Workiva サポートセンター

ステップ1：既存のクエリをコピーする

まず、パラメータ付きのクエリが必要です。既存のクエリのコピーを作成し、従業員数の合計を表示する国を決定するパラメータを追加します。

• Wdata ホームから、クエリCLP Employee Detail Query を探し、メニューを開く。
  • 選択コピー

• クエリ名称をCLP Employee Detail by Country Query に更新。

• クエリを保存 をクリックする。
• クエリ編集画面から、右端のパネルにあるParameters アイコンをクリックする。

• パラメータ追加 をクリックし、新規パラメータ作成を選択する。
  • パラメータ名称国名
  • ピックリストを有効化済に切り替え
  • リスト・オプション・ボックスで、以下の国をそれぞれ1行ずつリストアップする：
    • オーストラリア
    • ブラジル
    • イタリア
    • ケニア
    • 米国
  • デフォルトをなしに更新
  • [作成]をクリックする
• パラメータでクエリの結果をコントロールするには、フィルタを使用してパラメータをソースデータの列に接続する必要があります。クエリのフィルタータブにナビゲーション 
  • 左側のソースデータからCountry 列を探し、クリックして左側のフィルターエリアにドラッグする。
  • フィルター値に記入すべく、空文字列と書かれたところのフィルター値をクリック
    • フィルター値フィールドの右側にあるパラメータボタンをクリックします。
    • 国を選択
    • [適用] をクリックする

• • 国向けパラメータのあるクエリが手に入ります。クエリの実行をクリックして、クエリの結果を表示する国を尋ねられます。

• 保存をクリック

ステップ2：受信接続の作成

チェーンを使って接続を更新する方法を学ぶには、まずWdataクエリとスプレッドシートの間での接続を確立する必要があります。 

• CLP従業員概要スプレッドシートにナビゲーション
• をクリックして新規シートを追加
  • CLP国別従業員詳細の名称変更
• 国別シートでCLP従業員詳細に受信接続を追加：
  • 右側の接続アイコンをクリックし、接続パネル を開きます。
  • 受信接続タブで接続を追加を選択
    • 選択Wdata クエリ
    • CLP Employee Detail by Country クエリを選択します。
    • Country パラメータをオーストラリアに設定する。
    • 接続をクリックする。

• CLP従業員概要スプレッドシートに受信接続のシートが2枚あります

ステップ3：既存のチェーンを編集する

• チェーンビルダーに移動し、CLP｜Refresh Connection using ID を見つけてください。
• 鉛筆ボタンをクリックしてチェーンを編集する。
• 右上のチェーン設定 をクリックする。 
  • チェーンの名前の変更：CLP｜パラメータを指定して接続を更新する
• チェーンの保存

ステップ4：ランタイム入力

ランタイム入力コマンドを使ってチェーンをスタートさせる。これにより、チェーン実行時に更新したい接続と、値を更新したいパラメータを指定することができる。

• コマンドをダブルクリックして、ランタイム入力チェーンイベントを編集する。
• Add Inputボタンを2回クリックし、以下の入力を追加します：
  • 入力1：
    • 種別: テキストフィールド
    • 表示名パラメータ名
    • 必須チェックなし
  • インプット2：
    • 種別: テキストフィールド
    • 表示名パラメータ値
    • 必須チェックなし
• コマンドを保存する

ステップ5：接続の更新

追加されたParameterを考慮するために、Refresh Connections Commandを更新して、QueryにプッシュされるParameterとValueを考慮する必要があります。

• コマンドをダブルクリックして、Refresh Connectionを編集
  • 接続ID：Runtime InputのConnection ID 変数を引き続き使用する。
  • パラメータの追加
    • パラメータはソース（クエリ内）に保存されるため、ソースでパラメータを入力します。Source Parameters の横にある+ ボタンをクリックする。
    • パラメータ名：Runtime Inputs のParameter Name 変数を使用します。これにより、Chain 実行時に指定した Parameter Name の値を Refresh Connections Command にプッシュできます。
      • パラメータ名 フィールドをクリックする。
      • 左のパネルで、Triggerドロップダウンを展開します。
      • Runtime Inputs ドロップダウンを展開する。
      • パラメータ名 変数を選択する。
    • パラメータ値：Runtime InputsのParameter Value 変数を使用します。これにより、Chain実行時に指定されたパラメータ値をRefresh Connections Commandにプッシュすることができます。
      • パラメータ名 フィールドをクリックする。
      • 左のパネルで、Triggerドロップダウンを展開します。
      • Runtime Inputs ドロップダウンを展開する。
      • パラメータ値 変数を選択する。
• コマンドを保存する

ステップ6：エクササイズのテスト

チェーンが完成したので、結果をテストしてみよう。

• チェーンを更新
• Executeをクリックして、Run With Inputを選択
• 接続IDの検索
  • CLP従業員概要スプレッドシートにナビゲート
  • Connections パネルで、CLP Employee Detail by Country Query Connection を見つけ、上矢印をクリックします。ドロップダウンが表示されたら、View Properties を選択します。

• 接続IDをコピーします - 文字の入力忘れや無駄なスペースがないことを確認すること

• Chain Builderに戻り、Connection IDをConnection ID Runtime Inputに貼り付けます。
• パラメータを入力する
  • パラメータ名: クエリ内のパラメータ名 - この演習では、パラメータ名はCountry です。
  • パラメータ値: クエリがフィルタリングする必要のある値 - この演習では、ブラジルにフィルタリングします。
    • 注意：すでにスプレッドシートに保存されている値とは異なるパラメータ値を選択すると、スプレッドシートは上書きされ、データがオーストラリアからブラジルに変更されます。
• 開始をクリック
• チェーンが完了したら、スプレッドシートに戻り、接続が正常にリフレッシュされたことを確認する！

チェーン・ラン成功：

接続の更新に成功しました：

チェーンを使ってコネクションをリフレッシュする方法については、次のパスを実行してください：接続リストの更新 ！