Adalo アプリで使えるSAP Business Warehouse のデータ連携用のバックエンドAPI をノーコードで開発
CData API Server を使って、Adalo から SAP Business Warehouse に接続してデータを取得する方法を説明します。
API Server の設定
以下のリンクからAPI Server の無償トライアルをスタートしたら、セキュアなSAP Business Warehouse OData サービスを作成していきましょう。
SAP Business Warehouse への接続
Adalo からSAP Business Warehouse のデータを操作するには、まずSAP Business Warehouse への接続を作成・設定します。
- API Server にログインして、「Connections」をクリック、さらに「接続を追加」をクリックします。
- 「接続を追加」をクリックして、データソースがAPI Server に事前にインストールされている場合は、一覧から「SAP Business Warehouse」を選択します。
- 事前にインストールされていない場合は、コネクタを追加していきます。コネクタ追加の手順は以下の記事にまとめてありますので、ご確認ください。
CData コネクタの追加方法はこちら >> - それでは、SAP Business Warehouse への接続設定を行っていきましょう!
-
SAP Business Warehouse に接続するには、URL プロパティを有効なSAP Business Warehouse サーバーのベースURL に設定します。ドライバーはXMLAアクセスを使用してHTTP 上でホストされたSAP Business Warehouse インスタンスに接続する必要があります。
ドライバーはAuthScheme プロパティを通じて以下の認証スキームをサポートしています:
- None:サーバーで使用可能な場合、匿名認証。
- Basic:User とPassword を設定し、AuthScheme をBasic に設定します。
- Kerberos:必要なKerberos プロパティについては、ヘルプドキュメントの「Kerberos の使用」セクションを参照してください。
デフォルトでは、ドライバーはシステムの信頼された証明書ストアに対してサーバーの証明書を確認することでSSL/TLS のネゴシエーションを試みます。別の証明書を指定するには、使用可能な形式についてSSLServerCert プロパティを参照してください。
- 接続情報の入力が完了したら、「保存およびテスト」をクリックします。
SAP Business Warehouse に接続するには、URL プロパティを有効なSAP Business Warehouse サーバーのベースURL に設定します。ドライバーはXMLAアクセスを使用してHTTP 上でホストされたSAP Business Warehouse インスタンスに接続する必要があります。
ドライバーはAuthScheme プロパティを通じて以下の認証スキームをサポートしています:
- None:サーバーで使用可能な場合、匿名認証。
- Basic:User とPassword を設定し、AuthScheme をBasic に設定します。
- Kerberos:必要なKerberos プロパティについては、ヘルプドキュメントの「Kerberos の使用」セクションを参照してください。
デフォルトでは、ドライバーはシステムの信頼された証明書ストアに対してサーバーの証明書を確認することでSSL/TLS のネゴシエーションを試みます。別の証明書を指定するには、使用可能な形式についてSSLServerCert プロパティを参照してください。
API Server のユーザー設定
次に、API Server 経由でSAP Business Warehouse にアクセスするユーザーを作成します。「Users」ページでユーザーを追加・設定できます。やってみましょう。
- 「Users」ページで ユーザーを追加をクリックすると、「ユーザーを追加」ポップアップが開きます。
-
次に、「ロール」、「ユーザー名」、「権限」プロパティを設定し、「ユーザーを追加」をクリックします。
-
その後、ユーザーの認証トークンが生成されます。各ユーザーの認証トークンとその他の情報は「Users」ページで確認できます。
SAP Business Warehouse 用のAPI エンドポイントの作成
ユーザーを作成したら、SAP Business Warehouse のデータ用のAPI エンドポイントを作成していきます。
-
まず、「API」ページに移動し、
「 テーブルを追加」をクリックします。
-
アクセスしたい接続を選択し、次へをクリックします。
-
接続を選択した状態で、各テーブルを選択して確認をクリックすることでエンドポイントを作成します。
OData のエンドポイントを取得
以上でSAP Business Warehouse への接続を設定してユーザーを作成し、API Server でSAP Business Warehouse データのAPI を追加しました。これで、OData 形式のSAP Business Warehouse データをREST API で利用できます。API Server の「API」ページから、API のエンドポイントを表示およびコピーできます。
オンプレミスDB やファイルからのAPI Server 使用(オプション)
オンプレミスRDB やExcel/CSV などのファイルのデータを使用する場合には、API Server のCloug Gateway / SSH ポートフォワーディングが便利です。是非、Cloud Gatway の設定方法 記事を参考にしてください。
Adalo でアプリを作成する
CData API Server 側の準備が完了したら、早速Adalo 側でアプリ開発を開始します。
- 「CREATE NEW APP」をクリックし
- 今回は「Desktop Web App」を作成します。
- template を最初に選ぶことができますが、今回は検証用なので何も無い「Blank」で作成しました。
- 最後にアプリ名とカラーリング設定を選んで、アプリの準備は完了です。
External Collections の登録
続いてCData API Server への接続をAdalo に追加します。Adalo では「Collection」という形でデータ構造を持ち、アプリのデータを管理することができるのですが、この「Collection」を外部のAPIとシームレスに連携した形で利用することができる「External Collections with APIs」という機能があります。この機能を用いてCData API Server に接続します。
- アプリを作成したら、まず Adalo アプリ内でデータを扱うための定義である「Collection」を登録します。Collection は Adalo 内部の独自DB のような「Database Collections」と、外部のAPI に対してシームレスにアクセスすることが可能な「External Collections」があります。今回は外部のAPI に対してアクセスを行うので「External Collections」で登録します。
- External Collections の登録画面では最初にコレクション名とAPI のベースとなるURL エンドポイントを指定します。任意のCollection 名とAPI Base URL に先程CData API Server で登録したSAP Business Warehouse の対象リソースに接続できるOData のエンドポイントを指定します。併せて認証情報として Header に「x-cdata-authtoken」の名前でCData API Server ユーザー登録時に生成されているTokenを指定します。
- 続いてAdalo から実行されるそれぞれのリクエストの関連付けを行います。通常のAPI であれば様々なチューニングが必要となる箇所ですが、SAP Business Warehouse ではほぼデフォルトの設定のままで進められます。一点だけ設定が必要な箇所として、SAP Business Warehouse からのレスポンスをレコード単位で識別するために「Get All」の設定にある「Results Key」に「value」を登録しておくことが挙げられます。これを設定したら「Next」をクリックしましょう。
- 最後にAPIの「RUN TEST」を行います。
- 「RUN TEST」をクリック後、最終的に以下のようにメッセージとレスポンスが表示されれば、External Collections の作成は完了です。
一覧画面の作成
それでは作成した External Collections を使ってアプリを作っていきましょう。
- まず一覧画面を表示するためにAdalo の画面右上の「+」ボタンをクリックして、「Simple List」をドラッグアンドドロップで画面に配置します。
- 以下のように配置できたら「What is this a list of?」で先程作成したExternal Collections の定義を紐付けます。
- 併せて「Title」と「Subtile」を取得するデータ項目に紐付けましょう。
- プレビューを実行し一覧画面に移動してみると、以下のようにSAP Business Warehouse のデータを取得できていました。
まとめと30日の無償評価版のご案内
このように、SAP Business Warehouse 内のデータをAdalo で利用することができるようになります。CData API Server は、30日の無償評価版があります。是非、お試しいただき、Adalo からのデータ参照を体感ください。