构建表单

移动工作人员将阅读、输入和更新表单以采集数据和执行检查。 通过在 Field Maps Designer web 应用程序中配置表单，确保移动工作人员顺利完成外业工作。打开表单构建器后，即可通过以下方式开始配置表单：

• 添加基本表单元素 - 移动工作人员可以使用基本表单元素提供诸如日期、数字、文本以及从条形码扫描的数据等信息。
• 添加选择表单元素 - 移动工作人员可以使用选择表单元素从定义的值列表中进行选择。
• 将字段用作表单元素 - 可以将图层或表格内的字段添加到表单，并将其配置为表单元素。

注：

您可以在 Field Maps Designer web 应用程序和 Map Viewer 中配置表单。 要了解如何在 Map Viewer 中配置表单，请参阅创建用于属性编辑的表单。

您可以在 Field Maps 移动应用程序和 Map Viewer 中查看和编辑表单。

警告：

在 Field Maps Designer 中编辑地图、图层和表单时，请勿同时在单独的浏览器选项卡中对这些内容进行编辑。 在多个选项卡中编辑地图、图层和表单将导致数据丢失。

启用图层进行编辑

当构建表单时，您将使用地图中的要素图层来构建表单。 例如，您可以使用树木要素图层来构建树木清单表单。 移动工作人员使用 Field Maps 移动应用程序填写并提交表单后，随即将新的树木要素添加至图层。 要为图层构建表单，必须启用该图层进行编辑。

如果您使用 Field Maps Designer 创建了地图，则默认情况下将启用在地图创建过程中添加的要素图层进行编辑。 如果未启用图层进行编辑，请参阅以下资源之一以了解如何将其启用：

• 在 ArcGIS Online 中管理托管要素图层编辑（帮助主题）

注：

如果您是图层所有者或管理员，则即使未启用图层进行编辑，您也可以构建表单。 如果您正在使用 ArcGIS Online 并且拥有以完全控制功能进行编辑的权限，则您还可以在未启用图层进行编辑时构建表单。

有关详细信息，请参阅 ArcGIS Online 中取决于角色的访问编辑功能（帮助部分）或 ArcGIS Enterprise 中取决于角色的访问编辑功能（帮助部分）。

打开表单构建器

可以使用 Field Maps Designer 中的表单构建器创建移动工作人员在外业使用的表单。 要打开表单构建器，请完成以下步骤：

1. 在浏览器中，登录到您的组织并从 ArcGIS Online 中的应用程序启动器或 ArcGIS Enterprise 中的应用程序启动器打开 Field Maps Designer。

   地图页面随即出现，其中将显示您所拥有的地图和您所属的任何共享更新群组中包含的地图。

   注：

   如果您以管理员身份使用 ArcGIS Online 或 ArcGIS Enterprise 10.9.1 或更高版本，则可以选择查看和配置组织内的任何地图。 单击过滤器，然后选择所有地图。

2. 单击地图以开始对其进行配置。

   表单页面随即出现，其中显示了地图的内容。

   提示：

   如果您使用的是 ArcGIS Online 或 ArcGIS Enterprise 10.9.1 或更高版本，则您也可以在 Field Maps 中从地图的项目页面打开地图。 浏览到地图的项目页面，然后单击在 Field Maps 中打开。

   注：

   如果地图包含嵌套图层组（图层组包含图层组），则它们会出现在 Field Maps Designer 中。 要了解如何创建图层组，请参阅在 ArcGIS Online 中创建和管理图层组、在 ArcGIS Enterprise 中创建和管理图层组或在 ArcGIS Pro 中使用图层组。

3. 单击图层或表。

   表单构建器随即显示，其中包含一个空白表单画布。

   注：

   要构建表单，必须启用该图层进行编辑。

打开表单构建器后，通过将表单元素拖动到画布上，即可开始配置表单。 表单元素可定义移动工作人员在填写表单时提供的信息类型。 您可以添加基本表单元素或选择表单元素，也可以将字段用作表单元素。

提示：

可以使用 ArcGIS API for Python 和 copy_form_between_mapsPython 脚本或 ArcGIS Online 助手在地图之间复制表格。 有关分步说明，请参阅复制地图和表单以将其用于 Field Maps 博客文章。

添加基本表单元素

移动工作人员可以使用基本表单元素提供诸如日期、数字、文本以及从条形码扫描的数据等信息。 基本表单元素列在基本下的表单元素列表中，包括以下内容：

表单元素	字段类型	描述
条形码	双精度型、整型或字符串	扫描条形码或 QR 码以输入值。
日期/时间	日期	输入日期或时间。
数值 - 双精度型	双精度	输入十进制数值，例如 1.2。
数值 - 整型	整型	输入整数值，例如 2。
文本 - 多行	字符串	输入多行文本。
文本 - 单行	字符串	输入文本的单个行。

双击表单元素或对其进行拖动，以将其添加到表单画布中。 添加表单元素后，需要定义其显示名称和字段信息。

注：

无法将表单元素添加到要素图层视图。

定义显示名称和字段信息

将表单元素添加到表单中并保存这些元素后，这些元素将成为图层中的字段。 这些字段可存储移动工作人员收集的信息。 例如，如果您将文本 - 单行表单元素添加到表单中，则会将字符串字段添加到图层中。

