認定済み Power BI ビジュアル

[アーティクル]
02/18/2024

認定済み Power BI 視覚化とは、Microsoft Power BI チームのコード要件とテストに適合している AppSource の Power BI 視覚化です。実行されたテストは、ビジュアルが外部のサービスやリソースにアクセスしないことを確認するように作られています。ただし、Microsoft はサードパーティのカスタムビジュアルの作成者ではないため、お客様がこれらの視覚化の機能を確認するには作成者に直接連絡することをお勧めします。

認定済み Power BI 視覚化は、他の Power BI 視覚化と同様に使用できます。認定されていない視覚化よりも多くの機能を提供します。たとえば、PowerPoint にエクスポートしたり、レポートページをサブスクライブしているユーザーの受信メールにビジュアルを表示したりできます。

認定プロセスは任意です。視覚化の認定を行うかどうかは開発者が決定します。認定されていない Power BI ビジュアルは必ずしも危険ではありません。一部の Power BI ビジュアルは 1 つまたは複数の認定要件を満たしていないために認定されていません。たとえば、外部サービスに接続するマップ Power BI 視覚化や、商用ライブラリを使用する Power BI 視覚化は認定を受けられません。

認定の削除

Microsoft は、独自の裁量で、認定一覧から視覚化を削除する権利を留保します。

認定要件

Power BI 視覚化の認定を受けるには、このセクションに記載されている要件を満たしている必要があります。

一般的な要件

Power BI ビジュアルは、パートナーセンターで承認される必要があります。認定を要求する前に、AppSource で Power BI 視覚化を発行することをお勧めします。 Power BI ビジュアルを AppSource に発行する方法については、「Power BI ビジュアルをパートナーセンターに発行する」を参照してください。

認定に向けて Power BI 視覚化を提出する前に、次のことを確認してください。

ビジュアルが Power BI ビジュアルのガイドラインに準拠している
必要なテストすべてにビジュアルが合格している
コンパイルされたパッケージと提出されるパッケージが完全に一致している

コードリポジトリの要件

GitHub でコードをパブリックに共有する必要はありませんが、コードリポジトリは Power BI チームがレビューのために使用できる必要があります。これを行う最適な方法は、GitHub でソースコード (JavaScript または TypeScript) を提供することです。

リポジトリには以下が含まれている必要があります。

1 つだけの Power BI ビジュアルのコード。複数の Power BI ビジュアルのコード、または関連のないコードを含めることはできません。
certification (必ず小文字) という名前のブランチ。このブランチのソースコードは、提出されたパッケージと一致している必要があります。このコードは、次回の提出プロセス中に、Power BI ビジュアルを再提出する場合にのみ、更新できます。

Power BI ビジュアルにプライベート npm パッケージまたは git サブモジュールを使用している場合は、そのコードを含むリポジトリへのアクセスも提供する必要があります。

Power BI ビジュアルのリポジトリの外観を把握するには、GitHub リポジトリでPower BI ビジュアルのサンプル横棒グラフを確認してください。

ファイルの要件

Power BI ビジュアルを作成するには、最新バージョンの API を使用します。

リポジトリには、次のファイルを含める必要があります。

.gitignore - node_modules、.tmp、および dist をこのファイルに追加します。そのコードに node_modules、.tmp、または dist フォルダーを含めることはできません。
capabilities.json - このファイルのプロパティに変更を加え、Power BI ビジュアルの新しいバージョンを提出する場合は、それが既存のユーザーのレポートを破損させないことを確認します。
pbiviz.json
package.json。ビジュアルには、次のパッケージがインストールされている必要があります。
- "typescript"
- "eslint"
- "eslint-plugin-powerbi-visuals"
- このファイルには、リンターを実行するためのコマンドが含まれている必要があります - "eslint": "npx eslint . --ext .js,.jsx,.ts,.tsx"
package-lock.json
tsconfig.json

コマンドの要件

次のコマンドでエラーが返されないことを確認します。

npm install
pbiviz package
npm audit - 高レベルまたは中レベルの警告を返してはなりません。
必要な構成を含む ESlint。このコマンドから lint エラーが返されてはなりません。

注意

TSlint から ESLint に移行中です。 TSlint が使用されているビジュアルについては、2023 年 3 月まで認定を受け付けます。その後は、ESlint が必要となります。

コンパイルの要件

Power BI ビジュアルを作成するには、最新バージョンの powerbi-visuals-tools を使用します。

pbiviz package を使用して、Power BI ビジュアルをコンパイルする必要があります。独自のビルドスクリプトを使用している場合は、npm run package カスタムビルドコマンドを用意します。

ソースコードの要件

Power BI 視覚化の追加の認定ポリシー一覧に従っていることを確認します。提出がこれらのガイドラインに従っていない場合、このリンクに記載されているポリシー番号が記載された却下メールがパートナーセンターから届きます。

