esri_webfeaturelayer_createBranch (AutoLISP)

La fonction esri_webfeaturelayer_createBranch crée une version de branche de couche d’entités Web pour la couche d’entités Web spécifiée.

Syntaxe

(esri_webfeaturelayer_createBranch flname branchName branchInfo)

Arguments

• flname | chaîne | obligatoire | Nom de couche d’entités Web existant dans le dessin.
• branchName | chaîne | obligatoire | Nom à utiliser pour la nouvelle version de branche.
• branchInfo | liste associée | obligatoire | Informations sur la version de branche à appliquer à la couche d’entités Web flname en tant que liste associée de paires pointées comme suit :

Etiquette associée	Type de valeur	Description de la valeur	Requis ou facultatif
"DESCRIPTION"	chaîne	Texte de description fourni par le créateur de la version de branche dans la limite de 64 caractères.	Facultatif
"ACCESS"	chaîne	Niveau d’accès de la version de branche. Les options sont "Public", "Private" et "Protected".	Requis

Exemple d’utilisation

Tenter de créer une version de branche nommée SouthwestProposal pour la couche d’entités Web Damage_to_Commercial_Buildings.

(esri_webfeaturelayer_createBranch "Damage_to_Commercial_Buildings" "SouthwestProposal" 
    (list
        (cons "DESCRIPTION" "proposed changes") 
        (cons "ACCESS" "Public")
    )
)

Exemple d’utilisation du résultat

Crée une version de branche nommée SouthwestProposal pour la couche d’entités Web Damage_to_Commercial_Buildings et renvoie le nom de branche :

("SouthwestProposal")

Valeurs renvoyées

Voici les valeurs de renvoi possibles :

• En cas de réussite, la fonction renvoie une liste contenant le nom de version de branche sous forme de chaîne.
• En cas d’échec, elle renvoie une liste dont la première valeur est nil, puis une liste associée contenant la valeur de clé "Error" et un message d’erreur associé sous forme de chaîne : (nil ( "Error" . "<message>")).

Valeurs d’échec renvoyées

Un échec peut être dû par exemple aux raisons suivantes :

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

  L’argument requis n’a pas été fourni.

• (nil ("Error" . "Service error encountered."))

  Un problème s’est produit lors de la connexion au service Web.

• (nil ("Error" . "Layer does not support branch versions.")

  La couche spécifiée ne prend pas en charge les versions de branche.

• (nil ("Error" . "Unable to retrieve properties from the branch version.")

  Des valeurs non valides ont été utilisées ou autre erreur de connexion est survenue.

• (nil ("Error" . "No connected web feature layers found.")

  La connexion réseau à la couche d’entités Web a été perdue.

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

  Le nom de branche existe peut-être déjà.