API til identitetsfilter

API'en til identitetsfilter giver dig mulighed for at oprette en visualisering, der kan filtrere kategoriske data ved hjælp af en semantisk forespørgsel.
Den filtrerer dataene efter datapunkter i stedet for matematiske udtryk.

API'en holder styr på brugervalg, og hvilke data der skal vises. Datapunkterne gemmes i en matrix og refereres til deres placering i matrixen.

Denne API er nyttig i følgende scenarier:

• Til brugerdefinerede visualiseringer, der bruger semantiske modeller med gruppe på nøgler
• Overførsel af visualiseringer, der brugte en ældre API (tidligere end 2.2), til en nyere API
• Tillad valg ved hjælp af identificerende indeksmatrixer

Bemærk

API'en til identitetsfilter er tilgængelig fra API-version 5.1 Hvis du vil finde ud af, hvilken version du bruger, skal du tjekke apiVersion i filen pbiviz.json.

Identitetsfiltermodellen er baseret på grænsefladen IIdentityFilter .

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

Hvis visualiseringen f.eks. modtog følgende opdatering af datavisning:

Matrixen er af typen number[] og indeholder identitetsfelterne for de elementer, som brugeren har valgt.

IdentityIndex svarer til indekset for værdien i den semantiske models værdimatrix (se følgende eksempel).

I ovenstående eksempel: {identityIndex: 0} = "Aaliyah" {identityIndex: 1} = "Aaliyah" {identityIndex: 02 = "Aaliyah" osv.

Sådan bruger du API'en til identitetsfilter

Hvis du vil bruge API'en til identitetsfilter, skal din powerbi-modelversion være 1.9.1 eller nyere.

• Tilføj følgende egenskab som medlem af klassen visual.ts:

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

• Hvis du vil håndtere Power BI-opdateringer, skal du læse målmatrixen fra 'jsonFilters' i 'VisualUpdateOptions' og oversætte den til de tilsvarende værdier. Disse værdier er dem, der blev valgt. I det forrige eksempel svarer en målmatrix på [0,10] til værdierne for Aliyah og Abigail.

• Hvis du vil håndtere brugervalg i det forrige eksempel, skal du klikke på den første Abigail for at føje værdien 8 til matrixen for filterdestinationen og sende den ved hjælp af følgende kommando:

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

Migrering af visualiseringer med gammel API

Fra og med API 5.1.0 skal du føje følgende linjer til filen capabilities.json for at understøtte identitetsfilteret på visualiseringer, der er oprettet i en version, der er ældre end 2.2:

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

Disse linjer konverterer valgene til identitetsfiltre.

Bemærk

Dette trin er kun nødvendigt for eksisterende visualiseringer, der er oprettet med ældre API'er. Nyere visualiseringer behøver ikke at tilføje dette.

Relateret indhold

Brug valg af Power BI-visualiseringer til at føje interaktivitet til en visualisering

Har du flere spørgsmål? Prøv Power BI-community'et.