arcgis.apps.workforce module

Defines public exports for the workforce module.

The Project is the main entry point into the Workforce module. It can be used as shown in the following code example.

# Get a Project and search the assignments and workers, create new Workforce project

import arcgis
gis = arcgis.gis.GIS("https://arcgis.com", "<username>", "<password>")
item = gis.content.get("<item-id>")
project = arcgis.apps.workforce.Project(item)
assignments = project.assignments.search()
workers = project.workers.search()
project2 = arcgis.apps.workforce.create_project('new_project', summary='This project was created by Python')

create_project

arcgis.apps.workforce.create_project(title, summary=None, major_version=None, gis=None)

Creates a new Workforce Project

Parameter	Description
title	`String`. The title of the Project to create (must be unique to the organization)
summary	`String`. The summary of the Project
major_version	Optional `Int` The version of the Project to create. 1 represents the original Workforce Project which does not support offline. 2 represents the newer Workforce Project which supports offline among other things. Defaults to 2 in GIS 8.2 and higher
gis	Optional `GIS`. The authenticated GIS to use. Defaults to the active GIS if None is provided.

Returns a Project

Assignment

class arcgis.apps.workforce.Assignment(project, feature=None, geometry=None, assignment_type=None, assigned_date=None, assignment_read=None, completed_date=None, declined_comment=None, declined_date=None, description=None, dispatcher=None, due_date=None, in_progress_date=None, location=None, notes=None, paused_date=None, priority='none', status=None, work_order_id=None, worker=None)

Represents an assignment

Parameter	Description
project	Required `Project`. The project that this assignment belongs to.
feature	Optional `Feature`. A feature containing the assignments attributes. Mostly intended for internal usage. If supplied, other parameters are ignored.
geometry	Optional `Dict`. A dictionary containing the assignment geometry
assignment_type	Optional `AssignmentType`. The assignment type that represents this assignment.
assigned_date	Optional `Date` The date and time the assignment was assigned
assignment_read	Optional `Bool`. A flag indicating that the mobile worker has seen the assignment. Version 1 Projects Only
completed_date	Optional `Date`. The date the assignment was completed
declined_comment	Optional `String`. The comment submitted by the mobile worker.
declined_date	Optional `Date`. The date the assignment was declined.
description	Optional `Description`. The description associated with the assignment.
dispatcher	Optional `Dispatcher`. The dispatcher that assigned/created the assignment.
due_date	Optional `Date`. The date the assignment is due.
in_progress_date	Optional `Date`. The date the assignment was started.
location	Optional `String`. The location or address of the assignment.
notes	Optional `String`. The notes associated with the assignment.
paused_date	Optional `Date`. The date and time the assignment was paused.
priority	Optional `String`. The priority of the assignment none, low, medium, high, critical
status	Optional `String`. The status of the assignment. unassigned, assigned, in_progress, completed, declined, paused, canceled
work_order_id	Optional `String`. The work order id associated with the assignment.
worker	Optional `Worker`. The worker assigned to the assignment

# Get an assignment and update it

import arcgis
gis = arcgis.gis.GIS("https://arcgis.com", "<username>", "<password>")
item = gis.content.get("<item-id>")
project = arcgis.apps.workforce.Project(item)
assignment = project.assignments.search()[0]
assignment.update(priority="high",description="new assignment",location="100 Commercial Street, Portland, ME")
assignment.delete()

property assigned_date: Gets/Sets the assigned datetime of the assignment

property assignment_read: Gets/Sets the assignment read field

property assignment_type: Gets/Sets the AssignmentType

property assignment_type_code

property attachments: Gets the AssignmentAttachmentManager of the assignment

property completed_date: Gets/Sets the completed datetime of the assignment

property creation_date: The datetime at which the Feature was created.

property creator: The named user that created the Feature.

property declined_comment: Gets/Sets the declined comment of the assignment

property declined_date: Gets/Sets the declined datetime of the assignment

delete(): Deletes the assignment from the server

property description: Gets/Sets the description for the assignment

property dispatcher: Gets/Sets the Dispatcher of the assignment

property dispatcher_id: Gets the dispatcher id of the assignment

property due_date: Gets/Sets the due datetime of the assignment

property edit_date: The datetime at which the Feature was last edited.

property editor: The named user that last edited the Feature.

property feature: The Feature

property geometry: Gets/Sets the geometry for the Feature.

property global_id: The global id of the feature

property id: The object (version 1) or global id (version 2) of the feature

property in_progress_date: Gets/Sets the in progress datetime for the assignment

property location: Gets/Sets the location of the assignment

property notes: Gets/Sets the notes of the assignment

property object_id: The object id of the feature

property paused_date: Gets/Sets the paused datetime for the assignment

