Änderungsprotokoll für Power BI-Visuals-API

  • Artikel

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

API v5.3.0

  • Korrektur des Update für SelectionId für matrixdataView.

    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 Methode exportVisualsContentExtended 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

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: neuer aggregateSegments-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 SelectionIdBuilderwithMatrixNode und withTable
  • Keine Unterstützung mehr für die DataRepetitionSelector-Schnittstelle, die durch die data.CustomVisualOpaqueIdentity-Schnittstelle ersetzt wurde

API v2.3.0

API v2.2.0

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 die data.DataRepetitionSelector-Schnittstelle ersetzt wurde. Wenn Sie die Schlüsseleigenschaft der DataViewScopeIdentity-Schnittstelle verwendet haben, können Sie sie durch JSON.stringify(identity) ersetzen.

  • undefined wird innerhalb von dataView durch null ersetzt. Wenn mit var item in myArray eine Iteration über ein Array erfolgt, wird zwar undefined, aber nicht null übersprungen. Visuals mit diesem Muster funktionieren aufgrund dieses Updates möglicherweise nicht mehr. Prüfen Sie in Arrays unbedingt auf null:

    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 über proto auf Eigenschaften zugreifen, funktionieren aufgrund dieses Updates möglicherweise nicht mehr.

API v1.13.0

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

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

API 1.6.2

API 1.5.0

API 1.4.0

API 1.3.0

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 SelectionIdakzeptieren.
  • 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 in pbiviz 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