manual de apex 2-1

Application Express User's Guide

Building an Application

Application Express User's GuideNotas de la traduccin: Building an Application comienza en la pag.24. Al comienzo de este documento se agreg la guia del usuario y los conceptos bajo los cuales se apoya la herramienta de desarrollo. No se traducen los ttulos con el fin de relacionar los prrafos con el texto original ms rpidamente.Los hipervnculos de este documento apuntan todos a un servidor Oracle xe que se supone corriendo en el equipo que se est consultado este documento. Julio Valle

Resumen Esta herramienta permite generar aplicaciones web sobre una base de datos Oracle. Incluye todos los componentes que se necesitan para construir una interface completa con el usuario. Permite utilizar los datos de una hoja de clculo, crear modelos de pginas (plantillas), crear reportes, formularios, grficos, calendarios, navegar a una url, bloquear pginas que se estn modificando (desarrollo en equipo), utilizar listas de valores (LOV como las de form), implementar cortes de control, crear los formularios y reportes manualmente (adems de con el wizard), implementar master-detail en un solo formulario, crear formularios a partir de tablas, a partir de procedimientos almcenandos, a partir de una consulta sql, de un servicio web. Por supuesto se pueden validar y chequear los datos ingresados por el usuario en forma interactiva, mostrar mensajes de error, crear pginas de ayuda para los items, crear grficos de control de procesos que monitorean un sistema a intervalos especficos en forma automtica, crear botones de navegacin, listas de seleccin, check box, popup, calendarios, areas de texto, file browse (mostrar archivos documentos que estn en disco), ocultar elementos de la pgina, radio group, etc. Se puede incorporar JavaScript a las aplicaciones web, a travs de varias interfaces, sin sacrificar la comodidad de desarrollo. Crear LOV dependiente de los seleccionado en otra LOV. Se puede enviar e-mail desde una aplicacin. Tambin se puede correr la aplicacin en modo debug, es decir viendo los valores que toman las variables en tiempo de ejecucin.

Esta ayuda del sistema describe como usar el cliente Oracle Application Express conectado a una base de datos Oracle Express Edition (Oracle Database XE). Temas:

Documentation Topics Audience Documentation Accessibility Related Documents Conventions

Documentation Topics Los temas que se incluyen en esta ayuda son los siguientes: Title Quick Start Running a Demonstration Application Description Ofrece una rpida introduccin al uso del cliente Oracle Application Express con Oracle Database XE. Describe como ejecutar y modificar una aplicacin de demostracin con Application Builder.

Application Builder Provee los conceptos bsicos sobre Application Builder. Concepts Utilice Application Builder para ensamblar interfaces HTML ( aplicaciones) a partir de los objetos de la base de datos tales como tablas y procedimientos. (*) Using Application Provee importante informacin sobre el uso de Application Builder para -1-



Title Builder Building an Application Controlling Page Layout and User Interface

Description construir aplicaciones. Describe como utilizar Application Builder para construir una aplicacin y sus componentes. (*) Describe diferentes mtodos para refinar las interfaces de las aplicaciones de usuarios y el layout de las pginas incluyendo el refinamiento de las regiones, editando los atributos de los items, refinando templates e incorporando CSS (cascading style sheets) e imgenes. (*) Describe como implementar navegacin a una aplicacin utilizando diferentes tipos de controles de navegacin, incluyendo entradas en las barras de navegacin, tales como tabs, breadcrumbs, lists y trees. Explica como gestionar el entorno de desarrollo de aplicaciones incluyendo servicios, estados de cesin, preferencias de usuarios, archivos de log, modelos de aplicaciones, usuarios finales de Application Express, actividad de desarrollo de las aplicaciones, y explica como enviar email desde una aplicacin. Describe como usar la interface de usuario que viene por default para asignar propiedades a tablas columnas vistas. Describe la metodologa para depurar las aplicaciones con Application Builder, incluye modo Debug, modo SQL trace, visualizar pginas de reportes y como remover manualmente un control un componente para aislar el problema. Explica como implementar (instalar) una aplicacin construida con Application Builder. Describe como proveer seguridad a las aplicaciones desarrolladas con Application Builder utilizando encriptacin, proteccin del estado de la sesin, autenticacin y control de autorizacin. Provee informacin acerca de tcnicas avanzadas de programacin tales como enlace de base de datos, utilizacin de tipos de datos collections, ejecucin de SQL en background, utilizacin de servicios web, y gestin de las preferencias de los usuarios. Explica como traducir una aplicacin construida con Application Builder. Describe las APIs disponibles en Oracle Application Express.

Adding Navigation

Understanding Application Administration

Managing User Interface Defaults Debugging an Application

Deploying an Application Managing Application Security Advanced Programming Techniques Managing Application Globalization Oracle Application Express APIs

Managing Database Describe como usar el Object Browser para mostrar, crear y editar Objects with Object objetos de la base de datos Oracle Database Express Edition. Browser Building Queries with Explica como usar la interface grfica del Query Builders para buscar y Query Builder filtrar objetos de la base de datos, seleccionar objetos y columnas, crear relaciones entre objetos, formatear las salidas de los query y salvar los query. -2-



Title Using SQL Scripts Using SQL Commands Using SQL Utilities

Description Provides information on how to use SQL Scripts to create, edit, view, run, and delete script files. Explica como utilizar los comando SQL para crear, editar, ver, ejecutar y borrar comando sql. Describe como usar las herramientas de SQL para exportar e importar datos desde la base de datos, generar DDL, ver reporte de objetos, y restaurar objetos dropeados de la base de datos. Describe como administra la base de datos Oracle Database XE.

Administering the Database

-3-



Application Builder ConceptsNota de la traduccin: Son conceptos bajo los cuales se apoyara la herramienta de desarrollo. No describe los wizards de desarrollo. Se traducen los titulos de este tema. Julio Valle

Conceptos sobre Application Builder (AB)Veremos conceptos sobre los cuales se describe el AB. Comenzamos por indicar que se define como aplicacin a una coleccin de pginas (Pages) enlazadas a travs de Tags, Buttons, enlaces de Hipertexto. Qu es una pgina? Una pgina es el elemento de construccin bsico de una aplicacin. Cuando se construye una aplicacin con AB se crean pginas que contienen elementos que interactuan con el usuario, tales como Tabs, Listas, Buttons, Items y Regions. Se pueden agregar controles a la pgina en su Page Definition. Para ver la Page Definition de una pgina existente: 1. Navegar a la Database Home Page 2. Click sobre el icon Application Builder. 3. Seleccionar una aplicacin existente. 4. Seleccionar una pgina. La Page Definition se divide en tres partes ( secciones lgicas): 1. Page Rendering. Lista los controles de la interface con el usuario y la lgica que se ejecuta cuando la Page es interpretada. Vase "About Page Rendering Controls". . 2. Page Processing. Lista los controles de lgica (tales como clculos y procesos) que son evaluados y ejecutados cuando la pgina es procesada. Vase: "About Page Processing Controls". 3. Share Components. Lista los componentes comunes que se pueden displayar o se aplican sobre cada pgina dentro de la aplicacin. Vase:"About Shared Components". . Ver tambin: "About the Page Definition" and "Editing a Page Definition"

Descripcin de Page Processing y Page Rendering Al crear una aplicacin con AB, se enlazan pginas usando tabs, buttons, o hipertext links. Cada pgina puede tener botones items y puede incluir la lgica de la aplicacin. Se puede bifurcar de una pgina a la prxima usando navegacin condicional, ejecucin de clculos, validaciones, y display de reports, calendarios y grficos. Se pueden generar reportes, grficos y forms utilizando los wizards, escribiendo HTML esttico, o personalizando la generacin con programacin PL/SQL. Temas:

How the Application Express Engine Renders and Processes Pages Understanding Conditional Rendering and Processing Verifying User Identity Controlling Access to Controls and Components

-4-



Describe como el motor del AB interpreta y procesa las pginas. El motor del AB dinmicamente interpreta y procesa las pginas creadas a partir de los datos guardados en las tablas de la base de datos Oracle. Para ver una pgina se enva la peticin al servicio de Application Express ( APPLICATION EXPRESS ). Cuando se ejecuta una aplicacin el servicio de Application Express se apoya en dos procesos: Show Page: es el proceso que dibuja la pgina. Ensambla todos los atributos de la pgina (incluye regiones, items y botones) en una pgina HTML. Accept Page: ejecuta el procesamiento de la pgina. Ejecuta bifurcaciones, procesos y clculos. Cuando se solicita una peticin de pgina utilizando una url, el servicio ejecuta el proceso Show Page. Cuando se submite (se acepta) una pgina, el servicio ejecuta el proceso Accept Page, y ejecuta procesos de la pgina durante el cual salva los valores submitidos en la cache de la sesin y ejecuta los procesos, validaciones y/o clculos correspondientes. Descripcin de Page Processing y Page Rendering Una condicin es una expresin lgica que permite controlar el display, en la pgina, de botones, regiones, items y tabs como as tambin permite controlar la ejecucin de procesos, validaciones y clculos. Por ejemplo, cuando se condiciona un botn, el constructor de pgina evalua la condicin durante el proceso Show Page. Dependiendo del resultado de la evaluacin de la condicin, se mostrar, no, el botn. Se especifican las condiciones, seleccionando un tipo de condicin, cuando se crea el control o componente (regin, item, botn tab) bien seleccionando el atributo Condition Type. Depende del tipo de condicin que se seleccione, sern los valores que son apropiados ingresar como expresiones. La condicin es evaluada a verdadero falso basndose en la expresin especificada. Nota: Si se usa una expresin de campo depende del tipo de condicin seleccionado. Algunos tipos de condiciones no necesitan valores en ninguno de los campos de la condicin. Otros solo necesitan valor en uno de los campos y otros requieren valores en los dos campos. Aunque estos campos son etiquetados Expression1 y Expression2, no son necesariamente expresiones en el sentido estricto. Ellos son simplemente valores apropiados al tipo de condicin. Para ver un listado completo de las condiciones disponibles para un componente (control) dado, click en el icono View a la derecha del listado de los tipos de condiciones. Una lista rpida de las condiciones comnmente usadas aparece debajo de la lista. Si la condicin requiere una expresin, se la debe ingresar en el campo apropiado. La siguiente seccin ofrece ejemplos de algunos tipos de condiciones, comnmente usadas. Ver: Available Conditions para un listado detallado de los tipos de condiciones. Current Page en la Expression1 Su valor es verdadero cuando el ID de la pgina actual est dentro de una lista (delimitada por comas, en la expression1). Por Ej. 100 en la expression1, implica que la condicin se evalua como verdadera si el Id de la pgina actual es 100. Exists (Sql query que retorna al menos un valor) La condicin es verdadera si la consulta retorna al menos 1 fila. Por ejemplo: Select 1 from emp where deptno = :P101_deptno -5-



