Condividi tramite


API di filtro delle identità

L'API di filtro delle identità consente di creare un oggetto visivo in grado di filtrare i dati categorici usando una query semantica.
Filtra i dati in base ai punti dati anziché alle espressioni matematiche.

L'API tiene traccia delle selezioni degli utenti e dei punti dati da visualizzare. I punti dati vengono salvati in una matrice e referenziati in base alla relativa posizione nella matrice.

Questa API è utile negli scenari seguenti:

  • Per oggetti visivi personalizzati che usano modelli semantici con raggruppamento in chiavi
  • Migrazione di oggetti visivi che usano un'API precedente (precedente alla 2.2) a un'API più recente
  • Consenti selezioni usando l'identificazione delle matrici di indici

Nota

L'API di filtro delle identità è disponibile nell'API versione 5.1 Per scoprire quale versione si sta usando, controllare il apiVersion nel file pbiviz.json.

Il modello di filtro delle identità si basa sull'interfaccia IIdentityFilter.

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

Ad esempio, se l'oggetto visivo ha ricevuto l'aggiornamento della visualizzazione dati seguente:

Screenshot della matrice di esempio.

La matrice è di tipo numero[] e contiene i campi identità degli elementi selezionati dall'utente.

L’identityIndex corrisponde all'indice del valore nella matrice di valori del modello semantico (vedere l'esempio seguente).

Screenshot che mostra i valori di matrice dei nomi.

Nell'esempio precedente: {identityIndex: 0} = "Aaliyah" {identityIndex: 1} = "Aaliyah" {identityIndex: 02 = "Aaliyah" ecc.

Come usare l'API di filtro delle identità

Per usare l'API di filtro delle identità, la versione dei modelli powerbi deve essere 1.9.1 o successiva.

  • Aggiungere la proprietà seguente come membro della classe visual.ts:

        private filter: IIdentityFilter = {
            $schema: “”,
            filterType: FilterType.Identity,
            operator: "In",
            target: []
        }
    
  • Per gestire gli aggiornamenti di Power BI, leggere la matrice di destinazione da 'jsonFilters' in 'VisualUpdateOptions' e convertirla nei valori corrispondenti. Questi valori sono quelli selezionati. Nell'esempio precedente, una matrice di destinazione [0,10] corrisponde ai valori di Aliyah e Abigail.

  • Per gestire le selezioni utente nell'esempio precedente, fare clic sul primo Abigail per aggiungere il valore 8 alla matrice di destinazione del filtro e inviarlo usando il comando seguente:

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

Migrazione di oggetti visivi con l'API precedente

A partire dall'API 5.1.0, per supportare il filtro delle identità sugli oggetti visivi creati usando una versione precedente alla 2.2, aggiungere le righe seguenti al file capabilities.json:

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

Queste righe convertono le selezioni in filtri identità.

Nota

Questo passaggio è necessario solo per gli oggetti visivi esistenti creati con le API precedenti. Gli oggetti visivi più recenti non hanno bisogno di aggiungere questo elemento.

Usare le selezioni degli oggetti visivi di Power BI per aggiungere interattività a un oggetto visivo

Altre domande? Provare la Community di Power BI.