Κοινή χρήση μέσω


Δυνατότητες και ιδιότητες απεικονίσεων του Power BI

Κάθε απεικόνιση έχει ένα αρχείο capabilities.json που δημιουργείται αυτόματα όταν εκτελείτε την pbiviz new <visual project name> εντολή για να δημιουργήσετε μια νέα απεικόνιση. Το αρχείο capabilities.json περιγράφει την απεικόνιση στον κεντρικό υπολογιστή.

Το αρχείο capabilities.json ενημερώνει τον κεντρικό υπολογιστή σχετικά με το είδος των δεδομένων που αποδέχεται η απεικόνιση, τα χαρακτηριστικά με δυνατότητα προσαρμογής που θα τοποθετηθεί στο τμήμα παραθύρου ιδιοτήτων και άλλες πληροφορίες που απαιτούνται για τη δημιουργία της απεικόνισης. Ξεκινώντας από το API v4.6.0, όλες οι ιδιότητες στο μοντέλο δυνατοτήτων είναι προαιρετικέςεκτός από privilegesτις , οι οποίες είναι υποχρεωτικές.

Το αρχείο capabilities.json παραθέτει τα ριζικά αντικείμενα στην ακόλουθη μορφή:

{
    "privileges": [ ... ],
    "dataRoles": [ ... ],
    "dataViewMappings": [ ... ],
    "objects":  { ... },
    "supportsHighlight": true|false,
    "advancedEditModeSupport": 0|1|2,
    "sorting": { ... }
    ...
}

Όταν δημιουργείτε μια νέα απεικόνιση, το προεπιλεγμένο αρχείο capabilities.json περιλαμβάνει τα ακόλουθα αντικείμενα ρίζας:

Τα παραπάνω αντικείμενα είναι αυτά που απαιτούνται για τη σύνδεση δεδομένων. Μπορούν να τροποποιηθούν όπως απαιτείται για την απεικόνισή σας.

Τα ακόλουθα άλλα αντικείμενα ρίζας είναι προαιρετικά και μπορούν να προστεθούν ανάλογα με τις ανάγκες:

Μπορείτε να βρείτε όλα αυτά τα αντικείμενα και τις παραμέτρους τους στο σχήμα capabilities.json

δικαιώματα: καθορίστε τα ειδικά δικαιώματα που απαιτεί η απεικόνισή σας

Τα δικαιώματα είναι ειδικές λειτουργίες στις οποίες απαιτεί πρόσβαση η απεικόνισή σας για να λειτουργήσει. Τα δικαιώματα λαμβάνουν έναν πίνακα αντικειμένων privilege , ο οποίος ορίζει όλες τις ιδιότητες δικαιωμάτων. Οι παρακάτω ενότητες περιγράφουν τα δικαιώματα που είναι διαθέσιμα στο Power BI.

Σημείωμα

Από το API v4.6.0, τα δικαιώματα πρέπει να καθοριστούν στο αρχείο capabilities.json . Σε παλαιότερες εκδόσεις, η απομακρυσμένη πρόσβαση εκχωρείται αυτόματα και η λήψη σε αρχεία δεν είναι δυνατή. Για να μάθετε ποια έκδοση χρησιμοποιείτε, ελέγξτε το apiVersion στο αρχείο pbiviz.json .

Ορισμός δικαιωμάτων

Ένας ορισμός δικαιωμάτων JSON περιέχει αυτά τα στοιχεία:

  • name - (συμβολοσειρά) Το όνομα του δικαιώματος.
  • essential - (Δυαδική τιμή) Υποδεικνύει εάν η λειτουργικότητα απεικόνισης απαιτεί αυτό το δικαίωμα. Η τιμή true σημαίνει ότι το δικαίωμα απαιτείται. false Σημαίνει ότι το δικαίωμα δεν είναι υποχρεωτικό.
  • parameters - (πίνακας συμβολοσειρών)(προαιρετικά) Ορίσματα. Εάν parameters λείπει, θεωρείται κενός πίνακας.

Ακολουθούν τύποι δικαιωμάτων που πρέπει να οριστούν:

Σημείωμα

Ακόμη και με αυτά τα δικαιώματα που εκχωρούνται στην απεικόνιση, ο διαχειριστής πρέπει να ενεργοποιήσει την αλλαγή στις ρυθμίσεις διαχείρισης για να επιτρέψει στα άτομα στον οργανισμό τους να επωφεληθούν από αυτές τις ρυθμίσεις.

Να επιτρέπεται η πρόσβαση στο web

