Utiliser la barre d’actions pour améliorer l’expérience utilisateur

Lorsque vous incorporez un rapport pour votre organisation, vous devez demander aux utilisateurs de votre application de se connecter à Power BI pour afficher le contenu incorporé. Une fois que les utilisateurs se connectent, ils ont accès aux rapports qu’ils possèdent ou que vous ou d’autres membres de l’organisation partagez avec eux.

Les consommateurs de rapports que vous incorporez pour votre organisation peuvent tirer parti des fonctionnalités en libre-service telles que les barres d’action, les signets personnels et les filtres persistants via les API clientes .

Barre d’actions

Lorsque vous incorporez un rapport Power BI pour votre organisation, les consommateurs de rapports peuvent utiliser le rapport barre d’actions pour exporter, partager, modifier des vues ou effectuer plusieurs autres actions.

Vous pouvez activer la fonctionnalité complète de la barre d’actions pour permettre aux utilisateurs :

• Favoris du rapport
• Utiliser des filtres persistants
• Utiliser des signets personnels

Pour afficher la barre d’actions à vos consommateurs de rapports, ajoutez le paramètre bars à votre configuration incorporée et définissez la visibilité actionBar sur true.

let embedConfig = {
   ...
   settings: {
      bars: {
         actionBar: {
            visible: true
         }
      }
   }
};

L’affichage de la barre d’action affiche une liste verticale de pages de rapport, la même expérience que dans le service Power BI. Les utilisateurs peuvent réduire le volet de navigation de page pour donner plus de place au rapport.

Filtres persistants

filtres persistants conserver les filtres, segments et autres états de rapport des consommateurs de rapports sur les sessions. Les consommateurs de rapports peuvent rapidement accéder à leurs insights sans répéter les mêmes étapes de filtrage chaque fois qu’ils reviennent au rapport. Les utilisateurs peuvent partager le même état de rapport persistant sur le service Power BI, les scénarios mobiles et incorporés.

Pour activer les filtres persistants dans les rapports incorporés pour votre organisation :

1. Activez les filtres persistants dans les paramètres de rapport de bureau ou de service Power BI.

2. Vérifiez que votre application autorise UserState.ReadWrite.All autorisations dans Azure AD.

3. Définissez la propriété dans les paramètres de loadConfiguration incorporés sur :

      let config = {
         type: 'report',
         ...
         settings: {
            persistentFiltersEnabled: true
         }
      };
   

Le rapport se charge avec l’état de rapport le plus récent de l’utilisateur, s’il en existe un. Dans le rapport incorporé, les consommateurs peuvent utiliser le bouton Réinitialiser par défaut dans la barre d’action pour appliquer leurs filtres persistants.

Pour plus d’informations sur les filtres persistants et les API pertinentes, consultez filtres persistants.

Signets personnels

Dans les rapports que vous incorporez pour votre organisation, les consommateurs de rapports peuvent créer signets personnels en capturant les états de page de rapport, y compris les filtres, les segments et les états visuels, et en leur donnant des noms conviviaux. Les utilisateurs peuvent ensuite revenir rapidement à ces états en sélectionnant les signets. Les signets personnels sont disponibles uniquement pour leurs créateurs et ne nécessitent pas d’autorisations d’écriture pour le rapport.

Les consommateurs de rapports peuvent utiliser les mêmes signets personnels dans les rapports incorporés et dans le service Power BI. Les utilisateurs peuvent créer n’importe quel signet personnel leur affichage par défaut, de sorte qu’ils voient leur affichage favori du rapport chaque fois qu’ils l’ouvrent.

Pour activer les signets personnels dans les rapports incorporés pour votre organisation :

1. Vérifiez que votre application autorise UserState.ReadWrite.All autorisations dans Azure AD.

2. Définissez la propriété dans les paramètres de loadConfiguration incorporés sur :

      let config = {
         type: 'report',
         ...
         settings: {
            personalBookmarksEnabled: true
         }
      };
   

3. Rendre le volet signet visible dans le rapport.

Vous pouvez rendre le volet signet visible dans le rapport de deux manières. La première option consiste à afficher la barre d’action rapport, qui a un bouton Signets pour permettre aux utilisateurs d’ouvrir et de fermer le volet signets.

La deuxième option consiste à afficher et masquer le volet signets par programmation à l’aide des volets objet dans les paramètres du rapport.

let embedConfig = {
   ...
   settings: {
      panes: {
         bookmarks: {
            visible: true
         }
      }
   }
};

Vous pouvez mettre à jour les paramètres de rapport au moment de l’exécution à l’aide de la méthode updateSettings, consultez Mettre à jour les paramètres de rapport au moment de l’exécution.

Pour plus d’informations sur les signets personnels, consultez signets personnels.

Considérations et limitations

• Dans l’analytique incorporée Power BI, les filtres persistants et les fonctionnalités de signets personnels sont désactivés par défaut. Ces fonctionnalités sont prises en charge uniquement lorsque vous incorporez des rapports pour votre organisation, et non lorsque vous incorporez pour vos clients.

• Lorsque vous affichez la barre d’actions, vous ne pouvez plus contrôler par programme si la navigation de page apparaît sous la forme d’un volet situé à gauche ou sous forme d’onglets en bas. La modification de l’emplacement de la liste des pages de rapport n’est disponible que par le biais des paramètres de rapport du service Power BI, et non par le biais de l’objet panes.

• Les actions de signets personnels ne sont pas prises en charge par l’API. Pour plus d’informations sur les signets de rapport, consultez signets de rapport.

Contenu connexe

• Améliorer l’expérience de vos utilisateurs avec les signets
• Activer les filtres persistants