Power BI görsellerinde Analiz bölmesiThe Analytics pane in Power BI visuals

Analiz bölmesi Kasım 2018’de yerel görseller için kullanıma sunuldu.The Analytics pane was introduced for native visuals in November 2018. Bu makalede Power BI görsellerinin API v2.5.0 ile özelliklerini Analiz bölmesinde nasıl gösterebildiği ve yönetebildiği açıklanır.This article discusses how Power BI visuals with API v2.5.0 can present and manage their properties in the Analytics pane.

Analiz bölmesi

Analiz bölmesini yönetmeManage the Analytics pane

Aynı Biçim bölmesindeki özellikleri yönettiğiniz gibi, görselin capabilities.json dosyasında bir nesne tanımlayarak Analiz bölmesini de yönetebilirsiniz.Just as you'd manage properties in the Format pane, you manage the Analytics pane by defining an object in the visual's capabilities.json file.

Analiz bölmesinin farklılıkları şunlardır:For the Analytics pane, the differences are as follows:

  • Nesnenin tanımının altına değeri 2 olan bir objectCategory alanı eklersiniz.Under the object's definition, you add an objectCategory field with a value of 2.

    Not

    İsteğe bağlı objectCategory alanı API 2.5.0’da eklenmiştir.The optional objectCategory field was introduced in API 2.5.0. Nesnenin denetlediği görselin görünüşünü tanımlar (1 = Biçimlendirme, 2 = Analiz).It defines the aspect of the visual that the object controls (1 = Formatting, 2 = Analytics). Formatting genel görünüm, renkler, eksenler ve etiketler gibi öğeler için kullanılır.Formatting is used for such elements as look and feel, colors, axes, and labels. Analytics tahminler, eğilim çizgileri, başvuru çizgileri ve şekiller gibi öğeler için kullanılır.Analytics is used for such elements as forecasts, trendlines, reference lines, and shapes.

    Değer belirtilmezse objectCategory için varsayılan olarak "Formatting" kullanılır.If the value isn't specified, objectCategory defaults to "Formatting."

  • Nesnenin aşağıdaki iki özelliği olmalıdır:The object must have the following two properties:

    • show, bool türündedir ve false varsayılan değerine sahiptir.show of type bool, with a default value of false.
    • displayName, text türündedir.displayName of type text. Seçtiğiniz varsayılan değer, örneğin ilk görünen adı olur.The default value that you choose becomes the instance's initial display name.
{
  "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
      }
    }
  ...
  }
}

Diğer özellikleri aynı Format nesnelerinde yaptığınız gibi tanımlayabilirsiniz.You can define other properties in the same way that you do for Format objects. Ayrıca nesneleri Biçim bölmesinde yaptığınız gibi numaralandırabilirsiniz.And you can enumerate objects just as you do in the Format pane.

Analiz bölmesinin bilinen sınırlamaları ve sorunlarıKnown limitations and issues of the Analytics pane

  • Analiz bölmesinde henüz birden çok örnek desteği yoktur.The Analytics pane has no multi-instance support yet. Nesnelerin statik dışında farklı bir seçicisi olamaz (bu da “selector”: null olur) ve Power BI görsellerinde bir kartın kullanıcı tanımlı birden fazla örneği bulunamaz.Objects can't have a selector other than static (that is, "selector": null), and Power BI visuals can't have user-defined multiple instances of a card.
  • integer türündeki özellikler doğru şekilde görüntülenmiyor.Properties of type integer aren't displayed correctly. Bunun yerine, geçici bir çözüm olarak numeric türünü kullanın.As a workaround, use type numeric instead.

Not

  • Analiz bölmesini yalnızca yeni bilgiler ekleyen veya sunulan bilgilere farklı bir bakış açısı getiren nesneler için kullanın (örneğin önemli eğilimlere ışık tutan dinamik başvuru satırları).Use the Analytics pane only for objects that add new information or shed new light on the presented information (for example, dynamic reference lines that illustrate important trends).
  • Görselin görünüm ve kullanımını denetleyen tüm seçenekler (biçimlendirme) Biçimlendirme bölmesiyle sınırlandırılmalıdır.Any options that control the look and feel of the visual (that is, formatting) should be limited to the Formatting pane.