默认情况下,如果在 ArcGIS Survey123 Connect 中发布调查,则将使用调查中的方案来创建要素图层。 或者,您可以选择将调查与现有要素图层相关联。
准备要素图层
要将要素图层用于 Survey123,图层必须是 ArcGIS Enterprise 或 ArcGIS 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_id 和 submission_url 属性。 有关详细信息,请参阅创作与要素图层相匹配的调查。
如果所选要素图层具有附件,则将在调查中创建名为 <layer_name>_image 的单一图像问题。 该名称将与附件表中的关键字不匹配,必须进行更新。 如果现有附件表示多个问题,则您必须将图像问题添加至调查,以与附件表中的所有关键字相匹配。
注:
如果您正在创建的调查需要音频或文件问题,则必须手动将这些问题添加到调查中。 生成调查之后,打开电子表格并添加问题。 有关详细信息,请参阅媒体问题。 要素图层还必须启用附件。
创作与要素图层相匹配的调查
您可以手动创作与现有要素图层匹配的新调查,但是您必须在电子表格的设置选项卡上更新 form_id 和 submission_url 属性,以定义调查与您的门户或 ArcGIS Online 中的要素图层项目之间的链接。
form_id 属性在调查中所使用的要素图层内显式定义图层的名称。 有关详细信息,请参阅有关如何创作与要素服务相匹配的调查的知识库文章。
submission_url 属性是要素图层项目的 URL。
提示:
您必须提供要素图层项目的 URL,如上所示。 常见错误是使用不受支持的要素图层 URL。
要创建此 URL,必须将项目 ID 与门户内容根连接起来。 上图中的示例显示了指向 ArcGIS Online 项目的链接;指向门户中相同项目的链接与以下链接类似:https://<host>:<port>/arcgis/sharing/rest/content/items/21a6c530b31a4523bdff7gg94c9c5d9a
如果您所需的调查需要现有要素图层的某些字段但并非所有字段,建议通过要素图层生成调查(如以上部分所述),然后在发布调查之前删除不需要的问题。 这样,form_id 和 submission_url 属性将自动创建。
修改方案
根据现有要素图层创建调查后,仅在将相应字段或域添加至要素图层后,才能将新问题和选择列表值添加至调查。 根据要素图层视图创建调查时,仅在将相应字段或域添加至基础要素图层并传播到要素图层视图后,才能将新问题和选择列表值添加至调查。