Usando parâmetros para controlar a aparência do relatório (Construtor de Relatórios 2.0)
É 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 os dados de um relatório (Construtor de Relatórios 2.0).
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 (Construtor de Relatórios 2.0).
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 (Construtor de Relatórios 2.0).
Para obter mais informações sobre como controlar a visibilidade de linhas e colunas, consulte Tutorial: Adicionando parâmetros para filtrar dados do relatório (Construtor de Relatórios 2.0).
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. Quando o relatório for processado, a expressão do grupo será avaliada como o campo selecionado.
Consulte também