4.4 KiB
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
-
📄 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
-
📂 Seleccionar Directorio de Destino
- Haz clic en "📁 Examinar..." en la sección "Directorio de Destino"
- Selecciona la carpeta donde quieres guardar el archivo SCL
-
🚀 Iniciar Conversión
- El botón "🚀 Convertir XML → SCL" se habilitará automáticamente
- Haz clic para iniciar el proceso de conversión
-
📊 Monitorear Progreso
- Observa los mensajes de progreso en tiempo real
- La barra de progreso indica que el proceso está en ejecución
-
✅ 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:
- Valida las selecciones del usuario
- Ejecuta
x0_main.py
en modo simple con los parámetros:python x0_main.py --source-xml "archivo.xml" --dest-scl "destino/archivo.scl"
- Captura la salida del proceso en tiempo real
- 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
- 📁 Organización: Mantén los archivos XML organizados en carpetas por proyecto
- 🔄 Nombres: Los nombres de archivo SCL se generan automáticamente basados en el XML
- 📋 Log: Revisa siempre el área de log para detalles del proceso
- 💾 Backup: Mantén copias de seguridad de tus archivos XML originales
- 🔍 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 🎯