CLP - テーブルのデータを置換する – サポートセンター

データ管理をさらに合理化するには、同じチェーンにステップを組み合わせることができる。このConnected Learning Pathでは、Wdataテーブルのデータを置き換える最適な方法を説明します。

主なビジネス・ユースケース	テーブル管理
主な学習目標	チェーンを使ってWdataテーブルのデータを置き換える
前提条件	Workiva Connectorの設定 HTTPリクエストコネクタの設定 CLPの完了｜テーブル・パスへのデータのアップロード CLP 従業員詳細テーブルのT able ID を特定する。
テンプレート	CLP｜テーブルのデータを置換する

ステップ1：チェーンを走らせる

CLP | Upload Data to a Table Chain に移動する。
Execute をクリックし、Run With Input を選択する。
ランタイム入力の値を追加する
- テーブル ID - CLP 従業員詳細テーブルの ID
  - IDの見つけ方については、こちらの資料をご覧ください。
- ファイル名 - 任意のファイル名。この例では "Employee Detail "とする。
- ファイルの場所 -https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail.csv
Start をクリック
Chain が完了したら、Import File into Table ノードをクリックし、成功を確認する。
- 現在、CLP従業員詳細テーブルで利用可能なデータがあります。古いデータを削除し、新しいデータをアップロードするために1つのチェーンを使用して、更新されたデータセットに置き換えます。

ステップ2：チェーンを作る

新しいチェーンを追加する
- チェーンに名前を付けるCLP｜テーブルのデータを置換する
セーブ・ザ・チェーン

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

ランタイム入力コマンドを使ってチェインを開始する。これにより、ファイル名と、Chain実行時にインポートされるテーブルのIDを指定することができます。

チェーントリガーイベントからランタイム入力 コマンドを開始エリアに追加します。
コマンドをダブルクリックして、ランタイム入力チェーンイベントを編集する。
- 以下の3つの入力を追加する：
  - インプット1：
    - タイプテキストフィールド
    - 表示名テーブルID
    - 必須チェック済み
  - インプット2：
    - タイプテキストフィールド
    - 表示名ファイル名
    - 必須チェック済み
  - 入力 3：
    - タイプテキストフィールド
    - 表示名ファイルの場所
    - 必須チェック済み
コマンドを保存する

ステップ 4: ファイルのリスト

テーブル内の古いファイルを削除するには、ファイルIDが必要です。プログラムでFileIDを見つけるには、List Files Commandを使います。このコマンドは、テーブルIDを使用してテーブル内のすべてのファイルを検索し、ファイルの出力と、ファイルIDを含むそれらのファイルに関する情報を提供します。

List Files コマンドをチェーン・キャンバスに追加する。
ランタイム入力 チェーンイベントをリストファイルに接続 コマンド
コマンドをダブルクリックして設定する
- テーブルID フィールドをクリックする。
  - 左の変数パネルで、下矢印をクリックしてトリガーを展開する。
  - 下矢印をクリックして、Runtime Input を展開する。
  - SelectTableID
コマンドを保存する

ステップ5：テーブルからファイルのインポートを解除する

テーブルへのデータのアップロードと同様に、テーブルからのデータの削除は 2 つのステップで行います。ファイルを削除する前に、まずステージド・ステータスに移動する必要があります。ファイルをステージングに設定するには、アンインポートする必要がある。テーブルからファイルをインポート解除コマンドを使って、削除するデータセットを準備する。

Un-import File from Table コマンドをチェーン・キャンバスに追加。
List Files Command とUn-import File from Table Command を接続する。
コマンドをダブルクリックして設定する
- テーブルID フィールドをクリックする。
  - 左の変数パネルで、下矢印をクリックしてトリガーを展開する。
  - 下矢印をクリックして、Runtime Input を展開する。
  - SelectTableID
- ファイルID フィールドをクリックする。
  - 左の変数パネルで下矢印をクリックし、List Files を展開する。
  - 選択ファイルリスト
  - List Files - Files List変数をクリックして変数を変換する。
    - Select Transformation をクリックし、Get Value from JSON を選択する。
    - プラス記号をクリックして変数変換を追加する
      - Value フィールドに「0 」と入力し、エンターキーを押す。0が表示されたら、「id 」と入力し、もう一度エンターキーを押す。この変数は、List FilesコマンドからのJSON出力を読み込み、テーブル内の最初のファイルのIDを見つける。

ヒントJSON値のパース時には、大文字と小文字に特に注意すること。

- - - 受諾をクリックする
コマンドを保存する

ステップ 6: ファイルのダウンロード

次に、テーブルからステージングされたファイルを削除するか、アップロードする新しいファイルを準備する。データが正式に削除される前に、プロセスが成功したことを確認するために、古いファイルをアンインポートした後に新しいファイルをアップロードすることをお勧めします。アップロードする新しいファイルを準備するために、まずHTTPリクエストGetコマンドを使ってファイルをダウンロードしなければならない。私たちは、クラウドからファイルをダウンロードすることを実証するために、チェーンがダウンロードできるファイルをオンラインでホストしています。

