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

宮本航太
宮本航太
プロダクトスペシャリスト
CData JDBC ドライバを使って、帳票ツールのbiz-Stream で Factorial をノーコードで連携。



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

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

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

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

  • cdata.jdbc.api.jar
  • cdata.jdbc.api.lic （試用版では.lic ファイルは不要）
  • コピー元：C:\Program Files\CData\CData JDBC Driver for API 20xxJ\lib
  • コピー先：C:\Program Files (x86)\brainsellers\biz-Stream レイアウト・デザイナ\lib_jdbc

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

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

認証

Factorial は認証に OAuth 2.0 を使用し、自分の HR データに接続する場合も、他のユーザーが各自のデータに接続できるようにする場合も、OAuth 2.0 認証を利用できます。

OAuth 認証の設定

OAuth を使って接続するには、以下のステップで進めます：

  1. Factorial の管理パネルに移動して、新しい OAuth アプリケーションを作成します。
  2. アプリケーション設定から Client ID と Client Secret をコピーします。
  3. 以下の接続プロパティを設定します。
  • AuthScheme：OAuth に設定します。
  • OAuthClientId：OAuth Client ID に設定します。
  • OAuthClientSecret：OAuth Client Secret に設定します。
  • Scope：データへのアクセス権限を指定します（デフォルト："read write"）。

サーバURLは以下の形式で入力します。
URL: 

jdbc:api:Profile=C:\profiles\Factorial.apip;AuthScheme=OAuth;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;InitiateOAuth=GETANDREFRESH

Factorial のデータ リソースの作成

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

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

Windows:


java -jar 'C:\Program Files\CData\CData JDBC Driver for API 20xxJ\lib\cdata.jdbc.api.jar'

MacOS:


java -jar cdata.jdbc.api.jar

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

接続文字列デザイナーを使って、JDBC URL を生成する (Salesforce is shown.)

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

Factorial のデータ リソースの編集

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

Factorial のデータ リソースの選択

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

Factorial のデータ のカラム選択と条件設定

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

データソース設定

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

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

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

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

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

表オブジェクトとしてFactorial を使用

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

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

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

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

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

API Driver で Factorial のライブデータに接続

Factorial に接続

この記事の内容

関連記事