Résumé
Cet outil crée une valeur par défaut pour un champ spécifique. A chaque fois qu'un nouvel enregistrement est ajouté à 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 Catalogue. Vous pouvez créer et modifier des sous-types à l'aide de la page Propriétés du sous-type sur la boîte de dialogue Propriétés du jeu de données.
Cet outil peut également servir à effacer la valeur par défaut d’un champ ou sous-type, le cas échéant.
Syntaxe
AssignDefaultToField_management (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 | Le champ auquel la valeur par défaut est ajoutée chaque fois qu'une nouvelle ligne est ajoutée à la table ou 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 doit être 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é.
| Boolean |
Sortie dérivée
| Nom | Explication | Type de données |
| out_table |
Exemple de code
Exemple 1 d'utilisation de l'outil AssignDefaultToField (fenêtre Python)
Le script de fenêtre Python suivant montre comment utiliser l'outil AssignDefaultToField en mode immédiat.
import arcpy
from arcpy import env
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 suivant illustre l'utilisation de l'outil AssignDefaultToField.
# Name: AssignDefaultToField_Example2.py
# Description: Assign a new default to a field along with subtypes
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
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
Informations de licence
- ArcGIS Desktop Basic: Oui
- ArcGIS Desktop Standard: Oui
- ArcGIS Desktop Advanced: Oui