Survey123
ArcGIS Survey123 is a simple and intuitive form-centric data gathering solution that makes creating, sharing, and analyzing surveys possible in just three easy steps: 1) Ask Questions; 2) Get the Answers; 3) Make the best Decisions.
This connector is available in the following products and regions:
| Service | Class | Regions |
|---|---|---|
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure China regions - US Department of Defense (DoD) |
| Power Automate | Standard | All Power Automate regions except the following: - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Power Apps | Standard | All Power Apps regions except the following: - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Contact | |
|---|---|
| Name | Survey123 |
| URL | https://www.esri.com/survey123 |
| [email protected] |
| Connector Metadata | |
|---|---|
| Publisher | ArcGIS Survey123 |
| Website | https://www.esri.com/survey123 |
| Privacy policy | https://www.esri.com/en-us/privacy/overview |
| Categories | Website;Productivity |
ArcGIS Survey123 lets you design location-aware smart forms for your organization and for the public, allowing people to submit data on the web or with the Survey123 field app. Survey123 is part of ArcGIS, bringing the power of location intelligence into your survey data. For more information, see the ArcGIS Survey123 Overview.
Prerequisites
- An ArcGIS organizational account is required. For more information, see Create account.
- The Survey123 connector is designed to help you work with Survey123 surveys hosted in ArcGIS Online. If you want to use this connector with surveys hosted in ArcGIS Enterprise, please contact your Esri representative to discuss how Esri can help you configure your own custom Survey123 connector.
- You must be the owner of an ArcGIS Survey123 survey.
Get started
Once you have published your survey, you can familiarize yourself with this connector using templates from the gallery. Any data submitted through your form will be available in Microsoft Power Automate as dynamic content. You can even work with photos and signatures!
Considerations
You can only access surveys that you own.
By default, a flow is triggered when a survey response is submitted. To trigger a flow when a survey response is edited, go to the webhook settings for your survey on the Survey123 website. In the Trigger events section, enable the Existing record edited option. For more information on webhook settings, see Configure a webhook in the Survey123 website.
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 100 | 60 seconds |
Actions
| Create report |
Create report |
| Get surveys |
This action retrieves a list of surveys owned by the logged in-user |
Create report
Create report
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Survey
|
surveyItemId | True | string |
Survey |
|
Feature layer
|
featureLayerUrl | True | string |
Feature layer |
|
Report template
|
templateItemId | True | string |
Report template |
|
Feature object ID
|
objectIds | string |
Features to include in report. Use comma to separate multiple ObjectIDs |
|
|
Feature WHERE clause
|
where | string |
Features to include in report. A SQL WHERE clause to filter records |
|
|
UTC offset
|
utcOffset | string |
Apply an offset for your time zone, e.g. +02:00 or -09:00 |
|
|
Report name
|
outputReportName | string |
Report name |
|
|
Format
|
outputFormat | string |
Format |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
jobId
|
jobId | string |
jobId |
|
jobStatus
|
jobStatus | string |
jobStatus |
|
submitted
|
submitted | integer |
submitted |
|
completed
|
completed | integer |
completed |
|
title
|
resultInfo.title | string |
title |
|
totalCount
|
resultInfo.totalCount | integer |
totalCount |
|
succeededObjectIds
|
resultInfo.succeededObjectIds | array of integer |
succeededObjectIds |
|
failedObjectIds
|
resultInfo.failedObjectIds | array of |
failedObjectIds |
|
details
|
resultInfo.details | array of |
details |
|
resultFiles
|
resultInfo.resultFiles | array of object |
resultFiles |
|
objectIds
|
resultInfo.resultFiles.objectIds | array of integer |
objectIds |
|
name
|
resultInfo.resultFiles.name | string |
name |
|
size
|
resultInfo.resultFiles.size | integer |
size |
|
status
|
resultInfo.resultFiles.status | string |
status |
|
url
|
resultInfo.resultFiles.url | string |
url |
|
objectIds
|
resultInfo.resultFile.objectIds | array of integer |
objectIds in the first result file |
|
name
|
resultInfo.resultFile.name | string |
name of the first result file |
|
size
|
resultInfo.resultFile.size | integer |
size of the first result file |
|
status
|
resultInfo.resultFile.status | string |
status of the first result file |
|
url
|
resultInfo.resultFile.url | string |
url of the first result file |
|
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 |
|
outputFormat
|
inputInfo.parameters.outputFormat | string |
outputFormat |
Get surveys
This action retrieves a list of surveys owned by the logged in-user
Returns
Triggers
| When a survey response is submitted |
Triggers a new flow when a survey response is submitted by a user |
When a survey response is submitted
Triggers a new flow when a survey response is submitted by a user
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Survey
|
surveyId | True | string |
Survey |
|
events
|
events | True | array of string |
events |
|
Include portal info
|
includePortalInfo | True | boolean |
Include the portal info in the payload, such as the portal URL. |
|
Include user info
|
includeUserInfo | True | boolean |
Include the user info in the payload, such as the user name, email address, first name and last name. |
|
Include survey info
|
includeSurveyInfo | True | boolean |
Include the survey info in the payload, such as the survey title and survey item id. |
|
Include submitted record
|
includeServiceRequest | True | boolean |
Include the submitted record info in the payload, such as attributes and geometry of the feature. |
|
Include server response
|
includeServiceResponse | True | boolean |
Include the raw server response in the payload. |