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

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

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

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

接続の設定

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

それでは、Salesforce Data Cloud への認証方法を設定していきましょう。Salesforce Data Cloud では、OAuth 標準による認証をサポートしています。

OAuth 認証

AuthScheme をOAuth に設定してください。

デスクトップアプリケーション

CData 製品では、デスクトップでの認証を簡略化する埋め込みOAuth アプリケーションを提供しています。

また、Salesforce Data Cloud コンソールで設定および登録するカスタムOAuth アプリケーションを介してデスクトップから認証することも可能です。詳しくは、ヘルプドキュメントのカスタムOAuth アプリの作成をご確認ください。

接続する前に、以下のプロパティを設定してください。

  • InitiateOAuth：GETANDREFRESH。InitiateOAuth を使用すれば、繰り返しOAuth の交換を行ったり、手動でOAuthAccessToken を設定する必要がなくなります
  • OAuthClientId（カスタムアプリケーションのみ）：カスタムOAuth アプリケーションの登録時に割り当てられたクライアントID
  • OAuthClientSecret（カスタムアプリケーションのみ）：カスタムOAuth アプリケーションの登録時に割り当てられたクライアントシークレット

接続すると、CData 製品がデフォルトブラウザでSalesforce Data Cloud のOAuth エンドポイントを開きます。ログインして、アプリケーションにアクセス許可を与えてください。

以下のようにドライバーがOAuth プロセスを完了します。

  • コールバックURL からアクセストークンを取得します
  • 古いトークンの期限が切れた際は、新しいアクセストークンを取得します
  • OAuthSettingsLocation にOAuth 値を保存し、接続間で永続化します

Web アプリケーションやヘッドレスマシンを含むその他のOAuth 認証方法については、ヘルプドキュメントをご確認ください。

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

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

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

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

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

        <cfcol header="<b>[Account ID]</b>" align="Left" width=2 text="[Account ID]"/>

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

        ...

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

        SELECT * FROM Account

      </cfquery>
      <cftable
        query = "Salesforce Data CloudQuery"
        border = "1"
        colHeaders
        colSpacing = "2"
        headerLines = "2"
        HTMLTable
        maxRows = "500"
        startRow = "1">
        <cfcol header="<b>[Account ID]</b>" align="Left" width=2 text="[Account ID]"/>

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

        ...

      </cftable>
      </body>

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

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

SELECT * FROM Account WHERE name =

おわりに

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

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

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

 ダウンロード

詳細：

Salesforce Data Cloud Icon Salesforce Data Cloud ODBC Driver お問い合わせ

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

この記事の内容

関連記事