Skip navigation
All Places > Survey123 for ArcGIS > Blog > 2017 > June
2017

Sailing Alone Around the World is a sailing memoir by Joshua Slocum about his single-handed global circumnavigation aboard the sloop Spray. Between 24 April 1895 and 27 June 1898, Slocum, aboard the Spray, crossed the Atlantic twice, negotiated the Strait of Magellan, and crossed the Pacific. He also visited Australia and South Africa before crossing the Atlantic (for the third time) to return to Massachusetts after a journey of 46,000 miles. Slocum was the first person to sail around the world alone and we devote this release to him, his journey and wonderful book.

 

Here are the highlights for this update:

 

Critical Fixes and Enhancements

 

Survey123 field app and Connect:

 

  • BUG-000105552: This bug caused the autocomplete appearance to stop working and prevent submits on select_one questions with a choice_filter set. In other words, autocomplete would no longer work on cascading selects.  This bug was a regression introduced in version 2.1 and now fixed in 2.2.
  • BUG-000103217: This software defect caused the Survey123 field app to hang when attempting to submit data to a survey if the logged-in user had been revoked permissions to access the underlying survey's feature layer. In version 2.2, the Survey123 field app will report a descriptive error message when this situation is encountered.
  • ENH-000104223: This enhancement was submitted to request a x86 compatible  version of Survey123 for Android devices that require it. As of this version, a x86 build of Survey123 will be installed automatically to x86 devices.
  • Android: Photos taken with the Survey123 camera on OPPO F1 Android Phones are now of better quality.
  • iOS: Addressed issues preventing links included within a survey to launch other Esri apps such as Navigator, Trek2There and Explorer for ArcGIS.

 

You can download the latest version of Survey123 Connect and the Field app from our Survey123 Download page.

                            

 

Survey123 website:

 

  • BUG-000105700: This bug prevented logins via SAML into the Survey123 website. Problems have been resolved for Chrome and Firefox. Internet Explorer and Edge will need to wait until our 2.3 release.

 

It is always recommended you clear  your browser cache to make sure you get the latest updates on the survey123 website.

                            

 

Survey123 configurations from Esri Solutions

 

This update coincides with four new ArcGIS for Local Government Esri Solutions configurations using Survey123:

 

  • Homeless Point-In-Time Counts: Homeless Point-in-Time Counts is a configuration of Survey123 for ArcGIS and Operations Dashboard for ArcGIS that can be used by health and human service agencies and their network of volunteers to conduct sheltered and unsheltered homeless surveys.
  • Homeless Activity Reporter: Homeless Activity Reporter is a configuration of Survey123 for ArcGIS that can be used by the general public and engaged organizations to report the location of homeless individuals and encampments in the community.
  • Drug Activity Reporter: Drug Activity Reporter is a configuration of Survey123 for ArcGIS, Crowdsource Manager, and Operations Dashboard for ArcGIS that can be used by the general public to report suspected drug activity in a community. Drug Activity Reporter helps law enforcement agencies work hand-in-hand with the public to fight crime and neighborhood disorder.
  • Naxolone Deployment Reporter: Naloxone Deployment Reporter is a configuration of Survey123 for ArcGIS that can be used by public safety staff to inventory where naloxone was used to treat an opioid overdose during an emergency incident.

 

All the configurations above have also been made available in Survey123 Connect for ArcGIS under the Community surveys.

 

New Decimal Date Time Format

 

As described in the Dates and Time in Survey123 for ArcGIS blog post, you can manipulate date and time objects in Survey123 working with their EPOCH representation, also known as Unix Time. Starting with this release, you can also work with Dates using the Decimal Date time format, also known as  French Revolutionary Time.

 

We initially incorporated support for Date and Time handling via EPOCH format because that is how DateTime objects are encoded in ArcGIS. Other products out there using the XLSForms specification work with Decimal Date time, so we decided to bring support for this format as well. 

 

