Está en la página 1de 54

Manual de Aplicaciones en Oracle Application Express

(APEX)
Tabla de Contenido

Crear Aplicación ................................................................................................................. 4


Seleccionar una Nueva Aplicación ..................................................................................... 5
Atributos de la Aplicación .................................................................................................. 6
Páginas de la Aplicación..................................................................................................... 7
Tipos de Pestañas ............................................................................................................... 8
Elementos Compartidos...................................................................................................... 9
Seguridad de la Aplicación ................................................................................................. 10
Tema de la Aplicación ........................................................................................................ 11
Confirmar la Creación ........................................................................................................ 12
Aplicación Creada .............................................................................................................. 13
Edición de una Página ........................................................................................................ 14
Atributos de la Página ........................................................................................................ 15
Agregar Nueva Región a la Página..................................................................................... 18
Tipo de Región ................................................................................................................... 19
Atributos de Visualización la Región ................................................................................. 20
Contenido de la Región ...................................................................................................... 21
Atributos del Reporte ......................................................................................................... 22
Condiciones de Visualización de la Región ....................................................................... 23
Creación de Botones ........................................................................................................... 24
Posición del Botón .............................................................................................................. 25
Atributos del Botón ............................................................................................................ 26
Plantilla del Botón .............................................................................................................. 27
Atributos de Visualización ................................................................................................. 28
Redireccionamiento del Botón ........................................................................................... 29
Condiciones de Visualización del Botón ............................................................................ 30
Creación de Elementos ....................................................................................................... 31
Especificación del Elemento .............................................................................................. 32
Posición y Nombre del Elemento ....................................................................................... 33
Atributos del Elemento ....................................................................................................... 34

Manual de Oracle Application Express (APEX). 2


Origen del Elemento ........................................................................................................... 35
Estado de Sesión del Elemento........................................................................................... 36
Crear Cálculo de Página ..................................................................................................... 37
Elemento a Calcular............................................................................................................ 38
Proceso de Cálculo ............................................................................................................. 39
Condiciones para el Cálculo ............................................................................................... 40
Creación de un Proceso ...................................................................................................... 41
Tipo del Proceso ................................................................................................................. 42
Atributos del Proceso ......................................................................................................... 43
Función del Proceso ........................................................................................................... 44
Mensajes del Proceso ......................................................................................................... 45
Condiciones del Proceso ..................................................................................................... 46
Creación de Validaciones ................................................................................................... 47
Elemento a Validar ............................................................................................................. 48
Método de Validación ........................................................................................................ 49
Tipo de Validación ............................................................................................................. 50
Nombre y Secuencia de la Validación ................................................................................ 51
Mensaje de la Validación ................................................................................................... 52
Condiciones de la Validación ............................................................................................. 53
Atributos de Página con Elementos Creados ...................................................................... 54

Manual de Oracle Application Express (APEX). 3


Crear Aplicación

En el menú principal (home) del Oracle Application Express (APEX) se presenta la


opción para la creación de una nueva aplicación, de la misma manera que se presenta la
opción para importar una aplicación previamente exportada. A continuación se presentan
los pasos para la creación de una nueva aplicación, así como, la creación de regiones,
botones, elementos y demás componentes que conforman comúnmente una aplicación.
En la imagen que se presenta a continuación se observa la página principal del
APEX en el que se selecciona la opción de crear una aplicación.

Manual de Oracle Application Express (APEX). 4


Seleccionar una Nueva Aplicación.

Las nuevas aplicaciones se pueden crear de tres diferentes opciones, estas son, desde
una hoja de cálculo, una aplicación de demostración o una aplicación totalmente nueva que
es el caso que se presenta a continuación. Luego de seleccionar la opción “Create
Application” (Crear Aplicación) se debe presionar el botón “Next” (Siguiente).
A continuación se presenta la pantalla en que se siguen los pasos mencionados.

Manual de Oracle Application Express (APEX). 5


Atributos de la Aplicación.

Para la nueva aplicación es necesario asignar los siguientes valores:


 Name (Nombre): es el nombre de la aplicación que se está construyendo.
 Application (Aplicación): numero de identificador de la aplicación, este número es
único entre las aplicaciones que existen ya creadas, por defecto se genera el
próximo valor de la secuencia de los números de las aplicaciones existentes, este
valor puede ser modificado en este momento por otro número que no esté asignado.
 Create Application (Crear Aplicación): se presentan dos opciones, “From Scratch”
