esri_webfeaturelayer_add (AutoLISP)

Ajoute une nouvelle couche d’entités Web avec une requête de filtrage facultative. Les entités obtenues au sein de la zone du projet seront dessinées. Si la couche Web qui est ajoutée est sécurisée, l’utilisateur sera invité à saisir les informations de connexion requises pour se connecter au portail.

Syntaxe

(esri_webfeaturelayer_add url [service_properties])

Arguments

• url | chaîne | obligatoire | URL d’une couche d’entités Web valide à ajouter au dessin.
• service_properties | liste associée | facultatif | Liste associée de propriétés de couches d’entités Web sous forme de paires pointées, décrites dans le tableau ci-dessous :

Etiquette associée	Type de valeur	Description de la valeur	Requis ou facultatif
"DEFINITIONEXPRESSION"	Chaîne	Expression basée sur une clause WHERE permettant de limiter les entités de la couche selon des valeurs attributaires. La syntaxe de la clause WHERE est déterminée par les données source.	Facultatif
"BRANCHNAME"	Chaîne	Nom de la version de branche disponible sur la couche d’entités Web.	Facultatif

Exemple d’utilisation 1

Essaye d'ajouter la couche d'entités Web USA Major Cities (Principales villes des États-Unis) où la valeur du champ FID est supérieure à 3800 :

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

Exemple d’utilisation du résultat 1

Ajoute la couche d’entités Web USA Major Cities et dessine les entités dans la zone de projet actuelle où la valeur du champ FID est supérieure à 3800 et la fonction renvoie une liste de True :

(T)

Exemple d’utilisation 2

Essaye d’ajouter la couche d’entités Web USA States Generalized Boundaries et des entités où la valeur du champ STATE_NAME commence par la lettre N :

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

Exemple d’utilisation du résultat 2

Ajoute la couche d’entités Web USA States Generalized Boundaries, dessine les entités dans la zone de projet où la valeur du champ STATE_NAME commence par la lettre N et la fonction renvoie une liste de True :

(T)

Exemple d’utilisation 3

Essaye d’ajouter toutes les couches d’entités Web PoolPermits sans aucune requête de filtrage :

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

Exemple d’utilisation du résultat 3

Ajoute la couche d’entités Web PoolPermits, dessine les entités dans la zone de projet et la fonction renvoie une liste de True :

(T)

Exemple d’utilisation 4

Essaye d’ajouter la branche editor01.triangle de la couche d’entités Web DamageAssessment où la valeur du champ FID est supérieure à 3800 :

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

Exemple d’utilisation du résultat 4

Ajoute la branche editor01.triangle couche d’entités Web DamageAssessment où la valeur du champ FID est supérieure à 3800 et la fonction renvoie une liste de True :

(T)

Valeurs renvoyées

Voici les valeurs de renvoi possibles :

• En cas de réussite, la fonction renvoie une liste de valeurs True : (T)

  Remarque :

  Comportement asynchrone du logiciel

  Si l’URL fournie peut être interprétée, elle renverra (T) même si le service n’est pas entièrement ajouté. Elle renverra (T) avant que les entités ne soient entièrement dessinées. Une valeur de retour (nil) signifie généralement que le service ne s’est pas connecté.

• En cas d’échec, elle renvoie une liste avec la première valeur de nil puis une liste associée contenant la valeur principale "Error" et un message d’erreur associé sous forme de chaîne : (nil ("Error" . "<message>")), ou uniquement (nil).

Valeurs d’échec renvoyées

Des valeurs d’échec peuvent être renvoyées dans l’un des cas suivants :

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

  L’URL fournie n’est pas valide.

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

  L’URL fournie n’est pas valide.

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

  Un ou plusieurs des arguments requis n’a pas été fourni.

Voir aussi

(esri_docfeaturelayer_add) | Ajoute une nouvelle couche d’entités de document.

(esri_weblayer_add) | Ajoute une nouvelle couche Web : couche d’images, couche d’images de carte ou couche d’entités Web.