property priority

Gets/Sets the String priority of the assignment

none, low, medium, high, critical

property status: Gets/Sets the String status of the assignment

unassigned, assigned, in_progress, completed, declined, paused, canceled

update(geometry=None, assignment_type=None, assigned_date=None, assignment_read=None, completed_date=None, declined_comment=None, declined_date=None, description=None, dispatcher=None, due_date=None, in_progress_date=None, location=None, notes=None, paused_date=None, priority=None, status=None, work_order_id=None, worker=None)

Updates the assignment on the server

Parameter	Description
geometry	Optional `Dict`. A dictionary containing the assignment geometry
assignment_type	Optional `AssignmentType`. The assignment type that represents this assignment.
assigned_date	Optional `Date` The date and time the assignment was assigned
assignment_read	Optional `Bool`. A flag indicating that the mobile worker has seen the assignment. Version 1 Projects Only
completed_date	Optional `Date`. The date the assignment was completed
declined_comment	Optional `String`. The comment submitted by the mobile worker.
declined_date	Optional `Date`. The date the assignment was declined.
description	Optional `Description`. The description associated with the assignment.
dispatcher	Optional `Dispatcher`. The dispatcher that assigned/created the assignment.
due_date	Optional `Date`. The date the assignment is due.
in_progress_date	Optional `Date`. The date the assignment was started.
location	Optional `String`. The location or address of the assignment.
notes	Optional `String`. The notes associated with the assignment.
paused_date	Optional `Date`. The date and time the assignment was paused.
priority	Optional `String`. The priority of the assignment none, low, medium, high, critical
status	Optional `String`. The status of the assignment. unassigned, assigned, in_progress, completed, declined, paused, canceled
work_order_id	Optional `String`. The work order id associated with the assignment.
worker	Optional `Worker`. The worker assigned to the assignment

property web_app_link: Returns a link to the assignment in the Workforce web app

property work_order_id: Gets/Sets the work order id of the assignment

property worker: Gets the Worker of the assignment

property worker_id: Gets the worker id of the assignment

AssignmentType

class arcgis.apps.workforce.AssignmentType(project, feature=None, coded_value=None, name=None)

Defines the acceptable values for AssignmentType types.

Parameter	Description
project	Required `Project`. The project that this assignment belongs to.
coded_value	Optional `dict`. The dictionary storing the code and name of the type. Only works for v1 projects.
name	Optional `String`. The name of the assignment type.

# Get an assignment type, update it, delete it

import arcgis
gis = arcgis.gis.GIS("https://arcgis.com", "<username>", "<password>")
item = gis.content.get("<item-id>")
project = arcgis.apps.workforce.Project(item)
assignment_type = project.assignment_types.search()[0]
assignment_type.update(name="Manhole Inspection")
assignment_type.delete()

property code: Gets the internal code that uniquely identifies the assignment type

property coded_value: Gets the coded value

property creation_date: The datetime at which the Feature was created.

property creator: The named user that created the Feature.

delete(): Deletes the assignment type from the server

property edit_date: The datetime at which the Feature was last edited.

property editor: The named user that last edited the Feature.

property feature: The Feature

property geometry: Gets/Sets the geometry for the Feature.

property global_id: The global id of the feature

property id: Gets the id of the assignment type

property name: Gets/Sets The name of the assignment type

property object_id: The object id of the feature

update(name=None)

Updates the assignment type on the server

Parameter	Description
name	Optional `String`. The name of the assignment type

Attachment

class arcgis.apps.workforce.Attachment(assignment, attachment_info)

Represents a file attachment for an Assignment

Parameter	Description
assignment	Required `Assignment`. The assignment object that this attachment belongs to
attachment_info	Required `dict`. The attachment info dictionary representing the attachment.

property attachment_info: Gets the attachment info of the attachment

property content_type: Gets the attachment content type

download(out_folder=None)

Downloads the attachment to the specified path. If the path is omitted, the Attachment will be saved to the current working directory, using the name property as the filename. :param out_folder: The folder in which the attachment should be saved. Defaults to the current working directory.

Returns:: The absolute path to the downloaded file.

property global_id: Gets the attachment global id

property id: Gets the attachment id

property name: Gets the attachment name

property project: Gets the project that the attachment belongs to

property size: Gets the attachment size

Dispatcher

class arcgis.apps.workforce.Dispatcher(project, feature=None, contact_number=None, name=None, user_id=None)

Represents a dispatcher in a project.

Parameter	Description
project	Required `Project`. The project that the dispatcher belongs to.
feature	Optional `Feature`. The feature representing the dispatcher. Mostly intended for internal usage. If supplied, other parameters are ignored.
contact_number	Optional `String`. The contact number of the dispatcher
name	Optional `String`. The name of the dispatcher
user_id	Optional `String`. The user id of the dispatcher

