FinancialForce データを帳票ツールbiz-Stream で連携利用する方法

biz-Stream は、多様な表現が可能なWeb 帳票ソリューションです。

この記事では、biz-Stream からCData JDBC Driver 経由でFinancialForce データにリアルタイムで連携接続して帳票から利用する方法を紹介します。CData Drivers を使うことで、RDB のようにbiz-Stream 内でFinancialForce データを扱うことができるようになります。

biz-Stream へのFinancialForce JDBC ドライバーの配置

デフォルトの内容でインストールした場合、以下のパスに jar ファイルが配置されますので、その jar ファイルを biz-Stream の所定のパスにコピーします。

• cdata.jdbc.financialforce.jar
• cdata.jdbc.financialforce.lic （試用版では.lic ファイルは不要）

• コピー元：C:\Program Files\CData\CData JDBC Driver for FinancialForce 20xxJ\lib
• コピー先：C:\Program Files (x86)\brainsellers\biz-Stream レイアウト・デザイナ\lib_jdbc

biz-Stream からFinancialForce への接続設定

レイアウトデザイナを起動後、リソース定義にて FinancialForce への接続設定を行います。ドライバー選択のプルダウンに CData FinancialForce JDBC Driver が表示されますので選択します。

There are several authentication methods available for connecting to FinancialForce: login credentials, SSO, and OAuth.

Authenticating with a Login and Token

Set the User and Password to your login credentials. Additionally, set the SecurityToken. By default, the SecurityToken is required, but you can make it optional by allowing a range of trusted IP addresses.

To disable the security token:

1. Log in to FinancialForce and enter "Network Access" in the Quick Find box in the setup section.
2. Add your IP address to the list of trusted IP addresses.

To obtain the security token:

1. Open the personal information page on FinancialForce.com.
2. Click the link to reset your security token. The token will be emailed to you.
3. Specify the security token in the SecurityToken connection property or append it to the Password.

Authenticating with OAuth

If you do not have access to the user name and password or do not want to require them, use the OAuth user consent flow. See the OAuth section in the Help for an authentication guide.

Connecting to FinancialForce Sandbox Accounts

Set UseSandbox to true (false by default) to use a FinancialForce sandbox account. Ensure that you specify a sandbox user name in User.

サーバURLは以下の形式で入力します。
URL: jdbc:financialforce:User=myUser;Password=myPassword;Security Token=myToken;InitiateOAuth=GETANDREFRESH

JDBC Driver の接続文字列デザイナーを使う

JDBC 接続文字列を作るには、FinancialForce JDBC Driver のビルトイン接続文字列デザイナーを使う方法があります。ドライバーの.jar ファイルをダブルクリックするか、コマンドラインから.jar ファイルを実行します。

Windows:

MacOS:

接続プロパティに値を入力して、生成される接続文字列をクリップボードにコピーします。

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

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

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

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

FinancialForce データをリアルタイムで参照するbiz-Stream 帳票のデザイン

用紙設定を行います。今回は A4 設定にしました。設定後は画面下部にある追加ボタンをクリックします。

ページ設定では新規ボタンをクリックします。

ここではレイアウトデザイナが帳票テンプレートを xml で保存しますので、ファイル名を設定します。

レイアウトにはさまざまなメニューがありますが、今回は表を使用します。表を設定後、FinancialForce から取得したデータをセットするエリアを作成します。各セルにテキストボックスを挿入し、そのテキストボックス自体に FinancialForce の項目を紐づけします。
※ヘッダーにもそれぞれテキストボックスを追加します。

レイアウト作成画面を閉じた後、ページ設定の画面に戻りますので、画面下部にある追加ボタン（一度作成している場合は適用）をクリックし、レイアウトの作成が完了となります。

レイアウトデザイナーのトップ画面のヘッダーメニューからプレビューアイコンをクリックします。先ほど作成したレイアウトで FinancialForce のデータを表示させることができます。

このようにCData JDBC Driver をアップロードすることで、簡単にbiz-Stream でFinancialForce データをリアルタイムに参照する帳票をノーコードで連携して作成することができます。

ぜひ、CData JDBC Driver for FinancialForce 30日の無償評価版 をダウンロードして、お試しください。