© copyright ibm corp. 2011, 2015 · guía del usuario de creación de informes ibm. nota antes de...

44
IBM TRIRIGA Application Platform Versión 3 Release 5 Guía del usuario de creación de informes IBM

Upload: others

Post on 28-Jul-2020

0 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

IBM TRIRIGA Application PlatformVersión 3 Release 5

Guía del usuario de creación deinformes

IBM

Page 2: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

NotaAntes de utilizar esta información y el producto al que da soporte, lea la información del apartado “Avisos” en la página33.

Esta edición se aplica a la versión 3, release 5, nivel de modificación 0 de IBM TRIRIGA Application Platform y atodos los releases y modificaciones posteriores hasta que se indique lo contrario en nuevas ediciones.

© Copyright IBM Corporation 2011, 2015.

Page 3: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

Contenido

Capítulo 1. Gestor de informes de IBMTRIRIGA . . . . . . . . . . . . .. 1Tipos de informe . . . . . . . . . . . .. 1Creación de informes . . . . . . . . . .. 1

Creación de informes . . . . . . . . .. 1Adición de objetos de negocio a informes. .. 2Adición de informes relacionados . . . .. 2Establecimiento del acceso de seguridad parainformes . . . . . . . . . . . . .. 2Definición de columnas de informe . . . .. 3Aplicación de filtros a un informe . . . .. 3Filtración de registros en función deasociaciones . . . . . . . . . . .. 4

Especificación de valores de agregación parainformes de métricas . . . . . . . . . .. 4Profundizar en informes de métricas . . . . .. 4Informes del sistema. . . . . . . . . . .. 5

Capítulo 2. Creación avanzada deinformes en IBM TRIRIGA . . . . . .. 7Instalación de la aplicación BIRT. . . . . . .. 7Configuración de servidores de proceso de BIRT .. 7Instalación del plug-in de IBM TRIRIGA para BIRT . 8Actualización del plug-in de IBM TRIRIGA . . .. 8Proceso de informe de BIRT . . . . . . . .. 9

Informes iniciales en IBM TRIRIGA. . . . .. 9Creación de informes iniciales a partir deinformes de consulta. . . . . . . . .. 9Creación de informes iniciales a partir deformularios . . . . . . . . . . . .. 9

Importación de informes iniciales en BIRT . .. 9Creación de informes de BIRT . . . . . .. 10

Adición de orígenes de datos . . . . .. 10Conjuntos de datos . . . . . . . . .. 11Tipos de datos . . . . . . . . . .. 11

Parámetros . . . . . . . . . . .. 14Contexto para solicitudes de datos. . . .. 15Campos del sistema . . . . . . . .. 16Globalización . . . . . . . . . . .. 17Subinformes . . . . . . . . . . .. 18

Funciones personalizadas. . . . . . . .. 19Vista previa de informes BIRT . . . . . .. 20Exportación de informes BIRT . . . . . .. 21

Empaquetado de informes de BIRT . . .. 21Carga de informes en IBM TRIRIGA . . .. 21Bibliotecas de informes . . . . . . .. 21

Asociación de documentos a IBM TRIRIGA .. 22Asociación de documentos a informes deconsulta . . . . . . . . . . . .. 22Asociación de documentos a formularios .. 22

Configuración de acciones de impresión en masadespués de la migración de objetos . . . .. 23

Configuración de acciones de impresión enmasa en formularios de mantenimiento . .. 23Configuración de acciones de impresión enmasa en formularios de factura . . . . .. 24

Mantenimiento de informes . . . . . . .. 25Modificación de informes sin cambios deconjuntos de datos . . . . . . . . .. 25Modificación de informes con cambios deconjuntos de datos . . . . . . . . .. 26

Operadores de filtro . . . . . . . . . .. 26Valores especiales . . . . . . . . . . .. 28Nombres especiales en el campo de registro . .. 29

Avisos . . . . . . . . . . . . . .. 33Marcas registradas . . . . . . . . . . .. 35Términos y condiciones de la documentación delproducto . . . . . . . . . . . . . .. 35Declaración de privacidad en línea de IBM . . .. 36

© Copyright IBM Corp. 2011, 2015 iii

Page 4: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

iv © Copyright IBM Corp. 2011, 2015

Page 5: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

Capítulo 1. Gestor de informes de IBM TRIRIGA

Puede utilizar el Gestor de informes para filtrar, buscar y ordenar los informes.También puede enlazar a otros informes. Puede utilizar la herramienta Creador deinformes para generar y modificar informes.

En IBM® TRIRIGA, para tener botones de acciones en lugar de enlaces, establezcala propiedad SYSTEM_ACTION_STYLE en la carpeta TRIRIGAWEB.properties.

Tipos de informeEn el Gestor de informes puede crear informes que puede utilizar para buscar,filtrar, ordenar y enlazar a otros informes. Puede utilizar informes para mostrardatos.

La lista siguiente describe los tipos de informe:

InformeUn informe tabular básico.

GráficoUtiliza una consulta e información de gráficos web que están basados endibujos de diseño asistido por ordenador (CAD).

DiagramaMuestra los datos en un diagrama, como por ejemplo un diagrama circular,de barras, de líneas y de barras apiladas.

ResumenUn informe tabular que muestra los totales sin los registros de detalle.

JerarquíaUtiliza una consulta para mostrar información en una estructura jerárquica.

MétricaAgrega datos de instancia o tablas de datos en una tabla o un diagramacon rutas de detalle, filtros e informes relacionados.

Creación de informesPuede utilizar el creador de informes para crear informes que pueden filtrar,ordenar y buscar. Si ha creado un informe o si un grupo del que usted es miembrocomparte un informe del informe, puede ver el informe en la pestaña Misinformes.

Creación de informesPuede crear informes en la pestaña Mis informes. Hay varios tipos de informes.

Procedimiento1. En la pestaña Mis informes, especifique el nombre del informe. El convenio de

denominación consiste en un utilizar un prefijo de tres letras, como por ejemplotri_myreport o cst_myreport.

2. Especifique el ID. Utilice Personalizado o los estándares de numeración de suempresa para sus informes.

© Copyright IBM Corp. 2011, 2015 1

Page 6: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

3. Especifique la cabecera.4. Especifique una etiqueta para utilizar una agrupación adicional para el filtrado.5. Complete la descripción del informe.6. Seleccione el tipo de informe.7. Opcional: Marque el recuadro de selección Historial de seguimiento para ver

el historial de informe en la pestaña Historial.8. Opcional: En la pestaña Orden & Grupo, organice el diseño del informe.

Adición de objetos de negocio a informesLos objetos de negocio que están en un informe identifican los datos disponiblespara un informe. El informe solo funciona con los datos de los objetos de negocioespecificados.

Procedimiento1. En la subpestaña Objeto de negocio, seleccione Añadir objeto de negocio.2. Seleccione un módulo.3. Seleccione uno o varios objetos de negocio.4. Seleccione uno o varios formularios. Solo los datos asociados a los formularios

especificados se incluyen en el informe.5. Guarde el informe.6. Opcional: Para añadir un objeto de negocio hijo, seleccione el objeto de

negocio padre y seleccione Añadir objeto de negocio.7. Seleccione una o varias opciones asociadas.8. Opcional: Para expandir los datos que ve en el informe, quite la marca del

recuadro de selección Mostrar sólo asociaciones definidas en modelador dedatos.

9. para designar el objeto como el objeto de negocio asociado primario, marqueel recuadro de selección Objeto de negocio asociado primario. El objeto denegocio asociado primario está en la parte superior de una estructurajerárquica. Si quita la marca del recuadro de selección, el próximo objeto denegocio asociado de la estructura jerárquica es el objeto de negocio asociadoprimario.

10. Guarde el informe.

Adición de informes relacionadosUn informe relacionado es un informe autocontenido que tiene su propiadefinición y su propio formato. Muestra información adicional que puede serrelevante para quien la ve. Un informe principal puede tener más de un informerelacionado. Un informe relacionado no puede tener otro informe relacionado.

Procedimiento1. En la subpestaña Informes relacionados, seleccione Añadir.2. Seleccione el módulo.3. Seleccione los informes relacionados y seleccione Aceptar.4. Guarde el informe.

Establecimiento del acceso de seguridad para informesLa subpestaña Seguridad especifica los grupos que pueden acceder a un informe.El propietario del informe tiene privilegios de acceso completo.

2 © Copyright IBM Corp. 2011, 2015

Page 7: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

Procedimiento1. En la sección Acceso de seguridad, seleccione Añadir.2. Seleccione los grupos que acceden al informe y seleccione Aceptar.3. Seleccione Guardar.

Definición de columnas de informeLa pestaña Columnas definen qué campos se utilizan en el informe. Los camposque selecciona se muestran como columnas en el informe.

Acerca de esta tarea

La información de la pestaña Columnas se organiza en secciones. La secciónObjeto de negocio indica los objetos de negocio de origen. La sección Columnasidentifica qué campos del objeto de negocio seleccionado se deben incluir en elinforme. La sección Columnas de visualización especifica el orden en el que sepresentan los campos seleccionados y las etiquetas que se utilizan paraidentificarlos.

Procedimiento1. Seleccione los objetos de negocio.2. En la sección Columnas, marque el recuadro de selección para cada campo a

incluir en el informe.3. En la sección Columnas de visualización, edite el texto del cuadro de texto

Etiqueta de informe.4. Para especificar un porcentaje para el espacio de visualización para un campo,

especifique un valor numérico en el cuadro de texto Anchura.5. Seleccione Guardar.

Aplicación de filtros a un informeEn la pestaña Filtros puede especificar los campos, operadores y valores quedeterminan los resultados que se muestran en un informe. Los filtros seleccionadosse ejecutan secuencialmente. Los informes se ejecutan más rápidamente si el filtroque filtra la mayoría de registros se especifica primero, seguido del que filtra elsiguiente número de registros más elevado

Procedimiento1. Seleccione un objeto de negocio.2. En la sección Columnas, para cada campo que se utiliza como filtro, marque el

recuadro de selección en la columna Usuario o Sistema.3. En la sección Columnas de filtro de usuario y en la sección Columnas de filtro

del sistema, seleccione un campo y cambie la secuencia por la que se aplicanlos filtros.

4. Para cambiar la etiqueta que se muestra para un filtro, edite el texto en elcuadro de texto Etiqueta de informe. Si el campo es un campo de hora,especifique la hora en milisegundos o como una cadena en formato hh:mm:ss.

5. En el cuadro desplegable Operador de filtro, seleccione el operador de filtro decomparación.

6. Para filtros del sistema con un valor para tiempo de ejecución, especifique elvalor para la coincidencia. Para filtrar un campo Booleano, utilice los valoresTRUE o FALSE.

