Available for an ArcGIS organization licensed with the Indoors extension.
ArcGIS Indoors は、Indoor Viewer の情報パネルからサードパーティ アプリを直接起動するアクションに対応しています。これらの起動アクションを利用して、Indoors 組織は他のビジネス システムからの情報を簡単に統合できます。Web ページまたはネイティブ モバイル アプリを開く起動アクションを構成できます。こうすると、ユーザーは選択したアイテムに対するインシデントまたはリクエストを Indoors で送信できます。選択したアイテムに関する情報は Indoors から確認でき、フォームのフィールドには、Web ページまたはモバイル アプリを使用して更新情報が自動的に入力されます。
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 は、Indoors のライセンスに含まれます。サポートされる他の作業指示システムやチケット発行システムがない場合は、起動アクションは Survey123 を使用するよう構成できます。
アクション ボタンの使用を Survey123 でカスタマイズするには、有効な引数や値のペアを 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 ネイティブ アプリを起動
"url": "arcgis-survey123://?itemID=surveyformGUID&portalUrl=https://myportal.myorg.com/portal&field:comments={Units.NAME}"
メモ:
ただし、Viewer で使用する起動アクションを構成するときに、ネイティブ モバイル アプリ固有の URL を使用する際は注意が必要です。これらの URL はデスクトップ ユーザー向けにはサポートされていません。また、起動アクションを定義するときにネイティブ アプリの URL を使用する場合は、ネイティブの Indoors アプリか、モバイル ブラウザーからアクセスされる Viewer をサポートするワークフローに限定する必要があります。
サードパーティ システムとの連携
アクション ボタンは、サードパーティ URL を開いて属性値を渡すように構成することもできます。その場合は、サードパーティ システムが URL の構成可能な形式や、起動時にアクションを実行するパラメーターをサポートしている必要があります。このケースでは、連携システムの適切な URL を使用し、Indoors アプリの構成のシステムを呼び出す URL を使用します。一般的な用途としては、サードパーティの作業指示管理システムやアセット管理システムへのリンクが挙げられます。
サードパーティ システムを使用する場合は、以下の点を考慮してください。
- field: 演算子が異なる場合があります。
- URL 引数をサポートする Web フォームには、追加の構成が必要となることがあります。
- この構成が行えるかどうか、およびその方法の詳細については、連携システムのドキュメントをご参照ください。
メモ:
場合によっては、使用されるビジネス システムに応じ、# や + などの記号が使えないことがあります。
作業指示管理システムとの連携
Indoors では、外部のアセットおよび作業指示管理システムを起動できます。Viewer の情報パネルのアクション ボタンは、Indoors のスペースやアセット、またはその他のアイテムに関連するインシデントやリクエストなどの新しい情報を記録したり、サードパーティの作業指示管理アプリで既存の作業指示を開いたりする場合に使用される Web フォームまたはサードパーティのネイティブ アプリを開くよう構成できます。
Indoors では、作業指示と Indoors レイヤー属性を URL のクエリ文字列として渡すことができます。起動をサポートするためには、構文は Indoors と作業指示アプリ システムの URL スキーマに従う必要があります。
属性値は中括弧で囲み、次の構文に一致する必要があります。
?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 の起動アクションの構成例の詳細をご覧ください。
起動アクションの構成文字列の設定
Viewer では、起動アクションを複数の方法で構成できます。有効な JSON 構成文字列は、ArcGIS Pro の Indoors Configuration テーブルで指定できます。
アプリが Indoor Viewer テンプレートで作成されている場合は、起動アクションはポータルのコンフィギュレーターで設定することも可能です。その場合は、起動アクションの文字列が Indoors Configuration テーブルに存在すれば、起動アクションのデフォルト値が指定されます。コンフィギュレーター パネルの変更内容は、Indoors Configuration テーブルの設定を上書きします。
Viewer コンフィギュレーターでアプリ起動アクションが構成されると、エクスポートして ArcGIS Indoors for iOS と ArcGIS Indoors for Android で使用できるようになります。