Condividi tramite

Log delle modifiche dell'API per gli oggetti visivi di Power BI

  • Articolo

Questa pagina contiene un breve riepilogo delle versioni dell'API esistenti e delle aspettative nella versione futura. Le versioni elencate di seguito sono considerate stabili e non vengono modificate.

API v5.10.0

  • DataViewMetadataColumn ha una nuova proprietà denominata sourceFieldParameters. Questa proprietà indica se il campo corrente è il risultato di un parametro di campo. Se un singolo campo può essere originato da più parametri di campo, questa proprietà elenca tutti i parametri di campo correlati.
  • Supporta Desktop giugno 2024

API v5.9.1

  • acquireAADTokenService: avanzato per supportare i cloud seguenti.
    • Logo commerciale
    • Cloud per la Cina
    • US Government Community Cloud
    • US Government Community Cloud High
    • Cloud per il dipartimento della difesa degli USA

API v5.9.0

  • API di filtro delle identità gerarchiche: consente di creare un oggetto visivo che usa il mapping della matrice DataView per filtrare i dati in base ai punti dati che usano una struttura gerarchica. Ciò è utile per le visualizzazioni personalizzate che sfruttano i modelli semantici delle chiavi di gruppo e vogliono filtrare le gerarchie in base ai punti dati.
  • acquireAADTokenService: esteso con proprietà aggiuntive
  • Supporta Desktop marzo 2024

API v5.8.0

  • API di archiviazione locale: una nuova versione dell'API di archiviazione locale per tutte le visualizzazioni personalizzate, controllata da un'impostazione globale attiva per impostazione predefinita. L'amministratore può disattivare l'impostazione globale per disabilitare sia l'API legacy che la nuova versione dell'API.
  • Supporto sull’oggetto per le visualizzazioni personalizzate: supporto sull’oggetto per le visualizzazioni personalizzate per ottimizzare l'esperienza utente e offrire un'esperienza unificata di creazione equivalente agli oggetti visivi predefiniti.
  • Supporta Desktop febbraio 2024

API v5.7.0

  • API di autenticazione delle visualizzazioni personalizzate di Power BI: consente alle visualizzazioni personalizzate di ottenere token di accesso di Microsoft Entra tramite Single Sign-On (SSO), semplificando operazioni contestuali sicure ed efficienti per l'utente.
  • Controllo del drill-down dinamico: consente all'oggetto visivo di abilitare o disabilitare la funzionalità di drill-down in modo dinamico usando una chiamata API.
    • Quando la funzionalità di drill-down è abilitata, sono disponibili tutte le funzionalità di drill-down e di espansione/compressione. Queste funzionalità includono le chiamate API, i comandi del menu di scelta rapida, i pulsanti di drill-down dell'intestazione e il supporto per i dati gerarchici.
    • Quando la funzionalità di drill-down è disabilitata, queste funzionalità non sono disponibili.
  • Supporta Desktop dicembre 2023

API v5.4.0

API v5.3.0

  • Correzione dell'aggiornamento di SelectionId per matrice dataView.

    Nota

    I dati principali di SelectionId potrebbero cambiare. Pertanto, un elemento selectionId/identityIndex persistente che usa una versione precedente dell'API potrebbe non essere rilevante negli oggetti visivi delle matrice.

  • downloadService: aggiunge un nuovo metodo exportVisualsContentExtended che restituisce informazioni espanse sul risultato del download.
  • Supporta Desktop marzo 2023

API v5.2.0

API v5.1.0

API v4.7.0

  • API licenze: vendere, gestire e applicare licenze direttamente tramite il marketplace commerciale.
  • API drill-down: creare un oggetto visivo in grado di attivare autonomamente un'operazione di drill-down senza interazioni dell'utente.
  • Supporta Desktop luglio 2022

API v4.6.0

  • Nuova proprietà delle funzionalità: privilegi e due privilegi:
    • accesso web
    • scaricare il file dall'oggetto visivo personalizzato
  • Sono state aggiunte due opzioni di amministrazione del tenant corrispondenti
  • Scaricare API per consentire il download dell'oggetto visivo nel file
  • Supporta Desktop giugno 2022

API v4.2.0

API v3.8.0

  • Supporta Desktop maggio 2021 e versioni successive.

API v3.7.0

  • Supporta Desktop aprile 2021 e versioni successive.

API v3.6.0

  • L'oggetto visivo può ricevere aggiornamenti da Power BI senza dover associare dati.
  • Supporta Desktop 2021 febbraio e versioni successive.
  • Supporta Desktop RS maggio 2021 e versioni successive.

