Käyttäjätietosuodattimen ohjelmointirajapinta

Käyttäjätietosuodattimen ohjelmointirajapinnan avulla voit luoda visualisoinnin, joka voi suodattaa luokittaisia tietoja semanttisen kyselyn avulla.
Se suodattaa tiedot arvopisteiden mukaan matemaattisten lausekkeiden sijaan.

Ohjelmointirajapinta seuraa käyttäjien valintoja ja näytettäviä arvopisteitä. Arvopisteet tallennetaan matriisiin, ja niihin viitataan niiden sijainnin mukaan matriisissa.

Tästä ohjelmointirajapinnasta on hyötyä seuraavissa tilanteissa:

• Mukautetut visualisoinnit, jotka käyttävät semanttisia malleja ja ryhmittele avaimia
• Vanhempaa ohjelmointirajapintaa (aiemmin kuin 2.2) käyttävien visualisointien siirtäminen uudempaan ohjelmointirajapintaan
• Salli valinnat indeksimatriisien tunnistamisen avulla

Muistiinpano

Käyttäjätietosuodattimen ohjelmointirajapinta on saatavilla ohjelmointirajapinnan versiosta 5.1 Selvittääksesi, mitä versiota käytät, tarkista apiVersion pbiviz.json-tiedosto.

Käyttäjätietojen suodatinmalli perustuu IIdentityFilter-liittymään .

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

Esimerkiksi, jos visualisointi sai seuraavan tietonäkymäpäivityksen:

-matriisi on tyyppiä numero[], ja se sisältää käyttäjän valitsemien kohteiden käyttäjätietokentät.

IdentityIndex vastaa semanttisen mallin arvomatriisin arvon indeksiä (katso seuraavaa esimerkkiä).

Yllä olevassa esimerkissä: {identityIndex: 0} = "Aaliyah" {identityIndex: 1} = "Aaliyah" {identityIndex: 02 = "Aaliyah" jne.

Käyttäjätietosuodattimen ohjelmointirajapinnan käyttäminen

Jotta voit käyttää käyttäjätietosuodattimen ohjelmointirajapintaa, powerbi-models-version on oltava 1.9.1 tai uudempi.

• Lisää seuraava ominaisuus visual.ts-luokan jäseneksi:

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

• Jos haluat käsitellä Power BI -päivityksiä, lue kohdematriisi "jsonFilters"-kohdasta VisualUpdateOptions-kohteessa ja käännä se vastaaviin arvoihin. Nämä arvot on valittu. Edellisessä esimerkissä kohteen [0,10] kohdematriisi vastaa Aliyahin ja Abigailin arvoja.

• Voit käsitellä käyttäjävalintoja edellisessä esimerkissä napsauttamalla ensimmäistä Oletusarvoa lisätäksesi arvon 8 suodatuksen kohdematriisiin ja lähettääksesi sen seuraavan komennon avulla:

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

Visualisointien siirtäminen vanhan ohjelmointirajapinnan avulla

Ohjelmointirajapinnasta 5.1.0 alkaen voit tukea käyttäjätietojen suodatinta visualisoinneissa, jotka on luotu käyttämällä versiota 2.2 aiemmin, lisäämällä seuraavat rivit capabilities.json-tiedostoon :

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

Nämä rivit muuntavat valinnat käyttäjätietojen suodattimiksi.

Muistiinpano

Tämä vaihe on tarpeen vain olemassa oleville visualisoinneille, jotka on luotu vanhoilla ohjelmointirajapinnoilla. Tätä ei tarvitse lisätä uudempien visualisointien avulla.

Liittyvä sisältö

Vuorovaikutteisuuden lisääminen visualisointiin Power BI -visualisointien valintojen avulla

Onko sinulla lisää kysymyksiä? Kokeile Power BI -yhteisö.