The new Decimal Time format will be of your interest if you want surveys authored in Survey123 Connect to work in a web browser.  Our next-generation Web Form engine, which we plan on making available this summer will support surveys authored in Survey123 Connect, but it will expect you to define DateTime calculations using the Decimal format.

 

Just to be clear, your existing EPOCH calculations will continue to work as usual in the Survey123 field app. Now, if you want in the future to have your Connect surveys also work within a web browser you will want to consider a change to French Revolutionary Time.

 

In truth, this change should be absolutely irrelevant to most of the surveys you may have authored. Using either EPOCH or Decimal Date calculations is only necessary in a handful of situations. For example:

 

  • You want to calculate a date in the future or in the past
  • You want to calculate the time elapsed between two dates
  • You want to take a birthday date and calculate the age of a person
  • etc

 

For the most common uses of Date and Time objects in Survey123, you do not need  to do any EPOCH or Decimal Date Time calculations.  For example:

 

  • Set the default of a question to today's date
  • Validate that the user is providing a date in the past or the future
  • Ensure that a date is before  or  after another date
  • etc

 

For those of you that you will be using Decimal Date Time calculations, here is a quick guide to time, according to the French:

 

  • In Decimal Time, dates are always expressed as whole numbers (integers). Calculate a date by simply finding the number of days elapsed since January 1st 1970.  Dates older than 1970-01-01 are negative and more recent dates are positive. Adjusting for leap years, you can assume that a year on average has 365.25 days.
  • To get the decimal number out of a date or time, you can use the decimal-date-time() function.  This function returns a number that  represents the  time elapsed since January 1st 1970.  The whole part of the number represents the number of days, and the decimal part of it, the remaining portion of the day (according to the French, of course!).
  • A day has 10 hours in Decimal time. An hour has 100 minutes and every minute 100 seconds. Get familiar with equivalencies between the Decimal and the 24 hour-day system: Noon is at 5. 30 minutes are 0.5 hours and 15 minutes are ¼ of an hour.

 

The following table describes what different expressions look like using the EPOCH and Decimal formats:

 

EPOCH FormatDecimal Date Format
2 weeks into the futurenow() + 14*24*60*60*1000date(decimal-date-time(now()) +  14)
Calculate age from birthdayint((today() - ${birth_date}) div (1000*24*60*60* 365.25))

int((decimal-date-time(today()) - decimal-date-time(${birth_date})) div 365.25)

Minutes spent for lunchint(${LunchEnd} - ${LunchStart}) div (1000*60)

int((decimal-date-time(${lunchends}) - decimal-date-time(${lunchstarts})) * 24*60)

15 minutes from nownow() + 15*60*1000

date-time(decimal-date-time(now()) +  0.0104166675)

 

In general, if you really have to use Time calculations as in the table above, I would recommend that  you go with Decimal Date Time as opposed to EPOCH milliseconds. The reason is that working in this manner you will  ensure your surveys work in both the native and web flavor of the Survey123 app. You never know when using a web browser may be handy, so getting things done in Decimal Time will prepare you for the web right away.  Of course, you can continue using EPOCH if you feel more  comfortable, but just remember that your calculations will not work on the web in the future.

 

As you play with the new Decimal Date Time format, I also wanted to point you to a couple of resources:

 

Next Steps

 

The next release with functional enhancements will be 2.3 in late July or early August. Some of the features we are working on include:

 

  • Next Generation Web Forms: Our goal in 2.3 is to be able to render in a web browser any survey regardless of its  sophistication. At the moment, you can only render surveys in a web browser if you authored them with Web Designer. 2.2 will extend support to surveys authored in Survey123 Connect.
  • Enhanced printing of drill-down reports: At a high level, we want to give you options to make survey reports the way you want. We will let you author report templates in Microsoft Word and have them be used from our Survey123 website reporting tools.
  • On-premises deployments of the Survey123 website:  We want to deliver a solution for those of you who want to deploy Survey123 entirely in your own infrastructure,even if working completely disconnected from the internet. This is at risk for 2.3, but we will share what we have shortly in our Early Adopter web site.

 

