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

サマリー

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

使用法

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

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

    操作結果

    フィールドの削除

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

    フィールドの追加

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

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

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

パラメーター

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

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

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

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

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

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

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

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

String
制限
(オプション)

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

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

派生した出力

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

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

Table View

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

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

Table View

コードのサンプル

AlterFieldGroup の例 (Python ウィンドウ)

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

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

ライセンス情報

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

関連トピック