配置用于属性编辑的表单 (Map Viewer)

如果地图包含要素图层（托管要素图层、托管要素图层视图、托管表图层、子类型图层组或 ArcGIS Server 要素图层），您可以定义编辑者在更新 web 地图中要素图层的字段值时可以使用的表单。 可以为地图中的每个要素图层定义一个表单，也可以仅为您知道地图用户需要编辑的相应图层定义一个表单。

提示：

如果您拥有地图中的要素图层或者您是组织管理员，则可以在启用图层编辑之前为要素图层配置表单。

配置表单时，指定表单包含哪些表单元素以及这些元素的显示方式。 拥有表单有助于将编辑者引导到正确的字段和每个可编辑字段的允许属性值。

表单也另存为地图的一部分。 当您共享地图时，其他人可以使用您定义的表单来编辑地图中的要素图层或相关记录。

注：

当前，您可以在 ArcGIS Online 和 ArcGIS Enterprise 中的 Map Viewer 以及 Field Maps Designer 中配置表单。

配置表单之前

在为地图中的要素图层配置表单之前，请先熟悉图层的内容和字段设置。 字段包含的内容会影响您是否为字段创建元素组。 应用于字段的设置（例如是否允许空值、是否定义默认值以及图层所有者是否为字段定义列表）会影响您在表单上设置字段元素的格式。

配置表单

您可以为地图中的每个要素图层配置一个输入表单。 您可以定义哪些字段（元素）出现在表单上以及所在位置。

当编辑者选择可编辑要素图层中的要素时，会显示表单，以便编辑者可以输入该图层的属性值。

请按照这些步骤为要素图层配置表单。

1. 确认您是否已登录，以及是否具备创建内容的权限。
2. 在内容（深色）工具栏中，单击图层以打开图层窗格。
3. 向地图添加要素图层。
4. 选择要素图层后，在设置（浅色）工具栏上单击 表单。

   随即显示配置表单窗口。

5. 单独使用或组合使用以下选项向表单添加元素。

   表单元素是字段分组和显示在表单上的输入字段。 字段元素基于要素图层中的现有字段。

   • 转换现有弹出窗口—如果您为要素图层配置了弹出窗口，则可以使用现有的弹出窗口配置作为配置表单的起点。
   • 添加字段—选择图层中的哪些字段要添加到表单。 当字段被添加到表单画布时，就变成了表单元素。
   • 添加相关记录元素 - 当要素图层具有相关的表或要素图层时，可以向表单添加相关记录元素。
   • 创建元素组—您可以创建可展开和可折叠的组元素，以在表单上将逻辑相关的信息放在一起。
   • 添加条件值字段组 - 如果要素图层中的数据已定义条件值，则字段组列表将显示在表单构建器中。 由此可在单个步骤中将逻辑相关的字段组添加到表单画布。
6. 在将字段和组作为元素添加到表单画布后，格式化每个元素。
7. 或者，编写 Arcade 表达式来定义影响元素的条件。
8. 为表单上的元素添加、格式化和配置条件表达式后，单击确定以保存表单。
9. 保存地图。

   注：

   如果关闭地图而不保存，您将丢失表单。

如果您需要更改表单，请重复上述步骤。 请务必在编辑表单后保存地图。

转换现有弹出窗口

如果要素图层已配置弹出窗口，请单击转换弹出窗口以将弹出窗口中的字段添加到表单画布。

弹出窗口配置中不包含的字段显示在表单构建器的字段列表中。 您可以将它们拖到表单画布上，将它们作为元素添加到表单中，如下一章节所述。

将字段作为元素添加到表单后，您可以创建组来聚合相关字段或继续格式化字段元素。

注：

包含高精度 GPS 元数据的字段只有从现有弹出窗口导入时才能出现在表单上。 因为这些字段只能从 GPS 设备填充，所以禁用相应表单元素的编辑。

添加字段

选择图层中的哪些字段作为表单元素呈现给编辑者。 在大多数情况下，您添加编辑者将用于更新值的字段。

