Power BI 視覺效果中的進階編輯模式
進階編輯模式可讓您在 Power BI 視覺效果中使用進階 UI 控制。 從報表編輯模式中,選取視覺效果上的 [編輯] 按鈕,將編輯模式設定為 [進階]。 視覺效果可以使用 EditMode
旗標來判斷是否應顯示此 UI 控制。
根據預設,視覺效果不支援進階編輯模式 ("advancedEditModeSupport: 0"
)。 若要啟用進階編輯模式,請藉由設定 advancedEditModeSupport
屬性,將一行新增至視覺效果的 capabilities.json 檔案。
可能的值是:
0
- NotSupported。 視覺效果不支援進階編輯模式。 此視覺效果上不會顯示 [編輯] 按鈕。1
- SupportedNoAction。 視覺效果支援進階編輯模式,而且不需要進行任何進一步的變更。 Power BI 不會將視覺效果切換至[焦點] 模式。 開發人員可以使用此設定做為外部按鈕,在同一個檢視區中執行數個流程。2
- SupportedInFocus。 視覺效果支援進階編輯模式,而且要求主機在進入進階編輯模式時進入焦點模式。
進入進階編輯模式
下列情況會顯示 [編輯] 按鈕:
- capabilities.json 檔案中的
advancedEditModeSupport
屬性設定為SupportedNoAction
或SupportedInFocus
。 - 視覺效果是以報表編輯模式來檢視。
如果 capabilities.json 檔案遺漏 advancedEditModeSupport
屬性,或該屬性設定為 NotSupported
,則不會顯示 [編輯] 按鈕。
當您選取 [編輯] 時,視覺效果會進行 update() 呼叫,並將 EditMode 設為 Advanced
。 取決於 capabilities.json 檔案中設定的值,會發生下列動作:
SupportedNoAction
:主機不需要進一步的動作。SupportedInFocus
: 主機會以焦點模式彈出視覺效果。
結束進階編輯模式
如果 advancedEditModeSupport
屬性在 capabilities.json 檔案中設定為 SupportedInFocus
,則 [返回報表] 按鈕會出現。