智能编辑器微件—ArcGIS Web AppBuilder

“智能编辑器”微件提供了简化的编辑体验，并允许您编辑要素及其相关记录。可以将属性配置为动态隐藏、必填或禁用。您可以使用其他图层的值（例如地址或坐标格式中的位置信息）来设置属性的自动计算。 “智能编辑器”微件还允许您设置一次属性，并将这些设置应用于所有新创建的要素。可以通过提供自定义显示文本来控制编辑器窗体的描述性信息。可以将地图导航锁定在图层设置中，以便在触摸屏设备上编辑。

配置“智能编辑器”微件

可将此微件设置为应用程序启动时自动打开。将鼠标悬停在该微件上，然后单击不要在应用程序启动时打开此微件按钮以将该设置更改为在应用程序启动时自动打开此微件。（对于需要首先添加至应用程序的微件，可以在配置该微件后打开此选项。）

将鼠标悬停在微件上方，然后单击配置此微件按钮以打开配置窗口。
注：
如果需要先将微件添加到应用程序，请在微件选项卡上单击微件占位符。在打开的选择微件窗口中，选择微件然后单击确定。
或者单击更改微件图标，用自己的图像替换此微件的默认图标。
随即显示文件资源管理器窗口，供您选择可用作微件图标的本地图像文件。

配置“智能编辑器”微件时，需要考虑以下 4 个部分：图层设置、智能操作、属性操作和常规设置。

图层设置

图层设置包含地图中的所有可编辑图层，并且可用于控制每个图层的功能和操作。

提示：

此微件不会覆盖 web 地图和服务中的限制编辑设置。如果将服务设置为仅允许更新，则此微件将不允许创建或删除要素。但是，如果将图层设置为允许创建和删除要素，则当选择自定义设置时，可以在 Web 应用程序的微件配置中限制这些编辑权限。

如果您希望始终同步 Web 地图中定义的设置，则请选择支持 web 地图中的设置。包括以下设置：
- 哪些图层是可编辑的
- 要显示和编辑的字段
- 字段顺序
否则，选择自定义设置，以更好地控制每个可编辑图层的编辑功能。在所有图层表中，为启用了编辑的图层配置以下选项：
- 可编辑 - 仅允许编辑某些图层。
- 对于每个已选中可编辑框的图层，您可以启用以下功能：
  - 仅更新 - 将此图层限制为仅更新或修改现有要素。
  - 允许删除 - 允许删除要素。
  - 禁用几何编辑 - 不允许修整和移动要素几何。
或者，可以单击描述列下方的按钮并提供将显示在每个图层属性上方的文本，以帮助用户执行编辑。
警告：
如果您在 10.8.1 版本之前配置了该应用程序，并且为此内容使用了自定义 XSS，则可能需要对其进行修改以确保它现在可以按预期显示，因为自那时以来已实施 XSS 过滤器以提高安全性。
单击操作下的编辑按钮并选择可见字段和可编辑字段。
对话框将列出图层的所有字段。数据库必填字段以红色星号 (*) 注明。默认情况下，微件可传递地图中配置的显示和可编辑属性。以下是每个列的详细信息：
- 显示 - 在属性对话框中显示此字段。
- 可编辑 - 确定字段是否可以编辑。不可编辑的字段将显示，但处于禁用状态。
- 名称 - 显示以供参考。
- 别名 - 显示以供参考。
- 操作 - 对字段进行排序并定义智能操作和属性操作。
注：
如果字段属于智能操作组，则可以选择更新其所属的组，或者从组中移除该字段并单独对其进行更新。
如果地图中存在关系，则当您将鼠标悬停在操作下时还会提供一个“表”按钮。单击该“表”按钮可访问图层的相关图层或表。
仅显示前向父子关系。如果子关系可编辑但父关系不可编辑，则会显示父图层，但禁用所有属性。如果父图层可编辑但子图层不可编辑，则不会显示这些属性。
注：
“智能编辑器”微件仅支持一对一和一对多关系。如果是图层对表关系（当来源是要素图层，而目标是表图层时），则可以创建新的相关记录，而对于图层对图层关系，只能进行属性更新。
表格上方显示的是您之前在此关系层次结构中浏览过的位置的面包屑。单击面包屑中的段将该项目加载到表格中。
该表格将显示您的当前层级。将列出所有相关项目。选项如下：
- 可编辑 - 允许编辑相关图层或表格。
- 对于每个已选中可编辑框的图层，您可以启用以下功能：
  - 仅更新 - 将此图层限制为仅更新或修改现有要素或记录。如果相关项目为要素图层，则此项将处于选中状态但不可用。此微件会阻止您创建相关要素，您只能编辑现有相关要素的属性。
  - 允许删除 - 允许删除要素或记录。
  - 禁用几何编辑 - 此选项不适用于所有相关项目。