例如，如果要素图层包含以下字段 - 站点名称、站点类型、构建状态、景观、编辑日期、编辑者名称、创建日期、创建者名称、ID 和形状 - 您可以仅在表单上放置站点名称、站点类型、构建状态和景观字段，因为编辑日期、编辑者名称、创建日期、创建者名称和 ID 字段是自动填充的，并且在编辑者向图层添加要素时填充形状字段。

您还可以添加字段以供参考并禁用对表单元素的编辑。 在前面的示例中，您可以将“编辑日期”字段作为不可编辑元素包含在表单中，以便编辑者可以查看要素的上次更新时间。

1. 使用以下方法之一将字段作为元素添加到表单中：
   • 将所有字段添加到表单 - 单击字段列表中的全部添加以在表单的图层中包含所有字段。 当图层中有很多可编辑字段时，添加所有字段并删除一两个系统或不可编辑字段比添加单个字段更快。
   • 向表单中添加字段选择 - 要在表单中包括特定的字段选择，请按 Ctrl 键、单击要包括的字段，然后将其拖动到表单画布。
   • 逐个添加字段 - 要逐次将单个字段添加到表单，请双击该字段或将其拖动到表单画布中。

   提示：

   如果图层或表中包含大量字段，则可以使用字段列表中的查找字段搜索栏来定位特定字段。

2. 或者，将字段作为元素添加到表单后，创建组或继续格式化字段元素。

添加相关记录元素

如果您在发布托管要素图层之前在 ArcGIS Pro 地理数据库中创建了关系类，如果使用包含关系类的模板创建了托管要素图层，或者在 ArcGIS Survey123 Connect 中为包含重复部分的表单创建了托管要素图层，则可以向表单添加相关记录元素。 由此，用户在填写表单时，可以查看并添加与托管要素图层相关联的相关记录，例如表格。

例如，在用于监测城市树木健康状况的表单中，相关表单可以包括对每棵树的检查。 通过向表单添加相关记录元素，可以在编辑树要素的属性时向相关表添加新检查。

注：

• 对于数据，必须存在关系类，才能向表单添加相关记录元素。
• 要编辑相关记录，图层及其相关表或要素图层必须在地图中，并且每个相关表或图层必须已启用编辑功能。
• 目前支持源数据中要素类（源）和表（目标）之间的一对一和一对多关系基数。
• 目前，仅托管要素图层和托管要素图层视图支持向表单添加相关记录元素。

按照以下步骤将相关记录元素添加到表单：

1. 在相关记录列表中，双击相关记录元素或将其拖动到表单画布。

   相关记录元素将添加到表单画布。

2. 格式化相关记录元素的属性。

创建元素组

要将表单上同一物理位置中的相关字段分组，请创建组元素。 分组元素类似于将问题放在纸质表单的同一章节。 数字表单上的组具有额外的优势，即它们可以收缩以仅显示组标题，直到表单用户展开组。

例如，在用于更新路径要素图层内容的表单上，为与路径属性相关的所有字段（例如路径名称、类型和难度）创建一个组。 您可以为记录路径维护信息的字段创建一个单独的组，例如维护工作队名称、上次执行维护的日期以及执行维护的描述。 如果您选择在组折叠的情况下打开表单，则编辑者在展开组之前只会看到两个组名称。

按照以下步骤在可折叠部分的表单上将相关元素分组在一起：

1. 将组元素从表单元素列表拖到表单画布上。

   表单元素随即添加到表单画布中。

2. 将相关字段拖动到组中。

   您可以从表单构建器面板中的字段列表或表单画布中拖动字段。