当您将表单元素添加到表单画布中时，将显示属性窗格。 每个表单元素都需要显示名称、字段名称和字段类型属性的值。 如果字段为字符串类型，则还需要字段长度值。 要定义显示名称和字段信息，请完成以下步骤：

1. 添加显示名称值。

   显示名称为显示在表单上并自动用作字段名称值的名称。

   注：

   字段名称值中的所有空格都将替换为下划线并会移除所有无效字符。

2. 或者，更改字段名称值。

   如果您希望字段中存储的名称与表单中显示的名称不同，则可以更改字段名称。 如果显示名称较长，您可能需要使用较短的字段名称，例如：

   • 显示名称 - 提供有关检查的其他注意事项
   • 字段名称 - additional_notes

3. 如果您要配置条形码元素，请为字段类型选择值。

   您选择的字段类型取决于移动工作人员扫描的条形码中包含的信息类型。

4. 如果您要配置字段类型为字符串的表单元素，请为字段长度设置值。

   字段长度表示字段的最大长度。 文本 - 单行和条形码表单元素的默认值为 256 个字符。 文本 - 多行表单元素的默认值为 1000 个字符。

5. 或者，可以在默认值文本框中提供默认值。

   在创建要素时，会将默认值应用于字段，如果移动工作人员在采集数据时输入了常用值，则默认值将非常有用。

6. 保存表单。

   在添加新表单元素后保存表单后，无法更改字段名称、字段类型、字段长度和默认值属性。

   提示：

   如果要更改这些属性，您必须从画布中删除表单元素，并从表单构建器窗格的字段列表中删除该字段。 然后，即可添加新的表单元素并配置其属性。

格式化基本元素

输入所需的显示名称和字段信息后，可以为基本表单元素配置附加属性，以帮助简化外业数据采集。 有关详细信息，请参阅以下内容：

• 格式化日期元素
• 格式化文本元素
• 格式化条形码或 QR 码元素
• 提供描述
• 创建和编辑范围
• 提供提示
• 需要表单元素
• 设置默认值
• 禁用编辑
• 添加逻辑

添加选择表单元素

移动工作人员可以使用选择表单元素从定义的值列表中进行选择。 选择表单元素列在选择下的表单元素列表中，包括以下内容：

表单元素	字段类型	描述
组合框	双精度型、整型或字符串	从下拉菜单中显示的值的列表中进行选择。
单选按钮	双精度型、整型或字符串	从显示为按钮的值的列表中进行选择。
切换	双精度型、整型或字符串	从显示为切换的 2 个值中选择其中一个值。

双击表单元素或对其进行拖动，以将其添加到表单画布中。 添加选择表单元素后，需要定义其显示名称、字段信息和值列表。

注：

建议单选按钮元素最多使用 5 个值。 添加的值超过 5 个可能需要移动工作人员滚动表单以找到其选择内容。 如果值超过 5 个，建议使用组合框。

无法将表单元素添加到要素图层视图。

定义显示名称和字段信息

将表单元素添加到表单中并保存这些元素后，这些元素将成为图层中的字段。 这些字段可存储移动工作人员收集的信息。 例如，如果将一个字符串类型的组合框表单元素添加到表单中，则会将一个字符串字段添加到图层中。

当您将表单元素添加到表单画布中时，将显示属性窗格。 每个表单元素都需要显示名称、字段名称和字段类型属性的值。 如果字段为字符串，则还需要字段长度值。 通过完成以下步骤定义此信息：

1. 添加显示名称值。

   显示名称为显示在表单上并自动用作字段名称值的名称。

   注：

   字段名称值中的所有空格都将替换为下划线并会移除所有无效字符。

2. 或者，更改字段名称值。

   如果您希望字段中存储的名称与表单中显示的名称不同，则可以更改字段名称。 如果显示名称较长，您可能需要使用较短的字段名称，例如：

   • 显示名称 - 选择树类型
   • 字段名称 - tree_type

3. 为字段类型选择值。

   字段类型将应用于值列表。 创建值列表后，将无法更改字段类型。

4. 如果您要配置字段类型为字符串的表单元素，请为字段长度设置值。

   字段长度表示字段的最大长度并应用于值列表。 默认字段长度为 256 个字符。

定义显示名称和字段信息后，需要创建值列表。

注：

在创建值列表之前，无法保存新的选择表单元素。

创建值列表

值列表（也称为编码值域）用于定义移动工作人员在填写表单时可以从中进行选择的选项。 提供值列表可简化外业数据采集并确保输入数据的一致性。 列表中的每个值都包含标注和代码：

• 标注 - 标注是在 Field Maps 中填写表单时所显示的值，以及您希望该值对移动工作人员的显示方式。 在 Map Viewer 和其他应用程序中查看属性表时也会显示标注。
• 代码 - 代码是存储在要素图层中的值。

可以逐一添加值，或者通过上传 .csv 文件来添加值。 创建列表的方式取决于您正在配置的选择元素的类型。

注：

无法在要素图层视图中创建值列表。

为组合框或单选按钮创建列表

要为组合框或单选按钮元素创建值列表，请完成以下步骤：

1. 在属性窗格中，单击创建列表。

   随即出现值列表窗口。

