部署 Workforce

可通过以下方式帮助移动用户和调度员开始使用 ArcGIS Workforce

通过链接打开 Workforce 移动应用程序

移动用户可以在 Workforce 中指定其门户 URL,您也可以直接为其提供一个 URL,以将其用于指定正确的门户 URL。 通过电子邮件、短信、网页、QR 码或其他应用程序共享链接,您的移动用户可以访问正确的门户。 点击后,Workforce 将打开您希望移动工作人员使用的门户 URL。

链接结构

Workforce 移动应用程序的链接具有以下格式:https://workforce.arcgis.app?parameter=value。 参数和值对将被替换为您要用于部署应用程序的值。 例如,https://workforce.arcgis.app?portalURL=https://myportal.mycompany.com/arcgis 链接将使用参数 portalURL 使移动用户直接进入您组织的登录页面,并提示其进行登录。

参数

Workforce 链接支持以下参数。 如果未传递任何参数,则点击该链接即可打开 Workforce(或系统将提示您下载应用程序)。

参数备注

portalURL

您组织的门户 URL

  • 如果已指定值且移动用户已登出或连接到其他门户(其中包括 ArcGIS Online),则系统将提示其登出,然后使其直接进入您组织的登录页面并提示其登录。
  • 提供您在访问门户时在浏览器中输入的 URL,例如,https://myportal.mycompany.com/arcgis

mapID

要下载并在 Workforce 中打开的地图的项目 ID

  • 项目 ID 在 Worker 地图项目页面的 URL 中。 例如,如果 Worker 地图项目页面 URL 为 https://www.arcgis.com/home/item.html?id=fc60dfd46b234fbeaa74e76e6b17fb7b,则地图的项目 ID 为 fc60dfd46b234fbeaa74e76e6b17fb7b

assignmentID

Workforce 中打开的任务的 GlobalID

  • 需要 mapID 值。
  • 任务的 GlobalID 值位于 Assignments 图层项目页面数据选项卡上。 在表格时,单击选项菜单,然后单击显示/隐藏列。 选择 GlobalID 以显示每个任务的相应值。

assignmentStatus

Workforce 中打开时分配给任务的状态

  • 需要 mapIDassignmentID 值。
  • 支持以下整型值:
    • 1(已分配)
    • 2(进行中)
    • 3(已完成)
    • 4(已拒绝)
    • 5(已暂停)

下面提供了有关使用这些参数以通过 Workforce 链接实现特定行为的示例。

连接到特定门户

指定移动工作人员应连接到的门户 URL。

以下为示例:

https://workforce.arcgis.app?portalURL=https://myportal.mycompany.com/arcgis

下载并打开地图

可以使用 mapID 参数下载并打开地图。 如果移动工作人员已在其设备上下载地图,则不会进行任何下载,并且将在 Workforce 中打开特定地图。

以下为示例:

  • 以当前登录的移动工作人员的身份打开地图,或者,如果尚且没有移动工作人员登录,则为其提供登录的机会:
    https://workforce.arcgis.app?mapID=3ac4145c1ac44aea86e9ed42e00fbb0d
  • 连接到特定门户并打开地图:
    https://workforce.arcgis.app?portalURL=https://myportal.mycompany.com/arcgis&mapID=3ac4145c1ac44aea86e9ed42e00fbb0d

打开任务

可以使用 assignmentID 参数打开地图中的任务。

以下为示例:

https://workforce.arcgis.app?mapID=3ac4145c1ac44aea86e9ed42e00fbb0d&assignmentID=948b2bf3-f866-4516-97e7-00418d3b567d

设置任务的状态

可以使用 assignmentStatus 参数设置任务的状态。

以下为示例:

https://workforce.arcgis.app?mapID=3ac4145c1ac44aea86e9ed42e00fbb0d&assignmentID=948b2bf3-f866-4516-97e7-00418d3b567d&assignmentStatus=2
注:

可以但不建议使用此参数以移动应用程序中无法实现的方式来设置任务状态。 例如,如果某个任务的状态为已分配,则 Workforce 链接可用于将其设置为已暂停,以跳过由移动工作人员设置的进行中状态。 无法在移动应用程序中跳过此状态。

通过链接打开 Workforce web 应用程序

您可以通过电子邮件、短信、网页、QR 码或其他应用程序共享链接,从而简化 Workforce web 应用程序的部署。链接可以通过 URL 参数进行自定义,以打开现有任务或已填充任务信息的新任务。

为调度员提供一个链接,使其能够创建已填写关键信息的任务。 例如,要从第三方应用程序创建任务,则可以添加一个能够自动填充位置、描述和新任务截止日期的链接。

链接结构

Workforce Web 应用程序的链接通常以以下格式为开头:http://<portal-url>/apps/workforce/projects/<project-id>

要打开特定任务,向链接追加 /dispatch/assignments/<assignment-id>http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/<assignment-id>

要开始创建任务,将 /dispatch/assignments/new? 追加至链接,并包括一个或多个使用与号 (&) 分隔的参数

http://<your portal url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?assignmentType=repair&lat=34.057170&lon=-117.194150&location=Esri
注:

Workforce 工程打开时,可以在 URL 中找到 project-id 值。 例如,如果 URL 是 http://arcgis.com/apps/workforce/projects/a0f297f949f549f0ade07eee562d9934,则 project-id 值为 a0f297f949f549f0ade07eee562d9934

对参数进行编码

必须对 Workforce web 应用程序的链接中的所有参数进行编码。 编码使用百分号 (%) 后跟其等效的十六进制数来替换所有无效的字符。

例如,以下链接具有未编码参数:

http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?assignmentType=repair hydrant&lat=34.057170&lon=-117.194150&location=Esri Campus

以下是具有编码参数的相同链接:

http://<portal-url>/apps/workforce/<project-id>new?assignmentType=repair%20hydrant&lat=34.057170&lon=-117.194150&location=Esri%20Campus

您可以使用许多用于生成编码 URL 的免费网站和工具。 例如,Albion Research Ltd. 的 URLEncode and URLDecode Page

创建任务

创建可以启动 Workforce web 应用程序的链接,其中已为新任务填充任务信息。 例如,如果您具有用于创建树木检查的自定义应用程序,则可以创建一个可打开 Workforce 的链接,其中新的树木检查任务的任务类型和位置信息已经填充完成。

参数

使用 Workforce 链接创建任务所支持的参数在下方列出。

参数备注

assignmentType

为任务设置的任务类型

  • 您可以使用 GlobalID 值或任务类型的名称。
    注:

    如果您为 Classic 工程创建链接,则可以使用编码值属性域或任务类型名称。

  • 值不区分大小写。

lat

任务在 WGS84 (WKID: 4326) 中的 y 坐标

  • 需要 lon 值。

lon

任务在 WGS84 (WKID: 4326) 中的 x 坐标

  • 需要 lat 值。

location

用于任务的位置文本

  • 如果填充了 latlon,则将忽略此参数。

priority

为任务设置的优先级

  • 支持以下整型值:
    • 0(无)
    • 1(低)
    • 2(中)
    • 3(高)
    • 4(重要)

dueDateTime

为任务设置的截止日期和时间

  • 自 Unix 纪元以来的数字毫秒数。

workOrderId

从外部或第三方系统引用工单的键

  • 外部系统中的值。

description

关于任务的信息

  • 说明文本。

assignee

分配到任务的用户

  • 您可以使用工作人员的 GlobalID 值或其用户名。
    注:

    如果您为 Classic 工程创建链接,则可以使用 objectid 值或用户名。

  • 值不区分大小写。
注:

所有参数均为可选参数;但是必须先填写 assignmentTypelatlonlocation 参数,之后才能创建新任务。

