Funciones y Atributos de Mapa de Interface de Usuario
Contenido
Creación de una Lista Desplegable
Formateo de Campos de Entrada y Salida
Activación de Ayuda de Mapa de Interface de Usuario
Búsqueda mediante Zona de Explorador Desplegable
Ejecución de JavaScript para Eventos de Explorador
Invocación de Servicios Basados en Esquema
Refrescamiento de Página de Portal o Mapa Generado
Incrustación de Navegación de Framework
Inicio de Script de Asistente de Proceso de Negocios
Cierre del Mapa de Interface de Usuario con Valores Vinculados
Inclusión de Fragmento de Mapa
Inclusión de un Componente Web
Visualización de Esquema por Defecto para Adición
Carga y Descarga de un Archivo CSV
Creación de Fragmentos de Mapa de Zona de Portal
Bibliotecas de JavaScript Requeridas
Vinculación de XML a HTML
Solo se necesitan dos atributos diferentes para vincular el XML de un Mapa de Interface de Usuario con su HTML. Ambos atributos requieren un documento XML embebido en el HTML, donde los nodos <xml> vinculan el XML.
Enlace de un Campo
Sintaxis | Valores | Descripción |
---|---|---|
oraField=" " |
XPath de elemento de campo | Este atributo se usa para enlazar un elemento HTML directamente con un elemento XML, donde el elemento XML se define dentro del esquema XML del Mapa de Interface de Usuario. Este atributo se puede usar con cualquier elemento HTML de presentación, como: <span>, <div> y <input>. |
-
HTML para elemento de entrada:
<html> <body> <table> <tr> <td>Address:</td> <td><input type="text" oraField="address"/></td> </tr> <tr> <td>City:</td> <td><input type="text" oraField="city"/></td> </tr> <tr> <td>State:</td> <td><input type="text" oraField="state"/></td> </tr> <tr> <td>Zip:</td> <td><input type="text" oraField="zip"/></td> </tr> </table> </body> <xml> <root> <address>123 Main St</address> <city>Alameda</city> <state>CA</state> <zip>94770</zip> </root> </xml> </html>
HTML presentado
-
HTML para elementos span y div:
<html> <body> <div oraField="address"></div> <span oraField="city"></span> <span>,</span> <span oraField="state"></span> <span oraField="zip"></span> <span oraField="country"></span> </body> <xml> <root> <address>123 Main St</address> <city>Alameda</city> <state>CA</state> <zip>94770</zip> </root> </xml> </html>
HTML presentado:
Enlace de una Lista
Este atributo se usa para enlazar una tabla HTML con una lista XML, donde la lista XML se define dentro del esquema XML del Mapa de Interface de Usuario. El propósito de este elemento es hacer que el marco replique el HTML de la tabla para cada acontecimiento de la lista.
Sintaxis | Valores | Descripción |
---|---|---|
oraList=" " |
XPath de elemento de lista | Este atributo se usa para enlazar una tabla HTML con una lista XML, donde la lista XML se define dentro del esquema XML del Mapa de Interface de Usuario. El propósito de este elemento es hacer que el marco replique el HTML de la tabla para cada acontecimiento de la lista. |
<html>
<head><title>Bind xml list element</title></head>
<body>
<table oraList="payment">
<thead>
<tr>
<th><span>Pay Date</span></th>
<th><span>Amount</span></th>
</tr>
<tr/>
</thead>
<tr>
<td>
<span oraField="date" oraType="date"></span>
</td>
<td align="right">
<span oraField="amount" oraType="money"></span>
</td>
</tr>
</table>
</body>
<xml>
<root>
<payment>
<date>2008-01-01</date>
<amount>44.28</amount>
</payment>
<payment>
<date>2008-02-01</date>
<amount>32.87</amount>
</payment>
<payment>
<date>2008-03-01</date>
<amount>21.76</amount>
</payment>
</root>
</xml>
</html>
HTML presentado:

Creación de una Lista Desplegable
Se proporcionan los siguientes atributos para crear un elemento "select" de HTML, también llamado lista desplegable, según diferentes orígenes.
Origen | Sintaxis | Valores | Ejemplos |
---|---|---|---|
Consulta |
oraSelect="lookup: ;" |
Campo de consulta |
|
Consulta Extensible |
oraSelect="lookupBO: ;" |
Código de Objeto de Negocio |
|
Tipo de Característica (predefinido) |
oraSelect="charType: ;" |
Código de Tipo de Característica |
|
Tabla de Control |
oraSelect="table: ;" Nota: Este atributo solo funciona con tablas que siguen la estructura de tabla de control standard, en la que hay una tabla de idioma relacionada que incluye la columna DESCR como columna de descripción. Use el diccionario de datos del Visor de Aplicación para identificar tablas que califiquen para esta funcionalidad.
Advertencia: La función oraSelect solo funcionará si se despliegan menos de 500 valores.
|
Nombre de tabla |
|
Servicio de Página |
oraSelect="service: ;" |
Nombre de Servicio de Página |
|
Lista Embebida | Se usa para crear una lista desplegable select en función de la lista que está dentro del XML del mapa. oraSelect="valuePath: ;descPath: " |
Después del valuePath, indique el XPath del elemento que contiene los valores. Después del descPath, indique el XPath del elemento que contiene las descripciones. |
|
Script de Servicio |
oraSelect="ss: ;" |
Código de Script de Servicio | Consulte la sección que aparece a continuación para ver la sintaxis adicional necesaria para usar esta función. |
Servicio de Negocio |
oraSelect="bs: ;" |
Código de Servicio de Negocio | Consulte la sección que aparece a continuación para ver la sintaxis adicional necesaria para usar esta función. |
Al especificar un script de servicio o un servicio de negocio, se necesita información adicional acerca del mapeo para transmitir los datos desde el servicio y hacia él.
Sintaxis | Valores | Descripción |
---|---|---|
oraSelectIn=" ;" |
serviceXPath:element; | Se usa para transmitir el valor de otro elemento al servicio (mapeo al XPath del servicio). |
serviceXPath:'Literal'; | Se usa para transmitir un valor constante o literal al servicio (mapeo al XPath del servicio). | |
oraSelectOut="valuePath: ; descPath: " |
Consulte los ejemplos que aparecen a continuación | Se usa para indicar qué elemento de la salida del servicio tiene los valores y cuál tiene las descripciones. |
Ejemplo con un servicio de negocio:
...
<td>External System: </td>
<td>
<select oraField="externalSystem"
oraSelect="bs:F1-RetrieveExternalSystems"
oraSelectIn="outboundMsgType:boGroup/parameters/outboundMsgType;"
oraSelectOut="valuePath:results/externalSystem;
descPath:results/description">
</select>
</td>
...
Este método para crear listas desplegables, a menudo, se usa cuando existe una dependencia entre los elementos y la lista de valores válidos de una lista desplegable (para el elemento secundario) se basa en otro elemento del mapa (el elemento principal). Cuando se cambia el elemento principal, es posible que sea necesario refrescar el elemento secundario. Este comportamiento se puede implementar por medio de una función que se llama dentro de un evento onChange en el mapa. La sintaxis es oraHandleDependentElements('dependent element');. Se pueden nombrar múltiples elementos de destino (dependientes).
El siguiente ejemplo está relacionado con el ejemplo de servicio de negocio mencionado anteriormente, en el que la lista de sistemas externos es específica para un tipo de mensaje de salida determinado, que se transfiere como entrada. En el snippet que aparece debajo, se muestra la configuración del elemento de tipo de mensaje de salida para activar el refrescamiento de la lista desplegable del sistema externo.
...
<div>
<label oraLabel="boGroup/parameters/outboundMsgType"></label>
<span>
<select oraSelect="table:F1_OUTMSG_TYPE"
oraField="boGroup/parameters/outboundMsgType"
onChange="oraHandleDependentElements('boGroup/parameters/externalSystem');">
</select>
</span>
</div>
...
Formateo de Campos de Entrada y Salida
Los siguientes atributos están diseñados para aplicar el formateo de tipos de datos para campos de entrada y salida.
Formato Automático
Sintaxis |
---|
oraSchemaDataTypes="false" |
Este atributo se usa para activar el formateo automático en el documento HTML presentado. El formateo automático se lleva a cabo en función de los atributos de tipo de datos definidos en el esquema del mapa de Interface de Usuario. Para obtener detalles sobre el formateo de tipos de datos específicos, consulte las descripciones de atributos oraType que aparecen a continuación.
-
Esquema de Mapa de Interface de Usuario:
<schema> <schemaDate dataType="date"/> <schemaDateTime dataType="dateTime"/> <schemaFKRef fkRef="CI_USER"/> <schemaLookup dataType="lookup" lookup="ACCESS_MODE"/> <schemaMoney dataType="money"/> <schemaNumber dataType="number"/> <schemaTime dataType="time"/> </schema>
-
HTML de Mapa de Interface de Usuario:
<html> <body oraSchemaDataTypes="true"> <table border="1" cellpadding="1" cellspacing="1"> <tr><th>dataType</th><th>result type</th><th>input result</th><th> display-only result</th></tr> <tr> <td rowspan="2">date (from schema)</td> <td>raw</td> <td><input oraField="schemaDate" oraType="string" /></td> <td><span oraField="schemaDate" oraType="string"></span></td> </tr> <tr> <td>rendered</td> <td><input oraField="schemaDate"></td> <td><span oraField="schemaDate"></span></td> </tr> <tr> <td rowspan="2">dateTime (from schema)</td> <td>raw</td> <td><input oraField="schemaDateTime" oraType="string"></td> <td><span oraField="schemaDateTime" oraType="string"></span></td> </tr> <tr> <td>rendered</td> <td><input oraField="schemaDateTime"></td> <td><span oraField="schemaDateTime"></span></td> </tr> <tr> <td rowspan="2">fkRef (from schema)**</td> <td>raw</td> <td><input oraField="schemaFkRef" oraType="string"></td> <td><span oraField="schemaFkRef" oraType="string"></span></td> </tr> <tr> <td>rendered</td> <td><input oraField="schemaFkRef"></td> <td><span oraField="schemaFkRef"></span></td> </tr> <tr> <td rowspan="2">lookup (from schema)</td> <td>raw</td> <td><input oraField="schemaLookup" oraType="string"></td> <td><span oraField="schemaLookup" oraType="string"></span></td> </tr> <tr> <td>rendered</td> <td><input oraField="schemaLookup"></td> <td><span oraField="schemaLookup"></span></td> </tr> <tr> <td rowspan="2">money (from schema)</td> <td>raw</td> <td><input oraField="schemaMoney" oraType="string"></td> <td><span oraField="schemaMoney" oraType="string"></span></td> </tr> <tr> <td>rendered</td> <td><input oraField="schemaMoney"></td> <td><span oraField="schemaMoney"></span></td> </tr> <tr> <td rowspan="2">number (from schema)</td> <td>raw</td> <td><input oraField="schemaNumber" oraType="string"/></td> <td><span oraField="schemaNumber" oraType="string"></span></td> </tr> <tr> <td>rendered</td> <td><input oraField="schemaNumber"></td> <td><span oraField="schemaNumber"></span></td> </tr> <tr> <td rowspan="2">time (from schema)</td> <td>raw</td> <td><input oraField="schemaTime" oraType="string"></span></td> <td><span oraField="schemaTime" oraType="string"></span></td> </tr> <tr> <td>rendered</td> <td><input oraField="schemaTime"></td> <td><span oraField="schemaTime"></span></td> </tr> </table> </body> <xml> <root> <schemaDate>2007-11-02</schemaDate> <schemaDateTime>2007-11-02-23.45.00</schemaDateTime> <schemaFkRef>USD</schemaFkRef> <schemaLookup>A</schemaLookup> <schemaMoney>1000000</schemaMoney> <schemaNumber>5661976.11548</schemaNumber> <schemaTime>23.45.00</schemaTime> </root> </xml> </html>
HTML presentado.
Formato de Fecha
Esta función se usa para desplegar una fecha de acuerdo al perfil de despliegue del usuario. Para los campos de entrada, la configuración formatea los datos cuando el usuario presiona la tecla TAB para salir del campo.
Sintaxis |
---|
oraType="date" |
<html>
<body>
<table summary="" border="0" cellpadding="1" cellspacing="1">
<tr>
<td>Date: </td>
<td><span oraField="date" oraType="date"></span></td>
</tr>
<tr>
<td>Date: </td>
<td><input oraField="date" oraType="date"/></td>
</tr>
</table>
</body>
<xml>
<root>
<date>2008-12-28</date>
</root>
</xml>
</html>
HTML presentado.