Este ej. Referencia al item P101_deptno como una variable bind. Se pueden utilizar variables bind dentro de la aplicacin y en las consultas sql para referenciar items de la sesin. Ver: "About Bind Variables" PL/SQL Expression Use pl/sql expression para expresiones pl/sql vlidas evaluadas a verdadero / falso. Por ej. NVL(:MY_ITEM,NO) = YES Autenticacin de usuario Es el proceso mediante el cual se establece (reconoce) la identidad del usuario antes que este pueda acceder a la aplicacin. Podra requerir que el usuario deba ingresar un user/pass o bien un certificado digital o secure key. Oracle Application Express Soporta autenticacin modular, permitiendo cambiar fcilmente el mtodo de autenticacin cuando se necesite. Se puede establecer la autenticacin del usuario seleccionando el mtodo de autenticacin, o usando el wizard para crear su propio mtodo de autenticacin. Ver: "Establishing User Identity Through Authentication" para ms informacin. Control de Acceso a los Componentes Mientras las condiciones controlan la construccin y procesamiento de componentes sobre una pgina, las autorizaciones sobre los esquemas controlan el acceso de los usuarios a los datos. La autorizacin es para controlar el acceso a los recursos basado en los privilegios del usuario (sobre los objetos de la base de datos). El esquema de autorizacin extiende la seguridad al esquema de autenticacin de la aplicacin. Se puede especificar un esquema de autorizacin, para una aplicacin completa, una pgina, o un componente de la pgina tal como una regin, item, o botn. Por ejemplo: se podra utilizar un esquema de autorizacin para seleccionar que botones ( elementos de navegacin) puede el usuario ver en la pgina. Ver: "Providing Security Through Authorization" Nocin de gestin de estado de la sesin HTTP, el protocolo a travs del cual se entregan las pginas HTML, es un estandar. Un browser web est solamente conectado al servidor el tiempo que necesita para bajar la pgina. Adems, cada peticin de pgina, es tratada por el servidor como un proceso independiente, des-relacionado con peticiones anteriores o futuras de cualquier pgina. Esto significa que los valores ingresados en una pgina, relacionados tambin con pginas subsiguientes necesitan ser gestionados como valores de estado de la sesin. Tpicamente es el caso, cuando un usuario ingresa valores en una pgina, estos valores no son accesibles en pginas subsiguientes. Oracle Application. Express, resuelve este problema, manteniendo en forma transparente los valores de estado de la sesin y provee a los desarrolladores la posibilidad de accederlos y actualizarlos desde cualquier pgina de la aplicacin (dentro de la sesin). Temas:

What Is a Session? Understanding Session IDs -6-



Referencing Session State

Que es una sesin? Una sesin es una construccin lgica que establece persistencia a travs de las pginas visitadas. Cada sesin tiene asignado un ID (identificador nico). El motor del Application Express utiliza este ID para guardar y recuperar el conjunto de datos pertenecientes a la sesin que deben permanecer persistentes durante la misma. Ya que las sesiones son totalmente independientes, pueden existir varias al mismo tiempo. Adems, debido a que las sesiones persisten en la DB hasta que el administrador las purge, un usuario puede retornar a una sesin abierta con anterioridad, y continuar utilizndola. Un usuario puede ejecutar mltiples instancias de una misma aplicacin en diferentes sesiones de un browser. Las sesiones son lgica y fsicamente distintas de las sesiones de base de datos usadas para responder a la peticiones de las pginas. Un usuario ejecuta una aplicacin en una sola sesin, de Oracle Application Express, que va desde el login al logout, con una duracin tpicamente medida en minutos u horas. Cada Page requerida durante la sesin implica crear o reutilizar una sesin de la base de datos Oracle a fin de acceder a los recursos de la base de datos. A menudo estas sesiones de base de datos duran fracciones de segundo. Concepto de Session IDs El servicio del Application Express establece la identidad del usuario para cada pgina requerida y con el ID de la sesin recupera el estado de la sesin desde la base de datos. El punto ms visible del ID es la URL de la pgina requerida. Otra ubicacin visible est en la pgina HTML post e indirectamente en el contenido de una cookie de sesin. Esta cookie es enviada por el servicio del Application Express durante la autenticacin y se mantiene durante viva la sesin del browser ( la sesin de la aplicacin), lo que sea ms corto. Oracle Application Express asigna un nuevo Id de sesin durante la autenticacin, registra el usuario autenticado identificado con el Id de sesin y continuamente chequea el id de sesin en cada procesamiento de pgina que se requiere a travs de una URL o post data con la cooki de la sesin y registra la sesin en la base de datos. Estos chequeos proveen flexibilidad y seguridad. Ya que el Id de la sesin es la clave del estado de la sesin, el cookie de la sesin (donde se pueda aplicar) y el registro de la sesin salvaguardan la integridad del ID de la sesin y del estado de autenticacin del usuario. Visualizar el estado de la sesin El comportamiento de una aplicacin se gestiona por los valores de los estados de la sesin. Por ej. Puede mostrarse condicionado por el valor de un item de la sesin. Se pueden ver los valores de los item de una sesin desde una pgina con click en Session Visualizar el estado de la sesin (Session State Page). La pgina de estado de sesin provee informacin muy importante acerca del estado de la sesin. Para localizar una pgina especfica, ingrese el ID de la pgina en campo Page y haga click en GO. A continuacin se describe que informacin contiene. Etiqueta Descripcin -7-



Application

Muestra el nombre de la aplicacin, el usuario conectado, el Id del rea de trabajo ( Id del usuario de la base de datos), y el lenguaje del browser. Page Items Muestra los atributos de los items de la pgina, incluye los id de la aplicacin y de la pgina, nombre del item, como se displaya el item (oculto, popup, button, display solo del HTML), el valor del item en la sesin y un Status. La columna Status indica el estado de la sesin. Los valores posibles son: I-Insert U-Updated R-Reset Application Los application items son items que no residen en la page. Los Items application items son variables de estado de sesin desprovistos de las propiedades de la interface de usuario. Vase tambin: "Creating an Application-Level Item" y "Using Substitution Strings" para mayor informacin sobre referencias a items. Session State Resume el estado de la sesin con los datos actuales de la sesin. Las listas de los Id de aplicacin, los Id de pgina, los nombres de los item, (tipo de display, valor, y etiquetas de display). Ver: "Managing Session State Values" Gestin de los valores de estado de la sesin Cuando el motor del Application Express interactua, intercambia datos con la aplicacin web, es importante conocer como acceder y gestionar los valores de estado de sesin. En Oracle Application Express, el estado de la sesin se maneja automticamente para cada pgina y fcilmente referenciado en cdigo HTML esttico en controles de lgica tales como validaciones y procesos. Temas:

Referencing Session State (Referenciar estado de la sesin) Setting Session State (Establecer valores del estado de la sesin) Clearing Session State (Resetear valores del estado de la sesin) About Bind Variables (Acerca de variables locales relacionadas a la sesin)

Ver: Items y Referencing Item Values Referenciar Estados de Sesin Referenciar el valor de un item es de uno de los ejemplos ms comunes de referencias de variables de estado de sesin. Un item puede ser un campo, un rea de texto, una password, una select list una check box. En la siguiente tabla se describe la sintaxis soportada para referenciar valores de las variables de sesin. Sintaxis para referenciar variables de sesin. Sintaxis Descripcin :MY_ITEM Sintaxis de una variable bind comn cuyo nombre no excede los 30 caracteres. Use esta sintaxis para hacer referencias dentro de consultas SQL y dentro de cdigo PL/SQL. PL/SQL V(MY_ITEM) Sintaxis PL/SQL para referenciar un item usando la Type SQL -8-



PL/SQL Statix text

funcin V. Ver tambin: "Oracle Application Express APIs" NV(MY_NUMERIC_ITEM) Sintaxis para referenciar un item numrico utilizando la funcin NV. Ver tambin: "Oracle Application Express APIs" &MY_ITEM Sintaxis de texto. Variable de sustitucin de texto.

Establecer variables de sesin. Cuando un usuario acepta una pgina, el motor de APPLICATION EXPRESS . automticamente guarda los valores tipeados en los items de la sesin. Por ejemplo, supongamos que una aplicacin sencilla formada por dos pginas. La primer pgina de la aplicacin contiene un formulario en el cual el usuario puede ingresar un nmero de telfono. Se define el formulario y se crea un item denominado P2_PhoneNo. Sobre la segunda pgina, se quiere displayar la informacin ingresada por el usuario en el primer formulario. Cuando la pgina es aceptada, (la primera), Oracle Ap.Ex. captura el valor ingresado para el nmero de telfono y lo guarda. El nro de telfono ingresado por el usuario puede ser recuperado desde el estado de la sesin referenciando el item asociado con el campo de la pgina. Resetear valores del estado de sesin. En el desarrollo de la aplicacin, a veces es til inicializar los valores de algunos items especficamente, de todos los items de una pgina de todas las pginas de la aplicacin, los de la actual sesin. Inicializar implica colocarles el valor null. En el punto siguiente se ofrecen ejemplos especficos de inicializacin: Temas:

Clearing Cache by Item Clearing Cache by Page Clearing Cache for an Entire Application Clearing Cache for the Current User Session

Clearing Cache by item Inicializa la cache para un solo item colocando su valor a null. Por ej. se puede usar este mtodo para asegurar que un item tiene el valor null al ser preparada para ser interpretada por el explorador. El siguiente ej. usa la sintaxis estandar f?p para inicializar la cache para un item. Por ejemplo la pgina denominada 5 de la aplicacin 100. Ubicando MY_ITEM en la ClearCache de la sintaxis f?p resetea el valor de MY_ITEM a null. f?p=100:5:&SESSION.::NO:MY_ITEM El siguiente ejemplo resetea el valor del item THE_EMPNO y THE_DEPNO. f?p=100:5:&SESSION.::NO:THE_EMPNO,THE_DEPTNO Clearing Cache by Page Cachear los item de la aplicacin es una forma efectiva de mantener el estado de la sesin. Sin embargo, hay ocasiones en que se quiere limpiar la cache para todos los item de la pgina. Por ejemplo, supngase que se necesita limpiar todos los campos de una pgina -9-



