Ribbon y botones en las hojas

15. Ribbon y botones en las hojas

Todas las acciones de la herramienta están disponibles desde dos lugares al mismo tiempo: el ribbon (barra de herramientas personalizada en la parte superior de Excel) y los botones insertados directamente en las hojas F5 y Confirmaciones.

	Ribbon (pestaña ASEE)	Botones en hoja (F5 / Confirmaciones)
Ubicación	Cinta superior de Excel, disponible desde cualquier hoja	Dentro de la hoja F5 o Confirmaciones, cerca de los encabezados
Siempre visible	Sí	Solo cuando estás en esa hoja
Se puede ocultar	No — el ribbon es permanente	Sí — cada botón se puede ocultar individualmente desde `config` (ver sección 15.1)
Puede estar deshabilitado (gris)	Sí — los botones de Activity se habilitan según el avance del proceso (ver sección 13)	No aplica
Función	Idéntica al botón de hoja equivalente	Idéntica al botón del ribbon equivalente

ℹ

Hay dos conceptos distintos que no deben confundirse:
— Ocultar un botón de hoja: se hace desde config y hace que el botón desaparezca físicamente de la hoja. Aplica solo a botones en F5 y Confirmaciones, no al ribbon.
— Deshabilitar un botón del ribbon: el sistema lo pone gris automáticamente cuando las condiciones del proceso no están cumplidas. Solo aplica al grupo Activity. No hay parámetro en config que controle esto.

Botones del ribbon — pestaña ASEE

Grupo	Botones	Control de visibilidad / estado
Chequera	Importar Chequera, Limpiar Chequera	Siempre habilitados
F5	Generar F5, Exportar F5, Limpiar F5, Copiar UPC, Generar Botones F5	Siempre habilitados en ribbon. Los equivalentes en la hoja F5 se controlan desde `config`
Confirmaciones	Generar Conf., Exportar Conf., Limpiar Conf., Exportar Corte	Siempre habilitados en ribbon. Los equivalentes en la hoja se controlan desde `config`
Activity	Importar Activity, Generar Activity, Exportar Activity, Eliminar Activity	Se habilitan/deshabilitan automáticamente según el avance. Sin control desde `config`. Ver sección 13

✔

Botón "Generar Botones F5": si los botones de la hoja F5 desaparecen o se desconfiguran, este botón del ribbon los recrea todos de cero, respetando la configuración de visibilidad en config.

15.1 Mostrar u ocultar botones en las hojas

Los botones que aparecen dentro de la hoja F5 y de la hoja Confirmaciones tienen un parámetro en config que controla individualmente si cada botón se muestra o no.

ℹ

Esta sección aplica únicamente a los botones en las hojas F5 y Confirmaciones. Los botones del ribbon no se pueden ocultar. Los botones del grupo Activity en el ribbon no tienen parámetro en config — su estado (habilitado/gris) lo gestiona el sistema automáticamente según el proceso.

La lógica es simple:

Si la celda de valor tiene texto → el botón aparece en la hoja con ese texto como etiqueta.
Si la celda de valor está vacía → el botón no aparece.

### Cómo ocultar un botón

Ir a la hoja config.
Buscar la fila correspondiente al botón que quieres ocultar (secciones "Formato de Botones hoja F5" o "Formato de Botones hoja Confirmaciones").
En la columna E (Valor), borrar el contenido de esa celda (dejarla vacía).
En el ribbon, hacer clic en "Generar Botones F5" (para botones del F5) o regenerar Confirmaciones (para botones de Confirmaciones) para que los cambios tomen efecto.

### Cómo volver a mostrar un botón oculto

Ir a la hoja config, fila del botón.
En la columna E (Valor), escribir el texto que quieres que muestre el botón (ej. Importar Chequera).
Hacer clic en "Generar Botones F5" en el ribbon para recrear los botones.

ℹ

Ocultar un botón de la hoja no deshabilita la función — el mismo botón sigue disponible en el ribbon. Si quieres que la acción no esté disponible en absoluto, eso requiere cambios en el código.

### Botones disponibles por hoja

Botón	Hoja	Parámetro en config
Importar Chequera	F5	`f5_show_btnImportChequera`
Limpiar Chequera	F5	`f5_show_btnClearChequera`
Generar F5	F5	`f5_show_btnGenF5`
Exportar F5	F5	`f5_show_btnExportF5`
Limpiar F5	F5	`f5_show_btnClearF5`
Copiar UPC	F5	`f5_show_btnCopyUPCF5`
Importar Chequera	Confirmaciones	`confirm_show_btnImportChequera`
Limpiar Chequera	Confirmaciones	`confirm_show_btnClearChequera`
Generar Conf.	Confirmaciones	`confirm_show_btnGenConf`
Exportar Conf.	Confirmaciones	`confirm_show_btnExportConf`
Limpiar Conf.	Confirmaciones	`confirm_show_btnClearConf`
Exportar Corte	Confirmaciones	`confirm_show_btnExportCorte`

