Documentation for a newer release is available. View Latest

Configuraciones programadas

Una configuración programada permite configurar que una configuración entre en vigor en una fecha y hora futuras especificadas. Una vez que se alcanza esa fecha y hora, la configuración programada se convierte en la actual, reemplazando a la anterior. Una configuración se considera programada cuando su activeFromDate es mayor que la fecha y hora actuales.

Crear una configuración programada

Si aún no existe una configuración, se puede crear una configuración programada usando:
```
POST/settings-objects/{settingType}
```
Si existe una configuración actual y no existe una configuración programada, se puede crear una configuración programada usando:
```
PUT/settings-objects/{settingType}/{settingId}
```

Actualizar una configuración programada

Una configuración programada existente puede actualizarse usando:
```
PUT/settings-objects/scheduled-settings/{settingType}/{settingId}
```
El número de versión no cambia al actualizar una configuración programada.

Eliminar una configuración programada

Si una configuración programada ya no es necesaria, puede eliminarse usando:
```
DELETE/settings-objects/scheduled-settings/{settingType}/{settingId}
```

Consideraciones importantes

Solo puede existir una configuración programada en un momento dado.
Si existe una configuración programada, 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 usando:
  DELETE/settings-objects/scheduled-settings/{settingType}/{settingId}
- O ajuste el activeFromDate de la configuración programada a unos segundos o minutos después de la fecha y hora actuales mediante:
  PUT/settings-objects/{settingType}/scheduled-settings/{settingId}
Cuando se agrega activeToDate a una configuración dinámica (y el cambio se aprueba si es necesario), la configuración dinámica dejará de considerarse activa a partir de la fecha y hora especificadas en el atributo activeToDate. La configuración dinámica no podrá buscarse después de que se alcance el activeToDate y no aplicará a ninguna operación que consulte las colecciones de la base de datos de configuraciones dinámicas usando la correspondiente clave lógica única del registro.