Expanding support for editing with repeats is planned for 2.4, which will most likely come in September.

 

If you are eager to try the above  features and others  planned for the 2.3 release, you can access  them as Beta through our Early Adopter website.

 

We will continue looking closely at your comments in this GeoNet Group and our Early Adopter Community Website.

 

Keep your feedback coming!

BUG-000103217

 

 

 

Working on this release involved quite a bit of stracciatella and chocolate ice cream, but we knew the update would be dedicated to the World Milk Day, so we never felt too guilty. World Milk Day is celebrated on June 1st since 2011 and it is an opportunity to learn about milk and its qualities. If you don’t have a chance to break the daily routine visiting a nearby dairy farm, celebrate World Milk Day eating a delicious ice cream and reading about this tasty release.

 

The Survey123 field app build number is now 2.1.6. As usual, you can download the app from the iTunes, Google Play and Amazon stores.

Survey123 Connect for ArcGIS is now at version 2.1.9 and is also ready for Windows, Mac and Ubuntu Linux at our Downloads page.

To ensure the Survey123 website works as expected, play safe and clear your browser cache.

 

Here is what is new:

 

Survey123 website

 

In our last update, the Survey123 website included major improvements such as support for changing the design of already published surveys and the new rating question.  This release includes a handful of useful features:

 

Sharing survey results reports with others: You can easily share the results of a survey with others via a simple link. The survey results report includes an overview page with information about the number of records submitted, participants etc. The Data and Analyze tabs in the report include detailed information about every record submitted as well as aggregated information.

 

To share your results, go into the Collaborate tab, switch to the Analyze section and share your survey results with groups within your organization. Once you have shared the results of a survey through the Collaborate tab, you can grab the URL of your survey results report and include it in an e-mail, web page etc.

 

 

 

The survey results report link is a very convenient way for you to share with others a live picture of all data captured via Survey123. 

 

If you want anonymous users to look at the results of your survey, you can simply make your results public by sharing your survey with everyone. If you make your results public, we currently only let users look at the aggregated results in the Analyze tab; the Overview and Data tabs will only be visible to logged-in users. We are open to change this and allow anonymous access to the overview and data pages, but wanted to hear your feedback first.

 

Download data with a date filter: From the Data tab you can download your survey data in shapefile, file geodatabase and CSV formats.  You can now use time filters to more selectively define the amount of data you want to download.  For example, you can now limit the downloaded features to those captured in the past week, month, or within two specific dates you define.

 

 

Print Photo Size: New options have been added in the Print Report function so you can control the size that the photos will have once printed on paper.  By default, photos in your reports will be added at a small size, but you can decide to make them bigger. This is useful when you want detailed photos in your reports.

 

Website optimization: A lot of work went into making the website faster, reducing the size of files downloaded into your browser and optimizing how they get loaded on it. This may not be relevant to you if you have a fast internet connection, but it will make a significant difference if you don’t.

 

Connecting the Survey123 website to Portal for ArcGIS:  Starting with this release, you can have the Survey123 website work against your own ArcGIS Enterprise deployment. This means that you can now easily create surveys from your web browser, manage your surveys and leverage all the Survey123 reporting tools against your own instance of ArcGIS Enterprise, even when working behind a firewall. By connecting our Survey123 website with your own instance of Portal for ArcGIS, you get the latest features we implement in survey123.arcgis.com, but all data and surveys are strictly kept in your own infrastructure.

 

The mechanics for connecting the Survey123 website to your own ArcGIS Enterprise are described in this KB article.

The  minimum version of Portal for ArcGIS you require for the above to work  is 10.4 . You also must have an ArcGIS Data Store configured with your  Portal for ArcGIS Hosted Server.

Web  Designer’s ability to edit already published surveys requires Portal  for ArcGIS 10.5.1, which is scheduled to be released in July 2017. 

Note that what is described above follows a hybrid architecture, where some components such as our Survey123 website  and REST API are hosted in Esri's cloud, while other components such as your data, feature services, form items and portal are hosted in your own infrastructure. As you will see later in this post, we are working towards enabling you to deploy the entire Survey123 web site on-premises.

 

