ArcGIS Workforce

Create assignments in the field with Survey123

ArcGIS Workforce is designed for dispatchers to create and assign work for mobile workers to complete in the field. Assignments are created in the Workforce web app, but you might also want mobile workers to create assignments from the field. By bringing ArcGIS Survey123 to your workflow, mobile workers will be able to create assignments in the field that will then appear in Workforce.   

To get started, identify a Workforce project that requires mobile workers to have the ability to create assignments from the field. You’ll create a view of the assignments layer for the mobile workers, use the view layer to create a survey in Survey123 Connect, publish the survey, and then create assignments using Survey123. 

Note: If your mobile workers are more familiar with using ArcGIS Collector for data collection, see Create assignments in the field with Collector 

Create a view of the assignments layer 

Creating a hosted feature layer view from the assignments layer limits the fields and types of data the mobile worker sees. This ensures they only edit the Workforce data you want them to. To learn more about the fields within the Workforce feature service, see the Workforce schema overview.

Browse to the item page of the assignments layer and click Create View LayerFor more information, see Create hosted feature layer views in ArcGIS Online or Create hosted feature layer views in ArcGIS Enterprise 

Set the view definition 

In your view, browse to the Visualization tab. Click More Options , and click Set View Definition. The Define Features and Define Fields options appear. These allow you to limit the data available to mobile workers.   

Click Define Features to only include assignments with a status of Unassigned. 

Define Features window

Click Define Field to only include the following fields: OBJECTID, Description, Status, Priority, Assignment Type, Work Order ID, Due DateGlobalID, Location, Creation Date, Creator, Edit Date, and Editor. 

Define Fields window.

Note: Your mobile workers might not need all the fields. You can choose to exclude Description, Priority, Work Order ID, and Due Date. 

Create a survey 

Open the Survey123 Connect desktop app to create your survey (the Survey123 web designer doesn’t support creating a survey from an existing hosted feature layer). Click New survey to get started. Give the survey a name and choose the Feature service option. Select the hosted feature layer view you created based on your assignments layer, and click Create survey 

New Survey window

A survey is created using the fields in the view layer, and the spreadsheet that defines the survey opens. On the survey tab of the spreadsheetyou’ll find the fields imported from the view layer.  

The assignmenttype field is not automatically added to the survey because it has a GUID field type. You’ll manually add this field so mobile workers can include the assignment type when filling in their survey. In an empty row on the survey tab, fill in the following columns: 

Survey values for assignment type field

On the choices tab, you’ll add each assignment type so they appear as choices in your survey. Add an entry for each assignment type you want your mobile workers to have access to.  

Choice values for assignment types

Now that you have the assignment type question set up, you’ll make a few more edits on the survey tab 

An assignment status must be included, but you don’t want your mobile workers to change it from unassignedFor Status, mark the required column as yesset the field’s type to hidden, and give it a default value of 0 (unassigned).  

Survey values for status field

For Priority, set the appearance column to likert so the choices display as a scale in the survey.  

Survey values for priority field

Reorder the fields in the spreadsheet so required and more commonly populated fields display first in the survey 

Question order

Save your spreadsheet changes, and the preview of the survey in the Survey123 Connect window updates to show your changes.

Preview of the survey

Publish and share your survey 

In the Survey123 Connect window, click Publish 

Publish survey button

You are reminded that you used an existing feature service, so a new feature service won’t be created. Click Publish. Your survey is published to your ArcGIS organization in a folder of My Content that is named with “Survey-” followed by your survey name. 

Browse to the Survey123 website and open the survey. Click the Collaborate tab to share the survey with mobile workers. If you want all mobile workers in your Workforce project to be able to create assignments in Survey123, share the survey with the group created with your Workforce project. For more information, see Share survey. 

If instead you want to provide only a subset of mobile workers with access to create assignments in Survey123, create a new group for those members. Share the survey you created for Survey123 with the new group. For more information, see Create groups in ArcGIS Online or Create groups in ArcGIS Enterprise. 

Create assignments in Survey123 

Mobile workers can now download the survey in the Survey123 field app and create assignments. You can test your survey by submitting a form and then checking that a new assignment appears in the Workforce web app.  

Create an assignment in Survey123

Now your mobile workers can contribute assignments to Workforce using Survey123. Work they notice in the field is recorded and ready for assignment in the Workforce web app.

About the author

Josh is a Product Engineering Writer with a background in geography and comparative literature. When he isn't writing for the field apps team, he enjoys reading short stories, trying new recipes, and playing his bass clarinet.

Notify of
1 Comment
Inline Feedbacks
View all comments

Next Article

Apps for Field Operations at the 2024 Esri User Conference

Read this article