Megosztás a következőn keresztül:

Identitásszűrő API

  • Cikk

Az Identitásszűrő API lehetővé teszi egy vizualizáció létrehozását, amely képes a kategorikus adatok szűrésére szemantikai lekérdezéssel.
Az adatokat nem matematikai kifejezések, hanem adatpontok szerint szűri.

Az API nyomon követi a felhasználói kijelöléseket, és hogy mely adatpontok jelenjenek meg. Az adatpontok egy tömbben vannak mentve, és a tömbben elfoglalt helyük alapján hivatkoznak rá.

Ez az API a következő helyzetekben hasznos:

  • A kulcsokon csoporttal rendelkező szemantikai modelleket használó egyéni vizualizációk esetében
  • Régebbi (2.2-nél korábbi) API-t használó vizualizációk migrálása egy újabb API-ba
  • Kijelölés engedélyezése indextömbök azonosításával

Megjegyzés:

Az identitásszűrő API az API 5.1-es verziójából érhető el. Ha szeretné megtudni, hogy melyik verziót használja, ellenőrizze a apiVersion pbiviz.json fájlban.

Az identitásszűrő modell az IIdentityFilter interfészen alapul.

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

Ha például a vizualizáció a következő adatnézet-frissítést kapta:

Screenshot of sample array.

A tömb típusszámmal[] rendelkezik, és a felhasználó által kiválasztott elemek identitásmezőit tartalmazza.

Az identityIndex a szemantikai modell értéktömbjében lévő érték indexének felel meg (lásd az alábbi példát).

Screenshot showing array values of names.

A fenti példában: {identityIndex: 0} = "Aaliyah" {identityIndex: 1} = "Aaliyah" {identityIndex: 02 = "Aaliyah" stb.

Az Identitásszűrő API használata

Az Identitásszűrő API használatához a Powerbi-modellek verziójának 1.9.1-es vagy újabb verziónak kell lennie.

  • Adja hozzá a következő tulajdonságot a visual.ts osztály tagjaként:

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

  • A Power BI-frissítések kezeléséhez olvassa el a céltömböt a VisualUpdateOptions "jsonFilters" eleméből, és fordítsa le a megfelelő értékekre. Ezek az értékek lettek kiválasztva. Az előző példában egy [0,10] céltömb az Aliyah és az Abigail értékeinek felel meg.

  • Az előző példában szereplő felhasználói beállítások kezeléséhez kattintson az első Abigailre a 8-as érték szűrő céltömbhöz való hozzáadásához, és küldje el az alábbi paranccsal:

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

Vizualizációk migrálása régi API-val

Az API 5.1.0-tól kezdve a 2.2-nél korábbi verzióval létrehozott vizualizációk identitásszűrőjének támogatásához adja hozzá a következő sorokat a capabilities.json fájlhoz:

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

Ezek a sorok identitásszűrőkké alakítják a kijelöléseket.

Megjegyzés:

Ez a lépés csak a régebbi API-kkal létrehozott meglévő vizualizációkhoz szükséges. Az újabb vizualizációknak nem kell hozzáadniuk ezt.

Kapcsolódó tartalom

A Power BI-vizualizációk kijelöléseinek használata a vizualizációk interaktivitásának hozzáadásához

Van még esetleg kérdése? Próbálja ki a Power BI-közösség.