Professional Documents
Culture Documents
<XMLP>
Contenido
Introducción
......................................................................................................................................
3
Fases de implementación para el XML Publisher
........................................................................
5
Prerrequisitos
....................................................................................................................................
6
Consideraciones especiales
.............................................................................................................
6
Instalación del Oracle BI Publisher Desktop
.................................................................................
8
Creación y registro de un origen de datos
..................................................................................
11
Creación de plantillas tipo RTF con Microsoft Word
..................................................................
14
Definición del reporte en PeopleSoft
...........................................................................................
26
Ejecución y visualización del reporte XML
...................................................................................
30
PARTE II
..........................................................................................................................................
32
XML PUBLISHER + PEOPLECODE
.................................................................................................
32
2
Introducción
El
XML
Publisher
de
PeopleSoft
Enterprise
es
una
solución
para
la
generación
y
publicación
de
reportes
basada
en
plantillas
mediante
la
cual
se
separa
el
proceso
de
extracción
de
datos
del
proceso
de
diseño
que
determinará
la
apariencia
final
del
reporte
permitiendo
de
esta
forma,
reutilizar
la
información
extraída
desde
las
aplicaciones
para
utilizarla
en
múltiples
formatos
de
reporte.
XML
Publisher
(XMLP)
es
una
nueva
tecnología
de
Oracle
y
fue
originalmente
desarrollada
para
resolver
los
problemas
de
reporteo
que
enfrentaban
las
aplicaciones
de
Oracle.
Fue
lanzado
por
primera
vez
junto
con
la
suite
Oracle
E-‐Business
11.5.10
en
el
2003.
Desde
entonces,
ha
sido
integrada
en
cierta
medida
junto
con
aplicaciones
como
JD
Edwards
Enterprise
One
y
PeopleSoft
Enterprise,
existe
también
una
versión
autónoma
llamada
simplemente
Oracle
BI
Publisher
la
cual
no
tiene
dependencias
con
otras
aplicaciones.
Cuando
el
XML
Publisher
(XMLP)
se
convirtió
en
parte
de
la
suite
Oracle
BI
(Business
Intelligence)
Enterprise
Edition
fue
renombrado
como
Oracle
BI
Publisher,
debido
a
esto
en
la
actualidad
ambos
nombre
se
utilizan
indistintamente.
Oracle
ha
desarrollado
esta
herramienta
autónoma
basada
en
Java
que
hace
más
eficiente
el
proceso
de
reporteo
y
la
forma
de
trabajar
con
él.
Una
de
las
características
principales
del
Oracle
XML
Publisher
es
la
separación
de
los
procesos,
por
un
lado
el
de
extracción
de
datos
y
por
otro
el
de
la
generación
de
la
plantilla
que
dará
forma
al
reporte.
El
XML
Publisher
nos
proporciona
la
habilidad
para
diseñar
y
crear
las
plantillas
de
los
reportes
mediante
algunas
de
las
aplicaciones
de
escritorio
más
comunes,
como
Microsoft
Word
y
Adobe
Acrobat
y
posteriormente
presentarnos
la
información
XML
en
el
formato
establecido
por
dichas
plantillas.
De
esta
manera,
con
una
sola
plantilla,
se
pueden
generar
reportes
en
diferentes
formatos
de
archivo
(PDF,
RTF,
Excel,
HTML,
etc.).
Ya
que
el
XML
Publisher
toma
por
separado
la
lógica
de
los
datos
de
la
capa
de
presentación
durante
el
desarrollo
de
los
reportes
y
los
combina
durante
el
tiempo
de
ejecución,
se
puede
destinar
a
un
consultor
técnico
para
desarrollar
la
lógica
de
la
extracción
de
datos
(utilizando
Application
Engine,
PeopleCode
o
una
consulta
de
PeopleSoft)
y
por
otro
lado
tener
a
un
consultor
funcional
o
inclusive
a
un
usuario
final
para
diseñar
la
plantilla
que
dará
presentación
a
los
datos
utilizando
herramientas
comunes
de
software.
Debido
a
que
las
consultas
de
PeopleSoft
también
pueden
utilizarse
como
fuente
de
datos,
el
XML
Publisher
se
presenta
como
una
herramienta
flexible
para
cualquier
tipo
de
usuarios,
de
tal
manera
que
todos
ellos
sean
capaces
(con
un
mínimo
entrenamiento),
de
diseñar
plantillas
y
reportes
adaptados
exactamente
a
sus
necesidades
en
el
momento
que
lo
requieran,
reduciendo
así
considerablemente
los
costos
del
desarrollo.
El siguiente diagrama nos ilustra el concepto del XML Publisher.
3
Solo
algunas
características
de
la
suite
Oracle
BI
Publisher
se
han
incluido
para
el
XML
Publisher
pero
se
han
enriquecido
para
ser
utilizadas
en
PeopleSoft
Enterprise.
Los
querys
de
PeopleSoft
así
como
cualquier
aplicación
que
provea
de
datos
en
XML
se
encuentran
disponibles
para
fungir
como
fuente
de
datos.
El
XMLP
de
PeopleSoft
Enterprise
provee
un
ambiente
de
administración
de
plantillas,
fuentes
de
datos,
reportes,
traducciones,
etc.
XML
Publisher
será
la
solución
de
reporteo
elegida
por
Oracle
cuando
las
aplicaciones
FUSION
se
encuentren
disponibles
en
el
mercado.
A
continuación,
mostramos
un
conjunto
de
diferencias
al
comparar
tres
soluciones
de
reporteo.
4
La implementación del XML Publisher puede ser dividida en las siguientes fases y tareas correspondientes:
• Definir categorías para los reportes, incluyendo seguridad del Editor de definición de reportes.
• Descargar los complementos de diseño para facilitar el diseño de plantillas fuera de línea.
• Identificar
o
crear
orígenes
de
datos
para
el
reporte.
Los
orígenes
de
datos
pueden
ser
Querys
de
PeopleSoft,
objetos
Rowset
de
PeopleCode,
objetos
XMLDoc
o
archivos
XML
(hasta
la
versión
8.50
de
PeopleTools).
• Registrar
archivos
de
esquema
o
archivos
con
información
de
muestra
para
los
orígenes
de
datos
del
XMLP.
3. Creación
y
carga
de
plantillas
de
reporte
• Descargar
los
esquemas
e
información
de
muestra
de
los
orígenes
de
datos
para
diseñar
correctamente
las
plantillas
• Utilizar Microsoft Word o Adobe Acrobat para desarrollar y mantener reportes personalizados.
• Definir reportes asociando orígenes de datos con archivos de plantillas.
En
las
siguientes
páginas,
llevaremos
a
cabo
la
creación
de
algunos
tipos
de
reportes
utilizando
el
XMLP
ya
instalado
y
disponible
desde
PeopleSoft
Enterprise
por
lo
que
la
fase
1
concerniente
a
la
instalación,
no
será
abordada
en
este
documento.
En
este
caso
trataremos
solo
de
explotar
algunas
de
las
capacidades
del
producto,
sin
embargo
los
ejemplos
aquí
mostrados
serán
sólo
de
carácter
demostrativo
y
no
limitativo.
5
Prerrequisitos
Para
poder
trabajar
con
las
herramientas
de
creación
de
reportes
es
necesario
asegurarse
que
el
equipo
cuente
con
los
siguientes
elementos:
1. PeopleSoft
8.48
o
superior
2. Java
Runtime
Environment
(JRE)
3. Microsoft
.Net
2.0
o
superior
4. Microsoft
Word
2000
o
superior
Consideraciones especiales
Se
encuentran
disponibles
para
su
descarga
e
instalación
diferentes
versiones
del
complemento
Oracle
BI
Publisher
Template
Builder
for
Word
y
cuya
interface
(en
el
caso
de
la
más
reciente)
se
acopla
perfectamente
a
la
característica
“Ribbon”
de
las
nuevas
ediciones
de
Microsoft
Office
(2007
y
2010).
Sin
embargo,
durante
la
realización
de
los
ejercicios,
se
detectaron
algunos
inconvenientes
e
inclusive
errores
(al
diseñar
las
plantillas
con
Word
2007
o
2010
más
el
Template
Builder
versión
11.x
y
ejecutarlos
bajo
el
XML
Publisher
de
la
versión
9.0)
en
el
resultado
de
algunos
reportes
y
específicamente
al
trabajar
con
reportes
de
tipo
formulario
o
aquellos
que
incluían
gráficas;
es
posible
que
los
errores
se
deban
a
que
algunas
características
de
XML
que
inserta
el
asistente
de
diseño
dentro
de
la
plantilla
o
el
mismo
Word
no
sean
soportadas
por
el
procesador
de
XML
que
se
utiliza
en
el
XMLP
de
PeopleSoft
HCM
9.0.
Dichos
errores
podrían
ocasionar
que
los
reportes
muestren
información
basura
o
que
no
se
generen
del
todo
y
muestren
mensajes
de
error
como
el
siguiente:
“…
(Error)
Namespace
prefix
'ref'
used
but
not
declared"
relacionados
con
la
definiciones
de
nombres
de
espacio
XML.
Figura
3.
Barra
de
herramientas
de
Oracle
BI
Publisher
Template
Builder
for
Word
11.1.1.5.0
(Interfaz
Ribbon)
Figura 4. Barra de herramientas de Oracle BI Publisher Template Builder for Word 10.1.3.4.1 (Interfaz de Menú)
6
Finalmente,
la
combinación
de
herramientas
de
diseño
que
dio
mejores
resultados
en
la
elaboración
de
plantillas
y
su
posterior
ejecución
como
reportes
bajo
XMLP
de
PeopleSoft
Enterprise
9.0
fueron:
Microsoft
Office
Word
2003
+
Template
Builder
10.1.3.3.2
ó
10.1.3.4.1.
Figura
5.
Barra
de
herramientas
de
Oracle
BI
Publisher
Template
Builder
for
Word
10.1.3.4.1
funcionando
en
Word
2003
Figura 6. Pantalla “Acerca de” en Oracle BI Publisher Template Builder For Word
7
Para
poder
realizar
el
diseño
de
la
plantilla
la
cual
dará
la
apariencia
final
a
nuestro
reporte
se
puede
utilizar
cualquier
herramienta
de
diseño
capaz
de
guardar
archivos
con
formato
RTF
y
que
admita
la
integración
de
XML,
sin
embargo
se
sugiere
el
uso
del
complemento
para
Word
de
Oracle
BI
Publisher
(disponible
desde
PeopleSoft)
por
la
simpleza
que
brinda
al
momento
de
diseñar
plantillas
sobre
una
herramienta
con
la
que
el
usuario
estará
ampliamente
familiarizado.
Comenzaremos
por
hacer
la
instalación
del
complemento
Oracle
BI
Publisher
Desktop
realizando
el
siguiente
procedimiento:
Figura
7.
Ubicación
para
la
descarga
del
complemento
BI
Publisher
en
PeopleSoft
8
Figura
8.
Diálogo
de
opciones
para
descargar
el
complemento
Figuras
9
y
10.
Descompresión
del
paquete
y
asistente
de
la
instalación
4. Seleccionaremos
el
idioma
de
la
instalación
y
haremos
clic
en
Siguiente
para
continuar
con
el
proceso.
El
idioma
seleccionado
servirá
tanto
para
las
pantallas
del
asistente
de
instalación
así
como
para
el
idioma
que
el
complementó
mostrará
dentro
de
Word
una
vez
instalado,
es
posible
cambiarlo
por
otro
idioma
incluso
después
de
la
instalación.
En
las
pantallas
posteriores
podremos
establecer
la
carpeta
destino
de
la
instalación
y
para
terminar
el
proceso,
haremos
clic
en
Finalizar
cuando
el
asistente
nos
muestre
la
pantalla
(figuras
10
y
11).
9
Figuras
10
y
11.
Avance
de
la
instalación
y
finalización
del
asistente.
5. Una
vez
que
la
instalación
concluyó,
examinaremos
el
grupo
de
programas
instalados
en
el
equipo,
un
nuevo
conjunto
llamado
Oracle
BIPublisher
Desktop
deberá
estar
visible.
De
la
misma
manera,
al
abrir
Microsoft
Word,
podremos
ver
el
nuevo
menú
llamado
“BI
Publisher”
(en
versiones
inferiores
a
2007)
y
una
nueva
sección
llamada
Complementos
(en
versiones
2007
y
2010)
dentro
de
la
cual
se
encuentran
los
menús
y
las
opciones
que
nos
permitirán
manipular
a
las
plantillas
(figuras
4
y
5).
6. Una
vez
que
logramos
visualizar
el
complemento
dentro
de
Word,
podremos
verificar
en
la
opción
“Acerca
de”
dentro
del
menú
“Ayuda”
del
complemento
BI
Publisher,
la
versión
que
hemos
logrado
instalar
(figura
6).
10
Fig.
12
Pantalla
Orígenes
de
Datos
en
XML
de
PeopleSoft
Enterprise
2. Dentro
de
la
página
Orígenes
de
Datos,
seleccionaremos
“Añadir
un
Valor”
y
nos
aseguraremos
de
que
el
campo
*Tipo
de
Origen
de
Datos
contenga
el
valor
“Consulta
PS”,
a
continuación
haremos
clic
sobre
el
ícono
de
búsqueda
del
campo
*ID
Origen
Datos
y
de
la
lista
mostrada,
seleccionaremos
la
consulta
que
previamente
se
haya
diseñado
y
guardado
a
través
del
gestor
de
Consultas.
Hacer
clic
en
Añadir.
Fig.
13.
Selección
del
tipo
y
el
ID
de
origen
de
datos
11
3. En
la
siguiente
página,
podremos
visualizar
los
detalles
para
el
origen
de
datos
que
se
acaba
de
registrar,
se
puede
agregar
una
descripción
para
el
origen
así
como
seleccionar
un
ID
de
producto,
debemos
asegurarnos
de
que
la
casilla
Activo
está
seleccionada.
A
continuación,
hacer
clic
en
el
vínculo
Generar
del
renglón
Archivo
Datos
Ejemplo,
enseguida
a
la
derecha
del
podemos
encontrar
el
nombre
del
origen
de
datos
más
la
extensión
XML
a
manera
de
hipervínculo.
Fig.
14.
Detalles
del
origen
de
datos
Fig.
15
Archivo
XML
de
ejemplo
listo
para
ser
accedido.
4. Hacer
clic
sobre
el
vínculo
que
se
acaba
de
desplegar.
Enseguida
se
mostrará
en
una
nueva
ventana
del
navegador
web
el
contenido
XML;
mediante
los
comandos
del
navegador,
debemos
guardar
la
página
desplegada
en
cualquier
ubicación
deseada
y
asegurarse
de
que
la
extensión
con
la
que
se
guarde
sea
XML.
12
Fig.
16
despliegue
del
contenido
XML
para
el
archivo
de
datos
de
ejemplo
de
nuestro
origen
de
datos
5. Finalmente,
ya
de
vuelta
en
la
página
Orígenes
de
datos,
haremos
clic
en
el
icono
Guardar,
para
que
nuestros
ajustes
queden
registrados.
Con
esto
ha
quedado
correctamente
registrado
el
origen
de
datos.
13
El
siguiente
paso
en
la
generación
del
reporte
mediante
XMLP
será
definir
la
plantilla
que
servirá
para
dar
la
apariencia
final
al
documento
que
se
va
a
generar,
para
su
elaboración
utilizaremos
el
recién
instalado
complemento
Template
Builder
for
Word
que
es
parte
del
Oracle
BI
Publisher
Desktop.
Es
importante
destacar
que
el
uso
de
esta
herramienta
es
opcional,
sin
embargo,
es
una
poderosa
ayuda
a
la
hora
de
poder
trabajar
en
el
diseño
de
una
plantilla
de
reporte
y
combinarla
con
las
características
del
XML.
Comenzaremos
con
un
diseño
básico
de
reporte
tabulado
siguiendo
el
proceso
que
a
continuación
se
muestra.
1. En
Microsoft
Word
crearemos
un
nuevo
documento,
agregaremos
un
encabezado,
pié
de
página
y
cualquier
elemento
que
deseemos
que
forme
parte
de
nuestra
plantilla,
es
importante
destacar
que
solo
deben
agregarse
características
que
sean
soportadas
al
guardar
el
archivo
con
extensión
tipo
RTF.
Fig.
17
diseñando
la
plantilla
en
Microsoft
Word
2. Para
agregar
el
tabulado
a
nuestro
reporte
realizaremos
lo
siguiente.
Desde
el
menú
Oracle
BI
Publisher
seleccionaremos
Datos
>
Cargar
Datos
XML,
a
continuación
se
mostrará
un
cuadro
de
diálogo
mediante
el
cual
se
seleccionará
el
archivo
XML
que
se
generó
al
momento
de
registrar
el
Origen
de
Datos,
hacer
clic
en
Abrir
(figuras
18
y
19).
3. Si
el
archivo
XML
seleccionado
es
válido,
deberá
mostrarse
una
ventana
indicando
que
la
estructura
se
ha
cargado
exitosamente
(figura
20).
Haremos
clic
en
Aceptar.
En
caso
contrario,
tendremos
que
generar
nuevamente
el
archivo
XML
desde
la
sección
Orígenes
de
Datos
en
el
XMLP
de
PeopleSoft.
14
Fig.
18
y
19
seleccionando
el
archivo
de
datos
de
ejemplo
XML
Fig.
20
Datos
XML
cargados
exitosamente
4. Ya
que
se
han
cargado
los
datos,
utilizaremos
el
Asistente
de
Tablas
disponible
desde
la
opción
de
menú
Insertar
del
Oracle
BI
Publisher.
Enseguida,
un
nueva
ventana
se
mostrará
en
la
cual
seleccionaremos
la
opción
Tabla
y
después
haremos
clic
en
Siguiente.
Figs.
21
y
22.
Activación
del
asistente
para
tablas
y
selección
del
tipo
de
contenido
a
insertar
15
5. La
siguiente
ventana
nos
mostrará
las
opciones
que
se
pueden
utilizar
como
fuente
de
datos,
en
este
caso,
sólo
tendremos
disponible
“/query/row”,
enseguida
dar
clic
en
Siguiente
Fig.
23
Selección
del
tipo
de
origen
de
datos
a
utilizar
6. En
la
siguiente
ventana
podremos
seleccionar
los
campos
que
están
disponibles
desde
nuestro
origen
de
datos
y
que
deseamos
incluir
en
nuestro
reporte.
Al
finalizar
la
selección
de
campos
pasándolos
de
izquierda
a
derecha
de
la
ventana
dar
clic
en
Siguiente.
Fig.
24
Selección
de
campos
para
el
reporte
7. La
próxima
ventana
nos
permitirá
definir
algún
campo
para
establecer
la
agrupación
de
los
resultados,
en
el
ejemplo
se
utiliza
al
campo
“COMPANY”
para
establecer
el
orden.
Se
pueden
establecer
hasta
cuatro
niveles
de
agrupación,
en
función
de
los
campos
disponibles
en
el
origen
de
datos.
Al
finalizar,
hacer
clic
en
Siguiente.
16
Fig.
25
opciones
de
agrupación
para
el
reporte
8. La
siguiente
ventana
nos
permite
definir
el
criterio
de
ordenamiento
(si
se
desea)
para
los
resultados
de
la
consulta,
se
puede
seleccionar
cualquier
campo
que
se
haya
agregado
previamente.
De
igual
forma,
se
pueden
utilizar
hasta
cuatro
diferentes
campos
para
establecer
el
orden
de
los
resultados
para
continuar,
hacer
clic
en
Terminar.
Fig.
26
opciones
de
ordenamiento
para
el
reporte
9. Una
vez
finalizado
el
asistente
se
insertará
el
tabulado
con
los
datos
XML
incrustados.
A
continuación
puede
editar
libremente
las
etiquetas
de
los
campos,
modificar
las
fuentes,
colores
y
ubicación
de
los
textos
si
se
desea,
es
importante
no
eliminar
los
elementos
que
tienen
color
gris
como
fondo
ya
que
estos
determinan
el
despliegue
de
los
datos
XML.
17
10. Para
editar
las
etiquetas
de
los
campos
(textos
con
color
gris
de
fondo)
basta
con
hacer
doble
clic
sobre
el
elemento
para
abrir
el
cuadro
de
diálogo
Propiedades
de
BI
Publisher
y
cambiar
el
valor
del
campo
“Texto
para
mostrar”.
Una
vez
finalizada
la
edición
de
la
plantilla
debemos
guardar
el
archivo.
Fig.
27
Propiedades
de
un
elemento
insertado
mediante
el
asistente
para
tablas
de
BI
Publisher
Finalmente
nuestro
reporte
podría
tener
una
apariencia
como
la
siguiente,
para
terminar
debemos
asegurarnos
de
que
el
formato
de
archivo
es
RTF:
Fig.
28
apariencia
final
de
la
plantilla
RTF
18
Para
este
tipo
de
informe,
seguiremos
los
pasos
mencionados
anteriormente
en
la
creación
de
un
reporte
tipo
tabulado
aunque
con
algunas
ligeras
modificaciones.
Para
este
reporte
utilizaremos
un
origen
de
datos
que
ya
ha
sido
creado
previamente
mediante
el
Gestor
de
Consultas
en
PeopleSoft
y
que
de
igual
forma
ya
ha
sido
registrado.
Dicho
origen
de
datos
nos
devolverá
“n”
renglones
de
información
los
cuales
nos
servirán
para
ilustrar
correctamente
la
funcionalidad
del
XMLP
en
la
creación
de
formularios.
Fig.
29
diseño
de
una
plantilla
RTF
tipo
formulario
en
Microsoft
Word
2. Vincularemos
el
esquema
XML
resultante
durante
la
creación
del
origen
de
datos
en
PeopleSoft
con
la
plantilla
que
estamos
diseñando
mediante
el
comando
“Cargar
Datos
XML”
de
Oracle
BI
Publisher.
3. A
continuación
haremos
clic
en
el
menú
Insertar
(de
BI
Publisher)
y
daremos
clic
en
Campo…
para
que
el
explorador
de
campos
se
muestre
e
iremos
arrastrando
desde
esta
ventana,
cada
uno
de
los
campos
que
requerimos
y
los
colocaremos
sobre
el
espacio
requerido
en
el
formulario.
19
Fig.
30
colocando
campos
sobre
el
formulario
4. Una
vez
que
hayamos
concluido
de
insertarlos
cerramos
el
explorador
de
campos.
Debido
a
que
requerimos
que
el
formulario
contenga
diferentes
valores
por
cada
empleado
y
que
se
impriman
“n”
cantidad
de
formularios;
agregaremos
un
ciclo
de
repetición
colocándolo
al
inicio
del
reporte
y
que
indique
un
salto
de
página
al
final
de
este.
Fuera
del
área
del
reporte,
por
ejemplo
una
nueva
página,
seleccionaremos
del
menú
de
BI
Publisher
Insertar
>
Campo…
enseguida
se
mostrará
el
explorador
de
campos
pero
esta
vez
arrastraremos
el
texto
que
dice
“Row”
y
lo
soltaremos
sobre
la
página.
Cerramos
el
explorador
de
campos.
Fig.
31
insertando
un
indicador
de
conjunto
de
datos
en
el
reporte
tipo
formulario
5. Ahora
tendremos
que
colocar
el
cursor
al
inicio
de
la
etiqueta
recién
insertada
“row”
y
seleccionaremos
del
menú
de
BI
Publisher
Insertar
>
Grupo
de
repetición
y
en
la
ventana
que
se
mostrará
nos
aseguraremos
de
seleccionar
las
opciones
como
se
muestra
a
continuación
y
finalizaremos
con
un
clic
en
Aceptar:
20
Fig.
32
agregado
los
indicadores
de
inicio
y
corte
de
página
Lo anterior deberá agregarnos nuevas etiquetas al documento como se muestra:
6. A
continuación
dividiremos
la
etiqueta
en
dos
partes
(for-‐eachrow
y
page
breakend)
colocando
la
primera
parte
al
inicio
del
reporte
y
la
segunda
al
final
de
la
siguiente
forma:
Fig.
33
estableciendo
las
etiquetas
de
inicio
y
fin
de
página
Finalmente
guardaremos
el
archivo
(con
extensión
RTF)
y
quedará
listo
para
asociarlo
a
un
origen
de
datos
dentro
del
XML
Publisher
de
PeopleSoft
en
la
Definición
de
Informes.
21
Utilizando
parte
del
mismo
proceso
de
elaboración
de
las
plantillas
anteriores,
en
esta
sección
diseñaremos
un
reporte
que
contiene
una
gráfica
que
nos
permitirá
ilustrar
el
comportamiento
de
la
información
con
la
que
se
genera.
Partiremos
de
un
query
previamente
diseñado
a
través
del
Gestor
de
Consultas
de
PeopleSoft
que
será
nuestra
fuente
de
datos,
esta
consulta
nos
permite
obtener
un
conteo
de
los
empleados
que
han
causado
baja
así
como
el
motivo
de
la
misma
a
través
de
los
campos
EMPLID,
ACTION_REASON,
DESCR
y
DESCRSHORT.
1. Comenzaremos
utilizando
Microsoft
Word
para
diseñar
la
plantilla.
A
un
nuevo
documento
le
agregaremos
un
encabezado
y
pié
de
página,
así
como
los
elementos
necesarios
que
contendrá
nuestro
formulario.
Ejemplo:
Fig.
34
Diseño
de
la
plantilla
RTF
en
Microsoft
Word
2. Vincularemos
el
esquema
XML
resultante
durante
la
creación
del
origen
de
datos
en
PeopleSoft
con
esta
plantilla
para
agregar
los
campos
que
necesitaremos;
para
esto
en
la
barra
de
herramientas
de
BI
Publisher
seleccionaremos
Datos
>
Cargar
datos
XML…,
desde
el
cuadro
de
dialogo
seleccionamos
el
archivo
XML
en
cuestión
y
esperamos
hasta
observar
la
notificación
de
“Datos
cargados
correctamente”
3. Enseguida,
desde
el
menú
de
BI
Publisher
Insertar
seleccionaremos
Gráfico…
obtendremos
una
nueva
ventana
que
nos
permitirá
establecer
los
parámetros
generales
de
la
gráfica
y
de
su
apariencia.
Para
este
ejemplo,
llenaremos
los
campos
requeridos
como
se
muestra
a
continuación
arrastrando
desde
la
parte
izquierda
de
la
ventana
los
campos
EMPLID
sobre
el
cuadro
de
texto
“Valores”
y
DESCR
o
DESCRSHORT
sobre
el
cuadro
de
texto
“Etiquetas”.
Deshabilitaremos
la
casilla
“Datos
de
Grupo”
y
seleccionaremos
el
tipo
de
gráfica
que
deseamos
(en
este
caso
Gráfico
de
Tarta);
si
se
desea
también
se
le
puede
incluir
un
estilo
y
características
de
presentación
a
la
gráfica.
22
Fig.
35
Ventana
de
trabajo
Gráfico
de
Oracle
BI
Publisher
4. Una
vez
que
se
han
establecido
los
parámetros
para
Valores
y
Etiquetas,
podemos
hacer
clic
en
el
botón
“Presentación”
para
obtener
una
vista
previa
de
la
apariencia
que
ha
ganado
nuestra
gráfica.
Es
posible
que
se
muestre
la
leyenda
“No
válido”
en
lugar
de
la
vista
previa,
esto
podría
ser
un
error
en
la
configuración
de
los
parámetros
o
bien,
podría
deberse
a
que
la
información
de
ejemplo
del
esquema
XML
no
contiene
el
tipo
apropiado
para
generar
una
gráfica
de
muestra,
por
lo
que
habrá
que
esperar
hasta
ejecutar
el
reporte
para
visualizar
el
resultado.
Fig.
36
Configuración
de
la
gráfica
y
vista
previa
del
resultado
5. Finalizaremos
el
asistente
de
gráficas
dando
clic
en
el
botón
Aceptar.
Enseguida
deberemos
tener
agregada
en
nuestra
plantilla
RTF,
una
imagen
de
muestra
de
lo
que
representará
a
23
nuestra
gráfica.
En
este
punto,
podemos
darle
a
la
gráfica
el
tamaño
deseado
así
como
la
posición
que
tendrá
dentro
de
la
plantilla.
Es
importante
destacar
que
la
imagen
insertada
por
el
asistente,
deberá
conservar
las
características
de
imagen
y
no
se
le
deberán
agregar
propiedades
de
ningún
otro
tipo
de
objeto.
Finalmente,
nuestra
plantilla
podría
verse
como
se
muestra
a
continuación.
Fig.
37
Apariencia
de
la
plantilla
una
vez
insertada
la
gráfica
6. Es
posible
manipular
la
presentación
final
de
la
gráfica
en
cuanto
a
apariencia
y
también
en
lógica,
sin
embargo
esta
es
una
característica
que
no
está
disponible
a
través
del
complemento
para
Microsoft
Word
de
BI
Publisher.
Para
tal
efecto,
es
necesario
manipular
el
código
XML
que
genera
el
asistente,
el
cual
podremos
localizar
al
seleccionar
las
propiedades
de
la
imagen
(de
la
gráfica)
y
dentro
de
la
pestaña
“Texto
Alternativo”
(Figura
38).
7. Finalmente,
guardaremos
nuestro
documento
con
la
extensión
RTF
y
quedará
listo
para
utilizarse
en
la
definición
del
informe
correspondiente.
8. A
continuación
una
muestra
del
documento
resultante
después
de
la
ejecución
(Figura
39)
24
Fig.
38
Sentencias
XML
del
objeto
gráfico
incrustado
en
la
plantilla
vía
Oracle
BI
Publisher
Fig.
39
Resultado
de
la
ejecución
del
reporte
con
gráfica
25
Une
vez
que
se
cuenta
con
la
plantilla
que
determinará
la
presentación
de
los
datos
XML,
es
necesario
registrarla
dentro
de
la
aplicación
PeopleSoft
para
que
el
XMLP
pueda
combinarla
con
los
resultados
del
origen
de
datos,
para
lograr
esto
bastará
con
realizar
el
procedimiento
siguiente.
1. Ingresar
a
la
aplicación
PeopleSoft
y
mediante
la
barra
lateral
de
navegación
desplazarse
hasta
la
referencia
de
contenido
Herramientas
de
informes
>
XML
Publisher
>
Definiciones
de
Informes.
Enseguida
se
nos
mostrará
la
siguiente
pantalla:
Fig.
40
Definición
de
informes
XML
en
PeopleSoft
2. A
continuación
seleccionaremos
Añadir
un
Valor.
Los
siguientes
campos
son
obligatorios
Nombre
Informe
(escribir
el
ID
para
el
informe
que
deseamos
registrar),
*Tipo
Origen
Datos
(seleccionamos
“Consulta
PS”)
y
en
el
campo
ID
Origen
de
Datos
hacer
clic
sobre
el
icono
de
búsqueda
para
seleccionar
el
Origen
de
Datos
que
se
registró
previamente.
Hacer
clic
en
Añadir.
Fig.
41
Creando
una
nueva
definición
de
informe
26
Las
siguientes
pantallas,
nos
permitirán
establecer
las
propiedades
de
la
definición
de
reporte
que
estamos
registrando.
3. Dentro
de
la
pestaña
Definición,
en
la
sección
Propiedades
de
Informe
escribiremos
una
descripción
para
este
reporte,
el
campo
*Estado
Informe
debe
contener
el
valor
“Activo”
para
poder
ejecutar
este
reporte;
en
todo
reporte
activo
debe
haber
al
menos
una
plantilla
asociada.
El
campo
*ID
Categoría
Informe
permite
establecer
un
mecanismo
de
agrupamiento
de
seguridad
a
nivel
de
filas.
El
campo
Tipo
de
Plantilla
nos
permite
seleccionar
el
tipo
de
archivo
que
asociaremos
en
esta
definición,
para
nuestro
ejemplo,
seleccionaremos
RTF.
Fig.
42
Parámetros
de
configuración
de
la
sección
Definición
4. En
la
pestaña
Plantilla
estableceremos
un
identificador
único
para
cada
una
de
estas,
así
también
la
descripción,
idioma,
canal
de
distribución,
fecha
efectiva,
etc.
a
través
de
los
campos
*ID
Plantilla,
Descripción,
*Código
Idioma,
Canal
y
Fecha
Efectiva.
Debemos
asegurarnos
de
que
el
estado
es
“Activo”
para
la
plantilla
por
defecto.
Hacer
clic
en
el
botón
Cargar
para
que
una
nueva
página
nos
muestre
un
cuadro
de
diálogo
donde
podremos
indicar
la
ubicación
del
archivo
(RTF
en
este
caso)
que
se
subirá
al
servidor.
27
Fig.
43
Sección
“Plantilla”
de
la
definición
de
reporte
5. En
la
pestaña
Resultado
vamos
a
especificar
los
tipos
de
formato
de
salida
disponibles
para
este
reporte
así
como
el
formato
por
defecto.
Podemos
establecer
si
lo
deseamos,
una
ubicación
de
salida
específica.
Si
se
selecciona
PDF
podemos
determinar
si
el
reporte
generado
tendrá
permisos
de
edición.
Fig.
44
estableciendo
los
formatos
de
archivo
permitidos
6. En
la
pestaña
Seguridad
podremos
determinar
que
usuarios
tendrán
el
acceso
a
la
ejecución
del
reporte
limitándolo
a
ciertos
roles
o
usuarios
en
específico,
podremos
agregar
tantos
como
sea
necesario.
(fig.
45).
28
ejemplo
no
será
necesario
modificar
ningún
dato
de
esta
sección.
Para
finalizar,
haremos
clic
en
Guardar
para
completar
la
definición
del
reporte.
Fig.
43
Estableciendo
la
seguridad
del
reporte
Fig.
44
Pantalla
de
opciones
de
separación
Una vez concluidos los pasos anteriores, la definición del reporte ha quedado completada.
29
El
Visor
de
Informes
de
Consulta
nos
permite
seleccionar
y
visualizar
aquellos
reportes
que
tienen
como
origen
de
datos
una
consulta
de
PeopleSoft.
Las
características
de
seguridad
aplicadas
en
las
consultas
(origen
de
datos),
continúan
siendo
válidas
al
momento
de
la
ejecución
de
los
reportes
de
forma
tal
que
los
usuarios
tendrán
acceso
sólo
a
la
información
que
les
ha
sido
permitida.
Para
poder
visualizar
los
reportes
que
hemos
venido
trabajando,
seguiremos
el
siguiente
proceso:
1. Ingresar
a
la
aplicación
PeopleSoft
y
mediante
el
menú
de
navegación,
nos
desplazaremos
por
la
ruta
Herramientas
de
informes
>
XML
Publisher
>
Visor
de
Informes
de
Consulta.
En
seguida
visualizaremos
la
siguiente
pantalla:
Fig.
45
Visor
de
Informes
2. Podemos
ubicar
los
reportes
que
hemos
definido
previamente
utilizando
las
opciones
de
búsqueda
de
la
página,
ya
sea
por
nombre
de
informe,
descripción,
categoría,
nombre
del
origen
de
datos
entre
otros.
Una
vez
establecido
el
parámetro
de
búsqueda,
el
sistema
nos
devolverá
las
coincidencias
Fig.
46
Resultados
de
búsqueda
30
3. Finalmente,
para
visualizar
el
reporte,
basta
con
seleccionar
uno
de
los
formatos
de
archivo
de
salida
disponibles
en
la
lista
desplegable
o
bien
mantener
el
valor
por
defecto
y
hacer
clic
sobre
el
vínculo
“Ver
Informe”,
dependiendo
del
volumen
de
datos
o
complejidad
de
la
consulta
será
necesario
esperar
unos
minutos
hasta
finalmente
observar
en
pantalla
los
resultados.
31
32
1 2
3
4
3 5
Fig.
47
Documento
a
generar
Diseño
de
la
página
Para
la
ejecución
del
reporte
diseñaremos
una
página
con
características
similares
a
la
siguiente:
33
Fig.
48
Apariencia
de
la
página
de
ejecución
Fig.
49
Orden
de
la
página
de
ejecución
Diseño
de
los
componentes
del
reporte
XMLP
A
continuación
será
necesario
generar
las
consultas
que
se
van
a
utilizar,
en
este
ejemplo,
se
definieron
dos
diferentes
queries
(VTREH001
y
VTREH002).
El
primero
de
ellos
ejecuta
la
búsqueda
de
los
datos
que
conformarán
el
documento
para
un
solo
empleado
y
el
segundo
funcionará
cuando
el
usuario
deseé
datos
para
un
conjunto
de
empleados
determinado
por
el
rango
de
fechas.
Los
orígenes
de
datos
han
quedado
registrados
igualmente
con
los
nombres
VTREH001
y
VTREH002.
La
definición
de
los
informes
y
plantillas
se
configuró
de
la
siguiente
manera:
34
VTREH001
Fig.
50
Configuración
de
la
definición
del
informe
VTREH001
VTREH002
35
Fig.
10
Configuración
de
la
definición
del
informe
VTREH002
Añadiendo
el
PeopleCode
Dentro
del
campo
PUSH
(al
que
se
asocia
el
botón
de
comando)
del
registro
que
hemos
definido,
agregaremos
las
siguientes
líneas
de
código
dentro
del
evento
FieldChange
que
se
encargaran,
por
una
parte,
de
obtener
el
nombre
del
representante
de
RH
a
través
de
la
instrucción
SQLExec
y
posteriormente
de
llamar
a
la
función
“Bancaria_Empleado”
o
“Bancaria_Fechas”
y
enviarle
los
argumentos
para
la
operación
según
lo
establezcan
los
parámetros
dados
por
el
usuario
en
la
página.
&Emplid = VT_XMLEXEC_TBL.EMPLID.Value;
&Startdate = VT_XMLEXEC_TBL.START_DATE.Value;
&Enddate = VT_XMLEXEC_TBL.END_DATE.Value;
Evaluate VT_XMLEXEC_TBL.FLAG
When = "Y";
REM Reportes por Empleado específico;
If VT_XMLEXEC_TBL.FLAG1 = "Y" Then
Bancaria_Empleado(&sLangCd, &AsOfDate, &sOutFormat, &sPrcsServerName, &sFolder, 1, &Emplid, &Nombre_repr);
End-If;
When = "N";
REM Reportes por Rango de Fecha;
If VT_XMLEXEC_TBL.FLAG1 = "Y" Then
36
Break;
End-Evaluate;
A
continuación
la
definición
de
estas
funciones
dentro
del
evento
FieldFormula
del
campo
PUSH,
en
las
primeras
líneas,
estaremos
invocando
el
uso
de
las
clases
del
XML
Publisher.
import PSXP_RPTDEFNMANAGER:*;
import PSXP_REPORTMGR:*;
import PSXP_XMLGEN:*;
import PSXP_ENGINE:*;
/*Ejecución del query posterior al paso de los valores prompt necesarios para la ejecución */
&rcdQryPrompts = &oRptDefn.GetPSQueryPromptRecord();
If Not &rcdQryPrompts = Null Then
/*Asigna valores a prompt*/
&rcdQryPrompts.getfield(1).value = &EmplidCBE;
&rcdQryPrompts.getfield(2).value = &Nombre_reprCBE;
&oRptDefn.SetPSQueryPromptRecord(&rcdQryPrompts);
End-If;
/*publica reporte */
&oRptDefn.Publish(&sPrcsServerNameCBE, "", &sFolderCBE, &prcsInstId);
CommitWork();
/*Despliega Reporte*/
&oRptDefn.DisplayOutput();
End-Function;
/*Ejecución del query posterior a la obtención de los valores prompt necesarios para la ejecución */
&rcdQryPrompts = &oRptDefn.GetPSQueryPromptRecord();
If Not &rcdQryPrompts = Null Then
/*tantos prompts como el query requiera, incrementar el índice*/
&rcdQryPrompts.getfield(1).value = &FInicio;
&rcdQryPrompts.getfield(2).value = &FFin;
37
&rcdQryPrompts.getfield(3).value = &Nombre_reprCBF;
&oRptDefn.SetPSQueryPromptRecord(&rcdQryPrompts);
End-If;
/*genera reporte*/
&oRptDefn.ProcessReport(&sTmpltID, &sLangCdCBF, &AsOfDateCBF, &sOutFormatCBF);
/*publica reporte */
&oRptDefn.Publish(&sPrcsServerNameCBF, "", &sFolderCBF, &prcsInstId3);
CommitWork();
/*Despliega Reporte*/
&oRptDefn.DisplayOutput();
End-Function;
Una
vez
concluidos
estos
pasos,
podremos
obtener
el
documento
requerido
directamente
desde
la
página
de
ejecución.
38