Informes

Un informe es una consulta guardada sobre una sección: qué columnas salen, con qué condiciones, en qué orden y cómo se agrupan. Lo abre una persona desde el menú, lo muestra un panel, lo ejecuta una integración o lo consume el SDK. En la Flex API es el tipo FlexObjectTypes.Reports; sus columnas, FlexObjectTypes.ReportColumns.

Antes de empezarCopiar el enlace a este apartado

• Un informe pertenece a una sección principal activa y no cambia de sección.
• La pantalla: FlexHub → Informes. Desde el SDK, Flex_CreateObjectAsync(FlexObjectTypes.Reports, sectionId, patch).
• FlexHub no elimina informes, solo sus columnas.

Las familiasCopiar el enlace a este apartado

La columna destino guarda el enum TipoInformeE. Todo informe hecho a mano es Ordinario (12); los demás los crea el motor y no se editan.

El servidor envía el tipo resuelto en IsOrdinaryReport y su etiqueta en KindLabel. La categoría Funcionalidad con subcategoría API convierte un informe en informe API.

IdentidadCopiar el enlace a este apartado

DiseñoCopiar el enlace a este apartado

En FlexHub, pestaña Presentación.

Orden y agrupaciónCopiar el enlace a este apartado

• Orden: hasta nueve niveles, colorden1 a colorden9, con su sentido en colorden1desc a colorden9desc. Cada nivel desempata el anterior. Sin niveles, el orden no está garantizado.
• Agrupación: hasta nueve niveles, campoagrupacion1 a campoagrupacion9, con su modo en campoagrupacionmodo1 a campoagrupacionmodo9.

En FlexHub son las cards Cómo se ordena y Cómo se agrupa. El modo de agrupación (Qué se considera lo mismo) es el enum AgrupacionesCriteriosE:

La lista no se filtra por el tipo de la columna: elige un modo que encaje con el dato.

FiltradoCopiar el enlace a este apartado

En FlexHub, pestaña Filtro.

Las comprobaciones son el enum TipoFiltradoE; cuáles admite cada tipo de dato lo publica el servidor.

• Una condición con lista admite hasta 20 valores: la fila sale si coincide con cualquiera.
• El valor puede ser una constante o calcularse al abrir el informe (el usuario que lo abre, la respuesta a una pregunta). FlexHub muestra los calculados con Se calcula al abrir el informe., pero no los edita ni crea.
• Una condición que el servidor no puede descomponer se conserva y sale marcada Solo lectura.
• Con una fecha, FlexHub ofrece además las funciones relativas del motor (EventStartedLessThanXDaysAgo_Date y sus hermanas en minutos, horas, días, meses y años), IsYear, IsQuarter e InDynamicRange_*, que compara con un periodo de Intervalos. El valor que pide cada condición sale del parámetro de su función: un número en «en los últimos», un periodo en «está en el periodo». Al ejecutar el informe, una relativa con un número escrito se convierte en una comparación entre fechas, que puede usar el índice de la columna.

ColumnasCopiar el enlace a este apartado

Una columna es un dato que el informe saca por pantalla. Al crear el informe, el servidor pone la de identidad (id). Un informe no repite dato en dos columnas. Su contrato es Flex_GetEditablesAsync(FlexObjectTypes.ReportColumns):

ModoRepresentacionGrupalE: No agrupar (0), Sumar (1), Contar (2), Valor máximo (3), Valor mínimo (4), Media (5), Primero (6), Último (14), Contar distintos (7), Media distintos (8), Sumar distintos (9). Solo con constantes: Contar vacíos (10), Contar sí (11), Contar no (12) y Contar Rellenado (13).

Quitar una columna no borra datos y se puede restaurar. Si el informe ordenaba o agrupaba por ella, esas referencias se limpian.

Añadir columnasCopiar el enlace a este apartado

En FlexHub, Añadir columnas en la pestaña Columnas. Los pasos: Columnas.

• Agregar todos pone una columna por cada campo que el informe no muestra, salvo los Botón y los que rellena el motor (ubicacion, posicion, fecha, fecham, fechasyn, usuarioid, modificado).
• El título propuesto es la etiqueta del campo; con un campo de una relación, la etiqueta de la relación («Cliente», no «Nombre»).
• Una columna cuyo dato es la relación entera tiene que terminar en «ID» («Cliente ID»). Si no, FlexHub avisa Falta «ID» en el título.

Por la Flex API, Flex_CreateObjectAsync(FlexObjectTypes.ReportColumns, informeId, patch): el padre es el informe. El patch lleva dato (la ruta) o campoid, y titulo. Con consolidar a 0, crea todas y llama una vez a Flex_ConsolidateAsync.

PreguntasCopiar el enlace a este apartado

Una pregunta es lo que el informe pide antes de sacar filas: una fecha, un importe, un registro. Es FlexQuestionDTO, igual en informes, documentos y algoritmos; se lee con Flex_GetQuestionsAsync y se escribe con Flex_SetQuestionsAsync. En FlexHub van al final de la pestaña Filtro.

Añadir intervalo crea dos preguntas Fecha, «Desde» y «Hasta», con los nombres internos dinaup_desdef y dinaup_hastaf, que el motor reconoce. Cabe un intervalo por informe.

Las preguntas se pasan por posición (p1, p2, p3). Por eso un informe publicado o en uso llega con FlexQuestionsDTO.Frozen = true: no se añaden, quitan ni mueven, ni cambian de formato, sección o rango. Se cambian la etiqueta, la ayuda, el desplegable y, por la Flex API, el rol.

Para filtrar por periodo, usa una pregunta Fecha con rango y compárala con un campo Fecha (sin hora). Un campo Fecha y hora se guarda en UTC: un registro de las 23:00 del último día cae en el día siguiente para un usuario de otra zona horaria. Por la API, cada pregunta se responde con su Keyword en el diccionario variables de POST /api/reports.

Consumir un informeCopiar el enlace a este apartado