ArcMap

Ajouter un élément

Disponible avec une licence Advanced.

Résumé

Ajoute un nouvel attribut vide ou nul à une nouvelle table INFO ou une table existante.

Utilisation

  • Cet outil crée une nouvelle table INFO qui est une copie de la table Info en entrée avec un nouvel attribut contenant des valeurs vides ou des zéros. Les données situées dans d'autres attributs sont copiées de la table Info en entrée vers la table Info en sortie. Lorsque la table Info en entrée et la table Info en sortie portent le même nom, l'attribut est ajouté à la table Info en entrée ; dans le cas contraire, la table Info en sortie est créée en tant que nouvelle table INFO interne et la table Info en entrée n'est pas modifiée.

  • N'insérez pas d'attributs avant l'ID de couverture dans une table attributaire d'entités.

  • N'insérez pas d'attributs avant l'attribut COUNT dans une table VAT de grille.

  • Si le type d'attribut définit un caractère, des blancs sont insérés pour chaque enregistrement. S'il définit un attribut numérique, des zéros sont insérés pour chaque enregistrement.

  • Il est déconseillé d'ajouter des attributs aux fichiers tic de couverture. L'exécution de certaines opérations sur la couverture peut provoquer des résultats négatifs. Nettoyer, Copier et d'autres outils conservent uniquement les attributs tic d'origine.

  • Un outil semblable, Joindre des tables Info, ajoute des attributs en combinant deux tables INFO. L'outil Ajouter un élément se distingue de Joindre des tables Info en ce sens qu'il ajoute un seul attribut à la fois, tandis que les nouvelles valeurs attributaires sont toujours nulles ou vides. Il peut être préférable d'utiliser l'outil Joindre des tables Info lorsque de nombreux attributs doivent être ajoutés à partir d'une table INFO existante.

Syntaxe

arcpy.arc.AddItem(in_info_table, out_info_table, item_name, item_width, output_width, item_type, {decimal_places}, {start_item})
ParamètreExplicationType de données
in_info_table

Table INFO à laquelle l'attribut doit être ajouté.

INFO Table
out_info_table

Table INFO à créer.

INFO Table
item_name

Nouvel attribut à ajouter à la table INFO.

String
item_width

Largeur INFO de l'attribut ajouté. Largeurs prises en charge :

  • BINARY : 2 ou 4 octets
  • CHARACTER : entre 1 et 320 caractères
  • DATE : toujours 8 octets, au format mm/jj/aa
  • FLOATING : 4 octets (simple précision) ou 8 octets (double précision)
  • NUMERIC : entre 1 et 16 chiffres
  • INTEGER : entre 1 et 16 chiffres
Long
output_width

Largeur d'affichage de l'attribut ajouté. Il s'agit du nombre de caractères utilisés pour afficher la valeur d'un attribut.

Par exemple, pour un entier à 2 octets (type d'attribut BINARY), les valeurs peuvent atteindre 32767, exigeant ainsi cinq caractères pour s'afficher. Les dates peuvent s'afficher à l'aide de huit (mm/jj/aa) ou dix (mm/jj/aaaa) caractères. Pour afficher des dates internationales, les mois et les jours peuvent être permutés (par ex., jj/mm/aa).

Long
item_type

Type d'attribut INFO de l'attribut ajouté.

  • BINARY —Entier binaire ; nécessite moins d'espace de stockage que le type INTEGER
  • CHARACTER —Texte
  • Date —Date ; stocke le jour, le mois et l'année
  • FLOATING —Nombre binaire à virgule flottante, à simple ou double précision
  • NUMERIC —Nombre décimal stocké sous la forme d'un octet par chiffre
  • INTEGER —Nombre entier stocké sous la forme d'un octet par chiffre
String
decimal_places
(Facultatif)

Nombre de décimales de l'attribut ajouté. Ce nombre doit être spécifié pour les types d'attributs INFO NUMERIC et FLOATING.

Long
start_item
(Facultatif)

Attribut dans in_info_table après lequel le nouvel attribut doit être ajouté. L'attribut start_item par défaut est le dernier attribut dans la table in_info_table.

INFO Item

Exemple de code

Exemple d'utilisation de l'outil AddItem (script autonome)

Le script autonome ci-dessous illustre l'ajout d'un attribut binaire à la table attributaire de points d'une couverture. Il utilise la même table en entrée et en sortie, de sorte qu'aucune nouvelle table n'est créée. 

# Name: AddItem_Example.py
# Description: Adds an item to a coverage's polygon attribute table
# Requirements: ArcInfo Workstation

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
env.workspace = "C:/data"

# Set local variables
inInfoTable = "tra_airport/polygon"
outInfoTable = inInfoTable
itemName = "sites"
itemWidth = 4
outputWidth = 5
itemType = "BINARY"

# Execute AddItem
arcpy.AddItem_arc(inInfoTable, outInfoTable, itemName, itemWidth, outputWidth, 
                  itemType, "", "")

Environnements

Informations de licence

  • Basic: Non
  • Standard: Non
  • Advanced: Requiert ArcInfo Workstation installé

Rubriques connexes