各製品の資料を入手。
詳細はこちら →PowerBuilder からZoho Books のデータに連携
この記事では、Zoho Books JDBC ドライバーを使用してPowerBuilder からZoho Books にアクセスする方法を説明します。
最終更新日:2022-06-13
こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
CData JDBC Driver for ZohoBooks は、標準ベースのコントロールであり、PowerBuilder を含むJDBC をサポートするプラットフォームまたは開発テクノロジーから使用できます。 また、PowerBuilder でCData JDBC Driver for ZohoBooks を使用する方法についても詳しく説明します。
この記事では、CData JDBC Driver for ZohoBooks を使用してデータを取得し、基本的なPowerBuilder アプリケーションを作成する方法を説明します。
PowerBuilder からZoho Books のデータに接続
以下のステップに従ってDatabase Painter ツールを使用し、JDBC URL for ZohoBooks に基づいてデータベースプロファイルを作成します。データベースプロファイルを使用して、接続プロパティを保存できます。Ⅾatabase Painter では、データをグラフィカルに操作したり、SQL クエリを実行したりできます。
ドライバーJAR をPowerBuilder クラスパスに追加します。CLASSPATH システム環境変数を、インストールディレクトリのlib サブフォルダにあるドライバーJAR へのパスに設定します。
NotePowerBuilder Classic を使用している場合は、[Tools]->[System Options]->[Java]をクリックし、ドライバーJAR へのパスを追加することもできます。
- [Tools]->[Database Painter]と進みます。
- JDBC のノードを右クリックし、[New Profile]をクリックします。
- [Database Profile Setup]ダイアログで、以下を入力します。
- Profile Name:プロファイルのわかりやすい名前を入力します。
- Driver Name:ドライバーのクラス名にcdata.jdbc.zohobooks.ZohoBooksDriver を入力します。
- URL:JDBC URL を入力します。
Zoho Books 接続プロパティの取得・設定方法
以下の接続プロパティを使用して、取得されるZoho Books データを正確に絞り込むことができます。
- Region:サーバーURL のトップレベルドメイン(TLD)。アカウントが米国以外のドメインにある場合は、リージョンを適宜変更してください。
- OrganizationId(オプション):接続先の特定のZoho Books 組織に関連付けられたID。
- Organization Id の値が接続文字列で指定されていない場合、ドライバーは利用可能なすべての組織を自動的に取得し、最初のOrganization Id をデフォルトとして選択します。
Zoho Books への認証
Zoho Books はOAuth 認証標準を使用します。詳しくは、ヘルプドキュメントの「はじめに」セクションを参照してください。
ビルトイン接続文字列デザイナ
JDBC URL の構成については、Zoho Books JDBC Driver に組み込まれている接続文字列デザイナを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。
java -jar cdata.jdbc.zohobooks.jar
接続プロパティを入力し、接続文字列をクリップボードにコピーします。以下は一般的なJDBC URL です。
jdbc:zohobooks:OAuthClientId=MyOAuthClientId;OAuthClientSecret=myOAuthClientSecret;CallbackURL=https://localhost:33333;OrganizationId=MyOrganizationId;InitiateOAuth=GETANDREFRESH
- テーブルを表示および編集するには、テーブルを右クリックして[Edit Data]->[Grid]をクリックします。

Zoho Books をPowerBuilder Controls と共に使用する
標準のPowerBuilder オブジェクトを使用してJDBC データソースに接続し、クエリを実行できます。以下の例は、Zoho Books をDataWindowに取得する方法を示しています。次のコードをopen メソッドに追加できます。
SQLCA.DBMS = "JDBC"
SQLCA.AutoCommit = False
SQLCA.DBParm = "Driver='cdata.jdbc.zohobooks.ZohoBooksDriver',URL='jdbc:zohobooks:OAuthClientId=MyOAuthClientId;OAuthClientSecret=myOAuthClientSecret;CallbackURL=https://localhost:33333;OrganizationId=MyOrganizationId;InitiateOAuth=GETANDREFRESH";
CONNECT USING SQLCA;
dw_invoices.SetTransObject(SQLCA);
dw_invoices.Retrieve();