Curso Oracle Reports 9i

Capacitacin Empresarial
Manual Oracle Reports 9i

P P G GI IN NA A 1 1 D DE E 6 61 1 G GR RU UP PO O A AR RG GO OG G Y Y A AS SO OC CI IA AD DO OS S S S. .A A. . D DE E C C. .V V. .
T TE EC CN NO OL LO OG G A A E EN N S SI IS ST TE EM MA AS S A AD DM MI IN NI IS ST TR RA AT TI IV VO OS S

INTRODUCCIN

Reports

Oracle Internet Developer Suite 9i es una herramienta de Oracle que consta de Forms
9i, Reports 9i entro otros.

Reports 9i es parte de Oracle Internet Developer Suite 9i y parte fundamental de
Oracle Ver. 9i. Tiene como objetivo principal explotar, y visualizar la informacin
contenida dentro de una Base de Datos.

Oracle Reports 9i es una herramienta de elaboracin de informes de alta funcionalidad
que genera una salida lista para imprimir utilizando fuentes de datos tales como la
base de datos de Oracle. Se pueden incrustar grficos, sonidos, vdeo y una amplia
variedad de ayuda visuales en salidas por pantalla y en papel.

Oracle Reports 9i puede disear tiles y sofisticados formatos de salida con la ayuda
de estructuras de ordenes de SQL, para genera resultados deseados en muy poco
tiempo.

Los Componentes bsicos del Oracle Reports 9i son su Data Model, Web Layout,
Paper Layout, Parameter Form y Triggers Tambin pueden tener unidades de
programas y bibliotecas asociadas.

Consideraciones de hardware y software

Se debe tomar en cuenta que para poder tener un mejor rendimiento en cuanto al
funcionamiento de Reports 9i el siguiente hardware

Memoria RAM de 256 MB
Capacidad de disco duro de 300 MB (mnimo)
Procesador Pentium III o superior.



Por parte del software:

Tener instalado Oracle Internet Developer Suite 9i, en la maquina local o
bien, tener acceso a un servidor
Tener instalado SQL PLUS en la maquina local o bien, tener acceso a un
servidor
Contar con Windows 2000 o una versin posterior

DISEO Y EJECUCIN DE UN REPORTE

Recuperacin de datos

Reports es una herramienta que nos permite mostrar los datos de una Base de Datos,
para esto, se deben seguir los siguientes pasos;

Entrar a Reports Builder (ya sea por men o por un acceso directo creado)

Abrir el reporte tomando en cuenta su nombre fsico, esto en la opcin del
men principal File/Open, nos mostrar una caja de dialogo donde
seleccionaremos nuestro archivo

Conectarnos a la Base de Datos por medio de un Login, un Password y el
nombre de la Base de Datos.

La recuperacin de datos puede ser de distintas formas como se vera mas adelante.

Ejecucin de un reporte

Una vez abierto nuestro reporte, podemos correr el mismo, seleccionando la opcin
del men principal Program/Run Web layout o Run Paper Layout o por medio de
CTRL+R o SHIFT+CTRL+R respectivamente, otro medio es por los iconos que se
encuentran en la extrema izquierda de la pantalla mostrada



Destinos de un Reporte

Los destinos de un reporte nos indican hacia donde vamos a mandar los datos cuando
termine la generacin del reporte, son los siguientes:

Screen (La generacin del reporte nos la muestra en pantalla)

File (La generacin del reporte nos la salva en un archivo, se explica mas
adelante)

Printer (La generacin del reporte la dirige hacia la Impresora)

Mail (La generacin del reporte se enva a un identificador de correo del
sistema, se deber tener un driver instalado)

Preview (Nos muestra el resultado previo de la generacin del reporte)

Se considera conveniente explicar, como se podr visualizar en tiempo de ejecucin
(al tiempo de correr el reporte) la pantalla de dialogo que hace posible estas opciones.

Como primer paso, se deber entrar y realizar doble clic en el icono de Parameter
Form del Object Navigator, entonces aparecera una ventana en blanco como la que
se muestra a continuacin.



Como segundo paso, dar clic en el botn con la etiqueta Field, y arrastrar el cursor
hasta la parte de diseo y dibujar un rectngulo, que esta seria nuestro contenedor del
campo.

Como tercer paso, se debe oprimir el botn derecho del mouse para que nos
muestre las propiedades del campo creado y seleccionaremos la opcin Parameter
Form Builder.

Y entonces desplegara una pantalla como la siguiente:



Como cuarto paso, teclearemos un clic en el nombre DESTYPE (de modo que este
sombreado) y despus OK.

Enseguida aparecer otra ventana de dialogo teclear Yes.

Repetir desde el segundo paso hasta el cuarto paso para los nombres de
DESNAME y DESFORMAT.

File .- El resultado del reporte lo graba en un nombre de archivo especificado. Para
poder llevar a cabo correctamente esta opcin, se deber dar doble clic en la
opcin de Parameter Form del Object Navigator y posicionarse en el campo
con la etiqueta Destination Format y dar doble clic con el botn izquierdo del
mouse para que nos muestre las propiedades de dicho campo. Nos debern
aparecer unas pantallas como las siguientes:



NOTA: Obsrvese que la propiedad del campo con nombre Initial Value, tiene
asignado el valor dflt. Esto es opcional y se puede teclear en la pantalla de
parmetros en la opcin de DESFORMAT y es con el fin de que nos permita grabar y
visualizar nuestro archivo en MS WORD. Para poder efectuar lo anteriormente dicho
se debe de abrir primeramente MS WORD una vez abierto, se seleccionara desde MS
WORD nuestro archivo a editar.



Presentacin preliminar de un reporte

Al momento que se ejecuta un reporte, y se ha especificado que deseamos
visualizarlo en pantalla, el resultado ser:

En esta pantalla podemos realizar actividades como formateo de campos, ajuste de
columnas, incorporar elementos visuales, etc.



CREACIN DE UN REPORTE BSICO

La generacin de reportes se puede realizar dentro de Oracle Reports 9i de dos
formas:

o Por medio del Wizard
o De forma Manual

Acceso a Designer (Reports Builder).

El acceso al Designer (Reports Builder) a travs del Wizard para la generacin de un
reporte, se realiza de la siguiente manera:

1. Elegir la opcin del men principal File/New/Report o bien tecleando CTRL+N.

2. Elegir la opcin Use the Report Wizard despus, la oprima el botn OK.

3. Oprimir el botn NEXT.

4. Seleccionar Create Paper Report Layout only

5. Oprimir el botn NEXT

6. Especificar el titulo del Reporte, en este caso: REPORTE EJEMPLO

7. Seleccionar la opcin marcada por default (Tabular) y presionar el botn NEXT.

8. Seleccionar el Data Source por default (SQL Quero) y presionar el botn NEXT

9. Presionar el botn Query Builder.



10. Aceptar la tabla deseada y presionar el botn Include, despus presionar el
botn Close.

11. Nos mostrara la descripcin de la tabla seleccionada, y marcaremos los campos
que se deseen mostrar en el reporte. Esto dando un clic con el botn derecho
del mouse sobre el cuadro que aparece a la extrema izquierda, cuando se
termine la seleccin de dichos campos teclearemos el botn OK.

12. Nos mostrara el query elaborado para dicha consulta. Despus teclee el oprima
el botn Next

13. Se mostrarn los campos seleccionados por usted, estos se debern pasar
regresar (seleccionndolos con el mouse de modo que estn sombreados)
segn sea el caso, hacia la otra ventana que tiene el titulo de Displayed Fields
por medio de los cuatro botones que se encuentran entre ambas pantallas. Una
vez terminada la seleccin de los campos oprimir el botn Next

14. Si desea crear funciones para su reporte tales como sumatorias, conteo de
registros etc., marque el campo que desea afectar y oprima el botn de la
funcin. Como ejemplo el botn Count , despus digitar el botn Next

15. Si requiere cambiar los ttulos de los campos su longitud en esta pantalla
podr efectuarlo, despus oprimir el botn Next>

16. Elija el tipo de template que requiere para su reporte, las cuales son,
predeterminado por Oracle Reports 9i, si tiene usted creado un template y
desea anexarlo y trabajar sin template.

17. Oprimir el botn Finish.


P P G GI IN NA A 1 10 0 D DE E 6 61 1 G GR RU UP PO O A AR RG GO OG G Y Y A AS SO OC CI IA AD DO OS S S S. .A A. . D DE E C C. .V V. .

Navegador.

El navegador de objetos de Oracle Reports 9i es la ventana principal que nos aparece, en
este navegador, nosotros tenemos visibles los accesos a todos los componentes que
conforman un reporte. El navegador de objetos se ilustra a continuacin:



Ventanas de Designer (Reports Builder)

Las principales ventanas de Designer (Reports Builder) son:

Data Model
Web Source
Paper Layout
Parameter Form

Para acceder a cada una ellas, solo basta con realizar doble clic sobre el icono de cada
una de ellas, que aparece sobre el Object Navigator de Reports 9i.

Creacin de una consulta en el modelo de datos.

El Data Model esta compuesto de los siguientes Objetos

Queries