# Get a dispatcher, update it, delete it

import arcgis
gis = arcgis.gis.GIS("https://arcgis.com", "<username>", "<password>")
item = gis.content.get("<item-id>")
project = arcgis.apps.workforce.Project(item)
dispatcher = project.dispatchers.search()[0]
dispatcher.update(name="Dispatcher Name", contact_number="1234567890")
dispatcher.delete()

property contact_number: Gets/Sets the contact number of the dispatcher

property creation_date: The datetime at which the Feature was created.

property creator: The named user that created the Feature.

delete(): Deletes the dispatcher from the server

property edit_date: The datetime at which the Feature was last edited.

property editor: The named user that last edited the Feature.

property feature: The Feature

property geometry: Gets/Sets the geometry for the Feature.

property global_id: The global id of the feature

property id: The object (version 1) or global id (version 2) of the feature

property name: Gets/Sets the name of the dispatcher

property object_id: The object id of the feature

update(contact_number=None, name=None, user_id=None)

Updates the dispatcher on the server

Parameter	Description
contact_number	Optional `String`. The contact number of the dispatcher
name	Optional `String`. The name of the dispatcher
user_id	Optional `String`. The user id of the dispatcher

property user_id: Gets/Sets the user id of the dispatcher

Integration

class arcgis.apps.workforce.Integration(project, feature=None, integration_id=None, prompt=None, url_template=None, assignment_type=None)

Represents an integration in a project. Version 2 Workforce projects only.

Parameter	Description
project	Required `Project`. The project that the dispatcher belongs to.
feature	Optional `Feature`. The feature representing the dispatcher. Mostly intended for internal usage. If supplied, other parameters are ignored.
integration_id	Optional `String`. The id for the integration
prompt	Optional `String`. The prompt in the mobile app for the integration
url_template	Optional `String`. The url that the prompt links to
assignment_type	Optional `String`. The assignment type for the integration

# Get an integration, update it, delete it

import arcgis
gis = arcgis.gis.GIS("https://arcgis.com", "<username>", "<password>")
item = gis.content.get("<item-id>")
project = arcgis.apps.workforce.Project(item)
integration = project.integrations.search()[0]
integration.update(integration_id="arcgis-navigator",prompt="Navigate to Assignment")
integration.delete()

property assignment_type: Gets/Sets the assignment type of the integration

property creation_date: The datetime at which the Feature was created.

property creator: The named user that created the Feature.

delete(): Deletes the integration from the server

property edit_date: The datetime at which the Feature was last edited.

property editor: The named user that last edited the Feature.

property feature: The Feature

property geometry: Gets/Sets the geometry for the Feature.

property global_id: The global id of the feature

property id: The object (version 1) or global id (version 2) of the feature

property integration_id: Gets/Sets the id of the integration

property object_id: The object id of the feature

property prompt: Gets/Sets the prompt of the integration

update(integration_id=None, prompt=None, url_template=None, assignment_type=None)

Updates the dispatcher on the server

Parameter	Description
integration_id	Optional `String`. The id for the integration
prompt	Optional `String`. The prompt in the mobile app for the integration
url_template	Optional `String`. The url that the prompt links to
assignment_type	Optional `String`. The assignment type for the integration

property url_template: Gets/Sets the url template of the integration

Project

class arcgis.apps.workforce.Project(item)

A Workforce Project

Parameter

Description

item

Required Item. The item that the contains the project.

For a version 1 Workforce project, this is an item of type Workforce Project. For a version 2 Workforce project, this is an item of type Feature Service with typeKeyword Workforce Project

# Get a Project and search the assignments and workers.

import arcgis
gis = arcgis.gis.GIS("https://arcgis.com", "<username>", "<password>")
item = gis.content.get("<item-id>")
project = arcgis.apps.workforce.Project(item)
assignments = project.assignments.search()
workers = project.workers.search()

# Create v1 "Classic" Workforce project and v2 "offline-enabled" project
v1_project = arcgis.apps.workforce.create_project('v1_project', major_version=1)
v2_project = arcgis.apps.workforce.create_project('v2_project', major_version=2)

property assignment_types: The AssignmentTypeManager for the project

property assignment_types_item: The assignment types Item

property assignment_types_table: The assignment types Table

property assignment_types_table_url: The assignment types table url

property assignments: The AssignmentManager for the project

property assignments_item: The assignments Item

property assignments_layer: The assignments FeatureLayer

property assignments_layer_url: The assignments feature layer url

delete(): Deletes the project, group, folder, layers, and webmaps. Assumes the currently signed in user owns the project or is an admin.

property dispatcher_web_map_id: The dispatcher webmap item id