3. 选择组元素以编辑其属性。

   属性窗格随即出现，以便您编辑以下信息：

   • 显示名称 - 提供描述组中包含的字段的名称。 这类似于纸质表单上的章节标题。 该值为必填项。
   • 描述 - 提供对组的描述。
   • 初始状态 - 默认情况下，当表单打开时组会展开，这意味着所有字段都自动可见。 如果您希望收缩组的初始状态，请取消选中已展开复选框。 表单用户将单击组以将其展开并查看其包含的字段。
   • 条件可见性 - 添加 Arcade 属性表达式以应用有关何时组应显示在表单中的规则。 有关详细信息，请参阅配置条件可见性。

提示：

您可以通过从组工具栏中选择取消分组来从组中移除所有表单元素。 您可以按 Ctrl 键，选择要移除的每个元素，然后将其从组中拖出，以便从组中移除多个元素。

将条件字段组添加到表单

如果数据所有者在 ArcGIS Pro 中为数据创建了条件字段组，则条件字段组将显示在表单画布旁的字段组列表中。

由于字段相关（一个字段的值将确定或限制可为其他字段设置的值），因此当您从字段组列表中添加条件字段时，会将其添加到组元素中的表单。 条件字段应保持分组在一起，以便编辑者随后在 Map Viewer 中填写这些条件字段。 如果您从其字段组中移除字段，则将显示一条警告。

将一起列出共享一个或多个字段的条件字段组。 可将其作为一个字段组添加到表单中。

必须添加到表单的字段组将显示在列表的必填部分中。 如果已在 ArcGIS Pro 中将字段组配置为限制性条件字段组，则这些字段组为必填项，这意味着编辑者在编辑此字段组中的字段时所提供的属性值必须符合条件值定义。

警告：

如果您未将必填条件字段组添加到表单画布，则编辑者无法使用表单来编辑要素图层。

要了解如何在 ArcGIS Pro 中创建条件字段组，请参阅创建和管理条件值。

请按照以下步骤将条件值字段组添加到表单：

1. 可以使用以下方法之一将字段组添加到表单：
   • 逐一添加字段 - 要将单个字段组添加到表单，请双击该字段组或将其拖动到表单画布中。
   • 将字段组选择添加到表单 - 要将特定字段组选择添加到表单，请按 Ctrl 键，单击要包含的字段组，然后将其拖动到表单画布中。
   • 将所有字段组添加到表单 - 单击字段组列表中的全部添加以在表单的图层中包含所有字段。

   提示：

   如果图层或表中包含大量字段组，则可以使用字段组列表中的查找字段组搜索栏来定位特定字段组。

2. 将字段组作为元素添加到表单后，需要格式化组元素并格式化字段元素。

将格式应用于表单元素

当您在表单画布上选择表单元素时，将显示属性窗格。

上一章节描述了组元素的设置属性。

对于字段元素，属性窗格的格式化部分显示您可以为表单上的元素定义的属性以及从图层继承且无法为表单更改的属性。 以下几节介绍了可为表单上的字段元素定义的属性。

定义显示名称

每个表单元素都需要显示名称设置的值。 显示名称是伴随表单元素的标注。

对于字段，默认显示名称与字段名称相同。 接受默认名称或为每个字段输入一个更加用户友好或更具描述性的显示名称。

格式化文本元素

如果表单元素引用字符串字段，请按照以下步骤设置元素的格式：

1. 选择文本表单元素以打开属性窗格。
2. 单击输入类型下拉菜单并选择其中一个选项。
   • 条形码 - 此功能只能在具有条形码阅读器的应用程序中使用。 如果您选择此输入类型，则该元素将在无法读取条形码作为输入的应用程序中恢复为单行文本，例如 Map Viewer。
   • 文本 - 单行 - 表单上的输入字段将显示单行文本。
   • 文本 - 多行 - 表单上的输入字段将有几行高。 将此输入类型用于最大长度较高的文本字段，以允许编辑者查看该字段中的所有文本。
3. 要在提示编辑者输入正确值的字段中显示文本，请在占位符字段中输入该文本。

   例如，您可以输入 Type the applicant's first name 作为存储申请贷款人员名字的字段的占位符文本。

   占位符文本出现在输入字段元素内，并由编辑者提供的文本替换。

   您不能为定义了默认值的字段设置占位符文本。

