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

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

DSN の作成と設定

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

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

PingOne に接続するには以下のプロパティを設定します。

• Region：自身のPingOne 組織のデータがホスティングされている地域。
• AuthScheme：PingOne に接続する際に使用する認証の種類。
• WorkerAppEnvironmentId （デフォルトのPingOne ドメインを使用する場合に必要）、またはAuthorizationServerURL のいずれかで、下で説明するように設定します。

WorkerAppEnvironmentId の設定

WorkerAppEnvironmentId は、Worker アプリケーションが存在するPingOne 環境のID です。 このパラメータは、環境がデフォルトのPingOne ドメイン（auth.pingone）を利用している場合のみ使用されます。 これは、ヘルプドキュメントのカスタムOAuth アプリケーションの作成で説明するように、PingOne への認証に使用するカスタムOAuth アプリケーションを作成した後に設定します。

はじめに、このプロパティの値を見つけます。

1. 自身のPingOne 組織のホームページからナビゲーションサイドバーに移動し、Environments をクリックします。
2. OAuth / Worker のカスタムアプリケーションを作成した環境（通常はAdministrators）を見つけ、Manage Environment をクリックします。 環境のホームページが表示されます。
3. 環境のホームページのナビゲーションサイドバーで、Applications をクリックします。
4. リストから、OAuth またはWorker アプリケーションの詳細を見つけます。
5. Environment ID フィールドの値をコピーします。 以下の例に似たものになるはずです：
   

   WorkerAppEnvironmentId='11e96fc7-aa4d-4a60-8196-9acf91424eca'

次に、WorkerAppEnvironmentId をEnvironment ID フィールドの値に設定します。

AuthorizationServerURL の設定

AuthorizationServerURL は、お使いのアプリケーションが配置されている環境のPingOne 認可サーバーのベースURL です。 このプロパティは、PingOne プラットフォームAPI ドキュメントで説明されているように、環境にカスタムドメインを設定した場合にのみ使用されます。 Custom Domains を参照してください。

OAuth でのPingOne への認証

PingOne はOAuth とOAuthClient 認証の両方をサポートしています。 上述の設定手順に加え、OAuth またはOAuthCliet 認証をサポートするために、さらに2つの手順を完了する必要があります。

• ヘルプドキュメントのカスタムOAuth アプリケーションの作成で説明するように、カスタムOAuth アプリケーションを作成して設定します。
• ドライバーがデータモデル内のエンティティにアクセスできるようにするには、ヘルプドキュメントのAdministrator Roles での説明のとおり、使用するアドミンユーザー / ワーカーアプリケーションに対して正しいロールを設定していることを確認してください。
• 以下のサブセクションで説明されているように、選択した認証スキームと認証フローに適切なプロパティを設定します。

OAuth（認可コードグラント）

AuthScheme をOAuth に設定します。

デスクトップアプリケーション

OAuth アクセストークンの取得およびリフレッシュ

以下を設定して、接続してください。

• InitiateOAuth：GETANDREFRESH。繰り返しOAuth の交換を行ったり、手動でOAuthAccessToken を設定する必要をなくすには、InitiateOAuth を使用します。
• OAuthClientId：カスタムOAuth アプリケーションを作成した際に取得したClient ID。
• OAuthClientSecret：カスタムOAuth アプリケーションを作成した際に取得したClient Secret。
• CallbackURL：カスタムOAuth アプリケーションの登録時に定義したリダイレクトURI。例：https://localhost:3333

接続すると、CData 製品 はデフォルトブラウザでPingOne のOAuth エンドポイントを開きます。ログインして、アプリケーションにアクセス許可を与えます。 ドライバーはこれでOAuth プロセスを完了します。

1. ドライバーはPingOne からアクセストークンを取得し、それを使ってデータをリクエストします。
2. OAuth 値はOAuthSettingsLocation で指定された場所に保存され、接続間で永続化されるようにします。

ドライバーはアクセストークンの期限が切れると自動的にリフレッシュします。

Web アプリケーションやヘッドレスマシン、クライアントクレデンシャルグラントを含むその他のOAuth メソッドについては、ヘルプドキュメントを参照してください。

PingOne のデータの取得

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

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

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 PingOne 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」をクリックします。ウィンドウの左側にカラム名が表示されます。これで、用途に応じて任意のレポートを生成できます。

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

PingOne のデータを 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.PingOne エントリが表示されていることを確認します。

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 PingOne を選択します。
6. Data Source Name ボックスにシステム DSN を入力します：CData PBI PingOne Sys。

PowerBI.com に発行

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

1. Power BI Desktop Report Builder で、Home リボンの「Publish」をクリックしてレポートを発行します。
2. PowerBI.com で、レポートがアップロードされるワークスペースを選択し、ファイル名を入力します。
3. 「Open PingOne 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 PingOne in Power BI」をクリックします。これで、Power BI Service（Online）で作成したレポートを確認できます。

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