Ir al contenido
Documentación de Histrix

Índice de elementos

El schema declara 120 elementos. Esta página los presenta de dos formas: el árbol de anidamiento, para ver dónde va cada uno, y la tabla completa en orden alfabético.

Árbol de anidamiento

Sección titulada «Árbol de anidamiento»

Cada elemento se desarrolla en el nivel más alto donde puede aparecer, y una sola vez: donde vuelve a estar admitido queda como enlace a ese desarrollo. Los tags que el schema declara como equivalentes —<field> y <campo>, <table> y <tabla>— aparecen los dos, porque los dos son válidos.

Todos los elementos

Sección titulada «Todos los elementos»
Elemento Va dentro de Atributos Qué es
<abm> raíz del documento 172 Raíz del documento. Atributo “tipo” identifica el modo del documento (p.ej., “consulta”).
<actualiza> <campo>, <field> — Al cambiar el campo padre, propaga su valor a otros campos/combos/grilla/helpers.
<alto> <grafico> — Alto del gráfico. A diferencia de <ancho>, este sí se aplica: es la única forma de que un gráfico no salga con el…
<ancho> <grafico> — No hace nada: es código muerto. Se lee del XML pero nadie lo usa para dimensionar el gráfico, que siempre toma el…
<attribute> <campo>, <field> 1 No inyecta HTML: hace condicional un atributo de Histrix según el valor de otra columna. El id es el nombre del…
<ayuda> <campo>, <field> 24 Helper UI asociado a un campo. Tipos (type): - “combo”: dropdown alimentado por SQL (1er field = VALUE, 2do field =…
<ayuda_ex> <campo>, <field> 24 Helper UI asociado a un campo. Tipos (type): - “combo”: dropdown alimentado por SQL (1er field = VALUE, 2do field =…
<campo> <ayuda>, <ayuda_ex>, <fieldGroup> y 9 más 218 Campo de formulario o columna de grid/consulta. Es el bloque fundamental: representa una columna SQL, un campo local…
<campo> en <actualiza> <actualiza> 3 Alias español de <field> como destino de la actualización.
<campo> en <orden> <orden>, <order> 5 Alias español de <field>: el motor lo toma como fallback cuando el bloque de orden no tiene ningún <field>.
<campo> en <subquery> <subquery> 5 Campo que define una condición ON del JOIN. La <condicion> con valorde="campo" referencia un campo de la tabla…
<checklabel> <campo>, <field> — Etiqueta que acompaña al checkbox, a la derecha del control.
<cierraproceso> <fieldGroup>, <include>, <tabla> y 1 más 3 Cierre de proceso: ejecuta otro XML como parte de la grabación del actual.
<clave> <ayuda>, <ayuda_ex>, <helper> y 1 más — Campo que aporta la clave de la ayuda. Sólo se lee dentro de <ayuda_ex>, una de las formas legacy que comparten…
<code> <pdf> — Código del cuerpo del PDF, se ejecuta una vez al imprimir el contenedor.
<column> <serie> — Columna que aporta datos a esta serie.
<complete> <campo>, <field> — Expresión que el motor evalúa al completarse el campo. Ej: <complete>numero + 1</complete>.
<condicion> <campo>, <field> 4 Condición SQL de un campo: operador + valor literal/expresión.
<condition> <campo>, <field>, <validation> 4 Condición SQL de un campo: operador + valor literal/expresión.
<conditionalDisplay> <campo>, <field> — No es una expresión: es el id de otro campo. Si el valor de ese campo es falsy, este campo no se renderiza.
<confirmacion> <abm>, <histrix> — Mensaje de confirmación.
<consulta> <abm>, <histrix> 8 Contenedor del modelo de edición/visualización (<form> o alias español <consulta>).
<customScript> <abm>, <histrix> — Script personalizado para la pantalla.
<datos> <grafico> — Fuente alternativa de datos (cuando no se infiere del form).
<defaultValue> <ayuda>, <ayuda_ex>, <helper> y 1 más — Valor por defecto del parámetro de configuración, no del combo: se lee sólo en type="parameter" y es el valor que…
<descripcion> <ayuda>, <ayuda_ex>, <helper> y 1 más — Se acepta por compatibilidad, pero el motor no lo lee: sólo busca la forma en inglés.
<description> <ayuda>, <ayuda_ex>, <helper> y 1 más — Descripción del parámetro, para type="parameter": es el texto explicativo que se muestra en el **panel nativo de…
<detalle> <campo>, <field> — Nombre lógico del campo destino al volver de un popup hijo (mecanismo <importar resume>).
<ejecuta> <tabla>, <table> — SQL/PHP arbitrario a ejecutar. En tipo="nosql" Histrix reemplaza 'nombre_campo' (entre comillas) por el valor del…
<enabledWhen> <campo>, <field> — Habilita este campo mientras se cumpla la condición y lo deshabilita cuando deja de cumplirse.
<etiquetas> <grafico> — Campo cuyo valor se usa como eje X (etiquetas de cada punto).
<eval> <campo>, <field> — No es JavaScript: es PHP que corre server-side al parsear el XML, y decide si el campo existe.
<event> <eventos>, <events> 1 —
<eventos> <abm>, <histrix> — Grafía castellana de <events>: contenedor de <event id="..."> con el JavaScript que se ejecuta en cada momento del…
<events> <abm>, <histrix> — Alias en inglés de “eventos”.
<events> en <events> <events> 1 —
<expresion> <campo>, <field> 2 Expresión (SQL) para valores calculados.
<expression> <campo>, <field> 2 Expresión SQL para valores calculados. Va al SELECT (o HAVING si hay GROUP BY).
<expression> en <field> <field> — SELECT cuyo resultado se compara con el valor del campo. Soporta '[__campo__]' para interpolar otros campos del form.
<false> <if> — Valor/expresión devuelto si la condición es falsy. Opcional: sin esta rama, cuando la condición da falso el campo queda…
<falso> <if> — Alias español legacy de <false>.
<field> <ayuda>, <ayuda_ex>, <fieldGroup> y 9 más 218 Campo de formulario o columna de grid/consulta. Es el bloque fundamental: representa una columna SQL, un campo local…
<field> en <actualiza> <actualiza> 3 Destino de la actualización: campo, combo o grid embebido.
<field> en <importar> <importar> 1 Mapeo origen→destino dentro de <importar>. El id es el campo origen y el texto del tag es el campo destino; con…
<field> en <orden> <orden>, <order> 5 Campo por el que ordenar. Si tiene <expression>, se ordena por esa expresión SQL.
<field> en <subquery> <subquery>, <tabla>, <table> 5 Campo que define una condición ON del JOIN. La <condicion> con valorde="campo" referencia un campo de la tabla…
<field> en <validations> <validations> 1 Campo a validar. El id es el campo del form cuyo valor se compara.
<fieldGroup> <include>, <tabla>, <table> 169 Agrupador visual/lógico de campos. Se renderiza en el orden de aparición.
<filters> <tabla>, <table> 1 Filtros adicionales mostrados en la barra superior del listado.
<filtros> <tabla>, <table> 1 Filtros adicionales mostrados en la barra superior del listado.
<footer> <pdf> — Código que se ejecuta al dibujar cada pie de página.
<form> <abm>, <histrix> 8 Contenedor del modelo de edición/visualización (<form> o alias español <consulta>).
<format> <campo>, <field> — Alias inglés de <formato>.
<formato> <campo>, <field> — Formato de visualización (ej. “dd/mm/yyyy” en fechas, “#.##0,00” en numéricos).
<grafico> <tabla>, <table> 3 Definición de un gráfico. Va dentro de la <table>/<tabla> de la consulta que le da los datos: suelto en la raíz del…
<group> <ayuda>, <ayuda_ex>, <helper> y 3 más — Campos por los cuales agrupar el SQL (GROUP BY). Los campos con <expression> que usan funciones de agregación…
<habilita> <campo>, <field> — Está al revés de lo que sugiere el nombre: el texto del tag es el id del campo controlador, y el que se…
<header> <pdf> — Código que se ejecuta al dibujar cada cabecera de página.
<help> <campo>, <field> — Texto de ayuda contextual del campo (tooltip).
<helper> <campo>, <field>, <include> y 2 más 24 Helper UI asociado a un campo. Tipos (type): - “combo”: dropdown alimentado por SQL (1er field = VALUE, 2do field =…
<histrix> raíz del documento 172 Raíz del documento Histrix. Define un formulario, consulta, ficha, grid, gráfico u otra vista según el atributo tipo.
<htmllabel> <campo>, <field> — Texto alternativo del encabezado de columna, y sólo se usa cuando la etiqueta normal está vacía.
<if> <campo>, <field>, <orden> y 1 más 1 Estructura condicional de un <field>: <if exp="..."><true>X</true><false>Y</false></if>.
<if> en <fieldGroup> <fieldGroup>, <filters>, <filtros> y 2 más — Condición de procesamiento del bloque entero: es texto PHP que se evalúa antes de leer los filtros y, si da falso, el…
<iframe> <widget> — Éste sí es un iframe de verdad, y es la forma de mostrar algo externo a la aplicación (un tablero, un mapa, una…
<importar> <campo>, <field>, <include> y 2 más 12 Configura un popup hijo que alimenta el grid/form actual con datos seleccionados.
<include> raíz del documento — Fragmento XML incluido por otro documento (típicamente vía <fieldGroup xml="..." dir="...">).
<join> <consulta>, <form> 2 Relación con otra tabla (JOIN SQL). Soporta también JOIN a <subquery> cuando la tabla joineada es derivada…
<jseval> <campo>, <field> 4 Evaluación de código JavaScript al cambiar el campo. El resultado se asigna al destino.
<jsfunction> <campo>, <field> 1 Función JS asociada a un evento del campo (onfocus, onblur, onkeypress…).
<key> <ayuda>, <ayuda_ex>, <helper> y 1 más — Campo que aporta la clave de la ayuda, en un <helper type="external">.
<label> <campo>, <field> 47 Etiqueta legible del campo (header de columna o label del input).
<label> en <ayuda> <ayuda>, <ayuda_ex>, <helper> y 1 más — Etiqueta del parámetro: se lee sólo en type="parameter" y es el nombre con el que el parámetro aparece en el…
<maxsize> <campo>, <field> — Máximo de caracteres del input (atributo HTML maxlength).
<message> <field>, <validation> — Mensaje de error si la validación falla. Default “Valor invalido”.
<movimientos> <tabla>, <table> 2 Lista de XMLs relacionados que el motor procesa en cascada al grabar el padre.
<objective> <grafico> — Valor meta que se dibuja como referencia sobre el gráfico (la línea de objetivo).
<obs> <abm>, <histrix> — Observaciones (puede estar vacío).
<onformchange> <campo>, <field> — Código a ejecutar cuando cambia cualquier campo del form.
<onRowClick> <tabla>, <table> — JS a ejecutar al hacer clic en una fila de la grilla.
<opcion> <opciones>, <options> 2 Alias español de <option>; el motor lee las dos grafías.
<opciones> <campo>, <field> — Contenedor de opciones de un campo.
<operador> <campo>, <field> 2 Operador de la condición de filtro/JOIN del campo (=, !=, like, in, between, etc.).
<operator> <campo>, <field> 2 Elemento <operador> (o alias <operator>) dentro de <field>.
<operator> en <field> <field> — Operador de comparación (==, !=, …). Default ==. Suele ir en CDATA cuando lleva < o >.
<option> <ayuda>, <ayuda_ex>, <helper> y 3 más 2 Opción fija del combo (no proviene de SQL).
<options> <campo>, <field> — Lista de opciones fijas para radio/select (no dependen de SQL).
<options> en <grafico> <grafico> — JSON crudo que se mergea sobre las opciones de la librería de gráficos, para llegar a cualquier setting que el motor no…
<orden> <ayuda>, <ayuda_ex>, <helper> y 3 más 1 Alias español de <order>, pero sólo funciona en <tabla_ex> y <ayuda_ex>.
<order> <ayuda>, <ayuda_ex>, <helper> y 3 más 1 Definición de orden de la consulta (ORDER BY). Cada <field> declara una columna y su dirección.
<param> <importar> 3 Condición pre-filtrado en consultas/importar. field es alias de campo (mismo significado).
<parameter> <ayuda>, <ayuda_ex>, <helper> y 2 más 5 Forma equivalente a <field> con la sintaxis source/target.
<parameter> en <values> <values> 2 Parámetro que se pasa al XML de values (pares name/value).
<parametro> <campo>, <field> 4 Parámetros para helpers de tipo “parameter”. id (o xml) puede omitirse cuando se usa retorna sobre un set de…
<paring> <campo>, <field> 3 Alimenta con una condición SQL al contenedor embebido del campo (el que abre obj / linkint / el helper).
<paring> en <cierraproceso> <cierraproceso> 1 Mapea un campo del padre a un campo del XML cierraproceso.
<pdf> <consulta>, <form> — Impresión PDF con código embebido: <header>, <code> y <footer> se ejecutan como código PHP con la variable $pdf…
<pdf> en <campo> <campo>, <field> — Código PHP que reemplaza el dibujado de este campo en el PDF. El contenido se ejecuta al imprimir la celda y, si…
<pdfancho> <campo>, <field> — Ancho de la columna del valor en la ficha impresa. Su contraparte para la etiqueta es el atributo size del…
<pie> <abm>, <histrix> 4 Pie del documento/pantalla (atributos para PDF).
<preconsultas> <tabla>, <table> — Bloque de pre-consultas/validaciones ejecutadas antes de la consulta principal.
<prefijo> <campo>, <field>, <txtresultados> — Texto que se antepone al valor del campo al renderizar (en pantalla y PDF).
<preparam> <campo>, <field>, <importar> 3 Condición pre-filtrado en consultas/importar. field es alias de campo (mismo significado).
<prompt> <abm>, <histrix> — Instrucción para el resumen automático de la pantalla: el texto se le pasa al modelo de lenguaje junto con los datos…
<relacion> <movimientos> 2 Referencia a un XML hijo que se procesa como parte del movimiento.
<requiredWhen> <campo>, <field> — Hace obligatorio este campo mientras se cumpla la condición, y le saca la marca cuando deja de cumplirse.
<scriptSrc> <abm>, <histrix> — Librería JavaScript externa que la pantalla necesita: el texto del tag es la ruta del archivo y se inyecta antes que el…
<select> <tabla>, <table> — SELECT crudo que reemplaza la consulta que el motor armaría con los <field>.
<selectCode> <tabla>, <table> — 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…
<serie> <grafico> 1 Campo de una serie de datos (eje Y). Repetir para múltiples series.
<set> <ayuda>, <ayuda_ex>, <helper> y 1 más 1 Inyecta una propiedad arbitraria en el contenedor embebido del helper: el id es el nombre de la propiedad y el texto…
<setvar> <campo>, <field> — Guarda el valor del campo en una propiedad del contenedor de esa instancia, con el nombre que dice el texto del tag.
<size> <campo>, <field> — Tamaño visual del input o ancho de columna.
<sql> <subquery>, <tabla>, <table> — SQL del subquery. Acepta '[__campo__]' para parámetros.
<status> <tabla>, <table> 7 Una columna del tablero tipo="kanban". Va como hijo directo de <table>, al lado de <filters> y <order>, y se…
<subquery> <join> 1 Subquery aliasada usada como tabla joineada. Estructura: <subquery as="ALIAS">SELECT ...`<field…
<subtitulo> <grafico> — Subtítulo del gráfico.
<sufijo> <txtresultados> — Texto después de la cantidad de resultados.
<tabla> <consulta>, <form> 10 Tabla SQL fuente de datos (<table> o alias español <tabla>).
<tabla> en <join> <join> 2 Tabla joineada (alias español). Un <join> puede contener múltiples tablas joineadas en cadena.
<tabla_ex> <campo>, <field> 24 Helper UI asociado a un campo. Tipos (type): - “combo”: dropdown alimentado por SQL (1er field = VALUE, 2do field =…
<table> <consulta>, <form> 10 Tabla adicional declarada al nivel del <form>/<consulta>.
<table> en <join> <join> 2 Tabla referenciada en el JOIN. Puede ser una tabla real o un <subquery> aliasado.
<tempTable> <consulta>, <form> 1 Definición de tabla temporal usada como fuente del grid (típicamente en flujos de importación).
<text> <widget> — Contenido HTML fijo del widget, para los casos en que no hay una pantalla que embeber: un texto, un aviso, un bloque de…
<tipo> <campo>, <field> 4 Tipo del campo (date, numeric, check, file, geoPoint, etc.).
<tipo> en <grafico> <grafico> — Tipo de gráfico. Valores válidos: L línea, C columnas, SC columnas (idéntico a C), P torta, H cotizaciones…
<title> <abm>, <grafico>, <histrix> y 1 más — Título del documento/pantalla.
<titulo> <abm>, <grafico>, <histrix> — Alias español de <title>; el motor lee las dos grafías.
<true> <if> — Valor/expresión devuelto si la condición es truthy.
<txtresultados> <abm>, <histrix> — Cambia el texto que acompaña al contador de resultados del listado: <prefijo> va antes del número y <sufijo>…
<url> <widget> — Pantalla interna cuyo HTML se inyecta en el div del widget (se pide por AJAX, no es un iframe).
<validation> <fieldGroup>, <include>, <tabla> y 1 más 1 Validación del formulario, en singular: <condition> + <message>.
<validations> <tabla>, <table> — Validaciones por campo, en plural. Es un mecanismo distinto del <validation> singular: construye una validación…
<valor> <campo>, <field> 3 Valor por defecto del campo. Con eval="true" se evalúa como PHP (ej. date('d/m/Y')).
<value> <field> 1 Valor literal contra el que comparar, como alternativa a <expression>.
<value> en <ayuda> <ayuda>, <ayuda_ex>, <helper> y 1 más — Campo que aporta la descripción de la ayuda en un <helper type="external">: el que se muestra al usuario…
<value> en <values> <values> 1 Valor fijo: el id es lo que se guarda, el texto lo que se muestra.
<values> <ayuda>, <ayuda_ex>, <helper> y 1 más 2 Valores posibles de un parámetro (type="parameter"), para que el panel los ofrezca como lista en lugar de un texto…
<verdadero> <if> — Alias español legacy de <true>. El motor lo reconoce explícitamente como forma vieja: al encontrarlo activa el modo…
<visibleWhen> <campo>, <field> — Muestra u oculta este campo según una condición: el tag va sobre el campo controlado, no sobre el que dispara la…
<widget> <abm>, <histrix> 4 Widget embebido en el dashboard. No es un iframe y no apunta afuera: el contenido de <url> se pide por AJAX y su…