Informatica Cloud でfreee とデータ連携

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

Informatica Cloud を使うと、抽出、変換、読み込み（ETL）のタスクをクラウド上で実行できます。Cloud Secure Agent およびCData JDBC Driver for API を組み合わせると、Informatica Cloud で直接freee のデータにリアルタイムでアクセスできます。この記事では、Cloud Secure Agent のダウンロードと登録、JDBC ドライバーを経由したfreee への接続、そしてInformatica Cloud の処理で使用可能なマッピングの生成について紹介します。

Informatica Cloud Secure Agent

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

1. Informatica Cloud の「管理者」ページに移動します。
2. 「ランタイム環境」タブを選択します。
3. 「Secure Agent のダウンロード」をクリックします。
4. 「インストールトークン」の文字列を控えておきます。
5. クライアントマシンでインストーラーを実行し、ユーザー名とインストールトークンを入力してCloud Secure Agent を登録します。

NOTE：Cloud Secure Agent の全サービスが立ち上がるまで、時間がかかる場合があります。

freee JDBC Driver への接続

Cloud Secure Agent をインストールして実行したら、JDBC ドライバーを使ってfreee に接続できるようになります。はじめに「接続」タブをクリックし、続けて「新しい接続」をクリックします。接続するには次のプロパティを入力します。

• 接続名：接続の名前を入力（例：CData freee Connection）。
• タイプ：「JDBC_IC (Informatica Cloud)」を選択。
• ランタイム環境：Cloud Secure Agent をインストールしたランタイム環境を選択。
• JDBC 接続URL：freee のJDBC URL に設定。URL は次のようになります。
  
  jdbc:api:Profile=freee.apip;ProfileSettings='CompanyId=1234567;';Authscheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;InitiateOAuth=GETANDREFRESH;

  まずはOAuth アプリを作成します。https://app.secure.freee.co.jp/developers/applications にアクセスして、「新しいアプリケーションの作成」ボタンをクリックします。アプリケーション名を指定し、リダイレクトURL を設定して登録をクリックします。そうすると、クライアントシークレットとクライアントID が発行されます。

  次に、プロファイルをダウンロードしてドライバーがアクセス可能な場所に配置します。こちらからプロファイルをダウンロードして、「C:/profiles/」 などに設置してください。

  その後、Companies ビューからCompanyId を取得します。以下の接続プロパティを設定したら、接続する準備ができます。

  • AuthScheme：OAuth に設定します。
  • OAuthClientID：アプリ設定で指定されたOAuth クライアントID に設定します。
  • OAuthClientSecret：アプリ設定で指定されたOAuth クライアントシークレットに設定します。
  • CallbackURL：アプリ設定で指定したリダイレクトURI に設定します。
  • InitiateOAuth：GETANDREFRESH に設定します。InitiateOAuth を使用してOAuthAccessToken を取得するプロセスを管理できます。

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

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

  java -jar cdata.jdbc.api.jar

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

• JDBC Jar ディレクトリ：JDBC ドライバーがインストールされたディレクトリ（Windows の場合、デフォルトではC:\Program Files\CData\CData JDBC Driver for API\）直下のlib フォルダに設定。
• JDBC Driver Class Name：cdata.jdbc.api.APIDriver に設定。
• ユーザー名：プレースホルダーの値に設定（freee がユーザー名を必要としないため）。
• パスワード：プレースホルダーの値に設定（freee がパスワードを必要としないため）。

freee のデータマッピングの作成

freee への接続設定が完了し、Informatica のどのプロセスでもfreee のデータにアクセスできるようになりました。以下の手順で、freee から別のデータターゲットへのマッピングを作成します。

1. 「データ統合」ページに移動します。
2. 「新規」をクリックし、「マッピング」タブを開くと表示される「マッピング」を選択します。
3. 「ソース」ノードをクリックし、表示されるプロパティの「ソース」タブで「接続」と「ソースタイプ」を設定します。
4. 「選択」をクリックして、表示されるテーブル一覧からマッピングするテーブルを選択します。
5. 「フィールド」タブで、freee テーブルからマッピングするフィールドを選択します。
6. 「ターゲット」ノードをクリックし、ターゲットソース、テーブル、およびフィールドを設定します。「フィールドマッピング」タブで、ソースフィールドをターゲットフィールドにマッピングします。

マッピングの設定が完了し、Informatica Cloud でサポートされている接続とリアルタイムfreee のデータの統合を開始する準備ができました。CData JDBC Driver for API の30日の無償評価版をダウンロードして、今日からInformatica Cloud でリアルタイムfreee のデータの操作をはじめましょう！