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

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.

  • 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 dérivée

ÉtiquetteExplicationType de données
Table en entrée actualisée

Table en entrée mise à jour.

Vue tabulaire, couche raster, couche de mosaïque

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 dérivée

NomExplicationType 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)

Informations de licence

  • Basic: Nécessite O
  • Standard: Nécessite O
  • Advanced: Nécessite O

Rubriques connexes