ParamManagerScripts/backend/script_groups/XML Parser to SCL/README_x8_manual_gui.md

4.4 KiB

🔄 XML→SCL Converter - Modo Manual con GUI

📋 Descripción

x8_manual_gui.py es una interfaz gráfica de usuario (GUI) que facilita la conversión de archivos XML de Siemens TIA Portal a código SCL de manera manual e interactiva.

🚀 Características Principales

  • 🖥️ Interfaz gráfica amigable - Cuadros de diálogo de Windows nativos
  • 📄 Selección de archivo XML - Navegador de archivos integrado
  • 📂 Selección de directorio destino - Explorador de carpetas
  • 📝 Generación automática de nombres - El nombre del archivo SCL se genera automáticamente
  • 📊 Progreso en tiempo real - Visualización del proceso de conversión
  • Verificación de resultados - Confirmación de éxito y opción para abrir directorio
  • 🔧 Manejo de errores - Mensajes claros de error y advertencias

🎯 Modo de Uso

1. Ejecutar el Script

python x8_manual_gui.py

2. Pasos en la Interfaz

  1. 📄 Seleccionar Archivo XML

    • Haz clic en "📁 Examinar..." en la sección "Archivo XML de Origen"
    • Navega y selecciona tu archivo .xml de Siemens TIA Portal
    • El nombre del archivo SCL se generará automáticamente
  2. 📂 Seleccionar Directorio de Destino

    • Haz clic en "📁 Examinar..." en la sección "Directorio de Destino"
    • Selecciona la carpeta donde quieres guardar el archivo SCL
  3. 🚀 Iniciar Conversión

    • El botón "🚀 Convertir XML → SCL" se habilitará automáticamente
    • Haz clic para iniciar el proceso de conversión
  4. 📊 Monitorear Progreso

    • Observa los mensajes de progreso en tiempo real
    • La barra de progreso indica que el proceso está en ejecución
  5. Verificar Resultados

    • Al completarse, verás un mensaje de éxito
    • Opción para abrir automáticamente el directorio de destino

🔧 Funcionamiento Interno

El script GUI internamente:

  1. Valida las selecciones del usuario
  2. Ejecuta x0_main.py en modo simple con los parámetros:
    python x0_main.py --source-xml "archivo.xml" --dest-scl "destino/archivo.scl"
    
  3. Captura la salida del proceso en tiempo real
  4. Muestra los resultados de manera amigable

📋 Requisitos

  • Python 3.x con tkinter (incluido en la mayoría de instalaciones)
  • x0_main.py funcional con modo simple implementado
  • Sistema operativo Windows (para cuadros de diálogo nativos)

🆚 Comparación con Otros Modos

Modo Comando Uso Recomendado
GUI (x8) python x8_manual_gui.py 🎯 Usuario final, conversiones manuales
Simple python x0_main.py --source-xml file.xml --dest-scl file.scl 🔧 Testing, desarrollo, scripts
PLC python x0_main.py --plc-dir /path/to/plc 🏭 Procesamiento de proyecto completo
Orquestador python x0_main.py 🌐 Procesamiento masivo multi-PLC

🎨 Capturas de Funcionalidad

Interfaz Principal

  • Sección clara para selección de archivo XML
  • Área dedicada para directorio de destino
  • Nombre de archivo auto-generado
  • Botón prominente de conversión

Área de Progreso

  • Barra de progreso animada
  • Log en tiempo real con timestamps
  • Colores distintivos para diferentes tipos de mensajes
  • Scroll automático para seguir el progreso

Diálogos de Resultado

  • Éxito: Confirmación con opción de abrir directorio
  • Error: Detalles claros del problema encontrado

🚨 Solución de Problemas

El script no inicia

  • Verificar que Python tenga tkinter instalado
  • Ejecutar desde el directorio correcto

Error "x0_main.py no encontrado"

  • Asegurarse de que x0_main.py esté en el mismo directorio
  • Verificar permisos de archivo

La conversión falla

  • Revisar los mensajes en el área de log
  • Verificar que el archivo XML sea válido
  • Comprobar permisos de escritura en el directorio destino

💡 Consejos de Uso

  1. 📁 Organización: Mantén los archivos XML organizados en carpetas por proyecto
  2. 🔄 Nombres: Los nombres de archivo SCL se generan automáticamente basados en el XML
  3. 📋 Log: Revisa siempre el área de log para detalles del proceso
  4. 💾 Backup: Mantén copias de seguridad de tus archivos XML originales
  5. 🔍 Verificación: Siempre verifica el archivo SCL generado antes de usarlo en producción

Creado para facilitar la conversión manual de archivos XML de Siemens TIA Portal a código SCL 🎯