cuando se hace click en la opcin de crear una nueva orden. Limpiando la cache de la pgina entera, se colocan todos los valores de todos los items de la pgina a null. Clearing Session Cache para dos pginas y resetear la paginacin. Este ejemplo limpia la cache de la sesin para dos pgina y resetea la paginacin. f?p=6000:6003:&SESSION.::NO:RP,6004,6014 Este ejemplo : Ejecuta la pgina 6003 de la aplicacin 6000 y utiliza la sesin actual (id de la sesin corriente) Indica que no se muestra informacin de depuracin (NO). Limpia todos los valores que se mantienen en la actual cache de la sesin para los items de las pginas 6004 y 6014. Resetea la variable de paginacin (RP) en la Page 6003 (la pgina solicitada). Ver:"Controlling Report Pagination" Clearing Session Cache de una Page y le pasa un valor a un item. Este ejemplo muestra como implementar una actualizacin de formulario. Limpia la informacin existente y setea el valor de un item (generalmente se setea la clave primaria). f?p=6000:6003:&SESSION.::NO:6003:MY_ITEM:1234 Este ejemplo: Ejecuta la pgina 6003 de la aplicacin 6000 de la actual sesin. Indica que no se muestra informacin de depuracin. (NO). Limpia todos los valores mantenidos en la cache de la pgina 6003 de la sesin actual. Setea el item de la sesin actual denominado MY_ITEM al valor 1234. Clearing Session Cache de una Page e inicializa varios items. Este ejemplo es similar al anterior, excepto en que pasa varios items. f?p=6000:6004:&SESSION.::NO:6003:MY_ITEM1:MY_ITEM2,MY_ITEM3:1234,,5678 Este ejemplo: Ejecuta la pagina 6004 de la aplicacin 6000 de la actual sesin. Limpia la cache de todos los items de la pgina 6003. Indica que se oculta la informacin de debug. Setea los valores: MY_ITEM a 1234, MY_ITEM2 a null (indicado por la coma utilizada sin valor previo), e indica que MY_ITEM3 se inicialice a 5678. Clearing Cache para una aplicacin completa. Se puede limpiar la cache de una aplicacin completa utilizando la sintaxis f?p y creando un argumento Clear Cache utilizando la palabra clave APP. Por ejemplo: f?p=App:Page:Session::NO:APP Nota: Resetear la cache de una aplicacin completa no implica que se restaure el estado de la aplicacin. Por ejemplo, si una aplicacin incluye clculos procesos (cdigo) en el evento on-new instance de la aplicacin, el motor del Ap.Ex. ejecuta solo esos -10-



clculos y procesos (cdigo) cuando la sesin de la aplicacin es creada. Luego ejecuta el proceso de limpiar la cache y displayar la pgina requerida. La nica forma de resetear una aplicacin completamente, sin el ID de la sesin, es peticionarla utilizando una URL sin ID de sesin, bien llamando al mtodo HTMLDB_APPLICATION.CLEAR_APP_CACHE desde otra aplicacin. Si embargo, si el ID es registrado en el cliente utilizando una cookie, necesitar un logout para resetear el estado. Clearing Cache para la sesin del usuario conectado. Otro mtodo para limpiar la cache de una aplicacin es crear un argumento Clear Cache utilizando la keyword SESSION. Por ejemplo: f?p=6000:6004:12507785108488427528::NO:SESSION Variables Relacionadas (Bind) Se pueden utilizar variables en el cdigo de la aplicacin consultas SQL que hagan referencia a items especficos de la sesin. Por ejemploSELECT * FROM emp WHERE name like '%' || :SEARCH_STRING || '%'

En este ejemplo, el string de bsqueda es un item de la pgina. Si el tipo de regin se define como SQL Query, se puede referenciar el valor utilizando la sintaxis estandar de SQL. Utilizando variables aseguramos que la representacin parseada de la consulta SQL sea reutilizada por la base de datos, optimizando la utilizacin de la memoria del servidor. Recordar las siguientes reglas cuando se definan y utilicen variables bind. Deben corresponder a un nombre de item. No son sensibles a las maysculas/minsculas. El nombre puede tener hasta 30 caracteres (valid Oracle identifier). Aunque los nombres de item de aplicacin y de pgina pueden tener hasta 255 caracteres, si se desea usar un item dentro de la sintaxis de SQL, el nombre del item solo puede tener hasta 30 caracteres. Uso de variables en tipos Regions sobre una consulta SQL LOV. Si el tipo de una variable Regin es SQL Query, (las funciones pl/sql retornan SQL Query), LOV (lista de valores), se pueden referenciar con la siguiente sintaxis. :MY_ITEM Una forma sencilla de hacer esto es incorporar una variable de sesin en la clusula where. El siguiente ejemplo muestra como enlazar el valor del item THE_DEPTNO a una regin definida como SQL Query. SELECT ename, job, sal FROM emp WHERE deptno = :THE_DEPTNO Ver: "Customizing Regions" para ver informacin acerca de la creacin de regiones. Uso de variables (bind) en procedimientos PL/SQL

-11-



Para tipos region tales como un procedimiento PL/Sql, las regiones son construidas usando un formato de bloque annimo. En otras palabras, el comienzo y fin son agregados automticamente al cdigo PL/SQL. Por ejemplo: INSERT INTO emp (empno, ename, job) VALUES (:P1_empno, :P1_name, :P1_job); En este ejemplo, los valores de empno, ename, y job son reemplazados por P1_empno, P1_name y P1_job. Nocin de la sintaxis URL Cada aplicacin tiene un numero (denominado ID de la aplicacin) que la identifica unvocamente. De forma similar, cada pgina tiene un nmero nico (el ID de la pgina). Las aplicaciones y las pginas podran tener tambin alias alfanumricos. Los alias alfanumricos son nicos dentro de un esquema de base de datos pero los alias de pginas son nicos dentro de cada aplicacin. Cuando se ejecuta una aplicacin el motor de Ap. Ex genera un nmero de sesin que sirve como clave para la sesin del usuario. Temas:

Understanding the URL that Displays for a Page Using f?p Syntax to Link Pages Calling a Page Using an Application and Page Alias Calling a Page from a Button URL

URL que se muestra para cada pgina. La URL que muestra cada pantalla le indica la ubicacin a Oracle Application Express e identifica: la direccin la direccin de Oracle Application Express, el ID de la aplicacin, el ID de la pgina, y el ID de la sesin: Por ejemplo: http://apex.oracle.com/pls/apex/f?p=4350:1:220883407765693447 Este ejemplo indica: apex.oracle.com es la URL del servidor. pls es el indicador que usa el cartridge mod_plsql. apex es el nombre del descriptor de acceso de base de datos (DAD). El DAD describe como el servidor de http se conecta al servidor de base de datos as este puede completar la peticin http. El valor por default es apex. F?p= es un prefijo usado por Oracle Application Express. 4350 es la aplicacin llamada. 1 es la pgina de la aplicacin a displayar. 220883407765693447 es el nmero de sesin. Ver: "About Publishing the Application URL" Enlace de pginas con el string f?p Se pueden crear links entre pginas en la aplicacin usando la sintaxis: f?p=App:Page:Session:Request:Debug:ClearCache:itemNames :itemValues:PrinterFriendly -12-



Table: f?p Syntax Arguments Sintxis de los argumentos que se pueden pasar con f?p. Argumento App Page Session Descripcin Id de la aplicacin su alias. Id de la pgina su alias. Id de la sesin. Se puede referenciar un id de sesin para crear un link (de hypertext) a otras pginas que mantienen el mismo estado de la sesin mediante el pasaje del numero de sesin. Se puede referenciar el ID de sesin utilizando la siguiente sintaxis: String de sustitucin: &SESSION Pl/SQL: v(SESSION) Variable: :APP_SESSION Setea el valor de REQUEST. Cada botn de la aplicacin setea el valor de REQUEST con el nombre del botn. Esto permite aceptar procesos que hacen referencias al botn que el usuario lo cliqueo. Se puede referenciar a REQUEST con la siguiente sintaxis: String de sustitucin: &REQUEST PL/SQL: V(REQUEST) Variable: :REQUEST Muestra detalles del procesamiento de la aplicacin. Los valores vlidos para la bandera DEBUG son YES NO. Setee esta bandera a YES para displayar detalles acerca del proceso. Se puede referenciar a la bandera de DEBUG utilizando la siguiente sintaxis: String de sustitucin: &DEBUG PL/SQL: V(DEBUG) Variable: :DEBUG Limpia la cache. Esto setea el valor de los items a null. Para limpiar los item de la cache de una sola pgina, se debe especificar el ID de la pgina. Para limpiar los items cacheados de varias pginas, se listan separados por comas los ID de pgina. Limpiar una cache de una pgina tambin resetea cualquier proceso de la pgina. Se pueden incluir valores de items individuales separados por coma nombres de coleccin la palabra clave RP, la que cual resetea el numerador de pginas de la regin de la pgina requerida. La palabra clave APP limpia la cache de todas las pginas y de todos los items de la aplicacin y remueve las preferencias de orden del usuario conectado. La palabra clave SESSION logra el mismo resultado que APP pero solo limpia los items asociados a la aplicacin de la sesin actual. Lista delimitada por comas de nombres de items para setear el estado de la sesin en una URL. Lista de los valores de los items para setear la sesin en una url. Los items no pueden incluir punto y coma, pero pueden incluir comas si estn entre barras \. Por ej: \123,25\ Determina si la pgina est siendo interpretada (levantada, mostrada) en modo PrinterFriendly. Si PrinterFriendly est seteado a YES, la pgina se muestra en modo PrinterFriendly. El valor de PrinterFriendly puede ser usado para condicionar la interpretacin de la pgina para remover elementos tales como regiones de la pgina para optimizar la salida impresa. Se puede referenciar esta bandera utilizando la siguiente sintaxis: V(PRINTER_FRIENDLY) -13-

Request

Debug

ClearCache

ItemNames ItemValues PrinterFriendl y



Aunque es importante comprender como trabaja la sintaxis de f?p, rara vez tendremos que redactarla nosotros mismos. El Ap Builder incluye varios wizards que automticamente crean estas referencias. La siguiente seccin describe casos especficos en que se utiliza el enlace de pginas con f?p. Invocar una Pgina utilizando alias de aplicacin y de pgina Los alias de aplicacin y pginas deben ser identificadores Oracle vlidos, no pueden contener espacios en blanco, y no son sensibles a las maysculas. El siguiente ejemplo invoca una pgina utilizando alias desde adentro de una aplicacin. Este ejecuta la pgina home de la aplicacin myapp y utiliza el ID de la sesin actual. f?p=myapp:home:&SESSION Los alias de aplicacin deben ser nicos dentro del esquema del usuario. Si una aplicacin en una base de datos diferente tiene el mismo alias, utilice el argumento &c para calificar con el esquema del usuario. Por ejemplo: f?p=common_alias:home:&session.&c=WORKSPACE_A Invocando una pgina desde un botn con una url Cuando se crea un botn, se puede especificar una URL para re-direccionar la navegacin cuando el usuario haga click en el botn. Este ejemplo ejecuta la pgina 6001 de la aplicacin 6000 utilizando la sesin actual. f?p=6000:6001:&SESSION. Ntese que esto es solo un mtodo para usar un botn. Este mtodo bypasea submitir la pgina y acta como un hyperlink a otra pgina. Otro mtodo es submitir primero la pgina. En esta ltima forma, clikeando el botn que submite la pgina para procesarla, permite al formulario ser submitido y que el estado de la sesin sea guardado. Ver: "Creating Buttons" Utilizacin de Strings de sustitucin. Se pueden usar strings de sustitucin dentro de un templeate de pgina regin para reemplazar un carcter string por un valor. Al disear la aplicacin y permitir a los usuarios editar los items, se necesita sustituir strings a fin de pasar la informacin. Se puede utilizar sustitucin de string de la siguientes formas: Incluir un string de sustitucin dentro de un template. Referenciar un item pgina usando la sintaxis &ITEM. Usar un string de sustitucin para lograr una funcionalidad especfica. Los strings de sustitucin usado dentro de un template son delimitado por #. Por ejemplo: #ABC# Para referenciar items de pginas aplicacin usar variables de sustitucin: 1. Preceder el nombre del item con un ampersand (&). 2. Agregar un punto al nombre del item. -14-



