如果地图包含要素图层(托管要素图层、托管要素图层视图、托管表图层、子类型图层组或 ArcGIS Server 要素图层),您可以定义编辑者在更新 web 地图中要素图层的字段值时可以使用的表单。 可以为地图中的每个要素图层定义一个表单,也可以仅为您知道地图用户需要编辑的相应图层定义一个表单。
提示:
如果您拥有地图中的要素图层或者您是组织管理员,则可以在启用编辑之前为要素图层项目配置表单。
配置表单时,指定表单包含哪些表单元素以及这些元素的显示方式。 拥有表单有助于将编辑者引导到正确的字段和每个可编辑字段的允许属性值。
表单可以作为地图或图层的一部分保存。 当您共享地图或图层时,其他人可以使用您定义的表单来编辑地图中的要素图层或相关记录。 有关详细信息,请参阅以下保存表单部分。
注:
当前,您可以在 ArcGIS Online 和 ArcGIS Enterprise 中的 Map Viewer 和 Field Maps Designer 中配置表单。
配置表单之前
在为地图中的要素图层配置表单之前,请先熟悉图层的内容和字段设置。 字段包含的内容会影响您是否为字段创建元素组。 应用于字段的设置(例如是否允许空值、是否定义默认值以及图层所有者是否为字段定义列表)会影响您在表单上设置字段元素的格式。
配置表单
您可以为地图中的每个要素图层配置一个输入表单。 您可以定义哪些字段(元素)出现在表单上以及所在位置。
当编辑者选择可编辑要素图层中的要素时,会显示表单,以便编辑者可以输入该图层的属性值。
要为地图中的要素图层配置表单,请完成以下步骤:
- 确认您已登录组织,并且具备创建、更新和删除内容的权限。
- 在内容(深色)工具栏中,单击图层以打开图层窗格。
- 向地图添加要素图层。
- 选择要素图层后,请单击设置(浅色)工具栏上的配置编辑
,然后单击表单
。随即显示配置表单窗口。
- 单独使用或组合使用以下选项向表单添加元素:
表单元素是字段分组和显示在表单上的输入字段。 字段元素基于要素图层中的现有字段。
- 转换现有弹出窗口 - 如果您为要素图层配置了弹出窗口,则可以使用现有的弹出窗口配置作为配置表单的起点。
- 添加基本表单元素 - 编辑者可以使用基本表单元素提供诸如日期、数字、文本以及从条形码扫描的数据等信息。
- 添加选择表单元素 - 编辑者可以使用选择表单元素从定义的值列表中进行选择。
- 添加附件 - 编辑者可以使用附件元素上传文档、媒体和其他文件。
- 创建元素组 - 您可以创建可展开和可折叠的组元素,以在表单上将逻辑相关的信息放在一起。
- 添加描述性文本 - 您可以为表单添加描述性文本,以提供描述表单元素用途的上下文信息。
- 添加字段 - 选择图层中的哪些字段要添加到表单。 当字段被添加到表单画布时,就变成了表单元素。
- 添加相关记录元素 - 当要素图层具有相关的表或要素图层时,可以向表单添加相关记录元素。
- 添加条件值字段组 - 如果要素图层中的数据已定义条件值,则字段组列表将显示在表单构建器中。 由此可在单个步骤中将逻辑相关的字段组添加到表单画布。
- 在将元素添加到表单画布后,格式化每个元素。
- 或者,编写 ArcGIS Arcade 表达式来定义影响元素的条件。
- 为表单上的元素添加、格式化和配置条件表达式后,单击确定。
- 保存表单。
注:
如果关闭地图而不保存,您将丢失表单。
如果您需要更改表单,请重复上述步骤。 请务必在编辑表单后保存。
转换现有弹出窗口
如果要素图层已配置弹出窗口,请单击转换弹出窗口以将弹出窗口中的字段添加到表单画布。
弹出窗口配置中不包含的字段显示在表单构建器的字段列表中。 您可以将它们拖到表单画布上,将它们作为元素添加到表单中,如下一章节所述。
将字段作为元素添加到表单后,您可以创建组来聚合相关字段或继续格式化字段元素。
注:
包含高精度 GPS 元数据的字段无法添加到表单中。
添加基本表单元素
编辑者可以使用基本表单元素提供诸如日期、数字、文本以及从条形码扫描的数据等信息。 基本表单元素列在基本下的表单元素列表中,包括以下内容:
| 表单元素 | 字段类型 | 描述 |
|---|---|---|
条形码 | 双精度型、整型、大整型或字符串 | 扫描条形码或 QR 码以输入值。 |
日期 | 仅日期 | 以 YYYY-MM-DD 格式输入日期。 |
日期和时间 | 日期或时间戳偏移 | 输入日期和时间。 |
时间 | 仅时间 | 以 hh:mm 或 hh:mm:ss 格式输入时间 |
数值 - 双精度型 | 双精度 | 输入十进制数值,例如 1.2。 |
数值 - 整型 | 整型 | 输入整数值,例如 2。 |
文本 - 多行 | 字符串 | 输入多行文本。 |
文本 - 单行 | 字符串 | 输入文本的单个行。 |
要向表单中添加基本元素,请完成以下步骤:
注:
无法将表单元素添加到要素图层视图或子类型图层组。
- 在基本列表中,将一个元素拖动到表单画布上。
基本元素已添加到表单画布上。
- 设置基本表单元素的属性格式。
添加选择表单元素
编辑者可以使用选择表单元素从定义的值列表中进行选择。 选择表单元素列在选择下的表单元素列表中,包括以下内容:
| 表单元素 | 字段类型 | 描述 |
|---|---|---|
组合框 | 双精度型、整型或字符串 | 从下拉菜单中显示的值的列表中进行选择。 |
多项选择 | 字符串 | 从显示为按钮的值的列表中选择一个或多个选项。 |
单选按钮 | 双精度型、整型或字符串 | 从显示为按钮的值的列表中选择一个选项。 |
切换 | 双精度型、整型或字符串 | 从显示为切换的 2 个值中选择其中一个值。 |
要向表单中添加选项元素,请完成以下步骤:
- 在选项列表中,单击重新定位
,然后将一个元素拖动到表单画布上。选项元素已添加到表单画布上。
- 单击表单画布上的元素以将其选中。
- 在属性窗格的格式化部分中,通过以下任一方式创建值列表:
- 对于组合框、多项选择或单选按钮元素,单击创建列表,然后输入或导入值。 单击完成以将值添加到列表中,并返回属性窗格。 (可选)从默认值下拉菜单中选择一个默认值。
- 对于开关元素,在开关值下,为关闭值和开启值提供值。 从默认值下拉菜单中选择一个默认值。
- 设置选择表单元素的属性格式。
添加附件
如果图层所有者已在图层上启用了附件,编辑者可以提供音频、文档和媒体等信息。 附件元素在附件下的表单元素列表中列出,并包含以下内容:
| 附件元素 | 输入类型 | 描述 |
|---|---|---|
常规 |
| 在单个附件元素中捕获或上传一个或多个附件类型。 一般附件元素的灵活性最高,且支持在单个附件元素中包含多种不同的附件类型。 您可以限制可用的输入类型。 |
文档 |
| 上传文档文件类型,例如 PDF、Microsoft Excel 电子表格和 Microsoft Word 文档。 您可以自定义文件最大大小的值。 选项包括:无、1 MB、5 MB、10 MB、100 MB 或“自定义”。 默认文件大小为 10 MB。 |
媒体 |
| 为给定元素上传特定的媒体类型。 音频或视频附件的最大持续时间为 10 分钟。 您还可以定义最长持续时间值,以限制附件的大小。 |
要将附件元素添加到表单,请完成以下步骤:
- 在附件列表中,将附件元素拖动到表单画布上。
附件元素已添加到表单画布上。
- 设置附件元素的属性格式。
添加描述性文本
可以向表单添加描述性文本,以提供关于表单元素的上下文信息或其他详细信息。 描述性文本为只读文本,无法通过表单编辑器更改。
要向表单添加描述性文本元素,请完成以下步骤:
创建元素组
要将表单上同一物理位置中的相关字段分组,请创建组元素。 分组元素类似于将问题放在纸质表单的同一章节。 数字表单上的组具有额外的优势,即它们可以收缩以仅显示组标题,直到表单用户展开组。
例如,在用于更新路径要素图层内容的表单上,为与路径属性相关的所有字段(例如路径名称、类型和难度)创建一个组。 您可以为记录路径维护信息的字段创建一个单独的组,例如维护工作队名称、上次执行维护的日期以及执行维护的描述。 如果您选择在组折叠的情况下打开表单,则编辑者在展开组之前只会看到两个组名称。
要将相关元素分组到表单的可折叠部分中,请完成以下步骤:
- 将组元素从表单元素列表拖动到表单画布上。
表单元素随即添加到表单画布中。
- 将相关字段拖动到组中。
您可以从表单构建器面板中的字段列表或表单画布中拖动字段。
- 选择组元素以编辑其属性。
属性窗格随即出现,以便您编辑以下信息:
- 显示名称 - 提供描述组中包含的字段的名称。 这类似于纸质表单上的章节标题。 该值为必填项。
- 描述 - 提供对组的描述。
- 初始状态 - 默认情况下,当表单打开时组会展开,这意味着所有字段都自动可见。 如果您希望收缩组的初始状态,请取消选中已展开复选框。 表单用户将单击组以将其展开并查看其包含的字段。
- 条件可见性 - 添加一个 Arcade 属性表达式,以应用关于该组何时显示在表单上的规则。 有关详细信息,请参阅以下配置条件可见性部分。
提示:
您可以通过从组工具栏中选择取消分组来从组中移除所有表单元素。 您可以按 Ctrl 键,选择要移除的每个元素,然后将其从组中拖出,以便从组中移除多个元素。
添加字段
选择图层中的哪些字段作为表单元素呈现给编辑者。 在大多数情况下,您添加编辑者将用于更新值的字段。
例如,如果要素图层包含以下字段 - 站点名称、站点类型、构建状态、景观、编辑日期、编辑者名称、创建日期、创建者名称、ID 和形状 - 您可以仅在表单上放置站点名称、站点类型、构建状态和景观字段,因为编辑日期、编辑者名称、创建日期、创建者名称和 ID 字段是自动填充的,并且在编辑者向图层添加要素时填充形状字段。
您还可以添加字段以供参考并禁用对表单元素的编辑。 在前面的示例中,您可以将“编辑日期”字段作为不可编辑元素包含在表单中,以便编辑者可以查看要素的上次更新时间。
要向表单添加字段,请完成以下步骤:
- 要将图层中的字段作为元素添加到表单,请执行以下操作之一:
- 将所有字段添加到表单 - 单击字段列表中的全部添加以在表单的图层中包含所有字段。 当图层中有很多可编辑字段时,添加所有字段并删除一两个系统或不可编辑字段比添加单个字段更快。
- 向表单添加一组字段 - 要在表单上包含特定选择的字段,请按住 Ctrl 键,单击要包含的字段,然后将它们拖动到表单画布上。
- 逐个添加字段 - 要逐次将单个字段添加到表单,请双击该字段或将其拖动到表单画布中。
提示:
如果图层或表中包含大量字段,则可以使用字段列表中的查找字段搜索栏来定位特定字段。
- 或者,将字段作为元素添加到表单后,创建组或继续格式化字段元素。
添加相关记录元素
如果您在发布托管要素图层之前在 ArcGIS Pro 地理数据库中创建了关系类,如果使用包含关系类的模板创建了托管要素图层,或者在 ArcGIS Survey123 Connect 中为包含重复部分的表单创建了托管要素图层,则可以向表单添加相关记录元素。 这允许用户在填写表单时查看和添加与托管要素图层相关的记录,例如表格。
例如,在用于监测城市树木健康状况的表单中,相关表单可以包括对每棵树的检查。 通过向表单添加相关记录元素,可以在编辑树要素的属性时向相关表添加新检查。
注:
- 对于数据,必须存在关系类,才能向表单添加相关记录元素。
- 要编辑相关记录,图层及其相关表或要素图层必须在地图中,并且每个相关表或图层必须已启用编辑功能。
- 目前支持源数据中要素类(源)和表(目标)或要素类(目标)之间的一对一和一对多关系基数。
- 目前,托管要素图层和托管要素图层视图支持向表单添加相关记录元素。 还支持参与存在目标要素图层或表的关系的托管表。
要向表单添加相关记录元素,请完成以下步骤:
- 在相关记录列表中,双击相关记录元素或将其拖动到表单画布。
相关记录元素将添加到表单画布。
- 格式化相关记录元素的属性。
将条件字段组添加到表单
如果数据所有者为数据创建了条件字段组,则这些字段组会显示在表单画布旁边的字段组列表中。
注:
也可以在 ArcGIS Pro 中创建条件字段组。 要了解详细信息,请参阅创建和管理条件值。
由于字段相关(一个字段的值将确定或限制可为其他字段设置的值),因此当您从字段组列表中添加条件字段时,会将其添加到组元素中的表单。 条件字段应保持分组在一起,以便编辑者随后在 Map Viewer 中填写这些条件字段。 如果您从其字段组中移除字段,则将显示一条警告。
将一起列出共享一个或多个字段的条件字段组。 可将其作为一个字段组添加到表单中。
必须添加到表单的字段组将显示在列表的必填部分中。 如果已将字段组配置为限制性条件字段组,则这些字段组为必填项,这意味着编辑者在编辑此字段组中的字段时所提供的属性值必须符合条件值定义。
警告:
如果您未将必填条件字段组添加到表单画布,则编辑者无法使用表单来编辑要素图层。
要向表单添加条件值字段组,请完成以下步骤:
将格式应用于表单元素
当您在表单画布上选择表单元素时,将显示属性窗格。
对于基本、选择和字段元素,属性窗格中的格式化部分显示了您可以为表单上的元素定义的属性。 以下各节介绍了您可以为表单上的元素定义的属性。
要应用组格式,请参阅创建元素组。
注:
对于字段元素,某些属性是从图层继承的,无法在表单中进行更改。
定义显示名称
每个表单元素都需要显示名称设置的值。 显示名称是伴随表单元素的标注。
对于字段,默认显示名称与字段名称相同。 接受默认值,或者为每个字段提供一个更用户友好或更具描述性的显示名称。
格式化文本元素
如果表单元素引用字符串字段,请完成以下步骤来设置元素的格式:
- 选择文本表单元素以打开属性窗格。
- 单击输入类型下拉菜单,然后选择以下选项之一:
- 条形码 - 此功能只能在具有条形码阅读器的应用程序中使用。 如果您选择此输入类型,则该元素将在无法读取条形码作为输入的应用程序中恢复为单行文本,例如 Map Viewer。
- 文本 - 多行 - 表单上的输入字段将有几行高。 将此输入类型用于最大长度较高的文本字段,以允许编辑者查看该字段中的所有文本。
- 文本 - 单行 - 表单上的输入字段将显示单行文本。
- 要在提示编辑者输入正确值的字段中显示文本,请在占位符字段中提供该文本。
例如,您可以输入 Type the applicant's first name 作为存储申请贷款人员名字的字段的占位符文本。
占位符文本出现在输入字段元素内,并由编辑者提供的文本替换。
您不能为定义了默认值的字段设置占位符文本。
- 在描述字段中,提供解释该字段中的值所代表内容的文本。
描述显示在表单上的元素下方。
- 设置元素的最小长度(最小字符长度)和最大长度(最大字符长度)。
有时,要素图层会使用默认文本字段大小而不是对该字段有意义的长度发布。 例如,只能具有有限数量值(例如是、否或未知)的字段在要素图层中的字段长度可能为 256 个字符。 但是,如果您希望编辑者在编辑字段中的值时仅键入 y、n 或 u,则可以将最小值和最大值设置为 1。
您不能设置超过字段长度的最大字符长度。
- 选中必填复选框以定义编辑者必须为该字段输入一个值。
有关详细信息,请参阅根据需要定义元素。
- 要防止编辑者使用表单更新此字段中的值,取消选中可编辑复选框。
例如,包含一个用于引用目的的字段,但您不希望编辑者更改该字段中的值。
格式化日期和时间元素
要设置引用日期和时间字段的元素的格式,请完成以下步骤:
- 选择日期和时间表单元素以打开其属性窗格。
- 如果字段是日期字段类型,单击输入类型下拉菜单,然后选择以下选项之一:
- 日期 - 这允许编辑者提供日期。
- 日期和时间 - 这允许编辑者提供日期和时间。
- 在描述字段中,提供解释该字段中的值所代表内容的文本。
描述显示在表单上的元素下方。
- 对于仅时间或时间戳偏移元素,请选择表单允许编辑者输入的时间精度,如下所示:
- hh - 允许编辑者输入小时。
- hh:mm - 允许编辑者输入小时和分钟。
- hh:mm:ss - 允许编辑者输入小时、分钟和秒。
注:
秒可以存储在该字段中,但不会显示在 ArcGIS Online 中。
- 对于日期元素,可选择设置开始日期和结束日期参数的值以限制编辑者可以使用的日期范围。
例如,对于记录将在一年第一季度完成的检查的新图层中的日期字段,将相应年份的开始日期设置为一年的第一天,将结束日期设置为 3 月 31 日。
- 对于日期和时间元素,可选择设置开始时间和结束时间参数的值。
例如,对于仅在工作时间使用的表单,您可以限制开始和结束时间,使其不会超出您的工作时间。
- 要允许编辑者在编辑时间戳偏移元素时指定时区,请选中允许用户设置时区复选框。
- 选中必填复选框以定义编辑者必须为该字段输入一个值。
有关详细信息,请参阅根据需要定义元素。
- 要防止编辑者使用表单更新此字段中的值,取消选中可编辑复选框。
例如,包含一个用于引用目的的字段,但您不希望编辑者更改该字段中的值。
格式化数字元素
如果元素使用的是双精度型、整型或大整型数据类型的要素图层字段,请完成以下步骤来设置该表单元素的格式:
- 选择文本表单元素以打开属性窗格。
- 单击输入类型下拉菜单,然后选择以下选项之一:
- 条形码 - 此功能只能在具有条形码阅读器的应用程序中使用。 如果您选择此输入类型,则该元素将在无法读取条形码作为输入的应用程序中恢复为默认输入类型,例如 Map Viewer。
- 数字 - 双精度 - 如果图层中的字段定义为双精度,用于编辑地图的应用程序不接受条形码作为输入,且编辑者必须输入十进制数字,则请选择数字 - 双精度。
- 数字 - 整型 - 如果图层中的字段定义为整型、大整数或双精度,用于编辑地图的应用程序不接受条形码作为输入,且编辑者不应输入十进制数字,则请选择数字 - 整型。
- 要在提示编辑者输入正确值的字段中显示文本,请在占位符字段中提供该文本。
例如,您可以输入 Type the applicant's first name 作为存储申请贷款人员名字的字段的占位符文本。
占位符文本出现在输入字段元素内,并由编辑者提供的文本替换。
您不能为定义了默认值的字段设置占位符文本。
- 在描述字段中,提供解释该字段中的值所代表内容的文本。
描述显示在表单上的元素下方。
- 选中必填复选框以定义编辑者必须为该字段输入一个值。
有关详细信息,请参阅根据需要定义元素。
- 要防止编辑者使用表单更新此字段中的值,取消选中可编辑复选框。
例如,包含一个用于引用目的的字段,但您不希望编辑者更改该字段中的值。
格式化包含三个或更多值列表的元素
如果为要素图层中的字段定义了包含三个或更多值的列表,则可以将表单元素配置为显示为组合框或选项按钮。
要对包含三个或更多值的元素设置格式,请完成以下步骤:
- 选择引用字段的表单元素,该字段定义了值列表以打开其属性窗格。
- 在格式化部分中,单击输入类型下拉菜单,然后选择以下的一个选项:
- 组合框 - 表单用户可从可用选项列表中选择一个值。
- 单选按钮 - 所有选项都显示在表单上,旁边有选项按钮。 表单用户可单击适当的按钮。
如果列表包含很多值(例如,七个或更多值),组合框可以节省表单空间。
- 在描述字段中,提供解释该字段中的值所代表内容的文本。
描述显示在表单上的元素下方。
- 选中必填复选框以定义编辑者必须为该字段输入一个值。
有关详细信息,请参阅根据需要定义元素。
- 要防止编辑者使用表单更新此字段中的值,取消选中可编辑复选框。
如果表单元素不可编辑,表单上的按钮或列表选项设置会显示属性的现有值。 如果添加要素,则组合框或按钮元素不会显示任何值,除非该字段定义了默认值。
格式化具有两个可能值的元素
如果要素图层中的字段定义了一个仅包含两个可能值的列表,并且该字段在图层中设置了默认值,则可以将该元素定义为在表单上显示为切换开关,或显示为组合框或按钮。
如果图层中的字段没有设置默认值,您可以将元素配置为在表单上显示为组合框或按钮。
要对具有两个可能值的元素设置格式,请完成以下步骤:
- 选择引用字段的表单元素,该字段定义了双值列表和默认值以打开其属性窗格。
- 在格式化部分中,单击输入类型下拉菜单,然后选择以下选项之一来呈现此元素:
- 组合框 - 表单用户可从下拉列表中选择其中一个值。
- 单选按钮 - 两个选项都显示在表单上,旁边有按钮。 表单用户可单击适当的按钮。
- 开关 - 表单用户打开或关闭切换开关。
您可以通过单击切换值旁边的切换值顺序按钮将哪个值更改为等于启用的开关。
如果字段没有设置默认值并且您选择切换作为输入类型,则该元素在表单上显示为组合框。
- 在描述字段中,提供解释该字段中的值所代表内容的文本。
描述显示在表单上的元素下方。
- 选中必填复选框以定义编辑者必须为该字段输入一个值。
有关详细信息,请参阅根据需要定义元素。
- 要防止编辑者使用表单更新此字段中的值,取消选中可编辑复选框。
如果表单元素不可编辑,表单上的按钮、列表选项或切换开关设置会显示属性的现有值。 如果添加要素,则组合框或按钮元素不会显示任何值。 对于切换元素,默认设置显示在表单上。
格式化相关记录元素
您可以通过对相关记录元素的描述、排列顺序和可预览的数量设置格式,来自定义相关记录元素在表单中的显示。
要设置相关记录元素的格式,请完成以下步骤:
- 选择相关记录元素以打开属性窗格。
- 在描述字段中,提供解释该字段中的值所代表内容的文本。
描述显示在表单上的元素下方。
- 单击排序方式下拉菜单,然后选择用于对相关记录进行排序的字段。
- 单击排序顺序下拉菜单,然后选择相关记录的排序方式。
如果按字符串、双精度型或整型字段进行排序,则可以按升序或降序值排序。 如果按日期字段进行排序,则可以按最近或最晚的值排序。
- 单击预览计数下拉菜单,然后选择可以在表单中预览的相关记录数。
选择大于 3 的值可能需要在表单上进行额外的滚动,因此不推荐进行此操作。
注:
可以为相关表创建一个单独的表单,然后从相关表中选择要显示的字段以及对其进行格式化的方式。
根据需要定义元素
要强制为字段输入数据,您可以配置表单元素,以便它们需要条目。 例如,如果所有应用程序都需要提交日期,则将提交日期元素配置为必需。
当编辑者使用表单时,他们会在需要输入的字段旁边看到一个星号,并且在提供值之前他们无法保存他们的编辑。
要将元素定义为必填项,请完成以下步骤:
- 单击字段表单元素以打开属性窗格。
- 在逻辑部分,选中必填复选框。
* 必填片段随即出现在表单元素上,表示编辑者必须为此字段提供一个值。
添加逻辑以使表单根据条件地动态化
可以根据使用 ArcGIS Arcade 表达式定义的以下逻辑条件使表单动态化:
定义后,可以为其他表单元素重用表达式。
配置条件可见性
您可以根据添加到先前字段的值有条件地显示或隐藏表单元素。 例如,“建筑物评估”表单中包含了一个用于指示是否存在水损害的字段。 该表单中还包括一个包含与水损害相关的字段的组表单元素。 可以将条件可见性表达式应用于水损害组,以便仅在较早字段中指示了水损害时才显示该组。
要创建条件可见性表达式,请完成以下步骤:
- 单击字段表单元素以打开属性窗格。
- 在逻辑部分中,单击可见复选框旁边的
按钮 表达式。表达式弹出窗口随即出现,显示先前为表单创建的表达式。
- 单击新建表达式。
随即显示表达式构建器窗口。 构建器允许您在将表达式保存到所选表单元素之前在 Arcade 中编写和预览表达式。
- 在标题文本框中,为表达式添加标题。
- 定义表达式
例如,如果一个水损害组元素只需要在较早的字段中指示水损害时才需要出现,则可以使用以下条件来构建表达式:
- 字段名称 - 水损害
- 运算符 - is
- 值 - Yes
以下是 Arcade 语法中相同的表达式:
DomainName($feature, "water_damage") == "Yes"Map Viewer 将应用 Arcade 表单约束配置文件来评估要素是否符合表达式中定义的条件。 如果 water_damage 字段中指示了 Yes 以外的值,则水损害组将不会显示在表单中。
- 单击完成关闭表达式构建器。
</> 可见性片段随即出现在表单元素上,表示条件可见性表达式已应用于该组或字段。
您现在已创建表达式,可以将其应用于任意表单元素。 您可以通过单击表达式弹出窗口中表达式旁边的数字来查看哪些元素正在使用表达式。 要了解详细信息,请参阅以下重用表达式部分。
注:
您可以随时通过条件可见性菜单复制、编辑或删除表达式。 要使用 Arcade 编辑表达式,请从此菜单中单击编辑 Arcade。
配置条件必需元素
您可以根据在表单上先前输入的值,有条件地要求填写表单元素。 例如,只有当风暴泥石流的长度大于 3 米时,才需要泥石流描述字段。
要配置有条件必填的元素,请完成以下步骤:
- 单击字段表单元素以打开属性窗格。
- 在逻辑部分中,单击必填复选框旁边的
按钮 表达式。表达式弹出窗口随即出现,显示先前为表单创建的表达式。
- 单击新建表达式。
随即显示表达式构建器窗口。 该构建器允许您在将表达式保存到所选字段或组之前在 Arcade 中编写和预览表达式。
- 在标题文本框中,为表达式添加标题。
- 定义表达式。
每个表达式由一个或多个条件定义。 条件包括字段名称、运算符和可能的值。 可用运算符列表由字段类型(字符串、数字或日期)决定。
例如,如果仅在泥石流大于 3 米时才需要泥石流描述字段,则可以使用以下条件来构建表达式:
- 字段名称 - debris_length
- 运算符 - is greater than
- 值 - 3
以下是 Arcade 语法中的相同表达式:
($feature, "debris_length") > 3注:
要创建更复杂的表达式,请单击启动 Arcade 编辑器。
当将多个条件应用于相同要素时,对于必需的表单元素,可以选择所有条件都必须为 true 还是只有一个条件必须为 true。
ArcGIS Online 将应用 Arcade 表单约束配置文件来评估要素是否符合表达式中定义的条件。 如果在泥石流长度字段中输入的值小于 3,则表单中的泥石流描述字段将不是必填项。
- 单击完成关闭表达式构建器。
</> 必填片段随即出现在表单元素上,表示已应用必填表达式。
您现在已创建表达式,可以将其应用于任意表单元素。 您可以通过单击表达式弹出窗口中表达式旁边的数字来查看哪些元素正在使用表达式。 要了解详细信息,请参阅以下重用表达式部分。
注:
可以随时使用表达式弹出窗口中的溢出菜单复制、编辑或删除表达式。 要使用 Arcade 编辑表达式,请从此菜单中单击编辑 Arcade。
配置条件编辑
您可以根据先前在表单中输入的值有条件地启用表单元素的编辑功能。 例如,如果 pipe_replaced 字段值设置为 yes,则编辑者应该仅编辑 date_pipe_replaced 字段中的值。
要配置条件编辑,请完成以下步骤:
- 单击字段表单元素以打开属性窗格。
- 在逻辑部分中,单击可编辑复选框旁边的
按钮 表达式。表达式弹出窗口随即出现,显示先前为表单创建的表达式。
- 单击新建表达式。
随即显示表达式构建器窗口。 该构建器允许您在将表达式保存到所选字段或组之前在 Arcade 中编写和预览表达式。
- 在标题文本框中,为表达式添加标题。
- 定义表达式。
每个表达式由一个或多个条件定义。 条件包括字段名称、运算符和可能的值。 可用运算符列表由字段类型(字符串、数字或日期)决定。
例如,如果管道更换日期仅在 pipe_replaced 字段值为 yes 时可编辑,则可以使用以下条件构建表达式:
- 字段名称 - pipe_replaced
- 运算符 - is
- 值 - yes
以下是 Arcade 语法中相同的表达式:
($feature, "pipe_replaced") == "yes"ArcGIS Online 将应用 Arcade 表单约束配置文件来评估要素是否符合表达式中定义的条件。 如果在检查器 ID 字段中输入了 4367 以外的值,则将无法在表单中编辑管道 ID 字段。注:
要创建更复杂的表达式,请单击启动 Arcade 编辑器。
如果使用了多个条件,则对于要编辑的表单元素,可以选择所有条件都必须为 true 还是只有一个条件必须为 true。
- 单击完成。
</> 可编辑片段随即出现在表单元素上,表示已应用必填表达式。
您现在已创建表达式,可以将其应用于任意表单元素。 您可以通过单击表达式弹出窗口中表达式旁边的数字来查看哪些元素正在使用表达式。 要了解详细信息,请参阅以下重用表达式部分。
注:
可以随时使用表达式弹出窗口中的溢出菜单复制、编辑或删除表达式。 要使用 Arcade 编辑表达式,请从此菜单中单击编辑 Arcade。
添加表达式以计算字段值
可以向表单添加计算表达式来字段计算和填充数据。 这将自动计算字段值,从而节省编辑者时间并保证数据完整性。
使用 Arcade 根据要素属性和几何构建计算表达式。 例如,可以向存储桥梁检测计划日期的字段添加计算表达式。 例如,当编辑者将桥梁状况字段值设置为 damaged 时,在检测日期字段上定义的表达式可通过在桥梁检测字段中填充该日期,自动将下一次检测计划为在一周后进行。
计算表达式为动态表达式,意味着它们会在信息更改时自动更新表单。 因此,编辑者可以在提交表单之前查看更新计算。 由于计算表达式字段中的值由表达式填充,因此编辑者无法在表单中为该字段提供值。
要创建计算表达式,请完成以下步骤:
- 单击字段表单元素以打开属性窗格。
警告:
如果为表单元素启用了编辑功能,则表达式将不会运行。
- 在逻辑部分中,单击计算值部分中的
按钮 表达式。 - 单击新建表达式。
随即显示 Arcade 编辑器窗口。 编辑器允许您在将表达式保存到所选表单元素之前编写和测试表达式。
- 在标题文本框中,为表达式添加标题。
- 写入计算表达式。
例如,以下表达式用于在计算以平方米为单位的面积之前检查面要素几何是否为空。 将在下一部分节中提供其他示例。
要了解有关使用 Arcade 计算面积的详细信息,请参阅面积(几何函数)。if (IsEmpty(Geometry($feature))){ return; } else{ Area($feature, 'square-meters') }有关 Arcade 中提供的所有函数列表,请参阅 Arcade 函数索引。
- 单击运行以测试表达式,确保表达式不会生成错误。
- 单击完成以关闭 Arcade 编辑器。
</> 计算片段随即出现在表单元素上,表示已应用计算表达式。
在创建表达式后,您可以通过选择表单元素,然后单击之前创建的表达式将其应用于任何表单元素。 您可以通过单击计算表达式下的属性窗格中表达式旁边的编号,来查看哪些元素正在使用 Arcade 表达式。
注:
您可以随时通过计算表达式菜单复制、编辑或删除表达式。
计算表达式示例
以下是计算表达式的示例:
- 提供日期信息 - 以下示例表达式为日期字段提供当前日期:
要了解有关可使用 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 函数索引。
重用表达式
创建表达式后,可以跨表单元素重复使用它。 例如,您可以根据用于要求另一个表单元素的相同表达式有条件地显示某个表单元素,并且可以使用相同的计算来填充多个字段。
要将现有表达式用于表单元素,请完成以下步骤:
- 配置表单时,单击表单元素以打开属性窗格。
- 在逻辑部分中,单击要添加的表达式类型旁边的表达式按钮
。表达式弹出窗口或计算表达式弹出窗口随即出现,显示先前为表单创建的表达式。
提示:
表达式旁边的数值表示当前应用该表达式的表单元素的数量。 单击此数值会打开另一个弹出窗口,显示当前使用该表达式的表单元素及其属性。
单击显示表达式类型的片段上的 X,可以从任何表单元素属性中移除表达式。
- 选择要应用的表达式。
片段随即出现在表单元素上,表示已应用该表达式。
保存表单
完成编辑后,保存表单。 单击确定关闭配置表单窗口,并选择将表单保存至地图或图层,如下所示:
,或输入