Formato de Hora
Esta función se usa para desplegar una hora de acuerdo al perfil de despliegue del usuario. Para los campos de entrada, la configuración formatea los datos cuando el usuario presiona la tecla TAB para salir del campo.
Sintaxis |
---|
oraType="time" |
<html>
<body>
<table summary="" border="0" cellpadding="1" cellspacing="1">
<tr>
<td>Time: </td>
<td><span oraField="time" oraType="time"></span></td>
</tr>
<tr>
<td>Time: </td>
<td><input oraField="time" oraType="time"/></td>
</tr>
</table>
</body>
<xml>
<root>
<time>00.28.54.389</time>
</root>
</xml>
</html>
HTML presentado.

Formateo de Fecha y Hora
Esta función se usa para desplegar un registro de hora de acuerdo al perfil de despliegue del usuario. Si esta función se usa para un elemento de entrada, se divide en dos partes, una para la fecha y otra para la hora. De manera opcional, la parte de hora del elemento de fecha y hora se puede suprimir por medio del valor de atributo 'time:suppress'.
Sintaxis |
---|
oraType="dateTime; time:suppress" |
<html>
<body>
<table summary="" border="0" cellpadding="1" cellspacing="1">
<tr>
<td>Date time: </td>
<td><span oraField="dateTime" oraType="dateTime"></span></td>
</tr>
<tr>
<td>Date only: </td>
<td><span oraField="dateTime" oraType="dateTime; time:suppress"></span></td>
</tr>
<tr>
<td>Date time: </td>
<td><input oraField="dateTime" oraType="dateTime"/></td>
</tr>
<tr>
<td>Date only: </td>
<td><input oraField="dateTime" oraType="dateTime; time:suppress"/></td>
</tr>
</table>
</body>
<xml>
<root>
<dateTime>2009-11-01-00.28.54</dateTime>
</root>
</xml>
</html>
HTML presentado.

Formateo de Fecha y Hora con Hora Standard
Esta función TRUE se usa para presentar un elemento de fecha/hora en función del cronograma del horario de verano de la zona horaria "base". La zona horaria "base" se especifica en la tabla Instalación y representa la zona horaria de la base de datos. Para los elementos de entrada que tienen esta configuración, se supone que todas las horas que se ingresan corresponden al cronograma de horario de verano de la zona horaria base. Si se ingresa una hora que no se puede traducir a la hora standard de manera inequívoca, se le solicita al usuario que proporcione una etiqueta de zona horaria para indicar si se ingresó la hora según el horario de verano o la hora standard.
Sintaxis |
---|
oraType="dateTime; stdTime:true;" |
<html>
<body>
<table summary="" border="0" cellpadding="1" cellspacing="1">
<tr>
<td>Date time: </td>
<td><span oraField="dateTime" oraType="dateTime; stdTime:true;"></span></td>
</tr>
<tr>
<td>Date time: </td>
<td><input oraField="dateTime" oraType="dateTime; stdTime:true;"/></td>
</tr>
</table>
</body>
<xml>
<root>
<dateTime>2009-11-01-00.28.54</dateTime>
</root>
</xml>
</html>
HTML presentado.

HTML presentado para el día siguiente.

Formateo de Fecha y Hora con Referencia de Zona Horaria
Sintaxis | Valores Válidos | Descripción |
---|---|---|
oraType="dateTime; stdTimeRef: ;" | Se hace referencia a un XPath después de los dos puntos. | Esta función se usa para presentar un elemento de fecha/hora en función del cronograma del horario de verano de una zona horaria a cuyo XPath se hace referencia. Tenga en cuenta que se supone que la hora procesada se almacenó en la hora standard de la zona horaria a la que se hace referencia, de manera que solo se ejecuta el cambio al horario de verano, no el cambio de zona horaria. |
oraType="dateTime; displayRef: ;" | Se hace referencia a un XPath después de los dos puntos. | Esta función es similar a la función stdTimeRef, con la excepción de que esta función ejecuta el cambio de zona horaria, además del cambio al horario de verano. Para usar la función displayRef correctamente, solo debe asociarla con los elementos de zona horaria que se almacenaron en la zona horaria base. |
Para los elementos de entrada que tienen esta configuración, se asume que todas las horas que se ingresan corresponden al cronograma de horario de verano de la zona horaria a la que se hace referencia. Si se ingresa una hora que no se puede traducir a la hora standard de manera inequívoca, se le solicita al usuario que proporcione una etiqueta de zona horaria para indicar si se ingresó la hora según el horario de verano o la hora standard.
<html>
<body>
<table summary="" border="0" cellpadding="1" cellspacing="1">
<tr>
<td>Date time: </td>
<td><span oraField="dateTime" oraType="dateTime; stdTimeRef:timeZone;"></span></td>
</tr>
<tr>
<td>Date time: </td>
<td><input oraField="dateTime" oraType="dateTime; stdTimeRef:timeZone;"/></td>
</tr>
</table>
</body>
<xml>
<root>
<timeZone>US-EAST</timeZone>
<dateTime>2009-11-01-00.28.54</dateTime>
</root>
</xml>
</html>
HTML presentado.

HTML presentado para el día siguiente.

Formato de Duración
Sintaxis |
---|
oraType="duration" |
Esta función se usa para desplegar la duración. Para un elemento de entrada, el valor que ingresa el usuario se pasa de minutos a horas y minutos según corresponda. Por ejemplo, un valor ingresado de "90" se convierte a "00:01:30" cuando se presiona la tecla TAB para salir del campo de entrada.
<html>
<body>
<table summary="" border="0" cellpadding="1" cellspacing="1">
<tr>
<td>Duration: </td>
<td><span oraField="duration" oraType="duration"></span></td>
</tr>
<tr>
<td>Duration: </td>
<td><input oraField="duration" oraType="duration"/></td>
</tr>
</table>
</body>
<xml>
<root>
<duration>90</duration>
</root>
</xml>
</html>
HTML presentado.

Formateo de Día del Mes
Sintaxis |
---|
oraType="dayInMonth" |
Esta función se usa para desplegar el día y el mes concatenados.
<html>
<body>
<table summary="" border="0" cellpadding="1" cellspacing="1">
<tr>
<td>Day In Month: </td>
<td><span oraField="dayMonth" oraType="dayInMonth"></span></td>
</tr>
<tr>
<td>Day In Month: </td>
<td><input oraField="dayMonth" oraType="dayInMonth"/></td>
</tr>
</table>
</body>
<xml>
<root>
<dayMonth>0228</dayMonth>
</root>
</xml>
</html>
HTML presentado.

Formateo de Mes del Año
Sintaxis |
---|
oraType="monthInYear" |
Esta función se usa para desplegar el mes y el año concatenados.
<html>
<body>
<table summary="" border="0" cellpadding="1" cellspacing="1">
<tr>
<td>Month In Year: </td>
<td><span oraField="month" oraType="monthInYear"></span></td>
</tr>
<tr>
<td>Month In Year: </td>
<td><input oraField="month" oraType="monthInYear"/></td>
</tr>
</table>
</body>
<xml>
<root>
<month>200811</month>
</root>
</xml>
</html>
HTML presentado.

Formato Monetario
Esta función se usa para desplegar un número como importe monetario. Consulte la tabla para ver las opciones de configuración relacionadas con la divisa. Para los elementos de entrada, se emite un error si se ingresa un valor no numérico.
Sintaxis | Descripción |
---|---|
oraType="money: " | Especifique directamente un código de divisa después de los dos puntos. |
oraType="money;currencyRef: " | Haga referencia a un XPath (después de los dos puntos) para un elemento que hace referencia a un código de divisa. |
oraType="money" | Si no se especifica ninguna divisa o referencia de divisa, se usa la divisa de la instalación. |
<html>
<head>
<link rel="stylesheet" type="text/css" href="cisDisabled.css"/>
<link rel="stylesheet" type="text/css" href="cisEnabled.css"/>
</head>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
<tr>
<td>Amount, currency specified:</td>
<td><span oraType="money:EUR" oraField="totalAmt"></span></td>
</tr>
<tr>
<td>Amount, default currency:</td>
<td><span oraType="money" oraField="totalAmt"></span></td>
</tr>
<tr>
<td>Amount, default input:</td>
<td><input oraType="money" oraField="totalAmt"/></td>
</tr>
<tr>
<td>Amount, currency reference:</td>
<td><input oraType="money;currencyRef:cur" oraField="totalAmt"/></td>
</tr>
</table>
</body>
<xml>
<root>
<totalAmt>50500.09</totalAmt>
<cur>EUR</cur>
</root>
</xml>
</html>
HTML presentado

Formato de Número
Esta función se usa para desplegar un número o validar un valor de entrada. Para los elementos de entrada, el sistema devuelve un error si se ingresa un valor no numérico.
Sintaxis |
---|
oraType="number" |
<html>
<head>
<link rel="stylesheet" type="text/css" href="cisDisabled.css"/>
<link rel="stylesheet" type="text/css" href="cisEnabled.css"/>
</head>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
<tr>
<td>Count:</td>
<td><span oraType="number" oraField="count"></span></td>
</tr>
<tr>
<td>Count, input:</td>
<td><input oraType="number" oraField="count"/></td>
</tr>
</table>
</body>
<xml>
<root>
<count>989</count>
</root>
</xml>
</html>
HTML presentado.

