Gerenciando relatórios usando o Criador de relatórios › Objetos de dados › Variáveis de tempo de execução

Variáveis de tempo de execução

Os objetos de dados podem usar variáveis de tempo de execução para alterar o comportamento e os critérios de seleção dinamicamente.

Para os objetos de dados de consulta, é possível usar variáveis de tempo de execução na consulta SQL. Como pré-requisito, defina essas variáveis de tempo de execução na lista Variáveis. Essa lista inclui variáveis de consulta padrão e você pode adicionar suas próprias variáveis.

Por exemplo, considere um relatório baseado em uma consulta SQL que exibe uma lista de usuários. O objeto de dados pode assumir um valor Last_Name como uma variável de tempo de execução para indicar os caracteres iniciais do sobrenome. O valor Last_Name é solicitado dos usuários do objeto de dados. Você pode usar a variável de tempo de execução do tipo Sequência de caracteres denominada %Last_Name% na instrução SQL. Use essa variável para restringir os resultados a registros de usuários que iniciam com o valor digitado pelo usuário. A seguinte instrução SQL fornece uma consulta de exemplo:

SELECT first_name,middle_name,last_name FROM ca_contact WHERE (ca_contact.last_name like '%Last_Name%%')

Observação: apenas as variáveis de tempo de execução na consulta SQL são solicitadas do usuário.

Para o objetos de dados de plugin, é possível passar variáveis de tempo de execução para a classe do Java como pares nome-e-valor. Como pré-requisito, verifique se a classe de plugin de relatório Java leva os pares nome-e-valor para o objeto de dados do plugin.

Por exemplo, considere a classe de plugin com.ca.usm.reporting.Plugins.RequestFulfillmentReport. Essa classe de plugin utiliza um parâmetro do tipo Data denominado START_DATE. Portanto, START_DATE é exigido no objeto de dados que usa essa classe de plugin. Nesse caso, proceda de uma das seguintes maneiras:

• Codifique START_DATE como uma constante
• Solicitar do usuário o valor de data START_DATE e passe esse valor para o plugin

Você pode usar variáveis do sistema contextuais com as variáveis de tempo de execução, para as seguintes finalidades:

• Como valores padrão ao solicitar o usuário
• Como valores de constantes a serem passados para o plugin
• Como valores a serem usados em uma consulta

As variáveis do sistema contextual são as seguintes:

Adicionar uma variável de tempo de execução de consulta

É possível adicionar uma variável de tempo de execução personalizada para ser usada como um objeto de dados de consulta. Um exemplo é adicionar uma variável de tempo de execução de consulta que é uma variável suspensa.

Para adicionar uma variável de tempo de execução de consulta

1. Clique em Administração, Criador de relatórios.

   A página Criador de relatórios é exibida com Objetos de dados selecionado no menu à esquerda sob o menu principal.

2. Proceda de uma das seguintes maneiras:
   • Adicione um novo objeto de dados
   • Edite um objeto de dados existente

   A página muda para corresponder à ação de criação ou edição de um objeto de dados.

3. Clique em Criar variável.

   A caixa de diálogo Criar variável de tempo de execução ou Editar variável de tempo de execução é exibida.

4. Especifique o nome, o tipo e outros dados nos campos fornecidos. Use as seguintes diretrizes:
   • Para especificar dados avançados, clique em Avançado.
   • Para exibir o texto de ajuda, clique no ícone de Ajuda (ponto de interrogação). Esse ícone aparece no final da barra de título da caixa de diálogo.
5. Clique em Criar variável.

   O sistema do Catalog salva a definição da variável.

Você pode usar a variável em uma consulta SQL para um objeto de dados de consulta. É solicitado que os usuários digitem um valor ao executar o objeto de dados.

Observação: ao adicionar uma variável de tempo de execução de consulta que é uma variável suspensa, o número de valores na lista suspensa resultante é limitado a 1000. Se a consulta do relatório retornar mais de 1000 valores, o sistema truncará esses valores adicionais. Consequentemente, o usuário não poderá exibi-los na lista suspensa. Se necessário, você pode aumentar o número de valores que são exibidos na lista suspensa para ser maior que 1000. Para obter detalhes, consulte o Guia de Implementação.