フィールドへのデフォルト値の割り当て (Assign Default To Field) (データ管理)

サマリー

特定のフィールドのデフォルト値を作成します。 テーブルまたはフィーチャクラスに新しい行が追加されるたびに、指定したフィールドがこのデフォルト値に設定されます。

使用法

    注意:

    このツールを実行すると、入力データが変更されます。 詳細と不要なデータの変更を回避するための方法については、「入力データを変更または更新するツール」をご参照ください。

  • 設定されるデフォルト値は、[フィールド名] パラメーターで選択されたフィールド タイプに依存します。 LONG (long integer) タイプのフィールドを選択した場合、デフォルト値は LONG タイプでなければなりません。

  • デフォルト値へのサブタイプの追加は任意です。 サブタイプを追加する場合は、フィーチャクラスまたはテーブルにサブタイプ フィールドが必要になります。 サブタイプ フィールドは、[サブタイプ フィールドの設定 (Set Subtype Field)] ツールを使用して設定することができます。

  • また、サブタイプ ビューでサブタイプを表示したり管理することもできます。サブタイプ ビューは、[データ] リボンの [設計] セクションにある [サブタイプ] ボタンをクリックするか、[フィールド ビュー] リボンの [サブタイプ] ボタンをクリックして開くことができます。

  • このツールは、フィールドまたはサブタイプのデフォルト値のクリアにも使用できます。

パラメーター

ラベル説明データ タイプ
フィールド名

テーブルまたはフィーチャクラスに新しい行が追加されるたびに、追加されたデフォルト値を格納するフィールド

Field
サブタイプ
(オプション)

デフォルト値に追加できるサブタイプ

String
値のクリア
(オプション)

フィールドまたはサブタイプのいずれかのデフォルト値をクリアするかどうかを指定します。 フィールドのデフォルト値をクリアするには、[デフォルト値] パラメーターが空である必要があります。 サブタイプのデフォルト値をクリアするには、[デフォルト値] パラメーターを空のままにし、クリア対象のサブタイプを指定します。

  • オン - デフォルト値はクリアされます (NULL に設定)。 デフォルト値パラメーターが空である必要があります。
  • オフ - デフォルト値はクリアされません。 これがデフォルトです。
Boolean

派生した出力

ラベル説明データ タイプ
更新された入力テーブル

更新された入力テーブル。

Table View; Raster Layer; Mosaic Layer

arcpy.management.AssignDefaultToField(field_name, {subtype_code}, {clear_value})
名前説明データ タイプ
field_name

テーブルまたはフィーチャクラスに新しい行が追加されるたびに、追加されたデフォルト値を格納するフィールド

Field
subtype_code
[subtype_code,...]
(オプション)

デフォルト値に追加できるサブタイプ

String
clear_value
(オプション)

フィールドまたはサブタイプのいずれかのデフォルト値をクリアするかどうかを指定します。 デフォルト値をクリアするには、default_value パラメーターを空の文字列として渡す必要があります。 サブタイプのデフォルト値をクリアするには、クリア対象のサブタイプも指定する必要があります。

Boolean

派生した出力

名前説明データ タイプ
out_table

更新された入力テーブル。

Table View; Raster Layer; Mosaic Layer

コードのサンプル

AssignDefaultToField の例 (Python ウィンドウ)

次の Python ウィンドウ スクリプトは、イミディエイト モードで AssignDefaultToField 関数を使用する方法を示しています。

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"])
AssignDefaultToField の例 2 (スタンドアロン スクリプト)

次のスタンドアロン スクリプトで、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)

関連トピック