|
クラシックファイルタイプは 2021 年 1 月をもって使用できなくなりました。クラシックファイルを移行することも、PDF をダウンロードすることもできます。詳細はこちら

Workiva サポートセンター

CLP - テーブルのデータ置換

CLP - テーブルのデータ置換

  • 最終更新日

データ管理をさらに合理化するには、ステップを同じチェーンに結合すればよい。この接続ラーニングパスでは、チェーンを使った2ステップのプロセスである、Wdataテーブルのデータを置換する最適な方法を説明します。

プライマリビジネスユースケース テーブル管理
プライマリ学習目標 チェーンを使用したWdataテーブルのデータ置換
前提条件 Workiva コネクタの構成
HTTP リクエストコネクタの構成
完了CLP - テーブルへのデータアップロード パス
CLP 従業員詳細テーブルのテーブル ID を識別子として特定します。
サポートテンプレート CLP - テーブルのデータ置換

ステップ1：チェーン実行

  1. CLP | Upload Data to a Table チェーンに移動します。
  2. Execute をクリックし、Run With Inputs を選択します。
  3. Runtime Inputs に値を入力します：
  4. Start をクリックします。
  5. チェーンが正常終了したら、Import File into Table ノードをクリックして成功を確認します。
    現在、CLP従業員詳細テーブルで利用可能なデータがあります。これを更新されたデータセットに置換し、古いデータの削除と新規データのアップロードを1つのチェーンで行います。

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

  1. 新規チェーンの追加.
  2. チェーンの名称：CLP｜Replace Data in a Table.
  3. チェーンを保存します。

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

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

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

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

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

  1. List Filesコマンドをチェーンキャンバスに追加
  2. Runtime Inputs Chain Event をList Files Command に接続します。
  3. コマンドをダブルクリックして構成します。テーブルID フィールドをクリックします。
  4. 左側のVariables パネルで、下矢印をクリックしてTrigger を展開します。
    1. 下矢印をクリックして、Runtime Inputs を展開します。
    2. TableID を選択します。
  5. コマンドを保存する。

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

