Atributos y funciones de mapa de UI

Nota: en este tema, el término "campo" se utiliza para hacer referencia al concepto genérico de mostrar y capturar datos en un "campo", y al objeto de metadatos suministrado en el producto para definir los campos. Al referirse a este último, se utiliza el término "Campo de metadatos" y se proporciona un hiperenlace a la documentación del campo.

Contenido

Unión de XML y HTML

Creación de una lista desplegable

Formato de los campos de entrada y salida

Visualización de etiquetas

Activación de la ayuda del mapa de UI

Búsqueda con una zona del explorador emergente

Mostrar errores

Activación de JavaScript para eventos del explorador

Ocultación de elementos

Llamada de servicios basados en el esquema

Actualización de un mapa representado o la página del portal

Embeber navegación de marco

Lanzamiento del script de ayudante de proceso de negocio

Salida del mapa de UI con valores unidos

Inclusión de un fragmento de mapa

Inclusión de un componente web

Visualización del esquema por defecto al añadir

Configuración de un gráfico

Carga y descarga de un fichero CSV

Construcción de fragmentos de mapa de la zona de portal

Bibliotecas de JavaScript necesarias

Detección de cambios sin guardar

Ocultación de las pestañas del portal

Unión de XML y HTML

Solo son necesarios dos atributos diferentes para unir el XML del mapa de UI a su HTML. Estos dos atributos necesitan un documento XML embebido en el HTML, en el que el XML está unido mediante nodos <xml>.

Aviso: puede embeber un par de etiquetas <xml></xml> en el documento HTML para que se produzca la unión.

Enlazado de un campo


Sintaxis	Valores	Descripción
oraField=" "	XPath de elemento de campo	Este atributo se utiliza para enlazar un elemento HTML de forma directa a un elemento XML, donde el elemento XML está definido en el esquema XML del mapa de UI. El atributo puede usarse con cualquier elemento HTML de representación, como: <span>, <div> e <input>.

HTML para el elemento input:


<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 representado

HTML para los 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 representado:

Enlazado de una lista

Este atributo se utiliza para enlazar un elemento HTML de forma directa a una lista XML, donde la lista XML está definido en el esquema XML del mapa de UI. El objetivo del elemento es activar el marco para replicar el HTML de la tabla cada vez que aparece la lista.


Sintaxis	Valores	Descripción
oraList=" "	XPath de elemento de lista	Este atributo se utiliza para enlazar un elemento HTML de forma directa a una lista XML, donde la lista XML está definido en el esquema XML del mapa de UI. El objetivo del elemento es activar el marco para replicar el HTML de la tabla cada vez que aparece la lista.

Nota: los atributos de oraField embebidos en la lista deben contener la navegación de XPath relativa a la lista. Consulte un ejemplo a continuación.

<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 representado:

Creación de una lista desplegable

Los atributos siguientes se proporcionan para crear un elemento HTML "select", también denominado una lista desplegable, según las fuentes.


Source	Sintaxis	Valores	Ejemplos
Lista de valores	oraSelect="lookup: ;"	Campo de lista de valores	`... <td>House Type:</td> <td> <select oraField="houseType" oraSelect="lookup:HOUSE_TYPE;"> </select> </td>`
Lista de valores ampliable	oraSelect="lookupBO: ;"	Código de objeto de negocio	`... <td>UI Device Display Type:</td> <td> <select oraField="uiDeviceType" oraSelect="lookupBO: F1-DeviceDisplayTypes;"></select> </td>`
Tipo de característica (predefinido)	oraSelect="charType: ;"	Código de tipo de característica	`... <td>Usage:</td> <td> <select oraField="statusReasonUsage" oraSelect="charType:F1-SRUSG;"></select> </td> ...`
Tabla de control	oraSelect="table: ;" Nota: este atributo solo funciona con tablas que siguen la estructura de tablas de control estándar, en la que hay una tabla de idioma relacionada que incluye la columna DESCR como columna de descripción. Utilice el diccionario de datos del visor de aplicaciones para identificar las tablas aptas para esta funcionalidad. Aviso: la función oraSelect solo funcionará si se muestran menos de 500 valores.	Nombre de tabla	`... <td>Currency: </td> <td> <select oraField="currency" oraSelect="table:CI_CURRENCY_CD;"> </select> </td> ...`
Servicio de página	oraSelect="service: ;"	Nombre de servicio de página	`... <td>Country:</td> <td> <select oraField="country" oraSelect="service:CIPTCNTW;"> </select> </td> ...`
Lista embebida	Se usa para crear una lista desplegable de selección basada en una lista del XML del mapa. oraSelect="valuePath: ;descPath: "	Después de valuePath, indique el XPath del elemento que contiene los valores. Después de descPath, indique el XPath del elemento que contiene las descripciones.	<html> <body> <table summary="" border="0" cellpadding="1" cellspacing="1"> <tr> <td>Select: </td> <td><select oraSelect= "valuePath:list/value; descPath:list/desc" oraField="target"></select></td> </tr> </table> </body> <xml> <root> <target>10</target> <list> <value>10</value> <desc>Ten</desc> </list> <list> <value>20</value> <desc>Twenty</desc> </list> <list> <value>40</value> <desc>Forty</desc> </list> </root> </xml> </html>
Script de servicio	oraSelect="ss: ;"	Código de script de servicio	Consulte a continuación la sintaxis adicional necesaria al usar esta función.
Servicio de negocio	oraSelect="bs: ;"	Código de servicio de negocio	Consulte a continuación la sintaxis adicional necesaria al usar esta función.

Al especificar un script de servicio o un servicio de negocio, es necesaria información de asignación para transferir datos al servicio y desde él.


Sintaxis	Valores	Descripción
oraSelectIn=" ;"	serviceXPath:element;	Se usa para transferir el valor a otro elemento en el servicio (asignándolo al XPath del servicio).
oraSelectIn=" ;"	serviceXPath:'Literal'	Se usa para transferir una constante o literal al servicio (asignándolo al XPath del servicio).
oraSelectOut="valuePath: ; descPath: "	Consulte los ejemplos a continuación.	Se usa para indicar qué elemento de la salida del servicio contiene los valores y cuál contiene las descripciones.

Ejemplo de uso de 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 suele usarse cuando hay una dependencia entre los elemento 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 el elemento principal cambia, puede ser necesario actualizar el elemento secundario. Este comportamiento puede implantarse usando la función llamada en un evento onChange del mapa. La sintaxis es oraHandleDependentElements('elemento dependiente');. Se puede asignar nombre a múltiples elementos de destino (dependientes).

El siguiente ejemplo está relacionado con el anterior ejemplo de servicio de negocio, en el que la lista de sistemas externos es específica de un determinado tipo de mensaje saliente, que se transfiere como una entrada. El siguiente fragmento de código muestra la configuración del elemento de tipo de mensaje saliente para activar una actualización 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>
...

Formato de los campos de entrada y salida

Los atributos siguientes están diseñados para aplicar un formato de tipo de datos para los campos de entrada y salida.

Formato automático


Sintaxis
oraSchemaDataTypes="false"

Este atributo se utiliza para activar el formato automático en el documento HTML representado. El formato automatizado tendrá lugar de acuerdo con los atributos del tipo de datos definidos en el esquema de mapa de UI. Para ver detalles del formato de tipo de datos específico, consulte la siguiente descripción del atributo oraType.

Aviso: el atributo oraSchemaDataTypes="true" se inyectará de modo automático en el HTML del mapa de UI. Si no desea aplicar los tipos de datos del esquema al HTML representado, debe especificar este atributo en el nodo de cuerpo con un valor de falso. ¡El atributo <body oraSchemaDataTypes="false"> es necesario para evitar el formato automático!

Esquema de mapa de UI:

<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 del mapa de UI:


<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 representado.

Formato de fecha

Esta función se utiliza para mostrar una fecha de acuerdo con el perfil de visualización del usuario. Para los campos de entrada, el valor asigna formato a los datos cuando el usuario sale 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 representado.

