Como criar um parâmetro no Report Builder

Neste tutorial, você aprenderá como criar um parâmetro no Report Builder. Os parâmetros permitem que os usuários finais interajam com um relatório paginado.

Os parâmetros são semelhantes aos filtros, mas são funcionais apenas quando você está na exibição de execução do Construtor de relatórios . A adição desse recurso oferece grande assistência aos usuários finais, pois permite que eles filtrem os dados correspondentes às suas necessidades.

Este tutorial cobrirá uma discussão abrangente sobre tudo relacionado a parâmetros, onde você aprenderá como adicionar e remover parâmetros. O tutorial também mostrará como remover valores em branco ou nulos de seu relatório e lidar com erros no Report Builder.

Índice

• Adicionar um parâmetro no construtor de relatórios
• Removendo espaços em branco de um parâmetro no Report Builder
• Tratamento de erros para parâmetros
• Adicionando dois ou mais parâmetros
• Remover parâmetros no construtor de relatórios
• Lidando com espaços em branco
• Conclusão

Adicionar um parâmetro no construtor de relatórios

Clique com o botão direito do mouse no conjunto de dados que deseja como parâmetro no Construtor de relatórios e clique em Consultar . Isso abre o Designer de Consultas .

Na parte superior do Query Designer, você pode ver um rótulo chamado Parâmetros com duas caixas para cada Dimensão.

Clique na primeira caixa da dimensão Regiões e selecione Clique para executar a consulta .

Ao executá-lo, você verá que precisa selecionar uma cidade ou cidades antes de visualizar o relatório.

Depois de selecionar as cidades que deseja visualizar, clique em Visualizar relatório . Você verá que o relatório mostra apenas dados com base nas cidades selecionadas.

Removendo espaços em branco de um parâmetro no Report Builder

No relatório resultante, você notará que, mesmo com a seleção da cidade, ainda retorna valores em branco. Para remover valores em branco de seu parâmetro, volte para a visualização de design e abra a janela Report Parameter Properties .

Você pode fazer isso clicando com o botão direito do mouse no parâmetro que deseja editar e clicando em Propriedades do parâmetro .

Na guia Geral, desmarque as opções Permitir valor em branco e Permitir valor nulo . Em seguida, clique em OK.

O próximo passo é crucial. Se você não fizer isso, receberá um erro.

Volte para o Query Designer. Se quiser remover valores em branco ou nulos , você precisa definir o Operador como Igual e remover qualquer expressão de filtro.

Feito isso, clique em OK e execute seu relatório. Escolha selecionar tudo para o parâmetro Cidade e clique em Exibir relatório.

Você verá que todos os valores em branco e nulos da tabela foram removidos.

Tratamento de erros para parâmetros

Esta é uma explicação de por que editar o Query Designer ao remover espaços em branco é importante. Vejamos um cenário em que você ignora o retorno ao Designer de Consultas e, em vez disso, executa o relatório depois de desmarcar apenas as opções Permitir valor em branco e Permitir valor nulo .

Se você fizer isso, será confrontado com uma mensagem de erro.

O erro está dizendo que a propriedade AllowBlank do parâmetro City é falsa. No entanto, o valor padrão contém um valor que viola a condição da propriedade AllowBlank. Isso significa que há uma contradição nas propriedades do parâmetro City.

Lembre-se que nas Propriedades do Parâmetro, você já configurou para não permitir valores em branco ou nulos. No entanto, no Designer de Consulta, a expressão atual já define a Cidade para não ser igual a valores em branco. Portanto, há uma redundância na formatação.

Além disso, como você está usando City como parâmetro, não é mais necessário adicionar uma expressão de filtro. As mensagens de erro no Construtor de Relatórios são construídas intuitivamente conforme especificam o que está acontecendo.

Eles permitem que você corrija o erro primeiro antes de continuar com seu trabalho. Portanto, é sempre uma prática recomendada executar seu relatório rotineiramente.

Isso garante que os erros sejam detectados no início. Em vez de revisar tudo quando estiver quase terminando, você pode abordar os erros um de cada vez.

Adicionando dois ou mais parâmetros

Se quiser adicionar outro parâmetro ao seu relatório, abra o Designer de Consultas. Em seguida, arraste o item do grupo de medidas para a guia de dimensão.

Em seguida, marque a caixa para ativar este item como parâmetro e selecione Clique para executar a consulta . Neste caso, além da Cidade, as Datas agora são incluídas como um novo parâmetro.

Depois de clicar em OK, você notará na exibição Design que o Ano foi adicionado ao painel Parâmetros.

Antes de executar o relatório, primeiro você precisa verificar as propriedades do novo parâmetro. Edite quaisquer propriedades, se necessário.

Ao executar o relatório, você precisa definir as duas propriedades.

Depois de selecionar, clique em Exibir relatório . Você verá que o relatório mostra apenas os dados com base nos parâmetros que você selecionou.

Você também pode continuar ajustando os parâmetros enquanto visualiza o relatório.

Remover parâmetros no construtor de relatórios

Para excluir Parâmetros, abra o Query Designer . Clique no parâmetro que deseja remover e, em seguida, clique no botão X .

Em seguida, selecione Clique para executar a consulta e OK. Em seguida, clique no parâmetro que você excluiu no painel Dados do relatório e pressione o botão Excluir no teclado. Clique OK.

O parâmetro foi excluído do relatório. Ao executar a consulta, você estará filtrando apenas por Ano. Se, por exemplo, você selecionar 2015, o relatório mostrará apenas valores com 2015 como ano.

Lidando com espaços em branco

Para remover espaços em branco e valores nulos de seu relatório com eficiência, você pode usar uma expressão booleana.

Clique com o botão direito do mouse em seu conjunto de dados e vá para Propriedades do conjunto de dados . No painel Filtros , clique no botão Adicionar para criar um novo filtro.

Para este exemplo, você precisa criar uma expressão booleana para poder manter as linhas com valores não em branco.

Ao selecionar o campo que deseja filtrar, você precisa usar uma expressão. Então, clique no botão fx ao lado da caixa de texto Expressão. Digite a função comum, IsNothing . Em seguida, adicione no campo que deseja filtrar.

Isso retornará True se um valor de linha estiver em branco e False caso contrário.

Em seguida, em vez de Texto, escolha Boolean . Para o operador, use o sinal de igual ( = ). Na caixa de texto Valor, escreva false .

Portanto, nos bastidores, esse filtro primeiro avalia se um valor está em branco (verdadeiro) ou não (falso). Em seguida, ele filtra os valores que retornam true.

Se você executar seu relatório, verá que ele não contém mais valores em branco ou nulos.

Você pode usar isso em um conjunto de dados e no nível Tablix.

Tutorial do Construtor de Relatórios: Classificar e Filtrar Dados em Relatórios Paginados
Parâmetros do LuckyTemplates por meio do Editor de Consultas

Conclusão

Este tutorial oferece uma discussão abrangente sobre parâmetros no Report Builder . Esse recurso é especialmente benéfico para os usuários finais. Isso permite que eles vejam detalhes específicos em um relatório paginado.

E como você aprendeu, adicionar e remover parâmetros é fácil. O truque é garantir que as propriedades do parâmetro sejam definidas corretamente para que valores em branco ou nulos sejam excluídos.

Mas mesmo se você cometer um erro, você será notificado por meio de uma mensagem de erro. No geral, o Report Builder é um programa fácil e amigável de usar.

Sue Bayes