Contenido

1.

INTRODUCCIN A APEX............................................................................................ 2
1.1.

WORKSPACE....................................................................................................... 2

1.2.

CREAR APLICACIN............................................................................................ 2

1.3.

CREAR REPORTE................................................................................................ 5

1.4.

EJECUCION DE REPORTE.................................................................................... 6

1.4.1.
1.5.

CREACIN DE FORMULARIO DE EDICIN DE REGISTROS..................................6

1.5.1.
1.6.

Reemplazar Botn de edicin en los registros del campo Location_Id.........6

Insercin de botones DML en el formulario..................................................9

ENLACE DEL FORMULARIO AL REPORTE...........................................................10

1.6.1.

Crear vnculo para redireccionar al formulario...........................................11

1.6.2. Cambiar el texto por imagen a la columna de vnculo al formulario de

edicin.12
1.7.

AGREGAR BOTON NUEVO AL REPORTE............................................................13

1.8.

CONFIGURANDO ELEMENTOS DEL FORMULARIO.............................................15

1.8.1.

Agregar primary key para la insercin de un registro................................15

1.8.2.

Crear un Popup LOV en el formulario (Componentes Compartidos)..........17

1.8.3.

Lista estatica de valores............................................................................ 18

1.8.4.

Modificar mensaje de confirmacin al Botn Eliminar...............................19

2.

FORMULARIO CON REPORTE EN UNA PGINA.........................................................20

3.

GESTIN DE APLICACIONES................................................................................... 21
3.1.

EXPORTAR APLICACIN.................................................................................... 21

3.2.

IMPORTAR APLICACIN..................................................................................... 22

1. INTRODUCCIN A APEX
ENLACE A APLICACIN: 172.20.6.27:8081/pex
# pg. que apunta

http://172.20.6.27:8081/apex/f?p=101:1:13759...
Nombre de app.# Variable de sesin

1.1. WORKSPACE
Acceso por workspace, no acceso por aplicacin.
Se duplica, no se reutiliza.
A un workspace se puede asignar varios esquemas, pero cada esquema pertenece a
un solo workspace (Workspace----Uno a varios ----< Esquemas).
Se debe crear usuarios DE APEX y asignarles un determinado esquema, estos
usuarios no tienen que ver con los que se crean a nivel de la base de datos, es decir el
esquema HR/HR es de la base de datos pero para utilizar este esquema no accede
por la cuenta creada en la base, sino por usuarios que se crean en el Area de
gestin de usuarios de APEX.
Por default se crea el usuario ADMIN

1.2. CREAR APLICACIN

Aplication Builder -> Create
Database: porque se va a conectar a una bdd.

NEXT

CLICK EN Add Page para seguir agregando ms pginas.

Queda de esta manera:

Puedo elegir si quiero autenticar o no para la aplicacin.

NEXT

CREAR: Por default la vista de los componentes de la app se distribuye en rbol pero
podemos cambiar a Component View

Ilustracin 1 Tree View

Ilustracin 2 Component View

2. REPORTE CON REDIRECCIN A FORMULARIO (mtodo 1)

2.1. CREAR REPORTE
O puede agregar el reporte despus de crear la app asi:
-

NEXT

NEXT

En la Aplicacin seleccionar Crear Tab Page- > Report -> Interactive. En

Region Template seleccionar Reports Region (no Breadcrumb Region)

2.2. EJECUCION DE REPORTE

2.2.1.Reemplazar Botn de edicin en los registros del campo Location_Id

En el rea de Regions click en Breadcrumbs para hacer los tabs y enlazar a
formulario de edicin. Recordemos que creamos la app sin tabs.

2.3. CREACIN DE FORMULARIO DE EDICIN DE REGISTROS

Una vez creado el reporte, creamos un formulario de edicin que se enlazar al
reporte Tabular que creamos.
Para esto: Create Page -> Form -> Form on Tableo or View

Cambie el Page Name y Region Title dejar como est escrito por default.
En Breadcrumb seleccione la opcin Breadcrumb, con esto agregamos al formulario
un div con la ruta de navegacin. Como Editar y Crear Localidades es un
submen de Localidades entonces en parent entry seleccione el padre
Localidades.

El men quedara en esta posicin:

Elija la opcin Dont use tabs porque le vamos a llamar del reporte.

Primary Key

Podemos seleccionar Existing trigger, que ser un trigger que se encuentra en la

base de datos, o tambin puede usar Existing secuence que de igual manera estar
previamente implementado en la base.

Seleccionamos las columnas de la tabla Locations

que se vern en el formulario

2.3.1.Insercin de botones DML en el formulario

Seleccionamos los botones que deseamos que aparezcan en el FORMULARIO: INSERT,
DELETE, CANCEL, SAVE. Estos botones ya estn programados.

Seleccione una pgina a la que va a redireccionar (Branching), despus de que el

procesamiento del formulario se ha completado.

Ejecutando la pgina:

2.4. ENLACE DEL FORMULARIO AL REPORTE

Seleccionamos la pgina Localidades y le damos click en Region-> Localidades.

Click en la pestaa Report Attributes seleccionamos LOCATION_ID que es la