Groups

Colums

Parameter

Links

Queries es el lenguaje estndar del Ansi-standard SQL Select

Groups: Un grupo determina la jerarqua de los datos que aparecen en el reporte, son
utilizados para crear los breaks o cortes en un reporte, Oracle Reports
automticamente crea un grupo para cada query. Por ejemplo si tu query es la
seleccin del nmero del departamento y el nombre del empleado, Oracle Reports
crea un grupo que contiene ambas columnas. Para crear un nuevo grupo y asignarlo
al nmero del departamento, esto creara un corte el cual agrupar el empleado por
nmero de departamento, como se ve en la pantalla siguiente.



Columns: Oracle Reports tiene una herramienta para crear una nueva columna, las
cuales tiene la funcin de hacer sumatorias de un determinado campo del cual
podemos obtener el conteo de registros, el promedio, la desviacin estndar, etc.
Parmetros: Los parmetros son variables a las que se puede hacer referencia desde
el cdigo de PL/SQL y cualquier otra cosa que acepte valores de datos como entrada.

Links: son utilizados para establecer las ligas entre una relacin de Padre-Hijo y para
ligar los grupos que formarn el reporte Matricial.

Para poder crear un reporte utilizando la consulta dentro del Data Model es necesario
realizar los siguientes pasos:

1. Elegir la opcin del men principal File/New/Report o bien tecleando CTRL+N.

2. Elegir la opcin Build a new report manually despus, la oprima el botn OK.

3. No presentar una pantalla (DATA MODEL), dentro de la cual se debe oprimir el botn
SQL

Y dibujar con el mouse en el editor de diseo un cuadrado o bien, un rectngulo.

4. Realizar la creacin del query manualmente , en su defecto oprimiendo el botn Query
Builder (explicado en lneas anteriores), digitar el botn OK.



5. Si se da doble click con el mouse sobre el objeto de nombre Q_1, desplegara el query
elaborado por usted. As tambin nos muestra los campos que contiene nuestro query
que son parte del grupo G_XXXXXXXXXX.

6. Una vez creado nuestro query se proceder a la creacin del Layout model, que viene
siendo nuestro esquema donde se reflejan nuestros datos de salida del reporte. Para
esto se oprimir el botn que se localiza en el men de la parte superior de nuestro
diseador

7. Damos clic en YES

8. Seleccionar Paper Layout only, y presionamos el botn de NEXT

9. Seleccionar la opcin marcada por default (Tabular) y presionar el botn NEXT

10. Seleccionar la pestaa de nombre Fields. Se mostrarn los campos seleccionados por
usted, estos se debern pasar regresar (seleccionndolos con el mouse de modo que
estn sombreados) segn sea el caso, hacia la otra ventana que tiene el titulo de
Displayed Fields por medio de los cuatro botones que se encuentran entre ambas
pantallas. Una vez terminada la seleccin de los campos oprimir el botn Next>

11. Si desea crear funciones para su reporte tales como sumatorias, conteo de registros etc.,
marque el campo que desea afectar y oprima el botn de la funcin. Como ejemplo el
botn Count> , despus digitar el botn Next>



12. Si requiere cambiar los ttulos de los campos su longitud en esta pantalla podr
efectuarlo, despus oprimir el botn Next>

13. Elija el tipo de template que requiere para su reporte, las cuales son, predeterminado por
Oracle Reports 9i, si tiene usted creado un template y desea anexarlo y trabajar sin
template.

14. Oprimir el botn Finish.

PROPIEDADES DE UN REPORTE

Unit of measurement.- es la unidad de medida standard usada para especificar la
dimensin del reporte y los parmetros de la forma y son Pulgadas, centmetros y puntos.

Max. Horizontal Body Pages .- es el numero mximo de paginas Horizontales que se
desean aparezcan en el cuerpo del reporte.

Max. Vertical Body Pages.- es el numero mximo de paginas Horizontales que se desean
aparezcan en el cuerpo del reporte.

Panel Print Order.- Es el orden en el cual las paginas fsicas estn arregladas en una pagina
lgica, tambin determina el orden en el cual los paneles son numerados con la pagina lgica

Direction.- Es la orientacin la cual se imprimir el reporte. Y sus valores son de derecha a
izquierda y de izquierda a derecha.

Prewiewer Title .- Es el texto del titulo que aparecer en la parte superior del reporte.

Role Name.- Especifica la Base de Datos que el reporte utilizara al tiempo de RunTime. Se
necesita teclear un usuario, un password y una Base de Datos.

Distribution.- Usa los valores especificados en el caja de dialogo para definir la distribucin
completa del reporte.


Width.- Es el ancho de la pgina del reporte en la pantalla de Parameter Form.

Height.- Es la altitud o alto de la pgina del reporte en la pantalla de Parameter Form.

Number of Pages.- Es el numero total de paginas que desea ver en RunTime en la pantalla
de Parameter Form.

Before Report Type.- Con esta propiedad si es activada servir para ver al final de
documento la salida del mismo, para formato HTML que ser visto en un Web browser. Sus
valores son TEXT y FILE. Para definir un atributo usando PL/SQL usar
SRW.SET_BEFORE_REPORT_HTML

Before Report Value.- Con esta propiedad si es activada servir para ver al final de
valores son cualquier archivo o cadena de caracteres que contengan sentencias en HTML,
se deber especificar antes un After Report Type. Para definir un atributo usando PL/SQL
usar
SRW.SET_BEFORE_REPORT_HTML

After Report Type .- Con esta propiedad si es activada servir para ver al final de

SRW.SET_AFTER_REPORT_HTML

After Report Value .- Con esta propiedad si es activada servir para ver al final de
valores son cualquier archivo o cadena de caracteres que contengan sentencias en HTML,
se deber especificar antes un After Report Type. Para definir un atributo usando PL/SQL
usar
SRW.SET_AFTER_REPORT_HTML

Before Page Type .- Especifica el tipo de encabezado que aparecer al inicio de cada
pagina de tu documento, cuando el archivo es en formato HTML el reporte es visto en un
Web Browser. Sus valores son TEXT y FILE. Para definir un atributo usando PL/SQL usar

SRW.SET_BEFORE_PAGE_HTML


Before Page Value.- Especifica el tipo de encabezado que aparecer al inicio de cada
pagina de tu documento, cuando el archivo es en formato HTML el reporte es visto en un
Web Browser. Sus valores son cualquier nombre de archivo que contenga sentencias en
HTML, dependiendo si t especificaste Before Page Type. Para definir un atributo usando
PL/SQL usar
SRW.SET_BEFORE_PAGE_HTML

After Page Type.- Especifica el tipo de pie de pagina que aparecer al final de cada pagina
de tu documento, cuando la salida del reportees en HTML se vera en un Web Browser, sus

SRW.SET_AFTER_PAGE_HTML

After Page Value.- Especifica el pie de pagina hasta el fin de cada pagina de tu documento,
cuando salida del reporte sea en HTML ser visto por medio de un Web Browser, Sus
valores son cualquier archivo o cadena de caracteres que contengan sentencias en HTML
dependiendo si tu especificaste After Page Type. Para definir un atributo usando PL/SQL
usar
SRW.SET_AFTER_PAGE_HTML

Before Form Type.- Especifica el tipo de encabezado que aparecer al inicio de Parameter
Form al tiempo de RunTime, cuando la salida del reporte sea en HTML ser visto en un Web
Browser. Para definir un atributo usando PL/SQL usar SRW.SET_BEFORE_FORM_HTML.

Before Form Value.- Especifica el encabezado que aparecer al inicio del reporte en runtime
en la pantalla de Parameter Form, si la salida es en HTML ser visto por medio de Web
Browser. Sus valores son cualquier archivo o cadena de caracteres que contengan
sentencias en HTML, dependiendo si se especifico Before Form Type, HTML dependiendo si
t especificaste Before Form Type. Para definir un atributo usando PL/SQL usar
SRW.SET_BEFORE_FORM_HTML.

After Form Type.- Especifica el tipo de pie de pagina que aparecer al final de la corrida del
reporte en la pantalla Parameter Form, si la salida es en un archivo HTML ser visto en un
Web Browser. Sus valores son TEXT y FILE. Para definir un atributo usando PL/SQL usar
SRW.SET_AFTER_FORM_HTML.



After Form Value.- Especifica el pie de pagina que aparecer al final de la corrida del
reporte en tu Parameter Form, Sus valores son cualquier archivo o cadena de caracteres que
contengan sentencias en HTML dependiendo si tu especificaste After Page Type. Para definir
un atributo usando PL/SQL usar SRW.SET_AFTER_FORM_HTML.

Page Navigation Control Type .- Especifica como el cdigo ser definido para la
navegacin de los botones en HTML, sus valores son, FILE que es cualquier archivo de texto
conteniendo cdigo en HTML para la pagina de navegacin de los controles y TEXT que es
cualquier cdigo de texto contenido en HTML para la pagina de navegacin de los controles.
Para definir un atributo usando PL/SQL usar SRW.SET_PAGE_NAVIGATION_HTML.

