Cómo exportar e importar la configuración de la organización¶
Tipo: guía (cómo hacer una tarea). Dirigida a: administradores.
Esta guía te lleva por dos tareas: exportar la configuración de tu organización a un archivo, e importar un archivo de configuración (por ejemplo, para dar de alta una organización nueva parecida a otra que ya funciona). Qué contiene el archivo y todas las reglas están en la referencia de Configuración de la organización.
Prerrequisitos¶
- Permiso Exportar configuración de organización (
exportar_configuracion_organizacion) o Importar configuración de organización (importar_configuracion_organizacion). - Ser administrador (rol con la marca de administrador). Además del permiso, la pantalla exige el rol de administrador: si no lo sos, solo ves el aviso "Solo un administrador puede exportar o importar la configuración de la organización". De fábrica solo ADMINISTRADOR tiene estas acciones.
Exportar¶
- Entrá a Configuración General > Configuración de Organización.
- En Exportar, tildá las secciones que querés copiar. Vienen tildadas Roles y permisos, Categorías de gasto, Uniformes (catálogo) y Features. Si tildás una sección que depende de otra, la otra se tilda sola y queda bloqueada con la leyenda "incluida porque elegiste ...".
- Si dejás Roles y permisos, decidí si querés Incluir la asignación de widgets de cada rol (viene tildada).
- Si elegiste Proveedores e insumos del local o Turnos del local, aparece la pregunta "¿De cuál los exportamos?": elegí el local de origen.
- Tocá Descargar configuración.
Resultado: se descarga un archivo .json. No puede pesar más de 5 MB; si te lo rechaza por tamaño, exportá menos secciones por vez.
Importar¶
- En Importar, tocá Elegir archivo JSON y elegí el archivo (un
.jsonde hasta 5 MB). - La pantalla lee el archivo y muestra "¿Qué secciones querés aplicar?" con las que trae. Destildá las que no quieras.
- Si el archivo trae proveedores o turnos, aparece "¿A qué local se aplican los proveedores y turnos?". Elegí uno o varios locales de tu organización.
- Si incluís roles, respondé "¿Qué rol queda como administrador?". Ese rol queda con acceso de administrador y a esta pantalla, diga lo que diga el archivo. Es una protección para no dejar la organización sin nadie que pueda administrarla.
- Si el rol elegido no tiene ningún usuario activo, la pantalla te pide "¿Quién va a tener el rol ...?": elegí al menos un usuario.
- Leé el resumen amarillo "Esta operación reemplaza configuración" y tocá Aplicar configuración.
Resultado: aparece el cartel verde "Configuración aplicada" con un resumen de lo aplicado. Si el archivo traía claves que este sistema no conoce (porque viene de una versión con más módulos), se omiten y un aviso amarillo las lista: el resto se aplicó igual.
Qué se pisa y qué no¶
| Qué | Cómo se trata |
|---|---|
| Roles que trae el archivo | Se reemplazan por completo sus permisos (y sus widgets, si el archivo los trae). Si el rol no existía, se crea. |
| Roles de tu organización que no están en el archivo | No se tocan. |
| Rol administrador | Queda como administrador el rol que elegiste. Ningún otro rol del archivo queda como administrador, diga lo que diga el archivo. Los roles que hoy son administradores y no están en el archivo siguen siéndolo. |
| Categorías, uniformes, catálogo, proveedores, turnos | Se agregan o actualizan por nombre. No se borra nada. |
| Stock de los insumos | No se toca. |
| Features | Las que trae el archivo se habilitan. Las que no menciona no se apagan. |
| Usuarios, locales, feriados, facturas, fichadas, cierres, SisNube y contraseñas | Nunca viajan en el archivo. |
Atención: reemplazar los permisos de un rol que ya se usa cambia lo que pueden hacer las personas que lo tienen. Antes de importar a una organización que ya funciona, exportá primero su propia configuración para poder volver atrás.
Problemas frecuentes¶
| Mensaje | Qué hacer |
|---|---|
| "El archivo debe tener extensión .json" | Elegiste otro tipo de archivo. |
| "El archivo supera el tamaño máximo de 5 MB" | Exportá menos secciones. |
| "El archivo no es un JSON de configuración válido" / "no trae ninguna sección de configuración" | Está dañado, vacío o no es de Hexalba. |
| Un mensaje con "propiedad desconocida" | El archivo viene de una versión más nueva: por seguridad se rechaza entero en lugar de aplicarlo a medias. |
| "Elegí el rol que queda como administrador" | Falta ese paso. |
| "Elegí a qué local o locales se aplican los proveedores y turnos" | Elegí el destino. |
| "Los locales destino son inválidos" | Un local elegido no pertenece a tu organización. |
| "Elegí de qué local salen los proveedores y turnos" | Al exportar, falta el local de origen. |
| "Solo un administrador puede importar la configuración" | Tu rol no es de administrador. |
| "Un nombre del archivo choca con algo que ya existe en esta organización" o "hay N filas llamadas ... que solo difieren en mayúsculas o espacios" | El catálogo o los proveedores del archivo chocan con datos ya existentes. Leé el detalle, unificá los nombres en tu organización o corregí el archivo. |
| "La operación generaría N filas ... Importá a menos locales por vez" | Elegiste demasiados locales destino a la vez. Repetí la importación en tandas. |
| "El rol ... puede asignar ..., que no existe en la organización" / "... es un rol protegido" | Una lista de roles asignables del archivo nombra un rol que no viene en el archivo ni existe en tu organización, o un rol protegido. No se aplica nada: corregí el archivo o creá antes ese rol. |
| "El archivo es de la versión N y este sistema acepta hasta la M" | El archivo salió de una versión más nueva de Hexalba. Pedile al operador que actualice la instalación. |
| "Demasiados intentos. Esperá N segundos." | Esperá antes de reintentar. |
| Un mensaje que empieza con el nombre de un rol, proveedor, insumo o turno y dice qué dato está mal (por ejemplo, 'Turno "Noche": … debe tener formato HH:mm') | Ese dato del archivo no tiene el formato esperado. El archivo se rechaza entero y no se aplica nada: corregí el archivo o volvé a exportarlo desde la organización de origen. |
| 'La sección "…" necesita también "…", que no está en el archivo' | El archivo trae una sección sin otra de la que depende. Volvé a exportar tildando las dos. |