CLP - コントロール・シートの作成と読み取り – サポートセンター

コントロールシートを使用することは、1つのワークフローで使用される個別の変数を保存する最も効率的な方法です。コントロール・シートは、エンド・ユーザーがチェーン自体を編集することなく、チェーンの入力を指定することができる貴重なものです。コントロール・シートを使うには、まずコントロール・シートの構造化と、コントロール・シートからのデータの読み方を理解する必要がある。この接続ラーニングパスでは、コントロールシートを設定し、Workivaコマンドを使用してコントロールシートからデータを取得します。

プライマリビジネスユースケース	一元化された場所からのレポートワークフローのオーケストレーションエンドユーザーのワークフロー管理の簡素化
プライマリ学習目標	チェーンを使用してコントロールシートを構造化し、コントロールシートからデータを取得する方法を学ぶ。
前提条件	Workiva コネクターの構成 CLP の完了｜テーブル・パスへのデータ・アップロード CLP \| 接続リストの更新を完了します。関連する Workiva API Grant User にスプレッドシートの権限を付与する。
サポートテンプレート	CLP｜コントロールシートからの読み取り

ステップ1：コントロールシートの作成

私たちは、、Wdataテーブルにデータをアップロードし、そのデータの接続を更新するために使用される変数を格納するためのコントロールシートを作成します。チェーンが実行されるたびにRuntime Inputs としてこれらの変数を指定するのではなく、チェーンが実行中に読み込んで使用するコントロールシートに変数を追加します。

このコントロールシートは、1つのWdataテーブルに複数のファイルをアップロードし、1つのスプレッドシートで接続を更新することを示していますが、テーブルやスプレッドシートの固有IDをコントロールシートに追加するだけで、複数のテーブルやスプレッドシートを含むプロセスに拡張することができます。

Workiva プラットフォームに移動し、新規スプレッドシートを作成する。
Createをクリックし、Spreadsheetを選択
スプレッドシートの名称CLPコントロールシート
- 最初のシートの名称: プライマリ・コントロール・シート
プライマリ・コントロール・シートに、以下のヘッダーを作成する。
- アクティブフラグ
  - この列は、コントロールシートのその線に対してワークフローを実行する必要があるかどうかを指定します。
- ファイル名
  - この列は，Wdataテーブルに表示されるデータセットの名称を示す．
- テーブルID
  - データがアップロードされるWdataのテーブルID
- スプレッドシートID
  - データが更新されるスプレッドシートのID
- ファイルロケーション
  - ダウンロードされるファイルの場所
シートに以下の値を入力し、<TableID> 列に CLP 従業員詳細テーブルのIDを、<SpreadsheetID> 列に CLP 従業員概要スプレッドシートのID を記入します。これらの ID は以前の接続ラーニングパスで作成されたもので、必要な接続ラーニングパスについては前提条件を参照してください。
- ID検索のヘルプはこちらのドキュメントを参照。

ActiveFlag,FileName,TableID,FileLocation
TRUE,EmployeeDetailsP01,<TableID>,<SpreadsheetID>,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P01.csv
TRUE,EmployeeDetailsP02,<TableID>,<SpreadsheetID>,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P02.csv
TRUE,EmployeeDetailsP03,<TableID>,<SpreadsheetID>,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P03.csv

ステップ2：スプレッドシート権限の更新

Workiva コマンドとスプレッドシート間の効果的な通信を保証するために、生成されたAPI Grant は、スプレッドシートのオーナー権限または編集者権限を持つユーザーに関連付けられていなければなりません。

CLP コントロールシート スプレッドシートから、上部のリボンにあるファイル をクリックします。
権限をクリックし、次にスプレッドシートをクリックする。
- 構成された API Grant に関連付けられている Workiva ユーザーに、Workiva 接続内でアクセスします。

image (7).png

ステップ3：チェーンの作成

コントロール・シートで作成した変数を使用するために、そこから読み出すチェーンを作成します。常に同じスプレッドシートとシートを使用するので、一貫して使用するために、これらの詳細を格納するチェーン変数を設定します。

チェーンビルダーへのナビゲーション
新規作成チェーン
- チェーンの名称 CLP｜コントロールシートから読む
チェーン変数」でプラス記号を2回クリックして2つのチェーン変数を作成し、以下のように構成する：
- 変数1：
  - タイプ: チェーン変数（cv）
  - 名称：cv-コントロールスプレッドシートID
  - 値：CLP コントロールスプレッドシートのID を入力する。
    - スプレッドシートIDを検索するには、CLPコントロールシートスプレッドシートにナビゲーションしてください。
      - URLで、"spreadsheet/"の後、"/sheet"の前に見つかるスプレッドシートIDを選択します。
      - 例えば、スプレッドシート ID はここで太字になっています: app.wdesk.com/a/QWNjb3VudB8yMDkwNzExMDQ0/spreadsheet/6c4a23966c3c4a10a3178ae5791db7fd/-1/sheet/3161ee0402ec4b9fa4e937e6f0f63b13
- 変数2：
  - タイプ: チェーン変数（cv）
  - 名称：cv-コントロールシート名称
  - 値プライマリコントロールシート
チェーンの保存

ステップ4：シートデータの取得

シートデータ取得コマンドを使ってチェーンを開始する。これにより、コントロールシートから情報を取り出し、チェーンに供給することができる。

Get Sheet Data コマンドを追加Workiva コネクター からチェーン開始エリアへ。
コマンドをダブルクリックして構成する。
- スプレッドシートIDフィールドをクリック
  - Select a Variable パネルで、下矢印をクリックしてチェーンを展開する。
  - cv-Control Spreadsheet ID チェーン変数を選択する。
- シートID/名称フィールドをクリックする。
  - Select a Variable パネルで、下矢印をクリックしてチェーンを展開する。
  - cv-コントロールシート名チェーン変数を選択
- 地域：自由に地域を指定してください。もし": "のままであれば、コマンドはスプレッドシート全体のデータを取得します。
コマンドの保存

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

チェーンが完成したら、結果をテストする。

チェーンを更新
ExecuteをクリックしてRun Chainを選択します。
チェーンが正常終了したら、Get Sheet Data ノードをクリックし、成功を確認する。
- コマンドは、スプレッドシート内の指定されたシート内のデータの.csv出力を提供する必要があり、目玉アイコンをクリックして.csvを表示します。

コントロール・シートの使用に関する詳細は、次へお進みください：コントロールシートの値を使う！

サポート

コミュニティ

Workiva サポートセンター