PowerBuilder
Generador de Documentación HTML impulsado por IA para PowerBuilder
0 visualizaciones
Demo técnica de PowerBuilder 2025
El Generador de Documentación HTML es una herramienta portátil para extraer y documentar automáticamente proyectos de PowerBuilder. Exporta objetos de las librerías PBL, analiza los prototipos de funciones y se integra con una IA local (Ollama) para generar documentación técnica completa en un formato HTML moderno.
Por qué existe esta demo
En PowerBuilder, mantener la documentación técnica actualizada puede ser un proceso tedioso y manual. Esta demo utiliza LibraryDirectory y LibraryExport para extraer los prototipos de las funciones directamente de las PBLs y aprovecha la IA generativa moderna (Ollama) para documentar automáticamente el comportamiento, los parámetros y los tipos de retorno de su código.
Estructura del proyecto e integración con IA
La demo lee el archivo .pbt de destino, extrae las referencias a las .pbl y busca Ventanas, NVOs, Menús y Funciones Globales. Extrae el bloque de forward prototypes y analiza las funciones. Luego, utiliza un objeto auxiliar nvo_ai_helper para comunicarse con una instancia local de Ollama (ejecutando el modelo minimax-m3:cloud por defecto) para generar descripciones ricas y ejemplos de código.
La ventana principal: w_generador_doc_html
w_generador_doc_html centraliza la selección del proyecto, el análisis y la generación de HTML. El botón Generar activa todo el proceso:
• Escaneo de PBLs: Extrae los objetos de las PBLs declaradas en el .pbt seleccionado.
• Análisis (Parsing): Identifica las firmas de las funciones y sus argumentos.
• Enriquecimiento con IA: Se conecta a Ollama para aumentar la documentación con descripciones inteligentes.
• Generación de HTML: Genera un archivo HTML totalmente responsivo y estilizado (docs\ayuda_[proyecto].html) con una barra lateral de búsqueda y resaltado de sintaxis.
Helper de IA (nvo_ai_helper)
El objeto no visual nvo_ai_helper encapsula la comunicación con la API local de Ollama a través de HttpClient y JSONGenerator nativos de PowerBuilder. Envía los prototipos de las funciones a la IA y recibe texto estructurado o descriptivo, manejando de manera elegante los errores de conexión.
Cómo probarlo
11. Asegúrese de tener Ollama ejecutándose localmente en http://localhost:11434 con el modelo requerido22. Abra demo_gen_html_pbl.pbw en PowerBuilder 202533. Ejecute la aplicación44. Seleccione un archivo .pbt de cualquier proyecto de PowerBuilder que desee documentar55. Haga clic en el botón "Generar" y espere a que la IA procese los objetos66. Abra el archivo HTML generado en la carpeta docs
Conclusión
Este generador demuestra cómo combinar las características nativas de administración de bibliotecas de PowerBuilder con las capacidades modernas de IA y HTML/CSS responsivo. El resultado es una poderosa utilidad que reduce drásticamente el esfuerzo requerido para mantener una documentación de alta calidad para sus proyectos.