7. Seleccione el Operador de unión para organizar filtros del sistema en conjuntospara ajustar el orden por el que se aplican los filtros.

Capítulo 1. Gestor de informes de IBM TRIRIGA 3

Page 8: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

8. Seleccione Guardar.

Filtración de registros en función de asociacionesPuede utilizar la pestaña Avanzado para definir el tipo de registros asociados quese utilizan para filtrar los resultados del informe.

Procedimiento1. En la barra de sección Filtros de asociación, seleccione Añadir.2. Seleccione el módulo.3. Seleccione el objeto de negocio.4. Seleccione el tipo de asociación.5. Utilice el campo Tipo de filtro y el campo Registro/Consulta para especificar

qué registros desea utilizar para filtrar. Puede especificar un registro de filtradocon valores de nombre especiales.

6. Guarde el informe.

Especificación de valores de agregación para informes de métricasLos informes de métricas agregan datos a una tabla o un diagrama.

Procedimiento1. Abra el informe de métrica.2. En la pestaña Columnas, en la sección Valores de agregación, seleccione

Añadir.3. Especifique una etiqueta para el informe4. Seleccione una función.5. Especifique un número de secuencia.6. Seleccione Campo1 para especificar el campo en el que se produce la

agregación.7. Seleccione un eje de destino para identificar dónde se han mostrado los datos

agregados.8. Seleccione un color para representar la agregación.9. Seleccione Guardar.

Profundizar en informes de métricasPuede crear un informe gráfico de métricas para profundizar en los datossubyacentes de un informe. Después de crear un informe de métricas querepresenta los registros subyacentes, puede asociar el informe de métricas alinforme gráfico de métricas. Puede crear un informe de métricas creando uninforme cuyo tipo sea métrica.

Cuando selecciona un punto de datos en un informe, el sistema filtra los registrosen función de ese punto de datos. Por ejemplo, puede tener un informe gráfico demétricas que representa la suma del presupuesto original por estado. Si seleccionael punto de datos de estado Activo en el diagrama gráfico de métricas, solo semuestran los registros subyacentes cuyo estado sea Activo. A continuación, puedeprofundizar desde el diagrama de informe de métricas hasta el registro base.

Puede crear un informe gráfico de métricas de la misma forma que crea uninforme de métricas. Después de definir el informe de métricas, puede asociarlo al

4 © Copyright IBM Corp. 2011, 2015

Page 9: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

informe gráfico de métricas de destino. Para asociar los informes, abra el informegráfico de destino y vaya a la pestaña Ordenar y agrupar.

Informes del sistemaEn el Gestor de informes, los informes del sistema son informes estándar de IBMTRIRIGA. Un administrador del sistema puede designar informes del sistemacomo informes de comunidad.

Puede crear y ver informes del sistema en la pestaña Informes del sistema. Si uninforme del sistema está definido como un informe de comunidad, también puedeverlo en la pestaña Comunidad.

Puede crear un informe del sistema en cualquiera de los tipos de informe básicos,como por ejemplo diagrama o métrica o puede crear un informe del sistema de uno de los tipos siguientes:

ExternoUn informe creado con un software de terceros, como por ejemplo BIRT.

Legado de reservaUna consulta que devuelve los resultados solo de recursos disponibles.

ReservarUna consulta que actúa como la consulta Legado de reserva pero quetambién utiliza un calendario para determinar la disponibilidad derecursos.

Capítulo 1. Gestor de informes de IBM TRIRIGA 5

Page 10: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

6 © Copyright IBM Corp. 2011, 2015

Page 11: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

Capítulo 2. Creación avanzada de informes en IBM TRIRIGA

Puede utilizar IBM TRIRIGA Advanced Reporting para las presentaciones deinformes. IBM TRIRIGA Advanced Reporting utiliza la aplicación Eclipse BIRT yun plug-in de IBM TRIRIGA para la aplicación BIRT. Los informes de formulariomuestran el contenido de un solo registro. Los informes de consulta muestraninformes de varios registros.

El diseño de la aplicación BIRT está basado en cuadrícula y cada elemento debeexistir en un elemento de la cuadrícula de diseño de BIRT. Los diseños decuadrícula disponen elementos de informe en líneas, disponen verticalmenteelementos en columnas y dimensionan las columnas para que el contenido quepaen ellas. Puede utilizar cuadrículas para crear un informe arrastrando elementos aldiseño de informe.

Para poder desarrollar informes de BIRT para una aplicación de IBM TRIRIGA,debe instalar BIRT Report Designer y configurarlo para que funcione con IBMTRIRIGA.

Instalación de la aplicación BIRTPuede instalar el Diseñador de informes de BIRT una vez. Una vez iniciada lainstalación, asegúrese de que una versión soportada del JRE Java™ se instalalocalmente.

Acerca de esta tarea

Para las versiones soportadas, consulte la sección Compatibilidad de cliente IBMSupport Matrix.

Procedimiento1. Vaya a BIRT 4.3.1 en el sitio web de la biblioteca IBM Integrated Service

Management (ISM).2. Descargue BIRT Report Designer - All-in-One en un directorio local. El nombre

del directorio no puede incluir espacios.3. En la carpeta en la que ha descargado BIRT, extraiga el archivo

birt-report-designer-all-in-one-4_3_1.zip, abra la carpeta Eclipse, yseleccione el archivo eclipse.exe.

4. Seleccione la ubicación de espacio de trabajo en la que Eclipse almacena losarchivos de proyecto y seleccione Aceptar.

Configuración de servidores de proceso de BIRTPuede configurar un segundo servidor de IBM TRIRIGA para descargar y procesarinformes de BIRT en un proceso de BIRT aparte. Si no configura un servidor deprocesamiento aparte, el procesamiento de informes de BIRT se realiza en elservidor de aplicaciones.

Procedimiento1. Busque el archivo TRIRIGAWEB.properties.

© Copyright IBM Corp. 2011, 2015 7

Page 12: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

2. Establezca la propiedad BIRT_PROCESS_SERVER_LISTENING_PORT en el puerto TCPque comunica los dos servidores de IBM TRIRIGA. El servidor detectasolicitudes de BIRT en este puerto.

3. Establezca la propiedad BIRT_PROCESS_SERVER_HOST_NAME en el nombre de hosto la dirección IP del servidor de proceso de BIRT.

4. Establezca la propiedad de BIRT_PROCESS_SERVER_PORT en el puerto de escuchaque ha configurado en el servidor de proceso de BIRT.

5. Guarde el archivo TRIRIGAWEB.properties.6. Reinicie el servidor de proceso de BIRT.

Instalación del plug-in de IBM TRIRIGA para BIRTPara acceder a la creación avanzada de informes de IBM TRIRIGA, debe tener elplug-in de IBM TRIRIGA para BIRT instalado.

Procedimiento1. Abra la aplicación de BIRT y seleccione Ayuda > Instalar software nuevo.2. En el campo Trabajar con, especifique el URL siguiente para el sitio de

software de plug-in de IBM TRIRIGA: http://[servidor:puerto]/[vía deacceso]/eclipse. Utilice la [vía de acceso de contexto] solo si el servidor estáconfigurado con una vía e acceso de contexto.

3. Seleccione las Características de IBM TRIRIGA BIRT.4. Seleccione los detalles y seleccione Siguiente.5. Revise y acepte las licencias y seleccione Acabado.6. Reinicie la aplicación BIRT.7. En el campo Espacio de trabajo, seleccione el espacio de trabajo y seleccione

Aceptar.8. En la aplicación de Eclipse, seleccione Ventanas > Preferencias > Preferencias

de IBM TRIRIGA BIRT y especifique la información para conectar con elservidor de IBM TRIRIGA.

9. Seleccione Probar conexión y en el diálogo Conectado, seleccione Aceptar.10. Opcional: Configure las notificaciones de actualización.

a. Seleccione Ventanas > Preferencias, expanda la carpeta Instalar/Actualizary seleccione Actualizaciones automáticas.

b. Seleccione Buscar automáticamente actualizaciones nuevas y Notificarme.c. Seleccione las opciones Planificación de actualización, Descargar y

Cuando se encuentren actualizaciones.d. Seleccione Aplicar > Actualizar.

Actualización del plug-in de IBM TRIRIGACuando hay un release de IBM TRIRIGA disponible, puede actualizar el plug-in deIBM TRIRIGA en el entorno de BIRT Eclipse.

Procedimiento1. Abra la aplicación de BIRT y seleccione Ayuda > Acerca de Eclipse.2. Seleccione Detalles de instalación.3. En la pestaña Software instalado, seleccione IBM TRIRIGA BIRT Feature.4. Seleccione Actualizar.

8 © Copyright IBM Corp. 2011, 2015

Page 13: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

Proceso de informe de BIRTLos redactores de informes crean informes de BIRT. Los informes de BIRT son untipo de informe avanzado para representaciones de informes.

Los pasos siguientes describen el proceso de informes de BIRT:1. Cree un informe inicial en IBM TRIRIGA.2. Importe un informe inicial en BIRT Report Designer.3. Desarrolle un informe de BIRT.4. Obtenga una vista previa del informe de BIRT.5. Exporte un informe de BIRT.6. Cargue un informe de BIRT a IBM TRIRIGA.7. Asocie el informe de BIRT con un punto de acceso de IBM TRIRIGA.

Informes iniciales en IBM TRIRIGALos archivos de informe inicial se descargan de la aplicación de IBM TRIRIGA.Puede crear informes a partir de un informe existente, un informe de consulta o deun formulario.

Creación de informes iniciales a partir de informes de consultaPuede crear un informe inicial a partir de un informe de consulte de IBM TRIRIGAnuevo o existente. Los informes de consulta pueden contener datos de registros denivel superior. También pueden contener varios niveles de detalle accesiblesmediante objetos de negocio y registros asociados. A menudo, los informes deconsulta muestran informes de varios registros.

Procedimiento1. En el Gestor de informes de IBM TRIRIGA vaya al informe o a la consulta a

utilizar como modelo.2. Seleccione Avanzado y seleccione el enlace Informe BIRT.3. Seleccione Guardar.4. Seleccione la ubicación para la descarga del archivo inicial y seleccione

Guardar.

Creación de informes iniciales a partir de formulariosPuede crear un informe inicial a partir de un formulario de IBM TRIRIGA nuevo oexistente. Los informes de formulario contienen normalmente datos de un registrode nivel superior. Pueden contener datos de uno o varios registros asociados. En lapestaña Informes de un registro, puede seleccionar informes de formulario.También puede ejecutar un informe de formulario para visualizar el formulariopara varios registros de nivel superior.

Procedimiento1. En el Creador de formularios de IBM TRIRIGA, seleccione Diseño y seleccione

