将 Survey123 与现有要素图层搭配使用

默认情况下,如果在 ArcGIS Survey123 Connect 中发布调查,则将使用调查中的方案来创建要素图层。 或者,您可以选择将调查与现有要素图层相关联。

准备要素图层

要将要素图层用于 Survey123,图层必须是 ArcGIS EnterpriseArcGIS Online 中的项目。 其中包括发布到联合和非联合服务器的托管要素图层和要素图层。

注:

要使用非联合要素服务,则需进行其他配置,即必须在 ArcGIS 组织中手动创建表示该服务的要素图层项目。 有关详细信息,请参阅有关如何连接至非联合 ArcGIS Server 服务的知识库文章。

调查的所有者和用户必须具有访问要素图层的权限,且该要素服务必须是可编辑的。 还要考虑以下几点内容:

  • 如果用户要收集新的调查,则需要 Create 功能。
  • 如果用户要编辑现有调查,则需要该图层的 Update 功能。
  • 如果用户要捕获图像、音频或文件,则必须将 hasAttachments 设置为 true

在要素图层上启用附件时,KEYWORD 和 EXIFINFO 列在默认情况下不会添加到方案中。 要将附件与正确记录相关联,需要使用此列。 在启用附件后,请运行升级附件地理处理工具以启用关键字。

注:
建议在使用 Survey123 采集记录之前添加 KEYWORD 和 EXIFINFO 列,以使提交的所有附件均具有关键字。 如果在提交附件之前 KEYWORD 和 EXIFINFO 列不存在,则可以使用更新附件关键字 Python 笔记本来更新附件。

除非子图层或表针对关系使用 GUID 字段,否则重复部分将无法引用相关的图层或表。

如果您计划对调查进行编辑,请确保要素图层允许空值或者调查使用必填字段。 删除答案而未对其进行替换时,Survey123 将在编辑中使用空值;因此,对于不允许空值的要素服务,Survey123 将不提交要素图层中的调查。

此要素图层的以下附加功能必须设置为 true:

  • supportsAttachmentsByUploadId - 在要素图层上启用附件时,该功能将自动启用。 该功能允许应用程序在提交调查之前上传与调查相关的所有附件。 如果任何附件上传失败,整个调查提交将回滚,以防止数据丢失。
  • supportsApplyEditsWithGlobalIds - 要素图层必须支持使用全局 ID 应用编辑内容。 该功能允许应用程序在已创建的要素中创建和管理全局 ID(而不是服务器为已创建的要素创建新的全局 ID)。

要使要素图层支持使用全局 ID 应用编辑,必须满足以下要求:

  • 要素图层中的图层必须具有一个具有唯一索引的 GlobalId 列。 完成此操作的最佳方法是在发布要素图层时启用同步。
  • 如果使用多用户地理数据库,则图层可以使用分支版本化,但不可以使用传统版本化。 Survey123 将在使用分支版本化地理数据库时将默认版本作为目标版本。 有关详细信息,请参阅版本化类型
  • 在启用要素图层或表上的附件之前,该要素图层或表中必须存在全局 ID。
  • 如果要素图层包含启用 m 值的图层,则必须启用在无 m 值的情况下编辑

有关在要素图层中支持编辑操作的详细信息,请参阅 ArcGIS REST API 文档的图层(要素服务)中的 supportsApplyEditsWithGlobalIds

注:

在使用现有要素图层和相关表时,Survey123 仅支持一对多 GUID 关系。 系统将不支持一对一关系。

通过要素图层创建调查

您可以在 Survey123 Connect 中根据现有要素图层创建调查。 要素图层必须提前准备好才能用于 Survey123。 登录到您的 ArcGIS 组织,然后单击新建调查。 选择要素服务类别。 浏览至要素图层并对其进行选择,然后单击创建调查。 将通过要素图层生成 XLSForm。 然后,可以立即发布此调查,或者进一步对其进行自定义。 例如,可以向问题添加更具描述性的标注,或者将其分组排列。

如果您选择的要素图层具有多个图层,则系统将基于第一个图层生成调查。 要基于要素图层的另一个图层创建调查,则必须手动创作调查并更新电子表格中设置选项卡上的 form_idsubmission_url 属性。 有关详细信息,请参阅创作与要素图层相匹配的调查

如果所选要素图层具有附件,则将在调查中创建名为 <layer_name>_image 的单一图像问题。 该名称将与附件表中的关键字不匹配,必须进行更新。 如果现有附件表示多个问题,则您必须将图像问题添加至调查,以与附件表中的所有关键字相匹配。

注:

如果您正在创建的调查需要音频或文件问题,则必须手动将这些问题添加到调查中。 生成调查之后,打开电子表格并添加问题。 有关详细信息,请参阅媒体问题。 要素图层还必须启用附件。

创作与要素图层相匹配的调查

您可以手动创作与现有要素图层匹配的新调查,但是您必须在电子表格的设置选项卡上更新 form_idsubmission_url 属性,以定义调查与您的门户或 ArcGIS Online 中的要素图层项目之间的链接。

form_id 属性在调查中所使用的要素图层内显式定义图层的名称。 有关详细信息,请参阅有关如何创作与要素服务相匹配的调查的知识库文章。

submission_url 属性是要素图层项目的 URL。

Survey123 表单中的提交 URL
提示:

您必须提供要素图层项目的 URL,如上所示。 常见错误是使用不受支持的要素图层 URL。

要创建此 URL,必须将项目 ID 与门户内容根连接起来。 上图中的示例显示了指向 ArcGIS Online 项目的链接;指向门户中相同项目的链接与以下链接类似:

https://<host>:<port>/arcgis/sharing/rest/content/items/21a6c530b31a4523bdff7gg94c9c5d9a

如果您所需的调查需要现有要素图层的某些字段但并非所有字段,建议通过要素图层生成调查(如以上部分所述),然后在发布调查之前删除不需要的问题。 这样,form_idsubmission_url 属性将自动创建。

修改方案

根据现有要素图层创建调查后,仅在将相应字段或域添加至要素图层后,才能将新问题和选择列表值添加至调查。 根据要素图层视图创建调查时,仅在将相应字段或域添加至基础要素图层并传播到要素图层视图后,才能将新问题和选择列表值添加至调查。