Funciones y Atributos de Mapa de Interface de Usuario

Nota: En este tema, se utiliza el término "campo" para referirse tanto al concepto genérico de despliegue y captura de datos en un "campo" como al objeto de metadatos proporcionado en el producto para definir Campos. Cuando se hacer referencia al último caso, se usa el término "Campo de Metadatos" y se proporciona un hiperenlace a la documentación de Campo.

Contenido

Vinculación de XML a HTML

Creación de una Lista Desplegable

Formateo de Campos de Entrada y Salida

Despliegue de Etiquetas

Activación de Ayuda de Mapa de Interface de Usuario

Búsqueda mediante Zona de Explorador Desplegable

Despliegue de Errores

Ejecución de JavaScript para Eventos de Explorador

Ocultamiento de Elementos

Invocación de Servicios Basados en Esquema

Refrescamiento de Página de Portal o Mapa Generado

Incrustación de Navegación de Framework

Inicio de Script de Asistente de Proceso de Negocios

Cierre del Mapa de Interface de Usuario con Valores Vinculados

Inclusión de Fragmento de Mapa

Inclusión de un Componente Web

Visualización de Esquema por Defecto para Adición

Configuración de un Gráfico

Carga y Descarga de un Archivo CSV

Creación de Fragmentos de Mapa de Zona de Portal

Bibliotecas de JavaScript Requeridas

Detección de Cambios No Grabados

Ocultamiento de Separadores de Portal

Vinculación de XML a HTML

Solo se necesitan dos atributos diferentes para vincular el XML de un Mapa de Interface de Usuario con su HTML. Ambos atributos requieren un documento XML embebido en el HTML, donde los nodos <xml> vinculan el XML.

Advertencia: Debe embeber un par de etiquetas <xml></xml> en el documento HTML para que se produzca la vinculación.

Enlace de un Campo

Sintaxis Valores Descripción

oraField=" "

XPath de elemento de campo Este atributo se usa para enlazar un elemento HTML directamente con un elemento XML, donde el elemento XML se define dentro del esquema XML del Mapa de Interface de Usuario. Este atributo se puede usar con cualquier elemento HTML de presentación, como: <span>, <div> y <input>.
  • HTML para elemento de entrada:

    
    <html>
    <body>
    <table>
       <tr>
          <td>Address:</td>
          <td><input type="text" oraField="address"/></td>
       </tr>
       <tr>
          <td>City:</td>
          <td><input type="text" oraField="city"/></td>
       </tr>
       <tr>
          <td>State:</td>
          <td><input type="text" oraField="state"/></td>
       </tr>
       <tr>
          <td>Zip:</td>
          <td><input type="text" oraField="zip"/></td>
       </tr>
    </table>
    </body>
    <xml>
       <root>
          <address>123 Main St</address>
          <city>Alameda</city>
          <state>CA</state>
          <zip>94770</zip>
       </root>
    </xml>
    </html>

    HTML presentado

    HTML presentado para elementos de entrada
  • HTML para elementos span y div:

    
    <html>
    <body>
     
    <div oraField="address"></div>
    <span oraField="city"></span>
    <span>,</span>
    <span oraField="state"></span>
    <span oraField="zip"></span>
    <span oraField="country"></span>
     
    </body>
    <xml>
       <root>
          <address>123 Main St</address>
          <city>Alameda</city>
          <state>CA</state>
          <zip>94770</zip>
       </root>
    </xml>
    </html>

    HTML presentado:

    HTML presentado para elementos span

Enlace de una Lista

Este atributo se usa para enlazar una tabla HTML con una lista XML, donde la lista XML se define dentro del esquema XML del Mapa de Interface de Usuario. El propósito de este elemento es hacer que el marco replique el HTML de la tabla para cada acontecimiento de la lista.

Sintaxis Valores Descripción

oraList=" "

XPath de elemento de lista Este atributo se usa para enlazar una tabla HTML con una lista XML, donde la lista XML se define dentro del esquema XML del Mapa de Interface de Usuario. El propósito de este elemento es hacer que el marco replique el HTML de la tabla para cada acontecimiento de la lista.
Nota: Los atributos oraField embebidos en la lista deben contener la navegación de XPath relacionada con la lista. Consulte el ejemplo que aparece debajo.
<html>
<head><title>Bind xml list element</title></head>
<body>
<table oraList="payment">
   <thead>
      <tr>
         <th><span>Pay Date</span></th>
         <th><span>Amount</span></th>
        </tr>
        <tr/>
    </thead>
    <tr>
      <td>
         <span oraField="date" oraType="date"></span>
      </td>
      <td align="right">
         <span oraField="amount" oraType="money"></span>
      </td>
   </tr>
</table>
</body>
<xml>
<root>
    <payment>
        <date>2008-01-01</date>
        <amount>44.28</amount>
    </payment>
    <payment>
        <date>2008-02-01</date>
        <amount>32.87</amount>
    </payment>
    <payment>
        <date>2008-03-01</date>
        <amount>21.76</amount>
    </payment>
</root>
</xml>
</html>

HTML presentado:

HTML presentado para lista XML

Creación de una Lista Desplegable

Se proporcionan los siguientes atributos para crear un elemento "select" de HTML, también llamado lista desplegable, según diferentes orígenes.

Origen Sintaxis Valores Ejemplos
Consulta

oraSelect="lookup: ;"

Campo de consulta
...
<td>House Type:</td>
<td>
   <select oraField="houseType" 
oraSelect="lookup:HOUSE_TYPE;">
</select>
</td>
Consulta Extensible

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 tabla de control standard, en la que hay una tabla de idioma relacionada que incluye la columna DESCR como columna de descripción. Use el diccionario de datos del Visor de Aplicación para identificar tablas que califiquen para esta funcionalidad.
Advertencia: La función oraSelect solo funcionará si se despliegan menos de 500 valores.
Nombre de tabla
...
<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 select en función de la lista que está dentro del XML del mapa.

oraSelect="valuePath: ;descPath: "

Después del valuePath, indique el XPath del elemento que contiene los valores. Después del descPath, indique el XPath del elemento que contiene las descripciones.
<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 la sección que aparece a continuación para ver la sintaxis adicional necesaria para usar esta función.
Servicio de Negocio

oraSelect="bs: ;"

Código de Servicio de Negocio Consulte la sección que aparece a continuación para ver la sintaxis adicional necesaria para usar esta función.

Al especificar un script de servicio o un servicio de negocio, se necesita información adicional acerca del mapeo para transmitir los datos desde el servicio y hacia él.

Sintaxis Valores Descripción

oraSelectIn=" ;"

serviceXPath:element; Se usa para transmitir el valor de otro elemento al servicio (mapeo al XPath del servicio).
serviceXPath:'Literal'; Se usa para transmitir un valor constante o literal al servicio (mapeo al XPath del servicio).

oraSelectOut="valuePath: ; descPath: "

Consulte los ejemplos que aparecen a continuación Se usa para indicar qué elemento de la salida del servicio tiene los valores y cuál tiene las descripciones.

Ejemplo con un servicio de negocio:

...
<td>External System: </td>
<td>
   <select oraField="externalSystem" 
    oraSelect="bs:F1-RetrieveExternalSystems" 
    oraSelectIn="outboundMsgType:boGroup/parameters/outboundMsgType;" 
    oraSelectOut="valuePath:results/externalSystem; 
    descPath:results/description">
   </select>
</td>
...

Este método para crear listas desplegables, a menudo, se usa cuando existe una dependencia entre los elementos y la lista de valores válidos de una lista desplegable (para el elemento secundario) se basa en otro elemento del mapa (el elemento principal). Cuando se cambia el elemento principal, es posible que sea necesario refrescar el elemento secundario. Este comportamiento se puede implementar por medio de una función que se llama dentro de un evento onChange en el mapa. La sintaxis es oraHandleDependentElements('dependent element');. Se pueden nombrar múltiples elementos de destino (dependientes).

El siguiente ejemplo está relacionado con el ejemplo de servicio de negocio mencionado anteriormente, en el que la lista de sistemas externos es específica para un tipo de mensaje de salida determinado, que se transfiere como entrada. En el snippet que aparece debajo, se muestra la configuración del elemento de tipo de mensaje de salida para activar el refrescamiento de la lista desplegable del sistema externo.

...
<div>
   <label oraLabel="boGroup/parameters/outboundMsgType"></label>
      <span>
         <select oraSelect="table:F1_OUTMSG_TYPE"  
          oraField="boGroup/parameters/outboundMsgType"
          onChange="oraHandleDependentElements('boGroup/parameters/externalSystem');">
         </select>
      </span>
</div>
...

Formateo de Campos de Entrada y Salida

Los siguientes atributos están diseñados para aplicar el formateo de tipos de datos para campos de entrada y salida.

Formato Automático

Sintaxis
oraSchemaDataTypes="false"

Este atributo se usa para activar el formateo automático en el documento HTML presentado. El formateo automático se lleva a cabo en función de los atributos de tipo de datos definidos en el esquema del mapa de Interface de Usuario. Para obtener detalles sobre el formateo de tipos de datos específicos, consulte las descripciones de atributos oraType que aparecen a continuación.

Advertencia: El atributo oraSchemaDataTypes="true" se inyectará automáticamente en el HTML del mapa de Interface de Usuario. Si no desea aplicar los tipos de datos del esquema al HTML presentado, debe especificar este atributo en el nodo del cuerpo con el valor false. Se requiere el atributo <body oraSchemaDataTypes="false"> para evitar el formateo automático.
  • Esquema de Mapa de Interface de Usuario:

    <schema>
        <schemaDate dataType="date"/> 
        <schemaDateTime dataType="dateTime"/> 
        <schemaFKRef fkRef="CI_USER"/> 
        <schemaLookup dataType="lookup" lookup="ACCESS_MODE"/> 
        <schemaMoney dataType="money"/> 
        <schemaNumber dataType="number"/> 
        <schemaTime dataType="time"/> 
    </schema>
  • HTML de Mapa de Interface de Usuario:

    
    <html>
    <body oraSchemaDataTypes="true">
    <table border="1" cellpadding="1" cellspacing="1">
       <tr><th>dataType</th><th>result type</th><th>input result</th><th> display-only result</th></tr>
       <tr>
          <td rowspan="2">date (from schema)</td>
          <td>raw</td>
          <td><input oraField="schemaDate" oraType="string" /></td>
          <td><span oraField="schemaDate" oraType="string"></span></td>
       </tr>
       <tr>
          <td>rendered</td>
          <td><input oraField="schemaDate"></td>
          <td><span oraField="schemaDate"></span></td>
       </tr>
     
       <tr>
          <td rowspan="2">dateTime (from schema)</td>
          <td>raw</td>
          <td><input oraField="schemaDateTime" oraType="string"></td>
          <td><span oraField="schemaDateTime" oraType="string"></span></td>
       </tr>
       <tr>
          <td>rendered</td>
          <td><input oraField="schemaDateTime"></td>
          <td><span oraField="schemaDateTime"></span></td>
       </tr>
    
       <tr>
          <td rowspan="2">fkRef (from schema)**</td>
          <td>raw</td>
          <td><input oraField="schemaFkRef" oraType="string"></td>
          <td><span oraField="schemaFkRef" oraType="string"></span></td>
       </tr>
       <tr>
          <td>rendered</td>
          <td><input oraField="schemaFkRef"></td>
          <td><span oraField="schemaFkRef"></span></td>
       </tr>
     
       <tr>
          <td rowspan="2">lookup (from schema)</td>
          <td>raw</td>
          <td><input oraField="schemaLookup" oraType="string"></td>
          <td><span oraField="schemaLookup" oraType="string"></span></td>
       </tr>
       <tr>
          <td>rendered</td>
          <td><input oraField="schemaLookup"></td>
          <td><span oraField="schemaLookup"></span></td>
       </tr>
       
       <tr>
          <td rowspan="2">money (from schema)</td>
          <td>raw</td>
          <td><input oraField="schemaMoney" oraType="string"></td>
          <td><span oraField="schemaMoney" oraType="string"></span></td>
       </tr>
       <tr>
          <td>rendered</td>
          <td><input oraField="schemaMoney"></td>
          <td><span oraField="schemaMoney"></span></td>
       </tr>
     
       <tr>
          <td rowspan="2">number (from schema)</td>
          <td>raw</td>
          <td><input oraField="schemaNumber" oraType="string"/></td>
          <td><span oraField="schemaNumber" oraType="string"></span></td>
       </tr>
       <tr>
          <td>rendered</td>
          <td><input oraField="schemaNumber"></td>
          <td><span oraField="schemaNumber"></span></td>
       </tr>
     
       <tr>
          <td rowspan="2">time (from schema)</td>
          <td>raw</td>
          <td><input oraField="schemaTime" oraType="string"></span></td>
          <td><span oraField="schemaTime" oraType="string"></span></td>
       </tr>
       <tr>
          <td>rendered</td>
          <td><input oraField="schemaTime"></td>
          <td><span oraField="schemaTime"></span></td>
       </tr>
     
    </table>
     
    </body>
    <xml>
    <root>
       <schemaDate>2007-11-02</schemaDate>
       <schemaDateTime>2007-11-02-23.45.00</schemaDateTime>
       <schemaFkRef>USD</schemaFkRef>
       <schemaLookup>A</schemaLookup>
       <schemaMoney>1000000</schemaMoney>
       <schemaNumber>5661976.11548</schemaNumber>
       <schemaTime>23.45.00</schemaTime>
    </root>
    </xml>
    </html>

    HTML presentado.

    HTML presentado para oraSchemaDataTypes="yes"

