Umbraco アプリケーションに Microsoft Power BI レポートを埋め込む方法
概要
Power BIレポートとダッシュボードを埋め込むためのガイド ウンブラコMicrosoft Power BIとUmbracoを統合するには、 miniOrange Power BI インテグレーター プラグイン。このセットアップガイドでは、Power BI レポート、ダッシュボード、タイル、データセット、セマンティックモデルを Umbraco のページや投稿に埋め込む手順を詳しく説明します。これにより、ユーザーは Umbraco サイトから直接、インタラクティブな Power BI 成果物を閲覧できるようになります。また、行レベルセキュリティ (RLS) を有効にすることで、Umbraco で Power BI チャートをきめ細かくパーソナライズされたビューにすることもできます。
前提条件: ダウンロードとインストール
miniOrange Umbraco Integrator には以下が必要です。
- バージョンで実行されているUmbracoアプリケーション 9〜15.
- アプリケーションは、 MS SQL Server(そうでない場合は、データベースに基づいて適切なバージョンを提案できます。)
- アプリケーションがデータベースを使用しない場合は、動作するバージョンも提供できます。 データベースなし.
- A Microsoft パワー BI アカウント。
UmbracoアプリケーションにminiOrangeを追加する
- インストール miniOrange PowerBI Integrator NuGet パッケージ NuGet パッケージ マネージャーまたは CLI を使用します。
PM> NuGet\Install-Package miniOrange.Umbraco.PowerBI.Integrator
- インストールしたら、アプリケーションをビルドして追加するだけです miniOrange ビューと静的ファイル.
- 以下の詳細を記入してください プログラム.cs ファイルにソフトウェアを指定する必要があります。
using miniOrange.Umbraco.PowerBI;
using Umbraco_PowerBI_Integrator;
using Umbraco_PowerBI_Integrator.RouteObserver;
WebApplicationBuilder builder = WebApplication.CreateBuilder(args);
builder.Services.AddMiniOrangeServices(builder.Configuration);
builder.CreateUmbracoBuilder()
.AddBackOffice()
.AddWebsite()
.AddDeliveryApi()
.AddComposers()
.Build()
WebApplication app = builder.Build();
await app.BootUmbracoAsync();
app.UseStaticFiles();
app.UseUmbraco()
.WithMiddleware(u =>
{
u.UseBackOffice();
u.UseWebsite();
u.AppBuilder.UseminiOrangeUmbracoPowerBIMiddleware();
})
.WithEndpoints(u =>
{
u.UseInstallerEndpoints();
u.UseBackOfficeEndpoints();
u.UseWebsiteEndpoints();
});
await app.RunAsync();
- アプリケーションをビルドして実行します。
PowerBI 統合用に Azure AD を構成する
miniOrangeダッシュボード内でPowerBIの設定をいくつか行います。
1. Azure AD アプリの登録を構成する
- ログインする アズールAD 管理者としてポータルにアクセスします。
- Azure Active Directory のホーム画面が表示されます。
- Azure サービス セクションで、選択します。 Microsoft エントラ ID.
- 左側のタブの「管理」セクションで、「 アプリの登録.
- ソフトウェアの制限をクリック 新規登録.
- 割り当て 表示名 名前フィールドで、 口座の種類.
- URIをリダイレクトする フィールドに、 ウンブラコサイト とをクリックしてください 会員登録する
- アプリケーションの登録後、Azure ADは一意の アプリケーションID あなたのアプリケーションに。
- に移動します [概要]タブ左側のペインで、
- コピー アプリケーションID ディレクトリID、これはあなたのものになります 顧客ID and テナントID.
- 左側のナビゲーション ペインから、 証明書と秘密 タブには何も表示されないことに注意してください。
- クリックすると 新しいクライアントシークレット。 説明と有効期限を入力し、 追加 オプションを選択します。
- の値をコピーします 秘密鍵。 これはあなたのものになります クライアント秘密鍵.
2. Azure AD アプリケーションに API アクセス許可を追加します。
- に行く API権限 左側のナビゲーション ペインで、 権限を追加する オプションを選択します。
- 選択する Microsoft Graph 下 Microsoft API タブには何も表示されないことに注意してください。
- 選択する アプリケーションのアクセス許可 そして、 ユーザー.
- ユーザー select ユーザー.読み取り and ユーザー.読み取り.すべて 権限を設定して、 権限の追加 ボタン。(マイクロソフト グラフ)
- 「権限の追加」をクリックして下にスクロールして選択します PowerBIサービス リクエスト API 許可オプションの下。
- 選択する 権限の委任 そして、 外部リンク:レポート.
- レポート select レポート.読み取り.すべて 許可して、 許可を追加する ボタン。 (Power BI)
- これで、すべての権限が表示されます。 API権限
- ソフトウェアの制限をクリック デフォルトのディレクトリに管理者の同意を与える をクリックします。入力したコードが正しければ、MFAの設定は正常に完了します あり 付与管理者の同意確認時。
- Azure AD アプリケーションが正常に構成されました。
3. Azure ADセキュリティグループの設定を構成する
- Azure Active Directory ホーム ページで、 グループ 左ペインから
- ソフトウェアの制限をクリック 新しいグループ 新しいセキュリティグループを追加します。
- まず グループタイプ as セキュリティ ドロップダウンから、 グループ名 as Power BI 管理 API を許可する.
- 詳細を入力したら、 作成ボタン 新しいセキュリティグループを作成します。
- 新しく作成したセキュリティ グループ (Power BI Admin API を許可) を検索して選択します。
- に移動します 加盟国 左側のペインからタブをクリックして、 メンバーを追加.
- 次に、以前に構成したアプリケーション名を検索し、 select
正常に設定されました Azure AD アプリは、Umbraco アプリケーションへのユーザー同期と Power BI の統合を実現します。
統合用に PowerBI を構成します。
- に行きます Power BI ダッシュボードにアクセスし、管理者としてログインします。
- Power BI のホーム画面が表示されます。
- 右上隅にある をクリックします。 設定アイコン としてジョブステータス出力ログに記録されます。
- 下 ガバナンスと洞察 をクリックしてください 管理ポータル オプションを選択します。
- 管理ポータル セクション、下 テナント設定、までスクロールします。 開発者設定.
- ソフトウェアの制限をクリック サービス プリンシパルがプロファイルを作成して使用できるようにします。
- 有効にします トグル クリックして Apply.
- 下にスクロールして 管理API設定、トグルを有効にして、次のオプションを選択します。 特定のセキュリティグループ.
- 検索する Umbraco Power BI ユーザー グループ 次にをクリックしてください Apply.
- ホームページに戻ります。を選択 ワークスペース 左側のペインから タブをクリックし、リストからワークスペースを選択します。
- に移動します アクセスの管理 タブには何も表示されないことに注意してください。
- アクセスの管理 セクションで追加をクリックします ユーザーまたはグループを追加する.
- 以前に構成したアプリケーションを検索します。ドロップダウンから選択します ビューアー をクリックします。入力したコードが正しければ、MFAの設定は正常に完了します 追加 このAzure ADアプリケーションを Power BI ワークスペース.
- まず レポート 埋め込みたい Umbracoのページまたは投稿.
- 次に、 ワークスペースID and レポートID 以下の画像に示す URL からダウンロードし、後で必要になるため手元に置いておいてください。
PowerBI設定でminiOrangeプラグインを構成する
- Umbraco アプリケーションにアクセスしてください。
-
アプリケーションのベースURLに、 /?アクション=設定 クエリパラメータ。(
/?アクション=設定 )
- あなたは、 ご登録はこちらから記入してクリックしてください 登録ボタン.
- 登録すると、miniOrange 管理ダッシュボードが表示されます。
- に行きます 認証設定 タブを押して入力します クライアントID、クライアントシークレット、テナントID Azure AD アプリケーションの [保存] をクリックします。
- 今すぐ Power BI設定 タブを入力し、 レポート名、Workspace_ID and レポートID レポートの。
- を示すスクリプトが生成されます。 ワークスペースID and レポートID あなたの Power BI レポート.
- Umbraco BackOffice アカウントにログインします。
- コンテンツ タブで、PowerBI レポート オプションをクリックします。
- miniOrangeのトライアル版では、Entra IDアカウントでログインした後でのみレポートにアクセスできます。「サインイン」ボタンをクリックして、Entra IDアカウントでログインしてください。
- ログインするとすぐに PowerBI レポートが表示されます。
関連記事
Get in Touch
までご連絡ください umbracosupport@xecurify.com弊社のチームがUmbracoへのPower BI統合の設定をサポートいたします。また、お客様の要件に基づいて最適なソリューションやプランの選定もサポートいたします。
