Skip to main content

配置启动操作

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

ArcGIS Indoors 包含直接从 Indoors Viewer 中的信息面板和 Indoors 移动应用程序中的信息卡片启动第三方应用程序操作的支持。 这些启动操作使组织能够将与 Indoors 项目,或在 Indoors 地图中可能包含的额外工单、资产及其他感兴趣点图层中可用的项目相关的信息,集成至其他应用程序和工作流。

可以配置启动操作以打开 web 页面或移动应用程序,以允许应用程序用户针对选定要素提交事件或请求。 可以创建启动操作以自动填充表单字段,或者将 Web 页面或移动应用程序直接打开至与项目相关的信息。

注:

必须先解决无效的启动操作,才能成功共享 web 地图。

访问“配置 Indoors 启动操作”窗格

您可通过配置 Indoors 启动操作窗格以交互方式创建和管理启动操作。 在准备 Web 地图和移动地图包时,您可以在将地图共享到 ArcGIS 组织之前,在地图中为特定的图层或类别定义启动操作。

支持将启动操作与要素图层和地图图像图层配合使用。 在准备地图以将其用于 Indoors 移动应用程序时,请检查支持哪些图层类型。

要访问 ArcGIS Pro 中的窗格,请完成以下步骤:

  1. 单击视图选项卡。

  2. 窗口组中,单击 Indoors 下拉箭头,然后单击配置 Indoors 启动操作

    随即显示配置 Indoors 启动操作窗格。

创建启动操作

您可以通过单击配置 Indoors 启动操作窗格中的创建 Indoors 启动操作按钮来创建启动操作。 该操作将打开一个向导,以指导您完成为活动地图创建启动操作的工作流。 创建启动操作后,系统将在配置 Indoors 启动操作窗格中列出对该操作的描述。

编辑启动操作

您可以通过右键单击配置 Indoors 启动操作窗格中的启动操作并单击编辑编辑启动操作

注:

随后修改配置 Indoors 启动操作窗格中配置的启动操作(在 ArcGIS Pro 中编辑地图或已发布 web 地图或配置 Viewer 应用程序时)。

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}

注:

如果对 Indoors 模型中的 Sites、Facilities 或 Levels 图层进行重命名,您仍可以将 Indoors 模型图层名称用于采用 {LayerName.Attribute} 语法的 LayerName 属性。 例如,如果 Facilities 图层重命名为 Buildings,可以使用 {Buildings.Name}{Facilities.Name} 语法在启动操作 URL 中包含该图层中的属性。

集成 Survey123

ArcGIS Survey123 可供特定用户类型的用户访问。 如果缺少其他受支持的工单或票务系统,可以将启动操作配置为使用 Survey123。

要使用 Survey123 自定义操作按钮的体验,需要向 URL 追加有效的参数或值对。

在 ArcGIS Online 组织中创建调查时,默认会缩短用于共享该调查的 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 中信息面板上的操作按钮以打开 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 启动操作的示例。