製品をチェック

HCL Domino Driver の30日間無償トライアルをダウンロード

 30日間の無償トライアルへ

製品の詳細

HCL Domino アイコン HCL Domino JDBC Driver 相談したい

HCL Domino に連携するJava アプリケーションを素早く、簡単に開発できる便利なドライバー。

現場帳票電子化ソリューションXC-Gate とXC-Connect を使ってHCL Domino のデータを利用した帳票を作成する方法

杉本和也
リードエンジニア

最終更新日:2023-12-01
domino ロゴ

CData

jdbc ロゴ画像
XC-Gate ロゴ

こんにちは!リードエンジニアの杉本です。

今回は現場帳票管理・電子化ソリューションの『XC-Gate』とCData JDBC ドライバを組み合わせて各種クラウドデータを帳票で活用する方法を紹介します。

XC-Gate とは?

XC-Gate は製造業、建設業、食品業界など様々な業界で活用されている現場帳票電子化ソリューションです。

https://product.technotree.com/xc-gate-ent/

普段皆さんが使っているExcel を利用して帳票をカスタマイズ、作成することができるのが大きな特徴です。

https://www.technotree.com/form/xc-editor

XC-Gate 紹介画像

また、XC-Connect というツールをサーバーにインストールして、ローコードで業務管理・生産管理システムやBIツール、Excel、CSVといったデータと連携することができます。

https://product.technotree.com/xc-gate/xc-connect/feature/

XC-Connect 紹介画像

シナリオ

今回作成する帳票は以下のようにHCL Domino のデータを一覧表示するものとなっています。

XC-Gate によるHCL Dominoデータの帳票表示例

HCL Domino はREST APIが提供されているので、一見連携しやすいように見えますが、XC-Gate から直接クエリするにはインターフェース処理が難しい部分が実際問題として存在します。

https://developer.salesforce.com/docs/atlas.ja-jp.api_rest.meta/api_rest/resources_query.htm

そこで今回の記事ではこのボトルネックを「CData JDBC Driver」を活用することで解消します。

https://www.cdata.com/jp/drivers/domino/jdbc/

XC-Gate では XC-Connect というデータベースのデータを読み込むための仕組みが標準提供されており、この機能を介してSQL ServerやMySQLなどにアクセスできるようになっています。

https://www.xc-times.com/news/?newsUCd=908b7620-3ecd-4e04-ab5d-4a42897c035d

XC-Gate とXC-Connect のデータ連携説明図

そして、実はこのXC-Connect は内部でJDBC が利用されているため、XC-Connect とCData が提供しているJDBC Driver ラインナップを通じて、各種クラウドサービスのAPI にアクセスすることができるようになります。

とは言っても、説明だけではイメージできない部分もあると思うので、実際に帳票を作成してみましょう。

CData HCL Domino JDBC Driver のインストール

最初にCData HCL Domino JDBC Driver を対象のマシンにインストールします。

以下のページから30日間のトライアルがダウンロードできます。

HCL Domino JDBC ドライバーページ

インストーラーを入手後、対象のマシンでセットアップを進めていきます。

CData JDBC ドライバのインストール画面

セットアップ完了後、以下のフォルダにJDBC Driver のjar ファイルが配置されます。

C:\Program Files\CData\CData JDBC Driver for Domino 2023J\lib

JDBC Driver の接続テスト

対象のjar ファイルを実行すると接続テストツールが立ち上がるので、これでHCL Domino への接続を確認しておきましょう。

セットアップが完了すると接続設定画面が表示されるので、HCL Domino への認証に必要な情報を入力します。

Domino への接続

Domino のデータに接続するには、以下のプロパティを設定してください。

  • URL: Domino データベースをホスティングしているサーバーのホスト名、またはIP を入力します。サーバーのポート番号を含めてください。例えば、http://sampleserver:1234/
  • DatabaseScope: Domino Web UI 内のスコープ名を入力します。ドライバーは、ここで指定したスコープによって制御されるスキーマの、フォームとビューを公開します。Domino Admin UI で、サイドバーからScopes メニューを選択します。このプロパティを、既存のスコープ名に設定します。

