topic Re: Workforce integration with Field Maps in ArcGIS Workforce Questions

Workforce integration with Field Maps

BillLotz — Thu, 28 Jan 2021 20:28:45 GMT

Hello,

I have upgraded to 10.8.1, installed the Workforce general patch and Field Maps 20.4.0. When creating a new Workforce project, under the advanced tab, Field Maps do not show up in the App Integration Window. It shows Collector, Explorer, Navigator, survey123, but no Field Maps.

I've restarted computers and servers and logged out and back in, but no change. Field Maps functions correctly, I've mad a couple of maps. It seems confusing, when I launch the the Resources tab in Workforce project manager page it takes me to help that seems to be for the previous version, it talks about expanding the App Integration, but that was in the last version. Any Ideas?

Re: Workforce integration with Field Maps

CraigGillgrass — Fri, 29 Jan 2021 14:26:50 GMT

Bill,

Support for Field Maps integration is not in the 10.8.1 setups for Workforce. You can setup this up by running one of our Python scripts to add the app integration to Field Maps. We're also considering at a general patch to add this capability to Workforce but the earliest we would do that would be after the Spring release of Online in late March. However, the ability to integrate Field Maps with Workforce is in the Enterprise 10.9 release. So we are encouraging sites who need that capability and do not want to use the Python route to upgrade.

Craig

Re: Workforce integration with Field Maps

BillLotz — Fri, 29 Jan 2021 13:21:14 GMT

Thanks Craig, if I can be a bit of a critic, the documentation can be very confusing as to what version of Workforce it applies to and if it's AOL or enterprise. The same applies to ESRI videos and blog posts. With the Desktop help it tells you what version and platform with the dropdown to change. The videos and blog posts do have dates and you can infer what release from that, but a bit more specifics would help ease my, and I am hoping others, confusion.

That being said the apps are great and I appreciate them. Is the script on GitHub?

Thanks,

Bill

Re: Workforce integration with Field Maps

CraigGillgrass — Sat, 30 Jan 2021 16:07:52 GMT

Hi Bill,

You mention the Resources tab and the doc topic it links to in your original post, is that the part of the doc you find confusing? Can you point us to any other areas that lead to believe this was supported in 10.8.1? We want the doc to be clear and concise on these topics should would like to get your feedback on how to improve it.

Yes, the scripts are part of the ArcGIS API for Python and its Workforce module.

Here's the doc topic on it:
https://doc.arcgis.com/en/workforce/android-phone/help/workforce-schema.htm

Craig

Re: Workforce integration with Field Maps

BillLotz — Mon, 01 Feb 2021 13:34:38 GMT

Hello Craig,

I think the reason (at least one of them) I got confused is that when I had problems I did a google search for "arcgis workforce documentation" and ended up at: https://doc.arcgis.com/en/workforce/faqs/faqs-general.htm and found "What apps can I integrate with Workforce, and what do those integrations provide? Workforce supports integration with ArcGIS Field Maps, ArcGIS Collector, ArcGIS Explorer, ArcGIS Navigator, and ArcGIS Survey123" Above there it says that to use Workforce with 10.8.1 you must install the Portal patch, so I assumed Field maps would be available.

What I was getting at is in the Desktop help, it specifically states the version and platform that the help applies to. I am not sure what version the FAQ that I referenced applies to, it might be there somewhere, but at first glance I don't see it.

With desktop it is right there at the top of the documentation: https://desktop.arcgis.com/en/arcmap/latest/get-started/main/get-started-with-arcmap.htm

Thanks,

Bill

Re: Workforce integration with Field Maps

CraigGillgrass — Tue, 02 Feb 2021 15:41:47 GMT

Hi Bill, we'll be updating the doc to point out that Workforce does support integration with Field Maps at 10.8.1

Craig

Re: Workforce integration with Field Maps

Anonymous User — Thu, 18 Mar 2021 12:13:28 GMT

Hi Craig,

