Tag|field

Atributos

id="nombre_campo" - Obligatorio.

local="true|false" - Indica si el campo se corresponde con un campo de la base da datos o es un campo de uso local.

autoinc="true|false" - Indica si el campo de la base de datos es autoincremental.

noshow="true|false" - no muestra el campo.

deshabilitado="true|false" - deshabilita el campo.

validRow="true" - Indica si el campo condiciona la validez del registro. Si el contenido del campo es 0 entonces se borra la fila.

noZero="true|false" - En los campos numéricos NO muestra el 0.

noEmpty="true|false" - Si la columna no posse ningun valor, no la muestra.

maxlength="nn" - En las TextAreas establece la cantidad máxima de caracteres.

cellMaxlength="nn" - Trunca la cantidad de caracteres a mostrar en la celda de las tablas y activa tinytips para ver el resto del contenido.

refresh="true|false" - indica si el campo mostrara su valor al cambiarse automaticamente en pantalla.

requiered="true|false" - determina si el campo es obligatorio su ingreso o no.

bloquearfila="true|false" - Indica si el campo se bloqueara para la edicion o no.

path="nombre del campo" - Indica si el campo que nombrara la subcarpeta para guardar los archivos.

valto="true|false" - coloca un valor automatico al campo indicado. Puede conservar el valor del campo para que no se pierda al limpiar el formulario.

activa="true|false" -indica si el campo muestra o no los campos dependientes.

activador="nombre del campo del que depende" -indica el  campo del que depende.

tipoOrden="DESC|ASC" -indica si el tipo de ordenamiento de este campo si sera Ascendente o descendente.

log="false" - previene que el campo se muestre en las notificaciones.
searchRecord="true|false" - previene que el campo se utilice  en la busqueda de registros.

ldifKey="true|false".

ldifName="true|false".

condes="true|false".

editable="true|false" - determina si el campo es editable dentro de la grilla.

total="true|false" -

acumula="true|false" - El campo trabaja como acumulador en base a los registros que lo preceden, trabaja combinado con el atributo break

break="true|false" - Establece un corte de control para los atributos acumula, suma o total

suma="true|false" - Hace la sumatoria del campo en el cual se establece dicho atributo, trabaja combinado con el atributo break.

repeat="true|false" - En las grillas previene que el valor de la celda se repita en las subsiguientes cuando su valor es el mismo.

Estilo

sortable="true|false" - determina si se permite reordenar por este campo.

class="informal|fila" - determina a que clase pertenece esa fila, siendo estilos de css.

color="true| false" - determina muestra color en la fila en hexa.

styleTbody="Css" - determina estilos  de css para ese campo. (OBSOLETO - No tiene efecto)

Formstyle="display:none;" - Indica que el campo no se mostrará en el formulario.

colstyle- Establece el estilo de la columna de la tabla o la celda del Arbol sin afectar al abm asociado".
*colstyle="display:none;" - No muestra el campo.
*colstyle="color:red"     - Lo muestra con color rojo.

Cálculo

suma="true|false" - Suma la columna especificada

acumula="true|false" - Acumula el valor de la celda superior con el actual

average="true|false" - genera un promedio de los valores.

retroalimenta="true|false" - En los campos que acumulan vuelve a guardar el valor para que los calculos posteriores puedan tomar el valor acumulado del campo

break="true|false" - Determina que se delimitara la suma teniendo en cuenta el campo que tenga esta propiedad

rememberValue="true|false" - El valor del campo se almacena en la tabla de preferencias del usuario, de manera que al volver a usar ese programa el campo mantenga el valor.

numberPrecision="n" - cantidad de decimales a tener en cuenta internamente para el campo.

Links

linkint="nombre_archivo.xml"

linkdir="directorio del xml"

linkdes="descricpion del link"

linkReposition="Posiciona la ventana emergente al lado del boton que la dispara"

linkWidth="Ancho de la ventana emergente"

linkHeight="Alto de la ventana emergente"

linkmodal="true" - HAce a la ventana Modal

Tabla interna

obj="nombre_archivo.xml"
objdir="nombre directorio donde se encuentra el xml"

Grabación

id_tem="nombre del campo de la tabla temporal"

id_cab="nombre del campo de la tabla cabecera"

lastId="Nombre del XML del cual recuperar el ID de la ultima transaccion"  Obtiene el valor del last_insert_id del insert del xml referido.