Formato de Referencia de Clave Foránea
Por defecto, cuando se despliega un elemento con el valor fkRef para oraType, se activan una cadena de información, un menú contextual, la navegación y la búsqueda (si la referencia de Clave Foránea se configuró de la manera correspondiente). Se proporciona la sintaxis para que pueda desactivar cualquiera de estas funciones según lo desee.
Tenga en cuenta que también puede activar el hiperenlace de clave foránea por separado; consulte Incrustación de Navegación de Framework para obtener más información. Los diferentes atributos que se usan para controlar la funcionalidad de referencia de clave foránea son los siguientes: Tenga en cuenta que, en cada caso, el valor por defecto es true Se debe usar el valor false para desactivar la función.
Sintaxis |
---|
oraType="fkRef:true|false; info:true|false; context:true|false; navigation:true|false; search:true|false" |
- fkRef. El valor "true" activa el procesamiento de todas las siguientes referencias de clave foránea. Use el valor "false" para desactivar el procesamiento automático de Referencias de Clave Foránea.
- info. El valor "true" presenta una cadena de información en el mapa de Interface de Usuario, si corresponde.
- context. El valor "true" presenta un menú contextual para que aparezca antes del elemento de referencia de clave foránea, si corresponde.
- navigation. El valor "true" hace que la cadena de información se presente como hiperenlace, si corresponde. Al hacer click en el hiperenlace, se navegahacia la página correspondiente.
- search. El valor "true" despliega un ícono de búsqueda que inicia la zona de búsqueda, si corresponde.
-
Esquema de Mapa de Interface de Usuario:
<schema> <bo fkRef="F1-BOMO"/> </schema>
-
HTML de Mapa de Interface de Usuario:
<html> <body> <table summary="" border="1" cellpadding="1" cellspacing="1"> <tr> <td>Business Object</td> <td><span oraField="bo" oraType="fkRef:true; info:true; context:true; navigation:true;"></span></td> </tr> </table> </body> <xml> <root> <bo>F1-COUNTRY</bo> </root> </xml> </html>
-
HTML presentado.
Formato de Lista de Valores
Esta función se usa para desplegar la descripción de un valor de consulta.
Sintaxis | Valores Válidos |
---|---|
oraType="lookup: " | Nombre de campo de consulta después de los dos puntos. |
<html>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
<tr>
<td>Status:</td>
<td><span oraField="status" oraType="lookup:BATCH_JOB_STAT_FLG"></span></td>
</tr>
</table>
</body>
<xml>
<root>
<status>PD</status>
</root>
</xml>
</html>
HTML presentado.

Formato de Lista de Valores Ampliada
Esta función se usa para desplegar la descripción de un valor de consulta extensible.
Sintaxis | Valores Válidos |
---|---|
oraType="lookupBO: " | Nombre de código de Objeto de Negocio después de los dos puntos. |
<html>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
<tr>
<td>Value:</td>
<td><span oraField="status" oraType="lookupBO:F1-DeviceDisplayTypes"></span></td>
</tr>
</table>
</body>
<xml>
<root>
<status>oraTablet</status>
</root>
</xml>
</html>
HTML presentado.

Formato de Tipo de Característica
Esta función se usa para desplegar la descripción de un valor de característica predefinido.
Sintaxis | Valores Válidos |
---|---|
oraType="charType: " | Código de Tipo de Característica después de los dos puntos. |
<html>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
<tr>
<td>Skill:</td>
<td><span oraType="charType:CM-SKILL" oraField="skill"></span></td>
</tr>
</table>
</body>
<xml>
<root>
<skill>10</skill>
</root>
</xml>
</html>
HTML presentado.

Formato de Tabla de Control
Esta función se usa para desplegar la descripción de una tabla de control que tiene una tabla de idioma asociada.
Sintaxis | Valores Válidos |
---|---|
oraType="table: " | Código de tabla después de los dos puntos. |
<html>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
<tr>
<td>Currency:</td>
<td><span oraType="table:CI_CURRENCY_CD" oraField="curr"></span></td>
</tr>
</table>
</body>
<xml>
<root>
<curr>USD</curr>
</root>
</xml>
</html>
HTML presentado.

Formateo de Adición/Remoción de Grilla
Sintaxis | Descripción |
---|---|
oraType="addGridRow" |
La función addGridRow se usa para crear un cuadro de diálogo de "inserción de fila" en el mapa de Interface de Usuario.
|
oraType="deleteGridRow" |
La función deleteGridRow se usa para crear un cuadro de diálogo de "supresión de fila" en el mapa de Interface de Usuario.
|
Ejemplo:
<html>
<head>
<title>Demonstrate Grid Add and Grid Delete OraTypes</title>
<link rel="stylesheet" type="text/css" href="cisDisabled.css"/>
<link rel="stylesheet" type="text/css" href="cisEnabled.css"/>
</head>
<body>
<table oraList="listEntry">
<thead>
<tr>
<th/>
<th/>
<th><span>Date</span></th>
<th><span>Amount</span></th>
</tr>
<tr/>
</thead>
<tr>
<td oraType="addGridRow"></td>
<td oraType="deleteGridRow"></td>
<td>
<input oraField="date" oraType="date"></input>
</td>
<td align="right">
<input oraField="amount" oraType="money"></input>
</td>
</tr>
</table>
</body>
<xml>
<root>
<listEntry>
<date>2008-01-01</date>
<amount>44.28</amount>
</listEntry>
<listEntry>
<date>2008-02-01</date>
<amount>32.87</amount>
</listEntry>
<listEntry>
<date>2008-03-01</date>
<amount>21.76</amount>
</listEntry>
</root>
</xml>
</html>
HTML presentado.

Elementos sin Formato
Esta función se usa para desplegar el contenido de un elemento que contiene datos sin procesar como se define para el elemento de esquema que se presenta.
Sintaxis |
---|
oraType="raw" |
-
Esquema de Mapa de Interface de Usuario:
<schema> <rawStuff type="raw"/> </schema>
-
HTML de Mapa de Interface de Usuario:
<html> <head> <link rel="stylesheet" type="text/css" href="cisDisabled.css"/> <link rel="stylesheet" type="text/css" href="cisEnabled.css"/> </head> <body> <table summary="" border="1" cellpadding="1" cellspacing="1"> <tr> <td>Raw Stuff:</td> <td><span oraType="raw" oraField="rawStuff"></span></td> </tr> </table> </body> <xml> <root> <rawStuff> <ele1>text in element 1</ele1> <group1> <ele2>text inside element 2, group 1</ele2> <ele3>text inside element 3, group 1</ele3> </group1> </rawStuff> </root> </xml> </html>
HTML presentado.
Formato de Cadena
Esta función se usa para desplegar el contenido de un elemento, como la impresión de XML con formato, cuando el elemento contiene XML con escape.
Sintaxis |
---|
oraType="xmlString" |
Ejemplo:
<html>
<head>
<link rel="stylesheet" type="text/css" href="cisDisabled.css"/>
<link rel="stylesheet" type="text/css" href="cisEnabled.css"/>
</head>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
<tr>
<td>XML Stuff:</td>
<td><span oraType="xmlString" oraField="xmlStuff"></span></td>
</tr>
</table>
</body>
<xml>
<root>
<xmlStuff>
<ele1>text in element 1</ele1>
<group1>
<ele2>text inside element 2, group 1</ele2>
<ele3>text inside element 3, group 1</ele3>
</group1>
</xmlStuff>
</root>
</xml>
</html>
HTML presentado.

HTML presentado sin oraType=”xmlString”

Formato de HTML
Esta función se usa para desplegar el contenido de un elemento como HTML, en lugar de texto sin formato. Un elemento definido como oraType="fkref" se presenta automáticamente como HTML.
Sintaxis |
---|
oraType="html" |
Para evitar la ejecución de HTML malicioso, no se soportan todas las etiquetas HTML. La lista de etiquetas soportadas se indica en la definición de contenido administrado "F1-HTMLWhiteList".
Si se detecta HTML no soportado, se utiliza un escape para todo el elemento y se lo presenta como texto sin formato. Por lo tanto, se recomienda utilizar un escape adecuado para cualquier cadena de origen que contribuya al elemento HTML final si no se espera que contenga HTML válido. De esta manera, solo se utiliza un escape para las cadenas inválidas y no para todo el elemento.
Si el elemento HTML se compone durante el proceso de scripting, consulte la función de "escape" que se describe en Sintaxis de Edición de Datos para obtener más información. Use la API de java WebStringUtilities.asHTML para el escape de texto compuesto en Java.
<html>
<head>
<link rel="stylesheet" type="text/css" href="cisDisabled.css"/>
<link rel="stylesheet" type="text/css" href="cisEnabled.css"/>
</head>
<body>
<table summary="" border="0" cellpadding="1" cellspacing="1">
<tr>
<td>Info :</td>
<td><span oraType="html" oraField="info"></span></td>
</tr>
</table>
</body>
<xml>
<root>
<info><b>text in bold</b></info>
</root>
</xml>
</html>
HTML presentado.

HTML presentado sin oraType="html"