Για να επιτρέψετε σε μια απεικόνιση να αποκτήσει πρόσβαση σε έναν εξωτερικό πόρο ή μια τοποθεσία web, προσθέστε αυτές τις πληροφορίες ως προνόμιο στην ενότητα δυνατοτήτων. Ο ορισμός δικαιωμάτων περιλαμβάνει μια προαιρετική λίστα διευθύνσεων URL στις οποίες επιτρέπεται η πρόσβαση στην απεικόνιση με τη μορφή http://xyz.com ή https://xyz.com. Κάθε διεύθυνση URL μπορεί επίσης να περιλαμβάνει έναν χαρακτήρα μπαλαντέρ για τον καθορισμό υποτομών.

Ο ακόλουθος κώδικας είναι ένα παράδειγμα ρύθμισης δικαιωμάτων που επιτρέπει την πρόσβαση σε εξωτερικούς πόρους:

{
    "name": "WebAccess",
    "essential": true,
    "parameters": [ "https://*.microsoft.com", "http://example.com" ]
}

Το προηγούμενο WebAccess δικαίωμα σημαίνει ότι η απεικόνιση πρέπει να αποκτήσει πρόσβαση σε οποιονδήποτε υποτομέα του τομέα μόνο μέσω του microsoft.com πρωτοκόλλου HTTPS και example.com χωρίς υποτομείς μέσω HTTP και ότι αυτό το δικαίωμα πρόσβασης είναι απαραίτητο για να λειτουργήσει η απεικόνιση.

Λήψη στο αρχείο

Για να επιτρέψετε στο χρήστη την εξαγωγή δεδομένων από μια απεικόνιση σε ένα αρχείο, ορίστε ExportContent το σε true.

Αυτή η ExportContent ρύθμιση επιτρέπει στην απεικόνιση να εξάγει δεδομένα σε αρχεία στις ακόλουθες μορφές:

  • .txt
  • .Csv
  • .Json
  • .tmplt
  • .xml
  • .pdf
  • .xlsx

Αυτή η ρύθμιση είναι ξεχωριστή και δεν επηρεάζεται από τους περιορισμούς λήψης που εφαρμόζονται στις ρυθμίσεις μισθωτή εξαγωγής και κοινής χρήσης του οργανισμού.

Ο ακόλουθος κώδικας είναι ένα παράδειγμα ρύθμισης δικαιωμάτων που επιτρέπει τη λήψη σε ένα αρχείο:

"privileges": [
    {
        "name": "ExportContent",
        "essential": true
    }
]

Δικαιώματα τοπικού χώρου αποθήκευσης

Αυτό το δικαίωμα επιτρέπει σε μια προσαρμοσμένη απεικόνιση να αποθηκεύει πληροφορίες στο τοπικό πρόγραμμα περιήγησης του χρήστη.

Ακολουθεί ένα παράδειγμα μιας ρύθμισης δικαιωμάτων που επιτρέπει τη χρήση του τοπικού χώρου αποθήκευσης:

"privileges": [
    {
        "name": "LocalStorage",
        "essential": true
    }
]

Δεν απαιτούνται δικαιώματα

Εάν η απεικόνιση δεν απαιτεί ειδικά δικαιώματα, ο privileges πίνακας θα πρέπει να είναι κενός:

  "privileges": []

Πολλαπλά δικαιώματα

Το παρακάτω παράδειγμα δείχνει πώς μπορείτε να ορίσετε πολλά δικαιώματα για μια προσαρμοσμένη απεικόνιση.

"privileges": [
    {
        "name": "WebAccess",
        "essential": true,
        "parameters": [ "https://*.virtualearth.net" ]
    },
    {
        "name": "ExportContent",
        "essential": false
    }
]

dataroles: καθορίστε τα πεδία δεδομένων που αναμένει η απεικόνισή σας

Για να ορίσετε πεδία που μπορούν να συνδεθούν με δεδομένα, χρησιμοποιήστε το dataRoles. dataRoles Το είναι ένας πίνακας αντικειμένων DataViewRole , ο οποίος ορίζει όλες τις απαιτούμενες ιδιότητες. Τα dataRoles αντικείμενα είναι τα πεδία που εμφανίζονται στο τμήμα παραθύρου Ιδιότητες.

Ο χρήστης σύρει πεδία δεδομένων σε αυτά για να συνδέσει δεδομένα στα πεδία δεδομένων στα αντικείμενα.

Ιδιότητες DataRole

