属性ルールの追加 (データ管理ツール)

サマリー

データセットに属性ルールを追加します。

属性ルールは、編集操作性を強化し、データの整合性を確保するためにデータセットに追加できる、ユーザー定義のルールです。これらのルールは、属性値を設定したり、許容されるフィーチャ構成を制限したりするために使用でき、フィーチャの編集時に適用されます。フィーチャの編集時にルール違反が発生すると、エラーメッセージが返されます。

属性ルールの詳細

ArcGIS Arcade スクリプト言語の詳細

使用法

エンタープライズジオデータベース内のバッチ計算ルールと検証ルールは、ブランチバージョン対応されたデータセットの検証サーバーを使用して評価されます。これらのルールタイプを追加するには、データベースコネクションの [バージョニングタイプ] を ブランチ に設定する必要があります。
データセットには、GlobalID フィールドが必要です。
バッチ計算ルールまたは検証ルールをデータセットに追加するには、編集情報の記録を有効にする必要があります。
属性ルールの定義に使用する式は、Arcade 言語で使用可能な機能性に制限されます。
データベースシーケンスの作成 ツールで作成されたデータベースシーケンスを参照するには、スクリプト式 パラメーターに NextSequenceValue Arcade データ関数を使用します。
既存の属性ルールを別のデータセットに割り当てるには、このツールを何度も実行する代わりに、属性ルールのエクスポート ツールと 属性ルールのインポート ツールを使用できます。

注意:

データセットに属性ルールを追加すると、データセットのクライアントの最低バージョンは ArcGIS Pro 2.1 となります。すなわち、データセットは ArcMap では使用できなくなります。