Por ejemplo, se podra hacer referencia a un item de aplicacin denominado F101_X en una regin HTML, en un titulo, en una etiqueta en cualquier otro contexto, as: &F101_X. Notar que se requiere el punto final. Cuando la pgina es interpretada, el motor del App.Exp reemplaza el string de sustitucin por el valor del item F101_X

-15-



Strings de sustitucin predefinidos. Application builder soporta un conjunto de string de sustitucin predefinidos. Pueden ser necesarios para referenciar valores con el fin de lograr una funcionalidad especfica. Las siguientes secciones describe estos strings de sustitucin, cuando conviene usarlos y la sintaxis. Notar que la variable :USER tiene un significado especial dentro de la base de datos. Temas:

APP_ALIAS APP_ID APP_IMAGES APP_PAGE_ID APP_SESSION APP_UNIQUE_PAGE_ID APP_USER AUTHENTICATED_URL_PREFIX BROWSER_LANGUAGE CURRENT_PARENT_TAB_TEXT DEBUG HOME_LINK LOGIN_URL IMAGE_PREFIX Application Express SCHEMA OWNER PRINTER_FRIENDLY LOGOUT_URL PROXY_SERVER PUBLIC_URL_PREFIX REQUEST SQLERRM SYSDATE_YYYYMMDD WORKSPACE_IMAGES

Ver tambin: "Substitutions" Acerca de la definicin de string de sustitucin estticos tales como un atributo de la aplicacin. "Establishing User Identity Through Authentication" identificacin de usuario a travs de autenticacin. APP_ALIAS App_alias (alfanumrico) con el nombre de la aplicacin actual. App_alias es diferente de App_Id, ya que App_id debe ser nico en todos los esquemas y en todas las aplicaciones residentes en una base de datos. En contraste, App_alias requiere que sea nico solo dentro del esquema al que pertenece. Se puede utilizar App_alias en cualquier lugar que se pueda utilizar App_id. Por ejemplo, en la sintaxis f?p se puede usar un app_alias un id de aplicacin como se muestra en el ejemplo siguiente: f?p=ABC:1:&SESSION. Este ejemplo ejecuta en la actual sesin, la pgina 1 de la aplicacin ABC. Sintaxis de: APP_ALIAS. -16-



Reference Type Bind variable PL/SQL Substitution string El siguiente es un ejemplo HTML:

Syntax :APP_ALIAS V('APP_ALIAS') &APP_ALIAS.

Click me to go to page 1 of the current application APP_ID App_id identifica la aplicacin que se est ejecutando. Sintaxis de: APP_ID Reference Type Bind variable Direct PL/SQL PL/SQL Substitution string Syntax :APP_ID HTMLDB_APPLICATION.G_FLOW_ID (A NUMBER) NV('APP_ID') &APP_ID.

El siguiente es un ejemplo de una referencia a un string de sustitucin: f?p=&APP_ID.:40:&SESSION. APP_IMAGES Utilizar este string para referenciar imgenes importadas, Java Script, y cascading style sheets (CSS) que son para una aplicacin dada y no son compartidos con otras aplicaciones. Si se importa un archivo y se lo hace especfico de la aplicacin, luego se debe utilizar este string de sustitucin. Sintxis de: APP_IMAGES Reference Type Bind variable Direct PL/SQL PL/SQL Substitution string Template substitution Syntax :APP_IMAGES Not available. V('APP_IMAGES') &APP_IMAGES. #APP_IMAGES#

Ver: "IMAGE_PREFIX", "WORKSPACE_IMAGES", y "Managing Images" APP_PAGE_ID App_page_id es el id de la pgina de la aplicacin actual. Por ejemplo, si la aplicacin est en la pgina 3, debe responder con 3. Es til utilizar esta sintaxis cuando se desea escribir componentes de aplicaciones que necesitan trabajar en mltiples aplicaciones. -17-



Sintaxis de: app_page_id Reference Type Bind variable Direct PL/SQL Direct PL/SQL PL/SQL Substitution string Syntax :APP_PAGE_ID HTMLDB_APPLICATION.G_FLOW_STEP_ID (A NUMBER) :APP_PAGE_ID NV('APP_PAGE_ID') &APP_PAGE_ID.

Ejemplo de sustitucin: f?p=&APP_ID.:&APP_PAGE_ID.:&SESSION. APP_SESSION App_session es uno de los strings de sustitucin ms usados. Se puede utilizar para crear enlaces de hipertexto entre pginas de aplicaciones que mantienen el estado de una sesin pasndole el nmero de sesin. Sintaxis de app_session Reference Type Bind variable PL/SQL Short PL/SQL Short substitution string Substitution string Syntax :APP_SESSION V('APP_SESSION') V('SESSION') &SESSION. &APP_SESSION.

Consideremos el siguiente ejemplo: Desde adentro de una regin HTML: click me Utilizando Pl/Sql: htf.anchor('f?p=100:5:'||V('SESSION'),'click me'); En una consulta sql query:

SELECT htf.anchor('f?p=100:5:'||:app_session,'clickme') FROM DUAL;

APP_UNIQUE_PAGE_ID App_unique_page_id es un entero generado por una secuencia Oracle el cual es nico para cada pgina presentada. Este nmero es utilizado por las aplicaciones para prevenir submitir (aceptar procesar) pginas duplicadas y puede ser usado para otros propsitos. Por ejemplo, si tu quieres obtener una URL nica para evitar que el browser guarde en la cache, se puede embeber (incrustar) este numero en la respuesta columna de debug en el llamado al procedimiento f. Sintaxis de app_unique_page_id Reference Type Bind variable PL/SQL Substitution string Syntax :APP_UNIQUE_PAGE_ID V('APP_UNIQUE_PAGE_ID') &APP_UNIQUE_PAGE_ID. -18-



El siguiente ejemplo es un HTML: SELECT 'f?p=100:1:'||:APP_SESSION||':'|| :APP_UNIQUE_PAGE_ID|| ':::P1_EMPNO:'||empno, ename, job FROM emp Notar el uso de la columna APP_UNIQUE_PAGE_ID en la respuesta. Esto hace que esta URL sea nica y evita el problema de cacheo excesivo del browser. APP_USER App_user es el usuario actual que est ejecutando la aplicacin. Dependiendo de la modalidad de autenticacin, tiene valores que pertenecen a diferentes conjuntos. Si la aplicacin se ejecuta autenticando contra la base de datos, el valor del usuario es el mismo que el USER de la base de datos. Si la aplicacin utiliza un esquema de autenticacin contra el cual se autentica tendr el user dado durante la autenticacin. Sintaxis de App_user Reference Type Bind variable PL/SQL Short PL/SQL Substitution string Syntax :APP_USER V('APP_USER') V('USER') &USER.

Considere los siguientes ejemplos. En una region HTML. Hello you are logged in as &USER. En un cdigo Pl/sql htp.p(Hello you are logged in as||V(USER)); Como una variable SELECT * FROM some_table WHERE user_id = :app_user Ver: "Authentication" para mayor informacin acerca del atributo Public User AUTHENTICATED_URL_PREFIX Este atributo, a nivel de aplicacin, identifica un prefijo autenticado vlido (es decir, un prefijo Url de una sesin iniciada). Se puede usar un path relativo o full comenzando con http. Este item es til si tu aplicacin puede ser ejecutada en ambos modos: autenticado (log in) y pblico ( sin log in). Se puede usar authenticated_url_prefix para construir un link a una pgina autenticada. Este item es ms til cuando se usa autenticacin bsica contra la base de datos porque los cambios a la URL pueden requerir autenticacin. Sintaxis de authenticated_url_prefix Reference Type Bind variable PL/SQL Substitution string Syntax :AUTHENTICATED_URL_PREFIX V('AUTHENTICATED_URL_PREFIX') &AUTHENTICATED_URL_PREFIX.

-19-



BROWSER_LANGUAGE Referencia a la preferencia del lenguaje del browser actual. Sintaxis de browser_language Reference Type Bind variable Direct PL/SQL PL/SQL Substitution string Substitution string Syntax :BROWSER_LANGUAGE HTMLDB_APPLICATION.G_BROWSER_LANGUAGE V('BROWSER_LANGUAGE') :BROWSER_LANGUAGE. &BROWSER_LANGUAGE.

CURRENT_PARENT_TAB_TEXT Es el ms utilizado en los template de pginas, pero es solo relevante para aplicaciones que tienen dos niveles de tab (es decir, los tab parent y standard). Sirve para referenciar a la etiqueta del tab parent. Permite repetir el tab parent actualmente seleccionado dentro del template de la pgina. Sintaxis de current_parent_tab_text Reference Type Bind variable Substitution string DEBUG Los valores vlidos para la bandera de debug son Yes No. Activando debug se muestran los detalles del proceso de la aplicacin. Si se escribe cdigo y se desea ver el debug la nica forma es setear el modo debug a yes. Sintaxis de debug Reference Type Bind variable Direct PL/SQL PL/SQL Substitution string Syntax :DEBUG HTMLDB_APPLICATION.G_DEBUG V('DEBUG') &DEBUG. Syntax Not Available. &CURRENT_PARENT_TAB_TEXT.

Por ejemplo: f?p=100:1:&SESSION.::&DEBUG HOME_LINK Es la pgina inicial de la aplicacin. El motor del App.Exp apuntar a esta ubicacin si no se especifica una pgina y si no se define una pgina alternativa por medio la lgica del esquema de autenticacin. Se define el Home_Link como un atributo de la pgina. Sintaxis de home_link -20-



Reference Type Direct PL/SQL PL/SQL Template Reference Substitution String

