Manual IUX

A.F.P. HABITAT S.A.
1

Manual IUX

Versin
Creado por:
Fecha creacin
ltima modificacin
2.6
Sergio Sivori D.
Noviembre 2002
27-09-2004 15:17

A.F.P. HABITAT S.A. 2

ndice
Manual IUX __________________________________________________________________1
ndice _______________________________________________________________________2
1. Qu es IUX _________________________________________________________________5
2. Lenguaje ___________________________________________________________________6
Componentes IUX _________________________________________________________________ 6
Sintaxis General ___________________________________________________________________ 6
Tipo de indentificadores ____________________________________________________________ 7
3. Creacin de Pginas__________________________________________________________8
Ubicacin del Servidor Web _________________________________________________________ 8
Documento IUX ___________________________________________________________________ 8
Ejecutar y modificar Pginas IUX____________________________________________________ 8
4. Referencia de identificadores IUX_______________________________________________9
Archivo __________________________________________________________________________ 9
Bloque (Contenedor) _______________________________________________________________ 9
Campo__________________________________________________________________________ 10
Chequeo ________________________________________________________________________ 10
Columna ________________________________________________________________________ 11
Columnas (Tabulador) ____________________________________________________________ 11
Comando (Comandos)_____________________________________________________________ 12
Comandos _______________________________________________________________________ 13
Contenedor ______________________________________________________________________ 13
Controles________________________________________________________________________ 14
Detalle (Tabulador) _______________________________________________________________ 15
Div _____________________________________________________________________________ 16
Edicion _________________________________________________________________________ 17
Elemento (Informes) ______________________________________________________________ 18
Encabezado (Informes) ____________________________________________________________ 18
Estilo ___________________________________________________________________________ 19
Evaluar _________________________________________________________________________ 20
Fila_____________________________________________________________________________ 20
Formulario ______________________________________________________________________ 21
Funciones (Menus)________________________________________________________________ 22
Grupo __________________________________________________________________________ 23
Iterador_________________________________________________________________________ 24


Imagen _________________________________________________________________________ 25
Informe _________________________________________________________________________ 25
Leyenda_________________________________________________________________________ 26
Marco __________________________________________________________________________ 27
Menu ___________________________________________________________________________ 27
Menus __________________________________________________________________________ 28
Opcion__________________________________________________________________________ 28
Opciones (Menus) ________________________________________________________________ 29
Parametro_______________________________________________________________________ 30
Parrafo _________________________________________________________________________ 31
PiePagina (informe) _______________________________________________________________ 31
Portal___________________________________________________________________________ 32
Portlet __________________________________________________________________________ 32
QuiebrePagina (informe) __________________________________________________________ 32
Radio___________________________________________________________________________ 33
Region __________________________________________________________________________ 33
Rotulo __________________________________________________________________________ 34
Scripts __________________________________________________________________________ 34
Seccion _________________________________________________________________________ 35
Seleccion ________________________________________________________________________ 35
Separador _______________________________________________________________________ 36
Sesion __________________________________________________________________________ 36
Si ______________________________________________________________________________ 36
SiNo____________________________________________________________________________ 37
Sql _____________________________________________________________________________ 37
SubMenus (Descontinuado) ________________________________________________________ 38
Tabulador_______________________________________________________________________ 39
Texto ___________________________________________________________________________ 40
UtilScripts_______________________________________________________________________ 40
Var_____________________________________________________________________________ 41
Xml ____________________________________________________________________________ 41
5. XML como fuente de datos ___________________________________________________42
Formas de recuperar datos _________________________________________________________ 42
Asociar datos con elementos IUX____________________________________________________ 43
Donde ejecutar el Resultado ________________________________________________________ 44
Actualizacin de datos_____________________________________________________________ 44
Utilidad oXML___________________________________________________________________ 45


Atributos_______________________________________________________________________________45
Constantes______________________________________________________________________________45
Mtodo ________________________________________________________________________________45
6. Informes __________________________________________________________________46
7. Implementar Eventos ________________________________________________________47
Evento Constructor _______________________________________________________________________47
Evento FormCambio______________________________________________________________________47
Evento xmlPosicionar_____________________________________________________________________48
8. Utilidad oUrl (Navegacin entre pginas) _______________________________________49
Atributos_______________________________________________________________________________49
Constantes______________________________________________________________________________49
Mtodos________________________________________________________________________________50
9. Utilidad oForm (Control de Formularios) _______________________________________51
Mtodos________________________________________________________________________________51


1. Qu es IUX
IUX significa Interfaz de Usuario eXtensible y es una tecnologa que permite la construccin de pginas
Web. Se focaliza en la presentacin de las aplicaciones, con funcionalidades adicionales que hacen
extender la forma de cmo se presenta la informacin.

Caractersticas principales de IUX son: fcil de usar, permite definir pantallas estndar, es adaptable a
futuras tecnologas, es multi-plataforma, etc.

Fcil de usar
Dado que su dialecto lo componen pocos elementos, es rpido de aprender, adems puede proveer
mltiples funcionalidades con una sola declaracin. Esto es anlogo a los comandos de bases de datos
SQL. Al ser fcil de usar, el analista que recoge los requerimientos de los usuarios, no necesita tener
conocimientos de programacin avanzados para poder implementar una solucin con esta herramienta.

Pantallas Estndares
Los estilos y los colores no forman parte de lo que se puede definir dentro del lenguaje IUX, estos vienen
implcitos dentro de cada identificador.

Adaptable a futuras tecnologas
Uno de los principales problemas que enfrentan hoy en da las empresas donde se implementan software
computacional, es la adaptacin a las nuevas tecnologas. La necesidad surge, en general, porque
proveen mejores soluciones a lo que se tiene, pero el costo en tiempo y dinero puede ser alto
(aprendizaje, infraestructura, conversin, etc.) y el problema se incrementa dado que pasado un tiempo
relativamente corto, la nueva tecnologa adoptada pasa a ser superada por otra.

IUX no pretende solucionar todo lo anterior, pero permite que los costos se reduzcan. Porqu, debido a
que es un lenguaje que se puede extender o repotenciar sin volver a desarrollar lo construido. Adems
puede permitir mltiples salidas. Actualmente la salida es HTML y PDF, pero dependiendo del dispositivo
u otra identificacin, podra emitir XHTML, XML, formato WARP, u otro formato con la misma definicin
implementada.

IUX est desarrollado con el lenguaje de programacin J ava, de l cual es dependiente, pero tambin
puede ser reemplazado por otro (ej. .NET) conservando el mismo dialecto.

Multi-plataforma
IUX al estar desarrollado en J ava, permite ser ejecutado en distintas plataformas (Windows, Linux, Unix,
Mac).


2. Lenguaje
IUX es un lenguaje de identificadores basado en XML. Los identificadores son nodos jerrquicos, que van
definiendo los distintos elementos visuales de una pgina Web.
Componentes IUX
El IUX est compuesto de declaraciones, identificadores y propiedades.

Las declaraciones son definiciones iniciales que le indican al servidor Web como interpretar los
identificadores IUX. Tambin permiten enlazar objetos externos y otras funcionalidades.

Los identificadores, son los constructores de los distintos elementos visuales que componen una pgina
Web y es el elemento central del lenguaje IUX.

Las propiedades son parte de los identificadores y permiten definir especificaciones o modificar el
comportamiento de un identificador.
Sintaxis General
El IUX al ser un lenguaje basado en XML, cumple la misma regla que este, una palabra clave
(identificador) se utiliza para marcar secciones de un documento IUX.

Un identificador tiene la siguiente forma:


[ Cont eni do]


La declaracin inicial de un identificador est compuesto de <iux: seguido por el nombre del identificador.

Las propiedades estn dentro del demarcador inicial del identificador, y permiten agregar informacin
descriptiva a l. El nombre de una propiedad debe estar en minscula seguido por el signo (=), ms una
cadena de caracteres entre comillas, el cual representa el valor que toma la propiedad. Algunas
propiedades son opcionales (otras no), eso depende del identificador que se est implementando.

El contenido se refiere a otros identificadores. Por lo tanto, los identificadores pueden anidarse.

