esri_webfeaturelayer_add (AutoLISP)

La función esri_webfeaturelayer_add 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 proporcione las credenciales requeridas por el portal.

Sintaxis

(esri_webfeaturelayer_add url [service_properties])

Argumentos

Se incluyen los siguientes 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 que limita las entidades de la capa por valores de atributo. La sintaxis de la cláusula WHERE viene determinada por los datos de origen.	Opcional
"BRANCH"	Cadena de caracteres	Nombre de la versión en rama disponible en la capa de entidades web.	Opcional

Ejemplo de uso 1

Agregue 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

Agrega la capa de entidades web USA States Generalized Boundaries y las entidades 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 devuelve una lista true:

(T)

Ejemplo de uso 3

Agregue todas las capas de entidades 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 devuelve una lista true:

(T)

Ejemplo de uso 4

Agrega la rama editor01.triangle de la capa de entidades web DamageAssessment cuando 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 "BRANCH" "editor01.triangle") 
    )
)

Resultado del ejemplo de uso 4

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

(T)

Valores de retorno

Los siguientes son los valores de retorno posibles:

• Si todo va bien, la función devuelve una lista de 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 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 puede producir un valor 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): función de AutoLISP que agrega una nueva capa de entidades de documento.

(esri_weblayer_add): función de AutoLISP que agrega una nueva capa web, una capa de imágenes, una capa de imágenes de mapa o una capa de entidades web.