Syntax HTMLDB_APPLICATION.G_HOME_LINK V('HOME_LINK') #HOME_LINK# &HOME_LINK.

Ver: "Authentication" para mayor informacin sobre el atributo home link. LOGIN_URL Sirve para displayar un link a la pgina de login para usuarios que no estn actualmente logueados. Sintaxis de login_url Reference Type Bind variable Direct PL/SQL PL/SQL Substitution string Template Substitution Syntax :LOGIN_URL HTMLDB_APPLICATION.G_LOGIN_URL V('LOGIN_URL') &LOGIN_URL. #LOGIN_URL#

IMAGE_PREFIX Determina un path virtual al servidor web usado para apuntar al directorio de imgenes distribuidas con Oracle Application Express. Si se desea referenciar imgenes importadas utilizar WORKSPACE_IMAGES y APP_IMAGES.Ver: "APP_IMAGES","WORKSPACE_IMAGES", y "Configuring Standard Application Attributes"

Sintaxis de image_prefix Reference Type Bind variable Direct PL/SQL PL/SQL Substitution string Template Substitution Syntax :IMAGE_PREFIX HTMLDB_APPLICATION.G_IMAGE_PREFIX V('IMAGE_PREFIX') &IMAGE_PREFIX. #IMAGE_PREFIX#

APPLICATION EXPRESS SHEMA OWNER Si se estn generando llamados a aplicaciones desde dentro de cdigo pl/sql, podra ser necesario referenciar al propietario del esquema de Oracle Application Express. Seguidamente se describe la correcta sintaxis para referencia directa Pl/Sql. HTMLDB_APPLICATION.G_FLOW_SCHEMA_OWNER Tambin se podra usar #FLOW_OWNER# para referenciar este valor en las consultas SQL y PL/SQL (por ejemplo, en una regin en un procesos) -21-



PRINTER_FRIENDLY El valor de PRINTER_FRIENDLY determina si el motor de Ap.Ex se ejecuta en modo visualizacin. Este setting puede ser referenciado en los condicionales para eliminar elementos no deseados en una pgina impresa. Sintaxis de printer_friendly Reference Type Syntax Direct PL/SQL PL/SQL Substitution string HTMLDB_APPLICATION.G_PRINTER_FRIENDLY (VARCHAR2 DATATYPE) V('PRINTER_FRIENDLY') &PRINTER_FRIENDLY.

LOGOUT_URL Es un atributo a nivel de aplicacin usado para identificar la URL de logout. Esta es la URL a la que navega para la pgina de logout u opcionalmente directamente desconecta al usuario. Para crear una entrada logout en la barra de navegacin, se adiciona un punto a &LOGOUT_URL. Si se est codificando una pgina template, utilizar #logout_url#. (notar el punto final). Sintaxis de logout_url Reference Type Bind variable PL/SQL Substitution string Template substitution Syntax :LOGOUT_URL V('LOGOUT_URL') &LOGOUT_URL. #LOGOUT_URL#

PROXY_SERVER Proxy_server es un atributo de la aplicacin. El atributo puede ser usado por regiones cuyos fuentes se originan desde una url. Seguidamente la sintaxis correcta para una referencia pl/sql directa usada cuando estn escribiendo pl/sql para acceder a un servidor web remoto desde adentro de la base de datos (por ejemplo, cuando usamos el paquete utl_http despachado con la base de datos). HTMLDB_APPLICATION.G_PROXY_SERVER PUBLIC_URL_PREFIX Es un atributo a nivel de aplicacin que identifica la URL para salir de modo logged a una vista pblica. Sintaxis de public_url_prefix Reference Type Bind variable PL/SQL Substitution string Syntax :PUBLIC_URL_PREFIX V('PUBLIC_URL_PREFIX') &PUBLIC_URL_PREFIX. -22-



Reference Type Template substitution

Syntax #PUBLIC_URL_PREFIX#

REQUEST Cada botn de la aplicacin setea el valor de REQUEST al nombre del botn al valor del atributo REQUEST asociado al botn. Esto permite procesar aceptaciones que referencian el nombre del botn cuando un usuario lo clickea. In la sintaxis f?p se puede setear request utilizando el cuarto parmetro. Referencias al valor de REQUEST Request es tpicamente referenciado durante el proceso de aceptacin (es decir, el proceso que ocurre cuando se enva una pgina del cliente al servidor). Sintaxis de Request Reference Type Bind variable Direct PL/SQL PL/SQL Substitution string Syntax :REQUEST HTMLDB_APPLICATION.G_REQUEST V('REQUEST') &REQUEST &REQUEST. (exact syntax match) Alcance y valor de REQUEST para pginas enviadas. Cuando se enva una pgina, se inicia un proceso de Aceptacin. Este proceso de aceptacin consiste de clculos, validaciones, subprocesos, y bifurcaciones. El valor de REQUEST est disponible durante cada fase del proceso de aceptacin. Una vez que la aplicacin bifurca a una pgina diferente se setea el valor de request a NULL. El valor de REQUEST es el nombre del botn que el usuario clikqueo, el nombre del tab elegido por el usuario. Por ejemplo, supngase que tiene un botn con el nombre de CHANGE, y una etiqueta Apply Change. Cuando el usuario clickquea el botn, el valor de REQUEST ser CHANGE. Referencias REQUEST utilizando condiciones. Es comn referenciar REQUEST en los condicionales. Por ejemplo, si se desea resetear la paginacin cuando el usuario hace clicks en Go a una pgina del report. Se puede resetear la paginacin al crear un proceso de aceptacin de pagina. El proceso de la pgina puede ser condicionado usando Request = Expression 1. Para crear un on-submit page process: 1. Mediante Condition, seleccionar el tipo de condicin Request = Expression1. 2. En Expression 1, ingresar GO. Uso de REQUEST al mostrar procesos. Se puede usar REQUEST para mostrar procesos cuando se navega a una pgina usando la sintaxis f?p. Por ejemplo: f?p=100:1:&SESSION.:GO -23-



Recuerde que el cuarto argumento en la sintaxis f?p es REQUEST. Este ejemplo dirige hacia la aplicacin 100, pgina 1 para la sesin actual, y setea el valor de REQUEST al valor GO. Cualquier proceso regin puede referenciar el valor de REQUEST utilizando mostrar proceso (Show processing). El siguiente es un ejemplo similar pero utilizando PL/SQL: IF V ('REQUEST') = 'GO' THEN htp.p('hello'); END IF; Notar que htp.p('hello') es un call a un pl/sql del paquete Web Toolkit para salida impresa del string especificado. Ver tambin: Oracle Database Application Developer's Guide - Fundamentals for information about developing Web applications with PL/SQL Oracle Database PL/SQL Packages and Types Reference for information about htp packages SQLERRM Es un templete de sustitucin solo disponible en la Region de mensajes de error de la aplicacin. #SQLERRM# SYSDATE_YYYYMMDD Representa la fecha actual sobre el servidor de base de datos, con el formato yyyymmdd. Se puede utilizar en lugar de invocar llamados a la funcin SYSDATE(). Sintaxis de sysdate_yyyymmddBind variable :SYSDATE_YYYYMMDD PL/SQL V('SYSDATE_YYYYMMDD') Direct PL/SQL HTMLDB_APPLICATION.G_SYSDATE (DATE DATATYPE)

Reference Type Bind variable Direct PL/SQL PL/SQL

Syntax :SYSDATE_YYYYMMDD HTMLDB_APPLICATION.G_SYSDATE (DATE DATATYPE) V('SYSDATE_YYYYMMDD')

WORKSPACE_IMAGES Utilice este string de sustitucin para referenciar imgenes importadas, Java Script, y hojas de conexin en cascada del estilo que son compartidas con muchas aplicaciones dentro de un workspace (o esquema de base de datos). Sintaxis de worksapce_images -24-



Reference Type Bind variable Direct PL/SQL PL/SQL Substitution string Template substitution

Syntax :WORKSPACE_IMAGES Not available V('WORKSPACE_IMAGES') &WORKSPACE_IMAGES. #WORKSPACE_IMAGES#

Ver: "APP_IMAGES" y "IMAGE_PREFIX"

Building an ApplicationAqu se describe como utilizar el generador de aplicaciones para construir una aplicacin y sus componentes. Incluye instrucciones para crear una aplicacin y agregar pginas como as tambin componentes (reports, grficos form) controles de pgina (botones, items, listas de valores ) y componentes compartidos (menus, lists, tabs). Topics: Nota de la traduccin: La traduccin avanz hasta Creating Buttons. Julio Valle

Creating an Application Adding Pages to an Application Creating Reports Creating Forms Creating Calendars Creating Charts Creating Buttons Creating Items Creating Lists of Values Using Shortcuts Incorporating JavaScript into an Application Creating Dependent Select Lists Creating a Help Page

Ver tambin:

"Using Application Builder" "Controlling Page Layout and User Interface" "Adding Navigation"

Creating an Application Una aplicacin es una coleccin de pginas las cuales comparten un estado de sesin comn y la autenticacin. Se puede crear una aplicacin utilizando el wizard. Se puede deletear una aplicacin desde la home page del builder. Topics:

About Creating an Application Using a Wizard About the Create Application Wizard -25-



About the Create Application from Spreadsheet Wizard About Demonstration Applications Deleting an Application

About Creating an Application Using a Wizard Cuando se hace click en CREATE en la home page, se propone: Create application Permite crear una consulta a partir de queries SQL de tablas de la base de datos.. Create Application from Spreadsheet. Permite crear una aplicacin basada en una hoja de clculo. Se puede subir pegar una hoja de clculos de datos para crear una tabla y luego agregar una interfase con el usuario. En la aplicacin resultante, los usuarios pueden crear consultas, eliminar insertar, actualizar registros analizar los datos. Ver tambin: "About the Create Application from Spreadsheet Wizard". Demonstration Application. Instala / Desinstala aplicaciones demo. Sirve para aprender a construir aplicaciones. Ver tambien "About Demonstration Applications". Ver tambin: "Adding Pages to an Application" for information about adding reports and forms by creating a new page. About the Create Application Wizard. El wizard permite crear una aplicacin funcional completa a partir de cualquier nmero de tablas. Se pueden crear pginas en blanco pginas basadas en queries SQL sobre tablas de la base de datos. Se puede crear consultas SQL escribiendo la select (manualmente) bien utilizando la interface grfica del Query Builder. Las aplicaciones basadas sobre tablas pueden consistir de un simple report, un form y un report, un form tabular. Cuando se crean pginas sobre tablas, se tiene la opcin de generar pginas de anlisis. Las pginas de anlisis extienden un report simple ( un reporto sobre un form) para incluir mltiples drill-down reports y grficos. Ver tambin: "Building Queries with Query Builder" Topics:

Creating an Application Based on Tables or Queries About Application Models and User Interface Defaults Leveraging Application Models and User Interface Defaults

