topic Re: Custom URL scheme from Workforce? in ArcGIS Workforce Questions

Custom URL scheme from Workforce?

Anonymous User — Tue, 27 Feb 2018 14:22:25 GMT

I know you can call Survey123 from Collector or Navigator. Is it possible to launch a specific form from Workforce and pass information like the asset ID or any other relevant info I would want to carry over to Survey123? Say I want our mobile workers to receive assignations in Workforce (on their worker maps) and launch a specific form in Survey123 when they select a layer from the map inside Workforce. I know this method works quite well in Collector, but what about in Workforce? BTW - Many thanks to Ismael Chivite and James Tedrick for their fantastic contents on GeoNet

Re: Custom URL scheme from Workforce?

Jon_AndersKrokann_TEN — Tue, 27 Feb 2018 15:45:26 GMT

Hi Jimmy,

What I do is to launch the settings for the project, advance and app-integration. There I can set up the survey I want the workforce to work up with, and you can transfer relevant information.

Is this what you are looking for?

Re: Custom URL scheme from Workforce?

Anonymous User — Tue, 27 Feb 2018 16:09:57 GMT

Hi Jon,

In fact, I just want to know if we can pass field parameters via the URL scheme under Workforce to Survey123. It's a way to shorten a specific workflow, not being force to use Collector to execute this, so by example, a survey will be related to a parent feature class directly from Workforce (specifically the worker map in our case). Thanks.

Updates: After having done some tests, it doesn't work. Workforce cannot pass field parameters to Survey123 via a custom url shceme. Can someone prove me wrong?

Re: Custom URL scheme from Workforce?

CraigGillgrass — Tue, 27 Feb 2018 21:00:44 GMT

Jimmy,

Workforce supports launching Survey123 at the Project or Assignment Type level; the doc taking you through these steps is available here:

FAQs for project owners—Workforce for ArcGIS | ArcGIS

Tips for project owners—Workforce for ArcGIS | ArcGIS

This allows information to be passed from a Workforce Assignment to Survey123.

However, it sounds like you would like link Survey123 to a specific feature in a feature layer in the Worker web map and pass information from that feature to the Survey.

You mention in your first post the need to pass AssetID, are there other fields that you'd like to pass?

Craig

Re: Custom URL scheme from Workforce?

Anonymous User — Wed, 28 Feb 2018 04:42:27 GMT

Hi Craig,

What I would like to do in fact is to call a specific form in Survey123 from the Workforce worker map; so when the workers start their assignment by selecting what they have on the map, a pop-up windows would appear (with the Custom URL parameters embedded passing values to Survey123 -- ideally in a related table representing the inspections linked to an assets layers). Collector do this in a wonderful way...so I was hoping to have the same functionality within a web map in Workforce. Here is what it would look like:

I hope to have stated my problem more clearly. I know the Esri mobile apps allow some very tailored workflows and the one I'm looking for is solely about Workforce--Survey123. Please, don't hesitate if you need more details.

Thanks,

Jimmy

Re: Custom URL scheme from Workforce?

erica_poisson — Thu, 21 Jun 2018 12:48:14 GMT

Craig Gillgrass‌ Jimmy Bernatchez‌ has there been any update on this? I also have a use case where I'd love to have this functionality available. It would be really great for streamlining my workflow and utilizing already capture information.

Thanks,
Erica

Re: Custom URL scheme from Workforce?

khalilramadeen — Sun, 15 Jul 2018 08:17:24 GMT

Also I have the same issue, I want to pass specific attributes from assets into Survey123 form, it should be doable due to worker map can configure popups. The benefits will expand if we can populate assets details from Workforce directly.

Re: Custom URL scheme from Workforce?

Anonymous User — Mon, 16 Jul 2018 13:20:00 GMT

