DBeaver からXero WorkflowMax データに連携

CData JDBC Driver for XeroWorkflowMax は、IDE のウィザードからBI ツールまで、サードパーティーツールからXero WorkflowMax データの読み書きを可能にするJDBC 標準を実装しています。本記事では、DBeaver のウィザードを使ってXero WorkflowMax データに接続し、DBeaver のGUI でデータを参照する方法を紹介します。

XeroWorkflowMax データのJDBC データソースを作成する

以下の手順で、DBeaver にドライバーのJAR ファイルをロードします。

1. DBeaver アプリケーションを開き、「データベース」メニューの「ドライバーマネジャー」オプションを選択します。「新規」をクリックして「新しいドライバを作成する」フォームを開きます。
2. 「ドライバ名」ボックスに、ドライバーの分かりやすい名称を入力します。
3. .jar ファイルを追加するために、「ファイルを追加」をクリックします。
4. 表示されるダイアログで、インストールディレクトリのlib フォルダにあるcdata.jdbc.xeroworkflowmax.jar ファイルを選択します。
5. 「クラスを見つける」ボタンをクリックし、検索結果から「XeroWorkflowMax ドライバクラス」を選択します。これにより、フォーム上部にある「クラス名」フィールドが自動的に入力されます。ドライバーのクラス名はcdata.jdbc.xeroworkflowmax.XeroWorkflowMaxDriver です。
6. 「URL テンプレート」フィールドにjdbc:xeroworkflowmax: を追加します。

Xero WorkflowMax データへの接続を作成する

以下の手順で、認証情報およびその他の必要な接続プロパティを追加します。

1. 「データベース」メニューから、「新しい接続」をクリックします。
2. 表示される「新しい接続を作成する」ウィザードで、ドライバーを選択します。
3. ウィザードで「次へ」をクリックし、表示されたページで「ドライバのプロパティ」タブをクリックします。

4. Xero WorkflowMax に接続するために必要な認証情報およびその他のプロパティの値を入力します。

   WorkflowMax API に接続するには、Xero からAPIKey とAccountKey を取得します。取得については、 Xero のサポートにお問い合わせ頂く必要があります。(https://www.workflowmax.com/contact-us).

   API キーとAccount キーを取得したら、APIKey とAccountKey 接続プロパティの値を設定してください。 これらが設定されれば、接続の準備は完了です。

   組み込みの接続文字列デザイナー

   JDBC URL の作成の補助として、Xero WorkflowMax JDBC Driver に組み込まれている接続文字列デザイナーが使用できます。JAR ファイルをダブルクリックするか、コマンドラインからjar ファイルを実行します。

   java -jar cdata.jdbc.xeroworkflowmax.jar

   接続プロパティを入力し、接続文字列をクリップボードにコピーします。

   一般的な接続文字列：

   jdbc:xeroworkflowmax:APIKey=myApiKey;AccountKey=myAccountKey;

Xero WorkflowMax データにクエリを実行

これで、公開済みテーブルのデータにクエリを実行できるようになりました。「テーブル」を右クリックし、「テーブルの編集」をクリックします。「データ」タブでデータを確認できます。