2. 或者，可以通过上传 .csv 文件来填充值列表。
   1. 确保您的 .csv 文件与如下所示的所需格式相匹配。

      .csv 文件必须包含两列：一列用于标注，一列用于代码。 下表显示了包含 3 个值的 .csv 文件的所需格式：

      标注 1	代码 1
      标注 2	代码 2
      标注 3	代码 3

      为获得最佳结果，请使用 UTF-8 字符编码对 .csv 文件进行编码。 如果您使用 Microsoft Excel 创建 .csv 文件，请将其另存为 CSV UTF-8。

      警告：

      代码必须使用为表单元素定义的字段类型。 如果字段类型为字符串，则代码还必须小于或等于为表单元素定义的最大字段长度。

      在 Field Maps 中添加代码时不支持逗号，无法将其用作千位或小数分隔符。 要在代码中添加小数分隔符，必须使用句点。

      如果您在 Microsoft Excel 或类似程序外部编辑原始 .csv 文件，则必须对包含双引号的值使用转义。 例如，如果标注或代码为 24"，则必须在 .csv 文件中将其写为 "24"""。

      如果代码不符合这些要求，则 .csv 文件将无法上传。

   2. 将 .csv 文件拖动到值列表窗口中，或者单击从设备中选择以在文件资源管理器中将其选中。

   将使用 .csv 文件中的值填充该列表。

3. 或者，可以逐一添加值。

   可以通过单击添加 按钮添加值。 为每个值提供标注和代码。

   警告：

   代码必须使用为表单元素定义的字段类型。 如果字段类型为字符串，则代码还必须小于或等于为表单元素定义的最大字段长度。

   在 Field Maps 中添加代码时不支持逗号，无法将其用作千位或小数分隔符。 要在代码中添加小数分隔符，必须使用句点。

4. 单击完成即可创建该列表。

   单击完成后，您将无法更改字段类型或表单元素的长度。

   创建列表按钮将更改为编辑列表，其中括号中的数字表示列表中值的数量。

5. 或者，可以从默认值下拉菜单中选择默认值。

   在创建要素时，会将默认值应用于字段，如果移动工作人员在采集数据时输入了常用值，则默认值将非常有用。

   注：

   保存表单后，您将无法更改默认值属性。

6. 定义显示名称、字段信息和值列表后，请保存表单。

   在添加新表单元素后保存表单后，无法更改字段名称、字段类型和字段长度属性。

   提示：

   如果要更改这些属性，您必须从画布中删除表单元素，并从表单构建器窗格的字段列表中删除该字段。 然后，即可添加新的表单元素并配置其属性。

   要了解如何在创建列表后对其进行编辑，请参阅编辑值列表。

为切换创建列表

切换元素包含 2 个值。 要为切换元素创建值列表，请完成以下步骤：

1. 在切换值下，提供 2 个值供移动工作人员从中进行选择。

   即每个值的标注。 将自动生成每个值的代码。

2. 或者，可以通过单击管理代码来更改每个值的代码。

   值列表窗口随即出现，可以在其中编辑每个值的标注和代码。 完成后，请单击完成以关闭该窗口。

   单击完成后，您将无法更改字段类型或表单元素的长度。

   警告：

   代码必须使用为表单元素定义的字段类型。 如果字段类型为字符串，则代码还必须小于或等于为表单元素定义的最大字段长度。

   在 Field Maps 中添加代码时不支持逗号，无法将其用作千位或小数分隔符。 要在代码中添加小数分隔符，必须使用句点。

3. 在默认值下，选择您希望在表单中默认选中的值。 如果切换元素不包含默认值，则其会在表单中显示为组合框。

   注：

   保存表单后，您将无法更改默认值属性。

4. 定义显示名称、字段信息、值列表和默认值后，请保存表单。

   在添加新表单元素后保存表单后，无法更改字段名称、字段类型和字段长度属性。

   提示：

   如果要更改这些属性，您必须从画布中删除表单元素，并从表单构建器窗格的字段列表中删除该字段。 然后，即可添加新的表单元素并配置其属性。

   要了解如何在创建列表后对其进行管理，请参阅编辑值列表。

格式化选择元素

定义显示名称、字段信息、值列表和默认值后，可以为选择表单元素配置其他属性，以帮助简化字段中的数据采集。 有关详细信息，请参阅以下内容：

• 提供描述
• 创建和编辑值列表
• 需要表单元素
• 禁用编辑
• 添加逻辑

将字段用作表单元素

可以将图层或表格内的字段和条件字段组添加到表单，并将其配置为表单元素。 添加字段后，可以配置字段在表单上的显示方式。 如果字段包含值列表，您也可以管理这些值。

向表单添加字段

图层内的字段显示在表单画布旁的字段列表中。 可以通过以下一种或多种方式向表单添加字段：

• 逐一添加字段 - 要将单个字段添加到表单中，请双击该字段或将其拖动到表单画布中。
• 向表单添加字段选择 - 要向表单添加多个字段，请按住 Ctrl 键并单击要包含的字段，然后将其拖到表单画布上。
• 将所有字段添加到表单中 - 要在表单中包括所有字段，请在字段列表中单击全部添加。
• 转换弹出窗口 - 如果您在 Map Viewer 经典版 中将表单配置为弹出窗口，则可以使用现有弹出窗口配置在表单构建器中配置表单。 在空白表单画布上，单击转换弹出窗口。 弹出窗口中的可编辑字段随即添加到画布中，并按照原始顺序进行放置。 弹出窗口配置中不包含的字段出现在字段列表中。

提示：

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

如果字段为必需字段，则其将显示在字段列表的必需部分中，并且必须将其添加到表单中。 如果在 ArcGIS Online 中创建字段时将其配置为不允许空值，则字段会显示在必需部分中。

将条件字段组添加到表单

如果在 ArcGIS Pro 中配置了条件字段组，它们将显示在表单画布旁边的字段组列表中。 如果字段组共享公共字段，则将它们一起列出。 可以通过以下一种或多种方式向表单添加字段组：

• 逐一添加字段组 - 要将单个字段组添加到表单中，请双击该字段或将其拖动到表单画布中。
• 向表单添加字段组选择 - 要向表单添加多个字段组，请按住 Ctrl 键并单击要包含的字段组，然后将其拖到表单画布上。
• 将所有字段组添加到表单中 - 要在表单中包括所有字段组，请在字段组列表中单击全部添加。

提示：

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

将字段组添加到表单时，其条件字段包含在组元素中。 条件字段应保持分组在一起，以便移动工作人员随后在 Field Maps 中填写这些条件字段。 如果从其字段组中移除字段，则将显示一条警告。

如果字段组为必需字段，则其将显示在列表的必需部分中，并且必须将其添加到表单中。 如果字段组在 ArcGIS Pro 中被配置为限制性，则它们为必需内容。

警告：

如果未将条件字段组添加到表单画布，则移动工作人员可能无法在 Field Maps 中提交表单。

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

将字段配置为表单元素

将字段添加到表单画布后，即可将其配置为表单元素。 要配置字段在表单中的显示方式，请完成以下步骤：

1. 选择希望进行配置的字段。

   属性窗格随即显示。

2. 选择输入类型。

   输入类型用于定义表单元素在 Field Maps 中的显示方式。 您选择的输入类型取决于字段类型以及字段是否包含值列表。

   如果字段不包含值列表，并且您不希望创建值列表，请从输入类型下拉菜单中选择以下选项之一：

   输入类型	字段类型	描述
   条形码	双精度型、整型或字符串	扫描条形码或 QR 码以输入值。
   日期	日期	请输入日期。
   日期和时间	日期	输入日期和时间。
   数值 - 双精度型	双精度	输入十进制数值，例如 1.2。
   数值 - 整型	整型	输入整数值，例如 2。
   文本 - 多行	字符串	输入多行文本。
   文本 - 单行	字符串	输入文本的单个行。

   提示：

   如果字段是条件字段组的一部分并包含范围域，则建议使用数值 - 整型输入类型。

   如果字段包含值列表，或者您希望创建值列表，请从输入类型下拉菜单中选择以下选项之一：

   输入类型	字段类型	描述
   组合框	双精度型、整型或字符串	从下拉菜单中显示的值的列表中进行选择。
   单选按钮	双精度型、整型或字符串	从显示为按钮的值的列表中进行选择。
   切换	双精度型、整型或字符串	从显示为切换的 2 个选项中选择其中一个选项。

   注：

   建议单选按钮输入类型最多用于五个值。 添加的值超过 5 个可能需要移动工作人员滚动表单以找到其选择内容。 如果值超过 5 个，建议使用组合框。

   要了解如何为字段创建值列表，请参阅创建值列表。

   如果切换元素不包含默认值，则其会在表单中显示为组合框。 可以通过管理要素模板为现有字段设置默认值。

   警告：

   如果字段是条件字段组的一部分且包含值列表，则必须选择组合框输入类型，否则表单将无法在 Field Maps 中加载。

   如果字段包含条件值 <null>，则必须启用包含“无值”选项，否则表单将无法在 Field Maps 中加载。

3. 配置其他属性。

   选择输入类型后，可以配置其他表单元素属性以简化字段中的数据输入。 您还可以管理组合框、单选按钮和切换元素的值列表。 要了解有关配置表单元素的不同方式，请参阅以下内容：

   • 格式化日期元素
   • 格式化文本元素
   • 格式化条形码或 QR 码元素
   • 提供描述
   • 提供提示
   • 创建和编辑值列表
   • 创建和编辑范围
   • 需要表单元素
   • 禁用编辑
   • 添加逻辑

提供标题

可在标题中包含识别信息，以便移动工作人员选择正确的表单。 默认情况下，表单的标题为图层或表的名称。

1. 在配置表单时，单击当前标题。
2. 提供移动工作人员可以轻松识别的标题。
3. 保存表单。

提示：

如果您使用的是 ArcGIS Online 或 ArcGIS Enterprise 10.9.1 或更高版本，请在格式化窗格中单击添加字段，以在标题中包含一个字段值。

对表单中的元素进行排序

以移动工作人员更方便在字段中提供信息的方式对表单元素进行排序。 如果您的表单较长，则请先列出必要元素，从而使移动工作人员无需搜索关键项目。

1. 在配置表单时，可以拖动表单元素以在表单画布上对其进行排序，或者选择一个表单元素并使用箭头键将其向上或向下移动。
2. 保存表单。

提示：

如果您使用的是 ArcGIS Online 或 ArcGIS Enterprise 10.9.1 或更高版本，则可以通过按 Ctrl 键并单击每个元素来选择多个表单元素。

将元素分组在一起

如果表单中存在相关信息，则可以将其分组到一起，与纸质表单中的各个部分类似。 可以使用表单元素列表中的组元素对表单元素进行分组。

1. 将组元素拖动到表单上。
2. 将表单元素拖动到组中。
3. 选择组元素以编辑其属性。

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

   • 显示名称 - 为组提供可描述其字段的名称。
   • 描述 - 提供对组的描述。
   • 初始状态 - 如果您希望在表单中展开组的初始状态，请选中此复选框。
   • 条件可见性 - 添加 Arcade 属性表达式以应用有关何时组应显示在表单中的规则。 有关详细信息，请参阅条件可见性。

4. 保存表单。

提示：

如果您使用的是 ArcGIS Online 或 ArcGIS Enterprise 10.9.1 或更高版本，则可以通过从组工具条中选择取消分组来从组中移除所有表单元素。 您可以按 Ctrl 键，选择要移除的每个元素，然后将其从组中拖出，以便从组中移除多个元素。

添加只读信息

您可以添加信息元素，在表单上提供只读指南及信息。 例如，您可能想要提供检查工作流的说明或与所采集的数据相关的附加信息。 信息元素中的内容将设置为 Markdown 格式，您可以在表单中添加从字段中提取的动态信息。 要将信息元素添加到表单，请完成以下步骤：

1. 将信息元素拖动到表单上。

   属性窗格随即显示。

2. 在文本编辑器中，输入要在表单上显示的只读信息。

   可以使用多种方式设置文本格式，例如使用标题、粗体、斜体和代码字体。 还可以在其中添加编号列表、项目符号列表及链接。

   要在图层中添加从字段和表达式获取的内嵌链接，请单击选择字段或表达式下拉菜单 ，然后选择要添加的字段或表达式。

   注：

   信息元素中的文本不得超过 1,000 个字符。

3. 可以添加可见性表达式，根据条件显示或隐藏信息元素。
4. 保存表单。

更新标注（显示名称）

在 Field Maps 中，显示名称文本将用作表单元素的标注。 请提供移动工作人员熟悉的名称或简短问题。

提示：

使标注保持简洁明了。 在使用问题时，Field Maps 将对文本进行缩放，使文本置于表单的一行内。

1. 配置表单时，单击表单元素以打开属性窗格。
2. 在格式化部分中，编辑显示名称文本以更改表单上元素的标注。
3. 保存表单。

格式化文本元素

可以将文本元素配置为使用文本框或文本区域。 还可以为每个文本元素配置最小和最大字符计数。

1. 配置表单时，单击需要文本的表单元素以打开属性窗格。
2. 在格式化部分中，单击输入类型下拉菜单，然后选择一个选项。
   • 文本 - 单行 - 允许移动工作人员提供一行文本。
   • 文本 - 多行 - 允许移动工作人员提供多行文本。
3. 在格式化部分中，设置元素的最小长度和最大长度值。
4. 保存表单。

格式化日期和时间元素

可以将日期元素配置为使用日期选取器或日期和时间选取器。 还可以为每个日期元素设置范围。

1. 配置表单时，单击需要日期的表单元素以打开属性窗格。
2. 在格式化部分中，单击输入类型下拉菜单，然后选择一个选项。
   • 日期 - 允许移动工作人员提供日期。
   • 日期和时间 - 允许移动工作人员提供日期和时间。

   注：

   Field Maps 移动应用程序当前不支持 DateOnly、TimeOnly 和 Timestampoffset 字段类型。

3. 在格式化部分中，设置可供移动工作人员选择的开始日期、开始时间、结束日期和结束时间属性的值。
4. 保存表单。

格式化条形码或 QR 码元素

如果您的资产包含条形码或 QR 码，则可使用 Field Maps 扫描条形码或 QR 码并根据扫描结果填充一个或多个条目。 在 Field Maps 中，条形码输入类型的文本和数字条目包含用于扫描条形码或 QR 码的选项。 当移动工作人员选择扫描条形码或 QR 码 时，设备的相机应用程序将打开并读取条形码或 QR 码。 其中包含的信息将在扫描完成时用以填充选中的条目。

1. 配置表单时，单击需要条形码或 QR 码元素的字段以打开属性窗格。
2. 在格式化部分中，单击输入类型下拉菜单，然后选择条形码扫描仪。
3. 保存表单。

注：

Field Maps 支持操作系统支持的条形码和 QR 码格式。 有关 Android 支持，请参阅扫描 Android 上的条形码和 ML 工具包。 对于 iOS 支持，请参阅机器可读对象类型。

提供提示

在 Field Maps 中，将使用占位符文本来显示未包含值的条目的信息提示文本。 例如，您可以提供有关移动工作人员可从何处获取信息的信息，或有关输入时如何格式化信息的详细信息。

注：

日期字段或具有编码值域的字段的占位符文本不会显示在 Field Maps 中。

1. 配置表单时，单击表单元素以打开属性窗格。
2. 在格式化部分中，编辑占位符文本以更改元素的提示文本。
3. 保存表单。

提供描述

描述文本用于提供可描述表单元素用途的上下文信息。

1. 配置表单时，单击表单元素以打开属性窗格。
2. 在格式化部分中，编辑描述文本以更改元素的描述。
3. 保存表单。

创建和编辑值列表

值列表（也称为编码值域）用于定义移动工作人员在填写表单时可以从中进行选择的选项。 您可以创建和管理已添加到表单中的元素的值列表。

注：

要了解如何在创建新的选择表单元素时添加值列表，请参阅添加选择表单元素。

如果您在 ArcGIS Pro 中为日期字段创建了编码值域，则无法在 Field Maps Designer 中编辑其值列表。

无法在要素图层视图中编辑值列表。

创建值列表

如果文本或数值元素不包含值列表，可以按照以下步骤创建一个：

1. 在表单画布上选择一个文本或数值元素。

   属性窗格随即显示。

2. 单击输入类型下拉菜单并选择以下选择元素之一：

   输入类型	字段类型	描述
   组合框	双精度型、整型或字符串	以下拉菜单形式显示值
   单选按钮	双精度型、整型或字符串	以按钮形式显示值
   切换	双精度型、整型或字符串	以切换形式显示两个值

   注：

   建议单选按钮输入类型最多用于五个值。 添加的值超过 5 个可能需要移动工作人员滚动表单以找到其选择内容。 如果值超过 5 个，建议使用组合框。

   如果切换元素不包含默认值，则其会在表单中显示为组合框。 可以通过管理要素模板为现有字段设置默认值。

   警告：

   如果字段是条件字段组的一部分，则必须选择组合框输入类型，否则表单将无法在 Field Maps 中加载。

3. 按照剩余的步骤创建值列表。

   提示：

   如果图层包含您正在编辑的字段的数据，则可以使用这些值生成列表。 在值列表窗口中编辑列表时，单击生成值。

4. 保存表单。

编辑组合框或单选按钮的列表

要管理组合框或单选按钮元素的值列表，请完成以下步骤：

1. 选择表单元素。

   属性窗格随即显示。

   注：

   通过从输入类型下拉菜单中选择选项，可以更改值列表的输入类型。

2. 单击编辑列表。

   注：

   编辑列表按钮的括号中的数字表示列表中值的数量。

   随即出现值列表窗口。

3. 可以通过以下一种或多种方式管理值列表：
   • 可以通过单击添加按钮 添加值。
   • 编辑标注和代码。
   • 通过拖动或选择值以及使用箭头键，可以对值进行重新排序。
   • 通过将包含标注和代码值的 .csv 文件拖动到窗口上，可以替换或追加值列表。 .csv 文件必须与所需格式相匹配。 为获得最佳结果，请使用 UTF-8 字符编码对 .csv 文件进行编码。 如果您使用 Microsoft Excel 创建 .csv 文件，请将其另存为 CSV UTF-8。
   • 单击删除列表来删除列表。

   警告：

   代码必须使用为表单元素定义的字段类型。 如果字段类型为字符串，则代码还必须小于或等于为表单元素定义的最大字段长度。

   在 Field Maps 中添加代码时不支持逗号，无法将其用作千位或小数分隔符。 要在代码中添加小数分隔符，必须使用句点。

   如果您在 Excel 或类似程序外部编辑原始 .csv 文件，则必须对包含双引号的值使用转义。 例如，如果标注或代码为 24"，则必须在 .csv 文件中将其写为 "24"""。

   如果在表达式中使用某个值，则编辑其代码可能会导致表单出错。