Formato de Fecha

Esta función se usa para desplegar una fecha de acuerdo al perfil de despliegue del usuario. Para los campos de entrada, la configuración formatea los datos cuando el usuario presiona la tecla TAB para salir del campo.

Sintaxis
oraType="date"

<html>
<body>
<table summary="" border="0" cellpadding="1" cellspacing="1">
   <tr>
      <td>Date: </td>
      <td><span oraField="date" oraType="date"></span></td>
   </tr>
   <tr>
      <td>Date: </td>
      <td><input oraField="date" oraType="date"/></td>
   </tr>
</table>
</body>
<xml>
<root>
   <date>2008-12-28</date>
</root>
</xml>
</html>

HTML presentado.

HTML presentado para oraType="date"

Formato de Hora

Esta función se usa para desplegar una hora de acuerdo al perfil de despliegue del usuario. Para los campos de entrada, la configuración formatea los datos cuando el usuario presiona la tecla TAB para salir del campo.

Sintaxis
oraType="time"
<html>
<body>
<table summary="" border="0" cellpadding="1" cellspacing="1">
   <tr>
      <td>Time: </td>
      <td><span oraField="time" oraType="time"></span></td>
   </tr>
   <tr>
      <td>Time: </td>
      <td><input oraField="time" oraType="time"/></td>
   </tr>
</table>
</body>
<xml>
<root>
   <time>00.28.54.389</time>
</root>
</xml>
</html>

HTML presentado.

HTML presentado para oraType="time"

Formateo de Fecha y Hora

Esta función se usa para desplegar un registro de hora de acuerdo al perfil de despliegue del usuario. Si esta función se usa para un elemento de entrada, se divide en dos partes, una para la fecha y otra para la hora. De manera opcional, la parte de hora del elemento de fecha y hora se puede suprimir por medio del valor de atributo 'time:suppress'.

Sintaxis
oraType="dateTime; time:suppress"

<html>
<body>
<table summary="" border="0" cellpadding="1" cellspacing="1">
   <tr>
      <td>Date time: </td>
      <td><span oraField="dateTime" oraType="dateTime"></span></td>
   </tr>
   <tr>
      <td>Date only: </td>
      <td><span oraField="dateTime" oraType="dateTime; time:suppress"></span></td>
   </tr>
   <tr>
      <td>Date time: </td>
      <td><input oraField="dateTime" oraType="dateTime"/></td>
   </tr>
   <tr>
      <td>Date only: </td>
      <td><input oraField="dateTime" oraType="dateTime; time:suppress"/></td>
   </tr>
</table>
</body>
<xml>
<root>
   <dateTime>2009-11-01-00.28.54</dateTime>
</root>
</xml>
</html>

HTML presentado.

HTML presentado para oraType="dateTime"

Formateo de Fecha y Hora con Hora Standard

Esta función TRUE se usa para presentar un elemento de fecha/hora en función del cronograma del horario de verano de la zona horaria "base". La zona horaria "base" se especifica en la tabla Instalación y representa la zona horaria de la base de datos. Para los elementos de entrada que tienen esta configuración, se supone que todas las horas que se ingresan corresponden al cronograma de horario de verano de la zona horaria base. Si se ingresa una hora que no se puede traducir a la hora standard de manera inequívoca, se le solicita al usuario que proporcione una etiqueta de zona horaria para indicar si se ingresó la hora según el horario de verano o la hora standard.

Sintaxis
oraType="dateTime; stdTime:true;"
<html>
<body>
<table summary="" border="0" cellpadding="1" cellspacing="1">
   <tr>
      <td>Date time: </td>
      <td><span oraField="dateTime" oraType="dateTime; stdTime:true;"></span></td>
   </tr>
   <tr>
      <td>Date time: </td>
      <td><input oraField="dateTime" oraType="dateTime; stdTime:true;"/></td>
   </tr>
</table>
</body> 
<xml>
<root>
   <dateTime>2009-11-01-00.28.54</dateTime>
</root>
</xml>
</html>

HTML presentado.

Nota: Aparece la etiqueta de zona horaria porque la hora 1:28 es ambigua. Legalmente, la hora 1:28 AM del 1 de noviembre de 2009 ocurre dos veces porque el horario de verano termina a la 2:00 AM. Con la función stdTime, las etiquetas de zona horaria solo se muestran cuando es necesario aclarar la superposición de horas.
HTML presentado para oraType="dateTime; stdTime:true" durante período de superposición de horario de verano

HTML presentado para el día siguiente.

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

Formateo de Fecha y Hora con Referencia de Zona Horaria

Sintaxis Valores Válidos Descripción
oraType="dateTime; stdTimeRef: ;" Se hace referencia a un XPath después de los dos puntos. Esta función se usa para presentar un elemento de fecha/hora en función del cronograma del horario de verano de una zona horaria a cuyo XPath se hace referencia. Tenga en cuenta que se supone que la hora procesada se almacenó en la hora standard de la zona horaria a la que se hace referencia, de manera que solo se ejecuta el cambio al horario de verano, no el cambio de zona horaria.
oraType="dateTime; displayRef: ;" Se hace referencia a un XPath después de los dos puntos. Esta función es similar a la función stdTimeRef, con la excepción de que esta función ejecuta el cambio de zona horaria, además del cambio al horario de verano. Para usar la función displayRef correctamente, solo debe asociarla con los elementos de zona horaria que se almacenaron en la zona horaria base.

Para los elementos de entrada que tienen esta configuración, se asume que todas las horas que se ingresan corresponden al cronograma de horario de verano de la zona horaria a la que se hace referencia. Si se ingresa una hora que no se puede traducir a la hora standard de manera inequívoca, se le solicita al usuario que proporcione una etiqueta de zona horaria para indicar si se ingresó la hora según el horario de verano o la hora standard.

<html>
<body>
<table summary="" border="0" cellpadding="1" cellspacing="1">
   <tr>
      <td>Date time: </td>
      <td><span oraField="dateTime" oraType="dateTime; stdTimeRef:timeZone;"></span></td>
   </tr>
   <tr>
      <td>Date time: </td>
      <td><input oraField="dateTime" oraType="dateTime; stdTimeRef:timeZone;"/></td>
   </tr>
</table>
</body>
<xml>
<root>
   <timeZone>US-EAST</timeZone>
   <dateTime>2009-11-01-00.28.54</dateTime>
</root>
</xml>
</html>

HTML presentado.

Nota: Siempre aparece la etiqueta de zona horaria para una zona horaria a la que se hace referencia.
HTML presentado para oraType="dateTime; stdTimeRef:xpath" durante el período de superposición de horario de verano

HTML presentado para el día siguiente.

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

Formato de Duración

Sintaxis
oraType="duration"

Esta función se usa para desplegar la duración. Para un elemento de entrada, el valor que ingresa el usuario se pasa de minutos a horas y minutos según corresponda. Por ejemplo, un valor ingresado de "90" se convierte a "00:01:30" cuando se presiona la tecla TAB para salir del campo de entrada.

<html>
<body>
<table summary="" border="0" cellpadding="1" cellspacing="1">
   <tr>
      <td>Duration: </td>
      <td><span oraField="duration" oraType="duration"></span></td>
   </tr>
   <tr>
      <td>Duration: </td>
      <td><input oraField="duration" oraType="duration"/></td>
   </tr>
</table>
</body>
<xml>
<root>
   <duration>90</duration>
</root>
</xml>
</html>

HTML presentado.

HTML presentado para oraType="duration"

Formateo de Día del Mes

Sintaxis
oraType="dayInMonth"

Esta función se usa para desplegar el día y el mes concatenados.

<html>
<body>
<table summary="" border="0" cellpadding="1" cellspacing="1">
   <tr>
      <td>Day In Month: </td>
      <td><span oraField="dayMonth" oraType="dayInMonth"></span></td>
   </tr>
   <tr>
      <td>Day In Month: </td>
      <td><input oraField="dayMonth" oraType="dayInMonth"/></td>
   </tr>
</table>
</body>
<xml>
<root>
   <dayMonth>0228</dayMonth>
</root>
</xml>
</html>

HTML presentado.

HTML presentado para oraType="dayInMonth"

Formateo de Mes del Año

Sintaxis
oraType="monthInYear"

Esta función se usa para desplegar el mes y el año concatenados.

<html>
<body>
<table summary="" border="0" cellpadding="1" cellspacing="1">
   <tr>
      <td>Month In Year: </td>
      <td><span oraField="month" oraType="monthInYear"></span></td>
   </tr>
   <tr>
      <td>Month In Year: </td>
      <td><input oraField="month" oraType="monthInYear"/></td>
   </tr>
</table>
</body>
<xml>
<root>
   <month>200811</month>
</root>
</xml>
</html>

HTML presentado.

HTML presentado para oraType="monthInYear"

Formato Monetario

Esta función se usa para desplegar un número como importe monetario. Consulte la tabla para ver las opciones de configuración relacionadas con la divisa. Para los elementos de entrada, se emite un error si se ingresa un valor no numérico.

Sintaxis Descripción
oraType="money: " Especifique directamente un código de divisa después de los dos puntos.
oraType="money;currencyRef: " Haga referencia a un XPath (después de los dos puntos) para un elemento que hace referencia a un código de divisa.
oraType="money" Si no se especifica ninguna divisa o referencia de divisa, se usa la divisa de la instalación.
Nota: Debe especificar un par de referencias de hoja de estilo, cisEnabled y cisDisabled, en el encabezado del mapa de la alineación a la derecha. La hoja de estilo controla cómo se presenta el campo. Si desea modificar la presentació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 presentado

HTML presentado para oraType="money"

Formato de Número

Esta función se usa para desplegar un número o validar un valor de entrada. Para los elementos de entrada, el sistema devuelve un error si se ingresa un valor no numérico.

Sintaxis
oraType="number"
Nota: Debe especificar un par de referencias de hoja de estilo, cisEnabled y cisDisabled, en el encabezado del mapa de la alineación a la derecha. La hoja de estilo controla cómo se presenta el campo. Si desea modificar la presentación, debe sustituir el estilo oraNumber.
<html>
<head>
    <link rel="stylesheet" type="text/css" href="cisDisabled.css"/>
    <link rel="stylesheet" type="text/css" href="cisEnabled.css"/>