ラベル	説明	データタイプ
入力テーブル	新しいルールを適用するテーブルまたはフィーチャクラス。	Table View
名前	新しいルールの一意の名前。名前は 64 文字までに制限されています。	String
タイプ	追加する属性ルールのタイプを指定します。計算—フィーチャの属性値は、フィーチャ上に別の属性が設定されたときに自動的に設定されます。これらのルールは、指定されたトリガーイベントに基づいて適用されます。長期的な計算をバッチモードで実行するように設定できます。また、これらの計算はユーザー定義の時刻に評価されます。複数の計算ルールを追加するときに、循環依存がある場合には、ルールの追加順序が重要になります。たとえば、ルール A は `Field1` が `$feature.Field2 + $feature.Field3` の値に等しいという計算であり、ルール B は `Field4` が `$feature.Field1 + $feature.Field5` の値に等しいという計算であるとすると、計算の結果はルールの追加順序によって異なることになります。制約—フィーチャに対して許容される属性構成が指定されます。制約ルールの違反が発生した場合、エラーが生成され、フィーチャは格納されません。たとえば、`Field A` の値が `Field B` と `Field C` の合計を下回っていなければならない場合、その制約に対する違反が発生すると、エラーが生成されます。検証—バッチ検証プロセスで既存のフィーチャが識別されます。ルールはユーザー定義の時刻に評価されます。ルールに違反すると、エラーフィーチャが作成されます。	String
スクリプト式	ルールを定義する Arcade 式。	Calculator Expression
編集可能 (オプション)	属性値を編集できるかどうかを指定します。属性ルールはブロックされるように構成するか、計算対象のフィールドの属性値を編集者が編集できるように構成することができます。このパラメーターは、計算属性ルールタイプのみに適用されます。オン—属性値を編集できます。これがデフォルトです。オフ—属性値を編集できません。	Boolean
トリガーイベント (オプション)	属性ルールの有効化をトリガーする編集イベントを指定します。このパラメーターは、計算ルールタイプと制約ルールタイプにのみ有効です。バッチパラメーターがオフに設定されている計算ルールの場合は、1 つ以上のトリガーイベントを指定する必要があります。バッチパラメーターがオンに設定されている計算ルールの場合は、1 つ以上のトリガーイベントを指定する必要があります。挿入—このルールは新しいフィーチャの追加時に適用されます。更新—このルールはフィーチャが更新されるときに適用されます。削除—このルールはフィーチャが削除されるときに適用されます。	String
エラー番号 (オプション)	このルールの違反が発生した場合に返されるエラー番号。この値は一意である必要はないので、複数のルールで同じカスタムエラー番号が返される可能性があります。このパラメーターは、制約ルールタイプと検証ルールタイプに必須です。計算ルールタイプではオプションです。	String
エラーメッセージ (オプション)	このルールの違反が発生した場合に返されるエラーメッセージ。違反の発生時に編集者がその違反を理解できるように、わかりやすいメッセージを使用することをおすすめします。メッセージは 256 文字以下に制限されています。このパラメーターは、制約ルールタイプと検証ルールタイプに必須です。計算ルールタイプではオプションです。	String
説明 (オプション)	新しい属性ルールの説明。説明は 256 文字以下に制限されています。	String
サブタイプ (オプション)	ルールが適用されるサブタイプ (複数可)。	String
フィールド (オプション)	ルールの適用先となる既存のフィールドの名前。このパラメーターは、計算属性ルールタイプのみに適用されます。	String
アプリケーション評価から除外 (オプション)	編集をワークスペースに適用する前にアプリケーションがルールをローカルで評価するかどうかを指定します。すべてのクライアントが使用可能なルールをすべて実行する能力を持つわけではないので、作成者はクライアント評価から特定のルールを除外できます。たとえば、(データがオフラインである、サイズ、セキュリティーなどの理由で) すべてのクライアントで使用可能なわけではないデータを参照するルールが存在する可能性があります。また、ユーザーやコンテキストに依存するルールが存在することもあります (つまり、データコレクションアプリの軽量フィールドの更新では、追加のユーザー入力または知識を必要とするルールは実行されませんが、ArcGIS Pro などのクライアントがサポートしている場合があります)。このパラメーターは、`batch` パラメーター値が `BATCH` の場合、検証ルールタイプと計算ルールタイプには適用されません。オン—クライアント評価からルールが除外されます。オフ—クライアント評価からルールが除外されません。これがデフォルトです。	Boolean
バッチ (オプション)	該当するルールの評価をバッチモードで実行するかどうかを指定します。計算ルールでは、このパラメーター値は `BATCH` または `NOT_BATCH` にできます。検証ルールでは、このパラメーター値は `BATCH` である必要があります。制約ルールでは、このパラメーター値は `NOT_BATCH` である必要があります。オン—該当するルールの評価は、検証を実行することで、後からバッチモードで実行されます。オフ—該当するルールの評価は、バッチモードで実行されません。挿入、更新、または削除操作で該当するルールを評価するタイミングの決定にトリガーイベントが使用されます。これがデフォルトです。	Boolean
重要度 (オプション)	エラーの重要度。 1 ～ 5 の範囲内の値を指定して、ルールの重要度を定義できます。値 1 は最も重要度が高いことを示し、値 5 は最も重要度が低いことを示します。たとえば、特定の属性ルールの重要度を低くして、データ生成ワークフローの実行中のエラーを無視するように設定したり、収集されたデータの正確度に合わせてエラーを修正する必要がある高い重要度を設定したりすることができます。このパラメーターは、検証ルールにのみ適用されます。	Long
タグ (オプション)	一連のタグを使用して、ルール (検索およびインデックス作成用) をデータモデルの機能要件に対応付ける方法として解釈します。	String
トリガーフィールド (オプション)	計算属性ルールと制約属性ルールの更新トリガー中、編集イベントが発生した場合、属性ルールの実行をトリガーするフィールド。フィールドを指定しないと、すべてのフィールドが使用されます。	Field

派生した出力

ラベル	説明	データタイプ
更新されるテーブル	追加した属性ルールが反映された入力テーブル。	Table View

arcpy.management.AddAttributeRule(in_table, name, type, script_expression, {is_editable}, {triggering_events}, {error_number}, {error_message}, {description}, {subtype}, {field}, {exclude_from_client_evaluation}, {batch}, {severity}, {tags}, {triggering_fields})