Domino での認証

Domino は、ログインクレデンシャルまたはAzure Active Directory OAuth アプリケーションを使用した認証をサポートしています。

ログインクレデンシャル

ログインクレデンシャルで認証するには、以下のプロパティを設定してください:

  • AuthScheme: これを"OAuthPassword" に設定します
  • User: 認証するDomino ユーザーのユーザー名
  • Password: 認証するDominoユ ーザーに関連付けられたパスワード

ドライバーはログインクレデンシャルを使用して、自動的にOAuth トークン交換を実行します。

AzureAD

この認証方法は、Azure Active Directory をIdP として使用してJWTトークンを取得します。Azure Active Directory にカスタムのアプリケーションを作成し、それをIdP として設定する必要があります。そのためには、ヘルプドキュメントの指示に従ってください。その後、以下のプロパティを設定します。

  • AuthScheme: これを"AzureAD" に設定します
  • InitiateOAuth: これをGETANDREFRESH に設定します。InitiateOAuth を使用すると、OAuth 交換の繰り返しやOAuthAccessToken の手動設定を避けることができます。
  • OAuthClientId: カスタムOAuth アプリケーションのセットアップ時に取得したクライアントID
  • OAuthClientSecret: カスタムOAuth アプリケーションのセットアップ時に取得したクライアントシークレット
  • CallbackURL: アプリ登録時に定義したリダイレクトURI。例えば、https://localhost:33333
  • AzureTenant: データにアクセスするために使用されるMicrosoft Online テナント。companyname.microsoft.com 形式の値またはテナントID のいずれかを指定してください。

    テナントID は、Azure ポータルのAzure Active Directory > プロパティページに表示されているディレクトリID と同じです。

あとは「接続のテスト」ボタンをクリックし、接続が成功したら、「接続ウィザード」の「OK」ボタンをクリックして保存します。

接続設定

無事接続が完了すると、「接続テストの成功」メッセージが表示されます。接続文字列は後で利用するのでコピーして控えておきましょう。

XC-Connect の転送設定を追加する

続いてXC-Connect の接続設定を進めましょう。XC-GateでJDBC Driver 経由のデータを扱う場合は、このXC-Connect が必要となります。

XC-Connect は以下のページでデベロッパー登録をすることでダウンロードできます。

https://www.developer.technotree.com/

XC-Connect をセットアップし立ち上げると、ログイン画面が表示されるので、設定したパスワードを使用してログインします。

XC-Connect ログイン画面

併せて転送設定でXC-Gate側への接続を確立しておきましょう。予めXC-Gate の証明書を取得しておき、転送設定で指定しておきます。

XC-Connect の転送設定画面

JDBC ドライバーの登録

それではXC-Gate でCData JDBC ドライバの指定を追加していきます。

「システム設定」→「JDBCファイル設定」に移動し、

JDBC ファイル設定に移動

ここでCData JDBC ドライバをアップロードして登録します。「ファイルを選択」をクリックし「cdata.jdbc.domino.jar」をアップロードします。

XC-Gate JDBCドライバー登録画面

JDBC 登録後は読み込みのためにXC-Connect を一度再起動させましょう。

XC-Connect 再起動指示画面

合わせてライセンスファイル「cdata.jdbc.domino.lic」を「C:\Windows\ServiceProfiles\LocalService\.CData」に配置しておきます。もし「.CData」フォルダが無い場合は、作成して配置します。

機器の追加

CData JDBC ドライバを配置したら、XC-Connect で「どういったデータを読み込ませるのか」を指定する機器設定を追加していきます。まず最初に接続情報を追加しましょう。

「機器設定」タブに移動し、「+機器の追加」をクリックします。

XC-Connect 機器設定追加画面

プロトコルの選択画面では「メーカー:データベース」「機種:JDBC 汎用(SQL)」「プロトコル:SQL」をそれぞれ指定します。

