Passing Workforce Assignment GlobalID from Collector to Survey123

Question

What would the URL look like, to allow me to launch Survey123, from Collector, populated with data from an existing Workforce Assignment, to allow editing of the assignment?

I've created a Collector map, with Workforce Assignments symbolozed, so crews working in an area can see work assignments that may exist, but are either unassigned, assigned to someone else (who hasn't worked it yet).  If the crew does the work while they're in the area, I'd like for them to be able to edit the work assignment (assign it to them, change status to complete, etc.).

I've gotten as far as creating the URL to launch Survey123 from Collector; however, I can't seem to be able to get Survey123 to populate with the Workforce Assignment's data.

The URL I'm using is: arcgis-survey123://?itemID=[Survey123 Item ID]&field:GlobalID={GlobalID}

I've tried several combinations of globalId, Globalid, globalid, etc.  I saw where one post mentioned Workforce used a ${assignment.GlobalID} format, but that didn't work either.

Any help would be appreciated!

BillSimper · Answer

Hi Dominic,

Couple things to try-- dont use curly brackets around GlobalID (if you are) and probably a good idea to use UrlEncode (using Arcade) on your globalid variable like "UrlEncode($feature.globalid)"

DominicRobergeIADOT · Answer

Hi @BillSimper ,

I know it's been a while since you posted this , but I am trying to do the same process. Obviously I am missing something.....

My goal is, from Field Maps to click on a point (that was created using Survey 123) and open Survey 123 app with the information related to that point.

My survey has inbox enabled and the link I am using is this:

arcgis-survey123://?itemID=MYITEMID&action=edit&update=true&field:globalid={GlobalID}

Survey123 open directly to the inbox where all my inspections are listed.... What am I missing to get the specific inspection to load?

I got it got it work from the Survey web .... now if I could get to work on Survey app ....

Any help would be much apprecited.

Thanks!

BillSimper · Answer

It looks like it is possible to open a specific existing record into a Survey123 form in the field app. There's hardly any ESRI documentation for this feature (it'd be nice to see some and for this to be fully explained in a blog post).

Here is what worked for me:

arcgis-survey123://?itemID=itemIDofyourSurvey123FormHere&action=edit&q:globalid=globalidofyourSurvey123recordhere&update=true

The globalid of your record should be the 32 character alphanumeric with dashes.

Here are some caveats:

1) spell globalid as 'globalid', not GlobalID or globalId (unlike the ESRI example linked to below)

2) this feature uses the Inbox, so that has to be turned on in your S123 form

3) it's a good idea to turn off the Sent box in your form as this will interact with the Inbox and probably result in problems when trying to get this feature to work

4) I think you need that last part &update=true in order to refresh the Inbox. I'm not sure if you need &action=edit for this to work but you probably want this for your purpose

I got this to work through lots of trial and error and by referring to this web page: https://doc.arcgis.com/en/survey123/reference/integratewithotherapps.htm

There are other permutations that work, like:

arcgis-survey123://?itemID=itemIDofyourSurvey123FormHere&action=edit&q:where=globalid='globalidofyourSurvey123recordhere'&update=true

The form above (using single quotes) works for text fields generally (just avoid space characters or maybe URL encode the spaces). You can also query integer fields, including objectid, for example:

arcgis-survey123://?itemID=itemIDofyourSurvey123FormHere&action=edit&q:where=objectid=integerObjectIDofyourrecordhere&update=true

or

arcgis-survey123://?itemID=itemIDofyourSurvey123FormHere&action=edit&q:objectid=integerObjectIDofyourrecordhere&update=true

For objectid, be sure to spell it 'objectid' and not objectId or objectIds (as in the ESRI example). Apparently this field can be named differently from feature layer to feature layer so you may want to check to see how your field is spelled.

This blog post outlines how to do the same thing using the web browser version of Survey123 (instead of the Field App): https://community.esri.com/t5/arcgis-survey123-blog/survey123-tricks-of-the-trade-editing-records-in-a/ba-p/895827