データは、Experience Builder で作成するほとんどのアプリの中心的な要素です。 多くのウィジェットはデータに依存し、ビルダーは統一されたデータ管理機能を提供します。 同じデータを使用するウィジェットは、アプリ内で接続できます。 たとえば、複数のウィジェットでレコード選択を同期して、同じデータに接続しているウィジェットに同じフィルターを適用できます。
Experience Builder でアプリにデータを追加すると、そのデータはデータ ソース接続に固有のインスタンスになります。 これには、以下のようなメリットがあります。
- 元のデータ ソースに対する更新は、構築したアプリ内で同期されます。
- 同じデータ ソースを複数回追加できます。 Experience Builder では、接続が独立したデータになります。 ほとんどのデータ処理は、他のデータ処理 (フィルタリングや並べ替えなど) に影響しません。ただし、元のデータ ソースに対する更新 (フィーチャの編集や属性の更新など) は例外です。
データの管理
アプリに追加したすべてのデータは、ビルダー ワークスペースの [データ] パネルにリストされます。 ここでアプリのデータを管理したり、データに接続されているウィジェット、その数、接続先のフィールド (該当する場合) などの関連情報を確認したりできます。 [検索] ボックスを使用してリストをフィルタリングすると特定のデータ ソースを見つけることができます。 検索結果には、アプリに追加した Web マップと Web シーンのサブレイヤーが含まれます。
アプリへのデータの追加
アプリにデータを追加するとき、次のような Web マップ、Web シーン、および ArcGIS にコンテンツ アイテムとして格納されているレイヤーを選択できます。
- フィーチャ レイヤー - フィーチャ レイヤーは、建物、区画、都市、道路、地震の震源地など、類似したジオグラフィック フィーチャをグループ化したものです。 フィーチャには、ポイント、ライン、ポリゴン (エリア) があります。 フィーチャ レイヤーは、ベースマップの上部でデータを表示するのに最も適しています。
- フィーチャ レイヤーが関連付けられたシーン レイヤー - シーン レイヤーは、3D フィーチャ オブジェクトと Z 値 (標高値) のコレクションです。
- ポイント シーン レイヤー - 大量のポイント データ (数百万個のポイント) を表示できるように設計されているシーン レイヤー。
- 3D オブジェクト シーン レイヤー - 建物、樹木、都市のその他の要素など、主に 3D フィーチャを表示するときに使用されるシーン レイヤー。
- ビルディング シーン レイヤー - BIM (Building Information Modeling) データから作成された建物の 3D レンダリング。 ビルディング シーン レイヤーには次のサブレイヤーが含まれています。
- フル モデル - 建物のすべてのフィーチャが作業分野別にグループ化されています。 作業分野には、建築、電気、インフラストラクチャ、機械、配管、構造などがあります。 各分野はビルディング グループのサブレイヤーであり、屋根、壁、扉、空調ユニット、照明器具、柱、基礎などの建物フィーチャのビルディング コンポーネント サブレイヤーが含まれています。
- 概要 - 建物の外部シェルが表示されるビルディング コンポーネント サブレイヤー。
- フィーチャ サービス、シーン サービス、およびマップ サービス - サービスによって、フィーチャ、シーン、マップをサーバー上の他のユーザーが使用可能になります。
- フィーチャ コレクション (マップ メモおよびルート レイヤーを除く) - 機能が絞り込まれ、限定されているフィーチャ レイヤーのサブセット。
- イメージ レイヤー - ラスター データに基づいたマップのカートグラフィのコレクション。 ラスター データは、ピクセル (セル) のマトリックスで構成され、一般に、衛星や無人航空機システムなどのリモート センシング デバイスで取得した画像やその他の情報を格納するのに使用されます。
- タイル イメージ レイヤー - 1 つ以上の画像ファイルから生成されたイメージ レイヤー。 タイル イメージ レイヤーが複数の画像から作成された場合、画像が 1 つの画像にモザイク化されます。
- 標高レイヤー - タイル イメージ レイヤーの一種。 LERC (Limited Error Raster Compression) 形式でレンダリング済みのキャッシュ イメージ タイルのコレクションです。 LERC は、シングルバンドまたは標高データの圧縮形式です。 標高レイヤーは、シーンで地形をグローバルおよびローカルで表示するのに適しています。
- ダイナミック イメージ レイヤー - 1 つの画像または画像のコレクションから成るイメージ レイヤー。 タイル イメージ レイヤーとよく似ています。 ダイナミック イメージ レイヤーでは、ラスター関数テンプレートを使用して、解析をリアルタイムで実行できます。
- タイル イメージ レイヤー - 1 つ以上の画像ファイルから生成されたイメージ レイヤー。 タイル イメージ レイヤーが複数の画像から作成された場合、画像が 1 つの画像にモザイク化されます。
- 方向付き画像レイヤー - あらゆる角度から撮影した画像 (斜め、バブル、道路側など) および 360 度画像のコレクション。 方向付き画像は、モバイル カメラ、無人航空機システム、地表センサーなど、さまざまな光学カメラによって撮影された画像です。
これらのデータ ソースは、自身のコンテンツ、グループ、組織、パブリックに共有されているコンテンツ (ArcGIS Living Atlas of the World を含む) で参照および検索が可能です。 フィーチャ、画像、シーン、またはマップ サービスの URL から取得したレイヤーもサポートされています。 さらに、Web マップや Web シーンをアプリに追加するときは、そのサポートされているレイヤーをウィジェットのデータ ソースとして使用できます。
注意:
- Web マップや Web シーンをデータ ソースとして追加すると、ウィジェットはテーブル、マップ イメージ レイヤー、タイル レイヤー、グループ レイヤーなどのサポートされているレイヤーに接続することができます。 サポートされていないレイヤー タイプはウィジェット設定で使用できず、[データ] パネルの詳細タブに表示されません。
- Map Viewer Classic または Scene Viewer で開けない JSAPI 3.x で作成された Web マップおよび Web シーンは、データ ソースとして使用できません。 (これらのいずれかのアイテムを追加した場合、これらは選択できず、[データ] パネルにエラー カードとして表示されます)。
次の方法でマップにデータを追加できます。
- ウィジェットを追加する前に、[データ] パネルの [データの追加] ボタンをクリックして、アプリで使用されるデータを追加します。Experience Builder でサポートされているすべてのデータ タイプが [データの追加] ウィンドウにリストされます。
- ウィジェットを追加する前にデータを追加しない場合は、[データの選択] ウィンドウの下部にある [データの追加] をクリックすることで、ウィジェットの構成時にデータを追加できます。 ウィジェットでサポートされているデータ タイプのみを追加できます。 ウィジェットの構成時に追加したデータも [データ] パネルに表示され、他のウィジェットを構成するときに選択できます。
注意:
データを追加する際、サービス、グループ レイヤー、Web マップ、または Web シーンの一部のサブレイヤーを非表示にできます。 サービス、グループ、Web マップ、または Web シーンの詳細パネルで非表示にすることもできます。 ウィジェットを構成する際、非表示のレイヤーはデータの選択リストには表示されません。 未使用のレイヤーのみを非表示にすることができます。
データの削除
データ ソースは、[データ] パネルでアイテム カードの [削除] オプションを使用して削除できます。 データ ソースに含まれるデータも削除されます。 ここでデータを削除すると、ウィジェットの構成で使用できなくなります。 ウィジェットにすでに使用されているデータを削除すると、そのデータの情報がアプリに表示されなくなり、そのデータに接続されているすべてのウィジェットが影響を受けます。 データを削除するときに影響を受けるウィジェットを削除できます。または、後で他のデータを接続することで、ウィジェット設定を再構成できます。
データ詳細およびデータ ビュー
[データ] パネルには、アプリに追加したデータのアイテム名が付いたアイテム カードが表示されます。アイコン付きのラベルは、データ タイプを区別するのに役立ちます。 リンクをクリックして元のデータ ソースのアイテム ページを開くと、詳細情報を表示できます。 アイテム カードに表示される名前は、アプリとより関連性の高い名前に変更できます (ソース データは変更されません)。 各カードは、マップまたはシーン内にある関連するウィジェットとレイヤーの数を示します。 データ カードをクリックすると、ウィンドウにデータの詳細が表示されます。
- Web マップ、Web シーン、サービス、およびグループ レイヤーでは、次の情報を表示できます。
- [レイヤー] タブ - データ ソースに含まれるレイヤーがリストされます。 レイヤーは 2 つのグループに分かれています。[使用中] には、ウィジェット設定で選択されているレイヤーが表示されます。[その他] には、ウィジェットにまだ接続されていないレイヤーが表示されます。 ウィジェットを構成する際、未使用のレイヤーを非表示にして、データの選択リストに表示されないようにすることができます。 レイヤー カードをクリックすると、詳細ウィンドウが開きます。
- [ウィジェット] タブ - マップ、シーン、サービス、またはグループ レイヤー全体を使用するウィジェットがリストされます。 データで指定したレイヤーのみを使用するウィジェットは、ここには表示されず、対応するレイヤーの下にリストされます。
- 単一のレイヤー (サブレイヤーが含まれないレイヤーも含む) の場合、次の設定オプションおよび情報があります。
- [データ設定] - データのフィルター、並べ替えフィールド、およびレコードの制限を設定します。 このフィルター設定は、レイヤーのすべてのデータ ビューに影響します。
- [更新設定] - [自動更新] オプションがオフになっている場合、アプリまたはビルダーを更新したときにのみデータが更新されます。 [自動更新] をオンにすると、データを更新し、特定の時間間隔に基づいて最新のフィーチャを取得できます。 カスタムの時間間隔を設定したり、データを Web マップから取得している場合は、レイヤーの設定を使用したりすることができます。
- [エクスポートの許可] - データ アクションが有効になった接続済みウィジェットから、実行時にデータをエクスポートするためのオプションを提供します。
注意:
ホスト フィーチャ レイヤーでは、アプリはユーザーのロールとアイテムの設定で、データのエクスポートが許可されているかどうかも確認します。
- [関連] - フィーチャ レイヤーに関連データがある場合、リレーションシップがリレーションシップのタイプとともにここにリストされます。
- [データ ビュー] タブ - 接続されたウィジェットに表示される情報を制御するフィルター、並べ替えフィールド、レコードの制限を追加することで、サポートされているフィーチャ レイヤーおよびシーン レイヤーのデータ ビューを作成します。 これらの設定はビュー内でのみ有効で、他のデータ ビューやソース データには影響しません。
注意:
各レイヤーには、ウィジェットのデータ ソースの構成時に選択できる組み込みビューもあります。 デフォルト ビューには、すべてのフィーチャが含まれます。 選択フィーチャ ビューには、実行時に選択したフィーチャが含まれます。 自動入力ビューは、リスト ウィジェットの動的コンテンツ設定用に使用されます。
- [空の選択のビュー] - このチェックボックスをオンにして [設定] ボタンをクリックすると、選択フィーチャ ビューでフィーチャが選択されていない場合に表示するビューを構成します (構成済みのビューのフィーチャは、自動的に選択されません)。
- [フィールド] タブ - ウィジェットで使用されるフィールドがリストされます。
- [ウィジェット] タブ - 設定でレイヤーを使用するウィジェットがリストされます。
データの使用
アプリに追加したデータは、どのように追加したかに関係なく、そのアプリ内のすべてのサポートされているウィジェットで使用できます。 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 |
印刷 | フィーチャ レイヤー | 0 (レポートを接続しない場合)、1 または複数 (レポートを接続する場合) |
クエリ | フィーチャ レイヤー、シーン レイヤー、ダイナミック イメージ レイヤー、方向付き画像レイヤー | クエリごとに 1 |
検索 | フィーチャ レイヤー、シーン レイヤー、ダイナミック イメージ レイヤー、方向付き画像レイヤー | レイヤー ソースごとに 1 |
選択 | フィーチャ レイヤー、シーン レイヤー、ダイナミック イメージ レイヤー、方向付き画像レイヤー | 1 または複数 |
テーブル | フィーチャ レイヤー、シーン レイヤー、ダイナミック イメージ レイヤー、方向付き画像レイヤー | シートごとに 1 |
テキスト** | フィーチャ レイヤー、シーン レイヤー、ダイナミック イメージ レイヤー、方向付き画像レイヤー | 0 または複数 |
タイムライン *** | Web マップ、フィーチャ レイヤー、マップ サービス レイヤー、ダイナミック イメージ レイヤー、方向付き画像レイヤー | 1 または複数 |
*サポートされているアイテム タイプの特定のリストについては、「アプリへのデータの追加」をご参照ください。
**画像、テキスト、ボタン、および埋め込みのウィジェットは、デフォルトで静的です。 データからの情報を表示するには、[データに接続] 設定を有効にして、属性、統計情報、式を使用してパラメーターを指定します。 詳細については、「動的コンテンツ」をご参照ください。
*** タイムライン ウィジェットは、複数のフィーチャ レイヤーまたはマップ サービス レイヤーをサポートできますが、Web マップは一度に 1 つのみです。
出力データ
アプリに手動で追加するデータに加え、以下のウィジェットでは、独自のデータを処理し、表示した結果をもとに新しい出力データを生成できます。
| ソース ウィジェット | 出力データ タイプ | 出力データセット |
|---|---|---|
チャート | フィーチャ レイヤー | チャートの統計情報 |
ルート案内 | フィーチャ レイヤー | ストップ、ルート案内ポイント、ルート案内ライン、ルートごとに 1 |
標高断面 | フィーチャ レイヤー | プロファイルごとに 1 つ |
近隣検索 | フィーチャ レイヤー | [最近接] および [近接] 解析で構成されているレイヤーごとに 1 つ、[サマリー] 解析で構成されているレイヤーごとに 2 つ (統計サマリーに 1 つと解析内のすべてのフィーチャに 1 つ) |
クエリ | フィーチャ レイヤー | クエリごとに 1 |
検索 | フィーチャ レイヤー | ロケーター ソースごとに 1 |
現在地 (ベータ版) | フィーチャ レイヤー | 位置とパスに 1 つずつ |
ユーティリティ ネットワーク トレース | フィーチャ レイヤー | 結果エリア ポリゴンを含む 1 つのレイヤー |
これらのソース ウィジェットがアプリで構成されると、それらの出力データが、他のウィジェットを構成時に [データの選択] ウィンドウにリストされます。 出力は新しいデータ ソースとして作成されるため、出力データのフィルターと選択は、元のデータ ソースに影響しません。
注意:
その他のウィジェットにより出力データが使用されているウィジェットを削除すると、関連するウィジェットのリストを含む警告メッセージが表示されます。 関連ウィジェットを削除または保持し、別のデータ ソースを使用して後から再構成できます。
出力データのスキーマは、ソース ウィジェットによって定義されます。
- チャート - カテゴリ フィールド (構成されている場合) の属性を含む統計情報と、数値フィールドの計算結果です。ジオメトリは含まれません。
- クエリ - クエリ条件を満たすレコードのサブセットで、フィールドは [結果] 設定で構成されます。
- 検索 - 対応するロケーター ソースから取得した検索結果の住所
出力データの実際のレコードは、実行時にソース ウィジェットにより動的に生成されます。
データ ソースのビュー
ウィジェット設定でデータが選択されると、ウィジェットがサポートしているデータ ソースの数に応じて、ドロップダウン リストで 1 つ以上のビューを選択できます。 データ ソースには、次のビュー オプションがあります。
- [デフォルト] - データのすべてのフィーチャを含む組み込みビュー。
- [選択フィーチャ] - ユーザーが実行時に選択したフィーチャを含む組み込みビュー。 選択したフィーチャの状態はすべてのビューで同期されます。 このビューは、操作結果を表示するために使用されます。 たとえば、リスト ウィジェット向けに構成されている場合は、リストには選択したレコードのみが表示されます。また、リスト内のアイテムは、選択肢の変化に伴って動的に変わります。 選択肢がない場合、レコードが選択されるまで、リストにはデータがない旨を示すメッセージが表示されます。 [データ] パネルに、空の選択用のビューを作成することもできます。
- [自動入力] - ウィジェットがリスト ウィジェットに追加され、同じデータ ビューに接続されたときに動的コンテンツ設定で使用できる組み込みビュー。 このビューには、リスト内の各アイテムに対して生成されるフィーチャが 1 つだけ含まれています。
- データ ビュー - 異なるフィルター、並べ替えフィールド、レコードの制限で作成できる、フィーチャのサブセット。 データ ソースを複数のデータ ビューで事前処理すると、他のデータ ビューやソース データに影響を与えずに、ウィジェットに表示できるデータを制御できます。
注意:
出力データは、カスタム データ ビューの追加をサポートしていません。
注意:
[レコード] タブの [ページ サイズ] 設定はクエリのパフォーマンスと効率化の目的で使用されます。 改ページをサポートするウィジェット内の結果フィーチャの合計数に影響することはありません。 ページ サイズが結果よりも小さい場合、結果がすべて読み込まれるまで複数のリクエストが送信されます。
デフォルトで、デフォルト ビューが選択されています。 既存のビューを編集するか、ウィジェットに別のビューを作成することもできます。 ウィジェット構成パネルで作成されたビューは、他のウィジェット設定でも選択できます。
動的コンテンツ
一部のウィジェットには、接続されたデータ ソースから動的な情報を使用または表示できる設定があります。 たとえば、指定したフィーチャの属性値、特定の条件を満たしたフィーチャの統計結果、または静的な文字列、動的な値、計算が混在した式などがあります。
属性
指定したデータ ビューのフィーチャの属性値は、次のいずれかのビューを使用して取得します。
- ウィジェットのデータ ソース設定で設定したビュー。
- 元のデータ レイヤーの選択フィーチャ ビュー。 このビューでは、操作結果 (選択フィーチャの属性を表示するなど) を表示することができます。
- ウィジェットがリスト ウィジェット (テキスト、画像、ボタンなど) 内にあり、リスト ウィジェットと同じデータ ビューが含まれている場合の自動入力ビュー。 このビューには、リスト アイテムが表すフィーチャが 1 つだけ含まれます。
ビューに複数のフィーチャが含まれている場合、(データ ビューの並べ替え設定に基づいて) 最初のフィーチャの属性値が返されます。
統計
指定したデータ ビューで定義されたフィーチャ セットの統計結果を取得します。
結果には、数値フィールドの最大値、最小値、平均値、合計値、標準偏差、不連続パーセンタイル値、または連続パーセンタイル値、日付フィールドの最大値または最小値、フィーチャ セットのフィーチャ数 (一意の ID フィールドを使用) が含まれます。または、重複を除いたカウントをサービスがサポートする場合は、1 つのフィールドの個別値の数が含まれます。
統計エディターを使用し、統計情報にカスタム ラベルを指定します。 ラベルを設定するには、プレースホルダー テキストを置換します。プレースホルダー テキストはデフォルト ラベルとして使用され、指定した演算子とフィールドに基づいて変更されます。
不連続パーセンタイルと連続パーセンタイルには、パーセンタイル値を設定し、値の表示方法として昇順 ([ASC]) または降順 ([DESC]) を選択する必要があります。 パーセンタイル値は、0-100 のスケール上の値 n です。 昇順は、データセットの n 番目のパーセンタイルにある値はデータセット内の値の n% より大きいことを意味します。 降順は、データセットの n 番目のパーセンタイルにある値はデータセット内の値の n% より小さいことを意味します。
式
式エディターでは、テキスト (形式: “text”)、数値、フィールド変数 (形式: {field})、および [AVERAGE({field})]、[COUNT({field})]、[SUM({field})]、[MAX({field})]、[MIN({field})]、[STANDARD_DEVIATION({field})]、[PERCENTILE_DISCRETE({field},percentile value, order)]、[PERCENTILE_CONTINUOUS({field},percentile value, order)] などの関数を入力することができます。 各パートはプラス記号で連結されます。 式は、文字列の連結と数値計算の結果を返します。 たとえば、1 + 1 と入力すると 2 (数値) が返されますが、1 + "1" と入力すると “11” (文字列) が返されます。
入力する際、クリックして挿入できる候補が表示されます。 また、入力ボックスの下に表示されているフィールド名や関数名をクリックすると、フィールド変数や関数を挿入することができます。
[フィールド] タブのデータを使用して、フィールド変数が表すデータ ビューを設定することができます。 フィールド変数が式の独立したパートとして追加された場合、そのフィールドの属性値は、指定したデータ ビューの最初のフィーチャから返されます。
数値フィールド変数または日付フィールド変数を関数内で使用した場合 (例: AVERAGE({field}))、関数はそのフィールドのデータ ビューの統計結果を返します。 日付フィールドの場合、式の設定では COUNT、MAX、および MIN 関数のみがサポートされます。
[数値形式] ボタン 
をクリックするか、[数値形式] をオンにすることで、式の数値を書式設定できます。 小数点以下の表示桁数、桁区切り記号の有無、データの単位を追加するかどうかを指定できます。