Informatica Cloud で ApprovalMax のデータ を連携

Jerod Johnson
Jerod Johnson
Director, Technology Evangelism
CData JDBC ドライバーと Informatica Cloud Secure Agent を使用して、Informatica Cloud から ApprovalMax のデータ にリアルタイム接続。

Informatica Cloud は、クラウド上で抽出、変換、ロード（ETL）タスクを実行できるツールです。Cloud Secure Agent と CData API Driver for JDBC を組み合わせることで、Informatica Cloud から直接 ApprovalMax のデータ にリアルタイムでアクセスできます。本記事では、Cloud Secure Agent のダウンロードと登録、JDBC ドライバーを介した ApprovalMax への接続、そして Informatica Cloud のプロセスで使用可能なマッピングの作成方法をご紹介します。

Informatica Cloud Secure Agent

JDBC ドライバー経由で ApprovalMax のデータ に接続するには、Cloud Secure Agent をインストールします。

  1. Informatica Cloud の Administrator ページに移動します
  2. Runtime Environments タブを選択します
  3. 「Download Secure Agent」をクリックします
  4. Install Token をメモしておきます
  5. クライアントマシンでインストーラを実行し、ユーザー名と Install Token を使って Cloud Secure Agent を登録します

NOTE: Cloud Secure Agent のすべてのサービスが起動するまでに、しばらく時間がかかる場合があります。

ApprovalMax JDBC Driver への接続

Cloud Secure Agent のインストールと起動が完了したら、JDBC ドライバーを介して ApprovalMax に接続する準備が整いました。

Secure Agent マシンへの JDBC ドライバーの追加

  1. Secure Agent マシンの以下のディレクトリに移動します： 
    %Secure Agent installation directory%/ext/connectors/thirdparty/
  2. 設定するマッピングの種類に応じて、フォルダを作成しドライバーの JAR ファイル（cdata.jdbc.api.jar）を追加します。

    マッピングの場合は、以下のフォルダを作成してドライバーの JAR ファイルを追加します：

    informatica.jdbc_v2/common

    アドバンスドモードのマッピングの場合は、以下のフォルダも作成してドライバーの JAR ファイルを追加します：

    informatica.jdbc_v2/spark
  3. Secure Agent を再起動します。

Informatica Cloud での ApprovalMax への接続

ドライバーの JAR ファイルをインストールしたら、Informatica Cloud で ApprovalMax への接続を設定します。Connections タブをクリックし、New Connection をクリックして、以下のプロパティを入力します：
  • Connection Name: 接続に名前を付けます（例：CData ApprovalMax Connection）
  • Type:「JDBC_V2」を選択します
  • Runtime Environment: Secure Agent をインストールしたランタイム環境を選択します
  • JDBC Driver Class Name: JDBC ドライバークラス名を入力します：cdata.jdbc.api.APIDriver
  • JDBC Connection URL: ApprovalMax の JDBC URL を設定します。URL は以下のようになります：

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

    まず、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 ファイルをダブルクリックするか、コマンドラインから実行してください。

    
    java -jar cdata.jdbc.api.jar

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

    組み込みの接続文字列デザイナーを使用して JDBC URL を生成（例：Google Sheets）
  • Username: プレースホルダー値を設定します（ApprovalMax はユーザー名を必要としないため）
  • Password: プレースホルダー値を設定します（ApprovalMax はパスワードを必要としないため）
接続の設定（例：Google Sheets）

ApprovalMax のデータ のマッピングを作成

ApprovalMax への接続を設定したら、Informatica の任意のプロセスで ApprovalMax のデータ にアクセスできます。以下の手順では、ApprovalMax から別のデータターゲットへのマッピングを作成する方法を説明します。

  1. Data Integration ページに移動します
  2. New.. をクリックし、Mappings タブから Mapping を選択します
  3. Source Object をクリックし、Source タブで Connection を選択し、Source Type を設定します Source Connection と Source Type の選択
  4. 「Select」をクリックして、マッピングするテーブルを選択します Source Object の選択
  5. Fields タブで、マッピングする ApprovalMax テーブルのフィールドを選択します マッピングする Source フィールドの選択
  6. Target オブジェクトをクリックし、Target ソース、テーブル、フィールドを設定します。Field Mapping タブで、ソースフィールドをターゲットフィールドにマッピングします。 Target フィールドマッピングの選択

マッピングの設定が完了すると、Informatica Cloud でサポートされている任意の接続先と ApprovalMax のデータ のリアルタイム連携を開始できます。CData API Driver for JDBC の30日間無償トライアルをダウンロードして、Informatica Cloud で ApprovalMax のデータ の活用を今すぐ始めましょう。

はじめる準備はできましたか？

API Driver で ApprovalMax のライブデータに接続

ApprovalMax に接続

この記事の内容

関連記事