ノーコードツールAdalo でSAP HANA XS Advanced 連携アプリを作成

CData Connect Server を使ってSAP HANA XS Advanced のデータの仮想OData API エンドポイントを作成して、Adalo からSAP HANA XS Advanced のデータを使ったアプリを作成する方法。

杉本和也
リードエンジニア
最終更新日：2021-11-15

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

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

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

SAP HANA XS Advanced の仮想OData API エンドポイントを作成

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

CData Connect Server にログインして、Databases をクリックします。
利用できるデータソースアイコンから"SAP HANA XS Advanced" を選択します。
SAP HANA XS Advanced に接続するために必要なプロパティを入力します。
SAP HANA XSA 接続プロパティの取得・設定方法

SAP HANA XSA はOAuth 認証標準を利用しています。接続する前に、SAP HANA XSA OData サービスを確立する必要があります。ヘルプドキュメントの「カスタムOAuth アプリの作成」セクションを参照してください。
OAuthPassword グラント種別を使用してSAP HANA XSA に接続するには、以下を設定します。
- OAuthClientId：UAA サービスJSON ファイルで指定されたClient Id に設定。
- OAuthClientSecret：UAA サービスJSON ファイルで指定されたClient Secret に設定。
- Url：OData サービスエンドポイントに設定。
- XSUAAURL：UAA サービスURL に設定。
- User：アカウントのユーザー名に設定。
- Password：アカウントのパスワードに設定。
OData サービスを設定したら、カスタムクレデンシャルを使用して接続を確立できます。
Test Database をクリックします。
Permission -> Add をクリックして、新しいユーザーを追加し、適切な権限を指定します。
API タブをクリックして OData API エンドポイントが生成されていることを確認します。

Adalo でアプリを作成する

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

「CREATE NEW APP」をクリックし

今回は「Desktop Web App」を作成します。

templateを最初に選ぶことができますが、今回は検証用なので何も無い「Blank」で作成しました。

最後にアプリ名とカラーリング設定を選んで、アプリの準備は完了です。

External Collections の登録

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

アプリを作成したら、まず Adalo アプリ内でデータを扱うための定義である「Collection」を登録します。Collection は Adalo 内部の独自DBのような「Database Collections」と、外部のAPIに対してシームレスにアクセスすることが可能な「External Collections」があります。今回は外部のAPIに対してアクセスを行うので「External Collections」で登録します。

External Collections の登録画面では最初にコレクション名とAPI のベースとなるURLエンドポイントを指定します。任意のCollection 名とAPI Base URLに先程CData Connect Server で登録したSAP HANA XS Advanced の対象リソースに接続できるODataのエンドポイントを指定します。併せて認証情報として Header に「x-cdata-authtoken」の名前でCData Connect Server ユーザー登録時に生成されているTokenを指定します。

続いてAdaloから実行されるそれぞれのリクエストの関連付けを行います。通常のAPIであれば様々なチューニングが必要となる箇所ですが、SAP HANA XS Advanced ではほぼデフォルトの設定のままで進められます。一点だけ設定が必要な箇所として、SAP HANA XS Advanced からのレスポンスをレコード単位で識別するために「Get All」の設定にある「Results Key」に「value」を登録しておくことが挙げられます。これを設定したら「Next」をクリックしましょう。