</head>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
   <tr>
      <td>Count:</td>
      <td><span oraType="number" oraField="count"></span></td>
   </tr>
   <tr>
      <td>Count, input:</td>
      <td><input oraType="number" oraField="count"/></td>
   </tr>
</table>
</body>
<xml>
<root>
   <count>989</count>
</root>
</xml>
</html>

HTML presentado.

HTML presentado para oraType="number"

Formato de Referencia de Clave Foránea

Por defecto, cuando se despliega un elemento con el valor fkRef para oraType, se activan una cadena de información, un menú contextual, la navegación y la búsqueda (si la referencia de Clave Foránea se configuró de la manera correspondiente). Se proporciona la sintaxis para que pueda desactivar cualquiera de estas funciones según lo desee.

Tenga en cuenta que también puede activar el hiperenlace de clave foránea por separado; consulte Incrustación de Navegación de Framework para obtener más información. Los diferentes atributos que se usan para controlar la funcionalidad de referencia de clave foránea son los siguientes: Tenga en cuenta que, en cada caso, el valor por defecto es true Se debe usar el valor false para desactivar la función.

Sintaxis
oraType="fkRef:true|false; info:true|false; context:true|false; navigation:true|false; search:true|false"
  • fkRef. El valor "true" activa el procesamiento de todas las siguientes referencias de clave foránea. Use el valor "false" para desactivar el procesamiento automático de Referencias de Clave Foránea.
  • info. El valor "true" presenta una cadena de información en el mapa de Interface de Usuario, si corresponde.
  • context. El valor "true" presenta un menú contextual para que aparezca antes del elemento de referencia de clave foránea, si corresponde.
  • navigation. El valor "true" hace que la cadena de información se presente como hiperenlace, si corresponde. Al hacer click en el hiperenlace, se navegahacia la página correspondiente.
  • search. El valor "true" despliega un ícono de búsqueda que inicia la zona de búsqueda, si corresponde.
Nota: Las funcionalidades de navegación de clave foránea y de menú contextual solo están disponibles para los mapas de Interface de Usuario en una zona de portal. Los mapas de Interface de Usuario presentados durante el procesamiento del script de Asistente de Proceso de Negocios no soportan opciones de navegación. La funcionalidad de búsqueda solo está disponible para elementos HTML de entrada.
  • Esquema de Mapa de Interface de Usuario:

    
    <schema>
      <bo fkRef="F1-BOMO"/>
    </schema>
  • HTML de Mapa de Interface de Usuario:

    
    <html>
    <body>
    <table summary="" border="1" cellpadding="1" cellspacing="1">
       <tr>
          <td>Business Object</td>
          <td><span oraField="bo" oraType="fkRef:true; info:true; context:true; navigation:true;"></span></td>
       </tr>
    </table>
    </body>
    <xml>
    <root>
       <bo>F1-COUNTRY</bo>
    </root>
    </xml>
    </html>
  • HTML presentado.

    HTML presentado para oraType="fkRef:true; info:true; context:true; navigation:true"

Formato de Lista de Valores

Esta función se usa para desplegar la descripción de un valor de consulta.

Sintaxis Valores Válidos
oraType="lookup: " Nombre de campo de consulta después de los dos puntos.

<html>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
   <tr>
      <td>Status:</td>
      <td><span oraField="status" oraType="lookup:BATCH_JOB_STAT_FLG"></span></td>
   </tr>
</table>
</body>
<xml>
<root>
   <status>PD</status>
</root>
</xml>
</html>

HTML presentado.

HTML para valor de consulta presentado.

Formato de Lista de Valores Ampliada

Esta función se usa para desplegar la descripción de un valor de consulta extensible.

Sintaxis Valores Válidos
oraType="lookupBO: " Nombre de código de Objeto de Negocio después de los dos puntos.

<html>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
   <tr>
      <td>Value:</td>
      <td><span oraField="status" oraType="lookupBO:F1-DeviceDisplayTypes"></span></td>
   </tr>
</table>
</body>
<xml>
<root>
    <status>oraTablet</status>
</root>
</xml>
</html>

HTML presentado.

HTML presentado para consulta extensible

Formato de Tipo de Característica

Esta función se usa para desplegar la descripción de un valor de característica predefinido.

Sintaxis Valores Válidos
oraType="charType: " Código de Tipo de Característica después de los dos puntos.

<html>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
    <tr>
        <td>Skill:</td>
        <td><span oraType="charType:CM-SKILL" oraField="skill"></span></td>
    </tr>
</table>
</body>
<xml>
<root>
    <skill>10</skill>
</root>
</xml>
</html>

HTML presentado.

HTML presentado para tipo de característica

Formato de Tabla de Control

Esta función se usa para desplegar la descripción de una tabla de control que tiene una tabla de idioma asociada.

Sintaxis Valores Válidos
oraType="table: " Código de tabla después de los dos puntos.

<html>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
   <tr>
      <td>Currency:</td>
      <td><span oraType="table:CI_CURRENCY_CD" oraField="curr"></span></td>
   </tr>
</table>
</body>
<xml>
<root>
   <curr>USD</curr>
</root>
</xml>
</html>

HTML presentado.

HTML presentado para tabla de control

Formateo de Adición/Remoción de Grilla

Sintaxis Descripción
oraType="addGridRow"

La función addGridRow se usa para crear un cuadro de diálogo de "inserción de fila" en el mapa de Interface de Usuario.

  • Aparece una imagen de "adición".

  • Al hacer click en la imagen, se inserta una nueva fila en la grilla.

  • Si la lista está vacía, por defecto, se agrega automáticamente una fila vacía a la grilla. Esto significa que el usuario siempre verá al menos una fila de grilla si se usa este atributo.

oraType="deleteGridRow"

La función deleteGridRow se usa para crear un cuadro de diálogo de "supresión de fila" en el mapa de Interface de Usuario.

  • Aparece la imagen de "supresión".

  • Al hacer click en la imagen, se remueve la fila adyacente de la grilla.

Nota: Dado que los cuadros de diálogo de adición y supresión solo son relevantes dentro de la tabla, estos atributos se deben especificar dentro de un elemento <td>.
Advertencia: Estos atributos están diseñados para funcionar con la acción de objeto de negocio de "reemplazo" en lugar de "actualización". Por lo tanto, si el mapa contiene una grilla, se debe usar la acción de objeto de negocio de "reemplazo" para actualizar el objeto de negocio. Para obtener más información, consulte Acción de Reemplazo de Objeto de Negocio.

Ejemplo:

<html>
<head>
<title>Demonstrate Grid Add and Grid Delete OraTypes</title>
    <link rel="stylesheet" type="text/css" href="cisDisabled.css"/>
    <link rel="stylesheet" type="text/css" href="cisEnabled.css"/>
</head>
<body>
<table oraList="listEntry">
   <thead>
      <tr>
         <th/>
         <th/>
         <th><span>Date</span></th>
         <th><span>Amount</span></th>
      </tr>
      <tr/>
   </thead>
   <tr>
      <td oraType="addGridRow"></td>
      <td oraType="deleteGridRow"></td>
      <td>
         <input oraField="date" oraType="date"></input>
      </td>
      <td align="right">
         <input oraField="amount" oraType="money"></input>
      </td>
   </tr>
</table>
</body>
<xml>
<root>
   <listEntry>
      <date>2008-01-01</date>
      <amount>44.28</amount>
   </listEntry>
   <listEntry>
      <date>2008-02-01</date>
      <amount>32.87</amount>
   </listEntry>
   <listEntry>
      <date>2008-03-01</date>
      <amount>21.76</amount>
   </listEntry>
</root>
</xml>
</html>

HTML presentado.

HTML presentado para adición y supresión de fila

Elementos sin Formato

Esta función se usa para desplegar el contenido de un elemento que contiene datos sin procesar como se define para el elemento de esquema que se presenta.

Sintaxis
oraType="raw"
  • Esquema de Mapa de Interface de Usuario:

    
    <schema>
        <rawStuff type="raw"/>
    </schema>
  • HTML de Mapa de Interface de Usuario:

    
    <html>
    <head>
       <link rel="stylesheet" type="text/css" href="cisDisabled.css"/>
       <link rel="stylesheet" type="text/css" href="cisEnabled.css"/>
    </head>
    <body>
    <table summary="" border="1" cellpadding="1" cellspacing="1">
       <tr>
          <td>Raw Stuff:</td>
          <td><span oraType="raw" oraField="rawStuff"></span></td>
       </tr>
    </table>
    </body>
    <xml>
    <root>
       <rawStuff>
          <ele1>text in element 1</ele1>
          <group1>
             <ele2>text inside element 2, group 1</ele2>
             <ele3>text inside element 3, group 1</ele3>
          </group1>
       </rawStuff>
    </root>
    </xml>
    </html>

    HTML presentado.

    HTML presentado para oraType="raw"

Formato de Cadena

Esta función se usa para desplegar el contenido de un elemento, como la impresión de XML con formato, cuando el elemento contiene XML con escape.

Sintaxis
oraType="xmlString"
Nota: Aunque no es necesario, se puede mejorar la visualización con formato del XML presentado si se especifica un par de referencias de hoja de estilo, cisEnabled y cisDisabled, en el encabezado 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 presentado.

HTML presentado para oraType="xmlString"

HTML presentado sin oraType=”xmlString”

HTML presentado sin oraType="xmlString"

Formato de HTML

Esta función se usa para desplegar el contenido de un elemento como HTML, en lugar de texto sin formato. Un elemento definido como oraType="fkref" se presenta automáticamente como HTML.

Sintaxis
oraType="html"
Advertencia:

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

Si se detecta HTML no soportado, se utiliza un escape para todo el elemento y se lo presenta como texto sin formato. Por lo tanto, se recomienda utilizar un escape adecuado para cualquier cadena de origen que contribuya al elemento HTML final si no se espera que contenga HTML válido. De esta manera, solo se utiliza un escape para las cadenas inválidas y no para todo el elemento.

Si el elemento HTML se compone durante el proceso de scripting, consulte la función de "escape" que se describe en Sintaxis de Edición de Datos para obtener más información. Use la API de java WebStringUtilities.asHTML para el escape de texto compuesto en Java.


<html>
<head>
   <link rel="stylesheet" type="text/css" href="cisDisabled.css"/>
   <link rel="stylesheet" type="text/css" href="cisEnabled.css"/>
</head>
<body>
<table summary="" border="0" cellpadding="1" cellspacing="1">
   <tr>
   <td>Info :</td>
   <td><span oraType="html" oraField="info"></span></td>
   </tr>
</table>
</body>
<xml>
<root>
   <info><b>text in bold</b></info>
</root>
</xml>
</html>

HTML presentado.

HTML presentado para oraType="html"

HTML presentado sin oraType="html"

HTML presentado sin oraType="html"

Despliegue de Etiquetas

Derivación de Etiqueta desde un Elemento

Este atributo se usa para obtener una etiqueta sensible al idioma para un elemento HTML <span>, <td> o <input>.

Sintaxis Valores Válidos
oraLabel=" " XPath de un elemento en el esquema del mapa de Interface de Usuario. El elemento debe hacer referencia al atributo mapField=, mdField= o label=.
Nota: También puede definir un campo directamente en el HTML para la definición de etiqueta; consulte Derivación de Etiqueta desde un Campo para obtener más información.
Nota: Si el esquema contiene múltiples atributos, el atributo oraLabel elegirá la etiqueta para presentar en función de la siguiente jerarquía: El atributo de etiqueta sustituye el atributo mdField, que a su vez sustituirá el atributo mapField.
  • Esquema de Mapa de Interface de Usuario:

    <schema>
       <user mapField="USER_ID"/> 
       <info type="group" mapXML="CLOB">
          <city label="Metro Area"/> 
          <age mdField="AGE_LBL"/>
       </info> 
    </schema>
  • HTML:

    <html>
    <head><title oraMdLabel="BUS_LBL"></title></head>
    <body>
    <table>
       <tr>
          <td oraLabel="user"></td>
          <td><input oraField="user"/></td>
       </tr>
       <tr>
          <td oraLabel="info/city"></td>
          <td><input oraField="info/city"/></td>
       </tr>
       <tr>
          <td oraLabel="info/age"></td>
          <td><input oraField="info/age"/></td>
       </tr>
       <tr>
          <td/>
          <td><input type="button" oraMdLabel="ACCEPT_LBL"/></td>
       </tr>
    </table>
    </body>
    <xml>
    <root>
       <user>RWINSTON</user>
       <info>
          <city>Alameda</city>
          <age>32</age>
       </info>
    </root>
    </xml>
    </html>

    HTML presentado:

    HTML presentado para oraLabel