Survey123 Connect and Survey123 field app

 

Support for ArcGIS Server Federated Services: This is the first release with support for federated services. This is important for many of you who already have ArcGIS Server, and want to have Survey123 work against it.

 

If you want to build a survey on top of an existing Feature Service, simply go into Survey123 Connect and login to a portal, click on New Survey and select the Feature Service choice.  A gallery with all feature services you have access to will be shown. This list of feature services was limited to Hosted Feature Services in previous versions, but in this release the list will also include feature services from Federated Servers with your portal. 

 

Survey123 Connect will automatically create an XLSForm for the selected feature service, so you can modify it to your taste.  When the survey is published, a new Form item will be created in your ArcGIS organization and will be connected to the feature service you selected, so all data captured will go into it.

 

You can find more information about working with existing feature services in our help.

 

Note : It is possible to work against non-federated feature services following the step by step instructions outlined in this KB article

 

Enhanced Inbox: We introduced the Inbox concept in version 2.0. This two-minute video tutorial describes what the Inbox is all about. With 2.1, you can now refine your Inbox queries so they include variables such as the username. This is a handy feature allowing you to better control what surveys will be retrieved in the end-users Inbox. For example, say you want to populate the Inbox with surveys assigned to the logged in user. A query like this will do the trick:

 

 

The variable ${username} refers to the unique username as shown in the ArcGIS profile of the logged-in user. You can also use other information from the profile such as ${email}, ${firstName} and ${lastName}. 

 

Repeat Aggregated Functions: A set of new functions are available so you can count, sum and get the maximum and minimum value within responses across a repeat. These functions are handy in many situations. For example, say you want to create a smart form to perform asset inspections and you want to detail defects and the estimated cost or repairs.  You can calculate the total cost of repairs by using the sum() function. You can also use the max() function to highlight the repair item that is the  most expensive. 

 

Typically, the sum, count, max and min functions are used within the calculation column, but technically you can also use them to build constraint and relevant expressions.  For example, you can make a multiline text justification question relevant if the total cost of repairs exceeds a particular amount. 

 

If you want to see these aggregation functions in action, you can give our Daily Fishing Log survey a try.  You can either try the survey in your web browser or if you happen have the Survey123 field app installed, from the Survey123 app.

 

If you are curious how these functions were used in the Daily Fish Survey log example, here is a screenshot of the XLSForm. 

 

 

An XLSForm sample was also added to Survey123 Connect (Create New Survey-Samples) to illustrate the different repeat aggregation functions. Even the Daily Fishing Log survey is now  part of our  Community Samples.

 

 

Silent Installation: You can now install Survey123 Connect and the Survey123 field app silently through a series of scripts. This is useful when you plan to deploy or update Survey123 Connect or the Survey123 field app at large scale within your organization.   Marika recently wrote a great blog post on this topic where you can learn more about this.

 

Survey Templates and Samples: Several new community templates have been added in this release. Our templates can provide you a quick starting point for your projects, or at the very least a bit of inspiration.  You can access these templates in Survey123 Connect for ArcGIS.

 

Select New Survey and then browse templates in the Community category.

 

New templates in this release:

 

  • Pothole Report Hazard
  • Combined Sewer Overflow Notification
  • Daily Fishing Log
  • Manhole Inspection
  • Residential Septic Tank Inspection
  • Wildlife Roadkill Report

 

Other fixes and enhancements: As in every release, we also added other minor enhancements and fixes, which are detailed in the What's new help topic.

 

Next steps

 

Our next scheduled release is set for late June and will include bug-fixes only.

 

