製品をチェック

Zoho Books Driver の30日間無償トライアルをダウンロード

30日間の無償トライアルへ

製品の詳細

Zoho Books JDBC Driver

お困りの点はございませんか？

類似の事例やソリューションを探す

データ連携のスペシャリストにご相談ください

Zoho Books 連携について相談する

ColdFusion にリアルタイムZoho Books のデータをインポートしてアプリケーションを構築

CData JDBC ドライバを使ってColdFusion にZoho Books のデータをインポートして使用します。

古川えりか
コンテンツスペシャリスト
最終更新日：2023-02-02

この記事で実現できるZoho Books 連携のシナリオ

CData

こんにちは！ドライバー周りのヘルプドキュメントを担当している古川です。

Adobe ColdFusion は、Web アプリケーションおよびモバイルアプリケーション開発プラットフォームです。独自のスクリプト言語であるColdFusion Markup Language（CFML）を使用し、データドリブンなWeb サイトを作成したり、REST などのリモートサービスを生成したりすることができます。

ColdFusion とCData JDBC Driver for ZohoBooks を組み合わせると、ColdFusion のWeb アプリケーションやモバイルアプリケーションを、運用中のZoho Books のデータにリンクできます。これにより、アプリケーションの堅牢性と完成度を高めることができます。この記事では、JDBC ドライバーを使ってColdFusion マークアップファイルからZoho Books のデータを入力したテーブルを作成する方法について詳しく説明します。

最適化されたデータ処理が組み込まれたCData JDBC ドライバは、リアルタイムZoho Books のデータを扱う上で高いパフォーマンスを提供します。 Zoho Books にSQL クエリを発行すると、CData ドライバーはフィルタや集計などのZoho Books 側でサポートしているSQL 操作をZoho Books に直接渡し、サポートされていない操作（主にSQL 関数とJOIN 操作）は組み込みSQL エンジンを利用してクライアント側で処理します。組み込みの動的メタデータクエリを使用すると、ネイティブのデータ型を使ってZoho Books のデータを操作および分析できます。

Zoho Books への接続を設定する

Coldfusion とZoho Books の接続を確立するには、JDBC 接続文字列が必要です。

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 を生成（zoho books の場合）

データソースを追加してテーブルを作成する

接続を設定したのち、次の手順に従ってはじめにCData JDBC ドライバをColdFusion のlib ディレクトリに追加し、続けて新しいデータソースを追加、接続をテスト、ColdFusion マークアップファイルを作成し、最後にZoho Books のデータとリアルタイム接続してColdFusion Markup Language（CFML）で記述されるテーブルに表示します。

JDBC Driver for ZohoBooks およびlic ファイルを"C:\Program Files\CData\CData JDBC Driver for ZohoBooks\lib" から"C:\ColdFusion2021\cfusion\wwwroot\WEB-INF\lib"にコピーします。 cdata.jdbc.zohobooks.jar cdata.jdbc.zohobooks.lic
Note：.lic ファイルをjar ファイルとともにコピーしないと、有効なライセンスがインストールされていないことを示すライセンスエラーが表示されます。これは評価版、製品版ともに同様です。
ColdFusion Administrator インターフェースで「データとサービス」を選択します。
「新規のデータソースの追加」を行います。データソース名は、ColdFusion の変数命名規則に従っていればどのような名前でもかまいません。 JDBC ドライバーの場合は、「その他」を選択して「追加」ボタンをクリックします。
次に、ドライバーのプロパティを入力します。
- 「JDBC URL」は、次のような形式である必要があります： jdbc:zohobooks:|connectionString|
- 典型的な接続文字列は次のようになります：
  jdbc:zohobooks:OAuthClientId=MyOAuthClientId;OAuthClientSecret=myOAuthClientSecret;CallbackURL=https://localhost:33333;OrganizationId=MyOrganizationId;InitiateOAuth=GETANDREFRESH
- 「ドライバクラス」は次のようになります：cdata.jdbc.zohobooks.ZohoBooksDriver
- 「ドライバ名」の入力は任意で、これは単にColdFusion Administrator コンソールでデータソースを認識するために使われます。
ここで、作成したCDataZoho BooksJDBC データソースの左側にあるチェックマークをクリックして、接続をテストしてください。データソースのステータスが「OK」になると、使用可能な状態です。

次に、ColdFusion Markup ファイル（.cfm）を新規作成し、ColdFusion のwwwroot ディレクトリ（"C:\ColdFusion2021\cfusion\wwwroot"）に配置します。

次のコードは、データソースにクエリを実行します。

            
        <cfquery name="Zoho BooksQuery" dataSource="CDataZoho BooksJDBC">
          SELECT * FROM INVOICES
        </cfquery>

CFTable を使用すると、HTML で素早くテーブルを出力できます。

            
          <cftable
          query = "Zoho BooksQuery"
          border = "1"
          colHeaders
          colSpacing = "2"
          headerLines = "2"
          HTMLTable
          maxRows = "500"
          startRow = "1">

          <cfcol header="<b>InvoiceId</b>" align="Left" width=2 text="InvoiceId"/>

          <cfcol header="<b>InvoiceNumber</b>" align="Left" width=15 text="InvoiceNumber"/>

          ...

        </cftable>

HTML 部分を含むコード全体を以下に掲載します。

            
        <html>
        <head><title>CData Software | Zoho Books INVOICES Table Demo </title></head>
        <body>
        <cfoutput>#ucase("Zoho Books INVOICES Table Demo")#</cfoutput>
        <cfquery name="Zoho BooksQuery" dataSource="CDataZoho BooksJDBC">

          SELECT * FROM INVOICES

        </cfquery>
        <cftable
          query = "Zoho BooksQuery"
          border = "1"
          colHeaders
          colSpacing = "2"
          headerLines = "2"
          HTMLTable
          maxRows = "500"
          startRow = "1">
          <cfcol header="<b>InvoiceId</b>" align="Left" width=2 text="InvoiceId"/>

          <cfcol header="<b>InvoiceNumber</b>" align="Left" width=15 text="InvoiceNumber"/>

          ...

        </cftable>
        </body>

        </html>

最後に、デフォルトのポート8500のブラウザでコードをローカルに実行します。これでZoho Books のデータが入力されたテーブルが作成されました！

なお、CData JDBC ドライバはcfqueryparam 要素を使用したパラメータ化クエリもサポートしています。次に例を示します。 SELECT * FROM Account WHERE name =

今日からはじめましょう

CData JDBC Driver for ZohoBooks の 30日間無償トライアルをダウンロードして、Adobe ColdFusion でZoho Books と連携したアプリケーションの作成をはじめましょう！ご不明な点があれば、サポートチームにお問い合わせください。

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

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

無償トライアルへ

お問い合わせ

ソリューション

サポート

ブログへ →

ナレッジベース