データの選択—ArcGIS Experience Builder

データは、Experience Builder で作成するほとんどのアプリの中心的な要素です。多くのウィジェットはデータに依存し、ビルダーは統一されたデータ管理機能を提供します。同じデータを使用するウィジェットは、アプリ内で接続できます。たとえば、複数のウィジェットでレコード選択を同期して、同じデータに接続しているウィジェットに同じフィルターを適用できます。

Experience Builder でアプリにデータを追加すると、そのデータはデータソース接続に固有のインスタンスになります。これには、以下のようなメリットがあります。

元のデータソースに対する更新は、構築したアプリ内で同期されます。
同じデータソースを複数回追加できます。 Experience Builder では、接続が独立したデータになります。ほとんどのデータ処理は、他のデータ処理 (フィルタリングや並べ替えなど) に影響しません。ただし、元のデータソースに対する更新 (フィーチャの編集や属性の更新など) は例外です。

データの管理

アプリに追加したすべてのデータは、ビルダーワークスペースの [データ] パネルにリストされます。ここでアプリのデータを管理したり、データに接続されているウィジェット、その数、接続先のフィールド (該当する場合) などの関連情報を確認したりできます。 [検索] ボックスを使用してリストをフィルタリングすると特定のデータソースを見つけることができます。検索結果には、アプリに追加した Web マップと Web シーンのサブレイヤーが含まれます。

アプリへのデータの追加

アプリにデータを追加するとき、次のような Web マップ、Web シーン、および ArcGIS にコンテンツアイテムとして格納されているレイヤーを選択できます。

ホストフィーチャレイヤー
クエリをサポートしている 3D オブジェクトおよびポイントシーンレイヤー
フィーチャレイヤーが関連付けられたシーンレイヤー
フィーチャ、シーン、およびマップサービス
フィーチャコレクション (マップメモおよびルートレイヤーを除く)

これらのデータソースは、自身のコンテンツ、グループ、組織、パブリックに共有されているコンテンツ (ArcGIS Living Atlas of the World を含む) で参照および検索が可能です。フィーチャ、シーン、またはマップサービスの URL から取得したレイヤーもサポートされています。さらに、Web マップや Web シーンをアプリに追加するときは、そのサポートされているレイヤーをウィジェットのデータソースとして使用できます。

注意:

Web マップや Web シーンをデータソースとして追加すると、ウィジェットはテーブル、マップイメージレイヤー、タイルレイヤー、グループレイヤーなどのサポートされているレイヤーに接続することができます。サポートされていないレイヤータイプはウィジェット設定で使用できず、[データ] パネルの詳細タブに表示されません。
Map Viewer Classic または Scene Viewer で開けない JSAPI 3.x で作成された Web マップおよび Web シーンは、データソースとして使用できません (これらのいずれかのアイテムを追加した場合、これらは選択できず、[データ] パネルにエラーカードとして表示されます)。

次の 2 つの方法で、アプリにデータを追加できます。

ウィジェットを追加する前に、[データ] パネルの [データの追加] ボタンをクリックして、アプリで使用されるデータを追加します。Experience Builder でサポートされているすべてのデータタイプが [データの追加] ウィンドウにリストされます。
ウィジェットを追加する前にデータを追加しない場合は、[データの選択] ウィンドウの下部にある [データの追加] をクリックすることで、ウィジェットの構成時にデータを追加することもできます。ウィジェットでサポートされているデータタイプのみを追加できます。ウィジェットの構成時に追加したデータも [データ] パネルに表示され、他のウィジェットを構成するときに選択できます。

注意:

データを追加する際、サービス、グループレイヤー、Web マップ、または Web シーンの一部のサブレイヤーを非表示にすることができます。また、サービス、グループ、Web マップ、または Web シーンの詳細パネルで非表示にすることもできます。ウィジェットを構成する際、非表示のレイヤーはデータの選択リストには表示されません。未使用のレイヤーのみを非表示にすることができます。

データの削除

データソースは、[データ] パネルでアイテムカードの [削除] オプションを使用して削除できます。データソース内に含まれるデータも同様に削除されます。ここでデータを削除すると、ウィジェットの構成で使用できなくなります。ウィジェットにすでに使用されているデータを削除すると、そのデータの情報がアプリに表示されなくなり、そのデータに接続されているすべてのウィジェットが影響を受けます。データを削除するときに影響を受けるウィジェットを削除できます。または、後で他のデータを接続することで、ウィジェット設定を再構成できます。

