HCL Domino のデータをSisense でビジュアライズ

HCL Domino にアクセスできるSisense アプリでElastiCube を作成します。

古川えりか
コンテンツスペシャリスト
最終更新日：2022-04-14

この記事で実現できるHCL Domino 連携のシナリオ

CData

こんにちは！ドライバー周りのヘルプドキュメントを担当している古川です。

Sisense を使用すると、データを結合、分析、画像化lし、よりインテリジェントなビジネス決定を行い、効果的な戦略を作成できます。CData JDBC Driver for Domino は、Sisense に簡単に統合して利用することができます。この記事では、HCL Domino に接続するElastiCube の作成方法と、それを使用してSisense のHCL Domino をビジュアライズする方法を説明します。

HCL Domino への接続を構成する

ElastiCube を作成する前に、JDBC Driver のJAR ファイル(通常はC:\Program Files\CDatat\CData JDBC Driver for Domino\lib) のインストール場所をメモするか、jar ファイル(cdata.jdbc.domino.Domino.jar) をSisense JDBC driver ディレクトリの新しいフォルダ(通常はC:\ProgramData\Sisense\DataConnectors\jdbcdrivers)にコピーします。

Sisense アプリケーションの［Data］ページで、新しいElastiCube を作成します(または既存のElastiCube を開きます)。
［Model Editor］で［+ Data］をクリックし、［Add Data］ダイアログボックスを開きます。
［Generic JDBC］をクリックし、［JDBC settings］を開きます。
［Connection String］プロパティをHCL Domino のJDBC URL に設定し、必要なプロパティを追加します。
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 と同じです。
ビルトイン接続文字列デザイナ

JDBC URL の構成については、HCL Domino JDBC Driver に組み込まれている接続文字列デザイナを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。
java -jar cdata.jdbc.domino.jar
接続プロパティを入力し、接続文字列をクリップボードにコピーします。

JDBC URL を構成する際に、Max Rows プロパティを定めることも可能です。これによって戻される行数を制限するため、可視化・レポートのデザイン設計時のパフォーマンスを向上させるのに役立ちます。

以下は一般的な例です。
jdbc:domino:Server=https://domino.corp.com;Database=names.nsf;Port=3002;SSLClientCertType=PEMKEY_FILE;SSLClientCert=full_path_of_certificate.pem;SSLServerCert=*
JDBC JAR フォルダプロパティをCData JDBC Driver JAR ファイルの場所に設定します(上記を参照)。
ドライバーのクラス名をJDBC Driver のクラス名( cdata.jdbc.domino.DominoDriver) に設定します。
ユーザー名とパスワードのプロパティは空欄にします。
［Next］をクリックします。