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

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

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

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

接続の設定

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

UM SaaS Cloud 接続プロパティの取得・設定方法

デフォルトでは、CData 製品は本番環境に接続します。UMSaaSCloud sandbox アカウントを使用するには、UseSandbox をtrue に設定します。ユーザー / パスワード認証を使用している場合は、User にsandbox のユーザー名を設定してください。

UM SaaS Cloud への認証

UM SaaS Cloud は、Basic、OAuth、OAuthJWT（コンシューマーキー）など、複数の認証方式をサポートしています。ここではBasic 認証について説明します。認証情報の詳しい取得方法や他の認証方法については、ヘルプドキュメントの「はじめに」セクションを参照してください。

Basic 認証

Basic 認証は、セキュリティトークンとユーザー資格情報の使用に基づきます。Basic 認証を使用するには、AuthScheme をBasic に、User とPassword をログイン資格情報に設定し、SecurityToken を設定します。

デフォルトではSecurityToken が必要ですが、UM SaaS Cloud で信頼できるIP アドレスの範囲を設定することで、オプションにすることができます。

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

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

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

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

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

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

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

        ...

      </cftable>
    HTML 部分を含む完全なコードは以下のとおりです： 
              
      <html>
      <head><title>CData Software | UM SaaS Cloud Account Table Demo </title></head>
      <body>
      <cfoutput>#ucase("UM SaaS Cloud Account Table Demo")#</cfoutput>
      <cfquery name="UM SaaS CloudQuery" dataSource="CDataUM SaaS CloudODBC">

        SELECT * FROM Account

      </cfquery>
      <cftable
        query = "UM SaaS CloudQuery"
        border = "1"
        colHeaders
        colSpacing = "2"
        headerLines = "2"
        HTMLTable
        maxRows = "500"
        startRow = "1">
        <cfcol header="<b>BillingState</b>" align="Left" width=2 text="BillingState"/>

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

        ...

      </cftable>
      </body>

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

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

SELECT * FROM Account WHERE name =

おわりに

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

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

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

 ダウンロード

詳細：

UM SaaS Cloud Icon UM SaaS Cloud ODBC Driver お問い合わせ

UM SaaS Cloud ODBC ドライバーは、ODBC 接続をサポートする任意のアプリケーションからライブなUM SaaS Cloud データに直接接続できる強力なツールです。標準のODBC ドライバーインタフェースを使用して、データベースのようにUM SaaS Cloud にアクセスし、商品、在庫、受発注などの読み出し、書き込み、および更新を実行できます。

この記事の内容

関連記事