property dispatcher_webmap: The dispatcher Map for the project

property dispatchers: The DispatcherManager for the project

property dispatchers_item: The dispatchers Item

property dispatchers_layer: The dispatchers FeatureLayer

property dispatchers_layer_url: The dispatchers layer url

property group: The Group that the project resources are part of

property group_id: The group id that all project items are part of

property id: The item id of the project

property integrations: The AssignmentIntegrationManager for the project

property integrations_table: The integrations Table

property integrations_table_url: The integrations table url Table

property owner: The owner User of the project

property owner_user_id: The user id of the project owner.

property summary: The title of the project

property title: Gets the title of the project

property tracks: The TrackManager for the project

property tracks_item: The tracks Item

property tracks_layer: The tracks FeatureLayer

property tracks_layer_url: The tracks feature layer url

update(summary=None)

Updates the project on the server

Parameter	Description
summary	Optional `String`. The summary of the project.

property version: The version of the project

property worker_web_map_id: The worker webmap item id

property worker_webmap: The worker Map for the project

property workers: The WorkerManager for the project

property workers_item: The workers Item

property workers_layer: The workers FeatureLayer

property workers_layer_url: The workers feature layer url

Track

class arcgis.apps.workforce.Track(project, feature=None, geometry=None, accuracy=None)

Represents a track feature, which describes the historical location of a worker. V1 Projects only.

Parameter	Description
feature	Optional `Feature`. A feature containing the assignments attributes. Mostly intended for internal usage. If supplied, other parameters are ignored.
geometry	Optional `Dict`. A dictionary containing the assignment geometry
accuracy	Optional `Float`. The accuracy of the point

property accuracy: The horizontal accuracy of the location measurement, in meters.

property creation_date: The datetime at which the Feature was created.

property creator: The named user that created the Feature.

delete(): Deletes the track point on the server

property edit_date: The datetime at which the Feature was last edited.

property editor: The named user that last edited the Feature.

property feature: The Feature

property geometry: Gets/Sets the geometry for the Feature.

property global_id: The global id of the feature

property id: The object (version 1) or global id (version 2) of the feature

property object_id: The object id of the feature

update(geometry=None, accuracy=None)

Updates the track point on the server

Parameter	Description
geometry	Optional `Dict`. A dictionary containing the assignment geometry
accuracy	Optional `Float`. The accuracy of the point

Worker

class arcgis.apps.workforce.Worker(project, feature=None, geometry=None, contact_number=None, name=None, notes=None, status='not_working', title=None, user_id=None)

Represents a worker in a Workforce Project

Parameter	Description
project	Required `Project`. The project that the worker belongs to.
feature	Optional `Feature`. The feature representing the worker. Mostly intended for internal usage. If supplied, other parameters are ignored.
geometry	Optional `Dict`. The geometry of the worker.
contact_number	Optional `String`. The contact number of the worker.
name	Optional `String`. The name of the worker.
notes	Optional `String`. The notes about the worker.
status	Optional `String`. The status of the worker. not_working, working, on_break
title	Optional `String`. The title of the worker.
user_id	Optional `String`. The user id of the worker

# Get a worker, update it, delete it

import arcgis
gis = arcgis.gis.GIS("https://arcgis.com", "<username>", "<password>")
item = gis.content.get("<item-id>")
project = arcgis.apps.workforce.Project(item)
worker = project.workers.search()[0]
worker.update(title="Inspector",status="not_working")

property contact_number: Gets/Sets the contact number of the worker

property creation_date: The datetime at which the Feature was created.

property creator: The named user that created the Feature.

delete(): Deletes the worker from the server

property edit_date: The datetime at which the Feature was last edited.

property editor: The named user that last edited the Feature.

property feature: The Feature

property geometry: Gets/Sets the geometry for the Feature.

property global_id: The global id of the feature

property id: The object (version 1) or global id (version 2) of the feature

property name: Gets/Sets the name of the worker

property notes: Gets/Sets the notes of the worker

property object_id: The object id of the feature

property status

Gets/Sets the String status of the worker

not_working, working, on_break

property title: Gets/Sets the title of the worker

update(geometry=None, contact_number=None, name=None, notes=None, status=None, title=None, user_id=None)

Updates the worker on the server

Parameter	Description
geometry	Optional `Dict`. The geometry of the worker.
contact_number	Optional `String`. The contact number of the worker.
name	Optional `String`. The name of the worker.
notes	Optional `String`. The notes about the worker.
status	Optional `String`. The status of the worker. not_working, working, on_break
title	Optional `String`. The title of the worker.
user_id	Optional `String`. The user id of the worker

property user_id: Gets/Sets the user id of the worker

Submodules

arcgis.apps.workforce.managers module