Clover ETL からReckon Accounts Hosted データに連携

こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

CData JDBC Driver for ReckonAccountsHosted は、CloverETL からReckon Accounts Hosted への作成、読み取り、更新、削除のCRUD コマンド 処理を実現します。本記事では、CloverETL でJDBC Driver を使い、Reckon Accounts Hosted をシンプルなCSV ファイルに変換します。

JDBC Data Source でReckon Accounts Hosted に接続

1. Reckon Accounts Hosted データへの連携を作成します。CloverETL の新しいgraph で、Outline ペインのConnections ノードを右クリックして、Create Connection をクリックします。Database Connection ウィザードが表示されます。
2. ＋アイコンをクリックして、.jar ファイルをロードします。インストールディレクトリのlib フォルダの cdata.jdbc.reckonaccountshosted.jar ファイルを選択します。
3. JDBC URL を入力します。一般的な接続文字列は： jdbc:reckonaccountshosted:SubscriptionKey=my_subscription_key;CountryVersion=2021.R2.AU;CompanyFile=Q:/CompanyName.QBW;User=my_user;Password=my_password;CallbackURL=http://localhost:33333;OAuthClientId=my_oauth_client_id;OAuthClientSecret=my_oauth_client_secret;

   本製品 はOAuth 経由でReckon Accounts Hosted にリクエストを作成します。次の接続プロパティを指定します。

   • User： 必須。企業ファイルのユーザー名。
   • Password： 必須。企業ファイルのパスワード。
   • CompanyFile: 必須。企業ファイルへのパス。
   • InitiateOAuth：アクセストークンの処理をドライバーに任せる場合はGETANDREFRESH に設定。
   • CountryVersion：デフォルトは、2021.R2.AU です。

   カスタムOAuth アプリケーションを作成し、以下の追加の接続プロパティを指定することもできます。

   • SubscriptionKey：Azure Platform 上のReckon Portal から取得したAPI キー。
   • OAuthClientId：アプリケーション設定のクライアントID に設定。
   • OAuthClientSecret：アプリケーション設定のクライアントシークレットに設定。
   • CallbackURL：カスタムOAuth アプリのリダイレクトURI。

   CData は、OAuth デスクトップ認証を簡略化する埋め込みOAuth アプリケーションを提供します。ほかのOAuth 認証方法（Web、ヘッドレスなど）、カスタムOAuth アプリケーションの作成、その理由などについては、ヘルプドキュメントを参照してください。

DBInputTable コンポーネントで、Reckon Accounts Hosted データをクエリ

1. DBInputTable をReaders セクションからドラッグし、ジョブフローに置きます。ダブルクリックして、設定エディタを開きます。
2. DB コネクションプロパティで、Reckon Accounts Hosted JDBC をドロップダウンから選択します。
3. SQL クエリを入力します。例： SELECT * FROM Accounts

UniversalDataWriter でQuery のOutput を記述

1. Writer セクションからUniversalDataWriter をドラッグして、ジョブフローに置きます。
2. UniversalDataWriter をダブルクリックして、設定エディタを開き、ファイルURL を足します。
3. DBInputTable をダブルクリックして、Extract Metadata をクリックします。
4. DBInputTable のOutput ポートをUniversalDataWriter に接続します。
5. UniversalDataWriter のSelect Metadata メニューでAccounts テーブルを選択します。（UniversalDataWriter のInput ポートを右クリックしてメニューを開くことも可能です。）
6. Run をクリックして、ファイルの書き込みを実行します。