テーブル ウィジェットは、フィーチャ レイヤーと、フィーチャ レイヤーが関連付けられたシーン レイヤーの対話形式の属性テーブルを表示し、ユーザーがタブまたはリストからアクセスする複数のシートを含めることもできます。 テーブルに含めるフィールドを選択し、検索や選択などのツールを有効化できます。 ユーザーは 1 つまたは複数のフィールドで、昇順または降順でテーブルを並べ替えることができます。
例
このウィジェットを使用して、次のようなアプリの設計要件をサポートします。
- 属性テーブルを表示します。
- レコードの検索や並べ替え、属性の編集、マップ内の対応するフィーチャの選択など、ユーザーが操作できるテーブルを提供します。
使用上の注意
このウィジェットでは、テーブルのシートごとにデータ ソースを設定する必要があります。 テーブル ウィジェットは、フィーチャ レイヤーと、フィーチャ レイヤーが関連付けられたシーン レイヤーをサポートしています。 テーブル ウィジェットのアクションを設定して、マップ ウィジェットでマップ上で選択したフィーチャをズームしたり、リスト ウィジェット上の列をフィルター処理したりするなど、他のウィジェットを操作できます。 このウィジェットを使用すると、アプリにマップを含めずにフィーチャ属性を表示することもできます。
ヒント:
長い文字列が含まれているフィールドの場合、任意のセルにポインターを合わせると全体の値がツールチップに表示されます。 セル内の URL は [表示] ボタンに自動的に短縮されてライブ リンクになります。
注意:
このウィジェットは、サブタイプ グループ レイヤー内の個々のサブタイプ サブレイヤーをサポートしています。
検索方法
テーブル ウィジェットの検索ツールでは、検索候補と検索結果の取得に、異なる方法を使用します。
検索ツールでは、フルテキスト検索で検索候補を生成します。 フルテキスト検索は、レコードを小さい単位 (個々の単語など) に分割するフルテキスト フィールド インデックスを使用する効果的な検索方法です。 たとえば、米国の郵便局の位置を表すレイヤーに、すべての郵便局名を含む名前フィールドがあるとします。 このインデックスは、Highland Station Baltimore Post Office という名称を、検索可能な 5 つの単語 (「Highland」、「Station」、「Baltimore」、「Post」、「Office」) に分割します。 「Baltimore Office」、「Highland Baltimore」、「Stat Balt Office」など、これらの単語の任意の組み合わせ (または単語の冒頭部分のみの組み合わせ) で構成される検索語句を入力すると、検索候補にその郵便局が表示されます。
ホスト フィーチャ レイヤーの所有者か組織管理者である場合、フルテキスト フィールド インデックスをリスト ウィジェットかテーブル ウィジェットの検索フィールドとして選択すると、ホスト フィーチャ レイヤー向けに自動的に生成されます。 また、レイヤーのアイテムの詳細ページの属性フィールドにインデックスを手動で追加することもできます。 インデックスがないレイヤーがあり、レイヤーを編集する権限がない場合は、テーブル ウィジェットは代わりに START WITH abc% を使用して候補を検索します。つまり、ウィジェットは検索語句で開始するレコードを検索します。 これは効率性の低い検索方法です。
検索結果を取得するには、ウィジェットでは CONTAIN %abc% を使用します。つまり、検索語句はレコード内のどこに含まれていてもかまいません。 たとえば、「alt」を検索すると、Baltimore、Salt Lake City、Alton が検索結果に表示されます。
注意:
フルテキスト検索は 2023 年 10 月リリースの Experience Builder で追加された最新の変更点です。 このリリース以前のウィジェットでは、CONTAIN %abc% を使用して候補と結果の両方を取得していました。 CONTAIN %abc% クエリとは異なり、フルテキスト検索では、単語の中に含まれる検索語句は見つけられません。 上記の例では、「altimor」や「ighlan」を検索しても、想定される郵便局が検索候補に返されません。
設定
テーブル ウィジェットには次の設定があります。
- [ソース] - 次のいずれかの方法でデータをウィジェットに接続します。
- マップ ウィジェットの操作 - マップ ウィジェットからレイヤーをテーブルに取り込みます。 ドロップダウン メニューに、アプリのすべてのマップ ウィジェットが一覧表示されます。 テーブル ウィジェットは現在のページにある 1 つ目のマップに自動的に接続します。
- 接続されているマップ ウィジェット内のすべての Web マップまたは Web シーンがリストに表示されます。 [レイヤーの選択] ボタン
をクリックして [レイヤーの選択] パネルを開き、[レイヤーのカスタマイズ] をオンにすることができます。- [レイヤーのカスタマイズ] をオンにした場合、次の動作が適用されます。
- [レイヤーのカスタマイズ] をオフにした場合、次の動作が適用されます。
- 接続されているマップ ウィジェットのレイヤー表示設定が適用されます。 表示されているすべてのレイヤーがテーブルに表示されます。
- 空間データが含まれていないフィーチャ レイヤーがテーブルに必ず表示されます。
- 実行時にマップのレイヤーを追加または削除した場合、それらの変更がテーブルと同期します。
- マップ レイヤーのデフォルト設定を変更することはできません。
- [ツール] - 次のツールをオンにすることができます。
- [マップ範囲によるフィルター] - 現在のマップ範囲に基づいてテーブルをフィルターするツールをテーブル ウィジェットに追加します。 テーブル ウィジェットが初めて読み込まれるときにこのツールをデフォルトで有効化できます。
- 接続されているマップ ウィジェット内のすべての Web マップまたは Web シーンがリストに表示されます。 [レイヤーの選択] ボタン
- [レイヤーの選択] - 個々のレイヤーをテーブルに追加します。
- [新しいシート] - テーブルに新しいシートを追加します。 ([削除] ボタンをクリックしてテーブルからシートを削除します)。各シートの [シートの構成] パネルで以下の設定を行います。
- [データ] - ウィジェットに表示するフィーチャ レイヤーを選択します。 データ ビューの設定では、データをフィルターしてウィジェットに表示される情報を制限したり、データを並べ替えて特定の順序でフィーチャを表示したり、フィーチャの数を制限したりすることができます。
ヒント:
[データの選択] パネルで Web マップをクリックすることで、Web マップのすべてのレイヤーをテーブル ウィジェットに一度に追加できます。
- [最終更新のテキスト] - データの最終更新日を示すテキストを含めます。 この設定は、接続されたデータ ソースに対して自動更新が有効の場合のみ使用できます。
- [ラベル] - シートの名前を入力します。 この名前は、タブとしてウィジェットに表示されるか、シートのリストに表示されます。
- [フィールドの構成] - シートに表示されるフィールドの設定を構成します。
- [レイヤー設定の使用] - レイヤーのデフォルト設定を使用して、初期表示に表示されるフィールド、表示されるフィールド、編集可能なフィールドを決定します。
- [カスタマイズ] - シートに含めるフィールドを選択します。 (最初の 50 フィールドは自動的に選択されるので、必要に応じて、[選択の解除] ボタンを使用します)。選択したフィールドをドラッグして、フィールドの順序を変更します。 [表示] ボタンをクリックすると、ウィジェットが初めて読み込まれたときの列の表示/非表示が切り替わります (実行時に [列の表示/非表示] ツールを使用して表示設定を変更できます)。データ ソースが編集をサポートしている場合は、[編集の許可] チェックボックスをオンにして、データにアクセスできるユーザーがテーブルのセルをダブルクリックして属性を編集できるようにします。 編集可能なフィールドを選択できます。 編集できないフィールドの列ヘッダーには、鍵のアイコンが表示されます。
注意:
テーブル ウィジェットは添付ファイルをサポートしていません。
注意:
[エクスポート] データ アクションを使用して JSON、CSV、GeoJSON 形式にエクスポートした場合、表示対象として選択したフィールドだけがエクスポートに含まれます。
- [テーブル オプション] - テーブルの列とヘッダーに関連する設定を構成します。
- [列のサイズ設定] - テーブルの列のサイズをカスタマイズします。 列をデータに合わせることも、列の幅をピクセル ([px]) で指定することもできます。
- [ヘッダー オプション] - シート上部に表示されるヘッダー行をカスタマイズします。 ヘッダー テキストに太字の書式設定を適用したり、フォント色を変更したり、フォント サイズをピクセル単位 ([px]) で変更したりできます。 ヘッダーの背景色も選択できます。
- [ツール] - テーブルの操作に使用する実行時ツールをオンにします。
- [検索] - テーブル内のシートに検索ボックスを表示します。
- [検索フィールドの選択] - 検索するフィールドを 1 つ以上選択します。
- [完全一致] - 検索結果を検索語句に一致するレコードのみに限定します。
- [ヒント] - 検索ボックスに表示されるヒント テキストをカスタマイズします。
- [レコードの選択] - ユーザーがシート内のレコードを選択できるようにします。 このツールを有効化すると、[選択セットの表示] (シートを更新して選択されたアイテムのみを表示) と [選択の解除] がシートの [オプション] メニューに追加されます。
- [選択モード] - ユーザーがシート内の 1 つまたは複数のレコードを選択できるようにします。
- [レコード数の表示] - 合計レコード数と選択レコード数を表示します。
- [更新] - ユーザーがテーブルを更新して最新データを取得できるようにします。
- レコードの削除 - ユーザーが選択したレコードを削除できるようにします。 [レイヤー設定の使用] を選択した場合、レイヤーでレコードの削除が許可される場合にこの設定が表示されます。 [カスタマイズ] を選択した場合、[編集の許可] チェックボックスをオンにし、レイヤーでレコードの削除が許可される場合にこの設定が表示されます。
- [検索] - テーブル内のシートに検索ボックスを表示します。
- [データ] - ウィジェットに表示するフィーチャ レイヤーを選択します。 データ ビューの設定では、データをフィルターしてウィジェットに表示される情報を制限したり、データを並べ替えて特定の順序でフィーチャを表示したり、フィーチャの数を制限したりすることができます。
- [新しいシート] - テーブルに新しいシートを追加します。 ([削除] ボタンをクリックしてテーブルからシートを削除します)。各シートの [シートの構成] パネルで以下の設定を行います。
- マップ ウィジェットの操作 - マップ ウィジェットからレイヤーをテーブルに取り込みます。 ドロップダウン メニューに、アプリのすべてのマップ ウィジェットが一覧表示されます。 テーブル ウィジェットは現在のページにある 1 つ目のマップに自動的に接続します。
- [配置スタイル] - [タブ] または [ドロップダウン] から選択し、ユーザーによるテーブルのシート間の切り替え方法を指定します。
操作オプション
このウィジェットは、ウィジェットの設定の [アクション] タブで構成されるアクションをサポートしています。
メッセージ アクションは、ウィジェット間の対話機能を作成する場合に便利です。 たとえば、テーブル ウィジェットの [アクション] 設定で [レコード選択の変更] トリガーを追加し、マップ ウィジェットをターゲットとして設定して、[ズーム] メッセージ アクションを追加することで、ユーザーがテーブルでフィーチャを選択したときに、マップでそのフィーチャをズームできるようになります。
データ アクションをオンにすると、データ処理タスク (エクスポートやフィルタリングなど) を実行するためのボタンがウィジェットのユーザー インターフェイスに追加されます。 たとえば、[フィルターの設定] データ アクションをオンにすると、実行時に SQL 式でテーブル フィルターを設定できるようになります。
他のウィジェットの設定でオンにするテーブル関連のデータ アクションには、[テーブルでの表示] と [テーブルに追加] の 2 つがあります。 どちらも、別のウィジェットからテーブルにレコードを送信するためのものです。 違いは、対象となるレコードです。 [テーブルに追加] はデータ ソース レベルのアクションで、データ ソース全体のすべてのレコードをテーブル ウィジェットに送信します。 [テーブルに表示] はレコード レベルのデータ アクションで、選択レコード、現在のレコード、読み込まれたレコードにのみ影響します。
テーブル ウィジェットは [テーブルに表示] データ アクションでそのテーブル ウィジェット自体をターゲットにできます。 これは、いくつかのレコードを選択し、それらを同じテーブルの新しいシートに表示する場合などに便利です。
次の表に、使用できるウィジェットとデータ アクション、テーブル ウィジェット内に表示されるレコードを示します。
| テーブルに追加 | テーブルに表示 | |||
|---|---|---|---|---|
ソース ウィジェット | すべてのレコード | 選択レコード | 読み込まれたレコード | 現在のレコード |
データの追加 |  | |||
解析 | | |||
チャート | | | ||
フィーチャ情報 | | | ||
リスト | | | ||
マップ | | |||
マップ レイヤー | | |||
クエリ | | | | |
選択 | | |||
テーブル | | |||