本記事では CData サポート担当からこんなことを聞かれたらどこを確認すべきか?という観点で、よく頂くお問合せ内容をご紹介します。
記事はこちら →CData ODBC Driver for TaxJar は、PHP アプリケーションからのTaxJar データへの連携を可能にします。本記事では、TaxJar データをPHP のビルトインODBC 機能でクエリを実行する手順を説明します。
TaxJar に接続するDSN を作成します。
TaxJar API への認証には、まず初めにTaxJar UI からAPI キーを取得する必要があります。
NOTE:API の利用は、Professional およびPremium TaxJar プランでのみ可能です。
すでにProfessional またはPremium プランをお持ちの方は、TaxJar UI にログインして、「アカウント」->「TaxJar API」に移動するとAPI キーを確認することができます。 API キーを取得したら、APIKey 接続プロパティに設定できます。
一般的な接続文字列:
APIKey=3bb04218ef8t80efdf1739abf7257144;
ビルトインのデータソースアドミニストレーターでDSN 設定をします。ドライバーのインストールの最後にアドミニストレーターが開きます。ヘルプの「はじめに」でODBC データソースアドミニストレータでTaxJar に接続するDSN の設定方法を参照してください。
odbc_connect を呼び出して、TaxJar への接続を開きます。 odbc_pconnect メソッドでも可能です。コネクションを閉じるには、odbc_close もしくはodbc_close_all を使います。
$conn = odbc_connect("CData ODBC TaxJar Source","user","password");
コネクションはodbc_connect で開かれ、スクリプトが終わると終了します。odbc_pconnect メソッドで開いたコネクションは、スクリプトが終わっても開いたままです。これにより同じクレデンシャルであれば他のスクリプトでコネクションを共有することが可能です:
$conn = odbc_pconnect("CData ODBC TaxJar Source","user","password");
...
odbc_close($conn); //persistent connection must be closed explicitly
odbc_prepare を使って、Prepared ステートメントおよびパラメータライズドクエリを作成します。
$query = odbc_prepare($conn, "SELECT * FROM Orders WHERE TransactionID = ?");
Prepared ステートメントをodbc_execute を使って実行します。
$conn = odbc_connect("CData ODBC TaxJar Source","user","password");
$query = odbc_prepare($conn, "SELECT * FROM Orders WHERE TransactionID = ?");
$success = odbc_execute($query, array('123'));
Non-Parameterized クエリは、odbc_exec を使います。
$conn = odbc_connect("CData ODBC TaxJar Source","user","password");
$query = odbc_exec($conn, "SELECT * FROM Orders");
odbc_fetch_array ファンクションの結果セット配列としてアクセスします。
$conn = odbc_connect("CData ODBC TaxJar data Source","user","password");
$query = odbc_exec($conn, "SELECT * FROM Orders");
while($row = odbc_fetch_array($query)){
echo $row["TransactionID"] . "\n";
}
odbc_result_all ファンクションで、結果セットをHTML テーブルとして表示します。
$conn = odbc_connect("CData ODBC TaxJar data Source","user","password");
$query = odbc_prepare($conn, "SELECT * FROM Orders WHERE TransactionID = ?");
$success = odbc_execute($query, array('123'));
if($success)
odbc_result_all($query);
スタンドアロンのテスト環境をたちあげる簡単な方法はPHP のビルトインテストサーバーを使うことです。手順はこちらです:
PHP の最新版のバイナリのダウンロード。
フォルダにファイルを入れる。
フォルダを開く。
php.ini-development をphp.ini に変更。
ブラウザからテストスクリプトにアクセスするためのコマンドを実行。
php -S localhost:8000 -t C:\path-to-your-scripts -c C:\path-to-php\php.ini
サポートされているSQL の詳細は、ヘルプドキュメントを参照してください。上のサンプルは、PHP community documentation for all ODBC functions のTaxJar に特化したものです。