テーブルへのデータのアップロードと同様に、テーブルからのデータの削除は2ステップのプロセスです。ファイルを削除できるようにするには、まずステージング・ステータスにファイルを移動完了する必要があります。ファイルをステージングに設定するには、Wdataをアンインポートする必要があります。Un-Import File from Table Commandを使って、削除するデータセットを準備します。

  1. Un-import File from Table Command をチェーン キャンバスに追加します。
  2. List Files Command をUn-import File from Table Command に接続します。
  3. コマンドをダブルクリックして構成します。
    1. テーブル ID フィールドをクリックします。
      1. 左側のVariables パネルで、下矢印をクリックしてTrigger を展開します。
      2. 下矢印をクリックして、Runtime Inputs を展開します。
      3. TableID を選択します。
    2. ファイル ID フィールドをクリックします。
      1. 左側の変数パネルで、下矢印をクリックしてList Files を展開します。
      2. Files List を選択します。
      3. List Files - Files List 変数 をクリックして変数を変換します。
        1. Select Transformation をクリックし、Get Value from JSON を選択します。
        2. プラス記号をクリックして、変数変換/トランスフォーメーションを追加します。
        3. 値フィールドに '0' とタイプし、Enter を押します。
        4. =0 が表示されたら、'id' とタイプし、Enter を再度押します。
          この変数は、List FilesコマンドからのJSON出力を読み込み、テーブル内の最初のファイルのIDを検索する。
          ヒントJSON値を解析するときは、大文字と小文字に特に注意してください。
        5. [承認]をクリックします。
    3. コマンドを保存します。

     

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

    次へ、テーブルからステージングファイルを削除するか、アップロードする新規ファイルを準備します。データが正式に削除される前にプロセスが正常であることを確認するため、古いファイルをアンインポートした後に新規ファイルをアップロードすることをお勧めします。

    アップロード用に新規ファイルを準備するには、まず HTTPRequest Get Command を使用してファイルをダウンロードする必要があります。チェーンがクラウドからファイルをダウンロードするのを実演すべく、オンラインでファイルをホスティングしてダウンロードできるようにしました。

    1. HTTP Request コネクタからGet Command をチェーン キャンバスに追加します。
    2. Un-import File from Table Command をGet Command に接続します。
    3. コマンドをダブルクリックして構成します。
      1. URL フィールドをクリックします。
        1. 左側のSelect a Variable パネルで、下矢印をクリックしてTrigger を展開します。
        2. 下矢印をクリックして、Runtime Inputs を展開します。
        3. File Location（ファイルの場所）を選択します。
      2. [コンテンツ タイプ] フィールドを次のように更新します:application/csv。
    4. コマンドを保存します。

    ステップ7：ファイル作成

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

    1. Workiva Connector からCreate File Command をチェーンキャンバスに追加します。
    2. Get Command をCreate File Command に接続します。
    3. コマンドをダブルクリックして構成します。
      1. テーブル ID フィールドをクリックします。
        1. 左側のSelect a Variable パネルで、下矢印をクリックしてTrigger を展開します。
        2. 下矢印をクリックして、Runtime Inputs を展開します。
        3. テーブル ID を選択します。
      2. ファイルフィールドをクリックします。
        1. 左側のSelect a Variable パネルで、下矢印をクリックして GET を展開します。
        2. Response を選択します。
      3. 名称 フィールドをクリックします。
        1. 左側のSelect a Variableパネルで、下矢印をクリックしてTrigger を展開します。
        2. 下矢印をクリックして、Runtime Inputs を展開します。
        3. File Name を選択します。
        4. 左側のSelect a Variableパネルで、下矢印をクリックして Runtime を展開します。
        5. Chain.ExecutionDateTime を選択します。
        6. 2 つの変数の後に ".csv" とタイプします。
          Chain.ExecutionDateTime 変数は、ファイルがいつ生成されたかを表示し、各ファイルの名称が一意であることを保証するために使用されます。

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

    Wdata テーブルへのファイルアップロードプロセスの次へのステップは、データをインポートし、クエリで使用 可能にすることです。このステップでは、ステージングされたファイルをデータセットとして指定のテーブルにインポートします。

    1. Workiva Connector から Import File into Table Command をチェーンキャンバスに追加します。
    2. Create File Command を Import File into Table Command に接続します。
    3. コマンドをダブルクリックして構成します。
      • テーブル ID フィールドの場合：
        1. 左側の Select a Variableパネルで、下矢印をクリックしてTrigger を展開します。
        2. 下矢印をクリックして、Runtime Inputs を展開します。
        3. テーブル ID を選択します。
      • ファイル ID フィールドの場合。
        1. 左側のSelect a Variableパネルで、下矢印をクリックしてCreate File を展開します。
        2. 結果 を選択します。
        3. Create File - Result をクリックして変換/トランスフォーメーションします。
          1. Select Transformation ドロップダウンで、Get Value from JSON を選択します。
          2. プラス）ボタンをクリックします。
          3. 値フィールドに「id」 とタイプし、を押します。 を入力します。
          4. ACCEPT をクリックします。
    4. 保存 コマンド

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

    新規データがアップロードされ、使用可能な状態になり、古いデータセットがステージングされたので、最終ステップは古いデータを正式に削除することである。このステップでは、削除ファイル コマンドを使用して、テーブルからデータセットを削除します。

    1. 削除ファイルコマンドをWorkiva Connectorからチェーンキャンバスに追加
    2. ファイルをテーブルにインポート コマンドをファイル削除 コマンドに接続する。
    3. コマンドをダブルクリックして構成します。
      インポート済みファイルと同じファイルを削除していることを確認するため、テーブルからのインポート解除コマンドと同じ方法でファイルIDを生成します：
      • ファイル ID フィールド：
        1. 左側の変数 パネルで、下矢印をクリックしてファイル一覧 を展開します。
        2. Files List を選択します。
        3. List Files - Files List 変数をクリックして変数を変換します。
          1. Select Transformation をクリックし、Get Value from JSON を選択します。
          2. プラス記号（+）をクリックして、変数変換/トランスフォーメーションを追加します。
            1. Value フィールドに '0' とタイプし、Enter を押します。
            2. =0 が表示されたら、「id」とタイプし、Enterをもう一度押します。
              この変数は、List FilesコマンドからのJSON出力を読み込み、テーブル内の最初のファイルのIDを検索する。
              ヒントJSON値を解析する際には、大文字と小文字に特に注意してください。
            3. 承認をクリックする。
            4. コマンド.xx を保存します。

             

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

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

            1. Execute をクリックし、Run With Inputs を選択します。
            2. ランタイム入力の値を追加します。
            3. Start をクリックする。
              • チェーンは正常に古いファイルを削除し、新規ファイルと置換してテーブルに追加しているはずです。
              • Wdataのテーブルにナビゲーションし、右側のパネルのDatasetsをレビューすることで、データがテーブル内で置換されたことを確認できます。

            チェーンを使ってデータ収集を効率化する詳細は、Data Centralization Paths の続きをご覧ください！

データ管理をさらに合理化するには、ステップを同じチェーンに結合すればよい。この接続ラーニングパスでは、チェーンを使った2ステップのプロセスである、Wdataテーブルのデータを置換する最適な方法を説明します。 プライマリビ...