各製品の資料を入手。
詳細はこちら →Salesforce Data Cloud のデータを帳票ツールbiz-Stream で連携利用する方法
CData JDBC ドライバを使って、帳票ツールのbiz-Stream で Salesforce Data Cloud をノーコードで連携。
最終更新日:2022-05-18
この記事で実現できるSalesforce Data Cloud 連携のシナリオ
こんにちは!プロダクトスペシャリストの宮本です。
biz-Stream は、多様な表現が可能なWeb 帳票ソリューションです。
この記事では、biz-Stream からCData JDBC ドライバ経由でSalesforce Data Cloud のデータにリアルタイムで連携接続して帳票から利用する方法を紹介します。CData Drivers を使うことで、RDB のようにbiz-Stream 内でSalesforce Data Cloud のデータを扱うことができるようになります。
biz-Stream へのSalesforce Data Cloud JDBC ドライバーの配置
デフォルトの内容でインストールした場合、以下のパスに jar ファイルが配置されますので、その jar ファイルを biz-Stream の所定のパスにコピーします。
- cdata.jdbc.salesforcedatacloud.jar
- cdata.jdbc.salesforcedatacloud.lic (試用版では.lic ファイルは不要)
- コピー元:C:\Program Files\CData\CData JDBC Driver for SalesforceDataCloud 20xxJ\lib
- コピー先:C:\Program Files (x86)\brainsellers\biz-Stream レイアウト・デザイナ\lib_jdbc
biz-Stream からSalesforce Data Cloud への接続設定
レイアウトデザイナを起動後、リソース定義にて Salesforce Data Cloud への接続設定を行います。ドライバー選択のプルダウンに CData SalesforceDataCloud JDBC Driver が表示されますので選択します。
Salesforce Data Cloud は、OAuth 標準による認証をサポートしています。
OAuth
AuthScheme をOAuth に設定します。
デスクトップアプリケーション
CData は、デスクトップでの認証を簡略化する埋め込みOAuth アプリケーションを提供します。
また、Salesforce Data Cloud コンソールで設定および登録するカスタムOAuth アプリケーションを介してデスクトップから認証することもできます。詳しくは、ヘルプドキュメントのカスタムOAuth アプリの作成を参照してください。
接続する前に、次のプロパティを設定します。
- InitiateOAuth:GETANDREFRESH。InitiateOAuth を使えば、繰り返しOAuth の交換を行ったり、手動でOAuthAccessToken を設定する必要はなくなります。
- OAuthClientId (カスタムアプリケーションのみ):カスタムOAuth アプリケーションの登録時に割り当てられたクライアントID。
- OAuthClientSecret (カスタムアプリケーションのみ):カスタムOAuth アプリケーションの登録時に割り当てられたクライアントシークレット。
接続すると、本製品 はデフォルトブラウザでSalesforce Data Cloud のOAuth エンドポイントを開きます。ログインして、アプリケーションにアクセス許可を与えます。
以下のようにドライバーがOAuth プロセスを完了します。
- コールバックURL からアクセストークンを取得します。
- 古いトークンの期限が切れたときは、新しいアクセストークンを取得します。
- OAuthSettingsLocation にOAuth 値を保存し、接続間で永続化します。
Web アプリケーションやヘッドレスマシンを含むその他のOAuth メソッドについては、ヘルプドキュメントを参照してください。
サーバURLは以下の形式で入力します。
URL: jdbc:salesforcedatacloud:InitiateOAuth=GETANDREFRESH

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

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

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

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

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

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

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