Partilhar via


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 survey123@esri.com
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.

Returns

The outputs of this operation are dynamic.