(desde cero) y “Based on existing application desing model” (basado en un modelo
de diseño de una aplicación existente). En este caso seleccionamos la primera
opción.
 Schema (Esquema): es el esquema de la base de datos en que se creará la aplicación,
por defecto aparece el esquema del usuario con que se encuentra conectado a la
aplicación.
A continuación se visualiza la pantalla correspondiente a este paso, inmediatamente
asignado los valores a estos campos, presionar el botón “Next” (Siguiente) para ir al
siguiente paso.

Manual de Oracle Application Express (APEX). 6


Páginas de la Aplicación.

La aplicación debe contener al menos una página en un principio, a continuación se


presenta la manera en que se debe agregar una página para continuar con la creación de la
aplicación.
En este caso se presentan varios tipos de páginas como se visualiza en la imagen
mostrada a continuación. Estos tipos son: 1- Página en blanco, 2- Reporte, 3- Forma, 4-
Forma Tabular, 5- Detalle Maestro y 6- Reporte con Forma. En el caso actual seleccionar la
primera opción “Página en blanco” y presionar el botón “Add Page” (Agregar Página).
Luego de creada la aplicación se pueden agregar las páginas que se deseen, pero en
este paso es importante crear al menos una de ellas.
Para continuar, presionar el botón “Next” (Siguiente) para ir al próximo paso.

Manual de Oracle Application Express (APEX). 7


Tipos de Pestañas.

Para facilitar la navegación entre los módulos que pueda contener la aplicación, se
presenta la opción de pestañas, entre estas están:
 No Tabs (Sin Pestañas): Esta opción no crea en la aplicación el diseño de pestañas.
One Level of Tabs (Un nivel de Pestañas): Permite la creación de pestañas en un
único nivel.
 Two Levels of Tabs (Dos niveles de Pestañas): Permite la creación de pestañas en
dos niveles.
En la aplicación actual se selecciona la opción de “No Tabs” (Sin Pestañas) aunque
esto puede modificarse luego de creada la misma. Presionar el botón “Next” (Siguiente)
para continuar con el proceso.

Manual de Oracle Application Express (APEX). 8


Elementos Compartidos.

Los elementos compartidos como su nombre lo indica, son elementos que pueden
ser comunes entre aplicaciones, en este paso se presenta la opción de importar los
elementos compartidos de otras aplicaciones existentes, estos elementos pueden ser
plantillas de reportes, listas de valores, diseños entre otros, en el caso actual como se parte
de una aplicación nueva se selecciona la opción “No” para no importar ningún elemento de
otra aplicación. Presionar el botón “Next” (Siguiente) para continuar.

Manual de Oracle Application Express (APEX). 9


Seguridad de la Aplicación.
Para los esquemas de seguridad de la aplicación que se está creando, se presentan
tres opciones básicas:
 Application Express: este esquema permite ingresar a la aplicación únicamente a los
usuarios con cuentas activas dentro de la herramienta.
 No Authentication (Sin Autenticación): La aplicación a crear no posee esquemas de
seguridad, cualquier persona puede ingresar a la misma.
 Database Account (Cuenta de Base de Datos): Los usuarios que pueden ingresar a la
aplicación son aquellos que poseen una cuenta en la base de datos en donde residirá
la aplicación.
Para el caso actual se selecciona la primera opción “Application Express”.
El campo de “Language” (Lenguaje), toma por defecto el de la base de datos.
El campo de “User Application Preference Derived From” (Lenguaje de Usuario
Derivado De), seleccionar la opción de “Use Application Primary Language” (Usar el
Lenguaje Principal de la Aplicación).
Presionar el botón “Next” (Siguiente) para continuar con el proceso de creación.

Manual de Oracle Application Express (APEX). 10


Tema de la Aplicación.

En este paso se asigna a la aplicación el tema de diseño que se desea que tenga,
dicho tema puede ser modificado en cualquier momento mediante el menú “Shared
Compenents” (Componentes Compartidos) de la aplicación, en la opción de “Themes”.
En la aplicación actual se selecciona el tema 3 como predeterminado. Para continuar
presionar el botón “Next” (Siguiente).

Manual de Oracle Application Express (APEX). 11


Confirmar la Creación.

Para finalizar con la creación de la aplicación se muestra un cuadro con un pequeño