Derivación de Etiqueta desde un Campo

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

Sintaxis Valores Válidos
oraMdLabel=" " Código de Campo de Metadatos.
Nota: También puede definir etiquetas derivadas de la definición de esquema del mapa; consulte Derivación de Etiqueta desde 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 presentado:

Activación de Ayuda de Mapa de Interface de Usuario

En la sección Despliegue de Etiquetas, se describen las maneras de derivar la etiqueta para un elemento por medio de un Campo de Metadatos subyacente. Además, si el mismo campo de Metadatos contiene texto de ayuda, el sistema genera automáticamente una ayuda adyacente a la etiqueta de elemento. Al hacer click en la ayuda, el usuario puede ver el texto de ayuda.

Es posible cambiar la presentación de la ayuda. Consulte Opciones de Presentación Personalizada para obtener más información.

Búsqueda mediante Zona de Explorador Desplegable

Opción de Búsqueda

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

Sintaxis Valores Válidos
oraSearch=" " Código de zona.
Note: El atributo oraSearch es similar al atributo oraType porque se incluye "automáticamente" en el HTML por medio del atributo oraSchemaDataTypes. Esto significa que la codificación del atributo oraSearch en el HTML del Mapa de Interface de Usuario solo se requiere si no se especificó una zona de búsqueda en el esquema o en la referencia de Clave Foránea del elemento de esquema.
  • Ejemplo de definición de la búsqueda en el HTML. Esquema del Mapa de Interface de Usuario:

    <schema>
       <uiMap/> 
    </schema>

    HTML del Mapa de Interface de Usuario

    <html>
    <body>
    <table summary="" border="1" cellpadding="1" cellspacing="1">
       <tr>
          <td>UI Map with Search </td>
          <td><input oraField="uiMap" oraSearch="F1-UISRCH"></td>
       </tr>
    </table>
    </body>
    <xml>
    <root>
       <uiMap/>
    </root>
    </xml>
    </html>
  • Ejemplo de definición de la búsqueda en el esquema. Esquema del Mapa de Interface de Usuario:

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

    HTML del Mapa de Interface de Usuario

    <html>
    <body>
    <table summary="" border="1" cellpadding="1" cellspacing="1">
       <tr>
          <td>UI Map with Search </td>
          <td><input oraField="uiMap"></td>
       </tr>
    </table>
    </body>
    <xml>
    <root>
       <uiMap/>
    </root>
    </xml>
    </html>
  • Ejemplo en el que la referencia de Clave Foránea define la zona de búsqueda. Esquema del Mapa de Interface de Usuario:

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

    HTML del Mapa de Interface de Usuario

    <html>
    <body>
    <table summary="" border="1" cellpadding="1" cellspacing="1">
       <tr>
          <td>UI Map with Search </td>
          <td><input oraField="uiMap"></td>
       </tr>
    </table>
    </body>
    <xml>
    <root>
       <uiMap/>
    </root>
    </xml>
    </html>

En todos los casos, el HTML presentado es el mismo.

HTML presentado para búsqueda

Inicialización de Campos de Búsqueda

Este atributo opcional se usa para inicializar los filtros de la zona de búsqueda. Se pueden inicializar múltiples filtros. Este atributo solo se puede usar en conjunto con el atributo oraSearch.

Sintaxis Valores Válidos Opciones de Valores de Campo Comentarios
oraSearchField=" "

Uno o más pares de nombre de campo y valor de campo separados por dos puntos. Cada par está separado por un punto y coma.

oraSearchField="fieldName:fieldValue: ..."

El nombre de campo se usa para identificar el filtro de zona que se debe inicializar cuando se inicia la búsqueda. El nombre de campo debe asociarse con el mnemotécnico searchField especificado en un parámetro de filtro de usuario o filtro oculto de la zona de búsqueda.

Ningún valor Si no especifica un valor de campo, se usa el valor del elemento de entrada que contiene el atributo oraSearchField.
XPath Indique el XPath al elemento de esquema que contiene el valor que se debe usar.
'literal' Indica el valor literal que se debe proporcionar.
Nota: Si no especifica un atributo oraSearchField y el elemento de esquema tiene un atributo fkRef con búsqueda activada especificado, el marco crea automáticamente un atributo oraSearchField donde el nombre de campo es igual a los campos de la clave de la referencia de Clave Foránea (Metadatos).
Advertencia: La zona de explorador desplegable se puede invocar de una de las siguientes maneras: Haciendo click en el botón de búsqueda o presionando la tecla Intro desde el campo ubicado a la izquierda del botón. Si hace click en el botón, no se transmitirá ninguna información de campo de búsqueda a la zona. La información de campo de búsqueda solo se usa para inicializar valores de filtro de zona cuando se presiona 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>

Mapeo de Campos de Búsqueda Devueltos

Este atributo opcional se usa para dirigir los valores devueltos por la zona de búsqueda. Se pueden especificar múltiples campos. Este atributo solo se puede usar en conjunto con el atributo oraSearch.

Sintaxis Valores Válidos Opciones de Valores de Campo Comentarios
oraSearchOut=" "

Uno o más pares de nombre de campo y valor de campo separados por dos puntos. Cada par está separado por un punto y coma.

oraSearchOut="field name:xpath target; ..."

El nombre de campo se usa para identificar el resultado de búsqueda devuelto desde la zona de consulta. El nombre de campo debe asociarse con el mnemotécnico ELEMENT_​NAME definido en el parámetro de resultados de búsqueda de la zona de explorador.

Ningún valor Si no especifica un valor de campo, el elemento de entrada que contiene el atributo oraSearchField recibe el valor devuelto.
XPath Indique el XPath al elemento de esquema que debe recibir el valor devuelto.
Nota: Si no especifica un atributo oraSearchOut, el marco creará un valor por defecto en el que el nombre de campo será igual al nombre de 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>

Despliegue de Errores

Despliegue de Variables de Error

Se puede desplegar una de las siguientes variables de error.

Sintaxis
oraErrorVar="ERRMSG-TEXT"
oraErrorVar="ERRMSG-LONG"
oraErrorVar="ERRMSG-CATEGORY"
oraErrorVar="ERRMSG-NUMBER"
...
<table width="100%" cellpadding="12">
   <tr class="oraErrorText">
      <td>
         <a href="" onclick="oraShowErrorAlert(); return false;">
            <span  class="oraErrorText" oraErrorVar="ERRMSG-TEXT"></span>
         </a>
      </td>
   </tr>
</table>
...

HTML presentado

HTML presentado para oraErrorVar

Realce de un Campo con Error

Nota: Para obtener más información sobre como arrojar un error, consulte Sentencia de Finalización en Sintaxis de Edición de Datos.
Sintaxis Comentarios
oraError="automate:true|false; prefix: " Al especificar automate:true, se activa automáticamente el realzado del elemento con error cuando se emite un error. Tenga en cuenta que true es el valor por defecto y no es necesario especificarlo. Especifique automate:false para desactivar el realzado de campos.
El sistema usa una asociación del nombre de elemento al que se hace referencia en el error con los nombres de elementos del mapa de Interface de Usuario. Si los elementos del esquema están dentro de un XPath que puede no estar asociado a lo que hace referencia el error, indíquelo usando prefix:XPath.
Nota: Se debe especificar un par de referencias de hoja de estilo, cisEnabled y cisDisabled, para la referencia del estilo oraError. La hoja de estilo controla cómo se presenta el campo con error. Si desea modificar la presentación, debe sustituir el estilo oraError.

En el siguiente ejemplo de HTML, se muestra que los elementos del mapa se definen dentro de un grupo llamado boGroup. El nombre de elemento que devuelve el error no incluye este grupo, de manera que para que el realzado de campos funcione correctamente, el atributo prefix: debe indicar el nombre de grupo.

<html>
<head>
   <title>User Zone Input</title>
   <link rel="stylesheet" type="text/css" href="cisDisabled.css"/>
   <link rel="stylesheet" type="text/css" href="cisEnabled.css"/>
</head>
<body oraError="automate:true; prefix:boGroup">
<table width="100%" cellpadding="12">
   <tr class="oraErrorText">
      <td>
         <a href="" onclick="oraShowErrorAlert(); return false;">
            <span  class="oraErrorText" oraErrorVar="ERRMSG-TEXT"></span>
         </a>
      </td>
   </tr>
</table>
<table width="100%" border="0" cellpadding="4">
   <tr style="padding-top:30px;">
      <td align="right" class="label">User Id</td>
      <td>
         <span oraField="boGroup/userId" class="normal"/>
      </td>
   </tr>
   <tr>
      <td align="right" class="label">First Name</td>
      <td>
         <input oraField="boGroup/firstName" class="normal"/>
      </td>
   </tr>
   <tr>
      <td align="right" class="label">Last Name</td>
      <td>
         <input oraField="boGroup/lastName" class="normal"/>
      </td>
   </tr>
</table>
</body>
<xml>
<root>
   <boGroup>
      <userId>BOND007</userId>
      <firstName>James</firstName>
      <lastName></lastName>
   </boGroup>
</root>
</xml>
</html>

HTML presentado, donde el elemento de error arrojado es igual a "lastName":

oraErrorElement presentado automáticamente usando oraError en la etiqueta de cuerpo

Sustitución de Nombre de Elemento de Error

En el extraño caso de que el nombre de elemento que devuelve el error no se asocie con el nombre de elemento del mapa, puede agregar un atributo explícito para indicar el nombre de elemento de error.

Sintaxis Valores Válidos Comentarios
oraErrorElement= "nombre de elemento" El nombre de elemento al que se hace referencia aquí debe asociarse exactamente con el nombre del elemento de error asignado cuando se arrojó el error. El mismo nombre de elemento de error puede hacer referencia a más de un campo HTML.
Nota: Se debe especificar un par de referencias de hoja de estilo, cisEnabled y cisDisabled, para la referencia del estilo oraError. La hoja de estilo controla cómo se presenta el campo con error. Si desea modificar la presentación, debe sustituir el estilo oraError.

Aquí se ilustra un escenario donde el nombre de elemento asociado con el error difiere del nombre de elemento del mapa.

<html>
<head>
   <title>User Zone Input</title>
   <link rel="stylesheet" type="text/css" href="cisDisabled.css"/>
   <link rel="stylesheet" type="text/css" href="cisEnabled.css"/>
</head>
<body>
<table width="100%" cellpadding="12">
   <tr class="oraErrorText">
      <td>
         <a href="" onclick="oraShowErrorAlert(); return false;">
            <span  class="oraErrorText" oraErrorVar="ERRMSG-TEXT"></span>
         </a>
      </td>
   </tr>
</table>
<table width="100%" border="0" cellpadding="4">
   <tr style="padding-top:30px;">
      <td align="right" class="label">User Id</td>
      <td>
         <span oraField="userId" class="normal"/>
      </td>
   </tr>
   <tr>
      <td align="right" class="label">First Name</td>
      <td>
         <input oraField="firstName" class="normal" oraErrorElement="firstName"/>
      </td>
   </tr>
   <tr>
      <td align="right" class="label">Last Name</td>
      <td>
         <input oraField="familyName" class="normal"  oraErrorElement="lastName"/>
      </td>
   </tr>