Formato de hora

Esta función se utiliza para mostrar una hora de acuerdo con el perfil de visualización del usuario. Para los campos de entrada, el valor asigna formato a los datos cuando el usuario sale 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 representado.

Formato de fecha y hora

Esta función se utiliza para mostrar un registro de hora de acuerdo con el perfil de visualización del usuario. Si esta función se utiliza para un elemento de entrada, se divide en dos partes, una para la fecha y otra para la hora. La parte de la hora del elemento de fecha y hora puede suprimirse con el 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 representado.

Formato de fecha y hora con hora estándar

Esta función verdadera se utiliza para representar un elemento de fecha y hora, de acuerdo con el calendario de horas en horario de verano de la zona horaria 'base'. La zona de hora 'base' se especifica en la tabla Instalación y representa la zona de hora de la base de datos. Para los elementos de entrada con este valor, se considera que todas las horas introducidas corresponden al calendario de horas en horario de verano de la zona horaria 'base'. Si se introduce una hora que no se puede convertir sin ambigüedad a la hora estándar, se solicitará al usuario que proporcione una etiqueta de zona horaria para indicar si se ha introducido la hora estándar o en horario de verano.


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 representado.

Nota: la etiqueta de zona horaria aparece porque, de lo contrario, 1:28 sería ambiguo. Legalmente, el 1 de noviembre de 2009 1:28 AM tiene lugar dos veces, porque la hora en horario de verano se retrasa a las 2:00 AM. Con la función stdTime, las etiquetas de zona horaria solo se muestran cuando es necesario para aclarar horas que se solapan.

HTML representado para el día siguiente.

HTML representado para oraType="dateTime; stdTime:true" el día siguiente

Formato de fecha y hora con referencia a la zona horaria


Sintaxis	Valores válidos	Descripción
oraType="dateTime; stdTimeRef: ;"	Referencia a un XPath después de la coma.	Esta función se utiliza para representar un elemento de fecha y hora de acuerdo con el calendario de horas en horario de verano de una zona horaria a cuyo XPath se hace referencia. Tenga en cuenta que se considera que la hora procesada se ha almacenado en la hora estándar de la zona horaria a la que se hace referencia; por tanto solo se realizará el cambio en el horario de verano, no en la zona horaria.
oraType="dateTime; displayRef: ;"	Referencia a un XPath después de la coma.	Esta función es similar a stdTimeRef, excepto que ejecutará el cambio de zona horaria además del cambio de hora en horario de verano. Para utilizar displayRef de forma correcta, solo tiene que asociarla con los elementos de zona horaria que se han almacenado en la zona de hora base.

Para los elementos de entrada, se considera que todas las horas introducidas corresponden al calendario de horas en horario de verano de la zona horaria referenciada. Si se introduce una hora que no se puede convertir sin ambigüedad a la hora estándar, se solicitará al usuario que proporcione una etiqueta de zona horaria para indicar si se ha introducido la hora estándar o en horario de verano.

<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 representado.

Nota: la etiqueta de zona horaria aparece siempre para una zona horaria referenciada.

HTML representado para el día siguiente.

HTML representado para oraType="dateTime; stdTimeRef:xpath" el día siguiente

Formato de duración


Sintaxis
oraType="duration"

Esta función se utiliza para mostrar la duración de tiempo. Para un elemento de entrada, el valor introducido por el usuario se convierte de minutos a horas y minutos, según corresponda. Por ejemplo, un valor introducido como '90' se convierte en '00:01:30' al 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 representado.

Formato de día del mes


Sintaxis
oraType="dayInMonth"

Esta función se utiliza para mostrar un día y un 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 representado.

Formato de mes del año


Sintaxis
oraType="monthInYear"

Esta función se utiliza para mostrar un mes y un 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 representado.

Formato monetario

Esta función se utiliza para mostrar un número como un importe monetario. Consulte la tabla para ver opciones de configuración relativas a la divisa. Para los elementos de entrada, emite un error y se introduce un valor no numérico.


Sintaxis	Descripción
oraType="money: "	Especifique de forma directa un código de divisa después de la coma.
oraType="money;currencyRef: "	Referencia a un XPath (después de la coma) para un elemento que hace referencia a un código de divisa.
oraType="money"	Si no se especifica ninguna divisa de referencia divisa, se utiliza la divisa de la instalación.

Nota: debe especificar un par de referencias de hojas de estilo, cisEnabled y cisDisabled, en la cabecera del mapa para obtener la alineación correcta. La hoja de estilo controla el modo en que se representa el campo. Si desea modificar la representación, debe sustituir el estilo oraMoney.

<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 representado

Formato de número

Esta función se utiliza para mostrar un número o validar un valor de entrada. Para los elementos de entrada, el sistema devuelve un error y se introduce 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 representado.

Formato de referencia de clave externa

Por defecto, cuando se muestra un elemento con un oraType fkRef, están activados una cadena de información, un menú contextual, la navegación y la búsqueda (si la referencia de clave externa se ha configurado de esa forma). Se proporciona la sintaxis para que pueda desactivar cualquiera de estas características de forma selectiva.

Tenga en cuenta que también puede activar el hiperenlace de clave externa, consulte Embeber navegación de marco para obtener más información. Los diversos atributos utilizados para controlar la funcionalidad de referencia a la clave externa son los siguientes. Tenga en cuenta que, en todos los casos, 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 todo el siguiente procesamiento de referencia de clave externa. Utilice el valor 'false' para desactivar el procesamiento de referencia de clave externa.
info. El valor "true" representa la cadena de información en el mapa de UI, si corresponde.
context. El valor 'true' representa un menú contextual que aparece antes que el elemento de referencia de clave externa, si corresponde.
navigation. El valor 'true' hace que la cadena de información se represente como un hiperenlace, si corresponde. Al pulsar el hiperenlace, se accede a la página adecuada.
search. El valor "true" muestra un icono de búsqueda que lanza la zona de búsqueda, si corresponde.

Nota: la funcionalidad de menú contextual y navegación con clave externa solo está disponible para mapas de UI presentados en una zona de portal. Los mapas de UI presentados durante el procesamiento del script de ayudante de proceso de negocio no soportan las opciones de navegación. La funcionalidad de búsqueda solo está disponible para los elementos HTML de entrada.

Esquema de mapa de UI:


<schema>
  <bo fkRef="F1-BOMO"/>
</schema>

HTML del mapa de UI:


<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 representado.

Formato de lista de valores

Esta función se utiliza para mostrar la descripción de un valor de lista.


Sintaxis	Valores válidos
oraType="lookup: "	Nombre del campo de lista de valores después de la coma.


<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 representado.

HTML para el valor de lista representado.

Formato de lista de valores ampliable

Esta función se utiliza para mostrar la descripción de un valor de lista ampliable.


Sintaxis	Valores válidos
oraType="lookupBO: "	Nombre del código de objeto de negocio después de la coma.


<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 representado.

Formato de tipo de característica

Esta función se utiliza para mostrar 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 la coma.


<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 representado.

Formato de la tabla de control

Esta función se utiliza para mostrar la descripción de una tabla de control que tiene una tabla de idiomas asociada.


Sintaxis	Valores válidos
oraType="table: "	Código de tabla después de la coma.


<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 representado.

Adición o eliminación del formato de cuadrícula


Sintaxis	Descripción
oraType="addGridRow"	La función addGridRow se utiliza para crear el cuadro de diálogo "insertar fila" en el mapa de UI. Se muestra una imagen 'añadir'. Al pulsar la imagen, se inserta una nueva fila en la cuadrícula. Si la lista está vacía, por defecto, se añade de modo automático una fila de cuadrícula vacía. Esto significa que el usuario siempre verá al menos una fila de cuadrícula cuando se usa este atributo.
oraType="deleteGridRow"	La función deleteGridRow se utiliza para crear el cuadro de diálogo "suprimir fila" en el mapa de UI. Se muestra una imagen 'suprimir'. Al pulsar la imagen, se elimina la fila adyacente de la cuadrícula.

