Το τμήμα παραθύρου "Ανάλυση" στις απεικονίσεις του Power BIThe Analytics pane in Power BI visuals

Το τμήμα παραθύρου Ανάλυση παρουσιάστηκε για τις εγγενείς απεικονίσεις τον Νοέμβριο του 2018.The Analytics pane was introduced for native visuals in November 2018. Αυτό το άρθρο εξετάζει τον τρόπο με τον οποίο οι απεικονίσεις Power BI με το API v2.5.0 μπορούν να παρουσιάζουν και διαχειρίζονται τις ιδιότητές τους στο τμήμα παραθύρου Ανάλυση.This article discusses how Power BI visuals with API v2.5.0 can present and manage their properties in the Analytics pane.

Το τμήμα παραθύρου "Ανάλυση"

Διαχείριση του τμήματος παραθύρου "Ανάλυση"Manage the Analytics pane

Ακριβώς όπως διαχειρίζεστε ιδιότητες στο τμήμα παραθύρου Μορφή, διαχειρίζεστε το τμήμα παραθύρου Ανάλυση καθορίζοντας ένα αντικείμενο στο αρχείο capabilities.json της απεικόνισης.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.

Για το τμήμα παραθύρου Ανάλυση, οι διαφορές είναι οι εξής:For the Analytics pane, the differences are as follows:

  • Στον ορισμό του αντικειμένου, προσθέτετε ένα πεδίο objectCategory με τιμή 2.Under the object's definition, you add an objectCategory field with a value of 2.

    Σημείωση

    Το προαιρετικό πεδίο objectCategory παρουσιάστηκε στο API 2.5.0.The optional objectCategory field was introduced in API 2.5.0. Καθορίζει την πτυχή της απεικόνισης που ελέγχεται από το αντικείμενο (1 = Μορφοποίηση, 2 = Ανάλυση).It defines the aspect of the visual that the object controls (1 = Formatting, 2 = Analytics). Το Formatting χρησιμοποιείται για στοιχεία όπως η εμφάνιση και αίσθηση, τα χρώματα, οι άξονες και οι ετικέτες.Formatting is used for such elements as look and feel, colors, axes, and labels. Το Analytics χρησιμοποιείται για στοιχεία όπως οι προβλέψεις, οι γραμμές τάσης, οι γραμμές αναφοράς και τα σχήματα.Analytics is used for such elements as forecasts, trendlines, reference lines, and shapes.

    Εάν η τιμή δεν καθορίζεται, το objectCategory λαμβάνει προεπιλεγμένη τιμή "Formatting."If the value isn't specified, objectCategory defaults to "Formatting."

  • Το αντικείμενο πρέπει να έχει τις εξής δύο ιδιότητες:The object must have the following two properties:

    • show τύπου bool, με προεπιλεγμένη τιμή false.show of type bool, with a default value of false.
    • displayName τύπου text.displayName of type text. Η προεπιλεγμένη τιμή που επιλέγετε γίνεται το αρχικό εμφανιζόμενο όνομα της παρουσίας.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
      }
    }
  ...
  }
}

Μπορείτε να ορίσετε άλλες ιδιότητες όμοια με τον τρόπο που εκτελείτε Μορφοποίηση αντικειμένων.You can define other properties in the same way that you do for Format objects. Επίσης, μπορείτε να απαριθμήσετε αντικείμενα ακριβώς όπως το κάνετε στο τμήμα παραθύρου Μορφοποίηση.And you can enumerate objects just as you do in the Format pane.

Γνωστοί περιορισμοί και προβλήματα του τμήματος παραθύρου "Ανάλυση"Known limitations and issues of the Analytics pane

  • Το τμήμα παραθύρου Ανάλυση δεν διαθέτει ακόμα υποστήριξη πολλαπλών παρουσιών.The Analytics pane has no multi-instance support yet. Τα αντικείμενα δεν μπορούν να έχουν έναν επιλογέα που δεν είναι στατικός (δηλαδή, "selector": null) και οι απεικονίσεις του Power BI δεν μπορεί να έχουν πολλαπλές παρουσίες μιας κάρτας που έχουν οριστεί από τον χρήστη.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 δεν εμφανίζονται σωστά.Properties of type integer aren't displayed correctly. Ως λύση, χρησιμοποιήστε τον τύπο numeric αντί για αυτόν.As a workaround, use type numeric instead.

Σημείωση

  • Χρησιμοποιήστε το τμήμα παραθύρου Ανάλυση αποκλειστικά για αντικείμενα που προσθέτουν νέες πληροφορίες ή διαφωτίζουν πληροφορίες που έχουν παρουσιαστεί (για παράδειγμα, δυναμικές γραμμές αναφοράς που απεικονίζουν σημαντικές τάσεις).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).
  • Τυχόν επιλογές που ελέγχουν την εμφάνιση και την αίσθηση της απεικόνισης (δηλαδή τη μορφοποίηση) θα πρέπει να περιορίζονται στο τμήμα παραθύρου Μορφοποίηση.Any options that control the look and feel of the visual (that is, formatting) should be limited to the Formatting pane.