HTTP Request コネクタからGet Command を Chain canvas に追加。
Un-import File from Table Command をGet Command に接続する。
コマンドをダブルクリックして設定する
- URL フィールドをクリックする。
  - 左側のSelect a Variable パネルで、下矢印をクリックしてTrigger を展開します。
  - 下矢印をクリックして、Runtime Input を展開する。
  - ファイルの場所を選択
- Content type フィールドを:application/csv に更新する。
コマンドを保存する

ステップ 7: ファイルの作成

Upload Data to Table Connected Learning Path で行ったのと同様に、Wdata Tables にデータをアップロードするための 2 つのステップに従います。最終的な使用のためにファイルをインポートする前に、まずStagedステータスでファイルを作成する必要があります。Create Fileコマンドを使用して、Wdataテーブル内のファイルをStagedステータス（作成済みだが、まだデータセットとしてインポートされていない状態）で作成する。

Create File Command fromWorkiva Connector をチェーンキャンバスに追加する。
Get コマンドをCreate File コマンドに接続する。
コマンドをダブルクリックして設定する
- テーブルID フィールドをクリックする。
  - 左側のSelect a Variable パネルで、下矢印をクリックしてTrigger を展開します。
  - 下矢印をクリックして、Runtime Input を展開する。
  - テーブルIDを選択
- Fileフィールドをクリックする。
  - 左側のSelect a Variable パネルで、下矢印をクリックして GET を展開する。
  - レスポンスを選択
- Name フィールドをクリックする。
  - 左側のSelect a Variable パネルで、下矢印をクリックしてTrigger を展開します。
  - 下矢印をクリックして、Runtime Input を展開する。
  - ファイル名を選択
  - 左側のSelect a Variableパネルで、下矢印をクリックして Runtime を展開します。
  - SelectChain.ExecutionDateTime
  - 2つの変数の後に ".csv" と入力する。
    - Chain.ExecutionDateTime変数を使用して、ファイルがいつ生成されたかを表示し、各ファイルが一意な名前を持つようにします。

ステップ8：ファイルをテーブルにインポートする

Wdataのテーブルにファイルをアップロードするプロセスの第二段階は、データをインポートし、クエリで使用できるようにすることです。このステップでは、ステージングされたファイルを指定されたテーブルにデータセットとしてインポートする。

Import File into Table Command fromWorkiva Connector to Chain canvas
Create File Command と Import File into Table Command を接続する。
コマンドをダブルクリックして設定する
- テーブルID フィールドをクリックする。
  - 左側のSelect a Variable パネルで、下矢印をクリックしてTrigger を展開します。
  - 下矢印をクリックして、Runtime Input を展開する。
  - テーブルIDを選択
- ファイルID フィールドをクリックする。
  - 左側のSelect a Variableパネルで、下矢印をクリックしてCreate File を展開します。
  - 選択結果
  - Create File - Result をクリックして変換する。
    - Select Transformation ドロップダウンで、Get Value from JSON を選択します。
    - +ボタンをクリック
    - Value フィールドにid と入力し、Enter を押す。
    - ACCEPT をクリックする。
コマンドを保存する

ステップ 9: ファイルの削除

新しいデータがアップロードされ、使用できるようになり、古いデータセットがステージングされたので、最後のステップは古いデータを正式に削除することである。このステップでは、Delete Fileコマンドを使用して、テーブルからデータセットを削除します。

Delete File Command fromWorkiva Connector を Chain canvas に追加。
Import File into Table Command とDelete File Command を接続する。
コマンドをダブルクリックして設定する
- インポートを解除したのと同じファイルを削除していることを確認するため、以下のように、テーブルからファイルをインポート解除コマンドで行ったのと同じ方法でファイルIDを生成します：
- ファイルID フィールドをクリックする。
  - 左の変数パネルで下矢印をクリックし、List Files を展開する。
  - 選択ファイルリスト
  - List Files - Files List変数をクリックして変数を変換する。
    - Select Transformation をクリックし、Get Value from JSON を選択する。
    - プラス記号をクリックして変数変換を追加する
      - Value フィールドに「0 」と入力し、エンターキーを押す。0が表示されたら、「id 」と入力し、もう一度エンターキーを押す。この変数は、List FilesコマンドからのJSON出力を読み込み、テーブル内の最初のファイルのIDを見つける。

ヒントJSONの値をパースする際には、大文字と小文字に特に注意する。

- - - 受諾をクリックする
コマンドを保存する

ステップ 10：エクササイズをテストする

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

Execute をクリックし、Run With Input を選択する。
ランタイム入力の値を追加する
- テーブル ID - CLP 従業員詳細テーブルの ID
  - IDの見つけ方については、こちらの資料をご覧ください。
- ファイル名 - 任意のファイル名。この例では "Employee Detail "とする。
- ファイルの場所 -https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_replace.csv
Start をクリック
- Chainは古いファイルを削除し、新しいファイルと置き換えてTableに格納する。
- Wdataのテーブルに移動し、右側のパネルのDatasetsを確認することで、テーブルのデータが置換されたことを確認できます。

データ収集の効率化のためのチェーンの使用についてさらに知りたい方は、Data Centralization Paths の他の部分をご覧ください！

ヘルプ

コミュニティ

ラーニングハブ

サポート

CLP - テーブルのデータを置換する