- 描述 - 可选参数，用于在每个图层的属性上方提供描述。此选项将打开描述对话框。
- 操作 - 选择哪些字段可编辑、可见、可包括在预设值列表中，并定义智能和属性操作。允许访问相关图层或表格（如果可用）。
可以更改编辑记录时属性的加载方式。检查所有父图层以及相关表或图层的以下设置：
- 加载时展开所有父图层 - 在父图层中创建或更新记录时展开属性。
- 加载时展开所有相关表/图层 - 在父图层的相关表或图层中创建或更新记录时展开属性。

智能操作

智能操作基于定义的表达式来定义应用于字段的行为，例如要求、隐藏或禁用。可以使用以下步骤在多个图层中构建智能操作并将类似操作分组在一起。

注：

也可以直接在图层设置选项卡中配置智能操作。在图层设置选项卡中设置的操作可以相互独立，也可以用于创建“智能操作”群组。

在智能操作选项卡上，单击新建智能操作。在配置智能操作窗口中，对于群组名称，提供用于描述群组的名称。
对于用于表达式的图层，选择将用于为其定义表达式条件的字段的图层。
对于表达式，单击编辑表达式按钮并构建表达式以使用可能等效的表达式来过滤图层，然后对所选字段进行验证。
如果您的操作导致字段被隐藏，请选中即使字段隐藏仍然提交其属性数据。此选项将提交此字段中的数据。
在要应用的图层和字段部分中，选择隐藏、要求或禁用任何字段。
提示：
使用搜索框过滤字段，然后使用展开所有图层以显示所有图层的所有字段。
本部分列出了基于表达式的有效选项的图层和字段。每个字段只能执行一个操作；如果选择多个操作，则优先级将决定将执行这些操作的顺序。要更改优先级，请单击设置智能操作优先级按钮，并使用向上和向下箭头进行重新排序。
注：
如果对应字段上的操作旁边有黄色图标，则该字段在其他组中已有定义的操作。选中此操作将导致该字段从其他组中移除并加入当前组中。

属性操作

属性操作可以确定在满足要求时，如何定义或操作字段中的值。可以使用以下步骤在多个图层中构建属性操作并将类似操作进行分组。

注：

也可以直接在图层设置选项卡中配置属性操作。在图层设置选项卡中设置的操作可以相互独立，也可以用于创建“属性操作”群组。将按顺序处理操作，并且每个字段仅触发一个操作。要更改给定字段的属性操作优先级，请在从图层设置选项卡中为字段配置属性操作时更改其在条件列中的顺序。

可以在交叉点部分中添加新操作以基于相交图层中的字段值来填充字段。随即打开的窗口中的设置如下：
- 群组名称 - 描述群组的名称。
- 数据类型 - 提供数据类型。选择一个选项后，数据类型将按图层来过滤匹配字段的列表。
- 忽略图层排名并在所有已定义图层中查找最近要素 - 选中此框以使用最近相交要素。图层排名由要提取值的图层部分中的图层顺序决定 - 列表顶部的图层将被视为第一个将相交的图层。
- 要提取值的图层
  - 图层 - 将相交的图层。
  - 字段 - 将从所选图层中提取的字段。
  - 容差设置 - 发生相交的阈值。
    单击容差设置按钮，以为此图层设置自定义容差值或选中使用默认容差以使用常规设置中的容差设置。
  - 操作 - 控制顺序并允许删除条目。