データ詳細およびデータビュー

[データ] パネルには、アプリに追加したデータのアイテム名が付いたアイテムカードが表示されます。アイコン付きのラベルは、データタイプを区別するのに役立ちます。リンクをクリックして元のデータソースのアイテムページを開くと、詳細情報を表示できます。アイテムカードに表示される名前は、アプリとより関連性の高い名前に変更できます (ソースデータは変更されません)。各カードは、マップまたはシーン内にある関連するウィジェットとレイヤーの数を示します。データカードをクリックすると、ウィンドウにデータの詳細が表示されます。

Web マップ、Web シーン、サービス、およびグループレイヤーでは、次の情報を表示できます。
- [レイヤー] タブ - データソースに含まれるレイヤー。レイヤーは 2 つのグループに分かれています。[使用中] には、ウィジェット設定で選択されているレイヤーが表示されます。[その他] には、ウィジェットにまだ接続されていないレイヤーが表示されます。ウィジェットを構成する際、未使用のレイヤーを非表示にして、データの選択リストに表示されないようにすることができます。レイヤーカードをクリックすると、詳細ウィンドウが開きます。
- [ウィジェット] タブ - マップ、シーン、サービス、またはグループレイヤー全体を使用するウィジェット。データで指定したレイヤーのみを使用するウィジェットは、ここには表示されず、対応するレイヤーの下にリストされます。
単一のレイヤー (サブレイヤーが含まれないレイヤーも含む) の場合、次の設定オプションおよび情報があります。
- [データ設定] - データのフィルター、並べ替えフィールド、およびレコードの制限を設定します。このフィルター設定は、レイヤーのすべてのデータビューに影響します。
- [更新設定] - [自動更新] オプションがオフになっている場合、アプリまたはビルダーを更新したときにのみデータが更新されます。 [自動更新] をオンにすると、データを更新し、特定の時間間隔に基づいて最新のフィーチャを取得することを許可します。カスタムの時間間隔を設定したり、データを Web マップから取得している場合は、レイヤーの設定を適用したりすることができます。
- [エクスポートの許可] - データアクションが有効になった接続済みウィジェットから、実行時にデータをエクスポートするためのオプションを提供します。 (エクスポートは最大 5,000 レコードまで可能。)
  注意:
  ホストフィーチャレイヤーでは、アプリはエンドユーザーのロールとアイテムの設定で、データのエクスポートが許可されているかどうかも確認します。
- [データビュー] タブ - 接続されたウィジェットに表示される情報を制御するフィルター、並べ替えフィールド、レコードの制限を追加することで、サポートされているフィーチャレイヤーおよびシーンレイヤーのデータビューを作成します。これらの設定はビュー内でのみ有効で、他のデータビューやソースデータには影響しません。
  注意:
  各レイヤーには、ウィジェットのデータソースの構成時に選択できる組み込みビューもあります。 [デフォルト] ビューには、すべてのフィーチャが含まれます。 [選択フィーチャ] ビューには、実行時に選択したフィーチャが含まれます。 [自動入力] ビューは、リストウィジェットの動的コンテンツ設定用に使用されます。
  - [空の選択のビュー] - このチェックボックスをオンにして [設定] ボタンをクリックすると、[選択フィーチャ] ビューでフィーチャが選択されていない場合に表示するビューを構成します。 (構成済みのビューのフィーチャは、自動的に選択されません。)
- [フィールド] タブ - ウィジェットで使用されるフィールド。
- [ウィジェット] タブ - 設定でレイヤーを使用するウィジェット。

データの使用

アプリに追加したデータは、どのように追加したかに関係なく、そのアプリ内のすべてのサポートされているウィジェットで使用できます。 1 つのウィジェットで使用されているデータソースは、他のウィジェットでも使用できます。レコード選択は、アプリ全体で同期されます。さらに、デフォルトデータビューのフィルターは、データまたはそのビューを使用するすべてのウィジェットに影響を与えます。特定のデータビューのフィルターは、同じデータビューを使用するウィジェットにのみ影響します。

注意:

マップウィジェットで Web マップまたは Web シーンを表示すると、新しい Web マップまたは Web シーンビューが自動的に作成され、このビューは現在のウィジェットでのみ使用されます。このため、マップウィジェット内でのデータ処理は、同じデータソースまたはデータソースに含まれるレイヤーを使用しているウィジェットには影響しません。ただし、マップはデフォルトビューでのデータ処理の影響を受けます。