columna por la que voy a hacer el enlace al formulario. (Click en el cono de lpiz).

Aparece la siguiente pantalla correspondiente a configuracin de la columna

location_id, en la que realizaremos tareas como:
1. Cuando haga click en el campo LOCATION_ID de cualquier registro me redirija al
formulario.
2. Reemplazar el texto del campo LOCATION_ID por un botn de edicin.
2.4.1.Crear vnculo para redireccionar al formulario.
1. Cuando haga click en el campo LOCATION_ID de cualquier registro me redirija al
formulario.
Nos dirigimos a la pestaa Link Column:
-

En Link Text: Ponga texto HTML que se va a ver como link (LOV). Puede
usar una etiqueta de imagen o seleccionar las opciones de imagen que hay por
default.
CLICK en LOV del campo Page y selecciona el formulario (Editar y Crear
Localidades).
El campo Target por default tiene el valor Page on this App pero puede
seleccionar URL e insertar la direccin de la pgina a la que se va a
redireccionar.

La lista de Items y sus Values son elementos que pertenecen a la pgina de edicin
o formulario o pgina3. Se seleccionara la primary key de la tabla para que realice la
consulta y devuelva los datos en la pgina a la que se redirecciona.
Cuando el nombre de una columna se escribe con la sintaxis: #nombre_columna#
hace referencia al valor de esa columna en un determinado registro. EN
#LOCATION_ID# tomara los valores que son de tipo entero como : 4092,
1265
Ejemplo: En Item 1 y value corresponden al campo LOCATION_ID que es en
base al cual se hace la consulta y se devuelven los datos en el formulario Editar y
Crear Localidades o Pagina 3.

2.4.2.Cambiar el texto por imagen a la columna de vnculo al formulario

de edicin.
Como en Link Text escogimos de la lista de valores #LOCATION_ID# , quiere decir
que la columna LOCATION_ID del Reporte va a tener como vnculo a la misma
informacin de cada registro, como en la Ilustracin siguiente:

Ilustracin 3 Informacin de Location_id funciona acta como vnculo

Cambiando el Link Text por una Imagen:

Eliminamos la columna del botn edit azul: En Link Column (Columna de

Vnculo), que crea por default APEX, de la pestaa Report Attributes cambiamos la
opcin Link to Single Row View por Exclude Link Column.

De manera que al hacer clic en cualquier registro me devolver los datos en el

formulario para editar:

2.5. AGREGAR BOTON NUEVO AL REPORTE

Se agregar el botn Nuevo al Reporte. Seleccionamos el reporte Localidades y en
el rea de Botones damos click en + para crear.

En Action When Button Clicked cambie Action a Redirect to Page on this APP y
Clear Cache se pone el numero de pagina que queremos quede limpia de datos.

Clear Cache: numero_pagina: Introduzca los nmeros de pgina, separados por

comas, para las que desean que no aparezcan los datos guardados anteriormente.
Cuando quiera agregar un registro, si ha realizado una edicin, los datos del
registro se quedan guardados la prxima vez que accede a ste. Lo que hay
que hacer para evitarlo es usar Clear Cache en la accin del botn Nuevo, indicando
la pgina/as que queremos que limpie.

2.6. CONFIGURANDO ELEMENTOS DEL FORMULARIO

2.6.1.Agregar primary key para la insercin de un registro.

Creamos el trigger para implementar la clave primaria.

SAVE AND COMPILE.

Agregar un registro:

2.6.2.Crear un Popup LOV en el formulario (Componentes Compartidos)

En la pgina del formulario en la Items seleccionamos el elemento al que le vamos a
representar con un POPUP LOV.
Creamos una lista de valores en la pgina del formulario

Click en Create Dynamic List of Values.

NEXT

Agregamos LOV_PAISES al Item P3_COUNTRY_ID

2.6.3.Lista estatica de valores

2.6.4.Modificar mensaje de confirmacin al Botn Eliminar

Hacemos clic en el botn Eliminar de la pgina del formulario y en la pestaa Action
When button clicked cambiamos el contenido del mensaje:
javascript:apex.confirm(htmldb_delete_message,'DELETE'); por
javascript:apex.confirm(Est seguro de eliminar el registro,'DELETE');

3. REPORTE CON REDIRECCIN A FORMULARIO (mtodo 2)

Usando la opcin Form on Table with Report podemos crear de manera ms rpida
un reporte con la redireccin al formulario.
Se trabajar con dos tablas: REGIONS -< COUNTRIES.
Create Page -> Form -> Form on Table with Report

En este caso para que genere automticamente la clave primaria, en lugar de usar
Existing Trigger se ha utilizado Existing Secuence para lo que debe tener creado
previamente una secuencia a nivel de la base de datos.
Luego se sigue los mismos pasos de configuracin que se hizo en el captulo 2
Reporte con redireccin a formulario (mtodo 1).

4. GESTIN DE APLICACIONES
4.1. EXPORTAR APLICACIN.

Exportar a sql.

4.2. IMPORTAR APLICACIN

Se puede cambiar el ID de la Aplicacin.

5. REPORTE MAESTRO DETALLE