resumen de la información que se le asignó a la aplicación, de no estar satisfecho con la
misma, puede ir a los pasos anteriores presionando el botón “Previous” (Atrás) para
modificarla. También puede guardar esta configuración como un modelo predeterminado
marcando la casilla de chequeo presentada al final. Para culminar, presionar el botón
“Create” (Crear).

Manual de Oracle Application Express (APEX). 12


Aplicación Creada.

A continuación se visualiza la página principal de la aplicación creada, así mismo,


el mensaje de éxito en la creación de la aplicación, junto con el menú de opciones para el
mantenimiento y personalización de la misma, este menú está conformado por:
 Run Application (Ejecutar Aplicación).
 Supporting Object (Objetos Soportados).
 Shared Components (Componentes Compartidos).
 Export/Import (Exportar/Importar).

Manual de Oracle Application Express (APEX). 13


Edición de una Página.
Para la edición y personalización de una página, se muestra a continuación los
elementos que componen la misma, entre estos elementos están:
 Page Rendering (Atributos de Página): en los cuales se pueden modificar las
preferencias de la página.
 Regions (Regiones): pueden agregarse, eliminarse o editarse regiones como
reportes, formas, HTML entre otros.
 Buttons (botones): para agregar, eliminar o editar los botones de la página.
 Items (elementos): para agregar, eliminar o editar los elementos de la página, como
campos de texto, lista de selección, áreas de texto entre otros.
 Computations (Cálculos).
 Processes (Procesos), Validations (Validaciones), Branches (Bifurcaciones), y
demás opciones que se visualizan a continuación.

Manual de Oracle Application Express (APEX). 14


Atributos de la Página.
A continuación se presentan los atributos de la página y la función de cada uno, así
como la imagen en donde se visualizan los mismos.
 Name (Nombre): En este tópico se puede definir el nombre de la página, un alias y
el grupo al cual pertenece la misma.
 Display Attributes (Atributos de Visualización): se presentan opciones como la
platilla, las pestañas, el título entre otros.
 Header and Footer (Cabecera y Pie de Página): Se puede ingresar texto que se
visualizará en la página en las regiones mencionadas.
 HTML Header (Cabecera HTML): Código HTML que se puede ingresar para ser
visualizado en la cabecera de la página.
 HTML Body Attribute (Atributos HTML del Cuerpo de la Página): Código HTML
que se puede ingresar para ser visualizado como contenido de la página.
 Security (Seguridad): seguridad en aspectos como los esquemas autorizados para
ver la página, la autenticación y la protección de acceso.
 Duplicate (Dulicado): esta opción se maneja para cuando el usuario presiona el
botón “Atrás” en el explorador y la página realiza un submit.
 Cache: Permite activar o desactivar el almacenamiento en cache de la información
de la página, así como el tiempo de dicho almacenamiento o las condiciones del
mismo.
 Error, Help (ayuda) y Comments (Comentarios): Texto que se ingresa para cuando
se solicite el mismo, por ejemplo al momento de un error, se visualiza el texto que
se ingresa en dicho campo.
A continuación se visualiza los atributos de la página anteriormente descritos.

Manual de Oracle Application Express (APEX). 15


Manual de Oracle Application Express (APEX). 16
Manual de Oracle Application Express (APEX). 17
Agregar Nueva Región a la Página.

Una página puede poseer una variedad de regiones dependiendo del uso que se le
dará a la misma, al inicio cuando se creó la aplicación, en la página actual se creó una
región HTML, en este caso se procederá con la creación de un reporte, como se puede ver a
continuación existen regiones como formas, árboles, calendarios, ayudas entre otros, que se
pueden añadir a las paginas.
Para continuar con la creación de la región de reporte, presionar el botón “Next”
(Siguiente)

Manual de Oracle Application Express (APEX). 18


Tipo de Región.

Entre los tipos de reportes existen “SQL Report” (Reporte SQL), Interactive Report
(Reporte Interactivo), Wizard Report (Asistente para Reporte), en el caso actual se creará
un reporte sql (primera opción) para la visualización de datos existentes en una base de
datos. Luego de seleccionar esta opción, presionar el botón “Next” (Siguiente) para
continuar con el proceso de creación.

Manual de Oracle Application Express (APEX). 19


Atributos de Visualización de la Región.

Es necesario asignar a la región del reporte en creación la siguiente información


