リアルタイムHCL Domino データをPowerBI.com にパブリッシュ（発行）

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

CData Power BI Connector for Domino は、Power BI のツールおよびウイザードにシームレスに統合します。PowerBI.com へのリアルタイムデータのパブリッシュも可能です。次のステップで、Power BI Gateway を使って、自動リフレッシュ設定で、データをPower BI に公開します。

Power BI データソースとしてHCL Domino を設定

CData Power BI Connector をインストールすると完了後にDSN 設定画面が開きます。ここでHCL Domino への接続を設定します。

接続作業はWindows のODBC データソースアドミニストレータでも設定可能です。CData PowerBI REST DSN を選択します。 Power BI のbit 数（32 bit or 64 bit）に合わせたアドミニストレータを使うように気を付けてください。DSN 設定画面で必要な項目を入力してHCL Domino データに接続します。入力後に接続のテストを行い、OK を押して接続を確立します。

Domino 接続プロパティの取得・設定方法

接続の前に

CData 製品を経由してDomino に接続するには、「Proton コンポーネント」のインストールが必要です。通常、 Proton はAppDev パックの一部として配布されています。Proton またはAppDev パックの入手およびインストール方法については、HCL のドキュメントを参照してください。

CData 製品は匿名アクセス、またはクライアント証明書の提供によりProton を認証できます。 これらのオプションは両方ともDomino で特定の設定が必要です。

次の2セクションでは、接続に必要な事前設定について説明します。使用したい認証方法に対応するセクションを参照してください。

クライアント証明書による認証の設定

クライアント証明書による認証では、CData 製品は専用のユーザーアカウントとして接続します。このユーザーには、接続するすべてのデータベースに対するdesigner またはそれ以上のアクセス権が付与する必要があります。

また、CData 製品を使用するためにはユーザーがインターネット証明書を取得する必要があります。サーバーコンソールで以下のコマンドを実行することで、Proton にこの証明書を作成させることができます。 APPUSER はCData 製品でアクセス設定するユーザーアカウント名、ADMINISTRATOR は証明書を受け取るユーザー名です。

新しい証明書は、Notes のADMINISTRATOR メールボックスから利用できます。証明書は、クライアント証明書（clientcert）およびキー（clientkey）の2ファイルに分けて送信される場合があります。 キーファイルのテキストを証明書ファイルの末尾にコピーアンドペーストして、2つのファイルを結合する必要があります。

匿名認証の設定

匿名アクセスでは、CData 製品はAnonymous という一般的なユーザーアカウントで接続します。 接続するすべてのデータベースには、次の2つの権限が設定される必要があります。

• Anonymous ユーザーには、designer またはそれ以上のデータベースへのアクセス権が付与される必要があります。
• データベースは、Maximum Internet name and password オプションがdesigner またはそれ以上のアクセスに設定される必要があります。 この設定は、データベースのAccess Control List オプションのAdvanced タブにあります。

Domino への接続

接続するには以下を設定します。

• Server：Proton サービスを使ってDomino を実行中のサーバーのIP アドレス。
• Port：Proton サービスがリッスンしているポート番号。
• Database：.nsf 拡張子を含むデータベースファイル名。
• SSLServerCert：サーバーが受け入れ可能なTLS/SSL 証明書に設定。コンピュータによって信頼されていない他の証明書はすべて拒否されます。または、"*" を設定するとすべての証明書を受け入れます。

Domino への認証

CData 製品は、クライアント証明書を使用してProton に認証することも、匿名アクセスで認証することも可能です。

クライアント証明書による認証

クライアント証明書で認証するには以下を設定します。

• AuthScheme：SSLCertificate に設定。
• SSLClientCertType：これは、証明書ファイルの形式と一致する必要があります。 通常、.pem 証明書の場合はPEMKEY_FILE、.pfx 証明書の場合はPFXFILE のいずれかになります。
• SSLClientCert：証明書ファイルへのパス。

匿名認証

匿名認証を使用するには、AuthScheme をAnonymous に設定します。

HCL Domino テーブルをPower BI からクエリ

次の手順でHCL Domino からデータをPower BI からクエリできるようにします:

1. Power BI Desktop を開き、［データ］->［データを取得］->［その他］-> CData Domino を選択して接続を押します。次にサードパーティドライバーのプロンプトが出る場合には、そのまま続行します。
2. CData PowerBI HCL Domino を［Data Source Name］欄に入力します。データ接続モードを選択します：
   インポート データをプロジェクトにインポートする。オンデマンドで更新が可能。
   DirectQuery リモートデータに直接アクセスする場合。
3. ナビゲーターダイアログで使用するテーブルを選択します。

4. ［データの変換］では、データをカスタマイズすることができます。クエリエディタを開いて、フィルタ、ソート、集計を設定できます。

   • カラムのデータ型の変更
   • カラムの削除
   • カラムのグルーピング

   Power BI は、コネクタが取得・検出したHCL Domino のカラム毎のデータ型をそのまま使えます。

   Power BI は、データ変換を取得して、指定した条件でクエリを発行し、HCL Domino からデータを取得します。

   ［読み込み］をクリックすると、そのままのデータがコネクタ経由でPower BI にロードされます。

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