el enlace Informe BIRT.2. Seleccione Guardar.3. Seleccione la ubicación de descarga de archivo inicial y seleccione Guardar.

Importación de informes iniciales en BIRTPuede importar informes iniciales de IBM TRIRIGA en el Diseñador de informesde BIRT.

Capítulo 2. Creación avanzada de informes en IBM TRIRIGA 9

Page 14: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

Acerca de esta tarea

Si su herramienta de extracción de archivos comprimidos lo permite, puede abrirel archivo .zip y, en el panel Navegador del Diseñador de informes de BIRT,arrastre los archivos a un proyecto de informe determinado.

Procedimiento1. En BIRT seleccione Archivo > Nuevo > Proyecto.2. Seleccione la carpeta Business Intelligence, seleccione Proyecto de informe >

Siguiente.3. Especifique el nombre del proyecto y seleccione Acabado.4. En la ventana Diseño de informes seleccione Navegador, pulse con el botón

derecho del proyecto y seleccione Importar.5. Seleccione el archivo comprimido que descargó cuando creó un informe inicial

en IBM TRIRIGA y seleccione Acabado.6. Verifique que el informe inicial se muestra en la pestaña Navegador.

Creación de informes de BIRTPara crear un informe de BIRT, debe utilizar BIRT Report Designer para modificarel archivo .rptdesign importado. Los informes de BIRT contienen información quees IBM TRIRIGA.

Adición de orígenes de datosEn informes de BIRT, es accede a todos los datos a través de orígenes de datos. Uninforme inicial incluye un único origen de datos llamado TRIRIGA. TRIRIGA es unorigen de datos en script. Todos los conjuntos de daos que obtienen sus datos deun servidor de IBM TRIRIGA deben utilizar este origen de datos.

Acerca de esta tarea

Si el origen de datos de TRIRIGA no proporciona todos los datos necesarios, puedeutilizar los métodos de acceso de datos a los que BIRT de soporte, lo que incluyeJDBC y XML. Debe añadir manualmente el origen de datos JDBC y éste debellamarse TRIRIGA_DB. En tiempo de ejecución, el informe se modifica de modo queinteractúa con la base de datos de IBM TRIRIGA que está asociada al servidor enel que se está ejecutando el informe.

Procedimiento1. En BIRT, seleccione Explorador de datos.2. Pulse con el botón derecho del ratón sobre Orígenes de datos y seleccione

Origen de datos nuevo.3. Seleccione Origen de datos JDBC y en el campo Nombre de origen de datos,

especifique TRIRIGA_DB.4. Seleccione Siguiente.5. Opcional: Seleccione Clase de controlador y especifique el URL, el nombre de

usuario y la contraseña de la base de datos.6. Especifique el URL, el nombre de usuario y la contraseña de la base de datos.7. En el campo URL JNDI, especifique jdbc/local/Datasource-TRIRIGA-data y

seleccione Acabado.8. Pulse con el botón derecho Conjuntos de datos y seleccione el nombre de

conjunto de datos nuevo.9. Especifique la sentencia SQL.

10 © Copyright IBM Corp. 2011, 2015

Page 15: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

10. Opcional: Añada parámetros.11. Seleccione Acabado.

Conjuntos de datosUn informe inicial contiene un conjunto de datos como mínimo. El conjunto dedatos modela el informe de IBM TRIRIGA o el formulario creado originalmentepor el informe de BIRT.

El nombre del conjunto de datos representa el informe o formulario de IBMTRIRIGA. Por ejemplo, un conjunto de datos que modela el informetriFiscalPeriods_-_Buscar_-_Años se llama[v2QRY]Classification_triFiscalPeriods_triFiscalPeriods_-_Buscar_-_Años.

Un informe inicial exportado desde una consulta de IBM TRIRIGA tiene unconjunto de datos. El conjunto de datos tiene columnas que corresponden a lascolumnas de la consulta de IBM TRIRIGA. Por ejemplo, el informe de IBMTRIRIGA triFiscalPeriods - Buscar -Años tiene las columnas siguientes: Nombre,Fecha de inicio, Fecha de finalización y Ruta de jerarquía.

Un informe inicial exportado desde un formulario de IBM TRIRIGA puede tenervarios conjuntos de datos. Existe un conjunto de datos en el informe inicial con elprefijo [v2BO]. El conjunto de datos representa los datos de nivel superior delformulario y tiene columnas que corresponden a los campos de objeto de negociopara el objeto de negocio de nivel superior del formulario.

Cada Sección inteligente del objeto de negocio de un formulario se representacomo un conjunto de datos con el prefijo [v2SS]. Estos conjuntos de datos deSección inteligente tienen columnas correspondientes a los campos de objeto denegocio en esas secciones. El parámetro de entrada system__parentRecordIdespecifica los datos a recuperar para este conjunto de datos.

Cada sección de consulta del formulario se representa como un conjunto de datosde consulta normal y tiene el prefijo [v2QRY]. El parámetro de entradasystem__parentRecordId incorporado especifica los datos a recuperar para esteconjunto de datos.

En el informe inicial, los parámetros de entrada system__parentRecordId no estánenlazados al conjunto de datos de objeto de negocio de nivel superior. Debeenlazar los parámetros dentro del diseño de informe.

Tipos de datosPara conservar datos de IBM TRIRIGA, el sistema devuelve todos los datos decampo de objeto de negocio de IBM TRIRIGA en forma de objetos Java. Todos losinformes iniciales tienen columnas de salida modeladas como objetos Java.

Utilice las directrices siguientes para los objetos Java:v Cuando utiliza un valor en el informe, debe conocer el tipo de BIRT al que

corresponde.v Si utiliza valores frecuentemente, será necesario crear más scripts.v Cuando arrastra un elemento de IBM TRIRIGA directamente a un informe, el

elemento se muestra en el informe.

Para utilizar la columna de salida para otra cosa que no sea la visualización, puedeacceder al valore de SQL de la columna de salida en cualquier expresión de BIRTutilizando el método getNativeValue() del objeto.

Capítulo 2. Creación avanzada de informes en IBM TRIRIGA 11

Page 16: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

Por ejemplo, en el Creador de expresiones, especifique el valor siguiente:row["Classification_triFiscalPeriods_triStartDA"].getNativeValue().

Si el objeto Java tiene métodos adicionales, puede acceder a ellos utilizandocualquier expresión de BIRT. Al enlazar uno de esos resultados de expresiones a unelemento de informe, seleccione el tipo de BIRT adecuado para acceder a todas lasfunciones de BIRT incorporadas.

Cuando pone la columna de salida en el informe, BIRT utiliza automáticamente elmétodo toString(). Para acceder al valor, utilice el script menor siguiente:row["Classification_triFiscalPeriods_triStartDA"].getNativeValue().

Cuando exporta un informe inicial, todos los datos corresponden a objetos Javadentro de BIRT. Cada objeto Java tiene como mínimo los métodos getNativeValue()y toString().

Objetos Java:

Cuando exporta un informe inicial, se establece una correspondencia entro todoslos datos y los objetos Java dentro de BIRT. Cada objeto Java tiene los métodosgetNativeValue() y toString().

La tabla siguiente proporciona información para métodos adicionales para objetoJava y tipo de campo de objeto de negocio,

Tabla 1. Objetos Java

Tipo de campo deobjeto de negocio

Resultado degetNativeValue()

Considera-ciones detoString()

Métodosadicionales

EnlaceBIRTsugeridosi utilizael valornativo

Texto java.lang.String N/D N/D Cadena

Número

Resumen financiero

java.math.BigDecimal

Metadatos deUdM ymascaras decampo deobjeto denegocio

getUom().getUomTypeCode()

getUom.getUomValue()

Tiene Uom()devuelve false sino hay UdM.

Decimal

Resumen declasificación

java.math.BigDecimal

Máscaras decampo deobjeto denegocio

N/D Decimal

Fecha java.sql.Date Huso horariodel usuario yformato devisualizaciónpreferente

N/D Fecha

FechaHora java.sql.Date Huso horariodel usuario yformato devisualizaciónpreferente

N/D FechaHora

12 © Copyright IBM Corp. 2011, 2015

Page 17: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

Tabla 1. Objetos Java (continuación)

Tipo de campo deobjeto de negocio

Resultado degetNativeValue()

Considera-ciones detoString()

Métodosadicionales

EnlaceBIRTsugeridosi utilizael valornativo

Hora java.sql.Time Se visualizacomohoras/minutos/segundos sinconsideracionesde husohorario.

N/D Hora pararesultadossignifica-tivos deeste valor,utilice uncalendariode GMT.

Ubicador java.lang.String N/D N/D Cadena

Duración java.lang.Long

Un solo valor quecodifica loscomponentes deduración en unsolo valor. Sealmacena en la basede datos de IBMTRIRIGA pararepresentar unvalor de duracióndeterminado.Puede que estevalor no representeel número total demilisegundos parala duracióndeterminada.

Formatos queutilizan elformatopreferente deIBM TRIRIGAy tienen encuenta elidioma delusuario.

N/D Decimal

Clasificación java.lang.String(valor notraducido)

Vía de accesode jerarquíacompleta de laopción decampo deobjeto denegocio eidioma delusuario

N/D String

