Dinaup DocsFlujo de desarrollo
El ciclo de trabajo en Dinaup Terminal de principio a fin: conectarte a un tenant, modelar con Flex y publicar tus cambios como módulo.
Esta página describe el ciclo de trabajo recomendado para construir sobre Dinaup con Terminal: desde que te conectas a un tenant hasta que publicas tu trabajo como módulo. No entra en el detalle conceptual de cada pieza —eso vive en la documentación de Flex—, sino en el orden y el porqué de cada fase.
Terminal organiza este recorrido como un proceso por pasos. No tienes que recorrerlo entero cada vez: en el día a día saltarás directo a la fase que toque (editar un campo, ajustar un informe). Pero la primera vez, y antes de cada publicación, conviene tenerlo claro de principio a fin.
Antes de empezar necesitas Terminal instalado y conectado a un tenant con licencia Flex activa. Si aún no lo tienes, empieza por la guía de la sección.
Las cuatro fases del ciclo
Estas son las fases. Las tres primeras son construcción (defines cómo se comporta el sistema); la última es distribución (empaquetas y publicas lo construido).
| Fase | Qué haces | Dónde se explica el concepto |
|---|---|---|
| 1. Conectar | Abres Terminal y eliges el tenant sobre el que vas a trabajar. | Esta página |
| 2. Modelar datos | Creas y editas secciones y sus campos. | Secciones · Campos |
| 3. Dar comportamiento | Añades algoritmos, informes y documentos dinámicos. | Flex |
| 4. Publicar | Empaquetas todo como módulo y lo distribuyes por un canal. | Flex |
El ciclo en detalle
Conéctate al tenant
Al abrir Terminal, lo primero es elegir sobre qué tenant vas a trabajar. Un tenant es el entorno de un cliente o proyecto concreto: tiene sus propias secciones, datos y configuración.
Trabaja siempre sabiendo dónde estás. Modelar contra el tenant equivocado es la forma más fácil de romper algo que funcionaba.
Lo que editas con Flex afecta a todos los usuarios de ese tenant. Si vas a probar cambios delicados, hazlo primero en un entorno de pruebas, no sobre el tenant de producción de un cliente.
Crea o edita una sección
Una sección es una tabla de datos: clientes, facturas, productos, lo que tu solución necesite. Es el cimiento de todo lo demás, así que empieza por aquí.
Decide qué tipo de información va a guardar la sección y créala. Si vas a tener varias secciones que comparten campos comunes, plantéate apoyarlas en una sección base para no repetir estructura.
→ El modelo completo de secciones está en Secciones.
Añade los campos
Dentro de cada sección defines los campos (sus columnas). Para cada campo eliges tres cosas:
- Tipo: texto, número, decimal, fecha, sí/no, relación con otra sección…
- Rol: qué papel cumple ese dato dentro de la sección.
- Validación y comportamiento: si es obligatorio, su rango o formato, su valor por defecto, si se autorrellena a partir de otros campos o se bloquea como solo lectura.
Modela los campos pensando en cómo se van a rellenar y consultar después. Un buen diseño de campos te ahorra cálculos y correcciones más adelante.
→ Tipos, roles y validaciones en detalle en Campos.
Da comportamiento con algoritmos
Cuando un valor no se introduce a mano sino que se calcula, lo resuelves con un algoritmo: el total de una línea, un acumulado, un dato traído de otra sección.
Los algoritmos son el motor de cálculo de Flex. Se usan para rellenar campos, generar columnas en informes y componer documentos. Defínelos una vez y reutilízalos donde haga falta.
→ Tipos de algoritmo y cómo se conectan: Flex.
Construye informes
Un informe convierte tus secciones en listados y consultas útiles: eliges columnas, aplicas filtros y orden, agrupas y añades columnas calculadas con algoritmos.
Es la forma de explotar la información que ya estás guardando, sin escribir consultas a mano. Si una solución necesita que el usuario "vea" o "filtre" datos, casi siempre es un informe.
Genera documentos dinámicos
Un documento dinámico combina los datos de un registro con una plantilla para producir una salida con formato: una factura, un presupuesto, un correo, una respuesta para una integración.
Son la capa de presentación: lo que el sistema entrega hacia fuera. Diséñalos cuando tu solución tenga que emitir algo, no solo guardarlo.
Publica como módulo
Cuando el conjunto funciona, empaquetas todo el trabajo —secciones, campos, algoritmos, informes y documentos— en un módulo reutilizable. Es el paso que convierte una personalización suelta en algo distribuible y repetible.
Publicar tiene su propio mini-recorrido, que cubre la siguiente sección. El detalle de la ventana de publicación está en Publicar un módulo.
La fase de publicación
Publicar no es "subir y ya". Terminal te guía por una serie de comprobaciones para que el módulo llegue completo y a quien debe. A grandes rasgos:
Prepara el módulo
Reúnes en el módulo todas las piezas que has construido. Es el momento de revisar que no falte nada y que lo que incluyes tenga sentido como una unidad coherente.
Valida las dependencias
Un módulo suele apoyarse en otras piezas (otras secciones, otros módulos). Terminal comprueba esas dependencias antes de dejarte publicar, para que el módulo no llegue al destino con cabos sueltos que lo dejarían a medio funcionar.
Resolver las dependencias antes de publicar evita el problema clásico: instalar un módulo que "casi" funciona porque le falta algo de lo que dependía en origen.
Asigna versión y canal
Cada publicación lleva una versión (para saber qué cambió respecto a la anterior) y se envía por un canal (que determina quién recibe ese módulo y cuándo).
Pensar versión y canal como parte de la publicación —y no como un detalle administrativo— es lo que te permite distribuir cambios de forma ordenada y poder volver atrás si hace falta.
Cómo encaja con el resto
- El qué —el modelo de secciones, campos, algoritmos, informes y documentos— vive en la documentación de Flex. Esta página es solo el orden en que lo aplicas desde Terminal.
- El detalle de cada ventana del Terminal —qué opción es cada cosa al diseñar secciones, editar campos o escribir algoritmos— está en Ventanas del Terminal.
- La instalación y la conexión inicial al tenant las cubre la guía de la sección.
- La mecánica de empaquetar y distribuir (módulos, versiones, canales) se desarrolla en Publicar un módulo; aquí solo se sitúa dentro del ciclo.
Preguntas frecuentes
→ Volver a Dinaup Terminal → Secciones → Campos → Documentación de Flex
Módulos y canales
Cómo Dinaup empaqueta funcionalidad en módulos versionados y cómo los canales (desarrollo, beta, producción) controlan qué versión llega a tu licencia.
Diseñar secciones y campos
Referencia de las opciones del Asistente de Secciones y el Editor de Campos del Terminal al modelar tus datos.