Manual de Aplicaciones en Oracle Application Express (APEX)

Tabla de Contenido

Crear Aplicacin ................................................................................................................. 4 Seleccionar una Nueva Aplicacin ..................................................................................... 5 Atributos de la Aplicacin .................................................................................................. 6 Pginas de la Aplicacin..................................................................................................... 7 Tipos de Pestaas ............................................................................................................... 8 Elementos Compartidos...................................................................................................... 9 Seguridad de la Aplicacin ................................................................................................. 10 Tema de la Aplicacin ........................................................................................................ 11 Confirmar la Creacin ........................................................................................................ 12 Aplicacin Creada .............................................................................................................. 13 Edicin de una Pgina ........................................................................................................ 14 Atributos de la Pgina ........................................................................................................ 15 Agregar Nueva Regin a la Pgina..................................................................................... 18 Tipo de Regin ................................................................................................................... 19 Atributos de Visualizacin la Regin ................................................................................. 20 Contenido de la Regin ...................................................................................................... 21 Atributos del Reporte ......................................................................................................... 22 Condiciones de Visualizacin de la Regin ....................................................................... 23 Creacin de Botones ........................................................................................................... 24 Posicin del Botn .............................................................................................................. 25 Atributos del Botn ............................................................................................................ 26 Plantilla del Botn .............................................................................................................. 27 Atributos de Visualizacin ................................................................................................. 28 Redireccionamiento del Botn ........................................................................................... 29 Condiciones de Visualizacin del Botn ............................................................................ 30 Creacin de Elementos ....................................................................................................... 31 Especificacin del Elemento .............................................................................................. 32 Posicin y Nombre del Elemento ....................................................................................... 33 Atributos del Elemento ....................................................................................................... 34
Manual de Oracle Application Express (APEX).

Origen del Elemento ........................................................................................................... 35 Estado de Sesin del Elemento........................................................................................... 36 Crear Clculo de Pgina ..................................................................................................... 37 Elemento a Calcular............................................................................................................ 38 Proceso de Clculo ............................................................................................................. 39 Condiciones para el Clculo ............................................................................................... 40 Creacin de un Proceso ...................................................................................................... 41 Tipo del Proceso ................................................................................................................. 42 Atributos del Proceso ......................................................................................................... 43 Funcin del Proceso ........................................................................................................... 44 Mensajes del Proceso ......................................................................................................... 45 Condiciones del Proceso ..................................................................................................... 46 Creacin de Validaciones ................................................................................................... 47 Elemento a Validar ............................................................................................................. 48 Mtodo de Validacin ........................................................................................................ 49 Tipo de Validacin ............................................................................................................. 50 Nombre y Secuencia de la Validacin ................................................................................ 51 Mensaje de la Validacin ................................................................................................... 52 Condiciones de la Validacin ............................................................................................. 53 Atributos de Pgina con Elementos Creados ...................................................................... 54

Manual de Oracle Application Express (APEX).

Crear Aplicacin

En el men principal (home) del Oracle Application Express (APEX) se presenta la opcin para la creacin de una nueva aplicacin, de la misma manera que se presenta la opcin para importar una aplicacin previamente exportada. A continuacin se presentan los pasos para la creacin de una nueva aplicacin, as como, la creacin de regiones, botones, elementos y dems componentes que conforman comnmente una aplicacin. En la imagen que se presenta a continuacin se observa la pgina principal del APEX en el que se selecciona la opcin de crear una aplicacin.

Manual de Oracle Application Express (APEX).

Seleccionar una Nueva Aplicacin.

Las nuevas aplicaciones se pueden crear de tres diferentes opciones, estas son, desde una hoja de clculo, una aplicacin de demostracin o una aplicacin totalmente nueva que es el caso que se presenta a continuacin. Luego de seleccionar la opcin Create Application (Crear Aplicacin) se debe presionar el botn Next (Siguiente). A continuacin se presenta la pantalla en que se siguen los pasos mencionados.

