データの選択

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

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

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

データの管理

アプリに追加したすべてのデータは、ビルダー ワークスペースの [データ] パネルにリストされます。 ここでアプリのデータを管理したり、データに接続されているウィジェット、その数、接続先のフィールド (該当する場合) などの関連情報を確認したりできます。

アプリへのデータの追加

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

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

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

注意:

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

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

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

注意:

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

データの削除

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

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

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

• Web マップ、Web シーン、サービス、およびグループ レイヤーでは、次の情報を表示できます。
  • [レイヤー] タブ - データ ソースに含まれるレイヤー。 レイヤーは 2 つのグループに分かれています。[使用中] には、ウィジェット設定で選択されているレイヤーが表示されます。[その他] には、ウィジェットにまだ接続されていないレイヤーが表示されます。 ウィジェットを構成する際、未使用のレイヤーを非表示にして、データの選択リストに表示されないようにすることができます。 レイヤー カードをクリックすると、詳細ウィンドウが開きます。
  • [ウィジェット] タブ - マップ、シーン、サービス、またはグループ レイヤー全体を使用するウィジェット。 データで指定したレイヤーのみを使用するウィジェットは、ここには表示されず、対応するレイヤーの下にリストされます。
• 単一のレイヤー (サブレイヤーが含まれないレイヤーも含む) の場合、次の設定オプションおよび情報があります。
  • [データ設定] - データのフィルター、並べ替えフィールド、およびレコードの制限を設定します。 この設定は、レイヤーのすべてのデータ ビューに影響します。
  • [更新設定] - 自動更新がオフになっている場合、アプリまたはビルダーを更新したときにのみデータが更新されます。 自動更新をオンにすると、データを更新し、特定の時間間隔に基づいて最新のフィーチャを取得することを許可します。 カスタムの時間間隔を設定したり、データを Web マップから取得している場合は、レイヤーの設定を適用したりすることができます。
  • [フィールド] タブ - ウィジェットで使用されるフィールド。
  • [ウィジェット] タブ - 設定でレイヤーを使用するウィジェット。
  • [データ ビュー] タブ - 接続されたウィジェットに表示される情報を制御するフィルターや並べ替え条件を追加し、サポートされているフィーチャ レイヤーおよびシーンのデータ ビューを作成します。
    • 異なるフィルター、並べ替えフィールド、およびレコードの制限を含む複数のデータ ビューを追加できます。 これらの設定はビュー内でのみ有効で、他のデータ ビューやソース データには影響しません。
    • 各レイヤーには、2 つの組み込みビューがあります。 [デフォルト] ビューには、データが表示されます。 [選択フィーチャ] ビューには、レイヤー内の選択したフィーチャのコレクションが表示されます。 選択したフィーチャの状態はすべてのビューで同期されます。
    • 選択フィーチャ ビューは、フィーチャをクリックしてその属性を表示するなど、操作の結果を表示するために使用できます。 選択が存在しない場合、デフォルトで属性名が代わりに表示されます。 これを回避するには、[選択が空の場合のビュー] オプションをオンにすると、選択フィーチャが存在しない場合にそのビュー内のフィーチャの情報を表示するようにビューを構成できます。 構成済みのビューのフィーチャが自動的には選択されないことに注意してください。
    • ウィジェットがリスト ウィジェットに追加され、同じデータ ビューに接続されている場合、動的コンテンツ設定で [自動入力] ビューが利用できます。 このビューには、リスト内の各アイテムに対して生成されるフィーチャが 1 つだけ含まれています。

    注意:

    データとそのビューは 1:M の関係にあり、片方向にのみ影響を与えます。 データ設定はすべてのビューに影響を与えますが、ビュー設定は互いのビューやデータに影響を与えることはありません。 データとそのビューの関係については、Wiki 記事「ビュー (SQL)」をご参照ください。

データの使用

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

注意:

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

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

データが選択され、そのデータにデータ ビューが含まれている場合は、ウィジェットがサポートするデータ ソースの数に応じて、ドロップダウン リストで 1 つまたは複数のビューを選択できます。 デフォルトで、[デフォルト] ビューが選択されています。 既存のビューを編集するか、ウィジェットに新しいビューを作成することもできます。 作成されたビューは、他のウィジェット設定で使用できます。

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

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

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

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

動的コンテンツ

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

属性

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

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

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

統計情報

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

結果には、数値フィールドの最大値、最小値、平均値、合計値、またはフィーチャ セットのフィーチャ数が含まれます。

条件式

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

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

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

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