No todos los identificadores pueden anidar a otros identificadores, los cuales su trmino se puede
delimitar con el signo />. Esto tendra la siguiente forma:




Una estructura IUX de ejemplo sera:


















Tipo de indentificadores
Existen 4 tipos de identificadores: marcos, contenedores de controles, controles, e identificadores
independientes.

Los marcos, son un grupo de identificadores cuyo propsito es definir un bloque o rea de pantalla.
Existen por el momento tres marcos, los identificadores Portal, Region y Portlet. En la jerarqua IUX, el
elemento inicial que debe contener un documento, es un identificador tipo marco.

Los contenedores de controles, permiten tabular bloques de informacin de distinta forma. Este grupo
est conformado por formularios de datos, listas tabuladas (grillas), comandos o enlaces de palabra, etc.

Los controles, son la unidad mnima de IUX, y representan a diversos objetos visuales. Este grupo est
conformado por cajas de edicin, cajas de lista, cajas de chequeo, textos, seleccin, etc.

Los identificadores independientes, son una especie de identificadores comodines que permite ordenar
de mejor forma el dibujo de una pantalla. Este grupo, por el momento est conformado por un separador
de contenedores de controles. A futuro, la definicin se extender a la de agregar efectos visuales en las
pantallas.


3. Creacin de Pginas

Ubicacin del Servidor Web
Lo primero a considerar, es conocer la ubicacin fsica (directorio) en el servidor Web donde se pueden
crear los archivos IUX. Esta informacin la proveer el administrador Web.

Para que IUX funcione, debe implementarse en un archivo de texto con extensin J SP (.jsp) ubicado
fsicamente en un directorio reconocible por un servidor Web OC4J Tambin debe estar bien estructurado
y su sintaxis debe ser estrictamente correcta.

Ejemplo: W:\desa\hab\mantencion\html\persona.jsp
Documento IUX
Como se menciono, el primer componente de este lenguaje son las declaraciones. La declaracin
obligatoria es la siguiente:

<%@t agl i b ur i =" ht t p: / / www. af phabi t at . cl / syd/ i ux" pr ef i x=" i ux" %>

Con esta declaracin, al servidor Web se le indica como interpretar los identificadores IUX.

El siguiente paso es utilizar los identificadores.
Ejecutar y modificar Pginas IUX
Para ejecutar un documento IUX, es necesario invocarlo a travs de un explorador Internet y especificar
la direccin Web donde se encuentra nuestra pgina.

Ejemplo:
http://desant.afphabitat.cl:8888/desa/servlet/sistema/subsistema/pagina.jsp

Al invocar la pgina, aparecer el resultado de lo creado.

Es posible modificar el contenido del archivo y refrescar con el botn Actualizar del explorador Web.


4. Referencia de identificadores IUX
A continuacin, se describe el propsito y las propiedades de todos los identificadores IUX disponibles.
Archivo
Propsito:
Permite dibujar un control con una caja de edicin y un botn para seleccionar un archivo. Este control se
utiliza generalmente, para pedirle al usuario un archivo para cargar o bien, especificar un directorio y un
nombre de archivo.

Propiedades:
Propiedad Propsito Obligatorio Valores posible
nombre identificador nico del elemento Si caracteres
rotulo Indica el nombre que aparecer junto a
este control
No caracteres
ancho Indica el ancho del bloque No nmero
maximo Indica nmero mximo de caracteres que
se pueden digitar en la caja de edicin
No nmero
lectura Indica si se habilita la edicin de este
campo.
No [No] | Si
valor Especifica el valor que contiene la caja de
edicin por omisin
No caracteres
requerido Indica si el campo es obligatorio que
contenga datos
No [No] | Si

Ejemplo:


Bloque (Contenedor)
Propsito:
Depende del identificador iux:Contenedor, y permite definir un grupo de controles (formulario, tabulador,
leyenda, etc.) que va a contener.

Propiedades:
rotulo Indica el nombre que aparecer como ttulo
de la aleta del contenedor
Si caracteres
alinear indica la justificacin de los valores
contenidos en la columna
No caracteres


Ejemplo:













Campo
Propsito:
Este marco depende del identificador <iux:Fila>y permite especificar la seccin de edicin con ms de un
identificador.

Propiedades:
nombre identificador nico Si caracteres

Ejemplo:












Chequeo
Propsito:
Permite dibujar un control de edicin Caja de chequeo. La representacin visual de esto es, un cuadro de
edicin que al hacer clic se marca o desmarca..

Propiedades:
este control
No caracteres
xml Especifica el dato de origen que se utilizara
para marcar o no este elemento
No caracteres
contenga datos
No [No] | Si


Ejemplo:


Columna
Propsito:
Este marco depende del identificador <iux:Columnas>(del <iux:Tabulador>) y permite especificar una
columna dentro de un tabulador.

Propiedades:
enlace Indica funcin javascripts a ejecutar al
hacer clic en enlace del valor de la columna
especificada
No Caracteres
este control
No Caracteres
formato Indica el tipo de dato que se hospedar
dentro de la columna
No [Carcter] | Numero | Fecha
alinear Indica la justificacin de los valores
contenidos en la columna
No [Izquierda] | Centro |
Derecha
propiedades Permite definir atributos dependiendo del
control del cual es asociado
No ESTILO | TOTALIZA
totales Especifica si al final del tabulador se
incorporar una fila de totales y si la
columna en particular aparecer un valor
OPERACION:sumar;
ROTULO:<caracteres>
ESTILO:EstiloCelda

Ejemplo:

Columnas (Tabulador)
Propsito:
Este marco depende del identificador <iux:Tabulador>y permite especificar un conjunto de columnas
dentro de un tabulador. Tambin se pueden definir dentro de este elemento uno o ms elementos de este
tipo, representando columnas anidadas para agrupar los ttulos de informacin relacionada.

Propiedades:
titulos Indica si aparece como ttulos de columna
en <iux:Tabulador>
No [Si] | No
alinear Indica la alineacin de los ttulos de
columnas
Derecha


Ejemplo:












Comando (Comandos)
Propsito:
Permite definir un enlace al identificador <iux:Comandos>.

Propiedades:
rotulo Indica el nombre que aparecer subrayado
o en el botn
Si caracteres
url Se especifica la ruta de enlace a otra
pgina
No URL
comentario Se especifica un conjunto de caracteres
que indican el propsito del comando. Este
comentario se desplegar, en el caso de un
botn, al pasar con el mouse por este
elemento visual.
No caracteres

Ejemplo:






Comandos
Propsito:
Permite dibujar un bloque de enlaces especificados por uno o ms identificadores <iux:Comando>.

Propiedades:
ancho Indica el ancho del elemento No Nmero
tipo Indica si se representa como botn o
enlace
No [Boton] | Link
enlace Identifica la funcin javascripts que se
ejecutar al momento de seleccionar un
iux:Comando. La funcin se debe
implementar en un archivo javascripts
asociado a la pgina con un argumento de
entrada.
No caracteres

Ejemplo:




. .
. .

f unct i on Opci ones ( opc) {
i f ( opc == af i l i ado)
al er t ( Sel ecci on el bot n Maest r o de Af i l i ado. ) ;
el se i f ( opc == cer t i f i cado)
al er t ( Sel ecci on el bot n Cer t i f i cado de Sal do. ) ;
}
Contenedor
Propsito:
Permite dibujar un seleccionador de bloques de informacin. Est compuesto por uno o ms bloque, los
cuales se muestran uno a la vez. .

Propiedades:
titulo Indica el ttulo que aparece en este
identificador
Si caracteres
alto Indica el alto del elemento en pxeles No nmero
ancho Indica el ancho del elemento en pxeles No nmero
orientacin Indica la forma de presentar las alternativas No Vertical


Ejemplo:












Controles
Propsito:
Permite agrupar identificadores como <iux:Formulario>que contengan cajas de edicin. La funcin que
cumple es poder enviar el contenido a otras pginas o servidor de Web. Tambin se utiliza para
referenciar los controles a travs de javascripts con la utilidad oForms o instrucciones directas como
document.form[nombre-control].<nombre-elemento >.value.