Page Navigation Control Value.- Especifica el nombre del archivo o el cdigo para la
navegacin de los controles en HTML. Los valores son cualquier nombre de archivo o cdigo
que contenga sentencias HTML dependiendo si especificaste Page Navigation Control Type.
Si se elige trabajar con un cdigo propio para la navegacin de controles se deber incluir
dos variable al cdigo que son: &TotalPages y &File_Name. Para definir un atributo usando
PL/SQL usar SRW.SET_PAGE_NAVIGATION_HTML.

XML Tag Property: Especifica el nombre del elemento del reporte actualmente
seleccionado, grupo o columna.

XML Tag Attributes: Especifica los atributos de XML. El propsito de agregar un atributo a
un objeto es para describir el valor de ese Tag.

XML Prolog Type: Especifica si el prolog es provisto como texto o dentro de un archivo de
texto generado por Reports Builder

XML Prolog Value: Es el valor de XML para el prolog que deber aparecer al principio de
cualquier bien formada salida de XML


ALMACENAMIENTO DE UN MODULO Y OPCIONES DE SEGURIDAD

Para almacenar o guardar un reporte, ya sea, que este sufri modificaciones o que se
construyo como nuevo las opciones para salvar dicho reporte se hacen por medio del men
principal File/Save, por medio de CTRL+S o en su defecto por el icono.

Para guardar nuestro archivo con otro nombre renombrarlo podemos emplear la opcin del
men principal File/Save As... por medio de MAYUS+CTRL+S.

Para abrir un reporte existente se emplea la opcin del men principal File/Open, por medio
de CTRL+O o por medio del icono

Una manera muy rpida de controlar la seguridad en tiempo de ejecucin, se puede realizar
a travs del comando RWCLIENT, especficamente usando la modalidad: audit. Bajo la
siguiente sintaxis: audit.=username/password. Este usuario y password son usados para
autenticar a los usuarios en un Servidor de Reports seguro.

Cuando los usuarios se firman de manera exitosa, el navegador manda una cookie
encriptada para autenticarlos dentro del servidor de Reports. Por default, esta cookie expira
en 30 minutos. Cuando la cookie expira, las peticiones subsiguientes sern re-autenticadas

Si se requiere que los usuarios permanezcan autenticados y mantengan ese estado, aun
despus de expirada la cookie, se debe omitir el uso de la clusula audit como parte del
comando RWCLIENT.

En el modo grafico, al elegir la opcin FILE/Connect, aparecer una ventana de conexin la
cual nos solicita los datos: USER, PASSWORD y DATABASE, la ventana de conexin nos
habilita el poder conectarnos a una fuente de datos ya sea de Oracle o no.



MODELO DE DATOS: CONSULTAS, GRUPOS Y LIGAS

El objetivo de este tema es entender lo que son los grupos y las ligas en Report, a
continuacin se explican los conceptos bsicos y se da un repaso breve de lo
anteriormente dicho, ya que para nuestros fines esto es cien por ciento prctico.

Algunos conceptos que vamos a abordar en este tema son:

a. Hojas de query
b. Consultas externas.
c. Grupos
d. Jerarquas
e. Filtros
f. Reportes multiconsulta
g. Ligas

Hojas de Query: Las hojas de query son aquellas opciones dentro del diseador de
Reports que nos permiten establecer la fuente de datos, de la cual, vamos a extraer la
informacin.

Estas fuentes de informacin no son otra cosa ms que la pauta para el inicio
de la creacin de nuestro(s) reporte(s), mismas que son:

Permite la realizacin de las consultas al introducir una sentencia SQL

Permite la realizacin de las consultas a travs de un cursor dentro de una
funcin de reports

Consultas Externas: Permite la creacin de consultas a fuentes de datos No-Oracle
tales como fuentes de datos XML o bien, fuentes de datos usando archivos planos,
JSPs o usando algn driver JDBC., este tipo de consultas externas las podemos
implementar a travs de las siguientes funciones desde el diseador de Reports:



Permite la realizacin de las consultas a travs de elementos XML

Permite la realizacin de las consultas a travs de una fuente de datos
JDBC

Permite la realizacin de las consultas a travs de un archivo plano (de
texto)

Grupos: Los grupos son creados para organizar las columnas dentro de un reporte.
Cuando se genera un query, el diseador de Reports automticamente genera un
grupo que contiene las columnas que se seleccionaron como parte del query. Se
pueden generar grupos adicionales (de manera automtica o manual) para producir
cortes o niveles dentro del reporte. Se explicarn ms adelante.

Para crear un reporte por medio de grupos (esto es con el objeto de crear cortes en
nuestro reporte), se deben de seguir los siguientes pasos:

1. Dentro del Object Navigator, teclear doble clic en el icono que tiene la etiqueta
Data Model.

2. Dar clic en el botn SQL (arriba mencionado) y arrastrar el cursor a la ventana de
diseo.

3. Dibujar un rectngulo o un cuadrado en dicha rea y elaborar el query, ya sea
manualmente o por query builder (explicado anteriormente).

4. Al tiempo que aparezca nuestro query creado, elegir los campos deseados (los
que van a ser en este caso los hijos, a esto se le conoce como jerarqua de
campos) y arrastrarlo afuera del grupo, esto automticamente nos creara en la
pantalla de diseo otro grupo.

5. Se proceder a crear el LAYOUT por medio del botn RUN.

6. Se teclear la opcin Yes, y en la pestaa de Style se elegir la opcin Group
Above.

7. En la pestaa Fields, se seleccionaran los campos que se deseen imprimir.



8. Oprimir con el mouse el botn Finish.

J erarquas: La realizacin de reportes usando jerarquas se realiza a travs de la
opcin Express Data Source que es un software de modelado multidimensional de
base de datos que provee de procesos analticos en lnea (OLAP) con capacidades de
incluir, escenarios y modelado financiero, esta opcin ha sido optimizada para la
consulta y anlisis de datos corporativos tales como: ventas, marketing, finanzas,
manufactura o recursos humanos. La opcin dentro del modelador de reports, para
acceder esta opcin es a travs del siguiente icono:

Filtros: Los filtros se aplican sobre los grupos y especifican el tipo de filtro que
Reports aplicara sobre los registros que han sido regresados por una consulta.

Los valores que se pueden aplicar son: First, Last y PL/SQL, donde First y Last
regresarn los n registros especificados en la propiedad Number of Records. El valor
PL/SQL es una funcin para determinar cuales registros sern incluidos en el grupo
que ha sido definido.

Reportes Multiconsulta: Este tipo de reportes son muy tiles cuando deseamos
realizar una explotacin de datos mas a detalle sin tener que depender del Express
Data Source o bien, si deseamos conocer informacin del tipo maestro / multi-
detalles.

Para generar un reporte multi consulta es necesario realizar lo siguiente:

1. En el Object Navigator, dar clic sobre el nodo de Reports, y generar un nuevo
reporte.

2. Dar doble clic sobre el icono de Data Model bajo el nuevo reporte

3. Crear el primer Query usando la herramienta SQL Query

4. Crear el segundo Query usando la herramienta SQL Query.

5. Definir la columna para ligar los queries.


6. Ejecutar el reporte, dando clic en el botn de semforo en verde.

7. Dar clic sobre Yes

8. En el Wizard, sobre la hoja de Style seleccionar Group Above.

9. En la hoja de Groups, mover los campos que deseamos se agrupe la
informacin en el reporte.

10. En la hoja de Fields, mover los campos que deseamos sean desplegados en el
reporte

11. En la hoja de Labels, personalizar las etiquetas de los campos a desplegar

12. Dar clic en Finish.

Ligas: son utilizadas para establecer las ligas entre una relacin de Padre-Hijo y para
ligar los grupos que formarn el reporte Matricial.

Para crear un reporte por medio de ligas (esto es con el objeto de crear cortes en
nuestro reporte), se deben de seguir los siguientes pasos:

1. Dentro del Object Navigator, teclear doble clic en el icono que tiene la etiqueta
Data Model.

2. Dar clic en el botn SQL (arriba mencionado) y arrastrar el cursor a la ventana de
diseo.

3. Dibujar un rectngulo o un cuadrado en dicha rea y elaborar el query (este seria
el maestro) ya sea manualmente o por query builder (explicado anteriormente).

4. Dibujar otro rectngulo otro cuadrado en dicha rea y elaborar otro query (este
seria para el detalle), ya sea manualmente o por query builder (explicado
anteriormente).

5. Una vez elaborados nuestros dos queries, oprimir el botn Data Link (el segundo
arriba mencionado) y posicionarse con el cursor en el campo llave del query
maestro y sin soltarlo, arrastrarlo hacia el campo llave del query detalle sin
soltar el botn del mouse, se deber repetir la operacin para cuantas llaves
existan entre los queries. Esto automticamente nos creara la liga entre los dos
queries.


6. Se proceder a crear el LAYOUT por medio del botn RUN.

7. Se tecleara la opcin Yes, y en la pestaa Style se elegir la opcin Group Above.

8. Pasar a la pestaa Groups y mostrar los grupos disponibles, pasar los dos
grupos hacia la otra ventana seleccionando el botn con la etiqueta DOWN>>.

