配置表单

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

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

注：

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

您可以在 ArcGIS Field Maps 移动应用程序以及 ArcGIS Online 和 ArcGIS Enterprise 10.9.1 及更高版本中的新 Map Viewer 中查看和编辑表单。

警告：

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

如果您使用 ArcGIS Enterprise 10.8.1 或 10.9 以便使用 Field Maps web 应用程序来配置表单，则在编辑地图时必须使用 Map Viewer 测试版。 如果您使用 Map Viewer 编辑或保存地图，则您在 Field Maps web 应用程序中配置的表单将会丢失。

如果您使用的是 ArcGIS Enterprise 10.8 或更早版本，则 Field Maps web 应用程序不可用。 您必须在 Map Viewer 经典版 中配置表单。

如果您使用的是 ArcGIS Online 或 ArcGIS Enterprise 10.9.1 或更高版本，则在编辑地图时可使用新的 Map Viewer 或 Map Viewer 经典版。

打开表单构建器

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

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

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

   注：

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

   ArcGIS Enterprise 10.9.1 或更高版本不支持查看和配置通过共享更新群组与您共享的地图。

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

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

   提示：

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

3. 单击可编辑的图层或表。

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

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

提示：

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

添加基本表单元素

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

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

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

注：

ArcGIS Enterprise 11.0 及更高版本支持添加基本表单元素。

定义显示名称和字段信息

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

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

1. 添加显示名称值。

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

   注：

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

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

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

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

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

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

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

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

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

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

6. 单击保存以保存表单。

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

   提示：

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

格式化基本元素

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

• 格式化日期元素
• 格式化文本元素
• 格式化条形码或 QR 码元素
• 提供描述
• 提供提示
• 需要表单元素
• 设置默认值
• 禁用编辑
• 添加计算的表达式
• 配置条件可见性

添加选择表单元素

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

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

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

注：

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

ArcGIS Enterprise 11.0 及更高版本支持添加选择表单元素。

定义显示名称和字段信息

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

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

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 键并单击要包含的字段，然后将其拖到表单画布上。

  注：

  ArcGIS Enterprise 10.9.1 及更高版本支持使用 Ctrl 键添加字段选择。

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

提示：

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

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

将条件字段组添加到表单

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

注：

ArcGIS Enterprise 当前不支持添加条件字段组。

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

提示：

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

将字段组添加到表单时，其条件字段包含在组元素中。 条件字段应保持分组在一起，以便移动工作人员可以在 Field Maps 移动应用程序中按顺序填写它们。如果从其字段组中移除某个字段，则会出现警告。

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

警告：

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

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

将字段配置为表单元素

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

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

   属性窗格随即显示。

2. 选择输入类型。

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

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

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

   提示：

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

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

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

   注：

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

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

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

   ArcGIS Enterprise 10.9.1 及更高版本支持单选按钮和切换输入类型。

   警告：

   如果字段是条件字段组的一部分且包含值列表，则必须选择组合框输入类型，否则表单将无法在 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 键，选择要移除的每个元素，然后将其从组中拖出，以便从组中移除多个元素。

更新标注（显示名称）

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

提示：

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

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

格式化文本元素

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

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

格式化日期元素

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

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

格式化条形码或 QR 码元素

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

注：

ArcGIS Enterprise 10.9.1 及更高版本支持条形码扫描仪输入类型。

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

注：

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

提供提示

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

注：

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

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

提供描述

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

注：

ArcGIS Enterprise 10.9.1 及更高版本支持描述文本。

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

管理值列表

如果表单元素包含值列表（也称为编码值域），则可以在表单构建器中编辑这些值。 管理列表的方式取决于您正在配置的选择元素的类型。

注：

要为字段或表单元素创建值列表，请参阅以下内容之一：

• 在 Field Maps web 应用程序中创建值列表
• 使用 ArcGIS Online 定义属性列表和范围
• 使用 ArcGIS Enterprise 定义属性列表和范围
• 在 ArcGIS Pro 中创建和管理属性域