5.1. Crear reporte Maestro
Se crear un reporte interactivo en base a la tabla maestra (REGIONS). Solo se
puede crear un reporte interactivo por pgina. (Pagina: Regiones)

5.2. Crear reporte Detalle

Ahora agregaremos una regin a esta pgina y crearemos un REPORTE CLSICO.
Una regin HTML es un contenedor que puede ser usado para contener botones, tems
o texto HTML.

El campo Sequence indica el orden como se muestran las regiones. La tabla para
este reporte es COUNTRIES.

En la opcin de Report Attributes cambiaremos a Yes las siguientes opciones:

Rows per page: Nmero de registros que aparecer por pgina.
Column Heading Sorting: Activa la opcin de ordenar en el reporte, se crea un
cono de flecha en los encabezados de las columnas.
CSV Output: Permite que se descargue un reporte en formato CSV. Para activar esta
opcin, debe utilizar report template con una cadena de sustitucin #CSV_LINK# y
cambie esta opcin a Yes.
Enable Search: Se activa un cuadro para seleccionar las columnas por la cual se
realizan las consultas cuando el usuario ingrese criterio de bsqueda. Para este caso
deje el valor en NO.

Una vez creada la regin la reorganizamos de manera que se despliegue as:

Para reorganizar las regiones debemos editar su disposicin. Hacemos clic en

cualquiera de las regiones y en la pestaa Grid Layout cambiaremos el valor de las
opciones.

5.3. Enlace de reportes Maestro - Detalle

Ahora configuraremos la pgina de modo que cuando seleccione una regin me
retorne los pases correspondientes a ste. Debemos crear un enlace que relacione
las tablas REGIONS -> COUNTRIES ya que los reportes se crearon de manera suelta.
Creamos un tem de tipo oculto (Hidden). P4_OCULTO. Este tem recibir el valor de
la clave primaria de la Regin que hayamos seleccionado.

Ahora realizaremos el enlace maestro detalle. Editar el reporte interactivo

Regiones, en Link Column cambie la opcin a Link to Custom Target, con lo que
especificamos que es un enlace a un objetivo personalizado.
Cambie la opcin Page a 4, es decir redirecciona a la misma pgina.
En Item cambiamos los valores de Name y Value por P4_OCULTO y #REGION_ID#
respectivamente. Lo que quiere decir es que cuando seleccione una regin se enve el
valor (#REGION_ID#) de REGION_ID al Item Oculto que creamos anteriormente
(P4_OCULTO).

Ahora editamos el reporte clsico Pases y modificamos la consulta de esta manera.

5.4. Crear mensaje cuando la consulta no devuelve filas.

En el reporte de PAISES crearemos este mensaje en la pestaa Report Attributes
-> Messages y cambiamos el valor que viene por default.

Creamos un botn para regiones de tipo submit y en clear cache ponemos la misma
pgina. Lo que har este botn es limpiar la cach de la pgina lo que hace que se
borren los datos de la consulta detalle.

Agregaremos un Tab llamado Maestro Detalle en Shared Components de la

pgina Regiones.

6. VALIDACIONES EN FORMULARIO
Agregaremos validaciones en la Pgina del formulario Editar y crear Localidades.
Solo para prueba.
Crearemos las siguientes validaciones:

6.1. Validacin utilizando Expresiones Regulares

Seleccione el Botn para el cual se ejecutar la validacin. En este caso CREATE.

6.2. Validacin utilizando SQL.

Seleccionar el tipo de validacin SQL que se va a crear. (Exists)

Insertamos la consulta SQL: SELECT * FROM COUNTRIES WHERE COUNTRY_NAME

= :P3_POSTAL_CODE . Se iguala al item que vamos a validar.
En Error Message agregamos un mensaje de error.

Haciendo la prueba vemos como el mensaje de error aparece como Notificacin y en

lnea con el campo. Esta opcin puede cambiar en Sequence and Name cuando
crea la validacin.

7. MANIPULACIN DE REGIONES
Ahora vamos a crear una pgina en blanco y agregaremos 3 regiones. Se puede crear
hasta un grid de 9x9 regiones.
Importante: Los nombres de las regiones son NICOS si se duplica el nombre,
ste reemplazar a la existente.

7.1. Posicionando las regiones

Se edita las regiones y en la opcin Grid Layout se manipulan las opciones.
Start New Row: La regin va ubicada en una nueva fila?.
Colum: Nmero de columna en la que se va a ubicar la regin
Column Span: Nmero de columnas que va a expandirse una regin.

7.2. Insertar un reporte existente en una Regin

En la Regin 2 insertaremos el reporte.
Usar el iframe de html
<iframe src="f?p=&APP_ID.:2:"></iframe>
&APP_ID: Variable para capturar el nmero de la aplicacin.
Dos puntos (:): se usa para definir el siguiente parmetro.

7.3. Agregar un tem para subir imgenes.

En la pgina Editar y crear Localidades.

Debe agregar la columna IMAGEN en la tabla LOCATIONS de la base de datos.

En la base de datos puede comprobar que la imagen se insert.

Entradas en las barra de navegacin