Power BI 視覺效果中的 [分析] 窗格

[分析窗格] 可讓您將動態參考線 (例如最小值、最大值或平均值) 新增至視覺效果。 這些線可以協助您放大重要趨勢或深入解析。 本文討論如何建立 Power BI 視覺效果以在 [分析] 窗格中成線和管理動態參考線。

注意

API 2.5.0 版提供 [分析] 窗格。 若要了解您正在使用哪個版本，請檢查 pbiviz.json 檔案中的 apiVersion。

管理 [分析] 窗格

在 [分析窗格] 中管理屬性的方式，與在 [格式窗格] 中管理屬性的方式相似。 您可以在視覺效果的 capabilities.json 檔案中定義物件。

針對 [分析] 窗格，物件將如下定義：

API 5.1+

在物件的定義下，只新增物件名稱、屬性名稱和類型，如這裡所述。 範例：

{
  "objects": {
    "YourAnalyticsPropertiesCard": {
      "properties": {
        "show": {
          "type": {
            "bool": true
          }
        },
        "displayName": {
          "type": {
            "text": true
          }
        },
      ... //any other properties for your Analytics card
      }
    }
  ...
  }
}

舊版 API (5.1 板之前)

1. 在物件的定義下，新增 displayName 和值為 2 的 objectCategory 欄位。

   注意

   objectCategory 欄位會定義物件所控制的視覺效果層面 (1=Formatting, 2=Analytics)。 將 Formatting 用於元素，例如外觀與風格、色彩、軸和標籤等。 將 Analytics 用於元素，例如預測、參考線和形狀。

   如果未指定 objectCategory 值，則預設為 Formatting。

2. 將下列兩個屬性新增至物件：

   • bool 類型的 show，其預設值為 true
   • text 類型的 displayName，其預設值為 true

{
  "objects": {
    "YourAnalyticsPropertiesCard": {
      "displayName": "Your analytics properties card's name",
      "objectCategory": 2,
      "properties": {
        "show": {
          "type": {
            "bool": true
          }
        },
        "displayName": {
          "type": {
            "text": true
          }
        },
      ... //any other properties for your Analytics card
      }
    }
  ...
  }
}

在格式設定卡片中，將 set card analyticsPane 參數設定為 true，以指定此卡片屬於分析窗格。 依預設，analyticsPane 參數為 False，並會將卡片新增至格式設定窗格。 請參閱下列實作：

使用 FormattingModel 公用程式

class YourAnalyticsCardSettings extends FormattingSettingsCard {
    show = new formattingSettings.ToggleSwitch({
        name: "show",
        displayName: undefined,
        value: false,
        topLevelToggle: true
    });

    displayNameProperty = new formattingSettings.TextInput({
        displayName: "displayName",
        name: "displayName",
        placeholder: "",
        value: "Analytics Instance",
    });

    name: string = "YourAnalyticsPropertiesCard";
    displayName: string = "Your analytics properties card's name";
    analyticsPane: boolean = true; // <===  Add and set analyticsPane variable to true 
    slices = [this.show, this.displayNameProperty];
}

不使用 FormattingModel 公用程式

      const show: powerbi.visuals.EnabledSlice = {
          uid: "enableAxisCard_topLevelToggle_show_uid",
          suppressDisplayName: true,
          control: {
              type: powerbi.visuals.FormattingComponent.ToggleSwitch,
              properties: {
                  descriptor: {
                      objectName: "YourAnalyticsPropertiesCard",
                      propertyName: "show"
                  },
                  value: false
              }
          }
      }
        
      const displayNameProperty: powerbi.visuals.FormattingSlice = {
          uid: "enableAxisCard_displayName_uid",
          suppressDisplayName: true,
          control: {
              type: powerbi.visuals.FormattingComponent.TextInput,
              properties: {
                  descriptor: {
                      objectName: "YourAnalyticsPropertiesCard",
                      propertyName: "displayName"
                  },
                  value: "Analytics Instance",
                  placeholder: ""
              }
          }
      }

      const averageLineCard: powerbi.visuals.FormattingCard = {
          displayName: "Your analytics properties card's name",
          uid: "yourAnalyticsCard_uid",
          analyticsPane: true, // <===  Add and set analyticsPane variable to true 
          topLevelToggle: show,
          groups: [{
              displayName: undefined,
              uid: "yourAnalyticsCard_group_uid",
              slices: [displayNameProperty],
          }]
      };

定義其他屬性的方式與您對格式化物件所進行的方式相同，並列舉物件，與在 [格式化] 窗格中進行的方式相同。

注意

• [分析] 窗格僅適用於新增資訊或闡明所呈現資訊的物件 (例如，說明重要趨勢的動態參考線)。
• 控制視覺效果外觀及操作 (也就是格式設定) 的任何選項，都應該限制在 [格式化] 窗格中。

考量與限制

• [分析] 窗格尚未支援多個執行個體。 物件所能擁有的唯一選取器為靜態 (意即 selector: null)，而 Power BI 視覺效果無法擁有多個使用者定義卡片的執行個體。
• 類型為 integer 的屬性不會正確顯示。 因應措施是改為使用 numeric 類型。

相關內容

新增條件式格式設定