15.2 Cambiar la fila de encabezados del F5 o Confirmaciones

La fila donde el sistema espera encontrar (y escribir) los encabezados del F5 y de Confirmaciones está configurada en la hoja config. En circunstancias normales no es necesario cambiarla, pero si por alguna razón la estructura del archivo debe cambiar, así se hace:

### Parámetros que controlan la fila de encabezados

Parámetro en config	Hoja afectada	Valor por defecto
`f5_header_row`	F5	`2` — encabezados en la fila 2
`confirm_header_row`	Confirmaciones	`2` — encabezados en la fila 2

### Procedimiento para cambiar la fila de encabezados

Ir a la hoja config.
Localizar el parámetro f5_header_row (o confirm_header_row) y cambiar el valor en la columna E al número de fila deseado (ej. 3).
En la hoja F5 (o Confirmaciones), mover manualmente los encabezados a la fila nueva o dejarla vacía (el sistema los reconstruirá al generar).
Limpiar el contenido de la hoja correspondiente con el botón "Limpiar F5" (o "Limpiar Conf.") para borrar datos desalineados.
Volver a generar el F5 (o Confirmaciones).

⛔

Atención: cambiar la fila de encabezados mientras el F5 tiene datos generará un desalineamiento — el sistema escribirá en la fila nueva pero los datos viejos seguirán en las filas anteriores. Siempre limpiar antes de regenerar tras cambiar este parámetro.

15.3 Reconstrucción automática de encabezados

Si los encabezados de la hoja F5 o Confirmaciones son eliminados accidentalmente, el sistema los reconstruye automáticamente al presionar "Generar F5" o "Generar Confirmaciones".

### ¿Cómo funciona?

Los encabezados del F5 y Confirmaciones no son texto fijo en el archivo — se leen directamente de map_f5 y map_confirm respectivamente. Al generar, el sistema escribe en la fila de encabezados (definida por f5_header_row o confirm_header_row en config) los textos de la columna Nombre F5 o Nombre Confirmaciones del mapa en las columnas correspondientes.

✔

Esto significa que los encabezados siempre estarán sincronizados con el mapeo. Si cambias el nombre de una columna en map_f5, al regenerar el F5 el encabezado se actualizará automáticamente.

### ¿Aplica esto al Activity?

No. Las hojas del Activity (Product Content y Trade Item) tienen encabezados que provienen del archivo GOI descargado del Comprador — son los encabezados que el Comprador define. Si se eliminan, hay que reimportar el archivo GOI. El Activity no reconstruye encabezados.

ℹ

Los encabezados de las bases de datos (db_genero, db_marcas, etc.) tampoco se reconstruyen — son fijos y el sistema los lee tal como están en cada hoja. Si se eliminan, hay que restaurarlos manualmente.

15.4 ¿Por qué el Activity es diferente del F5 y Confirmaciones?

F5 y Confirmaciones se generan en hojas de este libro, con columnas y estructura que tú controlas. El Activity se genera en las hojas del archivo GOI del Comprador, que tienen una estructura fija definida por el Comprador. Estas son las diferencias clave:

Aspecto	F5 / Confirmaciones	Activity (GOI)
¿Quién define las columnas?	Tú — a través de `map_f5` o `map_confirm`	El Comprador — la estructura viene dentro del archivo GOI descargado
¿Se pueden agregar columnas?	Sí — agrega una fila en map_f5 o map_confirm	No — las columnas son las que el Comprador definió; cambiarlas rompe la carga
¿Se reconstruyen los encabezados?	Sí — automáticamente al generar	No — si se pierden, hay que reimportar el GOI
Fuente de datos	Directamente de la Chequera	Del F5 ya generado (el Activity necesita el F5 completo)
Sistema de alertas de color	Rojo y amarillo en las celdas, color configurable	Solo texto de error en la celda (`No definida en DB: …`), sin colores
¿Se puede exportar aunque haya errores?	Sí — el F5 se exporta aunque tenga celdas rojas	Técnicamente sí, pero la plataforma del Comprador rechazará la carga
Hojas que genera	Una hoja (F5 o Confirmaciones)	Dos hojas: Product Content And Site Exp + Trade Item Configurations
Requiere archivo externo	No — las hojas ya están en el libro	Sí — hay que descargar el GOI del Comprador e importarlo primero
Flujo de habilitación	Siempre disponible mientras haya chequera	Secuencial: Importar → Generar → Exportar (no se puede saltar pasos)

ℹ

Esta diferencia arquitectónica también explica por qué los mapas del Activity (map_activity_pc y map_activity_ti) son más rígidos que map_f5: las claves internas están vinculadas directamente al código y no se deben reorganizar libremente.