Talend Cloud Data Management Platform で ApprovalMax のデータ を連携

Qlik 社の Talend Cloud Data Management Platform は多様なデータ環境をサポートし、スマートな意思決定のための分析、業務データの共有、データおよびアプリケーションのモダナイゼーション、リスク低減のためのデータエクセレンスの確立を実現します。CData API Driver for JDBC と組み合わせると、ApprovalMax のデータ のデータ連携、品質管理、ガバナンスを向上できます。この記事では、Talend Cloud Data Management で CData JDBC Driver を使用して ApprovalMax に接続し、ワークフロー内でデータを同時に利用できるようにする方法を説明します。

前提条件

CData JDBC Driver を使用して Talend Cloud Data Management Platform でデータを表示・操作する前に、システムに最新バージョンの Talend Studio をダウンロードしてインストールしてください。また、以下の前提条件を満たしていることを確認してください。

1. 適切な権限を持つ Talend Cloud Data Management アカウント
2. CData Web サイトからダウンロード可能な CData API Driver for JDBC

Talend で ApprovalMax に JDBC データソースとして接続

Talend Data Management Cloud へのアクセス

1. ローカルシステムにインストールされている Talend Cloud Data Management Platform を起動し、Other Login Mode をクリックします。
2. Manage Connections をクリックします。Repository を「Local」に設定し、Name、Description、User E-mail を入力します。Workspace のパスを設定して OK をクリックします。
3. Create a new project ラジオボタンを選択して新しいプロジェクト名を追加し、Create をクリックします。
4. 新しいプロジェクトが Select an existing project セクションに表示されます。Open をクリックします。Talend Cloud Data Management Platform ワークスペースが開きます。

新しい接続の作成

1. ナビゲーションペインで Metadata ドロップダウンを展開します。Db Connections を右クリックし、Create Connection を選択します。
2. Database Connection ウィンドウの Find セクションで「JDBC」を検索して選択します。次に、Finish をクリックします。
3. ApprovalMax のデータ をロードする Talend の新しいデータベースの Name、Purpose、Description を入力します。Next をクリックします。

4. ApprovalMax に接続するための JDBC URL を生成します。jdbc:api: で始まり、セミコロンで区切られた一連の接続文字列プロパティを続けます。

   まず、Profile 接続プロパティをディスク上の ApprovalMax プロファイルの場所に設定します（例：C:\profiles\ApprovalMax.apip）。次に、ProfileSettings 接続プロパティを ApprovalMax の接続文字列に設定します（以下を参照）。

   ApprovalMax API プロファイル設定

   ApprovalMax Public API では、OAuth 2.0 の認可コードフローで認証を行います。自分のデータに接続するだけでなく、他のユーザーが各自のデータに接続できるようにすることも可能です。

   まず、ApprovalMax に OAuth アプリケーションを登録する必要があります。ApprovalMax Developer Portal（https://developer.approvalmax.com/applications）にサインインし、新しいアプリケーションを作成します。OAuth アプリケーションには Client ID と Client Secret が割り当てられます。また、Redirect URI（Callback URL）を少なくとも1つ登録しておく必要があります。

   Public API を利用するには、ApprovalMax の Premium サブスクリプション（または有効なトライアル）が必要です。

   以下の接続プロパティを設定すると、接続できるようになります。

   • AuthScheme：OAuth に設定します。
   • InitiateOAuth：GETANDREFRESH に設定します。InitiateOAuth を使うと、OAuthAccessToken を取得するプロセスを管理できます。
   • OAuthClientId：ApprovalMax Developer Portal のアプリケーション設定に表示される Client ID に設定します。
   • OAuthClientSecret：ApprovalMax Developer Portal のアプリケーション設定に表示される Client Secret に設定します。
   • CallbackURL：アプリケーション設定で登録した Redirect URI に設定します。
   • Scope：（オプション）デフォルトの OAuth スコープを上書きします。デフォルト値の openid offline_access https://www.approvalmax.com/scopes/public_api/read は、このプロファイルのすべてのテーブルへの読み取り専用アクセスを許可し、リフレッシュトークンを有効にします。スコープを絞り込む際は、最小権限の原則に従ってください。

   OAuth の Authorization URL は https://identity.approvalmax.com/connect/authorize、Token URL は https://identity.approvalmax.com/connect/token です。グラントタイプは authorization_code と refresh_token の両方に対応しています。

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

   JDBC URL の構築には、ApprovalMax JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。

   
   java -jar cdata.jdbc.api.jar
   

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

   

   一般的な JDBC URL は次のようになります。

   
   jdbc:api:Profile=C:\profiles\ApprovalMax.apip;AuthScheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackURL=your_callback_url;
   

5. CData API Driver for JDBC からコピーした JDBC URL を Edit new database に入力します。

6. Drivers の下にある「(+) Add」ボタンをクリックします。Drivers ボードに「newLine」が表示されます。新しい行の末尾にある (...) をクリックし、Install a new module ラジオボタンを選択して、(...) をクリックしてインストールディレクトリの「lib」サブフォルダにある JAR ファイルへのパスを追加します。OK をクリックします。
7. Driver Class として cdata.jdbc.api（前のステップで指定したインストールディレクトリから取得した JAR ファイル）を選択します。

新しい接続のテスト

1. Check Connection をクリックします。入力した詳細が正しければ、「Connection successful」という確認プロンプトが表示されます。「OK」と「Finish」をクリックします。
2. 接続が確立されたら、新しく作成した接続を右クリックし、Retrieve Schema を選択します。フィルターを使用して必要なデータを取得することもできます。Next をクリックします。
3. Schema ウィンドウで「CData」カタログを展開し、ApprovalMax スキーマからインポートするテーブルを選択します。Next をクリックします。
4. 次のステップで、テーブルから表示するカラムを選択し、Finish をクリックします。
5. ApprovalMax スキーマから選択したすべてのテーブルが、JDBC 接続の Table Schemas セクションに表示されます。
6. 選択したテーブルのいずれかを右クリックし、Data Viewer をクリックしてデータソースからのデータをプレビューします。

おわりに

CData API Driver for JDBC の30日間無償トライアルをダウンロードして、Talend Cloud Data Management Platform で ApprovalMax データを連携しましょう。ご不明な点があれば、サポートチームにお問い合わせください。