Despliegue de Etiquetas
Derivación de Etiqueta desde un Elemento
Este atributo se usa para obtener una etiqueta sensible al idioma para un elemento HTML <span>, <td> o <input>.
Sintaxis | Valores Válidos |
---|---|
oraLabel=" " | XPath de un elemento en el esquema del mapa de Interface de Usuario. El elemento debe hacer referencia al atributo mapField=, mdField= o label=. |
-
Esquema de Mapa de Interface de Usuario:
<schema> <user mapField="USER_ID"/> <info type="group" mapXML="CLOB"> <city label="Metro Area"/> <age mdField="AGE_LBL"/> </info> </schema>
-
HTML:
<html> <head><title oraMdLabel="BUS_LBL"></title></head> <body> <table> <tr> <td oraLabel="user"></td> <td><input oraField="user"/></td> </tr> <tr> <td oraLabel="info/city"></td> <td><input oraField="info/city"/></td> </tr> <tr> <td oraLabel="info/age"></td> <td><input oraField="info/age"/></td> </tr> <tr> <td/> <td><input type="button" oraMdLabel="ACCEPT_LBL"/></td> </tr> </table> </body> <xml> <root> <user>RWINSTON</user> <info> <city>Alameda</city> <age>32</age> </info> </root> </xml> </html>
HTML presentado:
Derivación de Etiqueta desde un Campo
Este atributo se usa para obtener una etiqueta sensible al idioma para el elemento HTML <span>, <td>, <input> o <title>. El texto de la etiqueta deriva del campo al que se hace referencia.
Sintaxis | Valores Válidos |
---|---|
oraMdLabel=" " | Código de Campo de Metadatos. |
-
HTML:
<html> <head><title oraMdLabel="F1_DETAILS_LBL"></title></head> <body> <table> <tr> <td oraLabel="user"></td> <td><input oraField="user"/></td> </tr> <tr> <td oraLabel="info/city"></td> <td><input oraField="info/city"/></td> </tr> <tr> <td oraLabel="info/age"></td> <td><input oraField="info/age"/></td> </tr> <tr> <td/> <td><input type="button" oraMdLabel="ACCEPT_LBL"/></td> </tr> </table> </body> <xml> <root> <user>RWINSTON</user> <info> <city>Alameda</city> <age>32</age> </info> </root> </xml> </html>
HTML presentado:
Activación de Ayuda de Mapa de Interface de Usuario
En la sección Despliegue de Etiquetas, se describen las maneras de derivar la etiqueta para un elemento por medio de un Campo de Metadatos subyacente. Además, si el mismo campo de Metadatos contiene texto de ayuda, el sistema genera automáticamente una ayuda adyacente a la etiqueta de elemento. Al hacer click en la ayuda, el usuario puede ver el texto de ayuda.
Es posible cambiar la presentación de la ayuda. Consulte Opciones de Presentación Personalizada para obtener más información.
Búsqueda mediante Zona de Explorador Desplegable
Opción de Búsqueda
Este atributo se usa para activar la funcionalidad de zona de búsqueda para elementos HTML de entrada.
Sintaxis | Valores Válidos |
---|---|
oraSearch=" " | Código de zona. |
-
Ejemplo de definición de la búsqueda en el HTML. Esquema del Mapa de Interface de Usuario:
<schema> <uiMap/> </schema>
HTML del Mapa de Interface de Usuario
<html> <body> <table summary="" border="1" cellpadding="1" cellspacing="1"> <tr> <td>UI Map with Search </td> <td><input oraField="uiMap" oraSearch="F1-UISRCH"></td> </tr> </table> </body> <xml> <root> <uiMap/> </root> </xml> </html>
-
Ejemplo de definición de la búsqueda en el esquema. Esquema del Mapa de Interface de Usuario:
<schema> <uiMap search="F1-UISRCH"/> </schema>
HTML del Mapa de Interface de Usuario
<html> <body> <table summary="" border="1" cellpadding="1" cellspacing="1"> <tr> <td>UI Map with Search </td> <td><input oraField="uiMap"></td> </tr> </table> </body> <xml> <root> <uiMap/> </root> </xml> </html>
-
Ejemplo en el que la referencia de Clave Foránea define la zona de búsqueda. Esquema del Mapa de Interface de Usuario:
<schema> <uiMap fkRef="F1-UISRC"/> </schema>
HTML del Mapa de Interface de Usuario
<html> <body> <table summary="" border="1" cellpadding="1" cellspacing="1"> <tr> <td>UI Map with Search </td> <td><input oraField="uiMap"></td> </tr> </table> </body> <xml> <root> <uiMap/> </root> </xml> </html>
En todos los casos, el HTML presentado es el mismo.

Inicialización de Campos de Búsqueda
Este atributo opcional se usa para inicializar los filtros de la zona de búsqueda. Se pueden inicializar múltiples filtros. Este atributo solo se puede usar en conjunto con el atributo oraSearch.
Sintaxis | Valores Válidos | Opciones de Valores de Campo | Comentarios |
---|---|---|---|
oraSearchField=" " |
Uno o más pares de nombre de campo y valor de campo separados por dos puntos. Cada par está separado por un punto y coma. oraSearchField="fieldName:fieldValue: ..."El nombre de campo se usa para identificar el filtro de zona que se debe inicializar cuando se inicia la búsqueda. El nombre de campo debe asociarse con el mnemotécnico searchField especificado en un parámetro de filtro de usuario o filtro oculto de la zona de búsqueda. |
Ningún valor | Si no especifica un valor de campo, se usa el valor del elemento de entrada que contiene el atributo oraSearchField. |
XPath | Indique el XPath al elemento de esquema que contiene el valor que se debe usar. | ||
'literal' | Indica el valor literal que se debe proporcionar. |
Se inicializan dos valores de filtro, como se muestra en el siguiente ejemplo:
<schema>
<bo/>
<uiMap/>
</schema>
<html>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
<tr>
<td>UI Map with Search </td>
<td><input oraField="uiMap" oraSearch="F1-UISRCH" oraSearchField="MAP_CD; BUS_OBJ_CD:bo;"></td>
</tr>
</table>
</body>
<xml>
<root>
<bo/>
<uiMap/>
</root>
</xml>
</html>
Mapeo de Campos de Búsqueda Devueltos
Este atributo opcional se usa para dirigir los valores devueltos por la zona de búsqueda. Se pueden especificar múltiples campos. Este atributo solo se puede usar en conjunto con el atributo oraSearch.
Sintaxis | Valores Válidos | Opciones de Valores de Campo | Comentarios |
---|---|---|---|
oraSearchOut=" " |
Uno o más pares de nombre de campo y valor de campo separados por dos puntos. Cada par está separado por un punto y coma. oraSearchOut="field name:xpath target; ..."El nombre de campo se usa para identificar el resultado de búsqueda devuelto desde la zona de consulta. El nombre de campo debe asociarse con el mnemotécnico ELEMENT_NAME definido en el parámetro de resultados de búsqueda de la zona de explorador. |
Ningún valor | Si no especifica un valor de campo, el elemento de entrada que contiene el atributo oraSearchField recibe el valor devuelto. |
XPath | Indique el XPath al elemento de esquema que debe recibir el valor devuelto. |
Se devuelven dos valores en el siguiente ejemplo:
<schema>
<bo/>
<mo/>
</schema>
<html>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
<tr>
<td>BO Search </td>
<td><input oraField="bo" oraSearch="Z1-BOSRCH" oraSearchOut="BUS_OBJ_CD; MO_CD:mo;"></td>
</tr>
</table>
</body>
<xml>
<root>
<bo/>
<mo/>
</root>
</xml>
</html>
Despliegue de Errores
Despliegue de Variables de Error
Se puede desplegar una de las siguientes variables de error.
Sintaxis |
---|
oraErrorVar="ERRMSG-TEXT" |
oraErrorVar="ERRMSG-LONG" |
oraErrorVar="ERRMSG-CATEGORY" |
oraErrorVar="ERRMSG-NUMBER" |
...
<table width="100%" cellpadding="12">
<tr class="oraErrorText">
<td>
<a href="" onclick="oraShowErrorAlert(); return false;">
<span class="oraErrorText" oraErrorVar="ERRMSG-TEXT"></span>
</a>
</td>
</tr>
</table>
...
HTML presentado

Realce de un Campo con Error
Sintaxis | Comentarios |
---|---|
oraError="automate:true|false; prefix: " | Al especificar automate:true, se activa automáticamente el realzado del elemento con error cuando se emite un error. Tenga en cuenta que true es el valor por defecto y no es necesario especificarlo. Especifique automate:false para desactivar el realzado de campos. |
El sistema usa una asociación del nombre de elemento al que se hace referencia en el error con los nombres de elementos del mapa de Interface de Usuario. Si los elementos del esquema están dentro de un XPath que puede no estar asociado a lo que hace referencia el error, indíquelo usando prefix:XPath. |
En el siguiente ejemplo de HTML, se muestra que los elementos del mapa se definen dentro de un grupo llamado boGroup. El nombre de elemento que devuelve el error no incluye este grupo, de manera que para que el realzado de campos funcione correctamente, el atributo prefix: debe indicar el nombre de grupo.
<html>
<head>
<title>User Zone Input</title>
<link rel="stylesheet" type="text/css" href="cisDisabled.css"/>
<link rel="stylesheet" type="text/css" href="cisEnabled.css"/>
</head>
<body oraError="automate:true; prefix:boGroup">
<table width="100%" cellpadding="12">
<tr class="oraErrorText">
<td>
<a href="" onclick="oraShowErrorAlert(); return false;">
<span class="oraErrorText" oraErrorVar="ERRMSG-TEXT"></span>
</a>
</td>
</tr>
</table>
<table width="100%" border="0" cellpadding="4">
<tr style="padding-top:30px;">
<td align="right" class="label">User Id</td>
<td>
<span oraField="boGroup/userId" class="normal"/>
</td>
</tr>
<tr>
<td align="right" class="label">First Name</td>
<td>
<input oraField="boGroup/firstName" class="normal"/>
</td>
</tr>
<tr>
<td align="right" class="label">Last Name</td>
<td>
<input oraField="boGroup/lastName" class="normal"/>
</td>
</tr>
</table>
</body>
<xml>
<root>
<boGroup>
<userId>BOND007</userId>
<firstName>James</firstName>
<lastName></lastName>
</boGroup>
</root>
</xml>
</html>
HTML presentado, donde el elemento de error arrojado es igual a "lastName":

Sustitución de Nombre de Elemento de Error
En el extraño caso de que el nombre de elemento que devuelve el error no se asocie con el nombre de elemento del mapa, puede agregar un atributo explícito para indicar el nombre de elemento de error.
Sintaxis | Valores Válidos | Comentarios |
---|---|---|
oraErrorElement= | "nombre de elemento" | El nombre de elemento al que se hace referencia aquí debe asociarse exactamente con el nombre del elemento de error asignado cuando se arrojó el error. El mismo nombre de elemento de error puede hacer referencia a más de un campo HTML. |
Aquí se ilustra un escenario donde el nombre de elemento asociado con el error difiere del nombre de elemento del mapa.
<html>
<head>
<title>User Zone Input</title>
<link rel="stylesheet" type="text/css" href="cisDisabled.css"/>
<link rel="stylesheet" type="text/css" href="cisEnabled.css"/>
</head>
<body>
<table width="100%" cellpadding="12">
<tr class="oraErrorText">
<td>
<a href="" onclick="oraShowErrorAlert(); return false;">
<span class="oraErrorText" oraErrorVar="ERRMSG-TEXT"></span>
</a>
</td>
</tr>
</table>
<table width="100%" border="0" cellpadding="4">
<tr style="padding-top:30px;">
<td align="right" class="label">User Id</td>
<td>
<span oraField="userId" class="normal"/>
</td>
</tr>
<tr>
<td align="right" class="label">First Name</td>
<td>
<input oraField="firstName" class="normal" oraErrorElement="firstName"/>
</td>
</tr>
<tr>
<td align="right" class="label">Last Name</td>
<td>
<input oraField="familyName" class="normal" oraErrorElement="lastName"/>
</td>
</tr>
</table>
</body>
<xml>
<root>
<userId>BOND007</userId>
<firstName>James</firstName>
<familyName></familyName>
</root>
</xml>
</html>
HTML presentado.