Nota: puesto que los cuadros de diálogo para añadir y suprimir solo son relevantes dentro una tabla, estos atributos deben especificarse dentro de un elemento <td>.

Aviso: estos atributos están diseñados para trabajar con la acción del objeto de negocio "sustituir" en lugar de "actualizar". Por tanto, si el mapa contiene una cuadrícula, debe usarse la acción del objeto de negocio 'sustituir' para actualizar el objeto de negocio. Consulte Acción de sustitución del objeto de negocio para obtener más información.

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 representado.

Representación de HTML para añadir o suprimir una fila

Elementos sin formato

Esta función se utiliza para mostrar el contenido de un elemento que contiene datos sin procesar, tal como se define para el elemento del esquema que se está representando.


Sintaxis
oraType="raw"

Esquema de mapa de UI:


<schema>
    <rawStuff type="raw"/>
</schema>

HTML del mapa de UI:


<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 representado.

Formato de cadena

Esta función se utiliza para mostrar el contenido de un elemento, como la impresión con sangría del XML, cuando el elemento contiene XML con escape.


Sintaxis
oraType="xmlString"

Nota: no es obligatorio, pero la impresión con sangría del XML representado mejora si especifica un par de referencias de hojas de estilo, cisEnabled y cisDisabled, en la cabecera del mapa.

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 representado.

HTML representado sin oraType=”xmlString”

Formato HTML

Esta función se utiliza para mostrar el contenido de un elemento como HTML, en lugar de como texto sin formato. Un elemento definido como oraType="fkref" se representa de modo automático como HTML.


Sintaxis
oraType="html"

Aviso:

Para evitar la ejecución de HTML, no se soportan todas las etiquetas HTML. La lista de etiquetas soportadas se establece en la definición de contenido administrado "F1-HTMLWhiteList".

Si se detecta HTML no soportado, se escapa todo el elemento y se representa como texto plano. Por tanto, se recomienda escapar de forma correcta cualquier cadena de código fuente que contribuya al elemento HTML final si no se espera que contenga HTML válido. De esta forma, se escapa la cadena problemática, no todo el elemento.

Si el elemento HTML está compuesto en un script, consulte la función "escape" descrita en Edición de la sintaxis de los datos para obtener más información. Use la API de Java WebStringUtilities.asHTML para escapar el 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 representado.

HTML representado sin oraType="html"

Visualización de etiquetas

Derivación de una etiqueta a partir de un elemento

Este atributo se utiliza para obtener una etiqueta que depende del idioma para un elemento HTML <span>, <td> o <input>.


Sintaxis	Valores válidos
oraLabel=" "	XPath de un elemento en el esquema de mapa de UI. El elemento debe hacer referencia al atributo mapField=, mdField= o label=.

Nota: también puede definir un campo de forma directa en su HTML para la definición de la etiqueta; consulte Derivación de una etiqueta a partir de un campo para obtener más información.

Nota: si el esquema contiene múltiples atributos, el atributo oraLabel elige la etiqueta que se representará de acuerdo con la siguiente jerarquía: el atributo de etiqueta sustituye al atributo mdField, que a su vez sobre escribe al atributo mapField.

Esquema de mapa de UI:

<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 representado:

Derivación de una etiqueta a partir de un campo

Este atributo se utiliza para obtener una etiqueta que depende del idioma para un elemento HTML <span>, <td>, <input> o <title>. El texto de la etiqueta se deriva del campo al que se hace referencia.


Sintaxis	Valores válidos
oraMdLabel=" "	Código de campo de metadatos.

Nota: también puede definir etiquetas derivadas de la definición del esquema del mapa; consulte Derivación de una etiqueta a partir de un elemento para obtener más información.

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 representado:

Activación de la ayuda del mapa de UI

En la sección Visualización de etiquetas se describen las formas de derivar la etiqueta para un elemento con un Campo de metadatos subyacente. Además, si el mismo campo de metadatos contiene el texto de ayuda, el sistema generará de modo automático una ayuda emergente adyacente a la etiqueta del elemento. Al pulsar la ayuda emergente, el usuario puede ver el texto de ayuda.

Es posible cambiar la representación de la ayuda emergente. Consulte Opciones de aspecto personalizado para obtener más información.

Búsqueda con una zona del explorador emergente

Opción de búsqueda

Este atributo se utiliza para activar la funcionalidad de zona de búsqueda para los elementos HTML de entrada.


Sintaxis	Valores válidos
oraSearch=" "	Código de zona.

Nota: el atributo oraSearch es similar a oraType, ya que se incluirá "de modo automático" en el HTML mediante el atributo oraSchemaDataTypes. Esto significa que la codificación del atributo oraSearch en el HTML del mapa de UI solo es necesaria si no se ha especificado ninguna zona de búsqueda en el esquema o en la referencia de clave externa del elemento del esquema.

Ejemplo de definición de una búsqueda en el HTML. Esquema del mapa de UI:

<schema>
   <uiMap/> 
</schema>

HTML del mapa de UI

<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 una búsqueda en el esquema. Esquema del mapa de UI:

<schema> 
   <uiMap search="F1-UISRCH"/>
</schema>

HTML del mapa de UI

<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 externa define la zona de búsqueda. Esquema del mapa de UI:


<schema>
   <uiMap fkRef="F1-UISRC"/> 
</schema>

HTML del mapa de UI

<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 representado es el mismo.

Inicialización de campos de búsqueda

Este atributo opcional se utiliza para inicializar los filtros de zona de búsqueda. Se pueden inicializar múltiples filtros. Este atributo solo se puede utilizar junto con oraSearch.


Sintaxis	Valores válidos	Opciones de valor de campo	Comentarios
oraSearchField=" "	Uno o varios pares de nombre del campo y valor del campo separados por coma. Cada par está separado por un punto y coma. oraSearchField="fieldName:fieldValue: ..." El nombre del campo se usa para identificar el filtro de zona que se inicializará cuando se lance la búsqueda. El nombre del campo debe coincidir con el valor de la abreviación searchField especificada en un parámetro de filtro de usuario o filtro oculto de la zona de búsqueda.	Ningún valor	Si no especifica ningún valor de campo, se utilizará el valor del elemento de entrada que contiene el atributo oraSearchField.
		XPath	Indique el XPath al elemento del esquema que contiene el valor que se utilizará.
		'literal'	Indique el valor literal que se suministrará.

Nota: si no específica ningún atributo oraSearchField y se ha especificado una fkRef con búsqueda activada en el elemento del esquema, el marco crea de modo automático un oraSearchField en el que el nombre del campo es igual a los campos de la clave de la referencia de clave externa (MD).

Aviso: puede llamarse a la zona del explorador emergente de dos formas: pulsando el botón de búsqueda, o bien pulsando la tecla Intro desde el campo situado a la izquierda del botón. Si pulsa el botón, no se transferirá información del campo de búsqueda a la zona. La información del campo de búsqueda solo se utiliza para inicializar los valores del filtro de zona cuando se pulsa Intro.

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>

Asignación de campos de búsqueda devueltos

Este atributo opcional se utiliza para dirigir los valores devueltos por la zona de búsqueda. Se pueden especificar múltiples campos. Este atributo solo se puede utilizar junto con oraSearch.


Sintaxis	Valores válidos	Opciones de valor de campo	Comentarios
oraSearchOut=" "	Uno o varios pares de nombre del campo y valor del campo separados por coma. Cada par está separado por un punto y coma. oraSearchOut="field name:xpath target; ..." El nombre del campo se usa para identificar el resultado de la búsqueda devuelto desde la zona de consulta. El nombre del campo debe coincidir con la abreviación ELEMENT_NAME definida en el parámetro de resultado de la búsqueda de la zona del explorador.	Ningún valor	Si no especifica ningún valor de campo, el elemento de entrada que contiene el atributo oraSearchField recibe el valor devuelto.
oraSearchOut=" "		XPath	Indique el XPath al elemento del esquema que debe recibir el valor devuelto.

