Consulta: <form>, <table> y SQL

Estos elementos describen la consulta: qué tabla es la base, con qué se une, cómo se agrupa y ordena, y qué filtros ve el usuario. El motor arma el SQL a partir de esta declaración.

`<form>`

Contenedor del modelo de edición/visualización (<form> o alias español <consulta>). Define la tabla base, joins, parámetros, y opcionalmente un bloque PDF custom.

Va dentro de: <abm> (0..n), <histrix> (0..n)
Atributos: 8 (propios)

Contenido

Elemento	Veces	Descripción
`<pdf>`	0..n	Impresión PDF con código embebido: `<header>`, `<code>` y `<footer>` se ejecutan como código PHP con la variable `$pdf` disponible, que apunta al…
`<join>`	0..n	JOIN a otra tabla. El motor genera el SQL del JOIN a partir de los `<field>` con `<condicion>`.
`<table>`	0..n	Tabla adicional declarada al nivel del `<form>`/`<consulta>`.
`<tabla>`	0..n	Alias español de `<table>` a este nivel, con el mismo comportamiento: si se declara más de una, sobrevive únicamente la última.
`<tempTable>`	0..n	Tabla temporal que alimenta el grid (flujos de importación).

Atributos

`detailText`

texto · opcional

Texto que ocupa el panel de detalle mientras no se eligió ninguna fila (el “Seleccione una fila…”). Sólo aplica al detalle en panel, no al inline, y si se omite se usa el texto traducido por defecto.

`detalle`

texto · opcional

Nombre del XML hijo que se abre como popup al hacer click en una fila (vista de detalle).

`dir`

texto · opcional

Directorio del XML referenciado por detalle (relativo al módulo).

`hasDetail`

texto · opcional

Campo cuyo valor determina si la fila tiene detalle disponible (icono “+”).

`inline`

BoolEstricto · opcional · default false

Muestra el detalle expandido bajo la fila en lugar de en un popup. Cualquier valor no vacío lo activa, incluido "false": para que el detalle salga en popup hay que omitir el atributo. El default="false" declarado acá es engañoso — inline="false" no apaga nada, lo prende.

`multipleSelection`

BoolPresencia · opcional

Agrega la columna de checkboxes para seleccionar varias filas. multipleSelection="false" no lo apaga: unas partes del render exigen el literal "true" y otras se conforman con que el atributo tenga cualquier valor, así que con "false" la selección múltiple queda a medio armar. Para desactivarla hay que omitir el atributo.

`showCab`

BoolEstricto · opcional · default false

Muestra arriba del detalle la cabecera de lo consultado (el form en modo lectura). Escrito acá no funciona: el motor lo renombra al transferirlo al contenedor y la propiedad resultante no la lee nadie. Hoy el único lugar donde surte efecto es el <histrix>, con showCab="true". Es un defecto del motor, no del schema.

`single`

BoolEstricto · opcional

Con "true", y sólo cuando hay detalle + inline, agrega la clase CSS single a la celda del detalle inline. No hace nada más: no es “registro único”, no toca la paginación ni la navegación entre filas, y hoy ni el JS ni el CSS del proyecto consumen esa clase.

`<consulta>`

Contenedor del modelo de edición/visualización (<form> o alias español <consulta>). Define la tabla base, joins, parámetros, y opcionalmente un bloque PDF custom.

Va dentro de: <abm> (0..n), <histrix> (0..n)
Atributos: 8 (propios)

Acepta los mismos 8 atributos y los mismos elementos hijos que <form>, que es donde están documentados.

`<table>`

Tabla adicional declarada al nivel del <form>/<consulta>. No es un JOIN implícito: el motor arma un contenedor por cada <table> de este nivel y se queda sólo con el último, sin merge ni condición ON automática, así que la primera tabla queda pisada. Para relacionar tablas va <join>.

Va dentro de: <consulta> (0..n), <form> (0..n)
Atributos: 10 (propios)

Contenido

