Power BI Report Builder でリアルタイムのHCL Domino のデータを Power BI Service に可視化

CData Power BI Connector は、Microsoft Power BI とのセルフサービス統合を提供します。CData Power BI Connector for HCL Domino を使用すると、Power BI レポートをリアルタイムのHCL Domino のデータにリンクできます。スケジュール更新やオンデマンド更新を設定することで、ダッシュボードを通じてHCL Domino のデータを監視し、分析がリアルタイムのHCL Domino のデータを反映するようにできます。この記事では、Power BI Connector を使用して Microsoft Power BI Desktop でリアルタイムのHCL Domino のデータを可視化する方法を詳しく説明します。

DSN の作成と設定

Power BI Connector をインストールすると、Power BI がデータソースに接続するために使用する CData PBI HCL Domino という名前の DSN（データソース名）が作成されます。必要な接続プロパティを入力して DSN を設定します。

Microsoft ODBC データソースアドミニストレーターを使用して、新しい DSN を作成するか、既存の DSN を設定（および名前変更）できます。スタートメニューから「ODBC データソース」と入力します。Power BI Desktop のインストールに対応するビット数（32 ビットまたは 64 ビット）の ODBC アドミニストレーターを実行してください。

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 と同じです。

HCL Domino のデータの取得

データソースの設定が完了したら、以下の手順に従って HCL Domino テーブルからデータセットにデータを読み込みます。

読み込むテーブルとビューを選択

1. Power BI Report Builder を開き、Blank Report を選択します。
2. Data Sources -> Add Data Source をクリックします。
3. Connection Type で ODBC を選択し、「Build」をクリックします。
4. 「Use user or system data source name」をクリックし、CData PBI HCL Domino Sys を選択します。
5. Connection Properties で Test Connection をクリックし、接続が成功することを確認します。
6. Data Source Properties ウィンドウで Test Connection をクリックし、OK をクリックします。
7. データソースの設定が完了したら、DataSets を設定します。DataSets -> Add Dataset をクリックします。先ほど設定したデータソースを選択し、Query Designer をクリックします。
8. レポートを生成するテーブルの SQL コマンドを入力し、「Run」（!）をクリックします。テーブル名は DSN の CData Connection Manager の Metadata タブで確認できます。
9. 「Validate Query」をクリックします。ウィンドウの左側にカラム名が表示されます。これで、用途に応じて任意のレポートを生成できます。

データビジュアライゼーションの作成

HCL Domino のデータを Power BI Report Builder に読み込んだ後、Fields ペインからキャンバスにフィールドをドラッグして、レポートビューでデータビジュアライゼーションを作成できます。以下の手順に従ってチャートを作成します：

1. Insert -> Chart -> Insert Chart に移動し、Chart Type を選択して OK をクリックします。
2. Values、Category Groups、Series Groups を選択します。Filters ペインにフィールドをドラッグすることで、ページ、レポート、または単一のビジュアライゼーションにフィルターを適用できます。フィールド値でフィルターするには、Filters ペインに表示されている値の1つを選択します。

PowerBI.com でデータ更新を設定

Power BI Gateway を使用して自動データ更新を設定するには、以下の手順に従います。ゲートウェイにより、Power BI クラウドサービスがお使いのマシンの DSN に接続できるようになります。

ゲートウェイモードの選択

ゲートウェイをインストールする際に、ゲートウェイモードを選択する必要があります：

• Gateway (personal mode)：PowerBI.com への発行とレポートの更新のみが必要な場合は、パーソナルモードでゲートウェイを使用します。ゲートウェイは Windows ユーザーアカウントで実行されます。
• （推奨） Gateway (Standard mode - formerly Enterprise)：ゲートウェイを必要とする他の Azure サービスを使用している場合は、デフォルトゲートウェイを使用します。複数のユーザーがゲートウェイにアクセスする必要がある場合も、デフォルトゲートウェイが必要です。 デフォルトゲートウェイ経由で接続するには、システム DSN が必要です（システム DSN はシステム全体でアクセスできますが、ユーザー DSN は特定のユーザーアカウントに制限されます）。コネクタインストールの最後のステップで設定された CData Power BI Salesforce システム DSN を使用できます。

Gateway (Personal Mode) の設定

パーソナルモードでゲートウェイを介して発行するには、カスタムコネクタにアクセスできるインストール済みゲートウェイが必要です。

