Partage via

Journal des modifications de l’API de visuels Power BI

  • Article

Cette page contient un bref résumé des versions d’API existantes et ce à quoi s’attendre dans la prochaine version. Les versions répertoriées ici sont considérées comme stables et ne changeront pas.

API v5.10.0

  • DataViewMetadataColumn possède une nouvelle propriété appelée sourceFieldParameters. Cette propriété indique si le champ actuel est le résultat d’un paramètre de champ. Si un même champ peut provenir de plusieurs paramètres de champ, cette propriété répertorie tous les paramètres de champ associés.
  • Prise en charge de Desktop juin 2024

API v5.9.1

  • acquireAADTokenService : amélioré pour prendre en charge les clouds suivants.
    • Cloud commercial
    • China Cloud
    • Cloud communautaire pour le service public des États-Unis
    • Cloud communautaire pour le service public des États-Unis – High
    • Département américain de la défense Cloud

API v5.9.0

  • API de filtre d’identité hiérarchique : vous permet de créer un visuel qui utilise le mappage DataView de matrice pour filtrer les données en fonction de points de données qui utilisent une structure hiérarchique. Elle est utile pour les visuels personnalisés qui tirent parti des modèles sémantiques de clés de regroupement et souhaitent filtrer des hiérarchies sur la base de points de données.
  • acquireAADTokenService : étendu avec des propriétés supplémentaires
  • Prise en charge de Desktop mars 2024

API v5.8.0

  • API de stockage local : nouvelle version de l’API de stockage local disponible pour tous les visuels personnalisés et contrôlée par un paramètre général défini comme activé par défaut. L’administrateur peut désactiver le paramètre global pour désactiver l’API héritée et la nouvelle version de l’API.
  • Support sur l’objet pour les visuels personnalisés : support sur objets pour les visuels personnalisés afin d’optimiser l’expérience utilisateur et d’offrir une expérience de création unifiée qui peut rivaliser avec les visuels prêts l’emploi.
  • Prise en charge de Bureau février 2024

API v5.7.0

  • API d’authentification des visuels personnalisés Power BI : permet aux visuels personnalisés d’obtenir des jetons d’accès Microsoft Entra via l’authentification unique (SSO), ce qui facilite des opérations contextuelles utilisateur sécurisées et efficaces.
  • Contrôle d’extraction dynamique : permet au visuel d’activer ou de désactiver la fonctionnalité d’extraction de manière dynamique en utilisant un appel d’API.
    • Lorsque la fonctionnalité d’extraction est activée, toutes les fonctionnalités d’extraction et de développement/réduction sont disponibles. Ces fonctionnalités incluent les appels d’API, les commandes de menu contextuel, les boutons d’extraction d’en-tête et la prise en charge des données de hiérarchie.
    • Lorsque la fonctionnalité d’extraction est désactivée, ces fonctionnalités ne sont pas disponibles.
  • Prise en charge de Desktop décembre 2023

API v5.4.0

API v5.3.0

  • Correctif/Mise à jour de selectionId pour le dataView de type matrice.

    Remarque

    Les données de base de selectionId peuvent changer. Par conséquent, un selectionId/identityIndex persistant qui utilise une version antérieure de l’API peut ne pas convenir dans les visuels de matrice.

  • downloadService : ajout d’une nouvelle méthode exportVisualsContentExtended qui retourne des informations de résultat développées concernant le téléchargement.
  • Prise en charge de Desktop (mars 2023).

API v5.2.0

API v5.1.0

  • Tri personnalisé : tri personnalisé amélioré pour les tables
  • Sous-totaux : le nouveau Type de sous-totaux indique si les totaux doivent être récupérés avant ou après le reste des données
  • Filtre d’identité : permet de filtrer des données catégorielles
  • Volet de nouvelle mise en forme : permet de concevoir un visuel personnalisé qui prend en charge la conception de nouveau volet de mise en forme
  • Prise en charge de Desktop octobre 2022

API v4.7.0

  • API de licence - Vendez, gérez et appliquez des licences directement dans la Place de marché commerciale.
  • API d’extraction - Créez un visuel qui peut déclencher lui-même une opération d’extraction, sans interaction utilisateur.
  • Prise en charge de Desktop juillet 2022

API v4.6.0

API v4.2.0

API v3.8.0

  • Prise en charge de Desktop mai 2021 et ultérieur.

API v3.7.0

  • Prise en charge de Desktop avril 2021 et ultérieur.

