API φίλτρου ταυτότητας

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

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

Αυτό το API είναι χρήσιμο στα παρακάτω σενάρια:

• Για προσαρμοσμένες απεικονίσεις που χρησιμοποιούν σημασιολογικά μοντέλα με ομαδοποίηση σε κλειδιά
• Μετεγκατάσταση απεικονίσεων που χρησιμοποίησαν ένα παλαιότερο API (παλαιότερο από 2.2) σε ένα νεότερο API
• Να επιτρέπονται οι επιλογές με χρήση της αναγνώρισης πινάκων ευρετηρίου

Σημείωμα

Το API φίλτρου ταυτότητας είναι διαθέσιμο από την έκδοση API 5.1 Για να μάθετε ποια έκδοση χρησιμοποιείτε, ελέγξτε το apiVersion στο αρχείο pbiviz.json.

Το μοντέλο φίλτρου ταυτότητας βασίζεται στη διασύνδεση IIdentityFilter .

    private filter: IIdentityFilter = {
        $schema: “”,
        filterType: FilterType.Identity,
        operator: "In",
        target: []
    }

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

Ο πίνακας είναι τύπου number[] και περιέχει τα πεδία ταυτότητας των στοιχείων που επέλεξε ο χρήστης.

Η identityIndex αντιστοιχεί στο ευρετήριο της τιμής στον πίνακα τιμών του μοντέλου σημασιολογίας (δείτε το παρακάτω παράδειγμα).

Στο παραπάνω παράδειγμα: {identityIndex: 0} = "Aaliyah" {identityIndex: 1} = "Aaliyah" {identityIndex: 02 = "Aaliyah" κ.λπ.

Τρόπος χρήσης του API φίλτρου ταυτότητας

Για να χρησιμοποιήσετε το API φίλτρου ταυτότητας, η έκδοση των μοντέλων σας powerbi πρέπει να είναι 1.9.1 ή νεότερη.

• Προσθέστε την ακόλουθη ιδιότητα ως μέλος της κλάσης visual.ts:

      private filter: IIdentityFilter = {
          $schema: “”,
          filterType: FilterType.Identity,
          operator: "In",
          target: []
      }
  

• Για τον χειρισμό ενημερώσεων του Power BI, διαβάστε τον πίνακα προορισμού από το "jsonFilters" στην "VisualUpdateOptions" και μεταφράστε τον στις αντίστοιχες τιμές. Αυτές οι τιμές είναι εκείνες που επιλέχθηκαν. Στο προηγούμενο παράδειγμα, ο πίνακας-στόχος [0,10] αντιστοιχεί στις τιμές της Aliyah και της Abigail.

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

this.visualHost.applyJsonFilter(this.filter, "general", "filter", powerbi.FilterAction.merge);

Μετεγκατάσταση απεικονίσεων με παλιό API

Ξεκινώντας από το API 5.1.0, για να υποστηρίξετε το φίλτρο ταυτότητας σε απεικονίσεις που δημιουργήθηκαν με μια έκδοση προγενέστερη της έκδοσης 2.2, προσθέστε τις ακόλουθες γραμμές στο αρχείο capabilities.json:

    "migration": {
        "filter": {
            "shouldUseIdentityFilter": true
        }
    }

Αυτές οι γραμμές μετατρέπουν τις επιλογές σε φίλτρα ταυτότητας.

Σημείωμα

Αυτό το βήμα είναι απαραίτητο μόνο για υπάρχουσες απεικονίσεις που έχουν δημιουργηθεί με παλαιότερα API. Οι νεότερες απεικονίσεις δεν χρειάζεται να το προσθέσουν αυτό.

Σχετικό περιεχόμενο

Χρήση επιλογών απεικονίσεων Power BI για την προσθήκη αλληλεπίδρασης σε μια απεικόνιση

Περισσότερες ερωτήσεις; Δοκιμάστε το Κοινότητα Power BI.