Arboles

Atributos que solamente se utilizan en la construccion de arboles de datos.

arbol="padre|hijo" - Indica si el campo determina el identificador de nodo padre o hijo en un arbol

treeSum="true|false" - Suma el valor del campo actual en el campo del padre

Exportación

export="false" - Evita que el campo se exporte en el archivo.

Pdf

Atributos que se utilizan en la construccion de archivos pdf.

size="..." - Indica el tamaño en puntos de la etiqueta en la impresion.

PDFsize="..." - Indica el tamaño de la fuente del campo en el pdf.

print="true|false" - Indica si el campo se imprimira  en el pdf.

pdfancho="..." - Indica que el break lo hará en las posicion indicada.

PDFlineas="true|false" - Indica si se imprimiran las lineas en el pdf de la tabla.

PDFcolWidth="..." - Establece el ancho en puntos de la columna en la impresion en pdf

PDFheader="true" - Al tener establecido este atributo el campo se olcuta del resto de la impresion y se utiliza automaticamente como cabecera de la misma. repitiendose por cada hoja en la posicion especificada por posx y posy.

PDFnoborder="true" - Indica si se imprimirá con resaltado la etiqueta del campo.

PDFnolabel="true" - Indica si se imprimirá la etiqueta del campo.

PDFwidth="..." - Indica el ancho de la página que va a ocupar el campo.

PDFrotate="..." - Indica la rotación del texto en grados.

PDFrestorePosition="..." - Vuelve el cursor a la posicion inicial despues de escribir el texto.
e-mail

Atributos que se utilizan en el envio de reportes por email.

email="to" - El valor del campo corresponde a la direccion de envio del mail.

email="subject" - El valor del campo corresponde al asunto del mail.

email="body" - El valor del campo corresponde al cuerpo del mail.

Validación

errorMessage="Mensaje" - Mensaje de error personalizado que se mostrará cuando una validación javascript devuelva un error.
 validar= "true/false" - Indica que ese campo será validado.
 mask= "formato" - mascara de formato : ej: 99/9999,  aa-aaaaa-aa o **-****-**

Imagen

imagewidth="tamaño en pixeles" - determina el ancho de la imagen.

watermark="palabra a mostrar" - determina la palabra que se utilizara como marca de agua de la imagen.

Calendar

calendarId="true" - Determina el id del evento.

calendarStartDate="true" - Indica al campo como fecha de comienzo del evento.

calendarStartTime="true" - Indica al campo como horario de comienzo del evento.

calendarEndDate="true" - Indica al campo como fecha de finalización del evento.

calendarEndTime="true" - Indica al campo como horario de finalización del evento.

calendarSubject="true" - Indica al campo como título del evento.

calendarEditable="true" - Indica si el evento será editable.

calendarColor="true" - Indica si el campo determina el color del calendario.

Campos Especiales

Aclaracion anteponer Id=“nombre del campo especial”

_ORDEN - Cuenta los registros de un formulario.

<label>

Funcion Especifica la etiqueta del campo.

Atributos

style="..."

Estilo representado en formato CSS estándar del campo

modpos="[br]|nobr|force"

En los Forumularios realiza un salto de linea, o nobr posiciona el campo al lado del anterior, en combinación con sincelda permite ubicar un campo pegado al otro. El valor force sirve para que los helper de tipo tablas queden ocupando todo el ancho disponible sin margen.

PDFnolabel="True|False"

Indica si debe colocar o no la label en el pdf.

posx="numero"

Indica la posicion de la label en el pdf con respecto al eje x.

posy="numero"

Indica la posicion de la label en el pdf con respecto al eje x.

pdffill="numero"

Arma el separador del PDF

<help>

El contenido de la etiqueta corresponde a la ayuda contextual durante el ingreso de valores en un campo, en el caso de un formulario.

<tipo>

Indica que tipo de datos contiene el campo. El tipo de datos de un campo esta dado por el tipo de la base de datos, pero mediante el uso de esta etiqueta se puede forzar a un tipo determinado. Para el caso de que el valor del campo este dado por el valor de una <expresion> deberá forzarse el tipo de datos con este tag. También indica el modo de representacion de tipos básicos.

Posibles valores

integer - Valor Entero.

decimal - Valor decimal sin separación de miles.

numeric - Valor decimal con separación de miles.

varchar - Campo de Texto.

date - Campo de Fecha.

