Define un elemento que no puede tener contenido. Define un campo de texto. Indica que el campo debe proveer autocompletado de valores. Luego que el usuario haya tipeado al menos @long-min caracteres y tras una demora de @demora, se consulta dinámicamente al servidor y se le presenta una lista de valores que cumplan la condición @comparacion respecto al texto ingresado, en la cual puede seleccionar uno. Ancho sugerido del campo, en caracteres. Ancho máximo, en cantidad de caracteres Indica si el valor del campo se convierte automáticamente a mayúsculas. Tiene prioridad sobre el parámetro de configuración 'texto_form_mayusculas'. Define un campo que permite subir un archivo al servidor. Utiliza el parámetro de configuración "upload_dir". Ruta destino del archivo, relativa al directorio base. Ancho sugerido del campo, en caracteres. ).]]> 1 't' Conexion::sqlstr2php(XGAP_CONF_VALOR_VERDADERO_SQL) ]]> 0 'f' Conexion::sqlstr2php(XGAP_CONF_VALOR_FALSO_SQL) ]]> Indica si el campo debe estar inicialmente chequeado o no. Define un campo de tipo combo (lista desplegable), cuyos valores posibles se dan por enumeración. Indica que es un campo clave. Define un campo de tipo lista con selección múltiple, cuyos valores posibles se dan por enumeración. Este campo no guarda automáticamente los valores seleccionados en la base de datos, sino que se debe hacer mediante código personalizado en la página. Define la consulta a realizar para obtener los elementos que deben estar seleccionados inicialmente. Cantidad de elementos a mostrar en la lista (atributo size del select). Si no está presente, se muestran 3 elementos; si es 0, no se genera el atributo. Define un campo formado por un grupo de radio buttons, cuyos valores posibles se dan por enumeración. ¿Los elementos del grupo se deben colocar de forma horizontal o vertical? Define un campo de tipo combo (lista desplegable), cuyos valores posibles se obtienen de la base de datos. Permite personalizar la opción del combo que corresponde a selección vacía. Texto a mostrar en la opción Indica que es un campo clave. Ancho en pixels del combo Define un campo de tipo lista con selección múltiple, cuyos valores posibles se obtienen de la base de datos. Este campo no guarda automáticamente los valores seleccionados en la base de datos, sino que se debe hacer mediante código personalizado en la página. Define la consulta a realizar para obtener los elementos que deben estar seleccionados inicialmente. Cantidad de elementos a mostrar en la lista (atributo size del select). Si no está presente, se muestran 3 elementos; si es 0, no se genera el atributo. Define un campo formado por un grupo de radio buttons, cuyos valores posibles se obtienen de la base de datos. ¿Los elementos del grupo se deben colocar de forma horizontal o vertical? El texto del link se obtiene del valor del dato, si no está presente el elemento etiqueta. Destino del link. Define un parámetro del request. Debe incluir un atributo de cada uno de los grupos {@nombre | @nombre-expr} y {@dato | @expr | @valor}. Nombre del parámetro del request, evaluado como una expresión PHP. Si está presente, no se tiene en cuenta @nombre. Nombre del parámetro del request, evaluado como un string. Debe referenciar el elemento "dato" de uno de los campos. El valor del parámetro es el valor inicial del campo referenciado. Si está presente, no se tienen en cuenta @valor ni @expr. Valor literal para el parámetro, evaluado como una expresión PHP. Si está presente, no se tiene en cuenta @valor. Valor literal para el parámetro, evaluado como string. Código a colocar en el atributo onclick del link. Texto del link. Si no está presente se usa el valor de la columna indicada por dato. Si está presente, indica que el link se debe abrir en una nueva ventana. Si no, reemplaza la página en la ventana actual. Si es 'true', se abre como un div dentro de la misma ventana. Si es 'false', se abre en una ventana separada. Nombre de la ventana. Sólo se usa si @inline='false'. Ancho de la ventana, incluyendo la unidad (ej: 90% o 750px) Alto de la ventana, incluyendo la unidad (ej: 90% o 550px) Posición de la ventana desde arriba, incluyendo la unidad (ej: 5% o 30px). Sólo se usa si @inline='true'. Posición de la ventana desde la izquierda, incluyendo la unidad (ej: 5% o 50px). Sólo se usa si @inline='true'. Define un campo oculto, que genera un input de tipo hidden, pero no cambia la apariencia de la página. El valor se obtiene de la base de datos. Nombre de la columna de la tabla que contiene el valor para el campo. Define un campo oculto, que genera un input de tipo hidden, pero no cambia la apariencia de la página. El valor es directamente el indicado en valor o funcion. Sólo se usa para definir el nombre del campo si no está presente el elemento nombre. Valor de la constante. htmlentities($_SERVER['PHP_SELF']) ]]> Define un campo oculto, que genera un input de tipo hidden, pero no cambia la apariencia de la página. El valor se obtiene de una variable de sesión. Sólo se usa para definir el nombre del campo si no está presente el elemento nombre. Nombre de la variable de sesión. Indica que se debe tomar el valor de la sesión sólo durante el alta; en modificación se debe tomar de la base, comportándose como si fuera <oculto>. Define un campo que muestra información, pero no se puede editar. Genera texto con el valor a mostrar y un hidden con el valor del dato. Define la consulta a hacer para obtener el valor a mostrar. Si no se incluye, se muestra el valor del dato. Nombre de la tabla a consultar. Nombre de la columna que contiene el valor a buscar. Nombre de la columna que contiene el valor a mostrar. Condiciones extra para la cláusula WHERE. Define otros campos de los cuales depende el resultado de la consulta. Los valores de estos campos se incluyen en la cláusula WHERE. Sólo se usa si está definido el elemento "consulta". Nombre de un campo del que depende la consulta. Indica el nombre de la columna referenciada en la tabla destino. Si no está presente, se usa "dato" como nombre de columna. Un valor true indica que el campo _no_ se debe incluir en el UPDATE. Define un campo de tipo área de texto, con la longitud del texto limitada a un máximo. Cantidad de filas del control. Cantidad de columnas del control. Cantidad máxima de caracteres que puede contener el campo. Indica si el valor del campo se convierte automáticamente a mayúsculas. Tiene prioridad sobre el parámetro de configuración 'texto_form_mayusculas'. Define un campo de tipo área de texto con formato. Ancho del control, dado en formato numérico o porcentual, por ejemplo: "600" o "90%". Alto del control, dado en formato numérico o porcentual, por ejemplo: "300" o "20%". Nombre del juego de barras de herramientas a usar en el control. Sólo se aplica si @tipo = 'HtmlArea'. Texto del link que abre el listado de selección. Define el tamaño en que se abre el listado. El contenido debe estar en el formato aceptado por Configuracion::recuadroConMargen(). El valor por defecto está dado por el parámetro de configuración tamanio_seleccionable_div. Nombre de la entidad a la que corresponde el listado destino. Nombre de la tabla que contiene el valor del campo. Si no está definido, se usa el elemento "entidad". Nombre de la columna del listado destino que contiene el valor que debe tomar el campo luego de realizar la selección. Nombre de la columna del listado destino que contiene el valor que debe mostrar el campo luego de realizar la selección (la descripción del valor seleccionado). Indica que otros campos seleccionable-simple o seleccionable-multiple son dependientes de éste. Cuando se abre el listado de selección para este campo, se blanquea el valor de todos los actualiza/campo. Nombre de un campo dependiente. Define otros campos de cuyo valor dependen los valores disponibles para éste; por lo tanto, todos ellos deben tener valor antes de poder abrir este seleccionable. El valor de cada depende/campo se incluye en la cláusula WHERE del listado, al abrir el seleccionable. Permite registrar controladores javascript para responder a eventos producidos en el campo. Registra un controlador para el evento select. El contenido debe ser una expresión javascript que retorne el objeto Function a registrar. Indica que el campo debe proveer autocompletado de valores. Luego que el usuario haya tipeado al menos @long-min caracteres y tras una demora de @demora, se consulta dinámicamente al servidor y se le presenta una lista de valores que cumplan la condición @comparacion respecto al texto ingresado, en la cual puede seleccionar uno. La búsqueda se hace por los valores de la columna indicada por el elemento "descripcion". Este método constituye una alternativa a abrir el listado y seleccionar un valor en éste, haciendo editable el campo de texto que contiene la descripción. Si texto-autocompletable/@demora=0, no se muestra una lista desplegable, sino que se completan los valores cuando el campo pierde el foco. Indica que se debe proveer un campo de texto adicional para que el usuario pueda completar los valores del campo escribiendo directamente (parte de) un valor de la columna indicada por el elemento "seleccionar". Luego que el usuario haya tipeado al menos @long-min caracteres y tras una demora de @demora, se consulta dinámicamente al servidor y se le presenta una lista de valores que cumplan la condición @comparacion respecto al texto ingresado, en la cual puede seleccionar uno. Si seleccionar-autocompletable/@demora=0, no se muestra una lista desplegable, sino que se completan los valores cuando el campo pierde el foco. Etiqueta para el campo de texto que corresponde al valor a seleccionar. Etiqueta para el campo de texto que corresponde a la descripción. Ancho, en cantidad de caracteres Ancho máximo, en cantidad de caracteres Ancho sugerido del campo de texto del seleccionable, en caracteres. Indica que al abrir el listado de selección NO se debe filtrar por el valor actualmente seleccionado, sino que se debe mostrar el listado completo. Permite indicar que el campo debe tener la edición deshabilitada. En modo solo-lectura el campo no cuenta con el link para abrir el listado de selección. A diferencia de @no_editable, este atributo se utiliza siempre, no sólo en edición. Texto del link que abre el listado de selección. Define el tamaño en que se abre el listado. El contenido debe estar en el formato aceptado por Configuracion::recuadroConMargen(). El valor por defecto está dado por el parámetro de configuración tamanio_seleccionable_div. Nombre de la entidad a la que corresponde el listado destino. Nombre de la tabla que contiene el valor del campo. Si no está definido, se usa el elemento "entidad". Nombre de la columna del listado destino que contiene el valor que debe tomar el campo luego de realizar la selección. Nombre de la columna del listado destino que contiene el valor que debe mostrar el campo luego de realizar la selección (la descripción del valor seleccionado). Valor para la cláusula ORDER BY de la consulta que selecciona los elementos. Define la consulta a realizar para obtener los elementos que deben estar seleccionados inicialmente. Define otros campos de cuyo valor dependen los valores disponibles para éste; por lo tanto, todos ellos deben tener valor antes de poder abrir este seleccionable. El valor de cada depende/campo se incluye en la cláusula WHERE del listado, al abrir el seleccionable. Indica la cantidad de filas con que se debe presentar el campo. Permite indicar que el campo debe tener la edición deshabilitada. En modo solo-lectura el campo no cuenta con el link para abrir el listado de selección. A diferencia de @no_editable, este atributo se utiliza siempre, no sólo en edición. Tipo de campo con contenido definido por el usuario. Si está presente, el valor queda disponible en la variable PHP $valores['{dato}']. Sólo se tiene en cuenta este elemento si dato está especificado. Sólo se tiene en cuenta este elemento si dato está especificado. Código HTML para el contenido del campo. Indica que el campo ocupa más de una línea. Orientación horizontal Orientación vertical Define una lista de opciones estática en el XML. 'label1', 'value2' => 'label2', ...). Ejemplo: lista de números del 1 al 12, tanto para valores como para etiquetas $a = range(1, 12); return array_combine($a, $a); ]]> Indica la tabla destino de la consulta. Debe estar presente si la consulta no es plana. Columnas que tiene los valores. Debe estar presente si la consulta no es plana. Columna que tiene las etiquetas. Debe estar presente si la consulta no es plana. Define la etiqueta como una expresión SQL. Si está presente, también debe estar el elemento "rotulo". Rotulo o alias a usar cuando la etiqueta se define como una expresión. No se tiene en cuenta si no está presente el elemento "expresion". Cuando este atributo está presente, la consulta se toma del contenido del elemento consulta, ignorando el resto de los hijos. Consulta para un campo que permite selección múltiple de valores. Cuando este atributo está presente, la consulta se toma del contenido del elemento, ignorando el resto de los hijos. Permite indicar si la consulta se debe realizar sólo en el formulario de modificación (false) o también en el de alta (true). Indica la posición del título respecto al control. Sólo se tiene en cuenta para campos @tipo='CheckBox'. El título se ubica a la izquierda del control El título se ubica a la derecha del control Entidad a la que corresponde el listado destino de un seleccionable. El contenido del elemento define el nombre de la entidad. Nombre de un campo del que depende la consulta. Indica el nombre de la columna referenciada en la tabla destino. Si no está presente, se usa como nombre de columna el mismo valor de este elemento. Permite definir una lista de columnas a mostrar cuando se despliega el campo, además de las predefinidas. Nombre de una columna extra a mostrar. Operador a usar para comparar el texto ingresado con el valor de la columna. ¿Se deben ignorar los acentos, tanto en el texto ingresado como en los valores de la columna? 0. ]]> Cantidad de valores que se muestran en cada página de la lista desplegable. Ancho de la lista desplegable. Ejemplos: 100 (se asume px); 100px; 15em. ¿La lista 1 tiene como prefijo a la lista 2? ¿La lista 1 tiene como sufijo a la lista 2? ¿La lista 1 contiene a la lista 2, en alguna posición? ¿La lista 1 y la 2 son iguales? ¿La lista 1 no tiene como prefijo a la lista 2? ¿La lista 1 no tiene como sufijo a la lista 2? ¿La lista 1 no contiene a la lista 2, en ninguna posición? ¿La lista 1 y la 2 no son iguales? Posibles operadores para comparar dos listas de valores. Una lista de valores es cualquier valor formado por una lista ordenada de otros valores, por ejemplo una cadena de caracteres. ¿La lista 1 es menor que la 2? ¿La lista 1 es menor o igual que la 2? ¿La lista 1 es mayor que la 2? ¿La lista 1 es mayor o igual que la 2? Nombre del origen de datos del campo. Nombre (id) a usar para el campo de formulario. Si no se especifica, se usa el valor de dato. Titulo a mostrar para el campo Texto para el tooltip del campo. 5, 'abc', __FILE__, phpversion() Si no está presente, se usa el valor por defecto definido para la columna correspondiente en la base de datos. ]]> Permite modificar el valor inicial del campo. Se aplica *antes* de cargarlo desde la base de datos, por lo cual se puede utilizar para cambiar lo que se recibe via request antes de realizar la acción del formulario, pero no para variar lo que aparece en el campo cuando se presenta la página. El contenido debe ser código PHP que retorne el nuevo valor. Dentro de este código están predefinidas las variables: * string $valor: valor original * boolean $agregado: ¿es un formulario de alta? * string $accion: nombre de la acción a ejecutar * Conexion $conexion * iSeguridad $seguridad * Configuracion $configuracion * HistorialNavegacion $historial Si está presente, se agregan controles para cambiar la selección de los elementos de la lista. Opciones para el control "Mostrar todos" ¿Se debe generar este control? Texto a mostrar Tooltip Opciones para el control "Deseleccionar todos" ¿Se debe generar este control? Texto a mostrar Tooltip Opciones para el control "Restaurar selección" ¿Se debe generar este control? Texto a mostrar Tooltip Permite obtener valores de columnas adicionales para la fila que se selecciona en el listado y guardarlos en otros campos del formulario; de esta forma, con una sola selección se actualizan varios campos (éste y cada datos_adicionales/correspondencia/@origen). Define un valor extra a obtener, mediante una correspondencia entre el campo origen y la columna de la tabla destino. Nombre de otro campo definido en el formulario, que va a recibir el valor de la columna @destino cuando se haga una selección. Nombre de la columna en el listado seleccionable, de la cual se debe obtener el valor para colocar en el campo @origen. Indica si esta correspondencia debe formar parte de la condición de selección. Si este atributo tiene valor verdadero, indica que el campo no se puede modificar cuando el formulario se presenta para edición. Si este atributo tiene valor verdadero, indica que el campo no se puede modificar en ningún caso. Indica si el campo es requerido, ignorando cómo está definido en la base de datos.