ノーコードツールAdalo でPCA Accounting 連携アプリを作成

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

Adalo は ノーコードでスマホやWebベースのアプリを構築できるクラウドサービスです。この記事では、CData Connect Server を経由して Adalo からPCA Accounting に連携するアプリを作成する方法を説明します。

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

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

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

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

   PCA クラウド会計DX では、OAuth 2 認証標準を使います。

   ユーザー資格情報の接続プロパティを設定せずに接続できます。接続に最小限必要な接続プロパティは、次のとおりです。

   • InitiateOAuth：GETANDREFRESH に設定。InitiateOAuth を使って、OAuth 交換や、手動での接続文字列のアクセストークン設定の繰り返しを避けられます。
   • OAuthClientId：アプリケーション設定のクライアントId に設定。
   • OAuthClientSecret：アプリケーション設定のクライアントシークレットに設定。
   • CallbackURL：アプリケーション設定のリダイレクトURL に設定。
   • ApiVersion：接続するPCA API Server バージョンを設定。
   • DefaultDataArea：接続するデータ領域を設定。
   • DataCenter：接続するサーバーのDataCenter 名を設定。
   • ProductCode：PCA 製品コード名を設定。
   • InputModuleName：PCA InputSlip のInputModuleName を設定。

   接続すると、CData 製品はデフォルトブラウザでPCA Accounting OAuth エンドポイントを開きます。ログインして、CData 製品にアクセス許可を与えます。CData 製品がOAuth プロセスを完了します。

   ヘッドレスマシンの認証など、他のOAuth 認証フローについては、ヘルプドキュメントの「OAuth 認証の使用」を参照してください。

4. Test Database をクリックします。
5. Permission -> Add をクリックして、新しいユーザーを追加し、適切な権限を指定します。
6. API タブをクリックして OData API エンドポイントが生成されていることを確認します。

Adalo でアプリを作成する

CData Connect Server 側の準備が完了したら、早速Adalo側でアプリ開発を開始します。

1. 「CREATE NEW APP」をクリックし
2. 今回は「Desktop Web App」を作成します。
3. templateを最初に選ぶことができますが、今回は検証用なので何も無い「Blank」で作成しました。
4. 最後にアプリ名とカラーリング設定を選んで、アプリの準備は完了です。

External Collections の登録

続いてCData Connect Server への接続をAdalo に追加します。Adalo では「Collection」という形でデータ構造を持ち、アプリのデータを管理することができるのですが、この「Collection」を外部のAPIとシームレスに連携した形で利用することができる「External Collections with APIs」という機能があります。この機能を用いてCData Connect Server に接続します。

1. アプリを作成したら、まず Adalo アプリ内でデータを扱うための定義である「Collection」を登録します。Collection は Adalo 内部の独自DBのような「Database Collections」と、外部のAPIに対してシームレスにアクセスすることが可能な「External Collections」があります。今回は外部のAPIに対してアクセスを行うので「External Collections」で登録します。
2. External Collections の登録画面では最初にコレクション名とAPI のベースとなるURLエンドポイントを指定します。任意のCollection 名とAPI Base URLに先程CData Connect Server で登録したPCA Accounting の対象リソースに接続できるODataのエンドポイントを指定します。併せて認証情報として Header に「x-cdata-authtoken」の名前でCData Connect Server ユーザー登録時に生成されているTokenを指定します。
3. 続いてAdaloから実行されるそれぞれのリクエストの関連付けを行います。通常のAPIであれば様々なチューニングが必要となる箇所ですが、PCA Accounting ではほぼデフォルトの設定のままで進められます。一点だけ設定が必要な箇所として、PCA Accounting からのレスポンスをレコード単位で識別するために「Get All」の設定にある「Results Key」に「value」を登録しておくことが挙げられます。これを設定したら「Next」をクリックしましょう。
4. 最後にAPIの「RUN TEST」を行います。
5. 「RUN TEST」をクリック後、最終的に以下のようにメッセージとレスポンスが表示されれば、External Collectionsの作成は完了です。

一覧画面の作成

それでは作成した External Collections を使ってアプリを作っていきましょう。

1. まず一覧画面を表示するためにAdalo の画面右上の「＋」ボタンをクリックして、「Simple List」をドラッグアンドドロップで画面に配置します。
2. 以下のように配置できたら「What is this a list of?」で先程作成したExternal Collectionsの定義を紐付けます。
3. 併せて「Title」と「Subtile」を取得するデータ項目に紐付けましょう。
4. プレビューを実行し一覧画面に移動してみると、以下のようにPCA Accounting のデータを取得できていました。

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