The next release with functional enhancements will be 2.3 in late July or early August. Some of the features we are working on include:

 

  • Next Generation Web Forms: Our goal in 2.3 is to be able to render in a web browser any survey regardless of its  sophistication. At the moment, you can only render surveys in a web browser if you authored them with Web Designer. 2.2 will extend support to surveys authored in Survey123 Connect.
  • On-premises deployments of the Survey123 website: In this release we presented a hybrid approach that lets you take advantage of the Survey123 website even if working against your own ArcGIS Enterprise deployment. At 2.3, we want to deliver a solution for those of you who want to deploy Survey123 entirely in your own infrastructure,even if working completely disconnected from the internet.

 

Expanding support for editing with repeats is planned for 2.4, which will most likely come in September.

 

If you are eager to try the above  features and others  planned for the 2.3 release, you can access  them as Beta through our Early Adopter website.

 

We will continue looking closely at your comments in this GeoNet Group and our Early Adopter Community Website.

 

Keep your feedback coming!

The Survey123 field app is used to capture data using smart forms created with Survey123 for ArcGIS. This blog post highlights 10 facts about the Survey123 field app that you may not know about.

 

1) Platforms supported: While most commonly used in mobile devices running iOS and Android, the Survey123 field app is also available on Windows 7,8.1,10 as well as Mac OS X and Ubunutu Linux.  This allows you to capture data  from laptops, toughbooks, surface tablets, tablets, smartphones and desktops too!

 

The Survey123 for ArcGIS download page lists all flavors of the app available.

 

2) Offline by default: The Survey123 field app is designed to work offline by default. Once surveys are downloaded, captured data (including locations) will be saved in the device so it can be later synchronized. In the event that you want to include a map in your survey, you will need to prepare it for offline use.

 

 

3) Public surveys: Private surveys can be accessed securely, but Survey123 also supports public surveys where no ArcGIS account is required to capture data (even if offline).

 

 

 

You can change the size of text and controls in the Survey123 app

4) Scale factor: You can control the size of text and controls in your forms through the app settings. This is particularly useful when using a tablet. This makes the buttons bigger for folks with fat fingers!

 

 

5) Tap and Hold: Here are my favorite tap and hold functions in the Survey123 field app:

 

  • A tap and hold over the location button in the map widget will trigger GPS averaging.
  • Tap and hold the arrows in the calendar widget to quickly set the year or month.
  • Accelerate data entry by tapping and holding the plus and minus buttons in the spinner widget.
  • Tap and hold a survey in the gallery and it will be open directly in Collect mode.

 

 

 

 

 

 

6) Integration with Workforce, Explorer and Collector for ArcGIS: You may already know that Workforce for ArcGIS features built-in integration with Survey123 (A detailed post by the way on this topic is long overdue, so I will try to get it out shortly) . What you may now know is that Survey123 can also be launched right from the popup of a feature in Collector and Explorer for ArcGIS. This can be useful when you want to open a smart form for a feature in a Web Map and pre-populate anwers in the form using attributes from that feature.  This is possible by invoking Survey123 through its Customer URL Scheme.

 

 

7) It’s all about Feature Services: All data captured through the Survey123 field app gets stored in ArcGIS Feature Services. This means that not only can you build Story Maps, Operation Dashboards and Web AppBuilder apps on top of Survey123 data, but it also means that you can use Survey123 on top of existing Feature Services you may have!  

 

You can build Surveys from existing Hosted and Federated Feature Services using the 'Create from Feature Service' option in Survey123 Connect for ArcGIS.

 

You can create surveys on top of existing feature services

 

8) Source Code available: The source code of the Survey123 field app is licensed under Apache 2.0 and available with AppStudio for ArcGIS Standard Edition. There are many reasons why you may want to take advantage of this:

 

  • You can create your own version of Survey123, keeping the same functionality but using your own branding.
  • You can extend the app with new functionality.
  • You can compile the app with your own developer certificate and deploy it using your own Mobile Device Management system.

 

9) Barcode scanning & Signatures: The Survey123 field app can scan barcodes and qrcodes using your device's built-in camera. Through a specific widget, you can also use your device's screen as a signature pad.

 

 

10) Rename photos: You can capture  one or more photos as part of your survey. Additionally, the Survey123 field app allows field users to rename and rotate photos before  submitting.