ここに示されているコード要件に従って、コードが Power BI 認定ポリシーに準拠していることを確認します。

必須

公開されている Javascript や TypeScript ライブラリなどの公開レビュー可能な OSS コンポーネントのみを使用します。
このコードでは、レンダリングイベント API をサポートする必要があります。
DOM が安全に操作されていることを確認します。ユーザー入力またはユーザーデータにサニタイズを使用してから DOM に追加します。
テストデータセットとしてサンプルレポートを使用します。

禁止

外部のサービスまたはリソースへのアクセス。たとえば、Power BI から任意のサービスにアクセスできる HTTP/S または WebSocket 要求を含めることはできません。そのため、機能の設定で WebAccess 特権を空にするか、省略する必要があります。
innerHTML または D3.html(user data or user input) の使用。
すべて入力データに対するブラウザーコンソールの JavaScript エラーまたは例外。
eval()、settimeout()、requestAnimationFrame()、setinterval(user input function) の安全ではない使用、ユーザー入力またはユーザーデータなどの任意のコードまたは動的コード。
縮小された JavaScript ファイルまたはプロジェクト。

認定に向けて Power BI 視覚化を提出する

これで、Power BI チームに Power BI ビジュアルの認定を受けるリクエストを提出する準備が整いました。

ヒント

Power BI 認定プロセスには時間がかかることがあります。新しい Power BI ビジュアルを作成している場合は、Power BI 認定を要求する前に、パートナーセンターを通して Power BI ビジュアルを発行しておくことをお勧めします。これにより、自分のビジュアルの発行が遅れないようにすることができます。

Power BI 認定を要求するには:

パートナーセンターにサインインします。
[概要] ページで、自分の Power BI ビジュアルを選択し、 [製品] 設定ページに移動します。
[Power BI 認定を要求します] チェックボックスをオンにします。
[確認と発行] ページで、 [認定の注意書き] テキストボックスに、ソースコードへのリンクと、それにアクセスするために必要な資格情報を入力します。

プライベートリポジトリの提出プロセス

GitHub などのプライベートリポジトリを使用して、認定を受けるために Power BI ビジュアルを送信する場合は、このセクションの手順に従ってください。

検証チーム用の新しいアカウントを作成します。
アカウントに対して 2 要素認証を構成します。
新しい回復用コードのセットを生成します。
Power BI ビジュアルを提出する際に、必ず次を提供してください。
- リポジトリへのリンク
- サインイン資格情報 (パスワードを含む)
- 回復用コード
- アカウントに対する読み取り専用アクセス許可 (pbicvsupport)

認定済み Power BI ビジュアルバッジ

Power BI 視覚化が認定されると、それが認定済み Power BI 視覚化であることを示すバッジが与えられます。

AppSource の認定済み Power BI ビジュアル

オンラインで検索した AppSource の Power BI ビジュアルのビジュアルのカード上に小さい黄色いバッジがある場合、それはその Power BI ビジュアルが認定済みであることを示します。
AppSource で Power BI ビジュアルのカードをクリックすると、"PBI 認定" という黄色いバッジが表示され、この Power BI ビジュアルが認定されていることを示します。

Power BI インターフェイスの認定済み Power BI ビジュアル

Power BI (デスクトップまたはサービス) から Power BI ビジュアルをインポートする場合、青いバッジは Power BI ビジュアルが認定されていることを示します。
認定済み Power BI ビジュアルのみを表示するには、" [Power BI 認定] " フィルターオプションを選択します。

パブリケーションタイムライン

AppSource へのデプロイのプロセスには時間がかかる場合があります。このプロセスが完了すると、Power BI ビジュアルが AppSource からダウンロードできるようになります。

ユーザーはいつビジュアルをダウンロードできますか。

新しい Power BI 視覚化を提出した場合、お客様が AppSource からメールを受信してから数時間後にユーザーがダウンロードできるようになります。
既存の Power BI 視覚エフェクトに更新を送信した場合、ユーザーは送信から 2 週間以内にダウンロードできるようになります。

注意

AppSource の [バージョン] フィールドは、Power BI が AppSource によって承認された日に更新されます。これは、ビジュアルの送信後約 1 週間です。ユーザーは更新されたビジュアルをダウンロードできますが、更新された機能は有効になりません。視覚化の新機能は、約 2 週間後にユーザーのレポートに影響を与えます。

Power BI ビジュアルに証明書バッジが表示されるのはいつですか。

認定バッジは、申請が承認されてから 3 週間以内に表示されるはずです。

その他の質問 Power BI コミュニティをご利用ください。

次の方法で共有

認定済み Power BI ビジュアル

認定の削除