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

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

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

HubSpot データ連携について

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

  • API の更新や変更を気にすることなく、HubSpot にアクセスできます。
  • 追加の構成手順なしで、HubSpot のカスタムオブジェクトやフィールドにアクセスできます。
  • SQL ストアドプロシージャを使用して、添付ファイルのアップロード・ダウンロード、エンゲージメントの挿入、カスタムオブジェクトやフィールドの作成・削除などの機能的な操作を実行できます。

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

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


はじめに


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

接続の設定

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

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

HubSpot はOAuth 認証 およびPrivateAppToken ベース認証をサポートします。

OAuth

HubSpot は埋め込みOAuth 認証情報を提供しており、デスクトップアプリケーションまたはヘッドレスマシンから簡単に接続できます。 Web アプリケーションから接続するには、カスタムOAuth アプリケーションを作成する必要があります。 OAuth 経由で接続するには、すべての認証フローでAuthScheme をOAuth に設定します。 ヘルプドキュメントでは、利用可能なOAuth フローでのHubSpot への認証について詳しく説明します。 カスタムOAuth アプリケーションの作成についての情報と、すでに埋め込みOAuth 認証情報を持つ認証フローでもカスタムOAuth アプリケーションを作成したほうがよい場合の説明については、「カスタムOAuth アプリケーションの作成」セクション を参照してください。

また、PrivateAppToken ベース認証についてはヘルプドキュメントの「接続の確立」セクションを参照してください。

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

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

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

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

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

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

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

        ...

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

        SELECT * FROM Prospects

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

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

        ...

      </cftable>
      </body>

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

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

SELECT * FROM Account WHERE name =

おわりに

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

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

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

 ダウンロード

詳細：

HubSpot Icon HubSpot ODBC Driver お問い合わせ

HubSpot ODBC ドライバーは、ODBC 接続をサポートする任意のアプリケーションからリアルタイムなHubSpot データに直接接続できるパワフルなツールです。標準のODBC ドライバーインタフェースを使用して、データベースのようにHubSpot にアクセスし、連絡先、取引、電子メール、会社などの読み、書き、更新を実行できます。

この記事の内容

関連記事