各ウィジェットの構成パネルには、データに接続するための標準設定が含まれています。 [データの選択] をクリックすると、ウィジェットがサポートするアプリに追加されたデータと出力されたデータをリストするウィンドウが表示されます (非表示のデータはリストされません)。リストからデータを選択したり、その他のデータをアプリに追加したりできます。[検索] ボックスを使用して、オプションのリストをフィルタリングできます。検索結果には、アプリに追加した Web マップと Web シーンのサブレイヤーが含まれます。一部のウィジェットは複数のデータソースをサポートしているので、リストで複数のアイテムを選択できます。ウィジェットが 1 つのデータソースのみに接続できる場合は、既存のデータカードをクリックして [データの選択] ウィンドウを開いて、選択を解除してから別のアイテムを選択できます。

以下の表は、データに接続できるウィジェットと、それぞれでサポートされているデータタイプを示しています。


ウィジェット	サポートされているデータタイプ*	サポートされているデータの数
ブランチバージョンの管理	フィーチャサービス、マップサービス (バージョン対応登録する必要があります)	1 または複数
ボタン**	フィーチャレイヤー、シーンレイヤー	0 または 1
チャート	フィーチャレイヤー、シーンレイヤー	1
編集	フィーチャレイヤー、シーンレイヤー (レイヤーは編集可能でなければなりません)	1 または複数
埋め込み**	フィーチャレイヤー、シーンレイヤー	0 または 1
フィーチャ情報	フィーチャレイヤー、シーンレイヤー	1
フィルター	フィーチャレイヤー、シーンレイヤー	フィルターごとに 1
画像**	フィーチャレイヤー、シーンレイヤー	0 または 1
リスト	フィーチャレイヤー、シーンレイヤー	1
マップ	Web マップ、Web シーン	1 または 2
マップレイヤー	Web マップ、Web シーン	0 または 1
クエリ	フィーチャレイヤー、シーンレイヤー	クエリごとに 1
検索	フィーチャレイヤー、シーンレイヤー	レイヤーソースごとに 1
テーブル	フィーチャレイヤー、シーンレイヤー	シートごとに 1
テキスト**	フィーチャレイヤー、シーンレイヤー	0 または複数

*サポートされているアイテムタイプの特定のリストについては、「アプリへのデータの追加」をご参照ください。

**画像、テキスト、ボタン、および埋め込みのウィジェットは、デフォルトで静的です。データからの情報を表示するには、[データに接続] 設定を有効にして、属性、統計情報、式を使用してパラメーターを指定します。詳細については、「動的コンテンツ」をご参照ください。

出力データ

アプリに手動で追加するデータに加え、以下のウィジェットでは、独自のデータを処理し、表示した結果をもとに新しい出力データを生成できます。


ソースウィジェット	出力データタイプ	出力データセット
チャート	フィーチャレイヤー	1
ルート案内	フィーチャレイヤー	ストップ、ルート案内ポイント、ルート案内ライン、ルートごとに 1
クエリ	フィーチャレイヤー	クエリごとに 1
検索	フィーチャレイヤー	ロケーターソースごとに 1

これらのソースウィジェットがアプリで構成されると、それらの出力データが、他のウィジェットを構成時に [データの選択] ウィンドウにリストされます。出力は新しいデータソースとして作成されるため、出力データのフィルターと選択は、元のデータソースに影響しません。

注意:

その他のウィジェットにより出力データが使用されているウィジェットを削除すると、関連するウィジェットのリストを含む警告メッセージが表示されます。削除または保持する関連ウィジェットを選択し、別のデータソースを使用して後から再構成できます。

出力データのスキーマは、ソースウィジェットによって定義されます。

チャート - カテゴリフィールド (構成されている場合) の属性を含む統計情報と、数値フィールドの計算結果です。ジオメトリは含まれません。
クエリ - クエリ条件を満たすレコードのサブセットで、フィールドは [結果] 設定で構成されます。
検索 - 対応するロケーターソースで見つかった検索結果の住所

出力データの実際のレコードは、実行時にソースウィジェットにより動的に生成されます。

データソースのビュー

ウィジェット設定でデータが選択されると、ウィジェットがサポートしているデータソースの数に応じて、ドロップダウンリストで 1 つ以上のビューを選択できます。データソースには、4 種類のビューがあります。