solicitada:
 Title (Título): Nombre de la región.
 Region Template (Plantilla de región): Es el formato que tomará la región en cuanto
a diseño.
 Display Point (Lugar de Visualización): Posición de la página en la que se ubicará
el reporte.
 Secuence (Secuencia): Identificador numérico que diferenciará a la región de forma
única de las demás regiones creadas.
 Column (Columna): Número de la columna en donde se ubicará el reporte.

Para continuar con la creación del reporte SQL presionar el botón “Next”
(Siguiente), a continuación se observa la pantalla en la que se solicita dicha información.

Manual de Oracle Application Express (APEX). 20


Contenido de la Región.

El contenido de la región en este caso por ser un reporte SQL es la sentencia que
consultará la base de datos para obtener la información. Para facilitar la creación de dicha
sentencia se brinda la opción del “Query Builder” (Constructor de Consultas) que facilita al
usuario el ensamblaje de la sentencia.
Para la visualización de los encabezados del reporte existen dos opciones, ya sea
derivado de la consulta “Derived from query columns” o columnas genéricas “Generic
columns”. A continuación se visualiza la pantalla en la que se debe ingresar la información
descrita anteriormente. Para continuar con la creación presionar el botón “Next”
(Siguiente).

Manual de Oracle Application Express (APEX). 21


Atributos del Reporte.

Entre los atributos para continuar con la creación del reporte se encuentran:
 Report Template (Plantilla del Reporte): Lista de selección que contiene las
diferentes plantillas predeterminadas, de haberse creado una platilla personalizada,
aparecería en esta lista.
 Break Columns (Columnas de Ruptura): Se selecciona la columna por la cual se
desea que el reporte “rompa”.
 Row per Page (Filas por Página): Número de filas que se desean visualizar por
cada página del reporte.
 Column heading Sorting (Ordenado por columna): Se selecciona “Yes” (Si) sí
desea la opción de ordenar el reporte por cada columna.
 CSV Output (Salida CSV): Para descargar el contenido del reporte en un archivo
de extensión CSV seleccionar la opción “Yes” (Si).
 Report Printing (Impresión del Reporte): Para imprimir el contenido del reporte
seleccionar la opción “Yes” (Si).

Para continuar con la creación del reporte SQL presionar el botón “Next”
(Siguiente), a continuación se observa la pantalla en la que se solicita dicha información.

Manual de Oracle Application Express (APEX). 22


Condiciones de Visualización de la Región.

Cualquier tipo de región posee condiciones de visualización, esto con el fin de


ocultar o no la región según un tipo de evento en la página. Entre estos eventos existen
“item=value” (elemento = a valor), “item not null” (elemento no nulo), “request=e1”
(solicitud = expresión 1), “page in” (página en), “page not in” (página no contenida en),
entre otras muchas más condiciones que se pueden observar al desplegar la lista en el
campo “Condition Type” (Tipo de Condición). Si no se desea un tipo de condición, se deja
la opción por defecto y la región se visualizará normalmente.
Para culminar con la creación del reporte SQL presionar el botón “Create Region”
(Crear Región), a continuación se observa la pantalla en la que se solicita dicha
información.

Manual de Oracle Application Express (APEX). 23


Creación de Botones

Para añadir botones a la página desde la pantalla de Edición de una Página (vista
anteriormente) se presiona en la opción de “Add” (Agregar), y la primera información
solicitada es la región en la cual se desea crear el botón.
A continuación se visualiza la pantalla en la que se solicita dicha información y
luego de seleccionar la región presionar el botón “Next”(Siguiente) para continuar con la
creación.

Manual de Oracle Application Express (APEX). 24


Posición del Botón.

Como cuando se creó el reporte, un botón también debe especificarse la posición en


que se ubicará el mismo, las opciones presentadas para esto son:
 Create a button in a región position (Crear un botón en una posición de la región)
 Create a button displayed among this region’s ítems (Crear un botón mostrado entre
los elementos de la región)

En el caso actual se selecciona la primera opción y se presiona el botón “Next”


(Siguiente) para continuar con la creación del botón. La pantalla donde se solicita dicha
información se visualiza a continuación.

Manual de Oracle Application Express (APEX). 25


Atributos del Botón.

Para asignar el nombre del botón y la etiqueta con que se visualizará el mismo, la
siguiente pantalla solicita dicha información en los siguientes campos:
 Button Name (Nombre del Botón): nombre con que se manejará el botón.
 Label (Etiqueta del Botón): Texto con que se visualizará el botón
 Button Type (Tipo del Botón)
