CLP - コントロール・シートの値を使う – サポートセンター

チェーンワークフローのためにコントロールシートの値を活用するには、コマンドでこれらの値を体系的に読み取り、適用する必要があります。この接続ラーニングパスでは、コントロールシートから値を読み込んで使用する方法と、複数の行を効率的にイテレータ処理するためにコマンドグループを使用する方法を探ります。

プライマリビジネスユースケース	一元化された場所からのレポートワークフローのオーケストレーションエンドユーザーのワークフロー管理の簡素化
プライマリ学習目標	コントロール・シートの値をチェーンで使用する方法を学ぶ。
セカンダリ学習目標	条件付きコマンド、JSONイテレータ、Handlebarsコネクタの使用方法について説明します。
前提条件	CLPの完了｜コントロールシートの作成と読み方以下のコネクターを構成する： - JSON ハンドルバー
サポートテンプレート	CLP｜コントロールシートの値を使う

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

チェーンビルダーに移動し、チェーン（CLP｜コントロールシートからの読み取り）を探す。
鉛筆ボタンをクリックしてチェーンを編集する。
右上のチェーン設定 をクリックする。
- チェーンの名前の変更：CLP｜コントロールシートの値を使う
チェーンの保存

ステップ2：コントロールシートをJSONに変換する

コントロールシートの値を効果的に利用するために、シートデータの取得 コマンドの出力をCSV書式からJSONに変換する。この変換は、コントロールシートのヘッダーと、各ヘッダーの下の行の対応する値との間にキーと値のペアを確立し、効率的な反復を実現します。

CSV to JSON コマンドをJSON コネクター からチェーンキャンバスに追加。
シートデータ取得 コマンドとCSV to JSON コマンドを接続する。
コマンドをダブルクリックして構成する。
- コマンドの名称コントロールシートをJSONに変換する
- 入力ファイル フィールドをクリックする。
  - Select a Variableパネル内で、下矢印をクリックし、Get Sheet Dataを展開します。
  - データ出力を選択する
- デリミター（区切り文字）フィールドはカンマ(,)のままにしておく
- コマンドの保存

ステップ3：コマンドグループの追加

コマンドグループをチェーンに追加し、コントロールシートの各行に対するイテレータを有効にする。これによって、コントロール・シートの各行を、グループの一連のコマンドを通してプッシュすることができる。

コマンドグループ をチェーンキャンバスに追加する。
Convert Control Sheet to JSON コマンドをコマンドグループのIn セクションに接続する。
コマンドグループをダブルクリックして構成する。
- グループの名称コントロールシートイテレータ
- 反復タブにナビゲーション
  - 反復トグルを有効にし、反復フィールド
    をクリック
    - Select a Variableパネル内で、下矢印をクリックしてConvert Control Sheet to JSONを展開します。
    - JSON出力の選択
- コマンドの保存

コマンドが構成されたので、コントロール・シートの各行を繰り返し、各行の出力を提供する。

ステップ4：条件コマンドの追加

コントロールシート内で、ユーザーはワークフロー内で特定の行を実行するかどうかを決定することができます。これは、ActiveFlag 列を介して活用される。条件コマンドを使用し、コントロールシートの各行に対してワークフローを継続するかどうかを決定する。

条件コマンド チェーンイベントをチェーンキャンバスに追加する。
グループスタート コントロールシート内のイテレータ グループと条件付き コマンドを接続する。
コマンドをダブルクリックして構成する。
- コマンドの名称：アクティブフラッグ？
- 条件を「AND 」のままにして、「+ RULE 」ボタンをクリックする。
- データタイプがString に設定されていることを再度確認し、テストするオペレーションをIs Blank から= に変更する。
- コマンドの左側の開いているフィールド（テストする値）をクリックする。
  - Select a Variable パネルから、下矢印をクリックしてGroup Iterator を展開する。
  - <> JSONファイル反復を選択
  - 緑色の JSON File Iteration ピルをクリックして、Variable を変換/トランスフォーメーションします。
    - Select a Transformationをクリックし、 Get Value from JSONを選択する。
    - 緑の + 記号を押す。
    - 値フィールドに、ActiveFlag ヘッダーをコントロールシートと同じようにタイプし、Enterを押す。
    - 別の変換/トランスフォーメーションを選択し、小文字を選択する。
    - 緑の + 記号を押す。
    - 承認をクリック

- 条件付き コマンドに戻り、右側（比較する値）にtrue とタイプする。
  - 先に適用した変数変換/トランスフォーメーションにより、アクティブ・フラグの値はすべて小文字になるため、小文字であることを確認する。
コマンドの保存

ステップ5：出力をコマンドに送る

この時点で、コントロールシートのイテレータは、コマンドグループのグループスタートに存在するコマンドに値を提供するようにセットアップされる。取得した値を表示するプレースホルダーとしてハンドルバーズ・コマンドを活用します。これは、下流のコマンドでイテレータとして使用することもできます。

Render Text Template コマンドをハンドルバー コネクターからチェーンキャンバスに追加する。
アクティブフラグを接続しますか？Render Text Templateコマンドへのコマンド。
コマンドをダブルクリックして構成する。
- コマンドの名称コントロールシート値の取得
- テンプレート フィールドに、以下の情報をタイプ入力する：
  - 上段コントロールシート情報
  - 2列目: ファイル名：<JSONファイル反復>
    - Select a Variableパネルから<JSONファイル反復>を置換し、下矢印をクリックしてGroup Iteratorを展開します。
    - <> JSONファイル反復を選択

- - - 緑色の JSON File Iteration ピルをクリックして、Variable を変換/トランスフォーメーションします。
      - Select a Transformationをクリックし、 Get Value from JSONを選択する。
      - 緑の + 記号を押す。
      - 値フィールドに「FileName」とコントロールシートと同じようにタイプし、Enterを押す。
      - 承認をクリック

- 行目、4行目、5行目のステップを繰り返し
  - <JSONファイル反復>のプレースホルダーをコントロール・シートの変数に置換します。
    - テーブル ID：<JSONファイル反復>
      - 前と同じステップを踏むが、FileName の代わりに、TableID を使用する。
    - スプレッドシート ID：<JSONファイル反復>
      - 前と同じステップを踏むが、ファイル名 の代わりに、SpreadsheetIDを使用する。
    - ファイルの場所：<JSONファイル反復>
      - 前と同じステップを踏みますが、FileNameの代わりにFileLocationを使います。
コマンドの保存

メモ: コントロールシートからヘッダーを抽出し、対応する行の値を取り出すには、アウトラインのステップに従ってください。

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

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

チェーンを更新
ExecuteをクリックしてRun Chainを選択します。
チェーンが正常終了したら、Capture Control Sheet Valuesコマンドをクリックし、成功を確認する。
- チェーンを完全に完了させてからコマンドをクリックする。
Value 1と書かれたフィールドがある。
- このフィールドをクリックすると、コマンドが3つの異なる値を処理したことが表示されます。これら値は、制御シートからのデータ列3つです。
各値のログフィールドをクリックし、コントロールシート内の値と一致していることを確認する。