Elemento	Veces	Descripción
`<movimientos>`	0..n	Relaciones a otros XMLs que se procesan al grabar (cascada de inserts/updates).
`<ejecuta>`	0..n	SQL/PHP arbitrario a ejecutar. En `tipo="nosql"` Histrix reemplaza `'nombre_campo'` (entre comillas) por el valor del campo.
`<cierraproceso>`	0..n	XML hijo que se procesa al cerrar/grabar este. Con `processFirst="true"` el hijo se ejecuta antes que el padre.
`<validation>`	0..n	Validación previa a la grabación con `<condition>` + `<message>`: si la condición falla, se muestra el mensaje y se aborta.
`<validations>`	0..n	Validaciones por campo (`<field>` con `<expression>` + `<operator>` + `<message>`).
`<filters>`	0..n	Filtros adicionales (barra superior). Equivalente a `<filtros>`.
`<filtros>`	0..n	Alias español de `<filters>`, pero no del todo equivalente: el motor procesa primero `<filtros>` y después `<filters>`, y la segunda pasada…
`<preconsultas>`	0..n	No ejecuta SQL. Es una lista de otros XMLs que se consultan antes de la consulta principal y cuyas filas quedan disponibles para ésta.
`<importar>`	0..n	Popup hijo para alimentar el grid actual.
`<sql>`	0..n	SQL raw. Sólo se reemplaza `[__campo__]`.
`<field>`	0..n	Campo de formulario o columna de grid/consulta. Es el bloque fundamental: representa una columna SQL, un campo local (`local="true"`), un valor…
`<campo>`	0..n	Campo de formulario o columna de grid/consulta. Es el bloque fundamental: representa una columna SQL, un campo local (`local="true"`), un valor…
`<fieldGroup>`	0..n	Agrupador visual/lógico de campos. Se renderiza en el orden de aparición.
`<group>`	0..n	Campos por los que agrupar (genera `GROUP BY`). Requiere `tabla="X"` en cada `<field>` cuando la columna está en múltiples tablas del JOIN.
`<order>`	0..n	Orden de la consulta (genera `ORDER BY`).
`<orden>`	0..n	Alias español de `<order>`.
`<grafico>`	0..n	Gráfico asociado a la tabla (líneas/barras/torta).
`<status>`	0..n	Columna de un tablero `tipo="kanban"`: un valor del campo declarado en `statusField`.
`<select>`	0..n	SELECT crudo que reemplaza la consulta que el motor armaría con los `<field>`.
`<selectCode>`	0..n	Bloque de código PHP que llena la grilla a mano, en lugar del SELECT que armaría el XML: se ejecuta al cargar los datos y tiene que dejar armado un…
`<onRowClick>`	0..n	JS a ejecutar al hacer clic en una fila de la grilla.
`<helper>`	0..n	Helper de importación a nivel de tabla (`type="import"`): define de dónde se traen renglones para llenar la grilla.

Atributos

`ajusteDebe`

texto · opcional

id del campo donde se imputa el ajuste al Debe. El valor se transfiere al contenedor, pero hoy ningún consumidor del motor lo lee: escribirlo no cambia nada.

`ajusteHaber`

texto · opcional

id del campo donde se imputa el ajuste al Haber. El valor se transfiere al contenedor, pero hoy ningún consumidor del motor lo lee: escribirlo no cambia nada.

`as`

texto · opcional

Alias SQL de la tabla base. Necesario cuando la misma tabla entra más de una vez en la consulta (por ejemplo un JOIN a sí misma) para poder calificar las columnas sin ambigüedad.

`CondExp`

texto · opcional

Condición de grabación por expresión, complemento de idCampoCond y no un reemplazo: el motor toma el último valor grabado del campo nombrado en idCampoCond (o 0 si viene vacío), le pega este texto a la derecha y evalúa el resultado como expresión PHP; si da falso, la fila no se graba. O sea que acá va sólo el operador y el término derecho — por ejemplo > 0 o == 5. Estando presente, reemplaza la evaluación truthy simple de idCampoCond.

`id`

texto · obligatorio

Nombre de la tabla SQL base.

`idCampoCant`

texto · opcional

id de un campo cuyo valor es la cantidad de veces que se repite la grabación de la fila: con idCampoCant="cant" y cant=3, el movimiento inserta tres registros iguales en lugar de uno. Vacío o ausente equivale a 1, y si el campo contiene una grilla embebida se usa la cantidad de filas de esa grilla. No valida nada: no tiene relación con rechazar cantidades en cero.

`idCampoCond`

texto · opcional

