Définir la valeur par défaut d’un champ (Gestion des données)

Synthèse

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

    Attention :

    Cet outil modifie les données en entrée. Pour plus d’informations et connaître les stratégies permettant d’empêcher les modifications de données indésirables, reportez-vous à la rubrique Outils qui modifient ou mettent à jour les données en entrée.

  • 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.

  • Vous pouvez également afficher et gérer des sous-types dans Vue des sous-types qui apparaît en cliquant sur le bouton Sous-types dans la section Création du ruban Données ou en cliquant sur le bouton Sous-types du ruban Vue des champs.

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

Paramètres

ÉtiquetteExplicationType de données
Table en entrée

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 Layer; Table View
Nom de champ

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
Valeur par défaut
(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. Si un domaine de valeurs précodées est associé au champ choisi, les valeurs du domaine précodé sont incluses dans la liste des valeurs du paramètre..

String
Sous-type
(Facultatif)

Sous-types pouvant figurer dans la valeur par défaut.

String
Supprimer la valeur
(Facultatif)

Indique si la valeur par défaut du champ ou du sous-type sera effacée ou non. Le paramètre Default Value (Valeur par défaut) doit être vide pour effacer la valeur par défaut du champ. Pour effacer la valeur par défaut du sous-type, laissez le paramètre Default Value (Valeur par défaut) vide et spécifiez le sous-type qui doit être effacé.

  • Activé : la valeur par défaut va être effacée (défini sur Null). Le paramètre Valeur par défaut doit être vide.
  • Désactivé : la valeur par défaut ne va pas être effacée. Il s’agit de l’option par défaut.
Boolean

Sortie obtenue

ÉtiquetteExplicationType de données
Table en entrée mise à jour

Table en entrée mise à jour.

Table View; Raster Layer; Mosaic Layer

arcpy.management.AssignDefaultToField(in_table, field_name, {default_value}, {subtype_code}, {clear_value})
NomExplicationType 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 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é.

  • CLEAR_VALUELa valeur par défaut va être effacée (défini sur Null).
  • DO_NOT_CLEARLa valeur par défaut ne va pas être effacée. Il s’agit de l’option par défaut.
Boolean

Sortie obtenue

NomExplicationType de données
out_table

Table en entrée mise à jour.

Table View; Raster Layer; Mosaic Layer

Exemple de code

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

Le script ci-dessous pour la fenêtre Python 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)

Informations de licence

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

Rubriques connexes