デフォルトでは、Survey123 で調査を公開すると、調査のスキーマを使用してフィーチャ レイヤーが作成されます。 あるいは、調査を既存のフィーチャ レイヤーと関連付けることができます。
フィーチャ レイヤーの準備
既存のフィーチャ レイヤーを Survey123 で使用するには、次の要件を満たしている必要があります:
- フィーチャ レイヤーは、ArcGIS Enterprise または ArcGIS Online 内のアイテムである必要があります。 これには、ホスト フィーチャ レイヤーや、フェデレートされているサーバーまたはフェデレートされていないサーバーに公開されているフィーチャ レイヤーが含まれます。
注意:
フェデレートされていないフィーチャ サービスを使用するには、追加の構成が必要となります。 ArcGIS 組織に、サービスを表すフィーチャ レイヤー アイテムを手動で作成する必要があります。 詳細については、フェデレートされていない ArcGIS Server サービスへの接続方法に関する技術情報記事をご参照ください。
- 調査の所有者とユーザーには、そのフィーチャ レイヤーへのアクセス権が必要です。
- フィーチャ レイヤーは「編集可能」である必要があります。
- 次の追加プロパティを true に設定する必要があります:
- supportsApplyEditsWithGlobalIds - フィーチャ レイヤーは、Global ID による編集の適用をサポートしている必要があります。 これを使用すると、作成されたフィーチャの Global ID をアプリで作成および管理できます (作成されたフィーチャにサーバーが新しい Global ID を作成しません)。
- supportsAttachmentsByUploadId - このプロパティは、フィーチャ レイヤーで添付ファイルを有効化すると自動的にオンになります。 これを使用すると、アプリが調査に関連付けられているすべての添付ファイルをアップロードしてから、調査を送信します。 添付ファイルのアップロードが失敗すると、調査の送信全体がロール バックされ、データの損失が回避されます。
調査の設計と使用方法に応じて、次の追加の要件を検討してください:
- ユーザーが新しい調査を収集してレコードを追加するには、Create 機能が必要です。
- ユーザーが既存の調査レコードを編集する方法:
- レイヤーの Update 機能が必要です。
- フィーチャ レイヤーが NULL 値を許可していること、または調査が必須フィールドを使用していることを確認します。 Survey123 は、回答が削除され置き換えられない場合に、編集中に NULL 値を使用します。そのため、Survey123 は、NULL 値を許可しないフィーチャ レイヤーからは調査を送信しません。
- ユーザーが画像、オーディオ、またはファイルを送信するには、添付ファイルを有効化 (hasAttachments を true に設定) する必要があります。
- 子レイヤーまたはテーブルがリレーションシップに GUID フィールドを使用していない場合、調査内の繰り返しでは関連レイヤーまたはテーブルを参照できません。 繰り返しの名前は関連テーブルまたはレイヤーのテーブル名によって定義され、変更することはできません。
注意:
Survey123 は、既存のフィーチャ レイヤーと関連テーブルを操作するとき、1 対多の GUID リレーションシップのみをサポートしています。 1 対 1 のリレーションシップはサポートされていません。
Global ID による編集の適用
フィーチャ レイヤーが Global ID による編集の適用をサポートするには、次の要件を満たす必要があります。
- フィーチャ レイヤー内のレイヤーには、一意のインデックスを持つ GlobalID 列が存在する必要があります。 これを行う最適な方法は、フィーチャ レイヤーを公開するときに同期を有効化することです。
- 複数ユーザーのジオデータベースを使用する場合、レイヤーではブランチ バージョニングを使用できますが、トラディショナル バージョニングは使用できません。 ブランチ バージョン対応のジオデータベースを使用する場合、Survey123 はデフォルト バージョンを対象にしています。 詳細については、「バージョニング タイプ」をご参照ください。
- フィーチャ レイヤーに M 対応レイヤーが含まれている場合、M 値なしの更新を有効にする必要があります。
- フィーチャ レイヤーまたはテーブルで添付ファイルを有効にする前に、フィーチャ レイヤーまたはテーブルに Global ID が存在する必要があります。
フィーチャ レイヤーでの編集のサポートの詳細については、ArcGIS REST API ドキュメントの「レイヤー (フィーチャ サービス)」で supportsApplyEditsWithGlobalIds をご参照ください。
添付ファイルの有効化
フィーチャ レイヤーで添付ファイルを有効にする場合、KEYWORD および EXIFINFO 列はデフォルトでスキーマに追加されません。 この列は、添付ファイルを正しいレコードに関連付けるために必要です。 添付ファイルを有効にしたら、アタッチメントのアップグレード ジオプロセシング ツールを実行して、キーワードを有効にします。
注意:
Survey123 でレコードを収集する前に、送信されるすべての添付ファイルがキーワードを保持するように KEYWORD および EXIFINFO 列を追加することをおすすめします。 添付ファイルが送信される前に KEYWORD および EXIFINFO 列が存在しない場合は、Update Attachment Keywords Python ノートブックを使用して添付ファイルを更新できます。
スキーマの変更
調査が既存のフィーチャ レイヤーから作成されると、対応するフィールドまたはドメインがフィーチャ レイヤーに追加された後でなければ、新しい質問と選択リストの値を調査に追加できません。 調査がフィーチャ レイヤー ビューから作成される場合、対応するフィールドまたはドメインが基になるフィーチャ レイヤーに追加され、フィーチャ レイヤー ビューに反映された後でなければ、新しい質問と選択リストを調査に追加できません。