Compartilhar via


Usando parâmetros para controlar a aparência do relatório

É possível alterar a aparência de um relatório e os itens em um relatório alterando os valores de suas propriedades. Como muitas propriedades em um relatório são baseadas em expressões, e como as expressões podem incluir referências a parâmetros, você tem grande flexibilidade para fornecer parâmetros que permitem que o usuário varie a aparência do relatório. Por exemplo, as propriedades baseadas em expressões para uma caixa de texto incluem cor da fonte, estilo, decoração, cor de plano de fundo, cor da borda, preenchimento e visibilidade. Conforme cada propriedade de item de relatório baseada em expressão é processada, o processador de relatório substitui primeiro todos os valores de parâmetros na expressão e avalia a expressão.

Outro motivo para criar parâmetros para propriedades baseadas em expressões é fornecer um relatório personalizado para usuários diferentes. É possível gravar uma definição de relatório e usar parâmetros para criar uma série de relatórios vinculados para alterar a aparência do relatório para audiências diferentes. Também é possível criar um relatório de busca detalhada com um parâmetro que controla se o relatório é aberto com nós expandidos ou recolhidos. Os usuários podem escolher a maneira preferida de exibir o relatório.

Outros motivos pelos quais você pode desejar criar parâmetros de relatório que controlam a aparência do relatório incluem:

  • Configurar os limites para valores de codificação de cores em uma região de dados. Por exemplo, exibir valores de moeda abaixo de um determinado limite ajustável em texto em vermelho.

  • Permitir que o usuário personalize imagens usadas em uma tabela.

  • Permitir que o usuário controle a ordem de classificação em uma região de dados. Para obter mais informações, consulte Classificando dados em um relatório.

  • Controlar condicionalmente a visibilidade de itens do relatório. Por exemplo, você pode desejar implementar seu próprio resumo e exibições de detalhes para um relatório, ocultando inicialmente alguns itens do relatório, fornecendo um parâmetro para que o usuário possa optar por mostrar todos os itens no relatório.

Use a caixa de diálogo Propriedades de Parâmetros do Relatório para criar parâmetros do relatório. Forneça uma lista de valores válidos e um prompt do usuário. As alterações feitas nos parâmetros não são refletidas no relatório até que ele seja executado. Crie valores padrão, se desejar que o relatório seja executado automaticamente.

Controlando a visibilidade

Você pode mostrar e ocultar itens em um relatório usando uma expressão que inclua um parâmetro nas propriedades de visibilidade Hidden, InitialToggleState e ToggleItem para o item de relatório. Defina essas propriedades de itens de relatório na página Visibilidade da caixa de diálogo Propriedades apropriada ou na propriedade Hidden no painel Propriedades para o item de relatório selecionado na superfície de design.

Por exemplo, você pode definir a visibilidade das caixas de texto, dos cabeçalhos de colunas, linhas da tabela ou cabeçalhos do grupo com base em um parâmetro booleano denominado Show usando a expressão a seguir:

=Not Parameters!Show.Value

Quando o parâmetro Show é true, a expressão na propriedade Hidden é avaliada como false em tempo de execução e portanto o item de relatório é visível. Para obter mais informações, consulte Ocultando itens de relatório condicionalmente.

Para obter regras sobre como preservar o espaço em branco quando um item de relatório está inicialmente oculto, consulte Renderizando itens de relatório.

Para obter mais informações sobre como controlar a visibilidade de linhas e colunas, consulte Tutorial: Adicionando parâmetros a um relatório.

Controlando a formatação

As caixas de texto possuem propriedades de fonte e estilo que se aplicam ao texto todo dentro de uma única caixa de texto. É possível definir muitas dessas propriedades usando expressões. Por exemplo, é possível criar um relatório de vendas mostrando lucros nas vendas e definir um parâmetro que permita que os usuários especifiquem um valor limite. Os valores acima do limite são exibidos usando uma fonte em vermelho e os valores abaixo do limite são exibidos usando uma fonte em preto.

Para tornar a cor da fonte condicional, use uma expressão para a propriedade Color da caixa de texto que mostre o lucro das vendas que se refere ao parâmetro de limite, em vez de um valor estático. Para este exemplo, crie um campo calculado chamado Lucro que contenha a soma do campo Vendas e adicione um parâmetro de relatório chamado Limite que contenha o campo Lucro. No painel Propriedades da caixa de texto, digite a seguinte expressão na propriedade Cor:

=IIF(Fields!Profit.Value < Parameters!Threshold.Value, "Red", "Black")

Controlando imagens

É possível fornecer um parâmetro para permitir que o usuário escolha uma imagem em um relatório. Por exemplo, você pode criar um parâmetro denominado ImageName e fornecer um conjunto de dados de valores disponíveis que forneça os nomes de imagens válidas. Adicione uma imagem à superfície de design e defina as propriedades da imagem, conforme necessário, para especificar onde localizar as origens da imagem. Em seguida, defina a propriedade Value do item de relatório da imagem como a seguinte expressão:

=Parameters!ImageName.Value

Quando o usuário seleciona um valor para o parâmetro @ImageName e executa o relatório, a imagem apropriada é exibida para o item de relatório da imagem.

Controlando grupos usando parâmetros

É possível criar um parâmetro de modo que um usuário possa controlar a maneira como os dados são agrupados para uma região de dados. Por exemplo, para permitir que o usuário controle o campo usado para agrupar dados em uma tabela, crie um parâmetro denominado GroupValue. Você deve fornecer um conjunto de nomes de campos válidos para agrupamento dos valores disponíveis para o parâmetro. Crie um grupo de linhas para a tabela e defina a expressão do grupo como a seguinte expressão: =Fields(Parameters!GroupValue.Value).Value. =Fields(Parameters!GroupValue.Value).Value. Quando o relatório for processado, a expressão do grupo será avaliada como o campo selecionado.