id del campo que habilita la grabación de la fila: si su valor es falsy, el INSERT/UPDATE de esa fila no se ejecuta. Cuentan como falsy el vacío (o sólo espacios), 0, '0', 0.00, '0.00', false y 'false'; cualquier otra cosa graba, incluido el literal "true". Va en el <table>: escrito en el <form>/<consulta> se descarta en silencio (30 XMLs del repo lo tienen ahí y no hace nada).

`label`

texto · opcional

Etiqueta legible de la tabla. En la práctica no se ve en ninguna parte: el motor la toma como título inicial del contenedor y unas líneas después la pisa siempre con el título declarado en el <histrix> — y si el <histrix> no trae título, la pisa con vacío. Ni la pestaña, ni el PDF, ni el nombre del archivo exportado la usan, aunque hay cientos de XMLs que la escriben. El título va en el <title>/<titulo> del <histrix>.

`showCantidad`

BoolEstricto · opcional

Muestra la cantidad de renglones de la grilla. Ojo con la grafía: es exactamente showCantidad — showCant y showcantidad no se leen.

`style`

texto · opcional

CSS inline que se emite como atributo style de la <table> HTML de la grilla, tanto en la vista web como en la mobile. Ojo que reemplaza el default del motor, que es float:left;clear:left;: si sólo querés agregar una regla conviene repetir esas dos, porque al pisarlas cambia el layout de la grilla. Y styleTbody —que este mismo XSD recomendaba antes para el <tbody>— no existe en ninguna forma: los 265 usos del repo no hacen nada.

`<tabla>`

Tabla SQL fuente de datos (<table> o alias español <tabla>). Contiene los campos del form, opcionalmente grupos, orden, filtros, validaciones, movimientos, cierraproceso. El id es el nombre de la tabla en la BD.

Va dentro de: <consulta> (0..n), <form> (0..n)
Atributos: 10 (propios)

Acepta los mismos 10 atributos y los mismos elementos hijos que <table>, que es donde están documentados.

`<join>`

Relación con otra tabla (JOIN SQL). Soporta también JOIN a <subquery> cuando la tabla joineada es derivada (<subquery as="ALIAS"><sql>SELECT ...</sql></subquery>).

Un <if> dentro del <join> no se lee: el join se aplica siempre. Para condicionarlo está grupo.

Va dentro de: <consulta> (0..n), <form> (0..n)
Atributos: 2 (propios)

Contenido

Elemento	Veces	Descripción
`<tabla>`	0..n	Tabla joineada (alias español). Un `<join>` puede contener múltiples tablas joineadas en cadena.
`<table>`	0..n	Tabla joineada (alias inglés).
`<subquery>`	0..n	JOIN a un subquery (tabla derivada). Requiere atributo `as`.

Atributos

`grupo`

texto · opcional

Grupo lógico del join (usado para identificar conjuntos de joins relacionados).

`tipo`

JoinTipo · opcional

Tipo de JOIN: left | right | inner | full (case-insensitive).

`<subquery>`

Subquery aliasada usada como tabla joineada. Estructura: <subquery as="ALIAS"><sql>SELECT ...</sql><field .../>...</subquery>. El SQL dentro de <sql> soporta '[__campo__]' para valores de campos del padre.

Va dentro de: <join> (0..n)
Atributos: 1 (propios)

Contenido

Elemento	Veces	Descripción
`<sql>`	0..1	SQL del subquery. Acepta `'[__campo__]'` para parámetros.
`<field>`	0..n	Campos del subquery con sus condiciones ON.
`<campo>`	0..n	Alias español de `<field>`.

Atributos

`as`

texto · obligatorio

Alias SQL obligatorio del subquery.

`<sql>`

SQL del subquery. Acepta '[__campo__]' para parámetros.

Va dentro de: <subquery> (0..1), <tabla> (0..n), <table> (0..n)
Contenido: texto libre.

No acepta atributos.

`<group>`

Campos por los cuales agrupar el SQL (GROUP BY). Los campos con <expression> que usan funciones de agregación (SUM/COUNT/MAX) quedan fuera del GROUP BY automáticamente. Va dentro de la <table>/<tabla>: dentro de un <fieldGroup> no se lee y el GROUP BY no se aplica.

Va dentro de: <ayuda> (0..n), <ayuda_ex> (0..n), <helper> (0..n), <tabla> (0..n), <tabla_ex> (0..n), <table> (0..n)

Contenido