4. 在描述字段中，提供解释该字段中的值所代表内容的文本。

   描述显示在表单上的元素下方。

5. 设置元素的最小长度（最小字符长度）和最大长度（最大字符长度）。

   有时，要素图层会使用默认文本字段大小而不是对该字段有意义的长度发布。 例如，只能具有有限数量值（例如是、否或未知）的字段在要素图层中的字段长度可能为 256 个字符。 但是，如果您希望编辑者在编辑字段中的值时仅键入 y、n 或 u，则可以将最小值和最大值设置为 1。

   您不能设置超过字段长度的最大字符长度。

6. 选中必填旁边的复选框以定义编辑者必须为该字段输入一个值。

   有关详细信息，请参阅根据需要定义元素。

7. 要防止编辑者使用表单更新此字段中的值，取消选中可编辑复选框。

   例如，您可能包含一个用于引用目的的字段，但您不希望编辑者更改该字段中的值。

格式化日期和时间元素

要格式化引用日期和时间字段的元素，请按照以下步骤进行操作：

1. 选择日期和时间表单元素以打开其属性窗格。
2. 如果该字段为日期字段类型，请单击输入类型下拉菜单并选择其中一个选项。
   • 日期 - 这允许编辑者提供日期。
   • 日期和时间 - 这允许编辑者提供日期和时间。
3. 在描述字段中，提供解释该字段中的值所代表内容的文本。

   描述显示在表单上的元素下方。

4. 对于仅时间或时间戳偏移元素，请选择表单允许编辑者输入的时间精度。
   • hh - 允许编辑者输入小时。
   • hh:mm - 允许编辑者输入小时和分钟。
   • hh:mm:ss - 允许编辑者输入小时、分钟和秒。

     注：

     秒可以存储在该字段中，但不会显示在 ArcGIS Online 中。

5. 对于日期元素，可选择设置开始日期和结束日期参数的值以限制编辑者可以使用的日期范围。

   例如，对于记录将在一年第一季度完成的检查的新图层中的日期字段，将相应年份的开始日期设置为一年的第一天，将结束日期设置为 3 月 31 日。

6. 对于日期和时间元素，可选择设置开始时间和结束时间参数的值。

   例如，对于仅在工作时间使用的表单，您可以限制开始和结束时间，使其不会超出您的工作时间。

7. 要允许编辑者在编辑时间戳偏移元素时指定时区，请选中允许用户设置时区复选框。
8. 选中必填旁边的复选框以定义编辑者必须为该字段输入一个值。

   有关详细信息，请参阅根据需要定义元素。

9. 要防止编辑者使用表单更新此字段中的值，取消选中可编辑复选框。

   例如，您可能包含一个用于引用目的的字段，但您不希望编辑者更改该字段中的值。

格式化数字元素

如果元素使用双精度、整型或大整数数据类型的要素图层字段，请按照以下步骤格式化表单元素：

1. 选择文本表单元素以打开属性窗格。
2. 单击输入类型下拉菜单并选择其中一个选项。
   • 条形码 - 此功能只能在具有条形码阅读器的应用程序中使用。 如果您选择此输入类型，则该元素将在无法读取条形码作为输入的应用程序中恢复为默认输入类型，例如 Map Viewer。
   • 数字 - 双精度 - 如果图层中的字段定义为双精度，用于编辑地图的应用程序不接受条形码作为输入，且编辑者必须输入十进制数字，则请选择数字 - 双精度。
   • 数字 - 整型 - 如果图层中的字段定义为整型、大整数或双精度，用于编辑地图的应用程序不接受条形码作为输入，且编辑者不应输入十进制数字，则请选择数字 - 整型。
3. 要在提示编辑者输入正确值的字段中显示文本，请在占位符字段中输入该文本。

   例如，您可以输入 Type the applicant's first name 作为存储申请贷款人员名字的字段的占位符文本。

   占位符文本出现在输入字段元素内，并由编辑者提供的文本替换。

   您不能为定义了默认值的字段设置占位符文本。