Propiedades:
tipo Indica la forma como enva al servidor los
datos de edicin que contiene. El tipo F es
el modo normal, el cual en el servidor, se
puede obtener el valor con
request.getParameter(control). El tipo A,
es para obtener contenidos de archivos.
Este ltimo tipo, se debe hacer una funcin
ad-hoc para obtener el contenido del
archivo
No [F] | A


Ejemplo:


<i ux: For mul ar i o nombr e=" car t ol aar ch" t i t ul o=" Sel ecci n Ar chi vo" r ot ul os=" Lado"
f i j o=" No" pr opi edades=" ALTO: 5; ESPACI ADO: 2"
f i l ai mpar =" ESTI LO: Dest acada" sombr eado=" Si " >


















. . .
. . .

f unct i on Comandos( opci on) {
i f ( opci on == acept ar ) {
al er t ( El ar chi vo sel ecci onado es + document . f or ms[ ar ch] . ar chi vo. val ue) ;
}

Detalle (Tabulador)
Propsito:
Permite definir una seccin de detalle dentro del identificador iux:Tabulador. Este identificador debe
especificarse en el mismo nivel y despus del identificador iux: Grupo. El efecto es una presentacin tipo
maestro, detalle para informes.

Ejemplo:




















Div
Propsito:
Este identificador permite ocultar y mostrar un conjunto de identificadores visuales. Generalmente se
utiliza con la funcin javascripts Di vEsconder , la cual oculta o muestra lo que contiene este identificador..

Propiedades:
alinear J ustificacin de los controles contenidos No [Izquierda] | Centro |
Derecha
esconder Indicasi muestra u oculta el bloque de
controles inicialmente
No [No] | Si
titulo Rtulo que aparece al pasear el Mouse
dentro del bloque
No caracteres

Ejemplo:






















En J avaScripts:
Di vEsconder ( " Di vLot e" , t r ue) ;


Edicion
Propsito:
Permite dibujar un control de edicin. La representacin visual de esto es, un cuadro de edicin.

Propiedades:
este control
No caracteres
valor Cadena de caracteres que se presentan
dentro del cuadro de edicin
No caracteres
alinear J ustificacin de los caracteres dentro de la
caja de edicin
Derecha
maximo Indica nmero mximo de caracteres que
se pueden digitar en la caja de edicin
No nmero
formato Especifica el formato de informacin que se
edita. Los formatos disponibles son:
@N =Nmero
@! =Mayscula
@F =Fecha
No @N<n>| @NS <n>| @! |
@F
filas Indica el nmero de lneas que se podr
admitir en la edicin
No nmero
para mostrar en la caja de este elemento
No Caracteres
modo Define el estilo de edicin No [Normal] | Area | Password
lectura
contenga datos
No [No] | Si
filas Para el modo Area, especifica la cantidad
de filas que va ha tener este elemento
No caracteres

Ejemplo:














Elemento (Informes)
Propsito:
Permite modificar propiedades de estilo de un identificador cuando se est en modo de informe.

Propiedades:
nombre Es el nombre del identificador iux que se
desea cambiar el estilo. Los elementos
validos para modificar son iux:Formulario y
iux:Tabulador
Si caracteres
propiedades Especifica la propiedad que toma el
identificador nombrado en modo de
impresin. El valor que puede
especificarse, es el mismo que puede
contener la propiedad propiedades del
identificador sealado
Si caracteres

Ejemplo:





Est e es un ej empl o de r epet i ci n por pgi na en el encabezado





Encabezado (Informes)
Propsito:
Permite agrupar identificadores que se repetirn en el encabezado de cada pgina impresa.

Ejemplo:


















<i ux: For mul ar i o nombr e=" car t ol aar ch" ancho=" 0" t i t ul o=" Ant ecedent es de Car ga"
r ot ul os=" Lado" f i j o=" No" pr opi edades=" ALTO: 4; ESPACI ADO: 2"
f i l ai mpar =" ESTI LO: Dest acada" sombr eado=" Si " >





. . .
. . .

Estilo
Propsito:
Permite definir la hoja de estilo en que se basaran los identificadores. La hoja de estilo es un archivo CCS
que contiene la definicin de colores, tamaos de letras y algunas formas..

Propiedades:
url Nombre de la hoja de estilo Si caracteres
propiedades No utilizado por el momento No caracteres


Evaluar
Propsito:
Es un identificador condicional, el cual permite definir una variable que se puede consultar con el
identificador <iux:Si del cual es dependiente. El valor a especificar puede ser una constante, una variable
de sesin (sesion.variable) o una variable de traspaso (request.variable). Se puede colocar en cualquier
parte del cdigo.

Propiedades:
valor Se indica la variable a evaluar Si caracteres

Ejemplo:








t



Fila
Propsito:
Este marco depende del identificador <iux:Formulario>y permite especificar una fila de un formulario.
Puede contener controles o los marcos <iux:Rotulo>y <iux:Campo>.

Propiedades:
compuesto Indica que el rtulo y el campo se definir
en forma separada
No [No] | Si

Ejemplo:







Formulario
Propsito:
Permite dibujar un bloque tabulado en forma rectangular de controles. Cada fila de que posee el
formulario se especifica con el identificador <iux:Fila>.

Propiedades:
titulo Mostrar como encabezado el rtulo
especificado
No caracteres
ancho Indica el ancho del bloque. Si se especifica
0, asume el ancho del contenedor de
controles (otros identificadores del mismo
nivel) mayor
No nmero
sombreado Presenta al final del formulario un relieve
visual
No [Si] | No
rotulos Indica la posicin de los rtulos con
respecto al control
No [Lado] | Arriba
fijo Indica si las columnas tienen un mismo
ancho, tomado del control ms ancho
No [No] | Si
margen Intercala una lnea antes y despus No [No] | Si
modo Especifica si el formulario es de edicin o
consulta
No [Edicion] | Consulta
propiedades Especifica un conjunto de propiedades
separados por punto y coma
No MARCO:<carcter>;
TITULO:<Estilo Marco>;
ROTULOS:<Estilo rotulos>;
BORDE:<n>;
ESPACIADO:<n>;
ALTO:<n>
filapar Especifica conjunto de propiedades
separados por punto y coma para las filas
pares, empezando por la segunda
No ESTILO:<EstiloCelda>;
ALTO:<n>
filaimpar Especifica conjunto de propiedades
impares, empezando por la primera
ALTO:<n>
esconder Permite solo mostrar el ttulo del formulario
ocultando los controles. Al hacer clic en el
ttulo, los controles se muestran.
No [No] | Si

Ejemplo:








































Funciones (Menus)
Propsito:
Define un men de tipo tabular. Las opciones se especifican con el identificador <iux:Menu>o con el
identificador <iux:Xml>. Este identificador depende del identificador <iux:Region>, justo debajo de
<iux:Mens>. Esta es una versin mejorada del identificador iux:SubMenus. Al ejecutar por primera vez
este identificador, se pueblan las opciones a travs del xml, en forma manual (iux:men) o por la
propiedad url. Durante la sesin, este identificador recuerda el doblamiento inicial, es decir, en las
siguientes pginas que se invocan, la recuperacin de las opciones no es necesario. Esto es vlido
cuando se navega dentro de un mismo subsistema. Al especificar el atributo refrescar, se obliga a volver
a recuperar las opciones.


Propiedades:
comentario Descripcin de la funcin. Aparece al
pasear el Mouse en la opcin.
No caracteres
para poblar el elemento
No caracteres
identificador Opciones de la funcin identifica un nico
nombre por Men
No caracteres
rotulo Columna asociada del <iux:Xml>que
muestra como rtulo nico
No Caracteres
url Columna asociada del <iux:Xml>que indica
la accin a tomar al hacer clic sobre el
rtulo
No URL
modo Indica la forma como se construye la ruta
de acceso a otra pgina. Si es Servlet, la
peticin se realiza a un controlador Web Si
es relativa, se invoca directamente la
pgina
No [Servlet] | Relativo
refrescar Vuelve a conformar las opciones No S | [No]

Ejemplo:






...
...

Grupo
Propsito:
Permite definir una seccin de grupo dentro del identificador iux:Tabulador. Este identificador est
asociado lal identificador iux:Detalle, y representa un corte de grupo dentro de la lista segn el atributo
criterio.

Propiedades:
criterio Se especifica una o ms columnas vlidas
de un xml que son repetitivas por detalle
Si caracteres
propiedades Definicin de estilos No caracteres


Ejemplo:















<i ux: Col umna nombr e=" dt ot al _f p" r ot ul o=" Tot al FP" ancho=" 10"



Iterador
Propsito:
Permite repetir un xml por cada fila que este tenga, el conjunto de identificadores que dependen de l.
Para hacer referencia a la fila actual, los controles dependientes, en su respectivo atributo xml, debe ser
el nombre del Iterador.

Propiedades:
nombre Indica el nombre nico, el cual sirve como
referencia xml para los identificadores
dependientes
Si caracteres
xml Especfica el dato de origen que se utilizara
para recorrerlo fila a fila.
Si caracteres

Ejemplo:



MOVI MI ENTO CAJ A @[ sesi on. pcFecMovt o] 
 FECHA CI ERRE @[ sesi on. pcFecEst ado] 









Imagen
Propsito:
Permite colocar una imagen en la pantalla. El archivo .gif, se debe ubicar en el directorio central de
imgenes (contexto/utl/servicio/imagenes/)

Propiedades:
nombre Indica el nombre de la imagen que
fsicamente debe estar en la URL con
extensin .gif
Si caracteres
ancho Indica el ancho de la imagen No nmero
Rotulo Indica el nombre que aparecer junto a
este control
No caracteres
Enlace Especifica una funcin javascripts que se
ejecuta al seleccionar la imagen con un
click
No caracteres

Ejemplo:


Informe
Propsito:
Permite definir en una pgina, las configuraciones en modo de informe. Las pginas iux pueden estar en
dos modos: normal o informes. Una pgina iux normal, los identificadores tienen un comportamiento
visual distinto al de modo de informe. El modo normal, la pgina se invoca en forma directa, para
invocarla en modo informe, se debe utilizar la instruccin javascripts: oUrl.Informe(pagina).

El iux:Informe y sus dependientes solo se ejecutan al momento que la pgina est en modo de informe
(en modo normal, no tienen ningn efecto).

Propiedades:
titulo Se indica la variable a evaluar Si caracteres
pie Indica si por cada pgina aparecer el pie
de pgina pre-definido
No [Si] | No
propiedades Reservado para uso futuro

Ejemplo:





Leyenda
Propsito:
Permite dibujar un bloque de texto compuesto de prrafos. Cada prrafo se define con el identificador
<iux:Parrafo>..

Propiedades:
ancho Indica el ancho mximo de la leyenda No nmero
alinear J ustifica los parrafos segn lo indicado en
este atributo
No [Izquierda] | J ustificado |
Centro | Derecha
estilo Especifica el formato de los prrafos No caracteres
para reemplazar partes del texto. El texto
dentro de un prrafo indicado como
@[atributo-xml] se reemplazar por el valor
contenido en el atributo del xml
especificado
No caracteres

Ejemplo:

Cer t i f i cado de Cot i zaci ones Pr evi si onal es Pagadas


 Fecha de Emi si n : @[ f echa] 


 
A. F. P. Habi t at S. A. , cer t i f i ca que a l a f echa de emi si n del pr esent e document o, el
empl eador @[ nom_emp_em] , RUT @[ r ut _emp] . 



Ha pagado l as cot i zaci ones pr evi si onal es per t eneci ent es al af i l i ado Sr . @[ nombr e_mae] , RUT
@[ r ut _af i ] , de acuer do al si gui ent e det al l e: 



Marco
Propsito:
Construye una regin dentro de la pgina donde se carga una nueva pgina. Ambas pginas son
independientes.

Al especificar en la propiedad pagina una pgina, esta se busca en el directorio relativo a la pgina
padre.

Propiedades:
url Indica la ruta completa donde se ubica la
pgina (protocolo, host, puerto, contexto,
etc).
No [Izquierda] | J ustificado |
Centro | Derecha
pagina Indica la pgina que se va ha cargar en el
marco. La pgina debe tener la extensin y
cualquier parmetro seguido del signo de
interrogacin. En caso de ser indicado la
propiedad xml, se especifica el atributo del
xml que contiene la pgina a invocar.
No caracteres
para ser usado como valor por la propiedad
pagina.
No caracteres
alinear Indica el tipo de alineacin del marco [Izquierda] | Centro |
Derecha
ascensor Especifica si el marco tiene o no barra de
desplazamiento horizontal y/o vertical si el
contenido es mayor al tamao del marco
No [Si] | No
ancho Determina el ancho en pxeles del marco No [700]
alto Determina el alto en pxeles del marco No [500]
propiedades Define caractersticas especiales al marco No caracteres

Ejemplo:

Menu
Propsito:
Define las opciones de los identificadores <iux:Menus>e <iux:SubMenus>.

Propiedades:
rotulo Especifica el texto que se muestra como opcin. No caracteres
comentario Indica una explicacin de la opcin No caracteres
sistema Indica el sistema el cual pertenece la opcin No caracteres
subsistema Indica el subsistema el cual pertenece la opcin No caracteres
url Indica la accin a tomar al hacer clic sobre el rtulo No URL
activo Especifica si la opcin es la actualmente
seleccionada
No [No] | Si
imagen Especifica el nombre de una imagen disponible en el
directorio general \imagenes. El nombre fsico debe
comenzar con mnu-
No caracteres


Ejemplo:












Menus
Propsito:
Define un men de tipo pestaa. Las opciones se especifican con el identificador <iux:Menu>

Propiedades:
nombre identificador nico Si Caracteres
ruta Indica si despliega los link de las pginas
visitadas dentro de la funcin
No Caracteres
No caracteres

Ejemplo:







Opcion
Propsito:
Permite definir una opcin dentro de una seleccin. Este control depende del identificador
<iux:Seleccion>.


Propiedades:
valor Se especifica el valor interno que tomar el
control. Si se indica el atributo xml, se
especifica el nombre de la columna que
contiene el valor del xml origen
Si caracteres
rotulo Se especifica la decodificacin del valor. Si
se indica el atributo xml, se especifica el
nombre de la columna que contiene el
rtulo del xml origen
Si caracteres
No caracteres

Ejemplo:









Opciones (Menus)
Propsito:
Muestra un conjunto de opciones que se pueden ejecutar dentro de la pgina actual. Es anlogo al
identificador iux:Comandos. Este identificador se especifica dentro del identificador iux:Menus. Y las
opciones se definen con el identificador iux:Menu.

Propiedades:
enlace Identifica la funcin javascripts que se
ejecutar al momento de seleccionar un la
opcin. La funcin se debe implementar en
un archivo javascripts asociado a la pgina
con un argumento de entrada el cual indica
el nombre de la opcin seleccionada.
No caracteres


Ejemplo:







<i ux: Menu nombr e=" i nf o2" r ot ul o=" I nd. Si n Cuent a"
<i ux: Menu nombr e=" i nf o3" r ot ul o=" Movt o. Per sonal "







Parametro
Propsito:
Este identificador depende de iux:Xml y permite especificar un parmetro que se incorporar en el
llamado al dato de origen.

Propiedades:
nombre Identifica el nombre del parmetro. Este
nombre debe ser igual al nombre definido
en el package.modulo que se invoca en
iux:Xml si este est en modo pkg.
Si caracteres
valor Es el valor que toma el parmetro. Si caracteres
omision En caso que el valor especificado est
vaci, el valor tomado ser el de esta
propiedad
No caracteres

Ejemplo:






Parrafo
Propsito:
Permite definir una frase dentro de una leyenda. Este control depende del identificador <iux:Leyenda>.

Propiedades:
para poblar el elemento.
No caracteres
contenido Especifica el nombre de la columna que
contiene el valor del xml. Por cada registro
del xml, este elemento crea un nuevo
prrafo
No caracteres

En el contenido de este identificador se pueden colocar etiquetas para definir distintos comportamientos
del texto. Lo siguiente es una tabla con las etiquetas disponibles:

Etiqueta Propsito
<A HREF=URL><A> Define un enlace
 Salto de lnea
<HR> Regla horizontal
 Fuente negrita
 Fuente cursiva
<TT></TT> Fuente ancho fijo
<LI> Elemento de lista
<UL></UL> Lista no numerada
<IMG SRC=URL> Imagen
@[xml-atributo] Cuando <iux:Parrafo depende de un <iux:Leyenda que tiene un
dato de origen (xml), se puede especificar dentro de <iux:Parrafo
esta etiqueta. Considerar que el <iux:Xml asociado, debe tener la
propiedad ejecucion=Servidor.

@[session.atributo] y
@[request.atributo]
En ambos casos se reemplaza segn lo que contenga el atributo
almacenado en la sesin y request.

Ejemplo:


En el cost ado i zqui er do apar ecen l as f unci ones di sponi bl es dent r o de est e si st ema, par a
act i var l as, ubi que el punt er o del r at n sobr e una de el l a y l uego haga cl i c

La Opci n Asi gnaci n de Usuar i o per mi t e def i ni r por l ot e er r neo el usuar i o encar gado de su
cor r ecci n.

PiePagina (informe)
Propsito:
Agrupa un conjunto de identificadores iux que se mostrarn en el pie de pgina de cada pgina impresa.
Este identificador depende de iux:Informe y es anlogo al iux:Encabezado y solo tiene efecto cuando la
pgina que lo contiene es invocado en modo de impresin.
.


Ejemplo:


Est e pr r af o se r epet i r en el pi e de cada pgi na i mpr esa

Portal
Propsito:
Delimitar un bloque relacionado de informacin de tipo global. Este identificador debe ser el primero en el
lenguaje iux..

Propiedades:
inicio Se especifica la url del
sistema/subsistema/pagina.jsp que se
invocar si la sesin no est disponible. Se
especifica @pagina si es la pagina inicial
donde se implementa
Si caracteres
especificado
No caracteres
ancho Indica el ancho del bloque No Nmero
Derechos Licencia de uso No AFP HABITAT S.A.

Ejemplo:

Portlet
Propsito:
Delimitar un bloque relacionado de informacin

Propiedades:
especificado
No caracteres
modo Indica el ambiente de ejecucin, desarrollo
o explotacin.
No [D] | E
estilo Indica el tipo de formato visual No [Portal] | Normal
derechos Licencia de uso No AFP HABITAT S.A.

Ejemplo:

QuiebrePagina (informe)
Propsito:
Genera un quiebre de pgina en cualquier parte de la pgina. Este elemento no tiene propiedades, ni
depende de otro elemento y solo tiene efecto en modo de impresin.

Ejemplo:



Radio
Propsito:
Permite dibujar un control de edicin tipo Radio Buttom. La representacin visual de esto es, un circulo
que al hacer clic se enciende o se apaga deseleccionando los iux:Radio del mismo nombre.

Propiedades:
nombre Identificador nico dentro del bloque de radio. Si caracteres
rotulo Indica el nombre que aparecer junto a este control No caracteres
valor Cadena de caracteres que se presentan dentro del
cuadro de edicin
No caracteres
xml Especifica el dato de origen que se utilizara como
valor. Si el atributo del xml contiene el valor
especificado en valor de este elemnto, el elemento se
encender. En caso contrario, no.
No caracteres
requerido Indica si el campo es obligatorio que contenga datos No [No] | Si
enlace Identifica la funcin javascripts que se ejecutar al
momento de hacer clic en este elemento. La funcin
se debe implementar en un archivo javascripts
asociado a la pgina con un argumento de entrada.
No caracteres

Ejemplo:


. .
. .

f unct i on Busqueda ( opc) {
i f ( opc == N)
al er t ( Buscar por nmer o. ) ;
el se i f ( opc == F)
al er t ( Buscar por f echa. ) ;
}

Region
Propsito:
Delimitar un bloque relacionado de informacin. Este identificador depende del identificador <iux:Portal>,
y de l depende el o los identificadores <iux:Seccion>. Por el momento, solo se puede definir un
<iux:Region>.

Propiedades:
nombre Mostrar como encabezado el rtulo
especificado
No caracteres
ancho Indica el ambiente de ejecucin, desarrollo
o explotacin.
No [D] | E


Ejemplo:


<RECORD r ot ul o=" Car ga de I nf or maci n" numr eg=" 1" / >
<RECORD r ot ul o=" Per mi t e Tr aspasas " numr eg=" 2" / >
<RECORD r ot ul o=" Pr econci l i aci n" numr eg=" 3" / >
<RECORD r ot ul o=" Per mi t e conci l i ar " numr eg=" 4" / >
<RECORD r ot ul o=" Asi gnaci n de Car ga" numr eg=" 5" / >
<RECORD r ot ul o=" Per mi t e def i ni r y asi gnar car ga" numr eg=" 6" / >










Rotulo
Propsito:
Este marco depende del identificador <iux:Fila>y permite especificar la seccin de texto con uno o mas
identificadores de tipo control .

Propiedades:
ancho Indica el ancho del bloque No numero

Ejemplo:




Scripts
Propsito:
Permite Invocar archivos con instrucciones javascripts. El archivo con extensin .js debe colocarse en el
directorio ../scripts relativo a la pgina. Cada pgina debe tener un archivo js asociado si se quiere
implementar mayor funcionalidad a la pgina.

Propiedades:
url Indica la ubicacin del archivo .js. En caso
que el archivo javascripts (.js) tiene el
mismo nombre que la pgina, se debe
especificar @pagina
Si URL


Nota: En esta versin no es soportado la definicin de javascripts dentro de la pgina.

Ejemplo:

Seccion
Propsito:
Delimitar un conjunto de <iux:Portlet>. Este identificador se utiliza para definir la forma de cmo se
agruparn los <iux:Portlet>. Cada <iux:Seccion>representa una fila dentro de una <iux:Region>.

Propiedades:
alinear Tipo de justificacin de los <iux:Portlet> No [Izquierda] | Centro |
Derecha

Ejemplo:














Seleccion
Propsito:
Este control permite definir una lista de opciones que se despliegan al hacer clic en la flecha del costado
derecho de la caja de edicin. Para definir las opciones, se utiliza en identificador <iux:Opcion>.

Propiedades:
este control
No caracteres
para seleccionar el elemento. El valor
contenido en el xml, debe ser uno que
coincida con un valor especificado en
iux:Opcion
No caracteres
lectura Indica si se habilita la edicin de este
campo.
No [Si] | No
contenga datos
No [No] | Si
valor Especifica el valor por omisin que tomar
la seleccin. El valor debe coincidir con un
valor especificado en iux:Opcion
No caracteres


Ejemplo:









Separador
Propsito:
Permite dejar espacios entre los identificadores de tipo contenedores de controles..

Propiedades:
alto Define el espacio entre identificadores Si nmero

Ejemplo:
Sesion
Propsito:
Redirecciona a una pgina de inicio, si al ejecutar la pgina que lo contiene, detecta que no hay sesin
vigente. Este identificador debe estar justo debajo del identificador <iux:Portal. Este identificador no es
neceario de implementar, ya que la misma funcionalidad se encuentra en <iux:Portal inicio=.

Propiedades:
url Especifica la pgina inicial de la aplicacin.
La estructura de esta propiedad es:
sistema/subsistema/pagina
Si Caracteres

Ejemplo:


. . .
. . .
Si
Propsito:
Es un identificador condicional, el cual depende de iux:Evaluar. Este identificador permite comparar un
valor de la propiedad es con el valor especificado en iux:Evaluar. Si es igual, el bloque de cdigo iux
que depende de este se ejecutar, en caso contrario, el cdigo se omite.
.


Propiedades:
es Identifica el valor que debe ser igual al valor
de iux:Evaluar, en caso contrario, no se
ejecutar el bloque de cdigo que contiene
este identificador
No caracteres
contiene Idem anterior, pero es verdadero si el valor
forma parte parcial del valor de iux:Evaluar
No caracteres
sensible Idem a la propiedad es, pero no discrimina
si es mayscula o minscula.
No caracteres

Solo una propiedad de las tres debe ser especificada.

Ejemplo:

e



e







SiNo
Propsito:
Este identificador depende de iux:Evaluar y ejecuta el bloque que tiene como contenido al fracasar los
iux:Si definidos antes que este.
.
Ejemplo:

e



e



t



Sql
Propsito:
Permite definir un comando SQL en el cuerpo de este identificador como dato de origen de un iux:Xml.
.
Propiedades:
cuenta Alias definido por el administrador del
sistema, el cual representa la configuracin
para poder realizar la conexin a la base de
datos de un esquema que contiene las
tablas que se referencia en el comando
SQL
Si Caracteres


Se debe considerar que al momento de calificar una columna en la instruccin WHERE del comando
SQL, cuando se hace la comparacin, si la columna es de tipo carcter, la condicin a evaluar debe ser
especificada entre comillas simple (en caso de nmero, no). Esto es vlido, tanto para datos constantes
como variables (ej. @[session.valor]).

Ejemplos:


SELECT sadi ob_mae obl , sadi vo_mae vol
FROM mae. maesaf i l
WHERE numr ut _mae = @[ sesi on. r ut ]





SELECT *
FROM ut l _pkg_modul o
WHERE i d_pkg = ' @[ sesi on. pkg- i d] '



SubMenus (Descontinuado)
Propsito:
Define un men de tipo tabular. Las opciones se especifican con el identificador <iux:Menu>o con el
identificador <iux:Xml>. Este identificador depende del identificador <iux:Region>, justo debajo de
<iux:Mens>

Propiedades:
Nombre identificador nico Si caracteres
Xml Especifica el dato de origen que se utilizara
No caracteres
identificador Columna asociada del <iux:Xml>que
identifica un nico nombre por Men
No caracteres
Rotulo Columna asociada del <iux:Xml>que
muestra como rtulo nico
No Caracteres
url Columna asociada del <iux:Xml>que indica
la accin a tomar al hacer clic sobre el
rtulo
No URL
modo Indica la forma como se construye la ruta
de acceso a otra pgina. Si es Servlet, la
peticin se realiza a un controlador Web Si
es relativa, se invoca directamente la
pgina
No [Servlet] | Relativo

Ejemplo:




...
...


Tabulador
Propsito:
Permite dibujar una lista de datos. Las columnas se definen con el identificador <iux:Columnas>

Propiedades:
especificado
No caracteres
ancho Indica el ancho del bloque. Si se especifica
0, asume el ancho del contenedor de
controles (otros identificadores del mismo
nivel) mayor
No nmero
filas Indica el nmero de filas (alto) que tiene el
tabulador. Adems, al ser mayor a 0,
incorpora un ascensor.
No nmero
para poblar el tabulador
No caracteres
sombreado Presenta al final de la grilla un relieve visual No [Si] | No
propiedades Especifica un conjunto de propiedades
separados por punto y coma
No MARCO:<carcter>;
TITULO:<Estilo Marco>;
ROTULOS:<Estilo rotulos>;
BORDE:<n>;
ESPACIADO:<n>;
ALTO:<n>
filapar Especifica conjunto de propiedades
pares, empezando por la segunda
ALTO:<n>
filaimpar Especifica conjunto de propiedades
impares, empezando por la primera
ALTO:<n>
sombreado Presenta al final de la grilla un relieve visual No [Si] | No
horizontal Establece si el ancho es visual o total No Si | [No]

Ejemplo:









Texto
Propsito:
Permite dibujar un texto dentro de un formulario. La representacin visual de esto es un cuadro de
edicin solo de lectura.

Propiedades:
este control
No caracteres
valor Cadena de caracteres que se presentan
dentro del cuadro de edicin no editable. El
valor no debe se especificado si se asocia
un xml
No caracteres
como valor para el elemento
No caracteres
alinear J ustificacin de los caracteres dentro de la
caja de edicin
Derecha
relieve Dibuja una caja de relieve que enmarca a
texto especificado en la propiedad valor
No [No] | Si

Ejemplo:

UtilScripts
Propsito:
Utilidades pre-definidas de tipo javascrits. Que permite enlazar los valores de una caja de lista
(iux:Seleccin) con valores de otro iux:Seleccin.

Propiedades:
tipo Indica el nombre de la utilidad o servicio.
En estos momentos solo se permite Enlace,
Si Enlace
para poblar el elemento.
Si caracteres
elemento Especifica el nombre del elemento o control
a manipular. En este caso, un control de
tipo <iux:Seleccin>
No caracteres
enlace Elemento padre ms un punto seguido por No caracteres


el identificador del el elemento padre.
rotulo Especificar campo asociado del xml para
ser mostrado
No caracteres
valor Especificar campo asociado del xml para
ser guardado dentro del control
No caracteres

Ejemplo:



Var
Propsito:
Definir en una variable javascripts dentro de una pgina con su respectivo valor. La variable es accesible
por cualquier funcin javascripts definida. Generalmente sirve para capturar valores de sesion o request.
.
Propiedades:
nombre El nombre de la variable Si caracteres
valor Valor que toma la variable. Puede ser una
constante o sesion o request
Si caracteres
tipo Indica el tipo de valor de la variable No [Caracter] | Numerico

Ejemplo:


Xml
Propsito:
Permite definir registros de datos para ser asociados a diferentes identificadores iux. Este identificador se
debe especificar al principio de la pgina, depende directamente de <iux:Portal>.

Propiedades:
nombre identificador nico con el cual se asocia
este elemento con otro identificador
Si caracteres
modo Indica la forma de cmo recuperar los datos Si [Central] | Servlet | Sql |
Interno | Local
url Indica el lugar donde ir a buscar los datos. No URL
ejecucion Determina el lugar donde se hospeda el
resultado
No [Servidor] | Cliente
registrar Indica si el resultado se puede referenciar
con la utilidad javascripts oXML
No [Si] | No
actualizar Indica si es actualizable el contenido No [No] | Si

Ejemplo:

SELECT *





5. XML como fuente de datos
Como se ha mencionado, el lenguaje iux posee de varios identificadores que construyen formas visuales
para representar informacin y poderla manipular. Estos identificadores, en su mayora, se les pueden
asociar datos dinmicos extrados de una fuente de base de datos o archivos. El formato xml es el medio
por el cual se pueden interpretar estos datos

El identificador iux:Xml es el instrumento que tiene el iux para recuperar la informacin. Este identificador
tiene una importancia relevante dentro del lenguaje iux, ya que permite enlazar datos con los distintos
identificadores iux.

Para poder utilizarlo, se debe comprender las distintas combinaciones que se pueden definir las
propiedades que posee este identificador.
Formas de recuperar datos
La recuperacin de datos se puede hacer de cinco manera, la cual es determinada por la propiedad
modo: Central, Servlet, Sql, Interno y Local.

Central: Los datos se van a buscar a un servidor central de xml. En este caso, en el atributo url se debe
especificar el nombre del package ms / ms el nombre del mdulo que hace la extraccin de datos
ms la extensin .pkg. El mdulo (objeto Oracle PL/SQL), generalmente es definido como una funcin
que devuelve un cursor, el cual es transformado en formato xml por el servidor central, para luego
retornarlo al cliente que los solicita (servidor web o el Explorador Internet). Para que esto suceda, el
package y mdulo debe estar catalogado en el servidor central. Este registro lo hace el administrador de
sistema. Para definir parmetros a los mdulos, se utiliza el identificador iux:Parmetros, donde el
nombre debe ser igual al nombre del parmetro que posee el mdulo..
Ejemplo:




Servlet: Los datos se van a buscar al servidor web que gestiona al subsistema. En este caso, en el
atributo url se debe especificar un nombre identificable por el servidor web. Para poder procesar este
requerimiento de datos, en el servidor de aplicaciones debe implementar la clase xml.Navegacion, la cual
es la encargada de realizar la tarea necesaria para devolver un xml vlido. En todo caso, se debe
considerar que en este lugar tambin se har una peticin al servidor central de xml pero con la
alternativa de invocar clases de negocio para poder complementar los datos.
Ejemplo:




Sql: Los datos se van a buscar a un servidor central de xml, pero a diferencia del modo central, el
servidor central ejecuta directamente en la base de datos el sql solicitado, convirtiendo el resultado en
xml para luego devolverlos a quien lo solicita. En este modo, se debe utilizar el identificador iux:Sql con la
propiedad cuenta especificada y en el cuerpo el comando Sql que se desea ejecutar. El valor que toma
la propiedad cuenta es un alias que detrs de l esta definido la configuracin necesaria para poder
conectarse a la base de datos (servidor, instancia, el usuario y la clave). Este alias es definido por el
administrador de sistemas, y el alcance es por sistema.
Ejemplo:

SELECT *




Interno: Los datos son definidos dentro de la pgina. Cada registro se debe especificar con <RECORD.
Ejemplo:

<RECORD col 1=Val 11 col 2=Val 12 col 3=Val 13 col 4=Val 14/ >


Local: Los datos se van a buscar a un archivo con el nombre especificado en la propiedad url. El archivo
debe tener la extensin .xml y se debe ubicar en el directorio dato del subsitema donde reside la pgina
que lo invoca. El contenido de este archivo debe regirse por la regla de conformacin xml.
Ejemplo:
Archivo sistema/subsistema/dato/eje.xml:
<?xml ver si on=" 1. 0" encodi ng=" I SO- 8859- 1" ?>
<DATA>
<RECORD r ot ul o=" Car ga" numr eg=" 1" / >
<RECORD r ot ul o=" Val i daci n" numr eg=" 2" / >
<RECORD r ot ul o=" Pr econci l i aci n" numr eg=" 3" / >
<RECORD r ot ul o=" Gest i n" numr eg=" 4" / >
<RECORD r ot ul o=" Asi gnaci n" numr eg=" 5" / >
<RECORD r ot ul o=" Par met r os" numr eg=" 6" / >
</ DATA>
. . .


Asociar datos con elementos IUX
La propiedad nombre de iux:Xml es el medio que se tiene para poder asociar los datos con los
identificadores que lo van a utilizar. Este nombre acta como origen de datos.

Los identificadores que pueden tener un origen de datos, poseen la propiedad xml, la cual debe tener
como valor un nombre de un iux:Xml.

Ejemplo



. . .







Como se puede observar en el ejemplo, el nombre del iux:Xml se prm el cual es referenciado por el
identificador iux:Tabulador Tab1 en la propiedad xml. Con esto, se le indica al tabulador que sus filas
sern las filas que genere el iux:Xml prm y las columnas definidas por la propiedad nombre de
iux:Columna, sern las los atributos de cada fila del xml contenga ese nombre.

La asociacin puede ser mltiple, esto es, un origen de datos puede estar asociado a ms de un
identificador iux. Por ejemplo, se puede asociar un origen de datos a varios identificadores dentro de un
formulario y a su vez, tambin asociar a otro tabulador. Si adems, el origen de datos se especifica en la
propiedad ejecucin=Cliente, al seleccionar una fila del tabulador, esa fila se activar (se presentar)
como contenido del formulario.


Donde ejecutar el Resultado
Al momento de definir un iux:Xml, se debe considerar el lugar donde se generar el resultado. Existen
dos partes posibles, en el servidor de aplicaciones o en el cliente (Internet Explorer), La propiedad
ejecucion permite configurar esto.

Al especificar la propiedad ejecucin=Servidor (por omisin), el interprete iux es el encargado de ir a
buscar los datos y los mantiene disponible mientras se termina de interpretar el resto de identificadores.
Al momento de encontrar un identificador con la propiedad xml que referencia a un origen de datos con
ejecucin=Servidor, este lo llena segn su forma de asociar.

Al especificar la propiedad ejecucin=Cliente, el interprete deja solo una declaracin de solicitud de
datos que se ejecutar al momento de cargar la pgina en el explorador web del cliente, es decir, el
explorador es el encargado de recuperar los datos, los cuales residen en un rea especial del cliente,
separado del html generado. El explorador tambin es el encargado de asociar los datos con los
diferentes controles.

Cuando utilizar ejecucin=Cliente?
En general, es la forma ms adecuada, ya que permite manipular en forma directa los datos, pero
tambin, tiene la desventaja que solo lo soporta el Internet Explorer versin 4.5 en adelante. En todo
caso, el iux es capaz de discriminar el tipo de explorador que lo invoca (no totalmente por el momento), lo
cual, le permite traducir esto de una forma u otra.
Actualizacin de datos
Existe la propiedad actualizar, que al estar igual a Si, los datos se pueden actualizar utilizando la utilidad
oXML disponible en javascripts.

Para poder utilizar las caractersticas aqu mencionada, el iux:XMl debe tener las propiedades
ejecucion=Cliente y actualizar =Si.

Cuando se disea un mantenedor de datos, este puede tener la capacidad de modificar una fuente de
datos o ms (caso, maestro-detalle), se disponen de un conjunto de controles, tales como, cajas de
edicin, listas desplegables, etc. Al momento de modificar algunos datos, estas modificaciones tambin
se realizan en el origen de datos asociado, los cuales residen en memoria del cliente del IE. A travs de
pocas instrucciones javascripts, estos datos modificados se enviarn al servidor, cuando el usuario as lo
indique (dado un botn para ello).

Para poder realizar esto con iux, se debe crear un PL/SQL package y el mdulo que gestionar la
actualizacin, adems de catalogarlo, se debe especificar los nodos que se utilizarn para guardar las
modificaciones. Esto le corresponde al programador.

En general, en un archivo javascripts asociado a la pgina del mantenedor, se debe especificar en las
propiedades del objeto oXML el nombre del package, del mdulo que gestionar la actualizacin, y
opcionalmente la definicin de parmetros que necesita el mdulo para operar. A continuacin, se debe
invocar el mtodo oXML.Guardar(arg) para ejecutar la accin. Este mtodo devuelve un verdadero
(despliega mensaje Datos Grabados si el argumento es true) si la actualizacin se realiz sin error o
false, en caso contrario. Si ocurre cualquier error, el mtodo Guardar() desplegar el mensaje que el
servidor arroja como error.

f unct i on Guar dar ( ) {
oXML. Package = " ut l _pkg_cont r ol " ;
oXML. Modul o = " updpar amet r os" ;
oXML. Par amet r o( " pModul oI d" , mdl i d) ;
i f ( ! oXML. Guar dar ( t r ue) ) r et ur n;
}


Utilidad oXML
Existe la utilidad oXML para la manipulacin de datos xml, la cual se puede acceder dentro de un archivo
javascripts. Esta utilidad est disponible al momento de existir un iux:Xml con la propiedad
ejecucin=Cliente (al menos que se especifique la propiedad registrar=No). Dispone de varios
atributos, constantes y mtodos para poder realizar distintas operaciones sobre los datos.

A continuacin, se especifican los diferentes elementos que se pueden utilizar:
Atributos
oXML.TipoServidor: Indica el tipo de servidor donde se guardar o recuperarn los datos

oXML.HostXml: Indica la mquina servidora de xml.

oXML.ContextoXML: Indica el contexto del servidor xml.

oXML.Package: Indica el package PL/SQL donde se encuentra el mdulo a invocar.

oXML.Modulo: Indica el mdulo PL/SQL a invocar

oXML.sql:: Indica el comando SQL a ejecutar en el servidor.

Constantes
oXML.TIPO_PACKAGE: Identifica el tipo servidor Package

oXML.TIPO_SQL Identifica el tipo servidor Sql

oXML.TIPO_APLICACION Identifica el tipo servidor Servlet

Mtodo
oXML.Agregar(nodo): Agrega un registro vaco al final.

oXML.Eliminar(nodo): Elimina el registro activo.

oXML.Buscar(nodo, columna, valor): Activa registro con la columna igual al valor especificado.

oXML.getValor(nodo, columna): Retorna el valor de la columna especificada del registro activo.

oXML.setValor(nodo, columna, valor): Asigna el valor especificado a la columna del registro activo.

oXML. getRetorno(valor): Obtiene un valor retornado por procedimiento invocado.

oXML.Maximo(nodo, columna): Retorna el valor numrico mximo de los registros en la columna.

oXML.Guardar(): Traslada todos los xml que tienen el atributo actualizable=Si en iux al Servidor.

oXML.Recuperar(nodo): Recupera del servidor los datos solicitados.

oXML.Crear(nodo): Crea un nuevo origen de datos.

oXML.Parametro(nombre, nodo): Crea un parmetro con su valor para enviar a servidor.

El argumento nodo identifica al xml que se desea afectar y es el mismo que se indic en la propiedad
nombre del iux:Xml. En todo caso, se pueden crear otros con el mtodo oXML.Crear().


6. Informes
Para poder crear informes en iux, se pueden utilizar los mismos identificadores que se usan para la
presentacin por pantalla.

Los identificadores, por omisin, se traducirn para que los elementos tengan un efecto visual distinto a
los que corresponden al formato de impresin. Este modo de traduccin se llamar normal. Para poder
variar esta traduccin a un formato de impresin (modo impresin), se deber utilizar la utilidad
javascripts oUrl, especficamente el mtodo Impresin().

Ejemplo:

Funct i on I mpr i mi r ( ) {
oUr l . pagi na=af i - cer t i f i cado
oUr l . I mpr esi on( ) ;
}

El efecto que produce este llamado es presentar la pgina invocada con un los mens si estos existiera y
dos botones (imprimir y volver) seguido de un marco de 700x500 pxeles donde estar el informe (rea
de infome).

En el rea de informe, se mostrar en formato de impresin los elementos definidos en la pgina,
omitiendo aquellos no imprimible (ej. Botones, marcos de edicin, etc..).

Existen identificadores que se ejecutan solo al momento de estar en modo de informes, tales como,
Informe, Encabezado, PiePagina, Elemento y QuiebrePagina. No es necesario incluir en una pgina
ninguno de estos identificadores para poder pasar a modo de informe, solo se utilizan si se quiere
formatear en mayor detalle la impresin.
El ms relevante es el identificador iux:Informe el cual contiene la los dems identificadores
mencionados, excepto QuiebrePagina, que puede estar en cualquier parte de la pgina. El iux:Informe
debe depender del identificador iux:Portal.


7. Implementar Eventos
Las pginas generadas por iux, invocan algunos eventos que pueden ser implementados en archivos
javascripts asociados a estas pginas.

En general, los eventos son gatillados por diversas acciones que realiza el usuario dentro de la pgina.
Tambin existen eventos que se generan al momento de cumplirse algunas operaciones, como el cargar
una pgina.

Los errores que se produzcan en estos eventos, no son capturados o avisados, por lo tanto, para poder
controlar esto, en cada uno de ellos se debe implementar las instruccin javascripts catch para manejar
los errores.

A continuacin se presentan eventos ms relevantes:
Evento Constructor
Este evento se invoca al momento de que se termina de cargar una pgina en el cliente. Sirve para
establecer configuraciones iniciales, como la inicializacin de variables o la deshabilitacin de algn
elemento visual.

Sintaxis:

f unct i on Const r uct or ( ) {

}

Ejemplo:
f unct i on Const r uct or ( ) {
oFor m. Sel ect or ( " p1" ) ;
oXML. Package = " ut l _pkg_cont r ol " ;
oXML. Modul o = " updpar amet r os" ;
oXML. Par amet r o( " pModul oI d" , mdl i d) ;
}
Evento FormCambio
Se invoca cuando un elemento de edicin cambia de valor dentro de un formulario. Este evento debe
retornar un trae (verdadero) o false (falso), lo cual determina si se puede o no cambiar a otro elemento de
edicin. Recibe como parmetro un objeto que identifica el elemento que gatilla el evento. Se puede
acceder al nombre del elemento (name) y al valor (value)

Para habilitar este evento, el formulario est dentro de un identificador iux:Controles.

Sintaxis:
f unct i on For mCambi o( campo) {

r et ur n t r ae;
}

Ejemplo:
f unct i on For mCambi o( campo) {
i f ( campo. name == " cuer po" ) {
i f ( campo. val ue == " S" )
oFor m. set Campo ( " p1" , " f or mat o" , " X" ) ;
el se
oFor m. set Campo ( " p1" , " f or mat o" , " N" ) ;
}
r et ur n t r ue;
}


Evento xmlPosicionar
El nombre de este evento vara segn el nombre iux:Xml y se ejecuta al momento que se cambia de fila
en un tabulador.
Sintaxis
f unct i on [ xml ] Posi ci onar ( ) {

}

Ej empl o:



.
.








f unct i on mdl Posi ci onar ( ) {

al er t ( I d. Modul o act ual + oXML. get Val or ( mdl , i d_modul o) ) ;
}


8. Utilidad oUrl (Navegacin entre pginas)
En iux existen algunos identificadores que permiten moverse entre pgina, como iux:Funciones. Pero la
mayora de los casos, la accin de cambiar de pgina se realiza mediante instrucciones javascripts. Para
esto, existe la utilidad oUrl, la que permite definir una pgina y direccionar la salida a ella. Tambin
permite invocar una pgina en modo de informe o pdf. Esta utilidad est siempre disponible.

Con esta utilidad, tambin es posible dejar valores en la sesin del servidor web, como tambin,
traspasar valores de una pgina a otra.

La utilidad oUrl dispone de las siguientes propiedades, constantes y mtodos:
Atributos
oUrl.protocolo: Indica el protocolo de comunicacin, por omisin http.

oUrl.maquina: Indica la mquina donde se ubica el servidor web.

oUrl.puerto: Indica el puerto de escucha del servidor web.

oUrl.contexto: Indica el contexto del servidor web.

oUrl.sistema: Indica el sistema el cual atender la peticin.

oUrl.subsistema: Indica la aplicacin donde se ubican los recursos.

oUrl.pagina: Indica la pgina que se invocar.

oUrl.extencion: Indica la extensin de la pgina, por omisin .jsp.

oUrl.modo: Indica el formato del contenido de la pgina, por omisin HTML..
Constantes
oUrl.REQUEST: Identifica el modo traspaso entre pgina para un parmetro.

oUrl.SESION: Identifica que el parmetro se guarda en sesin.

oUrl.SESION_ELIMINAR: Indica que el parmetro se eliminar de la sesin.

oUrl.NORMAL: Indica que el parmetro de traspasar solo al servidor.

oUrl.HTML: Indica que la pgina se mostrar en html. Utilizar en atributo oUrl.modo.

oUrl.INFORME: Indica que la pgina se mostrar en modo informe . Utilizar en atributo oUrl.modo.

oUrl. PDF: Indica que la pgina se mostrar en modo pdf. Utilizar en atributo oUrl.modo.


Mtodos
oUrl.Parametro(nombre, valor, alcance): Agrega un parmetro a traspasar. El alcance lo define una de las
constantes antes mensionadas.

oUrl.Redireccionar(): Invoca la pgina especificada en el atributo oUrl.pagina.

oUrl.Impresion(): Invoca la pgina especificada en el atributo oUrl.pagina en modo de impresin.

oUrl.AbrirDialogo(alto,ancho): Abre una ventana nueva en modo de dialogo, la cual debe ser cerrada para
poder acceder a pgina que lo invoc.

Ejemplo:
f unct i on Sel ecci on( i d_modul o) {
oUr l . pagi na = " pkg- par amet r o" ;
oUr l . Par amet r o( " Modul oI d" , i d_modul o, oUr l . SESI ON) ;
oUr l . Redi r ecci onar ( ) ;
}


9. Utilidad oForm (Control de Formularios)
El propsito de esta utilidad es de controlar el ingreso de datos de los formularios, para ello dispone de
mtodos que permiten modificarlos, como tambin crear algunos efectos visuales.

Para poder utilizar esta utilidad, se debe especificar el identificador iux:Controles.

A continuacin se presentan los mtodos disponibles en esta utilidad:
Mtodos
oForm.Validar(ctrl): Retorna verdadero si los elementos de edicin con la propiedad en iux requerido=Si
tienen valor, en caso contrario, retorna falso, desplegando un mensaje con los elementos no ingresados.
oForm. En el argumento ctrl., se indica el nombre del iux:Control que se desea validar.

oForm.setCampo(ctrl., campo, valor): Asigna un valor al elemento especificado en el argumento campo.

oForm.getCampo(ctrl., campo): Obtiene el valor del elemento campo.

oForm.Selector(ctrl.): Asigna efecto de foco al control.

Manual IUX

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Manual IUX

Uploaded by

Copyright:

Available Formats

A.F.P. HABITAT S.A.

f unct i on mdl Posi ci onar ( ) {

You might also like