起動アクションの構成—ArcGIS Pro

ArcGIS Indoors Pro または ArcGIS Indoors Maps エクステンションで利用できます。

ArcGIS Indoors は、Indoor Viewer の情報パネルや Indoors モバイルアプリの情報カードからサードパーティアプリを直接起動するアクションに対応しています。これらの起動アクションを実行すると、組織は Indoors アイテムに関連する情報や、Indoors マップに含まれている他の作業指示、アセット、その他の対象ポイントレイヤーで使用可能なアイテムを他のアプリやワークフローに統合できるようになります。

Web ページまたはモバイルアプリを開く起動アクションを構成して、アプリユーザーが選択したフィーチャに対するインシデントまたはリクエストを送信できるようにします。起動アクションを作成して、アイテムの情報をフォームフィールドに自動入力したり、アイテムに関連する情報を Web ページやモバイルアプリで直接開いたりできるようになります。

注意:

Web マップを正しく共有するには、無効な起動アクションを解決する必要があります。

Indoors の起動アクションの構成ウィンドウへのアクセス

[Indoors の起動アクションの構成] ウィンドウでは、起動アクションを対話的に作成および管理できます。 Web マップとモバイルマップパッケージを準備する場合、特定のレイヤーまたはカテゴリのマップを ArcGIS 組織に共有する前に、そのマップに起動アクションを定義できます。

起動アクションは、フィーチャレイヤーおよびマップイメージレイヤーとともに使用することができます。 Indoors モバイルアプリで使用できるようにマップを準備する場合は、サポートされているレイヤータイプを確認します。

ArcGIS Pro でウィンドウにアクセスするには、次の手順を実行します。

[表示] タブをクリックします。
[ウィンドウ] グループで、[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}

Survey123 との連携

ArcGIS Survey123 は、特定のユーザータイプからアクセスできます。サポートされる他の作業指示システムやチケット発行システムがない場合は、起動アクションは Survey123 を使用するよう構成できます。

アクションボタンの使用を Survey123 でカスタマイズするには、有効な引数または値のペアを URL に付加します。

ArcGIS Online 組織で調査を作成すると、調査を共有する 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 の起動アクションの構成に関わるその他の例をご確認ください。

注意: