Bubble でAvalara AvaTax のデータと連携したアプリを作成

杉本和也
リードエンジニア

CData Connect AI を使ってAvalara AvaTax のOData フィードを作成し、Bubble でカスタムアプリを作成します。

Bubble はアプリや業務用の開発・ローンチを容易にするローコード / ノーコードツールです。さらにCData Connect AI と連携することで、ノーコードアプリ開発用のAvalara AvaTax のデータへのクラウドベースのアクセスをノーコードで追加できます。本記事では、CData Connect AI 経由でBubble からAvalara AvaTax 連携を実現する方法を紹介します。

CData Connect AI はAvalara AvaTax のデータへのクラウドベースのOData インターフェースを提供し、Bubble からAvalara AvaTax のデータへのリアルタイム連携を実現します。

Connect AI を構成

Bubble でAvalara AvaTax のデータを操作するには、Connect AI からAvalara AvaTax に接続し、コネクションにユーザーアクセスを提供してAvalara AvaTax のデータのOData エンドポイントを作成する必要があります。

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

（オプション）新しいConnect AI ユーザーの追加

必要であれば、Connect AI 経由でAvalara AvaTax に接続するユーザーを作成します。

「Users」ページに移動し、 Invite Users をクリックします。
新しいユーザーのE メールアドレスを入力して、 Send をクリックしてユーザーを招待します。
「Users」ページからユーザーを確認および編集できます。

パーソナルアクセストークンの追加

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

Connect AI アプリの右上にあるユーザー名をクリックし、「User Profile」をクリックします。
「User Profile」ページで「Access Token」セクションにスクロールし、 Create PAT をクリックします。
PAT の名前を入力して Create をクリックします。
パーソナルアクセストークンは作成時にしか表示されないため、必ずコピーして安全に保存してください。

Connect AI からAvalara AvaTax に接続

CData Connect AI では、簡単なクリック操作ベースのインターフェースでデータソースに接続できます。

Connect AI にログインし、 Add Connection をクリックします。
「Add Connection」パネルから「Avalara AvaTax」を選択します。
必要な認証プロパティを入力し、Avalara AvaTax に接続します。
Basic 認証を実行する通常の方法は、次のログイン資格情報を提供することです。
- User：ユーザー名に設定します。
- Password：パスワードに設定します。
サンドボックス環境を使用している場合には、オプションで次を設定してください。
- UseSandbox：サンドボックスアカウントで認証する場合にはこれをtrue に設定します。
アカウント番号とライセンスキーを使用して認証する

または、アカウント番号とライセンスキーを使用して認証することもできます。次を使用してデータに接続します。
- AccountId：これをアカウントId に設定します。アカウントId は管理コンソールの右上端にリストされています。
- LicenseKey：これをAvalara Avatax のライセンスキーに設定します。ライセンスキーの生成は、Avalara Avatax アカウント管理者としてログインして Settings -> Reset License Key に移動して実行できます。
Create & Test をクリックします。
「Add Avalara AvaTax Connection」ページの「Permissions」タブに移動し、ユーザーベースのアクセス許可を更新します。

Connect AI にAvalara AvaTax OData エンドポイントを追加する

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

OData ページに移動し、 Add をクリックして新しいOData エンドポイントを作成します。
Avalara AvaTax 接続（例：AvalaraAvatax1）を選択し、Next をクリックします。
使用するテーブルを選択し、「Confirm」をクリックします。

コネクションとOData エンドポイントを設定したら、Bubble からAvalara AvaTax のデータに接続できます。

Avalara AvaTax のデータに接続したアプリを作成

OData エンドポイントをConnect AI に追加したら、Avalara AvaTax のデータへのライブ接続が可能なアプリをBubble で作成できます。

Bubble API Connector を設定

まずは、Bubble からCData Connect AI にアクセスするためのAPI Connector を設定します。

アプリ内で、Plugins タブをクリックして Add plugins をクリックします。
「API Connector」を検索して「Install」をクリックします。
インストール後、「Add another API」ボタンをクリックしてAPI を設定します。
- API に名前を設定します。
- Authentication を「HTTP Basic Auth」に設定します。
- Username をConnect AI のユーザーに設定します（user@mydomain.com）。
- Password を上記のユーザーのPAT に設定します。
- API Call を展開して、「GET」コマンドを選択してURL を先ほど設定したOData エンドポイント（例： https://cloud.cdata.com/api/odata/service/Transactions）に設定します。
「Initialize call」ボタンをクリックしてレスポンスのデータ型を必要に応じて調整します。
必要な変更を加えた後、「SAVE」をクリックします。