JBoss のコネクションプールからPipedrive のデータに連携

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

CData JDBC ドライバーは、コネクションプールの標準手順に従ってJBoss で構成できます。この記事では、JBoss アプリケーションのコネクションプールからSalesforce データにアクセスする方法について詳しく説明します。また、JBoss Management Interface を使用してCData JDBC Driver for Pipedrive を設定する方法についても詳しく説明します。最後には、コネクションプールからPipedrive にアクセスできるようになります。

Management Console からJDBC Data Source for Pipedrive を作成

以下のステップに従ってドライバーJAR を追加し、必要な接続プロパティを定義します。

1. ［Runtime］メニューで、展開先がマネージドドメインかスタンドアロンサーバーかに応じて［Domain］または［Server］メニューを選択し、［Manage deployments］をクリックして［Deployments］ページを開きます。
2. ［Add］をクリックします。表示されるウィザードで、インストールディレクトリのlib サブフォルダにあるドライバーのJAR ファイルとライセンスを追加します。ウィザードをデフォルトで終了し、ドライバーを選択して［Enable］をクリックします。
3. ［Configuration］メニューで［Subsystems］->［Connector］->［Datasources］と進みます。これにより、JDBC データソースページが開きます。
4. ［Add］をクリックし、表示されるウィザードでドライバーとJNDI の名前を入力します。例: java:jboss/root/jdbc/Pipedrive
5. 上で追加したドライバーを選択します。
6. JDBC URL、ユーザー名、パスワードを入力します。JDBC URL の構文は、jdbc:pipedrive: の後にセミコロンで区切られた接続プロパティのリストが続きます。

   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:pipedrive:AuthScheme=Basic;CompanyDomain=MyCompanyDomain;APIToken=MyAPIToken;
接続を確認したらウィザードを終了します。Pipedrive のデータソースを選択し、［Enable］をクリックします。

その他のJBoss 統合

上記のステップは、単純なコネクションプールのシナリオでドライバーを構成する方法を示しています。より詳しい情報については、JBoss EAP ドキュメントの［Data Source Management］の章を参照してください。