Creating an Application Based on Tables or Queries Se puede crear una aplicacin basada sobre un tabla, query, drill-down query seleccionando Create Application en el Create Application Wizard. 1. Sobre la Home Page de la base de datos, click en Application Builder. 2. Click en el botn Create. 3. Seleccionar Create Application y click en Next. 4. Ingrese los detalles bsicos de la aplicacin y click en Next. a. Name. Ingrese un nombre que describa la aplicacin. b. Application. Ingrese un valor entero (nico) para identificar la aplicacin. c. Create Application. Seleccione un mtodo de creacin: o From scratch Permite agregar pginas manualmente. o Based on existing application design model Permite copiar definiciones de pginas desde modelos de aplicaciones anteriores.Notar que se debern definir todos los otros atributos de la aplicacin, se puede elegir copiar los mismos atributos utilizando la opcin copiar componentes

-26-



compartidos desde otra aplicacin. (Vase el punto 7 y "About Application Models and User Interface Defaults"

d. Schema La aplicacin obtendr su recursos a partir de todas las sql ejecutadas sobre un esquema de base de datos especfico. Identificar el propietario del esquema de base de datos. Next agrega la pgina a su aplicacin. 5. Under Add Pages. .a Seleccionar el tipo de pagina que se desea agregar. Incluye las opciones de: o Blank Crea una pgina sin agregar ninguna funcionalidad. o Report Crea una pgina que contiene el resultado de una consulta SQL formateado. Se puede elegir construir un report basado en una tabla que se selecciona basado en una sentencia SQL SELECT dada por el usuario por una funcin PL/SQL que retorna una sentencia SQL SELECT que se provee. o Form crea un form para actualizar un sola fila en una tabla de la base de datos. o Tabular Form Crea un form para ejecutar update, insert delete sobre mltiples filas de una tabla de la base de datos. o Report and Form Construye dos pginas combinando form y report. Sobre la primer pgina, el usuario selecciona una fila para actualizar. Sobre la segunda pgina el usuario puede agregar un nuevo registro actualizar borrar un reg. Existente. Action Displaya el tipo de pgina seleccionada. Por cada seleccin, el wizard propone diferentes tipos de informacin. Las pginas report incluyen un check box Include Analysis Pages. Seleccione esta opcin y siga los prompt del wizard para extender un simple report ( un report sobre un form) para incluir mltiples grficos y reports drill-down. .b Click Add Page. La pgina ( pginas) aparecen al tope de la pgina. Para borrar una pgina, click en el icono Delete. .c Repetir los puntos anteriores hasta que todas las pginas hallan sido agregadas. .d Click Next. 6. Determinar si se va a incluir los tabs en la aplicacin y click Next. 7. Determinar si se va a importar componentes compartidos con otra aplicacin. Los componentes compartidos son elementos comunes que pueden displayarse ser aplicados sobre una pgina dentro de una aplicacin. Para incluir componentes compartidos: a. Copy Share Componentes desde otra aplicacin, seleccione Yes b. Copy from Application, seleccione la aplicacin desde la cual quiere importar componentes compartidos. c. Select Componentes to Import, seleccione los componentes a importar. d. Next. 8. Seleccione las siguientes preferencias de autenticacin y globalizacin. a. Default Authentication Scheme Identifica un esquema de autenticacin que se desea usar por default. b. Language Selecciona el lenguaje primario para esta aplicacin. Este atributo identifica el lenguaje en el cual la aplicacin es desarrollada. Este lenguaje es el lenguaje base desde el cual todas las traducciones son hechas. c. Obtener la preferencia de lenguaje del usuario. Especifica como el motor determina el lenguaje de la aplicacin. El lenguaje primario de la aplicacin puede ser esttico (es decir, derivada del lenguaje del browser) determinada de una preferencia de usuario item. El lenguaje seteado en la base de datos determina el formato de display de la fecha y las caractersticas de ordenamiento. Se puede alterar los atributos de lenguaje y la forma de -27-



seleccionar el lenguaje ms tarde editar los atributos de globalizacin de la pgina. Para ello vase "Configuring Globalization Attributes". d. Click Next. 9. Seleccione un theme (contexto) y click Next. Los Themes (contextos) son colecciones de templeates que pueden ser usados para definir el layout y el estilo de una aplicacin completa. Vase "Managing Themes". 10. Confirmar las selecciones realizadas. Retornar a la pgina anterior del wizard, click en Previous. Aceptar las opciones realizadas y click en Finish. About Application Models and User Interface Defaults. (Modelos de aplicaciones y valores por default de la interface del usuario). El wizard para crear aplicaciones est diseado asumiendo que el desarrollador lo ejecutar mltiples veces. Para facilitar este mtodo interactivo para el desarrollo de aplicaciones, cada vez que se ejecuta el wizard guarda la definicin de la pgina como un modelo de aplicacin. Consideremos el siguiente ejemplo: Crear una nueva aplicacin ejecutando el wizard. Despus de ver la aplicacin, caemos en la cuenta que no es todo lo que se quera. En lugar de modificarla, se puede ejecutar el wizard nuevamente y seleccionar un modelo de aplicacin. Al seleccionar un modelo de aplicacin existente cuando se re-ejecuta el wizard, se puede rpidamente mejorar la aplicacin con mnimo tiempo y esfuerzo. Ver tambin: Managing Application Models" Otra forma de incrementar la productividad cuando creamos una aplicacin es especificando valores por default en la interface de usuario. Los valores por default en las interfaces son metadatos que permiten asignar valores por default a las propiedades de las tablas, columnas, listas dentro de un esquema especfico. Ver tambin: Managing User Interface Defaults" Leveraging Application Models and User Interface Defaults. (Mejorar modelos de aplicaciones e interfaces de usuarios) Se puede incrementar la productividad en el desarrollo de aplicaciones mejorando los modelos de aplicaciones y los valores por default de las interfaces de usuarios. Considere los siguientes escenarios: 1) Crear una aplicacin basada en tablas vistas ejecutando el wizard. 2) Ejecutar la aplicacin generada. Determinar las deficiencias funcionales. 3) Evaluar si crear editar las interfases del usuario. Por ejemplo, se pueden usar los valores por default en la interface del usuario para controlar los campos del formulario para displayar las etiquetas de los reports. Tambin se puede utilizar los valores por default (de la interface) para displayar columnas especficas o displayar determinadas columnas en orden alternativo. 4) Navegar a la home page de la aplicacin y crear una nueva aplicacin haciendo click en Create. 5) Seleccionar Create Application. 6) Cuando pregunta por los detalles de la aplicacin, especificar lo siguiente: a. Nombre-Ingrese el nombre que describe a la aplicacin. b. Application-Ingrese el id que identifica a la aplicacin ( acepte el valor por default que propone el wizard). c. Create Application-seleccione Based on existing application design model. 1) Seleccione un modelo de aplicacin. Note que las pginas que se crearon recin, ya aparecen para ser seleccionadas como modelos. 2) Agregue, edite remueva pginas. -28-



3) Complete el wizard. 4) Repetir los pasos 2 a 9 hasta que la aplicacin alcance los requerimientos funcionales. About the Create Application from Spreadsheet Wizard (Wizard para Creacin de aplicaciones desde hojas de clculos) Se pueden crear aplicaciones a partir de datos en hojas de clculos seleccionando Create Application from Spreadsheet en el wizard. Para crear una aplicacin desde una hoja de clculo: 1) 2) 3) 4) Desde Home Page, click en Application Builder. Click en el botn Create. Seleccionar Create Application from Spreadsheet. Especificar como sern importados los datos desde la hoja de clculos. Seleccione alguno de los siguientes y click Next: a. Upload file (comma-delimited tab-delimited). Especifique uno de los siguientes y click Next: i. File Click en Browse para localizar el archivo a ser importado. ii. Separator Especificar el carcter separador de columna. Utilizar \t para separadores tab. iii. Optionally Enclosed By Ingrese el carcter delimitador. Se puede usar este carcter delimitador para indicar el comienzo/fin de un dato. Si se especifica un carcter delimitador, el wizard ignora los espacios en blancos que aparecen antes del carcter de inicio y los que aparecen despus del carcter de fin, que delimitan el dato. Se puede tambin usar esta opcin para datos que estn delimitados por un carcter especfico. iv. File Character Set Seleccionar el conjunto de caracteres en el que est codificado el archivo de texto. b. Copy and Paste (hasta 30 kbytes). Copiar y pegar los datos de la hoja de clculo que se desea importar y hacer click en Next. 5) Revisar la vista previa para ver como ser displayada la tabla y hacer click en Next. Especificar el nombre de la tabla y sus columnas, modificar los tipos de datos, detallar que columnas incluir. 6) Revisar si se displayan nombres en singular y escrbalos en plural. La interface por default de las columnas displaya los nombres por default de las etiquetas. 7) (Opcional) Mediante la interface por default, edite las etiquetas a displayar y click Next. 8) Para los totales por columnas, seleccione las columnas para las cuales los datos deben ser sumarizados en el reporte y grficos y click en Next. 9) Este wizard crea varios totales por reports. Selecciones las columnas que se deben totalizar por report. a. Aggregate by Column Elija uno ms columnas para las cuales se quiere sumarizar o promediar. b. Aggregate Function to use Seleccionar las funciones de resumen (Sum Average). c. Click Next. 10) Seleccionar opciones a nivel de aplicacin: a. Application Name Ingrese un nombre alfanumrico para esta aplicacin. b. Especificar el modo de creacin: -29-



i. Read and Write incluye operaciones insert y update en las pginas. ii. Read Only no incluye insert y update. c. Seleccione el tipo de grfico. d. Click Next. 11) Seleccione un theme (contexto) y click Next. (Themes son colecciones de templetes que pueden ser utilizados para definir el estilo y layout de una aplicacin completa. Vase: "Managing Themes". 12) Confirmar opciones. Si desea ver pginas previas del wizard puede realizar click en Previous. Para aceptar todo y finalizar, click Create. About Demonstration Applications (Aplicaciones de demostracin). Oracle Application Express se instala con aplicaciones de demostracin. Utilice estas aplicaciones para comprender las funcionalidades que se pueden incluir en las aplicaciones. Ver tambin: "Running a Demonstration Application" Acceso a las aplicaciones demo Para acceder a las aplicaciones demo: 1) Desde la Home Page, click en Aplication builder. 2) Click en el botn Create. 3) Seleccionar Demonstration Application. Aparece la pgina de aplicaciones demo, displayando enlaces a las siguientes aplicaciones: a. Sample Application ofrece una demostracin que resalta conceptos bsicos de diseo. b. Collection Showcase muestra los conceptos del carrito de compras. c. Web Services sirve como ejemplo de cmo se puede utilizar servicios web. 4) Instalar una aplicacin demo, bajar hasta la aplicacin que se desea instalar, click Install. Aparecer el estado Installed. 5) Editar la aplicacin instalada haciendo click en Edit. 6) Ejecutarla con click Run 7) Para re-instalarla (a la aplic. Demo), click en Re-Install. Deleting an Application (Eliminacin de una aplicacin). Se puede eliminar una aplicacin desde adentro del Application Builder, o mientras se estn editando sus atributos. Si se deletea una aplicacin, se borran con ella todos los componentes definidos (reports, grficos, formularios), controles de pginas (botones, items, lista de valores), y tambin los componentes compartidos (breadcrumbs, listas, y tabs). No se eliminan los default para las interfases. Temas:

Deleting an Application from Application Builder Deleting an Application from Edit Application Attributes

Deleting an Application from Application Builder Para borrar una aplicacin desde Application Builder: 1) Desde la Home Page, click en el icono Application Builder. 2) Seleccionar una aplicacin. -30-



3) Cuando se muestre el Ap. Builder, verificar el ID de aplicacin y el nombre en la parte superior de la pgina. 4) Sobre la lista de tareas, click en Delete this Application. 5) Seguir las instrucciones que se dan en pantalla. Deleting an Application from Edit Application Attributes. Deletear una aplicacin desde la edicin de los atributos de aplicacin: 1) Desde la Home Page, App. Builder 2) Seleccionar la aplicacin. 3) Click en editar atributos. 4) Click en Edit Standard Attributes. 5) Verificar el ID de la aplicacin y su nombre. 6) Click en Delete al tope de la pgina. Vase : Configuring Standard Application Attributes"

-31-



Adding Pages to an Application. Se puede agregar una nueva pgina componente a una pgina existente, ejecutando el Create Page Wizard. Para acceder al mismo: o Click en Create Page en la home-page de la aplicacin. o Click en Create en la pagina de definicin. o Seleccionar sobre la barra de desarrollo el Create Link. Nota: Se puede agregar tambin un componente a una pgina existente (tal como un report, un grfico, un formulario, un wizard, un calendario, un tree) utilizando el Wizard Create Page. El wizard responde solicitando el ID de una pgina existente. Temas.

Creating a Page from Application Home Page Creating a Page from the Page Definition Creating a Page from the Developer Toolbar Running a Page or Application Grouping Pages Locking and Unlocking a Page Deleting a Page

Vase tambin: Creating Reports", "Creating Charts", "Creating Forms", "Creating Calendars", and "Creating Trees" Creating a Page from Application Home Page Para crear una nueva pgina desde el Application home page: 1) Desde el Database Home Page, click en Application Builder 2) Seleccionar una aplicacin. Aparecer la Application home Page de la misma. 3) Click Create Page 4) Seleccionar el tipo de pgina que se desea crear: a. Pgina en Blanco. b. Mltiples pginas en blanco. c. Reporte. d. Grfico. e. Formulario. f. Wizard. g. Calendario. h. Tree. i. Pgina de login. 5) Seguir las instrucciones dadas en pantalla. Createing a Page from the Page Definition Para crear una nueva pgina mientras se est viendo una Page definition: 1) Navegar a la correspondiente Page Definition. a. Navegar a la Database Home Page. b. Click en el cono Application Builder. c. Seleccionar una aplicacin. d. Seleccionar una pgina. Aparece la definicin de la pgina. 2) Desde la barra de navegacin (al tope de la pgina), click en el botn Create. 3) Seleccionar el tipo de pgina que se desea crear: a. New page. b. Region sobre esta pgina. c. Control de pgina sobre si misma. -32-



d. Control compartido. (Shared control) Table: Create Page Options Describe las opciones disponibles correspondientes al tipo de pgina seleccionado. Create Page Options New Page Available Selections Available page types:a. b. c. d. e. f. g. h. i.

Blank age Multiple blank pages Report Chart Form Wizard Calendar Tree Login Page

Region on this page

Regions function as containers for content. Available region types:j. k. l. m. n. o. p. q. r. s. t.

HTML Report Form Chart Breadcrumb PL/SQL Dynamic Content Tree URL Calendar Multiple HTML Help Text

Page control on this page Page controls:u. v. w. x. y. z.

Item Button Branch Computation Process Validation

Shared control

Shared component options:aa. bb. cc. dd. ee. ff.

Navigation Bar icon Parent tab Standard tab List of values List Breadcrumb

4) Continuar con las instrucciones de pantalla. -33-



Vase tambin: Editing a Page Definition Creating a Page from the Developer Toolbar Los usuarios que estn logueados a la Database Home Page utilizando una cuenta de usuario tienen acceso a la barra de desarrollo. La barra de desarrollo se displaya al final de cada pgina y ofrece una forma rpida de crear una nueva pgina. Para crear una nueva pgina desde la barra de desarrollo: 1) Sobre la barra de desarrollo, seleccionar Create. Aparecer el wizard del nuevo componente. 2) Seleccione el tipo de componente que se desea crear y click Next. Las opciones disponibles son: a. New Page b. Regin sobre esta Page. c. Page Control sobre esta Page. d. Shared control. Table: Create Page Options Describe las opciones disponible correspondientes al tipo de pgina seleccionado. 3) Continuar con las instrucciones dadas sobre la pantalla. Vase tambin: "Using the Developer Toolbar" Running a Page or Application. El motor del Application Express dinmicamente ejecuta y procesa pginas basadas sobre los datos alojados en las tablas de las bases de datos. Para ver un versin ejecutada de la aplicacin, se ejecuta submite la misma al motor del Application Express. Al crear nuevas pginas, se pueden ejecutar individualmente, ejecutar la aplicacin completa. Se puede ejecutar una aplicacin con click en el icono Run Application. Temas.

About the Run Application Icon Running an Application from the Application Builder Home Page Running an Application from the Application Home Page Running a Page from the Pages List on the Application Home Page Running a Page from the Page Definition

About the Run Application Icon El icono de ejecucin de una aplicacin se asemeja a la luz del semforo. Un gran icono colorido, Run Application, aparece sobre la home page de las aplicaciones.

Muchas pginas dentro del Application Builder tambin ofrecen una versin ms pequea de este icono. Click en este pequeo icono se ejecuta la aplicacin completa de pginas individuales dependiendo del contexto en que se invoca. Por ejemplo, si es desde la home page ejecuta la aplicacin completa, si es desde la Page Definition ejecuta solo la pgina en cuestin. -34-



Running an Application from the Application Builder Home Page Para ejecutar una aplicacin completa desde la home page del Builder: 1) Desde la home page de la base de datos, click en Application Builder. 2) Desde la lista de vistas (View), seleccionar Details y click en Go. 3) Localizar la aplicacin en la lista de aplicaciones. 4) Click en el icono Run que est en la columna ms a la derecha. Running an Application from the Application Home Page Para ejecutar una aplicacin completa desde la home page de la aplicacin: 1) Sobre la Home Page de la base de datos, click en Application Builder. Aparece la home page del builder. 2) Seleccionar una aplicacin. 3) Click en el icono Run. Running a Page from the Pages List on the Application Home Page Para ejecutar una pgina desde la lista de Pginas: 1) Desde la Home Page, click en el icono Application Builder. 2) Seleccionar una aplicacin. 3) Desde la lista View, seleccionar Details y click en Go. 4) Desde la lista Pages, localizar la pgina que se desea ejecutar y click en Run, de la columna que est ms a la derecha. Running a Page from the Page Definition Para ejecutar una pgina especfica de la Page Definition: 1) Desde la Database Home Page, clic en Application Builder. 2) Seleccionar la aplicacin. 3) Seleccionar la pgina. Aparece directamente la page definition. 4) Clic en Run Page en el extremo superior derecho de la pgina. Grouping Pages Utilice grupo de pginas y gestione las pginas dentro de una aplicacin. Para utilizar grupo de pginas, se debe crear un grupo y luego asignar las pginas al grupo. Los grupos de pgina no tienen otra funcin especial que no sea organizar las pginas de una aplicacin. Se puede organizar fcilmente las pginas, por grupos, dentro de la aplicacin. Temas:

Viewing the Page Group Report Creating a Page Group Assigning Pages to a Page Group

Viewing Page Groups from the Application Home Page Para ver el grupo de pginas desde la home page de la aplicacin: 1) Desde la Database Home Page, clic en Application Builder. 2) Seleccionar la aplicacin. 3) Desde la lista de tareas del lado derecho de la pgina, clic en Manage Page Groups 4) Desde la lista de tareas, clic en Report Page Groups. Viewing Page Groups from the Page Definition Para ver un grupo de pginas desde la Page Definition. 1) Desde la Database home page, clic en el icono Application Builder. 2) Seleccionar una aplicacin. -35-



3) Seleccionar una pgina. Aparece la definicin de la pgina. 4) Desde la View list, seleccionar Groups. Creating a Page Group Para crear un grupo de pginas: 1) Desde la Database Home Page, click en Application Builder. 2) Seleccionar una aplicacin. 3) Desde la lista de tareas, sobre el lado derecho de la pgina, click en Manage Page Groups. 4) Desde la page group click en Create. 5) Ingresar el nombre, una descripcin, y click en Create. Assigning Pages to a Page Group Para asignar una pgina a un grupo: 1) Desde la Database Home Page, click en Application Builder. 2) Seleccionar una aplicacin. 3) Desde la lista de tareas, sobre el lado derecho de la pgina, click en Manage Page Groups. 4) Sobre la lista de tareas, click en Report Unassigned Pages. Aparecern las pginas no asignadas a grupos. 5) Desde Page Group, seleccionar el grupo al cual se quiere asignar las pginas. 6) Seleccionar las pginas que deben ser asignadas. 7) Click en Assigned Checked. Si se selecciona el id de pgina se enlaza a la pgina de atributos. Si se selecciona el nombre de la pgina enlaza a la definicin de pgina. Locking and Undlocking a Page Se pueden prevenir conflictos durante el desarrollo de la aplicacin impidiendo el acceso a pginas de la aplicacin. Mediante el loocking de una pgina, se previene que otros desarrolladores puedan editarla. Temas.

Determining If a Page Is Locked Locking a Page Unlocking Pages Accessing Alternative Locked Pages Views

Determining if a page est locked. Se indica que la pgina (actual) est lockeada mediante un icono. Si la pgina esta deslockeada, el icono aparece abierto, sino aparece cerrado. El icono de estado del lockeo aparece en las siguientes pginas: o Application home page. Seleccione Details desde la lista Display. Aparece una lista de pginas. El icono de lock aparece debajo de la columna Lock. o Page Definition. El icono lock aparece en el extremo derecho del men de la pgina. Locking a Page Se puede lockear una pgina de la aplicacin: 1) Desde la Database Home Page, click en Application Builder. 2) Seleccionar una aplicacin. 3) Sobre la lista de tareas a la derecha de la pgina, click en Manage Page Locks. 4) Seleccione la pgina apropiada y click en Lock Checked. 5) Ingrese un comentario en el campo de comentarios. 6) Click en Lock Page. -36-