Manual de Oracle Application Express (APEX).

Atributos de la Aplicacin.

Para la nueva aplicacin es necesario asignar los siguientes valores: Name (Nombre): es el nombre de la aplicacin que se est construyendo. Application (Aplicacin): numero de identificador de la aplicacin, este nmero es nico entre las aplicaciones que existen ya creadas, por defecto se genera el prximo valor de la secuencia de los nmeros de las aplicaciones existentes, este valor puede ser modificado en este momento por otro nmero que no est asignado. Create Application (Crear Aplicacin): se presentan dos opciones, From Scratch (desde cero) y Based on existing application desing model (basado en un modelo de diseo de una aplicacin existente). En este caso seleccionamos la primera opcin. Schema (Esquema): es el esquema de la base de datos en que se crear la aplicacin, por defecto aparece el esquema del usuario con que se encuentra conectado a la aplicacin. A continuacin se visualiza la pantalla correspondiente a este paso, inmediatamente asignado los valores a estos campos, presionar el botn Next (Siguiente) para ir al siguiente paso.

Manual de Oracle Application Express (APEX).

Pginas de la Aplicacin.

La aplicacin debe contener al menos una pgina en un principio, a continuacin se presenta la manera en que se debe agregar una pgina para continuar con la creacin de la aplicacin. En este caso se presentan varios tipos de pginas como se visualiza en la imagen mostrada a continuacin. Estos tipos son: 1- Pgina en blanco, 2- Reporte, 3- Forma, 4Forma Tabular, 5- Detalle Maestro y 6- Reporte con Forma. En el caso actual seleccionar la primera opcin Pgina en blanco y presionar el botn Add Page (Agregar Pgina). Luego de creada la aplicacin se pueden agregar las pginas que se deseen, pero en este paso es importante crear al menos una de ellas. Para continuar, presionar el botn Next (Siguiente) para ir al prximo paso.

Manual de Oracle Application Express (APEX).

Tipos de Pestaas.

Para facilitar la navegacin entre los mdulos que pueda contener la aplicacin, se presenta la opcin de pestaas, entre estas estn: No Tabs (Sin Pestaas): Esta opcin no crea en la aplicacin el diseo de pestaas. One Level of Tabs (Un nivel de Pestaas): Permite la creacin de pestaas en un nico nivel. Two Levels of Tabs (Dos niveles de Pestaas): Permite la creacin de pestaas en dos niveles. En la aplicacin actual se selecciona la opcin de No Tabs (Sin Pestaas) aunque esto puede modificarse luego de creada la misma. Presionar el botn Next (Siguiente) para continuar con el proceso.

Manual de Oracle Application Express (APEX).

Elementos Compartidos.

Los elementos compartidos como su nombre lo indica, son elementos que pueden ser comunes entre aplicaciones, en este paso se presenta la opcin de importar los elementos compartidos de otras aplicaciones existentes, estos elementos pueden ser plantillas de reportes, listas de valores, diseos entre otros, en el caso actual como se parte de una aplicacin nueva se selecciona la opcin No para no importar ningn elemento de otra aplicacin. Presionar el botn Next (Siguiente) para continuar.

Manual de Oracle Application Express (APEX).

Seguridad de la Aplicacin.
Para los esquemas de seguridad de la aplicacin que se est creando, se presentan tres opciones bsicas: Application Express: este esquema permite ingresar a la aplicacin nicamente a los usuarios con cuentas activas dentro de la herramienta. No Authentication (Sin Autenticacin): La aplicacin 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 aplicacin son aquellos que poseen una cuenta en la base de datos en donde residir la aplicacin. Para el caso actual se selecciona la primera opcin 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 opcin de Use Application Primary Language (Usar el Lenguaje Principal de la Aplicacin). Presionar el botn Next (Siguiente) para continuar con el proceso de creacin.

Manual de Oracle Application Express (APEX).

