Criar parâmetros para relatórios paginados no Construtor de Relatórios do Power BI
APLICA-SE A: Power BI Report Builder Power BI Desktop
Neste artigo, você aprenderá a criar parâmetros no Construtor de Relatórios do Power BI para relatórios paginados exibidos no serviço do Power BI. Um parâmetro de relatório fornece uma maneira para os leitores de relatório escolherem os dados do relatório e variarem a apresentação do relatório. Você pode fornecer um valor padrão e uma lista de valores disponíveis. Os leitores de relatório podem alterar a seleção. Eles também podem digitar as caixas de texto de parâmetro para pesquisar valores. Confira Exibir parâmetros para relatórios paginados para ver como os usuários de negócios interagem com os parâmetros no serviço do Power BI.
A ilustração a seguir mostra o modo de exibição de Design no Construtor de Relatórios do Power BI para um relatório com os parâmetros @BuyingGroup, @Customer, @FromDate e @ToDate.
Os parâmetros de relatório no painel Dados do Relatório.
A tabela com um dos parâmetros no conjunto de dados.
O painel Parâmetros. Você pode personalizar o layout dos parâmetros no painel de parâmetros.
Os parâmetros @FromDate e @ToDate têm o tipo de dados DateTime. Ao exibir o relatório, você pode digitar uma data na caixa de texto ou escolher uma data no controle de calendário, ou selecione Ir para hoje.
Um dos parâmetros na caixa de diálogo Propriedades do Conjunto de Dados.
Pré-requisitos
Os requisitos de licença para relatórios paginados do Power BI (arquivos.rdl) são os mesmos para relatórios do Power BI (arquivos .pbix).
- Não é preciso ter uma licença para baixar o Power BI Report Builder gratuitamente no Centro de Download da Microsoft.
- Com uma licença gratuita, você pode publicar relatórios paginados em Meu Workspace no serviço do Power BI. Para obter mais informações, confira Disponibilidade de recursos para usuários com licenças gratuitas no serviço do Power BI.
- Com uma licença de Power BI Pro ou uma licença PPU, você pode publicar relatórios paginados em outros workspaces. Você precisa, no mínimo, de uma função de colaborador no workspace.
- Você precisa ter a permissão Criar no conjunto de dados.
Criar ou editar um parâmetro de relatório
Abra seu relatório paginado no Construtor de Relatórios do Power BI.
No painel Dados do Relatório, clique com o botão direito do mouse sobre o nó Parâmetros>Adicionar Parâmetro. A caixa de diálogo Propriedades do Parâmetro do Relatório é aberta.
Em Nome, digite um nome para o parâmetro ou aceite o nome padrão.
Em Prompt, digite o texto a ser exibido ao lado da caixa de texto do parâmetro quando o usuário executar o relatório.
Na lista Tipo de dados, selecione o tipo de dados do valor do parâmetro.
Se o parâmetro pode conter um valor em branco, selecione Permitir valor em branco.
Se o parâmetro pode conter um valor nulo, selecione Permitir valor nulo.
Para permitir que um usuário selecione mais de um valor do parâmetro, selecione Permitir diversos valores.
Defina a opção de visibilidade.
Para mostrar o parâmetro na barra de ferramentas na parte superior do relatório, selecione Visível.
Para ocultar o parâmetro para que ele não seja exibido na barra de ferramentas, selecione Oculto.
Para ocultar o parâmetro e impedi-lo de ser modificado no servidor de relatórios depois que o relatório é publicado, selecione Interno. O parâmetro de relatório só pode ser exibido na definição do relatório. Para essa opção, você deve definir um valor padrão ou permitir que o parâmetro aceite um valor nulo.
Selecione OK.
Conteúdo relacionado
Veja Exibir parâmetros para relatórios paginados para conferir como os parâmetros são exibidos no serviço do Power BI.
Para obter informações detalhadas sobre os parâmetros em relatórios paginados, confira Parâmetros de relatório no Construtor de Relatórios do Power BI.