Guia de Implementação › Implementação › Criar produtos a serem entregues (Gerente de contratos) › Como criar relatórios › Relatórios de formato livre

Relatórios de formato livre

Os relatórios de formato livre permitem que os usuários gerem relatórios com base em consultas SQL do banco de dados do CA Business Service Insight ou de qualquer outra fonte de dados externa, que pode ser acessada por meio de uma conexão do servidor do CA Business Service Insight. Isso também inclui quaisquer outros tipos de fonte de dados que podem ser acessados por meio de ODBC, como Excel, Access, Lotus Notes, arquivos de texto, etc. Os relatórios de formato livre geralmente são usados para configurar relatórios de estatísticas com base em dados criados pelos comandos Tools.SaveRecord e Tools.SaveFields da lógica de negócios.

Os relatórios de formato livre se conectam por meio de um texto de conexão a um banco de dados selecionado e executam uma consulta SQL no banco de dados usando um texto de consulta. É possível adicionar parâmetros a ambos os textos para criar relatórios dinâmicos que permitem ao usuário digitar ou selecionar valores específicos para inclusão na consulta, como o nome de usuário e a senha para se conectar ao banco de dados.

Os relatórios de formato livre são exibidos nas guias Gráfico, Dados e Filtro, da mesma forma que os relatórios gerados usando o assistente de relatório.

Observação: relatórios de formato livre podem incluir gráficos somente se todas as colunas, exceto a primeira coluna, forem numéricas. Os dados na primeira coluna são usados para os títulos do eixo X. Os nomes da coluna são usados para outros títulos.

Devido ao fato de que os relatórios de formato livre usam o acesso direto a um banco de dados e uma consulta SQL aberta, a manutenção é problemática. É preciso tomar muito cuidado para não afetar os dados subjacentes que servem como origem para os relatórios de formato livre. Quando relatórios são gerados a partir de uma fonte de dados externa, recomenda-se que um processo de notificação seja configurado para garantir que essas fontes de dados não serão alteradas sem antes consultar o Gerente de contratos responsável pelos relatórios de dados de formato livre.

Informações gerais que devem ser lembradas ao criar relatórios de formato livre.

• Devido a problemas de formatação internacional de datas, muitas vezes é útil especificar o formato exato para a data, criando uma fórmula personalizada na lógica de negócios. Isso converte a data em um texto com o mesmo formato todas as vezes e evita problemas de formatação de datas dos EUA versus da Europa. Deve ser usada para as datas que são gravadas na tabela T_SLALOM_OUTPUTS por meio do comando Tools.SaveFields ou Tools.SaveRecord. A fórmula de exemplo é fornecida a seguir:

Function FormatDate(DateField)

    If DateField = "" Then
      FormatDate = ""
    Else
      Dim PeriodYear, PeriodMonth, PeriodDay, PeriodHour,
  PeriodMinute, Periodsecond
      PeriodYear    = DatePart("yyyy",DateField)
      PeriodMonth   = DatePart("m",DateField)
      PeriodDay     = DatePart("d",DateField)
      PeriodHour    = DatePart("h",DateField)
      PeriodMinute  = DatePart("n",DateField)
      Periodsecond  = DatePart("s",DateField)
      FormatDate  = PeriodDay&"/"&PeriodMonth&"/"&PeriodYear& _
 " "&PeriodHour&":"&PeriodMinute&":"&Periodsecond
    End If
End Function

• Ao usar o parâmetro de tempo dos manipuladores de eventos da lógica de negócios ou datas e horas do objeto eventDetails, sempre esteja ciente do impacto da mudança de fuso horário. Esteja ciente de que as datas, quando gravadas na tabela, podem estar em UTC, e não na hora local. Talvez você precise usar a função Tools.GetLocaleTime() para corrigir esse problema.
• Você ainda poderá usar o utilitário Criador de relatórios (quando um relatório de formato livre gerar um gráfico) para personalizar a aparência.
• As opções de exportação de PDF para o relatório de formato livre são personalizáveis usando a seção de parâmetros de relatório da tela de instalação de formato livre. Coisas como o layout da página (paisagem e retrato).
• HTML pode ser incorporado nos relatórios para executar diferentes funcionalidades, como adicionar hiperlinks ou alterar as fontes e as cores de linhas e colunas, ou exibir as configurações.
• Exibições de banco de dados (funcionalidade do Oracle) podem ser criadas na tabela T_SLALOM_OUTPUTS para simplificar o SQL necessário para os relatórios.
• Ao especificar parâmetros para os relatórios, é possível que eles sejam definidos de várias maneiras, como: texto livre, numérico (validar), senha (caracteres ocultos - útil para senhas de conexões a banco de dados), data (usando o utilitário seletor de data fornecido) e listas (criadas ao especificar uma instrução SQL para preencher a lista).
• Os valores dos parâmetros especificados na seção SQL do relatório de formato livre devem ser substituídos pelo nome do parâmetro, precedido pelo símbolo "@". por exemplo, @PARAM1. O uso de aspas nesse valor do parâmetro pode ser necessário se os valores forem textos.