Adalo アプリで使えるEpicor Kinetic のデータ連携用のバックエンドAPI をノーコードで開発

杉本和也
リードエンジニア

ノーコードツールAdalo から Epicor Kinetic のデータに接続するためのバックエンドAPI Server をCData API Server で構築

CData API Server を使って、Adalo から Epicor Kinetic に接続してデータを取得する方法を説明します。

API Server の設定

以下のリンクからAPI Server の無償トライアルをスタートしたら、セキュアなEpicor Kinetic OData サービスを作成していきましょう。

Epicor Kinetic への接続

Adalo からEpicor Kinetic のデータを操作するには、まずEpicor Kinetic への接続を作成・設定します。

API Server にログインして、「Connections」をクリック、さらに「接続を追加」をクリックします。
「接続を追加」をクリックして、データソースがAPI Server に事前にインストールされている場合は、一覧から「Epicor Kinetic」を選択します。
事前にインストールされていない場合は、コネクタを追加していきます。コネクタ追加の手順は以下の記事にまとめてありますので、ご確認ください。
CData コネクタの追加方法はこちら >>
それでは、Epicor Kinetic への接続設定を行っていきましょう！
ERP インスタンスに接続するには、次の接続プロパティを指定してください。
- Url：ERP インスタンスをホストしているサーバーのURL。例えば、https://myserver.EpicorSaaS.com
- ERPInstance：ERP インスタンス名。
- User：アカウントのユーザー名。
- Password：アカウントのパスワード。
- Service：データを取得するサービス。例えば、BaqSvc。
また、オプションで次の接続プロパティを指定することもできます。
- ApiKey：アカウント設定に応じて、いくつかのサービスへの接続に必要となるオプションのキー。
- ApiVersion：デフォルトはv1。新しいEpicor API を使用するにはv2 に設定してください。
- Company：ApiVersion をv2 に設定した場合は必須になります。
接続情報の入力が完了したら、「保存およびテスト」をクリックします。

ERP インスタンスに接続するには、次の接続プロパティを指定してください。

Url：ERP インスタンスをホストしているサーバーのURL。例えば、https://myserver.EpicorSaaS.com
ERPInstance：ERP インスタンス名。
User：アカウントのユーザー名。
Password：アカウントのパスワード。
Service：データを取得するサービス。例えば、BaqSvc。

また、オプションで次の接続プロパティを指定することもできます。

ApiKey：アカウント設定に応じて、いくつかのサービスへの接続に必要となるオプションのキー。
ApiVersion：デフォルトはv1。新しいEpicor API を使用するにはv2 に設定してください。
Company：ApiVersion をv2 に設定した場合は必須になります。

API Server のユーザー設定

次に、API Server 経由でEpicor Kinetic にアクセスするユーザーを作成します。「Users」ページでユーザーを追加・設定できます。やってみましょう。

「Users」ページで ユーザーを追加をクリックすると、「ユーザーを追加」ポップアップが開きます。
次に、「ロール」、「ユーザー名」、「権限」プロパティを設定し、「ユーザーを追加」をクリックします。
その後、ユーザーの認証トークンが生成されます。各ユーザーの認証トークンとその他の情報は「Users」ページで確認できます。

Epicor Kinetic 用のAPI エンドポイントの作成

ユーザーを作成したら、Epicor Kinetic のデータ用のAPI エンドポイントを作成していきます。

まず、「API」ページに移動し、「テーブルを追加」をクリックします。
アクセスしたい接続を選択し、次へをクリックします。
接続を選択した状態で、各テーブルを選択して確認をクリックすることでエンドポイントを作成します。

OData のエンドポイントを取得

以上でEpicor Kinetic への接続を設定してユーザーを作成し、API Server でEpicor Kinetic データのAPI を追加しました。これで、OData 形式のEpicor Kinetic データを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 で登録したEpicor Kinetic の対象リソースに接続できるOData のエンドポイントを指定します。併せて認証情報として Header に「x-cdata-authtoken」の名前でCData API Server ユーザー登録時に生成されているTokenを指定します。

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