Protección contra cambios de estructura de la fuente

Cómo funciona la protección de estructura: qué cambios controla, qué significa cada modo y cómo aceptar una nueva estructura de archivo.

La protección contra cambios de estructura evita que un archivo accidental o modificado del proveedor rompa perfiles de importación vinculados. Después de recibir correctamente un archivo de trabajo, Eofferix recuerda la estructura aceptada: columnas, nodos XML/JSON, atributos u otros elementos usados en la configuración.

En la siguiente actualización, la fuente compara la nueva estructura con la aceptada. Este bloque no muestra al usuario todo el archivo grande; comprueba una vista compacta de la estructura, suficiente para entender qué cambió.

Dónde configurar la protección

Abre la tarjeta de la fuente después de que el archivo de trabajo ya se haya recibido. El bloque Protección contra cambios de estructura aparece en la configuración y contiene dos parámetros: modo de control y si importa el orden de columnas o nodos.

Ajustes de protección contra cambios de estructura en Eofferix
El modo de control define si el archivo se bloquea o solo se muestra una advertencia.

Qué significan los modos

  • Firma estricta - el nuevo archivo no se acepta automáticamente si la estructura es distinta. Eofferix muestra una advertencia, compara la estructura anterior y la nueva del documento y espera una confirmación manual de la nueva estructura. Úsalo para fuentes críticas donde un cambio de columnas o nodos puede dañar la importación.
Animación de aceptación de una nueva estructura de fuente en Eofferix
Con la comprobación estricta se pueden abrir las diferencias, comparar la estructura anterior y la nueva, y aceptar la nueva estructura manualmente.
  • Solo campos y columnas - se comprueba el conjunto de elementos estructurales sin tener en cuenta el orden. En tablas son hojas y columnas; en XML, rutas de nodos y atributos; en JSON, claves. Sirve si el proveedor cambia el orden o la forma del archivo, pero conserva el sentido de los campos.
  • Solo advertir - el archivo se acepta, pero la tarjeta de la fuente conserva una advertencia. Úsalo cuando sea más importante no detener la actualización.
  • No comprobar - la protección se desactiva. Úsalo solo cuando los cambios de estructura no afectan al procesamiento posterior.

Orden de columnas y nodos

Tener en cuenta el orden de columnas y nodos determina si una reordenación se considera cambio de estructura. En CSV o XLSX, cuando la posición de columnas es importante para las reglas, deja activado el orden. Si el proveedor suele cambiar el orden, pero mantiene los nombres, elige que solo importe el conjunto: Eofferix compara el conjunto de campos, por lo que una reordenación de columnas con los mismos encabezados no detiene la fuente.

Qué ocurre cuando cambia la estructura

Si el modo seleccionado bloquea el nuevo archivo, Eofferix muestra una ventana con diferencias. Se ve qué estructura estaba aceptada antes, qué llegó ahora, qué campos o nodos desaparecieron y cuáles se añadieron. Hasta aceptar la nueva estructura, la fuente no reemplaza el archivo de trabajo por la versión arriesgada.

Ventana con diferencias de estructura de la fuente
Antes de aceptar la nueva estructura, se ven los campos eliminados y añadidos.

No aceptar todavía cierra la ventana sin cambiar la estructura aceptada. Aceptar nueva estructura convierte la nueva estructura en la de trabajo para futuras actualizaciones. Después conviene revisar los perfiles vinculados: si desaparecieron campos usados en snapshots o transformaciones, hay que actualizar las reglas.