如果您在 ArcGIS Pro 中为日期字段创建了编码值域，则无法在 Field Maps web 应用程序中管理其值列表。

ArcGIS Enterprise 11.0 及更高版本支持管理值列表。

管理组合框或单选按钮的列表

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

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. 单击保存以保存表单。

需要表单元素

可以配置表单元素，以便移动工作人员在提交表单之前需要提供值。 例如，如果所有检查都需要检查 ID，则表单中需要该值。 如果您需要表单元素，则您还必须确定该字段的要素图层中是否允许空值。 要需要表单元素，请完成以下步骤：

1. 配置表单时，单击表单元素以打开属性窗格。
2. 在格式化部分中，启用必要复选框以在 Field Maps 中需要值。
3. 通过选择是或否，可以确定要素图层中是否允许空值。

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

   注：

   如果您使用 ArcGIS Enterprise 10.9.1 或较早版本，则此选项不可用。

4. 单击保存。

   在表单中，必要元素由显示名称旁的星号指示，用于防止在未提供值的情况下进行提交。

设置默认值

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

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

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

禁用编辑

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

1. 配置表单时，单击表单元素以打开属性窗格。
2. 在格式化部分中，取消选中允许移动用户进行编辑复选框，以防止移动工作人员编辑字段。
3. 单击保存。

添加 Arcade 表达式

可以使用 ArcGIS Arcade 创建表达式以简化和自动化表单中的数据输入。 可以在 Field Maps 中创建以下表达式：

• 计算的表达式 - 根据属性、几何和帐户信息自动计算表单中的数据。
• 条件可见性表达式 - 根据已添加到现有字段的值，有条件地显示或隐藏表单元素。

添加计算的表达式

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

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

注：

ArcGIS Enterprise 11.0 及更高版本支持计算表达式。

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

   警告：

   如果选中允许编辑复选框，则表达式将不会运行。

2. 在计算表达式部分中，单击添加表达式。

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

3. 单击标题旁边的编辑，然后为表达式提供标题。
4. 写入计算表达式。

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

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

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

5. 单击测试以确保表达式不会生成错误。
6. 单击确定关闭 Arcade 编辑器。

   计算表达式将应用于表单元素。

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

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

   注：

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

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

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

  return Today();

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

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

  有关可以使用 Arcade 访问的帐户信息的详细信息，请参阅 GetUser（数据函数）。

  注：

  如果使用 ArcGIS Enterprise，请将 https://www.arcgis.com 替换为您的门户 URL。

• 从相交图层提取信息 - 以下表达式应用于表单中的邮政编码字段。 用于检查要素几何是否为空，然后从相交的宗地图层中提取邮政编码值：

  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. 在条件可见性部分中，单击添加表达式。

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

   注：

   如果使用 ArcGIS Enterprise 10.9.1 或较早版本，则会出现 Arcade 编辑器。 您可以使用编辑器使用 Arcade 创建条件可见性表达式。

3. 单击标题旁边的编辑，然后为表达式提供标题。
4. 构建表达式。

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

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

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

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

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

   注：

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

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

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

   注：

   如果表达式计算结果为 false，并且表单元素隐藏在表单中，则系统会清除字段的值。 如果表单元素组处于隐藏状态，则系统会清除其包含的所有值。

5. 单击保存。

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

   现在您已经保存了您的表达式，您可以通过选择表单元素并单击您创建的表达式将其应用于任何表单元素。 您可以通过单击条件可见性下的属性窗格中表达式旁边的数字来查看哪些元素正在使用 Arcade 表达式。

   注：

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

格式化高精度元数据显示

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

已知问题

下面提供了有关在 Field Maps web 应用程序中构建表单的已知问题以及有关如何解决这些问题的说明。

无法为表格配置表单

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

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

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

4. 返回到 Field Maps web 应用程序。

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