フィールド グループの変更 (Alter Field Group) (データ管理)

サマリー

フィールド グループのプロパティを変更します。

使用法

  • フィールド グループを削除すると、そのフィールド グループに関連付けられている条件値も削除されます。このツールでは、関連付けられている条件値を削除せずに、フィールド グループを変更することができます。

  • フィールド グループに属しているフィールドを変更すると、次の表に示されているように、そのフィールドによって変化する条件値が影響を受けることがあります。

    操作結果

    フィールドの削除

    削除されたフィールドに関連付けられている条件値も削除されます。

    フィールドの追加

    フィールド値タイプが ANY の条件値に追加された新しいフィールドが、フィールド グループに関連付けられている条件値にも追加されます。

  • フィールド グループの作成に、ObjectIDShape、またはサブタイプ フィールドなどのシステムが維持するフィールドを使用することはできません。

  • データがエンタープライズ ジオデータベースに格納されている場合、このツールを使用するにはデータ所有者として接続する必要があります。

パラメーター

ラベル説明データ タイプ
ターゲット テーブル

変更するフィールド グループを含むテーブル。

Table View
フィールド グループ名

変更するフィールド グループの名前。

String
新しいフィールド グループ名
(オプション)

フィールド グループに一意の新しい名前。

String
新しいフィールド
(オプション)

フィールド グループに属しているフィールド。フィールドを変更するには、新しいフィールド名を入力します。値を指定すると、追加処理が実行されるのではなく、フィールド グループに属しているフィールドの現在のリストが置き換えられます。値を指定しないと、フィールドの変更は行われません。

String
制限
(オプション)

フィールド グループが制限されるかどうかを指定します。このパラメーターでは、条件値を使用している場合の編集の操作性を制御できます。

  • オン - フィールド グループが制限されます。フィールド グループ内のフィールドへの入力が、条件値として指定した値に制限されます。これがデフォルトです。
  • オフ - フィールド グループが制限されません。値が条件値として指定されていない場合でも、値をフィールド グループ内のフィールドにコミットできます。
Boolean

派生した出力

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

変更したフィールド グループが反映された入力ターゲット テーブル。

テーブル ビュー

arcpy.management.AlterFieldGroup(target_table, name, {new_name}, {fields}, {is_restrictive})
名前説明データ タイプ
target_table

変更するフィールド グループを含むテーブル。

Table View
name

変更するフィールド グループの名前。

String
new_name
(オプション)

フィールド グループに一意の新しい名前。

String
fields
[fields,...]
(オプション)

フィールド グループに属しているフィールド。フィールドを変更するには、新しいフィールド名を入力します。値を指定すると、追加処理が実行されるのではなく、フィールド グループに属しているフィールドの現在のリストが置き換えられます。値を指定しないと、フィールドの変更は行われません。

String
is_restrictive
(オプション)

フィールド グループが制限されるかどうかを指定します。このパラメーターでは、条件値を使用している場合の編集の操作性を制御できます。

  • RESTRICTフィールド グループが制限されます。フィールド グループ内のフィールドへの入力が、条件値として指定した値に制限されます。これがデフォルトです。
  • DO_NOT_RESTRICTフィールド グループが制限されません。値が条件値として指定されていない場合でも、値をフィールド グループ内のフィールドにコミットできます。
Boolean

派生した出力

名前説明データ タイプ
out_table

変更したフィールド グループが反映された入力ターゲット テーブル。

テーブル ビュー

コードのサンプル

AlterFieldGroup (フィールド グループの変更) の例 (Python ウィンドウ)

フィールド グループの名前を変更し、現在のフィールド グループ内のフィールドを置き換え、フィールド グループが制限されないようにして、そのフィールド グループのプロパティを変更します。

import arcpy
arcpy.AlterFieldGroup_management("C:\\MyProject\\myConn.sde\\mygdb.USER1.myFC",
                                 "MyFieldGroup", "MyNewFieldGroupName",
                                 ["Field1", "Field3"],
                                 "DO_NOT_RESTRICT")

関連トピック