Workiva サポートセンター

Load Data to Wdataテンプレートは、Wdataテーブルに、既存のデータセットを置換中、または新規データセットを追加してデータを取り込みます。このテンプレートは既存のチェーンの一部として使用されることが最も多いが、データセットをテーブルにアップロードする必要のあるワークフローに追加することもできる。

要件

• ターゲットのWdataテーブルは、このチェーンを実行する前に作成しておく必要がある。
• このテンプレートは3つのチェーンで構成されている。各チェーンは個別に更新する必要がある。
• ファイル名称には拡張機能.csvまたは.tsvを含むこと。例えば"File_Name_Example.csv"。
• データセットの推奨最大ファイルサイズは300MBです。推奨ファイルサイズの詳細はこちら。

テンプレートの検索

Load Data to WData テンプレートは、Templates 画面の Workiva チェーンセクションにあります。

検索方法はこうだ：

1. チェーンビルダーで、テンプレート dynamic_feedタブに移動します。
2. 上部のメニューからWorkiva チェーン を選択。
3. 右上のLoad Data to Wdata | プライマリーチェーン を検索し、テンプレートを開く。

4. テンプレートを見つけたら、新規チェーン をクリックし、ワークスペースに配置する。 

   メモ： 構成されたら、このテンプレートの各チェーンをワークスペースに更新する必要があります。

テンプレートの構成

このテンプレートは、プライマリ・チェーン、データセット置換チェーン、新規データセット追加チェーンの3つのチェーンで構成されている。プライマリチェーンがワークスペースに配置されると、2つの子チェーン（追加/置換）も自動的に一緒に配置されます。

それぞれのチェーンを詳しく見てみよう：

• プライマリチェーン ：このチェーンは、テーブルの中に、チェーンによって読み込み中のデータセットと同じ名称のデータセットがあるかどうかを判定する。  一致するデータセットが検索されると、チェーンは一致したデータセットに関する情報を取得し、親チェーンに構成した「読み込み方法」の実行時入力に基づいて、そのデータを2つの子チェーンのうちの1つにリダイレクトする。

• Replace Dataset チェーン ：このチェーンは、マッチしたデータセットをテーブルから削除し、新規のデータセットに置換する。実行中にエラーが発生し、ロールバックオプションが選択された場合、チェーンは自動的に新規データセットを削除し、置換されるはずだったデータセットに元に戻します。  

• 新規データセット追加チェーン ：このチェーンは新規データセットを作成し、テーブルにインポートします。新規データセットは，テーブル内の他のデータセットで現在使われていない、一意なファイル名でなければなりません。

このチェーンセットを既存のチェーンに追加する場合、プライマリ・チェーンの実行入力を "Run Chain"ノード内で構成する必要があります。  子チェーンは変更や構成を必要としない。  

設定は以下のようになるはずだ：

変数

ランタイム入力

トラブルシューティング

エラーを含むチェーン実行履歴を表示するには：

1. チェーンビルダーで、Monitorに行きます。
   

2. クエスチョンマークにカーソルを合わせると、チェーン実行のステータスが表示されます。
   
   

チェーンがエラーを引き起こしたり、正しいデータの更新に失敗した場合は、以下のチェックを行ってください：

• 3つのチェーンがすべて、ワークスペースに更新されていることを確認します。各チェーンは別々に更新されなければなりません。
• データセットがサポートされている区切り文字を使用していること，ファイル名に.csvまたは.tsvの拡張機能（"File_Name_Example.csv"）を含むことを確認してください．
• Replace Dataset loadメソッドを使用する場合は、ファイル名称がWdataテーブルの既存のファイル名称と一致していることを確認してください。一致しない場合、チェーンは古いファイルを置換することなく、単に新規ファイルをテーブルに追加する。
• 逆に、Add New Dataset loadメソッドを使用する場合は、ファイル名称がWdataテーブルの他のどこにも使用されていないことを確認してください。重複するファイル名称を使用した場合、チェーンは失敗する。
• Workiva 接続に関連付けられたOAuth2 grant が適切なアクセス権を持っていることを確認してください。
• テーブルIDを入力する際は、ID全体が入力され、先頭や末尾に空白がないことを確認する。
• ランタイムタイムスタンプ変数をチェックする。データセットごとに一意なファイル名称が作成されるため，これらの名称をファイル名に使ってはならない．つまり，チェインがテーブル内のマッチしたデータセットを識別できなくなる．

列マッピングとその他のチェーン修正

データのインポート時に列ヘッダーの問題が発生した場合は、データの準備 または他のコマンドを使用することができます。 

オプション：インポート済みデータセットにタグを付ける

のタグ付けは、データセットのインポート時にサポートされていますが、オリジナルに変更を加える前に、テンプレートからチェーンの追加設定をデプロイすることをお勧めします。一度修正されたチェーンは、他のテーブルのデータセットが同じタグを使用していない限り、再利用することは難しいでしょう。  

チェーンにタグを追加する：

1. このテンプレートからデプロイされた チェーン3つそれぞれに、以下のランタイム入力を追加します：
   • タグキー（テキストフィールド）
   • タグ値（テキストフィールド）
     
2. プライマリーチェーン を編集して、各「ランチェーン」イベントに実行入力を渡す：
3. Replace Dataset Chain とAdd New Dataset Chain の両方で、"Import New Dataset" コマンド・ノードを編集して、タグのランタイム入力を承認する。

完了すると、インポート済みのデータセットに、提供されたタグキーとタグ値が付けられます。

その他のリソース

• Workiva コネクター
• ファイルユーティリティ・コネクター
• JSONコネクター
• 表形式変換/トランスフォーメーション・コネクター
• チェーンを別のチェーンの中で実行する ("Run Chain events")
• OAuth2の付与
• Wdataの機能とAPIの制限