- How can I submit data to my surveys?
- Do I need to be an ArcGIS named user in order to use the Survey123 field app or web form?
- What ArcGIS role do I need to have to use Survey123?
- Can I share my survey with users outside my organization?
- How accurate is the location captured by the Survey123 field app?
- How can I improve the location captured by my device?
- How do I change the location permissions of the Survey123 field app?
- Can I work with a device that does not have a data plan?
- Can I work offline?
- Does Survey123 support the High Efficiency Image Compression format?
- How can I integrate Survey123 with Workforce for ArcGIS?
- Why can't I see the Sent box or the Inbox for my survey?
- Why does my survey display a message to delete repeated records when I answer another question?
- Can I install the Survey123 field app and the Survey123 Classic field app on the same machine?
- Why can I no longer ignore SSL errors?
- Does the Survey123 field app have support for command line parameters?
- Do I need to allow mock locations to use an external GNSS receiver with Survey123?
Once a survey is published, you can share it with one or more groups in your ArcGIS organization. At that moment, your survey will be available to users, who can submit data through the Survey123 field app. Surveys created on the web can be accessed directly over the browser from your desktop or mobile device, making it easy for people to capture data right away. Surveys created on the web or in Survey123 Connect can also be downloaded to your desktop or mobile device and used in the Survey123 field app. The Survey123 field app is a more robust approach to data capture, supporting online and offline workflows as well as very large surveys.
To publish a survey, the minimum privileges required are as follows:
- Create content
- Publish hosted web layers
- Share maps and apps
Typically, this would be a Publisher role, but you can also create a custom role in your organization that contains only these privileges.
To use a survey, the minimum privileges required are as follows:
- Use maps and apps
- Join groups
- Edit features
Typically, this would be a User role, but you can also create a custom role in your organization that contains only these privileges.
For additional details, see User types, roles, and privileges.
On iOS, when the app is launched for the first time after installing, you will be asked if you want to capture location only when the app is on, always, or never. This can be changed later in your device's settings, by browsing to Settings > Privacy > Location Settings > Survey123.
On Android, when the app is launched for the first time after installing, you will be asked if you want to allow access to the device's location. This can be changed later in your device's settings, by browsing to Settings > Apps > Survey123 > Permissions (or similar depending on the Android device). On Android, when you run the app in the background, a notification that the app may be using your current location appears; however, your location will only be captured according to the behavior chosen in the location settings within the app. The default behavior is to only capture the location as needed by a survey, meaning that no location is captured when the app is in the background.
Connect to Wi-Fi to download the Survey123 field app, as well as any surveys you need to take to the field. You can then begin capturing survey information without a data connection. All of your survey results will be stored locally on your device. When you return to the office and have a Wi-Fi connection, you will able to submit your data. This workflow can also be used when running ArcGIS Enterprise behind a firewall.
Yes. Your surveys will continue to work while disconnected.
If you've included a geopoint question in your survey, be sure to also include an offline basemap in your survey. For details, see Prepare basemaps for offline use.
iOS 11 introduced the High Efficiency Image Compression (HEIC) format, which is used as a default image format for photos taken by iPhone 7 and later devices in the camera app. HEIC images are not supported by ArcGIS Online, so HEIC images attached to surveys are converted into JPEG files before submission.
Workforce for ArcGIS works well with Survey123 for ArcGIS, allowing dispatchers and mobile workers to communicate as they complete assignments. You can integrate with Survey123 to provide mobile workers a clean transition between updating their assignments in Workforce and capturing data in Survey123. To do so, create your survey, and configure Workforce to open that survey. For details on configuring Workforce, see Integrate other Esri apps. You can also learn more about Workforce through its resources.
Once you've configured your Workforce project, mobile workers can open Survey123 through Workforce, opening Survey123 with the associated survey and also creating a geopoint at the location of the assignment.
If the repeat count for a repeat is reduced through a calculation or being tied to another question, the app will present a button to delete all repeated records with values in them above the new repeat count; empty repeat records will be automatically deleted. Submitting the survey response will not send records above the new repeat count.
Only one version of the Survey123 field app should be installed on a machine, as both use the same URL scheme. If both versions of the app are installed on the same machine, and the URL scheme is used to launch the Survey123 field app (including surveys launched through Workforce for ArcGIS), the unwanted version may launch.
Currently, the following command line parameters are supported by the Survey123 field app. These parameters should have two hyphens before them, for example --show maximized.
- show maximized—Opens the window as maximized on desktop platforms.
- show fullscreen—Opens the window as full screen on desktop platforms.
- show minimized—Opens the window as minimized on desktop platforms.
- show normal—Opens the window as neither maximized, minimized, nor full screen.
- locale localeCode—Overrides the system language with the language defined by the locale code. For example, locale fr uses French translation files. This can be useful when testing your app in different languages.
- renderingEngine—Only supported on Windows desktop. Sets the graphics rendering engine. Supported values are default (which will use OpenGL and fall back to ANGLE if OpenGL encounters errors), opengl, and angle.
When using an external GNSS receiver with Survey123 3.2 or earlier on Android devices, you need to enable a mock location provider on the device so that data from the external receiver is made available to any running apps in place of the internal device location.
In Survey123 3.3 or later, you can connect directly to many external GNSS receivers, no longer requiring mock location configuration on Android devices. When you connect directly to a receiver, you also get access to additional location metadata, such as accuracy and satellite information. For a list of external receivers that you can connect to directly, see Choose a receiver.
Some receivers cannot be connected to directly. For these receivers, you can still use a mock location provider to replace the internal device location. In this case, you will get the position from the external receiver but not the additional metadata, and you'll usually rely on an app from the GNSS receiver manufacturer running on the device to process the location first, before it is passed through to the internal location provider.