Workbench 5でJSONデータに接続する

Workbench 5では、JSON DataSetジョブを作成できます。データソースタイプにJSONを選択すると、取得したいデータのデータノード、区切り文字、データの平坦化方法などを指定することができます。

Workbench 5でJSON DataSetジョブを作成するには、

1. 左側のアイコンバーにあるアイコンをクリックします。 

2. ジョブリストペインの右上にある ［+］ ボタンをクリックします。

3. ［Domoドメイン］ドロップダウンメニューで、必要なアカウント（Domoインスタンス）を選択します。
   アカウントが1つしか設定されていない場合は、そのアカウントが既に選択されているため、メニューは使用できません。

4. ［名前］フィールドに、DataSetジョブの名前を入力します。
   これは、Workbenchで表示されるジョブ名です。DomoにアップロードされたDataSet名ではありません。

5. ［トランスポートタイプ］メニューで、［ローカルファイルプロバイダー］、［外部プロセスファイルプロバイダー］、［FTP/SFTPファイルプロバイダー］、［JIRA接続プロバイダー］から選択します。
   
   これらトランスポート方法の詳細は、以下のとおりです。

   トランスポート方法	説明
   ローカルファイルプロバイダー	自分のマシンまたはネットワークからファイルを選択できます。
   外部プロセスファイルプロバイダー	サードパーティアプリケーションから、スクリプトを使ってデータをDomoに引き込みます。
   FTP/SFTPファイルプロバイダー	ファイルをFTP、SFTP（SSH-FTP）、FTPS（FTP-SSL）のいずれか経由で取得します。
   JIRA接続プロバイダー	JQLクエリを使用してJIRAサーバーからファイルを取得できます。

6. ［読み取りタイプ］メニューで、［JSON］を選択します。

7. ［DataSet名］フィールドに、DataSet名を入力します。これは、DomoにアップロードされたDataSet名です。
   新しいジョブを保存した後に変更できるのは、この設定のみです。

8. ［DataSetタイプ］フィールドに、ドロップダウンからDataSetのタイプを選択します。
   ここで選択または入力するDataSetのタイプは、ジョブ実行後のDomoのコネクタータイプに反映されます。

9. 適宜DataSetの説明を入力します。
   Domoに表示されるDataSetの説明です。 

10. ［作成］をクリックします。
    
    現在認証されているアカウントのジョブリストに、JSON DataSetジョブが新規に追加されます。ジョブを作成した後は、DataSet名以外の設定は編集できません。他の設定を変更する場合は、新しいジョブを作成する必要があります。 

11. ［設定］サブタブをクリックします。

12. 「ソース」の下の ［編集］をクリックします。
    
    ファイルトランスポートとJSONデータソースのオプションを設定するためのパネルが開きます。

13. （条件付き）以下のいずれかを行ってください。

    • トランスポートタイプに ［ローカルファイルプロバイダー］を選択した場合は、

      1. ［ファイルパス］フィールドで省略記号（...）をクリックします。

      2. 自分のマシンまたはネットワークからJSONファイルを選択します。

      3. ［適用］をクリックします。

    • トランスポートタイプに［外部プロセスファイルプロバイダー］を選択した場合は、

      1. ［プログラムの実行可能ファイル］フィールドで省略記号（...）をクリックします。

      2. 自分のマシンまたはネットワークから実行可能ファイルを選択します。

      3. （オプション）引数がある場合は［引数］フィールドに入力します。

      4. ［出力ファイルパス］フィールドで省略記号（...）をクリックします。

      5. 自分のマシンまたはネットワークの出力ファイルパスを選択します。
         出力パスのファイルタイプは、JSONである必要があります。

      6. ［適用］をクリックします。

    • トランスポートタイプに［FTP/SFTPファイルプロバイダー］を選択した場合は、

      1. ［サーバー］フィールドにサーバー名を入力します。

      2. ［ポート］フィールドにポート番号を入力します。

      3. ［ユーザー名］および［パスワード］にサーバーの認証情報を入力します。

      4. プロトコルを選択します（［FTP］、［SFTP］、 ［FTPS］のいずれか）。

      5. （オプション）SSL証明書がある場合は（［SFTP］と［FTPS］のみ）、必要に応じて設定します。詳細については、「SFTPファイルプロバイダー」を参照してください。
         

      6. ［リモートファイル］フィールドに、インポートするフィールドのファイル名を入力します。

      7. ［適用］をクリックします。

    • トランスポートタイプに［JIRA接続プロバイダー］を選択した場合は、

      1. 該当するフィールドに、会社のJIRAインスタンスに接続するのに使用するユーザー名とパスワードを入力します。

         注記：間違った認証情報でJIRAジョブを実行しようすると、JIRAアカウントはロックされます。これは、正しい認証情報を入れるだけでは修復することができません。手動でJIRAにログインし、CAPTCHA認証を行う必要があります。  

      2. ［サーバーURL］フィールドに、会社のJIRAサーバーのURLを入力します。

      3. ［JIRAクエリ］フィールドで、DataSetに引き込みたいJIRAデータのクエリを入力します。

         ヒント：JQLクエリはJIRAで作成してから、Workbenchにコピーして貼り付けることができます。

          JQLクエリ例：
         project not in (ARCHIVE, CPD, DC, DCV, DP, QA, ODD) AND issuetype in (Epic) AND fixVersion in (2015-02-17) ORDER BY status DESC, resolved DESC, issuetype DESC, key ASC

         重要：JIRAクエリを特定の順番付けをせずに設定すると、Domoへのアップロード時にエラーの原因になる場合があります。多くの場合、クエリでcreated ASCを使って結果を順序付けすることでこの問題を回避することができます。  

         例：
         
         Reporter is not null order by created ASC

      4. ［適用］をクリックします。

14. 「処理中」の下の ［編集］ボタンをクリックします。

15. ［データソース］フィールドで、引き込むJSONデータがあるデータノードを入力します。
    これは、オブジェクトのアレイになっているはずです。 

16. ［区切り文字］フィールドで、平坦化された結果の列名に挿入する区切り文字を入力します。

17. ［平坦化オプション］メニューで、必要な平坦化オプションを選択します。オプションは次のとおりです。

    オプション	説明
    なし	平坦化されていないJSON文字列を返します。
    深くする	ネスト化されたオブジェクト用の行を追加します。
    幅広くする	ネスト化されたオブジェクト用の列を追加します。返す行は1つだけです。

    
     
18. ［更新方法］メニューで、更新する方法を選択します。

    • 更新時に、DataSetを完全に入れ替えたい場合は、［DataSetを置換］を選択します。

    • 更新データを既存のデータに追加したい場合は、［DataSetに追加］を選択します。

これでDataSetジョブを実行する準備ができ、DomoにJSON DataSetが作成されます。しかし、Domoに送信する前にDataSetジョブでできる操作はたくさんあります。例えば、以下のような操作があります。

• Workbench 5でジョブをスケジューリングする

• ジョブの更新が成功または失敗したら通知するよう設定する

• Workbenchデータの暗号化と復号を行う

• 計算を使用して新しい列を作成する

• 列にカスタム日付形式を設定する

• 列の値を置き換える

• DataSetを結合する

• 列にフィルターをかける

• 偽装を設定する（WorkbenchのジョブをActive Directoryユーザーとして実行します）。