esri_webfeaturelayer_add (AutoLISP)

Agrega una nueva capa de entidades web con una consulta de filtrado opcional. Se dibujarán las entidades resultantes dentro del área del proyecto. Si la capa web que se va a agregar es segura, se le pedirá al usuario que introduzca las credenciales requeridas por el portal.

Sintaxis

(esri_webfeaturelayer_add url [service_properties])

Argumentos

• url | cadena de caracteres | obligatorio | URL de una capa de entidades web válida para agregar al dibujo.
• service_properties | lista asociada | opcional | Una lista asociada de propiedades de la capa de entidades web en forma de pares de puntos tal como se define en la tabla siguiente:

Etiqueta asociada	Tipo de valor	Descripción del valor	Obligatorio u opcional
"DEFINITIONEXPRESSION"	Cadena de caracteres	Expresión de cláusula WHERE para limitar las entidades de la capa por valores de atributo. La sintaxis de la cláusula WHERE viene determinada por los datos de origen.	Opcional
"BRANCHNAME"	Cadena de caracteres	Nombre de la versión en rama disponible en la capa de entidades web.	Opcional

Ejemplo de uso 1

Intentar agregar la capa de entidades web USA Major Cities donde el valor de campo FID es mayor que 3800:

(esri_webfeaturelayer_add "https://www.arcgis.com/home/item.html?id=85d0ca4ea1ca4b9abf0c51b9bd34de2e"
(list (cons "DEFINITIONEXPRESSION" "FID > 3800")))

Ejemplo de resultado de uso 1

Agrega la capa de entidades web USA Major Cities y dibuja entidades en el área del proyecto actual donde el valor de campo FID es mayor que 3800 y la función devuelve una lista true:

(T)

Ejemplo de uso 2

Intentar agregar las entidades y la capa de entidades web USA States Generalized Boundaries donde el valor de campo STATE_NAME comienza con la letra N:

(esri_webfeaturelayer_add "https://esri.maps.arcgis.com/home/item.html?id=8c2d6d7df8fa4142b0a1211c8dd66903"
(list (cons "DEFINITIONEXPRESSION" "STATE_NAME LIKE \'N%\'")))

Ejemplo de resultado de uso 2

Agrega la capa de entidades web USA States Generalized Boundaries y dibuja entidades en el área del proyecto donde el valor de campo STATE_NAME empieza con la letra N y la función devuelve una lista true:

(T)

Ejemplo de uso 3

Intentar agregar todas las capas de entidades de PoolPermits sin ninguna consulta de filtrado:

(esri_webfeaturelayer_add "http://sampleserver6.arcgisonline.com/arcgis/rest/services/PoolPermits/FeatureServer")

Ejemplo de resultado de uso 3

Agrega la capa de entidades web PoolPermits, dibuja todas las entidades dentro del área del proyecto y la función devuelve una lista true:

(T)

Ejemplo de uso 4

Intentar agregar la rama editor01.triangle de la capa de entidades web DamageAssessment donde el valor de campo FID es mayor que 3800:

(esri_webfeaturelayer_add "https://sampleserver7.arcgisonline.com/server/rest/services/DamageAssessment/FeatureServer"
    (list 
        (cons "DEFINITIONEXPRESSION" "FID > 3800")
        (cons "BRANCHNAME" "editor01.triangle") 
    )
)

Resultado del ejemplo de uso 4

Agrega la rama editor01.triangle de la capa de entidades web DamageAssessment en la que el valor del campo FID es mayor que 3800 y la función devuelve una lista true:

(T)

Valores de retorno

Los siguientes son los valores de retorno posibles:

• Si va bien, la función devuelve una lista true: (T)

  Nota:

  Comportamiento asíncrono de software

  Si la URL proporcionada se puede interpretar, devolverá (T) aunque el servicio no se agregue completamente. Devolverá (T) antes de completar el dibujo de las entidades. Un valor de retorno (nil) normalmente significa que el servicio no se ha conectado.

• Si se produce un error, devuelve una lista con el primer valor de nil y, a continuación, una lista asociada que contiene el valor de clave "Error" y un mensaje de error asociado como cadena de caracteres: (nil ("Error" . "<message>")) o solo (nil).

Valores de retorno fallido

Se pueden producir valores de retorno fallido por cualquiera de los siguientes motivos:

• (nil ("Error" . "Invalid URL"))

  La URL proporcionada no es válida.

• (nil ("Error" . "Error"))

  La URL proporcionada no es válida.

• (nil ("Error" . "Missing required argument."))

  No se suministraron uno o más de los argumentos requeridos.

Consulte también

(esri_docfeaturelayer_add) | Agrega una nueva capa de entidades de documento.

(esri_weblayer_add) | Agrega una nueva capa web: capa de imágenes, capa de imágenes de mapa o capa de entidades web.