クエリ ウィジェットで属性または空間フィルター クエリを実行することで、データ ソースから情報を取得できます。 クエリの結果によって、他のウィジェットでも使用できる出力データ ソースが生成されます。
例
このウィジェットを使用して、次のようなアプリの設計要件をサポートします。
- ユーザーが、クエリ式に基づいてフィーチャを検索できるようにします。
- ユーザーが、マップに図形を描画し、その図形と交差するフィーチャを返せるようにします。
- クエリの結果を使用し、他のウィジェット用に新しいフィーチャを作成します。
使用上の注意
クエリ ウィジェットでは、追加するクエリごとにデータ ソースを設定する必要があります。各クエリは単一のレイヤーで機能し、複数の属性と空間フィルターを定義できます。 複数のクエリを作成し、複数のデータ ソースからのレイヤーを使用することもできます。 クエリは、マップの有無に関係なく構成できます。 マップ ウィジェットのクエリから返されたフィーチャを表示するには、アクションを設定して自動的に表示するか、ユーザーがボタンをクリックできるようにするデータ アクションを使用します。 現在、シーン レイヤーを使用するには、代わりに [レコード選択の変更] トリガーを追加する必要があります。これによって、ユーザーはクエリ結果をクリックしてマップ上でハイライト表示できます。
設定
クエリ ウィジェットには次の設定があります。
- [新しいクエリ] - クエリを作成し、[クエリの設定] パネルで次の設定を指定します。
- [データ] - クエリするデータを選択します。 クエリごとに 1 つのデータ ソースのみ選択できます。 フィーチャ レイヤー、選択された Web マップと Web シーンに含まれるフィーチャ レイヤー、データ ビュー、出力データ ソース、およびフィーチャ サービスの URL がサポートされています。
- [ラベル] - 各クエリの名前をカスタマイズします。 ウィジェットにクエリが 1 つしかない場合は、縦の表示ラベルとアイコン配置スタイルをオフにできます。
- [アイコン] - ウィジェットに表示される各クエリのアイコンと、コンテンツ パネルのクエリ リストを選択します。 一般ギャラリーと矢印ギャラリーからアイコンを選択するか、ファイルからアイコンを追加できます。
注意:
次の画像形式をアップロードできます: PNG、GIF、JPG、JPEG、BMP。
- [属性フィルター] - 属性フィルター条件を指定する SQL 式を作成します。 これによって開く SQL 式ビルダーには、複雑な対話型クエリを作成するためのオプションがいくつか用意されています。
- [ラベル] - 属性フィルター セクションのラベルをカスタマイズします。
- [空間フィルター] - 使用可能とする空間フィルターを選択し、必要に応じてマップ ウィジェットを選択します。
- [ラベル] - 空間フィルター セクションのラベルをカスタマイズします。
- [現在のマップ範囲] - 現在のマップ範囲のすべてのフィーチャを返します。
- [対話的な描画モード] - マップ上に描画された図形と交差するフィーチャを返します。 描画ツールのオンとオフを切り替えることで、ウィジェットで使用できるツールを制御できます。
- [すべてのフィーチャを返す] - データ ソースのすべてのフィーチャを返します。
- 結果
- [ラベル] - 結果リストのラベルをカスタマイズします。
- [リストの方向] - クエリ結果を縦または横のリストで表示します。
- [フィールド] - レイヤーから表示するフィールドを指定します。
- [並べ替え] - 結果リストの並べ替え基準となるフィールドを構成します。
- [配置スタイル] - [縦]、[横]、または [アイコン] から選択して、1 つのウィジェット内でクエリのスタイルをカスタマイズします。
操作オプション
クエリ ウィジェットは、他のウィジェットでも使用できる出力データ ソースを生成します。 同じ出力データ ソースを使用して、追加ウィジェットを操作するには、アクションを追加します。 たとえば、マップはクエリ結果を自動的に表示し、フィーチャにズームできます。 クエリ ウィジェットの設定の [アクション] タブで、[作成されたレコード] トリガーを追加し、ターゲット マップを選択して、[マップ上に表示] と [ズーム] のアクションを追加します。
クエリ結果がリストに表示されます。 リストのアイテムを選択し、マップ上で対応するフィーチャを選択するには、クエリ ウィジェットに [レコード選択の変更] トリガーを追加します。 ターゲット フレームワークを選択し、[データ レコードの選択] アクションを追加して、マップのフィーチャ レイヤーと、トリガーとアクション データ間の接続をバインドするフィールドを構成します。 さらに、[ズーム] アクションを追加して、選択したフィーチャにマップをズームできます。