</table>
</body>
<xml>
<root>
   <userId>BOND007</userId>
   <firstName>James</firstName>
   <familyName></familyName>
</root>
</xml>
</html>

HTML presentado.

HTML presentado para oraErrorElement

Despliegue de Cuadro de Diálogo de Error

Cuando se despliega el texto de error, esta función se puede usar para desplegar el cuadro de diálogo de error standard (que despliega más información) cuando un usuario hace click en el mensaje de error.

Sintaxis
oraShowErrorAlert(); return false;
<html>
<head>
   <link rel="stylesheet" type="text/css" href="cisDisabled.css"/>
   <link rel="stylesheet" type="text/css" href="cisEnabled.css"/>
</head>
<body>
<table width="100%" cellpadding="12">
   <tr class="oraErrorText">
      <td>
         <a href="" onclick="oraShowErrorAlert(); return false;">
            <span  class="oraErrorText" oraErrorVar="ERRMSG-TEXT"></span>
         </a>
      </td>
   </tr>
</table>
<table>
   <tr>
      <td >Address:</td>
      <td><input type="text" oraField="address"/></td>
   </tr>
   <tr>
      <td>City:</td>
      <td><input type="text" oraField="city"/></td>
   </tr>
   <tr>
      <td>State:</td>
      <td><input type="text" oraField="state"/></td>
   </tr>
   <tr>
      <td>Zip:</td>
      <td><input type="text" oraField="zip"/></td>
   </tr>
   <tr>
      <td/>
      <td style="padding-top=15px;">
         <oraInclude map="F1-SaveCancelButtons"/>
      </td>
   </tr>
</table>
</body>
<xml>
<root>
   <address>123 Main St</address>
   <city>Alameda</city>
   <state>CA</state>
   <zip>94770</zip>
</root>
</xml>
</html>

HTML presentado.

HTML presentado mediante oraErrorVar

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

Ventana de detalles iniciada mediante la función oraShowAlert

Ejecución de JavaScript para Eventos de Explorador

Trabajo con Framework de JavaScript

Existen varios eventos de JavaScript que se pueden usar en el entorno HTML/JavaScript. Estos incluyen eventos como onLoad, onBlur, onChange, etc. El Marco de Mapa de Interface de Usuario también utiliza algunos de estos eventos. Es importante que cualquier Mapa de Interface de Usuario que se desarrolle funcione con el marco para poder obtener resultados consistentes (es posible que los eventos no siempre se ejecuten en el mismo orden).

Advertencia:

A continuación, se describe el enfoque recomendado para manejar la carga y el procesamiento de las actualizaciones de campos en los Mapas de Interface de Usuario.

Si se requiere JavaScript en un fragmento o Mapa de Interface de Usuario de XHTML, es necesario enlazarlo a una etiqueta ![CDATA[ ]] para garantizar que el documento XML sea válido. Tenga en cuenta que es posible que las etiquetas se deban convertir en comentarios para favorecer la compatibilidad con browsers antiguos. Por ejemplo:


<script type="text/javascript">
/* <![CDATA[ */

//
// javascript
//

/* ]]> */

</script>

Evento de Cambio de Elemento

Sintaxis Valores Válidos
oraChange=" " Una función de JavaScript.

En el momento de la carga del Mapa de Interface de Usuario, si ya hay un identificador de evento anexado al elemento HTML, el marco lo remueve y anexa un identificador de evento combinado. El identificador combinado llama a cualquier identificador del marco en primer lugar y, luego, llama a otros identificadores (personalizados).

Advertencia: Tenga en cuenta que la función no se debe usar para ejecutar una lógica que modifique el valor de datos de campo asociado nuevamente; de lo contrario, se producirá un bucle infinito.

En el siguiente ejemplo, la función oraInvokeBS se ejecuta cuando se hace click en el botón.

<html>
  <head>
    <title>oraInvokeBS test</title>
  </head>
  <body>
    <table>
      <tr>
        <td>User Id:</td>
        <td>
          <input oraField= "xmlGroup/userId"/>
          <input type="button" value="Search" oraChange="oraInvokeBS('UserSearch','xmlGroup');"/>
        </td>
      </tr>
      <tr>
        <td/>
        <td>Search Results</td>
      </tr>
      <tr>
        <td/>
        <td>
          <table oraList="xmlGroup/searchList">
            <tr>
              <td><span oraField="userId"></span>
              </td>
            </tr>
          </table>
        </td>
      </tr>
    </table>
  </body>
  <xml>
    <root>
      <xmlGroup>
        <userId/>
        <searchList>
            <userId></userId>
        </searchList>
      </xmlGroup>
    </root>
  </xml>
</html>

Evento de Carga de Página

Sintaxis Valores Válidos
oraLoad=" " Una función de JavaScript.
Advertencia: Si se ejecuta oraLoad en un fragmento de mapa de Interface de Usuario y se necesita ejecutar una función de JavaScript durante la carga de página (cuando la función invoca un objeto de negocio, un servicio de negocio o un script de servicio), puede usar la sintaxis especial "oraLoad[$SEQUENCEID]". Para conocer otras sintaxis especiales usadas para los fragmentos de mapa, consulte la sección Creación de un Encabezado de Zona de Portal.
  • En el siguiente ejemplo, se ejecuta la función oraDisplayNone durante la carga de página:

    <html>
    <body>
    <table summary="" border="1" cellpadding="1" cellspacing="1">
        <tr>
            <td oraLoad="oraDisplayNone(item,'userId','')">User Id: </td>
            <td><span oraField="userId"></span></td>
        </tr>
    </table>
    </body>
    <xml>
    <root>
        <userId>SPLAXT</userId>
    </root>
    </xml>
    </html>
  • HTML presentado

    oraLoad rendered

Después del Evento de Carga de Página

Sintaxis Valores Válidos
oraAfterLoad="" Una función de JavaScript.

En el siguiente ejemplo, se ejecuta la función oraGetValueFromScript después de la carga de página:

<div>
  <label for="boGroup_parameters_externalSystem" oraLabel="boGroup/parameters/externalSystem">
  </label>
    <span>
      <select oraSelect="bs:F1-RetrieveExternalSystems" class="oraInput" 
        id="boGroup_parameters_externalSystem" oraField="boGroup/parameters/externalSystem" 
        oraSelectOut="valuePath:results/externalSystem; descPath:results/description" 
        oraSelectIn="outboundMsgType:boGroup/parameters/outboundMsgType" 
        oraAfterLoad
        ="oraGetValueFromScript(document.getElementById('boGroup_parameters_externalSystem');">
      </select>
    </span>

</div>

Ocultamiento de Elementos

Ocultamiento mediante una Función

El sistema proporciona múltiples técnicas para ocultar un elemento HTML.

Sintaxis Valores Válidos Comentarios
oraDisplayNone(item ); (item, 'XPath', 'value', 'operator') Se usa para ocultar un elemento en función del valor de otro elemento (al que se hace referencia por medio de su XPath). Ingrese un valor de ' ' para consultar un valor en blanco. Por defecto, el operador es '='. En su lugar, se puede definir con otro operador, como '!=', '>' o '<'.
(item, function name,true | false) Se usa para indicar una función de JavaScript, la cual debe devolver un valor buleano.
oraIsSuppress="true" Utilice esta opción para los campos que siempre deben permanecer ocultos y no dependen de otra cosa. Defina este atributo en el elemento HTML (elemento div).
  • Ejemplo en el que la etiqueta de ID de Usuario está oculta cuando no existe un valor de ID de Usuario.

    <html>
    <body>
    <table summary="" border="1" cellpadding="1" cellspacing="1">
        <tr>
            <td oraLoad="oraDisplayNone(item,'userId','')">User Id: </td>
            <td><span oraField="userId"></span></td>
        </tr>
    </table>
    </body>
    <xml>
    <root>
        <userId></userId>
    </root>
    </xml>
    </html>
  • Ejemplo en el que el botón Grabar está oculto cuando el usuario no tiene acceso de seguridad a la acción de cambio ("C") para el servicio de aplicación 'F1-DFLTS'.

    <html>
    <body>
    <table summary="" border="1" cellpadding="1" cellspacing="1">
        <tr>
       <td oraLoad="oraDisplayNone(item, oraHasSecurity('F1-DFLTS', 'C'), false );">
          <input name="Save" type="button" onclick="oraInvokeBO('CM-IndividualTaxpayer', null, 'replace')"/>
       </td>
        </tr>
    </table>
    </body>
    <xml>
    <root>
        <userId></userId>
    </root>
    </xml>
    </html>

Control de Acceso de Seguridad de Usuario

El sistema proporciona dos funciones para controlar el acceso de seguridad de un usuario para un servicio de aplicación y un modo de acceso determinados. Por lo general, se usan para ocultar elementos.

Sintaxis Parámetros
oraHasSecurity( ) 'Código de Servicio de Aplicación'
'Modo de Acceso'
oraHasSecurityPath('x','y') 'XPath de Servicio de Aplicación'
'XPath de Modo de Acceso'

Consulte la sección anterior para ver un ejemplo de la función oraHasSecurity. A continuación, se muestra un ejemplo donde el botón de estado está oculto cuando el usuario no tiene acceso de seguridad para acceder al modo "ACT" del servicio de aplicación 'FORMTST'.

<html>
<body>
<table>
    <tr>
   <td oraLoad="oraDisplayNone(item, oraHasSecurityPath('appService', 'accessMode'), false );">
      <input oraField="statusLabel" type="button" onclick="oraRunScript('UpdateState','status');"/>
   </td>
    </tr>
</table>
</body>
<xml>
<root>
    <status>ACTIVATE</status>
<statusLabel>Activate</statusLabel>
<appService>FORMTST</appService>
    <accessMode>ACT</accessMode>
</root>
</xml>
</html>

Invocación de Servicios Basados en Esquema

El sistema proporciona funciones para invocar un objeto de negocio, un servicio de negocio o un script de servicio.

Invocación de Función de Objeto de Negocio

Esta función se usa para realizar una interacción de Objeto de Negocio directamente desde el HTML del mapa de Interface de Usuario. Devuelve un valor "true" o "false" según si la invocación encuentra un error o no.

Sintaxis Parámetros Comentarios
oraInvokeBO( ) 'Nombre de Objeto de Negocio'
"XPath" o null Identifica un elemento de grupo por medio del XPath. Si especifica la palabra null, se transmite todo el objeto XML embebido.
'acción' Indica la acción que se debe usar. Los valores válidos son add, delete, read, update, replace, fastAdd y fastUpdate.
Acceso Rápido: Consulte Acciones de Objeto de Negocio para obtener más información acerca de las diversas acciones de Objeto de Negocio.

Ejemplo de la sentencia invocada en una función de JavaScript.

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

Ejemplo de la sentencia invocada dentro de onClick.

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

Invocación de Función de Servicio de Negocio

Esta función se usa para realizar una interacción de servicio de negocio directamente desde el HTML del mapa de Interface de Usuario. Devuelve un valor "true" o "false" según si la invocación encuentra un error o no.

Sintaxis Parámetros Comentarios
oraInvokeBS( ) 'Nombre de Servicio de Negocio'
"XPath" o null Identifica un elemento de grupo por medio del XPath. Si especifica la palabra null, se transmite todo el objeto XML embebido.

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

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

Ejemplo de la sentencia invocada por medio de onClick.

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

Invocación de Función de Script de Servicio

Esta función se usa para realizar una interacción de script de servicio directamente desde el HTML del mapa de Interface de Usuario. Devuelve un valor "true" o "false" según si la invocación encuentra un error o no.

Sintaxis Parámetros Comentarios
oraInvokeSS( ) 'Nombre de Script de Servicio'
"XPath" o null Identifica un elemento de grupo por medio del XPath. Si especifica la palabra null, se transmite el documento que pertenece al nodo principal. Si el nodo principal no es suficiente, siempre se puede transmitir todo el documento por medio de la siguiente sintaxis:
oraInvokeSS('service script', 
null, null, [$SEQUENCEID])