4. 完成编辑值列表后，请单击完成以关闭该窗口。
5. 保存表单。

编辑切换的列表

要管理切换元素的值列表，请完成以下步骤：

1. 选择表单元素。

   属性窗格随即显示。

   注：

   通过从输入类型下拉菜单中选择选项，可以更改值列表的输入类型。

2. 可以通过以下一种或多种方式管理值列表：
   • 编辑切换值下的标注。
   • 通过单击切换值的顺序按钮 ，可以对值进行重新排序。
   • 通过单击管理代码，可以编辑值列表窗口中的代码。 完成编辑代码后，请单击完成以关闭该窗口。

   注：

   代码必须使用为表单元素定义的字段类型。 如果字段类型为字符串，则代码还必须小于或等于为表单元素定义的最大字段长度。

   如果在表达式中使用某个值，则编辑其代码可能会导致表单出错。

3. 保存表单。

创建和编辑范围

范围（也称为范围域）用于定义移动工作人员可以输入的有效最小值和最大值的范围。 可以为数值元素和具有数值字段类型的条形码元素创建和管理范围。

创建范围

如果数值元素不包含范围，可以按照以下步骤创建一个：

1. 在表单画布上选择一个数值元素。

   属性窗格随即显示。

   注：

   如果表单元素包含值列表，必须首先删除列表，并将输入类型更改为数值 - 整型、数值 - 双精度型或条形码（包含一个数值字段类型），然后再创建范围。

