ArcGIS Survey123 は、該当のコンポーネント アプリを起動するためのリンクを使用して、他のアプリと統合できます。 たとえば、別の Esri アプリ、Web マップのポップアップ、電子メールや Web サイトの単純なハイパーリンクから Survey123 Mobile を起動して開くためのアプリ リンクを作成できます。 URL を使用して、調査を自動的にダウンロードして開き、Survey123 Connect で編集することができます。
さらに Survey123 から、ArcGIS QuickCapture や ArcGIS Field Maps などの他のアプリにリンクすることもできます。
ヒント:
Survey123 Mobile は、Survey123 Mobile、Survey123 フィールド アプリ、QuickCapture の 3 つのアプリのリンクを開きます。 これらのリンクのいずれかを Survey123 Mobile 内から ([リンクを使用]、[QR コードをスキャン]、または調査もしくは QuickCapture プロジェクト内のリンクから) 起動した場合は、Survey123 Mobile 内で開きます。 詳細については、「コンテンツを開く」をご参照ください。
表内の URL パターンを使用して、Web ブラウザーまたは別のアプリからアクセスするためのリンクを作成します。 以下に掲載の例は、これらの URL パターンを使用して特定の調査を開く方法を示しています。
| 起動するアプリ | リンク元の場所 | 使用する URL パターン |
|---|---|---|
| Survey123 Mobile | Android iOS | Survey123 アプリのリンク 1: 例: |
Windows Android iOS2 | カスタム URL スキーム 3: 例: | |
Web アプリ | Web ブラウザー | ID 別の調査フォーム: 例: |
フィールド アプリ | Android iOS | Survey123 アプリのリンク 1: 例: |
Windows Android iOS2 | カスタム URL スキーマ 3: 例: | |
| Survey123 Studio | Windows | カスタム URL スキーマ 3: 例: |
Survey123 Connect | Windows | カスタム URL スキーマ 3: 例: |
別のアプリ | 調査フォーム | Survey123 からのリンク: アプリによって異なる |
1 - Survey123 アプリ リンクは App Store と Google Play で定められている要件に準拠しているため、より多くのアプリにリンクでき、共有しやすい短縮リンクがサポートされています。
2 - iOS デバイスでは、カスタム URL スキーマは、一部のアプリのグループについてのみ承認されています。
3 - カスタム URL スキーマ リンクは短縮できず、Android では開きにくい場合があります。 以下のように、ハイパーリンクの形式でカスタム URL スキーマ リンクを提示することを検討してください。<a href="arcgis-survey123-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19">Open survey</a>
URL パラメーター
URL パラメーターをリンクの末尾に追加して、アプリが開く方法をさらにカスタマイズできます。 たとえば、ジオポイントの質問のデフォルトの位置を設定したり、テキストの質問を設定したりできます。
URL パラメーターは文字 ? で始まり、文字 & で区切られます。 次に示すカスタム URL スキーマの例では、最初のパラメーター (itemID) が文字 ? で始まり、後続の各フィールド パラメーター (color_1 と color_2) が文字 & で区切られています。
arcgis-survey123-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:color_1=red&field:color_2=blueURL の例とサポートされている URL パラメーターの詳細については、「Survey123 Mobile の起動」、「フィーチャ関数 | ArcGIS Arcade | Esri Developer」、「Web アプリの起動」、「フィールド アプリの起動」、「Survey123 Connect の起動」、「Survey123 からの別のアプリの起動」をご参照ください。
注意:
Survey123 Mobile またはフィールド アプリで調査を開始するためのパラメーターを含むリンクを使用する前に、あらかじめアプリをデバイスにインストールしておくことをおすすめします。 詳細については、「ArcGIS Survey123 のインストール」をご参照ください。
URL のエンコード
一部の環境ではエンコードされていない URL パラメーターでも動作しますが、URL パラメーターはエンコードすることをおすすめします。 エンコーディングでは、無効な文字が、パーセント記号 (%) およびそれらの文字の 16 進数表記に置き換えられます。
次の例は、コールバックを使用し、Survey123 でエンコードされていないパラメーターを使用して特定のプロジェクトに戻る QuickCapture リンクを示しています。
https://survey123-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https://quickcapture.arcgis.app?itemID=867895a71a1840399476fc717e76bb43以下は、同じ URL のパラメーターをエンコードしたものです。
https://survey123-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https%3A%2F%2Fquickcapture.arcgis.app%3FitemID=867895a71a1840399476fc717e76bb43キーとその値の間の区切りを指定する等号は、エンコードしてはなりません。
ヒント:
エンコードされたパラメーターを作成する方法の 1 つは、ArcGIS Arcade を使用することです。 UrlEncode 関数では、各パラメーターを表すキー値ペアのコレクションを定義して、適切なエンコードを行った URL を作成できます。
調査の作成者は、URL に機密データが表示されないよう URL パラメーターを隠蔽することもできます。 この場合、Web アプリで使用する URL を作成する際に、encodeUrlParams=true を含めるようにしてください。 詳細については、「Web アプリを開くための URL パラメーター」をご参照ください。