10

Tema de la Aplicacin.

En este paso se asigna a la aplicacin el tema de diseo que se desea que tenga, dicho tema puede ser modificado en cualquier momento mediante el men Shared Compenents (Componentes Compartidos) de la aplicacin, en la opcin de Themes. En la aplicacin actual se selecciona el tema 3 como predeterminado. Para continuar presionar el botn Next (Siguiente).

Manual de Oracle Application Express (APEX).

11

Confirmar la Creacin.

Para finalizar con la creacin de la aplicacin se muestra un cuadro con un pequeo resumen de la informacin que se le asign a la aplicacin, de no estar satisfecho con la misma, puede ir a los pasos anteriores presionando el botn Previous (Atrs) para modificarla. Tambin puede guardar esta configuracin como un modelo predeterminado marcando la casilla de chequeo presentada al final. Para culminar, presionar el botn Create (Crear).

Manual de Oracle Application Express (APEX).

12

Aplicacin Creada.
A continuacin se visualiza la pgina principal de la aplicacin creada, as mismo, el mensaje de xito en la creacin de la aplicacin, junto con el men de opciones para el mantenimiento y personalizacin de la misma, este men est conformado por: Run Application (Ejecutar Aplicacin). Supporting Object (Objetos Soportados). Shared Components (Componentes Compartidos). Export/Import (Exportar/Importar).

Manual de Oracle Application Express (APEX).

13

Edicin de una Pgina.

Para la edicin y personalizacin de una pgina, se muestra a continuacin los elementos que componen la misma, entre estos elementos estn: Page Rendering (Atributos de Pgina): en los cuales se pueden modificar las preferencias de la pgina. 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 pgina. Items (elementos): para agregar, eliminar o editar los elementos de la pgina, como campos de texto, lista de seleccin, reas de texto entre otros. Computations (Clculos). Processes (Procesos), Validations (Validaciones), Branches (Bifurcaciones), y dems opciones que se visualizan a continuacin.

Manual de Oracle Application Express (APEX).

14

Atributos de la Pgina.
A continuacin se presentan los atributos de la pgina y la funcin de cada uno, as como la imagen en donde se visualizan los mismos. Name (Nombre): En este tpico se puede definir el nombre de la pgina, un alias y el grupo al cual pertenece la misma. Display Attributes (Atributos de Visualizacin): se presentan opciones como la platilla, las pestaas, el ttulo entre otros. Header and Footer (Cabecera y Pie de Pgina): Se puede ingresar texto que se visualizar en la pgina en las regiones mencionadas. HTML Header (Cabecera HTML): Cdigo HTML que se puede ingresar para ser visualizado en la cabecera de la pgina. HTML Body Attribute (Atributos HTML del Cuerpo de la Pgina): Cdigo HTML que se puede ingresar para ser visualizado como contenido de la pgina. Security (Seguridad): seguridad en aspectos como los esquemas autorizados para ver la pgina, la autenticacin y la proteccin de acceso. Duplicate (Dulicado): esta opcin se maneja para cuando el usuario presiona el botn Atrs en el explorador y la pgina realiza un submit. Cache: Permite activar o desactivar el almacenamiento en cache de la informacin de la pgina, 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 continuacin se visualiza los atributos de la pgina 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 Regin a la Pgina.

Una pgina puede poseer una variedad de regiones dependiendo del uso que se le dar a la misma, al inicio cuando se cre la aplicacin, en la pgina actual se cre una regin HTML, en este caso se proceder con la creacin de un reporte, como se puede ver a continuacin existen regiones como formas, rboles, calendarios, ayudas entre otros, que se pueden aadir a las paginas. Para continuar con la creacin de la regin de reporte, presionar el botn Next (Siguiente)

Manual de Oracle Application Express (APEX).

18

Tipo de Regin.
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 opcin) para la visualizacin de datos existentes en una base de datos. Luego de seleccionar esta opcin, presionar el botn Next (Siguiente) para continuar con el proceso de creacin.