o HTML Button (Botón HTML): El botón será uno HTML.
o Image (Imagen): El botón será una imagen.
o Template Driven (Controlado por Plantilla): El botón es del estilo de la
plantilla.
o Button is Reset (Botón de Reinicio): El botón reinicia la página.
 Action (Acción)
o Submit Page and Redirect to URL (aceptar la pagina y redireccionar a una
URL): se acepta la acción de la pagina y se redirecciona a una dirección
URL.
o Redirect to URL without submitting page (redireccionar a una URL sin
aceptar la página): no se acepta la acción de la pagina y se redirecciona a
una dirección URL.

Manual de Oracle Application Express (APEX). 26


Plantilla del Botón.

Como se seleccionó anteriormente que el botón será controlado por una plantilla, se
debe seleccionar a continuación de una lista la plantilla que usará dicho botón, en el caso de
haberse seleccionado una imagen en este paso se seleccionaría la imagen a cargar.
A continuación se visualiza la pantalla en que se solicita esta información, luego de
ingresarla, presionar el botón “Next” (Siguiente) para continuar con la creación del botón.

Manual de Oracle Application Express (APEX). 27


Atributos de Visualización.

Para las opciones de ubicación en la pantalla se solicita la siguiente información:


 Position (Posición): Ubicación en la región en donde se ubicará el botón.
 Sequence (Secuencia): Número del botón que lo diferenciará de los demás y lo
ubicará en la región.
 Alignment (Alineación).
 Button Attributes (Atributos del Botón).
Presionar el botón “Next” (Siguiente) para continuar con la creación del botón.

Manual de Oracle Application Express (APEX). 28


Redireccionamiento del Botón.

La acción del botón generara un Redireccionamiento a una página, ya sea la misma


u otra diferente, a continuación en el campo “Branch to Page (when button pressed)”
(Bifurcación a Página (cuando se presione el botón)) se debe ingresar la página a la cual se
digirirá la aplicación.

Manual de Oracle Application Express (APEX). 29


Condiciones de Visualización del Botón.

Cualquier tipo de botón posee condiciones de visualización, esto con el fin de


ocultar o no al mismo según un tipo de evento en la página. Entre estos eventos existen
“item=value” (elemento = a valor), “item not null” (elemento no nulo), “request=e1”
(solicitud = expresión 1), “page in” (página en), “page not in” (página no contenida en),
entre otras muchas más condiciones que se pueden observar al desplegar la lista en el
campo “Condition Type” (Tipo de Condición). Si no se desea un tipo de condición, se deja
la opción por defecto y el botón se visualizará normalmente.
Para culminar con la creación del botón presionar el botón “Create Button” (Crear
Botón), a continuación se observa la pantalla en la que se solicita dicha información.

Manual de Oracle Application Express (APEX). 30


Creación de Elementos.

Para añadir elementos a la página desde la pantalla de Edición de una Página (vista
anteriormente) se presiona en la opción de “Add” (Agregar), y la primera información
solicitada es el tipo de elemento que se desea agregar. Entre estos tipos de elementos se
encuentran: “Check Box” (Casillas de Verificación), “Date Picker” (Selector de Fecha),
“Hidden” (Oculto), “Select List” (Lista de Selección), “Text” (Texto) entre otros.
A continuación se visualiza la pantalla en la que se solicita el tipo de elemento, que
en este caso se selecciono “Text” y luego presionar el botón “Next”(Siguiente) para
continuar con la creación.

Manual de Oracle Application Express (APEX). 31


Especificación del Elemento.

Una vez seleccionado el elemento de texto, se debe especificar qué tipo de elemento
de texto se va a crear, entre las opciones presentadas están:
 Text Field (Campo de Texto): Campo de texto común.
 Text Field (Disabled, does not save state): Campo de texto que no guarda el estado
del mismo.
 Text Field (Disabled, save state): Campo de texto desactivado que guarda el estado
del mismo.
 Text Field (always submits page when enter pressed): Campo de texto que envía la
página al presionar enter en él.
 Text Field with Calculator Popup: Campo de texto con calculadora emergente.

En este caso seleccionar el campo de texto común, en el cual se puede ingresar