9. En la pestaa Fields, se seleccionaran los campos que se deseen imprimir.

10. Oprimir con el mouse el botn Finish.

MODELO DE DATOS: COLUMNAS

Mantenimiento de columnas

El mantenimiento de columnas se da tanto para el Data Model (donde creamos nuestro
query), como para el Layout Model (donde rediseamos nuestra salida que es la que se va a
mostrar en la impresin).

Columnas de Base de Datos, que son el producto de la extraccin de un query o
Existen otras columnas con los siguientes tipos, que son de frmula, placeholder y
sumarias.

Columnas de formula, nos permiten la elaboracin de cdigo por medio PL-SQL
regresando el valor especificado ya de carcter, numrico o fecha.

Columnas de Placeholder nos permiten almacenar valores dentro de estas variables
pudiendo ser de tipo de carcter, numrico o fecha.

Columnas sumarias, nos permiten elaborar sumatorias, conteos, extraer valores
mnimos, extraer valores mximo sobre un campo numrico especifico.



OBJETOS DE DISTRIBUCIN.

El concepto de distribucin dentro de Reports 9i hace referencia a que se puede difundir un
reporte a mas de un destinatario, en mas de un formato enviando solamente una, varias o
todas las secciones de un reporte. Asimismo, se puede generar un reporte en diversos tipos
de salida hacia impresoras con distintos tipos de pgina.

Lo anterior facilita al usuario el no tener que generar un tipo de reporte para cada tipo de
audiencia que requiera conocer la informacin con sus diversos niveles de segregacin.

Para lograr lo anterior, procederemos a conocer primero, cuales son los objetos susceptibles
a ser distribuidos y posteriormente se hablar de la distribucin de un informe.

Objetos de Distribucin

Oracle Reports 9i maneja bsicamente tres tipos de objetos de distribucin de objetos dentro
del Layout Editor, mismos que son:

Frames de Repeticin (Repeating Frames).
Campos (Fields).
Boilerplates.

Mismos que pueden ser agrupados en diferentes secciones o layouts dentro de un mismo
reporte, ms adelante, se hablar de cmo generar las listas de distribucin y los pasos que
se deben seguir para proceder a la dispersin del reporte ya sea a diferentes destinatarios o
a diferentes formatos de salida.

A continuacin se presenta una breve descripcin de los objetos de Distribucin:

Frames de Repeticin.- Los frames son usados para contener otros objetos y
protegerlos de ser sobrescritos o empujados por otros objetos. Por ejemplo, un frame
puede ser usado para contener todos los objetos propios de un grupo de datos
especfico, para soportar los encabezados de las columnas o para contener campos
sumatorios.



Cuando se predefine un layout para un reporte, Reports 9i crea tantos frames como
sean necesarios alrededor de los objetos del reporte. Asimismo, el usuario puede
generar estos frames de Manera Manual.

Un Repeating Frame contiene todos los campos que han sido creados para un grupo y
ste se dispara por cada uno de los registros que son recuperados por el grupo de
datos.

Un repeating frame puede ser colocado en cualquier parte dentro del layout del reporte
mientras que su grupo origen de datos no sea una dimensin de una matriz

Un repeating frame debe estar detrs de los objetos que lo contienen.

Campos.- Un campo es el contenedor para cada columna dentro del layout del
reporte. Un campo es propiedad de un objeto que lo contiene, tpicamente un
repeating frame, a menos de que el campo sea una sumatoria (en este caso es
propiedad de un frame).

Boilerplates.- Los objetos tipo boilerplate son cualquier texto o grafico que aparece
dentro de un reporte cada vez que ste es ejecutado. Reports 9i crea un objeto
boilerplate por cada etiqueta que es seleccionada dentro del Reports Wizard. Adems,
un objeto boilerplate a veces es creado por cada sumatoria dentro de un reporte.

En secciones posteriores, se retomar este tema ahondando en la funcionalidad y
propiedades de este tipo de objetos.



Creacin

Para proceder a la creacin de los objetos de distribucin mencionados en el apartado
anterior, es necesario realizar las siguientes acciones:

Para crear un repeating frame, se debe seleccionar el siguiente icono dentro del Paper
Layout Editor:

Para crear un campo, se debe seleccionar el siguiente icono dentro del Paper Layout
Editor

Para crear un boilerplate, se debe seleccionar cualquiera de los siguientes iconos
dentro del Paper Layout Editor

Asimismo, para proceder a la preparacin de un reporte con mltiples layouts para su
distribucin, en el Paper Layout se debe realizar lo siguiente:

1. Generar el reporte base
2. Una vez generado el reporte, se debe generar un segundo layout, lo anterior se
logra realizando clic sobre el siguiente icono:

3. Seguir los pasos del Wizard.



Regiones de un reporte.

La composicin del informe es la estructura de grfica del informe. Cada informe tiene una
cabecera, un pie de pgina y un cuerpo. Las pginas de cabecera vienen al principio
seguidas por pginas de cuerpo, seguidas por las pginas de pie de formulario.

El margen del informe es el rea de la pgina fuera de los lmites de la cabecera, el pie del
formulario y el cuerpo. El cuerpo contiene todos los marcos que se repiten y los elementos
del informe que estructuran grficamente el modelo de datos. La cabecera y el pie del
formulario contienen cualquier elemento de datos o texto plano.

La cabecera, el pie del formulario y el cuerpo se trabajan con las herramientas del Layout
Editor. Como se ve en la siguiente figura:

Encabezado
Cuerpo
Pie de Pgina
Margen


Reportes Grandes.

Reports 9i cuenta con la capacidad de soportar gran diversidad de reportes, un tipo de
reporte Grande es aquel que usa la mayora de los componentes disponibles en Reports
como por ejemplo:

De igual manera, un reporte matricial es un perfecto ejemplo de este tipo de reportes, el Data
Model de un Reporte matricial se ilustra a continuacin:

Tras la ejecucin del reporte anterior, se presenta lo siguiente:



Asimismo, no debemos olvidar que un reporte grande o un reporte mltiple no solo pueden
contener los aspectos antes mencionados, sino tambin, es aquel reporte que cuenta con
ms de un layout para su distribucin.


DISTRIBUCIONES POR OMISIN.

Creacin de una distribucin.

Una vez que el reporte ha sido generado con los objetos de distribucin tal como se vio en el
capitulo anterior, Reports 9i cuenta con la distribucin a nivel reporte la cual nos ayuda a
disear un reporte para que pueda ser generado en diferentes formatos de salida y pueda
ser redistribuido a mltiples destinos ya sea, de un reporte completo o bien, por secciones de
un mismo reporte.

Por ejemplo, en una sola ejecucin de un reporte se puede generar una salida en HTML,
puede ser enviada a una versin de PostScript a la impresora y adems, puede ser enviada
por e-mail ya sea una, varias o todas las secciones del reporte a una lista de distribucin. En
versiones anteriores, se deba correr el reporte para cada una de las salidas deseadas.



Se puede especificar una distribucin para un reporte en cualquiera de los siguientes
sentidos:

En el Distribution Dialog Box (en la seccin del reporte o en la seccin del Property
Inspector, bajo el nodo de General Layout, doble clic en el campo de Distribution
value)

En la lnea de comando va la clusula DESTINATION que se especifica en un archivo
DST
1

Modificacin de una distribucin.

Para realizar la modificacin de una distribucin se debe realizar lo siguiente:

En el Distribution Dialog Box (en la seccin del reporte o en la seccin del Property
Inspector, bajo el nodo de General Layout, doble clic en el campo de Distribution
value)

1
Es un archivo alterno para definir la distribucin de un reporte o seccin del mismo dentro del Distribution Dialog Box



Caractersticas de una distribucin.

El seccionamiento de un reporte habilita al usuario para definir mltiples layouts en el mismo
reporte, cada uno con una audiencia distinta como destino, formato de salida, formato de
pgina, tamao de pgina o incluso, la orientacin de la misma.

Se pueden definir tres secciones del reporte, cada una con un rea de margen y cuerpo de
manera independiente.

Por compatibilidad con las versiones anteriores de Reports, los nombres de las secciones
son Header, Main y Trailer. Por default, un reporte es definido en el rea principal (Main), en
las otras secciones, se pueden definir diferentes layouts para generar mltiples reportes por
separado.

Por ejemplo, en un reporte sencillo, se puede incluir un resumen ejecutivo para la gerencia
media y en otra seccin un detalle ms especifico para cada uno de los gerentes de divisin.

Dentro del Object Navigator, son mostradas las secciones del reporte debajo del nodo Paper
Layout.

Creacin de Mltiples Distribuciones.

Para habilitar la distribucin mltiple del reporte se puede especificar en cualquiera de las
siguientes maneras:

Seleccionar File/Distribute
Especificar DISTRIBUYE=YES en la lnea de comando.

Para revisar la distribucin de un reporte sin tener que distribuir el reporte, se puede usar la
opcin trace the reports distribution, la cual contiene cuales son las listas de distribucin para
el reporte. Se puede usar esta informacin para determinar que secciones del reporte sern
enviadas a que destinos.



Direcciones de Impresin.