API v3.4.0

  • fetchMoreData: nuovo parametro aggregateSegments (il valore predefinito è true), per il supporto di fetchMoreData senza aggregazione
  • Supporta Desktop 2020 novembre e versioni successive.
  • Supporta Desktop RS gennaio 2021 e versioni successive.

API v3.2.0

  • Supporta supportsMultiVisualSelection
  • Supporta Desktop 2019 settembre e versioni successive.
  • Supporta Desktop RS gennaio 2020 e versioni successive.

API v2.6.0

  • Aggiunge isInFocus all'opzione di aggiornamento e il metodo switchFocusModeState all'host degli oggetti visivi
  • Supporta la personalizzazione dei subtotali
  • Supporta Desktop 2019 giugno e versioni successive.
  • Supporta Desktop RS maggio 2019 e versioni successive.

API v2.5.0

  • Supporta il riquadro Analisi
  • Supporta i metodi SelectionIdBuilder withMatrixNode e withTable
  • Non supporta più l'interfaccia DataRepetitionSelector, sostituita con l'interfaccia data.CustomVisualOpaqueIdentity

API v2.3.0

API v2.2.0

API v2.1.0

  • Miglioramenti delle prestazioni:
    • Tempi di caricamento più brevi
    • Footprint della memoria di dimensioni inferiori
    • Ottimizzazione delle transazioni di dati ed eventi

Note sulla versione

  • Le API di filtro sottoposte a refactoring saranno disponibili nell'API v2.2 e non sono supportate nell'API v2.1.

  • Gli oggetti visivi ricevono solo il tipo dataView dichiarato nelle rispettive funzionalità. A seguito di questo aggiornamento, gli oggetti visivi che usavano più tipi dataView smetteranno di funzionare.

  • Non è più supportata l'interfaccia DataViewScopeIdentity, sostituita con l'interfaccia data.DataRepetitionSelector. Se si usava la proprietà Key dell'interfaccia DataViewScopeIdentity, è possibile sostituirla con JSON.stringify(identity)

  • undefined viene sostituito da null all'interno del dataView. Quando si esegue l'iterazione in una matrice tramite var item in myArray, undefined viene ignorato, ma non viene ignorato null. Gli oggetti visivi che usano questo modello possono smettere di funzionare a seguito di questo aggiornamento. Assicurarsi di controllare l'eventuale presenza di null nelle matrici:

    for (var item in myArray) {
   if (!item) {
     continue;
   }
   console.log(item);
}

  • La proprietà proto non memorizza più metadati/dati nascosti all'interno di dataView. Gli oggetti visivi che accedono alle proprietà tramite proto possono smettere di funzionare a seguito di questo aggiornamento.

API v1.13.0

API v1.12.0

API v1.11.0

API v1.10.0

  • Aggiunge ILocalizationManager
  • API di autenticazione

API v1.9.0

API v1.8.0

  • Supporta il nuovo tipo fillRule (gradiente) nello schema delle funzionalità
  • Supporta la proprietà rule nello schema delle funzionalità per le proprietà degli oggetti

API v1.7.0

API v1.6.2

API v1.5.0

API v1.4.0

API v1.3.0

API v1.2.0

  • Aggiunge colorPalette per gestire i colori usati per l'oggetto visivo.
  • Supporta la selezione multipla: selectionManager può accettare una matrice di SelectionId.
  • Supporta oggetti visivi R usando script R

API v1.1.0

  • Supporta oggetti visivi di debug in iFrame
  • Aggiunge una sandbox leggera con inizializzazione più veloce dell'iFrame
  • Corregge il problema Lo schema funzionalità.oggetto non supporta il tipo "text"
  • Supporta pbiviz update per aggiornare le definizioni e lo schema dei tipi di API degli oggetti visivi
  • Supporta il flag --api-version in pbiviz new per la creazione di oggetti visivi con una versione dell'API specifica
  • Supporta la versione alfa dell'API v1.2.0

Host di oggetti visivi

  • Aggiunge createSelectionIdBuilder per la creazione di identificatori univoci usati per la selezione di dati
  • Aggiunge createSelectionManager per la gestione dello stato della selezione dell'oggetto visivo e comunica le modifiche all'host dell'oggetto visivo
  • Aggiunge una matrice di colori predefiniti da usare negli oggetti visivi

API v1.0.0

  • Versione iniziale dell'API