hora - Campo de Hora HH:MM:SS.

check - Se representara valores binarios 1 / 0 como un checkbox.

radio - Se mostraran las opciones como radio buttons.

file  - histrix considerará el contenido del campo como el path a un archivo.

editor  - Muestra el Editor de Textos

dir  - Muestra el Directorio donde se alojan los archivos asociados (lleva el Atributo path  en FIELD)

custom_numeric  - Formatea Explicitmente como numero decimal

enclosed_numeric  - Formatea Explicitmente como numero decimal si es negativo se coloca entre paréntesis

<size>

Permite determinar la cantidad de caracteres de un campo a mostrar.

Ejemplo

 <field id="precio_costo" local="true" noshow="true">
        <label>rubro</label>
        <size>20</size>
 </field>

<detalle>

Funcion Se utiliza para indicar los parametros que pasara al xml, indicado en el atributo detalle del tag

• <consulta>. Se debe aclarar lo siguiente:
• el valor del campo que posee detalle sera enviado al campo destino especificado en dicho tag.
• se puede tener mas de un detalle por campo, para enviar el valor del campo actual a varios campos de destino.

Atributos

multipleSelection="true|false" - Permite pasar por detalle mas de un registro

Ejemplo

<consulta detalle="detalles.xml">
<field id="id_movimiento" noshow="true">
  <label>codigo de movimiento</label>
  <help>Codigo de movimiento</help>
  <detalle>movimiento_id</detalle>
</field>
</consulta>

<paring>

Determina los parametros que se pasaran al atributo linkint de la etiqueta , se debe especificar cual sera el nombre del campo destino así como también el campo que sera usado como parametro.

Atributos

destino ="campo_destino": determina el nombre del campo destino del xml utilizado en el atributo linkint.

Ejemplo

<field id="nro_minuta" noshow="false" linkint="detalles.xml" linkdes="minutas" linkmodal="true">
 <paring destino ="movimiento_id">id_movimiento</paring>
        <paring destino ="ejercicio_id">ejercicio_id</paring>
  <label>Numero minuta</label>
  <help>Numero de la minuta</help>
</field>

Contenido

<expresion>

Se utiliza para escribir expresiones SQL en lugar de obtener los datos de un campo determinado, pudiendo realizar operaciones, sub-querys y cualquier otra operacion

Atributos

having="false" = La consulta en lugar de hacer un HAVING en la condicion asociada realiza un WHERE

En general se utiliza para expresiones simples.

Ejemplo

<expresion>SUM(importe)</expresion>

<expresion having="false">fecha_movimiento</expresion>

<valor>

Valor por defecto del campo

Atributos

eval= "true" - El contenido será evaluado por el intérprete de php

default= "valor" - Valor definido por defecto del campo

aletras= "true" - Convierte numeros a letras

Tipos de valores

Date - Tipo fecha

numeric - Tipo entero

decimal - Tipo decimal

time -    Tipo hora

char -    Tipo caracter

Ejemplo

<valor> valor por defecto</valor>

<!-- Evalua la expresion  -->
<valor eval="true">date('Y')</valor>

<!-- Convierte Numeros A letras -->

 <tipo aletras="true">char</tipo>

<if>

En base a la evaluacion de la expresion exp=“CONDICION” se establece el valor del campo actual según el resultado de la evaluación sea verdadero o falso.

Tanto la expresion a evaluar como la expresion resultante interpreta los nombres de campo y los utiliza como variables para realizar el cálculo. Esta evaluación se realiza en el motor PHP y no en la base de datos, pudiendo combinarse varios sucesivos y utilizar expresiones nativas de PHP.

Atributos

exp="expresion de comparacion" - Obligatorio.

    <field id="test" local="true"  noshow="true">
        <if exp="patrimonial > 0 ">
          <true>'color:red;'</true>
          <false>'color:green;'</false>
        </if>
    </field>

<options>

Este Tag es obsoleto, utilice \<helper> en su lugar.

Se utiliza para especificar los valores que puede tener el campo entre una lista de opciones. Por defecto se representan las opciones en forma de select box. Se puede forzar la representacion a una serie de radio buttons con el tag <tipo> radio </tipo>.

Elemplo

<options>
    <option valor="0">Opcion 0</option>
    <option valor="1">Opcion 1</option>
</options>

<table_ex>

Este Tag es obsoleto, utilice <helper> en su lugar.

