Infragistics Reveal でPipedrive データを分析

こんにちは！リードエンジニアの杉本です。

Reveal は、Infragistics が提供するデータビジュアライゼーションツールであり、CData Connect Server およびPipedrive Connector と組み合わせることでPipedrive データから動的なダッシュボードを構築できます。CData Connect Server は、Pipedrive の仮想データベースを作成し、Pipedrive のOData API（Reveal でネイティブに使用可能）を生成するために使用できます。この記事では、Connect Server でのPipedrive への接続と、Infragistics Reveal からのConnect Server への接続について説明し、簡単なダッシュボードを作成します。

Connect Server ユーザーの追加

Reveal からConnect Server を介してPipedrive に接続するユーザーを作成します。

1. 「Users」->「 Add」とクリックします。
2. ユーザーを構成します。
3. 「Save Changes」をクリックして新しいユーザーの認証トークンをメモします。

Connect Server からPipedrive に接続

CData Connect Server は、簡単なポイントアンドクリックインターフェースを使用してAPI を生成します。

1. Connect Server を開き、「Databases」をクリックします。
2. 「Available Data Sources」から「Pipedrive」を選択します。
3. 必要な認証プロパティを入力し、Pipedrive に接続します。

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

4. 「 Test Database 」をクリックします。
5. 「Permission」->「 Add」とクリックし、適切な権限を持つ新しいユーザー（または既存のユーザー）を追加します。（Reveal に必要なのは、SELECT のみです。）

Connect Server にPipedrive OData エンドポイントを追加する

Pipedrive に接続したら、目的のテーブルのOData エンドポイントを作成します。

1. 「OData」->「Tables」->「Add Tables」とクリックします。
2. Pipedrive データベースを選択します。
3. 使用するテーブルを選択し、「Next」をクリックします。
4. （オプション）リソースを編集して特定のフィールドなどを選択します。
5. 設定を保存します。

（オプション）Cross-Origin Resource Sharing (CORS) を構成する

Ajax などのアプリケーションから複数の異なるドメインにアクセスして接続すると、クロスサイトスクリプティングの制限に違反する恐れがあります。その場合には、「OData」->「Settings」でCORS 設定を変更します。

• Enable cross-origin resource sharing (CORS):ON
• Allow all domains without '*':ON
• Access-Control-Allow-Methods:GET, PUT, POST, OPTIONS
• Access-Control-Allow-Headers:Authorization

設定への変更を保存します。

Reveal でダッシュボードを作成

Connect Server を構成すると、Reveal でPipedrive データをビジュアライズできます。

1. Reveal にログインし、「Dashboards」->「 New」とクリックします。
2. 「 Data Source」->「OData Feed」とクリックします。
3. 「API」->「Discovery」->「Base URL」でConnect Server API エンドポイントURLを指定します。（例：https://www.cdatacloud.com/myinstance/api.rsc）
4. 「Generic Credentials」を選択し、Connect Server のユーザー名と認証トークンを指定します。
5. ビジュアライズするエンティティを選択します。
6. フィールドを選択し、チャートの種類を選択します。

詳細と無料トライアル

これで、リアルタイムPipedrive データから簡単なダッシュボードが作成できました。Pipedrive （および150 を超えるほかのソース）からのOData フィードの作成方法の詳細については、Connect Server ページにアクセスしてください。30 日間無料トライアルをダウンロードしてOData API を使用するツールでPipedrive データをリアルタイムに活用しましょう。