Ejemplo de la sentencia invocada en una función de JavaScript:


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

Ejemplo de la sentencia invocada dentro de onClick.

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

Refrescamiento de Página de Portal o Mapa Generado

Refrescamiento de Mapa

Esta función se usa para "Refrescar" solo la zona de mapa que ejecuta el comando.

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

Refrescamiento de Página

Esta función se usa para refrescar todas las zonas del portal.

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

Incrustación de Navegación de Framework

Navegación mediante la Opción de Navegación

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

Sintaxis Parámetros
oraNavigate( ); 'Código de Opción de Navegación'
'XPath de Clave'
Advertencia: Esta función está destinada solo al mapa de Interface de Usuario definido en una zona de portal. No se debe usar en un mapa de Interface de Usuario iniciado por un script de Asistente de Proceso de Negocios.

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 Interface de Usuario debe contener un atributo fkRef. Para obtener más información, consulte Formateo de Referencia de Clave Foránea.

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

HTML presentado para oraNavigate

Inicio de Script de Asistente de Proceso de Negocios

Inicio de Script de Asistente de Proceso de Negocios

Sintaxis Parámetros Comentarios
oraRunScript( ); 'Código de script de Asistente de Proceso de Negocios'.
'Elemento de XPath' Se pueden transmitir uno o más valores de elemento al Asistente de Proceso de Negocios, donde se puede hacer referencia a ellos como variables temporales.
Advertencia: Esta función solo es aplicable a los mapas de Interface de Usuario desplegados en las zonas de portal. Los mapas de Interface de Usuario iniciados dentro de un script de Asistente de Proceso de Negocios en ejecución no pueden iniciar directamente otro script de Asistente de Proceso de Negocios desde le HTML del mapa de Interface de Usuario. En su lugar, devuelva un valor desde el mapa de Interface de Usuario y ejecute un tipo de paso Realizar Script o Trasferir Control.
Nota: Corresponde al autor del script extraer información del almacenamiento temporario en los pasos iniciales del script.

En el siguiente ejemplo, se crea una variable temporaria llamada "personId" con el valor "1234567890" y se inicia el script de Asistente de Proceso de Negocios llamado 'Edit Address'.

<html>
<body>
<table>
   <tr>
      <td>
         <div oraField="address"></div>
         <span oraField="city"></span>
         <span>,</span>
         <span oraField="state"></span>
         <span oraField="zip"></span>
         <span oraField="country"></span>
         <a href="" onClick="oraRunScript('Edit Address','personId');">edit</a>
      </td>
   </tr>
</table>
</body>
<xml>
<root>
   <personId>1234567890</personId>
   <address>123 Main St</address>
   <city>Alameda</city>
   <state>CA</state>
   <zip>94770</zip>
</root>
</xml>
</html>

HTML presentado.

HTML presentado para enlace de Script de Asistente de Proceso de Negocios

Inicio de Script de Asistente de Proceso de Negocios con Valores

Esta función se usa para iniciar un Asistente de Proceso de Negocios y proporciona pares de nombre/valor para transferir al almacenamiento temporario. Se pueden transmitir múltiples valores. Luego, el Script de Asistente de Proceso de Negocios puede hacer referencia a las variables temporarias por nombre.

Sintaxis Parámetros Comentarios
oraRunScriptWithValues( ); 'Código de script de Asistente de Proceso de Negocios'.
'Nombre de Elemento XPath':valor Uno o más pares de nombres y valores de elemento.
Nota: Debe usar esta función de JavaScript, en lugar de oraRunScript, si necesita transferir al script de Asistente de Proceso de Negocios valores que no estén ubicados en la estructura XML del Mapa de Interface de Usuario.

En el ejemplo que aparece debajo, una función de JavaScript llamada 'editUser()' es responsable de iniciar el script de Asistente de Proceso de Negocios llamado 'UserEdit'. Se crea la variable temporaria llamada 'userId' con el valor 'CMURRAY'.

<html>
<head>
<script type="text/javascript">
 
function editUser() {
    var values = {'userId': 'CMURRAY'};
    oraRunScriptWithValues('UserEdit', values);
    return;
}
 
</script>
</head>
<body>
...
</body>
</html>

Cierre del Mapa de Interface de Usuario con Valores Vinculados

Esta función se usa para salir de un Mapa de Interface de Usuario. Cuando sale del mapa, puede especificar un valor para devolver al script y, además, si se debe devolver un XML actualizado.

Sintaxis Parámetros Comentarios
oraSubmitMap( ); 'Valor de Devolución'
Valor buleano Indica si se debe devolver el XML actualizado. El valor por defecto es true.

En el siguiente ejemplo, el botón Grabar devolverá información actualizada; el botón Anular no lo hará.

<html>
<body>
<table>
   <tr>
      <td/>
      <td style="padding-bottom:15px;">
         <a href="" onclick="oraShowErrorAlert(); return false;">
         <span oraErrorVar="ERRMSG-TEXT"></span></a>
      </td>
   </tr>
   <tr>
      <td >Address:</td>
      <td><input type="text" oraField="address"/></td>
   </tr>
   <tr>
      <td>City:</td>
      <td><input type="text" oraField="city"/></td>
   </tr>
   <tr>
      <td>State:</td>
      <td><input type="text" oraField="state"/></td>
   </tr>
   <tr>
      <td>Zip:</td>
      <td><input type="text" oraField="zip"/></td>
   </tr>
   <tr>
      <td/>
      <td style="padding-top=15px;">
         <input type="button" value="Save" onClick="oraSubmitMap('SAVE');"/>
         <input type="button" value="Cancel" onClick="oraSubmitMap('CANCEL',false);"/>
      </td>
   </tr>
</table>
</body>
<xml>
<root>
   <address>123 Main St</address>
   <city>Alameda</city>
   <state>CA</state>
   <zip>94770</zip>
</root>
</xml>
</html>

Botones Grabar y Anular presentados:

HTML presentado mediante oraSubmitMap

Inclusión de Fragmento de Mapa

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

Sintaxis Parámetros Comentarios
<oraInclude map=' ' prefixPath=' '/> map='UI Map Code'
prefixPath='Xpath' De manera opcional, especifique un prefijo de XPath para anexar a cada valor de atributo oraField, oraLabel, oraList, oraSelect valuePath y descPath, oraDownloadData y oraUploadData incluido que se define en el HTML del fragmento de mapa de Interface de Usuario.
Nota: Esta funcionalidad solo se aplica a los valores de atributo de XPath si esos valores no aparecen debajo de un atributo oraList. Cualquier valor de XPath dentro de una tabla que contenga un atributo oraList no se verá afectado por un prefixPath.
  • Un ejemplo de un fragmento de mapa con dos botones, llamados 'F1-SaveCancelButtons'.

    <input onClick ="oraSubmitMap('SAVE');" oraMdLabel="SAVE_BTN_LBL" class="oraButton" 
    type="button"/>
    <input onClick ="oraSubmitMap('CANCEL',false);" oraMdLabel="CANCEL_LBL" class="oraButton" 
    type="button"/>
  • Un ejemplo de un mapa que incluye el fragmento de mapa llamado 'F1-SaveCancelButtons'.

    ...
    <tr>
       <td colspan="2" align="center">
    <oraInclude map="F1-SaveCancelButtons"/>
       </td>
    </tr>
    ...

Inclusión de un Componente Web

Un componente web es un elemento HTML personalizado que genera una función de interface de usuario específica. Cada componente web soportado generalmente tiene uno o más atributos HTML definidos que afectan el funcionamiento y la apariencia del componente web. Los componentes web más complejos pueden tener un correspondiente objeto de configuración del sistema que define el comportamiento y la información desplegada por el elemento de interface de usuario resultante. Por ejemplo, el componente web que produce un "árbol" de información tiene una tabla de configuración de Árbol, que define los detalles acerca de cómo recuperar información para el árbol y cómo desplegar cada nodo.

Atributos Comunes

Algunos atributos comunes que se pueden usar para cada componente web son:

  • Una referencia a la instancia específica del objeto de configuración que rige los detalles que se generarán.

  • La capacidad de transmitir datos de contexto como pares de nombre y valor.

  • Un "modo" que soporta el despliegue de una presentación preliminar de la función

Algunos atributos soportan la referencia a un único valor. Para este tipo de atributos, el valor se puede proporcionar mediante una de las siguientes referencias:
  • Valor literal. Se puede hacer referencia al valor directamente. Ejemplo:

    treename="F1-Tree"
  • Referencia de XPath. Las referencias de XPath deben utilizar la sintaxis explícita x[valor]. Ejemplo:

    treename="x[migrationTree]"
  • Referencia de contexto Global o de Portal. Estas referencias deben utilizar la sintaxis explícita c[valor].

    treename="c[TREE_NAME]"
  • Referencia de etiqueta de campo. Estas referencias deben utilizar la sintaxis explícita md[valor] .

    text=md[F1_ADD_LBL]"
  • Referencia de texto de ayuda de campo. Estas referencias deben utilizar la sintaxis explícita mdh[valor] .

    text=mdh[F1_OPERATIONS_LBL]"

Para los atributos complejos que soportan uno o más pares de nombre/valor, la sintaxis para definir los nombres y valores sigue las mismas reglas anteriores para valores literales, referencias de XPath y contexto. Se deben utilizar dos puntos (":") para separar el nombre del valor, y punto y coma (";") para separar cada par.

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

Un componente web determinado puede tener atributos HTML adicionales específicos de su funcionalidad.

Nota: Cualquier mapa de Interface de Usuario que defina un componente web debe incluir el fragmento de mapa F1-OJETLIBSR dentro de la etiqueta "body".
<body>
<oraInclude map="F1-OJETLIBSR"/>
..
</body>
Nota: También se pueden proporcionar atributos HTML standard (por ejemplo, ID=".." y style=".."). Estos se definen como normales. Cabe señalar que los componentes web pueden controlar algunos aspectos de estilo directamente y, por lo tanto, sustituir cualquier configuración de estilo proporcionada en el componente web HTML. Por ejemplo, la configuración de la Información Detallada Contextual ofrece opciones de color de texto que sustituirán cualquier color definido en el HTML.

En las siguientes secciones, se describe cada componente web soportado.

Árboles

Consulte Árboles para obtener más información sobre la configuración de árboles.

Sintaxis Parámetros Comentarios
<ou-tree...></ou-tree> treename="singleValue" Debe especificar una referencia al nombre del objeto de árbol que define la configuración del árbol que se desplegará. Este atributo espera un único valor que siga la sintaxis descrita en la sección de valor único anterior.
context="..." De manera opcional, transmita uno o más pares de nombre/valor. La sintaxis sigue el ejemplo que se muestra en la información anterior sobre atributos complejos.

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

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

Información Detallada Contextual

Consulte Información Detallada Contextual para obtener información sobre la configuración relacionada con la definición de información detallada contextual.

Sintaxis Parámetros Comentarios
<ou-insights ...></ou-insights> insightType="singleValue" Utilice este atributo para especificar el tipo de información detallada que se desplegará. Se debe especificar este atributo o el atributo de clase de información detallada. Este atributo espera un único valor que siga la sintaxis descrita en la sección de valor único anterior.
insightClass="singleValue" Utilice una clase de información detallada para desplegar todos los tipos de información detallada del grupo relacionado con esta clase. Este atributo espera un único valor que siga la sintaxis descrita en la sección de valor único anterior.
context="..." De manera opcional, transmita uno o más pares de nombre/valor. La sintaxis sigue el ejemplo que se muestra en la información anterior sobre atributos complejos.
mode="preview" Como opción, transmita un modo preview para indicar al algoritmo de información detallada subyacente que prepara los datos que se está llamando a la información en modo de presentación preliminar, sin ningún contexto disponible. Lo ideal es que el algoritmo devuelva información de muestra.
class=" " De manera opcional, proporcione una clase auxiliar CSS para controlar aspectos de la información detallada representada. Valores soportados:

class="card-full-width": Se aplica a la información detallada de tarjetas. Utilice esta clase de opción para garantizar que el ancho de la información detallada de una tarjeta se ajuste al ancho de la zona que la contiene. Si en la información detallada de tarjeta no se define este parámetro, se usa un ancho fijo.

A continuación, se presenta un ejemplo de mapa de presentación preliminar de información detallada donde el tipo de información detallada es el que está en contexto. No se necesitan datos de contexto y el modo es "preview".

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

En el siguiente ejemplo, se utiliza una clase de información detallada y se transmiten valores de contexto desde elementos XPath con nombres de contexto definidos explícitamente.

<ou-insights insightClass="C1CI" context="PER_ID:x[personId];ACCT_ID:x[accountId];PREM_ID:x[premiseId];"></ou-insights>

Botón

El componente web de botón soporta el juego standard de formatos de botón utilizados dentro del sistema.

Sintaxis Parámetros Comentarios
<ou-button...></ou-button> type=”singleValue” Debe definir el tipo de botón que se desplegará. Este atributo espera un único valor que siga la sintaxis descrita en la sección de valor único anterior. Los tipos de valores válidos son:
  • image: solo imagen

  • text: solo texto

  • imageText: imagen seguida de texto

  • menu: texto más signo de intercalación hacia abajo para abrir el menú

  • imageMenu: imagen más signo de intercalación hacia abajo para abrir el menú

Si no se proporciona ningún atributo de tipo, se desplegará una imagen de "botón roto".

img=”singleValue” Defina la ruta de acceso a la imagen que se desplegará. Se debe proporcionar este atributo o el atributo de referencia de imagen para un tipo de botón que incluya una imagen. Este atributo espera un único valor que siga la sintaxis descrita en la sección de valor único anterior.

Tenga en cuenta que, para las imágenes SVG, si la referencia incluye solo el nombre del archivo SVG sin ninguna ruta de acceso, se asume que la ruta de acceso es el repositorio SVG de Framework.

imgRef=”singleValue” Defina la referencia de ícono de despliegue de la imagen que se utilizará. Se debe proporcionar este atributo o el atributo de imagen para un tipo de botón que incluya una imagen. Este atributo espera un único valor que siga la sintaxis descrita en la sección de valor único anterior.
text="..." Defina los distintos elementos de texto que necesita el botón. La sintaxis sigue el ejemplo que se muestra en la información anterior sobre atributos complejos. Los valores válidos de nombre de elemento de texto son:
  • label: el texto de la etiqueta que se utilizará para el botón

  • tooltip: la ayuda contextual que se utilizará para el botón

  • aria-label : la etiqueta ARIA para el botón

menu=”singleValue” Defina el menú que se utilizará con el botón. Este atributo debe proporcionarse para un tipo de botón que incluya un control de menú. Este atributo espera un único valor que siga la sintaxis descrita en la sección de valor único anterior.
disabled=”singleValue” Este es un atributo HTML standard. El valor "true" o simplemente la presencia del texto "disabled" indicará un botón que está inicialmente desactivado.
security="..." De manera opcional, defina la configuración de seguridad para el botón. El botón estará oculto si el usuario no tiene el acceso de seguridad adecuado. La sintaxis sigue el ejemplo que se muestra en la información anterior sobre atributos complejos. Los valores válidos de nombre de elemento de seguridad son:
  • service: el servicio de aplicación cuyo acceso de seguridad rige el acceso al botón

  • accessMode: el modo de acceso específico para el servicio que determina un nivel de acceso más detallado al botón

clickAction="..." De manera opcional, defina la acción que se realizará cuando se haga click en el botón. La sintaxis sigue el ejemplo que se muestra en la información anterior sobre atributos complejos. Hay valores de "nombre" específicos para el atributo, como se indica a continuación:
  • action: la acción que se realizará. Los valores válidos son "BPA" y "NAVIGATE"

  • script: el script que se ejecutará cuando la acción sea "BPA"

  • navopt: la opción de navegación que se utilizará cuando la acción sea "NAVIGATE"

El atributo también puede incluir otros pares de nombre/valor que definen la información que se transmitirá al script o que se utilizará como campos de contexto de navegación.

Además de la configuración de atributos de seguridad, el sistema controlará si el usuario tiene acceso al script o a la ruta de navegación antes de realizar la acción.

Se puede utilizar el atributo HTML standard "onClick". Si el HTML incluye un atributo "onClick" además de "clickAction", el atributo "onClick" tendrá prioridad.

El siguiente es un ejemplo de un botón simple con texto.

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

El siguiente es un ejemplo de un botón de ícono que utiliza una referencia de ícono de despliegue.

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

El siguiente es un ejemplo de un botón de menú de imagen.

<ou-button type="imageMenu" imgRef="F1STTGS" menu="CI_CONTEXTSCRIPT" text="tooltip:md[F1INSTY_VIS_LBL];></ou-button>

El siguiente es un ejemplo de un botón de texto que permite navegar a otra página.

<ou-button type="text" text="label:md[ALG_CD];tooltip:md[GOTO_ALG]" clickAction="action:NAVIGATE; navopt:f1algqTabMenu; ALG_CD:x[algorithm];></ou-button>

Visualización de Esquema por Defecto para Adición

Los valores por defecto del esquema del mapa de Interface de Usuario se desplegarán en los campos de entrada del mapa de Interface de Usuario si un nodo <action> embebido tiene un valor "ADD" o en blanco.

Sintaxis
<action>ADD</action>
<action> </action>

Se despliega el esquema por defecto para el elemento <description>:

<schema>
    <action/>
    <boGroup type="group">
        <key/>
        <description default="enter description here"/>
    </boGroup>
</schema>
<html>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
    <tr>
        <td>Description   </td>
        <td><input oraField="boGroup/description"></td>
    </tr>
</table>
</body>
<xml>
<root>
    <action>ADD</action>
    <boGroup>
        <key/>
        <description/>
    </boGroup>
</root>
</xml>
</html>

HTML presentado.

HTML presentado con valor por defecto

Configuración de un Gráfico

Además de integrar gráficos con zonas, el sistema soporta el uso de los mismos atributos dentro del HTML de Mapa de Interface de Usuario para configurar una representación gráfica de una lista XML. El diseñador puede controlar el tipo, el tamaño, la posición y el contenido del gráfico mediante estos atributos. Para obtener detalles sobre los atributos y la sintaxis, consulte Configuración de Gráficos del Explorador de Datos.

Ejemplos de Gráficos

  • Muestra de una configuración de gráfico tipo torta:

    <html>
    <head>
    <title>Pie Chart</title>
    </head>
    <body>
     
    <div style="width:100%; height:290px;"
        oraChart="type:pie;"
        oraChartSeries1="list:set; labelPath:date; amount:amount; "
        oraChartBroadcast="BILL_ID:billId;">
    </div>
     
    </body>
     
    <xml>
    <root>
      <set>
    <date>05-02-2003</date>
    <amount>163.24</amount>
    <billId>592211649441</billId>
      </set>
      <set>
    <date>06-02-2003</date>
    <amount>97.29</amount>
    <billId>592211649442</billId>
      </set>
      <set>
    <date>07-02-2003</date>
    <amount>54.38</amount>
    <billId>592211649443</billId>
      </set>
    </root>
    </xml>
    </html>
  • Un gráfico tipo torta presentado para una única serie:

    oraChart="type:pie;" presentado
  • Muestra de una configuración de gráfico de líneas, de columnas o apilado, cada uno con dos series:

    <html>
    <head>
    <title>Stacked Chart</title>
    </head>
    <body>
     
    <div style="width:100%; height=300px;"
        oraChart="type:line;"
    oraChartSeries1="list:set; xaxis:date; label:Charge; amount:amount; "
    oraChartSeries2="list:set; xaxis:date; label:Balance; amount:balance; "
        oraChartBroadcast="BILL_ID:billId;">
    </div>
     
    <div style="width:100%; height=300px;"
    oraChart="type:cluster;"
    oraChartSeries1="list:set; xaxis:date; label:Charge; amount:amount; "
    oraChartSeries2="list:set; xaxis:date; label:Balance; amount:balance; "
    oraChartBroadcast="BILL_ID:billId;">
    </div>
     
    <div style="width:100%; height=300px;"
    oraChart="type:stacked;"
    oraChartSeries1="list:set; xaxis:date; label:Charge; amount:amount; "
    oraChartSeries2="list:set; xaxis:date; label:Balance; amount:balance; "
    oraChartBroadcast="BILL_ID:billId;">
    </div>
     
    </body>
     
    <xml>
    <root>
      <set>
    <date>05-02-2003</date>
    <amount>163.24</amount>
    <balance>163.24</balance>
    <billId>592211649441</billId>
      </set>
      <set>
    <date>06-02-2003</date>
    <amount>97.29</amount>
    <balance>260.53</balance>
    <billId>592211649442</billId>
      </set>
      <set>
    <date>07-02-2003</date>
    <amount>54.38</amount>
    <balance>314.91</balance>
    <billId>592211649443</billId>
      </set>
    </root>
    </xml>
    </html>
  • Tres tipos de gráficos presentados para dos series cada uno: de líneas, de columnas y apilado.

    oraChart="type:line; type:cluster; type:stacked; " presentado

Carga y Descarga de un Archivo CSV

Los siguientes atributos HTML se pueden usar para administrar tanto la carga como la descarga entre una lista definida dentro del esquema del mapa y un archivo CSV (valores separados por comas). Tenga en cuenta que esta técnica solo se recomienda para un volumen de datos pequeño a mediano, por ejemplo, no más de varios cientos de filas. Para volúmenes mayores, se recomienda usar la funcionalidad de carga/descarga en lote.

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

La carga de la configuración requiere que se indique un archivo CSV a cargar y una lista XML como destino. Por convención, cada fila de CSV crea una instancia de lista separada. Cada campo separado por comas del archivo se carga como un elemento separado en la lista. Para embeber un cuadro de dialogo de carga en un mapa, se debe asociar el atributo oraUploadData con un elemento contenedor, como div, td o span.

El valor opcional useLabels:true indica que, mientras se analiza el archivo CSV de carga, se espera que los encabezados sean etiquetas.

Nota: Si no especifica el valor useLabels:true y el nombre del elemento XML de destino es "camelCase", el encabezado de la hoja de cálculo correspondiente debe tener formato de título, con un espacio entre las palabras, por ejemplo, "Camel Case". Las letras y los caracteres especiales no se consideran una palabra distinta, por ejemplo, Address1 se debe cargar en el elemento XML de destino address1.

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

PRECAUCIÓN: Si utiliza una grilla junto con la función oraUploadData, debe mantener la lista de la grilla con la acción de objeto de negocio "replace". Para obtener más información, consulte Acción de Reemplazo de Objeto de Negocio.

Muestra de oraUploadData="embed" en un elemento div.

<html>
<head>
    <title>File Upload</title>
</head>
<body>
   
    <div oraUploadData="type:embed;path:myList"> </div>
 
</body>
 
<xml>
<root>
    <myList>
<id>838383930</id>
        <name>Janice Smith</name>
    </myList>
    <myList>
<id>737773730</id>
        <name>Bill McCollum</name>
    </myList>
</root>
</xml>
</html>

Este cuadro de diálogo de carga de archivos se embeberá en el cuerpo de la página donde se definió oraUploadData.

Cuadro de Diálogo de Carga de Archivo Embebido

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

La carga de la configuración requiere que se indique un archivo CSV a cargar y una lista XML como destino. Por convención, cada fila de CSV crea una instancia de lista separada. Cada campo separado por comas del archivo se carga como un elemento separado en la lista. Para cargar un archivo CSV por medio de un cuadro de diálogo desplegable, el atributo oraUploadData debe estar asociado con un elemento de entrada, como un botón, un enlace de texto o una imagen.

