可通过以下方式帮助移动用户和调度员开始使用 ArcGIS Workforce:
- 为移动用户提供链接,可使用该链接安装应用程序、设置门户 URL、下载地图、打开任务和设置任务的状态。
- 为调度员提供链接,可使用该链接简化任务创建。
- 使用移动设备管理 (MDM) 软件来部署和配置移动应用程序,其中包括门户 URL。
通过链接打开 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 |
|
mapID | 要下载并在 Workforce 中打开的地图的项目 ID |
|
assignmentID | 在 Workforce 中打开的任务的 GlobalID 值 |
|
assignmentStatus | 在 Workforce 中打开时分配给任务的状态 |
|
下面提供了有关使用这些参数以通过 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 | 为任务设置的任务类型 |
|
lat | 任务在 WGS84 (WKID: 4326) 中的 y 坐标 |
|
lon | 任务在 WGS84 (WKID: 4326) 中的 x 坐标 |
|
location | 用于任务的位置文本 |
|
priority | 为任务设置的优先级 |
|
dueDateTime | 为任务设置的截止日期和时间 |
|
workOrderId | 从外部或第三方系统引用工单的键 |
|
description | 关于任务的信息 |
|
assignee | 分配到任务的用户 |
|
注:
所有参数均为可选参数;但是必须先填写 assignmentType、lat、lon 和 location 参数,之后才能创建新任务。
如果使用 ArcGIS Enterprise,则在通过链接创建任务时,仅支持 lat 和 lon 参数。 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 |
|
每个应用程序虚拟专用网路
通过在 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 断开连接。