Power BI görsellerindeki Analiz bölmesi

Analiz bölmesi, görsellerinize min, max veya average gibi dinamik başvuru çizgileri eklemenize olanak tanır. Bu çizgiler önemli eğilimleri veya içgörüleri yakınlaştırmanıza yardımcı olabilir. Bu makalede, Analiz bölmesinde dinamik başvuru çizgileri sunabilen ve yönetebilen Power BI görsellerinin nasıl oluşturulacağı açıklanır.

Dekont

Analiz bölmesi API sürüm 2.5.0'da kullanılabilir. Hangi sürümü kullandığınızı öğrenmek için pbiviz.json dosyasını denetleyin apiVersion.

Analiz bölmesini yönetme

Analiz bölmesindekiözellikleri yönetmek, Biçim bölmesindeki özellikleri yönetmeye benzer. Görselin capabilities.json dosyasında bir nesne tanımlarsınız.

Analiz bölmesi için nesne aşağıdaki gibi tanımlanır:

API 5.1+

Nesnenin tanımı altında, burada açıklandığı gibi yalnızca nesne adını, özellik adını ve türünü ekleyin. Örneğin:

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

Eski API'ler (5.1'dan önce)

1. Nesnenin tanımı altında ve değerini 2içeren bir objectCategory alan ekleyindisplayName.

   Dekont

   alanı, objectCategory nesnenin denetlediğini görselin yönünü tanımlar (1=Biçimlendirme, 2=Analiz). Görünüm ve kullanım, renkler, eksenler ve etiketler gibi öğeler için kullanın Formatting . Tahminler, başvuru çizgileri ve şekiller gibi öğeler için kullanın Analytics .

   objectCategory Değer belirtilmezse, varsayılan olarak olurFormatting.

2. Nesnesine aşağıdaki iki özelliği ekleyin:

   • show türüne bool ve varsayılan değeri true
   • displayName türüne text ve varsayılan değeri 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
      }
    }
  ...
  }
}

Biçimlendirme ayarları kartında parametresini trueolarak ayarlayarak bu kartın analiz bölmesine set card analyticsPane ait olduğunu belirtin. Varsayılan olarak, analyticsPane parametre false'tur ve kart biçimlendirme bölmesine eklenir. Aşağıdaki uygulamalara bakın:

FormattingModel Yardımcı Programları Kullanma

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];
}

FormatModel Yardımcı Programları Olmadan

      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],
          }]
      };

Diğer özellikleri, Biçim nesneleri için yaptığınız gibi tanımlayın ve aynı Biçim bölmesinde yaptığınız gibi nesneleri numaralandırın.

Dekont

• Analiz bölmesini yalnızca yeni bilgi ekleyen veya sunulan bilgilere yeni ışık oluşturan nesneler için kullanın (örneğin, önemli eğilimleri gösteren dinamik başvuru çizgileri).
• Görselin görünümünü ve görünümünü denetleyen tüm seçenekler (biçimlendirme) Biçimlendirme bölmesiyle sınırlandırılmalıdır.

Dikkat edilecekler ve sınırlamalar

• Analiz bölmesinde henüz çok örnekli destek yoktur. Bir nesnenin sahip olabileceği tek seçici statiktir (başka bir ifadeyleselector: null), Power BI görsellerinde kullanıcı tanımlı kartın birden çok örneği olamaz.
• Türün integer özellikleri doğru görüntülenmez. Geçici bir çözüm olarak, bunun yerine tür numeric kullanın.

İlgili içerik

Koşullu biçimlendirme ekleme