Se utiliza para indicar el comienzo de una lista desplegable o combobox que referencia datos obtenidos dinamicamente.

Atributos

id="NOMBRE_DE_TABLA" : Nombre de la tabla a consultar
xml=”nombre_Archivo.xml” : referencia el nombre del archivo externo xml que contiene la consulta a realizar para obtener los datos.
vacio="true": si se indica true en este atributo se permitirá que el primer campo sea vacio del combo box.

Ejemplo

<field id="alicuota" local="true">
    <label  modpos="nobr">Alicuota</label>
    <tabla_ex id="GEN_IVA_ALICUOTAS" _vacio="true">
      <field id="alicuota">
      </field>
      <field id="alicuota2">
        <expresion>alicuota</expresion>
        <label>Alicuota</label>
      </field>
    </tabla_ex>
</field>

<ayuda_ex>

Este Tag es obsoleto, utilice <helper> en su lugar.

Referencia o contiene la consulta a ejecutar para obtener la ayuda asociada al campo actual.

Atributos

dir =“Nombre Directorio” - Directorio donde se encuetra el xml destino , al comienzo / para Path absoluto y sin barra para Path relativos.

Ejemplo

<ayuda_ex id="GEN_IVA_ALICUOTAS" _vacio="true">
          <field id="alicuota">
          </field>
          <field id="alicuota2">
            <expresion>alicuota</expresion>
            <label>Alicuota</label>
          </field>
          <field id="iva_id" oculto="true">
            <condicion operador="=">1</condicion>
          </field>
</ayuda_ex>

Modificador

<attribute>

Mediante el tag attribute se puede establecer o modificar un atributo interno de un campo en base al valor de otro dinámicamente.

Ejemplo

<field id="field_1" local="true">
      <valor>'color:red;'</valor>
</field>

<field id="field_2>
   <attribute id="style">field_1</attribute>  // el campo actual field_2 establecera el atributo style
                                                            // con el valor 'color:red;' del campo field_1
</field>

<setvar>

Setea el valor de una variable interna del contenedor segun el valor del campo.

limit="Límite de registros mostrados".

printer="Define una impresora".

procesa="Define el botón Procesa".

titulo_div="Titulo de la cabecera de una impresión".

tituloAbm="Titulo de un formulario tipo ABM".

xmlImpresion="Nombre del archivo XML utilizado para impresión".

Ejemplo

  <field id="titulo">
       <setvar>tituloAbm</setvar>
  </field>

Consulta

<condicion>

Agrega Una condicion al campo correspondiente. Se debe tener en cuenta que:

1. El campo que se utilizara debera tener el nombre de la tabla correspondiente. el nombre del campo.

Atributos

operador="=|>=|<=|!=|like" - Indica el operador de la condicion a aplicar en la consulta.

valorde="nombre_campo" - Indica de que campo tomara el valor para la condicion.

Ejemplo

<condicion operador="=">valor</condicion>

Validacion

<invalid>

Nos permite mostrar una advertencia despues de ingresar datos en formulario de forma temporal

Ejemplo

<field id="balancea" validar="true" noshow="true" deshabilitado="true" local="true">
        <label>Bal</label>
        <if  exp="DEB - HAB == 0 ">
          <true>'true'</true>
          <false>DEB - HAB</false>
        </if>
        <invalid>Minuta Desbalanceada</invalid>
</field>

Otros

<jseval>

Se utiliza para validar y calcular valores dinamicamente a otros campos.

Atributos

campodestino="nombre_campo" : Nombre del campo al que  validara o le dara el valor

actxml= "false|true" : Desactiva la actualizacion o refresco en ajax.

total="false|true" : Se refiere a la sumatoria del campo

Ejemplo

<field id="debe" suma="true" noZero="true" errorMessage="Mensaje">
        <label modpos="nobr">Debe</label>
        <jseval campodestino="haber">debe * 2 </jseval>
        <tipo>numeric</tipo>
</field>

Para Filtros Dinamicos :

<jseval campodestino="regcuenta_id" actxml="recibo_ingreso_deudores_varios_ing.xml">Cuenta</jseval>
 <jsfunction event="onchange">filtracampos('FFormrecibo_ingreso_deudores_varios_ing_xml' , 'recibo_ingreso_deudores_varios_ing.xml' );</jsfunction>

event="onchange|onsubmit|onclick|ondoubleclick|onload|onblur|onfous"