Καθορίστε το DataRoles με τις ακόλουθες ιδιότητες:

  • name: Το εσωτερικό όνομα αυτού του πεδίου δεδομένων (πρέπει να είναι μοναδικό).
  • displayName: Το όνομα που εμφανίζεται στον χρήστη στο τμήμα παραθύρου Ιδιότητες .
  • kind: Το είδος του πεδίου:
    • Grouping: Σύνολο διακριτών τιμών που χρησιμοποιούνται για την ομαδοποίηση πεδίων μέτρησης.
    • Measure: Μεμονωμένες αριθμητικές τιμές.
    • GroupingOrMeasure: Τιμές που μπορούν να χρησιμοποιηθούν είτε ως ομαδοποίηση, είτε ως μέτρηση.
  • description: Μια σύντομη περιγραφή κειμένου του πεδίου (προαιρετικό).
  • requiredTypes: Ο απαιτούμενος τύπος δεδομένων για αυτόν τον ρόλο δεδομένων. Οι τιμές που δεν συμφωνούν ορίζονται σε null (προαιρετικό).
  • preferredTypes: Ο προτιμώμενος τύπος δεδομένων για αυτόν τον ρόλο δεδομένων (προαιρετικό).

Έγκυροι τύποι δεδομένων για requiredTypes και preferredTypes

  • bool: Μια δυαδική τιμή
  • ακέραιος: Μια ακέραια τιμή
  • numeric: Μια αριθμητική τιμή
  • text: Μια τιμή κειμένου
  • geography: Γεωγραφικά δεδομένα

παράδειγμα dataRoles

"dataRoles": [
    {
        "displayName": "My Category Data",
        "name": "myCategory",
        "kind": "Grouping",
        "requiredTypes": [
            {
                "text": true
            },
            {
                "numeric": true
            },
            {
                "integer": true
            }
        ],
        "preferredTypes": [
            {
                "text": true
            }
        ]
    },
    {
        "displayName": "My Measure Data",
        "name": "myMeasure",
        "kind": "Measure",
        "requiredTypes": [
            {
                "integer": true
            },
            {
                "numeric": true
            }
        ],
        "preferredTypes": [
            {
                "integer": true
            }
        ]
    }
]
...
}

Οι προηγούμενοι ρόλοι δεδομένων θα δημιουργήσουν τα πεδία που εμφανίζονται στην παρακάτω εικόνα:

Πεδία ρόλου δεδομένων

dataViewMappings: πώς θέλετε να αντιστοιχιστούν τα δεδομένα

Τα dataViewMappings αντικείμενα περιγράφουν τον τρόπο με τον οποίο οι ρόλοι δεδομένων σχετίζονται μεταξύ τους και σας επιτρέπουν να καθορίσετε απαιτήσεις υπό όρους για την εμφάνιση προβολών δεδομένων.

Οι περισσότερες απεικονίσεις παρέχουν μία μόνο αντιστοίχιση, όμως μπορείτε να παρέχετε πολλές dataViewMapping. Κάθε έγκυρη αντιστοίχιση παράγει μια προβολή δεδομένων.

"dataViewMappings": [
    {
        "conditions": [ ... ],
        "categorical": { ... },
        "table": { ... },
        "single": { ... },
        "matrix": { ... }
    }
]

Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Κατανόηση της αντιστοίχισης προβολής δεδομένων σε απεικονίσεις Power BI.

αντικείμενα: ορισμός επιλογών παραθύρου ιδιοτήτων

Τα αντικείμενα περιγράφουν προσαρμόσιμες ιδιότητες που σχετίζονται με την απεικόνιση. Τα αντικείμενα που ορίζονται σε αυτήν την ενότητα είναι τα αντικείμενα που εμφανίζονται στο τμήμα παραθύρου Μορφοποίηση. Κάθε αντικείμενο μπορεί να έχει πολλές ιδιότητες και κάθε ιδιότητα έχει έναν τύπο συσχετισμένο με αυτή.

"objects": {
    "myCustomObject": {
        "properties": { ... }
    }
}

Για παράδειγμα, για την υποστήριξη δυναμικών συμβολοσειρών μορφοποίησης στην προσαρμοσμένη απεικόνισή σας, ορίστε το ακόλουθο αντικείμενο:

"objects": {
        "general": {
            "properties": {
                "formatString": {
                    "type": {
                        "formatting": {
                            "formatString": true
                        }
                    }
                }
            }
        },

Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Αντικείμενα και ιδιότητες απεικονίσεων του Power BI.