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

Dibyendu Datta
Lead Technology Evangelist

CData ODBC ドライバーを使って、ColdFusion でSage Intacct のデータをインポート・活用。

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

Sage Intacct データ連携について

CData は、Sage Intacct のライブデータにアクセスし、統合するための最も簡単な方法を提供します。お客様は CData の接続機能を以下の目的で使用しています：

API の更新や変更を気にすることなく、Sage Intacct にアクセスできます。
追加の構成手順なしで、Sage Intacct のカスタムオブジェクトやフィールドにアクセスできます。
Basic 認証による組み込み Web サービス認証情報を使用して、Sage Intacct にデータを書き戻すことができます。
SQL ストアドプロシージャを使用して、ベンダーの承認・却下、エンゲージメントの挿入、カスタムオブジェクトやフィールドの作成・削除などの機能的な操作を実行できます。

ユーザーは、Tableau、Power BI、Excel などの分析ツールと Sage Intacct を統合し、当社のツールを活用して Sage Intacct データをデータベースやデータウェアハウスにレプリケートしています。

他のお客様が CData の Sage Intacct ソリューションをどのように使用しているかについては、ブログをご覧ください：Drivers in Focus: Accounting Connectivity

はじめに

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

接続の設定

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

Sage Intacct 接続プロパティの取得・設定方法

独自のWeb サービスクレデンシャル、埋め込みクレデンシャル（Basic 認証）、またはOkta クレデンシャルのいずれかを使用して、Sage Intacct への接続を確立できます。

Sage Intacct への認証

Sage Intacct は2種類の認証をサポートします。Basic およびOkta です。選択した認証方法に関連するプロパティを設定して、接続を構成します。

Basic 認証

Basic 認証スキームでは、埋め込みクレデンシャルを使用してデータの読み書きが可能です。オプションとして、独自のWeb サービスクレデンシャルを指定することもできます。

Basic 認証を使用して認証を行うには、以下のプロパティを設定します。

AuthScheme：Basic。
CompanyID：Sage Intacct にログインする際に会社を識別するために使用するID。
User：Sage Intacct へのログインに使用するログイン名。
Password：ログインクレデンシャル用のパスワード。
（オプション）SenderID およびSenderPassword：Web サービスのSender ID およびパスワード（独自のWeb サービスクレデンシャルを使用している場合のみ）。

独自のWeb サービスクレデンシャルではなく、埋め込みクレデンシャルを使用する場合は、以下を実行する必要があります：

Web サービスダッシュボードで、会社 -> 会社情報 -> セキュリティタブに移動します。
Web サービス認証に"CData" を追加します。これは大文字・小文字が区別されます。これを行うには、会社 -> 会社情報（新しいUI では、設定 -> 会社）-> セキュリティ -> Web サービス認証 / 編集に移動します。

Okta 認証についてはヘルプドキュメントを参照してください。

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

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

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

次に、新しい ColdFusion マークアップファイル（.cfm）を作成し、ColdFusion の wwwroot ディレクトリ（「C:\ColdFusion2021\cfusion\wwwroot」）に配置します。

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

          
      <cfquery name="Sage IntacctQuery" dataSource="CDataSage IntacctODBC">
        SELECT * FROM Customer
      </cfquery>

CFTable を使用すると、HTML でテーブルを簡単に出力できます：

          
        <cftable
        query = "Sage IntacctQuery"
        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>TotalDue</b>" align="Left" width=15 text="TotalDue"/>

        ...

      </cftable>

HTML 部分を含む完全なコードは以下のとおりです：

          
      <html>
      <head><title>CData Software | Sage Intacct Customer Table Demo </title></head>
      <body>
      <cfoutput>#ucase("Sage Intacct Customer Table Demo")#</cfoutput>
      <cfquery name="Sage IntacctQuery" dataSource="CDataSage IntacctODBC">

        SELECT * FROM Customer

      </cfquery>
      <cftable
        query = "Sage IntacctQuery"
        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>TotalDue</b>" align="Left" width=15 text="TotalDue"/>

        ...

      </cftable>
      </body>

      </html>