Elemento	Veces	Descripción
`<field>`	0..n	Campo de agrupación. Requiere `tabla="X"` si la columna está en múltiples tablas del JOIN.
`<campo>`	0..n	Alias español de `<field>`.
`<if>`	0..n	Condición de procesamiento del bloque entero: texto PHP que decide si el `GROUP BY` se aplica o no.

No acepta atributos.

`<order>`

Definición de orden de la consulta (ORDER BY). Cada <field> declara una columna y su dirección. Va dentro de la <table>/<tabla>: colgado directo del <form>/<consulta> o de un <fieldGroup> no se lee y el ORDER BY no se aplica.

Va dentro de: <ayuda> (0..n), <ayuda_ex> (0..n), <helper> (0..n), <tabla> (0..n), <tabla_ex> (0..n), <table> (0..n)
Atributos: 1 (propios)

Contenido

Elemento	Veces	Descripción
`<if>`	0..1	Orden condicional: aplica el `<field>` que esté dentro de la rama true/false según la expresión.
`<field>`	0..n	Campo por el que ordenar. Si tiene `<expression>`, se ordena por esa expresión SQL.
`<campo>`	0..n	Alias español de `<field>`: el motor lo toma como fallback cuando el bloque de orden no tiene ningún `<field>`.

Atributos

`ordenaTemporal`

BoolEstricto · opcional

Aplica el orden sobre la tabla temporal del grid en lugar de sobre la consulta original. Es lo que hace que un grid de carga respete el orden declarado en vez de mostrar los renglones en el orden en que se fueron cargando.

Cuidado si hay más de un bloque de orden en la misma tabla: el valor se asigna al procesar cada bloque, así que gana el último y puede apagar el de un bloque anterior.

`<orden>`

Alias español de <order>, pero sólo funciona en <tabla_ex> y <ayuda_ex>. Dentro de un <helper> es inerte: ahí el motor busca únicamente <order> y no tiene fallback al español. Los 11 combos del repo que lo usan caen al orden por defecto (por el 2º campo del combo) y el síntoma es “el combo sale desordenado”. En un <helper> usar <order>.

Va dentro de: <ayuda> (0..n), <ayuda_ex> (0..n), <helper> (0..n), <tabla> (0..n), <tabla_ex> (0..n), <table> (0..n)
Atributos: 1 (propios)

Acepta los mismos 1 atributos y los mismos elementos hijos que <order>, que es donde están documentados.

`<filters>`

Filtros adicionales mostrados en la barra superior del listado. Recordar: un filtro debe declararse en <filters> Y como <field> (puede ser oculto="true").

Sólo se leen los <field>/<campo> hijos: un <label> o un <tabla_ex> colgado directo del bloque no genera ningún filtro. Y si en la misma tabla se escriben los dos tags, <filters> y <filtros>, la segunda lectura resetea el auto de la primera.

Va dentro de: <tabla> (0..n), <table> (0..n)
Atributos: 1 (propios)

Contenido

Elemento	Veces	Descripción
`<field>`	0..n	Campo de filtro (cada uno genera un input en la barra de filtros).
`<campo>`	0..n	Alias español de `<field>`: el motor lee las dos grafías como filtro.
`<if>`	0..n	Condición de procesamiento del bloque entero: es texto PHP que se evalúa antes de leer los filtros y, si da falso, el bloque no se procesa.

Atributos

`auto`

BoolEstricto · opcional

Con auto="true" los filtros se aplican solos al cambiar cualquier valor, sin botón “filtrar”. La comparación es estricta contra el texto true: 1 no sirve.

`<filtros>`

Filtros adicionales mostrados en la barra superior del listado. Recordar: un filtro debe declararse en <filters> Y como <field> (puede ser oculto="true").

Va dentro de: <tabla> (0..n), <table> (0..n)
Atributos: 1 (propios)

Acepta los mismos 1 atributos y los mismos elementos hijos que <filters>, que es donde están documentados.

`<condicion>`

Condición SQL de un campo: operador + valor literal/expresión. Va al WHERE.

El ruteo al HAVING lo decide el atributo having del <expression> del campo (o del propio <field>): escrito acá, sobre la <condicion>, no se lee — hay 7 XMLs con <condicion having="true"> que no hacen nada. En <helper> de combo, las condiciones se aplican al SELECT del combo (NO soportan '[__campo__]' — usar <actualiza> para combo dinámico).