名前	説明	データタイプ
in_table	新しいルールを適用するテーブルまたはフィーチャクラス。	Table View
name	新しいルールの一意の名前。名前は 64 文字までに制限されています。	String
type	追加する属性ルールのタイプを指定します。 `CALCULATION`—フィーチャの属性値は、フィーチャ上に別の属性が設定されたときに自動的に設定されます。これらのルールは、指定されたトリガーイベントに基づいて適用されます。長期的な計算をバッチモードで実行するように設定できます。また、これらの計算はユーザー定義の時刻に評価されます。複数の計算ルールを追加するときに、循環依存がある場合には、ルールの追加順序が重要になります。たとえば、ルール A は `Field1` が `$feature.Field2 + $feature.Field3` の値に等しいという計算であり、ルール B は `Field4` が `$feature.Field1 + $feature.Field5` の値に等しいという計算であるとすると、計算の結果はルールの追加順序によって異なることになります。 `CONSTRAINT`—フィーチャに対して許容される属性構成が指定されます。制約ルールの違反が発生した場合、エラーが生成され、フィーチャは格納されません。たとえば、`Field A` の値が `Field B` と `Field C` の合計を下回っていなければならない場合、その制約に対する違反が発生すると、エラーが生成されます。 `VALIDATION`—バッチ検証プロセスで既存のフィーチャが識別されます。ルールはユーザー定義の時刻に評価されます。ルールに違反すると、エラーフィーチャが作成されます。	String
script_expression	ルールを定義する Arcade 式。	Calculator Expression
is_editable (オプション)	属性値を編集できるかどうかを指定します。属性ルールはブロックされるように構成するか、計算対象のフィールドの属性値を編集者が編集できるように構成することができます。このパラメーターは、計算属性ルールタイプのみに適用されます。 `EDITABLE`—属性値を編集できます。これがデフォルトです。 `NONEDITABLE`—属性値を編集できません。	Boolean
triggering_events [triggering_events,...] (オプション)	属性ルールの有効化をトリガーする編集イベントを指定します。このパラメーターは、計算ルールタイプと制約ルールタイプにのみ有効です。 `batch` パラメーターが `NOT_BATCH` に設定されている計算ルールの場合は、1 つ以上のトリガーイベントを指定する必要があります。 `batch` パラメーターが `BATCH` に設定されている計算ルールには、トリガーイベントが適用されません。 `INSERT`—このルールは新しいフィーチャの追加時に適用されます。 `UPDATE`—このルールはフィーチャが更新されるときに適用されます。 `DELETE`—このルールはフィーチャが削除されるときに適用されます。	String
error_number (オプション)	このルールの違反が発生した場合に返されるエラー番号。この値は一意である必要はないので、複数のルールで同じカスタムエラー番号が返される可能性があります。このパラメーターは、制約ルールタイプと検証ルールタイプに必須です。計算ルールタイプではオプションです。	String
error_message (オプション)	このルールの違反が発生した場合に返されるエラーメッセージ。違反の発生時に編集者がその違反を理解できるように、わかりやすいメッセージを使用することをおすすめします。メッセージは 256 文字以下に制限されています。このパラメーターは、制約ルールタイプと検証ルールタイプに必須です。計算ルールタイプではオプションです。	String
description (オプション)	新しい属性ルールの説明。説明は 256 文字以下に制限されています。	String
subtype [subtype,...] (オプション)	ルールが適用されるサブタイプ (複数可)。	String
field (オプション)	ルールの適用先となる既存のフィールドの名前。このパラメーターは、計算属性ルールタイプのみに適用されます。	String
exclude_from_client_evaluation (オプション)	編集をワークスペースに適用する前にアプリケーションがルールをローカルで評価するかどうかを指定します。すべてのクライアントが使用可能なルールをすべて実行する能力を持つわけではないので、作成者はクライアント評価から特定のルールを除外できます。たとえば、(データがオフラインである、サイズ、セキュリティーなどの理由で) すべてのクライアントで使用可能なわけではないデータを参照するルールが存在する可能性があります。また、ユーザーやコンテキストに依存するルールが存在することもあります (つまり、データコレクションアプリの軽量フィールドの更新では、追加のユーザー入力または知識を必要とするルールは実行されませんが、ArcGIS Pro などのクライアントがサポートしている場合があります)。このパラメーターは、`batch` パラメーター値が `BATCH` の場合、検証ルールタイプと計算ルールタイプには適用されません。 `EXCLUDE`—クライアント評価からルールが除外されます。 `INCLUDE`—クライアント評価からルールが除外されません。これがデフォルトです。	Boolean
batch (オプション)	該当するルールの評価をバッチモードで実行するかどうかを指定します。計算ルールでは、このパラメーター値は `BATCH` または `NOT_BATCH` にできます。検証ルールでは、このパラメーター値は `BATCH` である必要があります。制約ルールでは、このパラメーター値は `NOT_BATCH` である必要があります。 `BATCH`—該当するルールの評価は、検証を実行することで、後からバッチモードで実行されます。 `NOT_BATCH`—該当するルールの評価は、バッチモードで実行されません。挿入、更新、または削除操作で該当するルールを評価するタイミングの決定にトリガーイベントが使用されます。これがデフォルトです。	Boolean
severity (オプション)	エラーの重要度。 1 ～ 5 の範囲内の値を指定して、ルールの重要度を定義できます。値 1 は最も重要度が高いことを示し、値 5 は最も重要度が低いことを示します。たとえば、特定の属性ルールの重要度を低くして、データ生成ワークフローの実行中のエラーを無視するように設定したり、収集されたデータの正確度に合わせてエラーを修正する必要がある高い重要度を設定したりすることができます。このパラメーターは、検証ルールにのみ適用されます。	Long
tags [tags,...] (オプション)	一連のタグを使用して、ルール (検索およびインデックス作成用) をデータモデルの機能要件に対応付ける方法として解釈します。複数のタグを入力するには、各タグをセミコロンで区切ります (例: Tag1;Tag2;Tag3)。	String
triggering_fields [triggering_fields,...] (オプション)	計算属性ルールと制約属性ルールの更新トリガー中、編集イベントが発生した場合、属性ルールの実行をトリガーするフィールド。フィールドを指定しないと、すべてのフィールドが使用されます。	Field

