各製品の資料を入手。
詳細はこちら →HubSpot のデータを帳票ツールbiz-Stream で連携利用する方法
CData JDBC ドライバを使って、帳票ツールのbiz-Stream で HubSpot をノーコードで連携。
最終更新日:2022-05-18
この記事で実現できるHubSpot 連携のシナリオ
こんにちは!プロダクトスペシャリストの宮本です。
biz-Stream は、多様な表現が可能なWeb 帳票ソリューションです。
この記事では、biz-Stream からCData JDBC ドライバ経由でHubSpot のデータにリアルタイムで連携接続して帳票から利用する方法を紹介します。CData Drivers を使うことで、RDB のようにbiz-Stream 内でHubSpot のデータを扱うことができるようになります。
biz-Stream へのHubSpot JDBC ドライバーの配置
デフォルトの内容でインストールした場合、以下のパスに jar ファイルが配置されますので、その jar ファイルを biz-Stream の所定のパスにコピーします。
- cdata.jdbc.hubspot.jar
- cdata.jdbc.hubspot.lic (試用版では.lic ファイルは不要)
- コピー元:C:\Program Files\CData\CData JDBC Driver for HubSpot 20xxJ\lib
- コピー先:C:\Program Files (x86)\brainsellers\biz-Stream レイアウト・デザイナ\lib_jdbc
biz-Stream からHubSpot への接続設定
レイアウトデザイナを起動後、リソース定義にて HubSpot への接続設定を行います。ドライバー選択のプルダウンに CData HubSpot JDBC Driver が表示されますので選択します。
HubSpot 接続プロパティの取得・設定方法
HubSpot はOAuth 認証 およびPrivateAppToken ベース認証をサポートします。
OAuth
HubSpot は埋め込みOAuth 認証情報を提供しており、デスクトップアプリケーションまたはヘッドレスマシンから簡単に接続できます。 Web アプリケーションから接続するには、カスタムOAuth アプリケーションを作成する必要があります。 OAuth 経由で接続するには、すべての認証フローでAuthScheme をOAuth に設定します。 ヘルプドキュメントでは、利用可能なOAuth フローでのHubSpot への認証について詳しく説明します。 カスタムOAuth アプリケーションの作成についての情報と、すでに埋め込みOAuth 認証情報を持つ認証フローでもカスタムOAuth アプリケーションを作成したほうがよい場合の説明については、「カスタムOAuth アプリケーションの作成」セクション を参照してください。
また、PrivateAppToken ベース認証についてはヘルプドキュメントの「接続の確立」セクションを参照してください。
サーバURLは以下の形式で入力します。
URL: jdbc:hubspot:InitiateOAuth=GETANDREFRESH

JDBC Driver の接続文字列デザイナーを使う
JDBC 接続文字列を作るには、HubSpot JDBC Driver のビルトイン接続文字列デザイナーを使う方法があります。ドライバーの.jar ファイルをダブルクリックするか、コマンドラインから.jar ファイルを実行します。
Windows:
java -jar 'C:\Program Files\CData\CData JDBC Driver for HubSpot 20xxJ\lib\cdata.jdbc.hubspot.jar'
MacOS:
java -jar cdata.jdbc.hubspot.jar
接続プロパティに値を入力して、生成される接続文字列をクリップボードにコピーします。

次にデータ取得条件を設定します。SQL 定義から定義名を設定し、編集ボタンをクリックします。

上のグレーエリアで右クリック → テーブルリストと選択しますと、HubSpot のオブジェクトがリストで表示されます。使用するテーブルを選択します。

ここでは取得対象の項目や条件などを設定することができます。対象項目や条件を指定できたらOKボタンをクリックし、戻った画面で追加ボタンをクリックします。

最後にデータソース設定を行います。データソース定義名に先ほど設定したものを選択し、画面下部にある追加ボタンをクリックします。これでbiz-Stream でHubSpot のデータを利用する準備ができました。

HubSpot のデータをリアルタイムで参照するbiz-Stream 帳票のデザイン
用紙設定を行います。今回は A4 設定にしました。設定後は画面下部にある追加ボタンをクリックします。
ページ設定では新規ボタンをクリックします。
ここではレイアウトデザイナが帳票テンプレートを xml で保存しますので、ファイル名を設定します。
レイアウトにはさまざまなメニューがありますが、今回は表を使用します。表を設定後、HubSpot から取得したデータをセットするエリアを作成します。各セルにテキストボックスを挿入し、そのテキストボックス自体に HubSpot の項目を紐づけします。
※ヘッダーにもそれぞれテキストボックスを追加します。

レイアウト作成画面を閉じた後、ページ設定の画面に戻りますので、画面下部にある追加ボタン(一度作成している場合は適用)をクリックし、レイアウトの作成が完了となります。
レイアウトデザイナーのトップ画面のヘッダーメニューからプレビューアイコンをクリックします。先ほど作成したレイアウトで HubSpot のデータを表示させることができます。
このようにCData JDBC ドライバをアップロードすることで、簡単にbiz-Stream でHubSpot のデータをリアルタイムに参照する帳票をノーコードで連携して作成することができます。
ぜひ、CData JDBC Driver for HubSpot 30日の無償評価版 をダウンロードして、お試しください。