ArcGIS Field Maps Blog

cancel
Showing results for 
Show  only  | Search instead for 
Did you mean: 

Other Boards in This Place

Latest Activity

(40 Posts)
JeffShaner
Esri Regular Contributor

The November release is our last major update to ArcGIS Field Maps in 2022 and includes many exciting new capabilities. Read all about our updates and grab the latest release from the stores!

Read more...

more
2 1 225
JeffShaner
Esri Regular Contributor

We've gone live with the October, beta 3, update for the November release of ArcGIS Field Maps!

This update includes support for opening Online maps that contain offline map areas - one of several QoL improvements coming in the November 2022 release

Minor update to the fall blog with a link to join the beta program if you haven't already!

ArcGIS Field Maps Early Access update (Fall 2022)

more
2 0 183
JeffShaner
Esri Regular Contributor

We've gone live with the September, beta 2 update for the November release of ArcGIS Field Maps.

Read more...

more
0 0 162
GlenShepherd
Esri Contributor

The Premise

Here's the hypothetical scenario:

  1. You've got an asset feature layer with a related table in your ArcGIS web portal of choice (ArcGIS Online or ArcGIS Enterprise portal) and you've added it to a web map for intended use in ArcGIS Field Maps mobile. 
  2. You've published a Survey123 survey from the feature layer's related table for completing repeat inspections of those assets.
  3. You want mobile workers to query the asset feature, launch a particular survey in Survey123, and automatically return them to the ArcGIS Field Maps mobile app after submission...

But after searching through documentation and community posts, configuring the syntax for this URL seems clear as mud...

So how do we piece together our URL and configure it?

wLink.gif

 

 

The Workflow

First of all, we need to write the first part of our URL that will call the alternative app; in this case Survey123. There are two options you can use:

  1. arcgis-survey123://?portalUrl=https://www.arcgis.com&
  2. https://survey123.arcgis.app?

In option 1, you can specify the portal URL that you want Survey123 to authenticate through, whether that be ArcGIS Online or ArcGIS Enterprise.  In option 2, we are simply calling the Survey123 app with either the default, or the most recent active web portal that was logged into on that mobile device. Users may be prompted to log in, if they have not done so already.

Note: '?' indicates we're going to add a query.  '&' indicates we're going to add parameters.

 

Next, we need to specify our survey's itemID. This is an alphanumeric string that identifies the specific Survey123 form item that we want to access. It can be found by logging into the Survey123 web designer accessing your survey and copying the string from the browser URL. Alternatively, we can log into our web portal > navigate to 'Content' > the survey's folder > access the 'Item Details' page for the 'Form' item > copy the Item ID from the browser URL.

It should look something like this:

  • itemID=5550529ee2314fe5b721904854b49456

 

Next, we might add field matching parameters if we wish to pass an attribute from the feature we're querying to the Survey123 form. We use the syntax, field:<destinationFieldName>={<originFieldName>}.

As an example, I might wish to pass the GlobalID value from my feature layer to the GUID field in my Survey123 form (related table). So I would add the following to my URL:

  • &field:GUID={GlobalID}

You can pass multiple attribute values at once using the syntax above and separating each with an '&' symbol. The field names MUST match those within your respective attribute tables.

 

Lastly, we want to add the callback and accompanying parameters. This can often be the trickiest part to get working successfully. 

The following will call the ArcGIS Field Maps mobile app to re-launch:

 

Now... Let's add it all together:

 

BUT WAIT!!!

You need to encode the callback section of your URL in order for it to actually work... We can use websites like https://www.urlencoder.org/ in order to do this. But essentially, we need to encode everything after the 'callback=' part of our URL, so that it looks a little something like this instead:

 

Now you can open Map Viewer, add your configured callback URL to your feature layer's pop-up and enable your mobile workers to smoothly switch between their Map-Centric workflows in ArcGIS Field Maps and the advanced Form-Centric capabilities of Survey123.

 

ezgif.com-gif-maker (1).gif

 

Furthermore, if we want to pass an action to the ArcGIS Field Maps mobile app, we can use the 'referenceContext' parameter, added to our callback. The following is simply telling ArcGIS Field Maps which web map to open according to the web map's Item ID:

  • ?referenceContext=open&itemID=b7a7a2af1bbc457eaefe5018ef912egd
  • Encoded: %2F%3FreferenceContext%3Dopen%26itemID%3Db7a7a2af1bbc457eaefe5018ef912egd

Note: Other examples of 'referenceContext' actions can be found here - https://doc.arcgis.com/en/field-maps/android/help/deploy-your-map.htm

more
11 2 638
LizArmstrong
Esri Contributor

Check out the recently updated Field Maps Resources lists!

Read more...

more
1 1 270
SarahSaint-Ruth
Esri Contributor

November 1st, 2022, ArcGIS Collector, ArcGIS Explorer, and ArcGIS Tracker will be removed from Google Play and the Apple App Store.

 

 

Read more...

more
0 2 221
JeffShaner
Esri Regular Contributor

We've just released the 22.3.1 update to Field Maps on iOS and Android platforms. This is a maintenance-only release. Please grab the update today!

Read more...

more
1 1 548
JeffShaner
Esri Regular Contributor

We're excited to announce the June release of ArcGIS Field Maps! This is a big update leading into the summer with exciting new features! Read to learn more!

Read more...

more
0 8 612
LizArmstrong
Esri Contributor

With the June release of ArcGIS Online and the July release of ArcGIS Enterprise, we will introduce a few licensing changes for our field apps.

Read more...

more
0 0 212
206 Subscribers