2. 单击创建范围。
3. 通过在最小值和最大值文本框中输入数值来定义有效值范围。

   提示：

   如果图层包含您正在编辑的字段的数据，则可以使用这些值生成范围。 单击生成值以根据图层中当前最小值和最大值生成最小值和最大值。

4. 单击完成。
5. 保存表单。

编辑范围

要管理数值元素的范围，请完成以下步骤：

1. 在表单画布上选择包含范围的数值元素。

   属性窗格随即显示。

2. 单击编辑范围。
3. 可以通过以下一种或多种方式管理范围：
   • 编辑最小值和最大值。
   • 单击删除范围来删除范围。
4. 单击完成。
5. 保存表单。

设置默认值

在创建要素时，会将默认值应用于字段，如果移动工作人员在采集数据时输入了常用值，则默认值将非常有用。 在 Field Maps Designer 中创建新表单元素或者在 ArcGIS Online、ArcGIS Enterprise 或 ArcGIS Pro 中创建新字段时，可以设置默认值。 要了解如何在创建表单元素或字段时设置默认值，请参阅以下内容之一：

• 在 Field Maps Designer 中添加基本表单元素
• 在 Field Maps Designer 中添加选择表单元素
• 在 ArcGIS Online 中添加或删除字段
• 在 ArcGIS Pro 中创建和管理字段