Este mismo tipo se usa para la <condition> de un <validation>, que no es SQL sino una expresión JavaScript evaluada en el browser: ahí ni operador ni valorde se leen.

Va dentro de: <campo> (0..n), <field> (0..n)
Contenido: texto libre.
Atributos: 4 (propios)

Atributos

`fixed`

BoolEstricto · opcional

Hace la condición inmune al botón de limpiar filtros: cuando el usuario resetea la barra de filtros, las condiciones normales se van y ésta queda. Sirve para las restricciones que son parte de la definición de la pantalla (una empresa, un estado, un tipo de comprobante) y que el usuario no debería poder sacar.

`logic`

texto · opcional

Cómo se encadena esta condición con las anteriores del mismo campo. Por defecto todas se suman con AND; con logic="OR" esta condición se une con OR a la de arriba. Es la única forma declarativa de armar un (a = 1 OR a = 2) sin escribir el SQL a mano.

`operador`

OperadorCondicion · opcional · default =

Operador SQL: =, !=, <, >, <=, >=, like, in, between, is null, etc. Opcional: si se omite, el motor asume = (normaliza el operador vacío), por lo que omitirlo y escribir operador="=" son equivalentes.

`valorde`

texto · opcional

Toma el valor de otro campo del mismo form (id). Útil en JOINs y filtros dinámicos.

`<condition>`

Condición SQL de un campo: operador + valor literal/expresión. Va al WHERE.

Este mismo tipo se usa para la <condition> de un <validation>, que no es SQL sino una expresión JavaScript evaluada en el browser: ahí ni operador ni valorde se leen.

Va dentro de: <campo> (0..n), <field> (0..n), <validation> (1)
Contenido: texto libre.
Atributos: 4 (propios)

Acepta los mismos 4 atributos que <condicion>, que es donde están documentados.

`<operador>`

Operador de la condición de filtro/JOIN del campo (=, !=, like, in, between, etc.). Acepta atributos modificador (modifica el valor antes de comparar) y oplogico (and/or para concatenar con el siguiente filtro).

Va dentro de: <campo> (0..n), <field> (0..n)
Contenido: texto, de tipo OperadorCondicion
Atributos: 2 (propios)

Atributos

`modificador`

texto · opcional

Modificador del operador: transforma el valor antes de comparar (ej. UPPER, LOWER, DATE).

`oplogico`

texto · opcional

Operador lógico para concatenar con el siguiente filtro: “and” (default) | “or”.

`<operator>`

Elemento <operador> (o alias <operator>) dentro de <field>. Contenido = operador SQL (OperadorCondicion); atributos opcionales modificador y oplogico para refinar el comportamiento del filtro.

Va dentro de: <campo> (0..n), <field> (0..n)
Contenido: texto, de tipo OperadorCondicion
Atributos: 2 (propios)

Acepta los mismos 2 atributos que <operador>, que es donde están documentados.

`<preconsultas>`

Bloque de pre-consultas/validaciones ejecutadas antes de la consulta principal.

La forma canónica es <xmlfile id="mi_consulta"/> (69 usos en el repo): cada uno nombra otro XML que se ejecuta antes, y sus resultados quedan disponibles para la consulta de esta pantalla. Se usa para preparar datos —llenar una tabla temporal, recalcular un saldo— sin meter ese SQL en la consulta principal.

El contenido está declarado permisivo a propósito, así que acá el schema no valida nada: un tag mal escrito adentro de este bloque no da error y simplemente no hace nada.

Va dentro de: <tabla> (0..n), <table> (0..n)
Contenido: texto libre.

No acepta atributos.

`<tempTable>`

Definición de tabla temporal usada como fuente del grid (típicamente en flujos de importación).

La forma canónica es una lista de <row>, cada uno con los <field> de un renglón (315 usos en el repo): con eso se precarga el grid con renglones fijos sin que exista una tabla real detrás. También se acepta SQL de creación de la temporal.

El contenido está declarado permisivo a propósito, así que acá el schema no valida nada: un tag mal escrito adentro de este bloque no da error y simplemente no hace nada.

Va dentro de: <consulta> (0..n), <form> (0..n)
Contenido: texto libre.
Atributos: 1 (propios)

Acepta los mismos 1 atributos que <field>, que es donde están documentados.

`<code>`

Código del cuerpo del PDF, se ejecuta una vez al imprimir el contenedor.

