Habilitar filtros persistentes

  • Artigo

Nos relatórios que você inserir para sua organização, quando o recurso de filtros persistentes estiver habilitado, os relatórios manterão seu estado, incluindo filtros, segmentações e outras alterações de exibição de dados. Quando o usuário abre um relatório, o estado do usuário salvo é carregado no relatório. Além disso, o usuário obtém o mesmo estado de usuário nos diferentes cenários se os filtros persistentes estiverem habilitados.

Para redefinir os filtros persistentes em um cenário de inserção, você precisará implementar um botão e usar a API de resetPersistentFilters ou mostrar a barra de ações para fazer com que o Power BI Redefinir para o botão padrão na barra de ações.

Como habilitar filtros persistentes

Os filtros persistentes são desabilitados por padrão. Para habilitar filtros persistentes, siga as etapas nesta seção.

  1. Verifique se os filtros persistentes estão habilitados nas configurações de relatório no serviço ou na área de trabalho do Power BI.

  2. Verifique se seu aplicativo do Azure AD (Azure Active Directory) tem permissões de UserState.ReadWrite.All.

  3. Defina a propriedade persistentFiltersEnabled como true.

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

O relatório será carregado com o estado de relatório do usuário mais recente, se o estado existir. O estado do relatório do usuário é salvo automaticamente após 60 segundos, sem nenhuma alteração.

Nota

Somente as atualizações para filtros existentes são salvas. Novos filtros adicionados pela API de setFilters não serão salvos.

APIs de filtros persistentes

Redefinir filtros persistentes

Redefina os filtros, as segmentações de dados e outras alterações de exibição de dados do usuário para o estado padrão do relatório.

    resetPersistentFilters(): Promise<void>

Salvar filtros persistentes

Salve os filtros de relatório, as segmentações e outras alterações de exibição de dados do usuário.

    savePersistentFilters(): Promise<void>

Filtros persistentes aplicados

Retorna os filtros, as segmentações de dados ou outras alterações de exibição de dados aplicadas no relatório, se existirem. Se os filtros persistentes estiverem desabilitados, isso retornará false.

Você pode usar essa API para determinar o estado do botão redefinir.

    arePersistentFiltersApplied(): Promise<boolean>

Considerações e limitações

Há suporte apenas para filtros persistentes para a solução inserção para sua organização (o usuário possui dados).

Conteúdo relacionado