Despliegue de Cuadro de Diálogo de Error
Cuando se despliega el texto de error, esta función se puede usar para desplegar el cuadro de diálogo de error standard (que despliega más información) cuando un usuario hace click en el mensaje de error.
Sintaxis |
---|
oraShowErrorAlert(); return false; |
<html>
<head>
<link rel="stylesheet" type="text/css" href="cisDisabled.css"/>
<link rel="stylesheet" type="text/css" href="cisEnabled.css"/>
</head>
<body>
<table width="100%" cellpadding="12">
<tr class="oraErrorText">
<td>
<a href="" onclick="oraShowErrorAlert(); return false;">
<span class="oraErrorText" oraErrorVar="ERRMSG-TEXT"></span>
</a>
</td>
</tr>
</table>
<table>
<tr>
<td >Address:</td>
<td><input type="text" oraField="address"/></td>
</tr>
<tr>
<td>City:</td>
<td><input type="text" oraField="city"/></td>
</tr>
<tr>
<td>State:</td>
<td><input type="text" oraField="state"/></td>
</tr>
<tr>
<td>Zip:</td>
<td><input type="text" oraField="zip"/></td>
</tr>
<tr>
<td/>
<td style="padding-top=15px;">
<oraInclude map="F1-SaveCancelButtons"/>
</td>
</tr>
</table>
</body>
<xml>
<root>
<address>123 Main St</address>
<city>Alameda</city>
<state>CA</state>
<zip>94770</zip>
</root>
</xml>
</html>
HTML presentado.

Cuadro de diálogo desplegable de error standard iniciado haciendo click en el mensaje de error:

Ejecución de JavaScript para Eventos de Explorador
Trabajo con Framework de JavaScript
Existen varios eventos de JavaScript que se pueden usar en el entorno HTML/JavaScript. Estos incluyen eventos como onLoad, onBlur, onChange, etc. El Marco de Mapa de Interface de Usuario también utiliza algunos de estos eventos. Es importante que cualquier Mapa de Interface de Usuario que se desarrolle funcione con el marco para poder obtener resultados consistentes (es posible que los eventos no siempre se ejecuten en el mismo orden).
A continuación, se describe el enfoque recomendado para manejar la carga y el procesamiento de las actualizaciones de campos en los Mapas de Interface de Usuario.
Si se requiere JavaScript en un fragmento o Mapa de Interface de Usuario de XHTML, es necesario enlazarlo a una etiqueta ![CDATA[ ]]
para garantizar que el documento XML sea válido. Tenga en cuenta que es posible que las etiquetas se deban convertir en comentarios para favorecer la compatibilidad con browsers antiguos. Por ejemplo:
<script type="text/javascript">
/* <![CDATA[ */
//
// javascript
//
/* ]]> */
</script>
Evento de Cambio de Elemento
Sintaxis | Valores Válidos |
---|---|
oraChange=" " | Una función de JavaScript. |
En el momento de la carga del Mapa de Interface de Usuario, si ya hay un identificador de evento anexado al elemento HTML, el marco lo remueve y anexa un identificador de evento combinado. El identificador combinado llama a cualquier identificador del marco en primer lugar y, luego, llama a otros identificadores (personalizados).
En el siguiente ejemplo, la función oraInvokeBS se ejecuta cuando se hace click en el botón.
<html>
<head>
<title>oraInvokeBS test</title>
</head>
<body>
<table>
<tr>
<td>User Id:</td>
<td>
<input oraField= "xmlGroup/userId"/>
<input type="button" value="Search" oraChange="oraInvokeBS('UserSearch','xmlGroup');"/>
</td>
</tr>
<tr>
<td/>
<td>Search Results</td>
</tr>
<tr>
<td/>
<td>
<table oraList="xmlGroup/searchList">
<tr>
<td><span oraField="userId"></span>
</td>
</tr>
</table>
</td>
</tr>
</table>
</body>
<xml>
<root>
<xmlGroup>
<userId/>
<searchList>
<userId></userId>
</searchList>
</xmlGroup>
</root>
</xml>
</html>
Evento de Carga de Página
Sintaxis | Valores Válidos |
---|---|
oraLoad=" " | Una función de JavaScript. |
-
En el siguiente ejemplo, se ejecuta la función oraDisplayNone durante la carga de página:
<html> <body> <table summary="" border="1" cellpadding="1" cellspacing="1"> <tr> <td oraLoad="oraDisplayNone(item,'userId','')">User Id: </td> <td><span oraField="userId"></span></td> </tr> </table> </body> <xml> <root> <userId>SPLAXT</userId> </root> </xml> </html>
-
HTML presentado
Después del Evento de Carga de Página
Sintaxis | Valores Válidos |
---|---|
oraAfterLoad="" | Una función de JavaScript. |
En el siguiente ejemplo, se ejecuta la función oraGetValueFromScript después de la carga de página:
<div>
<label for="boGroup_parameters_externalSystem" oraLabel="boGroup/parameters/externalSystem">
</label>
<span>
<select oraSelect="bs:F1-RetrieveExternalSystems" class="oraInput"
id="boGroup_parameters_externalSystem" oraField="boGroup/parameters/externalSystem"
oraSelectOut="valuePath:results/externalSystem; descPath:results/description"
oraSelectIn="outboundMsgType:boGroup/parameters/outboundMsgType"
oraAfterLoad
="oraGetValueFromScript(document.getElementById('boGroup_parameters_externalSystem');">
</select>
</span>
</div>
Ocultamiento de Elementos
Ocultamiento mediante una Función
El sistema proporciona múltiples técnicas para ocultar un elemento HTML.
Sintaxis | Valores Válidos | Comentarios |
---|---|---|
oraDisplayNone(item ); | (item, 'XPath', 'value', 'operator') | Se usa para ocultar un elemento en función del valor de otro elemento (al que se hace referencia por medio de su XPath). Ingrese un valor de ' ' para consultar un valor en blanco. Por defecto, el operador es '='. En su lugar, se puede definir con otro operador, como '!=', '>' o '<'. |
(item, function name,true | false) | Se usa para indicar una función de JavaScript, la cual debe devolver un valor buleano. | |
oraIsSuppress="true" | Utilice esta opción para los campos que siempre deben permanecer ocultos y no dependen de otra cosa. Defina este atributo en el elemento HTML (elemento div). |
-
Ejemplo en el que la etiqueta de ID de Usuario está oculta cuando no existe un valor de ID de Usuario.
<html> <body> <table summary="" border="1" cellpadding="1" cellspacing="1"> <tr> <td oraLoad="oraDisplayNone(item,'userId','')">User Id: </td> <td><span oraField="userId"></span></td> </tr> </table> </body> <xml> <root> <userId></userId> </root> </xml> </html>
-
Ejemplo en el que el botón Grabar está oculto cuando el usuario no tiene acceso de seguridad a la acción de cambio ("C") para el servicio de aplicación 'F1-DFLTS'.
<html> <body> <table summary="" border="1" cellpadding="1" cellspacing="1"> <tr> <td oraLoad="oraDisplayNone(item, oraHasSecurity('F1-DFLTS', 'C'), false );"> <input name="Save" type="button" onclick="oraInvokeBO('CM-IndividualTaxpayer', null, 'replace')"/> </td> </tr> </table> </body> <xml> <root> <userId></userId> </root> </xml> </html>
Control de Acceso de Seguridad de Usuario
El sistema proporciona dos funciones para controlar el acceso de seguridad de un usuario para un servicio de aplicación y un modo de acceso determinados. Por lo general, se usan para ocultar elementos.
Sintaxis | Parámetros |
---|---|
oraHasSecurity( ) | 'Código de Servicio de Aplicación' |
'Modo de Acceso' | |
oraHasSecurityPath('x','y') | 'XPath de Servicio de Aplicación' |
'XPath de Modo de Acceso' |
Consulte la sección anterior para ver un ejemplo de la función oraHasSecurity. A continuación, se muestra un ejemplo donde el botón de estado está oculto cuando el usuario no tiene acceso de seguridad para acceder al modo "ACT" del servicio de aplicación 'FORMTST'.
<html>
<body>
<table>
<tr>
<td oraLoad="oraDisplayNone(item, oraHasSecurityPath('appService', 'accessMode'), false );">
<input oraField="statusLabel" type="button" onclick="oraRunScript('UpdateState','status');"/>
</td>
</tr>
</table>
</body>
<xml>
<root>
<status>ACTIVATE</status>
<statusLabel>Activate</statusLabel>
<appService>FORMTST</appService>
<accessMode>ACT</accessMode>
</root>
</xml>
</html>
Invocación de Servicios Basados en Esquema
El sistema proporciona funciones para invocar un objeto de negocio, un servicio de negocio o un script de servicio.
Invocación de Función de Objeto de Negocio
Esta función se usa para realizar una interacción de Objeto de Negocio directamente desde el HTML del mapa de Interface de Usuario. Devuelve un valor "true" o "false" según si la invocación encuentra un error o no.
Sintaxis | Parámetros | Comentarios |
---|---|---|
oraInvokeBO( ) | 'Nombre de Objeto de Negocio' | |
"XPath" o null | Identifica un elemento de grupo por medio del XPath. Si especifica la palabra null, se transmite todo el objeto XML embebido. | |
'acción' | Indica la acción que se debe usar. Los valores válidos son add, delete, read, update, replace, fastAdd y fastUpdate. Acceso Rápido: Consulte Acciones de Objeto de Negocio para obtener más información acerca de las diversas acciones de Objeto de Negocio.
|
Ejemplo de la sentencia invocada en una función de JavaScript.
function invokeBO {
if (!oraInvokeBO('F1-User','xmlGroup','read')) {
oraShowErrorAlert();
return;
}
}
Ejemplo de la sentencia invocada dentro de onClick.
<input type="button" class="oraButton" oraMdLabel="DISPLAY_LBL" onClick="oraInvokeBO('F1-User');"/>
Invocación de Función de Servicio de Negocio
Esta función se usa para realizar una interacción de servicio de negocio directamente desde el HTML del mapa de Interface de Usuario. Devuelve un valor "true" o "false" según si la invocación encuentra un error o no.
Sintaxis | Parámetros | Comentarios |
---|---|---|
oraInvokeBS( ) | 'Nombre de Servicio de Negocio' | |
"XPath" o null | Identifica un elemento de grupo por medio del XPath. Si especifica la palabra null, se transmite todo el objeto XML embebido. |
Ejemplo de la sentencia codificada en una función de JavaScript.
function invokeBS {
if (!oraInvokeBS('F1-UserSearch','xmlGroup')) {
oraShowErrorAlert();
return;
}
}
Ejemplo de la sentencia invocada por medio de onClick.
<input type="button" class="oraButton" oraMdLabel="DISPLAY_LBL" onClick="oraInvokeBS('F1-RetrieveInfo');"/>
Invocación de Función de Script de Servicio
Esta función se usa para realizar una interacción de script de servicio directamente desde el HTML del mapa de Interface de Usuario. Devuelve un valor "true" o "false" según si la invocación encuentra un error o no.
Sintaxis | Parámetros | Comentarios |
---|---|---|
oraInvokeSS( ) | 'Nombre de Script de Servicio' | |
"XPath" o null | Identifica un elemento de grupo por medio del XPath. Si especifica la palabra null, se transmite el documento que pertenece al nodo principal. Si el nodo principal no es suficiente, siempre se puede transmitir todo el documento por medio de la siguiente sintaxis:
|
Ejemplo de la sentencia invocada en una función de JavaScript:
function invokeSS {
if (!oraInvokeSS('F1-GetUsers','xmlGroup')) {
oraShowErrorAlert();
return;
}
}
Ejemplo de la sentencia invocada dentro de onClick.
<input type="button" class="oraButton" oraMdLabel="DISPLAY_LBL" onClick="oraInvokeSS('F1-GetUserInfo');"/>
Refrescamiento de Página de Portal o Mapa Generado
Refrescamiento de Mapa
Esta función se usa para "Refrescar" solo la zona de mapa que ejecuta el comando.
Sintaxis |
---|
oraRefreshMap; |
...
<tr>
<td/>
<td><input type="button" onclick="oraRefreshMap();" value="Refresh"/></td>
</tr>
...
Refrescamiento de Página
Esta función se usa para refrescar todas las zonas del portal.
Sintaxis |
---|
oraRefreshPage; |
...
<tr>
<td/>
<td><input type="button" onclick="oraRefreshPage();" value="Refresh"/></td>
</tr>
...
Inicio de Script de Asistente de Proceso de Negocios
Inicio de Script de Asistente de Proceso de Negocios
Sintaxis | Parámetros | Comentarios |
---|---|---|
oraRunScript( ); | 'Código de script de Asistente de Proceso de Negocios'. | |
'Elemento de XPath' | Se pueden transmitir uno o más valores de elemento al Asistente de Proceso de Negocios, donde se puede hacer referencia a ellos como variables temporales. |
En el siguiente ejemplo, se crea una variable temporaria llamada "personId" con el valor "1234567890" y se inicia el script de Asistente de Proceso de Negocios llamado 'Edit Address'.
<html>
<body>
<table>
<tr>
<td>
<div oraField="address"></div>
<span oraField="city"></span>
<span>,</span>
<span oraField="state"></span>
<span oraField="zip"></span>
<span oraField="country"></span>
<a href="" onClick="oraRunScript('Edit Address','personId');">edit</a>
</td>
</tr>
</table>
</body>
<xml>
<root>
<personId>1234567890</personId>
<address>123 Main St</address>
<city>Alameda</city>
<state>CA</state>
<zip>94770</zip>
</root>
</xml>
</html>
HTML presentado.