FForm="Nombre del Boton Filtro,seguido del Nombre del Xml y finalizando con "_xml "
Seguido de : "Nombre del XML"

<jsfunction>

Nos permite utilizar funciones de javascript

Atributos

event="onchange" - habilita el evento onchange.

Ejemplo

<jsfunction event="onchange">filtracampos('FFormorden_pago_grid_xml','orden_pago_grid.xml');</jsfunction>

<actualiza>

Se utiliza para indicar campos que son dependientes de uno del otro.

Atributos

id="nombre del campo del que depende".

destino="nombre del campo que recibira el valor".

Ejemplo

 <field id="art2" local="true" deshabilitado="true" noshow="true">
        <actualiza>
            <field  id="pos_costo" destino="idArticulo" />
            <field  id="talle"     destino="idArticulo" />
        </actualiza>
  </field>

<preparam>

Determina la condicion que debe cumplir los parametros que se pasaran a la consulta definida en la etiqueta <preconsultas>, se debe especificar cual sera el nombre del campo destino así como también el campo que sera usado como parametro.

Atributos

campo="campo_destino" - determina el nombre del campo destino del xml con el que se realizara la condicion.

operador="operador" - determina el el operador que se utilizara en la condicion.

Ejemplo

  <preparam campo="ejercicio_id" operador="=">true</preparam>

<helper>

Se utiliza para crear o referenciar un contenedor de datos en el campo pudiendo obtener datos dinamicamente o enlazar a otro xml. Estos pueden ser de varios tipos

Atributos

type="combo | external | object  | link "
id="NOMBRE_DE_TABLA" : Nombre de la tabla a consultar
xml=”nombre_Archivo.xml” : referencia el nombre del archivo externo xml que contiene la consulta a realizar para obtener los datos.
dir="directorio" - Nombre opcional de directorio. es relativo al directorio actual. Si empieza con / se considera path  absoluto en relacion al directorio base de los xml.

Atributos para tipo =“combo”

empty  = "true" establece la primera opcion del combo como vacia.

Atributos para tipo =“link”

title  = "titulo del boton"
width  = "ancho de la ventana a generar"
height ="alto de la ventana a generar"
reposition ="true|false" - Ubica la ventana generada cercana al objeto que inicia el evento
tag ="a" o "button" - Utiliza un botón o un enlace tradicional para representar el vinculo externo

Ejemplo Tipo combo con opciones Fijas

<helper type="combo" >
   <option value="0">No</option>
   <option value="1">Si</option>
</helper>

Ejemplo Tipo combo dinámico En el primer caso usamos un XML ya existente para llenar el combo con lo que devuelve ese XML (generalmente un XML de tipo consulta)

<helper type="combo" xml="nombre_archivo.xml" [dir="directorio"] [empty="true"] />
Si necesitamos extender los campos que contiene el combo (para filtros por ejemplo) o para pasarlos como parametros al contenedor de ese combo, agregamos tags field dentro del mismo.

<helper type="combo" xml="nombre_archivo.xml" dir="directorio opcional">
    <field id="campo_condicional">
          <condicion operador="=">1</condicion>
    </field>
    <order>
    <field id="campo_opcional" table="TABLA"></field>
    </order>
</helper>

Alternativamente se puede utilizar directamente la tabla para construir el combo sin necesidad de recurrir a un XML de ayuda.

<helper type="combo" id="TABLA">
    <field id="campo_clave" />
    <field id="campo_descripcion" />
</helper>
Ejemplo Tipo Ayuda Externa
<helper type="external" xml="nombre_archivo.xml" dir="directorio opcional">
    <field id="campo_opcional"></field>
    <order>
    <field id="campo_opcional" table="TABLA"></field>
    </order>
</helper>

Ejemplo Tipo object

<helper type="object" xml="nombre_archivo.xml" dir="directorio">
   <parameter source="campo origen" target="campo destino" operator="="/>
</helper>

Ejemplo Tipo link

<helper type="link" xml="nombre_archivo.xml" dir="directorio">
   <parameter source="campo origen" target="campo destino" operator="="/>
</helper>

El campo del boton debe contener un <valor> o <expresion> sino no se muestra

Ejemplo tipo Parameter

<helper type="parameter" id="SIS::22::habilito_desc1" >
    <label>Nota de Pedido: Deshabilito 1er Descuento</label>
    <defaultValue>false</defaultValue>
</helper>