個人化熱門深入解析展示

發行項
02/19/2024

Power BI 內嵌式分析遊樂場中的個人化熱門深入解析展示 (預覽版) 使用自訂版面配置 API，讓使用者在報表檢視會話期間選取要查看的視覺效果和版面配置。

Power BI 內嵌自訂報表版面配置可控制報表頁面上視覺效果的大小、位置和可見度。您可以使用自訂版面配置將不同的檢視呈現給不同的使用者，或讓使用者個人化自己的檢視。自訂版面配置可協助使用者專注于最重要的視覺效果和見解。

您也可以使用自訂版面配置，在視窗大小變更時調整視覺效果的大小，或呈現桌面、平板電腦或行動畫面的不同版面配置。

自訂版面配置展示體驗

在個人化熱門深入解析展示中，名為 Contoso 的虛構群組會使用 Power BI 內嵌報表向其專案關係人顯示商務資料。內嵌報表會載入所有九個可用的視覺效果，並出現在雙欄配置中。

選取視覺效果

若要只選擇他們最想要查看的視覺效果，報表使用者可以選取 [ 選擇視覺效果] 按鈕。 [ 選擇視覺效果] 下拉式清單方塊隨即開啟，其中已選取所有九個可用的視覺效果。

使用者可以清除他們不感興趣的視覺效果旁的核取方塊。只有選取的視覺效果會出現在報表中，以供該檢視會話的其餘部分使用。

顯示 [選擇視覺效果] 對話方塊的螢幕擷取畫面，其中已選取三個視覺效果並顯示。

選取 [選擇視覺效果 ] 會再次關閉下拉式方塊。使用者可以再次選取 [ 選擇視覺效果 ] 以選取不同的視覺效果或全部九個視覺效果。

選取版面配置

使用者也可以選取 [ 選擇版面配置 ] 以下拉五個不同視覺效果版面配置選項的調色盤。選取版面配置選項會套用選取的配置，並關閉調色盤。

此螢幕擷取畫面顯示已選取並套用三欄版面配置的配置選擇區。

視覺效果和版面配置互動

[ 選擇視覺效果 ] 和 [選擇應用程式程式碼中的 版面配置 ] 控制項是獨立的，但它們會互動。例如，如果只顯示一個視覺效果，單欄配置會顯示大於三欄配置大小的視覺效果。

顯示單欄版面配置中單一視覺效果的螢幕擷取畫面。

顯示三欄版面配置中單一視覺效果的螢幕擷取畫面。

自訂版面配置展示程式碼

實作展示應用程式的程式碼位於 PowerBI-Embedded-Showcases GitHub 存放庫中。

應用程式 HTML 程式碼會建置報表容器、 選擇視覺效果 按鈕和下拉式清單，以及 [選擇版面配置 ] 按鈕和下拉式選擇區。
報表 JavaScript會內嵌報表、計算及設定自訂版面設定物件，並實作預設和個人化的自訂版面配置。

若要建立自訂報表配置，您可以將自訂版面設定物件傳遞至 settings 報表內嵌組態的屬性。若要啟用自訂版面配置，報表 JavaScript 會 layoutType 使用具有值 models.LayoutType.Custom 的屬性。

物件 customLayout 會指定報表畫布頁面大小、畫布縮放比例和頁面配置。頁面配置會指定報表的預設視覺效果配置，以及每個視覺效果的視覺配置。

let settings = {
    ...
    layoutType: models.LayoutType.Custom,
    customLayout: {
        pageSize: {
            type: models.PageSizeType.Custom,
            width: reportWidth - 10,
            height: reportHeight - 20
        },
        displayOption: models.DisplayOption.FitToPage,
        pagesLayout: pagesLayout
    }
};

為了顯示選取的視覺效果和版面配置，展示的 JavaScript 會動態建立 settings 物件並更新內嵌組態。報表會載入所選取視覺效果，其中顯示和實作自訂版面配置。

下一步

個人化報表配置

Power BI Embedded Analytics 遊樂場 (Preview)

Share via