esri_fielddef_set (AutoLISP)

La fonction esri_fielddef_set définit la définition de champ pour un champ attributaire d’une couche d’entités de document. Vous ne pouvez pas mettre à jour la valeur TYPE d’un champ existant ou modifier la définition des champs d’une couche d’entités.

Syntaxe

(esri_fielddef_set flname field_properties)

Arguments

• flname | chaîne | obligatoire | Nom de couche d’entités existant dans le dessin.
• field_properties | liste associée | obligatoire | Liste associée de propriétés de champ de couche d’entités sous forme de paires pointées comme suit :

  Etiquette associée	Type de valeur	Description de la valeur	Requis ou facultatif
  "NAME"	chaîne	Nom du champ.	Requis
  "LENGTH"	entier	Longueur des champs de type texte uniquement.	Facultatif (définie sur les valeurs par défaut de l’interface utilisateur)
  "VALUE"	variante	Valeur par défaut du champ.	Facultatif (définie sur les valeurs par défaut de l’interface utilisateur)
  "SUBTYPE"	chaîne	Nom de sous-type d’une couche d’entités existante dans le dessin. Lors de la définition de la définition de champ d’une sous-couche, ne définit que la valeur par défaut.	Facultatif

Exemple d’utilisation

Essayer de mettre à jour la définition du champ Location de la couche d’entités Parks.

(esri_fielddef_set "Parks"
(list
(cons "NAME" "Location")
(cons "LENGTH" 254)
(cons "VALUE" "CA")
))

Exemple d’utilisation du résultat

Met à jour la définition du champ Location de la couche d’entités Parks 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).
• 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

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

• (nil ("Error" . "Field is not editable"))

  Vous ne pouvez pas mettre à jour le type d’un champ existant ou modifier la définition de champ d’une couche d’entités Web.

• (nil ("Error" . "Input string was not in a correct format."))

  Le type de la valeur spécifiée est incorrect.

• (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" . "No edits made"))

  Aucune modification n’a été effectuée en raison d’un problème avec la routine écrite.