Nota: si no específica ningún atributo oraSearchOut, el marco crea uno por defecto en el que el nombre del campo se definirá igual que el nombre del campo de oraSearchField.

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>

Mostrar errores

Visualización de variables de error

Se puede mostrar una de las variables de error siguientes.


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 representado

Resaltado de un campo con error

Nota: para obtener más información acerca de cómo lanzar un error, consulte Sentencia de terminación en la sección Edición de la sintaxis de los datos.


Sintaxis	Comentarios
oraError="automate:true\|false; prefix: "	Al especificar automate:true, que activa de modo automático el resaltado del elemento incorrecto al emitir un error. Tenga en cuenta que el valor por defecto es true y no es necesario especificarlo. Especifique automate:false para desactivar el resaltado de campos.
	El sistema utiliza una coincidencia del nombre del elemento al que se hace referencia en el error con los nombres de elementos en el mapa de UI. Si los elementos del esquema están en un XPath que puede no coincidir con lo que es referenciado por el error, use prefix:XPath para especificarlo.

Nota: debe especificar un par de referencias de hojas de estilo, cisEnabled y cisDisabled, para la referencia del estilo oraError. La hoja de estilo controla el modo en que se representa el campo que tiene el error. Si desea modificar la representación, debe sustituir el estilo oraError.

En el siguiente ejemplo de HTML se muestra que los elementos del mapa se definen en un grupo denominado boGroup. El nombre del elemento devuelto por el error no incluirá este grupo, así que para que el resaltado del campo funcione de forma correcta, el atributo prefix: debe indicar el nombre del 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 representado, en el que el elemento de error iniciado es igual a 'lastName':

oraErrorElement representado de modo automático con oraError en la etiqueta de cuerpo

Sustitución del nombre del elemento con un error

En las raras ocasiones en las que el nombre del elemento devuelto por el error no coincida con el nombre del elemento en el mapa, podrá añadir un atributo explícito para indicar el nombre del elemento con un error.


Sintaxis	Valores válidos	Comentarios
oraErrorElement=	"nombre de elemento"	El nombre del elemento al que se hace referencia aquí debe coincidir de forma exacta con el nombre del elemento con un error asignado cuando se inició el error. El mismo nombre de elemento con error puede hacer referencia a más de un campo HTML.

Esto ilustra un escenario en el que el nombre del elemento asociado al error difiere del nombre del elemento en el 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 representado.

Visualización de mensajes emergentes de error

Cuando se muestra el texto de error, esta función puede usarse para abrir de forma emergente el cuadro de diálogo de error estándar (que muestra más información) cuando un usuario pulsa 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 representado.

Cuadro de diálogo emergente de error estándar lanzado al pulsar un mensaje de error:

Ventana detallada lanzada con la función oraShowAlert

Activación de JavaScript para eventos del explorador

Trabajo con el marco JavaScript

Hay muchos eventos de JavaScript que se pueden usar con el entorno HTML/Javascript. Esto incluye eventos como onLoad, onBlur, onChange, etcétera. El marco del mapa de UI también utiliza algunos de estos eventos. Es importante que cualquier mapa de UI que desarrolle funcione con el marco para obtener resultados coherentes (es posible que los eventos no siempre se ejecuten en el mismo orden).

Aviso:

A continuación se describe el enfoque recomendado para gestionar de forma segura la carga y el procesamiento de las actualizaciones de los campos en los mapas de UI.

Si es necesario JavaScript en un fragmento o mapa de UI XHTML, deberá unirlo en una etiqueta ![CDATA[ ]] para garantizar un documento XML válido. Tenga en cuenta que puede ser necesario eliminar los comentarios de las etiquetas para aumentar la compatibilidad con exploradores 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.

Al cargar el mapa de UI, si hay un controlador de eventos ya anexado a un elemento HTML, el marco lo elimina y anexa un controlador de eventos combinado. El controlador combinado llama a cualquier controlador del marco primero y, después, a los demás controladores (personalizados).

Aviso: tenga en cuenta que la función no se debe utilizar para ejecutar la lógica que vuelve a modificar el valor de los datos del campo asociado; de lo contrario, se producirá un bucle.

En el siguiente ejemplo, se ejecuta la función oraInvokeBS al pulsar 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.

Aviso: al ejecutar oraLoad en un mapa de UI de fragmento, si necesita ejecutar una función de JavaScript durante la carga de la página (en la que la función llama a un objeto de negocio, un servicio de negocio o un script de servicio), puede usar la sintaxis especial "oraLoad[$SEQUENCEID]". Para ver otra sintaxis especial utilizada por los fragmentos de mapa, consulte la sección Construcción de una cabecera de zona de portal.

En el siguiente ejemplo, se ejecuta la función oraDisplayNone al cargar la 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 representado

Evento después de cargar la 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 cargar la 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>

Ocultación de elementos

Ocultación mediante una función

El sistema ofrece varias técnicas para ocultar un elemento HTML.


Sintaxis	Valores válidos	Comentarios
oraDisplayNone(item );	(item, 'XPath', 'valor', 'operador')	Se usa para ocultar un elemento en función de otro elemento (referenciado con su XPath). Introduzca un valor de ' ' para interrogar un valor en blanco. Por defecto, el operador es '='. También puede definirse en otro operador, como '!=', '>' o '<'.
oraDisplayNone(item );	(item, function name,true \| false)	Se usa para indicar una función de JavaScript, que debe devolver un valor booleano.
oraIsSuppress="true"		Utilice esta opción en aquellos campos que deban ocultarse siempre, y no en función de otro dato. Defina este atributo en el elemento HTML (elemento div).

Ejemplo en el que la etiqueta de ID de usuario está oculta cuando no existe ningún 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 Guardar 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>

Comprobación del acceso de seguridad del usuario

El sistema proporciona dos funciones para comprobar el acceso de seguridad de un usuario a un determinado servicio de la aplicación y modo de acceso. Suelen usarse para ocultar elementos.


Sintaxis	Parámetros
oraHasSecurity( )	'Código de servicio de la aplicación'
oraHasSecurity( )	'Modo de acceso'
oraHasSecurityPath('x','y')	'XPath del servicio de la aplicación'
oraHasSecurityPath('x','y')	'XPath del modo de acceso'

Consulte la sección anterior para ver un ejemplo de la función oraHasSecurity. A continuación se muestra un ejemplo en el que el botón de estado está oculto cuando el usuario no tiene acceso de seguridad al modo de acceso 'ACT' para el 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>

Llamada de servicios basados en el esquema

El Sistema proporciona funciones para llamar a un objeto de negocio, un servicio de negocio o un script de servicio.

Llamada de una función de objeto de negocio

Esta función se utiliza para realizar una interacción del objeto de negocio de forma directa desde el HTML del mapa de UI. Devuelve un valor 'true' o 'false', en función de si la llamada encuentra un error.


Sintaxis	Parámetros	Comentarios
oraInvokeBO( )	'Nombre de objeto de negocio'
	'XPath' o null	Identifica un elemento de grupo mediante XPath. Si especifica la palabra null, se transferirá todo el objeto XML embebido.
	'acción'	Indica La acción que se usará. Los valores válidos son add, delete, read, update, replace, fastAdd y fastUpdate. Fastpath: para obtener más información sobre las diversas acciones de objeto de negocio, consulte Acciones de objeto de negocio.

Ejemplo con la sentencia a la que se llama en una función de JavaScript.

function invokeBO {
     if (!oraInvokeBO('F1-User','xmlGroup','read')) {
          oraShowErrorAlert();
          return;
}
}

Ejemplo con la sentencia llamada en onClick.

<input type="button"  class="oraButton" oraMdLabel="DISPLAY_LBL" onClick="oraInvokeBO('F1-User');"/>

Llamada de una función de servicio de negocio