4. 在描述字段中，提供解释该字段中的值所代表内容的文本。

   描述显示在表单上的元素下方。

5. 选中必填旁边的复选框以定义编辑者必须为该字段输入一个值。

   有关详细信息，请参阅根据需要定义元素。

6. 要防止编辑者使用表单更新此字段中的值，取消选中可编辑复选框。

   例如，您可能包含一个用于引用目的的字段，但您不希望编辑者更改该字段中的值。

格式化包含三个或更多值列表的元素

如果为要素图层中的字段定义了包含三个或更多值的列表，则可以将表单元素配置为显示为组合框或选项按钮。

1. 选择引用字段的表单元素，该字段定义了值列表以打开其属性窗格。
2. 在格式化部分中，单击输入类型下拉菜单，然后选择以下的一个选项：
   • 组合框 - 表单用户可从可用选项列表中选择一个值。
   • 单选按钮 - 所有选项都显示在表单上，旁边有选项按钮。 表单用户可单击适当的按钮。

   如果列表包含很多值（例如，七个或更多值），组合框可以节省表单空间。

3. 在描述字段中，提供解释该字段中的值所代表内容的文本。

   描述显示在表单上的元素下方。

4. 选中必填旁边的复选框以定义编辑者必须为该字段输入一个值。

   有关详细信息，请参阅根据需要定义元素。

5. 要防止编辑者使用表单更新此字段中的值，取消选中可编辑复选框。

   如果表单元素不可编辑，表单上的按钮或列表选项设置会显示属性的现有值。 如果添加要素，则组合框或按钮元素不会显示任何值，除非该字段定义了默认值。

格式化具有两个可能值的元素

如果要素图层中的字段定义了一个仅包含两个可能值的列表，并且该字段在图层中设置了默认值，则可以将该元素定义为在表单上显示为切换开关，或显示为组合框或按钮。

如果图层中的字段没有设置默认值，您可以将元素配置为在表单上显示为组合框或按钮。

1. 选择引用字段的表单元素，该字段定义了双值列表和默认值以打开其属性窗格。
2. 在格式化部分中，单击输入类型下拉菜单以选择如何呈现该元素：
   • 组合框 - 表单用户可从下拉列表中选择其中一个值。
   • 单选按钮 - 两个选项都显示在表单上，旁边有按钮。 表单用户可单击适当的按钮。
   • 切换 - 表单用户可启用或禁用切换开关。

     您可以通过单击切换值旁边的切换值顺序按钮将哪个值更改为等于启用的开关。

     如果字段没有设置默认值并且您选择切换作为输入类型，则该元素在表单上显示为组合框。

3. 在描述字段中，提供解释该字段中的值所代表内容的文本。

   描述显示在表单上的元素下方。

4. 选中必填旁边的复选框以定义编辑者必须为该字段输入一个值。

   有关详细信息，请参阅根据需要定义元素。

5. 要防止编辑者使用表单更新此字段中的值，取消选中可编辑复选框。

   如果表单元素不可编辑，表单上的按钮、列表选项或切换开关设置会显示属性的现有值。 如果添加要素，则组合框或按钮元素不会显示任何值。 对于切换元素，默认设置显示在表单上。

格式化相关记录元素

您可以通过格式化相关记录元素的描述、排列顺序和可预览的数量来自定义相关记录元素在表单中的显示。 按照以下步骤格式化相关记录元素：

1. 选择相关记录元素以打开属性窗格。
2. 在描述字段中，提供解释该字段中的值所代表内容的文本。

   描述显示在表单上的元素下方。

3. 单击排序方式下拉菜单，然后选择用于对相关记录进行排序的字段。
4. 单击排序顺序下拉菜单，然后选择相关记录的排序方式。

   如果按字符串、双精度型或整型字段进行排序，则可以按升序或降序值排序。 如果按日期字段进行排序，则可以按最近或最晚的值排序。