cualquier tipo de información.
A continuación se presenta la pantalla en la que se solicita al desarrollador
seleccionar el tipo del elemento.

Manual de Oracle Application Express (APEX). 32


Posición y Nombre del Elemento.

El siguiente paso es asignar un nombre al elemento, una secuencia para


diferenciarlo de los demás elementos y la región a la que pertenecerá el elemento, a
continuación se visualiza la pantalla en la que se solicita esta información.

Manual de Oracle Application Express (APEX). 33


Atributos del Elemento.

El siguiente paso en la creación del elemento es la asignación de atributos para la


visualización del mismo, estos atributos son:
 Label (Etiqueta): Nombre con que se mostrará el elemento.
 Label Alignment (Alineación de la Etiqueta): Posición en relación al elemento en
donde saldrá la etiqueta.
 Field Width (Ancho del campo): Número de caracteres que permitirá ingresar el
elemento.
 Field Alignment (Alineación del Campo): Posición en donde saldrá el campo en la
página.
 Label Template (Plantilla de la etiqueta): Plantilla que controlará la etiqueta del
elemento.
 Begin on New Line (Comenzar en línea nueva): si se desea que el elemento
comience en una línea nueva, seleccionar la opción “Yes” (Si).

A continuación se observa la pantalla en que son solicitados dichos valores para ser
asignados al elemento en creación

Manual de Oracle Application Express (APEX). 34


Origen del Elemento.

Para que el elemento posea un valor por defecto o un valor en caso de estar vacío se
cuenta con la opción de asignar dicho valor en el campo “Item Source Value” (Valor de
Origen del Elemento), este valor puede ser texto plano, una consulta SQL, una expresión
PL/SQL entre otros. A continuación se muestra la pantalla en que se ingresa este valor.

Manual de Oracle Application Express (APEX). 35


Estado de Sesión del Elemento.

Una vez asignado el origen del elemento, se debe especificar si el mismo se tomará
cada vez que aparezca el mismo “From source each time ítem is displayed” o cuando su
valor sea nulo “Only when the value is null (otherwise use cached value)”.
A continuación se observa la pantalla en que se ingresa esta característica del origen
del elemento, y para culminar con la creación del elemento presionar el botón “Create
Item” (Crear Elemento).

Manual de Oracle Application Express (APEX). 36


Crear Cálculo de Página.

Los cálculos de páginas cumplen la función de procesar valores y asignarlos a


elementos de la aplicación, ya sean en la página donde se crea el mismo o en otra página de
la aplicación.
El primer paso a seguir para la creación de un cálculo es definir si se va a realizar a
un elemento en la página actual “Item in This Page”, un elemento en otra página “Item on
Another Page” o un elemento a nivel de aplicación “Application Level Item”, en el caso
actual se realizará el cálculo para un elemento en la página actual (creado en los pasos
anteriores).
La pantalla en la que se solicita dicha información para el cálculo se puede observar
a continuación.

Manual de Oracle Application Express (APEX). 37


Elemento a Calcular.

Una vez seleccionada la opción del cálculo en el elemento, es necesario suministrar


la siguiente información:
 Compute Item (Elemento a calcular): En la lista de selección aparecen los elementos
existentes a los que se le pueden aplicar el cálculo en creación.
 Sequence (Secuencia): Identificador numérico que permite diferenciar los cálculos
existentes.
 Computation Point (Lugar del cálculo): momento en el cual se hace ejecutar el
cálculo.
 Computation Type (Tipo del cálculo): La lista de selección contiene los tipos de
cálculos que se pueden crear en la página.

A continuación se presenta la pantalla en la que se solicita la información


mencionada.

Manual de Oracle Application Express (APEX). 38


Proceso del Cálculo.

Una vez seleccionado el cálculo de tipo expresión PLSQL se solicita ingresar dicha
expresión en el campo “Computation” (Cálculo) como se observa a continuación. Presionar
el botón “Next” para continuar con la creación.

Manual de Oracle Application Express (APEX). 39


Condiciones para el Cálculo.

Cualquier tipo de cálculo posee condiciones de ejecución, esto con el fin de permitir
o no ejecutarse según un tipo de evento en la página. Entre estos eventos existen
“item=value” (elemento = a valor), “item not null” (elemento no nulo), “request=e1”
(solicitud = expresión 1), “page in” (página en), “page not in” (página no contenida en),
entre otras muchas más condiciones que se pueden observar al desplegar la lista en el
campo “Condition Type” (Tipo de Condición). Si no se desea un tipo de condición, se deja
la opción por defecto y el cálculo se ejecutará normalmente.
Para culminar con la creación del cálculo presionar el botón “Create” (Crear), a
continuación se observa la pantalla en la que se solicita dicha información.

