- What is XLSForm?
- Can I import existing XLSForms?
- What is the Survey123 website?
- When should I use the Survey123 website to author my surveys versus Survey123 Connect for ArcGIS?
- Can I show specific questions based on the answers from other questions?
- Do I need to include a geopoint, geotrace, or geoshape question in my survey?
- Can I control the initial extent, scale, and basemap in the map display for my geopoint, geotrace, or geoshape question?
- Can I use non-ASCII characters in my survey?
- Do surveys support right-to-left languages?
- How many questions can a survey contain?
- Is there a limit on the number of choices shown in a pick list?
- How can I restrict user input for a question in my survey?
- What bar code formats does Survey123 support?
- Where are my surveys stored?
- Can I move my survey files to a different location on my machine?
- Can I move the items for my survey to a different location in my ArcGIS organization?
- Can I transfer my survey files to a different machine?
- Can I modify an existing survey?
- How can I integrate Survey123 with Workforce for ArcGIS?
- Why can't I access my Survey123 survey in Workforce?
- Can I install Survey123 Connect and Survey123 Connect Classic on the same machine?
- Why can I no longer ignore SSL errors?
- Why does the schema preview for my survey display the field length for select one questions as 255, when the field length for the question in the existing feature service is less than 255?
- Does Survey123 Connect have support for command line parameters?
- Can I reference images that are hosted online inside note questions and the thank you screen?
- Why am I seeing thousand separators in some numbers but not others?
XLSForm is a specification that describes how to define a form using a spreadsheet. It is a widely adopted standard and is described at length at xlsform.org.
XLSForm allows you to specify what questions will be present in your form, how they are presented to the user, and how to validate the responses.
Numerous data collection tools use XForms as their input. XLSForm spreadsheets that you create are translated into an XML file following the XForms standard, which is then used in data collection tools.
Using the Survey123 website, you can bring your own XLSForms into ArcGIS.
Survey123 for ArcGIS allows you to take existing XLSForms and import them into ArcGIS. You'll use Survey123 Connect for ArcGIS to do this.
If you create surveys that you want to share with others, you can send them the .xls (or .xlsx) file via email to import into Survey123 Connect for publishing.
The Survey123 website is the heart of Survey123 for ArcGIS. Using the Survey123 website, you can manage your surveys, control who can contribute to them, and view and understand the data submitted to your surveys. The Survey123 website is a web browser-based application and is available at survey123.arcgis.com for ArcGIS Online users.
The advantage of the Survey123 website authoring tools is their ease of use: You can start creating surveys with no training. The type of questions and smart survey features available through the Survey123 website authoring tools are limited but are sufficient for basic surveys. If you need more advanced question types or more complex rules, you'll need Survey123 Connect for ArcGIS. In either case, your surveys will be displayed in the Survey123 website survey gallery, and you can share them and analyze your collected results in the Survey123 website as well.
Yes. Using the relevant column, you can hide some questions by default, and show them based on the answer from another question. A question hidden through the relevant column cannot submit any data in the survey, and any data previously entered into the field is deleted. For more information, see Form expressions.
Can I control the initial extent, scale, and basemap in the map display for my geopoint, geotrace, or geoshape question?
When publishing to ArcGIS Online, a survey can contain a maximum of 1,024 columns (including system fields), while a survey published to a portal can contain a maximum of 500. In both cases, this maximum limit can be circumvented by placing part of your survey into a repeat with a repeat count of 1 and storing that part of the survey in a related table.
For surveys authored in Survey123 Connect, Esri custom columns such as body::esri:inputMask can be used to restrict user input. The Survey123 web app does not currently support input masks.
Yes. After publishing a survey, you can use Survey123 Connect to download your files. Sign in with your ArcGIS organizational account, and click the thumbnail for the survey that appears to download.
Alternatively, if you want to transfer files before publishing, Survey123 Connect will display and open any survey in the My Survey Designs folder, provided all files are present in a folder and share the same file name. On all platforms, this folder can be found at \Username\ArcGIS\My Survey Designs.
Be sure to use the My Survey Designs folder, rather than the My Surveys folder that may be present. My Surveys is the folder the Survey123 field app uses for its downloaded surveys.
Before you publish a survey, you can modify the survey, such as changing the question label, adding questions, reordering questions, or deleting questions.
Once a survey is published, you can make limited modifications to it. Edits that do not require changing the schema of the feature service can be made without issue. For more information, see Publish your survey.
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.
Early adopter releases of Survey123 for ArcGIS used the ArcGIS Code Sample item type to store surveys in ArcGIS Online and ArcGIS Enterprise. These survey items are not supported in Workforce and will soon no longer be supported in Survey123. Be sure to upgrade your surveys or re-create the survey items with the latest version of Survey123.
Why does the schema preview for my survey display the field length for select one questions as 255, when the field length for the question in the existing feature service is less than 255?
Prior to Survey123 2.7, the default field length for select one questions was equal to the longest choice in the choice list. This was changed in version 2.7, making the default field length for select one questions 255. This is to allow the user to add additional choices with a greater length to a choice list in an already published survey without having to re-create the feature service to increase the field length for this question.
For surveys previously published or created using existing feature services, the schema preview will always display 255, regardless of the length of the field in the feature service. When publishing the survey again, the field length in the feature service will be honored, and a warning will be displayed if changes to the choice list exceed the current field length.
Currently, the following command line parameters are supported by Survey123 Connect. 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.
If your survey is to be completed in a web browser, you may choose to use images in it that are hosted online. When doing this, ensure that the image is shared publicly. If you are referencing an image hosted by ArcGIS Online, the URL must use the format of https://<org_url>/sharing/rest/content/items/<item_id>/data.