Guía de implementación › Implementación › Creación de entregas (gestor de contratos) › Cómo crear informes › Informes de formato libre

Informes de formato libre

Los informes de formato libre permiten a los usuarios generar informes basados en consultas SQL de la base de datos de CA Business Service Insight o de cualquier otro origen de datos externo al cual se pueda acceder mediante una conexión de servidor de CA Business Service Insight. Esto también incluye otros tipos de orígenes de datos a los cuales se puede acceder mediante ODBC, como Excel, Access, Lotus Notes, archivos de texto, etc. Los informes de formato libre se utilizan habitualmente para configurar informes estadísticos basados en datos creados por los comandos de lógica de negocios Tools.SaveRecord y Tools.SaveFields.

Los informes de formato libre se conectan mediante una cadena de conexión a la base de datos seleccionada y ejecutan una consulta SQL en la base de datos mediante una cadena de consulta. Los parámetros pueden agregarse a las dos cadenas para crear informes dinámicos que permitan que el usuario especifique o seleccione valores determinados para incluirlos en la consulta, como el nombre de usuario y la contraseña para conectarse a la base de datos.

Los informes de formato libre se muestran en las fichas Gráfico, Datos y Filtrar de forma similar a los informes generados mediante el asistente de informes.

Nota: Los informes de formato libre pueden incluir gráficos solamente si todas las columnas, aparte de la primera columna, son numéricas. Los datos de la primera columna se utilizan para los títulos del eje X. Los nombres de la columna se utilizan para otros títulos.

Dado que los informes de formato libre acceden directamente a una base de datos y a una consulta SQL abierta, el mantenimiento resulta problemático. Se deberá tener mucho cuidado de no afectar a los datos subyacentes que sirven como origen para los informes de formato libre. Cuando se generan informes de un origen de datos externo, se recomienda configurar un proceso de notificación para garantizar que esos orígenes de datos no cambien sin primero consultar con el gestor de contratos responsable de los informes de datos de formato libre.

Información general que tener en cuenta al crear informes de formato libre.

• Por problemas de formato de fechas internacionales, es a menudo útil especificar el formato exacto de la fecha creando una fórmula personalizada en la lógica de negocios. Esto convierte la fecha a una cadena con el mismo formato siempre y evita incidencias de formato de fecha US frente a formato de fecha UE. Esta conversión se deberá utilizar para fechas que se escriban a partir de la tabla T_SLALOM_OUTPUTS a través de los comandos Tools.SaveFields o Tools.SaveRecord. A continuación se incluye una fórmula de muestra:

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

• Cuando se utiliza el parámetro de tiempo de los controladores de eventos de la lógica de negocios, o cualquier marca de tiempo del objeto eventDetails, es necesario tener siempre presente el efecto del cambio correspondiente a la zona horaria. Tenga en cuenta que, al escribir las fechas en la tabla puede hacerse en hora UTC en lugar de en la hora local. Puede que haya que usar la función Tools.GetLocaleTime() para corregir esta situación.
• Se puede utilizar también la utilidad Diseñador de informes (cuando un informe de formato libre produce una gráfica) para personalizar el aspecto.
• Las opciones de exportación a PDF para los informes de formato libre son personalizables a través de la sección de parámetros del informe de la pantalla de configuración de los informes de formato libre, como el diseño de página (horizontal, vertical, etc.).
• Se puede insertar HTML en los informes para ejecutar diferentes funcionalidades, como agregar hipervínculos o cambiar el color de las columnas o las filas, los tipos de letra o la configuración de visualización.
• Se pueden crear vistas de base de datos (funcionalidad de Oracle) en la tabla T_SLALOM_OUTPUTS para simplificar el SQL necesario para los informes.
• Al especificar parámetros para los informes, se pueden establecer de distintas formas, como texto libre, numérico (validar), contraseña (caracteres ocultos, útil para contraseñas para conexiones a bases de datos), fecha (mediante la utilidad de selección de fecha proporcionada) y listas (creadas especificando una declaración SQL para rellenar la lista).
• Los valores de parámetro especificados en la sección de SQL del informe de formato libre necesitan sustituirse con el nombre del parámetro, precedidos del símbolo "@". Por ejemplo, @PARAM1. Si los valores son cadenas, es posible que sea necesario usar comillas alrededor de este valor de parámetro.