如果使用 ArcGIS Enterprise,则在通过链接创建任务时,仅支持 latlon 参数。 ArcGIS Enterprise 上的 Workforce web 应用程序使用反向地理编码填充 location 参数。

示例

以下是在创建 Workforce 任务时如何在应用程序链接中使用参数来填充信息的示例:

  • 使用坐标创建任务:
    http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?lat=34.057170&lon=-117.194150
  • 创建具有中优先级的树木检查任务并将其分配给移动工作人员:
    http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?assignmentType=inspect%20tree&lat=34.057170&lon=-117.194150&location=esri&priority=2&assignee=mobile_worker
  • 创建一个管线维修任务,截止日期为 5 月 23 日下午 3:00。
    http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?assignmentType=pipe%20repair&lat=34.057170&lon=-117.194150&location=esri&dueDateTime=1621782000000
  • 创建一个包含问题描述的维修任务:
    http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?assignmentType=repair&&lat=34.057170&lon=-117.194150&location=esri&description=Repair%20the%20valve.

移动设备管理

移动设备管理是指用于组织中移动设备管理的软件。 MDM 用于增强数据和网络安全性以及设置和执行移动设备策略。 此外,使用 MDM 可以提高移动设备的应用程序部署和管理的效率,其中包括控制应用程序的更新方式和时间。 有关 Esri 如何应对 MDM 的详细信息,请参阅 ArcGIS Trust Center 中的 ArcGIS 安全移动实施模式

如果准备通过 MDM 将 Workforce 部署到组织的移动设备,则可以配置一些应用程序和配置文件设置。 其中包括门户 URL 和每个应用程序 VPN 设置。

警告:

如果您使用的是 Android 设备,则必须安装并启用 Chrome 或其他浏览器才能显示门户登录屏幕。

Workforce 应用程序配置

应用程序配置(也称为 AppConfig)是指用于提供应用程序设置(例如门户 URL)的格式。 可以使用 MDM 自动指定并应用应用程序配置,而不必在每次安装移动应用程序时手动配置这些设置。 这些设置在 .xml 文件中定义为键值对字典。 创建字典的方式取决于您所使用的 MDM。 有关应用程序配置的详细信息,请访问 AppConfig 社区 web 页面。

Workforce 具有以下设置,可以在 MDM 中通过应用程序配置来实施这些设置:

备注

portalURL

您组织的门户 URL

  • 启动 Workforce 后,它将直接跳转至您组织门户的登录页面。
  • 例如,https://myportal.mycompany.com/gis
  • 值类型为字符串。

每个应用程序虚拟专用网路

通过在 MDM 中配置每个应用程序虚拟专用网络(每个应用程序 VPN),可以将对内部资源的访问权限限制为特定托管应用程序。 Workforce 可通过此配置进行部署。 要设置每个应用程序 VPN 以与 Workforce 配合使用,请参阅您所使用的 MDM 的软件文档。

警告:

如果您使用 iOS,则 Safari 可用于在 Workforce 中显示门户登录页面。 在已启用每个应用程序 VPN 的情况下,要使此功能正确运行,必须在您所使用的每个应用程序 VPN 配置文件中的 Safari 域设置中指定您的门户域(例如,mycompany.com)。 如果 Safari 域设置错误,则分配的移动设备无法访问 Workforce 门户登录屏幕。

如上所述,当您在每个应用程序 VPN 配置文件中设置 Safari 域值时,Safari 浏览器也可以访问您在 Safari 域中指定的门户域。 要阻止此访问,请配置 iOS 限制(如果在 MDM 中可用)以在适用设备上使用阻止 Safari 浏览器应用程序

在 MDM 中配置 Workforce 的每个应用程序 VPN 设置后,当在管理移动设备上打开应用程序时,应用程序会自动连接到指定的每个应用程序 VPN。 Workforce 在后台运行时,每个应用程序 VPN 仅连接到 Workforce。 关闭 Workforce 后,移动设备将自动从每个应用程序 VPN 断开连接。