5. 单击预览计数下拉菜单，然后选择可以在表单中预览的相关记录数。

   选择大于 3 的值可能需要在表单上进行额外的滚动，因此不推荐进行此操作。

注：

可以为相关表创建一个单独的表单，然后从相关表中选择要显示的字段以及对其进行格式化的方式。

根据需要定义元素

要强制为字段输入数据，您可以配置表单元素，以便它们需要条目。 例如，如果所有应用程序都需要提交日期，则将提交日期元素配置为必需。

当编辑者使用表单时，他们会在需要输入的字段旁边看到一个星号，并且在提供值之前他们无法保存他们的编辑。

1. 单击字段表单元素以打开属性窗格。
2. 在逻辑部分，选中必填复选框。

   * 必填片段随即出现在表单元素上，表示编辑者必须为此字段提供一个值。

添加逻辑以使表单根据条件地动态化

可以根据使用 ArcGIS Arcade 表达式定义的以下逻辑条件使表单动态化：

• 条件可见 - 有条件地显示或隐藏表单元素。
• 条件必填 - 在特定条件下，要求输入表单元素。
• 条件可编辑 - 有条件地启用表单元素的编辑功能。
• 计算的值 - 根据属性、几何和账户信息自动计算数据。

定义后，可以为其他表单元素重用表达式。

配置条件可见性

您可以根据添加到先前字段的值有条件地显示或隐藏表单元素。 例如，“建筑物评估”表单中包含了一个用于指示是否存在水损害的字段。 该表单中还包括一个包含与水损害相关的字段的组表单元素。 可以将条件可见性表达式应用于水损害组，以便仅在较早字段中指示了水损害时才显示该组。 要创建条件可见性表达式，请完成以下步骤：

1. 单击字段表单元素以打开属性窗格。
2. 在逻辑部分中，单击可见复选框旁边的按钮 表达式。

   表达式弹出窗口随即出现，显示先前为表单创建的表达式。

3. 单击新建表达式。

   随即显示表达式构建器窗口。 构建器允许您在将表达式保存到所选表单元素之前在 Arcade 中编写和预览表达式。

4. 在标题文本框中，为表达式添加标题。
5. 定义表达式

   例如，如果一个水损害组元素只需要在较早的字段中指示水损害时才需要出现，则可以使用以下条件来构建表达式：

   • 字段名称 - 水损害
   • 运算符 - is
   • 值 - Yes

   以下是 Arcade 语法中相同的表达式：

   DomainName($feature, "water_damage") == "Yes"

   Map Viewer 将应用 Arcade 表单约束配置文件来评估要素是否符合表达式中定义的条件。 如果 water_damage 字段中指示了 Yes 以外的值，则水损害组将不显示在表单中。

6. 单击完成关闭表达式构建器。

   </> 可见性片段随即出现在表单元素上，表示已应用条件可见性表达式。

7. 单击保存。

   条件可见性表达式随即应用于组或字段。

   现在您已经保存了表达式，并可以将其应用于任何表单元素。 您可以通过单击表达式弹出窗口中表达式旁边的数字来查看哪些元素正在使用表达式。 请参阅重用表达式以了解详细信息。

   注：

   可以随时使用表达式弹出窗口中的溢出菜单复制、编辑或删除表达式。

您可以随时通过条件可见性菜单复制、编辑或删除表达式。 要使用 Arcade 编辑表达式，请从此菜单中单击编辑 Arcade。

配置条件必需元素

您可以根据先前在表单中输入的值有条件地要求填写表单元素。 例如，只有当风暴泥石流的长度大于 3 米时，才需要泥石流描述字段。

1. 单击字段表单元素以打开属性窗格。
2. 在逻辑部分中，单击必填复选框旁边的按钮 表达式。

   表达式弹出窗口随即出现，显示先前为表单创建的表达式。