Manual de Oracle Application Express (APEX).

19

Atributos de Visualizacin de la Regin.

Es necesario asignar a la regin del reporte en creacin la siguiente informacin solicitada: Title (Ttulo): Nombre de la regin. Region Template (Plantilla de regin): Es el formato que tomar la regin en cuanto a diseo. Display Point (Lugar de Visualizacin): Posicin de la pgina en la que se ubicar el reporte. Secuence (Secuencia): Identificador numrico que diferenciar a la regin de forma nica de las dems regiones creadas. Column (Columna): Nmero de la columna en donde se ubicar el reporte. Para continuar con la creacin del reporte SQL presionar el botn Next (Siguiente), a continuacin se observa la pantalla en la que se solicita dicha informacin.

Manual de Oracle Application Express (APEX).

20

Contenido de la Regin.

El contenido de la regin en este caso por ser un reporte SQL es la sentencia que consultar la base de datos para obtener la informacin. Para facilitar la creacin de dicha sentencia se brinda la opcin del Query Builder (Constructor de Consultas) que facilita al usuario el ensamblaje de la sentencia. Para la visualizacin de los encabezados del reporte existen dos opciones, ya sea derivado de la consulta Derived from query columns o columnas genricas Generic columns. A continuacin se visualiza la pantalla en la que se debe ingresar la informacin descrita anteriormente. Para continuar con la creacin presionar el botn Next (Siguiente).

Manual de Oracle Application Express (APEX).

21

Atributos del Reporte.

Entre los atributos para continuar con la creacin del reporte se encuentran: Report Template (Plantilla del Reporte): Lista de seleccin que contiene las diferentes plantillas predeterminadas, de haberse creado una platilla personalizada, aparecera 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 Pgina): Nmero de filas que se desean visualizar por cada pgina del reporte. Column heading Sorting (Ordenado por columna): Se selecciona Yes (Si) s desea la opcin de ordenar el reporte por cada columna. CSV Output (Salida CSV): Para descargar el contenido del reporte en un archivo de extensin CSV seleccionar la opcin Yes (Si). Report Printing (Impresin del Reporte): Para imprimir el contenido del reporte seleccionar la opcin Yes (Si). Para continuar con la creacin del reporte SQL presionar el botn Next (Siguiente), a continuacin se observa la pantalla en la que se solicita dicha informacin.

Manual de Oracle Application Express (APEX).

22

Condiciones de Visualizacin de la Regin.

Cualquier tipo de regin posee condiciones de visualizacin, esto con el fin de ocultar o no la regin segn un tipo de evento en la pgina. Entre estos eventos existen item=value (elemento = a valor), item not null (elemento no nulo), request=e1 (solicitud = expresin 1), page in (pgina en), page not in (pgina no contenida en), entre otras muchas ms condiciones que se pueden observar al desplegar la lista en el campo Condition Type (Tipo de Condicin). Si no se desea un tipo de condicin, se deja la opcin por defecto y la regin se visualizar normalmente. Para culminar con la creacin del reporte SQL presionar el botn Create Region (Crear Regin), a continuacin se observa la pantalla en la que se solicita dicha informacin.

Manual de Oracle Application Express (APEX).

23

Creacin de Botones
Para aadir botones a la pgina desde la pantalla de Edicin de una Pgina (vista anteriormente) se presiona en la opcin de Add (Agregar), y la primera informacin solicitada es la regin en la cual se desea crear el botn. A continuacin se visualiza la pantalla en la que se solicita dicha informacin y luego de seleccionar la regin presionar el botn Next(Siguiente) para continuar con la creacin.

Manual de Oracle Application Express (APEX).

24

Posicin del Botn.

