個人化頂級深入解析展示

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

Power BI 內嵌 自定義報表版面配置， 控制報表頁面上視覺效果的大小、位置和可見性。 使用自定義版面配置向不同的用戶呈現不同的檢視，或讓用戶個人化自己的檢視。 自定義版面配置可協助使用者專注於他們最重要的視覺效果和深入解析。

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

自定義版面配置展示體驗

在 個人化頂級見解 展示中，名為 Contoso 的虛構集團會使用 Power BI 內嵌報表向專案關係人顯示商務數據。 內嵌報表會載入所有九個可用視覺效果，並出現在兩欄配置中。

選取視覺效果

若要只選擇他們最想要查看的視覺效果，報表用戶選取 [選擇視覺效果] 按鈕 。 [選擇視覺效果] 下拉式清單框 隨即開啟，並選取所有九個可用的視覺效果。

用戶可以清除他們不想看到視覺效果旁的複選框。 只有選取的視覺效果會出現在該檢視會話的其餘部分報表中。

選取 [[選擇視覺效果] 會再次關閉下拉式方塊。 用戶可以選取 再次選擇視覺效果，以選取不同的視覺效果或所有九個視覺效果。

選取版面配置

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

視覺效果和版面配置互動

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

自訂版面配置展示程序代碼

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

• 應用程式 HTML 程式代碼 建置報表容器、選擇視覺效果 按鈕和下拉式清單，以及 選擇版面配置 按鈕和下拉式選擇區。

• 報表 JavaScript 內嵌報表、計算及設定自定義版面配置物件，並實作預設和個人化的自定義版面配置。

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

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 遊樂場