Manual de Oracle Application Express (APEX). 40


Creación de un Proceso.

Los procesos son pequeños fragmentos de código que se ejecutan en una página al
ocurrir determinada situación, dichos procesos pueden comportarse como cálculos o hasta
realizar acciones en una base de datos.
Algunos de los procesos que se pueden crear son:
 PL/SQL: código PL/SQL que se ejecuta para realizar determinada acción.
 Session State (Estado de la Sesión): permite controlar la cache de la página o de la
aplicación entre otras cosas.
 Close popup Windows (Cerrar Ventana Emergente).

Estos son algunos de los procesos que se pueden crear, a continuación se visualiza
las opciones que se brindan al momento de crear un proceso, en este caso se creará un
proceso para el control de la cache de la página.

Manual de Oracle Application Express (APEX). 41


Tipo del Proceso.

Una vez seleccionado que el proceso va a ser del tipo “Session State” (Estado de la
Sesión) se debe especificar que subtipo de proceso es el que se creará, entre estas opciones
se encuentran “Clear Cache for Applications” (Limpiar Cache para Aplicaciones), “Clear
Cache for Current Applications” (Limpiar Cache para Aplicación Actual), “Clear Cache for
Items” (Limpiar Cache para Elementos), en el caso actual se usará la de tipo “Clear Cache
for all Items on Pages” (Limpiar Cache para Elementos de las Páginas) y presionar el botón
“Next” (Siguiente) para continuar con la creación, a continuación se observa la pantalla en
la que se solicita dicha información.

Manual de Oracle Application Express (APEX). 42


Atributos del Proceso.

Dentro de los atributos del proceso se encuentran:


 Name (Nombre): Nombre del proceso.
 Sequence (Secuencia): Número que identificará únicamente al proceso en la página.
 Point (Punto de Ejecución): Momento en el que se ejecutará dicho proceso.

Para continuar con la creación del proceso, presione el botón “Next” (Siguiente). A
continuación se observa la pantalla en la que se solicita la información mencionada.

Manual de Oracle Application Express (APEX). 43


Función del Proceso.

En este paso del proceso se debe especificar el número de páginas a las que se les
realizará el proceso de limpiado de cache, en el caso de ser un proceso PL/SQL se solicitará
el código del mismo. A continuación se visualiza la pantalla en la que se debe ingresar esta
información, para continuar con la creación presionar el botón “Next” (Siguiente).

Manual de Oracle Application Express (APEX). 44


Mensajes del Proceso.

Se presenta la opción de mostrar mensajes de éxito o de fallo del proceso, esta


información se debe ingresar en los campos “Success Message” (Mensaje de Éxito) y
“Failure Message” (Mensaje de Fallo) respectivamente, como se muestra a continuación.
Presionar el botón “Next” (Siguiente) para continuar con la creación del proceso.

Manual de Oracle Application Express (APEX). 45


Condiciones del Proceso

Cualquier tipo de proceso posee condiciones de ejecución, esto con el fin de


permitir o no ejecutarse según un tipo de evento en la página. Entre estos eventos existen
“item=value” (elemento = a valor), “item not null” (elemento no nulo), “request=e1”
(solicitud = expresión 1), “page in” (página en), “page not in” (página no contenida en),
entre otras muchas más condiciones que se pueden observar al desplegar la lista en el
campo “Condition Type” (Tipo de Condición). Si no se desea un tipo de condición, se deja
la opción por defecto y el proceso se ejecutará normalmente.
Para culminar con la creación del proceso presionar el botón “Create Process”
(Crear Proceso), a continuación se observa la pantalla en la que se solicita dicha
información.

Manual de Oracle Application Express (APEX). 46


Creación de Validaciones.

Existen en las páginas validaciones a nivel de un elemento o a nivel de una página


completa, esto se selecciona en los campos “Item level validation” (Validación a nivel de
elemento) o “Page level validation” (Validación a nivel de Página) respectivamente, en el
caso actual se creará una validación a nivel de elemento como se aprecia a continuación en
la imagen.