3. 单击新建表达式。

   随即显示表达式构建器窗口。 该构建器允许您在将表达式保存到所选字段或组之前在 Arcade 中编写和预览表达式。

4. 在标题文本框中，为表达式添加标题。
5. 定义表达式。

   每个表达式由一个或多个条件定义。 条件包括字段名称、运算符和可能的值。 可用运算符列表由字段类型（字符串、数字或日期）决定。

   例如，如果仅在泥石流大于 3 米时才需要泥石流描述字段，则可以使用以下条件来构建表达式：

   • 字段名称 - debris_length
   • 运算符 - is greater than
   • 值 - 3

   以下是 Arcade 语法中的相同表达式：

   ($feature, "debris_length") > 3

   注：

   要创建更复杂的表达式，请单击启动 Arcade 编辑器。

   当将多个条件应用于相同要素时，对于必需的表单元素，可以选择所有条件都必须为 true 还是只有一个条件必须为 true。

   ArcGIS Online 将应用 Arcade 表单约束配置文件来评估要素是否符合表达式中定义的条件。 如果在泥石流长度字段中输入的值小于 3，则表单中不需要泥石流描述字段。

6. 单击完成以保存表达式。

   </> 必填片段随即出现在表单元素上，表示已应用必填表达式。

现在您已经保存了表达式，并可以将其应用于任何表单元素。 您可以通过单击表达式弹出窗口中表达式旁边的数字来查看哪些元素正在使用表达式。 请参阅重用表达式以了解详细信息。

注：

可以随时使用表达式弹出窗口中的溢出菜单复制、编辑或删除表达式。 要使用 Arcade 编辑表达式，请从此菜单中单击编辑 Arcade。

配置条件编辑

您可以根据先前在表单中输入的值有条件地启用表单元素的编辑功能。 例如，如果 pipe_replaced 字段值设置为 yes，则编辑者应该仅编辑 date_pipe_replaced 字段中的值。

1. 单击字段表单元素以打开属性窗格。
2. 在逻辑部分中，单击可编辑复选框旁边的按钮 表达式。

   表达式弹出窗口随即出现，显示先前为表单创建的表达式。

3. 单击新建表达式。

   随即显示表达式构建器窗口。 该构建器允许您在将表达式保存到所选字段或组之前在 Arcade 中编写和预览表达式。

4. 在标题文本框中，为表达式添加标题。
5. 定义表达式。

   每个表达式由一个或多个条件定义。 条件包括字段名称、运算符和可能的值。 可用运算符列表由字段类型（字符串、数字或日期）决定。

   例如，如果管道替换日期仅在 pipe_replaced 字段值为 yes 时才可编辑，则可以使用以下条件来构建表达式：

   • 字段名称 - pipe_replaced
   • 运算符 - is
   • 值 - yes

   以下是 Arcade 语法中相同的表达式：

   ($feature, "pipe_replaced") == "yes"

   注：

   要创建更复杂的表达式，请单击启动 Arcade 编辑器。

   如果使用了多个条件，则对于要编辑的表单元素，可以选择所有条件都必须为 true 还是只有一个条件必须为 true。

   ArcGIS Online 将应用 Arcade 表单约束配置文件来评估要素是否符合表达式中定义的条件。 如果在检查器 ID 字段中输入了 4367 以外的值，则将无法在表单中编辑管道 ID 字段。

6. 单击完成。

   </> 可编辑片段随即出现在表单元素上，表示已应用必填表达式。

现在您已经保存了表达式，并可以将其应用于任何表单元素。 您可以通过单击表达式弹出窗口中表达式旁边的数字来查看哪些元素正在使用表达式。 请参阅重用表达式以了解详细信息。

注：

可以随时使用表达式弹出窗口中的溢出菜单复制、编辑或删除表达式。 要使用 Arcade 编辑表达式，请从此菜单中单击编辑 Arcade。

添加表达式以计算字段值

可以向表单添加计算表达式来字段计算和填充数据。 这将自动计算字段值，从而节省编辑者时间并保证数据完整性。