Como cuando se cre el reporte, un botn tambin debe especificarse la posicin en que se ubicar el mismo, las opciones presentadas para esto son: Create a button in a regin position (Crear un botn en una posicin de la regin) Create a button displayed among this regions tems (Crear un botn mostrado entre los elementos de la regin) En el caso actual se selecciona la primera opcin y se presiona el botn Next (Siguiente) para continuar con la creacin del botn. La pantalla donde se solicita dicha informacin se visualiza a continuacin.

Manual de Oracle Application Express (APEX).

25

Atributos del Botn.

Para asignar el nombre del botn y la etiqueta con que se visualizar el mismo, la siguiente pantalla solicita dicha informacin en los siguientes campos: Button Name (Nombre del Botn): nombre con que se manejar el botn. Label (Etiqueta del Botn): Texto con que se visualizar el botn Button Type (Tipo del Botn) o HTML Button (Botn HTML): El botn ser uno HTML. o Image (Imagen): El botn ser una imagen. o Template Driven (Controlado por Plantilla): El botn es del estilo de la plantilla. o Button is Reset (Botn de Reinicio): El botn reinicia la pgina. Action (Accin) o Submit Page and Redirect to URL (aceptar la pagina y redireccionar a una URL): se acepta la accin de la pagina y se redirecciona a una direccin URL. o Redirect to URL without submitting page (redireccionar a una URL sin aceptar la pgina): no se acepta la accin de la pagina y se redirecciona a una direccin URL.

Manual de Oracle Application Express (APEX).

26

Plantilla del Botn.

Como se seleccion anteriormente que el botn ser controlado por una plantilla, se debe seleccionar a continuacin de una lista la plantilla que usar dicho botn, en el caso de haberse seleccionado una imagen en este paso se seleccionara la imagen a cargar. A continuacin se visualiza la pantalla en que se solicita esta informacin, luego de ingresarla, presionar el botn Next (Siguiente) para continuar con la creacin del botn.

Manual de Oracle Application Express (APEX).

27

Atributos de Visualizacin.

Para las opciones de ubicacin en la pantalla se solicita la siguiente informacin: Position (Posicin): Ubicacin en la regin en donde se ubicar el botn. Sequence (Secuencia): Nmero del botn que lo diferenciar de los dems y lo ubicar en la regin. Alignment (Alineacin). Button Attributes (Atributos del Botn).

Presionar el botn Next (Siguiente) para continuar con la creacin del botn.

Manual de Oracle Application Express (APEX).

28

Redireccionamiento del Botn.

La accin del botn generara un Redireccionamiento a una pgina, ya sea la misma u otra diferente, a continuacin en el campo Branch to Page (when button pressed) (Bifurcacin a Pgina (cuando se presione el botn)) se debe ingresar la pgina a la cual se digirir la aplicacin.

Manual de Oracle Application Express (APEX).

29

Condiciones de Visualizacin del Botn.

Cualquier tipo de botn posee condiciones de visualizacin, esto con el fin de ocultar o no al mismo segn un tipo de evento en la pgina. Entre estos eventos existen item=value (elemento = a valor), item not null (elemento no nulo), request=e1 (solicitud = expresin 1), page in (pgina en), page not in (pgina no contenida en), entre otras muchas ms condiciones que se pueden observar al desplegar la lista en el campo Condition Type (Tipo de Condicin). Si no se desea un tipo de condicin, se deja la opcin por defecto y el botn se visualizar normalmente. Para culminar con la creacin del botn presionar el botn Create Button (Crear Botn), a continuacin se observa la pantalla en la que se solicita dicha informacin.

Manual de Oracle Application Express (APEX).

30

Creacin de Elementos.
Para aadir elementos a la pgina desde la pantalla de Edicin de una Pgina (vista anteriormente) se presiona en la opcin de Add (Agregar), y la primera informacin solicitada es el tipo de elemento que se desea agregar. Entre estos tipos de elementos se encuentran: Check Box (Casillas de Verificacin), Date Picker (Selector de Fecha), Hidden (Oculto), Select List (Lista de Seleccin), Text (Texto) entre otros. A continuacin se visualiza la pantalla en la que se solicita el tipo de elemento, que en este caso se selecciono Text y luego presionar el botn Next(Siguiente) para continuar con la creacin.

