Global structures
Las global structures son datos de configuración compartidos por todo el workspace que no son registros: la configuración fiscal de la empresa, una tabla de tasas, una lista de provincias. Las leen las automations (y los Logic Components) para tomar decisiones sin hardcodear valores. Necesitás el permiso manage_automations; viven en Configuración → Constructor de app → Global Structures.
Tres tipos
| Tipo | Qué almacena | Ejemplo |
|---|---|---|
| Object | Un único conjunto de campos (singleton). Siempre existe exactamente uno. | ”Configuración fiscal”: inicio del ejercicio, CUIT, condición de IVA |
| Record List | Una mini-tabla: N filas con las columnas que definas. Cada fila se puede activar/desactivar y ordenar. | ”Tasas de impuesto”: nombre, alícuota, vigente |
| Value List | Una lista plana de valores de texto. | ”Provincias”: Buenos Aires, Córdoba, Santa Fe… |
Crear una
- Configuración → Constructor de app → Global Structures → Nueva.
- Elegí el tipo. Name es la clave técnica (
tax_rates, no se cambia después); Label es el nombre visible. - Para Object y Record List, definí los campos/columnas (mismos tipos que los campos de una entidad: texto, número, fecha, picklist…). Value List no lleva schema.
- Guardá. Un Object y una Value List nacen con su único “entry” creado; una Record List nace vacía.
Editar los datos
Desde el detalle de la estructura:
- Object — un formulario con los campos; editás y guardás.
- Record List — una tabla con agregar / editar / eliminar filas inline, orden y activo/inactivo. Desactivar una fila la conserva pero la saca de uso.
- Value List — agregar, quitar y reordenar valores.
Ni el tipo ni el name se pueden cambiar después de crear la estructura; sí el label y el schema.
Usarlas desde automations
El nodo Get Global carga la estructura en una variable del flujo:
Qué queda en la variable depende del tipo: un Object entrega sus campos (taxes.iva), una Record List entrega una lista de filas (para recorrer con un Loop o filtrar), una Value List entrega una lista de textos. Ver Variables y referencias y Conditions y loops.
Desde un Logic Component también se pueden leer y actualizar (ctx.globals); ver Logic Components.
Ejemplos de uso
- Configuración de empresa (Object): razón social, domicilio fiscal, CUIT — para armar PDFs y emails.
- Tasas impositivas (Record List): provincia, IVA, IIBB — para calcular totales en una automation.
- Monedas aceptadas (Value List): ARS, USD, EUR — para validar un dato que llega por webhook. (La moneda de los registros se configura aparte: Monedas.)
- Umbrales de aprobación (Object): descuento máximo sin aprobación, monto que requiere gerente.