Änderungsprotokoll für Power BI-Visuals-API
Diese Seite enthält eine kurze Zusammenfassung der vorhandenen API-Versionen und was in der anstehenden Version zu erwarten ist. Die hier aufgeführten Versionen gelten als stabil und ändern sich nicht.
In Kürze verfügbar
- Hierarchischer Identitätsfilter
- API-Erweiterungen für die Authentifizierung
API v5.8.0
- Lokale Speicher-API: Eine neue Version der lokalen Speicher-API, die für alle benutzerdefinierten visuellen Elemente verfügbar ist und von einer globalen Administratoreinstellung gesteuert wird, die standardmäßig aktiviert ist. Der Administrator kann die globale Einstellung deaktivieren, um sowohl die Legacy-API als auch die neue Version der API zu deaktivieren.
- Unterstützung für benutzerdefinierte visuelle Objekte: Objektunterstützung für benutzerdefinierte visuelle Elemente, um die Benutzererfahrung zu optimieren und eine einheitliche Erstellungserfahrung zu ermöglichen, die auf Parität mit vordefinierten visuellen Elementen basiert.
- Unterstützt Desktop, Februar 2024
API v5.7.0
- Power BI Custom Visuals Authentication API: Diese API ermöglicht benutzerdefinierten Visuals das Abrufen von Microsoft Entra-Zugriffstoken über einmaliges Anmelden (Single Sign-On, SSO), wodurch sichere und effiziente Benutzerkontextvorgänge ermöglicht werden.
- Dynamisches Drillsteuerelement: Ermöglicht es dem visuellen Element, das Drillfeature dynamisch mithilfe eines API-Aufrufs zu aktivieren oder zu deaktivieren.
- Wenn das Drillfeature aktiviert ist, stehen alle Funktionen von Drilldown- und Erweiterungs-/Reduzieren-Features zur Verfügung. Zu diesen Funktionen gehören API-Aufrufe, Kontextmenübefehle, Header-Drillschaltflächen und Unterstützung für Hierarchiedaten.
- Wenn das Drillfeature deaktiviert ist, sind diese Funktionen nicht verfügbar.
- Unterstützt Desktop Dezember 2023
API v5.4.0
- Verbesserte Tastaturnavigation: Verbessert die Barrierefreiheit und Benutzerfreundlichkeit Ihrer visuellen Elemente, indem mehr Optionen für die Interaktion mit visuellen Elemente über die Tastatur bereitgestellt werden.
- Verwendung von Filtern in Berichten erkennen: Erkennen, ob Filter auf einen Bericht angewendet wurden.
- Unterstützt Desktop März 2023
API v5.3.0
- Korrektur des Update für SelectionId für matrix
dataView
.Hinweis
Die Kerndaten von selectionId können sich ändern. Daher ist ein beständiger selectionIds/identityIndex mit einer älteren API-Version in Matrixvisuals möglicherweise nicht relevant.
downloadService
: Fügt eine neue MethodeexportVisualsContentExtended
hinzu, die erweiterte Ergebnisinformationen des Downloads zurückgibt.- Unterstützt Desktop (März 2023)
API v5.2.0
- Angepasste Datenreduktion: Dieses Feature, das zum capabilities.json-Schema hinzugefügt wurde, bietet dem Berichtsautor die Möglichkeit, das Datenabruffenster durch benutzerdefinierten Visual-Code dynamisch zu ändern.
- Unterstützt Desktop Dezember 2022
API v5.1.0
- Benutzerdefinierte Sortierung: Verbesserte benutzerdefinierte Sortierung für Tabellen
- Teilergebnisse: Ein neuer Teilergebnistyp gibt an, ob Gesamtsummen vor oder nach dem Rest der Daten abgerufen werden sollen
- Identitätsfilter: Filtern kategorischer Daten
- Neuer Formatbereich: Entwerfen eines benutzerdefinierten Visuals, das das neue Design des Formatbereichs unterstützt
- Unterstützt Desktop Oktober 2022
API v4.7.0
- Lizenzierungs-API – Verkaufen, Verwalten und Erzwingen von Lizenzen direkt über den kommerziellen Marketplace.
- Drilldown-API – Erstellen Sie ein visuelles Element, das einen Drilldownvorgang ohne Benutzerinteraktion selbst auslösen kann.
- Unterstützt Desktop Juli 2022
API v4.6.0
- Neue Funktionseigenschaft: privileges und zwei Berechtigungen:
- Web Access
- Herunterladen einer Datei aus benutzerdefinierten visuellen Elementen
- Zwei entsprechende Mandantenadministrator-Schalter wurden hinzugefügt
- API herunterladen Herunterladen eines Visuals in eine Datei zulassen
- Unterstützt Desktop Juni 2022
API v4.2.0
- Neue Flags zum Erweitern und Reduzieren von Zeilenüberschriften
- Unterstützt Desktop Februar 2022
API v3.8.0
- Unterstützt Desktop Mai 2021 und höher.
API v3.7.0
- Unterstützt Desktop April 2021 und höher.
API v3.6.0
- Das Visual kann Updates von Power BI empfangen, ohne dass Daten gebunden werden müssen.
- Unterstützt Desktop 2021 von Februar und höhere Versionen.
- Unterstützt Desktop 2021 RS Mai 2021 und höhere Versionen.
API v3.4.0
fetchMoreData
: neueraggregateSegments
-Parameter (Standardwert „true“) zur Unterstützung der Nicht-Aggregation „fetchMoreData“- Unterstützt Desktop 2020 von November und höhere Versionen.
- Unterstützt Desktop 2021 RS Januar 2021 und höhere Versionen.
API v3.2.0
- Unterstützt supportsMultiVisualSelection
- Unterstützt Desktop 2019 von September und höhere Versionen.
- Unterstützt Desktop 2020 RS Januar 2020 und höhere Versionen.
API v2.6.0
- Fügt isInFocus zur Aktualisierungsoption und die switchFocusModeState-Methode zum Host des Visuals hinzu
- Unterstützt die Anpassung von Zwischensummen
- Unterstützt Desktop 2019 von Juni und höhere Versionen.
- Unterstützt Desktop 2019 RS Mai 2019 und höhere Versionen.
API v2.5.0
- Unterstützt den Bereich „Analyse“
- Unterstützt die Methoden
SelectionIdBuilder
withMatrixNode und withTable - Keine Unterstützung mehr für die
DataRepetitionSelector
-Schnittstelle, die durch diedata.CustomVisualOpaqueIdentity
-Schnittstelle ersetzt wurde
API v2.3.0
- API der Angebotsseite
- API für lokalen Speicher
- Tupelfilter-API (Filter für mehrere Spalten)
- API für das Rendern von Ereignissen
API v2.2.0
- Unterstützt das Wiederherstellen eines JSON-Filters aus DataView
- ContextMenu-API
- Unterstützt das Drillthrough -Feature
API v2.1.0
- Leistungsverbesserungen:
- Schnellere Ladezeiten
- Kleinerer Bedarf an Arbeitsspeicher
- Optimierte Daten- und Ereignistransaktionen
Anmerkungen zu diesem Release
Umgestaltete Filter-APIs werden in API 2.2 verfügbar sein und von API 2.1 nicht unterstützt.
Visuals erhalten nur den dataView-Typ, der in ihren Einstellungen deklariert wurde. Grafiken, die mehrere dataView-Typen verwendet haben, funktionieren als Folge dieses Updates nicht mehr.
Nicht mehr unterstützt wird die
DataViewScopeIdentity
-Schnittstelle, die durch diedata.DataRepetitionSelector
-Schnittstelle ersetzt wurde. Wenn Sie die Schlüsseleigenschaft derDataViewScopeIdentity
-Schnittstelle verwendet haben, können Sie sie durchJSON.stringify(identity)
ersetzen.undefined
wird innerhalb von dataView durchnull
ersetzt. Wenn mitvar item in myArray
eine Iteration über ein Array erfolgt, wird zwarundefined
, aber nichtnull
übersprungen. Visuals mit diesem Muster funktionieren aufgrund dieses Updates möglicherweise nicht mehr. Prüfen Sie in Arrays unbedingt aufnull
:for (var item in myArray) { if (!item) { continue; } console.log(item); }
Die
proto
-Eigenschaft speichert innerhalb von dataView keine ausgeblendeten Metadaten/Daten mehr. Visuals, die überproto
auf Eigenschaften zugreifen, funktionieren aufgrund dieses Updates möglicherweise nicht mehr.
API v1.13.0
- Unterstützt Slicer synchronisieren . Beachten Sie, dass dies aufgrund des aktuellen Zustands des PBI-Codes nur für Slicer für Einzelfelder funktioniert. Hier erfahren Sie mehr.
- Barrierefreiheit: Unterstützung für hohen Kontrast
- Barrierefreiheit: Flag „Tastaturfokus“ zulassen
API v1.12.0
- Unterstützt Designs
- Unterstützt fetchMoreData . Beachten Sie, dass für dieAPI zum Abrufen zusätzlicher Daten der harte Grenzwert von 30.000 Datenpunkten nicht mehr gilt.
- Canvas-QuickInfo-API
API v1.11.0
- FilterManager-API
- Unterstützt Lesezeichen
API v1.10.0
- Fügt
ILocalizationManager
hinzu - Authentifizierungs-API
API v1.9.0
API v1.8.0
- Unterstützt den neuen Typ fillRule (Gradient) im Schema „capabilities“
- Unterstützt die rule-Eigenschaft im Schema „capabilities“ für Objekteigenschaften
API v1.7.0
- Unterstützt RESJSON
API 1.6.2
- Unterstützt Bearbeitungsmodus , damit das Visual in den visualinternen Bearbeitungsmodus wechseln kann
- Unterstützt Interaktive (HTML-) R Power BI-Visuals basierend auf HTML
API 1.5.0
- Unterstützt Interaktionen zulassen für die Interaktivität von Visuals
API 1.4.0
- Unterstützt Lokalisierung
API 1.3.0
- Unterstützt QuickInfo
API 1.2.0
- Fügt colorPalette hinzu, um die Farben zu verwalten, die in Ihrem Visual verwendet werden.
- Unterstützt Mehrfachauswahl: selectionManager kann ein Array von
SelectionId
akzeptieren. - Unterstützt R-Visuals mithilfe von R-Skripts
API 1.1.0
- Unterstützt das Debuggen des Visuals in iFrame
- Fügt schlanke Sandbox mit schnellerer iFrame-Initialisierung hinzu
- Behebt das Problem Capabilities.objects unterstützt nicht den Typ „text“
- Unterstützt
pbiviz update
zum Aktualisieren der Typdefinitionen und des Schemas der Visual-API - Unterstützt das Flag
--api-version
inpbiviz new
, um Visuals mit einer bestimmten API-Version zu erstellen - Unterstützt das Alpha-Release von API 1.2.0
Host des Visuals
- Fügt createSelectionIdBuilder hinzu, um eindeutige Bezeichner für die Datenauswahl zu erstellen
- Fügt createSelectionManager hinzu, um den Auswahlzustand des Visuals zu verwalten, und überträgt Änderungen an den Host des Visuals
- Fügt ein Array standardmäßiger Farben zur Verwendung in Visuals hinzu
API 1.0.0
- Erstes Release der API