Wdataクエリのパラメータは、クエリをダイナミックにし、レポート期間を超えて使用できるようにするものである。この接続ラーニングパスでは、パラメータを追加してクエリを修正し、それをダイナミックにし、パラメータを考慮するためにチェーンを編集します。次に、クエリの結果をWorkivaスプレッドシートにエクスポートします。
| プライマリビジネスユースケース | Wdataに保存されたデータのレポート |
| プライマリ学習目標 | チェーンからのパラメータを使用したクエリの実行 |
| セカンダリ学習目標 | クエリ内のパラメータの作成 |
| 前提条件 |
CLP従業員詳細クエリのクエリIDを識別 オプション - 結果を書き込む既存のスプレッドシートのURLを識別します。 |
| サポートテンプレート | CLP｜パラメータを指定したクエリの実行 |
ステップ1: 既存のクエリの編集
まず、CLP従業員詳細クエリを編集してパラメータを追加します。どの国の総従業員数を表示するかを決定するパラメータを作成します。
- Wdataから、クエリCLP Employee Detail Queryを開いて編集
- 右端のパネルで、パラメータアイコンをクリックする。
-
パラメータ追加 をクリックし、新規パラメータ作成を選択する。
- パラメータ名称国名
- ピックリストを有効化済に切り替え
- リスト・オプション・ボックスで、以下の国をそれぞれ1行ずつリストアップする：
- オーストラリア
- ブラジル
- イタリア
- ケニア
- 米国
- デフォルトをなしに更新
- [作成]をクリックする
- パラメータでクエリの結果をコントロールするには、フィルタを使用してパラメータをソースデータの列に接続する必要があります。クエリのフィルタータブにナビゲーション
- 左側のソースデータからCountry 列を探し、クリックして左側のフィルターエリアにドラッグする。
- フィルター値に記入すべく、空文字列と書かれたところのフィルター値をクリック
- フィルター値フィールドの右側にあるパラメータボタンをクリックします。
- 国を選択
- 適用をクリック
-
- 国向けパラメータのあるクエリが手に入ります。クエリの実行をクリックして、クエリの結果を表示する国を尋ねられます。
- 保存をクリック
ステップ2：既存のチェーンを編集する
- チェーンビルダーに移動し、CLP｜クエリの実行と結果のエクスポートを選択します。
- 鉛筆ボタンをクリックしてチェーンを編集する。
- 右上のチェーン設定 をクリックする。
- チェーンの名前の変更：CLP｜クエリの実行とパラメータ指定
- チェーンの保存
ステップ3：ランタイム入力
ランタイム入力チェーン・イベントを使用してチェーンを開始する。これにより、実行するクエリのID、パラメータの値、結果を書き込む既存のスプレッドシートのURLの入力を求めることができます。スプレッドシートのURLフィールドはオプションで、空白のままだと新規スプレッドシートが作成される。
- コマンドをダブルクリックして、ランタイム入力チェーンイベントを編集する。
-
入力追加 ボタンをクリックし、以下を追加する：
- 種別: テキストフィールド
- 表示名称クエリパラメータ値
- 必須チェック済み
- オプションで、この新規入力をクエリID入力の後、スプレッドシートURL入力の前に表示されるようにドラッグ＆ドロップする。
- コマンドの保存
ステップ4：クエリの実行
最新のデータを取得するには、まずクエリを実行する必要がある。クエリが正常に実行されたら、クエリの結果をエクスポートして、線上のレポートに使用したり、他の外部システムに送信したりすることができます。クエリ実行コマンドを使ってWdataクエリを実行する。
- クエリ実行コマンドをダブルクリックして構成する。
-
パラメータ セクションのADD ボタンをクリックする。
- Nameフィールドに、クエリパラメータの名称を入力します。この場合、パラメータ名はCountryになる
- Type 」フィールドで、クエリ・パラメータ・タイプを選択します。この場合、パラメータ・タイプは「 Text」です。
-
Value フィールドをクリックする。
- 左の変数パネルで、下矢印をクリックしてトリガーを展開します。
- 下矢印をクリックしてRuntime Inputsを展開する。
- クエリパラメータ値 をクリックする。
- コマンドの保存
ステップ5：エクササイズのテスト中
チェーンが完成したら、結果をテストする。
- チェーンを更新
- ExecuteをクリックしてRun with Inputを選択
- ランタイム入力値の追加
- クエリ ID- Wdata における CLP 従業員詳細クエリの ID
- クエリパラメータ値 - クエリにフィルターをかけたい値。
- この例では、ブラジルにデータを絞っている。
- スプレッドシートのURL- クエリの結果をエクスポートするスプレッドシートの完全なURL。
- チェーンが正常に完了したら、スプレッドシートをビューして結果を確認する。
- チェーンは正常にクエリを実行し、結果をスプレッドシートにエクスポートしているはずです。
- シートの URL にナビゲーションして、データがスプレッドシートにエクスポートされ、フィルターが正しくかけられたことを確認できます。
チェーンを使ってデータ集中化を効率化する詳細は、データ収集パス の続きをご覧ください！