データをPower BI から取得したら、レポートビューで取得したHCL Domino フィールドをドラッグ＆ドロップしてビジュアライゼーションを作成します。チャートの種類を可視化ペインから選択し、フィールドのカラムをドラッグして設定します。

チャートの右上をクリックしてソートオプションを変更することもできます。

チャートの部分のハイライトも可能です。

取得したデータのビジュアライズ上でのフィルタリングをフィルタリングペインで行うことができます。

［更新］をクリックするとその時点でのリアルタイムデータをHCL Domino から取得してレポートに反映させることができます。

オンプレミスデータゲートウェイでのPowerBI.com へのデータリフレッシュの設定

次の手順でPower BI オンプレミスゲートウェイ を使って、ローカルに設定したDSN のHCL Domino データをPower BI のクラウド上から定期的にリフレッシュすることが可能です。

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

まずはゲートウェイのモードを選択します。

• Gateway (個人用モード): Power BI にのみパブリッシュしてリフレッシュする場合はこちらを選択。ゲートウェイはWindows ユーザーアカウントで起動します。
• Gateway (formerly Enterprise): ほかのAzure サービスでゲートウェイが必要な場合には、こちらを選択します。また、複数のユーザーがゲートウェイにアクセスする場合にもデフォルトゲートウェイが必要です。
  デフォルトゲートウェイでアクセスする場合にはシステムDSN で接続する必要があります。ユーザーDSN だと特定のアカウントのみがアクセスでき、システムDSN のようにシステム全体からアクセスすることができないためです。CData Power BI Domino system DSN は、コネクタのインストールの最後のステップで設定します。

個人用モードゲートウェイの設定

Personal モードでのゲートウェイでのパブリッシュは、カスタムコネクタにアクセスできるゲートウェイをインストールする必要があります。

1. CData Power BI Connector インストーラーを実行します。ダウンロードはこちらから 可能です。
2. on-premises data gateway (personal mode) オプションを選択します。
3. ゲートウェイにサインインします。
4. ゲートウェイ名を設定し、Recovery Key を指定します。
5. コネクタセクションで、カスタムデータコネクタオプションを有効化します。.pqx ファイルが置かれたパスをオルタナティブパスとして設定することもできます。
   Note: CData Power BI Connectors は、デフォルトフォルダ（Your User Home\Documents\Power BI Desktop\Custom Connectors）に.pqx ファイルをインストールします。

ゲートウェイの設定

ゲートウェイ経由のパブリッシュには、コネクタへのアクセスが可能なゲートウェイのインストールとPowerBI.com からのHCL Domino DSN への接続が必要です。

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

次の手順でマシン上にゲートウェイを設定します：

1. CData Power BI Connector インストーラーを起動します。Power BI Gateway のダウンロード も必要です。
2. on-premises data gateway (recommended) オプションを選択します。
3. ゲートウェイにサインインします。
4. ゲートウェイ名を設定し、Recovery Key を指定します。

5. ゲートウェイが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\) を指定したフォルダに移します。

   NOTE: 指定されたサービスアカウント(NT SERVICE\PBIEgwService) は、ゲートウェイのアクセスフォルダに指定される必要があります。必要な場合には、ゲートウェイインストーラーのサービス設定で変更ができます。

6. コネクタセクションで、CData.PowerBI.Domino が表示されていることを確認します。

2. PowerBI.com からHCL Domino データに接続する

1. ゲートウェイにデータソースを追加: PowerBI.com にログインして、設定メニューから［ゲートウェイの管理］を選択して、ゲートウェイクラスターの設定を実行。
2. ［このゲートウェイクラスターでユーザーのクラウドデータソースを更新することを許可する］オプションをクリック。
3. 適用を押して設定を保存します。
4. 続いてCData Power BI Connectorをデータソースとして追加します。
5. データソース設定セクションで、データソース名を入力し、データソースの種類にはCData Power BI Connector for Domino をドロップダウンから選択します。
6. Data Source Name には、システムDSN 名を入力します：CData Power BI Domino。
7. 設定後［すべての接続をテスト］ボタンをクリックし、［接続成功］が表示されれば、設定完了です。

PowerBI.com へのパブリッシュ

これでHCL Domino データソースに連携してデータを更新できるレポートが発行できます。次の手順でデータセットを含むレポートをパブリッシュします。

1. Power BI Desktop で、［発行］ボタンを押して、レポートをPower BI へパブリッシュします。
2. PowerBI.com で、発行したワークスペースを選択します。
3. ［データセット］セクションで、設定したHCL Domino データセットのオプションメニューをクリックして、［設定］をクリックします。
4. ［ゲートウェイ接続］セクションで、［データゲートウェイを使用する］を有効にします。状態がグリーンであることを確認し、適用を押して保存します。
5. 個人用モードでのゲートウェイ理世うでは、［データソースクレデンシャル］をクリックして、サインインします。

データセットの更新（リフレッシュ）

これでPower BI サイドからレポートのデータをHCL Domino の最新のデータに更新できるようになりました。

• データの手動更新には、［ワークスペース］-> データセット］に進み、更新ボタンをクリックします。
• スケジュール更新には、［ワークスペース］->［データセット］に進み、更新のスケジュールをクリックします。データの更新オプションを有効にして、更新頻度を設定します。
• レポートビューでは、更新を押してレポートを最新のデータに同期できます。