概要
特定のフィールドのデフォルト値を作成します。テーブルまたはフィーチャクラスに新しい行が追加されるたびに、指定したフィールドがこのデフォルト値に設定されます。
使用法
設定されるデフォルト値は、[フィールド名] パラメーターで選択されたフィールド タイプに依存します。LONG (long integer) タイプのフィールドを選択した場合、デフォルト値は LONG タイプでなければなりません。
デフォルト値へのサブタイプの追加は任意です。サブタイプを追加する場合は、フィーチャクラスまたはテーブルにサブタイプ フィールドが必要になります。サブタイプ フィールドは、[サブタイプ フィールドの設定 (Set Subtype Field)] ツールを使用して設定することができます。
フィーチャクラスまたはテーブルのサブタイプは、カタログ ウィンドウで管理することもできます。サブタイプの作成および変更は、データセット [プロパティ] ダイアログ ボックスの [サブタイプのプロパティ] ページを使用して実行できます。
このツールは、フィールドまたはサブタイプのデフォルト値のクリアにも使用できます。
構文
arcpy.management.AssignDefaultToField(in_table, field_name, {default_value}, {subtype_code}, {clear_value})| パラメーター | 説明 | データ タイプ |
in_table | フィールドの 1 つにデフォルト値を追加する対象となる入力のテーブルまたはフィーチャクラス | Mosaic Layer; Raster Catalog Layer; Raster Layer; Table View |
field_name | テーブルまたはフィーチャクラスに新しい行が追加されるたびに、追加されたデフォルト値を格納するフィールド | Field |
default_value (オプション) | 新しいテーブルまたはフィーチャクラスのそれぞれに追加されるデフォルト値。入力する値は、このフィールドのデータ タイプと一致する必要があります。 | String |
subtype_code [subtype_code,...] (オプション) | デフォルト値に追加できるサブタイプ | String |
clear_value (オプション) | フィールドまたはサブタイプのいずれかのデフォルト値をクリアするかどうかを指定します。デフォルト値をクリアするには、default_value パラメーターを空の文字列として渡す必要があります。サブタイプのデフォルト値をクリアするには、クリア対象のサブタイプも指定する必要があります。
| Boolean |
派生した出力
| 名前 | 説明 | データ タイプ |
| out_table | 更新された入力テーブル。 | テーブル ビュー; ラスター レイヤー; モザイク レイヤー |
コードのサンプル
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)
環境
ライセンス情報
- Basic: はい
- Standard: はい
- Advanced: はい