Esta función se utiliza para realizar una interacción del servicio de negocio de forma directa desde el HTML del mapa de UI. Devuelve un valor 'true' o 'false', en función de si la llamada encuentra un error.


Sintaxis	Parámetros	Comentarios
oraInvokeBS( )	'Nombre del servicio de negocio'
oraInvokeBS( )	'XPath' o null	Identifica un elemento de grupo mediante XPath. Si especifica la palabra null, se transferirá todo el objeto XML embebido.

Ejemplo con la sentencia codificada en una función de JavaScript.

function invokeBS {
     if (!oraInvokeBS('F1-UserSearch','xmlGroup')) {
          oraShowErrorAlert();
          return;
  }
}

Ejemplo con la sentencia a la que se llama mediante onClick.

<input type="button"  class="oraButton" oraMdLabel="DISPLAY_LBL" onClick="oraInvokeBS('F1-RetrieveInfo');"/>

Llamada de una función de script de servicio

Esta función se utiliza para realizar una interacción del script de servicio de forma directa desde el HTML del mapa de UI. Devuelve un valor 'true' o 'false', en función de si la llamada encuentra un error.


Sintaxis	Parámetros	Comentarios
oraInvokeSS( )	'Nombre del script de servicio'
oraInvokeSS( )	'XPath' o null	Identifica un elemento de grupo mediante XPath. Si especifica la palabra null, se transferirá el documento de pertenece al nodo principal. Si el nodo principal no es suficiente, siempre se puede transferir todo el documento mediante la siguiente sintaxis: `oraInvokeSS('service script', null, null, [$SEQUENCEID])`

Ejemplo con la sentencia a la que se llama en una función de JavaScript.


function invokeSS {
     if (!oraInvokeSS('F1-GetUsers','xmlGroup')) {
          oraShowErrorAlert();
          return;
}
}

Ejemplo con la sentencia llamada en onClick.

<input type="button"  class="oraButton" oraMdLabel="DISPLAY_LBL" onClick="oraInvokeSS('F1-GetUserInfo');"/>

Actualización de un mapa representado o la página del portal

Actualización del mapa

Esta función se utiliza para actualizar solo la zona del mapa en la que se emite el comando.


Sintaxis
oraRefreshMap;

...
    <tr>
        <td/>
        <td><input type="button" onclick="oraRefreshMap();" value="Refresh"/></td>
    </tr>
...

Actualización de la página

Esta función se utiliza para actualizar todas las zonas del portal.


Sintaxis
oraRefreshPage;

...
    <tr>
        <td/>
        <td><input type="button" onclick="oraRefreshPage();" value="Refresh"/></td>
    </tr>
...

Embeber navegación de marco

Desplazamiento con la opción de navegación

Esta función se utiliza para navegar a otra página usando la información definida en una opción de navegación.


Sintaxis	Parámetros
oraNavigate( );	'Código de opción de navegación'
oraNavigate( );	'XPath de la clave'

Aviso: esta función solo está diseñada para un mapa de UI mostrado en una zona de portal. No se debe usar en un mapa de UI lanzado por un script de ayudante de proceso de negocio.

En el siguiente ejemplo se muestran dos posibles usos de esta función: como URL y como botón. Tenga en cuenta que el esquema de mapa de UI debe contener un atributo fkRef. Consulte Formato de referencia de clave externa para obtener más información.

<schema>
    <userId fkRef="CI_USER"/>
</schema>

<html>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
    <tr>
       <td>User Link: </td>
       <td><a href="" onclick="oraNavigate('userMaint','userId'); return false;">
         <span oraField="userId" oraType="fkRef:CI_USER"></span></a>
       </td>
    </tr>
    <tr>
        <td>User Button: </td>
        <td><input type="submit" onclick="oraNavigate('userMaint','userId')" 
          value="Go to User"/></td>
    </tr>
</table>
</body>
<xml>
<root>
    <userId>SPLAXT</userId>
</root>
</xml>
</html>

HTML representado.

Lanzamiento del script de ayudante de proceso de negocio


Sintaxis	Parámetros	Comentarios
oraRunScript( );	'Código de script de ayudante de proceso de negocio'.
oraRunScript( );	'Elemento de XPath'	Puede que uno o varios valores de elemento se transfieran al script de ayudante de proceso de negocio, donde se puede hacer referencia a ellos como variables temporales.

Aviso Esta función solo es aplicable a los mapas de UI mostrados en las zonas de portal. Los mapas de UI iniciados en un script de ayudante de proceso de negocio en ejecución no pueden lanzar de manera directa otro script de ayudante de proceso de negocio desde el HTML del mapa de UI. En lugar de ello, devuelven un valor del mapa de UI y ejecutan un tipo de paso Ejecutar script o Transferir control.

Nota: es responsabilidad del autor del script extraer información del almacenamiento temporal en los pasos iniciales del script.

En el siguiente ejemplo, se crea una variable temporal denominada 'personId' con el valor '1234567890' y se lanza el script de ayudante de proceso de negocio 'Editar dirección'.

<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 representado.

Lanzamiento del script de ayudante de proceso de negocio con valores

Esta función se utiliza para lanzar un ayudante de proceso de negocio, proporcionando pares de nombre/valor que se introducirán en el almacenamiento temporal. Se pueden transferir varios valores. A continuación, el script de ayudante de proceso de negocio puede hacer referencia a las variables temporales por su nombre.


Sintaxis	Parámetros	Comentarios
oraRunScriptWithValues( );	'Código de script de ayudante de proceso de negocio'.
oraRunScriptWithValues( );	'Nombre de elemento XPath':value	Uno o varios pares de nombres y valores de elementos.

Nota: utilice esta función de JavaScript, en lugar de oraRunScript, si necesita introducir valores en el script de ayudante de proceso de negocio que no se encuentran en la estructura XML del mapa de UI.

En el siguiente ejemplo, una función de JavaScript denominada 'editUser()' es responsable de lanzar el script de ayudante de proceso de negocio 'Editar usuario'. Se creará la variable temporal '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>

Salida del mapa de UI con valores unidos

Esta función se utiliza para salir de un mapa de UI. Al abandonar el mapa, puede especificar un valor para volver al script y, además, si se devuelve XML actualizado.


Sintaxis	Parámetros	Comentarios
oraSubmitMap( );	'Devolver valor'
oraSubmitMap( );	Valor booleano	Indica si se debe devolver el XML actualizado. El valor por defecto es true.

En el siguiente ejemplo, el botón Guardar devolverá información actualizada, y el botón Cancelar 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 Guardar y Cancelar representados

Inclusión de un fragmento de mapa

Esta función se utiliza para embeber un fragmento de mapa en otro mapa de UI. Tenga en cuenta que es posible usar el nodo de inclusión en un mapa o un fragmento de mapa.


Sintaxis	Parámetros	Comentarios
<oraInclude map=' ' prefixPath=' '/>	map='Código de mapa de UI'
<oraInclude map=' ' prefixPath=' '/>	prefixPath='Xpath'	Puede especificar que se añada un prefijo de XPath a cada valor de atributo oraField, oraLabel, oraList, oraSelect valuePath y descPath, oraDownloadData y oraUploadData incluido que esté definido en el HTML del fragmento del mapa de UI. Nota: esta funcionalidad solo afecta a los valores de atributos de XPath cuando dichos valores no aparezcan debajo de un atributo oraList. Cualquier valor de XPath en una tabla que contenga un atributo oraList no se verá afectado por un prefixPath.

Ejemplo de un fragmento de mapa con dos botones, denominado '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"/>

Ejemplo de un mapa que incluye el fragmento de mapa denominado '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 interfaz de usuario específica. Cada componente web que se soporta incluye, por lo general, uno o más atributos HTML definidos que afectan al funcionamiento del componente web y al modo en que aparece. Los componentes web más complejos pueden incluir un objeto de configuración de sistema correspondiente que define el comportamiento y la información que muestra el elemento de interfaz de usuario resultante. Por ejemplo, el componente web que genera un "árbol" de información incluye una tabla de configuración de árbol, que define los detalles sobre cómo se recupera la información y cómo se muestra cada nodo.

