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

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

はじめに

---

DSN の作成と設定

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

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

NetSuiteへの接続

NetSuite では、2種類のAPI でデータにアクセスできます。どちらのAPI を使用するかは、Schema 接続プロパティで以下のいずれかを選択して指定してください。

• SuiteTalk は、NetSuite との通信に使用されるSOAP ベースの従来から提供されているサービスです。幅広いエンティティをサポートし、INSERT / UPDATE / DELETE の操作も対応しています。ただし、SuiteQL API と比べるとデータの取得速度が劣ります。また、サーバーサイドでのJOIN に対応していないため、これらの処理はCData 製品がクライアントサイドで実行します。
• SuiteQL は、より新しいAPI です。JOIN、GROUP BY、集計、カラムフィルタリングをサーバーサイドで処理できるため、SuiteTalk よりもはるかに高速にデータを取得できます。ただし、NetSuite データへのアクセスは読み取り専用となります。

データの取得のみが目的でしたらSuiteQL をお勧めします。データの取得と変更の両方が必要な場合は、SuiteTalk をお選びください。

NetSuite への認証

CData 製品では、以下の認証方式がご利用いただけます。

• トークンベース認証（TBA）はOAuth1.0に似た仕組みです。2020.2以降のSuiteTalk とSuiteQL の両方で利用できます。
• OAuth 2.0 認証（OAuth 2.0 認可コードグラントフロー）は、SuiteQL でのみご利用いただけます。
• OAuth JWT 認証は、OAuth2.0 クライアント認証フローの一つで、クライアント認証情報を含むJWT を使用してNetSuite データへのアクセスを要求します。

トークンベース認証（OAuth1.0）

トークンベース認証（TBA）は、基本的にOAuth 1.0 の仕組みです。この認証方式はSuiteTalk とSuiteQL の両方でサポートされています。管理者権限をお持ちの方がNetSuite UI 内でOAuthClientId、OAuthClientSecret、OAuthAccessToken、OAuthAccessTokenSecret を直接作成することで設定できます。 NetSuite UI でのトークン作成手順については、ヘルプドキュメントの「はじめに」セクションをご参照ください。

アクセストークンを作成したら、以下の接続プロパティを設定して接続してみましょう。

• AuthScheme = Token
• AccountId = 接続先のアカウント
• OAuthClientId = アプリケーション作成時に表示されるコンシューマーキー
• OAuthClientSecret = アプリケーション作成時に表示されるコンシューマーシークレット
• OAuthAccessToken = アクセストークン作成時のトークンID
• OAuthAccessTokenSecret = アクセストークン作成時のトークンシークレット

その他の認証方法については、ヘルプドキュメントの「はじめに」をご確認ください。

NetSuite のデータの取得

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

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

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

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

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

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

PowerBI.com に発行

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

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

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