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

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

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

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

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

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

1. CData Connect Server にログインして、Databases をクリックします。
2. 利用できるデータソースアイコンから"Avalara AvaTax" を選択します。
3. Avalara AvaTax に接続するために必要なプロパティを入力します。

   Basic 認証を実行する通常の方法は、次のログイン資格情報を提供することです。

   • User：ユーザー名に設定します。
   • Password：パスワードに設定します。

   サンドボックス環境を使用している場合には、オプションで次を設定してください。

   • UseSandbox：サンドボックスアカウントで認証する場合にはこれをtrue に設定します。

   アカウント番号とライセンスキーを使用して認証する

   または、アカウント番号とライセンスキーを使用して認証することもできます。次を使用してデータに接続します。

   • AccountId：これをアカウントId に設定します。アカウントId は管理コンソールの右上端にリストされています。
   • LicenseKey：これをAvalara Avatax のライセンスキーに設定します。ライセンスキーの生成は、Avalara Avatax アカウント管理者としてログインして Settings -> Reset License Key に移動して実行できます。
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. 続いて、Avalara AvaTaxのエンドポイントを呼び出す定義を追加します。「GET」リクエストで、CData Connect Server で定義したAPIエンドポイントのURLを入力してください。
5. 最後に「Initialize call」を行い、データ項目の型情報を調整します。
6. 特に変更がなければデフォルトのままでOKです。以上で bubble から CData Connect Server への連携設定は完了です。

UIを構成する

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

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

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