DataMart
El DataMart de ITM Platform es una copia optimizada para lectura de los datos de su cuenta, diseñada específicamente para consultas analíticas. Mientras que la API estándar está pensada para operaciones cotidianas como crear y actualizar registros, el DataMart tiene un propósito diferente: consultar y analizar datos de todo su portafolio.
La documentación técnica completa está disponible en la Documentación GraphQL del DataMart en el sitio de desarrolladores de ITM Platform.
¿Qué puede hacer con el DataMart?
El DataMart le da acceso directo para consultar los datos de su portafolio, incluyendo:
- Proyectos y servicios con todas sus propiedades e información de estado
- Tareas y su programación, progreso y asignaciones
- Presupuestos y compras para análisis financiero
- Ingresos y seguimiento financiero
- Riesgos e incidencias de todo su portafolio
Esto hace que el DataMart sea ideal para escenarios como:
- Construir cuadros de mando personalizados en herramientas externas
- Crear informes automatizados adaptados a su organización
- Alimentar sus datos de proyectos en su almacén de datos o plataforma de BI
- Ejecutar análisis transversales entre proyectos que van más allá de los informes incorporados
¿Cómo funciona?
El DataMart utiliza GraphQL, un lenguaje de consulta que le permite solicitar exactamente los datos que necesita en una sola llamada. En lugar de realizar múltiples peticiones a la API para reunir información relacionada, puede escribir una única consulta que recupere, por ejemplo, todos los proyectos con sus tareas, presupuestos y riesgos a la vez.
Existen tres tipos de consultas disponibles:
- Consulta de componente individual: Recuperar un proyecto o servicio específico por su ID
- Consulta de lista de componentes: Recuperar múltiples proyectos o servicios, con soporte para filtrado, ordenación y paginación
- Consulta de agregación: Ejecutar operaciones analíticas como agrupación, conteo y suma sobre sus datos — ideal para construir cuadros de mando e informes resumidos
El DataMart también soporta filtrado estilo MongoDB, lo que permite construir consultas con condiciones como "todos los proyectos que comienzan después de una fecha determinada" o "proyectos cuyo presupuesto supera una cantidad específica".
¿Quién puede acceder al DataMart?
El acceso al DataMart depende del rol del usuario en ITM Platform:
| Rol | Nivel de acceso |
|---|---|
| Administrador de la empresa | Acceso completo a todos los datos |
| Usuario completo | Acceso completo a todos los datos |
| Project Manager | Acceso limitado a sus proyectos y servicios gestionados |
| Miembro de equipo | Sin acceso |
| Invitado del proyecto | Sin acceso |
Autenticación
Para conectarse al DataMart, necesita dos datos:
- El identificador de su cuenta (el nombre del tenant en la URL de su ITM Platform)
- Un token de autenticación, que puede obtener a través de la API de login o generar como API Key desde la configuración de su perfil
Si ya está utilizando la API de ITM Platform o las plantillas de Power BI, es posible que ya disponga de estas credenciales.
Límites de consulta
Para garantizar un rendimiento óptimo para todos los usuarios, el DataMart establece algunas restricciones:
- Un máximo de 200 elementos por consulta (1.000 para consultas de agregación)
- Un tiempo límite de 5 segundos por consulta
- Un tamaño máximo de 1 MB por petición
- Las consultas de agregación deben incluir una etapa $limit
Estos límites son suficientes para la mayoría de los escenarios de informes e integración. Si necesita recuperar grandes conjuntos de datos, puede utilizar la paginación para iterar sobre los resultados.
Primeros pasos
La documentación técnica completa, incluyendo la sintaxis de consultas, operadores de filtrado, referencias de campos y ejemplos de consultas, está disponible en el sitio de desarrolladores de ITM Platform:
Documentación GraphQL del DataMart
Encontrará todo lo necesario para comenzar a construir consultas, desde los detalles de autenticación hasta ejemplos prácticos que puede adaptar a su caso de uso.
Cuándo usar el DataMart frente a otras herramientas de informes
ITM Platform ofrece varias formas de analizar y visualizar sus datos. Así se compara el DataMart:
| Herramienta | Ideal para |
|---|---|
| Informes y listas | Vistas rápidas e incorporadas de datos de proyectos |
| Cuadros de mando personalizables | KPIs visuales y gráficos dentro de ITM Platform |
| Plantillas de Power BI | Cuadros de mando prediseñados usando Power BI |
| Informes generados por IA | Resúmenes narrativos automatizados del estado del proyecto |
| DataMart | Consultas personalizadas, integraciones externas y analítica avanzada |
El DataMart es la opción adecuada cuando necesita control total sobre los datos que recupera y desea integrarlos con sistemas externos, crear informes personalizados o realizar análisis que van más allá de lo que ofrecen las herramientas incorporadas.