esri_webfeaturelayer_addAttachment (AutoLISP)

Cette fonction joint un fichier à une entité d’une couche d’entités Web prenant en charge les pièces jointes et pour laquelle l’utilisateur dispose d’un rôle d’édition ou supérieur. Les nouvelles entités doivent être synchronisées avant d’ajouter des pièces jointes.

Syntaxe

(esri_webfeaturelayer_addAttachment flname ename filepath)

Arguments

• flname | chaîne | obligatoire | Nom de couche d’entités Web existant dans le dessin.
• ename | nom d’entité | obligatoire | Nom de l’entité AutoCAD d’un objet pour ajouter une pièce jointe.
• filepath | chaîne | obligatoire | Chemin d’accès au fichier à joindre.

Exemple d’utilisation 1

Invite l’utilisateur à sélectionner une entité dans une couche d’entités Web nommée "Damage_to_Residential_Buildings" et essaye de joindre le fichier nommé "C:\\CADwork\\Attachments\\Olympus_Subdivision-2.0.xml" .

(progn
(setq ename (car (entsel)))
(esri_webfeaturelayer_addAttachment 
  "Damage_to_Residential_Buildings" 
  ename 
  "C:\\CADwork\\Attachments\\Olympus_Subdivision-2.0.xml"
))

Exemple d’utilisation du résultat 1

Le fichier "C:\\CADwork\\Attachments\\Olympus_Subdivision-2.0.xml" est ajouté à l’entité sélectionnée sur le serveur et la fonction renvoie :

(T)

Exemple d’utilisation 2

Invite l’utilisateur à sélectionner une entité dans une couche d’entités Web nommée "Shelters" et essaye de joindre le fichier nommé "C:\\CADwork\\Attachments\\LandSurface.xml". La couche d’entités Web ne prend toutefois pas en charge les pièces jointes.

(progn
(setq ename (car (entsel)))
(esri_webfeaturelayer_addAttachment 
  "shelters" 
  ename
  "C:\\CADwork\\Attachments\\Olympus_Subdivision-2.0.xml"
))

Exemple d’utilisation du résultat 2

Le fichier LandSurface.xml n’est pas ajouté et la fonction renvoie :

 (nil ("Error" . "Layer does not support attachments"))

Valeurs renvoyées

Cette fonction renverra une valeur.

• En cas de réussite, renvoie une liste contenant la valeur True : (T).
• En cas d’échec, elle renvoie une liste avec la première valeur nil puis une liste associée contenant la valeur principale "Error" (Erreur) 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’un des trois arguments requis n’a pas été fourni.

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

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

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

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

• (nil ("Error" . "Layer does not support attachments"))

  La couche d’entités Web spécifiée ne prend pas en charge les pièces jointes.

• (nil ("Error" . "File not found."))

  Le fichier spécifié n’existe pas

• (nil ("Error" . "No feature found."))

  L’entité spécifiée n’est pas un objet valide de la couche d’entités Web spécifiée.