Skip To Content

Use Survey123 with ArcGIS Server

In this topic

By default, when you publish a survey in Survey123 Connect for ArcGIS, a feature service is created using the schema from your survey. You can also generate a survey from an existing hosted or ArcGIS Server feature service, or author a survey that matches an existing feature service. The submission_url property on the Settings tab of your spreadsheet is used to define a link between your survey and the existing feature service. The form_id property explicitly defines which layer is used by the survey.

Submission URL

Prepare a feature service

To use a feature service with Survey123 it must be a hosted service from Portal for ArcGIS or ArcGIS Online.

The owner and users of the survey must have access to the feature service.

Repeats cannot reference related layers or tables unless the child layer or table uses a GUID field for the relationship. If using ArcGIS Server 10.3.1, repeats cannot work with related layers or tables unless the relationship uses a GUID field for the relationship in the parent layer. Although not a requirement in later versions of ArcGIS Server, best practice would be to use a GUID field for the relationship in the parent layer.

Note:

Creating surveys directly from federated services is currently not supported.

To work with non-federated feature services, some additional configuration is required. You will need to manually create a feature layer item that represents the service, in your ArcGIS organization. The feature service can be public but at the time of publishing your survey with the service submission_url, it will need to temporarily by made not public. For more details see this knowledge base article on how to connect to non-federated ArcGIS Server services.

Generate a survey from feature service

The quickest way to create a survey that is linked to an existing feature service is to generate the survey from the feature service in Survey123 Connect for ArcGIS.

In Survey123 Connect choose New Survey, sign in to your ArcGIS organization and select the Feature Services category. Browse to and select the desired feature service and click Create Survey. An XLSForm will be generated from your feature service. You can then publish this survey immediately or further customize it. For example, you may choose to add more descriptive labels to the questions, or group them into sections.

Surveys can not be generated from public services.

Author a survey that matches a feature service

It is also possible, but not recommended, to author a new survey that matches an existing feature service. If you require a survey that does not include all the fields of an existing feature service, it is recommended to generate a survey from the feature service (as described above) and delete any of the questions that are not needed before publishing the survey. For more details see this knowledge base article on how to author a survey that matches a feature service.