チェーンテンプレート：スプレッドシートからパラメータ値を指定してクエリを実行する

このチェーンを使用すると、特定のエンティティや期間に焦点を当てるなど、スプレッドシートからクエリのパラメータ値を取得して、クエリを実行し、その結果を別のシートにエクスポートすることができます。

必要となるもの

このチェーンを作成するには、次が必要です。

• コアWorkiva コネクター
• コア表形式変換 コネクタ

ステップ1：チェーンを作成する

1. Chain Builder で、Chains device_hub タブから、Create chain をクリックします。
2. [セットアップ]で、チェーンとその目的を特定するのに役立つ一意の名前と説明を入力します。
3. Variables で、使用するスプレッドシートとクエリの変数を追加する。

   名称	値
   クエリーID	実行するクエリのIDを入力します。 ヒント： クエリーのURLでは、IDはqueries/ の後に表示される。
   スプレッドシート ID	クエリのパラメータとして取得する値を持つスプレッドシートの ID を入力します。 ヒント: スプレッドシートのURLでは、そのIDはspreadsheet/ の後に表示される。
   シート ID	クエリのパラメータとして取得する値を持つスプレッドシートのシート ID を入力します。 ヒント: スプレッドシートのURLでは、シートのIDはsheet/ の後に表示される。
   スプレッドシートのURL	クエリー結果を既存のスプレッドシートにエクスポートするには、その完全なURLを入力します。 注： チェーンがクエリの結果に基づいて常に新しいスプレッドシートを作成する場合、この変数は不要である。

4. [保存]をクリックします。

ステップ 2.シートデータ取得コマンドを実行します。

スプレッドシートのセルからクエリ・パラメータの値を取得するには、Get sheet data コマンドでチェインを開始する。

1. Available BizApps で、Workiva を選択し、Get sheet data をStart に移動する。
2. コマンドの編集 をクリックし、基本情報 に名前と説明を入力する。
3. Command properties で、Workiva コネクタを選択してコマンドを実行します。
   
4. スプレッドシート ID の場合、パラメータ値のスプレッドシート ID を持つチェーン変数を選択する。
5. Sheet Name/ID の場合、パラメータ値にシートIDを持つチェーン変数を選択する。
6. Region の場合、[column][row] の A1 表現に、値を取得するセルを入力する。
7. Value Style では、セルの生の値と計算値のどちらを取得するかを選択します。例えば、セルに1 + 1 が含まれている場合、明示的な数式には「生の値」を、2 の合計には「計算」を選択します。
8. Revision には、値を取得するスプレッドシートのリビジョンを入力する。現在のバージョンについては、-1 と入力してください。
9. [保存]をクリックします。

ステップ3.値の抽出コマンドを追加する

クエリ・パラメータでスプレッドシートから取得した値を使用するには、Extract value コマンドを追加する。

1. Available BizApps の下で、Tabular Transformation を選択し、Extract value をキャンバスに移動します。
2. Start からExtract value へリンクをドラッグし、Edit for command をクリックする。
3. 基本情報 の下に、コマンドを識別するのに役立つ名前と説明を入力する。
4. Command properties で、Tabular Transformation コネクタを選択してコマンドを実行します。
5. 入力ファイル の場合、データシート データを取得 コマンドの出力 を選択します。
   
6. シート・データの取得 コマンドは1つのセルの値だけを取得するので、列インデックス 、デリミター 、行インデックス は、それぞれのデフォルト値である0、カンマ、1のままにしておきます。
7. [保存]をクリックします。

ステップ4.クエリ実行コマンドを追加する

取得した値をパラメータとして適用してクエリを実行するには、Run query コマンドを追加します。

1. Available BizApps の下で、Workiva を選択し、Run query をキャンバスに移動します。
2. Extract value からRun query へリンクをドラッグし、後者についてはEdit をクリックする。
3. 基本情報 の下に、コマンドを識別するのに役立つ名前と説明を入力する。
4. コマンド・プロパティ の下で、シート・データの取得 と同じWorkiva コネクタを選択する。
5. クエリーID 、クエリーIDのチェーン変数を選択する。
6. Parameters の下で、Add をクリックし、スプレッドシートの値をクエリのパラメータに適用します：
   • キー に、値を使用するパラメータ名を入力する。
   • Value で、 Value Extract value コマンドの出力を選択します。
7. [保存]をクリックします。

ステップ5.クエリ結果のエクスポートコマンドを追加する

クエリの結果をスプレッドシートにエクスポートするには、Export query result コマンドを追加します。

1. Available BizApps の下で、Workiva を選択し、Run query をキャンバスに移動します。
2. Run query からExport query result へリンクをドラッグし、後者についてはEdit をクリックする。
3. 基本情報 の下に、コマンドを識別するのに役立つ名前と説明を入力する。
4. コマンド・プロパティ の下で、シート・データの取得 と同じWorkiva コネクタを選択する。
   
5. クエリ結果ID の場合、Run query コマンドのクエリ結果 出力からID を選択する。
6. Spreadsheet URL の場合、結果を新しいスプレッドシートにエクスポートするか、既存のスプレッドシートにエクスポートするかを指定する：
   • 新しいスプレッドシートにエクスポートするには、Spreadsheet URL を空白のままにします。
   • 既存のスプレッドシートにエクスポートするには、スプレッドシートのURLにチェーン変数を選択します。
7. Save とPublish をクリックする。