Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
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
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.
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.
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.
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.
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.
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.
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).
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).
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).
13
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.
15
16
17
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.
19
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.
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).
21
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.
22
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.
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.
24
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.
25
26
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.
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.
28
29
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.
31
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.
32
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.
33
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
34
35
36
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.
38
39
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.
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.
41
42
43
44
45
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.
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).
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.
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.
50
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.
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).
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.
53
54