Configuraciones Programadas
Una configuración programada le permite configurar un ajuste para que entre en vigor en una fecha y hora futura especificada.
Una vez que se alcance esa fecha y hora, la configuración programada se convierte en actual, reemplazando la configuración anterior.
Una configuración se considera programada cuando su activeFromDate es mayor que la fecha y hora actuales.
Creando una Configuración Programada
-
Si una configuración no existe ya, se puede crear una configuración programada utilizando:
POST/settings-objects/{settingType} -
Si existe una configuración actual y no hay una configuración programada, se puede crear una configuración programada utilizando:
PUT/settings-objects/{settingType}/{settingId}
El processingEntity El parámetro DEBE ser proporcionado en la solicitud, con la entidad de procesamiento propietaria de la configuración definida.
|
Actualizando una Configuración Programada
-
Una configuración programada existente puede ser actualizada utilizando:
PUT/settings-objects/scheduled-settings/{settingType}/{settingId} -
El número de versión permanece sin cambios al actualizar una configuración programada.
El processingEntity El parámetro DEBE ser proporcionado en la solicitud, con la entidad de procesamiento propietaria de la configuración definida.
|
Eliminando una Configuración Programada
-
Si una configuración programada ya no es necesaria, puede ser eliminada utilizando:
DELETE/settings-objects/scheduled-settings/{settingType}/{settingId}
El processingEntity El parámetro, si se proporciona en la solicitud, asegura que solo la Entidad de Procesamiento propietaria de la configuración pueda eliminar su propia configuración programada.
|
Recuperando una Configuración Programada
-
Si hay una configuración programada presente, podemos obtenerla utilizando:
GET/settings-objects/scheduled-settings/{settingType}/{settingId}
El processingEntity El parámetro, si se proporciona en la solicitud, asegura que únicamente la Entidad de Procesamiento propietaria de la configuración pueda obtener su propia configuración programada.
|
Consideraciones Importantes
-
Solo puede existir una configuración programada en un momento dado.
-
Si hay una configuración programada presente, no se permiten actualizaciones a la configuración actual. Para realizar un cambio inmediato en una configuración actual, ya sea:
-
Elimine la configuración programada utilizando:
DELETE/settings-objects/scheduled-settings/{settingType}/{settingId} -
O ajuste el
activeFromDatede la configuración programada a unos segundos o minutos después de la fecha y hora actuales a través de:PUT/settings-objects/{settingType}/scheduled-settings/{settingId}
-
-
Cuando activeToDate se añade a una configuración dinámica (y el cambio es aprobado si es necesario), la configuración dinámica dejará de ser considerada activa a partir de la fecha y hora especificadas en el atributo activeToDate. La configuración dinámica no puede ser buscada una vez que la fecha activeToDate ha sido alcanzada y no se aplicará a ninguna operación que consulte las colecciones de la base de datos de configuraciones dinámicas utilizando la clave única lógica correspondiente del registro.