• Author / Uploaded
• mcbernalj

• Categories
• SQL
• HTML
• Pl / Sql
• Cálculo
• Oracle Corporation

Citation preview

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, 4Forma 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