派生した出力

名前	説明	データタイプ
out_table	追加した属性ルールが反映された入力テーブル。	Table View

コードのサンプル

AddAttributeRule の例 1 (Python ウィンドウ)

GasPipes フィーチャクラスの labeltext フィールドを計算する計算ルールを追加します。

'''****************************************************************************
Name:        AddAttributeRule_example1.py
Description: This script adds a calcualtion rule to a feature class
Created by:  Esri
****************************************************************************'''

# Import required modules
import arcpy

# Set local variables
in_table = "C:\\MyProject\\sdeConn.sde\\progdb.user1.GasPipes"
name = "calculateRuleLabel"
script_expression = 'if ($feature.material == 5) {return "Plastic"} else {return "Other"}'
triggering_events = "INSERT;UPDATE"
description = "Populate label text"
subtype = "Coated Steel"
field = "labeltext"

# Run the AddAttributeRule tool
arcpy.management.AddAttributeRule(in_table, name, "CALCULATION", script_expression, "EDITABLE", triggering_events, "", "", description, subtype, field)

AddAttributeRule の例 2 (Python ウィンドウ)

GasPipes フィーチャクラスの動作圧属性を 300 に制限する制約ルールを追加します。

'''****************************************************************************
Name:        AddAttributeRule_example2.py
Description: This script adds a constraint rule to a feature class
Created by:  Esri
****************************************************************************'''

# Import required modules
import arcpy

# Set local variables
in_table = "C:\\MyProject\\sdeConn.sde\\progdb.user1.GasPipes"
name = "constraintRuleOP"
script_expression = '$feature.OPERATINGPRESSURE < 300'
triggering_events = "INSERT;UPDATE"
description = "Operating pressure must be less than 300"
subtype = "ALL"
error_number = 2001
error_message = "Invalid operating pressure. Must be less than 300."

# Run the AddAttributeRule tool
arcpy.management.AddAttributeRule(in_table, name, "CONSTRAINT", script_expression, "EDITABLE", triggering_events, error_number, error_message, description, subtype)

AddAttributeRule の例 3 (Python ウィンドウ)

検証ルールを GasPipes フィーチャクラスに追加して、作動圧力が 300 を上回る既存のフィーチャにマークを付けます。

'''****************************************************************************
Name:        AddAttributeRule_example3.py
Description: This script adds a validation rule to a feature class
Created by:  Esri
****************************************************************************'''

# Import required modules
import arcpy

# Set local variables
in_table = "C:\\MyProject\\sdeConn.sde\\progdb.user1.GasPipes"
name = "validationRuleMaxOP"
rule_type = "VALIDATION"
script_expression = "$feature.OPERATINGPRESSURE < 300"
error_number = 3001
error_message = "Maximum operating pressure exceeded"
description = "Validation rule: max operating pressure value"
subtype = "Coated Steel"
batch = "BATCH"
severity = 3
tags = "OP;MAXOP"

# Run the AddAttributeRule tool
arcpy.management.AddAttributeRule(in_table, name, rule_type,
                                  script_expression, "", "",
                                  error_number, error_message,
                                  description, subtype, "", "",
                                  batch, severity, tags)

環境

現在のワークスペース

ライセンス情報

Basic: いいえ
Standard: はい
Advanced: はい

属性ルールの追加 (データ管理ツール)

サマリー

使用法

注意:

パラメーター

派生した出力

環境

ライセンス情報

関連トピック