esri_featurelayer_share (AutoLISP)

La fonction esri_featurelayer_share crée une couche d’entités hébergée à partir d’une ou de plusieurs couches d’entités de document spécifiées valides. Les définitions et les entités des couches d’entités de document spécifiées sont supprimées du dessin, et les entités résultantes dans la zone du projet en cours sont ajoutées au dessin, dans les couches AutoCAD appropriées des nouvelles couches d’entités Web.

Voici les exigences et les comportements d'utilisation :

• Vous devez être connecté à l’organisation spécifiée et disposer d’un rôle utilisateur permettant de créer ou de publier des données.
• Un seul élément de couche d'entités hébergée contenant une ou plusieurs couches d'entités est créé à partir des couches d'entités de document spécifiées.
• En cas de réussite, chaque couche d’entités de document est remplacée par une couche d’entités Web de la nouvelle couche d’entités hébergée.
• Comme avec toutes les couches d’entités Web, seules les objets entités compris dans la zone du projet en cours sont redessinés dans la session de dessin.
• La géométrie des entités résultantes est limitée en fonction des capacités de la couche d’entités hébergée, qui peut altérer les géométries telles que les courbes de tessellation.
• Si vous n’êtes pas déjà connecté à une organisation, vous êtes invité à saisir votre nom d’utilisateur et votre mot de passe.

Syntaxe

(esri_featurelayer_share sname flnames url [host_settings])

Arguments

Les arguments suivants sont inclus :

• sname | chaîne | obligatoire | Le nom de la nouvelle couche d'entités hébergée. Le nom sera tronqué à 90 caractères.
• flnames | chaîne | obligatoire | chaîne séparée par des virgules des noms de couches d'entités de document à partager.
• url | chaîne | obligatoire | l'URL de l'organisation ArcGIS Online ou ArcGIS Enterprise dans laquelle l'élément de couche d'entités hébergée sera créé.
• host_settings | liste associée | facultatif | Liste des paramètres facultatifs sous forme de paires pointées pour limiter les champs et renvoyer les valeurs par défaut appropriées telles que définies dans le tableau suivant :

  Etiquette associée	Type de valeur	Description de la valeur	Requis ou facultatif
  "AddGPSFields"	Booléen	Valeur True T ou False nil qui indique si les champs de métadonnées GPS sont ajoutés sur la nouvelle couche d’entités.	Facultatif
  "CreateWebFeatureLayerTemplate"	Booléen	Valeur True T ou False nil qui crée un modèle de propriété de couche d’entités dans le dessin pour chaque couche d’entités de document partagée, tant que l’expression de requête de la couche d’entités de document est une requête valide réservée à une couche (CAD Layer (Couche DAO) = "Manholes").	Facultatif
  "DefaultZ"	Double	Valeur z par défaut des nouvelles entités dans les applications de modification qui ne prennent pas en charge la modification des valeurs z. Cette valeur n’est pas utilisée lors de la modification dans ArcGIS pour AutoCAD, qui prend en charge la modification des valeurs z.	Facultatif
  "Description"	Chaîne	Description de la nouvelle couche d'entités hébergée en cours de création.	Facultatif
  "DisableEditorTracking"	Booléen	Valeur "true" (T) ou "false" (nil) qui spécifie si le suivi de l’éditeur doit être désactivé sur la nouvelle couche d’entités.	Facultatif
  "EnableM"	Booléen	Valeur True T ou False nil qui indique si les valeurs m sont activées sur la nouvelle couche d’entités.	Facultatif
  "Folder"	Chaîne	Nom du dossier dans lequel la nouvelle couche d’entités hébergée est créée.	Facultatif
  "GroupsToShareWith"	Chaîne	Chaîne unique contenant une liste séparée par des virgules des noms de groupes de l'organisation avec lesquels effectuer le partage.	Facultatif
  "ShareWithEveryone"	Booléen	Valeur True T ou False nil qui indique si la nouvelle couche d’entités hébergée est partagée avec tout le monde.	Facultatif
  "ShareWithOrg"	Booléen	Valeur True T ou False nil qui indique si la nouvelle couche d’entités est partagée avec des membres de l’organisation.	Facultatif
  "TAGS"	Chaîne	Chaîne unique contenant une liste séparée par des virgules de balises descriptives pour la nouvelle couche d’entités.	Facultatif

Exemple d’utilisation

Partagez les couches d'entités de document Sample_Points et Service_Lines en tant que couches d'entités hébergées au sein d'un nouvel élément de couche d'entités hébergée nommé New Construction :

(esri_featurelayer_share "New_Construction" "Sample_Points,Service_Lines" "https://www.arcgis.com"
  (list 
   (cons "Tags" "tag1,tag2")
   (cons "Description" "Owner")
   (cons "Folder" "String")
   (cons "EnableM" nil)
   (cons "ShareWithEveryone" nil)
   (cons "ShareWithOrg" T)
   (cons "DisableEditorTracking" nil)
   (cons "DefaultZ" 0)
   (cons "GroupsToShareWith" "group1,group2")
  )
)

Exemple d’utilisation du résultat

Partage les couches d’entités de document Sample_Points et Service_Lines en tant que couches d’entités hébergées au sein d’un nouvel élément de couche d’entités hébergée nommé New Construction. Une série de messages de statut est transmise à la ligne de commande. Les couches d’entités Web sont ajoutées au dessin, les entités sont redessinées dans la zone de projet et la fonction renvoie une liste contenant la chaîne d’URL de l’élément de portail publié.

("https://www.arcgis.com/home/item.html? id=b233c9eec046b4b290aca11ad8a3")

Valeurs renvoyées

Voici les valeurs de renvoi possibles :

• En cas de réussite, la fonction renvoie une liste contenant la chaîne d’URL de l’élément de portail publié.
• En cas d’échec, 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>")).

Valeurs d’échec renvoyées

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

• (nil ("Error" . "Document feature layer not found."))

  La valeur de la couche d’entités spécifiée n’est pas une couche d’entités valide dans le dessin.

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

  L’URL fournie n’est pas valide.

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

  L’un des arguments requis n’a pas été fourni.

• (nil ("Error" . "Only unique feature layers can be specified."))

  La même couche d’entités de document est ajoutée plusieurs fois.

• (nil ("Error" . "User does not have the sufficient capabilities to share as a Web Feature Layer."))

  Vous ne disposez pas des autorisations appropriées. Le compte d’organisation doit disposer au moins du rôle Publication.

• (nil ("Error" . "Service name is invalid or already exists."))

  Le nom du service fourni n’est pas valide ou existe déjà.

• (nil ("Error" . "Incorrect user name or password."))

  L’URL d’ArcGIS Online ou d’ArcGIS Enterprise est inaccessible sur le Web.

• (nil ("Error" . "An error occured"))

  Divers problèmes possibles ont été détectés au niveau de la connexion et de la publication.

• (nil ("Error" . "No coordinate system set"))

  Un système de coordonnées doit être attribué pour le dessin.

• (nil ("Error" . "One or more layers were not shareable."))

  Une ou plusieurs couches spécifiées ne peuvent pas être partagées. Par exemple, s’il existe des couches d’annotations ou multipatch, les entités ne peuvent pas être ouvertes (couche AutoCAD verrouillée).