Las direcciones de impresin dentro de Reports 9i solo pueden ser personalizadas y manipuladas en
el uso de Repeating Frames. La direccin de impresin especfica cuales instancias dentro de in
frame o repeating frame pueden aparecer.

Los valores que se pueden definir dentro de la direccin de impresin son:

Across.- Cada instancia del repeating frame subsiguiente a la primera instancia es impresa a
la derecha de la instancia previa a travs de la pgina lgica.

Across/Down.- Cada instancia del repeating frame subsiguiente a la primera instancia es
impresa a la derecha de la instancia previa hasta que una instancia completa no puede ser
ajustada entre las instancias previas y el margen derecho de una pgina lgica. En ese
momento, Reports 9i imprime la instancia debajo de la instancia ms a la izquierda en la
pgina lgica cuidando de que haya suficiente espacio vertical entre instancias para que se
puedan imprimir completas.

Dowm.- Cada instancia del repeating frame subsiguiente a la primera instancia es impresa
debajo de la instancia anterior dentro de la pgina lgica.

Down/Across.- Cada instancia del repeating frame subsiguiente a la primera instancia es
impresa debajo de la instancia anterior hasta que la instancia entera no pueda ser impresa
dentro del margen inferior de la pgina lgica, en este momento, Reports 9i imprime esta
instancia a la derecha de la instancia ms hacia arriba de la pgina lgica, cuidando de que
exista el suficiente espacio horizontal en la pgina lgica para que la instancia se imprima
completa.

Dentro de las restricciones que se aplican en el manejo del control de la impresin tienen lugar en los
repeating frames anidados, ya que si el repeating frame tiene definida la propiedad Across y el
repeating frame padre tiene definida la propiedad con Down, se puede presentar una sobrecarga de
objetos dentro de una misma pgina.


MARCOS CAMPOS Y BOILERPLATE

Marcos

Un marco se define dentro del Layout Model, todo reporte por lo menos deber de contener
al menos un marco, a estos marcos tambin se les conocen como frame.

Estos son los contenedores de columnas, etiquetas o marcos de repeticin.

Para estos marcos existen propiedades que se deben de tomar en cuenta, ya que estas son
de primordial importancia en la creacin de nuestros reportes de las ms importantes
podemos mencionar:

La propiedad CONTRACT tiene la intencin que el tamao vertical del objeto disminuya. Si el
objeto o el dato que es formateado dentro es bastante corto, pero si no puedes incrementar
el ancho a uno ms grande que el que muestra en el editor del reporte la truncacin del
dato puede ocurrir, Se conoce esta propiedad en el diseo del objeto por medio del signo
(o)

La propiedad EXPAND tiene la intencin que el tamao vertical del objeto se incremente. Si
el formateado del objeto o el dato que esta dentro de este es bastante alto, pero si no puedes
disminuir el ancho a uno menor, Se conoce esta propiedad en el diseo del objeto por medio
del signo (=)

La propiedad FIXED Tiene la intencin la altura del objeto es la misma que cada pagina
lgica, despreocupado del el tamao del objeto del dato que esta dentro de este, la
truncacin del dato puede ocurrir

La propiedad VARIABLE Tiene la intencin que el objeto pueda expandirse o contraerse
verticalmente para acomodar el objeto dentro de este (sin espacio extra), dentro tiene la
intencin de el alto muestra dentro del editor reporte no tiene efecto en el objeto del alto en
runtime, Se conoce esta propiedad en el diseo del objeto por medio del signo (rombo)



Marcos de repeticin

Un marco de repeticin (tambin llamados Repeating frame) es el contenedor de las
columnas seleccionas del query, esto es, que por cada campo seleccionado en nuestro query
es el que nos permite mostrar la salida de nuestro reporte.

Al igual que los Marcos tiene las mismas propiedades arriba mencionadas y su utilidades la
misma.

Modo Confine

El modo confine nos permite mover objetos no hacia afuera del frame o de Repeating
Frame al cual pertenecen, esto nos da seguridad al tiempo de disear nuestro reporte que no
muevan objetos hacia otro frame u otro Repeating Frame que no le corresponde, esta opcin
se activa en el Layout Model.

Esta opcin se activa en el Layout Model. Y la podemos activar o desactivar por medio del
siguiente botn que se localiza en el men principal de nuestro diseador.

Modo Flex

El modo Flex nos permite hacer ms grandes o ms pequeos uno varios objetos dentro
del Layout Model, por ejemplo, si seleccionamos un objeto que debe estar dentro de un
Repeating Frame y de un Frame automticamente se modificara el tamao de Repeating
Frame y de Frame.

Esta opcin se activa en el Layout Model. Y la podemos activar o desactivar por medio del
siguiente botn que se localiza en el men principal de nuestro diseador.



Mezcal de Grupos de Datos (Boilerplate)

Un Boilerplate es cualquier texto o grfica que aparece en nuestro reporte cada vez que este
es ejecutado, Report crea un Boilerplate para cada etiqueta de texto seleccionada en el
reporte.

Para pegar una imagen a nuestro reporte en el encabezado siga los siguientes pasos:

1. Dentro del Layout Model oprimir el siguiente que se localiza en el men principal del
diseador

Este nos da acceso al rea del encabezado del reporte donde se colocan los ttulos y
logotipos de la empresa.

2. Elegir la opcin File/Import/Image... del men principal

3. Nos mostrara una caja de dialogo donde seleccionaremos nuestro archivo y se aceptara
la opcin OK

4. Se proceder a regresar a nuestro diseador oprimiendo el siguiente botn



ANCLAS Y BOTONES

Anclas Explicitas.- Son particularmente tiles para determinar la posicin horizontal y vertical
de un objeto hijo con relacin al padre.

Para crear un ancla que tambin es conocido por anchor se deber seleccionar el botn
siguiente que se encuentra ubicado en la barra de botones a la izquierda del Layout Model:

Una vez seleccionado este icono, oprimir sobre el borde del objeto hijo, despus mover el
cursor al borde del objeto padre y oprimir dos veces sobre el borde fijar el ancla.

Las propiedades del ancla son las siguientes:

Child Object Name.- Nombre del Objeto hijo

Child Edge Type.- Borde del objeto hijo sobre el cual el ancla se localiza. Las opciones son;
Top, Botton,Left y Right

Child Edge Percent. - Porcentaje hacia abajo o a travs del borde del objeto hijo

Parent Object Name.- Nombre del Objeto padre

Parent Edge Type.- Borde del objeto Padre sobre el cual el ancla se localiza.

Las opciones son; Top, Botton,Left y Right

Child Edge Percent. - Porcentaje hacia abajo o a travs del borde del objeto padre

Collapse Horizontally.- Indica si el ancla debera tener un largo cero si el objeto padre no
imprime, removiendo el espacio horizontal.

Collapse Vertically.- Indica si el ancla debera tener un largo cero si el objeto padre no
imprime, removiendo el espacio vertical.



Botones (Hyperlinks).- En las versiones anteriores de Reports se podan generar botones,
Oracle Reports 9i para mantener la compatibilidad e implementacin de esta funcionalidad,
se basa en la generacin de Hipervnculos. Los hipervnculos pueden apuntar a una seccin
dentro del mismo reporte o bien a otro documento en formato HTML o PDF en la misma
maquina o servidor Web.

Para crear un botn (hipervnculo) siga los siguientes pasos;

1. Una vez elaborado nuestro reporte, posicionarse en el Layout Model y oprimir el icono de
Margin que en nuestro encabezo del reporte.

2. Elegir el botn mostrado que se encuentra localizado en la barra de botones a la extrema
izquierda de nuestro diseador y arrastrarlo a nuestra rea de diseo.

3. Escribir el siguiente texto: Ejemplo de Hipervnculo.

4. Dar doble clic en el objeto para que nos aparezcan las propiedades del mismo.

5. En la propiedad de nombre Hyperlink debemos escribir el nombre del archivo (y ruta)
que deseamos abrir, para abrir un documento dentro de la misma maquina escribir:
file:///<unidad>|:/<path>/<archivo>.<extensin>.

6. Compilar el reporte.

7. Dentro del men File/ Generate to file elegir la opcin Paginated to HTML o bien PDF

8. Especificar la ruta en donde se va a generar el archivo.

9. Una vez generado, abrirlo y se ver que esta el texto en manera de hipervnculo, si la ruta
del archivo es correcta, al hacer clic sobre el texto, se invocar al archivo que
especificamos en el hipervnculo.



PROPIEDADES COMUNES DE OBJETOS DE DISTRIBUCIN.

Propiedades de Objetos de Distribucin.

Las propiedades de los objetos de distribucin que pueden ser usadas dentro de Reports 9i son las
siguientes:

Tamao.
Paginacin.
Condiciones de Impresin.
Cdigos de Impresora.
Triggers de Formato.
Propiedades comunes para varios objetos.

Mismas que se abordarn en los temas subsecuentes.

Tamao.

El tamao de los objetos se puede controlar a travs de dos mecanismos:

1. Por medio del uso del Size Objects Dialog Box
2. Por medio del uso de las propiedades Horizontal y Vertical Elasticity Properties