- 要应用提取值的图层和字段 - 从所需图层中选择要应用提取值的字段。
提示：
如果为相交值定义了多个图层，则微件将自上而下搜索此列表来获取相交值。成功找到第一个值后，将忽略列表中的所有其他图层。要允许用户从相交图层中选择多个相交值，请在常规设置中启用相交值选取器。
可以在地址部分中添加新操作以基于使用定位器服务的指定位置处的地址来填充字段。随即打开的窗口中的设置如下：
- 群组名称 - 描述群组的名称。
- 属性 - 基于定义的地理编码器的可用字段。
- 要应用提取值的图层和字段 - 要应用地址属性的字段。
注：
要定义定位器服务，请转至常规设置选项卡，然后单击地理编码器设置。默认情况下，微件使用组织中定义的定位器。
提示：
如果从定位器返回多个结果，则将使用匹配分数最高的结果。
可以在坐标部分中添加新操作以基于坐标填充字段。坐标可以是纬度-经度、地图的空间参考或军事格网参考系 (MGRS)。随即打开的窗口中的设置如下：
- 群组名称 - 描述群组的名称。
- 坐标源 - 要确定位置坐标的变量。
  - 要素位置 - 基于要素在地图上的位置确定坐标。
  - 我的位置 - 基于编辑要素的用户的位置确定坐标。
- 坐标系统 - 可用坐标系将使用当前地图的空间参考、经纬度或 MGRS。
- 属性 - 基于所选坐标系，选择以下组合之一：
  - X, Y；X Y；或 Y X
  - 纬度, 经度; 纬度经度；或经度纬度
  - MGRS
- 要应用提取值的图层和字段 - 要应用坐标系属性的字段。
提示：
如果使用要素位置作为坐标源，则当用户创建或更新面时，将使用该面的质心坐标。如果用户创建或更新线，则将使用起点。
可以在预设部分中添加新操作，以定义用户在创建新要素时可使用属性值进行填充的字段。随即打开的窗口中的设置如下：
- 群组名称 - 描述群组的名称。
- 数据类型 - 按指定数据类型过滤要应用的图层和字段设置中的字段。要使用编码值属性域查看字段，请选择数字。
- 要应用的图层和字段 - 提供了基于数据类型和域过滤器的有效选项的图层和字段列表。蓝色星号 (*) 表示域字段。选择将为其创建预设的字段。
  提示：
  使用搜索框过滤字段，然后使用展开所有图层以显示每个图层的所有字段。
  注：
  如果字段旁边有黄色图标，则该字段在其他组中已应用预设操作。如果在当前预设中选中此字段，则将从其他组中移除该字段以加入当前组。
- 预设值 - 字段的默认值。可以在文本框中指定默认值或将其留空。单击选择值将提供三个选项，具体取决于您正在配置的数据：
  - 字段值 - 如果未将数据类型设置为日期且您尚未选中任何属性域字段，则选择值窗口将允许您在图层中指定字段值。
  - 属性域 - 如果选中至少一个属性域字段，则选择值窗口将包含所有选定字段中的属性域值列表。可以指定默认值作为预设值。
  - 日期 - 如果数据类型为日期，且您尚未选中任何属性域字段，则选择值窗口将允许您指定固定或相对日期。固定日期是不会随时间变化的值；而相对日期会根据要素创建日期和时间而变化。从以下选项中选择：
    - 固定 - 预设使用与所有新要素的默认值相同的指定日期和时间。定义自定义日期和时间值或从地图的图层中选择一个现有值。
    - 当前 - 预设对每个新要素使用当前日期和时间的值。
    - 过去 - 预设将从每个新要素的当前日期和时间减去指定值。
    - 未来 - 预设将指定值添加到每个新要素的当前日期和时间。
- 在预设值显示中隐藏 - 创建记录时，在微件窗格中隐藏预设，但仍将填充值。
注：
预设值仅适用于新要素创建。在更新现有要素时，预设不适用。要允许更新现有要素的交叉点、坐标和地址属性操作，请在常规设置中启用显示属性操作更新按钮。要在更新现有要素的几何时进行自动更新，请同时启用更新几何后自动调用属性操作。

常规设置

此部分包含用于控制验证和用户界面的微件设置。您也可以更改地理编码器设置。

如果您在要素图层或表格中将字段配置为从地址获取其值，请单击地理编码器设置以定义定位器 URL。
注：
默认情况下，将使用在您的组织中定义的定位器来填充地理编码器。如果更改了 URL，请同时更改地址属性操作中的属性源。
在要素模板和过滤器值设置部分中，从以下选项中进行选择：
- 显示绘制选项 - 显示所选模板的有效绘制选项列表。
- 在顶部显示预设值列表 - 将预设值列表显示在模板选取器上方。
- 使用要素模板过滤器 - 要素模板过滤器会显示关键字和图层过滤器来缩小编辑模板列表的范围。选中复选框可启用此选项。
  - 分组搜索结果 - 按图层分组搜索结果。
  注：
  可编辑图层的模板列表是基于随要素服务发布的模板或在图层的可视化设置中定义的模板提供的。如果模板在 Web 地图中更新，请确保这些更改与图层一起保存（如需反映在模板选取器中）。修改 Web 地图中的图层符号系统后，单击更多选项，然后选择保存图层。