One thing you can do right now, is add additional fields to your assignments layer. For example, you could add a field named "assetName". If you are creating your assignments automatically using scripts or whatever, then you would be able to populate this field (it currently won't show up in the Workforce Dispatcher Web Application). Then you can add a custom integration to survey123 which can be opened directly from the Workforce Mobile App. In the next release of the Python API (1.5), we have added an integration manager to the Workforce Module, this makes it easier to add custom integrations.

In the following example, I've added a new field titled "assetName" and then added an integration that passes this field directly to survey123 field named "field_0". The integration looks like:

{'id': 'survey123-custom',  'prompt': 'Open in Survey123',  'urlTemplate': 'arcgis-survey123://?itemID=a7d9a4895dc744feae0269d2cd43773a&field:field_0=${assignment.assetName}'}

Example code, using the new integration manager is available here: workforce-scripts/UC 2018 - 1 - Configuring A Project.ipynb at master · Esri/workforce-scripts · GitHub

You can also add custom integrations (beyond what you can do in the Web App) by editing the project json manually in AGO Assistant.

Re: Custom URL scheme from Workforce?

BobZappitelli — Mon, 28 Oct 2019 20:12:11 GMT

Aaron Pulver‌

Aaron, I'm using your workforce automation scripts to populate a project.

I'd like to add a custom field, in this case, 'hours', to assist with scheduling.

I've tried modifying the script to allow this (I've already added the field qtyhours to the layer), but am having little success.

I should add I'm not a coding expert but have some understanding.

# Set the hours
if args.qtyhours_field and assignment[args.qtyhours_field]:
assignment_to_add.qythours = assignment[args.qythours_field]

parser.add_argument('-qtyhours-field', dest='qtyhours_field', help="The field that contains the Hours")

The code executes, but does not collect the quantity of hours from the csv file.

Re: Custom URL scheme from Workforce?

Anonymous User — Tue, 29 Oct 2019 11:56:36 GMT

assignment_to_add.qythours = assignment[args.qythours_field]

I think this is the line that won't work. The "assignment_to_add" object is an Assignment and it only has specifically defined properties

If you want to do this, I think you'll have to go to the feature level like:

assignment_to_add.feature.attributes["qythours"] = assignment[args.qythours_field]

I haven't tried it, but I'm pretty sure it will work.

Re: Custom URL scheme from Workforce?

BobZappitelli — Tue, 29 Oct 2019 13:04:14 GMT

Flawless.

Thanks Aaron!

Re: Custom URL scheme from Workforce?

PaulSweeney3 — Wed, 20 May 2020 19:32:53 GMT

Hi Aaron

I am considering this as a solution to pass fields from workforce to survey123. I am just wondering if there was any pitfalls or risks associated with using it that you are aware of , as it is not fully supported via the workforce website.

Re: Custom URL scheme from Workforce?

JeffShaner — Fri, 29 May 2020 05:52:46 GMT

Hi Paul,

The app integrations are quite resilient. I would recommend testing the scheme for launching Survey123 using Collector or Explorer first. Just add the assignments layer into a web map and configure the popup to launch Survey as you like. When working as you expect, then use the Python API to add the integration. If you do encounter problems, you can alway use the ArcGIS Online assistant and remove the integration from the project item.

Jeff

Re: Custom URL scheme from Workforce?

PaulSweeney3 — Fri, 29 May 2020 20:39:15 GMT

Thanks Jeff i think i will try it on a current project we have in operation, we currently use the workforce module to automate the creation of assignments and i was looking for away to improve the content of the survey123 form so it was great to stumble across this info. Thanks for your reply.

Re: Custom URL scheme from Workforce?

bgomes — Thu, 19 Aug 2021 13:43:11 GMT

Hi Jeff,

Have some change in the structure of workforce?
Before we have the abitity to change scheme url of Survey 123 from Ago Assistant, but now the structure is quite different. I' cant see this option anymore.
have some way to choose our own fields to integrate in Survey 123?

Thanks

Re: Custom URL scheme from Workforce?

Anonymous User — Thu, 19 Aug 2021 14:23:12 GMT

In the offline Workforce Projects, the integrations are stored in a table within the feature service that is created. You can directly add new rows to add new integrations. More info can be found in this doc topic..

Re: Custom URL scheme from Workforce?

BobZappitelli — Mon, 22 Nov 2021 21:06:41 GMT

Hi Aaron,

assignment_to_add.feature.attributes["qythours"] = assignment[args.qythours_field]

Is this still valid for a version 2 project?

Thanks.

Re: Custom URL scheme from Workforce?

Anonymous User — Mon, 22 Nov 2021 23:57:56 GMT

This should work for both classic and offline enabled projects.