Indoor Viewer の起動アクションの構成—ArcGIS Indoors

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 で作成したアプリ起動アクションを変更するか、新しいアクションを作成するには、次の手順を実行します。

[アプリの構成] パネルで、[アプリの起動] セクションに移動します。
注意:
ArcGIS Pro で起動アクションを構成した場合は、[アプリの起動] セクションにそれらの起動アクションが表示されます。必要に応じて起動アクションを更新できます。
必要に応じて、新しいアクションを追加します。
1. [追加] をクリックして、新しいアクションを追加します。
2. [ラベル] テキストボックスにアクションの名前を指定します。
3. [URL] テキストボックスにアクションの URL を入力します。
4. [カテゴリおよびレイヤーの選択] をクリックし、このアクションを関連付けるレイヤーとカテゴリのチェックボックスをオンにします。
  デフォルトでは、すべてのレイヤーとサブカテゴリが選択されています。
5. [OK] をクリックします。
6. 他にアクションがある場合は、上記のステップを繰り返します。
削除する起動アクションの横にある [削除] ボタンをクリックします。
必要であれば、上矢印と下矢印を使用してアクションを並べ替えます。
[保存] をクリックして、更新内容をアプリテンプレートに保存します。

起動アクションが構成されたカテゴリおよびレイヤーに属するフィーチャの情報パネルで [詳細] ボタンその他をクリックすると、リストに起動アクションが表示されます。

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 を取得するには、次の手順を実行します。

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 はデスクトップユーザー向けにはサポートされません。ネイティブの Indoors アプリか、モバイルブラウザーからアクセスされる Viewer をサポートするワークフローには、起動アクションを定義するときにネイティブアプリの URL のみを使用します。

サードパーティシステムとの連携

アクションボタンは、サードパーティ URL を開いて属性値を渡すように構成することもできます。その場合は、サードパーティシステムが URL の構成可能な形式や、起動時にアクションを実行するパラメーターをサポートしている必要があります。連携システムの適切な URL を使用し、Indoors アプリの構成のシステムを呼び出す 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 の起動アクションの構成に関わるその他の例をご確認ください。

このトピックへのフィードバック

注意:

注意: