Activer les filtres persistants

Article
09/17/2023

Dans les rapports que vous incorporez pour votre organisation, lorsque la fonctionnalité de filtres persistants est activée, les rapports conservent leur état, y compris les filtres, les segments et d’autres modifications de vue de données. Lorsque votre utilisateur ouvre un rapport, l’état utilisateur enregistré se charge dans le rapport. En outre, l’utilisateur obtient le même état utilisateur dans les différents scénarios si des filtres persistants sont activés.

Pour réinitialiser les filtres persistants dans un scénario d’incorporation, vous devez implémenter un bouton et utiliser l’API resetPersistentFilters , ou afficher la barre d’action pour obtenir le bouton De réinitialisation de Power BI sur le bouton par défaut dans la barre d’action.

Comment activer des filtres persistants

Les filtres persistants sont désactivés par défaut. Pour activer les filtres persistants, suivez les étapes décrites dans cette section.

Vérifiez que les filtres persistants sont activés dans les paramètres du rapport dans le service Power BI ou le bureau.
Vérifiez que votre application Azure Active Directory (Azure AD) dispose UserState.ReadWrite.All d’autorisations.
Définissez la propriété persistentFiltersEnabled sur true.

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

Le rapport est chargé avec l’état du rapport de l’utilisateur le plus récent, s’il existe. L’état du rapport de l’utilisateur est automatiquement enregistré après 60 secondes, sans aucune modification.

Notes

Seules les mises à jour des filtres existants sont enregistrées. Les nouveaux filtres ajoutés par l’API setFilters ne seront pas enregistrés.

API de filtres persistants

Réinitialiser les filtres persistants

Réinitialisez les filtres, segments et autres vues de données d’un utilisateur à l’état par défaut du rapport.

    resetPersistentFilters(): Promise<void>

Enregistrer les filtres persistants

Enregistrez les filtres de rapport, les segments et d’autres modifications de la vue de données de l’utilisateur.

    savePersistentFilters(): Promise<void>

Filtres persistants appliqués

Retourne les filtres, segments ou autres modifications de vue de données appliquées au rapport, le cas échéant. Si les filtres persistants sont désactivés, cela retourne false.

Vous pouvez utiliser cette API pour déterminer l’état du bouton de réinitialisation.

    arePersistentFiltersApplied(): Promise<boolean>

Limites

Les filtres persistants sont pris en charge uniquement pour la solution d’incorporation pour votre organisation (l’utilisateur possède des données).

Étapes suivantes

Améliorer l’expérience de vos utilisateurs avec les signets

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

Contrôler les filtres de rapport