OData SDK for PHP を使ってBusiness b-ridge のデータを取得

CData Connect AI はBusiness b-ridge のデータをWeb サービスとして公開します。 この記事の手順を実行することで、Business b-ridge のデータをPHP オブジェクトとして扱うことができるようになります。

CData Connect AI はBusiness b-ridge のデータへのクラウドベースのOData インターフェースを提供し、ODataPHP SDK からBusiness b-ridge のデータへのリアルタイム連携を実現します。

Connect AI を構成

ODataPHP SDK でBusiness b-ridge のデータを操作するには、Connect AI からBusiness b-ridge に接続し、コネクションにユーザーアクセスを提供してBusiness b-ridge のデータのOData エンドポイントを作成する必要があります。

Business b-ridge に接続したら、目的のテーブルのOData エンドポイントを作成します。

（オプション）新しいConnect AI ユーザーの追加

必要であれば、Connect AI 経由でBusiness b-ridge に接続するユーザーを作成します。

1. 「Users」ページに移動し、 Invite Users をクリックします。
2. 新しいユーザーのE メールアドレスを入力して、 Send をクリックしてユーザーを招待します。
3. 「Users」ページからユーザーを確認および編集できます。

パーソナルアクセストークンの追加

OAuth 認証をサポートしていないサービス、アプリケーション、プラットフォーム、またはフレームワークから接続する場合は、認証に使用するパーソナルアクセストークン（PAT）を作成できます。きめ細かなアクセス管理を行うために、サービスごとに個別のPAT を作成するのがベストプラクティスです。

1. Connect AI アプリの右上にあるユーザー名をクリックし、「User Profile」をクリックします。
2. 「User Profile」ページで「Access Token」セクションにスクロールし、 Create PAT をクリックします。
3. PAT の名前を入力して Create をクリックします。
4. パーソナルアクセストークンは作成時にしか表示されないため、必ずコピーして安全に保存してください。

Connect AI からBusiness b-ridge に接続

CData Connect AI では、簡単なクリック操作ベースのインターフェースでデータソースに接続できます。

1. Connect AI にログインし、 Add Connection をクリックします。
2. 「Add Connection」パネルから「Business b-ridge」を選択します。
3. 必要な認証プロパティを入力し、Business b-ridge に接続します。

   Business b-ridge 接続プロパティの取得・設定方法

   Business b-ridge への接続には、Company Key、Project Key、Subscription Key が必要となります。それぞれWeb API 利用申請時に取得できます。取得したKey を接続プロパティに設定して接続します。

   • CompanyKey：Business b-ridge のCompany Key に設定。
   • ProjectKey：Business b-ridge のProject Key に設定。
   • SubscriptionKey：控えておいたSubscription Key に設定。
   
4. Create & Test をクリックします。
5. 「Add Business b-ridge Connection」ページの「Permissions」タブに移動し、ユーザーベースのアクセス許可を更新します。

Connect AI にBusiness b-ridge OData エンドポイントを追加する

Business b-ridge に接続したら、目的のテーブルのOData エンドポイントを作成します。

1. OData ページに移動し、 Add をクリックして新しいOData エンドポイントを作成します。
2. Business b-ridge 接続（例：BusinessBridge1）を選択し、Next をクリックします。
3. 使用するテーブルを選択し、「Confirm」をクリックします。

コネクションとOData エンドポイントを設定したら、ODataPHP SDK からBusiness b-ridge のデータに接続できます。

1. まずは、ODataPHP SDK を使用してCData Connect AI が公開したWeb サービスに接続するプロキシクラスを作成します。

   URI 部分を書き換えて、次のようなコマンドを実行してください。

   php C:\PHPLib\ODataphp\PHPDataSvcUtil.php /uri=https://your-server:8032/api.rsc/@your-personal-access-token/ /out=C:\PHPLib\ODataphp\BusinessBridgeEntities.php
   	    

   このコマンドは、OData エンドポイントが返すメタデータからクラスを定義して、指定したフォルダにクラスの定義を出力します。

   CData Connect AI およびOData SDK for PHP は、どちらもフォームとWindows 認証をサポートします。CData Connect AI はOData エンドポイントへのアクセスが認可されたユーザーの認証に、パーソナルアクセストークンを使用します。パーソナルアクセストークンはHTTP Basic 認証の際に渡したり、OData URL に付加することで使用できます。

   認証済みのユーザーは、CData Connect AI の管理コンソールのUsers セクションで設定できます。

2. これで、PHP のオブジェクト指向インターフェースを使ってBusiness b-ridge のデータにアクセスできます。以下のコードはCDATA テーブルのレコードを作成してリアルタイムデータを取得し、新しく作成したレコードを表示します。

   require_once 'BusinessBridgeEntities.php';
   try{
     $svc = new CDataAPI();
     $cdata = new CDATA();
     $cdata->ItemTypeId = '1';
     $svc->AddToCDATA($cdata);
     $svc->SetSaveChangesOptions(SaveChangesOptions::None);
     $svc->SaveChanges();
     $response = $svc->cdata()->Execute();
     foreach($response->Result as $cdata)
       echo $cdata->ItemId."";
   } catch (Exception $e) {    //CData Connect AI からのエラーをキャッチ
     echo $e->getError(), "\n";
   }