Locking a Page from the Pages List Para lockear una pgina desde la Lista de Pginas: 1) Desde la Database Home Page, click sobre App.Builder. 2) Seleccionar una aplicacin.. 3) Desde la lista View, seleccionar Details y click en Go. 4) En la lista de pginas, localizar la pgina deseada y click en el icono Lock. 5) Ingresar un comentario. 6) Click en Lock Pages. Locking a Page from the Page Definition. Para lockear una pgina desde la pgina de definicin de la aplicacin: 1) Navegar a la pgina de definicin de la aplicacin. 2) Click en el icono Lock, en la esquina superior derecha, encima de Shared Components. 3) Seleccionar las pginas deseadas y click en Lock Checked. 4) Ingresar un comentario. 5) Click en Lock Pages. Unlocking Pages Solo el desarrollador que lockeo una pgina puede deslockearla. Sin embargo, un desarrollador con privilegios administrativos puede deslockear pginas lockeadas por otros desarrolladores. Los pasos para deslockear pginas es similar que para el lockeo descrito ms arriba. Accessing Alternative Locked Pages Views. Se puede acceder un cierto nmero de diferentes vistas de pginas lockeadas. Para ello: 1) Desde la Database Home Page, click en app.builder. 2) Seleccionar una aplicacin. 3) Desde la lista de tareas, a la derecha de la pg., click en Manage Page Locks. 4) Desde la lista de tareas, click en uno de los siguientes: a. Show Locked Pages: Lo cual displaya solo pginas lockeadas dentro de la actual aplicacin. b. Show all pages.: Displaya todas las pginas de la aplicacin. c. Show Unlocked Pages: Displaya solo las pginas desloqueadas de la actual aplicacin. d. Administer Locks: Permite a un administrador deslokear cualquier pgina lockeada por un desarrollador. Deleting a Page Se puede deletear una pgina desde la Page Definition mientras se estn editando los atributos de la pginas. Deleting a Page from the Page Definition. Para deletear una pgina desde la Page Definition hacerlo desde la barra de navegacin al tope de dicha pgina, con un click en Delete. Deleting a Page while editing page attributes. Para deletear una pgina mientras se editan los atributos de pginas, en la page definition, click en Edit Attributes, Click en edit Standard Attributes y click en Delete. -37-



Creating Reports En Oracle Application Express, un reporte es el resultado de una consulta Sql query formateada. Se pueden generar reportes mediante la seleccin y ejecucin del constructor de consultas, mediante la definicin de una regin en el reporte basada en una consulta sql. Temas.

Creating a Report Using a Wizard Editing Report Attributes Controlling Report Pagination Enabling Column Sorting Adding a CSV Link to a Report Exporting a Report as an XML File or a CSV File Creating a Column Link Defining an Updatable Column Defining a Column as a List of Values Controlling When Columns Display Controlling Column Breaks

Creating a Report Using a Wizard Application Builder incluye un cierto nmero de wizards para construir reportes. Para crear un reporte utilizando un wizard: 1) Desde la Database Home Page, click en App. Builder. 2) Seleccionar la aplicacin. 3) Click en Create Page. 4) Seleccionar Report 5) Seleccionar uno de los siguientes tipos de report: a. Wizard Report : No requiere conocimientos sobre SQL. Selecciona el esquema, tabla, columna y resultados a mostrar. b. SQL Report : Crea un reporte basado sobre una sentencia Sql Select una funcin Pl/sql que retorna una sentencia sql select. 6) Continuar con las instrucciones de pantalla. Editing Report Attributes Se pueden utilizar los atributos del report y de las columnas de las pginas para controlar precisamente la definicin de la pgina del report. Por ejemplo se pueden usar estos atributos para alterar los encabezamientos de columna, la posicin, si es oculta, bien para crear una columna que es una suma para seleccionar la secuencia de ordenamiento. Desde la Page Definition, se puede acceder a los atributos de la pgina report con un click en Report RPT, adyacente a la region report que tu quieres editar. Report indica al reporte que es un report regular y RPT indica que es generado por wizard. Se puede navegar tambin a los atributos del report (a la pgina de atributos) haciendo click en el nombre de la regin y luego seleccionando el tab Report Attributes. Para acceder a la pgina de atributos del report: 1) Desde la Database Home Page, click en Application Builder. 2) Seleccionar la aplicacin. 3) Seleccionar la pgina. Aparece la pgina de definicin. 4) Debajo de la Regions, hacer click en Report cerca del nombre de la regin que se desea editar. Con lo cual aparece la pagina de Atributos del Report.

-38-



El tipo de encabezamiento identifica como fue generado el encabezamiento del report. Utilice la seccin de atributos de columna para controlar la apariencia y funcionalidad de cada columna. El link de cada columna indica si una columna tiene actualmente definido un enlace. El Edit de cada columna indica si es o no updateable una columna. Table: Common Report Column Edits Describe las ediciones ms comunes para las columnas de los reportes. Descripcin Modificar la secuencia de ordenacin de una columna Modificar alineacin del encabezamiento Modificar el encabezamiento de la columna Control sobre las columnas a displayar. Habilitar una nica secuencia de ordenacin. Habilitar una columna de totales Accin a desarrollar. Click sobre las flechas arriba / abajo. Under Column Alignment, seleccionar una nueva alineacin de columna. Under Heading, ingrese el nuevo texto que corresponde a la columna. Click en Show para indicar que una columna debe ser displayada. Click en Sort y seleccionar un numero de secuencia desde Sort Sequence. Se debe elegir al menos una columna de ordenacin (pueden ser varias). Click en Sum para habilitar la suma de la columna.

Se puede adems refinar los atributos especficos de una columna. 5) Para acceder a los atributos de la columna, click en el icono Edit adyacente al alias de la columna. Ver tambin la ayuda on line para ms informacin sobre un atributo especfico de la columna. Controlling Report Pagination Se puede controlar la paginacin del reporte mediante: o Inclusin del string de sustitucin de paginacin en el template del report. o Hacer la seleccin, del atributo Layout y Paginacin, desde los atributos del report. -39-



Se puede controlar como mostrar la paginacin seleccionando desde el atributo Layout y Paginacin. Para acceder a esta seccin: 1) Crear un reporte. 2) Debajo de la Regions, click sobre el enlace de atributo (Report RPT). Con lo cual aparecer la pgina de atributos del report. 3) Bajar con scroll down hasta Layout y Paginacin. Se usan los atributos de Layout y Paginacin para seleccionar el estilo de paginacin, determinar donde se displaya la paginacin y especifica el nmero de filas que displayar sobre cada pgina. La tabla siguiente describe los atributos ms comunes utilizados en Table: Layout and Pagination Attributes Atributo Report Templeate Pagination Scheme Display Possition Number of Rows Strip HTML Descripcin Especifica el template que se aplicar a este report. Los template (de reportes) proveen control sobre la salida de los resultados de una consulta sql. Se pueden seleccionar desde algunos template por default seleccionar un templete customizado. Especifica el esquema de paginacin para este reporte. Provee al usuario informacin sobre el nmero de filas y posicin dentro del conjunto resultante. Tambin define el estilo de los enlaces botones usados para navegar a la pgina siguiente y previa. Define donde se displaya la paginacin. Si se elige displayar la paginacin sobre el reporte, se requiere que el template, del reporte, soporte el tipo de display. Define el nmero mximo de filas a displayar por cada pgina. Especifica si se remueve, no, los tags HTML desde las columnas que tengan expresiones HTML y columnas con links. Si se seleccionan datos de la base de datos que contienen tags HTML, pueden causar conflictos con el HTML generado por los enlaces de columnas con las expresiones HTML. Cuando esta opcin esta habilitada, solo se utiliza la porcin de datos de la columna como valor ( no se utiliza el enlace ).

Including Pagination After the Rows in a Report Para incluir paginacin despus de las filas en un reporte. 1) Crear un reporte. 2) Navegar a la pgina de atributos del reporte. 3) En Layout and Pagination, seleccionar lo siguiente: a. Report Template Selecciona un templete de reporte (opcional). b. Pagination Scheme Selecciona un esquema de paginacin. c. Display Position Selecciona una posicin. d. Number of Rows Selecciona cuantas filas mostrar en cada pgina. e. Click en Apply Changes. 4) Editar el templete del reporte: a. Navegar a la definicin de pgina del reporte. b. En templates, seleccionar el nombre del template. c. Incluir el string de sustitucin #PAGINATION# en el atributo After Rows. d. Click en Apply Changes. 5) Ejecutar la pgina. Including Pagination Before the Rows in a Report Para incluir paginacin antes de las filas en un reporte: -40-



1) Crear un reporte. 2) Navegar a la pgina de atributos del reporte. 3) En Layout and Pagination, seleccionar lo siguiente: a. Report Template Selecciona un templete de reporte (opcional). b. Pagination Scheme Selecciona un esquema de paginacin. c. Display Position Selecciona una posicin que contiene el word top. d. Number of Rows Selecciona cuantas filas mostrar en cada pgina. e. Click en Apply Changes. 4) Editar el templete del reporte: f. Navegar a la definicin de pgina del reporte. g. En templates, seleccionar el nombre del template. h. Incluir el string de sustitucin #TOP_PAGINATION# en el atributo Before Rows. i. Click en Apply Changes. 5) Ejecutar la pgina. Enabling Column Sorting (ordenar por columna) Para habilitar la ordenacin por columna: 1) Navegar a la pgina de atributos del report. "Editing Report Attributes". 2) En los atributos de columna, seleccionar el check box de Sort adyacente a cada columna por la cual se desea ordenar. 3) Desde Sort Sequence (secuencia de ordenacin), seleccionar un nmero de secuencia. Sort Sequence es opcional. Sin embargo, si se ordena por una o ms columnas, al menos una de las columnas necesita tener definido el Sort Sequence. 4) Hace scroll hacia abajo a Sorting. 5) Especificar si es orden ascendente descendente click en set defaults. Adding a CSV Link to a Report ( Agregar enlace para exportar el reporte ) Se puede crear un enlace, dentro del reporte, que permita al usuario final, exportar el reporte generado a un archivo con formato delimitado por comas (.csv). Para agregar dicho tipo de enlace es necesario habilitar la opcin de salida CSV (CSV output option). Cuando se usa la opcin de salida CSV, el template del reporte no tiene trascendencia (ya que no sirve para formatear un archivo delimitado por comas). Se puede incluir un enlace CSV con cualquier