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 には、接続および認証する2つの方法があります。Basic およびOAuth です。

   Basic 認証

   Basic 認証で認証するには：
   1. API トークンを取得します。
      1. Pipedrive ポータルを開きます。
      2. ページ右上のアカウント名をクリックします。Pipedrive はドロップダウンリストを表示します。
      3. 会社設定 -> Personal Preferences -> API -> Generate Token に移動します。
      4. 生成されたAPI トークンの値を記録します。また、CompanyDomain を控えておきます。これは、PipeDrive ホームページのURL に表示されます。（これは会社の開発者用サンドボックスのURL です。）
   2. 次の接続プロパティを設定します。
      • APIToken：取得したAPI トークンの値。
      • CompanyDomain：開発者サンドボックスURL のCompanyDomain。
      • AuthScheme：Basic。
   3. 承認されたユーザー名とパスワードでログインします。

   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 を確認します。