当使用要素模板创建要素时，在要素模板中指定的默认值将应用于该字段。 这将允许您根据要创建的要素类型为单个字段设置不同的默认值。 如果字段目前具有默认值，则要素模板的默认值将覆盖此默认值并用于该字段。 要为要素模板提供默认值，请参阅管理要素模板。

隐藏表单元素

默认情况下，表单元素显示在表单中；但是，您可以更改此设置，使表单元素在 Field Maps 中隐藏。

1. 配置表单时，单击表单元素以打开属性窗格。
2. 在逻辑部分中，取消选中可见复选框，以防止移动工作人员编辑字段。

   隐藏标注将被添加到表单元素。

3. 保存表单。

提示：

您可以使用 Arcade 表达式有条件地隐藏表单元素。

需要表单元素

可以配置表单元素，以便移动工作人员在提交表单之前需要提供值。 例如，如果所有检查都需要检查 ID，则表单中需要该值。 要需要表单元素，请完成以下步骤：

1. 配置表单时，单击表单元素以打开属性窗格。
2. 在逻辑部分中，选中必填复选框，可在 Field Maps 中要求填写值。

   必填标注将被添加到表单元素。

   注：

   通过单击空值按钮 并选中或取消选中允许要素图层中的空值复选框，可以确定是否允许空值。

   如果允许空值，则在表单外编辑要素图层时不需要该字段。 如果图层具有一条或多条记录，则必须允许空值。