Manual de Oracle Application Express (APEX). 47


Elemento a Validar.

Como en el paso anterior se selecciono una validación a nivel de elemento, este


paso consiste en especificar en qué elemento se va a aplicar la validación, como se puede
apreciar en la imagen siguiente, el único elemento que aparece es el creado en pasos
anteriores, de existir más elementos, estos se listarían a continuación.
Para continuar, presionar el botón “Next” (Siguiente).

Manual de Oracle Application Express (APEX). 48


Método de Validación.

El próximo paso a seguir es seleccionar el método de validación a utilizar, entre


estos métodos se encuentran:
 SQL: Se usa para validar el ítem con una sentencia SQL.
 PL/SQL: Se usa para validar el ítem a través de un bloque anónimo PL/SQL.
 Item Not Null (Elemento no nulo): Valida que el elemento no se encuentre vacío.
 Item String Comparison (Comparación de palabras del elemento): Compara que el
contenido del elemento sea igual a los casos que se presentan al seleccionar esta
opción (siguiente página).
 Regular Expression (Expresión Regular).
A continuación se observan las opciones descritas anteriormente, seleccionando el
cuarto caso mencionado y presionando el botón “Next” (Siguiente) para continuar con la
validación.

Manual de Oracle Application Express (APEX). 49


Tipo de Validación.

Continuando con el método de validación se debe especificar qué tipo de


comparación se va a realizar, entre estas se encuentran “Item specified contains no spaces”
(El elemento no contiene espacios en blanco), “Item specified is numeric” (El elemento es
numérico), “Item specified is alphanumeric” (El elemento es alfanumérico) que es el caso
que se va a tomar. Presionando el botón “Next” (Siguiente) se continúa con la creación de
la validación. A continuación se presenta la pantalla donde están los métodos posibles para
crear.

Manual de Oracle Application Express (APEX). 50


Nombre y Secuencia de la Validación

Con la finalidad de diferenciar la validación de las existentes, es necesario


suministrar la siguiente información:
 Sequence (Secuencia): Número que identificará inequívocamente a la validación de
las demás existentes en la página actual.
 Validation Name (Nombre de la Validación): Nombre que se le dará a la validación
que se está creando.
 Error Display Location (Lugar de visualización del error): es en donde se mostrará
el mensaje de error cuando la validación se active.

A continuación se observan los campos en donde se debe ingresar la información


descritas anteriormente, presionando el botón “Next” (Siguiente) para continuar con la
validación.

Manual de Oracle Application Express (APEX). 51


Mensaje de la Validación.

Cuando la validación se active se mostrará un mensaje de error para que el usuario


lo observe, este mensaje se debe ingresar en el campo “Error Message” (Mensaje de Error)
como se observa en la imagen que se presenta a continuación. Para continuar una vez
ingresado el mensaje, presionar el botón “Next” (Siguiente).

Manual de Oracle Application Express (APEX). 52


Condiciones de la Validación.

Cualquier tipo de validación posee condiciones de ejecución, esto con el fin de


permitir o no ejecutarse según un tipo de evento en la página. Entre estos eventos existen
“item=value” (elemento = a valor), “item not null” (elemento no nulo), “request=e1”
(solicitud = expresión 1), “page in” (página en), “page not in” (página no contenida en),
entre otras muchas más condiciones que se pueden observar al desplegar la lista en el
campo “Condition Type” (Tipo de Condición). Si no se desea un tipo de condición, se deja
la opción por defecto y el proceso se ejecutará normalmente.
Adicionalmente, la validación se puede activar mediante la acción de un botón, este
se debe seleccionar en el campo “When Button Pressed” (Cuando se presione el botón) si
así se desea.
Para culminar con la creación de la validación presionar el botón “Create” (Crear), a
continuación se observa la pantalla en la que se solicita dicha información.

Manual de Oracle Application Express (APEX). 53


Atributos de Página con Elementos Creados.

Como se puede observar en la imagen que se presenta a continuación, la página


contiene los elementos creados en lo anteriormente descrito en este tutorial, entre los cuales
se encuentran las Regiones, Botones, Elementos, Cálculos, Procesos y Validaciones.
Si en algún momento se desea modificar alguna información o configuración de
estos, se puede accesar haciendo click en el nombre de cada uno, visualizando las
propiedades del objeto seleccionado.

Manual de Oracle Application Express (APEX). 54

También podría gustarte