ColdFusion で ODBC 経由のReckon Accounts Hosted のデータをリアルタイムにインポートしてアプリケーションを構築

Dibyendu Datta
Dibyendu Datta
Lead Technology Evangelist
CData ODBC ドライバーを使って、ColdFusion でReckon Accounts Hosted のデータ をインポート・活用。

Adobe ColdFusion は、Web およびモバイルアプリケーションの開発プラットフォームです。独自のスクリプト言語である ColdFusion Markup Language（CFML）を使用して、データ駆動型の Web サイトを作成したり、REST などのリモートサービスを生成したりできます。ColdFusion を CData ODBC Driver for Reckon Accounts Hosted と組み合わせることで、ColdFusion の Web およびモバイルアプリケーションとReckon Accounts Hosted のライブデータを連携できます。これにより、アプリケーションをより堅牢で完全なものにすることができます。この記事では、ODBC ドライバーを使って、ColdFusion マークアップファイル内でReckon Accounts Hosted のデータを取得してテーブルを作成する方法を説明します。

このチュートリアルを進めるには、CData ODBC Driver for Reckon Accounts Hosted と Adobe ColdFusion をインストールする必要があります。

接続の設定

まだ設定していない場合は、ODBC DSN（データソース名）で接続プロパティを指定します。これはドライバーインストールの最終ステップです。Microsoft ODBC データソースアドミニストレーターを使って ODBC DSN を作成・設定できます。

CData 製品 はOAuth 経由でReckon Accounts Hosted にリクエストを作成します。次の接続プロパティを指定します。

  • User： 必須。企業ファイルのユーザー名。
  • Password： 必須。企業ファイルのパスワード。
  • CompanyFile: 必須。企業ファイルへのパス。
  • InitiateOAuth：アクセストークンの処理をドライバーに任せる場合はGETANDREFRESH に設定。
  • CountryVersion：デフォルトは、2021.R2.AU です。

カスタムOAuth アプリケーションを作成し、以下の追加の接続プロパティを指定することもできます。

  • SubscriptionKey：Azure Platform 上のReckon Portal から取得したAPI キー。
  • OAuthClientId：アプリケーション設定のクライアントID に設定。
  • OAuthClientSecret：アプリケーション設定のクライアントシークレットに設定。
  • CallbackURL：カスタムOAuth アプリのリダイレクトURI。

CData は、OAuth デスクトップ認証を簡略化する埋め込みOAuth アプリケーションを提供します。ほかのOAuth 認証方法（Web、ヘッドレスなど）、カスタムOAuth アプリケーションの作成、その理由などについては、ヘルプドキュメントを参照してください。

データソースの追加とテーブルの作成

DSN を作成したら、以下の手順に従って、新しいデータソースを追加し、接続をテストし、ColdFusion マークアップファイルを作成し、最後にReckon Accounts Hosted のデータをインポートして ColdFusion でテーブルに表示します。

  1. ColdFusion 管理インターフェースから、Data & Services を選択します。
  2. ここで「Add New Data Source」をクリックします。データソース名は、ColdFusion の変数命名規則に準拠していれば任意の名前で構いません。ODBC ドライバーの場合は「ODBC Socket」を選択し、「Add」ボタンをクリックします。
  3. ODBC DSN ドロップダウンメニューから CData Reckon Accounts Hosted Sys を選択します。Advanced Settings セクションでは、Connection String は空白のままにしておきます。なお、この入力フィールドで指定されたプロパティは、DSN 設定で指定されたものを上書きします。
  4. 次に、先ほど作成した CDataReckon Accounts HostedODBC データソースの左側にあるチェックマークを押して、接続をテストします。データソースが「OK」ステータスを報告したら、使用する準備ができています。
  5. 次に、新しい ColdFusion マークアップファイル（.cfm）を作成し、ColdFusion の wwwroot ディレクトリ（「C:\ColdFusion2021\cfusion\wwwroot」）に配置します。

    以下のコードでデータソースをクエリします：

              
      <cfquery name="Reckon Accounts HostedQuery" dataSource="CDataReckon Accounts HostedODBC">
        SELECT * FROM Accounts
      </cfquery>
    CFTable を使用すると、HTML でテーブルを簡単に出力できます： 
              
        <cftable
        query = "Reckon Accounts HostedQuery"
        border = "1"
        colHeaders
        colSpacing = "2"
        headerLines = "2"
        HTMLTable
        maxRows = "500"
        startRow = "1">

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

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

        ...

      </cftable>
    HTML 部分を含む完全なコードは以下のとおりです： 
              
      <html>
      <head><title>CData Software | Reckon Accounts Hosted Accounts Table Demo </title></head>
      <body>
      <cfoutput>#ucase("Reckon Accounts Hosted Accounts Table Demo")#</cfoutput>
      <cfquery name="Reckon Accounts HostedQuery" dataSource="CDataReckon Accounts HostedODBC">

        SELECT * FROM Accounts

      </cfquery>
      <cftable
        query = "Reckon Accounts HostedQuery"
        border = "1"
        colHeaders
        colSpacing = "2"
        headerLines = "2"
        HTMLTable
        maxRows = "500"
        startRow = "1">
        <cfcol header="<b>Name</b>" align="Left" width=2 text="Name"/>

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

        ...

      </cftable>
      </body>

      </html>
  6. 最後に、ブラウザでコードを実行します。Reckon Accounts Hosted のデータを含むテーブルが表示されます。

なお、CData ODBC ドライバーは cfqueryparam 要素を使用したパラメータ化クエリもサポートしています。例： 

SELECT * FROM Account WHERE name =

おわりに

CData ODBC Driver for Reckon Accounts Hosted の 30日間無償トライアルをダウンロードして、Adobe ColdFusion でReckon Accounts Hosted 連携アプリケーションの構築を始めましょう。ご不明な点がございましたら、サポートチームまでお問い合わせください。

はじめる準備はできましたか？

Reckon Accounts Hosted ODBC Driver の無料トライアルをダウンロードしてお試しください：

 ダウンロード

詳細：

Reckon Accounts Hosted Icon Reckon Accounts Hosted ODBC Driver お問い合わせ

Reckon Accounts Hosted ODBC ドライバーは、ODBC 接続をサポートする任意のアプリケーションからリアルタイムなReckon Accounts Hosted アカウントデータに直接接続できるパワフルなツールです。標準のODBC ドライバーインタフェースを使用して、データベースのようにReckon Accounts Hosted データにアクセスし、読み、書き、更新を実行できます。

この記事の内容

関連記事