3. 保存表单。

   在表单中，必填元素由显示名称旁的星号指示，并且当该元素在表单上可见（而不是隐藏）时，必须提供值才能进行提交。

   注：

   如果在表单构建器之外要求填写该字段（例如在 ArcGIS Pro 或 ArcGIS Online 中创建字段时），则必须在 Field Maps 中输入一个值才能提交表单，无论该元素处于可见还是隐藏状态。

提示：

您可以使用 Arcade 表达式根据条件要求填写表单元素。

禁用编辑

默认情况下，系统将启用表单中字段的编辑功能；但您可以更改此设置，从而使移动工作人员无法编辑这些字段。 只读元素允许移动工作人员访问信息，但将阻止其对信息进行编辑。

1. 配置表单时，单击表单元素以打开属性窗格。
2. 在逻辑部分中，取消选中可编辑复选框，以防止移动工作人员编辑字段。

   只读标注将被添加到表单元素。

3. 保存表单。

提示：

您可以使用 Arcade 表达式为表单元素有条件地启用编辑。

添加逻辑

向表单添加逻辑允许使用 ArcGIS Arcade 设置表单元素的行为。 使用 Arcade 表达式，可以根据表达式中设置的条件动态隐藏元素、要求填写元素并启用编辑。 还可以向表单添加计算表达式，这样可以计算和填充表单中的数据。

在属性窗格的逻辑部分中，可以创建以下表达式并将它们应用于表单元素：

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

可以跨表单元素重用表达式，并随时对其进行编辑。

添加可见性表达式

您可以根据先前在表单中输入的值有条件地显示表单元素。 例如，仅在表单上已经指明水损害时，才应出现水损害组。 通过完成以下步骤添加可见性表达式：

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

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

   注：

   如果在 Field Maps Designer 中使用表达式弹出窗口之前已创建表达式，则会出现合并表达式消息。 单击合并以合并系统表达式，然后保存表单。 这允许重用系统表达式，从而提高表单性能。

3. 单击 + 新建表达式。

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

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

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

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

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

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

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

   注：

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

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

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

6. 单击完成。

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

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

   注：

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

在有条件地隐藏字段时保留值

当移动工作人员填写表单时，他们可能会为因条件可见性规则而隐藏的字段输入值。 通过完成以下步骤，可以确定隐藏的值是否保留在图层中：

1. 配置表单时，展开表单构建器窗格中的表单设置面板。
2. 要在有条件隐藏字段时保留值，请选中字段值下方的复选框。

   即使相应的字段在表单上隐藏，值也会保留在图层中。

注：

ArcGIS Enterprise 11.1 及更高版本中提供了字段值设置。

添加必填表达式

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

注：

必填表达式仅在表单元素在表单上可见（未隐藏）时适用。

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

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

   注：

   如果在 Field Maps Designer 中使用表达式弹出窗口之前已创建表达式，则会出现合并表达式消息。 单击合并以合并系统表达式，然后保存表单。 这允许重用系统表达式，从而提高表单性能。

3. 单击 + 新建表达式。

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

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

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

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

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

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

   ($feature, "debris_length") > 3

   注：

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

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

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

6. 单击完成。

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

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

   注：

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

添加可编辑表达式

您可以根据先前在表单中输入的值有条件地启用表单元素的编辑功能。 例如，如果先前已输入管理 ID，则 pipe ID 字段仅可处于可编辑状态。

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

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

   注：

   如果在 Field Maps Designer 中使用表达式弹出窗口之前已创建表达式，则会出现合并表达式消息。 单击合并以合并系统表达式，然后保存表单。 这允许重用系统表达式，从而提高表单性能。

