Editar configuración de optimización
Actualiza una configuración activa del optimizador de reservas para una organización o una ubicación, ajustando nombre, descripción, estado predeterminado y parámetros sin romper la lectura histórica de servicios pasados.
En este artículo
Esta guía explica cómo editar una configuración existente del optimizador en Grupo Marea Demo o en Marea Gran Via, manteniendo el mismo identificador activo para los servicios futuros.
Cuando ya existen servicios pasados afectados, Antylogic conserva automáticamente una versión histórica con la configuración anterior para que esas lecturas sigan siendo coherentes.
Antes de empezar
- Sesión iniciada en Antylogic con Grupo Marea Demo seleccionado.
- Para editar en Marea Gran Via, la ubicación debe estar resuelta en el contexto de la sesión.
- Permiso `optimization:manage` en el ámbito desde el que se guardan los cambios; con `optimization:view` la pantalla puede abrirse, pero no permite guardar.
- Una configuración activa, no de sistema y editable dentro del mismo ámbito. En el runtime documental puede ser necesario crear una configuración temporal si Marea Gran Via no tiene una disponible.
Instrucciones
- 1.
Abre el listado del Optimizador
Desde Marea Gran Via, entra en Reservas y abre la pestaña Optimizador. Localiza la configuración por nombre, ámbito, marca de predeterminada y fecha de actualización. La acción Editar solo aparece para configuraciones del mismo ámbito, no de sistema y con permisos de gestión.
- 2.
Entra al formulario de edición
Abre una fila editable. El formulario carga el detalle y muestra Nombre, Descripción, Predeterminada y las secciones de parámetros del optimizador, como General, buffers, objetivo, riesgo, saturación, opcionales y alternativas.
- 3.
Ajusta los datos operativos
Modifica el nombre o la descripción para que el equipo identifique mejor la configuración. Cambia la marca Predeterminada si esa configuración debe ser la principal del ámbito y revisa los parámetros visibles del optimizador antes de guardar.
- 4.
Guarda la configuración
Pulsa Guardar. Antylogic envía `name`, `description`, `is_default` y `settings` al endpoint del ámbito correspondiente. El id efectivo sale de la URL, no de un campo editable, y el ámbito original de la configuración no cambia.
- 5.
Confirma el resultado
Tras un guardado correcto, la aplicación actualiza la lista y el detalle, muestra confirmación y vuelve al listado. Los servicios futuros usan la configuración activa actualizada; si había referencias pasadas, el backend crea una snapshot histórica automática.
Validaciones y límites
- Sin `selectedOrgId` o sin `selectedLocationId` en ámbito de ubicación, la pantalla no carga el listado de Marea Gran Via.
- No se puede editar una configuración de sistema ni una configuración heredada de organización desde la pantalla de ubicación.
- Guardar solo se habilita cuando hay cambios respecto al snapshot inicial del formulario.
- `name` se recorta y es obligatorio en frontend y backend; `description` se recorta y se persiste como nula si queda vacía.
- El formulario normaliza números, enteros, horas y listas opcionales antes de enviar `settings`, y conserva claves desconocidas al reconstruir el payload.
- El guardado de ubicación usa `PUT /api/app/{orgId}/{locationId}/optimization-configs/{configId}`; el de organización usa `PUT /api/app/{orgId}/optimization-configs/{configId}`.
- Si el recurso no existe, está borrado, es de sistema o pertenece a otro ámbito, el backend lo trata como no encontrado.
- El versionado histórico no tiene una confirmación visual específica: ocurre dentro de la transacción cuando hay servicios pasados o eventos recurrentes con pasado afectados.
Resultado esperado
La configuración activa conserva su id y queda actualizada para servicios futuros. Las lecturas históricas siguen usando la versión anterior cuando Antylogic detecta referencias pasadas afectadas.