OData SDK for PHP を使ってCertinia のデータを取得

CData Connect Server を使えば、OData を使ってCertinia のデータにアクセスできます。CData Connect Server とOData PHP SDK を利用することで、Certinia のエンティティをPHP で取得して、オブジェクトとしてモデル化できます。

加藤龍彦
デジタルマーケティング

最終更新日:2022-11-25

こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

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

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

Certinia の仮想OData API エンドポイントを作成

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

  1. CData Connect Server にログインして、「DATA MODEL」をクリックします。 データベースを追加
  2. 利用できるデータソースアイコンから"Certinia" を選択します。
  3. Certinia に接続するために必要なプロパティを入力します。

    Certinia 接続プロパティの取得・設定方法

    デフォルトでは、CData 製品は本番環境に接続します。サンドボックスアカウントを使用するには、UseSandboxtrue に設定します。User にサンドボックスのユーザー名を指定してください。

    Certinia への認証

    Certinia への接続に使用できる認証方法は以下のとおりです。

    • ログイン認証
    • SSO
    • OAuth

    ログインおよびトークン

    User およびPassword をログインクレデンシャルに設定します。さらにSecurityToken を設定します。SecurityToken については、信頼できるIP アドレスに利用中のIP を追加することで指定する必要がなくなります。

    セキュリティトークンを無効にするには、以下の手順を実行してください。

    1. Certinia にログインして、「設定」セクションの「Quick Find」ボックスに「Network Access」と入力します。
    2. 使用しているIP アドレスを信頼できるIP アドレスのリストに追加します。

    セキュリティトークンの取得には、以下を実行してください。

    1. Certinia の個人情報設定用ページを開きます。
    2. セキュリティトークンリセット用のリンクをクリックすると、トークンが指定したメールアドレスに送信されます。
    3. 取得したセキュリティトークンを、SecurityToken 接続プロパティに指定するか、Password に追加してください。

    OAuth

    すべてのOAuth フローで、AuthSchemeOAuth に設定する必要があります。詳しい設定方法については、ヘルプドキュメントの「OAuth」セクションを参照してください。

    接続を設定
  4. 「Test Connection」をクリックします。
  5. 「USERS」 -> Add をクリックして、新しいユーザーを追加し、適切な権限を指定します。
  6. API タブをクリックして OData API エンドポイントが生成されていることを確認します。

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

  1. まずは、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\CertiniaEntities.php

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

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

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

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

    require_once 'CertiniaEntities.php'; try{ $svc = new CDataAPI(); $account = new Account(); $account->Industry = 'Floppy Disks'; $svc->AddToAccount($account); $svc->SetSaveChangesOptions(SaveChangesOptions::None); $svc->SaveChanges(); $response = $svc->account()->Execute(); foreach($response->Result as $account) echo $account->BillingState."
    "; } catch (Exception $e) { //CData Connect Server からのエラーをキャッチ echo $e->getError(), "\n"; }

トライアル・お問い合わせ

30日間無償トライアルで、CData のリアルタイムデータ連携をフルにお試しいただけます。記事や製品についてのご質問があればお気軽にお問い合わせください。