- 保持所选模板处于活动状态 - 用于保持所选模板处于活动状态。
- 将组过滤器的过滤值应用到预设字段 - 在“组过滤器”微件中配置的过滤器将应用于“智能编辑器”微件中的预设字段。
  警告：
  必须在应用程序中将“组过滤器”和“智能编辑器”配置为可同时访问。此外，“智能编辑器”中预设的组名称必须与“组过滤器”中的过滤器组名称相同。
- 允许编辑从“添加数据”微件添加的图层 - 可以编辑通过“添加数据”微件添加到应用程序中的可编辑图层。
在复制和追加要素部分中，从以下选项中进行选择：
- 允许从现有要素创建新要素 - 允许用户通过从地图的图层中选择现有要素来创建新要素。（如果字段名称或字段别名相同，此操作将自动匹配字段，无论其大小写和空格情况如何。有关如何使用字段匹配的详细信息，请参阅使用字段匹配复制要素。）
  - 允许将面复制到点 - 允许通过几何变换将面要素复制到点目标要素模板。点将被放置在源面要素内。
  - 允许将线复制到点 - 允许通过几何变换将线要素复制到点目标要素模板。
    - 始端的点 - 目标点要素将放置在选定要复制的源线要素的始端。
    - 末端的点 - 目标点要素将放置在选定要复制的源线要素的末端。
  - 复制的要素中的值将覆盖目标字段中的默认值 - 启用源要素值以覆盖已匹配字段的目标字段默认模板值。
注：
如果将多个折线或面要素复制到具有唯一值字段的图层，则会仅允许创建一个多部分要素。
警告：
复制多个要素时，系统不会应用通过智能操作配置的必填字段的限制。系统只会提示用户为在图层设置和服务级别设置的必填字段提供值。
在保存设置部分中，从以下选项中进行选择：
- 保存、删除、后退和关闭按钮的位置 - 显示窗体上方或下方的按钮。
- 当表单关闭或切换到下一条记录时提示保存未保存的编辑内容 - 当当前要素具有未保存编辑内容时，则显示提示。（复制多个要素会自动保存。）
- 删除记录时需要确认 - 删除记录时显示提示以确认该操作。
- 自动保存新要素 - 自动保存编辑内容，以便快速数字化新要素。
- 自动保存属性和几何更新 - 自动保存属性和几何更新。
- 保存时从选定内容中移除要素 - 如果仅存在一条记录，可以选择过渡到下一条记录或者返回到编辑模板页面。
- 超出字段长度时切换为多行输入 - 将文本输入从单行切换为多行。
在几何设置部分中，从以下选项中进行选择：
- 默认启用几何编辑 - 默认启用几何编辑，以便可以快速修改要素的形状。
- 启用地图导航锁定 - 锁定地图导航以帮助在触摸屏设备上进行编辑。
- 启用所选点要素到 GPS 位置的移动 - 启用点要素以移动到当前 GPS 位置。
- 启用所选点要素到 XY 位置的移动 - 启用使用定义的参考系将点移动到指定位置的功能。
  - 默认参考系 - 设置使用地图的当前空间参考、十进制度数的纬度-经度或 MGRS 坐标将选定点要素移动到新位置时的默认参考系。
- 设置要素选择的容差（像素）- 可以通过单击要素打开属性编辑面板。
在操作设置部分中，从以下选项中进行选择：
- 启用相交值选取器 - 如果在相交属性操作中对于一个字段有多个值可用，则将显示提示。
- 显示属性操作更新按钮 - 如果您在任何字段上定义了属性操作，则更改要素的几何时，此选项可用于更新衍生自属性操作的值。
  - 更新几何后自动调用属性操作 - 当您更改要素的几何时，此选项会自动更新从任意字段上的属性操作派生的值。
    警告：
    使用微件时，如果要素几何已更新，则在打开自动更新要素属性时，配置了属性操作的字段中的任何现有值将被新的相交、地址或坐标值覆盖。