Inicio de Script de Asistente de Proceso de Negocios con Valores
Esta función se usa para iniciar un Asistente de Proceso de Negocios y proporciona pares de nombre/valor para transferir al almacenamiento temporario. Se pueden transmitir múltiples valores. Luego, el Script de Asistente de Proceso de Negocios puede hacer referencia a las variables temporarias por nombre.
Sintaxis | Parámetros | Comentarios |
---|---|---|
oraRunScriptWithValues( ); | 'Código de script de Asistente de Proceso de Negocios'. | |
'Nombre de Elemento XPath':valor | Uno o más pares de nombres y valores de elemento. |
En el ejemplo que aparece debajo, una función de JavaScript llamada 'editUser()' es responsable de iniciar el script de Asistente de Proceso de Negocios llamado 'UserEdit'. Se crea la variable temporaria llamada 'userId' con el valor 'CMURRAY'.
<html>
<head>
<script type="text/javascript">
function editUser() {
var values = {'userId': 'CMURRAY'};
oraRunScriptWithValues('UserEdit', values);
return;
}
</script>
</head>
<body>
...
</body>
</html>
Cierre del Mapa de Interface de Usuario con Valores Vinculados
Esta función se usa para salir de un Mapa de Interface de Usuario. Cuando sale del mapa, puede especificar un valor para devolver al script y, además, si se debe devolver un XML actualizado.
Sintaxis | Parámetros | Comentarios |
---|---|---|
oraSubmitMap( ); | 'Valor de Devolución' | |
Valor buleano | Indica si se debe devolver el XML actualizado. El valor por defecto es true. |
En el siguiente ejemplo, el botón Grabar devolverá información actualizada; el botón Anular no lo hará.
<html>
<body>
<table>
<tr>
<td/>
<td style="padding-bottom:15px;">
<a href="" onclick="oraShowErrorAlert(); return false;">
<span oraErrorVar="ERRMSG-TEXT"></span></a>
</td>
</tr>
<tr>
<td >Address:</td>
<td><input type="text" oraField="address"/></td>
</tr>
<tr>
<td>City:</td>
<td><input type="text" oraField="city"/></td>
</tr>
<tr>
<td>State:</td>
<td><input type="text" oraField="state"/></td>
</tr>
<tr>
<td>Zip:</td>
<td><input type="text" oraField="zip"/></td>
</tr>
<tr>
<td/>
<td style="padding-top=15px;">
<input type="button" value="Save" onClick="oraSubmitMap('SAVE');"/>
<input type="button" value="Cancel" onClick="oraSubmitMap('CANCEL',false);"/>
</td>
</tr>
</table>
</body>
<xml>
<root>
<address>123 Main St</address>
<city>Alameda</city>
<state>CA</state>
<zip>94770</zip>
</root>
</xml>
</html>
Botones Grabar y Anular presentados:

Inclusión de Fragmento de Mapa
Esta función se usa para embeber un fragmento de mapa dentro de otro mapa de Interface de Usuario. Tenga en cuenta que es posible usar el nodo de inclusión en un mapa o en un fragmento de mapa.
Sintaxis | Parámetros | Comentarios |
---|---|---|
<oraInclude map=' ' prefixPath=' '/> | map='UI Map Code' | |
prefixPath='Xpath' | De manera opcional, especifique un prefijo de XPath para anexar a cada valor de atributo oraField, oraLabel, oraList, oraSelect valuePath y descPath, oraDownloadData y oraUploadData incluido que se define en el HTML del fragmento de mapa de Interface de Usuario. Nota: Esta funcionalidad solo se aplica a los valores de atributo de XPath si esos valores no aparecen debajo de un atributo oraList. Cualquier valor de XPath dentro de una tabla que contenga un atributo oraList no se verá afectado por un prefixPath.
|
-
Un ejemplo de un fragmento de mapa con dos botones, llamados 'F1-SaveCancelButtons'.
<input onClick ="oraSubmitMap('SAVE');" oraMdLabel="SAVE_BTN_LBL" class="oraButton" type="button"/> <input onClick ="oraSubmitMap('CANCEL',false);" oraMdLabel="CANCEL_LBL" class="oraButton" type="button"/>
-
Un ejemplo de un mapa que incluye el fragmento de mapa llamado 'F1-SaveCancelButtons'.
... <tr> <td colspan="2" align="center"> <oraInclude map="F1-SaveCancelButtons"/> </td> </tr> ...
Inclusión de un Componente Web
Un componente web es un elemento HTML personalizado que genera una función de interface de usuario específica. Cada componente web soportado generalmente tiene uno o más atributos HTML definidos que afectan el funcionamiento y la apariencia del componente web. Los componentes web más complejos pueden tener un correspondiente objeto de configuración del sistema que define el comportamiento y la información desplegada por el elemento de interface de usuario resultante. Por ejemplo, el componente web que produce un "árbol" de información tiene una tabla de configuración de Árbol, que define los detalles acerca de cómo recuperar información para el árbol y cómo desplegar cada nodo.
Atributos Comunes
Algunos atributos comunes que se pueden usar para cada componente web son:
-
Una referencia a la instancia específica del objeto de configuración que rige los detalles que se generarán.
-
La capacidad de transmitir datos de contexto como pares de nombre y valor.
-
Un "modo" que soporta el despliegue de una presentación preliminar de la función
-
Valor literal. Se puede hacer referencia al valor directamente. Ejemplo:
treename="F1-Tree"
-
Referencia de XPath. Las referencias de XPath deben utilizar la sintaxis explícita x[valor]. Ejemplo:
treename="x[migrationTree]"
-
Referencia de contexto Global o de Portal. Estas referencias deben utilizar la sintaxis explícita c[valor].
treename="c[TREE_NAME]"
-
Referencia de etiqueta de campo. Estas referencias deben utilizar la sintaxis explícita md[valor] .
text=md[F1_ADD_LBL]"
-
Referencia de texto de ayuda de campo. Estas referencias deben utilizar la sintaxis explícita mdh[valor] .
text=mdh[F1_OPERATIONS_LBL]"
Para los atributos complejos que soportan uno o más pares de nombre/valor, la sintaxis para definir los nombres y valores sigue las mismas reglas anteriores para valores literales, referencias de XPath y contexto. Se deben utilizar dos puntos (":") para separar el nombre del valor, y punto y coma (";") para separar cada par.
context="FIELD_NAME1:x[value1];FIELD_NAME2:F1AB;x[fieldName3]:c[FIELD_NAME3];"
Un componente web determinado puede tener atributos HTML adicionales específicos de su funcionalidad.
<body>
<oraInclude map="F1-OJETLIBSR"/>
..
</body>
En las siguientes secciones, se describe cada componente web soportado.
Árboles
Consulte Árboles para obtener más información sobre la configuración de árboles.
Sintaxis | Parámetros | Comentarios |
---|---|---|
<ou-tree...></ou-tree> | treename="singleValue" | Debe especificar una referencia al nombre del objeto de árbol que define la configuración del árbol que se desplegará. Este atributo espera un único valor que siga la sintaxis descrita en la sección de valor único anterior. |
context="..." | De manera opcional, transmita uno o más pares de nombre/valor. La sintaxis sigue el ejemplo que se muestra en la información anterior sobre atributos complejos. |
En el siguiente ejemplo, se utiliza una referencia explícita a un árbol y no se transmite ningún contexto. El árbol determinado depende del contexto global, al que tiene acceso el algoritmo de nodo de árbol.
<ou-tree treename="C1-PremiseTree"></ou-tree>
Información Detallada Contextual
Consulte Información Detallada Contextual para obtener información sobre la configuración relacionada con la definición de información detallada contextual.
Sintaxis | Parámetros | Comentarios |
---|---|---|
<ou-insights ...></ou-insights> | insightType="singleValue" | Utilice este atributo para especificar el tipo de información detallada que se desplegará. Se debe especificar este atributo o el atributo de clase de información detallada. Este atributo espera un único valor que siga la sintaxis descrita en la sección de valor único anterior. |
insightClass="singleValue" | Utilice una clase de información detallada para desplegar todos los tipos de información detallada del grupo relacionado con esta clase. Este atributo espera un único valor que siga la sintaxis descrita en la sección de valor único anterior. | |
context="..." | De manera opcional, transmita uno o más pares de nombre/valor. La sintaxis sigue el ejemplo que se muestra en la información anterior sobre atributos complejos. | |
mode="preview" | Como opción, transmita un modo preview para indicar al algoritmo de información detallada subyacente que prepara los datos que se está llamando a la información en modo de presentación preliminar, sin ningún contexto disponible. Lo ideal es que el algoritmo devuelva información de muestra. | |
class=" " | De manera opcional, proporcione una clase auxiliar CSS para controlar aspectos de la información detallada representada. Valores soportados: class="card-full-width": Se aplica a la información detallada de tarjetas. Utilice esta clase de opción para garantizar que el ancho de la información detallada de una tarjeta se ajuste al ancho de la zona que la contiene. Si en la información detallada de tarjeta no se define este parámetro, se usa un ancho fijo. |
A continuación, se presenta un ejemplo de mapa de presentación preliminar de información detallada donde el tipo de información detallada es el que está en contexto. No se necesitan datos de contexto y el modo es "preview".
<ou-insights insightType="x[insightType]" mode="preview"></ou-insights>
En el siguiente ejemplo, se utiliza una clase de información detallada y se transmiten valores de contexto desde elementos XPath con nombres de contexto definidos explícitamente.
<ou-insights insightClass="C1CI" context="PER_ID:x[personId];ACCT_ID:x[accountId];PREM_ID:x[premiseId];"></ou-insights>
Botón
El componente web de botón soporta el juego standard de formatos de botón utilizados dentro del sistema.
Sintaxis | Parámetros | Comentarios |
---|---|---|
<ou-button...></ou-button> | type=”singleValue” | Debe definir el tipo de botón que se desplegará. Este atributo espera un único valor que siga la sintaxis descrita en la sección de valor único anterior. Los tipos de valores válidos son:
Si no se proporciona ningún atributo de tipo, se desplegará una imagen de "botón roto". |
img=”singleValue” | Defina la ruta de acceso a la imagen que se desplegará. Se debe proporcionar este atributo o el atributo de referencia de imagen para un tipo de botón que incluya una imagen. Este atributo espera un único valor que siga la sintaxis descrita en la sección de valor único anterior. Tenga en cuenta que, para las imágenes SVG, si la referencia incluye solo el nombre del archivo SVG sin ninguna ruta de acceso, se asume que la ruta de acceso es el repositorio SVG de Framework. |
|
imgRef=”singleValue” | Defina la referencia de ícono de despliegue de la imagen que se utilizará. Se debe proporcionar este atributo o el atributo de imagen para un tipo de botón que incluya una imagen. Este atributo espera un único valor que siga la sintaxis descrita en la sección de valor único anterior. | |
text="..." | Defina los distintos elementos de texto que necesita el botón. La sintaxis sigue el ejemplo que se muestra en la información anterior sobre atributos complejos. Los valores válidos de nombre de elemento de texto son:
|
|
menu=”singleValue” | Defina el menú que se utilizará con el botón. Este atributo debe proporcionarse para un tipo de botón que incluya un control de menú. Este atributo espera un único valor que siga la sintaxis descrita en la sección de valor único anterior. | |
disabled=”singleValue” | Este es un atributo HTML standard. El valor "true" o simplemente la presencia del texto "disabled" indicará un botón que está inicialmente desactivado. | |
security="..." | De manera opcional, defina la configuración de seguridad para el botón. El botón estará oculto si el usuario no tiene el acceso de seguridad adecuado. La sintaxis sigue el ejemplo que se muestra en la información anterior sobre atributos complejos. Los valores válidos de nombre de elemento de seguridad son:
|
|
clickAction="..." | De manera opcional, defina la acción que se realizará cuando se haga click en el botón. La sintaxis sigue el ejemplo que se muestra en la información anterior sobre atributos complejos. Hay valores de "nombre" específicos para el atributo, como se indica a continuación:
El atributo también puede incluir otros pares de nombre/valor que definen la información que se transmitirá al script o que se utilizará como campos de contexto de navegación. Además de la configuración de atributos de seguridad, el sistema controlará si el usuario tiene acceso al script o a la ruta de navegación antes de realizar la acción. Se puede utilizar el atributo HTML standard "onClick". Si el HTML incluye un atributo "onClick" además de "clickAction", el atributo "onClick" tendrá prioridad. |
El siguiente es un ejemplo de un botón simple con texto.
<ou-button type="text" text="label:md[F1_BOOKMARK_LBL];"></ou-button>
El siguiente es un ejemplo de un botón de ícono que utiliza una referencia de ícono de despliegue.
<ou-button type="image" imgRef="F1CMNT"></ou-button>
El siguiente es un ejemplo de un botón de menú de imagen.
<ou-button type="imageMenu" imgRef="F1STTGS" menu="CI_CONTEXTSCRIPT" text="tooltip:md[F1INSTY_VIS_LBL];></ou-button>
El siguiente es un ejemplo de un botón de texto que permite navegar a otra página.
<ou-button type="text" text="label:md[ALG_CD];tooltip:md[GOTO_ALG]" clickAction="action:NAVIGATE; navopt:f1algqTabMenu; ALG_CD:x[algorithm];></ou-button>
Visualización de Esquema por Defecto para Adición
Los valores por defecto del esquema del mapa de Interface de Usuario se desplegarán en los campos de entrada del mapa de Interface de Usuario si un nodo <action> embebido tiene un valor "ADD" o en blanco.
Sintaxis |
---|
<action>ADD</action> |
<action> </action> |
Se despliega el esquema por defecto para el elemento <description>:
<schema>
<action/>
<boGroup type="group">
<key/>
<description default="enter description here"/>
</boGroup>
</schema>
<html>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
<tr>
<td>Description </td>
<td><input oraField="boGroup/description"></td>
</tr>
</table>
</body>
<xml>
<root>
<action>ADD</action>
<boGroup>
<key/>
<description/>
</boGroup>
</root>
</xml>
</html>
HTML presentado.

Configuración de un Gráfico
Además de integrar gráficos con zonas, el sistema soporta el uso de los mismos atributos dentro del HTML de Mapa de Interface de Usuario para configurar una representación gráfica de una lista XML. El diseñador puede controlar el tipo, el tamaño, la posición y el contenido del gráfico mediante estos atributos. Para obtener detalles sobre los atributos y la sintaxis, consulte Configuración de Gráficos del Explorador de Datos.
Ejemplos de Gráficos
-
Muestra de una configuración de gráfico tipo torta:
<html> <head> <title>Pie Chart</title> </head> <body> <div style="width:100%; height:290px;" oraChart="type:pie;" oraChartSeries1="list:set; labelPath:date; amount:amount; " oraChartBroadcast="BILL_ID:billId;"> </div> </body> <xml> <root> <set> <date>05-02-2003</date> <amount>163.24</amount> <billId>592211649441</billId> </set> <set> <date>06-02-2003</date> <amount>97.29</amount> <billId>592211649442</billId> </set> <set> <date>07-02-2003</date> <amount>54.38</amount> <billId>592211649443</billId> </set> </root> </xml> </html>
-
Un gráfico tipo torta presentado para una única serie:
-
Muestra de una configuración de gráfico de líneas, de columnas o apilado, cada uno con dos series:
<html> <head> <title>Stacked Chart</title> </head> <body> <div style="width:100%; height=300px;" oraChart="type:line;" oraChartSeries1="list:set; xaxis:date; label:Charge; amount:amount; " oraChartSeries2="list:set; xaxis:date; label:Balance; amount:balance; " oraChartBroadcast="BILL_ID:billId;"> </div> <div style="width:100%; height=300px;" oraChart="type:cluster;" oraChartSeries1="list:set; xaxis:date; label:Charge; amount:amount; " oraChartSeries2="list:set; xaxis:date; label:Balance; amount:balance; " oraChartBroadcast="BILL_ID:billId;"> </div> <div style="width:100%; height=300px;" oraChart="type:stacked;" oraChartSeries1="list:set; xaxis:date; label:Charge; amount:amount; " oraChartSeries2="list:set; xaxis:date; label:Balance; amount:balance; " oraChartBroadcast="BILL_ID:billId;"> </div> </body> <xml> <root> <set> <date>05-02-2003</date> <amount>163.24</amount> <balance>163.24</balance> <billId>592211649441</billId> </set> <set> <date>06-02-2003</date> <amount>97.29</amount> <balance>260.53</balance> <billId>592211649442</billId> </set> <set> <date>07-02-2003</date> <amount>54.38</amount> <balance>314.91</balance> <billId>592211649443</billId> </set> </root> </xml> </html>
-
Tres tipos de gráficos presentados para dos series cada uno: de líneas, de columnas y apilado.
Carga y Descarga de un Archivo CSV
Los siguientes atributos HTML se pueden usar para administrar tanto la carga como la descarga entre una lista definida dentro del esquema del mapa y un archivo CSV (valores separados por comas). Tenga en cuenta que esta técnica solo se recomienda para un volumen de datos pequeño a mediano, por ejemplo, no más de varios cientos de filas. Para volúmenes mayores, se recomienda usar la funcionalidad de carga/descarga en lote.
La sintaxis es oraUploadData="type:embed;path:list xpath;useLabels:true;showCount:true".
La carga de la configuración requiere que se indique un archivo CSV a cargar y una lista XML como destino. Por convención, cada fila de CSV crea una instancia de lista separada. Cada campo separado por comas del archivo se carga como un elemento separado en la lista. Para embeber un cuadro de dialogo de carga en un mapa, se debe asociar el atributo oraUploadData con un elemento contenedor, como div, td o span.
El valor opcional useLabels:true indica que, mientras se analiza el archivo CSV de carga, se espera que los encabezados sean etiquetas.
Al especificar el valor opcional showCount:true, se desplegará el número de registros cargados.
Muestra de oraUploadData="embed" en un elemento div.
<html>
<head>
<title>File Upload</title>
</head>
<body>
<div oraUploadData="type:embed;path:myList"> </div>
</body>
<xml>
<root>
<myList>
<id>838383930</id>
<name>Janice Smith</name>
</myList>
<myList>
<id>737773730</id>
<name>Bill McCollum</name>
</myList>
</root>
</xml>
</html>
Este cuadro de diálogo de carga de archivos se embeberá en el cuerpo de la página donde se definió oraUploadData.

oraUploadData="type:popup;path:list xpath;useLabels:true;showOk:true;showCount:true"
La carga de la configuración requiere que se indique un archivo CSV a cargar y una lista XML como destino. Por convención, cada fila de CSV crea una instancia de lista separada. Cada campo separado por comas del archivo se carga como un elemento separado en la lista. Para cargar un archivo CSV por medio de un cuadro de diálogo desplegable, el atributo oraUploadData debe estar asociado con un elemento de entrada, como un botón, un enlace de texto o una imagen.
El valor opcional useLabels:true se usa para indicar que, mientras se analiza el archivo CSV de carga, se espera que los encabezados sean etiquetas.
Si se especifica el valor opcional showOk:true, se desplegará el botón "Ok" una vez que finalice la carga. El cuadro de diálogo desplegable permanecerá abierto hasta que se presione el botón. Además, si se especifica el valor showCount:true, se desplegará el número de registros cargados.
Ejemplo de oraUploadData="popup" asociado con un botón:
<html>
<head>
<title>File Upload</title>
</head>
<body>
<input type="button" name="submitButton" oraUploadData="type:popup;path:myList;" value='Get Data'>
<table oraList="myList">
<tr/>
<tr>
<td><span oraField="id"/></td>
<td><span oraField="name"/></td>
</tr>
</table>
</body>
<xml>
<root>
<myList>
<id>838383930</id>
<name>Janice Smith</name>
</myList>
<myList>
<id>737773730</id>
<name>Bill McCollum</name>
</myList>
</root>
</xml>
</html>
HTML Presentado:

Al presionar el botón "Get Data", se iniciará un cuadro de diálogo de carga de archivos standard (proporcionado por Framework) como se muestra a continuación.

oraDownloadData="list xpath"
La configuración de descarga requiere que especifique una lista XML a descargar. Por convención, cada instancia de lista representará una fila separada en el archivo creado. Por defecto, cada elemento de la lista estará separado por una coma en el archivo.
Ejemplo de oraDownloadData.
<html>
<head>
<title>File Download</title></head>
<body>
<input type="button" name="downloadButton" oraDownloadData="myList" value="Download"/>
</body>
<xml>
<root>
<myList>
<id>881-990987</id>
<name>John Mayweather</name>
</myList>
<myList>
<id>229-765467</id>
<name>Anna Mayweather</name>
</myList>
<myList>
<id>943-890432</id>
<name>Andrew Brewster</name>
</myList>
</root>
</xml>
</html>
HTML Presentado:

Al presionar el botón "Download" se iniciará un cuadro de diálogo de descarga standard (proporcionado por Framework) como se muestra a continuación.

Una descarga exitosa dará como resultado un archivo CSV:

Para descargar datos desde una lista secundaria, use el atributo oraDownloadDataInList en lugar de oraDownloadData. El atributo oraDownloadDataInList tendrá el nombre de la lista secundaria. El XPath de la lista secundaria se usa para seleccionar datos de una fila específica de la lista principal. Por lo tanto, solo se descarga la lista secundaria específica.
oraDownloadDataUseLabels="true"
El atributo oraDownloadDataUseLabels se puede usar en conjunto con el atributo oraDownloadData descrito anteriormente. Especifique oraDownloadDataUseLabels si desea que el archivo CSV generado use las etiquetas de elemento para los encabezados de columna en lugar de los nombres de elemento.
Creación de Fragmentos de Mapa de Zona de Portal
Las zonas de portal pueden hacer referencia a un mapa de Interface de Usuario para la cabecera de zona y el área de filtro. Este mapa de Interface de Usuario no es un documento HTML completo, sino que está configurado como un fragmento de Mapa de Interface de Usuario. Al crear un fragmento de mapa de zona, puede hacer referencia a las siguientes variables de sustitución. Tenga en cuenta que estas variables se completarán de manera dinámica en tiempo de ejecución con información específica de la zona del mapa dentro del portal:
Variable | Lógica de Reemplazo |
---|---|
[$ZONEDESCRIPTION] | Texto de descripción de la zona. |
[$SEQUENCEID] | ID de secuencia de la zona |
[$ZONENAME] | Nombre de la zona. |
[$HELPTEXT] | Texto de ayuda de la zona. |
[$ZONEPARAMNAME] | Valor del parámetro de zona (o en blanco si no se especificó). |
-
Consulte uno de los siguientes mapas como ejemplo: F1-UIMapHeader y F1-ExplorerHeader.
-
Estos mapas usan la etiqueta oraInclude para incorporar fragmentos HTML para las acciones del marco y el menú de encabezado. Consulte los parámetros de tipo de zona para conocer los fragmentos de Mapa de Interface de Usuario que debe incluir en el HTML.
-
Si desea que el ícono "texto de ayuda" aparezca junto a la descripción de la zona, debe tener id="title_[$SEQUENCEID] en el elemento <td> que contiene la descripción.
-
Si se debe encapsular JavaScript en un fragmento de Mapa de Interface de Usuario, será necesario vincular el JavaScript dentro de una etiqueta
![CDATA[ ]]
para garantizar que el documento XML sea válido. Tenga en cuenta que es posible que las etiquetas se deban convertir en comentarios para favorecer la compatibilidad con browsers antiguos. Por ejemplo:<script type="text/javascript"> /*<![CDATA[ */ // //javascript // /*]]> */ </script>
-
oraGetZoneSequence(zoneName). Usa el código de la zona para recuperar el número de secuencia.
-
oraIsZoneCollapsed(sequenceId). Usa la secuencia de la zona para determinar si está cerrada.
-
oraHandleCollapse(seq). Cierra una zona.
-
oraHandleExpand(seq,refresh). Expande y/o refresca una zona.
Ejemplo de oraLoad[$SEQUENCEID] usado en una función:
<script type="text/javascript">
function oraLoad[$SEQUENCEID]() {
checkRebateClaimStatus();
}
function checkRebateClaimStatus() {
var work = id(''analyticsFilterText[$SEQUENCEID]'',
document).cells[0].innerText.split('' '');
var rebateClaimId = work[work.length - 3];
id(''rebateClaimId'', document).value = rebateClaimId;
oraInvokeSS(''C1-CheckRCSt'',''checkRebateClaimStatus'', false);
var statusIndicator = id(''statusInd'', document).value;
if (statusIndicator == ''C1PE'' || statusIndicator == ''C1ID'') {
id(''addRebateClaimLine'', document).style.display = '''';
} else {
id(''addRebateClaimLine'', document).style.display = ''none'';
}
}
</script>
F1-ExplorerHeader presentado:

Invocación de un Objeto de Negocio
La función oraInvokeBO se puede usar dentro de un encabezado de zona de portal o de un mapa de filtro de zona. Es similar al comando que se describe en Invocación de Función de Objeto de Negocio que permite que un objeto de negocio se invoque dentro del HTML del mapa de Interface de Usuario. Consulte esa sección para obtener una descripción de los primeros tres parámetros.
Sintaxis | Parámetros | Comentarios |
---|---|---|
oraInvokeBO( ) | 'Nombre de Objeto de Negocio' | |
"XPath" o null | ||
'acción' | ||
null | Se debe especificar como el cuarto argumento. | |
[$SEQUENCEID] | Se debe especificar como el quinto argumento. | |
true | false | Especifique true si el fragmento se usa dentro de un encabezado de zona de portal. Especifique false si el fragmento se usa con un mapa de filtro de portal. |
Ejemplo en un encabezado de zona de portal:
oraInvokeBO('CM-User','xmlGroup','read', null, [$SEQUENCEID], true)
Invocación de un Servicio de Negocio
La función oraInvokeBS se puede usar dentro de un encabezado de zona de portal o de un mapa de filtro de zona. Es similar al comando que se describe en Invocación de Función de Servicio de Negocio que permite que un servicio de negocio se invoque dentro del HTML del mapa de Interface de Usuario. Consulte esa sección para obtener una descripción de los primeros dos parámetros.
Sintaxis | Parámetros | Comentarios |
---|---|---|
oraInvokeBS( ) | 'Nombre de Objeto de Negocio' | |
"XPath" o null | ||
null | Se debe especificar como el cuarto argumento. | |
[$SEQUENCEID] | Se debe especificar como el quinto argumento. | |
true | false | Especifique true si el fragmento se usa dentro de un encabezado de zona de portal. Especifique false si el fragmento se usa con un mapa de filtro de portal. |
Ejemplo en un encabezado de zona de portal:
oraInvokeBS('CM-UserSearch','xmlGroup', null, [$SEQUENCEID], true)
Invocación de un Script de Servicio
La función oraInvokeSS se puede usar dentro de un encabezado de zona de portal o de un mapa de filtro de zona. Es similar al comando que se describe en Invocación de Función de Script de Servicio que permite que un script de servicio se invoque dentro del HTML del mapa de Interface de Usuario. Consulte esa sección para obtener una descripción de los primeros dos parámetros.
Sintaxis | Parámetros | Comentarios |
---|---|---|
oraInvokeSS( ) | 'Nombre de Script de Servicio' | |
"XPath" o null | ||
null | Se debe especificar como el cuarto argumento. | |
[$SEQUENCEID] | Se debe especificar como el quinto argumento. | |
true | false | Especifique true si el fragmento se usa dentro de un encabezado de zona de portal. Especifique false si el fragmento se usa con un mapa de filtro de portal. |
Ejemplo en un encabezado de zona de portal:
oraInvokeSS('UserSearch','xmlGroup', null, [$SEQUENCEID], true)
Detección de Cambios No Grabados
Use esta función para devolver un valor booleano a verdadero si hay cambios no grabados. El sistema interrogará la función cuando el usuario intente navegar y emitirá una advertencia en consecuencia. Esta función solo es necesaria si un mapa de interface de usuario utiliza un javascript personalizado para administrar elementos de forma que el sistema no pueda detectar si se han realizado cambios. Además, tenga en cuenta que es responsabilidad del javascript del mapa de la interface de usuario administrar los valores en el booleano utilizado para esta función.
function hasUnsavedChanges(){
return isDirtyFlag;
}
Ocultamiento de Separadores de Portal
El producto proporciona la capacidad de usar JavaScript para ocultar un separador en el portal actual de acuerdo con una condición por medio de la API de JavaScript oraAuthorizeTab. Esta API acepta una función como parámetro y desactiva el índice de separador indicado.
Por ejemplo, el Mapa de Interface de Usuario puede tener una función para desactivar uno o más índices de separador:
function overrideTabIndex(index){
if (index == 2) return false;
if (index == 3) return false;
}
Se hace referencia a JavaScript en el momento de carga:
<body class="oraZoneMap"
onLoad="oraAuthorizeTabs(overrideTabIndex);">
Bibliotecas de JavaScript Necesarias
Todas las funcionalidades que se describen en este documento dependen de un par de bibliotecas de JavaScript. Si escribe y ejecuta los mapas por completo dentro del marco que presenta el mapa de Interface de Usuario, no necesita insertar manualmente las siguientes bibliotecas, ya que el marco las insertará cuando se presente el Mapa de Interface de Usuario.
src="privateUserMapSupport.js"
El documento HTML debe hacer referencia a esta biblioteca para ejecutar la vinculación en un entorno independiente.
<script type="text/javascript" src="privateUserMapSupport.js"></script>
src="userMapSupport.js"
Para aprovechar las funciones opcionales del juego de herramientas, debe hacer referencia a esta biblioteca.
<script type="text/javascript" src="userMapSupport.js"></script>
onload="oraInitializeUserMap();"
Para ejecutar una vinculación en un entorno independiente, debe embeber la siguiente función onLoad en el nodo <body>.
<body onload="oraInitializeUserMap();">