Survey123

ArcGIS Survey123 是一种简单直观的以表单为中心的数据收集解决方案，只需执行三个简单的步骤即可创建、共享和分析调查：1）提出问题;2）获取答案;3）做出最佳决策。

此连接器在以下产品和区域中可用：

服务	Class	区域
Copilot Studio	标准	除以下各项外的所有 Power Automate 区域： - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）
逻辑应用程序	标准	除以下各项外的所有逻辑应用区域： - Azure 中国区域 - 美国国防部（DoD）
Power Apps	标准	除以下各项外的所有 Power Apps 区域： - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）
Power Automate	标准	除以下各项外的所有 Power Automate 区域： - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）

联系人
Name	Survey123
URL	https://www.esri.com/survey123
Email	survey123@esri.com

连接器元数据
发布者	ArcGIS Survey123
网站	https://www.esri.com/survey123
隐私策略	https://www.esri.com/en-us/privacy/overview
类别	网站;生产力

ArcGIS Survey123 允许你为组织和公众设计位置感知智能表单，允许用户在 Web 或 Survey123 字段应用中提交数据。 Survey123 是 ArcGIS 的一部分，它为调查数据带来了位置智能的强大功能。有关详细信息，请参阅 ArcGIS Survey123 概述。

先决条件

需要 ArcGIS 组织帐户。有关详细信息，请参阅 “创建帐户”。
- Survey123 连接器旨在帮助你处理 ArcGIS Online 中托管的 Survey123 调查。如果要将此连接器用于 ArcGIS Enterprise 中托管的调查，请联系 Esri 代表，讨论 Esri 如何帮助你配置自己的自定义 Survey123 连接器。
必须是 ArcGIS Survey123 调查的所有者。

开始

发布调查后，可以使用库中的模板熟悉此连接器。通过表单提交的任何数据都将在 Microsoft Power Automate 中作为动态内容提供。甚至可以处理照片和签名！

注意事项

只能访问你拥有的调查。

默认情况下，提交调查响应时会触发流。若要 在编辑调查响应时触发流，请转到 Survey123 网站上的调查的 Webhook 设置。在 “触发器事件 ”部分中，启用 “现有记录已编辑 ”选项。有关 Webhook 设置的详细信息，请参阅 Survey123 网站中的“配置 Webhook”。

限制

名称	调用	续订期
每个连接的 API 调用数	100	60 秒

操作

创建报表	创建报表
获取调查	此作检索已登录用户拥有的调查列表

创建报表

操作 ID:: FeatureReportSubmitJob

创建报表

参数

名称	密钥	必需	类型	说明
调查	surveyItemId	True	string	调查
特征层	featureLayerUrl	True	string	特征层
报表模板	templateItemId	True	string	报表模板
功能对象 ID	objectIds		string	报表中包含的功能。使用逗号分隔多个 ObjectID
Feature WHERE 子句	where		string	报表中包含的功能。用于筛选记录的 SQL WHERE 子句
UTC 时差	utcOffset		string	为时区应用偏移量，例如 +02：00 或 -09：00
报告名	outputReportName		string	报告名
Format	outputFormat		string	Format

名称	路径	类型	说明
jobId	jobId	string	jobId
jobStatus	jobStatus	string	jobStatus
提交	submitted	integer	提交
完成	completed	integer	完成
title	resultInfo.title	string	title
totalCount	resultInfo.totalCount	integer	totalCount
succeededObjectIds	resultInfo.succeededObjectIds	array of integer	succeededObjectIds
failedObjectIds	resultInfo.failedObjectIds	array of	failedObjectIds
详情	resultInfo.details	array of	详情
resultFiles	resultInfo.resultFiles	array of object	resultFiles
objectIds	resultInfo.resultFiles.objectIds	array of integer	objectIds
姓名	resultInfo.resultFiles.name	string	姓名
size	resultInfo.resultFiles.size	integer	size
状态	resultInfo.resultFiles.status	string	状态
网址	resultInfo.resultFiles.url	string	网址
objectIds	resultInfo.resultFile.objectIds	array of integer	第一个结果文件中的 objectIds
姓名	resultInfo.resultFile.name	string	第一个结果文件的名称
size	resultInfo.resultFile.size	integer	第一个结果文件的大小
状态	resultInfo.resultFile.status	string	第一个结果文件的状态
网址	resultInfo.resultFile.url	string	第一个结果文件的 url
jobType	inputInfo.jobType	string	jobType
featureLayerUrl	inputInfo.parameters.featureLayerUrl	string	featureLayerUrl
objectIds	inputInfo.parameters.queryParameters.objectIds	string	objectIds
templateItemId	inputInfo.parameters.templateItemId	string	templateItemId
surveyItemId	inputInfo.parameters.surveyItemId	string	surveyItemId
portalUrl	inputInfo.parameters.portalUrl	string	portalUrl
输出格式	inputInfo.parameters.outputFormat	string	输出格式

获取调查

操作 ID:: GetOwnedSurveyList

此作检索已登录用户拥有的调查列表

触发器

提交调查响应时

当用户提交调查响应时触发新流

提交调查响应时

操作 ID:: AddData

当用户提交调查响应时触发新流

参数

名称	密钥	必需	类型	说明
调查	surveyId	True	string	调查
events	events	True	array of string	events
包括门户信息	includePortalInfo	True	boolean	在有效负载中包含门户信息，例如门户 URL。
包括用户信息	includeUserInfo	True	boolean	在有效负载中包含用户信息，例如用户名、电子邮件地址、名字和姓氏。
包括调查信息	includeSurveyInfo	True	boolean	在有效负载中包含调查信息，例如调查标题和调查项目 ID。
包括提交的记录	includeServiceRequest	True	boolean	在有效负载中包含提交的记录信息，例如特征的属性和几何图形。
包括服务器响应	includeServiceResponse	True	boolean	在有效负载中包含原始服务器响应。

此操作输出是动态内容。

通过

参数

返回

参数

返回