属性规则和关系类
属性规则可用于读取和编辑地理数据库中参与 关系类 的数据集的相关记录。 规则可以应用于参与关系类的要素类和表，这些关系类可包含附件和关联要素的注记。 属性规则还可用于从对关系中的源类与目标类的更新中截取编辑事件，即添加、移除或删除相关记录。 例如，当要素被添加到相关要素类时，实时计算属性规则可以更新一个属性字段。
通过关系类触发事件
实时计算和约束属性规则会在特定编辑事件（插入、更新和删除操作）发生时触发。 对于更新事件，您可以选择指定一列触发字段。 通过 ArcGIS Pro 使用 将新项添加到关系 或 将所选项添加到关系 快捷菜单选项添加相关记录时，会触发多个编辑事件。
使用 将新项添加到关系 快捷菜单操作时，会发生以下情况：
在关系类目标表中，将创建一个空行。
- 在目标行上插入触发器。
在目标行上设置外键。
- 更新目标行上的触发器。
例如，当您在包含更新触发事件的目标表上添加属性规则时，规则将捕获外键并查询源表中相关联的行。
您也可以使用 将所选项添加到关系 和 从关系中移除 快捷菜单操作。
下表列出了通过比较 $originalFeature.key 和 $feature.key 可针对更新事件区分的特定函数。
|
函数 |
事件 |
ArcGIS Arcade 表达式 |
|---|---|---|
|
将要素添加到关系 |
更新 |
Isempty($originalfeature.key) == true And isempty($feature.key) == false |
|
将所选要素添加到关系 |
更新 |
Isempty($originalfeature.key) == true And isempty($feature.key) == false |
|
从关系中移除要素 |
更新 |
Isempty($originalfeature.key) == false And isempty($feature.key) == true |
|
删除对相关记录执行的操作 |
删除 |
读取相关记录
使用关系类时，您可以使用 Arcade 函数读取相关记录，这些函数可获取输入要素并返回相关记录。
FeatureSetByRelationshipName - 运行仅限于服务器上下文。 将此函数用于属性规则时，请确保 从应用程序评估中排除 选项已设置为真。
FeatureSetByRelationshipClass - 支持在服务器和客户端侧运行。 在编辑内容发送到数据源之前，使用此函数的规则在应用程序中以本地方式运行（例如 ArcGIS Pro 和 ArcGIS Maps SDKs for Native Apps）。
您也可以通过 FeatureSetByName Arcade 函数和对外键应用过滤器来读取相关记录。
使用 FeatureSetByName Arcade 函数读取关系类的相关记录。
在参与与检查表的一对多关系类的电线杆要素类中的 InspectionCount 字段上创建 计算规则 。 FeatureSetByName 函数可用于直接读取检查等级并检索更新时的相关记录。 使用此 Arcade 函数需要了解关系类字段。 对于此关系类，原始主键是电线杆要素类的 globalID 字段，原始外键是检查独立表的 poleguid 字段。
//A calculation rule that returns the count of a pole inspection records.
//When a pole feature is updated, the calculation rule reads all its related inspections records from the comments field and returns the total inspection count for that feature.
Var fs = FeatureSetByName($datastore, “Inspection”, [“comments”], false)
Var poleGuid = $feature.poleguid
Var fsinspected = Filter(fs, “POLEGUID= @poleguid”);
Return count(fsinspected)
使用 FeatureSetByRelationShipName Arcade 函数读取关系类的相关记录。
可以使用 FeatureSetByRelationshipName 函数重写用于读取关系类的相关记录的相同脚本。 使用此函数，您不必知道外键，只需要知道关系名称 pole_inspection 。
注意：
使用此函数创建属性规则时，请确保 从应用程序评估中排除 选项已设置为 true。
//A calculation rule that returns the count of a pole inspection records.
//When a pole feature is updated, the calculation rule reads all its related inspections records from the comments field and returns the total inspection count for that feature.
Var fsinspected = FeatureSetByRelationshipName($feature, “pole_inspection”, [“comments”], false)
Return count(fsinspected)
使用 FeatureSetByRelationshipClass Arcade 函数读取关系类的相关记录。
可以使用 FeatureSetByRelationshipClass 函数重写用于从关系类读取相关记录的相同脚本。 使用此函数，您不必知道外键，只需要知道关系名称 pole_inspection 。 该函数支持操作服务器端和客户端，因此使用该函数的属性规则可以在应用程序本地运行。
//A calculation rule that returns the count of a pole inspection records.
//When a pole feature is updated, the calculation rule reads all its related inspections records from the comments field and returns the total inspection count for that feature.
Var fsinspected = FeatureSetByRelationshipClass ($feature, “pole_inspection”, [“comments”], false)
Return count(fsinspected)
创建、更新和删除相关记录
还可以基于 字典 返回内容使用计算规则编辑关系类中的相关记录。
此处是一个创建计算规则的示例，该计算规则可创建一个相关记录。 当用户更新电线杆注释字段时，编辑字典关键字用于创建检查记录。 同样，您可以更新或删除相关记录。 有关详细信息，请参阅 属性规则字典关键字 。
在更新编辑时为关系类添加新的相关记录。
在更新电线杆注释字段时，可使用计算规则来创建相关记录。 在此表达式中，如果注释字段发生更改，则使用 edit 字典关键字创建检查记录。 同样，您可以更新或删除相关记录。 有关详细信息，请参阅 属性规则字典关键字 。
//A calculation rule that triggers on an update event when the pole comment field is edited.
//The expression first checks if the comment field changed and creates a new related record.
If ($originalfeature.comment != $feature.comment)
{
Return {
“edit”: [{
“className”: “inspection”,
“adds”: [{ “attributes”: { “comments”: $feature.comment } }]
}]
}
Return;
验证并评估关系类规则
可以创建并应用 验证 或 约束 属性规则来强制执行关系类规则。
例如，在电线杆（起点）要素类和检查（目的地）表之间设置了关系类。 每个电线杆必须至少记录一次或多次检查。
可以在此相关数据之间创建一对一 (1:1) 或一对多 (1:M) 关系类规则来完成此操作。 创建关系类规则后，可以使用以下脚本编写验证属性规则，该规则将应用于电线杆（原点）要素类，强制每个电线杆必须通过一项或多项检查：
//A validation rule that ensures each pole passes one or more inspections.
var fsInspections = FeatureSetByRelationshipClass($feature, "poles");
if (count(fsInspections) == 0) return false;
return true;
将此 验证属性规则 添加到数据后，评估过程会审查数据上的规则以确保遵循规则。 所使用的评估方法取决于规则类型和属性。
在用户指定的时间通过 错误检查器 视图或 评估规则 工具对验证规则进行评估。 在评估过程中，验证规则会创建错误要素，突出显示违反规则的要素。 您可通过 错误检查器 视图来检查这些规则的错误要素。
注:
可以使用 FeatureSetByRelationshipName 或 FeatureSetByRelationshipClass Arcade 函数来创作这些规则。 FeatureSetByRelationshipClass 允许您通过客户端的服务评估规则，需要 ArcGIS Pro 3.2 或更高版本，相关说明请参见 读取相关记录 部分。
要修改此属性规则以强制电线杆必须只有一次检查或没有检查，可以按如下方式重写脚本：
//A validation rule that ensures each pole has one or fewer inspections.
var fsInspections = FeatureSetByRelationshipClass($feature, "poles");
if (count(fsInspections) > 1 ) return false;
return true;
对数据创建并应用 约束属性规则 。 约束规则用于指定要素上允许的属性配置和一般关系。 与计算规则不同，约束规则不用于填充属性，而是用于确保要素满足特定条件，并在条件不符合时阻止编辑。
约束规则在编辑事件（插入、更新和删除操作）发生期间评估。 对于更新事件，您可以选择设置一列触发字段。 约束规则将返回 true 或 false 结果，表示是否满足规则，如下所示：
True - 满足所提供的脚本表达式，随即将创建要素。
False - 不满足所提供的脚本表达式，因此不会创建要素。
创建和应用约束属性规则时，请密切注意编辑触发器的顺序。
例如，创建 约束属性规则 并将其应用于电线杆要素类，强制电线杆要素类中的每个杆必须至少存在一个检查事件。 如果约束属性规则设置为在插入时触发，例如添加新电线杆时，则无法创建电线杆。 在这种情况下，建议创建约束属性规则以在更新而不是插入时触发。
注:
可通过 即用型规则 
按钮访问可配置检查库，来支持创建约束和验证规则。 这适用于 ArcGIS Data Reviewer 许可。