使用 Arcade 根据要素属性和几何构建计算表达式。 例如，可以向存储桥梁检测计划日期的字段添加计算表达式。 例如，当编辑者将桥梁状况字段值设置为 damaged 时，在检测日期字段上定义的表达式可通过在桥梁检测字段中填充该日期，自动将下一次检测计划为在一周后进行。

计算表达式为动态表达式，意味着它们会在信息更改时自动更新表单。 因此，编辑者可以在提交表单之前查看更新计算。 由于计算表达式字段中的值填充为表达式，因此编辑者无法在表单中为该字段键入值。

要创建计算表达式，请完成以下步骤：

1. 单击字段表单元素以打开属性窗格。

   警告：

   如果为表单元素启用了编辑功能，则表达式将不会运行。

2. 在逻辑部分中，单击计算值部分中的按钮 表达式。
3. 单击新建表达式。

   随即显示 Arcade 编辑器窗口。 编辑器允许您在将表达式保存到所选表单元素之前编写和测试表达式。

4. 在标题文本框中，为表达式添加标题。
5. 写入计算表达式。

   例如，以下表达式用于在计算以平方米为单位的面积之前检查面要素几何是否为空。 将在下一部分节中提供其他示例。

   if (IsEmpty(Geometry($feature))){
       return;
   }
   else{
       Area($feature, 'square-meters')
   }

   要了解有关使用 Arcade 计算面积的详细信息，请参阅面积（几何函数）。

   有关 Arcade 中提供的所有函数列表，请参阅 Arcade 函数索引。

6. 单击运行以测试表达式，确保表达式不会生成错误。
7. 单击完成以关闭 Arcade 编辑器。

   </> 计算片段随即出现在表单元素上，表示已应用计算表达式。

8. 单击保存保存表达式和表单。

   在保存表达式后，您可以通过选择表单元素，然后单击之前创建的表达式将其应用于任何表单元素。 您可以通过单击计算表达式下的属性窗格中表达式旁边的编号，来查看哪些元素正在使用 Arcade 表达式。

   注：

   您可以随时通过计算表达式菜单复制、编辑或删除表达式。

计算表达式示例

以下是计算表达式的示例：

• 提供日期信息 - 以下示例表达式为日期字段提供当前日期：

  return Today();

  要了解有关可使用 Arcade 访问的日期信息的详细信息，请参阅日期函数。
• 从相交图层提取信息 - 以下表达式适用于表单中的邮政编码字段并从相交宗地图层提取邮政编码值：

  if (IsEmpty(Geometry($feature))){
      return;
  }
  else{
      var parcels_FS = Intersects($feature, FeatureSetByName($map,"Redlands parcels")); 
       if (Count(parcels_FS) == 1){ 
         return Text(First(parcels_FS).ZIP_CODE);
       }
  }

  要了解有关使用 Arcade 从相交图层提取信息的详细信息，请参阅相交（几何函数）。

有关 Arcade 中提供的所有函数列表，请参阅 Arcade 函数索引。

重用表达式

创建表达式后，可以跨表单元素重复使用它。 例如，您可以根据用于要求另一个表单元素的相同表达式有条件地显示某个表单元素，并且可以使用相同的计算来填充多个字段。

按照以下步骤对表单元素使用现有表达式：

1. 配置表单时，单击表单元素以打开属性窗格。
2. 在逻辑部分中，单击要添加的表达式类型旁边的表达式按钮 。

   表达式弹出窗口或计算表达式弹出窗口随即出现，显示先前为表单创建的表达式。

   提示：

   表达式旁边的数值表示当前应用该表达式的表单元素的数量。 单击此数值会打开另一个弹出窗口，显示当前使用该表达式的表单元素及其属性。

   单击显示表达式类型的片段上的 X，可以从任何表单元素属性中移除表达式。

3. 选择要应用的表达式。

   片段随即出现在表单元素上，表示已应用该表达式。