3. 单击 + 新建表达式。

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

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

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

   例如，如果 pipe ID 字段仅在先前输入管理 ID（在本例中为 4367）时才可编辑，则可以使用以下条件来构建表达式：

   • 字段名称 - inspector_id
   • 运算符 - is
   • 值 - 4367

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

   ($feature, "inspector_id") == "4367"

   注：

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

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

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

6. 单击完成。

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

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

   注：

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

添加计算的表达式

计算的表达式将自动计算并填充表单中的数据，从而为外业移动工作人员节省时间。 可以使用 Arcade 以多种方式构建计算的表达式，包括使用要素属性、几何以及已登录用户的账户信息。

计算表达式为动态表达式，意味着它们会在信息更改时自动更新表单。 因此，外业工作人员可以在提交表单之前查看已更新的计算。 要创建计算表达式，请完成以下步骤：

1. 配置表单时，单击表单元素以打开属性窗格。

   警告：

   如果为表单元素启用了编辑功能，则表达式将不会运行。 如果元素具有可编辑表达式，请确保在希望计算表达式来填充值时禁用编辑功能。

2. 在逻辑部分中，单击计算值复选框旁边的按钮 表达式。

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

3. 单击 + 新建表达式。

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

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

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

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

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

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

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

8. 保存表单。

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

   注：

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

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

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

  return Today();

  要了解有关可使用 Arcade 访问的日期信息的详细信息，请参阅日期函数。
• 包括已登录用户的账户信息 - 以下表达式将返回已登录到 Field Maps 的用户的全名：

  var userInfo = GetUser(portal("https://www.arcgis.com"),"")return (userinfo["fullName"])

  有关可以使用 Arcade 访问的账户信息的详细信息，请参阅 GetUser（数据函数）。
• 从相交图层提取信息 - 以下表达式应用于表单中的邮政编码字段。 用于检查要素几何是否为空，然后从相交的宗地图层中提取邮政编码值：

  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 函数索引。

提示：

有关其他示例，请参阅ArcGIS Field Maps 常用计算表达式（博客文章）。

重用表达式

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

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

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

   提示：

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

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

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

   标注随即出现在表单元素上，表示已应用表达式。

格式化高精度元数据显示

包含高精度元数据的字段不会显示在表单或字段列表中。 如果要在弹出窗口中显示高精度元数据，请格式化数字以使用适当的小数位数。 如果您要显示定位时间，则请格式化日期。

保存表单

经常保存表格以确保更改不会丢失。 可以保存对地图或图层的更改：

• 保存到地图 - 如果表单是对于特定地图的唯一表单，并且您不希望在其他地图中进行重用，请通过单击保存按钮 来保存更改。 该表单将保存到地图中，并且不会出现在包含该图层的其他地图中。
• 保存到图层 - 如果要在包含图层的地图中重复使用表单，请单击保存按钮旁边的下拉菜单并单击保存到图层来保存更改。 表单随即保存到图层中，可以在其他地图中重复使用。 如果画布上显示的表单是保存到图层的表单，则撤消和恢复按钮旁边会出现一条表单已保存到图层消息。 要了解有关重用表单的详细信息，请参阅在 ArcGIS Field Maps 中重用表单（博客文章）。

注：

保存到地图的表单更改会覆盖保存到图层的表单更改。 如果一个表单被保存到图层，然后新的表单更改被保存到地图，则保存到地图的表单将出现在 Field Maps 中。

要保存对图层的更改，您必须为其所有者、是组织的默认管理员或具有以下权限：

• 管理权限：成员：查看全部
• 管理权限：内容：查看全部
• 管理权限：内容：更新

局限性

下面描述了在 Field Maps Designer 中构建表单的限制：

无法使用日期、时间和大整型字段类型

Field Maps 移动应用程序当前不支持 DateOnly、TimeOnly、Timestampoffset 和 BigInteger 字段类型，这些字段类型可能是使用 Map Viewer 中的表单构建器添加到表单中的。 包含这些字段类型的图层将无法在 Field Maps 移动应用程序中加载。如果地图包含这些字段类型，则无法在 Field Maps 中离线使用。

无法使用相关记录元素

可以使用 Map Viewer 中的表单构建器将相关记录元素添加至表单，但是，目前 ArcGIS Field Maps 中不支持相关记录元素。 虽然添加至表单的相关记录元素将显示在 Field Maps Designer 中，但是无法对其进行格式化，并且其将在 Field Maps 移动应用程序的表单中隐藏。

如果您从 Field Maps Designer 的表单中删除相关记录元素，则无法将其添加回表单。 您只能在 Map Viewer 中将相关记录元素添加至表单。

无法为具有 GNSS 字段的表配置表单

如果表与具有 GNSS 字段的图层相关，则您无法配置其表单，但可以为表的副本配置表单。 要创建相关表的副本，请完成以下步骤：

1. 浏览到包含 GNSS 字段的图层的项目页面，然后单击可视化选项卡。
2. 单击另存为新图层，然后提供一个标题。
3. 单击保存。

   系统随即创建图层的副本和相关表并将其添加到我的内容中。

4. 返回 Field Maps Designer。

   您现在即可为表的副本配置表单。