Size Dialog Box.

El Size Dialog Box habilita al usuario para redimensionar un conjunto de objetos relacionados
entre s mismos.



Horizontal y Vertical Elasticity Properties

Las propiedades Horizontal y Vertical Elasticity Properties especifican la manera en que el
tamao horizontal y vertical respectivamente se ajustar en tiempo de ejecucin para
acomodar los objetos o los datos dentro de estos.

La siguiente figura demuestra la manera en que la elasticidad horizontal y vertical es usada en
la vista Paper Layout del Editor de Reports.

En caso de que el contenido dentro de un objeto exceda su longitud predefinida, las
propiedades de elasticidad horizontal y vertical determinaran si el contenido se pasa a la
siguiente pgina o es truncado. Las imgenes, dibujos y graficas nunca excedern su tamao
preestablecido.


Paginacin.

La paginacin especfica la manera en que el nmero de pgina es calculado para los campos que
tienen definida la propiedad Source con alguno de los siguientes valores:

&Physical Page Number,
&Total Number of Physical Pages,
&Logical Page Number
&Total Number of Logical Pages.

La siguiente figura ilustra la diferencia entre la numeracin lgica, la numeracin fsica y la
numeracin del panel. Cabe destacar que cada regin puede contener mltiples pginas lgicas.
Adems, dentro de cada pgina lgica se pueden tener varios paneles. En la figura, las pginas
fsicas son numeradas secuencialmente comenzando en la seccin del encabezado de las pginas.



Condiciones de Impresin

Las condiciones de impresin son parte fundamental en lo que respecta a la definicin de la salida del
reporte que estemos realizando, la forma en que podemos manipular, predefinir y ajustar estas
propiedades es conforme a lo siguiente.

Dentro del Object Navigator, debajo del nodo Paper Layout se debe realizar doble clic en el icono de
la seccin que deseemos ajustar (Main, Header, Trailer)

Posteriormente, ya en el Property Inspector, debajo del nodo Section.

1. Ajustar las propiedades Width y Height
2. Ajustar la orientacin

En caso de que necesitemos contar con la capacidad de poder modificar estas propiedades en
tiempo de ejecucin, debemos realizar lo siguiente:

1. Seleccionar Tools/ Parameter Form Builder

2. Dar clic en el parmetro ORIENTATION

3. Clic en OK

4. Doble clic el campo del valor de Orientation para desplegar el Property Inspector

5. Bajo el nodo de Parameter, ajustar la propiedad Initial Value de Portrait a Landscape.

6. Clic en el botn de ejecucin.

7. En la lista de valores de Orientation cambiar la orientacin a la deseada

8. Continuar con la ejecucin del reporte.



Cdigos de Impresora.

Los cdigos de impresora son usados cuando se ejecuta un reporte en modo carcter, estos cdigos
no son usados cuando se ejecuta en modalidad bitmap. En la mayora de los casos se dispone de la
capacidad de completar cualquier formateo especial escribiendo bloques PL/SQL en el layout de los
objetos.

Existen dos propiedades dentro de Reports 9i que controlan los cdigos de impresora, estos son:

Printer Code After Property.
Printer Code Before Property.

Estos cdigos se explicarn ms adelante, sin embargo, algo que si conviene precisar en este
momento es, la utilizacin del paquete SRW del que hacen uso los cdigos antes citados.

Al momento de adquirir la suite de Oracle Internet Developer Suite 9i, Reports incluye un paquete
preestablecido llamado SRW, el cual contiene algunas funciones, procedimientos y excepciones a las
que se pueden hacer referencia en cualquiera de las libreras o de reportes.

A continuacin se mencionan algunos de los procedimientos, excepciones y funciones de las que se
conforma el paquete SRW:

ADD_DEFINITION
APPLY_DEFINITION
BREAK
CONTEXT_FAILURE
CREATE_TEMPORARY_FILENAME
DO_SQL
DO_SQL_FAILURE
GC_CREATE
GC_GET_VALUE
GC_NEXT
GET_PAGE_NUM
GET_VALUE
GETTER_RUN
INTEGER_ERROR
MAXROW_INERR



La ejemplificacin sobre el uso de este paquete no es cubierta en este curso debido a la complejidad
sobre el uso de este paquete. Para mayor informacin se puede hacer referencia a la documentacin
oficial del fabricante en la siguiente liga:

http://download-uk.oracle.com/docs/html/B10310_01/orbr_concepts2.htm#1031477

Nota:

Para hacer uso de esta informacin deber contar con un usuario / password
vlido para el sitio.

Triggers de formato.

Un Trigger de formato es una funcin de PL/SQL que se ejecuta antes de que un objeto sea
formateado. Este tipo de triggers pueden ser usados para cambiar el formato de un objeto de manera
dinmica.

La funcin debe regresar un valor booleano (TRAE o FALSE). Dependiendo del valor que regrese la
funcin, la instancia actual del objeto es incluida o excluida de la salida del reporte. Se puede acceder
a los triggers de formato desde el Object Nagivator, desde la propiedad Inspector o bien, desde el
Editor de PL/SQL

Cabe mencionar que el bloque PL/SQL dentro de un trigger de formato es ejecutado para cada
instancia del objeto, esto es, mientras menos instancias existan del objeto dentro del reporte, menos
sern las veces que el bloque PL/SQL se ejecutar y ms rpida ser la ejecucin del reporte.

Asimismo, la ejecucin de un trigger de formato no afecta a los datos recuperados por el reporte, esto
es, si el trigger de formato regresa FALSE a un campo, los datos recuperados para el campo son
procesados independientemente de que el campo aparezca o no en la salida del reporte.



Propiedades comunes para varios objetos.

Si dentro del Paper Layout Editor tenemos ubicados varios objetos, nos podemos dar cuenta
que los objetos entre si, tienen algo en comn: Propiedades.

Independientemente del tipo de objeto del de que se trate existen varias propiedades que son
comunes o compartidas entre ellos, mismas que son:

Hyperlink.- La propiedad Hyperlink especifica una direccin URL que hace referencia
a un documento o a alguna seccin dentro del documento.

Hyperlink Destination.- La propiedad Hyperlink destination especifica un identificador
nico para un objeto el cual, puede ser usado como un destino hacia una direccin
Web.

Bookmark.- La propiedad de Bookmark especifica una direccin Web que aparecer
en un frame de favoritos dentro del documento HTML maestro.

Application Command Line.- La propiedad Application Command Line especifica una
lnea de comando que ser ejecutada en la maquina cliente cuando el objeto
(documento PDF) es visualizado en el visor de PDF. Un reporte en formato PDF puede
incluir hyperlinks y commands line. Si el Command Line es especificado dentro de un
objeto.

Page Break Before.- La propiedad Page Break Before especfica si se requiere que el
objeto sea formateado en la siguiente pgina de la que originalmente corresponde al
objeto. Lo anterior no necesariamente significa que todos los objetos debajo de este
objeto se muevan a la siguiente pgina.

Page Break After.- La propiedad Page Break After especifica que se requiere que
todos los objetos dependientes u objetos hijos de un objeto se muevan a la siguiente
pgina. En otras palabras, cualquier objeto que sea hijo de un objeto (ya sea implcito o
explicito) sern tratados como si tuvieran definida la propiedad Page Break Befote igual
a Yes.

Page Protect.- La propiedad Page Protect especifica si se requiere intentar conservar
el objeto entero y su contenido en la misma pgina lgica. El usar esta propiedad
puede causar que los objetos subsiguientes al objeto protegido puedan aparecer
encima de este.


Vertical Elasticity.- La propiedad Vertical Elasticity especifica la manera en que el
tamao vertical de un objeto podr ser modificado en tiempo de ejecucin para
acomodar los objetos o bien, los datos contenidos en este.

Horizontal Elasticity.- La propiedad Horizontal Elasticity especifica la manera en que
el tamao horizontal de un objeto podr ser modificado en tiempo de ejecucin para
acomodar los objetos o bien, los datos contenidos en este.

Print Object On.- La propiedad Print Object On especifica la frecuencia con la que se
requiere que el objeto aparezca en el reporte. El valor de esta propiedad indica en que
pginas lgicas se requiere que el objeto sea impreso.

Base Print On.- La propiedad Base Print On especifica que el objeto actual ser
impreso dependiendo del objeto especificado en la propiedad Print Object On, esto es,
el objeto actual solo se imprimir tantas veces el objeto padre (Print Object on)
aparezca dentro del reporte.

Keep UIT Anchoring Object.- La propiedad Keep UIT Anchoring Object especifica si
se requiere que el objeto actual y el objeto al que ha sido anclado se impriman en la
misma pgina lgica. El ancla entre dos o ms objetos puede ser implcita o explicita.
Consecuentemente, Keep UIT Anchoring Object podr tener efecto aunque no se haya
creado un ancla explicita entre dos objetos.

Printer Code Befote.- La propiedad Printer Code hace referencia a las secuencias de
escape de la impresora para definir instrucciones especiales de impresin (por
ejemplo: un tamao en particular para una fuente o resaltado). Esta propiedad
especifica que la secuencia de escape ser ejecutada antes de cada lnea del objeto.
Esta propiedad se dispara cuando se requiera imprimir el objeto dentro del reporte pero
antes de que sea realmente impreso.

