Survey widget

The Survey widget integrates with ArcGIS Survey123 and allows you to create a survey or use an existing survey in the widget. Use the Survey widget to collect feedback or general data from end users. When you include a survey in your app, you can collect data from users by asking questions. Depending on the question type, the answer to each question is stored as an attribute, geometry, or attachment for a feature in the underlying feature layer. If you connect the Survey widget to a data source that contains a layer or layer view of the survey data, users can select a feature in other widgets that are also connected to that same data source to edit or view the data through the survey.

Examples

Use this widget to support app design requirements such as the following:

• You want to collect general user feedback for a project.
• You want to collect feedback from the community about a city park and store the survey results in a table related to the park's feature layer.
• You want to collect ratings and suggestions from the public for hiking trails around the city.
• You have a survey of tree hazards and want field workers to be able to select a feature on the map to display corresponding survey responses in the Survey widget so they can view the data or edit values to submit updates to the survey layer.

Usage notes

When you add a Survey widget to the page, you can create a survey using the integrated survey designer, connect to one of your existing surveys, or connect to an existing survey that is shared with you. Once you create a survey or select an existing survey, additional widget configuration settings allow you to change its appearance and send data from the app to the survey. For example, you can send data from a map in your app to the survey by connecting feature attributes or geometry in the feature layer to questions in the survey. All data collected by the survey in your app is stored in the survey’s underlying feature layer.

The survey content adjusts to fit the width of the widget, which you can resize on the canvas. You can configure the widget to ignore a survey’s theme if it doesn’t fit your app design.

Tip:

If you want users to be able to submit multiple responses, you can use URL parameters to configure automatic refresh in Survey123.

Settings

The Survey widget includes the following settings:

• There are three ways to select a survey:
  • Create new survey—Create a survey to populate the widget in your app. Provide a name, optionally provide tags and a summary, and click Create. A new survey is created in your content and a survey designer window appears. For help designing the survey, see Create and publish a survey in the Survey123 help.
  • Select my own survey—Select a survey that you have already created. If you're an administrator, you can also select surveys created by members of your organization. To make changes to the survey, click Edit survey to open the survey designer. If the survey for this widget was created with Survey123 Connect, you cannot edit content for survey questions in the designer.
  • Select others' survey—Select a survey that is made by someone else in your organization and is shared with you, your organization, or the public.

• Appearance—Show additional layout elements from the survey to fit the context of your app. For example, you can include the survey header, description, and footer or turn on its theme to use the colors and background images from the survey. (By default, the widget displays the survey content without its theme so it doesn’t conflict with the theme of your app.)

• Mode—Specify whether users can submit new survey responses or edit or view existing records. Optionally, you can configure the widget to populate some survey questions with data from a feature selected with a Select widget, Map widget, or any other widget that allows selecting records. For all modes, click Select data to open the Select data panel, where you can choose a data source. To allow editing or viewing existing records, you must select the data source that contains the survey layer or layer view.

  Note:

  Edit and view modes only support surveys created with Survey123 version 3.9 and later.

  • Submit a new record—Allow users to create records by submitting survey responses.
    • Send data to this survey—Instead of users manually inputting an answer, a survey question can be completed using the geometry or attributes of a feature in another widget (such as a selected feature in a map or table). For example, when a user selects a park on the map, you can send the object ID of the selected park to a hidden Park ID question in the survey, allowing you to associate the user's comment with a specific feature in the park layer.

      Note:

      If you want users to be able to select a feature in a web scene and populate survey questions with data from that feature, the scene layer must have an associated feature layer.

      • Add connection—Connect a field from the data source to a question from the survey. You can add multiple connections if you want to pass multiple attributes to the survey.
  • Edit an existing record—Allow users to edit existing data by selecting a feature from another widget, modifying corresponding values in the survey, then submitting updates back to the feature.
  • View an existing record—Allow users to view existing data in read-only mode by selecting a feature from another widget and displaying corresponding values in the survey.