Définir la valeur par défaut d’un champ

Résumé

Crée une valeur par défaut pour un champ spécifique. Lorsqu’une nouvelle ligne est ajoutée à la table ou la classe d’entités, cette valeur par défaut sera affectée au champ indiqué.

Utilisation

• La valeur par défaut dépend du type de champ choisi dans le paramètre Nom du champ. Si vous choisissez un champ de type LONG (entier long), la valeur par défaut doit être de type LONG.

• L'ajout de sous-types à la valeur par défaut est facultatif. Si vous ajoutez un sous-type, il doit y avoir un champ de sous-type dans la classe d'entités ou la table. Vous pouvez définir le champ de sous-type à l'aide de l'outil Définir le champ de sous-type.

• Les sous-types d’une classe d’entités ou d’une table peuvent également être gérés dans la fenêtre Catalog (Catalogue). Vous pouvez créer et modifier des sous-types à l’aide de la page Subtypes Property (Propriétés du sous-type ) dans la boîte de dialogue Properties (Propriétés).

• Cet outil peut également servir à effacer la valeur par défaut d’un champ ou d’un sous-type.

Syntaxe

arcpy.management.AssignDefaultToField(in_table, field_name, {default_value}, {subtype_code}, {clear_value})

Paramètre	Explication	Type de données
in_table	Table en entrée ou classe d'entités dont l'un des champs se voit ajouter une valeur par défaut.	Mosaic Layer; Raster Catalog Layer; Raster Layer; Table View
field_name	Champ auquel la valeur par défaut est ajoutée chaque fois qu’une nouvelle ligne est ajoutée à la table ou à la classe d’entités.	Field
default_value (Facultatif)	La valeur par défaut à ajouter à chaque nouvelle table ou classe d'entités. La valeur saisie doit correspondre au type de données du champ.	String
subtype_code [subtype_code,...] (Facultatif)	Sous-types pouvant figurer dans la valeur par défaut.	String
clear_value (Facultatif)	Indique si la valeur par défaut du champ ou du sous-type sera effacée ou non. Pour effacer la valeur par défaut, le paramètre default_value doit être transmis en tant que chaîne vide. Pour effacer la valeur par défaut du sous-type, vous devez également spécifier le sous-type qui doit être effacé. TRUE —La valeur par défaut va être effacée (défini sur Null). FALSE —La valeur par défaut ne va pas être effacée. Il s’agit de l’option par défaut.	Boolean

Sortie dérivée

Nom	Explication	Type de données
out_table	Table en entrée mise à jour.	Vue tabulaire, couche raster, couche de mosaïque

Exemple de code

Exemple 1 d'utilisation de l'outil AssignDefaultToField (fenêtre Python)

Le script de fenêtre Python ci-dessous illustre l'utilisation de la fonction AssignDefaultToField en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data/Montgomery.gdb/Landbase"
arcpy.CopyFeatures_management("blocks", "C:/output/output.gdb/blocks")
arcpy.AssignDefaultToField_management("C:/output/output.gdb/blocks", "Res", 1,
                                      ["0: Non-Residental", "1: Residental"])

Exemple 2 d'utilisation de l'outil AssignDefaultToField (script autonome)

Le script autonome ci-dessous illustre l'utilisation de la fonction AssignDefaultToField.

# Name: AssignDefaultToField_Example2.py
# Description: Assign a new default to a field along with subtypes
 
# Import system modules
import arcpy
 
# Set environment settings
arcpy.env.workspace = "c:/data/Montgomery.gdb/Landbase"
 
# Set local variables
inFeatures = "blocks"
outFeatureClass = "c:/output/output.gdb/blocks"
fieldName = "Res"
defaultValue = 1
subTypes = ["0: Non-Residental", "1: Residental"]
 
# Execute CopyFeatures to make new copy of the input
arcpy.CopyFeatures_management(inFeatures, outFeatureClass)
 
# Execute AssignDefaultToField
arcpy.AssignDefaultToField_management(outFeatureClass, fieldName, 
                                      defaultValue, subTypes)

Environnements

• Espace de travail courant

Informations de licence

• Basic: Oui
• Standard: Oui
• Advanced: Oui