RapidMiner からPipedrive データに連携

こんにちは！ドライバー周りのヘルプドキュメントを担当している古川です。

この記事では、CData JDBC Driver for Pipedrive をRapidMiner のプロセスと簡単に統合する方法を示します。この記事では、CData JDBC Driver for Pipedrive を使用してPipedrive をRapidMiner のプロセスに転送します。

RapidMiner のPipedrive にJDBC Data Source として接続する

以下のステップに従ってPipedrive へのJDBC 接続を確認できます。

1. Pipedrive 用の新しいデータベースドライバーを追加します。［Connections］->［Manage Database Drivers］とクリックします。
2. 表示されるウィザードで［Add］ボタンをクリックし、接続に名前を入力します。
3. JDBC URL のプレフィックスを入力します。 jdbc:pipedrive:
4. インストールディレクトリのlib サブフォルダにあるcdata.jdbc.pipedrive.jar ファイルにパスを入力して下さい。
5. ドライバークラスを入力します。 cdata.jdbc.pipedrive.PipedriveDriver
6. 新しいPipedrive 接続を作成します。［Connections］->［Manage Database Connections］とクリックします。
7. 接続の名前を入力します。
8. データベースシステムの場合は、以前構成したPipedrive ドライバーを選択します。
9. Host ボックスで接続文字列を入力します。

   Pipedrive 接続プロパティの取得・設定方法

   Pipedrive への接続に使用できる認証方法は、Basic およびOAuth です。

   Basic

   API トークンの取得から始めます。
   1. PipeDrive の右上にあるアカウント名をクリックします。
   2. 会社設定をクリックし、続いてPersonal Preferences -> API -> Generate Token をクリックします。
   3. API トークンを控えておきます。
   4. CompanyDomain を控えておきます。これは、PipeDrive ホームページのURL に表示されます。

   以下を設定してPipedrive へ認証します。

   • APIToken：控えておいたAPI トークンに設定。
   • CompanyDomain：控えておいた開発者サンドボックスURL の会社ドメインに設定。
   • AuthScheme：Basic に設定。

   API トークンは、PipeDrive の右上にあるアカウント名 -> 会社設定 -> Personal preferences -> API に移動して確認できます。

   OAuth

   ユーザー名やパスワードへのアクセスを保有していない場合や、それらを使いたくない場合にはOAuth ユーザー同意フローを使用します。認証方法については、ヘルプドキュメントの「OAuth」セクションを参照してください。

   ビルトイン接続文字列デザイナ

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

   java -jar cdata.jdbc.pipedrive.jar

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

   以下は一般的な接続文字列です。

   AuthScheme=Basic;CompanyDomain=MyCompanyDomain;APIToken=MyAPIToken;
10. 必要であればユーザー名とパスワードを入力します。

プロセス内の様々なRapidMiner オペレーターとのPipedrive 接続を使用できます。Pipedrive を取得するには、［Operators］ビューから［Retrieve］をドラッグします。 ［Retrieve］オペレータを選択した状態で、［repository entry］の横にあるフォルダアイコンをクリックして［Parameters］ビューで取得するテーブルを定義できます。表示されるRepository ブラウザで接続ノードを展開し、目的のサンプルセットを選択できます。

最後に、［Retrieve］プロセスから結果に出力をワイヤリングし、プロセスを実行してPipedrive を確認します。