Node.js からPipedrive のデータをSQL Server データベースとしてクエリ

CData Connect AI を使用すると、SQL Server インターフェース経由でPipedrive のデータをクエリできます。以下のステップに従って、Connect AI にPipedrive の仮想データベースを作成し、Node.js を使用してクエリを実行します。

CData Connect AI は、Pipedrive のピュアMySQL かつクラウドベースのインターフェースを提供し、ネイティブにサポートされているデータベースにデータを複製することなくNode.js からの手軽なリアルタイムPipedrive のデータクエリを実現します。Node.js でデータをクエリすると、CData Connect AI はサポートされているすべてのSQL 操作（フィルタ、JOIN など）を直接Pipedrive にプッシュし、サーバー側の処理を活用してPipedrive のデータを高速で返します。

Connect AI からPipedrive に接続する

1. Connect AI にログインし、 Add Connection をクリックします。
2. Add Connection パネルから「Pipedrive」を選択します。
3. 必要な認証情報を入力し、Pipedrive に接続します。

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

   Pipedrive への接続・認証方法には、Basic 認証とOAuth 認証の2種類があります。

   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 認証」セクションを参照してください。

   

4. Create & Test をクリックします。
5. Edit Pipedrive Connection ページのPermissions タブに移動し、ユーザーベースのアクセス許可を更新します。

パーソナルアクセストークンを追加する

OAuth 認証をサポートしないサービス、アプリケーション、プラットフォーム、フレームワークから接続する場合、パーソナルアクセストークン（PAT）を認証に使用できます。きめ細かくアクセスを管理するために、サービスごとに個別のPAT を作成するのがベストプラクティスです。

1. User Profile ページでPersonal Access Token セクションにスクロールし、 Create PAT をクリックします。
2. PAT の名前を入力して Create をクリックします。
3. パーソナルアクセストークンは作成時にしか表示されないため、必ずコピーして安全に保存してください。

接続が設定されたら、Node.js からPipedrive のデータに接続できるようになります。

Node.js からPipedrive をクエリ

以下の例は、SQL Server モジュールを使用してPipedrive へのクエリを実行する方法を説明しています。以下の情報が必要です。

• server：tds.cdata.com
• port：14333
• user：Connect AI ユーザー（例：[email protected]）
• password：上記のユーザーのPAT
• database：Pipedrive 用に構成した接続（Pipedrive1）

以下のコードで、Pipedrive に接続してクエリが実行できます。

var sql = require('mssql')
var config = {
	server: 'tds.cdata.com',
	port:14333,
	user: '[email protected]', //update me
	password:'CONNECT_USER_PAT', //update me
	options: {
		encrypt: true,
		database: 'Pipedrive1'
	}
}

sql.connect(config, err => {
    if(err){
        throw err ;
    }
    new sql.Request().query('SELECT * FROM Deals', (err, result) => {
        console.dir(result)
    })

});

sql.on('error', err => {
    console.log("SQL Error: " ,err);
})