Soporte Opertek

Descripción del problema

Al crear un lote en la Aplicación Client, aparece un error en pantalla

BatchClient - FAIL
AREA MODEL CHANGED: AREAGUID:033C798274C545F188789F619355E9DA, 
AREAVERSION:306 RECIPEAREAVERSION:305

Para poder crear el lote de esa receta, hay que ir al recipe editor y darle a Rebuild recipe directory y seguidamente decirle a todo que sí. El problema es que haciendo esto, el sistema modifica TODAS las fechas de las recetas.

Explicación de qué ocurre

¿Por qué aparece el error “AREA MODEL CHANGED”?

Cada receta en Proficy está vinculada al Area Model mediante dos identificadores:

• AREAGUID → Identificador único del área.
• AREAVERSION → Número de versión del área en el momento en que la receta fue compilada.

Cuando se crea un lote, el sistema compara la versión del área actual (AREAVERSION) con la versión registrada en la receta (RECIPEAREAVERSION). Si no coinciden, el sistema bloquea la creación del lote porque podría haber cambios en equipos, fases o propiedades que afecten la ejecución segura del batch.

Esto está documentado en el Recipe Development Manual y el System Configuration Manual:

"Batch Execution validates that the recipe’s area model version matches the current area model version to ensure consistency of equipment bindings and phase logic.

La discrepancia podría venir porque se ha modificado o importado un nuevo Modelo de Área (Equipo).
El sistema detecta una inconsistencia entre la versión del modelo guardada en la receta y el modelo actual del sistema.

Causa Raíz

• Desajuste de GUID/Versión: 
  Por diseño, cualquier cambio en el Modelo de Equipo invalida la verificación de las recetas existentes.
• Seguridad y Cumplimiento: 
  El sistema bloquea la ejecución para evitar inconsistencias operativas, especialmente crítico en entornos regulados (GMP/Farma).
• Falta de Re-verificación: 
  Las recetas antiguas conservan metadatos del modelo anterior que ya no coinciden con el nuevo.

¿Por qué “Rebuild Recipe Directory” resuelve el error?

La opción Rebuild Recipe Directory recompila todas las recetas para que:

• Se actualicen al AREAVERSION actual.
• Se regeneren las referencias internas (incluyendo GUID y dependencias).

Esto es necesario porque el sistema no permite ejecutar recetas con un área desincronizada.

¿Por qué se cambian TODAS las fechas aunque no se editen las recetas?

Aquí está la clave:

• El proceso de Rebuild no distingue entre recetas modificadas y no modificadas.
• Al reconstruir el directorio, Batch Execution vuelve a generar los metadatos de cada receta, incluyendo: 
  • Fecha de compilación.
  • Usuario que ejecutó la acción.
  • Versión del área asociada.

Esto ocurre porque el sistema considera que cualquier cambio en el Area Model puede afectar la lógica de ejecución, incluso si la receta no cambió. Por eso, la fecha que ves en SQL refleja la última vez que la receta fue “validada” para producción, no necesariamente editada.

En el Recipe Development Manual se indica:

When rebuilding the recipe directory, all recipes are recompiled to synchronize with the current area model. This process updates administrative fields such as issue date and version control.

Solución recomendada 

La mejor solución: arreglar la receta que falla sin tocar las demás

Para resolver el fallo, es necesario actualizar el vínculo entre la receta y el modelo:

1. Abrir el Batch Recipe Editor.
2. Cargar cada una de las recetas afectadas.
3. Hacer clic en Verify (Verificar).
4. Si la verificación es exitosa, hacer clic en Save (Guardar).
5. Intentar ejecutar el lote nuevamente en el Batch Client.

Mejores Prácticas (Entornos GMP)

Las siguientes recomendaciones ayudarán a evitar este tipo de problemas y a hacer una mejor gestión del sistema:

• No bypass: 
  Evitar exportar/importar repetidamente para "limpiar" el error; la vía oficial es la verificación manual.
• Control de Cambios: 
  Re-verificar obligatoriamente todas las recetas después de cualquier cambio en el modelo de equipos.
• Estado del Sistema: 
  No modificar el Modelo de Área mientras haya lotes en ejecución, ya que puede impedir reinicios en caliente (warm restarts).

Verificación/guardado de recetas, tras cambios en Area Model o versión de Batch:

Cambios en el Area Model:

1. Regla de oro: 
   Solo se debe modificar el Area Model cuando todos los lotes (batches) en ejecución hayan terminado y hayan sido eliminados.
2. Verificación obligatoria: 
   Las recetas guardan internamente la versión del Area Model con la que fueron verificadas por última vez. Si el modelo actual es distinto al de la receta, debes verificar y guardar las recetas nuevamente.
3. Riesgos: 
   Si hay discrepancias, la receta podría no ejecutarse correctamente, provocando caídas del servidor de Batch o problemas de seguridad.

Opción "Recipe Verification Required"

Esta opción está activada por defecto para garantizar la compatibilidad.

Se puede desactivar, lo que permite programar lotes sin verificar/guardar, pero GE no lo recomienda. 

Si se desactiva el "Recipe Verification Required", cosa que GE no recomienda, 
el Cliente asume toda la responsabilidad por fallos o resultados adversos

Referencias a la documentación online de Proficy Batch