Printer Code After.- La propiedad Printer Code hace referencia a las secuencias de
escape de la impresora para definir instrucciones especiales de impresin (por
ejemplo: un tamao en particular para una fuente o resaltado). Esta propiedad
especifica que la secuencia de escape ser ejecutada despus de cada lnea del
objeto. Esta propiedad se dispara cuando se requiera imprimir el objeto dentro del
reporte pero antes de que sea realmente impreso.



PROPIEDADES ESPECFICAS DE OBJETOS DE DISTRIBUCIN.

Propiedades de un marco de repeticin.

Las propiedades ms relevantes de un Frame de Repeticin (Repeating Frame) son las
siguientes:

Source.- La propiedad de Source especifica el grupo al que pertenece la informacin
dentro del repeating frame.

Print Direction.- La propiedad de Print Direction especifica la direccin en la cual las
instancias sucesivas del repeating frame aparecern.

Maximum Records per Page.- La propiedad de Maximum Records per page
especfica el nmero mximo de instancias del repeating frame que sern formateados
en una pagina lgica. Por ejemplo, si un repeating grame tiene diferentes instancias, y
suponiendo que deseamos mejorar la apariencia del reporte, a solo 3 instancias del
repeating frame, para asegurar este hecho, el valor para esta propiedad debe ser de 3.

Minumum Widow Records.- La propiedad de Minimum Widow Records especfica el
nmero mnimo de registros que aparecern cuando el repeating frame se comience a
imprimir. Si el nmero de instancias especificadas en esta propiedad no pueden ser
acomodadas dentro de la pgina lgica en donde el repeating frame comenz a
imprimir, el repeating frame se comenzar a formatear en la siguiente pgina lgica.

Column Mode.- La propiedad de Column Mode controla la manera en que Reports 9i
recupera y formatea los datos para las diferentes instancias del repeating frame.
Column Mode es usado principalmente para repeating frames maestros o repeating
frames que contengan campos que puedan ser expandidos vertical u horizontalmente.

Horiz. Space Between Frames.- La propiedad Horiz. Space Between Frames
especifica el espacio total (en la unidad de medida de reports) que se desea tener
horizontalmente entre las instancias del repeating frame.

Vert. Space Between Frames.- La propiedad Vert. Space Between Frames especifica
el espacio total (en la unidad de medida de reports) que se desea tener verticalmente
entre las instancias del repeating frame.




Web.


objeto.

Table Attributes.- La propiedad de Table Attributes especifica los atributos de HTML
que sern insertados dentro de un tag <table> de HTML generado por el tag
<rw:include> dentro de un archive JSP. El tag <rw: include> tiene el atributo src que
hace referencia al objeto de despliegue. En el caso de referenciar un frame o repeating
frame, esta opcin proveer una opcin para especificar otros atributos de HTML tales
como borde, espaciado entre celdas, etc.

El resto de las propiedades especifican las propiedades de impresin y de despliegue dentro
del layout.



Propiedades de un campo.

Las propiedades ms relevantes de un campo (Field) son las siguientes:

Source.- La propiedad Source especifica de donde obtiene el campo sus valores
(usualmente es de una columna o bien, de un parmetro de usuario). Si el origen del
campo es un nmero de pgina (por ejemplo &Logical Page Number), se puede definir
la propiedad Page Numbering
2
para controlar la forma en que el paginado es realizado.

Source Data Type.- La propiedad Source Data Type es un campo de solo lectura que
despliega el tipo de dato de la fuente (u origen) de los datos de un campo.

Visible.- La propiedad Visible especifica si el campo ser o no desplegado. Esta
propiedad es usada para campos a los que solo se requiere hacer referencia en un
texto del tipo Boilerplate. Los campos ocultos son usados comnmente en reportes tipo
Carta en donde los campos son referenciados como texto Boilerplate. Para hacer
referencia a campos ocultos (Visible = No) se debe referenciar al mismo como
&NombredelCampo.


Web.


objeto.

del layout

2
Define la manera en que el nmero de pgina es calculado para los campos que usan esta propiedad o bien, &Total
Number of Physical Pages, &Logical Page Number o &Total Number of Logical Pages.



Propiedades de un boilerplate.

Las propiedades ms relevantes del Boilerplate son las siguientes:

Type.- La propiedad Type especifica el formato (por ejemplo: Text) de un objeto
boilerplate, este campo es de solo lectura. Los valores que puede tomar esta propiedad
son: Text, Line, Rectangle, Arc, Rounded Rectangle, Polyline, Polygon, Ellipse.


Web.


Contains HTML Tags.- La propiedad Contains HTML Tags indica que el objeto
boilerplate u objeto incluye HTML tags. Reports acomoda el objeto de manera
horizontal o vertical, y formatea el objeto como un texto normal (por ejemplo: cualquier
referencia del campo es resuelta). Si se necesita pasar el largo o ancho de un objeto
como parmetros, se pueden usar las variables ObjectWidth y ObjectHeight.

objeto.

del layout


REPORTES MATRICIALES SIMPLES Y SUMARIOS

Los reportes matriciales son de utilidad en muchos requerimientos especficos para la
explotacin de la informacin, al igual que los reportes convencionales, deben de contener
por lo menos un query, donde se seleccionara un campo para lo que podra llamarse el
encabezado, otro campo para lo que formara parte del detalle y por ltimo un campo
sumarizado que sea de tipo numrico para la creacin de la matriz. Esto agrupado por los
dos primero campos seleccionados.

Un ejemplo de un query con el que partiramos para la creacin de un reporte matricial es el
siguiente:

select b.nom_centro centro
,c.desc_producto prod
,sum(a.imp_neto) imp_neto
from pe_desgloce_facturas a
,pe_centros b
,pe_productos c
where a.num_centro = b.num_centro
and a.cve_producto = c.cve_producto
group by b.nom_centro,c.desc_producto

Los reportes matriciales constan por lo menos de 3 (tres) grupos, que son como se comento
lneas arriba, para los encabezados, los detalles y la matriz. Y otro grupo contenedor de los
encabezados y detalles.

Para la creacin de un reporte matricial se debern seguir los siguientes pasos:

1. Crear un query. Se puede tomar como ejemplo en script anterior.

2. Del resultado del query crear tres grupos (explicado en la creacin de grupos), uno por
cada campo en el orden que aparecen en el query.

3. Oprimir el botn mostrado que se encuentra a la extrema derecha del diseador y crear
un cuadrado o un rectngulo, de modo que el primer grupo y el segundo grupo queden
dentro del cuadrado o rectngulo dibujado


4. Una vez creado nuestro cuadrado o rectngulo, oprimir el botn derecho del mouse y
seleccionar la opcin Report Wizard...

5. En la pestaa Style seleccionar la opcin Matriz

6. En la pestaa Rows seleccionar el campo para el detalle, que este caso serian los
productos.

7. En la pestaa Columns seleccionar el campo para el encabezado, que en este serian los
centros.

8. En la pestaa Cell seleccionar el campo para la matriz, que en este caso seria el campo
sumarizado. Para elegir este campo es por medio del botn Sum >

9. En la pestaa de Totals seleccionar el campo con la etiqueta Sumimp_neto por medio del
botn Sum >

10. Elegir la pestaa Labels si desea cambiar el titulo de las etiquetas

11. Elegir la pestaa Template si desea asignar un template, ya sea de los predeterminados
por Report, si tiene usted uno creado o trabajar sin template

12. Oprimir el botn Finish



REPORTES MATRICIALES AVANZADOS Y SUMARIOS

Para la creacin de un reporte matricial por grupo se debern seguir los siguientes pasos:

Para llevar a cabo nuestro ejemplo podemos basarnos en el siguiente query

select a.ani_factura ao
,b.nom_centro centro
,c.desc_producto prod
,sum(a.imp_neto) imp_neto
from pe_desgloce_facturas a
,pe_centros b
,pe_productos c
where a.num_centro = b.num_centro
and a.cve_producto = c.cve_producto
group by a.ani_factura,b.nom_centro,c.desc_producto

La diferencia que existe con el anterior es que se agrego el campo ao para efectos del
corte.

1. Crear un query con el script de prueba arriba mostrado.

2. Crear cuatro grupos uno por cada campo en el orden jerrquico del query

3. Oprimir el botn mostrado que se encuentra a la extrema derecha del diseador y crear
un cuadrado o un rectngulo, de modo que el segundo grupo y el tercer grupo queden
dentro del cuadrado o rectngulo dibujado

4. Una vez creado nuestro cuadrado o rectngulo, oprimir el botn derecho del mouse y
seleccionar la opcin Report Wizard.



5. En la pestaa Style seleccionar la opcin Matrix with Group

6. En la pestaa Cell seleccionar el campo para la matriz, que en este caso seria el campo
sumarizado. Para elegir este campo es por medio del botn Sum >

7. En la pestaa de Totals seleccionar el campo con la etiqueta Sumimp_neto por medio del
botn Sum >

