SnapLogic を使用して freee Project Management を外部サービスと連携

Jerod Johnson
Jerod Johnson
Director, Technology Evangelism
CData JDBC Driver を SnapLogic で使用して、freee Project Management を外部サービスと連携する方法を説明します。

SnapLogic は、ノーコードでデータ連携フローを作成できる iPaaS（Integration Platform as a Service）です。CData JDBC Driver と組み合わせることで、freee Project Management を含む250を超える SaaS、ビッグデータ、NoSQL ソースのリアルタイムデータに SnapLogic ワークフローからアクセスできます。

CData JDBC Driver は、最適化されたデータ処理機能を内蔵しており、リアルタイム freee Project Management のデータ とのやり取りにおいて比類ないパフォーマンスを発揮します。外部ツールから複雑な SQL クエリが発行されると、ドライバーはフィルタや集計などのサポートされている SQL 操作を freee Project Management に直接プッシュし、サポートされていない操作（多くの場合、SQL 関数や JOIN 操作）は内蔵の SQL エンジンを使用してクライアント側で処理します。動的なメタデータクエリ機能により、ネイティブデータ型を使用して freee Project Management のデータ を操作できます。

SnapLogic から freee Project Management に接続

SnapLogic から freee Project Management のデータ に接続するには、CData freee Project Management JDBC Driver をダウンロードしてインストールします。インストールウィザードに従って進めてください。インストールが完了すると、JAR ファイルはインストールディレクトリ（デフォルトでは C:/Program Files/CData/CData API Driver for JDBC/lib）に配置されます。

freee Project Management JDBC Driver のアップロード

インストール後、Manager タブから SnapLogic 内の場所（例：projects/Jerod Johnson）に JDBC JAR ファイルをアップロードします。

接続の設定

JDBC Driver をアップロードしたら、freee Project Management への接続を作成します。

  1. Designer タブに移動します
  2. Snaps から「JDBC」を展開し、「Generic JDBC - Select」snap をデザイナーにドラッグします
  3. Add Account をクリック（または既存のアカウントを選択）し、「Continue」をクリックします
  4. 次のフォームで、JDBC 接続プロパティを設定します：
    • JDBC JARs に、先ほどアップロードした JAR ファイルを追加します
    • JDBC Driver Class を cdata.jdbc.api.APIDriver に設定します

    • JDBC URL を freee Project Management JDBC Driver の JDBC 接続文字列に設定します。例：

      jdbc:api:Profile=freeepm.apip;ProfileSettings='CompanyId=1234567;';Authscheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;RTK=XXXXXX;

      注意：RTK はトライアルキーまたは製品キーです。詳細についてはサポートチームまでお問い合わせください。

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

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

      java -jar cdata.jdbc.api.jar

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

      まずは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 を取得するプロセスを管理できます。
  5. 接続プロパティを入力したら、「Validate」をクリックし、「Apply」をクリックします

freee Project Management のデータ の読み取り

接続の検証と適用後に開くフォームで、クエリを設定します。

  • Schema name を「API」に設定します
  • Table name を freee Project Management のテーブルに設定します。スキーマ名を使用して、例：「API」.「Projects」（ドロップダウンで利用可能なテーブルの一覧を確認できます）
  • テーブルから使用する各項目の Output fields を追加します

Generic JDBC - Select snap を保存します。

接続とクエリを設定したら、snap の末尾をクリックしてデータをプレビューします（下図でハイライト表示）。

結果が期待通りであることを確認したら、追加の snap を使用して freee Project Management のデータ を別のエンドポイントに送信できます。

freee Project Management のデータ を外部サービスにパイプ

この記事では、データを Google スプレッドシートに読み込みます。サポートされている任意の snap を使用するか、別の CData JDBC Driver と Generic JDBC snap を使用して、外部サービスにデータを移動できます。

  1. 「Worksheet Writer」snap を「Generic JDBC - Select」snap の末尾にドロップします。
  2. Google Sheets に接続するためのアカウントを追加します
  3. Worksheet Writer snap を設定して、freee Project Management のデータ を Google スプレッドシートに書き込みます

これで、完全に設定されたパイプラインを実行して、freee Project Management からデータを抽出し、Google スプレッドシートにプッシュできます。

詳細情報と無料トライアル

CData API Driver for JDBC を使用することで、SnapLogic で freee Project Management のデータ を外部サービスと連携するパイプラインを作成できます。freee Project Management への接続の詳細については、CData API Driver for JDBC ページをご覧ください。CData API Driver for JDBC の30日間無料トライアルをダウンロードして、今すぐお試しください。

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

API Driver で freee Project Management のライブデータに接続

freee Project Management に接続

この記事の内容

関連記事