启动操作语法

适用于 ArcGIS Indoors Pro 或 ArcGIS Indoors Maps 扩展模块。

ArcGIS Indoors 包含直接从 Indoor Viewer 中的信息面板和 Indoors 移动应用程序中的信息卡片启动第三方应用程序操作的支持。 在 ArcGIS 组织中配置查看器应用程序时,可通过 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 上附加有效的参数或值对。

ArcGIS Online 组织中创建调查时,默认会缩短用于共享该调查的 URL。 要启用启动操作,在附加参数和对时,必须使用完整 URL。 要获取现有调查的完整 URL,请完成以下步骤:

  1. Survey123 中,单击我的调查选项卡,然后单击要为其创建启动操作的调查。
  2. 单击协作选项卡,然后单击共享调查
  3. 复制缩短的 URL,并将其粘贴到浏览器中,然后加载该调查。

    完整 URL 随即显示在地址栏中。

  4. 从地址栏中复制完整 URL。

现在,在配置启动操作时,可以根据需要将参数和对追加到此 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。 在定义启动操作时,仅限将本机应用程序 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}

工单和 Indoors 图层中的值

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

ServiceNow URL

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

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

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