La fonction esri_webfeaturelayer_add 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 ajoutée est sécurisée, l’utilisateur est invité à fournir les informations d’identification requises par le portail.
Syntaxe
(esri_webfeaturelayer_add url [service_properties])
Arguments
Les arguments suivants sont inclus :
- 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 qui limite les entités de la couche selon des valeurs attributaires. La syntaxe de la clause WHERE est déterminée par les données sources. | Facultatif |
| "BRANCH" | Chaîne | Nom de la version de branche disponible sur la couche d’entités Web. | Facultatif |
Exemple d’utilisation 1
Ajouter la couche d’entités Web USA Major Cities (Principales villes des États-Unis) lorsque 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 (Principales villes des États-Unis), dessine les entités dans la zone de projet actuelle lorsque la valeur du champ FID est supérieure à 3800 et renvoie une liste de valeurs True :
(T)Exemple d’utilisation 2
Ajoute la couche d’entités Web USA States Generalized Boundaries (Limites généralisées des États américains) et des entités lorsque 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 (Limites généralisées des États américains), dessine les entités dans la zone de projet lorsque la valeur du champ STATE_NAME commence par la lettre N et fonction renvoie une liste de valeurs True :
(T)Exemple d’utilisation 3
Ajoute toutes les couches d’entités Web PoolPermits (Permis de construire pour piscine) sans 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 (Permis de construire pour piscine), dessine toutes les entités dans la zone de projet et renvoie une liste de valeurs True :
(T)Exemple d’utilisation 4
Ajouter la branche editor01.triangle de la couche d’entités Web DamageAssessment (Évaluation des dommages) lorsque 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 "BRANCH" "editor01.triangle")
)
)
Exemple d’utilisation du résultat 4
Ajoute la branche editor01.triangle de la couche d’entités Web DamageAssessment (Évaluation des dommages) lorsque la valeur du champ FID est supérieure à 3800 et renvoie une liste de valeurs 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, la fonction renvoie une liste dont la première valeur est nil, une liste associée contenant la valeur de clé "Error" et un message d’erreur associé sous forme de chaîne : (nil ("Error" . "<message>")) ou uniquement (nil).
Valeurs d’échec renvoyées
Un échec peut être dû par exemple aux raisons suivantes :
- (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) : fonction AutoLISP qui ajoute une nouvelle couche d’entités de document.
(esri_weblayer_add) : fonction AutoLISP qui ajoute une nouvelle couche Web, une nouvelle couche d’imagerie, une nouvelle couche d’imagerie de carte ou une nouvelle couche d’entités Web.
Vous avez un commentaire à formuler concernant cette rubrique ?