Manual de Oracle Application Express (APEX).

31

Especificacin 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 estn: Text Field (Campo de Texto): Campo de texto comn. 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 enva la pgina al presionar enter en l. Text Field with Calculator Popup: Campo de texto con calculadora emergente.

En este caso seleccionar el campo de texto comn, en el cual se puede ingresar cualquier tipo de informacin. A continuacin se presenta la pantalla en la que se solicita al desarrollador seleccionar el tipo del elemento.

Manual de Oracle Application Express (APEX).

32

Posicin y Nombre del Elemento.

El siguiente paso es asignar un nombre al elemento, una secuencia para diferenciarlo de los dems elementos y la regin a la que pertenecer el elemento, a continuacin se visualiza la pantalla en la que se solicita esta informacin.

Manual de Oracle Application Express (APEX).

33

Atributos del Elemento.

El siguiente paso en la creacin del elemento es la asignacin de atributos para la visualizacin del mismo, estos atributos son: Label (Etiqueta): Nombre con que se mostrar el elemento. Label Alignment (Alineacin de la Etiqueta): Posicin en relacin al elemento en donde saldr la etiqueta. Field Width (Ancho del campo): Nmero de caracteres que permitir ingresar el elemento. Field Alignment (Alineacin del Campo): Posicin en donde saldr el campo en la pgina. Label Template (Plantilla de la etiqueta): Plantilla que controlar la etiqueta del elemento. Begin on New Line (Comenzar en lnea nueva): si se desea que el elemento comience en una lnea nueva, seleccionar la opcin Yes (Si).

A continuacin se observa la pantalla en que son solicitados dichos valores para ser asignados al elemento en creacin

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 vaco se cuenta con la opcin 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 expresin PL/SQL entre otros. A continuacin se muestra la pantalla en que se ingresa este valor.

Manual de Oracle Application Express (APEX).

35

Estado de Sesin 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 continuacin se observa la pantalla en que se ingresa esta caracterstica del origen del elemento, y para culminar con la creacin del elemento presionar el botn Create Item (Crear Elemento).

Manual de Oracle Application Express (APEX).

36

Crear Clculo de Pgina.

Los clculos de pginas cumplen la funcin de procesar valores y asignarlos a elementos de la aplicacin, ya sean en la pgina donde se crea el mismo o en otra pgina de la aplicacin. El primer paso a seguir para la creacin de un clculo es definir si se va a realizar a un elemento en la pgina actual Item in This Page, un elemento en otra pgina Item on Another Page o un elemento a nivel de aplicacin Application Level Item, en el caso actual se realizar el clculo para un elemento en la pgina actual (creado en los pasos anteriores). La pantalla en la que se solicita dicha informacin para el clculo se puede observar a continuacin.

Manual de Oracle Application Express (APEX).

37

Elemento a Calcular.
Una vez seleccionada la opcin del clculo en el elemento, es necesario suministrar la siguiente informacin: Compute Item (Elemento a calcular): En la lista de seleccin aparecen los elementos existentes a los que se le pueden aplicar el clculo en creacin. Sequence (Secuencia): Identificador numrico que permite diferenciar los clculos existentes. Computation Point (Lugar del clculo): momento en el cual se hace ejecutar el clculo. Computation Type (Tipo del clculo): La lista de seleccin contiene los tipos de clculos que se pueden crear en la pgina.

A continuacin se presenta la pantalla en la que se solicita la informacin mencionada.

Manual de Oracle Application Express (APEX).

38

Proceso del Clculo.

Una vez seleccionado el clculo de tipo expresin PLSQL se solicita ingresar dicha expresin en el campo Computation (Clculo) como se observa a continuacin. Presionar el botn Next para continuar con la creacin.

