Dundas BI でHCL Domino のデータを使ってダッシュボードを構築

CData のHCL Domino 用 ODBC ドライバーは、ODBC 標準経由でHCL Domino のリアルタイムデータにアクセスし、使い慣れた SQL クエリで各種 BI、レポート、ETL ツールからHCL Domino のデータを利用可能にします。この記事では、汎用 ODBC データプロバイダーとしてHCL Domino に接続し、Dundas BI でHCL Domino のデータを基にしたチャート、レポート、ダッシュボードを作成する方法を解説します。

HCL Domino のデータへの接続設定

1. まだ設定していない場合は、データソース名（DSN）で必要な接続プロパティを指定します。DSN の設定は組み込みの Microsoft ODBC データソースアドミニストレーターを使用して行えます。これはドライバーインストールの最終ステップでもあります。Microsoft ODBC データソースアドミニストレーターを使用して DSN を作成・設定する方法については、ヘルプドキュメントの「はじめに」の章をご参照ください。
   
   

   Domino への接続

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

   • URL：Domino データベースをホスティングしているサーバーのホスト名またはIP アドレス。Domino データベースをホスティングしているサーバーのポートを含めます。例：http://sampleserver:1234/
   • DatabaseScope：Domino Web UI でのスコープ名。CData 製品は、指定されたスコープに適合するスキーマのフォームとビューを公開します。Domino Admin UI で、サイドバーのScopes メニューを選択してください。このプロパティを既存のスコープ名に設定します

   Domino での認証

   続いて、認証方法を設定しましょう。Domino では、ログインクレデンシャル（OAuthPassword）またはMicrosoft Entra ID（AzureAD）のいずれかによる認証をサポートしています。

   ログインクレデンシャル

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

   • AuthScheme：OAuthPassword
   • User：認証するDomino ユーザーのユーザー名
   • Password：認証するDomino ユーザーに関連付けられたパスワード

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

   Microsoft Entra ID（Azure AD）

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

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

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

   DSN を設定する際には、Max Rows 接続プロパティも設定することをお勧めします。これにより返される行数が制限され、レポートやビジュアライゼーションの設計時にパフォーマンスを向上させるのに役立ちます。

2. Dundas BI インターフェースを開き、メニューから New Data Connector をクリックします。
3. Dundas BI の Data Connector を設定します：
   • Data Connector の名前を入力します。
   • Data Provider として「ODBC generic」を選択します。
   • 「Use System DSN」チェックボックスをオンにします。
   • 適切なシステム DSN を選択します。
   

HCL Domino のデータをダッシュボードに追加

これでHCL Domino のデータを使ってダッシュボードを作成する準備が整いました。

1. ホームページに移動します。
2. Explore Data をクリックします。

3. 適切な Data Connector を展開します。
4. Connector から関連するデータをパネルにドラッグします。
   • 「テーブル」全体を選択して追加することもできますが、適切なビジュアライゼーションを作成するには Metric Set からメジャーや行を削除する必要があるかもしれません。あるいは、ビジュアライゼーションに含めたいフィールドのみを選択することもできます。
   • フィールドを選択した状態で、メジャーと行にフィルタや条件を追加し、ビジュアライゼーションをさらにカスタマイズできます。

5. メニューバーから Re-visualize をクリックし、データに適したビジュアライゼーションを選択します。

6. Add To New Dashboard をクリックして、ビジュアライゼーションを新しいダッシュボードに追加します。

7. HCL Domino のデータを使ったダイナミックなビジュアライゼーションを作成してダッシュボードを設定します。