Select to view content in your preferred language

What's new in ArcGIS Survey123 (February 2022)

4734
11
02-24-2022 07:23 PM
IsmaelChivite
Esri Notable Contributor
9 11 4,734

 

 

The ArcGIS Survey123 February 2022 update is now available. This release includes great additions to the Survey123 web designer to help you visually create more powerful smart forms. The Survey123 field app includes massive improvements to make calculations faster and support for custom markup tools. All of that, and much more!

Read on to learn what’s new:

Survey123 web designer and web app

  • Use your own web maps in a survey
  • Have your survey automatically get the respondent’s location
  • Use your own locators with the address and map questions

Survey123 Connect and field app:

  • Faster calculations and new calculation modes
  • Markup photos, maps and diagrams with custom markup tool palettes
  • New Media tab and Overview folder option

Other enhancements and important release notes:

  • Expanded report syntax
  • Other release notes

 

 

Survey123 web designer and web app

 

The Survey123 web designer helps you visually create smart forms, right from a web browser. In recent updates we added support for the new Address question type, introduced calculations, and added options to permanently hide questions in your form.

This release brings more enhancements to the Map and Address question types.

 

Use your own web maps in a survey

 

Up until this release, you could configure a default map for your survey. Well, kind of, as you could only choose a map already present in  your organization’s basemap gallery. Now, however, you can select any web map!

Note that a new Edit option has been added to help you configure the contents of your map. You can select a map you own as well as other maps from your organization.

001_Survey123 Designer Change Map.gif

 

Have your survey automatically get the respondent’s location

 

Map questions now support various options to determine the default location. Use these options to specify the behavior of your map: Should the map automatically center when the survey is opened? Or when the user interacts with the map? What if instead the map should be centered at a predetermined location?

002 Designer New Default Map Location Options.jpg

Automatically centering the map when the form loads is something new for online surveys. Combined with calculations, it is a powerful option because it makes your smart forms location-aware.

Say, for example, you create a survey to report issues in your city. Since you know where the user is, you can automatically populate questions such as city, postal code or address where the incident happens.

 

Use your own locators with the address and map questions

 

Many people may not know how to pinpoint the location of something in a map, but for sure they will now its address. We introduced the address question type in our previous release. It helps respondents complete an address as they type.

To simplify data entry boost the quality of your data, it is good practice to configure address questions with your own locators. You can now easily do that right from the Survey123 designer.

003_Survey123 Designer Change Locator.gif

 

If you are creating a web survey to collect information in your city, why would you use a locator with addresses from other places? Learn how to create your own locator, share it, and use it with your Survey123 address questions.

Survey123 Connect and field app

 

Survey123 Connect is a desktop tool. With it, you can author the most sophisticated forms using an XLSForm spreadsheet. The Survey123 field app is available for iOS, Android and Windows devices.  It includes advanced options to work with your smart forms from the field, or the office.

The new build numbers for Survey123 Connect and the field app are 3.14.256 and 3.14.237, respectively.

Faster calculations and new calculation modes

 

Calculations in a smart form allow you to populate questions based on previously entered responses. The calculation execution in the Survey123 field app has been optimized to make your forms faster. You will appreciate the difference when working with very large forms.

Additionally, starting with this release, you can specify three different calculation modes in your questions:

  • Auto: The calculation is triggered if the question is empty or if it has not been previously modified by the user. This is the default mode and the only one available up until this release.
  • Always: Auto-calculates the value, even if the user has already entered a value.
  • Manual: Use this option if you want the user to trigger the calculation manually.

The new calculation modes give you more flexibility to dictate the logic of your form.

 

Markup photos, maps and diagrams with custom markup tool palettes

 

Survey123 includes image annotation tools. With them, users can markup photos, diagrams and maps. We gave these tools an overhaul in late 2021. This update introduces the concept of custom annotation tool palettes.

004 Survey123 markup tools.gif

 

While Survey123 comes with its own annotation tools, you may want to tailor the user experience, so it best fits your workflows. For example, if you are supporting an effort where you know users will markup in a photo the location of existing water and gas meters, you will want to create markup tools for these two features, and nothing else.