Manual de Oracle Application Express (APEX).

39

Condiciones para el Clculo.

Cualquier tipo de clculo posee condiciones de ejecucin, esto con el fin de permitir o no ejecutarse segn un tipo de evento en la pgina. Entre estos eventos existen item=value (elemento = a valor), item not null (elemento no nulo), request=e1 (solicitud = expresin 1), page in (pgina en), page not in (pgina no contenida en), entre otras muchas ms condiciones que se pueden observar al desplegar la lista en el campo Condition Type (Tipo de Condicin). Si no se desea un tipo de condicin, se deja la opcin por defecto y el clculo se ejecutar normalmente. Para culminar con la creacin del clculo presionar el botn Create (Crear), a continuacin se observa la pantalla en la que se solicita dicha informacin.

Manual de Oracle Application Express (APEX).

40

Creacin de un Proceso.
Los procesos son pequeos fragmentos de cdigo que se ejecutan en una pgina al ocurrir determinada situacin, dichos procesos pueden comportarse como clculos o hasta realizar acciones en una base de datos. Algunos de los procesos que se pueden crear son: PL/SQL: cdigo PL/SQL que se ejecuta para realizar determinada accin. Session State (Estado de la Sesin): permite controlar la cache de la pgina o de la aplicacin entre otras cosas. Close popup Windows (Cerrar Ventana Emergente).

Estos son algunos de los procesos que se pueden crear, a continuacin 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 pgina.

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 Sesin) 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 Aplicacin 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 Pginas) y presionar el botn Next (Siguiente) para continuar con la creacin, a continuacin se observa la pantalla en la que se solicita dicha informacin.

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): Nmero que identificar nicamente al proceso en la pgina. Point (Punto de Ejecucin): Momento en el que se ejecutar dicho proceso. Para continuar con la creacin del proceso, presione el botn Next (Siguiente). A continuacin se observa la pantalla en la que se solicita la informacin mencionada.

Manual de Oracle Application Express (APEX).

43

Funcin del Proceso.

En este paso del proceso se debe especificar el nmero de pginas a las que se les realizar el proceso de limpiado de cache, en el caso de ser un proceso PL/SQL se solicitar el cdigo del mismo. A continuacin se visualiza la pantalla en la que se debe ingresar esta informacin, para continuar con la creacin presionar el botn Next (Siguiente).

Manual de Oracle Application Express (APEX).

44

Mensajes del Proceso.

Se presenta la opcin de mostrar mensajes de xito o de fallo del proceso, esta informacin se debe ingresar en los campos Success Message (Mensaje de xito) y Failure Message (Mensaje de Fallo) respectivamente, como se muestra a continuacin. Presionar el botn Next (Siguiente) para continuar con la creacin del proceso.

Manual de Oracle Application Express (APEX).

45

Condiciones del Proceso

Cualquier tipo de proceso posee condiciones de ejecucin, esto con el fin de permitir o no ejecutarse segn un tipo de evento en la pgina. Entre estos eventos existen item=value (elemento = a valor), item not null (elemento no nulo), request=e1 (solicitud = expresin 1), page in (pgina en), page not in (pgina no contenida en), entre otras muchas ms condiciones que se pueden observar al desplegar la lista en el campo Condition Type (Tipo de Condicin). Si no se desea un tipo de condicin, se deja la opcin por defecto y el proceso se ejecutar normalmente. Para culminar con la creacin del proceso presionar el botn Create Process (Crear Proceso), a continuacin se observa la pantalla en la que se solicita dicha informacin.

Manual de Oracle Application Express (APEX).

46

Creacin de Validaciones.
Existen en las pginas validaciones a nivel de un elemento o a nivel de una pgina completa, esto se selecciona en los campos Item level validation (Validacin a nivel de elemento) o Page level validation (Validacin a nivel de Pgina) respectivamente, en el caso actual se crear una validacin a nivel de elemento como se aprecia a continuacin en la imagen.

