Arquitectura
Modelo de datos
La base analítica publica alrededor de cien entidades. Esta página explica cómo están construidas, qué convenciones siguen y dónde está cada cosa.
La lista exacta de lo publicado en tu solución se obtiene consultando el documento de metadatos del punto OData. Ver Consultar con OData.
Cinco convenciones que se repiten en todas#
Aprenderlas una vez ahorra mirar el detalle de cada entidad:
| Campo | Qué es |
|---|---|
ID |
La clave primaria. Es un identificador estable: el que se usa para relacionar entidades entre sí |
ID_EMPRESA |
A qué empresa de tu solución pertenece el registro |
CODIGO y DESCRIPCION |
El código visible y el texto que lee una persona |
VIGENTE |
1 si sigue en uso, 0 si se retiró. Los catálogos conservan lo retirado para que el histórico cuadre |
CREADOEL, CREADOPOR, MODIFICADOEL, MODIFICADOPOR |
Cuándo y quién creó y modificó por última vez |
Y las relaciones siempre se hacen por identificador: un campo ID_CLIENTE de
una tarea contiene el ID de la entidad CLIENTES.
Esto es lo que hace fácil el modelado en Power BI
Todas las relaciones son de un campo ID_* contra el ID de la entidad
correspondiente. No hay claves compuestas ni convenciones distintas según la
tabla.
Tipos de datos#
Los tipos llegan ya normalizados, que es una de las ventajas de pasar por la capa de transformación:
| Tipo | Se usa para |
|---|---|
String |
Textos, identificadores y códigos |
Decimal |
Importes, cantidades, horas y marcas 0/1 |
Date |
Fechas sin hora |
DateTimeOffset |
Fechas con hora |
TimeOfDay |
Horas del día |
Las fechas vienen tipadas, no como texto
A diferencia de una integración contra el sistema operativo, aquí una fecha es una fecha: la herramienta de BI la reconoce sola y no hay que convertir ni preocuparse del orden día/mes. Es una de las cosas que la transformación arregla por el camino.
Las marcas booleanas llegan como número
VIGENTE, BLOQUEADO y similares son Decimal con valor 0 o 1. En Power BI
conviene convertirlas a verdadero/falso al modelar, una sola vez.
Qué no vas a encontrar, y por qué#
| No se publica | Motivo |
|---|---|
| Imágenes, fotos y documentos adjuntos | Multiplican el volumen y no se analizan |
| Campos calculados y sumarios del sistema operativo | Se resolvían al vuelo; en analítica se prefieren valores ya persistidos |
| Campos de búsqueda, filtro, orden e interfaz | Existen para manejar pantallas, no para medir |
| Configuración interna y plantillas de impresión | No son datos de negocio |
Si echas en falta un dato, pregúntalo
El criterio de exclusión es conservador a propósito, pero es revisable: si tu análisis necesita un campo que hoy no viaja, se puede incorporar. Lo que no se hace es publicarlo «por si acaso».
Las entidades, por familias#
102 entidades y 2.311 campos. El detalle campo a campo está en las páginas de referencia; aquí queda el mapa de qué hay en cada una y por dónde entrar.
| Familia | Qué contiene | Entidades |
|---|---|---|
| Maestros | Quién es el cliente, qué se vende, quién trabaja y sobre qué equipos se actúa | 14 |
| Trabajo | Proyectos, tareas, planificación, partes, horas, materiales y gastos | 23 |
| Venta y facturación | Presupuestos, albaranes, cuotas, conceptos facturables y costes | 11 |
| Compras y gastos | Facturas y albaranes de proveedor, con su imputación | 5 |
| Calidad | Incidencias, no conformidades, acciones y sus catálogos | 10 |
| Inmobiliaria | Promociones e inmuebles | 5 |
| Catálogos | Las dimensiones por las que se segmenta y se agrupa | 21 |
| Organización y servicio | Empresas, usuarios, perfiles, campos propios y el registro de cargas | 13 |
Las cinco entidades que hay que conocer sí o sí#
| Entidad | Por qué importa |
|---|---|
SERVICIOS_PARTE |
Lo ejecutado: las horas realmente trabajadas, con su persona, su fecha y su tipo de hora. Casi todo indicador de productividad o rentabilidad pasa por aquí |
PLANIFICACIONES_TAREA |
Lo previsto. Cruzarla con la anterior es el análisis de desviación, el primer cuadro de mando que pide todo el mundo |
PRESUPUESTOS |
Los ingresos. Contiene presupuestos y albaranes a la vez, distinguidos por su tipo de documento |
COSTES |
El coste por hora de cada persona. Sin esta entidad, un informe de rentabilidad enseña ingresos y cero gasto |
ESTADOS |
Lleva el tipo de estado —inicial, en curso, detenido, final—, que es lo que permite medir qué está abierto sin depender del nombre que cada empresa le ponga |
Tus campos propios también llegan
Si tu empresa definió campos adicionales, sus definiciones y sus valores están publicados en la familia de organización y se pueden incorporar al análisis.
El registro de cargas es parte del informe
API_SYNC_LOG dice cuándo se actualizó cada cosa. Cárgalo y pon una tarjeta con
la última actualización: contesta de antemano la pregunta que siempre llega.
Cómo se relacionan entre sí#
Todas las relaciones siguen la misma regla —un campo ID_ALGO apunta al ID de la
entidad ALGOS—, pero hay una columna vertebral que conviene tener en la cabeza y
tres trampas al modelar que cuestan una tarde si se descubren tarde.
Está todo en Relaciones entre entidades.
Multiempresa#
Si tu solución tiene varias empresas, la mayoría de entidades llevan
ID_EMPRESA y conviene filtrar por ella desde el principio, normalmente con una
tabla de empresa y relaciones en el modelo.
Sin ese filtro los totales suman de más
Y no da ningún error: simplemente los números salen mayores de lo que deberían. Es el fallo más común al montar el primer informe multiempresa.
Qué viene después#
Consultar con OData para leerlo, y Conectar Power BI para explotarlo.