En este artículo explicamos cómo funciona websave en Uniface 10.4 y cómo puede convertir los datos de un componente a JSON para integrarlos con aplicaciones web y APIs modernas.
Qué es websave: la sentencia websave en Uniface 10.4 exporta los datos de un componente a un flujo JSON. Es una herramienta de exportación que empaqueta la información del componente en formato JSON, fácil de leer por humanos y máquinas y muy útil para arquitecturas web y servicios REST.
Sintaxis básica: websave{/mod | /one} Con dos calificadores opcionales que modifican el comportamiento: /mod incluye solo los datos modificados; /one incluye únicamente el registro principal actual y sus datos relacionados.
Cómo funciona: al ejecutar websave se genera una instantánea completa de los datos del componente, incluyendo todos los registros del hitlist, campos de base de datos y no base de datos, registros marcados para eliminación y metadatos como CRC, ID y STATUS. En Uniface una ocurrencia es cada registro individual, similar a una fila de una tabla.
Valores de retorno: el estado de la operación queda en $status. Un número negativo indica error. Cero indica éxito total. Un número positivo indica éxito parcial y suele reflejar cuántos ficheros de imagen no se pudieron crear.
Triggers y personalización: durante la serialización se pueden ejecutar triggers para adaptar la conversión: preSerialize se ejecuta antes de convertir cada registro y postSerialize después de convertirlo. Estos hooks permiten calcular campos derivados, excluir datos o transformar contenido antes de incluirlo en el JSON.
Ejemplo práctico: un flujo típico puede ser: clear retrieve/e ORDER.INOUTER websave putmess $webinfo(data) return. Este ejemplo limpia datos, recupera registros de ORDER, convierte el conjunto a JSON y muestra el resultado en el área de mensajes.
Imágenes: si el componente contiene imágenes almacenadas en base de datos, websave crea archivos temporales para incluir referencias en el JSON. El servidor Uniface necesita permisos de escritura en el directorio del proyecto para generar esos ficheros; en caso contrario aparecen iconos de error en lugar de las imágenes.
Consejos de desarrollo: para facilitar la depuración se pueden activar variables que mejoran la legibilidad del JSON como $JSON_INDENT para sangrado y $JSON_SHOWNAMES para mostrar nombres de campo de forma clara.
Contexto de uso: websave se usa principalmente en componentes Dynamic Server Page para aplicaciones web que generan contenido dinámico. Es perfecto para construir servicios REST, APIs y para integrar Uniface con frontends modernos u otros microservicios.
Q2BSTUDIO y cómo podemos ayudar: en Q2BSTUDIO somos especialistas en desarrollo de software a medida y aplicaciones a medida, con experiencia en inteligencia artificial, ciberseguridad y servicios cloud. Si necesitas desarrollar soluciones que integren Uniface con APIs modernas, transformar datos a JSON o exponer servicios REST, te ayudamos a diseñar e implementar la arquitectura adecuada y a optimizar procesos. Conocemos las mejores prácticas de seguridad y permisos de servidor para evitar problemas con archivos temporales e imágenes.
Ofrecemos servicios completos que abarcan desde el desarrollo de aplicaciones a medida hasta proyectos de inteligencia artificial para empresas, pasando por ciberseguridad, servicios cloud aws y azure, servicios inteligencia de negocio y soluciones con power bi. También trabajamos en automatización de procesos, agentes IA y estrategias de IA para empresas para mejorar eficiencia y toma de decisiones.
Palabras clave: aplicaciones a medida, software a medida, inteligencia artificial, ciberseguridad, servicios cloud aws y azure, servicios inteligencia de negocio, ia para empresas, agentes IA, power bi.
Conclusión: websave es una herramienta esencial para desarrolladores Uniface que necesitan exportar datos a JSON de forma controlada y segura. Revisa siempre $status tras la operación, gestiona permisos de fichero en el servidor y aprovecha triggers para personalizar la salida. Si buscas soporte profesional para integrar Uniface con soluciones web, APIs o proyectos de transformación de datos, en Q2BSTUDIO podemos acompañarte en todo el ciclo desde el diseño hasta la puesta en producción.
