Power BI görsellerindeki Analiz bölmesi

Analytics bölmesi görsellerinize minimum, maksimum veya ortalama 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, Analytics bölmesinde dinamik başvuru çizgileri sunabilen ve yönetebilen Power BI görsellerinin nasıl oluşturulacağı açıklanır.

Not

Analytics 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ındaki apiVersion denetleyin.

Analiz bölmesini yönetme

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

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

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

{
  "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ının altına displayName ve değeri 2olan bir objectCategory alanı ekleyin.

   Not

   objectCategory alanı, 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 Formatting kullanın. Tahminler, başvuru çizgileri ve şekiller gibi öğeler için Analytics kullanın.

   objectCategory değeri belirtilmezse, varsayılan olarak Formattingolur.

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

   • show, bool türünde ve varsayılan değeri true olan
   • displayName türü text olan ve varsayılan değeri true olan

{
  "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, set card analyticsPane parametresini trueolarak ayarlayarak bu kartın analiz bölmesine ait olduğunu belirtin. Varsayılan olarak, analyticsPane parametresi false'tur ve kart biçimlendirme bölmesine eklenir. Aşağıdaki uygulamalara bakın:

FormatModel Yardımcı Araçlarını 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];
}

      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 Biçim bölmesinde yaptığınız gibi nesneleri numaralandırın.

Not

• Analytics bölmesini yalnızca yeni bilgiler 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 ve hissiyatını denetleyen tüm seçenekler (biçimlendirme), Biçimlendirme bölmesiyle sınırlandırılmalıdır.

Dikkat edilmesi gerekenler ve sınırlamalar

• Analytics bölmesinde henüz çoklu örnek desteği yoktur. Bir nesnenin sahip olabileceği tek seçicistatik (selector: null), ve Power BI görsellerinde kullanıcı tanımlı bir kartın birden fazla örneği olamaz.
• integer türü özellikleri doğru görüntülenmez. Geçici çözüm olarak bunun yerine numeric yazın.

İlgili içerik

Koşullu biçimlendirme ekleme