Wdataテーブルへのデータファイルのアップロードを簡素化することは、テーブル管理を合理化するためのコアスキルです。この接続ラーニングパスでは、チェーンを使用してWdataテーブルにデータをアップロードする方法を説明します。
| プライマリビジネスユースケース | テーブル管理 |
| プライマリ学習目標 | チェーンを使用した Wdata テーブルからのデータのアップロード |
| 前提条件 | Workiva コネクターの構成 HTTP リクエスターコネクターの構成 |
| サポートテンプレート | CLP|テーブルからのデータアップロード |
ステップ1:テーブルの作成
- Wdata に移動します。
-
以下のプロパティでテーブル を作成するステップを完了します:
- テーブル名称: "CLP従業員詳細"
-
列:
表示名 列 ID タイプ 書式をインポート emp_idemp_idテキスト ユーザー名ユーザー名テキスト first_namefirst_nameテキスト ラストネームラストネームテキスト 役職名役職名テキスト 部署部署テキスト 都市都市テキスト 国国テキスト 通貨通貨テキスト 入社日入社日日付 月/日/年 ftefte小数値 1,000.00 用語用語ブーリアン型 (Boolean)
メモ:
-
hire_dateの値のインポート書式設定が変更されていることに注意してください。これは、テーブルに読み込まれるデータの書式設定と一致するようにするためです。日時書式設定については、このページ で検索できます。 - テーブルのテーブル ID を記録してください。
ステップ2:チェーンの作成
- チェーンビルダー にナビゲーションします。
- 新規チェーンの追加.
- チェーンの名称:CLP | データをテーブルにアップロード.
- チェーンを保存します。
ステップ3:ランタイム入力
Runtime Inputs Chain Event を使用して、チェーンをキックオフします。これにより、ファイル名称と、チェーン実行時にインポート済みとなるテーブルのIDを指定することができる。Runtime Inputsの詳細はこちら。
- Runtime Inputs Chain Event を Chain Trigger Events から Start Node に追加します。
- コマンドをダブルクリックして、Runtime Inputs Chain Event を編集します。
-
Runtime Inputs の値を追加します。
これらはテキスト・フィールドとなり、「必須」とマークしてください。- テーブルID - 「CLP従業員詳細」テーブルのID。
ID検索のヘルプはこのドキュメント を参照してください。 - ファイル名 - ファイルの名称。
この例では、ファイルを「社員詳細」と呼びます。
- テーブルID - 「CLP従業員詳細」テーブルのID。
- File Location - CSV ファイルの場所。
この例では、https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail.csv を使用します。
-
Runtime Inputs の値を追加します。
- 保存 をクリックして、コマンドを保存します。
ステップ4:ファイルのダウンロード
HTTP Request Getコマンドは、テーブルにアップロードされるファイルのダウンロードに使用される。クラウドからファイルをダウンロードするデモを行うために、チェーンがダウンロードするファイルをオンラインでホストしています。
- HTTP Request コネクターからGet Command を Chain canvas に追加します。
- Runtime Inputs Chain Event をGet Command に接続します。
- コマンドをダブルクリックして構成します。
-
URL フィールドをクリックします。
- 左側のSelect a Variable パネル内で、下矢印をクリックしてTrigger を展開します。
- 下矢印をクリックして、Runtime Inputs を展開します。
- ファイルの場所 を選択します。
- コンテンツタイプ フィールドで、application/csv を選択します。
-
URL フィールドをクリックします。
- コマンドを保存する。
ステップ5:ファイル作成
Wdataテーブルへのファイルのアップロードは2ステップのプロセスである。最終的に使用するためにインポートする前に、まずファイルをステージング ステータスで作成する必要がある。Create File "コマンドを使用して、Wdata テーブル内のファイルをステージング ステータス(作成済みだがデータセットとしてインポート済みではない状態)に作成します。
- Workiva Connector からCreate File Command を Chain キャンバスに追加します。
- Get Command をCreate File Command に接続します。
- コマンドをダブルクリックして構成します。
-
テーブル ID フィールドをクリックします。
- 左側のSelect a Variable パネルで、下矢印をクリックしてTrigger を展開します。
- 下矢印をクリックして、Runtime Inputs を展開します。
- テーブル ID を選択します。
-
ファイルフィールドをクリックします。
- 左側のSelect a Variable パネル内で、下矢印をクリックして GET を展開します。
- Response を選択します。
-
名称 フィールドをクリックします。
- 左側のSelect a Variableパネル内で、下矢印をクリックしてTrigger を展開します。
- 下矢印をクリックして、Runtime Inputs を展開します。
- 選択ファイル名称.
- 左側のSelect a Variable パネルで、下矢印をクリックしてRuntime を展開します。
- 選択Chain.ExecutionDateTime.
- 2 つの変数の後に ".csv" とタイプします。
-
テーブル ID フィールドをクリックします。
- コマンドの保存
ステップ6:ファイルをテーブルにインポートする
Wdataテーブルにファイルをアップロードするプロセスの第2ステップは、データをインポートし、クエリで使用できるようにすることである。このステップでは、ステージングされたファイルをデータセットとして指定のテーブルにインポートします。
- Workiva Connector から Import File into Table Command をチェーンキャンバスに追加します。
- Create File Command をImport File into Table Command に接続します。
- コマンドをダブルクリックして構成します。
-
テーブル ID フィールドをクリックします。
- 左側のSelect a Variable パネルで、下矢印をクリックしてTrigger を展開します。
- 下矢印をクリックして、Runtime Inputs を展開します。
- テーブル ID を選択します。
-
ファイル ID フィールドをクリックします。
- 左側のSelect a Variableパネル内で、下矢印をクリックしてCreate File を展開します。
- 結果 を選択します。
-
Create File - Result をクリックして変換/トランスフォーメーションします。
- Select Transformation ドロップダウンで、Get Value from JSON を選択します。
- +ボタンをクリックします。
- Value フィールドに、"id" とタイプし、キーボードの Enter をクリックします。
- ACCEPT をクリックします。
-
テーブル ID フィールドをクリックします。
- コマンドを保存する。
ステップ7:エクササイズのテスト
チェーンが完成したので、結果をテストしてみましょう。
- チェーンを更新します。
- Execute をクリックし、Run With Inputs を選択します。
- ランタイム入力の値を入力します。
- テーブルID - "CLP Employee Detail "テーブルのID。
ID検索のヘルプはこのドキュメント を参照してください。 - ファイル名 - ファイルの名称。
この例では、ファイルを「社員詳細」と呼びます。 - File Location - CSV ファイルの場所。
この例では、https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail.csv を使用します。
- テーブルID - "CLP Employee Detail "テーブルのID。
- Start をクリックします。
-
チェーンが正常終了したら、Import File into Table ノードをクリックし、成功を確認します。
チェーンは正常にファイルを取り込み、Workiva ファイルを作成し、テーブルにインポート済みであるはずです。 Wdata のテーブルに移動し、右側のパネルでデータセットをレビューすることで、データがテーブルにアップ ロードされたことを確認できます。
チェーンを使ったWdataテーブルのデータセット管理については、次へ:テーブルからのデータ削除 !