1. CData Power BI Connector インストーラーを実行します。まだダウンロードしていない場合は、Power BI Gateway (Personal Mode) をダウンロードしてください。
2. オンプレミスデータゲートウェイ（personal mode）オプションを選択します。
3. ゲートウェイにサインインします。
4. ゲートウェイ設定の Connectors セクションで、「custom data connectors」オプションを有効にします。カスタムデータコネクタの .pqx ファイルへの代替パスもここで指定できます。

   注意：CData Power BI Connector は .pqx ファイルをデフォルトフォルダにインストールします。パス："Your User Home\Documents\Power BI Desktop\Custom Connectors."

Gateway (Standard Mode) の設定

ゲートウェイを介して発行するには、カスタムコネクタにアクセスできるインストール済みゲートウェイと、PowerBI.com から Salesforce 用 DSN への設定済み接続が必要です。

ゲートウェイのセットアップ

以下の手順に従って、お使いのマシンでゲートウェイを設定します：

1. CData Power BI Connector インストーラーを実行します。まだダウンロードしていない場合は、Power BI Gateway (Standard Mode) をダウンロードしてください。
2. オンプレミスデータゲートウェイ（推奨）オプションを選択します。
3. ゲートウェイにサインインします。
4. ゲートウェイに名前を付け、回復キーを指定します。
5. Connectors セクションで、ゲートウェイが CData Power BI Connector を検索するフォルダを選択します。この記事では "C:\Users\PBIEgwService\Documents\Power BI Desktop\Custom Connectors\" を使用します。または、CData Connector の .pqx ファイル（"C:\Users\USERNAME\Documents\Power BI Desktop\Custom Connectors\" にあります）を設定したフォルダにコピーします。

   注意：サービス用に設定されたアカウント（NT SERVICE\PBIEgwService）が、ゲートウェイ用に選択したフォルダにアクセスできる必要があります。必要に応じて、ゲートウェイインストーラーの Service Settings セクションでサービスアカウントを変更できます。

6. Connectors セクションのリストに CData.Domino エントリが表示されていることを確認します。

PowerBI.com から Salesforce データに接続

1. ゲートウェイにデータソースを追加します：PowerBI.com にログインし、Settings メニューから Manage Gateways を選択してゲートウェイを選択します。
2. 「Allow user's custom data connectors to refresh through this gateway cluster」を選択します。
3. Apply をクリックして変更を保存します。
4. ゲートウェイにデータソースを追加するオプションをクリックします。
5. Data Source Settings セクションで、データソースの名前を入力します。Data Source Type メニューで CData Power BI Connector for HCL Domino を選択します。
6. Data Source Name ボックスにシステム DSN を入力します：CData PBI HCL Domino Sys。

PowerBI.com に発行

更新可能なレポートと基になるデータセットを発行できるようになりました。以下の手順に従って発行し、データセットのデータ更新設定を完了します。

1. Power BI Desktop Report Builder で、Home リボンの「Publish」をクリックしてレポートを発行します。
2. PowerBI.com で、レポートがアップロードされるワークスペースを選択し、ファイル名を入力します。
3. 「Open HCL Domino in Power BI」をクリックして、ブラウザの Power BI Service でレポートを開きます。

発生したエラーと解決策

「Unable to render paginated report」のようなエラーメッセージが表示された場合は、以下の手順に従ってエラーを解決できます。

Power BI Service でデータソースを作成

1. 「Update data source credentials」をクリックします。
2. 「Continue」をクリックします。
3. Gateway Connection セクションで、ゲートウェイを使用するオプションを有効にし、ゲートウェイを選択します。データソースをゲートウェイに手動で追加する必要がある場合があります：
   1. Actions 列の下でゲートウェイを展開します。
   2. 「Manually add to gateway」リンクをクリックします。
4. Add to gateway をクリックします（以下のスクリーンショットを参照）。匿名認証はサポートされていないため、Authentication で Basic を選択します。Power BI Service アカウントのユーザー名とパスワードを入力します。
5. データソースが正常に作成されたら、「Maps to」で Connection name を選択し、変更を適用します。
6. Power BI Report Builder に戻り、「Open HCL Domino in Power BI」をクリックします。これで、Power BI Service（Online）で作成したレポートを確認できます。

これで、Power BI Report Builder と CData Power BI Connector を使用して、リアルタイムのHCL Domino のデータ上に構築された Power BI レポートが完成しました。HCL Domino 用 CData Power BI Connector の詳細については、CData Power BI Connector for HCL Domino ページで無料トライアルをダウンロードしてご確認ください。ご質問がある場合は、サポートチームまでお問い合わせください。