PHP のOData SDK を使用したQuickbase のデータのクエリ

CData API Server は、ADO.NET Provider for Quickbase（またはその他の250+ ADO.NET Providers のデータ）と組み合わせることでWeb サービスとしてQuickbase のデータを公開します。下記の手順に従って、Quickbase のデータをオブジェクトとして使用します。

API Server の設定

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

Quickbase への接続

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

1. API Server にログインして、「Connections」をクリック、さらに「接続を追加」をクリックします。
2. 「接続を追加」をクリックして、データソースがAPI Server に事前にインストールされている場合は、一覧から「Quickbase」を選択します。
3. 事前にインストールされていない場合は、コネクタを追加していきます。コネクタ追加の手順は以下の記事にまとめてありますので、ご確認ください。
   CData コネクタの追加方法はこちら >>
4. それでは、Quickbase への接続設定を行っていきましょう！

5. ユーザー認証方法

   ユーザー資格情報で認証するには、次の接続プロパティを設定してください。

   1. User とPassword を設定します。
   2. アプリケーションがApplicationToken を必要とする場合には、指定しない場合にはエラーが発生します。 ApplicationToken は、SpecificApp > Settings > App management > App properties > Advanced settings > Security options > Manage Application Token に移動して取得できます。

   ユーザートークン認証

   ユーザートークンで認証するには、次の接続プロパティを設定してください。

   1. UserToken を設定すれば接続できます。UserToken は、Quick Base > My Preferences > My User Information > Manage User Tokens から確認できます。
6. 接続情報の入力が完了したら、「保存およびテスト」をクリックします。

ユーザー認証方法

ユーザー資格情報で認証するには、次の接続プロパティを設定してください。

1. User とPassword を設定します。
2. アプリケーションがApplicationToken を必要とする場合には、指定しない場合にはエラーが発生します。 ApplicationToken は、SpecificApp > Settings > App management > App properties > Advanced settings > Security options > Manage Application Token に移動して取得できます。

ユーザートークン認証

ユーザートークンで認証するには、次の接続プロパティを設定してください。

1. UserToken を設定すれば接続できます。UserToken は、Quick Base > My Preferences > My User Information > Manage User Tokens から確認できます。

API Server のユーザー設定

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

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

Quickbase 用のAPI エンドポイントの作成

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

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

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

以上でQuickbase への接続を設定してユーザーを作成し、API Server でQuickbase データのAPI を追加しました。これで、OData 形式のQuickbase データをREST API で利用できます。API Server の「API」ページから、API のエンドポイントを表示およびコピーできます。

ユーザー認証方法

ユーザー資格情報で認証するには、次の接続プロパティを設定してください。

1. User とPassword を設定します。
2. アプリケーションがApplicationToken を必要とする場合には、指定しない場合にはエラーが発生します。 ApplicationToken は、SpecificApp > Settings > App management > App properties > Advanced settings > Security options > Manage Application Token に移動して取得できます。

ユーザートークン認証

ユーザートークンで認証するには、次の接続プロパティを設定してください。

1. UserToken を設定すれば接続できます。UserToken は、Quick Base > My Preferences > My User Information > Manage User Tokens から確認できます。

さらに、OData SDK for PHP との互換性のためにAPI Server を構成します。「Settings」をクリックし、OData セクションで「デフォルトバージョン」を2.0 に設定します。

API Server に接続するユーザーの認証トークンを取得

作成するOData サービスを決定したら、「Users」をクリックして任意のユーザーをクリックし、ユーザーの認証トークンを取得します。API Server は、認証トークンベースの認証を使用して、主要な認証スキームをサポートします。SSL を使用すれば、接続の認証だけでなく、暗号化も可能です。IP アドレスを使用してアクセスを制限することも可能です。デフォルトでは、ローカルマシンからの接続のみが許可されます。

わかりやすくするために、URL に認証トークンを設定してAPI Server への認証を行います。これはデフォルトでは有効になっていないため、API Server の構成ファイルであるsettings.cfg に以下の行を追加する必要があります。

[Application]
AllowAuthTokenInUrl = true

settings.cfg ファイルはデータディレクトリに配置されています。.NET 版では、www の下のapp_data フォルダがデータディレクトリになっています。Java 版でのデータディレクトリの位置は、OS によって変わります。

• Windows：C:\ProgramData\CData\Quickbase\
• Unix or Mac OS X：~/cdata/Quickbase/

Quickbase エンティティをPHP オブジェクトとして使用する

以下のステップに従ってOData PHP SDK を使用し、API Server によって公開されるWeb サービスに接続するプロキシクラスを作成します。

1. 以下のようなコマンドにURL を渡します。

   php C:\PHPLib\ODataphp\PHPDataSvcUtil.php /uri=https://your-server:8032/api.rsc/@your-authtoken/ /out=C:\PHPLib\ODataphp\QuickbaseEntities.php

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

   API Server とOData SDK for PHP は、フォーム認証とWindows 認証をサポートします。API Server は、認証トークンを使用してOData エンドポイントへのアクセスを許可されたユーザーを認証します。HTTP Basic 認証で認証トークを指定するか、OData URL に追加することができます。

   許可されたユーザーは、API Server の「Users」セクションで設定できます。

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

   require_once 'QuickbaseEntities.php';
   try{
     $svc = new CData();
     $sampletable_1 = new SampleTable_1();
     $sampletable_1->Column2 = '100';
     $svc->AddToSampleTable_1($sampletable_1);
     $svc->SetSaveChangesOptions(SaveChangesOptions::None);
     $svc->SaveChanges();
     $response = $svc->sampletable_1()->Execute();
     foreach($response->Result as $sampletable_1)
       echo $sampletable_1->Id."";
   } catch (Exception $e) {    //catch errors from the API Server
     echo $e->getError(), "\n";
   }