Manual de Oracle Application Express (APEX).

47

Elemento a Validar.
Como en el paso anterior se selecciono una validacin a nivel de elemento, este paso consiste en especificar en qu elemento se va a aplicar la validacin, como se puede apreciar en la imagen siguiente, el nico elemento que aparece es el creado en pasos anteriores, de existir ms elementos, estos se listaran a continuacin. Para continuar, presionar el botn Next (Siguiente).

Manual de Oracle Application Express (APEX).

48

Mtodo de Validacin.
El prximo paso a seguir es seleccionar el mtodo de validacin a utilizar, entre estos mtodos se encuentran: SQL: Se usa para validar el tem con una sentencia SQL. PL/SQL: Se usa para validar el tem a travs de un bloque annimo PL/SQL. Item Not Null (Elemento no nulo): Valida que el elemento no se encuentre vaco. Item String Comparison (Comparacin de palabras del elemento): Compara que el contenido del elemento sea igual a los casos que se presentan al seleccionar esta opcin (siguiente pgina). Regular Expression (Expresin Regular). A continuacin se observan las opciones descritas anteriormente, seleccionando el cuarto caso mencionado y presionando el botn Next (Siguiente) para continuar con la validacin.

Manual de Oracle Application Express (APEX).

49

Tipo de Validacin.
Continuando con el mtodo de validacin se debe especificar qu tipo de comparacin 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 numrico), Item specified is alphanumeric (El elemento es alfanumrico) que es el caso que se va a tomar. Presionando el botn Next (Siguiente) se contina con la creacin de la validacin. A continuacin se presenta la pantalla donde estn los mtodos posibles para crear.

Manual de Oracle Application Express (APEX).

50

Nombre y Secuencia de la Validacin

Con la finalidad de diferenciar la validacin de las existentes, es necesario suministrar la siguiente informacin: Sequence (Secuencia): Nmero que identificar inequvocamente a la validacin de las dems existentes en la pgina actual. Validation Name (Nombre de la Validacin): Nombre que se le dar a la validacin que se est creando. Error Display Location (Lugar de visualizacin del error): es en donde se mostrar el mensaje de error cuando la validacin se active.

A continuacin se observan los campos en donde se debe ingresar la informacin descritas anteriormente, presionando el botn Next (Siguiente) para continuar con la validacin.

Manual de Oracle Application Express (APEX).

51

Mensaje de la Validacin.
Cuando la validacin 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 continuacin. Para continuar una vez ingresado el mensaje, presionar el botn Next (Siguiente).

Manual de Oracle Application Express (APEX).

52

Condiciones de la Validacin.

Cualquier tipo de validacin posee condiciones de ejecucin, esto con el fin de permitir o no ejecutarse segn un tipo de evento en la pgina. Entre estos eventos existen item=value (elemento = a valor), item not null (elemento no nulo), request=e1 (solicitud = expresin 1), page in (pgina en), page not in (pgina no contenida en), entre otras muchas ms condiciones que se pueden observar al desplegar la lista en el campo Condition Type (Tipo de Condicin). Si no se desea un tipo de condicin, se deja la opcin por defecto y el proceso se ejecutar normalmente. Adicionalmente, la validacin se puede activar mediante la accin de un botn, este se debe seleccionar en el campo When Button Pressed (Cuando se presione el botn) si as se desea. Para culminar con la creacin de la validacin presionar el botn Create (Crear), a continuacin se observa la pantalla en la que se solicita dicha informacin.

Manual de Oracle Application Express (APEX).

53

Atributos de Pgina con Elementos Creados.

Como se puede observar en la imagen que se presenta a continuacin, la pgina contiene los elementos creados en lo anteriormente descrito en este tutorial, entre los cuales se encuentran las Regiones, Botones, Elementos, Clculos, Procesos y Validaciones. Si en algn momento se desea modificar alguna informacin o configuracin 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