Ir al contenido

Esquema, borrador y versiones

El esquema es la definición de todas las colecciones (campos, reglas, vistas, automatizaciones, flujos, sitios) en un manifiesto JSON heskala.collections. Los cambios grandes se hacen en un borrador («Desarrollo») y se aplican a producción con un despliegue. Cada despliegue queda como una versión.

  1. Ve a «Configuración → Colecciones → Esquema» para ver las colecciones en un lienzo.
  2. Cambia a Desarrollo: se crea una copia de producción que puedes editar sin afectar a nadie.
  3. Abre «Desarrollo y versiones» para editar el JSON, probar, ver el plan y desplegar.
  4. En el historial puedes cargar una versión anterior en el borrador y desplegarla de nuevo.
  5. Para exportar un grupo de colecciones como app: «Configuración → Colecciones» → «Exportar como app».
  • Solo un administrador despliega.
  • El despliegue se aplica en una sola transacción y queda como versión nueva. No borra datos ni cambia tipos de campo.
  • Hay un solo borrador por empresa: si otra persona tiene uno abierto, no lo pises.
  • El archivo que importas no puede pasar de 1 MB.

Orden recomendado:

  1. get_schema_draft (o start_schema_draft si no hay).
  2. patch_schema_draft con todas las operaciones juntas. Evita save_schema_draft: reescribe el manifiesto completo.
  3. plan_schema_draft: revisa los riesgos y cuéntaselos a la persona.
  4. deploy_schema_draft solo con su confirmación.

Otras: discard_schema_draft, list_schema_versions, restore_schema_version (carga una versión en el borrador) y export_schema.