Usar Plantilla¶

Esta guía le enseñará a cargar y usar plantillas guardadas para ejecutar importaciones rápidamente.

Cargar una Plantilla¶

Paso 1: Acceder a las Plantillas¶

Abra xls2sage50
Vaya a la sección Plantillas (icono :material.bookmark:)

Sección de plantillas

Paso 2: Seleccionar la Plantilla¶

Busque la plantilla que desea usar en la lista
Puede usar el buscador para filtrar por nombre
Seleccione la plantilla

Paso 3: Cargar la Plantilla¶

Haga clic en "Cargar" o doble clic en la plantilla.

La plantilla se cargará y verá:

El mapeo de campos configurado
Las opciones de importación
Las validaciones definidas

Ejecutar Importación con Plantilla¶

Paso 1: Seleccionar el Archivo¶

Una vez cargada la plantilla:

Haga clic en "Seleccionar Archivo"
Busque el archivo Excel que desea importar
Seleccione el archivo

!!! tip "Nombre de Archivo**

El archivo debe tener la misma estructura que usó al crear la plantilla (mismas columnas).

Paso 2: Verificar la Configuración¶

Revise que la configuración cargada es correcta:

Elemento	Qué Verificar
Mapeo	Todas las columnas están mapeadas
Opciones	Las opciones son las deseadas
Validaciones	Las reglas son apropiadas

Paso 3: Vista Previa¶

Siempre realice una vista previa:

Haga clic en "Vista Previa"
Revise los primeros 10 registros
Verifique que los datos se ven correctamente

!!! warning "Revise Siempre la Vista Previa**

Si el archivo tiene una estructura diferente al usado para crear la plantilla, la importación podría fallar.

Paso 4: Ejecutar¶

Si todo es correcto:

Haga clic en "Importar"
Espere a que finalice el proceso
Revise los resultados

Modificar Temporalmente una Plantilla¶

Si necesita hacer cambios temporales sin modificar la plantilla:

Cargue la plantilla
Realice los cambios necesarios (mapeo, opciones)
No guarde la plantilla
Ejecute la importación

Los cambios no se guardarán y la plantilla permanecerá intacta.

!!! tip "Guardar como Nueva Plantilla**

Si desea conservar los cambios, use **"Guardar como"** con un nombre diferente en lugar de sobrescribir la original.

Plantillas y Archivos con Estructura Diferente¶

Si el archivo tiene una estructura diferente:

Opción A: Crear Nueva Plantilla¶

Configure el mapeo para el nuevo archivo
Guárdelo como una plantilla nueva

Opción B: Modificar la Plantilla Existente¶

Cargue la plantilla
Modifique el mapeo
Haga clic en "Guardar" (sobrescribir)

Opción C: Usar Mapeo Inteligente¶

xls2sage50 intentará adaptar el mapeo:

Columnas con nombres similares se asocian automáticamente
Columnas sin equivalencia se marcan para revisión

Flujo Completo con Plantilla¶

flowchart TD
    A[Abrir xls2sage50] --> B[Sección Plantillas]
    B --> C[Seleccionar Plantilla]
    C --> D[Cargar Plantilla]
    D --> E[Seleccionar Archivo Excel]
    E --> F{¿Estructura compatible?}
    F -->|Sí| G[Vista Previa]
    F -->|No| H[Ajustar Mapeo]
    H --> I{¿Guardar cambios?}
    I -->|Sí| J[Guardar Plantilla]
    I -->|No| K[Continuar sin guardar]
    J --> G
    K --> G
    G --> L{¿Correcto?}
    L -->|Sí| M[Ejecutar Importación]
    L -->|No| N[Corregir]
    N --> G
    M --> O[Verificar Resultados]

Atajos de Teclado¶

Atajo	Acción
`Ctrl + L`	Abrir lista de plantillas
`Ctrl + Shift + L`	Cargar última plantilla usada
`F5`	Actualizar lista de plantillas

Automatización con Plantillas¶

Uso desde Línea de Comandos¶

# Ejecutar una plantilla específica
python xls2sage50.py run --template="Clientes_Mensual" --file="clientes_febrero.xlsx"

# Ejecutar con opciones adicionales
python xls2sage50.py run --template="Clientes_Mensual" --file="clientes_febrero.xlsx" --dry-run

Script por Lotes¶

@echo off
REM Importación automática con plantilla

set ARCHIVO=%1
set PLANTILLA=Clientes_Mensual

if "%ARCHIVO%"=="" (
    echo Uso: importar.bat archivo.xlsx
    exit /b 1
)

python xls2sage50.py run --template=%PLANTILLA% --file=%ARCHIVO%

if %ERRORLEVEL% EQU 0 (
    echo Importacion exitosa
) else (
    echo Error en importacion
    exit /b 1
)

Problemas Comunes¶

Problema: Columnas No Reconocidas¶

Algunas columnas no se mapean

Causa: El archivo tiene columnas diferentes al usado para crear la plantilla

Solución: - Verifique que los nombres de columnas coinciden - Ajuste el mapeo manualmente - Considere crear una nueva plantilla

Problema: Archivo con Columnas Adicionales¶

El archivo tiene columnas que no están en la plantilla

Causa: El archivo tiene más columnas que las esperadas

Solución: - Las columnas adicionales se ignoran automáticamente - Si desea usarlas, añádalas al mapeo - Guarde una nueva versión de la plantilla

Próximo Paso¶

Editar y Eliminar - Modifique o elimine plantillas existentes

!!! question "¿Necesita Crear una Plantilla?**

Si aún no tiene plantillas, consulte [Crear Plantilla](crear.md) para aprender a crearlas.