Atributos comunes

Algunos de los atributos comunes que se pueden utilizar para cada componente web son:

Una referencia a la instancia específica del objeto de configuración que rige los detalles que se generan.
La posibilidad de transferir datos de contexto como, por ejemplo, pares de nombre y valor.
Un 'modo' que soporta la vista previa de una función.

Algunos atributos soportan un valor único al que se hace referencia. Para estos tipos de atributos, el valor se puede indicar utilizando una de las referencias siguientes:

Valor literal. Se puede hacer referencia directa al valor. Ejemplo:
```
treename="F1-Tree"
```
Referencia de XPath. Las referencias de XPath deben utilizar la sintaxis explícita x[value]. Ejemplo:
```
treename="x[migrationTree]"
```
Referencia de contexto global o de portal. Estas referencias deben utilizar la sintaxis explícita c[value].
```
treename="c[TREE_NAME]"
```
Referencia de etiqueta de campo. Estas referencias deben utilizar la sintaxis explícita md[value].
```
text=md[F1_ADD_LBL]"
```
Referencia de texto de ayuda de campo. Estas referencias deben utilizar la sintaxis explícita mdh[value].
```
text=mdh[F1_OPERATIONS_LBL]"
```

En el caso de atributos complejos que soportan uno o más pares de nombre/valor, la sintaxis para definir los nombres y valores seguirá las mismas reglas que se han indicado antes para valores literales, referencias de XPath y contexto. Deben utilizarse dos puntos (":") para separar el nombre del valor y puntos y comas (";") para separar cada par.

context="FIELD_NAME1:x[value1];FIELD_NAME2:F1AB;x[fieldName3]:c[FIELD_NAME3];"

Un componente web determinado puede incluir atributos HTML adicionales específicos para su funcionalidad.

Nota: cualquier mapa de UI que defina un componente web deberá incluir el fragmento de mapa F1-OJETLIBSR en la etiqueta "body" (cuerpo).

<body>
<oraInclude map="F1-OJETLIBSR"/>
..
</body>

Nota: también se pueden indicar atributos HTML estándar (por ejemplo, ID=".." y style=".."). Estos se definen de la forma habitual. Debe tenerse en cuenta que los propios componentes web pueden controlar directamente parte de los aspectos de estilo y, por tanto, pueden sustituir cualquier configuración de estilo indicada en el componente web HTML. Por ejemplo, en la configuración de información detallada contextual se incluyen valores para el color de texto, que sustituiría a cualquiera color definido en el HTML.

En las secciones siguientes se describe cada componente web soportado.

Árboles

Para obtener más información sobre la configuración de árbol, consulte Árboles.


Sintaxis	Parámetros	Comentarios
<ou-tree...></ou-tree>	treename="singleValue"	Debe indicar una referencia al nombre del objeto de árbol que define la configuración del árbol que se mostrará. Este atributo espera un valor único, que seguirá la sintaxis descrita en la sección de valor único anterior.
<ou-tree...></ou-tree>	context="..."	De forma opcional, se pueden transferir uno o más pares nombre/valor. La sintaxis seguirá el ejemplo que se muestra en la información de atributos complejos indicada con anterioridad.

En el siguiente ejemplo se utiliza una referencia explícita a un árbol y no se transfiere ningún contexto. El árbol particular se basa en el contexto global, al que tiene acceso el algoritmo de nodo de árbol.

<ou-tree treename="C1-PremiseTree"></ou-tree>

Información detallada contextual

Consulte la sección de información detallada contextual para obtener más detalles sobre la configuración relativa a la definición de dicho tipo de información.


Sintaxis	Parámetros	Comentarios
<ou-insights ...></ou-insights>	insightType="singleValue"	Utilice este atributo para especificar el tipo de información detallada que se va a mostrar. Debe indicarse este atributo o el atributo de clase de información detallada. Este atributo espera un valor único, que seguirá la sintaxis descrita en la sección de valor único anterior.
	insightClass="singleValue"	Utilice una clase de información detallada para mostrar todos los tipos para el grupo de información detallada relacionado con esta clase. Este atributo espera un valor único, que seguirá la sintaxis descrita en la sección de valor único anterior.
	context="..."	De forma opcional, se pueden transferir uno o más pares nombre/valor. La sintaxis seguirá el ejemplo que se muestra en la información de atributos complejos indicada con anterioridad.
	mode="preview"	De forma opcional, puede indicarse un modo de vista previa para indicar al algoritmo de información detallada subyacente que prepara los datos que se llama a la información detallada en modo de vista previa, sin contexto disponible. De forma idónea, el algoritmo devolverá la información de muestra.
	class=" "	De forma opcional, indique una clase de ayuda de CSS para controlar los aspectos de la información detallada representada. Valores soportados: class="card-full-width" - Aplicable para información detallada de tarjeta. Utilice esta clase de opción para asegurarse de que el ancho de la información detallada de tarjeta se ajusta al de la zona que la contiene. Si no se define este parámetro, la información detallada de tarjeta utilizará un ancho fijo.

El siguiente ejemplo procede del mapa de vista previa de información detallada, donde el tipo de información detallada será el de contexto. No será necesario indicar datos de contexto y el modo será 'vista previa'.

<ou-insights insightType="x[insightType]" mode="preview"></ou-insights>

En el siguiente ejemplo se utiliza una clase de información detallada y se transfieren valores de contexto de los elementos de XPath con nombres de contexto definidos de forma explícita.

<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 ofrece soporte para los formatos de juegos de botones estándar que se utilizan en el sistema.


Sintaxis	Parámetros	Comentarios
<ou-button...></ou-button>	type=”singleValue”	Debe definir qué tipo de botón se mostrará. Este atributo espera un valor único, que seguirá la sintaxis descrita en la sección de valor único anterior. Los valores de tipo válido son: image - solo imagen text - solo texto imageText - imagen, seguida de un texto menu - texto y una intercalación desplegable para abrir el menú imageMenu - imagen y una intercalación desplegable para abrir el menú Si no se indica ningún atributo de tipo, se mostrará una imagen de 'botón roto'.
	img=”singleValue”	Defina la ruta de la imagen que se mostrará. Deberá indicarse este atributo o el de referencia de imagen para el tipo de botón que incluye una imagen. Este atributo espera un valor único, que seguirá la sintaxis descrita en la sección de valor único anterior. Debe tenerse en cuenta que, en el caso de imágenes SVG, si la referencia solo incluye un nombre de fichero SVG, sin ruta, se considerará que esta es la del repositorio de SVG de marco.
	imgRef=”singleValue”	Defina la referencia de icono de visualización de la imagen que se va a utilizar. Deberá indicarse este atributo o el de la imagen para un tipo de botón que incluye una imagen. Este atributo espera un valor único, que seguirá 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 seguirá el ejemplo que se muestra en la información de atributos complejos indicada con anterioridad. Los valores de nombre de elemento de texto válidos son: label - texto de etiqueta que se utilizará en el botón tooltip - texto desplegable que se utilizará para el botón aria-label - etiqueta ARIA para el botón
	menu=”singleValue”	Defina el menú que se utilizará con el botón. Deberá indicarse este atributo para un tipo de botón que incluya un control de menú. Este atributo espera un valor único, que seguirá la sintaxis descrita en la sección de valor único anterior.
	disabled=”singleValue”	Se trata de un atributo HTML estándar. Un valor "true" (verdadero) o la presencia del texto "disabled" (desactivado) dará como resultado un botón inicialmente desactivado.
	security="..."	De forma opcional, defina la configuración de seguridad para el botón. Si el usuario no dispone del acceso de seguridad adecuado, el botón quedará oculto. La sintaxis seguirá el ejemplo que se muestra en la información de atributos complejos indicada con anterioridad. Los valores de nombre de elemento de seguridad válidos son: service - servicio de aplicación cuyo acceso de seguridad rige el acceso al botón. accessMode - modo de acceso específico para el servicio, que determina un nivel de acceso más granular al botón.
	clickAction="..."	De forma opcional, defina la acción que se llevará a cabo al pulsar el botón. La sintaxis seguirá el ejemplo que se muestra en la información de atributos complejos indicada con anterioridad. Para los atributos existen los valores de ‘nombre’ específicos siguientes: action - acción que se llevará a cabo. Los valores válidos son ‘BPA’ y ‘NAVIGATE’ script - script que se ejecutará cuando la acción sea 'BPA'. navopt - opción de navegación que se utilizará si la acción es ‘NAVIGATE’ El atributo también puede incluir otros pares de nombre/valor que definen la información que se va a transferir al script o se utilizan como campos de contexto de navegación. Además de los valores de atributo de seguridad, el sistema comprobará que el usuario dispone de acceso al script o a la ruta de navegación antes de realizar la acción. El atributo ‘onClick’ de HTML estándar se puede seguir utilizando. Si el HTML incluye un atributo ‘onClick’ además de ‘clickAction’, ‘onClick’ tendrá prioridad.

