ノーコードアプリ開発プラットフォーム bubble でPipedrive にアクセス

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

bubble はプログラミングを行わずにWebアプリケーションを開発できるクラウドサービスです。この記事では、CData Connect Server を経由して bubble からPipedrive に連携する方法を説明します。

CData Connect Server は、Pipedrive データのクラウド to クラウドの仮想OData インターフェースを提供し、bubble からリアルタイムにPipedrive データへ連携することができます。

Pipedrive の仮想OData API エンドポイントを作成

まずCData Connect Server でデータソースへの接続およびOData API エンドポイント作成を行います。

1. CData Connect Server にログインして、Databases をクリックします。
2. 利用できるデータソースアイコンから"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 をクリックして、新しいユーザーを追加し、適切な権限を指定します。
6. API タブをクリックして OData API エンドポイントが生成されていることを確認します。

bubble API Connector の構成

それでは bubble側でCData Connect Server に連携するための API Connector を構成します。

1. まず、bubble の Pluginsタブに移動して「Add Pluings」をクリックします。
2. 一覧の中から「API Connector」を検索し、インストールしてください。
3. インストール後、連携設定の画面が出てくるので、任意の名称を入力し、Header情報に「x-cdata-authtoken」と予め取得したCData Connect Server のTokenを設定します。
4. 続いて、Pipedriveのエンドポイントを呼び出す定義を追加します。「GET」リクエストで、CData Connect Server で定義したAPIエンドポイントのURLを入力してください。
5. 最後に「Initialize call」を行い、データ項目の型情報を調整します。
6. 特に変更がなければデフォルトのままでOKです。以上で bubble から CData Connect Server への連携設定は完了です。

UIを構成する

それではbubble でPipedrive のデータを呼び出してみましょう。今回はExcel Likeなテーブルを表示できるUIコンポーネントでデータを呼び出してみます。

1. Add Pluingsで「Excel-like HandsonTable」を追加します。
2. あとは、このUIコンポーネントを配置して、CData Connect Server のPluginをバインドするだけでOKです。
3. テーブルにバインドする配列要素はvalue 要素を指定してみてください。
4. プレビュー画面に移動することで、Pipedrive からデータを取得した一覧画面が確認できます。

このように、CData Connect Serverを経由することで、API 側の複雑な仕様を意識せずにAPI 連携をしたウェブアプリをbubble で開発できます。他にも多くのデータソースに対応するCData Connect Server の詳細をこちらからご覧ください。