I have the same problem with the integration of Field Maps in Workforce (I'm using ArcGIS Enterprise 10.8.1). I already installed the General Patch and Field Maps 20.4, but the Field Maps extension does not appear yet. I read about your Python script to add integration to Field Maps. Unfortunatelly, by browsing the link that you attached (https://developers.arcgis.com/python/api-reference/arcgis.apps.workforce.html) I did not find any script to add the Field Maps extension.

Where can I find the Python script to add Field Maps as extension of my Workforce project in ArcGIS Enterprise 10.8.1?

Thanks in advance,

Antonio

Re: Workforce integration with Field Maps

CraigGillgrass — Thu, 18 Mar 2021 12:30:00 GMT

Hello,

Please see this topic in the Python API:
https://developers.arcgis.com/python/api-reference/arcgis.apps.workforce.html#integration

Craig

Re: Workforce integration with Field Maps

Anonymous User — Thu, 18 Mar 2021 13:41:01 GMT

Thank you Craig,

I was able to add Field Maps to my Workforce project. Now I'll have to continue to configure my project using API. Do you have any example that explain how to continue the configuration?

Thanks again,

Antonio

Re: Workforce integration with Field Maps

CraigGillgrass — Thu, 18 Mar 2021 13:49:01 GMT

Sure, here's an example that integrates at the project level to a web map and passes the WorkOrderID to a field called FACILITYID in the target layer in the map:

https://fieldmaps.arcgis.app?itemID=<itemid>&referenceContext=addFeature&geometry=${assignment.latitude},${assignment.longitude}&featureSourceURL=https://services.arcgis.com/<orgid>/arcgis/rest/services/Backflow_Inspection_Holistic/FeatureServer/0&featureAttributes=%7B%22FACILITYID%22:%22${assignment.workorderid}%22%7D

Re: Workforce integration with Field Maps

MollyWatson1 — Mon, 29 Mar 2021 19:53:56 GMT

Hi Craig,

Does the Python script you reference above to integrate the new Workforce with Field Maps have to be run just one time to set things up? Or does it have to be run continually every time there is a new assignment generated?

Thanks,

Molly

Re: Workforce integration with Field Maps

CraigGillgrass — Mon, 29 Mar 2021 22:42:52 GMT

Hi Molly,

No, you just need to run the script once and set it for the Workforce project. If anyone has the project open in mobile they will need re-open the project for the changes to take effect.

Craig

Re: Workforce integration with Field Maps

HrEngen — Thu, 06 May 2021 11:21:00 GMT

Hi Craig.

Is there an update on the integration between Workforce and Field Maps general patch?

Thanks in advance

Søren

Re: Workforce integration with Field Maps

CraigGillgrass — Thu, 06 May 2021 12:54:18 GMT

Hello, I don't have any updates on the patch. It's still a consideration but other priorities are precede it. For now, our recommendation is to use the Python API workflow to enable the Workforce to Field Maps integration.

Craig

Re: Workforce integration with Field Maps

HrEngen — Thu, 06 May 2021 13:02:18 GMT

Can I use the Phyton API from Arcgis Pro or do it have to be Developer?

Re: Workforce integration with Field Maps

CraigGillgrass — Thu, 06 May 2021 13:07:11 GMT

Hello, you do not have to be a developer. I'd suggest starting with this topic in our online help:
https://doc.arcgis.com/en/workforce/android-phone/help/workforce-schema.htm

However, if you're not comfortable with using the Python API, since we've moved the Integrations into a table you can edit the table directly . I believe I replied to a previous comment on this thread with an example of how the app integration could look for Field Maps.

Craig

Re: Workforce integration with Field Maps

HrEngen — Thu, 06 May 2021 15:30:41 GMT

Hello.
I was hoping that the integration was more integreted ind workforce.

My thoughts was that when the worker starts an assignment it sutomatic goes to the survey app og any other app with integration.

Mayby workforce isn´t the right app for the project i´m working on.

Re: Workforce integration with Field Maps

CraigGillgrass — Thu, 06 May 2021 16:10:49 GMT

Hello,

This ability is in the backlog to consider, however, there are a few reasons we do not support this

Since not all use cases involve automatically launching the target app - the Worker needs to add notes or photos before going to the other app
The worker can start the assignment from the To Do list
The assignment has multiple integrations

This was a purposeful decision to not launch the other app right away on Start but it is in our backlog to consider.

Craig

Re: Workforce integration with Field Maps

HrEngen — Thu, 06 May 2021 18:22:39 GMT

Hello Craig.

Thanks for the fast reply.

I understand your reasons.

If you consider it again, mayby the integration to a target app could be if it fits with the task.

Tasktype one does require the target app - maybe Survey123 - automatically launches the app

Tasktype two dosent require the target app - does nothing - the original start button.

Task three requres the target app - maybe Field maps - automatically launches the app

Some of the app have the foto and notes possibility.

For this project i´m going to make it work in other ArcGIS products.

Søren

Re: Workforce integration with Field Maps

CraigGillgrass — Fri, 07 May 2021 13:33:11 GMT

Hello Søren,

It's something we can consider - we'll have to balance it with how this kind of integration works when there are other integrations configured for the assignment type; e.g. a Routing or Navigator integration. The other consideration is we also get requests to support multiple of the same app integration for each type - so, for a type of work assignment, allow 2 Survey integrations.

Not impossible to support but just adds more options to consider.

Craig