Workiva サポートセンター

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

必要となるもの

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

• コアWorkiva コネクター
• 中核となる表形式変換 コネクター

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

1. チェーンビルダー で、チェーン デバイスハブ タブから、チェーンの作成 をクリックします。
2. [セットアップ]で、チェーンとその目的を特定するのに役立つ一意の名前と説明を入力します。
3. 変数 で、スプレッドシートとクエリで使用する変数を追加する。

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

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

ステップ 2.シートデータ取得コマンドで開始する。

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

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

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

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

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

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

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

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

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

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

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