配置 Indoor Viewer 的启动操作

适用于 ArcGIS Indoors Maps 扩展模块。

ArcGIS Indoors 包含直接从 Indoor Viewer 中的信息面板启动第三方应用程序操作的支持。 应用程序启动操作可用于将关键业务系统与 ArcGIS Indoors 集成。

可以将启动操作配置为打开 web 页面或本机移动应用程序,并将室内数据自动传递到目标系统或应用程序。这将允许用户针对 Viewer 中的选定要素提交事件或请求。 用户可以查看有关在 Viewer 应用程序中选择的要素的信息并使用 web 页面或移动应用程序将已更新的信息自动填充到表单字段。

现在可以通过以下方式为 Viewer 配置启动操作:

  • ArcGIS Pro 中使用配置 Indoors 启动操作窗格。 在 ArcGIS Pro 中配置的启动操作可以在应用程序配置过程中进行修改。
    注:

    配置应用程序面板中所做的修改仅影响 Viewer 应用程序中的启动操作。

  • 在创建或修改应用程序时,使用配置应用程序面板。在配置面板中,您可以修改在 ArcGIS Pro 中创建的启动操作或创建新的启动操作。

注:

Indoors 允许将图钉放置在建筑物外部的位置,例如校园园林或地面上。 如果将启动操作应用于配置面板中的所有图层,则这些已放置的图钉也会具有对其可用的操作。

使用配置面板配置启动操作

Viewer 应用程序配置期间,执行以下步骤以修改在 ArcGIS Pro 中创建的应用程序启动操作或新建操作。

  1. 配置应用程序面板中,导航到应用程序启动部分。
    注:

    如果您在 ArcGIS Pro 中配置了启动操作,这些操作会在应用程序启动部分中显示。 可根据需要对其进行更新。

  2. 可以选择新建操作。
    1. 单击添加以添加新操作。
    2. 标注文本框中提供操作的名称。
    3. 操作的 URL 添加到 URL 文本框。
    4. 单击选择类别和图层,然后选中与该操作关联的图层和类别的复选框。

      默认情况下,所有图层和子类别都处于选中状态。

    5. 单击确定
    6. 针对任何附加操作,重复上述步骤。
  3. 单击要移除的任何启动操作旁边的移除按钮 移除
  4. 如有必要,可以使用向上和向下箭头对操作进行重新排序。
  5. 单击保存将更新保存到应用程序模板。

当您针对具有已配置启动操作的类别和图层中的要素单击信息面板中的更多按钮 更多 时,启动操作将显示在列表中。

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 可供特定用户类型的用户访问。 如果缺少其他受支持的工单或票务系统,可以将启动操作配置为使用 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}

注:

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

与第三方系统集成

如果第三方系统支持 URL 可配置形式或参数以在启动时驱动操作,则也可以将操作按钮配置为打开第三方 URL 并向其传递属性值。 可以将 Indoors 应用程序配置中用于调用系统的 URL 与集成系统的相应 URL 配合使用。 常见用途包括链接到第三方工单管理系统或资产管理系统。

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

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

注:

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

与工单管理系统集成

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

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 启动操作的示例。