El valor opcional useLabels:true se usa para indicar que, mientras se analiza el archivo CSV de carga, se espera que los encabezados sean etiquetas.

Nota: Si no especifica el valor useLabels:true y el nombre del elemento XML de destino es "camelCase", el encabezado de la hoja de cálculo correspondiente debe tener formato de título, con un espacio entre las palabras, por ejemplo, "Camel Case". Las letras y los caracteres especiales no se consideran una palabra distinta, por ejemplo, Address1 se debe cargar en el elemento XML de destino address1.

Si se especifica el valor opcional showOk:true, se desplegará el botón "Ok" una vez que finalice la carga. El cuadro de diálogo desplegable permanecerá abierto hasta que se presione el botón. Además, si se especifica el valor showCount:true, se desplegará el número de registros cargados.

PRECAUCIÓN: Si utiliza una grilla junto con la función oraUploadData, debe mantener la lista de la grilla con la acción de objeto de negocio "replace". Para obtener más información, consulte Acción de Reemplazo de Objeto de Negocio.

Ejemplo de oraUploadData="popup" asociado con un botón:

<html>
<head>
    <title>File Upload</title>
</head>
<body>
   <input type="button" name="submitButton" oraUploadData="type:popup;path:myList;" value='Get Data'>
   <table oraList="myList">
      <tr/>
      <tr>
         <td><span oraField="id"/></td>
         <td><span oraField="name"/></td>
      </tr>
   </table>
</body>
<xml>
<root>
   <myList>
      <id>838383930</id>
      <name>Janice Smith</name>
   </myList>
   <myList>
      <id>737773730</id>
      <name>Bill McCollum</name>
   </myList>
</root>
</xml>
</html>

HTML Presentado:

Atributo oraUploadData anexado al botón Get Data

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

Cuadro de Diálogo Desplegable de Carga de Archivos

oraDownloadData="list xpath"

La configuración de descarga requiere que especifique una lista XML a descargar. Por convención, cada instancia de lista representará una fila separada en el archivo creado. Por defecto, cada elemento de la lista estará separado por una coma en el archivo.

Nota: El formateo de número se basa en la configuración del perfil de usuario. Para las configuraciones regionales en las que el símbolo decimal es una coma, una implementación puede definir una configuración de propiedades (spl.csv.delimiter.useFromDisplayProfile=true) para hacer que el sistema use un punto y coma como delimitador para separar 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 Presentado:

atributo oraDownloadData anexado al botón Download

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

Cuadro de diálogo Desplegable de Descarga de Archivos

Una descarga exitosa dará como resultado un archivo CSV:

Archivo CSV creado

Para descargar datos desde una lista secundaria, use el atributo oraDownloadDataInList en lugar de oraDownloadData. El atributo oraDownloadDataInList tendrá el nombre de la lista secundaria. El XPath de la lista secundaria se usa para seleccionar datos de una fila específica de la lista principal. Por lo tanto, solo se descarga la lista secundaria específica.

oraDownloadDataUseLabels="true"

El atributo oraDownloadDataUseLabels se puede usar en conjunto con el atributo oraDownloadData descrito anteriormente. Especifique oraDownloadDataUseLabels si desea que el archivo CSV generado use las etiquetas de elemento para los encabezados de columna en lugar de los nombres de elemento.

Creación de Fragmentos de Mapa de Zona de Portal

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

Variable Lógica de Reemplazo
[$ZONEDESCRIPTION] Texto de descripción de la zona.
[$SEQUENCEID] ID de secuencia de la zona
[$ZONENAME] Nombre de la zona.
[$HELPTEXT] Texto de ayuda de la zona.
[$ZONEPARAMNAME] Valor del parámetro de zona (o en blanco si no se especificó).
Advertencia:
  • Consulte uno de los siguientes mapas como ejemplo: F1-UIMapHeader y F1-ExplorerHeader.

  • Estos mapas usan la etiqueta oraInclude para incorporar fragmentos HTML para las acciones del marco y el menú de encabezado. Consulte los parámetros de tipo de zona para conocer los fragmentos de Mapa de Interface de Usuario que debe incluir en el HTML.

  • Si desea que el ícono "texto de ayuda" aparezca junto a la descripción de la zona, debe tener id="title_​[$SEQUENCEID] en el elemento <td> que contiene la descripción.

  • Si se debe encapsular JavaScript en un fragmento de Mapa de Interface de Usuario, será necesario vincular el JavaScript dentro de una etiqueta ![CDATA[ ]] para garantizar que el documento XML sea válido. Tenga en cuenta que es posible que las etiquetas se deban convertir en comentarios para favorecer la compatibilidad con browsers antiguos. Por ejemplo:

    <script type="text/javascript">
    
    /*<![CDATA[ */
    
    //
    //javascript
    //
    /*]]> */
    </script>
Nota: Si desea mantener los valores de un campo de entrada de filtro dentro de un fragmento de mapa de filtro para la funcionalidad "Volver" y "Avanzar" del marco, debe asociar el campo de entrada (casillero de texto, selección, etc.) con una ID de HTML única. Los valores de campo de entrada asociados con una ID única se capturarán en el "memento" del marco. El "memento" se usa para volver a crear el mapa de entrada cuando se navega a la zona de portal mediante la funcionalidad "Volver" o "Avanzar".
Nota: existen muchas funciones especializadas para manipular el comportamiento de la zona, por ejemplo:
  • oraGetZoneSequence(zoneName). Usa el código de la zona para recuperar el número de secuencia.

  • oraIsZoneCollapsed(sequenceId). Usa la secuencia de la zona para determinar si está cerrada.

  • oraHandleCollapse(seq). Cierra una zona.

  • oraHandleExpand(seq,refresh). Expande y/o refresca una zona.

Todas estas funciones, y muchas otras, se ubican en la biblioteca de JavaScript userMapSupport.js que se describe a continuación.
Nota: Si se ejecuta oraLoad en un fragmento de mapa de Interface de Usuario y se necesita ejecutar una función de JavaScript durante la carga de página (cuando la función invoca 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 de Carga de Página para obtener más información.

Ejemplo de oraLoad[$SEQUENCEID] usado en una función:

<script type="text/javascript">
function oraLoad[$SEQUENCEID]() {
checkRebateClaimStatus();
}
 
function checkRebateClaimStatus() {
    var work = id(''analyticsFilterText[$SEQUENCEID]'',
document).cells[0].innerText.split('' '');
    var rebateClaimId = work[work.length - 3];
    id(''rebateClaimId'', document).value = rebateClaimId;
oraInvokeSS(''C1-CheckRCSt'',''checkRebateClaimStatus'', false);
    var statusIndicator = id(''statusInd'', document).value;
    if (statusIndicator == ''C1PE'' || statusIndicator == ''C1ID'') {
       id(''addRebateClaimLine'', document).style.display = '''';
    } else {
id(''addRebateClaimLine'', document).style.display = ''none'';
    }
}
</script>

F1-ExplorerHeader presentado:

F1-ExplorerHeader presentado

Invocación de un Objeto de Negocio

La función oraInvokeBO se puede usar dentro de un encabezado de zona de portal o de un mapa de filtro de zona. Es similar al comando que se describe en Invocación de Función de Objeto de Negocio que permite que un objeto de negocio se invoque dentro del HTML del mapa de Interface de Usuario. Consulte esa sección para obtener una descripción de los primeros tres parámetros.

Sintaxis Parámetros Comentarios
oraInvokeBO( ) 'Nombre de Objeto de Negocio'
"XPath" o null
'acción'
null Se debe especificar como el cuarto argumento.
[$SEQUENCEID] Se debe especificar como el quinto argumento.
true | false Especifique true si el fragmento se usa dentro de un encabezado de zona de portal. Especifique false si el fragmento se usa con un mapa de filtro de portal.

Ejemplo en un encabezado de zona de portal:

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

Invocación de un Servicio de Negocio

La función oraInvokeBS se puede usar dentro de un encabezado de zona de portal o de un mapa de filtro de zona. Es similar al comando que se describe en Invocación de Función de Servicio de Negocio que permite que un servicio de negocio se invoque dentro del HTML del mapa de Interface de Usuario. Consulte esa sección para obtener una descripción de los primeros dos parámetros.

Sintaxis Parámetros Comentarios
oraInvokeBS( ) 'Nombre de Objeto de Negocio'
"XPath" o null
null Se debe especificar como el cuarto argumento.
[$SEQUENCEID] Se debe especificar como el quinto argumento.
true | false Especifique true si el fragmento se usa dentro de un encabezado de zona de portal. Especifique false si el fragmento se usa con un mapa de filtro de portal.

Ejemplo en un encabezado de zona de portal:

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

Invocación de un Script de Servicio

La función oraInvokeSS se puede usar dentro de un encabezado de zona de portal o de un mapa de filtro de zona. Es similar al comando que se describe en Invocación de Función de Script de Servicio que permite que un script de servicio se invoque dentro del HTML del mapa de Interface de Usuario. Consulte esa sección para obtener una descripción de los primeros dos parámetros.

Sintaxis Parámetros Comentarios
oraInvokeSS( ) 'Nombre de Script de Servicio'
"XPath" o null
null Se debe especificar como el cuarto argumento.
[$SEQUENCEID] Se debe especificar como el quinto argumento.
true | false Especifique true si el fragmento se usa dentro de un encabezado de zona de portal. Especifique false si el fragmento se usa con un mapa de filtro de portal.

Ejemplo en un encabezado de zona de portal:

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

Detección de Cambios No Grabados

Use esta función para devolver un valor booleano a verdadero si hay cambios no grabados. El sistema interrogará la función cuando el usuario intente navegar y emitirá una advertencia en consecuencia. Esta función solo es necesaria si un mapa de interface de usuario utiliza un javascript personalizado para administrar elementos de forma que el sistema no pueda detectar si se han realizado cambios. Además, tenga en cuenta que es responsabilidad del javascript del mapa de la interface de usuario administrar los valores en el booleano utilizado para esta función.

function hasUnsavedChanges(){
       return isDirtyFlag;
   }

Ocultamiento de Separadores de Portal

El producto proporciona la capacidad de usar JavaScript para ocultar un separador en el portal actual de acuerdo con una condición por medio de la API de JavaScript oraAuthorizeTab. Esta API acepta una función como parámetro y desactiva el índice de separador indicado.

Por ejemplo, el Mapa de Interface de Usuario puede tener una función para desactivar uno o más índices de separador:

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

Se hace referencia a JavaScript en el momento de carga:

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

Bibliotecas de JavaScript Necesarias

Todas las funcionalidades que se describen en este documento dependen de un par de bibliotecas de JavaScript. Si escribe y ejecuta los mapas por completo dentro del marco que presenta el mapa de Interface de Usuario, no necesita insertar manualmente las siguientes bibliotecas, ya que el marco las insertará cuando se presente el Mapa de Interface de Usuario.

Advertencia: Cuando ejecute HTML fuera del marco, debe incluir las siguientes referencias explícitamente dentro del HTML. Además, la herramienta que use para presentar el HTML debe tener acceso a una copia física de privateUserMapSupport.js para el soporte de la vinculación.

src="privateUserMapSupport.js"

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

Advertencia: Hacer referencia a funciones dentro de esta biblioteca de JavaScript es peligroso, porque estas funciones son propiedad del marco y pueden cambiar durante una actualización de versión o mediante el proceso de aplicación de parches normal.
<script type="text/javascript" src="privateUserMapSupport.js"></script>

src="userMapSupport.js"

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

Nota: Puede hacer referencia a las funciones dentro de esta biblioteca de JavaScript para escribir funciones personalizadas dentro del mapa de Interface de Usuario.
<script type="text/javascript" src="userMapSupport.js"></script>

onload="oraInitializeUserMap();"

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

<body onload="oraInitializeUserMap();">