Va dentro de: <pdf> (0..1)
Contenido: texto libre.

No acepta atributos.

`<footer>`

Código que se ejecuta al dibujar cada pie de página.

Va dentro de: <pdf> (0..1)
Contenido: texto libre.

No acepta atributos.

`<header>`

Código que se ejecuta al dibujar cada cabecera de página.

Va dentro de: <pdf> (0..1)
Contenido: texto libre.

No acepta atributos.

`<onRowClick>`

JS a ejecutar al hacer clic en una fila de la grilla.

Va dentro de: <tabla> (0..n), <table> (0..n)
Contenido: texto libre.

No acepta atributos.

`<pdf>`

Impresión PDF con código embebido: <header>, <code> y <footer> se ejecutan como código PHP con la variable $pdf disponible, que apunta al objeto que dibuja el PDF — de ahí salen los métodos que se pueden llamar (Cell, MultiCell, Image, SetFont, SetXY…).

Los atributos de este tag se descartan: PDForientacion / PDForientation escritos acá no hacen nada (146 XMLs del repo lo intentan) — la orientación va en el <histrix>. Y el bloque tiene que colgar del <form>/<consulta>: un <code> suelto dentro de <table> no se lee.

Va dentro de: <consulta> (0..n), <form> (0..n)

Contenido

Elemento	Veces	Descripción
`<header>`	0..1	Código que se ejecuta al dibujar cada cabecera de página.
`<code>`	0..1	Código del cuerpo del PDF, se ejecuta una vez al imprimir el contenedor.
`<footer>`	0..1	Código que se ejecuta al dibujar cada pie de página.

No acepta atributos.

`<select>`

SELECT crudo que reemplaza la consulta que el motor armaría con los <field>.

Va dentro de: <tabla> (0..n), <table> (0..n)
Contenido: texto libre.

No acepta atributos.

`<selectCode>`

Bloque de código PHP que llena la grilla a mano, en lugar del SELECT que armaría el XML: se ejecuta al cargar los datos y tiene que dejar armado un arreglo con un elemento por renglón, y cada renglón como pares campo => valor. Si devuelve algo, ese contenido reemplaza por completo al resultado de la consulta.

Dos trampas: no corre si el contenedor tiene dataSource, que tiene prioridad; y si el código falla, la grilla queda vacía sin ningún aviso en pantalla — el error va al log.

Va dentro de: <tabla> (0..n), <table> (0..n)
Contenido: texto libre.

No acepta atributos.

`<status>`

Una columna del tablero tipo="kanban". Va como hijo directo de <table>, al lado de <filters> y <order>, y se declara una por cada valor del campo indicado en statusField que quiera verse. Las columnas se dibujan en el orden de aparición.

Las filas cuyo estado no coincide con ninguna columna declarada no desaparecen: van a una columna “Sin clasificar” al final (ver showOrphans y orphanLabel en <histrix>).

Va dentro de: <tabla> (0..n), <table> (0..n)
Contenido: texto libre.
Atributos: 7 (propios)

Atributos

`color`

texto · opcional

Color CSS de la columna: pinta la línea superior del encabezado y el borde izquierdo de sus tarjetas. Un campo con kanban="color" lo pisa por tarjeta.

`confirmDir`

texto · opcional

Directorio de confirmXml. Obligatorio cuando hay confirmXml: sin él el path no resuelve en varios contextos y el popup abre con “file not found” (la misma regla que el dir de los includes). Declararlo aunque apunte al directorio del propio XML.

`confirmTitle`

texto · opcional

Título del modal de confirmación. Si no está, se usa el label de la columna.

`confirmXml`

texto · opcional

XML que hay que completar para entrar a esta columna. Sin este atributo el movimiento se graba directo, como en el resto de las columnas.

Con él, el tablero no graba: al soltar la tarjeta abre este XML como modal pasándole la clave de la tarjeta y el estado destino —los <parameter> prellenan el form del lado del servidor, así que la pantalla abre con el estado nuevo ya puesto— y ese XML es el que graba. Puede ser un update simple o una ficha con <movimientos>, que es justamente lo que el UPDATE plano del campo no puede hacer.

Al cerrarse el modal el tablero recarga y acomoda cada tarjeta según el estado que tiene en la base: si se confirmó queda en la columna nueva, y si se canceló vuelve sola a donde estaba.

