各製品の資料を入手。
詳細はこちら →製品をチェック
製品の詳細・30日間の無償トライアルはこちら
CData ConnectOData SDK for PHP を使ってGaroon のデータを取得
CData Connect Server を使えば、OData を使ってGaroon のデータにアクセスできます。CData Connect Server とOData PHP SDK を利用することで、Garoon のエンティティをPHP で取得して、オブジェクトとしてモデル化できます。
加藤龍彦デジタルマーケティング
最終更新日:2022-11-25
こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
CData Connect Server はGaroon のデータをWeb サービスとして公開します。 この記事の手順を実行することで、Garoon のデータをPHP オブジェクトとして扱うことができるようになります。
CData Connect Server はGaroon のデータへのクラウドベースのOData インターフェースを提供し、ODataPHP SDK からGaroon のデータへのリアルタイム連携を実現します。
Garoon の仮想OData API エンドポイントを作成
まずCData Connect Server でデータソースへの接続およびOData API エンドポイント作成を行います。
- CData Connect Server にログインして、「DATA MODEL」をクリックします。
- 利用できるデータソースアイコンから"Garoon" を選択します。
-
Garoon に接続するために必要なプロパティを入力します。
Garoon への認証は、パスワード認証、Basic 認証、クライアントSSL をサポートしています。
パスワード認証
Garoon への認証には、以下を設定する必要があります。
- Url:アカウントのURL。
- User:アカウントのユーザー名。
- Password:アカウントのパスワード。
Basic 認証
Basic 認証セキュリティ機能がドメインに設定されている場合は、BasicAuthUser とBasicAuthPassword の追加ログイン資格情報を指定します。Basic 認証ではUser とPassword に加えて、これらのクレデンシャルが必要です。
クライアントSSL
Basic 認証の代わりに、クライアント証明書を指定してCData 製品を認証できます。 SSLClientCert、SSLClientCertType、 SSLClientCertSubject、 およびSSLClientCertPassword を設定します。 さらに、User とPassword をGaroon のログイン資格情報に設定します。
- 「Test Connection」をクリックします。
- 「USERS」 -> Add をクリックして、新しいユーザーを追加し、適切な権限を指定します。
- API タブをクリックして OData API エンドポイントが生成されていることを確認します。
コネクションとOData エンドポイントを設定したら、PHP からGaroon のデータに接続できます。
-
まずは、ODataPHP SDK を使用してCData Connect Server が公開したWeb サービスに接続するプロキシクラスを作成します。
URI 部分を書き換えて、次のようなコマンドを実行してください。
php C:\PHPLib\ODataphp\PHPDataSvcUtil.php /uri=https://your-server:8032/api.rsc/@your-authtoken/ /out=C:\PHPLib\ODataphp\GaroonEntities.php
このコマンドは、OData エンドポイントが返すメタデータからクラスを定義して、指定したフォルダにクラスの定義を出力します。
CData Connect Server およびOData SDK for PHP は、どちらもフォームとWindows 認証をサポートします。CData Connect Server はOData エンドポイントへのアクセスが認可されたユーザーの認証に、認証トークンを使用します。認証トークンはHTTP Basic 認証の際に渡したり、OData URL に付加することで使用できます。
認証済みのユーザーは、CData Connect Server の管理コンソールのUsers セクションで設定できます。
-
これで、PHP のオブジェクト指向インターフェースを使ってGaroon のデータにアクセスできます。以下のコードはEvents テーブルのレコードを作成してリアルタイムデータを取得し、新しく作成したレコードを表示します。
require_once 'GaroonEntities.php'; try{ $svc = new CDataAPI(); $events = new Events(); $events->CreatorName = 'Bob'; $svc->AddToEvents($events); $svc->SetSaveChangesOptions(SaveChangesOptions::None); $svc->SaveChanges(); $response = $svc->events()->Execute(); foreach($response->Result as $events) echo $events->Id.""; } catch (Exception $e) { //CData Connect Server からのエラーをキャッチ echo $e->getError(), "\n"; }
おl>