Activer les filtres persistants

  • Article

Dans les rapports que vous incorporez pour votre organisation, lorsque la fonctionnalité de filtres persistants est activée, les rapports conservent leur état, notamment 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 par défaut 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.

  1. Vérifiez que les filtres persistants sont activés dans les paramètres de rapport dans le service Ou le bureau Power BI.

  2. Vérifiez que votre application Azure Active Directory (Azure AD) dispose d’autorisations UserState.ReadWrite.All.

  3. 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, si l’état existe. L’état du rapport de l’utilisateur est automatiquement enregistré après 60 secondes, sans aucune modification.

Note

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 des filtres persistants

Enregistrez les filtres de rapport, les segments et d’autres modifications de 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 d’un utilisateur 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>

Considérations et limitations

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

Contenu connexe