Indoors エクステンションのライセンスが付与された ArcGIS 組織で利用できます。
ArcGIS Indoors は、Indoor Viewer の情報パネルからサードパーティ アプリを直接起動するアクションに対応しています。 アプリ起動アクションは、重要なビジネス システムを ArcGIS Indoors に組み込む手段として使用されます。
Web ページまたはネイティブ モバイル アプリを開いて、屋内データをターゲット システムまたはアプリに自動的に渡すように起動アクションを構成できます。こうすると、ユーザーは選択されたフィーチャに対するインシデントまたはリクエストを Viewer で送信できます。 ユーザーは、Viewer で選択されたフィーチャに関する情報を表示でき、フォームのフィールドには、Web ページまたはモバイル アプリを使用して更新情報が自動的に入力されます。
Viewer の起動アクションは次の方法で構成できます。
- ArcGIS Pro で [Indoors の起動アクションの構成] ウィンドウを使用します。 ArcGIS Pro で構成した起動アクションは、後でアプリの構成中に変更することができます。
注意:
[アプリの構成] パネルで行った変更は、Viewer アプリの起動アクションのみに反映されます。
- アプリの作成または変更時に [アプリの構成] パネルを使用します。この構成パネルでは、ArcGIS Pro で作成した起動アクションを変更したり、新しい起動アクションを作成したりできます。
注意:
Indoors では、建物の外、たとえばキャンパスの庭やグランドなどの場所にピンを配置することができます。 起動アクションが、構成パネルで [すべてのレイヤー] に適用される場合、ドロップされたピンには、そこで使用できるアクションもあります。
構成パネルを使用した起動アクションの構成
Viewer アプリの構成時に、ArcGIS Pro で作成したアプリ起動アクションを変更するか、新しいアクションを作成するには、次の手順を実行します。
- [アプリの構成] パネルで、[アプリの起動] セクションに移動します。
注意:
ArcGIS Pro で起動アクションを構成した場合は、[アプリの起動] セクションにそれらの起動アクションが表示されるので、必要に応じて起動アクションを更新できます。
- 必要に応じて、新しいアクションを追加します。
- [追加] をクリックして、新しいアクションを追加します。
- [ラベル] テキスト ボックスにアクションの名前を指定します。
- [URL] テキスト ボックスにアクションの URL を入力します。
- [カテゴリおよびレイヤーの選択] をクリックし、このアクションを関連付けるレイヤーとカテゴリのチェックボックスをオンにします。
デフォルトでは、すべてのレイヤーとサブカテゴリが選択されています。
- [OK] をクリックします。
- 他にアクションがある場合は、上記のステップを繰り返します。
- 削除する起動アクションの横にある [削除] ボタン
をクリックします。 - 必要であれば、上矢印と下矢印を使用してアクションを並べ替えます。
- [保存] をクリックして、更新内容をアプリ テンプレートに保存します。
起動アクションが構成されたカテゴリおよびレイヤーに属するフィーチャの情報パネルで [詳細] ボタン 
をクリックすると、リストに起動アクションが表示されます。
URL syntax
Launch actions are enabled by URLs, and the syntax must follow common URL conventions. For example, special characters in the arguments must be URL encoded, and the argument or value pairs must be separated with standard URL conventions.
For Indoors, values must be contained in curly brackets and match the following syntax:
?arg={Layer.Attribute}&arg={Attribute}
注意:
The layer is optional and, if not included, defaults to the active item in the Indoors app. Many use cases require passing attributes from a different layer in the map or scene. This is supported with the layer operator. Arguments and values are not case sensitive.
See the following samples:
Single value
?Name={KNOWNAS}&building={facility_name}&space={Units.Name}
Multiple values
?center={shape.y},{shape.x}
Value from another feature class
&site={FACILITIES.SITE_ID}
Pass value to a specific field
&field:room={units.name}
Supported argument and value formats
The launch action URL can support either passing a value with a generic argument (field={Units.UNIT_ID}) or pointing the value at a specific field in the Survey123 form (field:room={Units.Name}).
In addition, multiple arguments can be listed together, and you can add text between them.
Example
https://<MySurveyURL>?Name={knownas}&office=office%3A%20{units.NAME}&loc={shape.x},{shape.y},{shape.z}
Survey123 との連携
Survey123 is included with your Indoors license. In the absence of any other supported work order or ticketing system, launch actions can be configured to use Survey123.
To customize the experience of the action button with Survey123, append valid argument or value pairs onto the URL.
When you create a survey in your ArcGIS Online organization, the URL to share the survey is shortened by default. To enable launch actions, you must use the full URL when appending arguments and pairs. To get the full URL for an existing survey, complete the following:
- In Survey123, click the My Surveys tab and click the survey for which you want to create a launch action.
- Click the Collaborate tab and click Share survey.
- Copy the shortened URL, paste it into a browser, and load the survey.
The full URL appears in the address bar.
- Copy the full URL from the address bar.
You can now append arguments and pairs to this URL as necessary when configuring launch actions.
Example: Base URL for default behavior
https://survey123.arcgis.com/share/surveyformGUID?portalUrl=https://myportal.myorg.com/portal
Example: Custom
This example overrides the default room input with the name field from the Units layer.
https://survey123.arcgis.com/share/surveyformGUID?portalUrl=https://myportal.myorg.com/portal&field:room={Units.NAME}
Example: Launch the Survey123 native app on mobile devices
arcgis-survey123://?itemID=surveyformGUID&portalUrl=https://myportal.myorg.com/portal&field:comments={Units.NAME}
注意:
Be careful when using URLs specific to native mobile apps when configuring launch actions for use in Viewer as these are not supported for desktop users. Using a native app's URL when defining launch actions should be limited to workflows supporting the native Indoors apps or Viewer accessed from a mobile browser.
Integration with third-party systems
The action button can also be configured to open a third-party URL and pass attribute values to it, provided that the third-party system supports URL configurable forms or parameters to drive actions upon launch. In this case, use a URL that calls the system in the Indoors app configuration with an appropriate URL for the integrated system. Some common uses are linking to third-party work order management systems or asset management systems.
Consider the following when working with third-party systems:
- The field: operator may be different.
- Web forms that support URL arguments may require additional configuration.
- Consult the integrated system vendor for details on whether and how this works.
注意:
In some cases, depending on the business system being used, some characters may not be supported, such as the # or + characters.
作業指示管理システムとの連携
Indoors では、外部のアセットおよび作業指示管理システムを起動できます。 Viewer の情報パネルのアクション ボタンは、Indoors のスペースやアセット、またはその他のアイテムに関連するインシデントやリクエストなどの新しい情報を記録したり、サードパーティの作業指示管理アプリで既存の作業指示を開いたりする場合に使用される Web フォームまたは別個のアプリを開くよう構成できます。
Indoors supports passing work order and Indoors layer attributes as a query string in the URL. The syntax must follow the URL/URI schema for Indoors and work order app system to support launch actions.
The attribute value must be enclosed in curly brackets and match the following syntax:
?arg={Work order Attribute}&arg={Layer.Attribute}
The following are additional syntax samples:
Single value from work order layer
?arg={workorderid}
Multiple values from work order layer
?arg={workorderid}&arg={priority}
Value from work order and Indoors layer
?arg={workorderid}&arg={Layer.Attribute}
ServiceNow URL
The following sample passes the work order number as a parameter and opens an existing work order:
https://<MyServerURL>/nav_to.do?uri=task.do?sysparm_query=number={workorderid}
See more examples of configuring launch actions for ServiceNow.