- 所有要素的默认相交容差 - 启用全局相交容差。
- 默认相交容差（像素值）仅适用于点要素 - 如果所有要素的默认相交容差设置为 0，则将此设置用于点要素。
在为编辑面板提供要显示的文本部分中，更改或移除显示在要素模板列表上方的文本。提供文本以帮助用户执行编辑。如果图层不允许创建新要素且模板列表已隐藏，则此操作非常有用。
单击确定关闭配置窗口。

使用“智能编辑器”微件

打开“智能编辑器”微件可以显示模板选取器和预设值列表。如果想要编辑的图层未显示在模板选取器中，请确保在配置中为该图层选中了可编辑且该图层在地图中可见。可以使用“智能编辑器”微件来创建要素、使用字段匹配复制要素以及更新要素。

创建要素

要创建要素，请完成以下步骤：

如果您已将字段配置为包括在预设列表中，请输入其值。
注：
预设值仅适用于新要素创建。在更新现有要素时，预设不适用。
提示：
可以使用以下格式，通过 URL 参数定义预设值：https://<domain>/apps/webappviewer/index.html?id=<itemid>&<preset name>=<value>
使用 URL 参数定义日期和时间值时，只能指定固定日期，并且必须使用 Unix Epoch 时间戳格式。例如，太平洋夏令时间 2020 年 9 月 29 日下午 12:00:00 的值为 1601406000000。
添加要素：
1. 单击模板中的符号。
  提示：
  如果可用，请通过按名称搜索模板来过滤要素模板。
2. 选择在地图上添加或绘制要素，还是通过从地图复制现有要素来创建要素。
在为已添加的要素显示的属性中，于可用字段中输入信息。
这些字段因要素服务中的可编辑属性字段和可编辑图层的配置而异。
要在要素中附加图像或其他文件（如果可用），请在附件部分单击选择文件，然后在设备上浏览至此文件。
要将相关记录添加到相关表中，请单击创建新要素按钮，然后在可用字段中输入信息。

使用字段匹配复制要素

要使用字段匹配复制要素，请完成以下步骤：

选择要复制的要素：
1. 单击要用于所复制要素的要素模板符号。
2. 选择如何选择要复制的要素（按面、套索或矩形）。
3. 选择地图上的要素。
  提示：
  可以从 web 地图中的图层或者从使用“添加数据”微件添加的图层复制要素。如果 GPX 航路点添加为表图层，则无法对其进行复制。这是一个已知限制。
  选择要复制的要素窗格随即出现，且所有选定要素均将按照图层名称列出和分组。每个所选要素使用 Web 地图中弹出窗口配置的标题标注。
4. 展开和折叠源图层，并取消选中您不希望复制的任何要素。
单击应用字段匹配。
应用字段匹配窗口随即出现，其中将列出所选要素的每个源图层，并附有已匹配字段的计数。具有相同字段名称或字段别名的字段会自动匹配。
对于每个目标字段，选择一个源字段，从中将属性值复制到创建的目标要素中。
注：
可用源字段的列表将由设置为从 web 地图中的弹出窗口配置进行显示的字段进行确定，并且将独立于微件配置的图层设置选项卡中的字段设置。如果已针对给定的目标字段配置了属性操作，则该属性操作将具有较高的优先级，且无法匹配任何源字段。
创建要素时，单击应用以应用当前字段匹配。

更新要素

要更新要素，请完成以下步骤：

确保未选择模板，然后在地图上单击要素以打开其属性并编辑其信息和几何。
您还可以从所选要素的弹出要素操作访问“智能编辑器”微件。
要更新要素几何，请确保选中编辑几何框，并使用以下按钮（如果有）：
- 自动更新要素属性　-　单击此按钮可以更新动态要素属性。（绿色的复选标记表示属性将在更新几何时自动更新。）
- 地图导航　-　在移动设备上进行编辑时，单击此按钮可以锁定或解锁地图导航。（绿色复选标记表示已锁定地图导航。）
- 将选定要素移动到当前 GPS 位置 - 单击此按钮可将选定要素移动到 GPS 设备所提供的当前位置。
- 将选定的要素移动到 XY 位置 - 单击此按钮可使用地图的当前空间参考、以十进制度为单位的经纬度或 MGRS 坐标将选定的要素移动到指定的 x,y 位置。
对于相关表/图层，单击相关记录以打开其属性并编辑信息。
要移除要素，请单击删除。