启动操作语法

适用于具有 Indoors 功能许可的门户。​

ArcGIS Indoors 包含直接从 Indoor Viewer 中的信息面板和 Indoors 移动应用程序中的信息卡片启动第三方应用程序操作的支持。在 ArcGIS Enterprise 门户或 ArcGIS Online 组织中配置查看器应用程序时,可通过 ArcGIS Pro 中的配置 Indoors 启动操作窗格配置启动操作。

URL 语法

启动操作由 URL 启用,语法必须遵循通用的 URL 约定。例如,参数中的特殊字符必须经过 URL 编码,并且参数或值对必须使用标准的 URL 约定予以分隔。

对于 Indoors,值必须实用大括号括起,并与以下语法相符:

?arg={Layer.Attribute}&arg={Attribute}

注:

图层为可选项,如果未包含,则默认为 Indoors 中的当前选定项目。许多使用案例都会需要传递来自地图或场景内不同图层的属性。图层运算符可支持此功能。参数和值不区分大小写。

请参阅以下示例:

单一值

?Name={KNOWNAS}&building={facility_name}&space={Units.Name}

多个值

?center={shape.y},{shape.x}

来自另一个要素类的值

&site={FACILITIES.SITE_ID}

将值传递到特定字段

&field:room={units.name}

支持的参数和值格式

启动操作 URL 可以支持传递带有通用参数的值(field={Units.UNIT_ID})或指向 Survey123 表格内特定字段的值(field:room={Units.Name})。

此外,可以同时列出多个参数,并可在参数之间添加文本。

示例

https://<MySurveyURL>?Name={knownas}&office=office%3A%20{units.NAME}&loc={shape.x},{shape.y},{shape.z}

Survey123 集成

Survey123 被包括在 Indoors 许可内。在没有任何其他受支持的工单或票务系统的情况下,可以将启动操作配置为使用 Survey123

要为 Survey123 自定义操作按钮的体验,请将有效的参数或值对附加到 URL 中。

示例:默认行为的基本 URL

https://survey123.arcgis.com/share/surveyformGUID?portalUrl=https://myportal.myorg.com/portal

示例:自定义

本示例使用“单位”图层的名称字段覆盖了默认的房间输入。

https://survey123.arcgis.com/share/surveyformGUID?portalUrl=https://myportal.myorg.com/portal&field:room={Units.NAME}

示例:启动移动设备上的 Survey123 本机应用程序

arcgis-survey123://?itemID=surveyformGUID&portalUrl=https://myportal.myorg.com/portal&field:comments={Units.NAME}

注:

在配置启动操作以用于 Viewer 时,如果使用特定于本机移动应用程序的 URL,则请注意,因为桌面用户不支持这些功能。在定义启动操作时,使用本机应用程序 URL 应仅限于支持本机 Indoors 应用程序或支持通过移动浏览器访问 Viewer 的工作流。

与第三方系统集成

如果第三方系统支持 URL 可配置形式或参数以在启动时驱动操作,则也可以将操作按钮配置为打开第三方 URL 并向其传递属性值。在这种情况下,请使用能够调用 Indoors 含有集成系统正确 URL 的应用程序配置内的系统的 URL。一些常见的用途包括链接到第三方工单理管理系统或资产管理系统。

使用第三方系统时,请考虑以下内容:

  • field: 运算符可能有所不同。
  • 支持 URL 参数的 Web 表单可能需要额外配置。
  • 有关其是否起作用以及如何起作用的详细信息,请参阅集成系统供应商。

注:

在某些情况下,某些诸如 #+ 的字符可能不受支持,具体取决于所使用的业务系统。

与工作订单管理系统集成

Indoors 支持启动外部资产和工作订单管理系统。Viewer 中的信息面板和 Indoors 移动应用程序中的信息卡片上的操作按钮可以配置为打开 web 表单或第三方本机应用程序。该表单或第三方应用程序可用于记录新信息(例如与空间、资产或 Indoors 中的其他项目相关联的事件或请求),或者在第三方工作订单管理应用程序中打开现有工作订单。

Indoors 支持传递工单和 Indoors 图层属性作为 URL 中的查询字符串。该语法必须遵循 Indoors 的 URL/URI 方案以及工单应用程序系统,才能支持启动。

该属性值必须用大括号括起,并与以下语法相符:

?arg={Work order Attribute}&arg={Layer.Attribute}

以下为其他语法示例:

工单图层中的单个值

?arg={workorderid}

工单图层中的多个值

?arg={workorderid}&arg={priority}

工单和室内图层中的值

?arg={workorderid}&arg={Layer.Attribute}

ServiceNow URL

以下示例会将工单号作为参数传递,并打开一个现有的工单:

https://<MyServerURL>/nav_to.do?uri=task.do?sysparm_query=number={workorderid}

查看更多针对 ServiceNow 配置启动操作的示例。