Below are some examples of custom annotation tool palettes. Note that each of the tools has its own meaning. They are all categorized logically into separate groups.

004 Survey123 Custom Annotation tools.png

Custom annotation tools make image markup more intuitive, but they also help generate more consistent image annotations.

Find more about custom annotation tools,  in our documentation and this blog post.

 

 

New media tab and overview folder option

 

Use the new Media tab in Survey123 Connect to quickly visualize the contents of the media folder for your survey, such as CSV files, custom annotation palettes, audio files and images.

 

On the Options tab, you will find a new switcher to enable or disable the Overview folder. The Overview folder is useful when you want users of the Survey123 field app to view all survey records in a single map or list.

Other enhancements and important notes

 

Improved report syntax

 

Use new report syntax to display multiple records on a single map. You can also rotate photos!

 

Other release notes

 

As announced in May 2021, macOS installers for Survey123 Connect and Survey123 field app are no longer available with version 3.14.

Access to the Survey123 field app and Connect source code in ArcGIS AppStudio is now available only upon request. Complete this form if you would like access. 3.14 will be the last version of the source code available.

Image questions (with or without the draw or annotate appearance) will not allow you to browse for existing images in your device, unless you enable local image browsing. This can be done right from within Survey123 web designer as well as from Connect using method=browse in the body::esri:style column. More details in the Survey123 Tricks of the Trade: Photos blog.

The next updates are planned for March 2022 and April 2022. If you want to get up to speed on new features coming, join the Survey123 Early Adopter Community.

 

Fixes

 

BUG-000144684 ArcGIS Survey123 field app shows duplicate choices for a select_one question with choices which contains integers only if the survey has another select_one question with more than 256 choices when the survey is updated on the device after republishing the survey
BUG-000144253 The headings for a table-list appearance are not visible when repeats are applied on the groups in the ArcGIS Survey123 field app
BUG-000143625 The select_one question type in ArcGIS Survey123 Connect or field app 3.13 populates the field domain (name) after selecting the field label (label) when the field domain is 10 or more digits
BUG-000119569 In the Survey123 for ArcGIS Mobile App, SAML ADFS logins are cached, preventing a new user from signing in when a previous user signs out
BUG-000143746 When using a geopoint question, ArcGIS Survey123 crashes on Android devices when an organization is configured with a custom geocoder

Issues causing application crash with complex surveys: BUG-000138740, BUG-000125886 ,BUG-000133842, BUG-000133237,BUG-000128201, BUG-000126685, BUG-000125015, BUG-000108085, BUG-000111086

BUG-000144753 Blank survey responses submitted for nested repeats prevent reports from being generated in the ArcGIS Survey123 website when surveys are published to Portal and surveys are submitted from the ArcGIS Survey123 field app
BUG-000140014 Thumbnails misalign on the ArcGIS Survey123 field app when the download list is refreshed
BUG-000129066 Image is not loading in the Survey123 field app via dynamic URL creation using placeholders
BUG-000127011 When using the Survey123 for ArcGIS field app, an image attachment disappears when the survey is edited from Outbox having a 'repeat' set with image question

BUG-000128495 Substr() functions do not update to show the most recent selection when editing existing survey submissions from the Inbox which initially do not contain a response in the substr() dependent field
BUG-000101479 Unpublished online surveys do not open in Survey123 Connect for ArcGIS

BUG-000145342 Unable to generate a report in ArcGIS Survey123 if there are too many getValue expressions of an attachment in the if conditional statement.
BUG-000145620 Querying a hosted feature layer created from ArcGIS Survey123 Connect returns a respectsDaylightSaving error message
BUG-000145304 ArcGIS Survey123 does not capture the updated responses passed through the custom URL parameters when editing existing submissions
BUG-000142188 When loading dates (MM/DD/YYYY) from the data taken from ArcGIS Survey123 website and ArcGIS Survey123 Connect labels sometimes work incorrectly, either failing to list Months (MM) or Years (YYYY) appropriately
BUG-000143583 If there is no attachment outside the repeat or no other questions answered inside the repeat, the ArcGIS Survey123 website does not show the repeat's image attachments on the Individual Response pane for surveys hosted on versions of Portal for ArcGIS older than 10.8
BUG-000112346 The default latitude and longitude of a read-only geopoint question that captures devices location is zero when using link for a survey
BUG-000142529 The ArcGIS Survey123 mobile app display issues with the language selector
BUG-000143301 Creating the Set rule -function does not work properly in Survey123 when the Address -component is used in the survey before the Set rule -component
BUG-000135434 ArcGIS Survey123 (On premise) post-installation within IE11 shows only The survey does not exist or is not accessible

 

