Workiva サポートセンター

はじめに

このガイドは、「Power BI：Power BI チェーン テンプレートへのデータ読み込み」をスムーズに実装できるよう支援することを目的としています。Power BI ワークスペースに新しいデータを読み込んだり、既存のデータを更新したり、データを削除したりする場合でも、このテンプレートがその作業を支援します。このドキュメントでは、Power BIの設定権限やアプリケーションAPIの権限の設定手順、および「Chain Template」を使用することによるさまざまなメリットについて、わかりやすく解説しています。このガイドに従うことで、スムーズかつ効率的な導入プロセスを確保でき、Power BI でのデータ処理作業をより簡単かつ効果的に行うことができます。

前提条件

チェーン

• ワークスペースでは、以下のコネクターを有効にして構成する必要があります：
  • Power BI
  • Workiva

データ

• データが記載されたCSVファイルが必要です（CSVファイルにはバイト順マークが含まれていてはなりません）。
• 列名とそれぞれのデータ型のリストは不可欠です

Power BI のセットアップに関する追加情報 

• そのユーザーアカウントが、Azure アカウントで変更を行う権限を持つPower BI Proライセンス以上を保有していることを確認してください
• Azure ポータルにサインインしてください 
• ページの右上隅にあるアカウントを選択して、Microsoft Entra テナント を選択してください
• 「アプリの登録」を選択します。 
• 
  • 「アプリ登録」で、「新規登録」を選択します 
• 
  • 次のフィールドに塗りつぶしの色を入力します：
    • 名前 - アプリケーションに名前を付けます
    • 対応するアカウントの種類 - アプリケーションを利用できるユーザーを選択してください 
• 
  • 「登録」を選択してください。アプリの登録が完了すると、そのアプリの概要ページに移動します
  • 概要ページで、アプリケーション（クライアント ID）とテナント ID を確認し、この情報を安全な場所に保管してください。Workiva を Power BI に接続する際に、これらが必要になります。

Power BI の API 権限

• 右側のパネルから、Power BI アプリケーションのアクセス権限を調整します
  • 展開 管理
  • APIの権限設定に移動する                                                                                                              
    • 以下のAPI権限が選択されていることを確認してください。

リダイレクトURI

• 右側のパネルから、Power BI アプリケーションのアクセス権限を調整します
  • 展開 管理
  • 「認証」に移動する                                                                                                               

Power BI のアクセス許可の設定が完了したら、「Power BI コネクタ」を確認し、Power BI コネクタを設定してください。 

チェーンの展開

その Power BI：Power BI へのデータの読み込み 「テンプレート」画面の「Workiva Chains」セクションにあります。

検索方法はこうだ：

1. Chain Builder で、「テンプレート」タブに移動します
2. 上部のメニューから「Workiva Chains」を選択してください
3. 右上の「Power BI: Power BIチェーンテンプレートへのデータ読み込み」を検索し、テンプレートを開きます

テンプレートが見つかったら、以下に挙げるランタイム入力を使用して、ワークスペースに合わせてテンプレートを設定してください。

注：テンプレートからチェーンを作成する方法の詳細については、「チェーンの作成と管理」の記事をご覧ください。 

注：この統合ユーザーには、コネクタが実行するコマンドに対して適切な権限（たとえば、連携するスプレッドシートやワークスペースの所有者権限など）が必要です。

ランタイム入力

チェーンについてさらに詳しく

チェーンプロセスを効果的に運用し、成果を出し始めるためには、関連する Power BI ワークスペースを Chains 内のそれぞれの変数と整合させる必要があります。

以下に、Table ID をそれぞれのランタイム入力に設定する方法を示します。 Power BI：Power BI へのデータの読み込み チェーン

1. 有効になっている設定に移動してください Power BI：Power BI へのデータの読み込み チェーン。

2. コマンドをダブルクリックして、ランタイム入力を編集します
3. 「Runtime Inputs」コマンド内の、Power BI にあるそれぞれのテーブル ID およびワークスペース ID を更新してください

注：このテンプレートを使用するには、パイプラインのダウンストリームにある「コマンド」に追加のユーザーが必要となりますので、ご注意ください。 

「データセットの作成」コマンドでは、ユーザーはチェーンの実行を続行する前に、データセットの列とそれぞれのデータ型を入力・設定する必要があります。 

• コマンドをダブルクリックして、「データセットの作成」を編集します
  • [列] で [追加] を選択し、列の「名前」と「データ型」を入力します。

注：先に進む前に、最初の「CHANGE_ME」という列を必ず置き換えてください。各コマンドで許可される列数は70列までです。70列を超えるテーブルは、Power BI内で再結合する必要があります。 

トラブルシューティング

以下のステップは、チェーンテンプレートに関する問題のトラブルシューティングに使用できます：

チェーン実行エラー

バイト順マーク（BOM）を含むCSVファイル

Power BI コマンドでは、BOM を含む CSV ファイルを読み込んで処理することができません。BOMを削除するには、以下のトラブルシューティングのヒントをご覧ください：以下の場合
Visual Studio Code (VS Code):

1. VS CodeでCSVファイルを開いてください。
2. ウィンドウの右下隅に表示されているエンコーディングをクリックしてください（「UTF-8 with BOM」と表示されている場合があります）。
3. ドロップダウンメニューが表示されます。「UTF-8」を選択してください。通常、これをすると、次回の保存時にBOMが削除されます。「ファイル」＞「名前を付けて保存」を選択し、エンコードのドロップダウンメニューで「UTF-8」が選択されていることを確認する必要があるかもしれません。
    

Notepad++（Windows）の場合：

1. CSVファイルをNotepad++で開いてください。
2. 上部のツールバーにある「エンコーディング」メニューを選択してください。
3. 「BOMなしのUTF-8に変換」を選択します。
4. ファイルを保存します（「ファイル」＞「保存」）。

その他のリソース

Power BI コマンド

Power BIへのコネクター