使用動作列來增強用戶體驗

當您為組織內嵌報表時，您需要應用程式使用者登入 Power BI 以檢視內嵌的內容。 一旦使用者登入，他們就可以存取他們擁有的報表，或您或其他組織成員與他們共用的報表。

您為組織內嵌的報表取用者可以利用動作列、個人書籤和持續性篩選等自助功能，透過 用戶端 API。

動作列

當您為組織內嵌Power BI報表時，報表取用者可以使用報表 動作列 匯出、共用、變更檢視，或採取數個其他動作。

您可以啟用動作列的完整功能，讓使用者：

• 我的最愛報表
• 使用永續性篩選
• 使用個人書籤

重要

若要提供完整的動作列功能，您必須在 Azure Active Directory （Azure AD） 中為您的應用程式授與使用者 UserState.ReadWrite.All 許可權。

若要向報表取用者顯示動作列，請將 bars 設定新增至內嵌組態，並將 actionBar 可見性設定為 true。

let embedConfig = {
   ...
   settings: {
      bars: {
         actionBar: {
            visible: true
         }
      }
   }
};

顯示動作列會顯示報表頁面的垂直清單，與 Power BI 服務中的體驗相同。 用戶可以折疊頁面流覽窗格，讓報表有更多空間。

永續性篩選

持續性篩選 保留報表取用者的篩選、交叉分析篩選器和其他報表狀態。 報表取用者可以在每次返回報表時，快速取得其深入解析，而不需要重複相同的篩選步驟。 用戶可以跨Power BI服務、行動和內嵌案例共用相同的永續性報表狀態。

若要為組織啟用內嵌報表中的永續性篩選：

1. 在Power BI服務或桌面報表設定中啟用持續性篩選。

2. 請確定您的應用程式允許在 Azure AD 中 UserState.ReadWrite.All 許可權。

3. 將內嵌 loadConfiguration 設定中的 persistentFiltersEnabled 屬性設定為 true：

      let config = {
         type: 'report',
         ...
         settings: {
            persistentFiltersEnabled: true
         }
      };
   

如果報表存在，報表會載入使用者的最新報表狀態。 在內嵌報表中，取用者可以使用 [重設] 設定為動作列中的預設 [] 按鈕來套用其永續性篩選。

如需持續性篩選和相關 API 的詳細資訊，請參閱 持續性篩選。

個人書籤

在您為組織內嵌的報表中，報表取用者可以藉由擷取報表頁面狀態，包括篩選、交叉分析篩選器和視覺狀態，併為其提供易記名稱，以建立 個人 書籤。 然後，用戶可以選取書籤來快速返回這些狀態。 個人書籤只能供其建立者使用，而建立書籤不需要報表的寫入許可權。

報表取用者可以在內嵌報表和 Power BI 服務中使用相同的個人書籤。 用戶可以將其預設檢視設為任何個人書籤，因此每次開啟報表時，他們都會看到其最愛的報表檢視。

若要為組織啟用內嵌報表中的個人書籤：

1. 請確定您的應用程式允許在 Azure AD 中 UserState.ReadWrite.All 許可權。

2. 將內嵌 loadConfiguration 設定中的 personalBookmarksEnabled 屬性設定為 true：

      let config = {
         type: 'report',
         ...
         settings: {
            personalBookmarksEnabled: true
         }
      };
   

3. 讓書籤窗格顯示在報表中。

您可以透過兩種方式在報表中顯示書籤窗格。 第一個選項是顯示報表 動作列，其具有 書籤 按鈕，讓使用者開啟和關閉書籤窗格。

第二個選項是使用報表設定中的 窗格，以程式設計方式顯示和隱藏書籤窗格。

let embedConfig = {
   ...
   settings: {
      panes: {
         bookmarks: {
            visible: true
         }
      }
   }
};

您可以使用 updateSettings 方法來更新運行時間的報表設定，請參閱 在運行時間更新報表設定。

如需個人書籤的詳細資訊，請參閱 個人書籤。

考慮和限制

• 在 Power BI 內嵌式分析中，預設會停用持續性篩選和個人書籤功能。 只有在您為組織內嵌報表時，才支持這些功能，而不是針對客戶內嵌時。

• 當您顯示動作列時，無法再以程式設計方式控制頁面導覽是否顯示為左側窗格或底部的索引標籤。 變更報表頁面清單位置只能透過Power BI服務報表設定使用，而不是透過 panes 物件。

• API 不支援個人書籤動作。 如需報表書籤的相關信息，請參閱 報表書籤。

相關內容

• 使用書籤增強用戶體驗
• 啟用持續性篩選