Dinaup DocsInstalar Dinaup Terminal y publicar tu primer módulo
Instala Terminal, conéctate a un tenant, modela una sección con Flex y empaqueta todo en un módulo que distribuyes por canal.
Vas a instalar Dinaup Terminal, conectarte a un tenant, crear una sección con un par de campos, darle comportamiento con un algoritmo y un informe, y publicarlo como módulo. Cada paso enlaza al detalle por si quieres profundizar.
Contenido técnico para partners e integradores que construyen sobre Dinaup. El usuario final que factura o vende trabaja desde la aplicación web; aquí moldeas el sistema por debajo con Flex.
Antes de empezar
| Requisito | Por qué |
|---|---|
| Equipo con Windows | Terminal es una aplicación de escritorio para Windows. Se instala en tu perfil de usuario, sin permisos de administrador. |
| Acceso a un tenant | El servidor de tu organización, una licencia y un usuario con su contraseña. Si no los tienes, pídelos a quien administre Dinaup. |
| Licencia Flex activa | Sin ella abres Terminal pero no editas la estructura del tenant. Es lo que habilita crear secciones, campos, algoritmos y módulos. |
Si al entrar no puedes editar secciones ni campos, revisa que el tenant tenga Flex activo y que tu usuario no sea de solo lectura. Planes en Precios; concepto en ¿Qué es Dinaup?.
Construir el módulo
Seis fases: instalas y conectas, modelas los datos, les das comportamiento y publicas. Cada capa se apoya en la anterior, así que vas de abajo arriba: primero los datos, luego los cálculos, por último cómo se explotan.
Instala Terminal y conéctate al tenant
Instala Dinaup Terminal con winget install Dinaup.CLI (o descarga el ejecutable oficial), ábrelo y acepta la licencia. En la pantalla de acceso introduce los tres datos que identifican tu entorno:
- Servidor: la instancia de Dinaup de tu organización.
- Licencia: tu empresa dentro de ese servidor; determina los datos a los que entras.
- Usuario: tu cuenta personal; determina qué puedes ver y hacer.
Conéctate al tenant que vas a personalizar con un usuario que pueda editar la estructura (no de solo lectura).
Lo que editas con Flex afecta a todos los usuarios de ese tenant. Para cambios delicados, usa un entorno de pruebas, no el tenant de producción de un cliente.
Entiende los canales antes de tocar nada
Tu trabajo viaja por canales de madurez. Saber en cuál estás te evita sorpresas al publicar.
| Canal | Para qué es |
|---|---|
| Desarrollo | Versión en construcción, sujeta a cambios. Donde creas y pruebas mientras trabajas. |
| Beta | Versión candidata, estable pero en validación, para probar en condiciones reales. |
| Producción (release) | Versión estable que reciben los clientes finales en su día a día. |
Una versión nace en desarrollo, madura hacia beta y se publica en producción. La licencia fija el canal: una de producción no instala versiones a medio hacer. Por eso conviene construir contra un tenant de desarrollo o beta.
Crea una sección con un par de campos
Una sección es una tabla de datos (clientes, equipos, incidencias… lo que tu solución necesite). Es el cimiento, así que empiezas por aquí.
- Crea la sección y dale un nombre claro.
- Si va a compartir estructura con otras, apóyala en una sección base para no repetir campos.
- Añade un par de campos para arrancar. Para cada uno eliges:
- un tipo base (texto, número decimal, fecha, sí/no, relación…),
- un rol opcional que lo afina (un Texto con rol Email valida el formato),
- sus atributos: obligatorio, bloqueado, valor por defecto.
Modela los campos pensando en cómo se rellenan y consultan después. Un buen diseño aquí te ahorra correcciones más tarde.
Añade un algoritmo simple
Cuando un valor se calcula en vez de teclearse —un total, un acumulado, un dato traído de otra sección—, lo resuelves con un algoritmo.
Define uno y conéctalo a un campo auto-calculado: ese campo deja de escribirse a mano y se rellena solo a partir del cálculo. Los algoritmos son el motor de Flex: los defines una vez y los reutilizas en campos, informes y documentos.
Construye un informe para explotar los datos
Un informe convierte tu sección en un listado útil: eliges columnas, aplicas filtros y orden, agrupas y añades columnas calculadas con el algoritmo del paso anterior.
Así el usuario "ve" y "filtra" lo que guardas sin escribir consultas a mano. Con esto tu solución ya guarda, calcula y muestra: un ciclo completo de datos.
Publica todo como módulo
Cuando el conjunto funciona, empaquetas la sección, sus campos, el algoritmo y el informe en un módulo reutilizable. Es lo que convierte una personalización suelta en algo distribuible y repetible. La publicación tiene su propio recorrido, justo debajo.
Publicar el módulo
Terminal te guía por una serie de comprobaciones para que el módulo llegue completo y a quien debe.
Prepara el módulo
Reúne en el módulo todas las piezas que construiste: la sección, sus campos, el algoritmo y el informe. Revisa que no falte nada y que el conjunto 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 no instales un módulo que "casi" funciona porque le falta algo de su 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 la recibe y cuándo).
Para un primer módulo, publica en desarrollo: lo pruebas a fondo y, cuando esté sólido, lo promocionas a beta y luego a producción. Tratar versión y canal como parte de la publicación es lo que te deja distribuir cambios de forma ordenada y volver atrás si hace falta.
Una vez publicado, cualquier licencia compatible instala el módulo desde la galería compartida y obtiene el mismo comportamiento. El núcleo se actualiza solo a la versión vigente del canal de cada licencia.
Cómo encaja con el resto
- El qué —el modelo de secciones, campos, algoritmos, informes y documentos— vive en Flex. Esta guía es el orden en que lo aplicas desde Terminal.
- La instalación y conexión al tenant tiene su página propia: Instalación y conexión.
- La mecánica de empaquetar y distribuir se desarrolla en Módulos y canales y Flujo de desarrollo.
Preguntas frecuentes
→ Dinaup Terminal → Instalación y conexión → Módulos y canales → Flujo de desarrollo → Documentación de Flex