[デフォルト] は、データのすべてのフィーチャを含む組み込みビューです。
[選択フィーチャ] は、ユーザーが実行時に選択したフィーチャを含む組み込みビューです。選択したフィーチャの状態はすべてのビューで同期されます。このビューは、操作結果を表示するために使用されます。たとえば、リストウィジェット向けに構成されている場合は、リストには選択したレコードのみが表示されます。また、リスト内のアイテムは、選択肢の変化に伴って動的に変わります。選択肢がない場合、レコードが選択されるまで、リストにはデータがない旨を示すメッセージが表示されます。または、[データ] パネルに、空の選択用のビューを作成することもできます。
[自動入力] は、ウィジェットがリストウィジェットに追加され、同じデータビューに接続されたときに動的コンテンツ設定で使用できる組み込みビューです。このビューには、リスト内の各アイテムに対して生成されるフィーチャが 1 つだけ含まれています。
データビューとは、異なるフィルター、並べ替えフィールド、レコードの制限で作成できる、フィーチャのサブセットです。データソースを複数のデータビューで事前処理すると、他のデータビューやソースデータに影響を与えずに、ウィジェットに表示できるデータを制御できます。
注意:
出力データは、カスタムデータビューの追加をサポートしていません。
注意:
[レコード] タブの [ページサイズ] 設定はクエリのパフォーマンスと効率化の目的で使用されます。改ページをサポートするウィジェット内の結果フィーチャの合計数に影響することはありません。ページサイズが実際の結果よりも小さい場合、結果がすべて読み込まれるまで複数のリクエストが送信されます。

デフォルトで、[デフォルト] ビューが選択されています。また、既存のビューを編集するか、ウィジェットに別のビューを作成することもできます。ウィジェット構成パネルで作成されたビューは、他のウィジェット設定でも選択できます。

動的コンテンツ

一部のウィジェットには、接続されたデータソースから動的な情報を使用または表示できる設定があります。たとえば、指定したフィーチャの属性値、特定の条件を満たしたフィーチャの統計結果、または静的な文字列、動的な値、計算が混在した式などがあります。

属性

指定したデータビューのフィーチャの属性値は、次のいずれかのビューを使用して取得します。

ウィジェットのデータソース設定で設定したビュー。
元のデータレイヤーの [選択フィーチャ] ビュー。このビューでは、操作結果 (選択フィーチャの属性を表示するなど) を表示することができます。
ウィジェットがリストウィジェット (テキスト、画像、ボタンなど) 内にあり、リストと同じデータビューが含まれている場合の [自動入力] ビュー。このビューには、リストアイテムが表すフィーチャが 1 つだけ含まれます。

選択したビューに複数のフィーチャが含まれている場合、(データビューの並べ替え設定に基づいて) 最初のフィーチャの属性値が返されます。

統計

指定したデータビューで定義されたフィーチャセットの統計結果を取得します。

結果には、数値フィールドの最大値、最小値、平均値、合計値、またはフィーチャセットのフィーチャ数 (一意の ID フィールドを使用) が含まれます。または、重複を除いたカウントをサービスがサポートする場合は、1 つのフィールドの個別値の数が含まれます。

式

式のエディターでは、テキスト (形式: “text”)、数値、フィールド変数 (形式: {fieldname})、および AVERAGE({fieldname})、COUNT({fieldname})、SUM({fieldname})、MAX({fieldname})、MIN({fieldname}) などの関数を入力することができます。各パートはプラス記号 (+) で連結されます。式は、文字列の連結と数値計算の結果を返します。たとえば、1 + 1 と入力すると 2 (数値) が返されますが、1 + "1" と入力すると “11” (文字列) が返されます。

入力する際、クリックして挿入できる候補が表示されます。また、入力ボックスの下に表示されているフィールド名や関数名をクリックすると、フィールド変数や関数を挿入することができます。

[フィールド] タブにあるデータを使用して、フィールド変数が表すデータビューを設定することができます。フィールド変数が式の独立したパートとして追加された場合、そのフィールドの属性値は、指定したデータビューの最初のフィーチャから返されます。

数値フィールド変数を関数内で使用した場合 (例: AVG({fieldname}))、関数はそのフィールドのデータビューの統計結果を返します。

歯車アイコンをクリックするか、[数値形式] をオンにすることで、式の数値を書式設定できます。小数点以下の表示桁数、桁区切り記号の有無、データの単位を追加するかどうかを指定できます。

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