Usar a barra de ações para aprimorar a experiência do usuário

Ao inserir um relatório para sua organização, você exige que os usuários do aplicativo entrem no Power BI para exibir o conteúdo inserido. Depois que os usuários entrarem, eles terão acesso aos relatórios que possuem ou que você ou outros membros da organização compartilham com eles.

Os consumidores de relatórios inseridos para sua organização podem aproveitar os recursos de autoatendimento, como barras de ações, indicadores pessoais e filtros persistentes por meio das APIs do cliente.

Barra de ação

Quando você inseri um relatório do Power BI para sua organização, os consumidores de relatório podem usar a barra de ações de relatório para exportar , compartilhar, alterar exibições ou executar várias outras ações.

Você pode habilitar a funcionalidade completa da barra de ações para permitir que os usuários:

• Adicionar o relatório a Favoritos
• Usar filtros persistentes
• Usar indicadores pessoais

Importante

Para fornecer a funcionalidade completa da barra de ações, você deve conceder aos usuários a permissão UserState.ReadWrite.All para seu aplicativo no Azure Active Directory (Azure AD).

Para mostrar a barra de ações aos consumidores de relatório, adicione a bars configuração à configuração de inserção e defina a actionBar visibilidade como true.

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

Mostrar a barra de ações exibe uma lista vertical de páginas de relatório, a mesma experiência que em serviço do Power BI. Os usuários podem recolher o painel de navegação da página para dar mais espaço ao relatório.

Filtros persistentes

Os filtros persistentes retêm os filtros, as segmentações de dados e outros estados de relatório dos consumidores de relatório durante as sessões. Os consumidores de relatório podem acessar rapidamente seus insights sem repetir as mesmas etapas de filtragem sempre que retornarem ao relatório. Os usuários podem compartilhar o mesmo estado de relatório persistente em cenários de serviço do Power BI, móveis e inserção.

Para habilitar filtros persistentes em relatórios inseridos para sua organização:

1. Habilite filtros persistentes nas configurações de relatório da serviço do Power BI ou da área de trabalho.

2. Verifique se seu aplicativo permite UserState.ReadWrite.All permissões em Azure AD.

3. Defina a persistentFiltersEnabled propriedade nas configurações de loadConfiguration inseridas como true:

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

O relatório é carregado com o estado de relatório mais recente do usuário, se houver um. No relatório inserido, os consumidores podem usar o botão Redefinir para padrão na barra de ações para aplicar seus filtros persistentes.

Para obter mais informações sobre filtros persistentes e as APIs relevantes, consulte filtros persistentes.

Indicadores pessoais

Nos relatórios que você inserir para sua organização, os consumidores de relatório podem criar indicadores pessoais capturando estados de página de relatório, incluindo filtros, segmentações e estados visuais e dando-lhes nomes amigáveis. Os usuários podem retornar rapidamente a esses estados selecionando os indicadores. Indicadores pessoais estão disponíveis apenas para seus criadores e criá-los não requer permissões de gravação para o relatório.

Os consumidores de relatório podem usar os mesmos indicadores pessoais em relatórios inseridos e no serviço do Power BI. Os usuários podem tornar qualquer indicador pessoal seu modo de exibição padrão, para que vejam a exibição favorita do relatório sempre que o abrirem.

Para habilitar indicadores pessoais em relatórios inseridos para sua organização:

1. Verifique se seu aplicativo permite UserState.ReadWrite.All permissões em Azure AD.

2. Defina a personalBookmarksEnabled propriedade nas configurações de loadConfiguration inseridas como true:

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

3. Torne o painel de indicador visível no relatório.

Você pode tornar o painel de indicador visível no relatório de duas maneiras. A primeira opção é mostrar a barra de ação de relatório, que tem um botão Indicadores para que os usuários abram e fechem o painel de indicadores.

A segunda opção é mostrar e ocultar o painel de indicadores programaticamente usando o objeto de painéis nas configurações do relatório.

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

Você pode atualizar as configurações de relatório em runtime usando o updateSettings método, consulte as configurações de relatório de atualização no runtime.

Para obter mais informações sobre indicadores pessoais, consulte indicadores pessoais.

Limitações

• Na análise integrada do Power BI, os filtros persistentes e os recursos de indicadores pessoais são desabilitados por padrão. Esses recursos só têm suporte quando você inseri relatórios para sua organização, não quando você inseri para seus clientes.

• Ao mostrar a barra de ações, você não pode mais controlar programaticamente se a navegação de página aparece como um painel à esquerda ou como guias na parte inferior. A alteração do local da lista de páginas de relatório só está disponível por meio das configurações do relatório serviço do Power BI, não por meio do panes objeto.

• Ações de indicadores pessoais não são suportadas pela API. Para obter informações sobre indicadores de relatório, consulte indicadores de relatório.

Próximas etapas

Aprimorar a experiência dos usuários com indicadores

Habilitar filtros persistentes