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

Dibyendu Datta
Lead Technology Evangelist

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

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

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

接続の設定

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

Salesforce Marketing Cloud API への認証

User およびPassword をログインクレデンシャルに設定するか、sandbox アカウントに接続する場合はsandbox ユーザーのクレデンシャルに設定します。

Salesforce Marketing Cloud API への接続

デフォルトでは、CData 製品は本番環境に接続します。Salesforce Marketing Cloud sandbox アカウントを使用するには、UseSandbox をtrue に設定します。

デフォルトのインスタンスは、Web Services API s7 です。他のインスタンスを使用する場合は、Instance を設定できます。

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

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

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

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

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

          
      <cfquery name="Salesforce MarketingQuery" dataSource="CDataSalesforce MarketingODBC">
        SELECT * FROM Subscriber
      </cfquery>

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

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

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

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

        ...

      </cftable>

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

          
      <html>
      <head><title>CData Software | Salesforce Marketing Subscriber Table Demo </title></head>
      <body>
      <cfoutput>#ucase("Salesforce Marketing Subscriber Table Demo")#</cfoutput>
      <cfquery name="Salesforce MarketingQuery" dataSource="CDataSalesforce MarketingODBC">

        SELECT * FROM Subscriber

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

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

        ...

      </cftable>
      </body>

      </html>

最後に、ブラウザでコードを実行します。Salesforce Marketing のデータを含むテーブルが表示されます。

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

SELECT * FROM Account WHERE name =

おわりに

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

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

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

ダウンロード

詳細：

Salesforce Marketing ODBC Driver お問い合わせ

Salesforce Marketing Cloud ODBC Driver は、ODBC 接続をサポートするさまざまなアプリケーションからSalesforce Marketing Cloudデータへの接続を実現するパワフルなツールです。

標準のODBC ドライバーインターフェースを使用して、データベースのようにSalesforce Marketing Cloud データにアクセスし、Accounts、Emails、Lists、Subscribers などの読み、書き、更新を実行できます。

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

接続の設定

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

おわりに

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

この記事の内容

関連記事