11 Comments
JustinAdams
Occasional Explorer

Hello @IsmaelChivite ,

 

We have been using survey123 for awhile now. We take in field inquiries using survey123 field app that was published using connect. It is a fairly complicated form. After it is submitted, we use a web app to open the survey on the web for supervisors to review and edit before final submission. Since this update the web version automatically overwrites the geopoint from the survey. The only way to stop this that I have figured is to turn off your location settings completely. Is there another way to turn this off? I can't get to a web app/designer setting for it because I published on Connect. 

 

Thanks!  

 

Edit: This also applies to when you are trying to make an edit on the survey123 websites sidebar. It will automatically change any geopoint that you come across. 

IsmaelChivite
Esri Notable Contributor

@JustinAdams   Starting with this version, logic was added to the Survey123 web app so the user location can be automatically populated when the form loads. However, it is not expected that this would overwrite the geopoint value when you open the form in edit mode.  In fact, the location should only be populated when you configure the form to do so.

Would it be possible to look at your form in more detail? If you are open to it, please check a Direct Message I just sent to your user in Esri Community with details to set a screen sharing session.

GabeRudy
Occasional Explorer

@JustinAdams @IsmaelChivite This is happening with one of our organizations forms as well.  I reverted the Survey123 form back to 3.13 and that seemed to fix the issue.  Thank you for looking into this.  

VHolubec
Esri Regular Contributor

Hello, 

love the new option to use custom maps in the Web Designer. But cannot find a way how to set "own maps" in the Connect. Is there a way?

Thank you.

ZhifangWang
Esri Regular Contributor

@VHolubec ,

You can include any map for a survey in Survey123 Connect by setting them as linked items. Please refer to details in:

VHolubec
Esri Regular Contributor

Many thanks @ZhifangWang for clarifiacation! 

JustinAdams
Occasional Explorer

@IsmaelChivite I have reverted back to 3.13 and the issues are no longer there. It seems to be an issue with 3.14. Thanks for the tip on that @GabeRudy !

ZacharySutherby
Esri Regular Contributor

Hello @JustinAdams @GabeRudy

A patch was released to the Survey123 website last night that resolved the geopoint moving to the devices current location when editing the forms. 

If you still see the issue on the current 3.14 Survey123 website please let us know. 

Thank you, 

Zach

GarethBaker1
Frequent Contributor

Is there a way to control how the location is set when submitting responses via the web for a form that was designed via Survey123 Connect? I'd prefer for the Find My Location button to not appear on the map question and for it just to centre on the location specified in Connect if possible.

Would reverting to Connect 3.13 sort this out at least temporarily?

ZhifangWang
Esri Regular Contributor

@GarethBaker1 ,

There is no way to hide the locate button in the UI currently. If you don't want to capture the device location after loading the form in the Survey123 web app, you can set "null" as the default value (default column) to the geopoint question in Survey123 Connect. Please see details in this doc: https://doc.arcgis.com/en/survey123/desktop/create-surveys/geopoints.htm#ESRI_SECTION1_6B32C981BC5E4... 

 

Generally, for the Survey123 web app, if you leave the default column empty for a geopoint question,

  • Before 3.14 release (<=3.13), the web app does nothing but only zooms to the home location
  • After 3.14 release (>=3.14), the web app requests the device location after the form loading. Set the default value as "null" to keep the same behavior as previous versions
  • Setting a pair of coordinates as the default value works consistently before and after 3.14 version

 

 

GarethBaker1
Frequent Contributor

Thanks @ZhifangWang 

In my case I'm working with a Geoshape but the use of the null default value has done the trick - no need to remove the Find the Location button completely in this instance, just didn't want it prompting the user for location automatically.