XC-Connect 機器プロトコル設定画面

最初に接続情報を指定します。任意の設定名称を指定し、JDBC Driver 名で先程登録したDriver を選択します。

接続URLには「JDBC Driver の接続テスト」時に取得した接続文字列を指定しましょう。「ユーザー名」「パスワード」は利用しませんのでダミーの文字列を入力すればOKです。

入力後「接続テスト」をクリックして、「接続テストに成功しました」と表示さればOKです。

XC-Connect 接続情報設定画面

取得データの追加

続いて。機器設定の詳細から「どういったデータを読み込ませるのか?」を指定する「取得データの追加」設定を行います。

機器登録完了後、「+取得データの追加」をクリックします。

XC-Connect 取得データ設定画面

任意のデータ名称を取得後、実行SQL を指定します。ここではHCL Domino の取引先情報である「Account」テーブルを取得するためのSQLを指定しました。

取得間隔や実行タイムアウトは任意の設定を指定します。ただ、Web API の連携では、各種API 側のリクエスト制限が指定されているものも存在するので、過度に短い間隔は利用しないほうが良いかと思います。

「保存方式」は「マスタ(項目)形式」を指定し、キーとしてHCL Domino の「Id」カラムを指定しました。

XC-Connect データ読み込み設定画面

設定後、「接続テスト」をクリックし、以下のようにデータが取得できていればOK です。

XC-Connect データ取得テスト結果画面

登録後、「起動する」ボタンをクリックしておきましょう。

XC-Connect 転送設定起動画面

タグ設定の追加

最後にXC-Gate で登録したマスタデータを利用するためのタグ設定を追加します。

「タグ設定」タブに移動し「+タグ設定の追加」をクリックしましょう。

XC-Gate タグ設定追加画面

「機器データ名称」の「選択」ボタンをクリックして、

XC-Gate 機器データ名称選択画面

登録しているCData JDBC ドライバを選択。

XC-Gate CData JDBC ドライバ選択画面

以下のようなタグ設定の画面に移るので「+表示項目の追加」をクリックし

XC-Gate タグ設定画面

帳票に取り込みたい項目をそれぞれ追加していきます。

XC-Gate 帳票項目追加画面

あとは「タグEXCEL出力」でXC-Gate で利用するタグ設定を取得します。

XC-Gate タグExcel出力画面

これでXC-Gate で帳票を作成するためのタグが準備できました。

XC-Gate タグ設定完了画面

帳票の登録

それでは実際にXC-Connect 経由でXC-Gate の帳票にデータが表示できるか試していきましょう。今回は先程取得したタグを利用して以下のような帳票をExcel で作成しました。

XC-Gate によるExcel帳票例

XC-Gate にログインし、これを「フォルダ」から「新しいチェックシート」として登録します。

XC-Gate チェックシート登録画面

作成したExcel ファイルを指定して、任意のファイル名でチェックシートを登録します。

XC-Gate チェックシートファイル指定画面

チェックシートの登録が完了したら「プレビュー」ボタンをクリックして、帳票を参照してみましょう。

XC-Gate チェックシートプレビュー画面

以下のような画面が表示されるので「コネクト取得」をクリックしてみると、

コネクト取得をクリック

CData JDBC ドライバとXC-Connect 経由でリアルタイムにHCL Domino のデータが取得できました!

HCL Domino のデータを取得

おわりに

このようにXC-Gate・XC-Connect とCData JDBC ドライバを組み合わせることで、手軽にXC-Gate の帳票に各種クラウドサービスのデータを取り込むことができます。

CData ではHCL Domino 以外にも様々なクラウドデータソースのJDBC Driver を扱っています。

https://www.cdata.com/jp/jdbc/

ぜひ自社で利用しているサービスと合わせて、XC-Gate を活用してみてください。

関連コンテンツ

トライアル・お問い合わせ

30日間無償トライアルで、CData のリアルタイムデータ連携をフルにお試しいただけます。記事や製品についてのご質問があればお気軽にお問い合わせください。