8. Elegir la pestaa Labels si desea cambiar el titulo de las etiquetas

9. Elegir la pestaa Template si desea asignar un template, ya sea de los predeterminados
por Report, si tiene usted uno creado o trabajar sin template

10. Oprimir el botn Finish

PARMETROS Y FORMA DE PARMETROS

Creacin de parmetros de usuario

Los parmetros de usuario son tiles cuando deseamos controlar nuestra informacin a
desplegar (extrada de un query) de ciertos registros que cumplan con los criterios de
bsqueda que se desee.

Referencia a parmetros en una consulta

Esta referencia se da al tiempo de editar el query del reporte, se debe poner en alguna
condicin del mismo en la clusula WHERE o AND de el lado derecho: (dos puntos) seguido
del nombre del parmetro, Reports preguntar si desea crear el parmetro si esto es correcto
aceptar la opcin OK.



Lista de valores

Las listas de valores se implementan tambin en los parmetros del reporte. Dentro las
propiedades del parmetro existe una de nombre List of Values, que al tiempo se
seleccionarla nos muestra los dos tipos de listas de valores existentes,

Siendo la primera de ellas Static Values por medio de esta opcin se seleccionaran los
valores constantes que aparecern en nuestra lista de valores como ejemplo podramos
mencionar por decir algo, un dominio declarado en la Base de Datos donde sus valores son
M de Masculino y F de Femenino.

El segundo tipo de lista de valores es SELECT Statement es ms flexible que la primera
opcin en el sentido de que por este medio tendremos acceso a los datos de la Base de
Datos para seleccionar los registros que se deseen por medio de la creacin de un query.

Este tipo de lista de valores consta de dos Checkbox :

Restrict List to Predetermined Values : Seleccionar esta opcin cuando se desee que la
lista de valores despliegue valores de tabla como por ejemplo el ao de la factura

Hide First Column : Esta opcin es til cuando se desea desplegar en la lista de valores la
descripcin de un campo tomando como referencia la llave del campo. Por ejemplo la clave y
la descripcin de un catalogo, estas dos columnas debern seleccionarse en el query y al
tiempo de correr el reporte nos mostrar la descripcin dejando la clave (la cual no se
mostrara en la consulta) para fines de bsqueda en el query.



Parmetros del sistema

DESTYPE .- Es el tipo de dispositivo al cual enviara report su salida (ej screen, file etc.)

DESNAME .- El nombre del dispositivo de salida, en caso que sea el valor de Destype sea
seleccionado como File deber especificar en esta propiedad la ruta y el nombre del archivo

DESFORMAT .- Es la definicin del formato del dispositivo de salida. Para archivo es rtf

COPIES .- Nos permite seleccionar el nmero de copias que se imprimirn del reporte.

CURRENCY .- Es el smbolo indicador de la moneda , por default es $

THOUSANDS .- Es el smbolo indicador de separacin de los miles, ej 1,000 por default es
coma ,

DECIMAL .- Es el smbolo indicador de los decimales por default es . (punto)
ORIENTATION .- Es la direccin en la cual se imprima el reporte (landscape o portrait)

BACKGROUND .- Dentro de la propiedad de Initial Value por default nos da la opcin No,
esto es por si no se desea correr el reporte por Background la opcin Si permite lo contrario.

MODE .- Cuando se desea correr el reporte en modo carcter o grfico

PRINTJOB .- Si la impresin es mediante un job Imprime una caja de dialogo que aparecer
antes de la corrida del reporte.



ALMACENAMIENTO DE REPORTES

Puede almacenar cualquier mdulo como por ejemplo: un reporte, un query externo o una
librera PL/SQL, en un archivo de sistema operativo o en las tablas de la base de datos de
Reports.

Su eleccin depende del sistema de manejo de aplicacin (como puede se el manejo del
archivo de seguridad y control) y alguna restriccin, en trminos del tamao de la Base de
Batos VS la distribucin de almacenamiento del archivo.

Tipos de archivos en el sistema operativo

Tipo de
archivo
Contenido Creacin Formato Ventaja
.rdf Definicin del reporte File-Save
File-
Administration-
Convert
Ejecutable
binario,
modificable
por medio del
Designer
Definicin
completa del
reporte
.rep Reporte que no
contiene
comentarios o
cdigo fuente
File-Generate
Dile-
Admistration-
Convert
Ejecutable
binario, no
modificable
Se reduce el
tamao del
ejecutable,
impide al usuario
la modificacin
.rex Definicin del reporte File-
Administration-
Convert
Text (ASCII o
EBCDIC), no
ejecutable, no
modificable
directamente
Fuente de
control y puede
usarse para
depuracin



Ms tipos de archivos en reports en funcin del sistema operativo

Tipo de archivo Contenido Creacin Formato Ventaja
.sql Una sentencia
query
File-Save
File->Save as
Texto
(ASCII/EBCDIC)
100 %
portable
.pll Una librera
PL/SQL externa
que contiene una
mas
construcciones
PL/SQL
File-Save
File->Save as
Binario
.pld Versin ASCII de
una librera externa
File-
Administration
-Convert
ASCII 100 %
portable
.prt Una definicin de
impresora
Copia y
edicin de
archivo de un
archivo .prt
existente
Texto
(ASCII/EBCDIC)
Solo para
reportes
modo
caracter

Almacenamiento la Base de Datos

Cuando se salva un mdulo en la base de datos, su definicin es almacenada en las tablas
de reports. Estas tablas retienen una combinacin de la especificacin del reporte e
informacin de la integracin con otros productos Oracle. Como SQL*Plus y el acceso al
diccionario de datos.

Porque salvar la Base de Datos?

Podra querer salvar reportes a la base de datos por estas razones:

Para documentar los reportes.

Para ser capaz de modificar el reporte.

Para crear sus propios reportes.

Usar una especie de repositorio central durante el proceso del diseo.



Portabilidad de archivos

Podra necesitar mover mdulos de reportes, queries externos o mdulos de librera de una
maquina a otra, o de una base de datos a otra. Cada archivo creado tiene diferentes
caractersticas que determinan su potabilidad. La tabla siguiente muestra los archivos que
pueden ser transportados, con algunas limitaciones:

Tipo de archivo Portabilidad
.sql, .rex, .prt (archivos de texto) 100 % portable
.pld (texto) 100 % portable
.rdf (binario), .pll Portable si se transfiere como binario
(PL/SQL re-compila al abrir/ejecutar)
.rep Portable como binario, si no hay cdigo
PL/SQL

TRIGGERS

Los triggers en report son tiles para controlar la informacin extrada de un query, en
algunos casos, se puede tambin controlar dicha informacin sin necesidad de tocar el
query. En el transcurso de la explicacin se vern ms a detalle.

Tipos de Triggers

Existen tres tipos de triggers para reports y son los siguientes:
De Reporte
De Modelo de Datos
De Distribucin

Tipos de Estructuras PL/SQL.

El tipo de estructuras PL/SQL soportadas por los triggers de forms son todas aquellas que
ayudan al control de la informacin tales como:

DoWhile
WhileDo
For
If... then else.


Triggers en Reporte.

Un submen de cinco triggers a nivel reporte. Cada trigger se dispara en una diferente etapa
de la ejecucin de l reporte.

Before Parameter Form
Alter Parameter Form
Before Report
Between Pages
After Report

Triggers en Modelo de Datos

Existen 3 tipos de triggers a nivel modelo de datos:

Columna de Formula: se dispara cada vez que la columna es procesada

Grupo Filtrador: se dispara por cada registro del grupo

Validacin de parmetro: se dispara cuando se despliega el parameter form y
cuando el usuario abandona el parmetro del campo

Triggers de Distribucin

Triggers de formato en la mayora de objetos layout (excluyendo anclas). Cada trigger se
dispara cuando el objeto es procesado.

Cdigo Comn.

Si bien las libreras no son parte de los triggers de Reports 9i, si son identificadas como
funciones que se pueden emplear en cualquier momento por los mismos.

Una librera es un conjunto de funciones o procedimientos PL/SQL que pueden ser
asociadas en un reporte. Cuando una librera es adjuntada a un reporte, se puede hacer
referencia a los paquetes, funciones y procedimientos dentro del reporte.


Restricciones.

Si Reports no puede encontrar la librera que se ha especificado como parte del
reporte, un mensaje de aviso ser desplegado, en caso de que se intente compilar o
ejecutar el reporte, este generar un error.

Las libreras son salvadas junto con el reporte, la prxima vez que se abre el reporte o
la librera, se buscara la definicin de las libreras, tal como se guardo por primera vez.

Si una librera hace referencia a otra, ambas libreras se debern agregar al reporte.

Curso Oracle Reports 9i

Загружено:

Сведения о документе

Авторское право

Доступные форматы

Поделиться этим документом

Поделиться или встроить документ

Параметры публикации

Этот документ был вам полезен?

Это неприемлемый материал?

Авторское право:

Доступные форматы

Curso Oracle Reports 9i

Загружено:

Авторское право:

Доступные форматы

Capacitacin Empresarial

Manual Oracle Reports 9i

Вам также может понравиться