A continuación, se incluye un ejemplo de un botón simple con texto.

<ou-button type="text" text="label:md[F1_BOOKMARK_LBL];"></ou-button>

A continuación, se incluye un ejemplo de un botón de icono que utiliza una referencia de icono de visualización.

<ou-button type="image" imgRef="F1CMNT"></ou-button>

A continuación, se incluye 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>

A continuación, se incluye un ejemplo de un botón de texto que accede 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 del esquema por defecto al añadir

Los valores por defecto en el esquema del mapa de UI aparecerán en un campo de entrada de dicho mapa si un nodo <action> embebido tiene el valor 'ADD' o vacío.


Sintaxis
<action>ADD</action>

<action> </action>

Se mostrará el esquema por defecto del 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 representado.

Configuración de un gráfico

Además de integrar los gráficos con las zonas, el sistema soporta el uso de los mismos atributos dentro del HTML de mapa de UI 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 relativos a los atributos y a la sintaxis, consulte Configuración de gráfico del explorador de datos.

Ejemplos de gráficos

Ejemplo de configuración de un gráfico circular:

<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 circular representado para una sola serie:

Ejemplo de configuración de un gráfico de líneas, grupos o barras apiladas, 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áfico representados para dos series cada uno: líneas, grupos y barras apiladas.

Carga y descarga de un fichero CSV

Los atributos HTML siguientes pueden usarse para gestionar y realizar cargas y descargas entre una lista definida en el esquema del mapa y un fichero CSV (valores separados por comas). Debe tenerse en cuenta que esta técnica solo se recomienda para un volumen de datos de tamaño reducido o medio que no supere, por ejemplo, varios centenares de filas. Para volúmenes mayores, se recomienda el uso de la funcionalidad de carga/descarga.

La sintaxis es oraUploadData="type:embed;path:list xpath;useLabels:true;showCount:true"

Cargar la configuración requiere asignar un nombre al fichero CSV que se va a cargar, y una lista XML como destino. De forma convencional, cada fila CSV creará una instancia de lista independiente. Cada campo separado por coma del fichero se cargará como un elemento independiente en la lista. Para embeber un cuadro de diálogo de carga en un mapa, es necesario asociar el atributo oraUploadData a un elemento contenedor, como div, td o span.

El valor useLabels:true opcional indica que, mientras se analiza el fichero CSV de carga, se espera que las cabeceras sean etiquetas

Nota: si no especifica el valor de useLabels:true y el nombre del elemento de destino XML es "camelCase", la cabecera de la hoja de cálculo correspondiente debe tener todas las palabras en mayúsculas y con un espacio entre palabras; por ejemplo, "Iniciales Mayúscula". Las letras y caracteres especiales no se consideran una palabra diferente; por ejemplo, Dirección1 se cargará en la dirección1 del elemento XML de destino.

Al especificar el valor showCount:true opcional, se mostrará el número de registros cargados.

CAUTION: si utiliza una cuadrícula junto con la función oraUploadData, debe mantener la lista de la cuadrícula con una acción de objeto de negocio "reemplazar". Consulte Acción de sustitución del objeto de negocio para obtener más información.

Ejemplo 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 ficheros se embeberá en el cuerpo de la página en la que se define oraUploadData.

Cuadro de diálogo de carga de ficheros embebido

oraUploadData="type:popup;path:list xpath;useLabels:true;showOk:true;showCount:true"

Cargar la configuración requiere asignar un nombre al fichero CSV que se va a cargar, y una lista XML como destino. De forma convencional, cada fila CSV creará una instancia de lista independiente. Cada campo separado por coma del fichero se cargará como un elemento independiente en la lista. Para cargar un fichero CSV mediante un cuadro de diálogo emergente, es necesario asociar el atributo oraUploadData a un elemento de entrada, como un botón, un enlace de texto o una imagen.

El valor useLabels:true opcional se usa para indicar que, mientras se analiza el fichero CSV de carga, se espera que las cabeceras sean etiquetas

Al especificar el valor showOk:true opcional, se mostrará un botón "Aceptar" cuando termine la carga. La ventana emergente permanecerá abierta hasta que se pulse el botón. Además, al especificar el valor showCount:true se mostrará el número de registros cargado.

Ejemplo de oraUploadData="popup" asociado a 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 representado:

Atributo oraUploadData anexado al botón Obtener datos

Al pulsar el botón Obtener datos, se abrirá un cuadro de diálogo de carga de ficheros estándar (proporcionado por el marco), como se muestra a continuación.

Cuadro de diálogo emergente de carga de ficheros

oraDownloadData="list xpath"

Descargar la configuración requiere asignar un nombre a la lista XML que se va a descargar. De forma convencional, cada instancia de lista representará una fila independiente en el fichero creado. Por defecto, cada elemento de la lista estará separado por una coma en el fichero.

Nota: el formato de número se basa en el valor del perfil de usuario. Para localidades en las que el símbolo decimal es una coma, una implantación puede configurar un valor de propiedad (spl.csv.delimiter.useFromDisplayProfile=true) para hacer que el sistema utilice un punto y coma como del imitador que separa los elementos, en lugar de una coma.

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 representado:

Atributo oraDownloadData anexo al botón Descargar

Al pulsar el botón Descargar, se abrirá un cuadro de diálogo de descarga de ficheros estándar (proporcionado por el marco), como se muestra a continuación.

Cuadro de diálogo emergente de descarga de ficheros

Una descarga correcta dará como resultado un fichero CSV:

Para descargar datos de una sublista, utilice el atributo oraDownloadDataInList, en lugar de oraDownloadData. El atributo oraDownloadDataInList tendrá el nombre de la sublista. El XPath de la sublista se utiliza para elegir datos de una fila específica de la lista principal. De esta forma, solo se descarga la sublista específica.

oraDownloadDataUseLabels="true"

El atributo oraDownloadDataUseLabels solo se puede utilizar junto con el atributo oraDownloadData antes descrito. Especifique oraDownloadDataUseLabels si desea que el fichero CSV generado utilice etiquetas de elemento para las cabeceras de columna, en lugar de nombres de elementos.

Construcción de fragmentos de mapa de la zona de portal

Las zonas de portal pueden hacer referencia a un mapa de UI para la cabecera de la zona y el área de filtro. Este mapa de UI no es un documento HTML completo, sino que está configurado como un fragmento de mapa de UI. Al construir un fragmento de mapa de zona, puede hacer referencia a las variables de sustitución siguientes. Tenga en cuenta que estas variables se rellenarán de forma dinámica en tiempo de ejecución con información específica de la zona de mapa en el portal:


Variable	Lógica de sustitución
[$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 la zona (o vacío si no se ha especificado).

Aviso:

Consulte uno de los mapas siguientes como ejemplo: F1-UIMapHeader y F1-ExplorerHeader.
Estos mapas utilizan la etiqueta oraInclude para incorporar los fragmentos HTML para las acciones de menú de cabecera y marco. Consulte los parámetros de tipo de zona para los fragmentos de mapa de UI que debe incluir en su HTML.
Si desea que el icono "texto de ayuda" aparezca al lado de la descripción de la zona, debe tener id="title_[$SEQUENCEID]" en el <td> que contiene la descripción.
Si es necesario encapsular JavaScript en un fragmento de mapa de UI, deberá unirlo al JavaScript en una etiqueta ![CDATA[ ]] para garantizar un documento XML válido. Tenga en cuenta que puede ser necesario eliminar los comentarios de las etiquetas para aumentar la compatibilidad con exploradores antiguos. Por ejemplo:
```
<script type="text/javascript">

/*<![CDATA[ */

//
//javascript
//
/*]]> */
</script>
```

Nota: si desea preservar los valores de un campo de entrada de filtro, en un fragmento de mapa de filtro, para las funcionalidades Volver atrás y Avanzar del marco, debe asociar el campo de entrada (cuadro de texto, seleccionar, etcétera) a un ID HTML exclusivo. Los valores del campo de entrada asociados a un ID exclusivo se capturarán en el 'memento' del marco. 'memento' se utiliza para volver a crear el mapa de entrada cuando se accede a la zona de portal mediante la funcionalidad Volver atrás o Avanzar.

Nota: existen muchas funciones especializadas para manipular el comportamiento de la zona; por ejemplo:

oraGetZoneSequence(zoneName). Utiliza el código de zona para recuperar su número de secuencia
oraIsZoneCollapsed(sequenceId). Utiliza el código de zona para determinar si está reducido
oraHandleCollapse(seq). Reducir una zona.
oraHandleExpand(seq,refresh). Ampliar y/o actualizar una zona.

Todas estas funciones, y muchas más, se encuentran en la biblioteca de JavaScript userMapSupport.js, descrita a continuación.

Nota: al ejecutar oraLoad en un mapa de UI del fragmento, si necesita ejecutar una función de JavaScript durante la carga de la página (en la que la función llama a un objeto de negocio, un servicio de negocio o un script de servicio), puede usar la sintaxis especial "oraLoad[$SEQUENCEID]". Consulte la sección Evento al cargar la página para obtener más información.

Ejemplo de oraLoad[$SEQUENCEID] usada 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 representado:

Llamada de un objeto de negocio

La función oraInvokeBO puede usarse en la cabecera de una zona de portal o un mapa de filtro de zona. Es similar en el comando descrito en Llamada de una función de objeto de negocio, que permite llamar a un objeto de negocio en el HTML del mapa de UI. Consulte esa sección para ver una descripción de los tres primeros parámetros.


Sintaxis	Parámetros	Comentarios
oraInvokeBO( )	'Nombre de objeto de negocio'
	'XPath' o null
	'acción'
	null	Debe especificarse como el cuarto argumento.
	[$SEQUENCEID]	Debe especificarse como el quinto argumento.
	true \| false	Especifique true si el fragmento se usa en una cabecera de la zona de portal. Especifique false si el fragmento se usa con un mapa de filtro de zona.

Ejemplo en una cabecera de la zona de portal:

oraInvokeBO('CM-User','xmlGroup','read', null, [$SEQUENCEID], true)

Llamada de un servicio de negocio

La función oraInvokeBS puede usarse en la cabecera de una zona de portal o un mapa de filtro de zona. Es similar en el comando descrito en Llamada de una función de servicio de negocio, que permite llamar a un Servicio de negocio en el HTML del mapa de UI. Consulte esa sección para ver una descripción de los dos primeros parámetros.


Sintaxis	Parámetros	Comentarios
oraInvokeBS( )	'Nombre de objeto de negocio'
	'XPath' o null
	null	Debe especificarse como el cuarto argumento.
	[$SEQUENCEID]	Debe especificarse como el quinto argumento.
	true \| false	Especifique true si el fragmento se usa en una cabecera de la zona de portal. Especifique false si el fragmento se usa con un mapa de filtro de zona.

Ejemplo en una cabecera de la zona de portal:

oraInvokeBS('CM-UserSearch','xmlGroup', null, [$SEQUENCEID], true)

Llamada de un script de servicio

La función oraInvokeSS puede usarse en la cabecera de una zona de portal o un mapa de filtro de zona. Es similar en el comando descrito en Llamada de una función de script de negocio, que permite llamar a un script de negocio en el HTML del mapa de UI. Consulte esa sección para ver una descripción de los dos primeros parámetros.


Sintaxis	Parámetros	Comentarios
oraInvokeSS( )	'Nombre del script de servicio'
	'XPath' o null
	null	Debe especificarse como el cuarto argumento.
	[$SEQUENCEID]	Debe especificarse como el quinto argumento.
	true \| false	Especifique true si el fragmento se usa en una cabecera de la zona de portal. Especifique false si el fragmento se usa con un mapa de filtro de zona.

Ejemplo en una cabecera de la zona de portal:

oraInvokeSS('UserSearch','xmlGroup', null, [$SEQUENCEID], true)

Detección de cambios sin guardar

Utilice esta función para devolver un valor booleano definido como verdadero si existen cambios sin guardar. El sistema interrogará a la función cuando el usuario intente acceder y emitirá un aviso en consecuencia. Esta función solo es necesaria si un mapa de UI utiliza Javascript personalizado para gestionar elementos de forma que el sistema no puede detectar si se han efectuado cambios. También debe tener en cuenta que será responsabilidad del Javascript de mapa de UI la gestión de los valores del booleano que se utiliza para esta función.

function hasUnsavedChanges(){
       return isDirtyFlag;
   }

Ocultación de las pestañas del portal

El producto proporciona la posibilidad de usar JavaScript para ocultar una pestaña en el portal actual en función de alguna condición mediante la API oraAuthorizeTab de JavaScript. Esta API acepta una función como un parámetro y desactiva el índice de pestaña indicado.

Por ejemplo, el mapa de UI puede tener una función para desactivar uno o varios índices de pestaña.

function overrideTabIndex(index){
    if (index == 2) return false;
    if (index == 3) return false;
  }

Se hace referencia al JavaScript durante la carga:

<body class="oraZoneMap"
onLoad="oraAuthorizeTabs(overrideTabIndex);">

Bibliotecas de JavaScript necesarias

Toda la funcionalidad descrita en este documento depende de un par de librerías de JavaScript. Si escribe y ejecuta sus mapas por completo en el marco de representación del mapa de UI, no necesita insertar de forma manual las bibliotecas siguientes, ya que el marco las insertará cuando se represente el mapa de UI.

Aviso: al ejecutar HTML fuera del marco, debe incluir de forma explícita las referencias siguientes en su HTML. Además, la herramienta que se usa para representar el HTML debe tener acceso a una copia física de privateUserMapSupport.js para soportar la unión.

src="privateUserMapSupport.js"

El documento HTML debe hacer referencia a esta biblioteca para ejecutar la unión en un entorno independiente.

Aviso: hacer referencia a las funciones en esta biblioteca de JavaScript es peligroso porque estas funciones son propiedad del marco y pueden cambiarse durante la actualización de versiones o mediante el proceso de parche normal.

<script type="text/javascript" src="privateUserMapSupport.js"></script>

src="userMapSupport.js"

Para aprovechar las funciones del juego de herramientas opcional, debe hacer referencia a esta biblioteca.

Nota: puede hacer referencia a las funciones de esta biblioteca de JavaScript para escribir funciones personalizadas en el mapa de UI.

<script type="text/javascript" src="userMapSupport.js"></script>

onload="oraInitializeUserMap();"

Para ejecutar la unión en un entorno independiente, debe embeber la siguiente función onload en el nodo <body>.

<body onload="oraInitializeUserMap();">