API v3.6.0

  • Un visuel peut recevoir des mises à jour de Power BI sans avoir à lier des données.
  • Prend en charge Desktop 2021 février et versions ultérieures.
  • Prend en charge Desktop RS mai 2021 et versions ultérieures.

API v3.4.0

  • fetchMoreData : nouveau paramètre aggregateSegments (valeur par défaut true), pour la prise en charge de fetchMoreData sans agrégation
  • Prend en charge Desktop 2020 novembre et versions ultérieures.
  • Prend en charge Desktop RS janvier 2021 et versions ultérieures.

API v3.2.0

  • Prend en charge supportsMultiVisualSelection
  • Prend en charge Desktop 2019 septembre et versions ultérieures.
  • Prend en charge Desktop RS janvier 2020 et versions ultérieures.

API v2.6.0

  • Ajoute isInFocus pour mettre à jour l’option et la méthode switchFocusModeState à l’hôte du visuel
  • Prend en charge la personnalisation sous-totaux
  • Prend en charge Desktop 2019 juin et versions ultérieures.
  • Prend en charge Desktop RS mai 2019 et versions ultérieures.

API v2.5.0

  • Prend en charge le Volet Analyse
  • Prend en charge les méthodes withMatrixNode et withTable de SelectionIdBuilder
  • Ne prend plus en charge l’interface DataRepetitionSelector, remplacée par l’interface data.CustomVisualOpaqueIdentity

API v2.3.0

API v2.2.0

API v2.1.0

  • Amélioration des performances :
    • Temps de chargement plus rapides
    • Encombrement mémoire plus faible
    • Données et transactions d’événement optimisées

Notes de publication

  • Les API de filtrage refactorisées sont disponibles dans l’API 2.2 et ne sont pas prises en charge dans l’API 2.1.

  • Les visuels recevront uniquement le type de dataView qui a été déclaré dans leurs fonctionnalités. Les visuels qui utilisaient plusieurs types de dataView cesseront de fonctionner à la suite de cette mise à jour.

  • Ne prend plus en charge l’interface DataViewScopeIdentity, remplacée par l’interface data.DataRepetitionSelector. Si vous utilisiez la propriété de clé de l’interface DataViewScopeIdentity, vous pouvez la remplacer par JSON.stringify(identity)

  • undefined est remplacé par null à l’intérieur de la dataView. Lors d’une itération sur un tableau avec var item in myArray, il ignore undefined mais pas null. Les visuels qui utilisent ce modèle peuvent cesser de fonctionner après cette mise à jour. Veillez à vérifier la présence de null dans les tableaux :

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

  • La propriété proto ne stocke plus les métadonnées/données cachées dans la dataView. Les visuels qui accèdent aux propriétés via proto peuvent cesser de fonctionner après cette mise à jour.

API v1.13.0

API v1.12.0

API v1.11.0

API v1.10.0

  • Ajoute ILocalizationManager
  • API d’authentification

API v1.9.0

API v1.8.0

  • Prend en charge le nouveau type fillRule (gradient) dans le schéma des fonctionnalités
  • Prend en charge la propriété rule dans le schéma des fonctionnalités pour les propriétés d’objet

API v1.7.0

API v1.6.2

API v1.5.0

API v1.4.0

API v1.3.0

API v1.2.0

  • Ajoute colorPalette pour gérer les couleurs utilisées sur votre visuel.
  • Prend en charge la sélection multiple : selectionManager peut accepter un tableau de SelectionId.
  • Prend en charge les visuels R à l’aide de scripts R

API v1.1.0

  • Prend en charge le visuel de débogage dans un iFrame
  • Ajoute un bac à sable (sandbox) léger et une initialisation plus rapide de l’iFrame
  • Résout le problème Capabilities.objects does not support "text" type
  • Prend en charge pbiviz update pour mettre à jour les définitions de type et le schéma des API de visuel
  • Prend en charge l’indicateur --api-version dans pbiviz new pour créer des visuels avec une version d’API spécifique
  • Prend en charge la version alpha de l’API v1.2.0

Hôte de visuel

  • Ajoute createSelectionIdBuilder pour créer des identificateurs uniques utilisés pour la sélection des données
  • Ajoute createSelectionManager pour gérer l’état de sélection du visuel et communiquer les modifications à l’hôte du visuel
  • Ajoute un tableau de couleurs par défaut à utiliser dans les visuels

API v1.0.0

  • Version initiale de l’API