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

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

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

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

Reckon Accounts Hosted の仮想OData API エンドポイントを作成

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

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

   CData 製品 はOAuth 経由でReckon Accounts Hosted にリクエストを作成します。次の接続プロパティを指定します。

   • User： 必須。企業ファイルのユーザー名。
   • Password： 必須。企業ファイルのパスワード。
   • CompanyFile: 必須。企業ファイルへのパス。
   • InitiateOAuth：アクセストークンの処理をドライバーに任せる場合はGETANDREFRESH に設定。
   • CountryVersion：デフォルトは、2021.R2.AU です。

   カスタムOAuth アプリケーションを作成し、以下の追加の接続プロパティを指定することもできます。

   • SubscriptionKey：Azure Platform 上のReckon Portal から取得したAPI キー。
   • OAuthClientId：アプリケーション設定のクライアントID に設定。
   • OAuthClientSecret：アプリケーション設定のクライアントシークレットに設定。
   • CallbackURL：カスタムOAuth アプリのリダイレクトURI。

   CData は、OAuth デスクトップ認証を簡略化する埋め込みOAuth アプリケーションを提供します。ほかのOAuth 認証方法（Web、ヘッドレスなど）、カスタム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. 続いて、Reckon Accounts Hostedのエンドポイントを呼び出す定義を追加します。「GET」リクエストで、CData Connect Server で定義したAPIエンドポイントのURLを入力してください。
5. 最後に「Initialize call」を行い、データ項目の型情報を調整します。
6. 特に変更がなければデフォルトのままでOKです。以上で bubble から CData Connect Server への連携設定は完了です。

UIを構成する

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

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

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