适用于 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}
与 ArcGIS Survey123 集成
ArcGIS Survey123 可供特定用户类型的用户访问。 如果缺少其他受支持的工单或票务系统,可以将启动操作配置为使用 Survey123。
要使用 Survey123 自定义操作按钮的体验,需要向 URL 附加有效的参数或值对。
在 ArcGIS Online 组织中创建调查时,默认会缩短用于共享该调查的 URL。 要启用启动操作,在附加参数和对时,必须使用完整 URL。
要获取现有调查的完整 URL,请完成以下步骤:
- 在 Survey123 中,单击我的调查选项卡,然后单击要为其创建启动操作的调查。
- 单击协作选项卡,然后单击共享调查。
- 将缩短的 URL 复制到浏览器中,然后加载该调查。
完整 URL 随即显示在地址栏中。
- 从地址栏中复制完整 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 支持传递工单和 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 启动操作的示例。