Zdieľať cez

Rozhranie API filtra identity

  • Článok

Rozhranie API filtra identity umožňuje vytvoriť vizuál, ktorý môže filtrovať kategorické údaje pomocou sémantického dotazu.
Filtruje údaje podľa údajových bodov a nie matematických výrazov.

Rozhranie API uchováva prehľad o výberoch používateľov a o tom, ktoré údajové body sa majú zobraziť. Údajové body sa ukladajú do poľa a odkazujú na ne podľa ich pozície v poli.

Toto rozhranie API je užitočné v nasledujúcich scenároch:

  • Pre vlastné vizuály, ktoré používajú sémantické modely so skupinou v kľúčoch
  • Migrácia vizuálov, ktoré používali staršie rozhranie API (staršie ako 2.2) na novšie rozhranie API
  • Povoliť výbery pomocou identifikácie indexových polí

Poznámka

Rozhranie API filtra identity je k dispozícii vo verzii 5.1 rozhrania API. Ak chcete zistiť, ktorú verziu používate, pozrite si apiVersion súbor pbiviz.json .

Model filtra identity je založený na rozhraní IIdentityFilter .

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

Ak napríklad vizuál dostal nasledujúcu aktualizáciu zobrazenia údajov:

Screenshot of sample array.

Pole je typu number[] a obsahuje polia identity položiek, ktoré používateľ vybral.

IdentitaIndex zodpovedá indexu hodnoty v poli hodnoty sémantického modelu (pozrite si nasledujúci príklad).

Screenshot showing array values of names.

V príklade uvedenom vyššie: {identityIndex: 0} = "Aaliyah" {identityIndex: 1} = "Aaliyah" {identityIndex: 02 = "Aaliyah" atď.

Používanie rozhrania API filtra identity

Na používanie rozhrania API filtra identity musí byť verzia modelov powerbi 1.9.1 alebo vyššia.

  • Ako člena triedy visual.ts pridajte nasledujúcu vlastnosť:

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

  • Ak chcete spracovať aktualizácie služby Power BI, prečítajte si cieľové pole zo súboru jsonFilters v časti VisualUpdateOptions a preložte ho na zodpovedajúce hodnoty. Tieto hodnoty sú vybraté. V predchádzajúcom príklade cieľové pole [0,10] zodpovedá hodnotám Aliyah a Abigail.

  • Ak chcete spracovať výbery používateľa v predchádzajúcom príklade, kliknutím na prvú Abigail pridajte hodnotu 8 do cieľového poľa filtra a odošlite ju pomocou nasledujúceho príkazu:

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

Migrácia vizuálov so starým rozhraním API

Od rozhrania API 5.1.0 na podporu filtra identity vo vizuáloch, ktoré boli vytvorené pomocou verzie predchádzajúcej ako 2.2, pridajte do súboru capabilities.json nasledujúce riadky:

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

Tieto riadky skonvertujú výbery na filtre identity.

Poznámka

Tento krok je potrebný len pre existujúce vizuály vytvorené so staršími rozhraniami API. Novšie vizuály toto vizuály nemusia pridávať.

Súvisiaci obsah

Pridanie interaktivity do vizuálu pomocou výberov vizuálov služby Power BI

Máte ďalšie otázky? Skúste Komunita Power BI.