Appliquer des thèmes de rapport

  • Article

Power BI thèmes de rapport vous permettent d’appliquer des modifications de conception à l’ensemble de votre rapport. Par exemple, vous pouvez inclure vos couleurs d’entreprise et modifier vos jeux d’icônes. Lorsque vous appliquez un thème de rapport, tous les visuels de votre rapport utilisent les couleurs et la mise en forme de votre thème sélectionné comme valeurs par défaut. Pour plus d’informations sur les paramètres de thème et leur conception, consultez format de fichier JSON du thème rapport.

Vous pouvez enregistrer et publier un rapport avec un thème qui lui est appliqué. Le thème appliqué est le thème par défaut de ce rapport lorsqu’il est chargé dans le service Power BI ou dans le analytique incorporé Power BI.

Les développeurs utilisant power BI embedded analytique ont également la possibilité d’incorporer un rapport avec un thème personnalisé appliqué au lieu du thème par défaut pour le rapport. L’application d’un thème de cette façon charge le même rapport avec différents thèmes à différents utilisateurs en fonction de leurs paramètres.

Objet de thème de rapport

Cette section décrit l’objet de thème de rapport utilisé pour représenter des thèmes. Un type d’objet IReportTheme peut être passé à la configuration incorporée.

interface IEmbedConfiguration extends IEmbedConfigurationBase {
  ...
  theme?: models.IReportTheme;
}

L’objet de thème de rapport doit avoir un paramètre unique nommé themeJson. Ce champ doit contenir l’objet JSON qui représente les paramètres de thème. Pour plus d’informations, consultez la page Format de fichier JSON du thème rapport.

interface IReportTheme {}
interface ICustomTheme extends IReportTheme {
  themeJson: any;
}

Appliquer un thème à un rapport

Le thème appliqué peut également être modifié une fois le rapport chargé. Lorsque vous appliquez le thème une fois le rapport chargé, l’utilisateur final peut sélectionner un thème dans une liste et voir les modifications de style appliquées immédiatement au rapport sans recharger.

Appliquer un thème au chargement

Cet exemple est utile si vous souhaitez appliquer un thème personnalisé au chargement de rapport.

// Parse the theme JSON file into an object
let themeJsonObject = parseJsonfile(path);
let embedConfig = {
    …
    theme: {
        themeJson: themeJsonObject
    }
};

let report = powerbi.embed(embedContainer, embedConfig);

Appliquer le thème au moment de l’exécution

La méthode apply est utile si vous souhaitez modifier le thème une fois le rapport chargé sans recharger le rapport.

La classe Report Client Power BI définit la méthode comme suit :

applyTheme(theme: models.IReportTheme): Promise<void>

L’API applyTheme modifie le thème appliqué au rapport au moment de l’exécution.

...
// Parse the theme JSON file into an object
let themeJsonObject = parseJsonfile(path); 

// Apply the theme
report.applyTheme({ themeJson: themeJsonObject });

Appliquer un thème lorsque vous créez un rapport

Un nouveau rapport incorporé peut être créé avec un thème qui lui est appliqué. Les nouveaux visuels ajoutés au rapport respectent le style de thème. Consultez également le Créer, modifier et enregistrer un rapport incorporé page.

Cet exemple est utile si vous souhaitez appliquer un thème personnalisé à un nouveau rapport.

// Parse the theme JSON file into an object
let themeJsonObject  = parseJsonfile(path);
let embedCreateConfiguration = {
  …
  theme: {
    themeJson: themeJsonObject 
  }
};

let report = powerbi.createReport(embedContainer, embedCreateConfiguration);

Note

parseJsonfile est une fonction qui doit être implémentée sur le code de l’application et qui ne fait pas partie du Kit de développement logiciel (SDK).

Réinitialiser un thème de rapport

La méthode de réinitialisation est utile si vous souhaitez réinitialiser le thème de rapport au thème par défaut, mais que vous n’avez pas le fichier JSON de thème.

La classe Report du client Power BI définit la méthode resetTheme comme suit :

resetTheme(): Promise<void>

L’appel de l’API resetTheme retourne au thème par défaut du rapport.

// Apply the theme
report.resetTheme();

Considérations et limitations

  • L’utilisation de l’API applyTheme décrite ci-dessus remplace entièrement le thème par défaut par le nouveau fichier JSON. L’API n’étend pas la configuration du thème par défaut.
  • Il existe plusieurs fois lors de l’application de thèmes ne modifie pas les visuels du rapport comme prévu. Pour plus d’informations, consultez Situations lorsque les couleurs du thème de rapport ne respectent pas vos rapports.
  • Vous ne pouvez pas utiliser l’API pour appliquer un thème et définir un niveau de contraste en même temps. Si vous configurez les deux propriétés, l’API utilise le niveau de contraste que vous avez spécifié, mais ignore le paramètre de thème.

Contenu connexe