El endpoint del movimiento rechaza estas columnas con 400, así que la confirmación no se puede saltear pegándole a la API.

Es la forma de dar drag a un estado que es consecuencia de un proceso (presupuesto → facturado, orden pendiente → cumplida): en vez de pisar el campo, se dispara la pantalla que hace el trabajo completo.

`label`

texto · opcional

Título de la columna. Si no está, se muestra el value.

`limit`

entero · opcional

Límite de trabajo en curso (WIP). Es sólo visual: el contador pasa a mostrar usadas/limit y se pinta en alerta al pasarse, pero no impide mover tarjetas a la columna.

`value`

texto · obligatorio

Valor del campo statusField que cae en esta columna. Obligatorio, y no puede repetirse entre columnas: las dos cosas se reportan como error de configuración en pantalla. Es también el único destino válido de un drop — arrastrar a la columna de huérfanos se rechaza con 400.

`<table>` en `<join>`

Tabla referenciada en el JOIN. Puede ser una tabla real o un <subquery> aliasado.

Va dentro de: <join> (0..n)
Atributos: 2 (propios)

Contenido

Elemento	Veces	Descripción
`<field>`	1..n	Campos de la tabla joineada con sus condiciones ON.

Atributos

`as`

texto · opcional

Alias SQL de la tabla en el JOIN.

`id`

texto · obligatorio

Nombre de la tabla joineada.

`<tabla>` en `<join>`

Tabla joineada (alias español). Un <join> puede contener múltiples tablas joineadas en cadena.

Va dentro de: <join> (0..n)
Atributos: 2 (propios)

Acepta los mismos 2 atributos y los mismos elementos hijos que <table>, que es donde están documentados.

`<campo>` en `<orden>`

Alias español de <field>: el motor lo toma como fallback cuando el bloque de orden no tiene ningún <field>.

Va dentro de: <orden> (0..n), <order> (0..n)
Contenido: texto libre.
Atributos: 5 (propios)

Acepta los mismos 5 atributos que <field>, que es donde están documentados.

`<campo>` en `<subquery>`

Campo que define una condición ON del JOIN. La <condicion> con valorde="campo" referencia un campo de la tabla principal para armar el ON tabla_join.x = tabla_principal.y.

Va dentro de: <subquery> (0..n)
Atributos: 5 (propios)

Acepta los mismos 5 atributos y los mismos elementos hijos que <field>, que es donde están documentados.

`<field>` en `<orden>`

Campo por el que ordenar. Si tiene <expression>, se ordena por esa expresión SQL.

Va dentro de: <orden> (0..n), <order> (0..n)
Contenido: texto libre.
Atributos: 5 (propios)

Atributos

`id`

texto · obligatorio

id del campo por el que ordenar.

`orderType`

OrdenTipo · opcional

Dirección de orden (inglés). Coexiste con tipoOrden; el motor lee ambos.

`tabla`

texto · opcional

Tabla del campo (cuando ambiguo en JOINs).

`table`

texto · opcional

Alias inglés de tabla.

`tipoOrden`

OrdenTipo · opcional · default ASC

Dirección de orden. Alias inglés: orderType.

`<field>` en `<subquery>`

Campo que define una condición ON del JOIN. La <condicion> con valorde="campo" referencia un campo de la tabla principal para armar el ON tabla_join.x = tabla_principal.y.

Va dentro de: <subquery> (0..n), <tabla> (1..n), <table> (1..n)
Atributos: 5 (propios)

Contenido

Elemento	Veces	Descripción
`<condicion>`	0..n	Condición del JOIN (operador + valor o referencia a otro campo).
`<condition>`	0..n	Alias inglés de `<condicion>`.
`<expression>`	0..n	Expresión SQL alternativa para el campo del JOIN.
`<expresion>`	0..n	Alias español de `<expression>`.
`<label>`	0..n	Etiqueta del campo en pantalla (si se muestra).
`<tipo>`	0..n	Tipo del campo del JOIN.

Atributos

`alias`

texto · opcional

Alias SQL del campo.

`id`

texto · obligatorio

Nombre de la columna en la tabla del JOIN.

`noshow`

BoolEstricto · opcional

Alias inglés de oculto.

`oculto`

BoolEstricto · opcional

Si “true”, oculta el campo en pantalla.

`tabla`

texto · opcional

Tabla a la que pertenece el campo (cuando ambiguo).