Lista java.lang.String (notraducido

Idioma delusuario

N/D String

Booleano java.lang.Boolean N/D N/D Booleano

Imagen byte[] Devuelve lavía de accesoa la imagen talcomo sealmacena en labase de datosde IBMTRIRIGA

N/D Imagen

Capítulo 2. Creación avanzada de informes en IBM TRIRIGA 13

Page 18: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

Tabla 1. Objetos Java (continuación)

Tipo de campo deobjeto de negocio

Resultado degetNativeValue()

Considera-ciones detoString()

Métodosadicionales

EnlaceBIRTsugeridosi utilizael valornativo

Binario byte[] Representaciónde cadena delID decontenido, laclave de latablaDM_CONTENT

N/D Blob

UdM java.lang.String

(Valor notraducido)

getUomValue()traducido alidioma delusuario actual

getUom().getUomTypeCode()

getUom.getUomValue()

getUomValue() esNULL si no hayvalor

Cadena

Contraseña java.lang.String N/D N/D Cadena

SystemField_BoRecordId

java.lang.Long N/D N/D Decimal

SystemField_ java.lang.Long N/D N/D Decimal

SystemField_ModifiedDate Time

java.sql.Date Huso horariodel usuario yformato devisualizaciónpreferente.

N/D FechaHora

SystemField_CreatedDate Time

java.sql.Date Huso horariodel usuario yformato devisualizaciónpreferente

N/D FechaHora

SystemField_ModifiedDateTimeNumber

java.sql.Date Huso horariodel usuario yformato devisualizaciónpreferente

N/D FechaHora

SystemField_ProjectId

java.lang.Long N/D N/D Decimal

SystemField_BoTypeId

java.lang.Long N/D N/D Decimal

SystemField_Parent java.lang.Long N/D N/D Decimal

ParámetrosEn IBM TRIRIGA, las consultas y los informes tienen parámetros que filtran losdatos devueltos por las consultas. En el Gestor de informes, puede utilizar losfiltros para configurar filtros de consulta y de informe.

14 © Copyright IBM Corp. 2011, 2015

Page 19: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

Si un conjunto de datos de BIRT utiliza una consulta de IBM TRIRIGA y esaconsulta tiene filtros de entrada de usuario, cada filtro se muestra en un informeinicial. Los filtros se muestran en la pestaña Explorador de datos como entrada denivel superior en la carpeta Parámetros de informe. Este parámetro de informedefine la solicitud de usuario que se produce antes de la ejecución del informe. Losfiltros se muestran también en la sección Parámetros como un parámetro delconjunto de datos que modela la consulta de IBM TRIRIGA. La entada pasa elvalor del parámetro de informe especificado para el conjunto de datos.

Cuando se necesita un filtro, la consulta de IBM TRIRIGA con un filtro de usuarioaparece como una solicitud de usuario filtra los resultados en función de ladefinición de consulta de IBM TRIRIGA.

La etiqueta predeterminada para un campo es la etiqueta del campo Objeto denegocio. Puede añadir una etiqueta personalizada y texto de ayuda para esosparámetros de informe.

Si un informe tiene varios filtros de usuario en el mismo campo, se muestran todoslos filtros en el informe. BIRT identifica parámetros mediante un sufijocorrespondiente a sus posiciones en la consulta.

BIRT no permite distinguir entre un filtro a ignorar y un valor de filtro NULL. Siselecciona NULL para un parámetro de informe correspondiente a un filtro deconsulta de IBM TRIRIGA, el filtro no se utiliza.

Para los tipos de parámetro que son texto, puede especificar un valor NULL y elmotor de consulta de IBM TRIRIGA utiliza NULL como el valor de filtro.

La integración de IBM TRIRIGA BIRT solo procesa correctamente el filtro delparámetro Time cuando utiliza un tipo de datos String para el parámetro Time. Siutiliza un tipo de datos Time para el filtro del parámetro Time, el visor deTRIRIGA BIRT no muestra un error pero no filtra los resultados adecuadamente.

La integración de IBM TRIRIGA BIRT procesa formatos de fecha y de fecha y horadistintos del inglés en los parámetros de filtro Date y Date Time solo si se hanestablecido como tipos de datos String.

Contexto para solicitudes de datosEn IBM TRIRIGA, debe añadir contexto a solicitudes de datos. El contexto esnecesario para el usuario actual, el registro y el proyecto.

El entorno de vista previa de BIRT proporciona el contexto de usuario de lapreferencias de BIRT de IBM TRIRIGA. El entorno de tiempo de ejecución de IBMTRIRIGA obtiene datos de usuarios con sesión iniciada.

En los entornos de vista previa de BIRT y tiempo de ejecución de IBM TRIRIGA, elcontexto de registro pasa a través del informe de BIRT como un parámetro deinforme y llega hasta los conjuntos de datos.

Un informe inicial para una consulta tiene un parámetro de informesystem__parentRecordId oculto no necesario. Para el conjunto de datos de consulta,tiene un parámetro de entrada system__parentRecordId. Cuando el informe seejecuta, si se pasa un valor distinto de cero a través del parámetro a IBM TRIRIGA,se convierte en el valor $$RECORDID$$ cuando se ejecuta la consulta de IBMTRIRIGA.

Capítulo 2. Creación avanzada de informes en IBM TRIRIGA 15

Page 20: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

En un informe inicial para un formulario, el parámetro system__recordIds es unparámetro de informe necesario. El parámetro system__recordIds es una lista deIDs de registro delimitados por comas que el informe de formulario representa.Puede utilizar varios IDs para los requisitos de la creación de informes en masa.

En un entorno de vista previa de BIRT, se utiliza una solicitud para recopilar elvalor de system__recordIds para obtener una vista previa del informe deformulario. El parámetro system__recordIds siguiente es un ejemplo:system_recordIds 1590609, 1345105, 1295530.

En una definición de informe, incluso aunque el informe tenga un parámetroconfigurado como no oculto, la solicitud no se muestra dentro de un entorno detiempo de ejecución de IBM TRIRIGA porque el entorno de tiempo de ejecuciónproporciona el valor.

En el entorno de vista previa de BIRT, puede especificar un contexto de proyectoen la sección de preferencias de IBM TRIRIGA BIRT mediante la entrada del ID deproyecto. El entorno de vista previa de BIRT utiliza la entrada del ID de proyectopara proporcionar contexto de proyecto para cualesquiera solicitudes de IBMTRIRIGA.

Campos del sistemaAlgunos campos incorporados en un informe de BIRT no están incorporados encampos de objeto de negocio de IBM TRIRIGA.

La tabla siguiente contiene campos del sistema con nombres especiales que tienenun significado especial para la integración de IBM TRIRIGA-BIRT.

Tabla 2. Campos del sistema

Campo del sistema Uso Descripción

system__recordIds Parámetro de entrada deconjunto de datos paraconjuntos de datos de objetode negocio.

Parámetro de entrada deinforme para informes deformulario.

Lista delimitada por comasde IDs de registro quecontrolan los registrosdevueltos de los informes deformulario. Necesario si noutiliza el parámetro deentrada de system_recordId.

system__recordId Parámetro de entrada deconjunto de datos paraconjuntos de datos de objetode negocio.

Valor numérico querepresenta un solo registropara volver de un conjuntode datos de objeto denegocio. Para un informe deconsulta, este campo esobligatorio. Para un informede formulario, este campo esobligatorio si no utiliza elparámetro de entradasystem_recordIds.

16 © Copyright IBM Corp. 2011, 2015

Page 21: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

Tabla 2. Campos del sistema (continuación)

Campo del sistema Uso Descripción

system_parentRecordId Parámetro de entrada deconjunto de datos paraconjuntos de datos deconsulta.

Parámetro de entrada deconjunto de datos paraconjuntos de datos desección inteligente.

Parámetro de entrada deinforme para informe deconsulta.

Proporciona contexto deregistro para informes yconjuntos de datos.

para secciones inteligentes,system_parentRecordId es unvalor obligatorio quecontrola qué datos de secciónde registro se debe devolver.

Para conjuntos de datos deconsulta, las variables$$RECORDID$$ y $$PARENTse utilizan en una definiciónde consulta de IBMTRIRIGA.

system__recordId Columna de salida paratodos los tipos de conjuntosde datos de IBM TRIRIGA.

Cada conjunto de datos deIBM TRIRIGA tiene unacolumna de salida llamadasystem_recordId. Lacolumna contiene el ID deregistro del registro devuelto.El único caso en el que estacolumna se devuelve con unvalor NULL es en el caso deuna referencia que no pasarácon una sección inteligentemodificada. En ese caso, nohay registro de IBMTRIRIGA incorporado.

system__sourceRecordId Columna de salida deconjunto de datos paraconjuntos de datos desección inteligente.

Cada conjunto de datos desección inteligente tiene unacolumna de salida llamadasystem_sourceRecordId. Elvalor aloja los datos a partirde los que se inicializó unregistro de seccióninteligente, lo que se llamallamado el registro de origen.system_sourceRecordIdayuda a diferencia el registrode sección del registro deorigen.

GlobalizaciónLos informes iniciales y la integración IBM TRIRIGA-BIRT tienen característicasque le ayudan a globalizar informes. Antes de exportar etiquetas para informes deBIRT, asegúrese de que esos informes están configurados en IBM TRIRIGA.

La integración IBM TRIRIGA-BIRT para la localización de fechas. La serie devisualización para cualquier campo de Fecha o de FechaHora de IBM TRIRIGA seformatea en el formato de fecha preferente del usuario. Además, la funciónpersonalizada formatDate() y formatDateTime() presentan una Fecha o FechaHorade BIRT en el formato de fecha preferente del usuario de IBM TRIRIGA.

Capítulo 2. Creación avanzada de informes en IBM TRIRIGA 17

Page 22: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

IBM TRIRIGA convierte todas las etiquetas del informe de BIRT. El informe inicialincluye todas las etiquetas necesarias para traducir las etiquetas de campo deobjeto de negocio de un informe.

Un informe inicial está asociado a un archivo de propiedades de recursos con unaextensión tririgalabels.properties. Puede ver esta asociación en la secciónRecursos en la pestaña Editor de propiedades – Informe. Este recurso de informeseñala un archivo de propiedades que contiene claves de etiqueta para cada campode objeto de negocio incorporado en el informe.

En el informe inicial, cada clave ya está asociada a la columna de salida deconjunto de datos en BIRT. Si utiliza el Explorador de datos como un lienzo, puedearrastrar elementos al lienzo sin tener que volver a asociar las claves devisualización para esos elementos. Si no arrastra elementos al lienzo, puede utilizartodas las etiquetas del archivo de propiedades en cualquier elemento de informe.Puede utilizar las etiquetas en el archivo de propiedades cuando selecciona unelemento de informe en el diseño y navega a la sección Propiedades delocalización en la pestaña Propiedades de la pestaña Editor de propiedades –Etiqueta. En tiempo de ejecución, el texto que utiliza estas claves se traduce enfunción del idioma del usuario actual.

Si necesita una etiqueta en su informe que no está disponible desde el archivo depropiedades de informe inicial, puede añadir claves y etiquetas al archivo. Elnombre de clave no puede empezar con el prefijo especial [FIELD]. IBM TRIRIGApuede traducir cualquier etiqueta creada.

Una biblioteca de informes de BIRT puede alojar elementos de informereutilizables, incluidas las etiquetas. Puede crear un archivo de propiedades con laextensión tririgalabels.properties y referirse a ese archivo de propiedades comoun recurso de bibliotecas. Para ver un archivo de propiedades para una bibliotecade informes de BIRT, seleccione la biblioteca en el navegador de BIRT y vea laspropiedades en la pestaña Editor de propiedades – Biblioteca. Para leer labiblioteca, cada informe de BIRT debe hacer referencia a la biblioteca antes deexportar y actualizar el informe a IBM TRIRIGA.

SubinformesPuede construir subinformes en el nivel superior de un informe o ponerlos enarchivos .rptdesign.

Por ejemplo, un informe puede mostrar cabeceras de orden de compra. Para cadacabecera, un informe puede mostrar líneas de detalle para esa orden de compra enconcreto. En este caso los elementos de detalle de orden de compra se muestrancomo un subinforme de los datos de cabecera de orden de compra.

Puede construir subinformes en el archivo .rptdesign como el informe principal.Un solo informe puede mostrar años fiscales y trimestres fiscales, donde los añosfiscales son los registros padre y el informe visualiza los trimestres fiscales paracada año fiscal.

Utilice las directrices siguientes para informes individuales:v Un ID de registro se devuelve para cada resultado de un conjunto de datos

padre.v La consulta de IBM TRIRIGA hijo filtra los resultados en función del registro

padre.

18 © Copyright IBM Corp. 2011, 2015

Page 23: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

v El conjunto de datos hijo toma un ID padre como parámetro. Si BIRT envía unsystem_parentRecordId con un valor predeterminado 0, el sistema IBM TRIRIGAlo ignora.

v En la tabla hijo del diseño de informe, el conjunto de datos Enlace de parámetroenlaza el ID del registro padre al parámetro de entrada del conjunto de datoshijo.

Puede construir subinformes en diferentes archivos de .rptdesign. Por ejemplo,puede mostrar todos los años fiscales en una sola lista que utiliza un hiperenlacepara llevar al usuario a los trimestres del año seleccionado. En este caso, lostrimestres fiscales son un archivo .rptdesign aparte.

Utilice las directrices siguientes para separar archivos de informe:v En el nivel superior de cualquier archivo comprimido que importe en IBM

TRIRIGA debe haber un archivo .rptdesign como mínimo. Cualesquierasubinformes de otros archivos .rptdesign deben estar en un directorio hijo.

v Cuando configura un hiperenlace, el system__recordId del informe de nivelsuperior debe estar enlazado con el parámetro de informesystem__parentRecordId el subinforme. Un ejemplo de esto incluye años fiscalesy trimestres fiscales.

Funciones personalizadasLas funciones personalizadas le ayudan con los casos de uso particulares. Lasfunciones personalizadas están en la categoría TRIRIGA del Creador deexpresiones de BIRT.

La tabla siguiente describe las funciones personalizadas:

Tabla 3. Funciones personalizadas. Funciones personalizadas

Nombre Descripción Entradas Devolución

formatNumber Utiliza IBM TRIRIGApara formatear unnúmero.

number - BigDecimal:valor de número aformatear

unitOfMeasure -TriResultUom:unidad de medidautilizada paraformatear el número.Puede utilizar unvalor NULL si nohay ninguna UdMdisponible, pero debeutilizar la entradaencodedBoFieldName.

encodedBoFieldName- String [opcional]:campo de objeto denegocio del queproviene estenúmero. Utilícelocuando procedaporque los metadatosde campo puedenafectar al formato delos números.

Cadena: el númeroformateado.

Capítulo 2. Creación avanzada de informes en IBM TRIRIGA 19

Page 24: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

Tabla 3. Funciones personalizadas (continuación). Funciones personalizadas

Nombre Descripción Entradas Devolución

formatDate Utiliza IBM TRIRIGApara formatear unafecha. Utiliza suformato preferenteespecificado en elregistro de perfil deusuario.

date - java.util.Date:fecha a formatear

Cadena: la fechaformateada.

formatDateTime Utiliza IBM TRIRIGApara formatear unafecha y hora. Utilizasu formato preferenteespecificado en elregistro de perfil deusuario.

dateTime -java.util.Date:DateTime a formatear

Cadena: la fecha yhora formateada.

getProjectIdFor-Record

Devuelve el ID deregistro del proyectoen el que está elregistro. DevuelveNULL si el registrono está en unproyecto.

ID del registro.Normalmente, elvalor desystem__recordId deun registro deresultados de IBMTRIRIGA.

Decimal: el ID delproyecto en el queestá el registro.

getRootOrganiza-tionId

Devuelve el ID deregistro de laorganización raíz.

N/D Decimal: el ID delregistro deorganización de laraíz de IBMTRIRIGA.

getCompany-LogoId Devuelve el ID deldocumento dellogotipo de laempresa.

N/D Decimal: el ID deldocumento dellogotipo de laempresa.

getProjectLogoId Devuelve el ID deldocumento dellogotipo del proyectoactual.

N/D Decimal: el ID deldocumento dellogotipo del proyectoactual.

getUserId Devuelve el ID delusuario con sesióniniciada actualmente.

N/D Decimal: el ID delusuario actual.

getProjectId Devuelve el ID delproyecto actual.Devuelve NULL si elusuario no estáactualmente en unproyecto.

N/D Decimal: el ID delproyecto actual.

Vista previa de informes BIRTPuede obtener vistas previas de informes mediante la pestaña Vista previa delDiseñador de informes de BIRT. En la aplicación BIRT, puede establecer valores enla sección Preferencias de IBM TRIRIGA BIRT para pasar contexto de IBMTRIRIGA a un informe BIRT durante la ejecución de vista previa. Puede establecerlos valores de preferencias cuando especifica la información en el servidor de IBMTRIRIGA.

20 © Copyright IBM Corp. 2011, 2015

Page 25: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

Puede pasar los tipos de contenido siguientes:

Usuario actualEstablezca cuando desea especificar los valores de servidor de aplicaciones, nombre de usuario y campo de contraseña de IBM TRIRIGA.

Proyecto activoEstablezca esta opción cuando especifique el ID de registro de un proyectodeterminado. El proyecto activo hace que la vista previa simule laejecución en el contexto del proyecto de Capital especificado.

Parámetros de entradaSolicitado por la aplicación de BIRT. Al obtener una vista previa delinforme, la aplicación de BIRT le solicita parámetros de entrada definidosen el informe. Esos valores también sirven como contexto de la ejecucióndel informe.

Exportación de informes BIRTPuede exportar informes de BIRT de vuelta a IBM TRIRIGA para que el entorno deIBM TRIRIGA pueda utilizar los informes.

Empaquetado de informes de BIRTAntes de exportar el informe de BIRT de vuelta a IBM TRIRIGA, empaquete elinforme como archivo .zip.

Procedimiento1. En BIRT, pulse con el botón derecho sobre el proyecto y seleccione Exportar.2. Expanda la carpeta general, seleccione Archivo de archivado y seleccione

Siguiente.3. Seleccione Construcción de informe.4. Seleccione los archivos .rptdesign y tririgalabels.properties.5. En el campo Al archivo de archivado, renombre el archivo .zip nuevo y

seleccione la ubicación de carga.6. Seleccione las opciones que desea utilizar.7. Seleccione Acabado.

Carga de informes en IBM TRIRIGAPuede utilizar el Gestor de documentos para cargar el archivo .zip empaquetadoen IBM TRIRIGA.

Procedimiento1. En IBM TRIRIGA, abra el Gestor de documentos.2. Expanda la carpeta IBM TRIRIGA.3. Seleccione o cree la carpeta de carga. Puede utilizar un nombre de carpeta

correspondiente al módulo del informe inicial y la consulta de IBM TRIRIGA.4. Seleccione Documento nuevo, seleccione Examinar y seleccione el archivo de

informe de BIRT.5. Especifique un nombre de documento.6. Opcional: Especifique los valores de campo.7. Seleccione Cargar y seleccione Aceptar.

Bibliotecas de informesUna biblioteca de informes es una construcción de BIRT que aloja componentesreutilizables que se comparten en varios informes.

Capítulo 2. Creación avanzada de informes en IBM TRIRIGA 21

Page 26: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

Puede cargar una biblioteca de informes de la misma forma que carga un informe.

Puede cargar las bibliotecas de informes en el sistema Gestión de documentos deIBM TRIRIGA y en la carpeta \ROOT\TRIRIGA\BIRT Libraries. Si esta estructura decarpetas no existe en su sistema, cree la carpeta.

La biblioteca de informes se puede cargar como un archivo .rptlibrary simple ocomo un archivo .zip.

El nombre del documento de IBM TRIRIGA debe coincidir con el nombre delarchivo .rtplibrary.

Si la biblioteca contiene etiquetas, el archivo .rptlibrary puede hacer referencia alarchivo tririgalabels.properties que puede tener etiquetas traducibles.

Asociación de documentos a IBM TRIRIGAPara poder utilizar un informe de BIRT, debe asociar el documento de IBMTRIRIGA a un punto de acceso de IBM TRIRIGA. Los puntos de acceso son uninforme de consulta o un informe de formulario.

Asociación de documentos a informes de consultaPuede crear una consulta de IBM TRIRIGA como consulta externa. La consultaactúa como enlace al archivo BIRT .rpt que ha cargado en el Gestor dedocumentos. En el Gestor de documentos, puede seleccionar el informe de BIRT.Puede utilizar el informe en muchos lugares a través de IBM TRIRIGA, como porejemplo secciones de formulario y secciones de portal.

Procedimiento1. En IBM TRIRIGA abra el Gestor de informes.2. Seleccione Informes del sistema > Nuevo.3. Especifique la información.4. Seleccione Guardar y Cerrar.

Asociación de documentos a formulariosPuede utilizar informes en muchos lugares de IBM TRIRIGA, como por ejemplosecciones de formulario, secciones de portal y la pestaña Informes.

Acerca de esta tarea

Para utilizar un informe de BIRT en una sección de formulario, añada el informe ala pestaña Diseño y a la pestaña Inclusiones/Formularios de un formulario. En lapestaña Inclusiones/Formularios asocie el informe de BIRT al formulario de IBMTRIRIGA. Como resultado, todas las etiquetas del informe de BIRT se puedenexportar para su traducción desde el gestor de globalización.

Procedimiento1. En IBM TRIRIGA vaya al Creador de formularios y seleccione General.2. Abra el formulario para el que ha desarrollado el informe de formulario.3. Opcional: Revise el formulario.4. Seleccione Diseño y seleccione Mostrar informes para asegurarse de que el

informe aparece en la pestaña Informes de un formulario.5. Seleccione Inclusiones/Formularios y seleccione Añadir.

22 © Copyright IBM Corp. 2011, 2015

Page 27: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

6. Seleccione el archivo de informe que ha cargado en el Gestor de documentos yseleccione Aceptar.

7. En la sección de formularios, seleccione el archivo de informe.8. Seleccione Diseño y seleccione Publicar.

Configuración de acciones de impresión en masa después dela migración de objetos

En la aplicación de IBM TRIRIGA, las acciones de informe de impresión en masautilizan URLs que tienen IDs de documento numérico codificados. Después deaplicar un paquete de migración de objetos, el ID de documento de un documentopuede cambiar y la acción de impresión en masa ya no funciona. Puede actualizarmanualmente cada ID de documento y asociar cada documento al formulariorelacionado.

Configuración de acciones de impresión en masa en formulariosde mantenimientoPuede configurar acciones en formularios de mantenimiento para una impresión enmasa.

Procedimiento1. Inicie la sesión en IBM TRIRIGA como administrador.2. En el Gestor de documentos, seleccione TRIRIGA > Tarea.3. Pulse con el botón derecho sobre uno de los documentos de la tabla siguiente

y seleccione Propiedades para obtener el ID del documento. Repita este pasopara cada documento en la tabla siguiente:

Nombre de documento Acción de impresión en masa

Registro de tareas de trabajo de evaluaciónde condición (BIRT)

Imprimir tarea de trabajo de evaluación decondición

Registro de revisiones de contrato (BIRT) Imprimir revisión de contrato

Registro de tareas de inspección (BIRT) Imprimir tarea de inspección

Registro de tareas de trabajo de recuentode inventario (BIRT)

Imprimir tarea de trabajo de recuento deinventario

Registro de tareas de trabajo de selecciónde inventario (BIRT)

Imprimir tarea de trabajo de selección deinventario

Registro de tareas de trabajo de llave(BIRT)

Imprimir tarea de trabajo de llaves

Registro de tareas de pedido de material(BIRT)

Imprimir Tarea de pedido de material

Registro de tareas de lista de pendientes(BIRT)

Imprimir tarea de lista de pendientes

Registro de tareas de reserva de trabajo(BIRT)

Imprimir tarea de reserva de trabajo

Registro de tarea de planificación (BIRT) Imprimir tarea de planificación

Registro de tareas de envío (BIRT) Imprimir tarea de entrega

Registro de tareas de trabajo (BIRT) Imprimir tarea de trabajo

4. En el menú Herramientas, seleccione Herramientas de creación de programas> Creador de formularios.

Capítulo 2. Creación avanzada de informes en IBM TRIRIGA 23

Page 28: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

5. Seleccione el módulo triMaintenance, seleccione el formulariotriMaintenanceManager y revise el formulario.

6. En la navegación del formulario, seleccione triSchedule > Trabajo > Mistareas.

7. Seleccione la acción de impresión en masa. En las propiedades de acción,sustituya el ID de documento antiguo por el ID de documento nuevo. Repitaeste paso para cualquier acción de la tabla anterior.

8. Después de actualizar todos los valores de ID de documento, publique elformulario.

9. En el menú Herramientas seleccione Herramientas de creación de programas> Creador de formularios.

10. Seleccione el módulo triTask. Abra un formulario de tarea de la tablasiguiente y revise el formulario.

11. Seleccione Inclusiones/Formularios y en la sección de formularios, seleccioneAñadir. Busque el documento y publique el formulario. Repita este paso paracada formulario en la tabla siguiente.

Formulario de tarea Nombre de documento

triConditionAssessmentWorkTask Registro de tareas de trabajo de evaluaciónde condición (BIRT)

triContractReviewTask Registro de revisiones de contrato (BIRT)

triInventoryCountWorkTask Registro de tareas de trabajo de recuento deinventario (BIRT)

triInventoryPickWorkTask Registro de tareas de trabajo de selección deinventario (BIRT)

triKeyWorkTask Registro de tareas de trabajo de llave (BIRT)

triMaterialOrderTask Registro de tareas de pedido de material(BIRT)

triPunchlistTask Registro de tareas de lista de pendientes(BIRT)

triReserveWorkTask Registro de tareas de reserva de trabajo(BIRT)

triScheduleTask Registro de tarea de planificación (BIRT)

triSubmittalTask Registro de tareas de envío (BIRT)

triWorkTask Registro de tareas de trabajo (BIRT)

Configuración de acciones de impresión en masa en formulariosde facturaPuede configurar manualmente acciones de impresión en masa en formularios defactura.

Procedimiento1. Inicie la sesión en la aplicación de IBM TRIRIGA como un administrador.2. En el Gestor de documentos, navegue a TRIRIGA > Contrato.3. Pulse con el botón derecho sobre un documento de la tabla siguiente y

seleccione Propiedades para obtener el ID de documento. Repita este pasopara cada documento en la tabla siguiente:

24 © Copyright IBM Corp. 2011, 2015

Page 29: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

Nombre de documento Acción de impresión en masa

Impresión en masa de resumen de facturasde activos (BIRT)

Impresión en masa de facturas de activo

Impresión en masa de resumen de facturade propiedades inmobiliarias (BIRT)

Impresión en masa de facturas depropiedades inmobiliarias

4. En el menú Herramientas, seleccione Herramientas de creación de programas> Creador de formularios.

5. Vaya al módulo triPayment, seleccione triProcessInvoices y revise elformulario.

6. En la navegación del formulario, seleccione triGeneral > Facturas conCuentas por cobrar.

7. En las propiedades de facturas de cuentas por cobrar, seleccione una de lasacciones de impresión en masa. En las propiedades de acción, sustituya el IDde documento antiguo por el ID de documento nuevo. Repita este paso paracada acción de la tabla anterior.

8. Después de actualizar todos los valores de ID de documento, publique elformulario.

9. Vaya al menú Herramientas y seleccione Herramientas de creación deprogramas > Creador de formularios.

10. Seleccione el módulo triPayment. Abra una factura desde la tabla siguiente yrevise el formulario.

11. Seleccione Inclusiones/Formularios y en la sección de formularios, seleccioneAñadir. Busque el documento y publique el formulario. Repita este paso paracada formulario en la tabla siguiente:

Formulario de factura Nombre de documento

triAssetInvoice Impresión en masa de resumen de facturasde activos (BIRT)

triREInvoice Impresión en masa de resumen de facturade propiedades inmobiliarias (BIRT)

Mantenimiento de informesPuede cambiar informes existentes que no impliquen conjuntos de datos y puedecambiar informes existentes que impliquen conjuntos de datos.

Modificación de informes sin cambios de conjuntos de datosPara modificar un informe de BIRT que no implica cambios de conjuntos de datos,puede utilizar el Gestor de documentos para recuperar el archivo de informe,cambie el archivo y reimporte el archivo de informe.

Procedimiento1. En el Gestor de documentos, seleccione el archivo, especifique un comentario y

seleccione Extraer.2. Cree un informe inicial en IBM TRIRIGA e importe el informe inicial en BIRT.3. Realice los cambios necesarios en el informe y guarde el archivo. Si cambia un

informe de BIRT estándar, renombre el informe antes de cargarlo en el Gestorde documentos para proteger la versión personalizada en caso de unaactualización de IBM TRIRIGA.

4. Vuelva a cargar el archivo en el Gestor de documentos.

Capítulo 2. Creación avanzada de informes en IBM TRIRIGA 25

Page 30: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

Modificación de informes con cambios de conjuntos de datosUtilice el Gestor de documentos para recuperar el archivo de informe, cambiar elarchivo de informe y reimportar el archivo de informe.

Procedimiento1. Genere un informe inicial basado en el mismo modelo que ha utilizado para el

informe de BIRT existente.2. Realice una de las opciones siguientes:

OpcionesModificación de informes con cambios deconjunto de datos

Seleccione actualizaciones de elementos deelementos de conjunto de datos de script

Seleccione las actualizaciones a incluir de loselementos de conjunto de datos de script enel informe de BIRT actual y en el archivo de.rtpdesign nuevo.

Sustituya los elementos de conjunto dedatos de script

Sustituya los elementos de conjunto de datose script del archivo de .rptdesign actual conlos elementos de conjunto de datos de scriptnuevos generados en el archivo .rptdesignnuevo. Importe el informe inicial en unproyecto, copie el conjunto de datos delinforme inicial nuevo y péguelo en losconjuntos de datos del archivo .rptdesignexistente.

Qué hacer a continuación

Si añade campos o filtros de usuario a la consulta de IBM TRIRIGA, también debecambiar el informe. Después de actualizar el conjunto de datos, si ese conjunto dedatos se utiliza para incorporarse a BIRT, debe reincorporar el conjunto de datos yvolver a enlazar los elementos del informe de BIRT.

Operadores de filtroLos valores de los operadores de filtro dependen del tipo de campo del camposeleccionado.

La tabla siguiente lista y describe los valores que puede utilizar:

Tabla 4. Operadores de filtro. Operadores de campo

Operador Descripción

Después Disponible para campos de fecha, fecha y hora y hora. Si elvalor del campo especificado es posterior al valor especificado,es verdadero.

Antes Disponible para campos de fecha, fecha y hora y hora. Si elvalor del campo especificado es anterior al valor especificado,es verdadero.

Contiene Disponible para campos de texto, UdM y booleanos. Si elvalor del campo especificado contiene el valor especificado, esverdadero.

Contiene – Distinción demayúsculas y minúsculas

Disponible para campos de texto, UdM y booleanos. Si elvalor del campo especificado contiene el valor especificado,incluida la distinción de mayúsculas y minúsculas, esverdadero.

26 © Copyright IBM Corp. 2011, 2015

Page 31: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

Tabla 4. Operadores de filtro (continuación). Operadores de campo

Operador Descripción

No contiene Disponible para campos de texto, UdM y booleanos. Si elvalor del campo especificado no contiene el valor del campoespecificado, es verdadero.

No contiene – Distinciónde mayúsculas yminúsculas

Disponible para campos de texto, UdM y booleanos. Si elvalor del campo especificado no contiene el valor especificado,incluida la distinción de mayúsculas y minúsculas, esverdadero.

Finaliza con Disponible para campos de texto, UdM y booleanos. Si elvalor del campo especificado valor del campo especificadofinaliza con el valor especificado, es verdadero.

Finaliza con - Distinciónde mayúsculas yminúsculas

Disponible para campos de texto, UdM y booleanos. Si elvalor del campo especificado valor del campo especificadofinaliza con el valor especificado e incluye la distinción entremayúsculas y minúsculas, es verdadero.

Igual a Si el valor del campo especificado es igual al valorespecificado, es verdadero.

En Si el valor del campo especificado es uno de los valoresespecificados, es verdadero. Para valores de serie y numéricos,los valores especificados deben ser valores de literales entreapóstrofos separados por comas, por ejemplo:'Tom','Jerry','Paul','1','2','3'.

Menor que Disponible para campos de número. Si el valor del campoespecificado es menor que el valor especificado, es verdadero.

Menor o igual que Disponible para campos de número, fecha, fecha y hora yhora. Si el valor del campo especificado es menor o igual queel valor especificado, es verdadero.

Mayor que Disponible para campos de número. Si el valor del campoespecificado es mayor que el valor especificado, es verdadero.

Mayor o igual que Disponible para campos de número, fecha, fecha y hora yhora. Si el valor del campo especificado es mayor o igual queel valor especificado, es verdadero.

No es igual Si el valor del campo especificado no es igual al valorespecificado, es verdadero.

No en Si el valor del campo especificado no es uno de los valoresespecificados, es verdadero. Para valores de serie y numéricos,los valores especificados deben ser valores de literales entreapóstrofos separados por comas. Por ejemplo:'Tom','Jerry','Paul','1','2','3'.

Comenzar con Disponible para campos de texto, UdM y booleanos. Si elvalor del campo especificado valor del campo especificadoempieza por el valor especificado, es verdadero.

Comienza con - Distinciónde mayúsculas yminúsculas

Disponible para campos de texto, UdM y booleanos. Si elvalor del campo especificado valor del campo especificadoempieza por el valor especificado e incluye la distinción entremayúsculas y minúsculas, es verdadero.

Si tiene una consulta utilizada en un campo de ubicador o unasección inteligente y advierte que la función de autocompletartarda mucho en ejecutarse, considere la posibilidad de cambiarel operador de filtro de contiene a empieza por.

Capítulo 2. Creación avanzada de informes en IBM TRIRIGA 27

Page 32: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

Valores especialesAdemás de utilizar números y texto en el campo Valor, puede utilizar valoresespeciales.

Los valores especiales precedentes pueden ir seguidos de un signo + o - y de unnúmero entero. Por ejemplo, $$TODAY$$+1 es mañana, $$THISWEEK$$-1 es la semanapasada y $$THISYEAR$$+5 es cinco años después del año actual. La tabla siguientelista y describe los valores especiales:

Tabla 5. Valores especiales que pueden ir seguidos de un signo + o -.. Valores especiales

Valor Descripción

$$TODAY$$ Se utiliza para comparar una fecha con lafecha actual. Por ejemplo, si no deseamostrar cursos de formación que tuvieronlugar en el pasado, especifique:General::Start Date After $$TODAY$$

$$THISWEEK$$ Se utiliza para comparar una fecha con lasemana actual. Por ejemplo, para ver cursosde formación que empiezan en la semanaactual, especifique:

General::Start Date Equals $$THISWEEK$$

$$THISMONTH$$ Se utiliza para comparar una fecha con elmes actual.

$$THISYEAR$$ Se utiliza para comparar una fecha con elaño actual.

La tabla siguiente lista y describe más valores especiales:

Tabla 6. Valores especiales. Valores especiales

Valor Descripción

$$RUNTIME$$ El valor especial $$RUNTIME$$ permite alusuario especificar un valor para el filtrocuando se ejecuta el registro. Si el usuario noespecifica un valor, se ignora el filtro.

El valor especial $$RUNTIME$$ funciona biencon la mayoría de tipos de datos yoperadores de comparación. Sin embargo,para datos de texto, el valor especial$$RUNTIME$$ funciona con el operadorContiene.

En lugar de utilizar el valor especial$$RUNTIME$$, puede identificar campos paraentrada de usuario marcando el recuadro deselección Usuario en la pestaña Filtros.

$$USERID$$ El valor especial $$USERID$$ es un filtro decampo válido en consultas.

28 © Copyright IBM Corp. 2011, 2015

Page 33: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

Tabla 6. Valores especiales (continuación). Valores especiales

Valor Descripción

$$USERID::SectionName::FieldName$$ El valor especial$$USERID::SectionName::FieldName$$ es unfiltro válido en consultas. Establecer elcampo de valor en el valor especial$$USERID::SectionName::FieldName$$ indicaque un valor se compara con el nombre decampo FieldName en la sección SectionNamedel registro.

$$PERSONID$$ El valor especial $$PERSONID$$ es un filtro decampo válido en consultas. Cuando seutiliza el valor especial $$PERSONID$$, seresuelve en el ID de objeto inteligente de lapersona asociada al usuario actual. Si elusuario actual no está asociado a unapersona, se visualizará un error.

Igual que el valor especial $$USERID$$, dasoporte al acceso de sección o de campo. Elejemplo siguiente es una notación válidapara resolver el primer nombre de lapersona actual:$$PERSONID::Detail::triFirstNameTX$$.

$$PARENT::SectionName$$ El valor especial $$PARENT::SectionName$$es un filtro de campo válido en consultas.Establecer el campo de valor en el valorespecial $$PARENT::SectionName$$ indica queun valor se compara con la secciónSectionName del registro que contiene lasección de consulta o la sección inteligente.

$$PARENT::SectionName ::FieldName$$ Puede indicar un filtro que compara unvalor en el registro filtrado con un valor enel registro que contiene la seccióninteligente.

Para indicar que un valor se compara con elcampo FieldName, en la sección SectionNamedel registro que contiene la sección deconsulta o la sección inteligente, utilice elcampo de valor siguiente:$$PARENT::SectionName::FieldName$$.

Si el valor del valor especial de $$PARENTestá vacío, se resuelve en un criterio ISNULL.

Nombres especiales en el campo de registroEn el campo de registro puede utilizar nombres especiales para filtrar para unaasociación con registros especiales.

El valor de un registro o un campo de consulta debe coincidir con el nombre de laotra consulta. Si el valor del campo de tipo de filtro es consulta, establezca elregistro adecuado o la consulta.

Capítulo 2. Creación avanzada de informes en IBM TRIRIGA 29

Page 34: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

Si el valor del campo de tipo de filtro es registro, el valor del campo de registro oconsulta determina si la asociación que el filtro necesita es directa con el registrode contexto, con otro registro asociado al registro de contexto o un registro noasociado.

La tabla siguiente contiene nombres especiales para el campo de registro:

Tabla 7. Nombres especiales en el campo de registro

Valor Descripción

$$USERID$$ Cuando se ejecuta la consulta, el valor$$USERID$$ se resuelve en el ID de registrodel usuario que inició la consulta.

$$PERSONID$$ Cuando se ejecuta la consulta, el valor$$PERSONID$$ se resuelve en el ID de registrodel registro Personas asociado al usuario queinició la consulta.

$$RECORDID$$ Útil para consultas utilizadas en lassecciones de consulta y para las consultas deacción de búsqueda para secciones de datos.Las consultas utilizadas en las secciones deconsultas y las consultas de búsqueda senecesitan a menudo para devolver soloregistros asociados con el registro quecontiene la sección.

Cuando establece el campo de registro en elvalor $$RECORDID$$, si los registros de nivelsuperior se asocian directamente con elregistro de contexto, los registros de nivelsuperior pasan este filtro.

$$GROUPID$$ Si establece el campo de registro en el valor$$GROUPID$$, si los registros de nivelsuperior se asocian con un registro querepresenta un grupo al que pertenece elusuario, el registro de nivel superior pasa elfiltro.

Si el campo de registro se establece en elvalor $$GROUPID$$, el campo Módulo seestablece en Grupo y el campo Objeto denegocio se establece en Todo.

$$PROJECTID$$ Cuando establece el campo de registro en elvalor $$PROJECTID$$ y si los registros denivel superior se asocian con un registro querepresenta el proyecto activo, los registros denivel superior pasan el filtro.

Si el campo registro se establece en$$PROJECTID$$, el campo Módulo seestablece en triProject y el campo Objetode negocio se establece en Todo.

Los proyectos de IBM TRIRIGAproporcionan una manera de clasificar datosen función de la relevancia para las tareas enlas que las personas trabajan.

30 © Copyright IBM Corp. 2011, 2015

Page 35: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

Tabla 7. Nombres especiales en el campo de registro (continuación)

Valor Descripción

$$PARENT$$ Utilice $$PARENT$$ para especificar que losregistros de nivel superior pasan este filtro siestán asociados a un registro que tenga unaasociación directa o indirecta con el registrode contexto. Funciona especificando una víade acceso del registro de contexto a otroregistro a través de las secciones de registroo los campos de ubicador.

Por ejemplo, si un registro de contexto es unregistro de empleado, el informe debeincluir registros de empleado paraempleados que tienen el mismo supervisorque el registro de contexto.

Para especificar un filtro, utilice los registrosde empleado que tienen un campo deubicador llamado triReportsToTX que hacereferencia al registro correspondiente alsupervisor de un empleado. SitriReportsToTX está en la sección general, elvalor del campo de registro es$$PARENT::General::triReportsToTX$$.

Si la referencia era una sección inteligente, elvalor del campo de registro será$$PARENT::triReportsTo$$.

Si el valor de $$PARENT$$ está vacío, seresuelve en un criterio de IS NULL.

$$PARENT::SECTIONNAME$$ Utilice para filtrar una sección basada en losvalores de otra sección. PARENT es siempre lapalabra PARENT. SECTIONNAME es el nombrede la sección que contiene los valores quedesea filtrar. Asegúrese de utilizar el nombrey no la etiqueta de la sección.

$$PARENT::SECTIONNAME::FIELDNAME$$ Se utiliza para filtrar una sección debúsqueda basada en el valor de un campoen otra sección. PARENT es siempre la palabraPARENT. SECTIONNAME es el nombre de lasección que contiene el campo que deseafiltrar. FIELDNAME es el nombre del campopor el que desea filtrar. Asegúrese de utilizarel nombre y no la etiqueta de la sección y elcampo.

$$ORGANIZATIONID$$ Se utiliza para filtrar una sección de consultade portal basada en las organizaciones delusuario con sesión iniciada.

$$ORGANIZATIONIDWITHCHILDREN$$ Se utiliza para filtrar una sección de consultade portal basada en las organizaciones delusuario con sesión iniciada, incluidas todaslas organizaciones hijo dependientes.

$$GEOGRAPHYID$$ Se utiliza para filtrar una sección de consultade portal basada en la geografía del usuariocon sesión iniciada.

Capítulo 2. Creación avanzada de informes en IBM TRIRIGA 31

Page 36: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

Tabla 7. Nombres especiales en el campo de registro (continuación)

Valor Descripción

$$GEOGRAPHYIDWITHCHILDREN$$ Se utiliza para filtrar una sección de consultade portal basada en la geografía y todas lasgeografías hijo del usuario con sesióniniciada.

32 © Copyright IBM Corp. 2011, 2015

Page 37: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

Avisos

Esta información se ha desarrollado para productos y servicios que se ofrecen enEE.UU. Este material puede estar disponible por parte de IBM en otros idiomas.Sin embargo, es posible que tenga obligación de tener una copia del producto o dela versión del producto en dicho idioma para acceder a él.

Es posible que IBM no ofrezca en otros países los productos, servicios ocaracterísticas que se describen en este documento. Póngase en contacto con elrepresentante local de IBM para obtener información sobre los productos yservicios que actualmente pueden adquirirse en su zona. Cualquier referencia a unproducto, programa o servicio de IBM no pretende afirmar ni implicar que sólo sepueda utilizar dicho producto, programa o servicio de IBM. En su lugar puedeutilizarse cualquier producto, programa o servicio funcionalmente equivalente queno vulnere ninguno de los derechos de propiedad intelectual de IBM. Sin embargo,es responsabilidad del usuario evaluar y verificar el funcionamiento de losproductos, programas o servicios que no sean de IBM.

IBM puede tener patentes o solicitudes de patente en tramitación que afecten a loscontenidos descritos en este documento. La entrega de este documento no leconcede ninguna licencia sobre dichas patentes. Puede enviar sus consultas sobrelicencias por escrito a:

IBM Director of LicensingIBM CorporationNorth Castle Drive, MD-NC119Armonk, NY 10504-1785EE.UU.

Para realizar consultas sobre licencias relativas a la información de doble byte(DBCS), póngase en contacto con el departamento de propiedad intelectual de IBMde su país o envíe sus consultas, por escrito, a:

Intellectual Property LicensingLegal and Intellectual Property LawIBM Japan Ltd.19-21, Nihonbashi-Hakozakicho, Chuo-kuTokyo 103-8510, Japón

INTERNATIONAL BUSINESS MACHINES CORPORATION PROPORCIONAESTA PUBLICACIÓN "TAL CUAL" SIN GARANTÍA DE NINGUNA CLASE, NIEXPLÍCITA NI IMPLÍCITA, INCLUIDAS, PERO SIN LIMITARSE A ELLAS, LASGARANTÍAS O CONDICIONES IMPLÍCITAS DE NO VULNERACIÓN DEDERECHOS, COMERCIALIZACIÓN O IDONEIDAD PARA UN FINDETERMINADO. Algunas jurisdicciones no permiten la renuncia a garantíasexplícitas o implícitas en determinadas transacciones, por lo tanto, esta declaraciónpuede no ser aplicable en su caso.

Esta información puede incluir imprecisiones técnicas o errores tipográficos.Periódicamente se efectúan cambios en la información aquí contenida; estoscambios se incorporarán en nuevas ediciones de la publicación. IBM puedeefectuar mejoras y/o cambios en el producto(s) y/o programas descritos en estapublicación en cualquier momento y sin previo aviso.

© Copyright IBM Corp. 2011, 2015 33

Page 38: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

Cualquier referencia incluida en esta información a sitios Web que no sean de IBMsólo se proporciona para su comodidad y en ningún modo constituye unaaprobación de dichos sitios sitios web. Los materiales de estos sitios web noforman parte de los materiales de IBM para este producto, y el uso que se haga deestos sitios web será responsabilidad del usuario.

IBM puede utilizar o distribuir cualquier información que se le proporcione en laforma que considere adecuada, sin incurrir por ello en ninguna obligación para conusted.

Los licenciatarios de este programa que desee información sobre éste con lafinalidad de habilitar: (i) el intercambio de información entre programas creadosindependientemente y otros programas (incluido éste) y (ii) el uso mutuo de lainformación que se ha intercambiado, deben ponerse en contacto con:

IBM Director of LicensingIBM CorporationNorth Castle Drive, MD-NC119Armonk, NY 10504-1785EE.UU.

Dicha información puede estar disponible, sujeta a los términos y condicionesadecuados, incluido, en algunos casos, el pago de una tarifa.

El programa bajo licencia descrito en este documento y todo el material bajolicencia asociado a él los proporciona IBM según los términos del Acuerdo deCliente de IBM, el Acuerdo Internacional de Programas Bajo Licencia de IBM ocualquier acuerdo equivalente entre el usuario e IBM.

Los datos de rendimiento y los ejemplos de clientes citados se presentan solamentea efectos ilustrativos. Los resultados reales de rendimiento pueden variar enfunción de configuraciones específicas y condiciones de operación.

La información relativa a los productos que no son de IBM se ha obtenido de losproveedores de los mismos, de sus anuncios publicados o de otras fuentesdisponibles públicamente. IBM no ha probado esos productos y no puedeconfirmar la precisión de su rendimiento, la compatibilidad ni ninguna otraafirmación relacionada con productos no IBM. Las preguntas sobre las prestacionesde productos que no sean de IBM se deben dirigir a los proveedores de dichosproductos.

Las declaraciones relativas a la dirección o intenciones futuras de IBM puedencambiar o ser retiradas sin aviso, y representan sólo propósitos y objetivos.

Esta información contiene ejemplos de datos e informes utilizados en operacionesde negocio diarias. Para ilustrarlos de la forma más completa posible, los ejemplosincluyen nombres de personas, empresas, marcas y productos. Todos estosnombres son ficticios y cualquier parecido con personas o empresas comercialesreales es pura coincidencia.

LICENCIA DE COPYRIGHT:

Esta información contiene programas de aplicación de ejemplo en el lenguaje deorigen, que muestran técnicas de programación en diversas plataformas operativas.Puede copiar, modificar y distribuir los programas de ejemplo de cualquier forma,sin tener que pagar a IBM, con intención de desarrollar, utilizar, comercializar o

34 © Copyright IBM Corp. 2011, 2015

Page 39: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

distribuir programas de aplicación que estén en conformidad con la interfaz deprogramación de aplicaciones (API) de la plataforma operativa para la que estánescritos los programas de ejemplo. Estos ejemplos no se han probadoexhaustivamente bajo todas las condiciones. Por lo tanto, IBM no puede garantizarni dar por supuesta la fiabilidad, la capacidad de servicio ni la funcionalidad deestos programas. Los programas de ejemplo se proporcionan "TAL CUAL" singarantías de ningún tipo. IBM no se responsabilizará de los daños causados por eluso de los programas de ejemplo.

Cada copia o parte de estos programas de ejemplo o cualquier trabajo derivadodebe incluir una nota de copyright como la siguiente:© (nombre de su empresa) (año).Partes de este código proceden de Programas de ejemplo de IBM Corp.© Copyright IBM Corp. _escriba el año o los años_.

Marcas registradasIBM, el logotipo de IBM e ibm.com son marcas comerciales o marcas registradas deInternational Business Machines Corp., registradas en muchas jurisdicciones detodo el mundo. Otros productos y nombres de servicio pueden ser marcasregistradas de IBM u otras empresas. En Internet hay disponible una listaactualizada con las marcas registradas de IBM, en "Copyright and trademarkinformation", en la dirección www.ibm.com/legal/copytrade.shtml.

Java y todas las marcas registradas basadas en Java y logotipos son marcasregistradas de Oracle y/o sus filiales.

Linux es una marca registrada de Linus Torvalds en los Estados Unidos y/o enotros países.

Microsoft, Windows, Windows NT y el logotipo de Windows son marcasregistradas de Microsoft Corporation en los Estados Unidos y/o en otros países.

UNIX es una marca registrada de The Open Group en los Estados Unidos y enotros países.

Otros productos y nombres de servicio pueden ser marcas registradas de IBM uotras empresas.

Términos y condiciones de la documentación del productoLos permisos para utilizar estas publicaciones están sujetos a los siguientestérminos y condiciones.

Validez

Estos términos y condiciones se añaden a los términos de utilización del sitio webde IBM.

Uso personal

Puede reproducir estas publicaciones para su uso personal, no comercial, siempre ycuando se conserven todos los avisos sobre propiedad. No puede distribuir,visualizar ni crear trabajos derivados de estas publicaciones ni de ninguna parte deellas, sin el consentimiento expreso de IBM.

Avisos 35

Page 40: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

Uso comercial

Puede reproducir, distribuir y visualizar estas publicaciones únicamente en suempresa siempre que se conserven todos los avisos de propiedad. No puederealizar trabajos derivados de estas publicaciones, ni reproducir, distribuir nivisualizar estas publicaciones ni ninguna parte de las mismas fuera de la empresa,sin el consentimiento expreso de IBM.

Derechos

Exceptuando los permisos concedidos explícitamente, no se concede ningún otropermiso, licencia ni derecho, ni explícito ni implícito, para las publicaciones ni paraningún otro tipo de información, datos, software o propiedad intelectual contenidoen los mismos.

IBM se reserva el derecho a retirar los permisos concedidos aquí cuando, a sucriterio, el uso de las publicaciones vaya en detrimento de su interés o, segúndeterminación de IBM, las instrucciones anteriores no se estén siguiendocorrectamente.

No está autorizado a descargar, exportar ni reexportar esta información excepto entotal conformidad con todas las leyes y regulaciones aplicables, incluidas las leyesy regulaciones de exportación de Estados Unidos.

IBM NO GARANTIZA EL CONTENIDO DE ESTAS PUBLICACIONES. LASPUBLICACIONES SE PROPORCIONAN "TAL CUAL" Y SIN GARANTÍA DENINGUNA CLASE, NI EXPLÍCITA NI IMPLÍCITA, INCLUYENDO PERO SINLIMITARSE A, LAS GARANTÍAS IMPLÍCITAS DE COMERCIALIZACIÓN, NOVULNERACIÓN E IDONEIDAD Y ADECUACIÓN A UN PROPÓSITODETERMINADO.

Declaración de privacidad en línea de IBMLos productos de Software IBM, incluido el software como soluciones de servicio,(“Ofertas de software”) pueden utilizar cookies u otras tecnologías para recopilarinformación sobre el uso del producto, para ayudar a mejorar la experiencia delusuario final, para adaptar las interacciones con el usuario final o para otros fines.En muchos casos, las ofertas de software no recopilan información de identificaciónpersonal. Algunas de nuestras ofertas de software pueden ayudarle a recopilarinformación de identificación personal. Si la oferta de software utiliza cookies pararecopilar información de identificación personal, se establece a continuacióninformación específica sobre el uso de cookies de esta oferta.

Esta oferta de software no utiliza cookies u otras tecnologías para recopilarinformación de identificación personal.

Si las configuraciones desplegadas para esta oferta de software le ofrecen comocliente la posibilidad de recopilar información de identificación personal de losusuarios finales mediante cookies y otras tecnologías, debe buscar asesoramientojurídico sobre la legislación aplicable a esa recopilación de datos, que incluyecualquier requisito de aviso y consentimiento.

Para obtener más información sobre el uso de diversas tecnologías, incluyendocookies, para estos fines, consulte la Política de privacidad de IBM enhttp://www.ibm.com/privacy y la Declaración de privacidad en línea de IBM enhttp://www.ibm.com/privacy/details en la sección titulada “Cookies, Web

36 © Copyright IBM Corp. 2011, 2015

Page 41: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

Beacons and Other Technologies” y "IBM Software Products andSoftware-as-a-Service Privacy Statement" enhttp://www.ibm.com/software/info/product-privacy/.

Avisos 37

Page 42: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

38 © Copyright IBM Corp. 2011, 2015

Page 43: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información
Page 44: © Copyright IBM Corp. 2011, 2015 · Guía del usuario de creación de informes IBM. Nota Antes de utilizar esta información y el pr oducto al que da soporte, lea la información

IBM®

Impreso en España