IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

IBM Cognos Framework Manager
Versión 10.2.1
Guía del usuario

Nota
Antes de utilizar esta información y el producto al que da soporte, lea la información del apartado “Avisos” en la página
653.
Información sobre el producto
Este documento se aplica a IBM Cognos Business Intelligence versión 10.2.1 y también puede aplicarse a releases
posteriores.
Licensed Materials - Property of IBM
© Copyright IBM Corporation 2005, 2013.

Contenido
Introducción . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiii
Capítulo 1. Novedades . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Características nuevas en 10.2.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Características nuevas en 10.2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Características modificadas en 10.2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Características nuevas en 10.1.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Características modificadas en 10.1.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Características nuevas en 10.1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Características eliminadas de 10.1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Capítulo 2. Introducción a Framework Manager. . . . . . . . . . . . . . . . . . . 7
Análisis del problema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Creación de aplicaciones de IBM Cognos business intelligence . . . . . . . . . . . . . . . . . . . 8
Objetos que va a utilizar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Creación de proyectos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Apertura de proyectos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
La página del proyecto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Visor de proyectos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Cambio de opciones de los proyectos. . . . . . . . . . . . . . . . . . . . . . . . . . 17
Reordenación de objetos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Pestaña Explorador . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
La pestaña Diagrama . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
La pestaña Mapa de dimensiones . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
El panel Propiedades . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
El panel Herramientas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Convenciones de nomenclatura para objetos en un proyecto . . . . . . . . . . . . . . . . . . . 24
Modelos de ejemplo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
El modelo Almacén de Viaje de Aventuras . . . . . . . . . . . . . . . . . . . . . . . . 26
El modelo Ventas de Viaje de Aventuras . . . . . . . . . . . . . . . . . . . . . . . . . 27
Capítulo 3. Model Design Accelerator . . . . . . . . . . . . . . . . . . . . . . 29
Árbol del explorador . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Diagrama del explorador . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
El espacio de trabajo del acelerador de modelos . . . . . . . . . . . . . . . . . . . . . . . 31
Diagrama de asunto de consulta . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Uso del modo de edición de relación . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Vista Aviso de modelo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Cambio de valores en los diagramas . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Creación de un proyecto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
El esquema en estrella . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Gestión de un esquema en estrella. . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Capítulo 4. Importación de metadatos de orígenes de datos. . . . . . . . . . . . . 39
Orígenes de datos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Seguridad de los orígenes de datos . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Tipos de conexiones de origen de datos . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Metadatos nativos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Conexiones de origen de datos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Creación de conexiones de origen de datos . . . . . . . . . . . . . . . . . . . . . . . . . 44
Pasos para crear una conexión de origen de datos . . . . . . . . . . . . . . . . . . . . . 46
Importación de metadatos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Importación de metadatos desde bases de datos relacionales . . . . . . . . . . . . . . . . . . 48
Importación de metadatos de modelos de IBM Cognos . . . . . . . . . . . . . . . . . . . . 49
© Copyright IBM Corp. 2005, 2013 iii

Importación de metadatos de un modelo Architect o un catálogo Impromptu . . . . . . . . . . . . 50
Importación de metadatos de IBM Cognos DecisionStream o IBM Cognos Data Manager . . . . . . . . 50
Importación de orígenes de metadatos de IBM . . . . . . . . . . . . . . . . . . . . . . 54
Importación de metadatos de orígenes de metadatos de terceros. . . . . . . . . . . . . . . . . 57
Resolución de problemas de metadatos de otros orígenes . . . . . . . . . . . . . . . . . . . 62
Importación de metadatos utilizando XML como origen de datos . . . . . . . . . . . . . . . . 64
Importación de objetos con el mismo nombre . . . . . . . . . . . . . . . . . . . . . . . 65
Capítulo 5. Modelado de metadatos relacionales. . . . . . . . . . . . . . . . . . 67
Configuración de la vista de importación . . . . . . . . . . . . . . . . . . . . . . . . . 67
Configuración de la vista empresarial. . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Relaciones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Cardinalidad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Modificación de una relación . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Creación de expresiones complejas para una relación . . . . . . . . . . . . . . . . . . . . 73
Creación de relaciones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Creación de un atajo de relación . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Detección y generación de relaciones . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Asuntos de consulta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Asuntos de consulta de orígenes de datos . . . . . . . . . . . . . . . . . . . . . . . . 75
Asuntos de consulta de modelo . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Asuntos de consulta de procedimiento almacenado . . . . . . . . . . . . . . . . . . . . . 79
Determinantes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Creación de asuntos de consulta de modelo basados en objetos existentes . . . . . . . . . . . . . 88
Visualización de objetos relacionados . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Creación de conjuntos de consultas . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Prueba de asuntos de consulta o conjuntos de consultas . . . . . . . . . . . . . . . . . . . 92
Validación de asuntos de consulta . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Actualización de asuntos de consulta . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Conversión de asuntos de consulta en dimensiones . . . . . . . . . . . . . . . . . . . . . 97
Conversión de asuntos de consulta de modelo en asuntos de consulta de orígenes de datos . . . . . . . 98
Edición de SQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Cambio del tipo de SQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Cambio del modo de generar SQL . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Dimensiones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Orígenes de datos normalizados . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Creación de dimensiones regulares . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Ordenación de miembros de un nivel . . . . . . . . . . . . . . . . . . . . . . . . . 113
Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Creación de dimensiones de medida. . . . . . . . . . . . . . . . . . . . . . . . . . 116
Conversión de medidas en elementos de consulta . . . . . . . . . . . . . . . . . . . . . 118
Relaciones de ámbito . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Creación de dimensiones regulares basadas en objetos existentes . . . . . . . . . . . . . . . . 119
Visualización de objetos relacionados . . . . . . . . . . . . . . . . . . . . . . . . . 119
Prueba de dimensiones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Conversión de dimensiones en asuntos de consulta. . . . . . . . . . . . . . . . . . . . . 123
Metadatos multilingües . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Soporte de metadatos multilingües . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Configuración de un entorno de creación de informes multilingüe. . . . . . . . . . . . . . . . 124
Modelado con orígenes de datos multilingües . . . . . . . . . . . . . . . . . . . . . . 125
Uso de macros para modelar datos multilingües. . . . . . . . . . . . . . . . . . . . . . 126
Adición de un idioma a un proyecto . . . . . . . . . . . . . . . . . . . . . . . . . 127
Exportación de tablas de traducción . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Importación de tablas de traducción. . . . . . . . . . . . . . . . . . . . . . . . . . 129
Ejemplo: crear proyectos multilingües para metadatos relacionales . . . . . . . . . . . . . . . 129
Elementos de consulta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Modificar cómo se agregan los elementos de consulta . . . . . . . . . . . . . . . . . . . . 134
Formateo de elementos de consulta . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Definición de controles de solicitud . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Conversión de elementos en medidas . . . . . . . . . . . . . . . . . . . . . . . . . 149
Reglas de negocio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
iv IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Creación de cálculos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
Creación de filtros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
Aplicación de filtros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
Ejemplo: mostrar el nombre de moneda de cada país . . . . . . . . . . . . . . . . . . . . 156
Creación de mapas de parámetros . . . . . . . . . . . . . . . . . . . . . . . . . . 157
Ejemplo: especificación de valores de idioma para metadatos relacionales . . . . . . . . . . . . . 159
Creación de parámetros de sesión . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Utilizar parámetros con asuntos de consulta de orígenes de datos relacionales. . . . . . . . . . . . 162
Crear solicitudes con macros de consulta . . . . . . . . . . . . . . . . . . . . . . . . 162
Organización de modelos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
Creación de grupos de esquema en estrella . . . . . . . . . . . . . . . . . . . . . . . 173
Atajos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
Creación de carpetas o espacios de nombres . . . . . . . . . . . . . . . . . . . . . . . 181
Creación de carpetas de elementos de consulta . . . . . . . . . . . . . . . . . . . . . . 183
Creación de carpetas de medidas . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
Modelos duraderos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
Creación de un modelo duradero. . . . . . . . . . . . . . . . . . . . . . . . . . . 185
Prueba de un modelo duradero . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
Análisis de modelos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
Pasos para analizar un modelo . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
Capítulo 6. metadatos de SAP BW . . . . . . . . . . . . . . . . . . . . . . . 193
Importación desde un origen de datos de SAP BW . . . . . . . . . . . . . . . . . . . . . . 193
Acceso a metadatos y datos de SAP BW . . . . . . . . . . . . . . . . . . . . . . . . 194
Estructuras de SAP BW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
Jerarquías SAP BW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
Pasos para acceder a un cubo de información protegido . . . . . . . . . . . . . . . . . . . 198
Pasos para importar de un origen de datos de SAP BW . . . . . . . . . . . . . . . . . . . 198
Correlación de objetos de SAP BW con Framework Manager . . . . . . . . . . . . . . . . . . 199
Dimensiones (SAP BW) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
Modificar una dimensión regular (SAP BW) . . . . . . . . . . . . . . . . . . . . . . . 201
Roles (SAP BW) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
Modificación de una dimensión de cifras clave (SAP BW) . . . . . . . . . . . . . . . . . . 209
Visualización de objetos relacionados (SAP BW) . . . . . . . . . . . . . . . . . . . . . . 210
Prueba de una dimensión o de otro objeto (SAP BW) . . . . . . . . . . . . . . . . . . . . 211
Asuntos de consulta de modelo (SAP BW) . . . . . . . . . . . . . . . . . . . . . . . 214
Elementos de consulta (SAP BW) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
Modificar cómo se agregan los elementos de consulta (SAP BW) . . . . . . . . . . . . . . . . 220
Formateo de elementos de consulta (SAP BW) . . . . . . . . . . . . . . . . . . . . . . 223
Definición de un control de solicitud (SAP BW) . . . . . . . . . . . . . . . . . . . . . . 224
Variables de SAP BW. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
Valores de propiedad de variable numérica (SAP BW) . . . . . . . . . . . . . . . . . . . . 233
Valores de las propiedades de variables de característica (SAP BW) . . . . . . . . . . . . . . . 233
Solicitudes de lista de selección (SAP BW). . . . . . . . . . . . . . . . . . . . . . . . 235
Adición de reglas de negocio (SAP BW) . . . . . . . . . . . . . . . . . . . . . . . . . 235
Creación de un cálculo (SAP BW) . . . . . . . . . . . . . . . . . . . . . . . . . . 236
Creación de un filtro (SAP BW) . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
Aplicación de un filtro (SAP BW). . . . . . . . . . . . . . . . . . . . . . . . . . . 240
Creación de un mapa de parámetros (SAP BW) . . . . . . . . . . . . . . . . . . . . . . 241
Creación de un parámetro de sesión (SAP BW) . . . . . . . . . . . . . . . . . . . . . . 243
Organización del modelo (SAP BW) . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
Atajos (SAP BW) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
Creación de carpetas o espacios de nombres (SAP BW) . . . . . . . . . . . . . . . . . . . 246
Capítulo 7. Publicación de paquetes . . . . . . . . . . . . . . . . . . . . . . 249
Verificación de modelos o paquetes . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
Creación o modificación de paquetes . . . . . . . . . . . . . . . . . . . . . . . . . . 252
Creación de un paquete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
Modificación de un paquete . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
Seguridad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
Contenido v

Usuarios, grupos y roles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
Adición de seguridad de datos . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
Seguridad de objetos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
Modificación de la seguridad de los paquetes . . . . . . . . . . . . . . . . . . . . . . 260
Especificación de idiomas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
Definición de idiomas para un paquete. . . . . . . . . . . . . . . . . . . . . . . . . 261
Definición de idiomas para todos los paquetes . . . . . . . . . . . . . . . . . . . . . . 261
Definición de opciones de supresión. . . . . . . . . . . . . . . . . . . . . . . . . . . 261
Asuntos de consulta y dimensiones externalizados . . . . . . . . . . . . . . . . . . . . . . 262
Publicación de paquetes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
Publicación de paquetes basados en orígenes de datos de OLAP . . . . . . . . . . . . . . . . 267
Publicación de paquetes mediante la ejecución de scripts . . . . . . . . . . . . . . . . . . . 268
Actualización de informes para utilizar la versión de paquete más reciente . . . . . . . . . . . . . 269
Capítulo 8. Gestión de proyecto . . . . . . . . . . . . . . . . . . . . . . . . 271
Metadatos del modelo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
Exploración de paquetes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
Visualización de la distribución de los objetos en paquetes . . . . . . . . . . . . . . . . . . 272
Creación de documentación del modelo . . . . . . . . . . . . . . . . . . . . . . . . 272
Modelado multiusuario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
Bifurcación y fusión de proyectos. . . . . . . . . . . . . . . . . . . . . . . . . . . 273
Proyectos segmentados y enlazados . . . . . . . . . . . . . . . . . . . . . . . . . . 279
Control de repositorio externo . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
Administración de metadatos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
Copiar, mover, renombrar o suprimir proyectos . . . . . . . . . . . . . . . . . . . . . . 285
Análisis del impacto de los cambios en los paquetes . . . . . . . . . . . . . . . . . . . . 287
Recorrelación de objetos con nuevos orígenes. . . . . . . . . . . . . . . . . . . . . . . 289
Exportación de metadatos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
Reutilización de proyecto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
Portabilidad de modelos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
Sincronización de proyectos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
Pasos para sincronizar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
Comportamiento de las consultas. . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
Reguladores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
Lugar de procesamiento de los resúmenes de agregado . . . . . . . . . . . . . . . . . . . 312
Mejora del rendimiento mediante el establecimiento del tipo de procesamiento de consultas . . . . . . . 313
Mejora del rendimiento reutilizando datos de la memoria caché al ejecutar un informe. . . . . . . . . 314
Especificar modos de transacción . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
Selección de conjuntos de funciones . . . . . . . . . . . . . . . . . . . . . . . . . . 316
Calidad de servicio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
Control y optimización de consultas . . . . . . . . . . . . . . . . . . . . . . . . . . 319
Capítulo 9. Directrices de modelado de metadatos . . . . . . . . . . . . . . . . 321
Introducción a los conceptos del modelado de IBM Cognos . . . . . . . . . . . . . . . . . . . 321
Conceptos de modelado relacional . . . . . . . . . . . . . . . . . . . . . . . . . . 321
Consideraciones sobre el diseño de modelos . . . . . . . . . . . . . . . . . . . . . . . 331
Conceptos de modelado dimensional . . . . . . . . . . . . . . . . . . . . . . . . . 339
Creación del modelo relacional . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341
Definición de la base de modelado dimensional . . . . . . . . . . . . . . . . . . . . . . 342
Definición de la representación dimensional del modelo . . . . . . . . . . . . . . . . . . . 350
Organización del modelo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354
Capítulo 10. SQL generado por el software de IBM Cognos . . . . . . . . . . . . 357
Introducción a las consultas dimensionales . . . . . . . . . . . . . . . . . . . . . . . . 357
Consulta de hecho único . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
Consulta de varios hechos y consultas de granularidad múltiple en dimensiones compatibles . . . . . . 359
Modelado de relaciones 1-n como relaciones 1-1 . . . . . . . . . . . . . . . . . . . . . . 362
Consulta de varios hechos y consultas de granularidad múltiple en dimensiones no compatibles . . . . . 363
Resolución de dimensiones y hechos identificados de forma ambigua . . . . . . . . . . . . . . . 367
Asuntos de consulta que representan un nivel de jerarquía . . . . . . . . . . . . . . . . . . 368
vi IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Resolución de consultas que no se deberían haber dividido . . . . . . . . . . . . . . . . . . 369
Capítulo 11. Actualización de modelos . . . . . . . . . . . . . . . . . . . . . 375
Verificación del modelo antes de la actualización . . . . . . . . . . . . . . . . . . . . . . 375
Apertura y actualización de modelos . . . . . . . . . . . . . . . . . . . . . . . . . . 375
Actualización y reguladores . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376
Actualización y tipos de datos. . . . . . . . . . . . . . . . . . . . . . . . . . . . 377
Actualización y asuntos de consulta basados en metadatos de SAP BW . . . . . . . . . . . . . . 377
Verificación y reparación de modelos de IBM Cognos ReportNet . . . . . . . . . . . . . . . . . 378
Conversión de la información de dimensiones en determinantes o dimensiones . . . . . . . . . . . 378
Selección y reparación de objetos en modelos de IBM Cognos ReportNet actualizados . . . . . . . . . 381
Actualización de proyectos segmentados y enlazados . . . . . . . . . . . . . . . . . . . . . 382
Apéndice A. Características de accesibilidad. . . . . . . . . . . . . . . . . . . 385
Características de accesibilidad en Framework Manager . . . . . . . . . . . . . . . . . . . . 385
Atajos de teclado para Framework Manager . . . . . . . . . . . . . . . . . . . . . . . . 385
Atajos de teclado para Model Design Accelerator . . . . . . . . . . . . . . . . . . . . . 385
IBM y accesibilidad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386
Apéndice B. Resolución de problemas . . . . . . . . . . . . . . . . . . . . . 387
No se pueden comparar dos CLOB en Oracle . . . . . . . . . . . . . . . . . . . . . . . 387
Error de memoria insuficiente con metadatos ERWin importados . . . . . . . . . . . . . . . . . 387
Framework Manager no puede acceder al URI de pasarela . . . . . . . . . . . . . . . . . . . 387
Los nombres de objetos aparecen en un idioma incorrecto . . . . . . . . . . . . . . . . . . . 388
Las uniones externas completas en Oracle devuelven resultados incorrectos . . . . . . . . . . . . . 388
Error al probar asuntos de consulta en un modelo importado de Teradata . . . . . . . . . . . . . . 388
Error para el asunto de consulta SQL de introducir. . . . . . . . . . . . . . . . . . . . . . 389
Error QE-DEF-0259 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389
La dimensión de cifras clave externalizada conserva un valor de solicitud anterior . . . . . . . . . . . 390
Los modelos antiguos muestran seguridad de objetos de nivel . . . . . . . . . . . . . . . . . . 390
La exportación de un modelo de Framework Manager a un archivo CWM falla con el error No se ha encontrado
MILOG.TXT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390
Diferencia en las uniones internas de SQL después de actualizar a IBM Cognos BI, versión 8.3 y posteriores . . 390
Uniones externas completas no enviadas a Oracle 9i y 10GR1 . . . . . . . . . . . . . . . . . . 391
Discrepancias injustificadas en cálculos numéricos . . . . . . . . . . . . . . . . . . . . . . 391
La búsqueda de valores podría devolver resultados no esperados . . . . . . . . . . . . . . . . . 393
Apéndice C. Uso del editor de expresiones . . . . . . . . . . . . . . . . . . . 395
Operadores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395
(. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395
). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395
*. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395
,. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395
/ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395
|| . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396
+ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396
-. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396
< . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396
-> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397
>= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397
and. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397
auto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397
between . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397
case . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398
contains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398
currentMeasure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398
Contenido vii

default . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398
distinct . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398
else. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398
end. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399
ends with . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399
escape . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399
for . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399
for all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399
for any . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399
for report. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400
if . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400
in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400
in_range . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400
is missing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
is null . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
is not missing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
is not null . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
like . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
lookup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402
not . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402
or . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402
prefilter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402
rows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
rows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
starts with . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
then . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
when . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
Funciones de resumen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
Funciones estadísticas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
aggregate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412
average . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412
count . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412
maximum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412
median . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413
minimum. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413
moving-average . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413
moving-total. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414
percentage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414
percentile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415
quantile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416
quartile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416
rank . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417
running-average . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417
running-count . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418
running-difference. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419
running-maximum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419
running-minimum. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420
running-total . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420
total . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421
Resúmenes de miembros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421
aggregate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421
average . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422
count . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422
maximum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422
median . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422
minimum. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423
percentage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423
percentile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423
quantile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423
quartile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423
rank . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424
viii IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

standard-deviation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424
standard-deviation-pop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424
total . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424
variance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424
variance-pop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425
Constantes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425
date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425
date-time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425
time with time zone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425
timestamp with time zone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425
interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425
interval year. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425
interval month . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425
interval year to month . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425
interval day . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425
interval hour . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425
interval minute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425
interval second . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425
interval day to hour . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426
interval day to minute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426
interval day to second . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426
interval hour to minute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426
interval hour to second . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426
interval minute to second . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426
null . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426
number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426
string . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426
time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426
Construcciones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426
if then else . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426
in_range . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426
search case . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427
simple case . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427
Funciones de fecha/hora . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428
_add_days . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428
_add_months . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428
_add_years . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429
_age . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429
_day_of_week . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429
_day_of_year . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430
_days_between . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430
_days_to_end_of_month . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430
_first_of_month. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430
_last_of_month . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431
_make_timestamp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431
_months_between . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432
_week_of_year . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432
_years_between . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432
_ymdint_between . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432
Funciones de bloque . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433
_firstFromSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433
_remainderSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434
Datos Aster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434
Cadena de datos Aster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434
Formateo de tipo de datos de los datos Aster. . . . . . . . . . . . . . . . . . . . . . . 436
Funciones matemáticas de datos Aster . . . . . . . . . . . . . . . . . . . . . . . . . 436
Trigonometría de datos Aster . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437
ascii . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438
chr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438
current_schema. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438
translate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438
Contenido ix

date_trunc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438
version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439
DB2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439
Funciones matemáticas de DB2 . . . . . . . . . . . . . . . . . . . . . . . . . . . 439
Funciones trigonométricas de DB2 . . . . . . . . . . . . . . . . . . . . . . . . . . 439
ascii . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441
ceiling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441
char . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441
chr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441
concat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442
date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442
day. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442
dayname . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443
dayofweek . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443
dayofweek_iso . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443
dayofyear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443
days . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444
dec. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444
decimal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444
difference. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444
digits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445
double. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445
event_mon_state . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445
float . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445
hex. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445
hour . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445
insert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446
integer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446
int . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446
julian_day . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447
lcase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447
left . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447
length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447
locate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448
long_varchar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448
ltrim . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448
microsecond . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448
midnight_seconds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449
minute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449
month . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449
monthname . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449
quarter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450
radians . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450
repeat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450
replace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450
right . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451
round . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451
rtrim . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451
second . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452
sign . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452
smallint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452
soundex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452
space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452
substr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453
table_name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453
table_schema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453
time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453
timestamp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453
timestamp_iso . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454
timestampdiff . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454
to_char . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454
x IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

translate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454
trunc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455
truncate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455
ucase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455
value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456
varchar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456
week . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456
year . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456
Greenplum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457
Cadena de Greenplum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457
Formateo de tipo de datos de Greenplum . . . . . . . . . . . . . . . . . . . . . . . . 458
Funciones matemáticas de Greenplum . . . . . . . . . . . . . . . . . . . . . . . . . 459
Funciones trigonométricas de Greenplum . . . . . . . . . . . . . . . . . . . . . . . . 459
ascii . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461
chr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461
current_database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461
current_schema. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461
{current_user} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461
{session_user} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461
translate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461
date_trunc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462
version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462
Informix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462
Funciones matemáticas de Informix . . . . . . . . . . . . . . . . . . . . . . . . . . 462
Funciones trigonométricas de Informix . . . . . . . . . . . . . . . . . . . . . . . . . 462
cardinalidad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463
char_length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463
concat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464
date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464
day. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464
extend. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464
hex. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464
initcap. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465
length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465
lpad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465
mdy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465
month . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465
nvl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465
octet_length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466
replace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466
round . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466
rpad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466
substr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467
to_char . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467
to_date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467
trunc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467
weekday . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467
year . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468
MS Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468
Funciones cast de MS Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468
Funciones matemáticas de MS Access . . . . . . . . . . . . . . . . . . . . . . . . . 469
Funciones trigonométricas de MS Access . . . . . . . . . . . . . . . . . . . . . . . . 469
ascii . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469
ceiling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470
chr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470
concat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470
curdate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470
curtime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470
dayname . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470
dayofmonth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471
dayofweek . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471
Contenido xi

dayofyear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471
hour . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471
instr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471
lcase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471
left . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471
length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472
locate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472
ltrim . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472
minute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472
month . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472
monthname . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472
now . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473
position . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473
quarter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473
right . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473
round . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473
rtrim . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474
sign . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474
space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474
substr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474
substring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474
truncate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475
ucase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475
week . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475
year . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475
MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475
Cadena de MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475
Funciones matemáticas de MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . 477
Funciones trigonométricas de MySQL . . . . . . . . . . . . . . . . . . . . . . . . . 477
ascii . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479
database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479
esquema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479
session_user . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479
system_user . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479
version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479
Netezza . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479
Funciones matemáticas de Netezza . . . . . . . . . . . . . . . . . . . . . . . . . . 479
Funciones trigonométricas de Netezza . . . . . . . . . . . . . . . . . . . . . . . . . 480
Netezza Fuzzy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481
Funciones fonéticas de Netezza . . . . . . . . . . . . . . . . . . . . . . . . . . . 481
ascii . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482
chr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482
decode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482
initcap. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482
instr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482
lpad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483
ltrim . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483
months_between . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483
next_day . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483
nvl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483
round . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484
rpad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484
rtrim . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484
substr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484
{current_db} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484
{current_user} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 485
{session_user} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 485
to_char . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 485
to_date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 485
to_number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 485
translate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 485
xii IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

date_trunc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 485
trunc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 485
version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486
Oracle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486
Funciones matemáticas de Oracle. . . . . . . . . . . . . . . . . . . . . . . . . . . 486
Funciones trigonométricas de Oracle . . . . . . . . . . . . . . . . . . . . . . . . . 486
add_months . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487
ascii . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487
ceil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488
char_length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488
chr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488
concat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488
decode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488
dump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489
greatest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489
initcap. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489
instr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489
instrb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489
least . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489
length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490
lengthb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490
lpad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490
ltrim . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490
months_between . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490
new_time. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490
next_day . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491
nls_initcap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491
nls_lower. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491
nls_upper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491
nvl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491
replace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492
round . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492
rpad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492
rtrim . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492
sign . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493
soundex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493
substr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493
substrb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493
{sysdate} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493
to_char . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494
to_date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494
to_number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494
translate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494
trunc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494
trunc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495
{user} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495
vsize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495
Paraccel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495
Cadena de Paraccel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495
Formateo de tipo de datos de Paraccel . . . . . . . . . . . . . . . . . . . . . . . . . 496
Funciones matemáticas de Paraccel . . . . . . . . . . . . . . . . . . . . . . . . . . 496
current_database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496
current_schema. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496
{current_user} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 497
{session_user} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 497
translate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 497
version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 497
Postgres . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 497
Cadena de Postgres . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 497
Formateo de tipo de datos de Postgres . . . . . . . . . . . . . . . . . . . . . . . . . 499
Funciones matemáticas de Postgres . . . . . . . . . . . . . . . . . . . . . . . . . . 499
Contenido xiii

Funciones trigonométricas de Postgres . . . . . . . . . . . . . . . . . . . . . . . . . 500
ascii . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501
chr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502
{current_db} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502
{current_catalog} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502
{current_schema} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502
{current_user} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502
{session_user} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502
translate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502
date_trunc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502
version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502
Red Brick. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503
ceil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503
concat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503
{current_user} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503
date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503
dateadd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503
datediff . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 504
datename. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 504
dec. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 504
decimal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 504
decode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 504
float . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 504
ifnull . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505
int . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505
integer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505
length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505
lengthb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505
ltrim . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505
nullif . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506
positionb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506
real. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506
round . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506
rtrim . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506
sign . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507
string . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507
substr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507
substrb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507
time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507
timestamp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 508
timestamp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 508
to_char . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 508
SAP BW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 508
Funciones trigonométricas de SAP BW . . . . . . . . . . . . . . . . . . . . . . . . . 508
Funciones matemáticas de SAP BW . . . . . . . . . . . . . . . . . . . . . . . . . . 509
Salesforce.com . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 509
Funciones de fecha . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 509
convertCurrency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513
convertTimezone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513
SQL Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513
Funciones matemáticas de SQL Server . . . . . . . . . . . . . . . . . . . . . . . . . 513
Funciones trigonométricas de SQL Server . . . . . . . . . . . . . . . . . . . . . . . . 513
ascii . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515
char . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515
charindex. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515
{current_user} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515
datalength . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 516
dateadd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 516
datediff . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 516
datename. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 516
datepart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 516
xiv IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

day. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517
difference. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517
getdate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517
isnull . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517
left . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518
ltrim . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518
month . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518
patindex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518
replace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519
replicate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519
reverse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519
right . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519
round . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519
rtrim . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519
sign . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520
soundex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520
space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520
str . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520
stuff . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520
year . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520
Sybase. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 521
Funciones matemáticas de Sybase . . . . . . . . . . . . . . . . . . . . . . . . . . 521
Funciones trigonométricas de Sybase . . . . . . . . . . . . . . . . . . . . . . . . . 521
ascii . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 522
char . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523
charindex. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523
datalength . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523
dateadd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523
datediff . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524
datename. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524
datepart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524
day. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524
difference. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525
getdate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525
left . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525
ltrim . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525
month . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526
patindex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526
rand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526
replicate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526
reverse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526
right . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526
round . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526
rtrim . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527
soundex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527
space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527
str . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527
stuff . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527
substring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528
to_unichar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528
uhighsurr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528
ulowsurr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528
uscalar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529
year . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529
Teradata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529
Funciones trigonométricas de Teradata . . . . . . . . . . . . . . . . . . . . . . . . . 529
account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531
add_months . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531
bytes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531
case_n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531
char2hexint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531
Contenido xv

characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532
database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532
date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532
format. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532
index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532
log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532
nullif . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532
nullifzero . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532
profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 533
random . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 533
role. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 533
sesión . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 533
soundex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 533
substr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 533
time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534
type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534
user . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534
vargraphic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534
zeroifnull . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534
Vectorwise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534
Cadena de Vectorwise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534
Funciones matemáticas de Vectorwise . . . . . . . . . . . . . . . . . . . . . . . . . 535
Funciones trigonométricas de Vectorwise . . . . . . . . . . . . . . . . . . . . . . . . 536
{initial_user}. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537
{session_user} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537
numeric_trunc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537
Vertica. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537
Vertica String . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537
Formateo de tipo de datos de Vertica . . . . . . . . . . . . . . . . . . . . . . . . . 539
Vertica Math. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539
Vertica Trigonometry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 540
ascii . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541
chr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541
current_database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541
current_schema. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541
{current_user} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541
{session_user} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542
translate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542
date_trunc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542
version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542
Funciones de macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542
+ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542
_add_days . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 543
_add_months . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 543
_add_years . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544
array . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544
csv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545
dq . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545
getConfigurationEntry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545
grep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545
_first_of_month. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 546
_last_of_month . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 546
join. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547
lstrip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547
prompt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547
promptmany . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 548
rstrip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 549
sb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 549
sq . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 549
sort. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 550
split . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 550
xvi IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

strip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 550
substitute. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 551
timestampMask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 551
toLocal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 552
tolower . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 553
toupper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 553
toUTC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 553
exclusivos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 554
urlencode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 554
CSVIdentityName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555
CSVIdentityNameList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555
CAMPassport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555
CAMIDList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555
CAMIDListForType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556
simple case . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556
Funciones comunes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556
abs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556
cast. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 557
ceil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558
ceiling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558
char_length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558
character_length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558
coalesce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559
current_date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559
current_time. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559
current_timestamp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559
exp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 560
extract. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 560
floor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 560
ln . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561
localtime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561
localtimestamp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561
lower . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561
mod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562
nullif . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562
octet_length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562
position . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563
power . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563
_round . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563
row . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 564
sqrt. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 564
substring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 565
trim . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 565
upper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 565
width-bucket . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 566
Funciones trigonométricas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 566
Funciones dimensionales . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 569
ancestor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 569
ancestors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 569
bottomCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570
bottomPercent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570
bottomSum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570
caption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 571
children . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 571
closingPeriod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 572
cousin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 572
completeTuple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 573
currentMember . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574
defaultMember . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574
descendants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574
except . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 576
Contenido xvii

filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 576
firstChild . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 577
firstSibling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 577
_format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 577
emptySet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 578
generate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 578
head . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 578
hierarchize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 579
hierarchy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 579
item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 580
intersect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 580
lag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 580
lastChild . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 581
lastPeriods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 581
lastSibling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 582
lead . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 582
level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583
niveles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583
linkMember . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584
members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584
nextMember. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584
openingPeriod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585
order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585
ordinal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586
parallelPeriod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586
parent. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 587
periodsToDate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 587
prevMember . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 588
member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 588
nestedSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 589
set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 589
siblings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 589
tail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 589
topCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590
topPercent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590
topSum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591
tuple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591
union . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591
roleValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 592
rootMember . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 593
rootMembers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 593
subset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 593
exclusivos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594
value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594
Funciones de informe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 595
Today . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 595
Now . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 595
AsOfDate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 595
AsOfTime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 595
ReportDate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 595
ReportName. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 595
ReportPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 595
ReportDescription . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596
ReportLocale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596
GetLocale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596
Locale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596
ReportProductLocale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596
ReportAuthorLocale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596
ReportSaveDate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596
ReportCreateDate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596
ReportID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597
xviii IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

ReportOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597
ReportOption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597
ServerName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597
ServerLocale. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597
ModelPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597
BurstKey . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597
BurstRecipients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598
IsBursting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598
ParamNames . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598
ParamName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598
ParamDisplayValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598
ParamValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598
ParamCount. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598
RowNumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598
PageNumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599
PageCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599
IsPageCountAvailable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599
HorizontalPageNumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599
HorizontalPageCount. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599
PageName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599
URLEncode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599
TOCHeadingCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599
IsAccessible . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 600
ColumnNumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 600
IsCrosstabRowNodeMember . . . . . . . . . . . . . . . . . . . . . . . . . . . . 600
IsCrosstabColumnNodeMember . . . . . . . . . . . . . . . . . . . . . . . . . . . 600
IsInnerMostCrosstabRowNodeMember . . . . . . . . . . . . . . . . . . . . . . . . . 600
IsInnerMostCrosstabColumnNodeMember. . . . . . . . . . . . . . . . . . . . . . . . 600
IsOuterMostCrosstabRowNodeMember. . . . . . . . . . . . . . . . . . . . . . . . . 600
IsOuterMostCrosstabColumnNodeMember . . . . . . . . . . . . . . . . . . . . . . . 601
IsFirstColumn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 601
IsLastColumn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 601
IsLastInnerMostCrosstabColumnNodeMember . . . . . . . . . . . . . . . . . . . . . . 601
IsLastInnerMostCrosstabRowNodeMember . . . . . . . . . . . . . . . . . . . . . . . 601
CubeName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 601
CubeDescription . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 601
CubeCreatedOn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 602
CubeDataUpdatedOn. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 602
CubeSchemaUpdatedOn. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 602
CubeIsOptimized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 602
CubeDefaultMeasure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 602
CubeCurrentPeriod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 602
CellValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 602
InScope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603
Funciones de conversión de tipo de datos . . . . . . . . . . . . . . . . . . . . . . . . . 603
_add_days . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603
_add_months . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603
_add_years . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603
_age . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603
_day_of_week . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604
_day_of_year . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604
_days_between . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604
_days_to_end_of_month . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604
_first_of_month. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604
_last_of_month . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605
_make_timestamp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605
_months_between . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605
_week_of_year . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605
_years_between . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605
_ymdint_between . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 606
abs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 606
Contenido xix

ceiling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 606
character_length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 606
date2string . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 606
date2timestamp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 606
date2timestampTZ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607
DTinterval2string . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607
DTinterval2stringAsTime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607
exp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607
extract. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607
floor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 608
int2DTinterval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 608
int2YMinterval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 608
ln . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 608
lower . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 608
mapNumberToLetter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 609
mod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 609
nullif . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 609
number2string . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 609
octet_length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 609
position . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 609
power . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610
round . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610
sqrt. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610
status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610
string2date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610
string2double . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 611
string2DTinterval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 611
string2int32 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 611
string2int64 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 611
string2time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 611
string2timestamp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 611
string2timestampTZ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 611
string2YMinterval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612
substring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612
time2string . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612
timestamp2date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612
timestamp2string . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612
timestamp2timestampTZ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612
timestampTZ2date. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613
timestampTZ2string . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613
timestampTZ2timestamp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613
timeTZ2string . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613
trim . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613
upper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613
YMinterval2string . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613
Apéndice D. Referencia de formateo de datos . . . . . . . . . . . . . . . . . . 615
Propiedades de formateo de datos . . . . . . . . . . . . . . . . . . . . . . . . . . . 615
Caracteres "no aplicables" . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615
Cualquier carácter de error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615
Tipo de calendario. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615
Reloj . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615
Moneda . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615
Visualización de moneda . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 616
Símbolo de moneda . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 616
Posición del símbolo de moneda . . . . . . . . . . . . . . . . . . . . . . . . . . . 616
Orden de fechas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 616
Separador de fecha . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 616
Estilo de fecha . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 616
Separador decimal. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 616
Formato de los dígitos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 616
xx IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Formato de los dígitos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617
Mostrar símbolos AM / PM . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617
Mostrar como exponente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617
Mostrar días. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617
Mostrar eras. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617
Mostrar horas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617
Mostrar milisegundos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617
Mostrar minutos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617
Mostrar meses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617
Mostrar meses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617
Mostrar segundos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618
Mostrar huso horario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618
Mostrar días de la semana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618
Mostrar años . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618
Mostrar años . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618
Caracteres de división por cero . . . . . . . . . . . . . . . . . . . . . . . . . . . 618
Símbolo de exponente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618
Tamaño de grupo (dígitos) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618
Símbolo de moneda internacional . . . . . . . . . . . . . . . . . . . . . . . . . . 618
Mantisa (dígitos) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618
Número máximo de dígitos . . . . . . . . . . . . . . . . . . . . . . . . . . . . 619
Número mínimo de dígitos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 619
Caracteres de los valores ausentes . . . . . . . . . . . . . . . . . . . . . . . . . . 619
Modelo para números negativos . . . . . . . . . . . . . . . . . . . . . . . . . . . 619
Posición del signo negativo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 619
Símbolo de signo negativo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 619
Número de posiciones decimales . . . . . . . . . . . . . . . . . . . . . . . . . . . 619
Caracteres de desbordamiento numérico . . . . . . . . . . . . . . . . . . . . . . . . 619
Carácter de relleno . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 619
Modelo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 619
Símbolo de porcentaje . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 620
Escala de porcentaje (entero) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 620
Escala . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 620
Tamaño de grupo secundario (dígitos) . . . . . . . . . . . . . . . . . . . . . . . . . 620
Caracteres de errores de seguridad . . . . . . . . . . . . . . . . . . . . . . . . . . 620
Separador de miles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 620
Separador de hora. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 620
Estilo de hora . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 620
Unidad de tiempo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 621
Usar separador de miles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 621
Caracteres con valor cero . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 621
Apéndice E. Utilización de modelos para formatear datos . . . . . . . . . . . . . 623
Directrices de modelos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 623
Símbolos de fecha y hora . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 624
Símbolos de formato decimal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 631
Apéndice F. Directrices para trabajar con datos de SAP BW para su uso en
Transformer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 633
Cómo trabajar con datos de SAP BW utilizando un paquete de Framework Manager . . . . . . . . . . 633
Creación de una consulta BW en SAP Business Explorer Query Designer . . . . . . . . . . . . . 634
Creación de un paquete en Framework Manager . . . . . . . . . . . . . . . . . . . . . 637
Creación de un modelo en Transformer. . . . . . . . . . . . . . . . . . . . . . . . . 639
Cómo trabajar con datos de SAP BW utilizando archivos CSV externalizados en Framework Manager . . . . 641
Requisitos de una consulta SAP BW . . . . . . . . . . . . . . . . . . . . . . . . . . 642
Consideraciones sobre Framework Manager . . . . . . . . . . . . . . . . . . . . . . . 644
Creación de PowerCubes a partir de datos SAP BW . . . . . . . . . . . . . . . . . . . . 645
Contenido xxi

Apéndice G. Palabras reservadas. . . . . . . . . . . . . . . . . . . . . . . . 649
Apéndice H. Tipos de datos XML . . . . . . . . . . . . . . . . . . . . . . . . 651
Avisos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 653
Glosario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 657
A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 657
C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 658
D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 659
E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 660
G . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 661
H . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 661
I. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 661
J. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 661
L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 661
M . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 661
N . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 662
O . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 662
P . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 662
R . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 663
S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 664
T . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 664
U . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 665
V . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 665
W . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 665
Índice. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 667
xxii IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Introducción
IBM ® Cognos Framework Manager es una herramienta de modelado de metadatos.
Un modelo es una presentación empresarial de la información de unos o varios
orígenes de datos. Al añadir prestaciones de seguridad y multilingües a la
presentación empresarial, un único modelo puede satisfacer las necesidades de
muchos grupos de usuarios de todo el mundo.
Este documento incluye procedimientos, ejemplos, notas, sugerencias y otra
información relevante que le ayudarán a preparar un modelo para generar
informes y desplegar un paquete.
Público
Este documento está pensado para ayudar a los modeladores a utilizar IBM
Cognos Framework Manager. Antes de utilizar Framework Manager, debe
comprender cómo funciona el modelado de datos y cómo se escriben consultas.
Búsqueda de información
Para buscar documentación de productos de IBM Cognos en la web, incluida toda
la documentación traducida, acceda a uno de los Information Center de IBM
Cognos (http://pic.dhe.ibm.com/infocenter/cogic/v1r0m0/index.jsp). Las notas de
la versión se publican directamente en los Information Center e incluyen enlaces
con las notas técnicas y los APAR más recientes.
Asimismo, puede consultar las versiones en formato PDF de las notas de la versión
y las guías de instalación de los productos directamente en los discos de los
productos de IBM Cognos.
Proyecciones futuras
En esta documentación se describe la funcionalidad actual del producto. Puede que
se incluyan referencias a elementos que actualmente no están disponibles. Sin
embargo, no deberá deducirse su futura disponibilidad real. Estas referencias no
constituyen un compromiso, promesa ni obligación legal que implique la entrega
de ningún tipo de material, código o funcionalidad. El desarrollo, entrega y
comercialización de las características o funcionalidad son aspectos que quedan a
la entera discreción de IBM.
Declaración de limitación de responsabilidad de los ejemplos
La compañía Ejemplo Viaje de Aventuras, la compañía Viaje de aventuras, Ventas
de VA, las variaciones del nombre Viaje de Aventuras y Ejemplo Viaje de
Aventuras y Ejemplo de planificación representan operaciones empresariales
ficticias con datos de ejemplo utilizados para desarrollar aplicaciones de ejemplo
para IBM y clientes de IBM. Estos registros ficticios incluyen datos de ejemplo para
las transacciones de ventas, la distribución de productos, la gestión financiera y los
recursos humanos. Cualquier parecido con nombres, direcciones, números de
contacto o valores de transacciones reales es pura coincidencia. Otros archivos de
ejemplo pueden contener datos ficticios generados manual o informáticamente,
datos relativos a hechos procedentes de fuentes públicas o académicas, o datos
utilizados con el permiso del poseedor del copyright, para utilizarlos como datos
© Copyright IBM Corp. 2005, 2013 xxiii

de ejemplo para desarrollar las aplicaciones de ejemplo. Los nombres de productos
a los que se hace referencia pueden ser marcas registradas de sus respectivos
propietarios. Está prohibido realizar cualquier tipo de duplicación no autorizada.
Características de accesibilidad
Las características de accesibilidad ayudan a los usuarios que tienen una
discapacidad física, por ejemplo movilidad restringida o visión limitada, a utilizar
productos de tecnología de la información. IBM Cognos Framework Manager tiene
características de accesibilidad. Para obtener información, consulte: Apéndice A,
“Características de accesibilidad”, en la página 385.
xxiv IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Capítulo 1. Novedades
Esta sección contiene una lista de las características nuevas, modificadas, obsoletas
y eliminadas de esta versión de IBM Cognos Framework Manager. Además incluye
una lista acumulada con información similar de versiones anteriores. Esta
información le permitirá planificar sus estrategias de actualización y despliegue de
aplicaciones, así como las necesidades de formación de sus usuarios.
Para obtener información sobre las actualizaciones, consulte la publicación IBM
CognosGuía de instalación y configuración y Capítulo 11, “Actualización de modelos”,
en la página 375.
Para obtener información sobre las nuevas características de esta versión, consulte
a publicación IBM CognosGuía de características nuevas.
Para obtener una lista actualizada de los entornos soportados por los productos
IBM Cognos, como los sistemas operativos, parches, navegadores, servidores web,
servidores de directorios, servidores de bases de datos y servidores de aplicaciones,
visite http://www.ibm.com/.
Características nuevas en 10.2.1
Las características siguientes son nuevas en este release de IBM Cognos
Framework Manager.
Propiedades nuevas para controlar las transacciones de
lectura/escritura
Hay disponibles dos propiedades nuevas en los orígenes de datos de Framework
Manager. Estas propiedades son Modo de acceso a transacción y Modo de
sentencia de transacción.
De forma predeterminada, un asunto de consulta que contiene un procedimiento
almacenado se ejecuta en una transacción de sólo lectura. Sin embargo, el
procedimiento almacenado puede incluir operaciones que requieran una
transacción de lectura/escritura. En releases anteriores de Framework Manager, los
asuntos de consulta que utilizaban procedimientos podían ejecutarse en una
transacción de lectura/escritura. Sin embargo, sólo eran visibles para los autores de
Event Studio. Las nuevas propiedades permiten que los asuntos de consulta que se
ejecutan en transacciones de lectura/escritura se utilicen en todas las demás
aplicaciones Studio.
Para obtener más información, consulte: “Especificar modos de transacción” en la
página 315
Características nuevas en 10.2
A continuación encontrará una lista de características nuevas respecto a la versión
anterior.
© Copyright IBM Corp. 2005, 2013 1

Características nuevas específicas de proveedor
Las funciones específicas de Vectorwise se muestran ahora en el editor de
expresiones de la carpeta Funciones específicas de proveedor.
Características modificadas en 10.2
A continuación encontrará una lista de las características modificadas respecto a la
versión anterior. Se incluyen enlaces a los temas relacionados directamente.
Cambio del idioma de la interfaz de usuario del producto
En Framework Manager, puede especificar el idioma de la interfaz de usuario del
producto.
De forma predeterminada, el entorno local del producto Framework Manager está
establecido en el entorno local del sistema. Puede reemplazar este valor añadiendo
manualmente una entrada de preferencia al archivo bmt.ini. Por ejemplo,
>Section name = BMTUI
>Preference Name="ForceProductLocale">en-ca
Sustituya la cadena "en-ca" por cualquier código de entorno local de producto
válido. El entorno local del producto especifica qué idioma o configuración
regional se utilizan para partes de la interfaz del producto, como los comandos de
menú.
Especificación del modo de consulta para un proyecto
Cuando se crea un nuevo proyecto en IBM Cognos Framework Manager, ahora el
nuevo proyecto utiliza el modo de consulta dinámica de forma predeterminada.
Modelos duraderos soportados para orígenes de datos DMR
Ahora los procesos de modelos duraderos están soportados para el modelado
dimensional de orígenes de datos relacionales (DMR).
Características nuevas en 10.1.1
A continuación encontrará una lista de características nuevas respecto a la versión
anterior.
Validación de objetos de modelo
En esta versión, se ha aumentado la flexibilidad en relación a la validación de
objetos de modelo. Se ha añadido el botón Validar para elementos como elementos
de consulta, relaciones y dimensiones. Puede servir de ayuda en el proceso de
modelado ya que se puede realizar la validación al crear o modificar una
definición individual. El botón Validar y el comando Validar objeto del menú
Herramientas realizan la misma función.
En la versión anterior, se establecía la opción Validar automáticamente del menú
Herramientas para la validación automática. En esta versión, el valor
predeterminado es sin validación automática.
2 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Si la opción Validar automáticamente está habilitada, el botón Aceptar vuelve a
comprobar la validación y guarda el objeto en una acción.
Características nuevas específicas de proveedor
Las funciones específicas de datos Aster se visualizan ahora en el editor de
expresiones en la carpeta Funciones específicas de proveedor.
Características modificadas en 10.1.1
A continuación encontrará una lista de las características modificadas respecto a la
versión anterior. Se incluyen enlaces a los temas relacionados directamente.
Especificación del modo de consulta para un proyecto
Cuando se crea un proyecto nuevo en IBM Cognos Framework Manager, ahora se
puede especificar qué Modo de consulta utilizará el proyecto. En el diálogo Nuevo
proyecto, hay una casilla de verificación que permite especificar el modo de
consulta dinámica. De forma predeterminada, un proyecto nuevo utiliza un modo
de consulta compatible.
También se puede cambiar de un modo a otro dentro del proyecto. En el panel
Propiedades para el proyecto, puede modificar la propiedad Modo de consulta.
Para obtener más información, consulte: IBM CognosGuía de consultas dinámicas.
Control del modo de consulta dinámica con reguladores
IBM Cognos Framework Manager proporciona un nuevo conjunto de reguladores
para controlar determinada funcionalidad del modo de consulta dinámica.
Para obtener más información, consulte: IBM CognosGuía de consultas dinámicas.
Importación de metadatos relacionales a Framework Manager
La función Importar metadatos relacionales de IBM Cognos Administration
especifica que un grupo tiene la posibilidad de importar metadatos relacionales a
un proyecto de IBM Cognos Framework Manager utilizando el modo de consulta
dinámica.
De forma predeterminada, los grupos Administradores del sistema,
Administradores del directorio y Administradores de informes pertenecen a la
función Importar metadatos relacionales.
Para realizar importaciones relacionales a un proyecto de modo de consulta
dinámica, se deben añadir otros grupos manualmente a la función. Por ejemplo, si
crea un grupo Usuarios de IBM Cognos Framework Manager y añade sus usuarios
de IBM Cognos Framework Manager a ese grupo, también necesitará añadir el
grupo a la función Importar metadatos relacionales. Los usuarios deben tener
permisos de visita y ejecución.
Cambio de nombre de los elementos de menús
Se ha cambiado el nombre de dos elementos de menús; su funcionalidad se
conserva igual. El comando de evaluación automática del menú Proyecto se
denomina ahora Validar automáticamente. El comando de evaluación de objeto del
Capítulo 1. Novedades 3

menú Herramientas se denomina ahora Validar objeto.
Características nuevas en 10.1.0
A continuación encontrará una lista de características nuevas respecto a la versión
anterior. Se incluyen enlaces a los temas relacionados directamente.
Model Design Accelerator
Model Design Accelerator es un programa de utilidad gráfico diseñado para guiar
a los modeladores principiantes y experimentados en un proceso de modelado
simplificado. Los modeladores principiantes, sin mucha experiencia ni formación,
tendrán la posibilidad de crear fácilmente modelos potentes. Los modeladores con
experiencia podrán acelerar el proceso de modelado y reducir el tiempo de
creación de un modelo. Para obtener más información, consulte: Capítulo 3,
“Model Design Accelerator”, en la página 29
Modelos duraderos
Cuando se crea un modelo de IBM Cognos Framework Manager utilizando la
función de modelo duradero, se puede cambiar el nombre de los elementos de
consulta en el modelo sin romper las referencias a los nombres cambiados en los
informes existentes. Para obtener más información, consulte: “Modelos duraderos”
en la página 184.
Modo de consulta dinámica
En IBM Cognos Framework Manager, puede especificar que un paquete basado en
un origen de datos soportado puede utilizar el modo de consulta dinámica, que es
un modo de ejecución de consulta basado en Java. Este modo ofrece una mejora
del rendimiento y funcionalidad de las consultas, almacenamiento en memoria
caché segura e interfaces de datos nativas para utilizar la tecnología de 64 bits.
Para obtener información sobre orígenes de datos soportados, consulte la
publicación IBM Cognos Guía de consultas dinámicas.
Utilice el modo de consulta dinámica estableciendo el conmutador Utilizar modo
de consulta dinámica de la página Opciones del Asistente de publicación. Para
obtener más información, consulte: “Publicación de paquetes” en la página 264.
Más información sobre el modo de consulta dinámica
Para obtener más información sobre el modo de consulta dinámica, consulte los
documentos indicados en la tabla siguiente.
Tabla 1. Dónde encontrar información sobre el modo de consulta dinámica
¿Qué busca? Dónde encontrar la información
Una descripción general del modo de IBM Cognos Business Intelligence Guía de
consulta dinámica, sus ventajas y
consultas dinámicas
consideraciones sobre su utilización.
Información detallada sobre técnicas y IBM Cognos 10 Dynamic Query Cookbook en
comportamientos de productos del modo de la sección de prácticas recomendables del
consulta dinámica.
centro del cliente de IBM Cognos
http://www.ibm.com/software/data/
cognos/customercenter/
(http://www.ibm.com/software/data/
cognos/customercenter/).
4 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Tabla 1. Dónde encontrar información sobre el modo de consulta dinámica (continuación)
¿Qué busca? Dónde encontrar la información
Información sobre la habilitación de la IBM Cognos Business Intelligence Guía de
conectividad para orígenes de datos instalación y configuración
soportados por el modo de consulta
dinámica.
Información sobre la administración de
Query Service, incluyendo el
almacenamiento en memoria caché y las
propiedades de Query Service.
Información sobre la publicación de
paquetes para el modo de consulta
dinámica.
Información sobre la prueba de informes en
modo de consulta dinámica antes de la
actualización.
Información sobre la utilización de IBM
Cognos Software Development Kit para
administrar las propiedades de Query
Service y desarrollar aplicaciones de cliente
para utilizar el modo de consulta dinámica.
IBM Cognos Business Intelligence Guía de
administración y seguridad
IBM Cognos Framework Manager Guía del
usuario
IBM Cognos Lifecycle Manager User Guide
IBM Cognos Software Development Kit
Developer Guide
Creación de paquetes para orígenes de datos de SAP BW
Puede crear paquetes para cubos de SAP BW y consultas directamente en IBM
Cognos Connection. No cambia la funcionalidad de Framework Manager para
crear y publicar paquetes de SAP BW. Con independencia del lugar donde se creen
los paquetes, son idénticos y los estudios de IBM Cognos pueden utilizarlos de la
misma manera.
Para obtener más información, consulte la sección sobre paquetes en la Guía de
administración y seguridad.
Utilización de jerarquías dependientes del tiempo de SAP BW
Las jerarquías dependientes del tiempo reflejan automáticamente los cambios de
jerarquía o estructura. Cuando una estructura se importa a Framework Manager,
cada jerarquía de tiempo de SAP BW se representa como un nivel individual. Los
usuarios de Report Studio pueden utilizar estas estructuras para informar y
comparar niveles válidos para un periodo de tiempo especificado.
Mejoras de la descripción de funciones
Las funciones que se pueden utilizar para crear cálculos incluyen ahora
descripciones mejores y más ejemplos. Las descripciones y ejemplos se visualizan
en la interfaz de usuario de Framework Manager y esta guía de usuario.
Características nuevas específicas de proveedor
Las funciones que son específicas de Postgres, Vertica, Netezza, Paraccel, MySQL y
Greenplum se visualizan en el editor de expresiones de la carpeta Funciones
específicas de proveedor.
Capítulo 1. Novedades 5

Características eliminadas de 10.1.0
La funcionalidad indicada a continuación se ha eliminado de la versión 10.1.
Control de repositorios
El soporte nativo para los repositorios CVS y Microsoft Visual SourceSafe se ha
eliminado de esta versión. Si utiliza esta característica, y sigue necesitando la
funcionalidad de control de versiones de proyectos, lea la sección “Control de
repositorio externo” en la página 284. Esta sección explica cómo mantener el
control de versiones de proyectos fuera de la aplicación de modelado, y se puede
utilizar con todos los sistemas de control de versiones.
Dimensiones compatibles en orígenes de datos de SAP BW
El soporte para dimensiones compatibles generadas por IBM Cognos Framework
Manager para orígenes de datos de SAP BW se ha eliminado de esta versión.
6 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Capítulo 2. Introducción a Framework Manager
Análisis del problema
IBM Cognos Framework Manager es una herramienta de modelado de metadatos
que controla la creación de consultas para el software de IBM Cognos. Un modelo
es una colección de metadatos que incluye información física e información de la
empresa para uno o varios orígenes de datos. El software de IBM Cognos permite
la gestión del rendimiento en orígenes de datos relacionales normalizados y
desnormalizados, así como una variedad de orígenes de datos OLAP. Al añadir
prestaciones de seguridad y multilingües, un único modelo puede satisfacer las
necesidades de creación de informes, creación de consultas ad hoc y análisis de
muchos grupos de usuarios de todo el mundo.
Antes de realizar una acción en IBM Cognos Framework Manager, debe
comprender perfectamente cuál es el problema de creación de informes que desea
resolver.
Para empezar, realice las acciones siguientes:
Procedimiento
1. Analice el problema de creación de informes.
2. Obtenga información sobre los objetos que va a utilizar.
3. Cree o abra un proyecto.
4. Examine los paneles de Framework Manager.
5. Examine los modelos de muestra incluidos en Framework Manager.
Antes de empezar, debe comprender cuál es el problema de creación de informes
que intenta resolver y de qué datos dispone para resolverlo.
Si no tiene respuestas para todas las cuestiones siguientes, comente con los
usuarios sus necesidades de creación de informes:
Procedimiento
1. ¿Está de acuerdo con los usuarios en las necesidades de creación de informes?
Algunas de las cuestiones que se planteen pueden ser: multilingüismo,
rendimiento, seguridad y cómo organizar y combinar los elementos de consulta
y los filtros.
2. ¿Contiene el origen de datos los datos y metadatos necesarios?
Sin metadatos, como las claves principales, índices y claves foráneas, los
informes pueden tardar mucho en ejecutarse o pueden producir resultados
incorrectos. Si el origen de datos no contiene los datos y metadatos que
necesita, ¿se cambiará o se ofrecerán soluciones alternativas?
3. ¿Existen los mismos datos en más de un origen de datos?
Si es así, elija el origen de datos que más se adecue a sus necesidades de
creación de informes. Si un almacén de datos está disponible, normalmente es
mejor que elegir una base de datos operativa. Lo más idóneo es un almacén de
datos basado en un esquema en estrella. Si no existe, y prevé que la aplicación
de creación de informes se utilizará intensamente, piense en la posibilidad de
crear uno.
© Copyright IBM Corp. 2005, 2013 7

4. ¿Qué tablas de origen de datos son las tablas de hechos, cuáles son las
dimensiones y cuáles son tablas de hecho y dimensiones?
5. ¿Cuáles son las claves y los atributos de cada dimensión?
6. ¿Qué relaciones se requieren?
7. ¿Hay varias rutas de relaciones entre las tablas?
Si es así, ¿qué representa cada ruta? Debe definir la ruta preferida para cada
una.
Resultados
Después, revise los nombres de los orígenes de datos y tablas y columnas del
origen de datos para que no utilicen los nombres reservados por IBM Cognos. Si
tiene que usar una palabra reservada, inclúyala entre comillas en la especificación
SQL. Por ejemplo, select Orderdate, "Timezone". Para obtener más información,
consulte: Apéndice G, “Palabras reservadas”, en la página 649.
Creación de aplicaciones de IBM Cognos business intelligence
Puede utilizar los componentes de IBM Cognos Business Intelligence para crear
aplicaciones de creación de informes y análisis.
La vida útil de una aplicación de IBM Cognos Business Intelligence pueden ser de
meses e, incluso, de años. Durante esta, los datos pueden cambiar y pueden
generarse nuevas necesidades. A medida que los datos subyacentes cambian, los
autores deben modificar el contenido existente y desarrollar contenido nuevo. Con
el tiempo, los administradores también deben actualizar los modelos y los orígenes
de datos. Para obtener más información sobre cómo utilizar los orígenes de datos,
consulte las publicaciones IBM Cognos Business Intelligence Guía de administración y
seguridad e IBM Cognos Framework Manager Guía del usuario.
Antes de empezar
En una aplicación en funcionamiento, la infraestructura técnica y de seguridad y el
portal se encuentran en el lugar adecuado, igual que los procesos para la gestión
de cambios, el control de datos, etc. Para obtener información sobre el flujo de
trabajo asociado a la creación de contenido de IBM Cognos BI, consulte la
publicación IBM Cognos Business Intelligence Guía de arquitectura y despliegue. Para
obtener información adicional, consulte el kit de herramientas de IBM Cognos
Solutions Implementation Methodology, que incluye guías orientativas de
implementación y documentos de soporte. La información sobre el kit de
herramientas está disponible en el Centro del cliente de Cognos
(http://www.ibm.com/software/data/cognos/customercenter/).
En el siguiente gráfico se ofrece una descripción general del uso de IBM Cognos BI
para crear aplicaciones con todos los componentes de IBM Cognos BI.
8 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Procedimiento
Objetos que va a utilizar
1. Localizar y preparar orígenes de datos y modelos.
IBM Cognos BI puede informar a partir de una amplia variedad de orígenes de
datos, tanto relacionales como dimensionales. Las conexiones de base de datos
se crean en la interfaz de administración Web, y se utilizan para modelar, para
crear informes y para ejecutar la aplicación.
Para utilizar los datos de creación y visualización de informes, los estudios de
inteligencia empresarial requieren un subconjunto de un modelo de metadatos
(llamado paquete). Es posible que los metadatos requieran un modelado amplio
en Framework Manager.
2. Compilar y publicar el contenido.
Los informes, las tablas de puntuación, los análisis, los espacios de trabajo, etc.
se crean en los estudios de inteligencia empresarial de IBM Cognos BI. El
estudio que deba utilizar dependerá del contenido, la vida útil y el público del
informe, así como de si el modelado de los datos es dimensional o relacional.
Por ejemplo, los informes y los análisis automáticos se realizan con IBM
Cognos Workspace Advanced, IBM Cognos Query Studio e IBM Cognos
Analysis Studio, mientras que los informes planificados se crean en IBM
Cognos Report Studio. Los informes y las tablas de puntuación de Report
Studio suelen prepararse para un público más amplio, publicarse en IBM
Cognos Connection u otro portal, y planificarse para la separación, distribución,
etc. También se puede utilizar Report Studio para preparar plantillas para crear
informes automáticos.
3. Entregar y visualizar la información.
El contenido se entrega desde el portal de IBM Cognos u otros portales
soportados, y se visualiza la información que se ha guardado en los portales o
que se ha entregado mediante otros mecanismos. También es posible ejecutar
informes, análisis, tablas de puntuación, etc. desde el estudio de inteligencia
empresarial en el que se crean.
Para obtener información sobre el ajuste y el rendimiento, consulte la
publicación IBM Cognos Business Intelligence Guía de administración y seguridad y
el Centro del cliente de Cognos (http://www.ibm.com/software/data/cognos/
customercenter/).
Cuando se trabaja en IBM Cognos Framework Manager, se utilizan distintos
objetos contenidos en un proyecto.
Proyectos
Un proyecto contiene un modelo, espacios de nombres, paquetes, orígenes de datos
e información relacionada para mantener y compartir la información de modelo.
Un único proyecto puede abarcar muchos orígenes de datos o tablas.
Un proyecto de IBM Cognos Framework Manager se visualiza como una carpeta
que contiene un archivo de proyecto (.cpf) y los archivos .xml específicos que
definen el proyecto. Los archivos de una carpeta de proyecto son exclusivos para
cada proyecto. El proyecto y sus archivos asociados están contenidos en una
carpeta de proyecto.
En general, no se deben añadir archivos secundarios a la carpeta de proyecto
porque pueden verse afectados por acciones como los comandos mover, cambiar
nombre y suprimir del menú Gestionar proyectos. Si decide añadir archivos
Capítulo 2. Introducción a Framework Manager 9

secundarios a las carpetas de proyecto, los archivos se añaden con rutas absolutas.
Si se mueven desde la ubicación original, deben redirigirse.
Éstos son contenidos de una carpeta de proyecto.
.cpf
El archivo del proyecto de Framework Manager, que hace referencia a los
archivos .xsd y .xml que definen un proyecto.
archive-log.xml
Este archivo contiene la parte del archivo de registro principal que se ha
archivado.
customdata.xml
Este archivo contiene la información de diseño para el diagrama.
Si se suprime este archivo, la información de diseño se pierde. Se aplicará
un diseño automático.
IDLog.xml
Este archivo hace un seguimiento de los objetos para modelos que utilizan
la bifurcación y fusión.
log.xml
Una lista de todas las modificaciones realizadas en el modelo.
mda_metadata.xml
Un archivo de Model Design Accelerator, que contiene los metadatos
importados desde orígenes de datos.
mda_engine_project.xml
Un archivo de Model Design Accelerator, que contiene la definición del
esquema en estrella.
model.xml
Los datos reales del modelo creados por los usuarios de Framework
Manager.
preferences.xml
Las preferencias para los proyectos de Framework Manager.
session-log.xml
Una lista de transacciones no guardadas en el modelo. Cuando se guarda
el proyecto, esta lista se suprime. Puede ver el contenido de este archivo
utilizando Ver historial de transacciones.
Cuando se inicia Framework Manager, el nombre del archivo
session-log.xml cambia a session-log-backup.xml.
session-log-backup.xml
Archivo session-log.xml de la sesión anterior. Con este archivo, un
modelador puede ejecutar un script para restaurar las transacciones del
modelo que no se habían guardado, en caso de una interrupción
inesperada de la sesión actual.
Este archivo se suprime cada vez que Framework Manager se inicia.
Asegúrese de que hace una copia de este archivo antes de salir de la sesión
actual de Framework Manager si desea conservar una copia.
10 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

epository.xml
El historial de la versión registrada para cada proyecto o segmento que se
ha añadido a este repositorio; este archivo solo existe si se han añadido
proyectos a un repositorio.
upgradeReport.htm
El contenido del mensaje de resumen de actualización que se visualiza
después de la actualización.
Modelos
Un modelo es el conjunto de dimensiones, asuntos de consulta y otros objetos
relacionados necesarios para una o varias aplicaciones de informe relacionadas.
El modelo de Framework Manager es una capa de metadatos que añade valor a un
origen de datos de distintas formas. Lo más importante, proporciona una vista
empresarial de la información de los datos de origen para simplificar la creación de
informes, el análisis y las consultas. La vista empresarial puede:
v Organizar elementos en carpetas que representan áreas de negocio para informes
v Formatear elementos utilizando formatos numéricos, de moneda, de fecha, de
hora y otros
v Presentar nombres de carpeta y elementos multilingües para que los usuarios
puedan trabajar en el idioma de su elección
v Automatizar la generación de consultas SQL enviadas al origen de datos
relacionales
v Especificar solicitudes predeterminadas
Puede incluirse que el software de IBM Cognos solicite al usuario que utilice un
nombre descriptivo aunque realmente filtre un código o un valor de clave, para
mejorar el rendimiento de las consultas.
En particular, puede modificar un modelo de Framework Manager para asegurarse
de que las consultas enviadas al origen de datos sean eficientes, estén bien
formadas y sean seguras. Puede especificar las reglas que controlan la generación
de consultas, restringir el acceso de usuarios a filas o columnas de datos específicas
y modelar las relaciones de datos para ocultar la complejidad de los datos a los
usuarios.
Espacios de nombres
Un espacio de nombres identifica de forma exclusiva los elementos de consulta, las
dimensiones, los asuntos de consulta y otros objetos. Las diferentes bases de datos
se importan a espacios de nombres separados para evitar nombres duplicados.
Paquetes
Un paquete es un subconjunto de dimensiones, asuntos de consulta y otros objetos
definidos en el proyecto. Un paquete es lo que realmente se publica en el servidor
IBM Cognos BI y se utiliza para crear informes, análisis y consultas ad hoc.
Dimensiones
Una dimensión es una amplia agrupación de datos acerca de un aspecto
importante de una empresa, como productos, fechas o mercados.
Capítulo 2. Introducción a Framework Manager 11

Creación de proyectos
Los tipos de dimensiones con los que puede trabajar en IBM Cognos Framework
Manager son dimensiones regulares y dimensiones de medida. En SAP BW, las
dimensiones de medida se conocen como cifras clave.
Asuntos de consulta
Un asunto de consulta es un conjunto de elementos de consulta que tienen una
relación inherente.
En la mayoría de casos, los asuntos de consulta se comportan como tablas. Los
asuntos de consulta producen el mismo conjunto de filas, independientemente de
las columnas que se consultan.
Existen diferentes tipos de asuntos de consulta.
Origen de datos
Los asuntos de consulta de orígenes de datos hacen referencia directamente
a datos de un único origen de datos. IBM Cognos Framework Manager
crea automáticamente un asunto de consulta de orígenes de datos
relacionales para cada tabla y vista que se importa al modelo.
Modelo
Los asuntos de consulta de modelo no se generan directamente desde un
origen de datos, sino que se basan en elementos de consulta de otras
dimensiones o asuntos de consulta, incluidos otros asuntos de consulta de
modelo. Al utilizar asuntos de consulta de modelo, puede crear una vista
más abstracta de orientación empresarial de un origen de datos.
Procedimiento almacenado
Los asuntos de consulta de procedimiento almacenado se generan al
importar un procedimiento desde un origen de datos relacionales. IBM
Cognos Framework Manager solo soporta procedimientos almacenados
definidos por el usuario. Los procedimientos almacenados del sistema no
se soportan.
Elementos de consulta
Un elemento de consulta es la parte más pequeña del modelo que puede incluirse
en un informe. Representa una única característica de algo, como la fecha en que
se presentó un producto.
Los elementos de consulta están contenidos en asuntos de consulta o dimensiones.
Por ejemplo, un asunto de consulta que hace referencia a toda una tabla contiene
elementos de consulta que representan cada columna de la tabla.
Para los usuarios, los elementos de consulta son los objetos más importantes para
crear informes. Utilizan propiedades de los elementos de consulta para crear sus
informes.
En IBM Cognos Framework Manager, se trabaja en el contexto de un proyecto. El
proyecto contiene objetos que se organizan para los usuarios según el modelo de
negocio y las reglas de negocio de la empresa. Estos objetos se ven en la página
del proyecto.
12 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Antes de empezar
Para poder importar metadatos, debe crear un proyecto.
Para obtener información sobre cómo crear un segmento de proyecto, consulte:
“Creación de segmentos” en la página 282.
Para obtener información sobre cómo crear un proyecto con Model Design
Accelerator, consulte: “Creación de un proyecto” en la página 34.
Procedimiento
1. En la página Bienvenidos, pulse Crear un proyecto nuevo.
Sugerencia: Si se encuentra en Framework Manager, pulse Archivo, Nuevo.
2. En la página Nuevo proyecto, especifique un nombre y una ubicación para el
proyecto y pulse Aceptar.
De forma predeterminada, un proyecto nuevo utiliza un modo de consulta
dinámica. Para usar el modo de consulta compatible, desmarque la casilla de
verificación Utilizar modo de consulta dinámica. Para obtener más
información, consulte la publicación IBM Cognos Guía de consultas dinámicas.
3. En la página Seleccionar idioma, pulse el idioma de diseño del proyecto.
No se puede cambiar el idioma seleccionado después de pulsar en Aceptar,
pero se pueden añadir otros idiomas del proyecto. Para obtener más
información, consulte: “Adición de un idioma a un proyecto” en la página 127.
Para obtener más información sobre cómo elegir el idioma de diseño adecuado
para los modelos duraderos, consulte: “Modelos duraderos” en la página 184.
Nota: Si el servidor de SAP BW no da soporte al idioma seleccionado, utiliza la
correlación de entorno local del contenido de la configuración de IBM Cognos.
Si no hay una correlación definida, Framework Manager utiliza el idioma
predeterminado del servidor de SAP BW.
4. Pulse Aceptar para seleccionar el idioma de diseño.
Aparece el asistente de metadatos.
5. Elija si va a importar los metadatos en este momento o más adelante:
v Para importar ahora, seleccione el origen de importación y pulse Siguiente.
v Para posponer la importación de los metadatos, pulse Cancelar.
6. Si opta por importar los metadatos en este momento, siga las instrucciones del
asistente de metadatos:
v Seleccione una conexión de origen de datos y pulse Siguiente.
Si la conexión de origen de datos que desea no está listada, deberá crearla.
Para obtener más información, consulte: “Creación de conexiones de origen
de datos” en la página 44.
v Seleccione las casillas de verificación de los objetos que desea importar.
v Especifique cómo desea que la importación gestione los nombres de objetos
duplicados. Elija si va a importar y crear un nombre exclusivo. Si decide
crear un nombre exclusivo, el objeto importado se muestra con un número.
Por ejemplo, en su proyecto verá QuerySubject y QuerySubject1.
v Si desea importar objetos de sistema, seleccione la casilla de verificación
Mostrar objetos del sistema y seleccione los objetos del sistema que desea
importar.
v Especifique los criterios que va a usar para crear relaciones y pulse Importar.
Para obtener más información, consulte: “Relaciones” en la página 68.
Capítulo 2. Introducción a Framework Manager 13

Apertura de proyectos
La página del proyecto
Se muestra una lista de objetos que no han podido importarse y un recuento de
los objetos que se importaron.
7. Pulse Finalizar.
Guarde el archivo del proyecto (.cpf) y todos los archivos relacionados en una
carpeta. Si guarda un proyecto con un nombre o formato diferente, recuerde
guardar el proyecto en otra carpeta.
Para poder importar metadatos o realizar cambios en los metadatos existentes,
primero debe abrir un proyecto.
Si el proyecto se ha creado con un esquema de modelos anterior a la versión
soportada actualmente, es posible que se le solicite que actualice el modelo.
Si el modelo está incorporado en un repositorio, no puede actualizarlo. Reserve
manualmente el modelo del sistema de control de código fuente y ábralo en la
nueva versión de IBM Cognos Framework Manager.
Si ha actualiza un modelo segmentado, debe abrir y actualizar cada segmento
manualmente. Después de actualizar cada segmento, puede actualizar el proyecto
de nivel superior o maestro.
Procedimiento
1. En la página Bienvenidos, pulse Abrir un proyecto nuevo.
Sugerencia: Si se encuentra en Framework Manager, pulse Archivo, Abrir.
2. Localice la carpeta del proyecto y pulse el archivo .cpf.
3. Pulse Aceptar.
Tras crear o abrir un proyecto, se muestra la página de proyecto. La página del
proyecto es donde se diseñan, empaquetan y publican los metadatos del proyecto.
Esta página contiene varios paneles y vistas que se pueden utilizar para ver y
modificar los objetos del proyecto.
Visor de proyectos
El Visor de proyectos muestra los objetos de un proyecto en una vista jerárquica.
Puede utilizar el Visor de proyectos para visualizar, modificar y crear objetos.
Las relaciones se muestran tanto en la pestaña Diagrama como en Explorador. Las
funciones importadas se muestran en la pestaña Explorador.
El Visor de proyectos utiliza los siguientes iconos para representar objetos y
estados. Un proyecto puede utilizar algunos o todos los iconos.
Icono Objeto
Proyecto.
14 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario
Espacio de nombres raíz o cualquier otro espacio de
nombres del proyecto.

Icono Objeto
Carpeta de origen de datos.
Origen de datos
Carpeta de mapa de parámetros.
Mapa de parámetros.
Paquete.
Carpeta de paquetes.
Paquete publicado.
Cálculo
Cálculo cuya propiedad Uso está establecida en Atributo.
Cálculo cuya propiedad Uso está establecida en
Identificador.
Cálculo incluido.
Cálculo cuya propiedad Uso está establecida en Hecho.
Dimensión de modelo basada en objetos de modelo
existentes.
Dimensión importada de un origen de datos.
Dimensión que no es válida. Esta dimensión se ha
importado de un origen de datos.
Filtro.
Jerarquía.
Nivel de una jerarquía.
Medida.
Capítulo 2. Introducción a Framework Manager 15

Icono Objeto
Medida semiaditiva.
Dimensión de medida basada en objetos de modelo
existentes.
Dimensión de medida importada de un origen de datos.
Dimensión de medida no válida. Esta dimensión se ha
importado de un origen de datos.
Elemento de consulta.
Elemento de consulta cuya propiedad Uso está establecida
en Identificador.
Elemento de consulta cuya propiedad Uso está establecida
en Hecho.
Elemento de consulta ubicado bajo un asunto de consulta
de atajo.
Asunto de consulta basado en objetos de modelo
existentes.
Asunto de consulta importado de un origen de datos.
Asunto de consulta no válido. Este asunto de consulta se
ha importado de un origen de datos.
Asunto de consulta basado en datos multidimensionales.
Asunto de consulta que contiene elementos de consulta
cuya propiedad Uso está establecida en Hecho. Este
asunto de consulta se basa en objetos de modelo
existentes.
Asunto de consulta que contiene elementos de consulta
cuya propiedad Uso está establecida en Hecho. Este
asunto de consulta se ha importado de un origen de datos.
Asunto de consulta que contiene elementos de consulta
cuya propiedad Uso está establecida en Hecho. Este
asunto de consulta se ha importado de un origen de datos
y no es válido.
Relación.
16 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario
Proyecto o segmento enlazado que se ha actualizado. Este
icono se muestra sobre otros iconos.
Objeto enlazado. Este icono se muestra sobre otros iconos.

Icono Objeto
Atajo. Este icono se muestra sobre otros iconos.
Objeto no válido. Este icono se muestra sobre otros iconos.
Cambio de opciones de los proyectos
Puede cambiar una o varias opciones para probar los proyectos y guardar
automáticamente los cambios.
Las opciones de prueba se aplican globalmente en todas las pruebas que se
ejecuten para este proyecto. Para obtener información sobre la prueba de
determinados objetos, consulte: Capítulo 5, “Modelado de metadatos relacionales”,
en la página 67 o Capítulo 6, “metadatos de SAP BW”, en la página 193.
Guardar proyectos automáticamente puede ayudarle a evitar la pérdida de datos si
se produce una interrupción imprevista, como un corte en la alimentación eléctrica.
Si opta por guardar los proyectos automáticamente, puede elegir el tiempo entre
las opciones de guardado.
Si opta por utilizar la característica de guardado automático, IBM Cognos
Framework Manager no puede guardar los cambios cuando un cuadro de diálogo
está abierto si el cuadro de diálogo bloquea otras áreas de Framework Manager.
Por ejemplo, cuando se utilizan los cuadros de diálogo que presenta el asistente
para crear carpetas, no se puede acceder a los comandos de la barra de menús.
Una vez que haya cerrado el cuadro de diálogo, Framework Manager guardará
automáticamente los cambios cuando transcurra el tiempo especificado para el
guardado automático.
Procedimiento
1. Pulse Proyecto, Opciones.
2. En la pestaña Opciones de prueba, elija las opciones que desee.
Objetivo Acción Persistencia
Limitar el número de filas
recuperadas
Seleccione la casilla de
verificación Restringir el
número máximo de filas
que se devolverán y escriba
el numero de filas que desee.
Este valor no mejora el
rendimiento de la
recuperación de datos
cuando se prueban
dimensiones, asuntos de
consulta y conjuntos de
consulta.
Este valor se aplica a todas
las dimensiones, asuntos de
consulta y conjuntos de
consulta del modelo.
Este valor se guarda y se usa
en la siguiente sesión con
cualquier otro proyecto.
Capítulo 2. Introducción a Framework Manager 17

Objetivo Acción Persistencia
Especificar el nivel de detalle Arrastre el control deslizante
del nivel de información
que se muestra en la
información de consulta
hasta el punto que represente
el nivel de detalle que
requiera.
Aplicar filtros de modo de
diseño relevantes
Seleccione la casilla de
verificación Aplicar todos
los filtros de modo de
diseño durante las pruebas.
Esto aplica todos los filtros
pertinentes cuyo uso se
defina en el modo de diseño
en otra dimensión, asunto de
consulta o conjunto de
consultas.
Este valor se guarda y se usa
en la siguiente sesión con
este proyecto.
Este valor se guarda y se usa
en la siguiente sesión con
cualquier otro proyecto.
3. Si desea que los proyectos se guarden automáticamente, en la pestaña
Guardado automático, seleccione Activado y escriba un número que represente
la frecuencia, en minutos, con la que desea que sus proyectos se guarden
automáticamente.
4. Pulse Aceptar.
Reordenación de objetos
De forma predeterminada, los objetos de espacio de nombres raíz enumerados en
el Visor de proyectos se muestran en el orden en el que se añadieron. Puede
cambiar el orden de los objetos en función de sus nombres. Los objetos se pueden
reordenar por orden ascendente o descendente.
Al seleccionar los objetos para reordenar, todas las selecciones deben estar en el
mismo nivel en el árbol de metadatos. No obstante, puede reordenar solo algunos
de los objetos de un nivel. La ubicación de los objetos reordenados en relación con
los objetos que no se seleccionaron se basa en la posición del primer objeto de la
lista reordenada. Por ejemplo, al reordenar por orden ascendente, el objeto cuyo
nombre empieza por la letra más cercana a la "A" permanece en su posición actual
en el Visor de proyectos, seguido de los demás objetos seleccionados.
Al reordenar los objetos seleccionados, puede incluir a los hijos de estos. Por
ejemplo, supongamos que dos asuntos de consulta, Minoristas del Oeste y
Minoristas del Este, se muestran en un nivel. Cada asunto de consulta tiene hijos,
que se muestran un nivel por debajo de sus padres. Si reordena Minoristas del
Oeste y Minoristas del Este y opta por incluir sus hijos, el Visor de proyectos lista
Minoristas del Oeste y Minoristas del Este en un nivel. Los hijos de cada asunto de
consulta se agrupan por debajo de sus padres y se listan en orden ascendente.
Asimismo, puede incluir los descendientes de los objetos hijos. El tiempo necesario
para reordenar los objetos puede aumentar en función del tipo y del número de
objetos seleccionados.
18 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Si las selecciones incluyen objetos de solo lectura o niveles de jerarquías, IBM
Cognos Framework Manager muestra un mensaje que informa de que esos
elementos no podrán reordenarse.
Procedimiento
1. En el Visor de proyectos, seleccione los objetos de espacio de nombres raíz que
desee reordenar.
Recuerde que los objetos seleccionados deben estar en el mismo nivel.
También puede seleccionar los objetos con la pestaña Explorador o la pestaña
Diagrama.
2. Pulse Herramientas, Reordenar.
3. Seleccione si desea reordenar los objetos en orden ascendente o descendente.
4. Seleccione si desea reordenar solo los objetos seleccionados o también desea
reordenar los hijos de los objetos seleccionados.
Si opta por reordenar los hijos de los objetos seleccionados, puede incluir
también todos los descendientes de los objetos hijos.
5. Pulse Aceptar.
Pestaña Explorador
La pestaña Explorador muestra el contenido de un proyecto, de forma similar a
cualquier sistema de archivos. Organiza los objetos por nombre, clase o
descripción.
Si un proyecto tiene muchos objetos, puede resultar más fácil localizarlos en la
pestaña Explorador.
Puede utilizar la pestaña Explorador para ver, crear y modificar objetos y
relaciones. También puede crear carpetas y espacios de nombres para agrupar
objetos.
La pestaña Diagrama
Utilice la pestaña Diagrama para mostrar las relaciones entre los objetos de un
proyecto. Las relaciones entre los objetos se muestran como líneas con notación de
cardinalidad. Puede ampliar los objetos y los espacios de nombres para mostrar la
jerarquía de objetos y las relaciones entre los objetos.
Sugerencia: Puede controlar el área del modelo que se ve en el diagrama.
Mantenga pulsado el botón descripción general de la esquina inferior derecha y
arrastre el puntero por encima del del diagrama.
En la pestaña Diagrama, puede realizar las acciones siguientes:
v Ver, crear y modificar objetos y relaciones.
v Crear carpetas y espacios de nombres para objetos de grupos.
v Cambiar la configuración de los diagramas.
v Cambiar el diseño de los objetos a diseño en estrella o diseño de árbol estándar,
pulsando en Diagrama, Diseño automático.
v Seleccionar un objeto pulsando en Diagrama, Establecer punto focal.
v Localizar un objeto pulsando con el botón derecho en el objeto en el Visor de
proyectos y pulsando en Localizar en diagrama.
v Aumentar o disminuir el zoom pulsando en Diagrama, Zoom.
Capítulo 2. Introducción a Framework Manager 19

v Ampliar o contraer todos los objetos desde el menú Diagrama.
v Guardar el diagrama para su impresión pulsando en Diagrama, Captura de
pantalla y especificando el nombre de la imagen.
v Iniciar el Explorador de contexto pulsando con el botón derecho en un objeto en
la pestaña Diagrama y pulsando en Lanzar explorador de contexto.
v Imprimir el diagrama en el Explorador de contexto pulsando con el botón
derecho en el fondo del Explorador de contexto y pulsando en Imprimir.
También hay un botón para imprimir en la barra de herramientas del
Explorador de contexto. Este menú que aparece al pulsar el botón derecho del
ratón incluye también comandos que sirven para previsualizar el diagrama; para
ello utilice Imprimir vista previa y cambie las opciones de diseño de página con
Configurar página.
Cambio de valores en los diagramas
Puede cambiar uno o varios valores de los diagramas. La pestaña Valores de
diagrama define los valores del diagrama principal. La pestaña Explorador de
contexto define cómo se rellenan y muestran los diagramas de contexto.
Procedimiento
1. Pulse Diagrama, Valores de diagrama.
2. Defina el nivel de detalle.
Puede seleccionar elementos de consulta, relaciones, relaciones de ámbito,
cardinalidad y descripciones.
3. Seleccione el tipo de notación.
Puede usar la notación Merise o Crowfoot. De forma predeterminada, IBM
Cognos Framework Manager utiliza la notación Merise. La notación Merise
marca cada extremo de la relación con la cardinalidad mínima y máxima de
dicho extremo. También puede utilizar la notación Crowfoot, que ofrece una
representación pictórica de la relación.
4. Para alinear los objetos más fácilmente, active las opciones de instantánea.
5. Para tener una red con líneas separadas uniformemente en el fondo, seleccione
la casilla de verificación Mostrar cuadrícula.
6. Seleccione la fuente y el color del texto.
7. Seleccione si desea que estos valores sean predeterminados para todos los
proyectos.
8. Pulse Aceptar.
La pestaña Mapa de dimensiones
Puede utilizar la pestaña Mapa de dimensiones para ver, crear y modificar
jerarquías y niveles para la dimensión seleccionada en el Visor de proyectos.
Asimismo, puede ver y modificar relaciones de ámbito.
Las pestañas Medidas y Atributos se muestran tras pulsar en la pestaña Mapa de
dimensiones. Utilice la pestaña Medidas para ver o modificar todas las medidas y
relaciones de ámbito disponibles en el modelo. Utilice la pestaña Atributos para
ver o modificar el rol del elemento de consulta seleccionado.
Además, puede incluir cálculos en el elemento de consulta.
Sugerencia: El mejor método para ver metadatos de SAP BW es en el diseño de
estrella. En el menú Diagrama, pulse el diagrama de diseño automático, estrella.
20 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

El panel Propiedades
El panel Propiedades muestra las propiedades de los últimos objetos seleccionados
en el Visor de proyectos, la pestaña Explorador, la pestaña Diagrama, la pestaña
Mapa de dimensiones, la pestaña Dependencias, el panel Buscar o el panel
Resumen. Las propiedades del objeto se definen durante la importación, y algunos
valores de propiedad pueden modificarse durante el modelado. Puede utilizar el
panel Propiedades para añadir, modificar o suprimir las propiedades de los
objetos.
Puede modificar las propiedades de varios objetos al mismo tiempo. Si selecciona
más de un objeto, IBM Cognos Framework Manager sólo muestra las propiedades
comunes a todos los objetos. Puede:
v Ordenar los valores de propiedad efectuando una doble pulsación en la cabecera
de la propiedad.
Se muestra una flecha para indicar la dirección en que se ordenan los valores.
Puede alternar entre orden ascendente y descendente.
v Filtrar los valores de propiedad pulsando la flecha que se encuentra a la derecha
de la cabecera de la propiedad.
Puede pulsar un valor o pulsar Personalizar para definir los criterios para las
filas que desea visualizar.
v Aplicar un valor de propiedad a varios objetos pulsando la flecha que se
encuentra junto a la propiedad y arrastrando el área resaltada sobre las
propiedades a las que desea aplicar dicho valor.
v Cambiar la anchura de las filas y las columnas pulsando con el botón derecho el
nombre de objeto del panel de propiedades.
Si necesita más espacio, puede cambiar el tamaño del panel Propiedades o
moverlo para que flote en la ventana. Por ejemplo, si tiene más de un monitor,
puede mover el panel Propiedades a otro monitor.
Sustitución de varios valores de propiedad
Puede sustituir varios valores de cada propiedad de cadena de texto.
Cuando se sustituyen varios valores de propiedad, IBM Cognos Framework
Manager actualiza automáticamente los elementos que dependen de los valores
que ha sustituido. Si alguna dependencia no puede actualizarse, como los nombres
de origen de datos o del mapa de parámetros, el modelo se deberá validar
manualmente.
Puede buscar que coincida todo el valor de la propiedad o solo parte del valor. Si
busca que coincida parte del valor de la propiedad, puede realizar sustituciones
múltiples en una única propiedad de texto. Por ejemplo, si busca "área" para
sustituirlo por "zona", el valor de propiedad "Esta área y esa área" se sustituirá por
"Esta zona y esa zona". No obstante "áreas" se sustituirá por "zonas".
Sugerencia: Antes de sustituir los valores de propiedad, amplíe el panel
Propiedades y amplíe la columna de la propiedad cuyo valor desea sustituir.
Procedimiento
1. En la ventana Visor de proyectos, seleccione varios objetos.
Consejo: Para reducir el conjunto de propiedades de búsqueda para antes
realizar la sustitución, filtre primero las propiedades. En la pestaña
Capítulo 2. Introducción a Framework Manager 21

Propiedades, pulse con el botón derecho en la cabecera de columna que desea
utilizar para filtrar y pulse Establecer filtro automático.
2. Elija una de las acciones siguientes:
v Si el modelo contiene varios idiomas, pulse la pestaña Idioma.
v Si el modelo contiene un idioma, pulse la pestaña Propiedades.
3. Pulse con el botón derecho en la cabecera de columna de la propiedad cuyos
valores desea sustituir y pulse Sustitución masiva.
4. En los cuadros Buscar y Sustituir por, escriba las cadenas de texto para buscar
y sustituir.
Consejo: Para sustituir las propiedades vacías, deje el cuadro Buscar sin
rellenar.
5. Para realizar una búsqueda sensible a las mayúsculas y las minúsculas,
seleccione la casilla de verificación Coincidir mayúsculas y minúsculas.
6. Para buscar el texto de propiedad completo, seleccione la casilla de verificación
Concordar todo el contenido de la celda.
Consejo: Para sustituir todos los campos de propiedad, con independencia del
texto que contengan, escriba un asterisco en el cuadro Buscar y seleccione la
casilla de verificación Concordar todo el contenido de la celda.
7. Realice una de las acciones siguientes:
v Pulse Sustituir para sustituir el objeto seleccionado actualmente y buscar la
siguiente coincidencia.
v Pulse Siguiente para seleccionar el siguiente objeto coincidente.
v Pulse Sustituir todo para sustituir todas las propiedades coincidentes, desde
la primera propiedad coincidente de la lista.
v Pulse Cerrar cuando acabe de realizar todas las sustituciones.
A medida que se apliquen los cambios en una propiedad, los resultados
aparecerán en la pestaña.
Cuando la sustitución masiva haya alcanzado el último objeto de la lista,
aparecerá un mensaje que mostrará el número de sustituciones.
El panel Herramientas
El panel Herramientas contiene las pestañas Resumen, Buscar y Dependencias.
Puede pasar el panel Herramientas a una ventana independiente. Para ello, pulse
la barra de título del panel y arrástrela hacia cualquier dirección hasta que el borde
del panel sea una línea gruesa. Ahora puede arrastrar la ventana Herramientas a
cualquier ubicación del escritorio. Para devolver la ventana a un panel en el
interior de una ventana de IBM Cognos Framework Manager, arrástrela a uno de
los bordes de Framework Manager hasta que el borde de la ventana sea una línea
fina.
Pestaña Resumen
La pestaña Resumen muestra el idioma, las estadísticas y tareas disponibles para
el objeto seleccionado en Visor de proyectos.
La sección Proyecto muestra el idioma de diseño y el idioma activo. Puede
cambiar el idioma activo.
La sección Estadísticas muestra el número de objetos, por clase, ubicados en el
objeto seleccionado actualmente. Si el objeto seleccionado contiene una carpeta, el
22 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

contenido de la carpeta se incluye en el recuento numérico. Los objetos
seleccionados incluyen proyectos, espacios de nombres y carpetas. El objeto
seleccionado predeterminado es el proyecto.
La sección Tareas muestra las acciones aplicables al objeto seleccionado
actualmente, sobre la base de la clase de objeto. Si selecciona una carpeta, se
enumeran las acciones para la carpeta. Si selecciona un objeto de la carpeta, la lista
incluye las acciones para el objeto y para la carpeta.
Para obtener más información sobre las clases de objeto, consulte el archivo
c10_location\templates\bmt\CR1Model\BMTModelSpecification.xsd.
Utilización de la pestaña Buscar
Cuando se trabaja con un proyecto largo, puede resultar difícil localizar los objetos
que se necesitan para completar una tarea. Utilice la pestaña Buscar para encontrar
rápidamente objetos mediante la aplicación de diferentes criterios de búsqueda,
como la ubicación, la clase, la condición o la propiedad.
Antes de empezar
Si el modelo contiene varios idiomas, debe haber especificado el valor Idioma
activo en el cuadro de diálogo Definir idiomas para poder buscar objetos.
Procedimiento
1. Pulse Herramientas, Buscar.
Sugerencias:
v Si el panel Herramientas no está visible, pulse Ver, Herramientas. Puede
arrastrar el panel Herramientas a la parte inferior de la ventana de
Framework Manager y cambiar su tamaño para obtener una vista mejor de
los resultados de la búsqueda.
v Para reducir el conjunto de propiedades de búsqueda, filtre primero las
propiedades. En la pestaña Propiedades pulse con el botón derecho en el
encabezado de columna que desea utilizar para filtrar y pulse Establecer
filtro automático.
2. En el cuadro Cadena de búsqueda, escriba el texto que desea encontrar.
Puede utilizar mayúsculas, minúsculas o una combinación de ambos tipos de
letras. La búsqueda no es sensible a las mayúsculas y las minúsculas. Los
caracteres comodín válidos son "*" y "?"..
3. Pulse el botón de flecha doble para mostrar los cuadros de los criterios
de búsqueda.
4. En la lista Condición, seleccione una condición para aplicar a la cadena de
búsqueda.
El cuadro Condición determina cómo debe coincidir el valor Cadena de
búsqueda con el texto del modelo. Contiene una lista de posibles condiciones
de búsqueda. Si desea realizar la búsqueda con caracteres comodín, utilice la
condición igual a.
Una expresión regular es un método complejo y potente para comparar
cadenas de texto. Para buscar con una expresión regular, utilice la condición
expresión regular. La búsqueda con expresión regular es sensible a las
mayúsculas y las minúsculas. Por ejemplo, para encontrar todos los objetos
que contienen la palabra "Con" busque la cadena "\Con", sin comillas.
El valor del cuadro Condición se guarda entre sesiones.
Capítulo 2. Introducción a Framework Manager 23

5. En la lista Buscar en, seleccione la parte de la jerarquía del modelo en la que
desea buscar.
El valor del cuadro Buscar en se guarda entre sesiones.
6. En la lista Clase, seleccione la única clase de objetos en la que desea buscar.
7. En la lista Propiedad, seleccione el tipo de propiedad en el que desea buscar.
La propiedad (Todas las propiedades) busca en todas las propiedades. La
propiedad Nombre de objeto limita la búsqueda al nombre de cada objeto. La
propiedad Propiedades de texto busca en el conjunto de propiedades que
contienen cadenas de texto, como Descripción o Sugerencias de pantalla, pero
no incluye el nombre de objeto.
El valor del cuadro Propiedad se guarda entre sesiones.
8. Pulse Buscar.
Los resultados se enumeran al final de la pestaña Buscar. Los resultados de la
búsqueda pueden contener varios valores, como propiedades de texto, para un
solo objeto. Al pulsar en un objeto que tiene varios valores, se seleccionan
todos los valores que pertenecen a dicho objeto. Si el modelo contiene varios
idiomas, los resultados de búsqueda incluyen las propiedades de cada idioma
del modelo.
Una vez realizada la búsqueda, la casilla de verificación Subconjunto queda
disponible. Si selecciona la casilla de verificación Subconjunto, la siguiente
búsqueda se realiza en los resultados de búsqueda existentes. La casilla de
verificación Subconjunto se desmarca después de cada búsqueda. Puede
realizar búsquedas sucesivas en el subconjunto seleccionando la casilla de
verificación Subconjunto.
9. Para localizar un objeto en el Visor de proyectos, pulse un objeto en la
pestaña Buscar.
10. Para ver un objeto de un diagrama, pulse con el botón derecho en un objeto
en la pestaña Buscar y pulse Localizar en diagrama.
Resultados
El botón Sustitución masiva de la pestaña Buscar permite realizar una operación
de búsqueda y sustitución en el conjunto de objetos del resultado de la búsqueda.
Al pulsar en el botón Sustitución masiva, el conjunto de resultados se muestra en
la pestaña Propiedades y aparece el diálogo Sustitución masiva. Allí, puede
seleccionar la propiedad para ejecutar la operación de búsqueda y sustitución.
Igualmente, puede iniciar una sustitución masiva desde el panel Propiedades. Para
obtener más información, consulte: “Sustitución de varios valores de propiedad” en
la página 21.
La pestaña Dependencias
La pestaña Dependencias muestra los objetos que dependen del objeto
seleccionado.
Convenciones de nomenclatura para objetos en un proyecto
Todos los objetos de un proyecto deben tener un identificador único. La referencia
puede constar de una o más partes, en función del tipo de objeto. Las partes
incluyen un nombre de objeto y una ubicación en la jerarquía del proyecto, según
se exprese en el idioma predeterminado del proyecto.
24 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Nota: Si desea que dos dimensiones o asuntos de consulta tengan el mismo
nombre en un proyecto, deben estar en diferentes espacios de nombres.
Identificadores de una parte
Algunos objetos de un proyecto tienen un identificador de una sola parte. El
identificador de una parte debe ser único en todo el proyecto, incluso si el espacio
de nombres contiene otros espacios de nombres. Estos objetos tienen un
identificador de una parte:
v Espacios de nombres
v Funciones
v Atajos a espacios de nombres
v Atajos a carpetas
Identificadores de dos partes
Algunos objetos de un proyecto tienen un identificador de dos partes formado por
el nombre del espacio de nombres contenedor y el nombre del objeto. El nombre
del objeto debe ser único en el espacio de nombres contenedor. Estos objetos tienen
un identificador de dos partes:
v Dimensiones regulares
v Dimensiones de medida
v Asuntos de consulta
v Atajos a asuntos de consulta
Por ejemplo, un espacio de nombres go_sales contiene un asunto de consulta
denominado Product. El asunto de consulta Product tiene el nombre siguiente,
donde los corchetes y los puntos son la sintaxis que Framework Manager utiliza
para los identificadores de objeto:
[go_sales].[Product]
Identificadores de tres partes
Algunos objetos de un proyecto tienen un identificador de tres partes basado en el
identificador del asunto de consulta contenedor. Cada nombre debe ser único en el
asunto de consulta contenedor. Estos objetos tienen un identificador de tres partes:
v Jerarquías
v Medidas
v Elementos de consulta
Por ejemplo, un espacio de nombres go_sales contiene un asunto de consulta
denominado Product y un elemento de consulta denominado Product Code. El
elemento de consulta Product Code tiene el nombre siguiente, donde los corchetes
y los puntos son la sintaxis que IBM Cognos Framework Manager utiliza para los
identificadores de objeto:
[go_sales].[Product].[Product Code]
Identificadores de cuatro partes
Los niveles de un proyecto tienen un identificador de cuatro partes formado por el
nombre del espacio de nombres, el nombre de dimensión, el nombre de jerarquía y
el nombre de nivel.
Capítulo 2. Introducción a Framework Manager 25

Modelos de ejemplo
Por ejemplo, un espacio de nombres go_data_warehouse contiene una dimensión
denominada Account. Una jerarquía de Account es Balance sheet, que contiene un
nivel denominado Account. El nivel Account tiene el nombre siguiente, donde los
corchetes y los puntos son la sintaxis que Framework Manager utiliza para los
identificadores de objeto:
[go_data_warehouse].[Account dimension].[Balance sheet].[Account]
Identificadores de cinco partes
Algunos objetos de un proyecto tienen un identificador de cinco partes formado
por el nombre del espacio de nombres, el nombre de dimensión, el nombre de
jerarquía, el nombre de nivel y el nombre de elemento de consulta. Los
identificadores de cinco partes también se utilizan para títulos y claves de empresa
en nombres exclusivos de miembro. Para obtener más información, consulte:
“Nombres exclusivos de miembro” en la página 112.
Por ejemplo, un espacio de nombres go_data_warehouse contiene una dimensión
denominada Account. Una jerarquía de Account es Balance sheet, que contiene un
nivel denominado Account. El nivel Account contiene un elemento de consulta
denominado Account name. El elemento de consulta Account name tiene el
nombre siguiente, donde los corchetes y los puntos son la sintaxis que Framework
Manager utiliza para los identificadores de objeto:
[go_data_warehouse].[Account dimension].[Balance sheet].[Account].[Account
name]
Se incluyen varios modelos de ejemplo con IBM Cognos Framework Manager para
que los explore. Los modelos de ejemplo se han creado utilizando las directrices
para modelar metadatos.
En cada modelo de ejemplo, los elementos de consulta tienen el formateo
predeterminado definido. Los nombres y descripciones se han traducido a idiomas
diferentes. Con la utilización del mapa de parámetros Language_lookup, cada
usuario ve automáticamente nombres de carpetas y elementos, así como las
descripciones en su idioma preferido.
Para obtener más información sobre los informes y paquetes de ejemplo, consulte:
Report Studio Guía del usuario.
El modelo Almacén de Viaje de Aventuras
Este modelo contiene información financiera y de recursos humanos sobre una
compañía ficticia, Viaje de Aventuras. El modelo accede a un origen de datos
relacionales dimensional.
Este modelo de muestra se encuentra en c10_location\webcontent\samples\
models\great_outdoors_warehouse.
El modelo de muestra contiene las siguientes vistas:
v Vista Base de datos
Contiene los objetos que se importaron del origen de datos. Estos objetos están
agrupados en espacios de nombres para cada área empresarial y una
denominada GO para las tablas comunes a todas las áreas empresariales.
26 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Asimismo, los asuntos de consulta de modelo, los atajos y los filtros se
organizan en espacios de nombres. Los espacios de nombres se muestran a los
usuarios como carpetas. Esta organización de información en categorías
empresariales pertinentes facilita a los usuarios la localización de la información
que necesitan.
En esta vista, se definen todas las uniones y todos los determinantes.
Se agregaron algunos asuntos de consulta de modelo para aquellos que
necesitaban determinantes y para las tablas de consulta.
v Vista empresarial
Contiene asuntos de consulta de modelo que representan los datos en términos
empresariales o de necesidades de la aplicación.
En esta vista, se definen los cálculos, incluidos los de los idiomas.
Esta vista mejora la portabilidad del modelo y evita las consultas de metadatos
que se producen cuando los cálculos se realizan directamente en los asuntos de
consulta del origen de datos.
v Vista dimensional
Contiene dimensiones regulares, dimensiones de medidas y relaciones de ámbito
creadas en Framework Manager.
v Vista de análisis
Contiene la parte del modelo que se ve en los estudios para el paquete
(dimensional) de análisis.
Los atajos a las dimensiones regulares y de medidas de la vista dimensional se
agrupan en esquemas en estrella y se colocan en la raíz del modelo en carpetas,
una para cada área empresarial. Están claramente marcadas con "(analysis)" al
final del nombre. No se encuentran en un espacio de nombres aparte porque
esto añadiría otro nivel en el árbol de metadatos de los estudios.
v Vista de consulta
Contiene la parte del modelo que se ve en los estudios para el paquete de
consultas y creación de informes.
Los atajos a los asuntos de consulta del modelo de la vista dimensional se
agrupan en esquemas en estrella y se colocan en carpetas, una para cada área
empresarial. Están claramente marcadas con "(query)" al final del nombre en la
raíz del modelo.
Además, hay paquetes en el modelo de muestra: uno para el análisis y otro para
las consultas y creación de informes. No se puede utilizar el paquete de consultas
y creación de informes en IBM Cognos Analysis Studio.
El modelo Ventas de Viaje de Aventuras
Este modelo contiene información analítica sobre una compañía ficticia, Viaje de
Aventuras. El modelo accede a un sistema transaccional.
Este modelo de muestra se encuentra en c10_location\webcontent\samples\
models\great_outdoors_sales.
El modelo de muestra contiene las siguientes vistas:
v Vista Base de datos
Contiene los asuntos de consulta que se importaron del origen de datos. Puesto
que se trata de un origen de datos transaccionales, la mayoría de las tablas de
hechos o tiene claves. En algunos casos, se han utilizado claves de varias pares
Capítulo 2. Introducción a Framework Manager 27

y, en otros casos, se han agregado asuntos de consulta de modelo para calcular
las claves y para resolver cardinalidad ambigua.
En esta vista, se definen todas las uniones y todos los determinantes.
v Vista empresarial
Contiene asuntos de consulta de modelo y atajos de referencia que representan
los datos en términos comerciales o de necesidades de la aplicación. En esta
vista, se definen los cálculos, incluidos los de los idiomas.
v Vista dimensional
Contiene dimensiones regulares, dimensiones de medidas y relaciones de
ámbito. Las dimensiones se basan en los asuntos de consulta de modelo de la
vista empresarial.
Es también donde se cambia el nombre de los asuntos de consulta, si es
necesario.
v Vista de análisis
Contiene la parte del modelo que se ve en los estudios para el paquete
(dimensional) de análisis.
Los atajos a las dimensiones regulares y de medidas de la vista dimensional se
agrupan en esquemas en estrella y se colocan en la raíz del modelo en carpetas,
una para cada área empresarial. Están claramente marcadas con "(analysis)" al
final del nombre. No se encuentran en un espacio de nombres aparte porque
esto añadiría otro nivel en el árbol de metadatos de los estudios.
v Vista de consulta
Contiene la parte del modelo que se ve en los estudios para el paquete de
consultas y creación de informes.
Los atajos a los asuntos de consulta del modelo de la vista dimensional se
agrupan en esquemas en estrella y se colocan en carpetas, una para cada área
empresarial. Están claramente marcadas con "(query)" al final del nombre en la
raíz del modelo.
Además, hay paquetes en el modelo de muestra: uno para el análisis y otro para
las consultas y creación de informes. No se puede utilizar el paquete de consultas
y creación de informes en IBM Cognos Analysis Studio.
28 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Capítulo 3. Model Design Accelerator
Árbol del explorador
Model Design Accelerator es una extensión de IBM Cognos Framework Manager
que simplifica la creación de modelos de esquema en estrella relacionales. Ayuda al
modelador a crear un esquema en estrella relacional de tabla de hechos que
cumple las prácticas recomendadas para el modelado. Los modeladores noveles
pueden crear modelos sin mucha experiencia ni formación. Los modeladores con
experiencia pueden reducir el tiempo general destinado a crear un modelo. Model
Design Accelerator evalúa cada paso de diseño para identificar posibles problemas
y ayudarle a resolverlos.
Antes de empezar a diseñar un modelo, debe comprender cuál es el problema que
intenta resolver y de qué datos dispone para resolverlo.
Para empezar a utilizar Model Design Accelerator, realice estas acciones:
v Cree un proyecto y seleccione un origen de datos.
v Explore la interfaz de usuario de Model Design Accelerator.
v Cree un modelo de esquema en estrella.
v Estudie cómo gestionar el modelo de esquema en estrella.
Model Design Accelerator cuenta con varias vistas y cuadros de diálogo que le
ayudarán a crear el modelo.
v Árbol del explorador
v Diagrama del explorador
v Acelerador de modelos
v Diagrama de asunto de consulta
v Modo de edición de relación
v Aviso de modelo
v Opciones
Para acceder a los menús emergentes de cada vista, pulse con el botón derecho en
la vista. El cuadro de diálogo Opciones está disponible en todos los menús
emergentes.
Utilice el Árbol del explorador para ver objetos seleccionados con el asistente de
metadatos. Los objetos de origen de datos se muestran en una vista jerárquica,
similar a otros sistemas de archivos.
Para ver una vista gráfica del origen de datos, utilice el Diagrama del explorador.
Si el origen de datos contiene numerosos objetos, puede resultar más fácil localizar
un objeto mediante el Árbol del explorador.
El Árbol del explorador utiliza los siguientes iconos para representar objetos.
Icono Objeto
Proyecto.
© Copyright IBM Corp. 2005, 2013 29

Diagrama del explorador
Icono Objeto
Tabla en el origen de datos.
Columna en el origen de datos.
La propiedad de tipo de datos de la columna lo identifica
como una medida.
Columna en el origen de datos.
Las propiedades de la columna lo identifican como una
clave.
Columna en el origen de datos.
Las propiedades de la columna no lo identifican como una
medida ni como una clave.
Origen de datos
El Diagrama del explorador muestra una vista gráfica de los metadatos de origen
de datos. Utilice el Diagrama del explorador para explorar los metadatos y ver las
relaciones entre objetos.
Para acceder al Diagrama del explorador, seleccione uno o más objetos en el Árbol
del explorador. A continuación, pulse el icono Diagrama del explorador que se
encuentra por encima del Árbol del explorador.
En la ventana Diagrama del explorador puede:
v Ver objetos y relaciones.
v Cambiar el diseño de los objetos a diseño en estrella o diseño de árbol estándar.
v Crear un esquema en estrella preliminar basado en cualquier tabla que contenga
hechos.
v Acercar o alejar.
v Cambiar la configuración de los diagramas.
Existen dos formas de utilizar el Diagrama del explorador. Desde el Árbol del
explorador puede seleccionar un subconjunto de objetos que le interesen y
añadirlos al Diagrama del explorador. Desde el Árbol del explorador también
puede añadir todos los objetos al Diagrama del explorador. Luego puede
conservar los objetos que le interesen y eliminar el resto. Utilice los elementos de
menú Mostrar tablas relacionadas y Eliminar tablas para crear una vista de tan
sólo los objetos que desee explorar. El diagrama es una vista de sólo lectura de los
metadatos de origen de datos. Al añadir o eliminar tablas, sólo modifica el
diagrama. No realiza cambios en el origen de datos.
Utilice las opciones de menú del diagrama para explorar relaciones con otros
objetos. Para acceder a las opciones de menú del diagrama, seleccione un objeto en
el Diagrama del explorador y pulse con el botón derecho del ratón o utilice la
barra de herramientas. Pulse con el botón derecho una tabla para seleccionar la
opción para ver el diagrama con un diseño en estrella o de árbol alrededor de
dicha tabla. También puede acceder a algunas de las opciones de menú del
diagrama mediante los iconos.
30 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Puede crear un esquema en estrella preliminar seleccionando cualquier tabla del
Diagrama del explorador. Púlsela con el botón derecho del ratón y seleccione
Generar un esquema en estrella desde esta tabla para crear un diseño de
esquema en estrella completo.
Puede acoplar el Diagrama del explorador al espacio de trabajo pulsando el botón
de acople. Desde la ventana acoplada tiene la opción de dividir la pantalla
horizontal o verticalmente.
Utilice el cuadro de diálogo Opciones para personalizar los valores de diagrama
predeterminados. Por ejemplo, si las tablas contienen muchas columnas o utilizan
nombres largos, los datos de los diagramas pueden no visualizarse completos.
Ajuste las opciones de tamaño máximo de tabla en la pestaña General para
asegurarse de que se visualicen todos los datos. Utilice la pestaña Colores para
modificar los colores predeterminados que se usan para identificar las
características del diagrama.
El espacio de trabajo del acelerador de modelos
Una vez creado un proyecto, puede empezar a trabajar en una sesión de Model
Design Accelerator. El Acelerador de modelos es el espacio de trabajo gráfico
donde puede crear un esquema en estrella.
Para crear un esquema en estrella, diseñe el asunto de consulta de hechos
utilizando las medidas que desea incluir en los informes. A continuación, cree
asuntos de consulta de modelo para proporcionar contexto y describir esas
medidas. Las líneas que unen los asuntos de consulta indican las relaciones que
existen. Utilice el Diagrama de asunto de consulta para ver las tablas de origen de
datos que se utilizaron para crear el asunto de consulta seleccionado.
Model Design Accelerator evalúa cada paso de diseño con respecto a prácticas
probadas de modelado para identificar posibles problemas y ayudarle a
resolverlos. Si sus acciones dan lugar a un posible problema, se visualiza la vista
Aviso de modelo.
Una vez completado el esquema en estrella, genere un modelo. Puede refinar el
modelo en Framework Manager. Cree un paquete y publique el modelo en IBM
Cognos Connection para empezar a crear informes en los estudios.
Diagrama de asunto de consulta
Utilice el Diagrama de asunto de consulta para mostrar las tablas de origen de
datos que se utilizaron para crear el esquema en estrella. Estas tablas se importan a
Framework Manager como parte del modelo generado. Para acceder al Diagrama
de asunto de consulta, efectúe una doble pulsación en un asunto de consulta en el
espacio de trabajo del Acelerador de modelos.
En la ventana Diagrama de asunto de consulta puede:
v Ver las tablas de origen de datos que se usaron para crear el asunto de consulta
seleccionado.
v Crear, modificar, suprimir o reemplazar relaciones mediante el Modo de edición
de relación.
v Cambiar los valores para los diagramas mediante el Diálogo de opciones.
Utilice el cuadro de diálogo Opciones para personalizar los valores de diagrama
predeterminados. Por ejemplo, si las tablas contienen numerosas columnas o
Capítulo 3. Model Design Accelerator 31

utilizan nombres largos, los datos de los diagramas pueden no visualizarse
completos. Ajuste las opciones de tamaño máximo de tabla en el cuadro de diálogo
Opciones para asegurarse de que se visualicen todos los datos. Otra opción
controla los colores predeterminados que se utilizan para identificar las
características del diagrama.
Uso del modo de edición de relación
Use Modo de edición de relación para crear, modificar, suprimir o reemplazar
uniones de modelos.
Puede acceder a Modo de edición de relación de dos formas:
v Si Model Design Accelerator detecta un posible problema, aparece la ventana
Aviso de modelo. La opción Vuelva a dibujar manualmente las uniones entre
las tablas activa la funcionalidad del modo de edición de relación desde la vista
Aviso de modelo.
v Para acceder al Diagrama de asunto de consulta, efectúe una doble pulsación en
un asunto de consulta en el espacio de trabajo del Acelerador de modelos.
Desde allí, pulse Entrar en modo de creación de relación.
Procedimiento
1. Seleccione las dos tablas que desee unir.
Si no puede crear una unión directa entre las dos tablas, utilice tablas
intermedias. Para añadir tablas intermedias, arrastre las tablas desde el Árbol
del explorador al Diagrama de asunto de consulta. Después, cree las uniones
necesarias enlazando las tablas mediante tablas intermedias.
Sugerencia: Una tabla intermedia tiene un contorno de línea de guiones.
2. Pulse el icono Crear una relación de modelo .
Aparece el cuadro de diálogo Modificar la relación. Se muestra una nueva
línea de unión.
3. Seleccione una columna de cada tabla para crear la relación.
4. Seleccione la cardinalidad de la relación adecuada.
5. Efectúe una doble pulsación en Aceptar para volver al espacio de trabajo del
Acelerador de modelos.
Si sus acciones producen un modelo no válido, se visualiza la vista Aviso de
modelo.
Resultados
Asimismo, desde Modo de edición de relación, puede seleccionar las columnas
que desea unir y pulsar en el icono para crear una relación de modelo .
Aparece el cuadro de diálogo Modificar la relación con la unión entre las
columnas seleccionadas.
Vista Aviso de modelo
La vista Aviso de modelo se visualiza cuando Model Design Accelerator detecta
un posible problema. Para ayudarle a crear un modelo válido, Model Design
Accelerator evalúa cada una de sus acciones. La vista Aviso de modelo describe la
acción causante de un problema y, si procede, propone opciones para solucionarlo.
Algunas de las opciones presentadas se ejecutan automáticamente al seleccionarlas
y pulsar Aceptar. Otras opciones requieren realizar cambios manuales, bien dentro
de Model Design Accelerator, bien en el modelo generado en Framework Manager.
32 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Dado que Model Design Accelerator no siempre puede determinar la intención de
sus acciones, a veces deberá resolver un problema creando uniones manuales. Si
está disponible, la opción Vuelva a dibujar manualmente las uniones entre las
tablas activa la funcionalidad de Modo de edición de relación desde la vista Aviso
de modelo.
Al seleccionar Vuelva a dibujar manualmente las uniones entre las tablas, se
muestran iconos de unión en la parte superior izquierda de la vista Aviso de
modelo. Puede crear uniones manuales según convenga para resolver el problema
identificado.
Para obtener más información, consulte: “Uso del modo de edición de relación” en
la página 32.
Si hay una serie de opciones de modelado dependientes, pulse Cancelar para
deshacer la última acción. Si no hay opciones de modelado, pulse Cancelar para
deshacer la última acción y volver al espacio de trabajo del Acelerador de
modelos.
Cambio de valores en los diagramas
Puede cambiar uno o varios valores de las vistas de diagrama utilizando el cuadro
de diálogo Opciones. En Model Design Accelerator, hay tres vistas de diagrama.
Son el espacio de trabajo del Acelerador de modelos, elDiagrama de explorador y
el diagrama de asunto de consulta.
Procedimiento
1. Desde cualquiera de las vistas de diagrama, pulse con el botón derecho para
acceder al menú emergente. Seleccione Opciones y pulse la pestaña General.
2. Seleccione el tipo de notación para representar las relaciones.
Puede utilizar la notación crowfoot simplificado, crowfoot estándar o
cardinalidad numérica. De forma predeterminada, Model Design Accelerator
utiliza la notación Crowfoot simplificado que proporciona una representación
en imágenes de la relación.
3. Defina un tamaño de tabla máximo para los diagramas de explorador y de
asunto de consulta.
4. Defina un tamaño de tabla máximo para el espacio de trabajo del Acelerador
de modelos.
5. Seleccione si desea que se muestre una descripción de texto junto a cada icono
de herramienta.
6. Seleccione si desea que se muestre la pantalla de introducción cada vez que se
inicie Model Design Accelerator.
7. Pulse la pestaña Colores para cambiar los colores de los objetos de diagrama.
Se asignan los colores predeterminados a las diferentes características de los
objetos de diagrama. Cambie los colores para personalizar la apariencia.
La opción Ver colores de fondo indica que los cambios realizados en la
ventana activa producirán cambios en el diseño del esquema en estrella. Esto
permite identificar fácilmente las ventanas que se utilizan para editar y las
ventanas que solo se utilizan para visualizar.
8. Pulse Aceptar.
Capítulo 3. Model Design Accelerator 33

Creación de un proyecto
En Model Design Accelerator, se trabaja en el contexto de un proyecto.
Procedimiento
El esquema en estrella
1. En la página de bienvenida de IBM Cognos Framework Manager, pulse Crear
un proyecto nuevo utilizando Model Design Accelerator....
Si se encuentra en Framework Manager, puede seleccionar Ejecutar Model
Design Accelerator en el menú Herramientas. En este caso, no se creará un
proyecto. El esquema en estrella se asocia con el proyecto abierto y el modelo
generado se añade a este proyecto.
2. En la página Nuevo proyecto, especifique un nombre y una ubicación para el
proyecto y pulse Aceptar.
3. En la página Seleccionar idioma, pulse el idioma de diseño del proyecto.
4. Pulse Aceptar para seleccionar el idioma de diseño.
No se puede cambiar el idioma de diseño, pero se pueden añadir otros idiomas
de Framework Manager.
Aparece el asistente de metadatos.
5. Para elegir el origen de datos, siga las instrucciones del asistente de metadatos:
v Seleccione un origen de datos y pulse Siguiente.
Si el origen de datos que quiere no está listado, deberá crearlo. Para obtener
más información, consulte: “Creación de conexiones de origen de datos” en
la página 44.
Puede importar solo desde un origen de datos cada vez. Si desea importar
desde más de un origen de datos, deberá realizar varias importaciones.
v Seleccione las casillas de verificación de los objetos que desea utilizar.
Puede seleccionar todos los objetos que desee, ya sean muchos o pocos.
Todos los metadatos seleccionados estarán a su disposición para trabajar con
ellos en el diseño del esquema en estrella. Solo se importarán los objetos
necesarios para el modelo en Framework Manager cuando se genere el
modelo.
v Pulse Continuar para entrar en Model Design Accelerator.
Es posible que aparezca una pantalla de introducción que le ofrezca
información general sobre los pasos para realizar el diseño. Cierre esta
pantalla para empezar a usar Model Design Accelerator.
6. Cree un modelo de esquema en estrella con los objetos seleccionados del origen
de datos.
7. Realice una de las siguientes acciones:
Pulse Guardar para guardar el contenido de la sesión y seguir trabajando.
Pulse Cerrar para guardar el contenido de la sesión y entrar en Framework
Manager.
Pulse Generar modelo para generar un modelo basado en el diseño de
esquema en estrella y entrar en Framework Manager.
Puede guardar y cerrar el diseño con tanta frecuencia como desee sin generar
un modelo. Para obtener más información, consulte: “El esquema en estrella”
Crear un esquema en estrella mediante Model Design Accelerator es un proceso de
tres pasos:
34 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

v Construir el asunto de consulta de hechos con las medidas que desee en los
informes.
v Construir asuntos de consulta relacionados para dar contexto a las medidas.
v Generar el modelo.
En cualquier momento puede detener el puntero del ratón sobre un objeto para ver
sus propiedades. Las propiedades muestran el origen del objeto en el origen de
datos. En la vista Diagrama del explorador, también se muestra si el elemento se
utiliza en el esquema en estrella. Puede pulsar con el botón derecho del ratón en
una unión para ver el diálogo Relación.
Conviene ir guardando el diseño a medida que trabaja. Si sale de Model Design
Accelerator y luego vuelve a entrar, puede reanudar el trabajo en el esquema en
estrella guardado.
Nota: Al volver a entrar en Model Design Accelerator, abre la última sesión de
trabajo. No puede ir a otros proyectos desde Model Design Accelerator.
Construir el asunto de consulta de hechos
Use el Árbol del explorador para explorar las tablas y columnas en el origen de
datos. Seleccione las medidas que desea incluir en los informes y añádalas al
asunto de consulta de hechos en el espacio de trabajo del acelerador de modelos.
Las medidas son columnas numéricas en una vista o tabla de base de datos que
puede agruparse o agregarse. Algunos ejemplos de medidas son Costo de
producción o Cantidad. Model Design Accelerator realiza el seguimiento de las
claves requeridas y automáticamente las incluye en el modelo. No existe ningún
requisito para añadir claves. Seleccione sólo las medidas que quiera que los autores
del informe vean en el paquete.
Seleccione las medidas en el Árbol del explorador y arrástrelas al asunto de
consulta de hechos en el espacio de trabajo del Acelerador de modelos. También
puede realizar las selecciones en el Diagrama del explorador.
Todas las medidas añadidas deben ser de la misma tabla del origen de datos. Si
intenta añadir medidas de varias tablas o añadir elementos de consulta que no son
medidas, se visualizará el cuadro de diálogo Aviso de modelo. Esto es porque
Model Design Accelerator sólo soporta un modelo de esquema en estrella de una
única tabla de hechos.
Construir asuntos de consulta relacionados
Utilice objetos del Árbol del explorador para construir los asuntos de consulta en
el modelo de esquema en estrella. Seleccione columnas del Árbol del explorador y
añádalas a los asuntos de consulta apropiados en el espacio de trabajo del
acelerador de modelos. Puede añadir o eliminar asuntos de consulta o columnas
del espacio de trabajo según convenga.
Para ayudarle a construir los asuntos de consulta, utilice el Diagrama del
explorador para examinar los metadatos para las tablas y vistas seleccionadas del
origen de datos. Puede crear asuntos de consulta desde la Vista de explorador oel
Diagrama del explorador.
Desde el Diagrama del explorador puede seleccionar un asunto de consulta o
varios y ver las relaciones.
Capítulo 3. Model Design Accelerator 35

Generar el modelo
Cuando el esquema en estrella esté acabado o listo para su prueba, pulse Generar
modelo para crear el modelo y entrar en IBM Cognos Framework Manager.
Las pruebas de Model Advisor se aplican al modelo resultante. En la pestaña
Verificar resultados del modelo, revise los asuntos identificados. Se muestra una
descripción de cada asunto y una lista de los objetos afectados por el asunto. Para
obtener más información sobre Model Advisor, consulte: “Análisis de modelos” en
la página 186.
El modelo de esquema en estrella creado normalmente contendrá sólo un
subconjunto de elementos de consulta del origen de datos. Al generar un modelo,
sólo se importan a Framework Manager los metadatos necesarios para dar soporte
al modelo de esquema en estrella.
Cada vez que genere un modelo, se crean nuevos espacios de nombres en el
proyecto de Framework Manager abierto. La Vista física sólo contiene las tablas
importadas para dar soporte al modelo de esquema en estrella. La Vista
empresarial contiene asuntos de consulta de modelo con tan sólo las columnas
seleccionadas al crear los asuntos de consulta. Estos son los objetos que creó en
Model Design Accelerator. La Vista de presentación contiene una colección de
atajos que hacen referencia a los asuntos de consulta de modelo de la Vista
empresarial.
Desde Framework Manager puede mejorar el modelo añadiendo cálculos, filtros,
idiomas adicionales y estructuras dimensionales. No obstante, cada vez que genere
un nuevo modelo, se crean nuevos espacios de nombres y sus mejoras no se
aplicarán a los nuevos espacios de nombres.
Puede volver a Model Design Accelerator en cualquier momento para editar el
esquema en estrella. Debe publicar el modelo en Framework Manager para
utilizarlo en los estudios de IBM Cognos.
Gestión de un esquema en estrella
Una forma de diseñar un esquema en estrella consiste en crear un modelo
independiente. Para ello, cree un proyecto, construya un esquema en estrella en
Model Design Accelerator, genere un modelo y guárdelo en el proyecto de IBM
Cognos Framework Manager.
Puede guardar y cerrar el diseño de modelo de esquema en estrella con tanta
frecuencia como desee sin generar un modelo. Después de generar un modelo,
puede volver a Model Design Accelerator seleccionando Ejecutar Model Design
Accelerator en el menú Herramientas. Puede realizar una de las siguientes
acciones:
v Editar el esquema en estrella actual, si ya existe uno.
v Crear un nuevo esquema en estrella usando los mismos metadatos de origen de
datos importados.
Los metadatos de Model Design Accelerator se guardan en el archivo
mda_metadata.xml, en la carpeta del proyecto. Puede mover el esquema en estrella
a otro proyecto copiando el archivo mda_metadata.xml en otra carpeta de proyecto
distinta.
36 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Cada vez que genere un modelo, se crean espacios de nombres en el proyecto de
Framework Manager abierto. La Vista física sólo contiene las tablas que se
necesitaron para dar soporte al modelo de esquema en estrella. La Vista
empresarial contiene asuntos de consulta de modelo con tan sólo las columnas
seleccionadas al crear los asuntos de consulta. Estos son los objetos que creó en
Model Design Accelerator. La Vista de presentación contiene una serie de atajos a
los asuntos de consulta de modelo creados en la Vista empresarial.
Para cada modelo posterior generado, se crea un nuevo conjunto de espacios de
nombres en el proyecto de Framework Manager. Se añade un número a cada
nombre de espacio de nombres para distinguirlo de la versión anterior. Por
ejemplo, el primer modelo contiene un espacio de nombres titulado Vista física. El
segundo modelo contendrá Vista física1.
Cuando el diseño del esquema en estrella esté completo, puede mejorar el modelo
resultante en Framework Manager añadiendo cálculos, filtros, idiomas adicionales
y estructuras dimensionales. Si cambia el esquema en estrella y regenera un
modelo, no se sobrescribe el diseño original ni las mejoras realizadas.
Capítulo 3. Model Design Accelerator 37

38 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Capítulo 4. Importación de metadatos de orígenes de datos
Orígenes de datos
Antes de realizar un modelo en IBM Cognos Framework Manager, debe importar
los metadatos. Puede importar metadatos desde diversos orígenes de datos, tanto
relacionales como dimensionales. Puede importar en un modelo nuevo o en uno
existente. Antes de importar, es importante determinar si el origen de datos
contiene los datos y metadatos que dan respuesta a sus necesidades para la
creación de informes.
Para importar metadatos, realice las acciones siguientes:
Procedimiento
1. Defina los orígenes de datos.
2. Defina la seguridad de los orígenes de datos.
3. Estudie los diversos tipos de conexiones de origen de datos.
4. Estudie cómo se realizan las conexiones de origen de datos.
5. Cree una conexión de origen de datos.
6. Importe los metadatos.
Para crear modelos e importar metadatos, debe definir primero los orígenes de
datos. Una conexión de origen de datos proporciona la información que IBM
Cognos BI necesita para conectarse a una base de datos.
Cada origen de datos puede contener una o varias conexiones físicas a la base de
datos. La conexión de origen de datos especifica los parámetros necesarios para
conectarse a la base de datos, como la ubicación de la base de datos y la duración
del tiempo de espera. Una conexión puede incluir información de credenciales e
inicios de sesión.
Puede proteger los orígenes de datos con la autenticación de IBM Cognos. La
autenticación de IBM Cognos respeta la seguridad que también se haya definido en
el origen de datos. Puede crear inicios de sesión de origen de datos para aislar el
proceso de conexión a la base de datos de los usuarios finales. El inicio de sesión
almacena el ID de usuario y la contraseña necesaria para acceder a la base de
datos. También puede desplegar orígenes de datos.
Para obtener más información sobre las conexiones de origen de datos, consulte la
publicación IBM CognosGuía de administración y seguridad.
Seguridad de los orígenes de datos
Puede definir la seguridad de los orígenes de datos con la autenticación de IBM
Cognos o con la seguridad específica del origen de datos. Si define la autenticación
de IBM Cognos para un origen de datos no se reemplazará la seguridad específica
del proveedor para la base de datos.
En función del origen de datos, estarán disponibles uno o varios de los tipos
siguientes de autenticación de IBM Cognos:
v Sin autenticación
© Copyright IBM Corp. 2005, 2013 39

IBM Cognos BI se conecta al origen de datos sin proporcionar credenciales de
inicio de sesión.
v credenciales de servicio IBM Cognos
IBM Cognos BI se conecta al origen de datos con el inicio de sesión del servicio
de IBM Cognos. Los usuarios no necesitan inicios de sesión individuales para la
base de datos. No obstante, en los entornos de producción, son más adecuados
los inicios de sesión individuales para las bases de datos.
v Espacio de nombres externo
IBM Cognos BI inicia sesión en el origen de datos con las mismas credenciales
que se usan para autenticarse ante el espacio de nombres de autenticación
externo especificado. El espacio de nombres especificado debe estar activo, los
usuarios deben iniciar sesión a este antes de acceder al origen de datos y las
credenciales usadas para la autenticación del espacio de nombres deben ser
relevantes para la autenticación del origen de datos.
Todos los orígenes de datos soportan también inicios de sesión definidos para el
grupo Todos o para usuarios, grupos o roles particulares. Si el origen de datos
requiere un inicio de sesión de origen de datos, pero no tiene acceso a un inicio de
sesión para este origen de datos, se le solicitará que inicie la sesión cada vez que
acceda al origen de datos.
IBM Cognos BI también respeta la seguridad que se haya definido para el origen
de datos. Por ejemplo, para los cubos de IBM Cognos, la seguridad puede definirse
en el nivel de los cubos. Para los orígenes de datos de Microsoft Analysis Services,
la seguridad puede definirse utilizando roles de cubos.
Tipos de conexiones de origen de datos
IBM Cognos da soporte a muchos tipos de orígenes de datos. La información de
conexión de origen de datos puede variar para cada tipo de origen de datos que se
utilice.
Para obtener información detallada sobre las conexiones de determinados orígenes
de datos, consulte la publicación IBM CognosGuía de administración y seguridad. Si
necesita más información sobre los parámetros para conectarse a determinados
orígenes de datos, consulte la documentación del proveedor del origen de datos
que utilice.
En un modelo de Framework Manager, los catálogos y los esquemas son
propiedades que se asocian con un objeto de origen de datos. Si existen, estas
propiedades califican a todos los objetos que se generen en una sentencia SQL en
tiempo de ejecución.
Cuando se cambia el origen de datos con el que se correlaciona un modelo, los
niveles de calificación se eliminan. El Sistema de gestión de bases de datos
relacionales (RDBMS) aplica las búsquedas de espacio de nombres adecuadas a
medida que prepara las sentencias SQL que recibe. Según el proveedor, RDBMS
puede buscar hasta en dos lugares para solucionar una referencia a un objeto. Si
una referencia no puede resolverse, aparece un error.
IBM Cognos Framework Manager conserva los nombres de las tablas y las
columnas como las presenta RDBMS. Estos nombres se muestran en las sentencias
SQL de Cognos. SQL de Cognos usa comillas para los nombres para conservar las
mayúsculas y las minúsculas y evitar conflictos con los caracteres especiales o las
palabras clave.
40 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Metadatos nativos
IBM Cognos da soporte a orígenes de datos OLAP y a orígenes de datos
relacionales. El término metadatos nativos hace referencia a objetos como modelos,
paquetes y consultas que se basan en un origen de datos OLAP. Un espacio de
nombres que contiene metadatos nativos utiliza este icono para indicar que es
diferente de espacios de nombres que contienen otros tipos de metadatos.
Los orígenes de datos OLAP son orígenes de datos ricos en metadatos. El
modelado explícito para estos orígenes de datos no está habilitado en Framework
Manager y el paquete se publica directamente en el portal. Para obtener más
información, consulte: “Publicación de paquetes basados en orígenes de datos de
OLAP” en la página 267.
Los niveles se crean usando los nombres de generación en las etiquetas. Si desea
cambiar la forma de nombrar los niveles, puede hacerlo cambiando la
configuración de compilación de dimensión en la aplicación que generó el cubo.
Para obtener más información, consulte la documentación del distribuidor.
Los orígenes de datos relacionales requieren que el modelado dimensional los
habilite para trabajar en IBM Cognos Analysis Studio y para trabajar con funciones
de detalle en otros estudios. Para obtener más información sobre modelado
dimensional, consulte: “Dimensiones” en la página 105.
Si ha instalado componentes de IBM Cognos en servidores UNIX, localice el origen
de datos basado en archivos en un servidor UNIX. Luego deberá utilizar una ruta
UNIX, como /nombre_servidor/cubes/Great Outdoors Company.mdc para acceder
al archivo. Para obtener más información, consulte: “Creación de conexiones de
origen de datos” en la página 44.
Los paquetes compuestos contienen tanto metadatos OLAP como relacionales.
Conexiones de origen de datos
Puede personalizar las conexiones de origen de datos según las necesidades de los
usuarios.
Varias conexiones de origen de datos
Si tiene acceso a una conexión de origen de datos en un origen de datos, se le
solicitará que seleccione una conexión de origen de datos al abrir el proyecto de
IBM Cognos Framework Manager. Puede utilizar varias conexiones de origen de
datos en un solo origen de datos para facilitar la migración de un entorno a otro y
mantener la integridad del un proyecto.
Por ejemplo, puede utilizar varias conexiones de origen de datos para trabajar con
los metadatos de un origen de datos de prueba. Cree un proyecto con la conexión
de origen de datos de GoSales. Cree y modifique los objetos que desee del
proyecto y realice pruebas para asegurar que el proyecto se ha modelado como
usted desea. Después de cerrar la sesión y volver a abrir el proyecto de Framework
Manager, puede seleccionar la conexión de origen de datos de producción. Cuando
publique el paquete en el servidor de IBM Cognos, los usuarios elegirán la
conexión de origen de datos que deseen utilizar en su informe.
Deben definirse varias conexiones al mismo origen de datos en IBM Cognos
Connection. Si desea soportar varias conexiones para cada origen de datos, borre
Capítulo 4. Importación de metadatos de orígenes de datos 41

los nombres de esquema y catálogo de origen de datos y cree una conexión para
cada base de datos en IBM Cognos Connection.
Nota: Si trabaja con varios cubos que contienen metadatos diferentes, utilice
orígenes de datos independientes para cada cubo. Para poder expandir un paquete
OLAP en los estudios, ambos cubos deben tener el mismo nombre interno. Si desea
ejecutar informes guardados que utilizan diferentes conexiones de origen de datos,
el nombre del cubo y los nombres de dimensión, jerarquía, nivel y atributo deben
ser iguales en ambos cubos. Si utiliza un único origen de datos con una conexión
independiente para cada cubo, los nombres internos de todos los cubos deben ser
iguales.
Para obtener más información sobre las conexiones de origen de datos, consulte la
publicación IBM CognosGuía de administración y seguridad.
Niveles de aislamiento
El nivel de aislamiento especifica cómo se gestionan las transacciones que
modifican la base de datos. De forma predeterminada, se utiliza la pasarela de
objetos predeterminada. No todos los tipos de bases de datos soportan cada nivel
de aislamiento. Algunos proveedores de base de datos utilizan diferentes nombres
para los niveles de aislamiento.
Las consultas que sean ejecutadas por informes y análisis están destinadas a ser
operaciones de sólo lectura. Las consultas se ejecutan con una unidad de trabajo en
el origen de datos como una transacción con un nivel de aislamiento
predeterminado o definido por el administrador. Los autores de informes no deben
suponer que las consultas que ejecutan procedimientos almacenados confirman
todos los datos escritos por el procedimiento. En algunos entornos, los cambios
realizados por un procedimiento pueden quedar confirmados por las características
de la base de datos. Un procedimiento almacenado marcado con acceso de
escritura en Framework Manager confirma los cambios pero sólo se puede usar
con Event Studio.
Si necesita ejecutar consultas específicas con distintos niveles de aislamiento, debe
definir distintas conexiones de base de datos.
Para los orígenes de datos OLAP, incluido SAP BW, la unidad de trabajo de
transacciones es de sólo lectura.
Los siguientes niveles se encuentran en orden creciente de aislamiento:
v Lectura no confirmada
Los cambios efectuados por otras transacciones están disponibles
inmediatamente para una transacción.
Tipo de base de datos Nivel de aislamiento equivalente
Oracle No aplicable
DB2 Lectura no confirmada
Microsoft SQL Server Lectura no confirmada
Sybase Adaptive Server Enterprise Lectura no confirmada
42 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Tipo de base de datos Nivel de aislamiento equivalente
Informix Lectura sucia
v Lectura confirmada
Una transacción puede acceder sólo a filas confirmadas por otras transacciones.
Tipo de base de datos Nivel de aislamiento equivalente
Oracle Lectura confirmada
DB2 Estabilidad del cursor
Microsoft SQL Server Lectura confirmada
Sybase Adaptive Server Enterprise Lectura confirmada
Informix Lectura confirmada
v Estabilidad del cursor
Otras transacciones no pueden actualizar la fila en la que se posiciona una
transacción.
Tipo de base de datos Nivel de aislamiento equivalente
Oracle No aplicable
DB2 No aplicable
Microsoft SQL Server No aplicable
Sybase Adaptive Server Enterprise No aplicable
Informix Estabilidad del cursor
v Lectura reproducible
Las filas seleccionadas o actualizadas por una transacción no se pueden cambiar
por otra transacción hasta que ésta se complete.
Tipo de base de datos Nivel de aislamiento equivalente
Oracle No aplicable
DB2 Estabilidad de lectura
Microsoft SQL Server Lectura repetible
Sybase Adaptive Server Enterprise Lectura repetible
Informix Lectura repetible
Capítulo 4. Importación de metadatos de orígenes de datos 43

v Protección fantasma
Una transacción no puede acceder a las filas insertadas o suprimidas desde el
inicio de la transacción.
Tipo de base de datos Nivel de aislamiento equivalente
Oracle No aplicable
DB2 No aplicable
Microsoft SQL Server No aplicable
Sybase Adaptive Server Enterprise No aplicable
Informix No aplicable
v Serializable
Un conjunto de transacciones ejecutado simultáneamente produce el mismo
resultado que si se hubiese efectuado de manera secuencial.
Tipo de base de datos Nivel de aislamiento equivalente
Oracle Serializable
DB2 Lectura repetida
Microsoft SQL Server Serializable
Sybase Adaptive Server Enterprise Serializable
Informix No aplicable
Creación de conexiones de origen de datos
Un origen de datos define la conexión física a una base de datos. Una conexión de
origen de datos especifica los parámetros necesarios para conectarse a una base de
datos, como la ubicación de la base de datos y la duración del tiempo de espera.
Estos parámetros forman una cadena de conexión para el origen de datos.
Se pueden crear orígenes de datos en el portal o en Framework Manager. Como se
almacenan en el servidor, los orígenes de datos aparecen en ambos lugares,
independientemente de dónde se hayan creado. Las conexiones de origen de datos
existentes solo se pueden editar en el portal.
Si es administrador, puede configurar todos los orígenes de datos necesarios antes
de crear modelos en Framework Manager para que todas las conexiones estén
disponibles en el asistente de Framework Manager Metadata.
Los orígenes de datos se almacenan en el espacio de nombres de Cognos y deben
tener nombres exclusivos. Por ejemplo, no se puede utilizar el mismo nombre para
un origen de datos y un grupo.
44 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Puede incluir información de autenticación para la base de datos en la conexión de
origen de datos mediante la creación de un inicio de sesión. No es necesario que
los usuarios especifiquen la información de autenticación de base de datos cada
vez que se utilice la conexión porque está cifrada y almacenada en el servidor. El
inicio de sesión producido al crear un origen de datos está disponible para el
grupo Todos. Después, puede modificar quién puede utilizar el inicio de sesión o
crear más inicios de sesión.
Antes de crear orígenes de datos, debe tener permisos de escritura para la carpeta
en la que desea guardar el origen de datos y para el espacio de nombres de
Cognos. También debe tener permisos de ejecución para la característica protegida
Conexiones de origen de datos.
Recomendación: Utilice rutas de red para orígenes de datos
basados en archivos
Si dispone de una instalación distribuida con varios servidores, recomendamos
utilizar rutas de red para todos los orígenes de datos basados en archivos en lugar
de rutas locales. Esto garantiza que los servicios que necesitan los orígenes de
datos puedan acceder a ellos, independientemente de qué servidor necesite los
datos.
Al crear una conexión con un origen de datos basado en archivo, como un
PowerCube, se especifica una ruta y un nombre de archivo. Para apuntar al
archivo, utilice una ruta local, como C:\cubes\Great Outdoors Company.mdc, o
una ruta de red, como \\nombre_servidor\cubes\Great Outdoors Company.mdc.
En una instalación distribuida, en la que los servidores de informes se ejecutan en
sistemas diferentes, para utilizar una ruta local es necesario que el archivo y la ruta
sean válidos en todos los sistemas en los que se ejecuta un servidor de informes.
De forma alternativa, si utiliza una ruta de red para apuntar a un archivo, todos
los servidores de informes apuntan al mismo archivo en la red sin que el archivo
esté disponible localmente. Además, para asegurarse de que el archivo siempre esté
disponible, recomendamos almacenarlo en un directorio compartido que se pueda
acceder en la red.
Si ha instalado componentes de IBM Cognos Business Intelligence en servidores el
sistema operativo UNIX, recomendamos que también localice el origen de datos
basado en archivos de un servidor UNIX. Luego debe utilizar una ruta UNIX,
como nombre_servidor/cubes/Great Outdoors Company.mdc para acceder al
archivo.
Si ha instalado todos los componentes en un único sistema, puede utilizar rutas
locales, pero debe asegurarse de que los servicios que solicitan los datos tengan el
acceso adecuado a los archivos de datos del sistema.
Para instalaciones en el sistema operativo Microsoft Windows, recomendamos
utilizar rutas UNC para directorios compartidos de cualquier origen de datos
basado en archivo, como PowerCubes o archivos XML.
Conexiones a orígenes de datos específicos
Para crear una conexión a un origen de datos, primero debe revisar la información
pertinente en IBM CognosGuía de administración y seguridad. Para cada uno de los
siguientes tipos de orígenes de datos, encontrará información detallada sobre los
parámetros de conexión necesarios y la autenticación.
Capítulo 4. Importación de metadatos de orígenes de datos 45

v IBM DB2
v IBM Cognos Cubes
v Oracle Essbase
v IBM Infosphere Warehouse Cubing Services
v IBM Informix
v Microsoft Analysis Services
v Microsoft SQL Server
v ODBC Connections
v Oracle
v SAP BW
v Sybase Adaptive Server Enterprise
v IBM Cognos TM1
v XML
En función del tipo de base de datos a la que se conecte, es posible que también
deba revisar la información sobre los niveles de aislamiento. Para obtener más
información, consulte: “Niveles de aislamiento” en la página 42.
Pasos para crear una conexión de origen de datos
Procedimiento
1. Pulse el espacio de nombres, carpeta o segmento al que desea importar.
2. Pulse Acciones, Asistente para ejecutar metadatos.
3. En la ventana Seleccionar origen de metadatos, pulse Orígenes de datos,
Siguiente.
4. En la ventana Seleccionar origen de datos, pulse Nuevo.
Se ejecuta el Asistente para nuevo origen de datos que también está disponible
en Cognos Connection.
Desde el Asistente para nuevo origen de datos, puede acceder a la publicación
IBM CognosGuía de administración y seguridad del sistema de ayuda en línea.
5. En la página de nombre y descripción, escriba un nombre exclusivo para la
conexión y, si lo desea, una descripción y sugerencia, y seleccione Siguiente.
6. En la página de conexión, en la lista desplegable Tipo, seleccione el tipo de
origen de datos que desea crear.
Si el origen de datos no aparece en la lista, seleccione Otro tipo.
7. Si es necesario, especifique un nivel de aislamiento para el origen de datos.
8. Especifique los parámetros que componen la cadena de conexión y especifique
otros valores, como el inicio de sesión o el tiempo de espera.
En IBM CognosGuía de administración y seguridad, hallará información detallada
sobre los parámetros de conexión necesarios y la autenticación.
9. Pulse Probar la conexión, Probar para probar si los parámetros son correctos.
Si se le solicita, escriba un ID de usuario y una contraseña o seleccione un
inicio de sesión y pulse Aceptar. Si está probando una conexión ODBC para un
DSN de usuario, debe iniciar la sesión como creador del DSN para que la
prueba se realice correctamente.
En la columna Estado, puede ver si la conexión se ha realizado correctamente.
Si no ha sido así, seleccione Cerrar, regrese a los pasos anteriores y compruebe
los parámetros de la conexión.
46 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Resultados
Importación de metadatos
Asimismo, puede probar la conexión de origen de datos desde la carpeta Orígenes
de datos del Visor de proyectos. Pulse con el botón derecho en el origen de datos
y pulse Probar.
Se pueden importar metadatos a un proyecto nuevo oaunproyecto existente. La
importación de metadatos es una operación que se puede realizar muchas veces a
lo largo del proyecto. También se puede exportar el modelo a Common Warehouse
Metamodel (CWM).
IBM Cognos Framework Manager puede utilizar metadatos y datos de orígenes de
datos externos para crear un proyecto.
Para importar metadatos, debe indicar los orígenes que desea y dónde están
ubicados. Puede importar solo desde un origen de datos cada vez. Si desea
importar desde más de un origen de datos, deberá realizar varias importaciones.
Puede importar metadatos desde
v Bases de datos relacionales, como Oracle, IBM DB2 y Microsoft SQL Server
v Orígenes de datos de SAP BW
v Modelos de IBM Cognos
v Modelos Architect y catálogos Impromptu
v Modelos de IBM Cognos DecisionStream o Data Manager
v Orígenes de metadatos de IBM
v Orígenes de metadatos de terceros
v XML como origen de datos
Para obtener información sobre los tipos de orígenes de datos soportados, acceda a
uno de los Information Center de IBM Cognos en http://www.ibm.com/software/
data/support/cognos_crc.html.
Para obtener información sobre la utilización de conexiones de origen de datos,
consulte: “Conexiones de origen de datos” en la página 41.
Nombres de objeto duplicados
Al importar metadatos, puede seleccionar cómo desea que la importación maneje
los nombres de objeto duplicados. Existe la opción de no importar el objeto, o de
importarlo y crear un nombre exclusivo. La ventaja de importar todo excepto los
objetos duplicados es que se pueden añadir nuevos objetos de base de datos al
proyecto sin especificarlos individualmente y sin llevar a cabo la sincronización.
Para importar metadatos que tienen nombres de tabla iguales, debe crear dos
espacios de nombres e importar cada tabla a un espacio de nombres diferente.
Al importar metadatos de SAP BW, IBM Cognos Framework Manager asigna un
nombre exclusivo a cada objeto. Por lo tanto, si cambia el nombre de un objeto en
el modelo y luego lo vuelve a importar, Framework Manager reconoce que ya
existe. Para volver a importar un objeto con un nombre exclusivo diferente, puede
crear un nuevo espacio de nombres y volver a importar el objeto a ese espacio de
nombres.
Capítulo 4. Importación de metadatos de orígenes de datos 47

También puede importar objetos que tienen el mismo nombre.
Importación de metadatos desde bases de datos relacionales
Cuando se importan metadatos de una base de datos relacional, se pueden
importar todos los metadatos o seleccionar tipos de objetos determinados como
tablas, columnas, vistas, sinónimos, procedimientos almacenados y funciones.
También puede importar objetos de sistema desde un origen relacional. Los
procedimientos almacenados del sistema no se soportan. IBM Cognos Framework
Manager solo soporta procedimientos almacenados definidos por el usuario.
En las tablas siguientes, se muestran objetos de base de datos que se correlacionan
con los objetos de Framework Manager.
Objeto de base de datos Objeto de Framework Manager
tabla asunto de consulta
columna elemento de consulta
vista asunto de consulta
sinónimo asunto de consulta
procedimiento asunto de consulta
función función del proyecto
Los conjuntos con nombre importados desde Microsoft SQL Server y Microsoft
Analysis Server se guardan como cálculos de solo lectura en el modelo de
Framework Manager. El cálculo tiene un distintivo que lo identifica como conjunto
con nombre y una propiedad que contiene el nombre de dimensión.
Procedimiento
1. Pulse el espacio de nombres, carpeta o segmento al que desea importar.
2. Pulse Acciones, Asistente para ejecutar metadatos.
3. En el cuadro de diálogo Seleccionar origen de metadatos, elija el tipo de
metadatos que desea importar.
La opción Orígenes de metadatos proporciona una lista de orígenes de datos
definidos en el software IBM Cognos.
v Seleccione el origen de metadatos relacionales específico para importar.
v Seleccione una conexión de origen de datos y pulse Siguiente.
Si la conexión de origen de datos que desea no está listada, deberá crearla.
Para obtener más información, consulte: “Creación de conexiones de origen
de datos” en la página 44.
v Seleccione las casillas de verificación de los objetos que desea importar.
v Especifique cómo desea que la importación gestione los nombres de objetos
duplicados. Elija si va a importar y crear un nombre exclusivo o si no va a
importar. Si decide crear un nombre exclusivo, el objeto importado se
muestra con un número. Por ejemplo, en su proyecto verá QuerySubject y
QuerySubject1.
48 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

v Si desea importar objetos de sistema, seleccione la casilla de verificación
Mostrar objetos del sistema y seleccione los objetos del sistema que desea
importar.
v Especifique los criterios que va a usar para crear relaciones.
v Si desea convertir todas las cardinalidades en 1 desmarque la casilla de
verificación Detección de hechos habilitada. Si elimina las cardinalidades n
se inhabilita la detección de hechos y la posibilidad de evitar
automáticamente el recuento doble. Para obtener más información, consulte:
“Modelado de relaciones 1-n como relaciones 1-1” en la página 362.
4. Pulse Importar.
Se muestran las estadísticas de la importación con una lista de objetos que no
han podido importarse y un recuento de los objetos que se importaron.
5. Pulse Finalizar.
Qué hacer a continuación
Después de importar metadatos, debe comprobarlos en las áreas siguientes:
v Relaciones y cardinalidad. Consulte: “Verificación de metadatos importados” en
la página 342.
v Determinantes. Consulte: “Determinantes” en la página 84.
v La propiedad Uso para los elementos de consulta. Consulte: “Formateo de
elementos de consulta” en la página 143.
v La propiedad Agregado regular para los elementos de consulta. Consulte:
“Formateo de elementos de consulta” en la página 143.
Importación de metadatos de modelos de IBM Cognos
Puede importar metadatos de un modelo de IBM Cognos existente.
Nota: Si importa de otro proyecto de IBM Cognos Framework Manager, la sintaxis
de las expresiones no está ajustada a cada idioma. Por ejemplo, supongamos que
crea un proyecto de Framework Manager con francés como idioma de diseño y
utiliza una sintaxis específica para el francés en los cálculos y filtros. Después, crea
un proyecto con inglés como idioma de diseño e importa el proyecto francés en el
proyecto nuevo. Las expresiones definidas en los cálculos y los filtros no son
válidas. Debe modificar manualmente la expresión después de importar los
metadatos.
Procedimiento
1. Pulse el espacio de nombres, carpeta o segmento al que desea importar.
2. Pulse Acciones, Asistente para ejecutar metadatos.
3. Pulse Modelo de IBM Cognos, Siguiente.
4. Localice el modelo (archivo.cpf) que desee y pulse Abrir, Siguiente.
5. Siga las instrucciones del asistente de importación:
v Seleccione las casillas de verificación de los objetos que desea importar.
v Especifique cómo desea que la importación gestione los nombres de objetos
duplicados.
Elija si va a importar y crear un nombre exclusivo o si no va a importar. Si
decide crear un nombre exclusivo, el objeto importado se muestra con un
número. Por ejemplo, en su proyecto verá QuerySubject y QuerySubject1.
6. Pulse Siguiente, Finalizar.
Capítulo 4. Importación de metadatos de orígenes de datos 49

Importación de metadatos de un modelo Architect o un
catálogo Impromptu
Para importar metadatos de un modelo de IBM Cognos Architect o un catálogo
Impromptu, primero debe convertirlos en archivos XML. Debido a las diferencias
existentes entre IBM Cognos Series 7 e IBM Cognos BI, después de importar los
metadatos migrados de IBM Cognos Framework Manager, debe realizar unas
tareas adicionales para probar y refinar los metadatos.
Para obtener más información sobre la migración de Series 7, consulte la
publicación IBM Cognos Migration Assistant User Guide en uno de los Information
Center de IBM Cognos en http://publib.boulder.ibm.com/infocenter/cogic/
v1r0m0/index.jsp.
Procedimiento
1. Compruebe que ha exportado el modelo de Architect o el catálogo de
Impromptu.
2. Pulse el espacio de nombres, carpeta o segmento al que desea importar.
3. Pulse Acciones, Asistente para ejecutar metadatos.
4. Pulse IBM Cognos Architect (.xml) o IBM Cognos Impromptu (.xml) y pulse
Siguiente.
5. Localice el archivo XML de Architect o Impromptu que contiene los metadatos
para importar.
Un mensaje de la ventana Vista previa de XML confirma que ha elegido un
archivo XML válido.
6. Pulse Abrir.
7. Seleccione el espacio de nombres que contiene la información de seguridad de
Series 7.
8. Pulse Importar.
Aparece una lista de objetos creados.
9. Si desea verificar los metadatos importados, pulse la casilla de verificación
Verificar tras importación.
10. Pulse Finalizar.
Importación de metadatos de IBM Cognos DecisionStream o
IBM Cognos Data Manager
Puede utilizar IBM Cognos Framework Manager para importar metadatos de un
archivo XML creado por IBM Cognos DecisionStream o IBM Cognos Data
Manager.
Puede importar
v Una capa física que resida en el espacio de nombres de metadatos físicos
Esta capa contiene asuntos de consulta de orígenes de datos que representan las
tablas importadas. La capa física contiene asuntos de consulta y relaciones físicas
entre ellos. Estas relaciones físicas se deducen de las relaciones definidas en el
archivo de importación. Las tablas importadas se convierten en asuntos de
consulta de Framework Manager y las claves suplentes se convierten en
determinantes de Framework Manager.
v Una capa dimensional que reside en el espacio de nombres de dimensiones
Esta capa contiene dimensiones regulares, dimensiones de medida y relaciones
de ámbito. Las dimensiones regulares pueden ser compatibles o no compatibles.
50 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Los objetos de dimensiones de medida corresponden a las estrellas importadas.
Las relaciones de ámbito se deducen de las relaciones definidas en el archivo de
importación.
v Una capa lógica que reside en el espacio de nombres de la vista empresarial
Esta capa contiene atajos para las dimensiones regulares y de medida en el
espacio de nombres de dimensiones. Los atajos están organizados en
agrupaciones de esquema en estrella, que son espacios de nombres con el mismo
nombre que las estrellas del archivo de importación.
El diagrama siguiente muestra cómo los objetos de DecisionStream y Data
Manager se correlacionan con los objetos de Framework Manager.
DecisionStream o
Objetos IBM Cognos Data Manager
Dimensión
Estrella (Hecho)
Relación
Agrupaciones de
esquemas en estrella
Hechos
Objetos Framework Manager y los
espacios de nombres corespondientes
Asunto de consulta
Relación
Dimensión regular
Dimensión de
medida
Relacion de
ámbito
Espacio de nombres
estrella: atajo a
dimensión regular
Espacio de nombres
estrella: atajo a
dimensión de medida
Espacio de nombres
de metadatos físicos
Espacio de nombres
Dimensión
Espacio de nombres
Vista empresarial
Una estrella se correlaciona con un asunto de consulta de Framework Manager en
el espacio de nombres de metadatos físicos o como una dimensión de medida en el
espacio de nombres de dimensiones. Los atributos de hechos siguientes se incluyen
en el modelo.
Nombre de atributo Correlación de Framework Manager
Nombre de tabla Nombre del asunto de consulta de base de
datos en el que se basa la consulta de
modelo que representa el hecho
Nombre abreviado Descripción de asunto de consulta
Capítulo 4. Importación de metadatos de orígenes de datos 51

Nombre de atributo Correlación de Framework Manager
Nombre empresarial Propiedad personalizada
Descripción Descripción de asunto de consulta
Nombre de columna Nombre de elemento de consulta
Tipo de columna Tipo de datos de elemento de consulta
Longitud de columna Tamaño de elemento de consulta
Nombre abreviado de columna Propiedad personalizada
Nombre empresarial de columna Propiedad personalizada
Descripción de columna Descripción de elemento de consulta
Tipo de columna Uso de elemento de consulta
Claves de tabla Determinantes en el espacio de nombres de
metadatos físicos
Conexiones
Una conexión se correlaciona con un origen de datos de Framework Manager.
Nota: Una conexión de origen de datos no se crea automáticamente en IBM
Cognos Connection. La conexión se debe crear manualmente en IBM Cognos
Connection, tal como se explica en los pasos del procedimiento de importación.
Para obtener más información, consulte: “Importación de metadatos de IBM
Cognos DecisionStream o IBM Cognos Data Manager” en la página 50.
Los atributos de orígenes de datos siguientes se incluyen en el modelo.
Nombre de atributo Correlación de Framework Manager
Nombre abreviado de conexión Propiedad personalizada
Nombre empresarial de conexión Nombre de origen de datos
Descripción de conexión Descripción de origen de datos
Conectividad Propiedad type.interface
Cadena de conexión Propiedad personalizada
Creaciones de dimensiones
La creación de una dimensión se correlaciona con Framework Manager como un
espacio de nombres de nivel superior.
52 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Jerarquías
Una dimensión que contiene jerarquías, niveles y columnas se correlaciona con una
dimensión regular de Framework Manager que contiene jerarquías, niveles y
elementos de consulta.
Estrellas compatibles
Las estrellas compatibles se correlacionan con un espacio de nombres de
Framework Manager que reside en el espacio de nombres de la vista empresarial.
Contiene atajos que hacen referencia a las dimensiones.
Los atributos de estrella compatibles siguientes se incluyen en el modelo.
Nombre de atributo Correlación de Framework Manager
Nombre abreviado de estrella El nombre del espacio de nombres que
representa la estrella
Nombre empresarial de estrella El nombre de la dimensión de medida que
representa el hecho
Descripción de estrella La descripción de la dimensión de medida
que representa el hecho
Hechos Atajos para una dimensión de medida
Dimensiones Atajos para dimensiones regulares
Jerarquías Jerarquías en la dimensión regular que
representan las dimensiones de
DecisionStream
Propiedades del modelo
El archivo de exportación contiene las siguientes propiedades del modelo.
Nombre de atributo Correlación de Framework Manager
Versión de esquema No correlacionada
Versión de catálogo Propiedad personalizada
Nombre abreviado de modelo El nombre del espacio de nombres que
representa el objeto de modelo de nivel
superior
Nombre empresarial de modelo Propiedad personalizada
Descripción de modelo La descripción del espacio de nombres que
representa el objeto de modelo de nivel
superior
Capítulo 4. Importación de metadatos de orígenes de datos 53

Pasos para importar desde IBM Cognos DecisionStream o IBM
Cognos Data Manager
Procedimiento
1. Pulse el espacio de nombres, carpeta o segmento al que desea importar.
2. Pulse Acciones, Asistente para ejecutar metadatos.
3. Pulse IBM Cognos DecisionStream (.xml) o IBM Cognos Data Manager (.xml)
y pulse Siguiente.
4. Localice el archivo XML que contiene los metadatos para importar.
Un mensaje de la ventana Vista previa de XML confirma que ha elegido un
archivo XML válido.
5. Pulse Abrir, Importar.
Aparece una lista de objetos creados.
6. Si desea verificar los metadatos importados, pulse la casilla de verificación
Verificar tras importación.
7. Pulse Finalizar.
8. Cree una conexión de origen de datos en IBM Cognos Connection. El nombre
que defina en IBM Cognos Connection debe ser el mismo que el nombre del
origen de datos mostrado en la carpeta Orígenes de datos de Framework
Manager.
Para obtener información sobre cómo crear una conexión de origen de datos,
consulte: “Creación de conexiones de origen de datos” en la página 44.
Importación de orígenes de metadatos de IBM
Se puede utilizar IBM Cognos Framework Manager para importar metadatos de
orígenes de datos de IBM como IBM InfoSphere DataStage. De forma similar a los
orígenes de datos de terceros, los metadatos se extraen utilizando Meta Integration
Model Bridge (MIMB).
Para obtener más información, consulte: “Importación de metadatos de orígenes de
metadatos de terceros” en la página 57.
Opciones de importación de orígenes de metadatos de IBM
Las opciones que ve se basan en el origen de datos seleccionado. No todas las
opciones se aplican a Framework Manager.
Opciones de Framework Manager
Las opciones de IBM Cognos Framework Manager disponibles son las mismas
independientemente del tipo de origen de metadatos seleccionado. Esta tabla
muestra las opciones usadas para crear objetos en Framework Manager.
54 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Opciones de Framework Manager Descripción
Logical/Physical representation Especifica cómo se representan los objetos
lógicos y físicos.
Integrated representa los objetos lógicos y
físicos como un objeto integrado.
Separated representa los objetos lógicos y
físicos como dos objetos relacionados. Esta
es la opción predeterminada.
Separated (verbose) representa los objetos
lógicos y físicos como dos objetos distintos.
Dimensional/Logical representation Integrated representa el objeto dimensional
como un objeto integrado. Esta es la opción
predeterminada.
Separated representa el objeto dimensional
como un objeto dimensional y uno lógico.
Diagram representation Especifica cómo se representan los
diagramas en el proyecto.
As Namespaces indica que los diagramas se
representan como espacios de nombres.
As Packages indica que los diagramas se
representan como paquetes.
Both indica que los diagramas se
representan como espacios de nombres y
como paquetes. Esta es la opción
predeterminada.
None indica que los diagramas no se
representan en el proyecto.
Namespace hierarchy Especifica dónde se conserva la jerarquía de
paquetes.
All indica que la jerarquía de paquetes se
conserva en todos los espacios de nombres.
Esta es la opción predeterminada.
None indica que la jerarquía de paquetes no
se conserva.
Dimensional level only indica que la
jerarquía de paquetes sólo se conserva en el
espacio de nombres dimensional.
Logical level only indica que la jerarquía de
paquetes sólo se conserva en el espacio de
nombres lógico.
Physical level only indica que la jerarquía
de paquetes se conserva sólo en el espacio
de nombres físico.
Capítulo 4. Importación de metadatos de orígenes de datos 55

Opciones de Framework Manager Descripción
Logical only classes Especifica si se representan las clases sólo
lógicas.
Ignore indica que se ignoran las clases sólo
lógicas.
Show indica que se muestran las clases sólo
lógicas junto con sus atributos. Esta es la
opción predeterminada.
Logical only attributes Especifica si se representan los atributos sólo
lógicos. Esta opción no afecta a los atributos
sólo lógicos en una clase sólo lógica.
Drop indica que la información lógica de
una clase no se muestra si contiene un
atributo sólo lógico.
Ignore indica que se ignoran los atributos
sólo lógicos.
Show indica que se muestran los atributos
sólo lógicos. Esta es la opción
predeterminada.
Unreferenced dimension attributes Especifica cómo se representan los atributos
de dimensión sin referencia en el proyecto.
Un atributo de dimensión sin referencia es
un atributo que no participa en un nivel ni
ningún otro atributo de dimensión hace
referencia a él.
Dimensions without dimensional
information
56 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario
Ignore All indica que se ignoran todos los
atributos de dimensión sin referencia.
Ignore Join indica que sólo se ignoran los
atributos de dimensión sin referencia que
participan en una unión.
Show All indica que se muestran todos los
atributos de dimensión sin referencia. Esta es
la opción predeterminada.
Show Join indica que sólo se muestran los
atributos de dimensión sin referencia que
participan en una unión.
Especifica cómo se representan las
dimensiones que no contienen información
de dimensión.
Dimension crea una dimensión, además de
un nivel y una jerarquía predeterminada.
Esta es la opción predeterminada.
Model Query crea una consulta de modelo.

Opciones de Framework Manager Descripción
Create cubes Especifica si la importación puede crear
cubos. Un cubo se representa como un
espacio de nombres que contiene toda la
información necesaria para construir el cubo.
Populate screentip Especifica si la importación utiliza el campo
de descripción como sugerencia.
Name of the namespace containing the
dimensional information
Name of the namespace containing the
logical information
Name of the namespace containing the
physical information
Name of the namespace containing the
subject areas
True permite que el contenido del campo de
descripción se visualice como sugerencia en
IBM Cognos Report Studio, Query Studio o
IBM Cognos Workspace Advanced.
Especifica el espacio de nombres que
contiene la información de dimensión. El
valor predeterminado es "Dimensional
Model".
Especifica el espacio de nombres que
contiene la información lógica. El valor
predeterminado es "Logical Model".
Especifica el espacio de nombres que
contiene la información física. El valor
predeterminado es "Physical Model".
Especifica el espacio de nombres que
contiene las áreas temáticas. El valor
predeterminado es "Subject Area".
Consistency Check Especifica el nivel de comprobación de
consistencia.
Basic es el nivel de comprobación de
consistencia típico.
Extensive lleva a cabo una validación más
exhaustiva del modelo.
None indica que no se lleva a cabo ninguna
validación.
Importación de metadatos de orígenes de metadatos de
terceros
Puede utilizar IBM Cognos Framework Manager para importar metadatos de otros
orígenes, relacionales incluidos. Los metadatos se importan utilizando un puente
de metadatos.
Puede importar metadatos relacionales y de otro tipo en el mismo modelo. Puede
empezar con un nuevo modelo de Framework Manager e importar los otros
metadatos antes de los metadatos relacionales. Esto evita conflictos si importa
objetos con el mismo nombre.
Capítulo 4. Importación de metadatos de orígenes de datos 57

Al importar otros metadatos, se crean orígenes de datos basados en la información
proporcionada a través del asistente de importación. Si al menos un objeto físico
del otro origen hace referencia a un esquema de base de datos o un catálogo, o
ambos, se crea un origen de datos de Framework Manager con sus propiedades de
catálogo o de esquema establecidas en los nombres del catálogo o esquema
definido en los metadatos. Se crea un origen de datos genérico para los objetos
físicos que no hacen referencia a un catálogo ni un esquema.
Si desea acceder a metadatos de otro origen de datos, deberá realizar una
importación de modelo físico.
No todos los orígenes de datos contienen metadatos apropiados para Business
Intelligence Reporting y no todos los conceptos se correlacionan con Framework
Manager. La importación de metadatos está adaptada para Framework Manager y
sólo se importarán metadatos compatibles.
Todos los puentes de metadatos proporcionan una capa física que constituye la
base para posteriores modelados. La riqueza del modelo de Framework Manager
resultante está directamente relacionada con la riqueza del origen de metadatos.
Varias bases de datos
Otros orígenes de metadatos pueden basarse en varias bases de datos. La mejor
forma de importar estos orígenes de datos múltiples en Framework Manager
consiste en realizar varias importaciones. Para cada importación, seleccione los
elementos que correspondan a ese origen de datos concreto.
Por ejemplo, la primera vez que importe de otro origen de metadatos, seleccione
origen_de_datos_1 y todos los elementos que correspondan a ese origen de datos.
La siguiente vez, seleccione origen_de_datos_2 y los elementos que correspondan a
ese origen de datos. Siga importando hasta haber importado todos los orígenes de
datos y sus elementos correspondientes.
Opciones de importación específicas de terceros
Meta Integration Model Bridge (MIMB) extrae metadatos de los orígenes de datos
de terceros. No todas las opciones se aplican a Framework Manager. Para obtener
información sobre herramientas soportadas y correlaciones de objetos, consulte el
sitio web de Meta Integration.
Las opciones que verá durante la importación se basan en el origen de datos
seleccionado.
Opciones de Framework Manager
Las opciones de IBM Cognos Framework Manager disponibles son las mismas
independientemente del tipo de origen de metadatos seleccionado. Esta tabla
muestra las opciones usadas para crear objetos en Framework Manager.
58 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Opciones de Framework Manager Descripción
Logical/Physical representation Especifica cómo se representan los objetos
lógicos y físicos.
Integrated representa los objetos lógicos y
físicos como un objeto integrado.
Separated representa los objetos lógicos y
físicos como dos objetos relacionados. Esta
es la opción predeterminada.
Separated (verbose) representa los objetos
lógicos y físicos como dos objetos distintos.
Dimensional/Logical representation Integrated representa el objeto dimensional
como un objeto integrado. Esta es la opción
predeterminada.
Separated representa el objeto dimensional
como un objeto dimensional y uno lógico.
Diagram representation Especifica cómo se representan los
diagramas en el proyecto.
As Namespaces indica que los diagramas se
representan como espacios de nombres.
As Packages indica que los diagramas se
representan como paquetes.
Both indica que los diagramas se
representan como espacios de nombres y
como paquetes. Esta es la opción
predeterminada.
None indica que los diagramas no se
representan en el proyecto.
Namespace hierarchy Especifica dónde se conserva la jerarquía de
paquetes.
All indica que la jerarquía de paquetes se
conserva en todos los espacios de nombres.
Esta es la opción predeterminada.
None indica que la jerarquía de paquetes no
se conserva.
Dimensional level only indica que la
jerarquía de paquetes sólo se conserva en el
espacio de nombres dimensional.
Logical level only indica que la jerarquía de
paquetes sólo se conserva en el espacio de
nombres lógico.
Physical level only indica que la jerarquía
de paquetes se conserva sólo en el espacio
de nombres físico.
Capítulo 4. Importación de metadatos de orígenes de datos 59

Opciones de Framework Manager Descripción
Logical only classes Especifica si se representan las clases sólo
lógicas.
Ignore indica que se ignoran las clases sólo
lógicas.
Show indica que se muestran las clases sólo
lógicas junto con sus atributos. Esta es la
opción predeterminada.
Logical only attributes Especifica si se representan los atributos sólo
lógicos. Esta opción no afecta a los atributos
sólo lógicos en una clase sólo lógica.
Drop indica que la información lógica de
una clase no se muestra si contiene un
atributo sólo lógico.
Ignore indica que se ignoran los atributos
sólo lógicos.
Show indica que se muestran los atributos
sólo lógicos. Esta es la opción
predeterminada.
Unreferenced dimension attributes Especifica cómo se representan los atributos
de dimensión sin referencia en el proyecto.
Un atributo de dimensión sin referencia es
un atributo que no participa en un nivel ni
ningún otro atributo de dimensión hace
referencia a él.
Dimensions without dimensional
information
60 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario
Ignore All indica que se ignoran todos los
atributos de dimensión sin referencia.
Ignore Join indica que sólo se ignoran los
atributos de dimensión sin referencia que
participan en una unión.
Show All indica que se muestran todos los
atributos de dimensión sin referencia. Esta es
la opción predeterminada.
Show Join indica que sólo se muestran los
atributos de dimensión sin referencia que
participan en una unión.
Especifica cómo se representan las
dimensiones que no contienen información
de dimensión.
Dimension crea una dimensión, además de
un nivel y una jerarquía predeterminada.
Esta es la opción predeterminada.
Model Query crea una consulta de modelo.

Opciones de Framework Manager Descripción
Create cubes Especifica si la importación puede crear
cubos. Un cubo se representa como un
espacio de nombres que contiene toda la
información necesaria para construir el cubo.
Populate screentip Especifica si la importación utiliza el campo
de descripción como sugerencia.
Name of the namespace containing the
dimensional information
Name of the namespace containing the
logical information
Name of the namespace containing the
physical information
Name of the namespace containing the
subject areas
True permite que el contenido del campo de
descripción se visualice como sugerencia en
IBM Cognos Report Studio, Query Studio o
IBM Cognos Workspace Advanced.
Especifica el espacio de nombres que
contiene la información de dimensión. El
valor predeterminado es "Dimensional
Model".
Especifica el espacio de nombres que
contiene la información lógica. El valor
predeterminado es "Logical Model".
Especifica el espacio de nombres que
contiene la información física. El valor
predeterminado es "Physical Model".
Especifica el espacio de nombres que
contiene las áreas temáticas. El valor
predeterminado es "Subject Area".
Consistency Check Especifica el nivel de comprobación de
consistencia.
Basic es el nivel de comprobación de
consistencia típico.
Extensive lleva a cabo una validación más
exhaustiva del modelo.
None indica que no se lleva a cabo ninguna
validación.
Pasos para importar de orígenes de metadatos de terceros
Antes de empezar
Para poder importar metadatos, debe tener una conexión a un origen de datos.
Procedimiento
1. Pulse el espacio de nombres, carpeta o segmento al que desea importar.
2. Pulse Acciones, Asistente para ejecutar metadatos.
3. Pulse Orígenes de metadatos de terceros, Siguiente.
4. Pulse el tipo de metadatos que desea importar.
Capítulo 4. Importación de metadatos de orígenes de datos 61

5. En el cuadro de diálogo Opciones de importación específicas de terceros,
utilice la opción Archivo para identificar el archivo que contiene los metadatos
para importar.
Pulse el resto de las opciones que desee. Las opciones que ve se basan en el
origen de datos seleccionado.
Nota: Utilice las opciones predeterminadas. Estas opciones optimizan la
importación de metadatos. Si cambia las opciones, pueden producirse
resultados imprevistos. Para volver a utilizar las opciones predeterminadas,
pulse Usar valores predeterminados.
6. Pulse Siguiente.
7. En el cuadro de diálogo Opciones de importación específicas de Framework
Manager, pulse las opciones que desee y pulse Siguiente.
8. Siga las instrucciones del asistente de metadatos:
v Seleccione una conexión de origen de datos y pulse Siguiente.
Si la conexión de origen de datos que desea no está listada, deberá crearla.
Para obtener más información, consulte: “Creación de conexiones de origen
de datos” en la página 44.
v Seleccione las casillas de verificación de los objetos que desea importar.
v Especifique cómo desea que la importación gestione los nombres de objetos
duplicados. Elija si va a importar y crear un nombre exclusivo o si no va a
importar. Si decide crear un nombre exclusivo, el objeto importado se
muestra con un número. Por ejemplo, en su proyecto verá QuerySubject y
QuerySubject1.
v Especifique los criterios que va a usar para crear relaciones y pulse Importar.
Para obtener más información, consulte: “Relaciones” en la página 68.
Se muestran las estadísticas de la importación con una lista de objetos que no
han podido importarse y un recuento de los objetos que se importaron.
9. Pulse Finalizar.
Modelado tras la importación:
Los metadatos de origen tienen una estructura lógica compatible con IBM Cognos
BI. Durante la importación, esta estructura se conserva para conseguir una mayor
fidelidad con el modelo de origen.
Tras la importación, solo están disponibles los metadatos físicos.
Procedimiento
1. Analice y examine el modelo. Consulte: “Análisis de modelos” en la página
186.
2. Defina los determinantes.
3. Defina la propiedad Uso.
Algunos puentes requieren que se definan hechos manualmente porque esto no
está disponible en el origen de los metadatos.
4. Compruebe las relaciones y la cardinalidad.
5. Resuelva las relaciones ambiguas, como varias relaciones válidas, relaciones
reflexivas y relaciones recursivas.
Resolución de problemas de metadatos de otros orígenes
Esta sección describe los problemas que pueden producirse a trabajar con
metadatos importados en IBM Cognos Framework Manager.
62 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Las relaciones en las que intervienen vistas de tabla no se
importan desde un archivo Oracle Designer
Las relaciones de clave principal y clave foránea en las que interviene al menos
una vista de tabla no se importan desde un archivo Oracle Designer a Framework
Manager.
Cree las relaciones de clave principal y clave foránea manualmente.
No se puede probar un asunto de consulta de otro origen
No se puede probar un asunto de consulta importado de otro origen de datos.
Por ejemplo, puede probar un asunto de consulta y obtener este mensaje de error:
QE-DEF-0177 Se ha producido un error al realizar la operación
'sqlPrepareWithOptions' estado='-201'.
UDA-SQL-0196 La tabla o vista
"GOSALES1.COGNOS.COM.GOSALES.CONVERSION_RATE" no se ha encontrado
en el diccionario.
Para solucionar este problema, compruebe que existen las condiciones siguientes:
v El objeto de origen de datos de Framework Manager creado por la importación
y referenciado por el asunto de consulta tiene un origen de datos
correspondiente con el mismo nombre en el almacén de contenido de IBM
Cognos Business Intelligence.
v El origen de datos del almacén de contenido correspondiente es válido y la
información de conexión es correcta.
v Las propiedades del catálogo o esquema opcionales del objeto de origen de
datos que ha creado la importación y las referencias al asunto de consulta son
correctas. Para las bases de datos que aceptan identificadores sensibles a las
mayúsculas y las minúsculas, compruebe que las mayúsculas o minúsculas sean
correctas.
v El objeto de base de datos (tabla o vista) representado por el asunto de consulta
existe en la base de datos con el mismo nombre y es accesible en la conexión
actual.
v El tipo de consulta es válido. Puede existir un tipo de consulta no válido si
importa un asunto de consulta de SAP BW y cambia el valor de la propiedad de
tipo de consulta para el origen de datos. De forma predeterminada, el valor del
tipo de consulta es multidimensional. No lo cambie.
Algunas expresiones importadas de otros orígenes de metadatos
no son válidas
El soporte para el análisis de expresiones se ha mejorado en MIMB en IBM Cognos
BI. Se analizan las funciones que son equivalentes entre otros orígenes de
metadatos e IBM Cognos BI.
Las excepciones incluyen
v Funciones sin correlación entre IBM Cognos BI y el otro origen de metadatos
v Expresiones que utilizan una sintaxis especializada
Solución:
Si tiene funciones sin correlación entre IBM Cognos BI y el otro origen de
metadatos, tras importar las expresiones de los demás orígenes de metadatos, edite
Capítulo 4. Importación de metadatos de orígenes de datos 63

manualmente las expresiones en Framework Manager para que sean conformes a
la sintaxis equivalente de Framework Manager.
Si tiene expresiones que utilizan una sintaxis especializada, haga lo siguiente:
Procedimiento
1. En Framework Manager, identifique todos los elementos de consulta
importados que representen cálculos incluidos con referencias como $$1, $$2,
etc.
2. En el panel Propiedades, localice la información proporcionada en la propiedad
patternMapping de cada elemento de consulta.
La propiedad patternMapping indica la correlación entre los parámetros del
cálculo importados y las referencias reales del objeto en el modelo original.
3. Efectúe una doble pulsación en un asunto de consulta con errores.
4. Efectúe una doble pulsación en el cálculo incluido correspondiente al elemento
de consulta identificado en el paso 1.
5. Si se ha asignado un nombre predeterminado al cálculo ("Cálculo..."),sustitúyalo
por el nombre del elemento de consulta real.
6. Sustituya los parámetros importados por las referencias reales del objeto de
Framework Manager que estos parámetros representan.
7. Repita estos pasos para cada uno de los asuntos de consulta con errores.
Importación de metadatos utilizando XML como origen de
datos
Puede importar un archivo XML como un origen de datos tabulares en IBM
Cognos Framework Manager. Puede importarlo localmente o desde un sitio remoto
mediante un URL válido. En Framework Manager, el archivo XML se utiliza para
modelar los metadatos y crear un paquete.
El archivo XML se valida y analiza en tiempo de ejecución, cuando la consulta se
procesa mediante Report Studio, Query Studio o IBM Cognos Workspace
Advanced. Si añade la opción VALIDATE=ON a la cadena de conexión,
Framework Manager valida parcialmente el archivo XML en la etiqueta
que describe los metadatos. Para obtener más información sobre los
tipos de datos soportados, consulte: Apéndice H, “Tipos de datos XML”, en la
página 651.
Debe utilizar el esquema xmldata.xsd para validar el archivo XML. El esquema se
encuentra en la carpeta \c10\bin. No es necesario especificar la ubicación del
esquema en el propio archivo XML.
Para utilizar XML como un origen de datos, compruebe que:
v No utiliza SQL nativo para acceder a los datos de un archivo XML
v No accede a objetos binarios grandes (BLOB)
v Utiliza solo las llamadas de metadatos sqlColumns() y sqlTables()
Otras llamadas devuelven un error de función no soportada.
v El archivo XML está bien formado y es válido
64 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Antes de empezar
Para poder importar metadatos, debe tener una conexión a un origen de datos. Si
el origen de datos XML está en otro sistema, debe utilizar una cuenta que tenga
permiso para acceder al origen de datos.
Después de crear una conexión a un origen de datos XML, el origen de datos se
muestra en la lista de orígenes de datos.
Para utilizar XML como un origen de datos, debe conocer el XML, los esquemas y
otra tecnología relacionada con XML.
Procedimiento
1. Pulse el espacio de nombres, carpeta o segmento al que desea importar.
2. Pulse Acciones, Asistente para ejecutar metadatos.
3. Pulse el origen de datos XML que desee importar y pulse Siguiente.
Importación de objetos con el mismo nombre
Los espacios de nombres son contenedores como las carpetas. Los objetos de un
proyecto de IBM Cognos Framework Manager deben poder identificarse de modo
exclusivo. Si tiene dos objetos con el mismo nombre, deben residir en espacios de
nombres separados.
Por ejemplo, tiene una base de datos que contiene datos financieros. Un conjunto
de tablas representa la información de previsión y real. Ambos tipos de
información tienen tablas denominadas Cuentas por pagar y Cuentas por cobrar.
Para importar estas tablas en Framework Manager y utilizar los mismos nombres
de tabla en el proyecto, debe crear dos espacios de nombres. Un espacio de
nombres se puede denominar Previsión y el otro, Real.
Procedimiento
1. Pulse el modelo o espacio de nombres raíz y pulse Acciones, Crear, Espacio de
nombres.
2. Pulse con el botón derecho en el espacio de nombres, pulse Cambiar nombre y
escriba un nombre descriptivo.
Capítulo 4. Importación de metadatos de orígenes de datos 65

66 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Capítulo 5. Modelado de metadatos relacionales
Nota: La información sobre metadatos de SAP BW se encuentra en otros temas.
Tras importar metadatos, deberá asegurarse de que están configurados de modo
que cumplan los requisitos de creación de informes de sus usuarios, así como
proporcionar la información adicional que necesiten. Las mejoras realizadas en IBM
Cognos Framework Manager no afectan al origen de datos original.
Sugerencia: Para verificar que el modelo cumple los requisitos de creación de
informes, puede seleccionar los objetos que se visualizarán en un informe y
probarlos. Los resultados de la prueba mostrarán el informe que verán los
usuarios, así como el SQL y los mensajes del software de IBM Cognos, si los
hubiera. También puede publicar un paquete en cualquier momento y luego
utilizarlo para crear informes.
Puede comprobar el proyecto en cualquier momento para asegurarse de que las
referencias entre los objetos que contiene son válidas. Consulte: “Verificación de
modelos o paquetes” en la página 249.
Cree al menos dos vistas: la vista de importación y la vista empresarial. Utilizar
dos o más vistas facilita la recorrelación de elementos con un nuevo origen de
datos.
Configuración de la vista de importación
La vista de importación contiene los metadatos que se han importado del origen
de datos.
Para que los metadatos estén correctamente configurados en la vista de
importación siga estos pasos:
Procedimiento
1. Compruebe que las relaciones reflejan los requisitos de creación de informes.
2. Optimice y personalice los datos recuperados por los asuntos de consulta.
3. Optimice y personalice los datos recuperados por las dimensiones. Le resultará
útil almacenar las dimensiones en una vista de dimensiones aparte.
4. Gestione el soporte para los metadatos multilingües.
5. Controle cómo se usan y formatean los datos comprobando las propiedades de
los elementos de consulta.
Configuración de la vista empresarial
La vista empresarial proporciona una capa a la información en los datos de origen
de modo que a los usuarios les resulte más sencillo crear informes.
Para mejorar los metadatos de la vista empresarial, siga estos pasos:
Procedimiento
1. Añada reglas de empresa, como cálculos y filtros, que definan la información
que los usuarios pueden recuperar.
© Copyright IBM Corp. 2005, 2013 67

Relaciones
2. Organice el modelo creando vistas separadas para cada grupo de usuarios que
reflejen los conceptos empresariales familiares para sus usuarios.
3. Cree un modelo duradero que acepte los últimos cambios realizados en los
nombres de los elementos de consulta sin que afecte en los informes existentes
y autores de los informes.
Resultados
Puede analizar los metadatos con Model Advisor para asegurarse de que el
modelo sigue las directrices de modelo en vigor.
Una relación describe como crear una consulta relacional para varios objetos del
modelo. Sin relaciones, estos objetos son conjuntos de datos aislados.
Las relaciones son bidireccionales. Para comprenderlas, con frecuencia es necesario
examinar ambos sentidos.
Los diferentes tipos de relaciones son:
v Uno a uno
Las relaciones uno a uno se producen cuando una instancia de datos de un
asunto de consulta se relaciona exactamente con una instancia de otro. Por
ejemplo, cada estudiante tiene un número de estudiante.
v Uno a muchos o cero a muchos
Las relaciones uno a muchos o cero a muchos se producen cuando una instancia
de datos de un asunto de consulta se relaciona con muchas instancias de otro.
Por ejemplo, cada profesor tiene muchos estudiantes.
v Muchos a muchos
Las relaciones de muchos a muchos se producen cuando muchas instancias de
datos de un asunto de consulta se relacionan con muchas instancias de otra. Por
ejemplo, muchos estudiantes tienen muchos profesores.
Al importar metadatos, IBM Cognos Framework Manager puede crear relaciones
entre los objetos del modelo sobre la base de las claves principal y foráneas del
origen de datos. Puede crear o eliminar relaciones en el modelo de forma que este
represente mejor a estructura lógica del negocio.
Una vez importados los metadatos, compruebe que las relaciones que necesita
existen en el proyecto y que la cardinalidad es correcta. Es posible que el origen de
datos se haya diseñado sin usar una integridad referencial. Con frecuencia, no se
especifican muchas limitaciones de clave principal y única. Sin estas
limitaciones,Framework Manager no puede generar las relaciones necesarias entre
las tablas de hechos y las tablas de dimensiones.
Framework Manager almacena las relaciones en el padre común más cercano de
los objetos que participan en la relación. El padre puede ser una carpeta o un
espacio de nombres. Si mueve uno de los objetos participantes fuera del padre
común, la relación se mueve al espacio de nombres siguiente que sea común a
ambos extremos de la relación. Si mueve una relación a una carpeta o espacio de
nombres diferente, los objetos participantes también se mueven a la misma carpeta
o espacio de nombres.
68 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Cardinalidad
Sugerencia: Utilice la pestaña Buscar (panel Herramientas) para encontrar un
objeto de la clase Relación cuyo nombre coincida con un modelo especificado. Por
ejemplo, si busca una relación cuyo nombre contenga Encabezado de pedido,
Framework Manager encuentra todas las relaciones que tengan Encabezado de
pedido en un extremo. Si ha modificado el nombre de una relación, una búsqueda
de este tipo no la encontrará.
Entre dos asuntos de consulta, existen relaciones. La cardinalidad de una relación
es el número de filas relacionadas para cada uno de los dos asuntos de consulta.
Las filas se relacionan mediante la expresión de la relación; normalmente, esta
expresión hace referencia a las claves principal y foránea de las tablas subyacentes.
El software de IBM Cognos utiliza la cardinalidad de una relación de las siguientes
formas:
v Para evitar contar por partida doble los datos de hechos
v Para soportar uniones de bucle, habituales en modelos de esquema en estrella
v Para optimizar el acceso al sistema de origen de datos subyacente
v Para identificar asuntos de consulta que se comportan como hechos o
dimensiones
Una consulta que utiliza varios hechos de diferentes tablas subyacentes se divide
en consultas independientes para cada tabla de hechos subyacente. Cada consulta
de hecho único hace referencia a su tabla de hechos respectiva así como a las tablas
dimensionales relacionadas con la tabla de hechos. Se utiliza otra consulta para
combinar estas consultas individuales en un único conjunto de resultados.
Generalmente se hace referencia esta última operación como consulta enlazada. Se
puede reconocer que una consulta está enlazada cuando se muestra coalesce y
una unión externa completa.
Una consulta enlazada también permite que el software de IBM Cognos relacione
correctamente los datos en diferentes niveles de granularidad. Consulte: “Consultas
de varios hechos y granularidades” en la página 328.
Todas las relaciones y cardinalidad deben reflejar correctamente las necesidades de
generación de informes de los usuarios.
Para obtener más información, consulte: “Cardinalidad en consultas generadas” en
la página 322 y “Cardinalidad en el contexto de una consulta” en la página 323.
Detección de la cardinalidad del origen de datos
Al realizar una importación de un origen de datos relacionales, se detecta la
cardinalidad en función del conjunto de reglas que se especifique.
Las opciones disponibles son
v Utilizar claves primarias y foráneas
v Utilizar nombres de elementos de consulta coincidentes que representen
columnas indexadas de forma exclusiva
v Utilizar nombres de elementos de consulta coincidentes
La situación más común es utilizar claves primarias y foráneas así como elementos
de consulta coincidentes que representen de forma exclusiva las columnas
Capítulo 5. Modelado de metadatos relacionales 69

indexadas. La información se utiliza para establecer algunas propiedades de
elementos de consulta así como para generar relaciones.
Para ver la información de índice y de claves que se ha importado, pulse con el
botón derecho en un asunto de consulta y pulse Editar definición. Para un asunto
de consulta, puede cambiar la información en la pestaña Determinantes.
Las relaciones opcionales, uniones externas completas y relaciones de muchos a
muchos se pueden importar del origen de datos. IBM Cognos Framework Manager
las ejecutará como consultas.
Nota: Todas las dimensiones regulares empiezan como asuntos de consulta. Si ha
convertido un asunto de consulta en una dimensión regular, tenga en cuenta que la
información de determinantes para el asunto de consulta se utiliza como punto de
partida para definir los niveles de una única jerarquía. Revise los niveles y las
claves creadas en la jerarquía de la dimensión.
Notación
De forma predeterminada, Framework Manager utiliza notación Merise. La
notación Merise marca cada extremo de la relación con la cardinalidad mínima y
máxima de dicho extremo. También puede utilizar la notación Crowfoot, que
ofrece una representación pictórica de la relación.
Para obtener información sobre cómo cambiar la notación, consulte: “Cambio de
valores en los diagramas” en la página 20.
Al interpretar la cardinalidad, debe considerar la notación que se visualiza en
ambos extremos de la relación.
Las posibles etiquetas son:
v 0..1 (cero o una coincidencia)
v 1..1 (exactamente una coincidencia)
v 0..n (cero o más coincidencias)
v 1..n (una o más coincidencias)
La primera parte de la notación especifica el tipo de unión para la relación:
v Una unión interna (1)
Una unión interna muestra todas las filas coincidentes de los dos objetos.
v Una unión externa (0)
Una unión externa lo muestra todo de los dos objetos, incluidos los elementos
que no coinciden. Una unión externa puede calificarse como completa, izquierda
o derecha. Las uniones externas izquierda y derecha lo toman todo del lado
izquierdo o derecho de la relación, respectivamente, y sólo lo que coincide del
otro lado.
Los usuarios verán un informe distinto, en función de si utiliza una unión interna
o externa. Pongamos por caso que los usuarios quieren un informe que enumere
los vendedores y los pedidos. Si utiliza una unión externa para conectar
vendedores y pedidos, el informe muestra todos los vendedores,
independientemente de si tienen algún pedido. Si utiliza una unión interna, el
informe muestra sólo los vendedores que tienen algún pedido.
Los datos de un objeto pueden no tener ninguna coincidencia en el otro objeto. Sin
embargo, si la relación tiene una cardinalidad mínima de 1, siempre se utiliza una
70 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

unión interna y estos registros se ignoran. En cambio, si todos los elementos
coinciden pero la relación en el modelo tiene una cardinalidad mínima de 0,
siempre se utiliza una unión externa, aunque los resultados sean los mismos con
una unión interna. Por ejemplo, la tabla subyacente para un objeto contiene una
clave foránea obligatoria (que no puede dejarse vacía) para el otro. Asegúrese de
que los datos y las cardinalidades coinciden.
La segunda parte de la notación define la relación de los elementos de consulta
entre los objetos.
Cardinalidad en consultas generadas
El software de IBM Cognos soporta tanto la cardinalidad mínima y máxima como
la opcional.
En 0:1, 0 es la cardinalidad mínima, 1 es la cardinalidad máxima.
En 1:n, 1 es la cardinalidad mínima, n es la cardinalidad máxima.
Una relación con una cardinalidad especificada de 1:1 a 1:n se denomina
generalmente como 1 a n cuando se centra en las cardinalidades máximas.
Una cardinalidad mínima de 0 indica que la relación es opcional. Se especifica una
cardinalidad mínima de 0 si se desea que la retenga conserve la información en el
otro lado de la relación en ausencia de una coincidencia. Por ejemplo, una relación
entre un cliente y las ventas reales puede especificarse como 1:1 a 0:n. Indica que
los informes mostrarán la información de cliente solicitada incluso si no existieran
datos de ventas.
Por lo tanto una relación de 1 a n también se puede especificar como:
v 0:1 a 0:n
v 0:1 a 1:n
v 1:1 a 0:n
v 1:1 a 1:n
Utilice la sentencia Impacto de relación del cuadro de diálogo Definición de
relación para comprender mejor la cardinalidad. Por ejemplo, Sales Staff (1:1) está
unido a Orders (0:n).
Es importante asegurarse de que la cardinalidad se capture correctamente en el
modelo porque determina la detección de asuntos de consulta de hechos y se
utiliza para evitar el recuento doble de datos de hechos.
Al generar consultas, el software de IBM Cognos sigue estas reglas básicas para
aplicar la cardinalidad:
v La cardinalidad se aplica en el contexto de una consulta.
v La cardinalidad 1 a n implica datos de hechos en el lado de n e implica datos de
dimensión en el lado de 1.
Capítulo 5. Modelado de metadatos relacionales 71

v Un asunto de consulta puede comportarse como un asunto de consulta de
hechos o un asunto de consulta dimensional, en función de las relaciones que
son necesarias para responder a una consulta determinada.
Datos difusos
Cuando se modela en los análisis o la generación de informes, es importante tener
en cuenta las cuestiones empresariales en relación con el origen de datos.
Es habitual que, en un esquema en estrella, una relación entre una dimensión y
una tabla de hechos sea opcional. Esto significa que no todos los miembros
dimensionales son obligatorios en una tabla de hechos. Los motores de OLAP
compensan este hecho insertando el valor adecuado al crear la estructura OLAP
para los puntos de intersección dimensionales que no tienen datos.
Por ejemplo, un usuario de Analysis Studio desea crear este informe:
Region 2005 2006
Canadá 1.000.000
México 500.000 750.000
Estados Unidos 1.000.000 1.250.000
Al modelar, es habitual reemplazar las relaciones opcionales entre las dimensiones
y los hechos para mejorar el rendimiento. No obstante, al realizar el análisis o la
generación de informes en datos difusos donde se requiere información sobre los
miembros dimensionales que no tienen hechos, deben activarse las uniones
exteriores a fin de garantizar la devolución de datos para los puntos de
intersección dimensionales válidos.
Para habilitar las uniones exteriores, siga estos pasos:
v Pregunte al administrador de la base de datos si el origen de datos da soporte a
las uniones exteriores completas.
v Importe los metadatos con las uniones exteriores activadas.
Modificación de una relación
Después de importar datos o crear una relación en IBM Cognos Framework
Manager, puede cambiar el nombre de la relación y volver a definir la
cardinalidad.
Puede crear expresiones de relación personalizadas seleccionando un operador de
la lista o cambiando manualmente la expresión en el editor de expresiones.
También puede crear una expresión compleja para la relación.
Puede ver las relaciones que ya existen para un objeto seleccionando el objeto y
pulsando en Lanzar explorador de contexto en el menú Herramientas.
Procedimiento
1. Pulse una relación y pulse Acciones, Editar definición.
2. Para modificar elementos existentes, en la pestaña Expresión de relación,
seleccione los elementos de consulta, cardinalidades y operador que desee.
72 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Los elementos de consulta deben tener el mismo tipo de datos.
3. Para crear una unión más, en la pestaña Expresión de relación, pulse Nuevo
enlace y defina la nueva relación.
4. Para probar la relación, en la pestaña SQL de relación, identifique el número
de filas que desea que se devuelvan y pulse Probar.
5. Pulse Aceptar.
Si los metadatos proceden de un origen de datos de OLAP, pulse Cerrar.
Creación de expresiones complejas para una relación
Puede crear expresiones complejas para relaciones utilizando funciones, parámetros
y objetos del modelo.
Procedimiento
1. Pulse una relación y pulse Acciones, Editar definición.
2. En la pestaña Expresión de relación, pulse el botón de puntos suspensivos (...)
situado junto al cuadro Expresión.
3. Defina la expresión.
Si inserta parámetros de sesión o solicitudes y desea especificar los valores que
representan cuando pruebe la expresión, pulse el botón de opciones .
4. Pulse Aceptar.
Creación de relaciones
Puede crear una relación para unir lógicamente objetos relacionados que los
usuarios desean combinar en un único informe. Es útil para las relaciones entre
objetos que no se seleccionaron durante la importación de metadatos, no se
unieron en el origen de datos o proceden de varios orígenes.
Puede crear directamente una relación entre los elementos de consulta.
También puede crear una expresión compleja para la relación.
Asimismo, puede utilizar IBM Cognos Framework Manager para generar
automáticamente relaciones entre objetos basados en determinados criterios.
Puede ver las relaciones que ya existen para un objeto seleccionando el objeto y
pulsando en Lanzar explorador de contexto en el menú Herramientas.
Procedimiento
1. Pulse Ctrl y una o dos dimensiones, asuntos de consulta o elementos de
consulta.
2. Pulse Acciones, Crear, Relación.
Si esta relación es un destino válido para un atajo de relación, Framework
Manager le solicitará si desea crear un atajo para dicha relación. Para obtener
más información, consulte: “Creación de un atajo de relación” en la página 74.
3. Pulse Aceptar.
Aparece el cuadro de diálogo Definición de relación. Puede utilizar este
cuadro de diálogo para modificar la relación.
Capítulo 5. Modelado de metadatos relacionales 73

Creación de un atajo de relación
Un atajo de relación es un puntero a una relación existente. Puede utilizar los
atajos de relación para reutilizar la definición de una relación existente. Los
cambios que se realicen en la relación de origen se reflejan automáticamente en el
atajo. También puede utilizar los atajos de relación para solucionar relaciones
ambiguas entre asuntos de consulta.
IBM Cognos Framework Manager le solicitará si desea crear un atajo de relación al
crear una relación y si se cumplen las dos condiciones siguientes:
v Al menos un extremo de la relación nueva es un atajo.
v Existe una relación entre los objetos originales.
Procedimiento
1. Pulse Ctrl y los objetos que desea incorporar al atajo de relación.
2. Pulse Acciones, Crear, Relación.
Framework Manager le solicita si desea crear un atajo para dicha relación.
3. Pulse Sí.
Aparece una lista de todas las relaciones en las que un extremo es un objeto de
modelo y el otro extremo es otro objeto de modelo o un atajo a otro objeto de
modelo.
4. Para recuperar todas las relaciones cuyos dos extremos pueden ser un objeto de
modelo o un atajo a un objeto de modelo, pulse Buscar todo.
5. Pulse la relación que desea que sea el destino del atajo de la relación.
6. Pulse Aceptar.
Detección y generación de relaciones
Puede utilizar IBM Cognos Framework Manager para detectar y generar relaciones
entre dos o más objetos del modelo. Esto es útil si va a importar metadatos en
fases o si desea cambiar los criterios de las relaciones existentes; por ejemplo, si
incluyen uniones externas.
Al importar metadatos de esquema en estrella, procure no generar relaciones
basadas en la coincidencia de nombres de columna y elementos de consulta a
menos que aplique convenios de denominación. Es frecuente que los almacenes de
datos apliquen estándares de denominación a las columnas, como surr_key como
nombre de columna predeterminado para las claves suplentes de las dimensiones.
En este caso, si se generan relaciones basadas en nombres de columna coincidentes,
se generan relaciones incorrectas entre todas las tablas de dimensiones.
Procedimiento
1. Pulse Ctrl y dos o más objetos.
2. Pulse Herramientas, Detectar relaciones.
3. Seleccione las reglas que desea aplicar a cada par de tablas.
Regla Resultado
Utilizar claves primarias y foráneas Crea uniones que se basan en relaciones de
clave principal y clave foránea. Los nombres
de los elementos de consulta no tienen que
coincidir.
74 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Asuntos de consulta
Regla Resultado
Utilice nombres de elementos de consulta
coincidentes que representen columnas
indexadas de forma exclusiva.
Utilizar nombres de elementos de consulta
coincidentes
Crea uniones entre los elementos de consulta
cuyos nombres y tipos de datos coincidan, si
una o las dos columnas subyacentes están
indexadas de modo exclusivo.
Crea uniones entre elementos de consulta
cuyos nombres y tipos de datos coinciden.
Esto genera todas las relaciones posibles.
4. Indique si desea que Framework Manager detecte y genere relaciones entre
v Los objetos seleccionados
v Cada objeto seleccionado y cada objeto del proyecto que no esté seleccionado
v Los objetos seleccionados y el resto de los objetos del proyecto
5. Identifique si desea que Framework Manager cree uniones externas o uniones
internas basadas en uniones externas que existen en el origen de datos.
6. Si desea inhabilitar la prevención automática de recuento doble, convierta todas
las n cardinalidades en 1 desmarcando la casilla de verificación Detección de
hechos habilitada.
Para obtener más información, consulte: Capítulo 9, “Directrices de modelado
de metadatos”, en la página 321.
7. Pulse Aceptar.
Un asunto de consulta es un conjunto de elementos de consulta que tienen una
relación inherente.
IBM Cognos Framework Manager se utiliza para modificar los asuntos de consulta
a fin de optimizar y personalizar los datos que recuperan. Por ejemplo, puede
añadir filtros o cálculos. Cuando se cambia la definición de un asunto de consulta,
Framework Manager vuelve a generar los elementos de consulta asociados,
asegurando así que los cambios en las propiedades del asunto de consulta queden
reflejados en todos los elementos de consulta de ese asunto de consulta.
Hay diferentes tipos de asuntos de consulta en Framework Manager:
v Asuntos de consulta de orígenes de datos
v Asuntos de consulta de modelo
v Asuntos de consulta de procedimiento almacenado
También puede estar interesado en “Asuntos de consulta frente a dimensiones” en
la página 334.
Asuntos de consulta de orígenes de datos
Los asuntos de consulta que están basados en metadatos relacionales están
definidos por sentencias SQL que describen cómo recuperar datos del origen de
datos.
Capítulo 5. Modelado de metadatos relacionales 75

Los asuntos de consulta de orígenes de datos hacen referencia directamente a datos
de un único origen de datos. IBM Cognos Framework Manager crea
automáticamente un asunto de consulta de orígenes de datos para cada tabla y
vista que importe a su modelo.
Por ejemplo, importa la tabla de hechos Detalles del empleado desde la base de
datos de ejemplo Almacén de Viaje de Aventuras. Framework Manager crea
entonces un asunto de consulta utilizando la siguiente sentencia SQL:
Select * from [go_data_warehouse].EMPLOYEE_DETAIL_FACT
Framework Manager genera asuntos de consulta que representan datos tabulares
del origen de datos. Por ejemplo, un asunto de consulta que hace referencia a toda
una tabla contiene elementos de consulta que representan cada columna de la
tabla. Si el SQL selecciona solamente columnas específicas, sólo esas columnas se
representan como elementos de consulta.
Cada asunto de consulta de orígenes de datos puede hacer referencia a datos de un
solo origen de datos cada vez. No obstante, la ventaja de los asuntos de consulta
de orígenes de datos es que puede editar directamente el SQL que define los datos
que deben recuperarse. Esto significa que puede insertar parámetros que controlen
los datos que recupera la consulta y crear asuntos de consulta basados en SQL
arbitrarios.
Es posible que haya creado sentencias SQL para asuntos de consulta sin incluir
entre comillas las referencias a columnas y tablas. Esto funciona en entornos de
orígenes de datos relacionales que no utilizan una búsqueda con distinción entre
mayúsculas y minúsculas contra las tablas de metadatos que analizan. La sentencia
SQL para el asunto de consulta puede ser Cognos SQL, SQL nativo o SQL
pass-through. Las sentencias de SQL nativo y pass-through deben estar
completamente autocontenidas y no deben hacer referencia a nada fuera de ese
SQL, como solicitudes de base de datos, variables o formateo nativo que
normalmente proporcionaría la aplicación de llamada. En cambio, las sentencias de
Cognos SQL se analizan utilizando metadatos del modelo o del origen de datos
relacionales. De forma predeterminada, Cognos SQL distingue entre mayúsculas y
minúsculas, por lo que busca metadatos utilizando los nombres tal como se
visualizan en la sentencia SQL.
Para utilizar varios orígenes de datos para un asunto de consulta, utilice un asunto
de consulta de modelo que acceda a los asuntos de consulta de orígenes de datos u
otros asuntos de consulta de modelo.
Creación de asuntos de consulta de orígenes de datos
Los asuntos de consulta de orígenes de datos hacen referencia directamente a datos
de un único origen de datos. IBM Cognos Framework Manager crea
automáticamente un asunto de consulta de orígenes de datos para cada tabla y
vista que importe a su modelo. Puede crear asuntos de consulta de orígenes de
datos adicionales.
Puede añadir cualquier combinación de objetos a un asunto de consulta, como
elementos de consulta, otros asuntos de consulta o dimensiones. Puede añadir
cálculos y filtros independientes y también cálculos y filtros incluidos en el asunto
de consulta.
76 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Asimismo, puede crear asuntos de consulta de orígenes de datos, que se basen en
metadatos que existen en el modelo, y asuntos de consulta de procedimiento
almacenado, que se generen a partir de procedimientos almacenados en un origen
de datos relacionales.
Procedimiento
1. Seleccione la carpeta de espacio de nombres y pulse Acciones, pulse Crear,
Asunto de consulta.
2. Escriba un nombre para el asunto de consulta nuevo en el cuadro Nombre.
3. Pulse Origen de datos y Aceptar.
4. Complete todos los pasos del asistente Nuevo asunto de consulta.
Para asegurar que el origen de consulta se identifique de modo exclusivo para
un asunto de consulta de orígenes de datos, espere a que se muestre el botón
Finalizar antes de cerrar el asistente.
5. Pulse Finalizar.
6. Pulse con el botón derecho en el asunto de consulta creado y pulse Editar
definición.
7. Pulse la pestaña SQL y desde el cuadro Objetos de base de datos disponible,
arrastre los objetos al cuadro SQL.
Si el proyecto contiene varios orígenes de datos y desea añadir objetos desde
diferentes orígenes de datos al asunto de consulta, pulse Insertar origen de
datos, seleccione el origen de datos que requiera y pulse Aceptar.
Asimismo, puede insertar una macro e incluir un cálculo y un filtro. Para
obtener más información, consulte: “Creación de cálculos” en la página 150 o
“Creación de filtros” en la página 152.
8. Elija la acción que desee:
Objetivo Acción
Proporcionar control en la granularidad Pulse la pestaña Determinantes. Consulte:
“Determinantes” en la página 84.
Probar el asunto de consulta Pulse la pestaña Probar. Consulte: “Prueba
de asuntos de consulta o conjuntos de
consultas” en la página 92.
Ver el SQL Pulse la pestaña Información de consultas.
Consulte: “Edición de SQL” en la página 98.
Ver las tablas del sistema desde el origen de
datos
Seleccione la casilla de verificación Mostrar
objetos del sistema.
9. Pulse Aceptar.
Un aviso muestra si las modificaciones han invalidado relaciones, otros
asuntos de consulta, cálculos o filtros.
10. Compruebe que las propiedades Uso y Agregado regular estén correctamente
definidas. Consulte: “Modificar cómo se agregan los elementos de consulta”
en la página 134.
Capítulo 5. Modelado de metadatos relacionales 77

Asuntos de consulta de modelo
Los asuntos de consulta de modelo no se generan directamente desde un origen de
datos, sino que se basan en elementos de consulta de otras dimensiones o asuntos
de consulta, incluidos otros asuntos de consulta de modelo. Al utilizar asuntos de
consulta de modelo, puede crear una vista más abstracta de orientación
empresarial de un origen de datos.
Normalmente los asuntos de consulta de modelo se crean en la vista empresarial,
no en la vista de importación. Para obtener información sobre la vista empresarial,
consulte: “Organización de modelos” en la página 173.
Dado que los asuntos de consulta de modelo se basan en los metadatos de su
modelo, le permiten:
v Reutilizar sentencias SQL complejas que existen en el modelo.
v Hacer referencia a objetos de diferentes orígenes de datos en el mismo asunto de
consulta.
Si importa un asunto de consulta de modelo de otro modelo, el asunto de consulta
de modelo no funcionará a no ser que también importe los asuntos de consulta de
orígenes de datos a los que hace referencia el asunto de consulta de modelo.
Si desea editar el SQL, deberá convertir el asunto de consulta de modelo en un
asunto de consulta de orígenes de datos.
Creación de asunto de consulta de modelo para metadatos
relacionales
Los asuntos de consulta de modelo se basan en elementos de consulta de otras
dimensiones o asuntos de consulta, incluidos otros asuntos de consulta de modelo.
Al utilizar asuntos de consulta de modelo, puede crear una vista más abstracta de
orientación empresarial de un origen de datos.
Puede añadir cualquier combinación de objetos a un asunto de consulta, como
elementos de consulta, otros asuntos de consulta o dimensiones. Puede añadir
cálculos y filtros independientes y también cálculos y filtros incluidos en el asunto
de consulta.
También puede crear un asunto de consulta de modelo fusionando asuntos de
consulta existentes y elementos de consulta “Creación de asuntos de consulta de
modelo basados en objetos existentes” en la página 88. Asimismo, puede crear
asuntos de consulta de orígenes de datos, que hagan referencia directamente a los
datos de un solo origen de datos “Asuntos de consulta de orígenes de datos” en la
página 75 y asuntos de consulta de procedimiento almacenado que se generen a
partir de procedimientos almacenados de un origen de datos relacionales “Asuntos
de consulta de procedimiento almacenado” en la página 79.
Cuando se utiliza un asunto de consulta de modelo en los estudios de IBM
Cognos, IBM Cognos BI utiliza las relaciones definidas para el asunto de consulta
de modelo, no las relaciones definidas para los asuntos de consulta de orígenes de
datos subyacentes. Si desea que se utilicen las relaciones definidas para los asuntos
de consulta de orígenes de datos subyacentes, no defina relaciones ni
determinantes para el asunto de consulta de modelo.
78 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Procedimiento
1. Seleccione la carpeta de espacio de nombres y pulse Acciones, pulse Crear,
Asunto de consulta.
2. Escriba un nombre para el asunto de consulta nuevo en el cuadro Nombre.
3. Pulse Modelo, Aceptar.
4. Pulse la pestaña Definición de asunto de consulta.
5. Para añadir elementos al asunto de consulta de modelo, arrastre los elementos
desde el cuadro Objetos de modelo disponibles al cuadro Elementos de
consulta y cálculos.
Puede cambiar el orden de los elementos y de los cálculos. Sin embargo, si el
asunto de consulta contiene una carpeta de elementos de consulta, puede
cambiar el orden solo en el Visor de proyectos.
6. También puede incluir un filtro.
Si añade cálculos o filtros a un asunto de consulta de modelo, Framework
Manager debe dirigirse al origen de datos en lugar de simplemente acceder al
modelo.
7. Si desea probar el asunto de consulta, pulse la pestaña Probar.
8. Pulse Aceptar.
Un aviso muestra si las modificaciones han invalidado relaciones, otros asuntos
de consulta, cálculos o filtros.
9. Compruebe que las propiedades Uso y Agregado regular estén correctamente
definidas.
Resultados
También puede estar interesado en los temas siguientes:
v Cálculos incluidos “Creación de un cálculo (SAP BW)” en la página 236
v Filtros incluidos “Creación de un filtro (SAP BW)” en la página 237
v Probar y configurar opciones de prueba “Prueba de una dimensión o de otro
objeto (SAP BW)” en la página 211
v Modificar las propiedades de varios asuntos de consulta al mismo tiempo
“Sustitución de varios valores de propiedad” en la página 21
Asuntos de consulta de procedimiento almacenado
Los asuntos de consulta de procedimiento almacenado se generan al importar un
procedimiento desde un origen de datos relacionales. IBM Cognos Framework
Manager solo soporta procedimientos almacenados definidos por el usuario. Los
procedimientos almacenados del sistema no se soportan.
El procedimiento debe ejecutarse en Framework Manager para obtener una
descripción del conjunto de resultados que el procedimiento puede devolver.
El procedimiento almacenado debe devolver un solo conjunto de resultados
uniforme. IBM Cognos BI solo da soporte al primer conjunto de resultados que se
devuelve. Si el procedimiento pudiera devolver un conjunto de resultados
diferente, el formato debe ser coherente con el usado para definir los metadatos de
Framework Manager.
Cada conjunto de resultados debe devolver el mismo formulario, como el mismo
número, tipo y nombres de columna. IBM Cognos BI da soporte a las firmas
Capítulo 5. Modelado de metadatos relacionales 79

sobrecargadas, pero cada procedimiento debe definirse como un procedimiento de
nombre exclusivo con un asunto de consulta diferente para cada conjunto de
resultados.
No se da soporte a los parámetros de salida.
Una vez que se haya importado o creado un asunto de consulta de procedimiento
almacenado, se mostrará como objeto roto. Debe ejecutarlo para validar el
procedimiento almacenado subyacente y especificar la lista de proyección. Con
frecuencia, no existen metadatos estáticos para el procedimiento almacenado en el
origen de datos relacionales que describan el aspecto que tiene el conjunto de
resultados. El conjunto de resultados solo se conoce en el tiempo de ejecución.
Cuando un procedimiento almacenado se actualiza en el origen de datos, la
ejecución de este en Framework Manager actualiza el asunto de consulta con los
elementos de consulta recién generados.
Algunas veces se importan funciones como asuntos de consulta de procedimiento
almacenado. Examine la definición del procedimiento almacenado para determinar
lo que el procedimiento espera que se pase y lo que intentará devolver. Edite y
pruebe cada uno de los asuntos de consulta de procedimiento almacenado que crea
que puede ser una función. Si la prueba falla, el asunto de consulta es una función
y debe eliminarse.
Para obtener más información, consulte: “Creación o modificación de asuntos de
consulta de procedimiento almacenado” en la página 81.
Procedimientos almacenados de orígenes de datos Informix
Si tiene procedimientos almacenados de orígenes de datos de servidores dinámicos
o paralelos de Informix, debe editar estos parámetros. consulte el origen original
de los procedimientos almacenados para comprobar que estén correctamente
asignados.
Informix 7.x y 8.xproporcionan solo el nombre del procedimiento almacenado a
Framework Manager. Debe proporcionar todos los parámetros, como el nombre del
parámetro, el tipo de datos, el modo, el tamaño, la precisión, la escala y el valor,
para que el conjunto de resultados pueda obtenerse. Informix 9.x proporciona
metadatos para los procedimientos almacenados y funciones definidas por el
usuario con valores de parámetro predeterminados. Compruebe todos los
parámetros antes de utilizarlos; en particular, el atributo de modo.
Las funciones de Informix se importan como procedimientos almacenados. Una
vez que los haya importado, debe cambiarlos por funciones; para ello, pulse el
botón f(x) en el cuadro de diálogo Editar definición. Este botón solo está
habilitado para estas funciones. Después, seleccione el argumento que representa
los resultados o use los valores obtenidos de los resultados de la prueba.
Procedimientos almacenados de Composite Information Server
Si tiene procedimientos almacenados de Composite Information Server, consulte el
origen original de los procedimientos almacenados para comprobar que están
correctamente asignados.
Las funciones de Composite se importan como procedimientos almacenados. Una
vez que los haya importado, debe cambiarlos por funciones; para ello, pulse el
botón f(x) en el cuadro de diálogo Editar definición. Este botón solo está
80 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

habilitado para estas funciones. Después, seleccione el argumento que representa
los resultados o use los valores obtenidos de los resultados de la prueba.
Creación o modificación de asuntos de consulta de
procedimiento almacenado
Una vez que se haya importado o creado un asunto de consulta de procedimiento
almacenado, puede modificarlo. Para evitar incoherencias, el asunto de consulta
modificado debe devolver la misma estructura de conjunto de resultado que el
procedimiento almacenado original.
IBM Cognos Framework Manager solo soporta procedimientos almacenados
definidos por el usuario. Los procedimientos almacenados del sistema no se
soportan.
Hay varios tipos de procedimientos almacenados:
Tipo de procedimiento almacenado Descripción
Consulta de datos emite una transacción de solo lectura.
Si tiene un procedimiento almacenado cuyo
tipo se ah definido como Consulta de datos,
el procedimiento almacenado emite una
transacción de solo lectura. Cuando el
procedimiento almacenado se ejecuta en
Event Studio, aparece un mensaje de error
que indica que el procedimiento almacenado
desea actualizar la base de datos. El motivo
del error es que el procedimiento
almacenado contiene una transacción pasiva
soportada por la base de datos subyacente.
El problema se soluciona pulsando en
Aceptar para que el procedimiento
almacenado actualice la base de datos. No
debe realizar mas acción que esta.
Capítulo 5. Modelado de metadatos relacionales 81

Tipo de procedimiento almacenado Descripción
Modificación de datos Escribe un registro en el origen de datos.
Utilice este tipo si desea utilizar el
procedimiento almacenado en Event Studio.
Si desea que los usuarios de Event Studio
puedan seleccionar un parámetro en una
tarea, debe incluir el parámetro entre
comillas.
Aviso: Si prueba un procedimiento
almacenado de modificación de datos en el
cuadro de diálogo Editar definición, los
datos se graban en el origen de datos. No se
pueden retrotraer transacciones al origen de
datos en Framework Manager. Si se graban
datos no deseados en el origen de datos
como resultado de una prueba del
procedimiento almacenado, el administrador
de la base de datos puede retrotraer si el
origen de datos está configurado para
soportarlo. Para probar el procedimiento
almacenado sin grabar datos en el origen de
datos, pulse Probar en el menú
Herramientas.
Asimismo, puede crear asuntos de consulta de orígenes de datos, que hagan
referencia directamente a los datos de un solo origen de datos “Asuntos de
consulta de orígenes de datos” en la página 75 y asuntos de consulta de modelo
que se basen en metadatos que existen en el modelo “Asuntos de consulta de
modelo” en la página 78.
Procedimiento
1. Realice las acciones siguientes:
Objetivo Acción
Crear un asunto de consulta de
procedimiento almacenado
Modificar un asunto de consulta de
procedimiento almacenado
Seleccione la carpeta de espacio de nombres
y, desde el menú Acciones, pulse Crear,
Asunto de consulta.
Escriba un nombre para el asunto de
consulta nuevo en el cuadro Nombre.
Pulse Procedimiento almacenado y Aceptar.
Complete todos los pasos del asistente
Nuevo asunto de consulta.
Seleccione el asunto de consulta de
procedimiento almacenado que desee
modificar.
En el menú Acciones, pulse Editar
definición.
2. Pulse la pestaña Definición y elija la acción que desee.
82 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Objetivo Acción
Utilizar otro procedimiento almacenado En el cuadro Nombre de procedimiento
almacenado, escriba el nombre del
procedimiento almacenado.
Cambiar el tipo de procedimiento
almacenado
Cambiar el origen de datos en el que está el
procedimiento almacenado
En el cuadro Tipo, seleccione Consulta de
datos o Modificación de datos.
Pulse el botón de puntos suspensivos (...)
situado junto al cuadro Origen de datos.
Cuando se importa un procedimiento
almacenado, se crear un origen de datos.
Puede señalar el origen de datos original y
suprimir el nuevo.
Editar un argumento Pulse el argumento y en el botón de puntos
suspensivos (...) .
Generar los elementos de consulta
proyectados
El cuadro Sintaxis del cuadro de diálogo
Definición de asunto de consulta muestra
la sintaxis correcta que debe utilizarse.
Pulse la pestaña Probar. Consulte: “Prueba
de asuntos de consulta o conjuntos de
consultas” en la página 92.
3. Pulse Aceptar.
Framework Manager ejecuta el procedimiento almacenado y, si el asunto de
consulta devuelve un conjunto de resultados, valida el asunto de consulta.
Si el procedimiento almacenado no devuelve un conjunto de resultados, el
asunto de consulta pasa a ser no válido si se guarda en el modelo. Si el asunto
de consulta no válido se incluye en el paquete publicado, dicho asunto de
consulta no se puede utilizar en el informe.
4. Compruebe que las propiedades Uso y Agregado regular estén correctamente
definidas en cada elemento de consulta que se cree.
Por ejemplo, un elemento de consulta puede definirse como hecho cuando, en
realidad, es un identificador.
Resultados
Puede actualizar el asunto de consulta de procedimiento almacenado si cambia el
origen de datos. Consulte: “Actualización de asuntos de consulta” en la página 96.
Ejemplo: Uso de solicitudes con un procedimiento almacenado
Si define solicitudes para variables de procedimiento almacenado, los usuarios
pueden definir variables en los informes.
Procedimiento
1. Cree un asunto de consulta de procedimiento almacenado que utilice el
procedimiento almacenado sp_FIND_ORDER_DATE.
Aparece el cuadro de diálogo Definición de asunto de consulta.
Capítulo 5. Modelado de metadatos relacionales 83

2. En la pestaña Definición, seleccione el argumento @order_number y pulse el
botón de puntos suspensivos (...) .
3. En el cuadro Valor, escriba la sintaxis de macro siguiente y pulse Aceptar:
#prompt(’Order Number’,’integer’)#
Nota: Framework Manager elimina todo lo que está fuera de los signos de
almohadilla al ejecutar la macro.
4. Si desea probar la solicitud para la variable, realice lo siguiente:
v Pulse Probar, Probar muestra.
Aparece el cuadro de diálogo Valores de solicitud.
v En la columna Nombre, pulse Número de pedido.
v En el campo Valor, escriba 1234 y pulse Aceptar.
Se devuelve un registro que muestra la fecha del número de pedido 1234.
Framework Manager utiliza este valor mientras dure la sesión o hasta que se
borre el valor de la solicitud.
5. Pulse Aceptar.
Determinantes
Los determinantes reflejan la granularidad mediante la representación de
subconjuntos o grupos de datos en un asunto de consulta y se utilizan para
asegurar la agregación correcta de estos datos repetidos. Los determinantes están
más directamente relacionados con el concepto de claves e índices del origen de
datos y se importan en función de la información de claves exclusivas y de índice
del origen de datos. Se recomienda revisar siempre los determinantes que se
importan y, si es necesario, modificarlos o crear otros nuevos. Mediante la
modificación de determinantes, puede reemplazar la información de índice y claves
del origen de datos, sustituyéndola por información mejor alineada con sus
necesidades de informe y análisis. Mediante la adición de determinantes, puede
representar grupos de datos repetidos que son pertinentes para su aplicación.
Un ejemplo de determinante único es Day en el ejemplo de Time siguiente. Un
ejemplo de determinante no único es Month; la clave de Month se repite para el
número de días de un mes determinado. Cuando se define un determinante no
único, se debe especificar Agrupar por. Indica al software de IBM Cognos que
cuando las claves o atributos asociados a este determinante se repitan en los datos,
se deben aplicar funciones de agregado y agrupación para evitar el recuento doble.
No se recomienda especificar determinantes que tengan seleccionadas las dos
opciones Identificado exclusivamente y Agrupar por o que no tengan ninguna de
ellas seleccionadas.
Year Key Month Key Month Name Day Key Day Name
2006 200601 January 06 20060101 Sunday, January
1, 2006
2006 200601 January 06 20060102 Monday, January
2, 2006
Se pueden definir tres determinantes para este conjunto de datos de la siguiente
forma: dos determinantes Agrupar por (Year y Month) y un determinante único
(Day). El concepto es similar al concepto de niveles y jerarquías, pero no idéntico.
84 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Nombre del
determinante Clave Atributos
Identificado
exclusivamente Agrupar por
Year Year Key Ninguno No Sí
Month Month Key Month Name No Sí
Day Day Key Day Name Sí No
Month Key
Month Name
Year Key
En este caso, solo utilizamos una clave para cada determinante porque cada una de
ellas contiene suficiente información para identificar un grupo contenido en los
datos. Con frecuencia Month se convierte en un reto si la clave no contiene
suficiente información para aclarar el año al que pertenece el mes. Sin embargo, en
este caso, la clave de Month incluye la clave de Year y, por lo tanto por sí misma
es suficiente para identificar los meses como una subagrupación de años.
Nota: Aunque puede crear un determinante que agrupe meses sin el contexto de
años, es la opción menos común para la creación de informes porque se agruparían
todos los datos para febrero de todos los años, en lugar de todos los datos para
febrero de 2006.
Cuándo se deben utilizar determinantes
Aunque se pueden utilizar determinantes para resolver una variedad de problemas
relacionados con la granularidad de los datos, los casos principales en los que
siempre se deben utilizar son los siguientes:
v Un asunto de consulta se comporta como una dimensión que tiene varios niveles
de granularidad y se unirá en diferentes conjuntos de claves a datos de hechos.
Por ejemplo, Time tiene varios niveles y se une a Inventory en la clave Month y
a Sales en la clave Day. Para obtener más información, consulte: “Consultas de
varios hechos y granularidades” en la página 328.
v Surge la necesidad de contar o realizar otras funciones de agregado en una clave
o atributo que se repite.
Por ejemplo, Time tiene la clave Month y un atributo, Days in the month, que se
repite para cada día. Si desea utilizar Days in the month en un informe, no
desea la suma de Days in the month para cada día del mes. En su lugar, desea
el valor único de Days in the month para la clave Month que se ha elegido. En
SQL, es XMIN(Days in the month for Month_Key). También existe una cláusula
Group by en Cognos SQL.
Hay menos casos comunes en los que se necesita utilizar determinantes:
v Desea identificar de forma única la fila de datos al recuperar datos BLOB de
texto del origen de datos.
Para la consulta de blobs es necesaria información adicional de tipo de clave o
de índice. Si esta información no está presente en el origen de datos, puede
añadirla utilizando determinantes. Reemplace los determinantes importados del
origen de datos que entran en conflicto con las relaciones creadas para informe.
No puede utilizar claves de varios segmentos cuando el asunto de consulta
accede a datos blob. Con consultas de resumen, los datos blob se deben
Capítulo 5. Modelado de metadatos relacionales 85

ecuperar por separado de la parte de resumen de la consulta. Para hacerlo,
necesita una clave que identifique de forma única la fila y que no tenga varios
segmentos.
v Se especifica una unión que utiliza menos claves que un determinante único que
se ha especificado para un asunto de consulta.
Si la unión se ha creado en base a un subconjunto de las columnas a las que
hacen referencia las claves de un determinante único en el lado de 0..1 o 1..1
de las relaciones, habrá un conflicto. Resuelva este conflicto modificando la
relación para que esté completamente de acuerdo con el determinante o
modificando el determinante para que soporte la relación.
v Desea reemplazar los determinantes importados del origen de datos que entran
en conflicto con relaciones creadas para informe.
Por ejemplo, hay determinantes en dos asuntos de consulta para varias
columnas pero la relación entre los asuntos de consulta solo utiliza un
subconjunto de estas columnas. Modifique la información de determinante del
asunto de consulta si no es adecuado para utilizar las columnas adicionales en la
relación.
Especificación de determinantes
Los determinantes sirven para controlar la granularidad de los asuntos de consulta.
Si un asunto de consulta tiene determinantes, cada elemento de consulta del
asunto debe incluirse en uno de los determinantes.
Los determinantes se procesan en el orden en el que se han especificado en el
modelo. Puede cambiar el orden de los determinantes. Si un asunto de consulta
tiene más de un determinante, se utiliza el primero que cubre todos los elementos
solicitados. Los determinantes se evalúan en el contexto de cada unión requerida
así como en el contexto de los elementos solicitados.
Los asuntos de consulta de orígenes de datos se importan con los determinantes
definidos para ellos. Estos determinantes predeterminados se generan sobre la base
de claves e índices en el origen de datos.
Los asuntos de consulta de modelo no tiene determinantes definidos
automáticamente. Si se necesitan determinantes, deben definirse manualmente.
Los asuntos de consulta de procedimiento almacenado no tienen determinantes.
No se pueden utilizar determinantes con SQL especificado por el usuario que se
haya especificado en una consulta definida en Report Studio.
Procedimiento
1. Pulse el asunto de consulta que desee y pulse Acciones, Editar definición.
2. Pulse la pestaña Determinantes.
3. Pulse Añadir en el cuadro Determinantes.
En el cuadro, aparece la entrada Nuevo determinante. Para dar a esta entrada
un nombre que pueda recordar fácilmente, pulse con el botón derecho en ella y
pulse Cambiar de nombre.
4. Para definir una clave, pulse con el botón derecho en un elemento de consulta
del cuadro Elementos disponibles y pulse Añadir como clave.
Sugerencia: También puede arrastrar los elementos de consulta al cuadro
Clave.
86 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

5. Para identificar los elementos de consulta que deben asociarse con este
determinante, pulse con el botón derecho en los elementos de consulta del
cuadro Elementos disponibles y pulse Añadir como atributos.
Sugerencia: También puede arrastrar los elementos de consulta al cuadro
Atributos.
Puede tener determinantes sin atributos definidos. Framework Manager utiliza
este tipo de determinante para indicar qué elementos de consulta están
indexados.
6. Para especificar que el determinante seleccionado debe utilizarse como
identificador exclusivo, seleccione la casilla de verificación Identificado
exclusivamente.
Esto solo debe hacerse si los datos de este elemento son exclusivos para cada
fila del origen de datos subyacente.
Puede especificar más de un determinante exclusivo si son realmente
exclusivos. En el momento de la consulta, la relación que se utiliza determinará
qué determinante exclusivo debe utilizarse.
7. Seleccione la casilla de verificación Agrupar por para indicar que si las claves o
los atributos asociados con dicho determinante se repiten en los datos, IBM
Cognos BI debe aplicar funciones de agregado y agrupaciones para evitar un
recuento doble.
8. Si desea cambiar el orden de los determinantes, utilice los botones de flecha.
Los determinantes se procesan en el orden en el que se han especificado en el
modelo.
9. Pulse Aceptar.
Resultados
Para obtener más información, consulte: “Determinantes” en la página 324 y
Capítulo 10, “SQL generado por el software de IBM Cognos”, en la página 357.
Efecto de los determinantes en SQL
Es importante comprender el efecto que los determinantes tienen en el SQL que se
genera. Los determinantes afectan a la agrupación y agregación de datos, incluidos
los asuntos de consulta que tienen relaciones con el asunto de consulta, así como el
propio asunto de consulta.
Por ejemplo, considere la siguiente información. Cada Product Line contiene
muchas apariciones de Product Type. Cada Product Type contiene muchas
apariciones de Product. Para Product, Product Key es una clave suplente y Product
Number es una clave de empresa que se utiliza como atributo. Los datos unidos en
Product Key se agregan correctamente cuando los notifican Product Line o Product
Type.
Determinante Clave Agrupar por
Identificado
exclusivamente Atributos
Product line Código de
Product line
Sí Product line
Product type Código de
Product type
Sí Product type
Capítulo 5. Modelado de metadatos relacionales 87

Determinante Clave Agrupar por
Product Clave de
Product
Identificado
exclusivamente Atributos
Sí Cost
Margin
Product name
Product number
Creación de asuntos de consulta de modelo basados en
objetos existentes
Puede seleccionar objetos de modelo existentes y fusionarlos en un asunto de
consulta de modelo nuevo. Esto significa que puede reutilizar metadatos existentes
para crear con mayor rapidez asuntos de consulta.
La información sobre los asuntos de consulta de SAP BW se muestra en el tema
“Creación de asuntos de consulta de modelo basados en objetos existentes (SAP
BW)” en la página 215.
Acerca de esta tarea
Puede fusionar, entre otros, los objetos siguientes
v Asuntos de consulta de orígenes de datos relacionales y sus atajos
v Asuntos de consulta de modelo y sus atajos
v Elementos de consulta, filtros y cálculos del modelo y asuntos de consulta de
orígenes de datos
v Relaciones y atajos de relaciones entre el modelo y los asuntos de consulta de
orígenes de datos
Puede fusionar todos los objetos del mismo tipo que desee en una nueva consulta
en una sola operación. La consulta siempre crea un asunto de consulta de modelo.
El asunto de consulta nuevo contiene todos los filtros que existen en el asunto de
consulta original.
Procedimiento
1. Pulse Ctrl y los objetos que desea fusionar en un único asunto de consulta.
2. Pulse Acciones, Fusionar en asunto de consulta nuevo.
Visualización de objetos relacionados
Puede ocultar un objeto en el Explorador de contexto. Puede cambiar el diseño,
colocar todos los objetos en el Explorador de contexto, ampliar o disminuir,
imprimir, obtener vistas previas de los diagramas antes de imprimir y cambiar la
configuración de la página.
También puede utilizar la pestaña Mapa de dimensiones para explorar
dimensiones.
88 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Procedimiento
1. Seleccione uno o más objetos para explorar.
2. En el menú Herramientas, pulse Lanzar explorador de contexto.
3. Para ver los objetos conectados, pulse uno o varios objetos y pulse el botón
adecuado.
Objetivo Botón
Ver los objetos relacionados con el objeto seleccionado.
Ver las referencias intermedias de los objetos.
Ver todas las referencias de los objetos.
4. Si desea ver los detalles sobre un objeto, como sus relaciones y elementos de
consulta, pulse con el botón derecho en el objeto, pulse Navegar por diagrama,
Valores de diagrama y seleccione los detalles que desee.
Creación de conjuntos de consultas
No todos los tipos de datos están soportados. Generalmente, los conjuntos no están
permitidos en los tipos de datos BFILE, BLOB, CLOB, LONG y VARRAY o en columnas de
tablas anidadas.
Un asunto de consulta se puede definir utilizando operaciones set de unión,
intersección o excepción. Un conjunto de consultas se define para combinar,
comparar o igualar datos similares de diferentes orígenes de datos. Los conjuntos
de consultas son útiles cuando se modelan datos de sistemas dispares.
Existen muchas razones para crear un conjunto de consultas. Un conjunto de
consultas puede ser necesario para crear una dimensión compatible en orígenes de
datos dispares. Puede que se desee comparar el contenido de dos consultas para
determinar si las consultas contienen los mismos datos; esto es común en entornos
de prueba. Puede comparar consultas que devuelven nulos. Puede manejar una
relación hecho a hecho que realmente sea una relación uno a uno. (Si realmente no
es una relación uno a uno, cree una consulta de granularidad múltiple “Consultas
de varios hechos y granularidades” en la página 328).
Un conjunto de consultas puede estar compuesto de dos asuntos de consulta
solamente. Puede crear un conjunto de consultas que combine otros dos conjuntos
de consulta. Un conjunto de consultas puede contener
v Todas las filas de asuntos de consultas (operación de unión).
Por ejemplo, la compañía ha adquirido recientemente otra compañía y se
necesita una lista completa de todos los clientes.
v Solo las filas compartidas entre los asuntos de consulta (operación de
intersección).
Por ejemplo, desea averiguar qué miembros del personal son también directores.
v Solo las filas que existen en el primer asunto de consulta y no en el segundo
asunto de consulta en el conjunto de consultas (operación de excepción).
Por ejemplo, desea resaltar las diferencias entre dónde se han vendido los
productos este año y dónde se vendieron hace diez años.
Capítulo 5. Modelado de metadatos relacionales 89

Los nombres de los elementos en la lista de proyección son, de forma
predeterminada, los elementos asignados al primer asunto de consulta en la
operación de conjunto.
Las relaciones entre dos asuntos de consulta del conjunto de consultas y otros
asuntos de consulta no se incluyen en el conjunto de consultas.
Los informes muestran diferentes resultados en función del operador que se
utiliza. Por ejemplo, existen dos asuntos de consulta con los nombres de varios
empleados.
El primer asunto de consulta contiene estas filas:
Fila Valor
1 Jane
2 John
3 John
4 Michael
5 Michael
El segundo asunto de consulta contiene estas filas:
Fila Valor
1 Jane
2 John
3 John
4 Patrick
Se crea un conjunto de consultas. Se ven resultados diferentes en función del
operador que se utilice.
Operador Resultado Notas
Union Jane, John, Michael, Patrick Se muestran todos los
elementos. Los valores no se
duplican.
Intersect Jane, John Se muestran los elementos
comunes. Los valores no se
duplican.
90 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Operador Resultado Notas
Except Michael Se muestran los elementos
que no son comunes. Los
valores no se duplican.
Union All Jane, Jane, John, John, John,
John, Michael, Michael,
Patrick
Si el segundo asunto de
consulta se listara primero en
el conjunto de consultas, el
resultado sería Patrick.
Se muestran todos los
elementos. Los valores se
duplican.
Intersect All Jane, John, John Se muestran los elementos
comunes. Los valores se
duplican.
Except All Michael, Michael Se muestran los elementos
que no son comunes. Los
valores se duplican.
Pasos para crear un conjunto de consultas
Si el segundo asunto de
consulta se listara primero en
el conjunto de consultas, el
resultado sería Patrick.
Procedimiento
1. Seleccione dos asuntos de consulta que cumplan estos requisitos:
v Los dos asuntos de consulta deben tener el mismo número de columnas.
v Las columnas deben estar en el mismo orden.
v Las columnas deben tener el mismo tipo de datos o similares.
Los tipos de datos no tienen que ser exactamente iguales si el origen de
datos puede convertir automáticamente los del segundo conjunto de
resultados en tipos de datos compatibles con los del primer conjunto de
resultados.
Por ejemplo, un asunto de consulta contiene datos de país y utiliza int como
tipo de datos. Otro asunto de consulta contiene datos de país y utiliza
smallint como tipo de datos. Framework Manager importa estos asuntos de
consulta como int16 y int32 y realiza una operación set.
2. Pulse Acciones, Definir conjunto de consultas.
3. Pulse la pestaña Definición.
4. En el cuadro Nombre, defina un nombre para el conjunto de consultas.
5. Revise los cuadros de Asunto de consulta para que el orden en el que los
asuntos de consulta se muestren en la cláusula Select sea el correcto.
El orden puede ser importante si desea un conjunto determinado de nombres
de columna (alias) que se muestra en solo uno de los asuntos de consulta. Si el
orden no es correcto, cancele este conjunto de consultas y empiece de nuevo.
Capítulo 5. Modelado de metadatos relacionales 91

En las uniones e intersecciones, el orden de los asuntos de consulta no importa.
Puede cambiar el orden y recibir la misma respuesta. En las excepciones, el
orden de los asuntos de consulta no importa.
6. Utilice el cuadro Operador para definir cómo se combinan las filas de los
asuntos de consulta.
Opción Descripción
Union Recupera todas las filas exclusivas de ambos
conjuntos. Los duplicados se eliminan.
Intersect Recupera las filas que comunes de los
asuntos de consulta.
Except Recupera las filas que existen en el primer
asunto de consulta y no en el segundo
asunto de consulta.
7. Para crear una operación Union All, Intersect All o Except All, desmarque la
casilla de verificación Eliminar filas duplicadas.
8. Elija la acción que desee.
Objetivo Acción
Trabajar con los cálculos incluidos en los
asuntos de consulta
Trabajar con los filtros incluidos en los
asuntos de consulta
Pulse la pestaña Cálculos.
Puede añadir o editar los cálculos y cambiar
su orden.
Pulse la pestaña Filtros.
Puede añadir o editar filtros, cambiar su
orden y cambiar el uso de los filtros.
Probar el conjunto de consultas Pulse la pestaña Probar.
9. Pulse Aceptar.
Resultados
También puede estar interesado en los temas siguientes:
v Cálculos incluidos “Creación de cálculos” en la página 150
v Filtros incluidos “Creación de filtros” en la página 152
v Determinantes “Determinantes” en la página 84
v Probar el conjunto de consultas o cambiar los ajustes de la prueba “Prueba de
asuntos de consulta o conjuntos de consultas”
Prueba de asuntos de consulta o conjuntos de consultas
Prueba de objetos
Para ver los resultados que devuelve un objeto, puede probarlo. Puede probar un
objeto al crearlo, o más tarde. Los objetos que se pueden probar son dimensiones,
asuntos de consulta, conjuntos de consulta, jerarquías, niveles, cálculos y elementos
de consulta.
Puede ver los datos que se visualizarán en un informe específico antes de publicar
un paquete seleccionando y probando los objetos que se visualizarán en el informe.
Esto permite depurar fácilmente un modelo y verificar que el modelo cumple los
requisitos de creación de informes, porque no necesita crear y publicar los
paquetes primero.
92 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Al probar un objeto, IBM Cognos Framework Manager devuelve datos de ejemplo.
No se aplica formateo a los datos de ejemplo. Si debe probar formateo, deberá
publicar el paquete y visualizar los objetos en los estudios de IBM Cognos.
Puede ver resultados diferentes según lo que pruebe. Por ejemplo, si utiliza el
editor de expresiones para probar un cálculo incluido en un asunto de consulta,
Framework Manager sólo prueba la expresión, pero no el elemento, de modo que
la configuración de agregación para el elemento de consulta no se aplica en la
prueba. Al probar todo el asunto de consulta, que incluye el cálculo, se obtiene un
resultado diferente, porque sí se aplica la configuración de agregación. Por
ejemplo, si la configuración de agregación es resumir, verá un número menor de
filas en la prueba.
Al probar una dimensión de medida, el SQL usa agregados, no las medidas.
Si prueba un segmento hijo de un modelo segmentado, puede ver un error si un
objeto de los que está probando hace referencia a un objeto de otro segmento hijo y
el objeto al que se hace referencia no está disponible para el proyecto en cuestión.
Compruebe que el modelo padre contiene todos los objetos y que este mensaje de
error no se visualiza al probar el modelo padre.
Los valores del regulador pueden afectar a los resultados de la prueba. Para
obtener más información, consulte: “Reguladores” en la página 304.
Puede cambiar la configuración de prueba existente para personalizar los
resultados que muestra la prueba. Por ejemplo, entre otros valores, puede controlar
el número de filas devueltas.
Pasos para crear o modificar el objeto
Procedimiento
1. Seleccione el objeto que desea probar.
2. Pulse Acciones, Editar definición y, después, pulse la pestaña Probar o
Consulta Información.
El cuadro Resultados de la prueba está vacío hasta que se ejecuta la consulta.
Los conjuntos de resultado que contengan objetos binarios grandes se
mostrarán como [blob].
3. Para ejecutar la consulta y recuperar todos los resultados de la prueba, pulse
Probar muestra.
4. Si desea añadir un recuento de las filas, pulse Total de filas.
5. Si desea aplicar la propiedad Agregado regular del elemento de consulta o la
propiedad Reglas de agregado de una medida semiaditiva referenciada en la
expresión, seleccione la casilla de verificación Suma automática.
Si desmarca esta casilla de verificación, se devuelve una fila para cada fila del
conjunto de resultados de la consulta.
6. Si desea obtener más información sobre los resultados de la consulta, pulse la
pestaña Información de consulta.
7. Pulse Aceptar.
Capítulo 5. Modelado de metadatos relacionales 93

Pasos para ver los datos que se mostrarán en un informe
determinado
Procedimiento
1. Seleccione los objetos que se mostrarán en el informe.
2. Pulse Herramientas, Probar.
3. Para ejecutar la consulta y recuperar todos los resultados de la prueba, pulse
Probar muestra.
4. Si desea ver los detalles de los problemas detectados, pulse la pestaña
Información sobre consultas.
Si no ve los resultados de la consulta en la ventana de prueba, significa que los
datos del origen de datos superan el valor de uno de los reguladores. La
consulta se detiene en el límite especificado, pero la ventana de resultados de
prueba no contiene datos. Sugerencia: Defina todos los reguladores con el valor
cero.
Cambio de los valores de la prueba
Puede personalizar las pruebas cambiando sus valores.
Procedimiento
1. Seleccione el objeto que desee.
2. Pulse Acciones, Editar definición y, después, pulse la pestaña Probar o
Información de consulta.
3. Pulse Opciones, Probar valores.
4. Elija las opciones que desee.
Objetivo Acción Persistencia
Recuperar un parámetro y
mostrar un número
determinado de filas
Seleccione la casilla de
verificación Restringir el
número máximo de filas
que se devolverán y escriba
el numero de filas que desee.
Este valor no mejora el
rendimiento de la
recuperación de datos
cuando se prueban
dimensiones, asuntos de
consulta y conjuntos de
consulta.
Especificar el nivel de detalle Arrastre el control deslizante
del nivel de información
que se muestra en la
información de resultados
hasta el punto que represente
el nivel de detalle que
requiera.
Reemplazar temporalmente
parámetros de sesión
94 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario
En el cuadro Parámetros de
sesión, pulse Definir.
Aparece el cuadro de diálogo
Parámetros de sesión.
Este valor se aplica a todas
las dimensiones, asuntos de
consulta y conjuntos de
consulta del modelo.
Este valor se guarda y se usa
en la siguiente sesión con
cualquier otro modelo.
Este valor se guarda y se usa
en la siguiente sesión con
este modelo.
Los valores de reemplazo no
se guardan con el modelo.
Este valor solo sirve en la
sesión actual.

Objetivo Acción Persistencia
Aplicar filtros de modo de
diseño relevantes
Aplicar un filtro de
seguridad
Seleccione la casilla de
verificación Aplicar todos
los filtros de modo de
diseño durante las pruebas.
Esto aplica todos los filtros
pertinentes cuyo uso se
defina en el modo de diseño
en otra dimensión, asunto de
consulta o conjunto de
consultas.
En el cuadro Filtros de
seguridad, pulse Editar.
Cambiar valores de solicitud En el cuadro Valores de
solicitud actuales, pulse
Solicitudes.
Aparece el cuadro de diálogo
Gestor de solicitudes de
modelos, que muestra todas
las peticiones, y sus valores,
que están en el modelo.
5. Efectúe una doble pulsación en Aceptar.
Resultados
También puede estar interesado en los temas siguientes:
v Definición de reguladores
v Filtros de seguridad
v Reemplazo temporal de parámetros de sesión
v Cambio de valores de solicitud
v Trabajo con dimensiones
v Trabajo con asuntos de consulta
Este valor se guarda y se usa
en la siguiente sesión con
cualquier otro modelo.
Este valor se guarda y se usa
en la siguiente sesión con
este modelo.
Los valores de la solicitud no
se guardan con el modelo.
Este valor solo sirve en la
sesión actual.
Validación de asuntos de consulta
Puede validar la definición de un asunto de consulta sin tener que abrir el cuadro
de diálogo Definición de asunto de consulta. Esto es útil cuando:
v Se han añadido elementos de consulta nuevos a un asunto de consulta
v La definición del asunto de consulta subyacente ha cambiado
v Los parámetros de un procedimiento almacenado han cambiado
Acerca de esta tarea
La información sobre la validación de asuntos de consulta de SAP BW se muestra
en el tema “Validación de asuntos de consulta de modelo (SAP BW)” en la página
215.
Capítulo 5. Modelado de metadatos relacionales 95

El comando Validar objeto realiza una exhaustiva comprobación de todos los
asuntos de consulta y garantiza que se puedan ejecutar.
Lo que ocurra en el proceso de evaluación dependerá del tipo de asunto de
consulta seleccionado.
Tipo de asunto de consulta Proceso de evaluación
Asunto de consulta de orígenes de datos
relacionales
Asunto de consulta de modelo basado en
metadatos relacionales
Asunto de consulta de procedimiento
almacenado
Se envía al origen de datos relacionales una
solicitud basada en los elementos obtenidos.
La lista de referencias de orígenes de datos
se actualiza.
Los atributos físicos, como el tipo de datos,
se actualizan según sea necesario.
Se envía al origen de datos una solicitud
basada en los elementos obtenidos.
Se actualiza el SQL de la memoria caché, si
está disponible.
Los atributos físicos, como el tipo de datos,
se actualizan según sea necesario.
Se envía al origen de datos una solicitud
basada en los últimos parámetros del
procedimiento almacenado.
La lista de elementos de consulta se
actualiza.
También puede actualizar el asunto de consulta “Actualización de asuntos de
consulta” si procede de un origen de datos relacionales o sincronizar todo el
proyecto “Sincronización de proyectos” en la página 301.
Procedimiento
1. Seleccione el asunto de consulta que desee evaluar.
2. Pulse Herramientas, Validar objeto.
Resultados
Si ha cambiado la propiedad Agregado regular con el valor no soportado, la
propiedad se restablecerá cuando se evalúe el asunto de consulta. Si la propiedad
se define con otro valor, esta no se cambia.
Actualización de asuntos de consulta
Si utiliza un origen de datos relacionales, puede optar por actualizar solo los
asuntos de consulta en lugar de realizar una sincronización completa del proyecto.
Debe realizar una sincronización de proyecto para sincronizar los cambios
realizados en otro origen de datos.
El asunto de consulta se actualiza sobre la base de la definición del origen de
datos. Cuando se actualiza el asunto de consulta, los nuevos metadatos se obtienen
del origen de datos y los elementos de consulta se vuelven a sincronizar.
96 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

También puede evaluar el asunto de consulta, si procede de un origen de datos
relacionales “Validación de asuntos de consulta” en la página 95.
No puede utilizar el comando Actualizar objeto para los asuntos de consulta del
modelo.
Procedimiento
1. Seleccione uno ovarios asuntos de consulta.
2. Pulse Herramientas, Actualizar objeto.
Sugerencia: También puede abrir el cuadro de diálogo Definición de asunto de
consulta y pulsar en Aceptar.
Conversión de asuntos de consulta en dimensiones
Puede convertir un asunto de consulta en una dimensión regular o en una
dimensión de medida cuando desee utilizar características asociadas con las
dimensiones, como la definición de jerarquías y niveles. Un asunto de consulta de
modelo se convierte en una dimensión de modelo.
Aunque los asuntos de consulta de orígenes de datos se pueden convertir en
dimensiones de origen de datos, éstas tienen una funcionalidad limitada en
comparación con los asuntos de consulta o dimensiones de modelo. Deje de
utilizar dimensiones de orígenes de datos, regulares y de medida. Cree modelos
según las prácticas recomendadas en Capítulo 9, “Directrices de modelado de
metadatos”, en la página 321 para utilizar los asuntos de consulta como una base
relacional del modelo. Defina dimensiones regulares y de medida como objetos de
modelos basados en asuntos de consulta de orígenes de datos o asuntos de
consulta de modelos. En versiones futuras, se proporcionarán directrices sobre la
migración para usuarios existentes de dimensiones de origen de datos.
Si el asunto de consulta tiene determinantes especificados, las claves que haya
especificado para cada determinante se utilizan para crear una jerarquía con una
clave de empresa para cada nivel. Los determinantes forman una jerarquía. El
primer atributo de cadena de cada determinante se utiliza para el título de la
empresa. Si el título no es el atributo que desea utilizar, debe cambiarlo
manualmente.
Convertir un asunto de consulta en una dimensión es solo un punto de partida.
Examine cada dimensión que se cree de este modo para que refleje sus
necesidades.
También puede convertir una dimensión en un asunto de consulta “Conversión de
dimensiones en asuntos de consulta” en la página 123.
No puede utilizar los determinantes para crear jerarquías separadas para la
dimensión. Debe crear las jerarquías separadas para la dimensión después de
convertir el asunto de consulta.
No puede convertir las dimensiones siguientes:
v Conjuntos de consultas
v Asuntos de consulta de procedimiento almacenado
v Asuntos de consulta SAP BW
Procedimiento
1. Seleccione los asuntos de consulta que desee convertir.
Capítulo 5. Modelado de metadatos relacionales 97

2. Pulse Acciones, Convertir en dimensión regular o Convertir en dimensión de
medida.
Conversión de asuntos de consulta de modelo en asuntos de
consulta de orígenes de datos
Puede convertir un asunto de consulta de modelo en un asunto de consulta de
orígenes de datos si desea editar el SQL.
No convierta el asunto de consulta de modelo si desea hacer referencia a varios
orígenes de datos.
Procedimiento
1. seleccione el asunto de consulta de modelo que desea convertir.
2. Pulse Acciones, Convert en asunto de consulta de orígenes de datos.
Este comando solo está disponible si ha ejecutado una consulta y la pestaña
Información de consulta del cuadro de diálogo Editar definición contiene
SQL.
Edición de SQL
SQL es el lenguaje estándar del sector para crear, actualizar y consultar sistemas de
gestión de bases de datos relacionales.
Cuando se edita una definición de un asunto de consulta de orígenes de datos
relacionales, se pueden usar
v “Cognos SQL” en la página 101
v “SQL nativo” en la página 102
v “SQL pass-through” en la página 103
Acerca de esta tarea
Si desea editar el SQL de un asunto de consulta de modelo, deberá copiar el SQL
para el asunto de consulta de modelo de la pestaña Información de consulta y
pegarlo en un asunto de consulta de orígenes de datos nuevo. También puede
convertir el asunto de consulta de modelo en un asunto de consulta de orígenes de
datos. No edite el SQL si desea que el asunto de consulta de modelo haga
referencia a varios orígenes de datos. Consulte: “Conversión de asuntos de
consulta de modelo en asuntos de consulta de orígenes de datos”.
Si cambia el alias de una columna, se volverá a generar el elemento de consulta
que representa dicha columna. Cualquier modificación que se realice en el
elemento de consulta no se conservará porque IBM Cognos Framework Manager lo
considerará como un nuevo elemento de consulta.
Puede añadir comentarios al SQL con /* antes del comentario y */ al final.
A continuación se incluye un ejemplo:
select country /* this is a multiline
comment
another line
another line
*/
98 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Procedimiento
1. Pulse el asunto de consulta de orígenes de datos que desea cambiar.
2. Pulse Acciones, Editar definición.
3. Pulse la pestaña SQL y arrastre los objetos al cuadro SQL o escriba el SQL que
desee.
4. Pulse Aceptar.
Cambio del tipo de SQL
Al seleccionar el tipo de SQL en el que desea generar un asunto de consulta de
orígenes de datos, debe sopesar los factores siguientes y decidir sus prioridades.
Tipo Ventaja Desventaja
Cognos SQL El SQL de Cognos mejora el
rendimiento del asunto de
consulta; por ejemplo,
eliminando los elementos no
utilizados en el momento de
la consulta.
El SQL funciona en todas las
bases de datos soportadas.
SQL nativo El rendimiento se optimiza
en todos los asuntos de
consulta relacionados.
Puede utilizar el SQL que sea
específico para su base de
datos.
SQL de paso Puede especificar cualquier
SQL soportado por la base
de datos.
No se puede especificar SQL
no estándar.
No puede utilizar SQL que el
origen de datos no soporte
para las subconsultas.
Es posible que el SQL no
funcione en un tipo de base
de datos diferente.
No se permite a Framework
Manager que optimice
automáticamente el
rendimiento.
Es posible que el SQL no
funcione en un origen de
datos diferente.
Requisitos para cambiar a SQL nativo
Si cambia un asunto de consulta a SQL nativo, primero debe asegurarse de que el
SQL refleje las reglas aplicables al origen de datos nativo de modo que la consulta
pueda ejecutarse correctamente.
Debe realizar las acciones siguientes:
v Edite los nombres de tabla existentes.
El SQL de Cognos utiliza una estructura de dos partes para nombrar a los
asuntos de consulta. Por ejemplo, [gosales].[ProductLine] significa que el
asunto de consulta ProductLine procede de la base de datos gosales. Por lo
tanto, cuando cambie a SQL nativo, debe asegurarse de que todos los nombres
de tabla incluyan los elementos padre que necesita el proveedor del origen de
datos.
Capítulo 5. Modelado de metadatos relacionales 99

Para obtener información sobre los convenios de denominación, consulte:
“Convenciones de nomenclatura para objetos en un proyecto” en la página 24.
v Compruebe que el SQL sea válido para las subconsultas.
IBM Cognos Framework Manager procesa los asuntos de consulta de SQL nativo
como subconsultas. Por ejemplo, vea este asunto de consulta SQL de Cognos:
Select
P.ProductName, P.Margin From Product P
Si lo cambia a SQL nativo, Framework Manager genera la sentencia siguiente:
Select
oracle_plain.ProductName as Productname,
oracle_plain.Margin as Margin
From
(GOSALES1_OR_92_WE...SELECT
P.PRODUCTNAME, P.MARGIN
FROM
PRODUCT P}
)oracle_plain
Por lo tanto, debe asegurarse de que el asunto de consulta cumpla las
restricciones adicionales de la base de datos que se imponen a las subconsultas,
como no utilizar la cláusula With. El SQL pass-through no tiene las mismas
restricciones. No obstante, el hecho de que el SQL nativo se procese como parte
de una consulta mayor mejora su rendimiento.
Para probar el SQL nativo utilizando una herramienta de consulta, como
SQL*Plus de Oracle, debe colocar el SQL en la cláusula From de una sentencia
Select. Por ejemplo, puede utilizar la sintaxis siguiente en una herramienta de
consulta:
Select * from () T1
v Asigne alias a las columnas obtenidas.
Asigne alias a todas las columnas con valores calculados. A continuación se
incluye un ejemplo:
SELECT
Length(Country) as LGTH
FROM Country
v Incluya los alias entre comillas dobles.
Al cambiar el tipo de SQL de un asunto de consulta, se puede cambiar las
mayúsculas y minúsculas de los alias. Si esto ocurre, los asuntos de consulta que
hagan referencia a los elementos de consulta cambiados dejarán de ser válidos.
Para que estos cambios de mayúsculas y minúsculas no se produzcan, debe
incluir los alias entre comillas dobles, como
Select
COUNTRY as "test" from COUNTRY
v Si un asunto de consulta de orígenes de datos contiene una macro en la lista de
proyección (cláusula Select) de la sentencia SQL, especifique un alias en el SQL
que coincida con la propiedad Nombre de columna del elemento de consulta.
Podría producirse un error porque la macro evalúa sobre un nombre de columna
diferente del de la propiedad Nombre de columna del elemento de consulta
correspondiente. El resultado es que el sistema no puede localizar el elemento en
la lista de proyección. Las listas de proyección son estáticas.
La asignación de un alias sirve para que el nombre del elemento de la lista de
proyección no varíe, como consecuencia de la evaluación del cambio de la
macro.
100 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Por ejemplo, la consulta siguiente contiene un parámetro de sesión, runLocale,
cuyo valor especifica la columna que recupera la consulta:
Select
#$ColumnMap{$runLocale}# as
CountryNameAlias
From
[GoSales].Country
Tenga en cuenta que el signo de almohadilla (#) está reservado para macros.
Framework Manager elimina todo lo que esté fuera de los signos de almohadilla
al ejecutar la macro.
Procedimiento
1. Pulse el asunto de consulta que desea cambiar.
2. Pulse Acciones, Editar definición y, después, pulse la pestaña Información de
consulta.
El cuadro Resultados de la prueba está vacío hasta que se ejecuta la consulta.
3. Pulse Opciones, Valores SQL.
4. Con la lista Tipo de SQL, cambie el tipo de SQL.
Si cambia el tipo por SQL nativo, consulte la lista de comprobación anterior
para asegurarse de que el SQL refleje las reglas aplicables al origen de datos
nativo.
5. Pulse Aceptar.
6. Si desea ver el SQL, pulse Probar muestra.
7. Si desea ver la consulta actual, pulse Consulta.
8. Si desea ver el xml que utiliza IBM Cognos BI, pulse Respuesta.
9. Pulse Aceptar.
Cognos SQL
De forma predeterminada, IBM Cognos Framework Manager utiliza Cognos SQL
para crear y editar asuntos de consulta. Cognos SQL cumple con los estándares de
SQL y funciona con todos los orígenes de datos relacionales y tabulares.
Framework Manager genera el SQL más optimizado posible. Por lo tanto, Cognos
SQL es preferible.
Debido a que los asuntos de consulta en Framework Manager son similares a las
vistas de bases de datos, el SQL para cada asunto de consulta debe ser conforme a
los estándares de SQL que se aplican a las vistas. Por ejemplo, deben asignarse
alias a cualquier columna que esté vacía o cuyo nombre no sea exclusivo. Este
nivel de conformidad significa que Cognos SQL se comporta más coherentemente
que el SQL específico de proveedor, que no se ajusta a los estándares de SQL.
En general, es preferible utilizar Cognos SQL porque se pueden crear asuntos de
consulta que
v Pueden contener metadatos de varios orígenes de datos.
v Tienen menos restricciones de bases de datos.
v Interactúan más eficazmente con aplicaciones IBM Cognos.
Construcciones del estándar SQL:
Si el origen de datos lo soporta, puede usar la cláusula With con Cognos SQL. La
cláusula With sirve para generar SQL más legible y permitir que el origen de datos
genere un plan más óptimo para la recuperación de datos. El origen de datos
Capítulo 5. Modelado de metadatos relacionales 101

puede detectar más fácilmente los casos en los que las mismas tablas deben
escanearse y entonces puede resolverlas como una vista en línea o tabla temporal.
De forma predeterminada, IBM Cognos Framework Manager usa las
construcciones de tabla comunes del estándar SQL cuando está definido el
regulador Utilizar cláusula WITH al generar SQL.
Utilice la cláusula With para obtener un mejor rendimiento de las consultas si la
solicitud está limitada por la funcionalidad soportada por el software de origen de
datos subyacente. Cuando una consulta usa funcionalidad que no está soportada
por el origen de datos, el uso de la cláusula With puede producir una
descomposición adicional de la consulta, que puede ocasionar una disminución del
rendimiento. En tal caso, si no se usa la cláusula With se puede generar un
conjunto de consultas mejor para el origen de datos subyacente.
A continuación, se muestra un ejemplo de SQL de Cognos con tablas derivadas:
SELECT * FROM
(SELECT SNO C1, AVG(QTY) C2, COUNT(*) C3 FROM
SUPPLY
GROUP BY SNO) T1,
(SELECT MAX(QTY) C1 FROM SUPPLY) T2
A continuación, se muestra cómo SQL de Cognos convierte el ejemplo anterior en
una cláusula With:
WITH T1 AS (SELECT SNO C1, AVG(QTY) C2, COUNT(*)
C3 FROM
SUPPLY GROUP BY SNO),
T2 AS (SELECT MAX(QTY) C1 FROM SUPPLY)
SELECT *FROM T1, T2
No utilice la cláusula With en el procesamientorecursivo.
Para obtener más información sobre la cláusula With, consulte: “Reguladores” en la
página 304.
La comprobación del tipo de datos y la validación de SQL se mejoran
continuamente. Por este motivo y porque no todos los proveedores son totalmente
compatibles con el estándar SQL, no se pasarán expresiones de SQL ambiguas o no
válidas que anteriormente se pasaban a los orígenes de datos. Si tiene una
expresión que devuelve un tipo de datos no especificado por el estándar SQL, pase
la expresión al origen de datos utilizando la sintaxis {expr}. Sus usuarios deben
usar la misma técnica.
SQL nativo
SQL nativo es el SQL que utiliza el origen de datos, como Oracle SQL. Use SQL
nativo para pasar la sentencia SQL que especifique a la base de datos. IBM Cognos
BI puede añadir sentencias a lo especificado por el usuario. No puede utilizar SQL
nativo en un asunto de consulta que haga referencia a más de un origen de datos
en el proyecto.
El SQL especificado en IBM Cognos Framework Manager y procesado por la base
de datos, ya sea nativo o pass-through, debe estar completamente autocontenido.
No debe hacer referencia a nada fuera del mismo SQL, como solicitudes de base de
datos, variables o formateo nativo que normalmente proporcionaría la aplicación
de llamada.
102 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Si le resulta cómodo trabajar con una versión de SQL nativo, tal vez quiera
utilizarlo para asuntos de consulta basados en un origen de datos único. De este
modo, puede utilizar palabras clave que no están disponibles en Cognos SQL, y
copiar y pegar SQL de otra aplicación a Framework Manager.
Al generar la consulta, Framework Manager combina el SQL de cada asunto de
consulta que utiliza una conexión de origen de datos determinada en una única
consulta. Esto ayuda a mejorar el rendimiento de la consulta. No obstante, dado
que el SQL se genera como una serie de subconsultas, las consultas de SQL nativo
deben respetar las posibles restricciones impuestas por el distribuidor de base de
datos en tablas derivadas.
A continuación se muestra un ejemplo de SQL nativo que devuelve una lista de
empleados y directivos:
SELECT
lpad(’ ’, (level-1)* 4) ename
EMP_CHART,
level, empno, ename, job, mgr
FROM
emp
CONNECT BY PRIOR
empno = mgr
AND
deptno not in (20,30)
START WITH
mgr IS NULL
ORDER BY
level, job
SQL pass-through
Utilice SQL pass-through cuando la sentencia SQL que especifique no sea válida
dentro de una tabla derivada. SQL pass-through permite utilizar SQL nativo sin
ninguna de las restricciones que el origen de datos impone en las subconsultas.
Esto es porque los asuntos de consulta SQL pass-through no se procesan como
subconsultas, sino que el SQL para cada asunto de consulta se envía directamente
al origen de datos donde se generan los resultados de la consulta.
Cada asunto de consulta se envía al origen de datos como una sentencia separada
en vez de optimizarse por parte de IBM Cognos Framework Manager, por lo que
el rendimiento es más lento. Por consiguiente, al elegir entre SQL nativo y SQL
pass-through, debe decidir qué es más importante: el rendimiento o utilizar SQL
no permitido en una subconsulta.
En general, sólo debe utilizar SQL pass-through si tiene que crear un asunto de
consulta que contenga construcciones específicas para un origen de datos y que no
se puedan utilizar dentro de una tabla derivada, como en una cláusula With o
OrderBy.
El SQL especificado en Framework Manager y procesado por la base de datos, ya
sea nativo o pass-through, debe estar completamente autocontenido. No debe hacer
referencia a nada fuera del mismo SQL, como solicitudes de base de datos,
variables o formateo nativo que normalmente proporcionaría la aplicación de
llamada.
Capítulo 5. Modelado de metadatos relacionales 103

Por ejemplo, este informe orientado a sistemas contiene la fecha del sistema:
SELECT
TO_CHAR(SYSDATE, ’DAY, DDTH MONTH YYYY’)
FROM
SYS.DUAL
Tenga en cuenta que el signo de almohadilla (#) está reservado para macros y que
los nombres de columna deben ser exclusivos. Framework Manager elimina todo
lo que esté fuera de los signos de almohadilla al ejecutar la macro.
Cambio del modo de generar SQL
Puede especificar cómo IBM Cognos Framework Manager genera el SQL que
recupera los datos de los orígenes de datos relacionales para los asuntos de
consulta de orígenes de datos o asuntos de consulta de modelo.
El tipo de generación de SQL de un asunto de consulta puede definirse como
Como vista o Minimizado. El valor predeterminado es Minimizado.
Cuando el valor del tipo de generación es Minimizado, el SQL generado solo
contiene el conjunto mínimo de tablas y uniones necesario para obtener los valores
para los elementos de consulta seleccionados.
Cuando el tipo de generación tiene el valor Como vista, Framework Manager
genera consultas que contienen toda la sentencia SQL que definía el asunto de
consulta. Utilice Como vista cuando desee que la consulta se ejecute como un
bloque. El SQL se tratará como una vista. Por ejemplo, si desea que la consulta
devuelva el mismo número de filas cada vez que se ejecute.
El uso de SQL minimizado mejora el rendimiento y, en consecuencia, la consulta se
ejecuta significativamente más rápido. Generar SQL minimizado es especialmente
ventajoso para los asuntos de consulta que representan tablas de dimensiones. Al
usar un único asunto de consulta de modelo para modelar una dimensión, puede
beneficiarse de consultas SQL pequeñas que se ejecutan mucho más rápido.
Por ejemplo, el tipo de generación de SQL del siguiente asunto de consulta es
Como vista. Observe que este asunto de consulta contiene una sentencia Select
anidada.
select
New_Query_Subject.COUNTRYCODE as COUNTRYCODE,
New_Query_Subject.EUROINUSESINCE as EUROINUSESINCE
from
(select
CONVERSIONRATE.COUNTRYCODE as COUNTRYCODE, COUNTRY.EUROINUSESINCE as EUROINUSESINCE
from
"2 - GOSales1 - OLE-DB".GOSALES1.dbo.CONVERSIONRATE CONVERSIONRATE,
"2 - GOSales1 - OLE-DB".GOSALES1.dbo.COUNTRY COUNTRY
where
(COUNTRY.SALESCOUNTRYCODE = CONVERSIONRATE.COUNTRYCODE)
) New_Query_Subject
Si cambia el tipo de generación de SQL por Minimizado, Framework Manager
genera el siguiente SQL minimizado:
select
CONVERSIONRATE.COUNTRYCODE as COUNTRYCODE,
COUNTRY.EUROINUSESINCE as EUROINUSESINCE
from
"2 - GOSales1 - OLE-DB".GOSALES1.dbo.CONVERSIONRATE CONVERSIONRATE,
104 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Dimensiones
"2 - GOSales1 - OLE-DB".GOSALES1.dbo.COUNTRY COUNTRY
where
(COUNTRY.SALESCOUNTRYCODE = CONVERSIONRATE.COUNTRYCODE)
EL SQL minimizado funciona mejor cuando los conjuntos de resultado devueltos
de cada elemento de consulta son equivalentes. Si en una columna hay registros
que no se corresponden con los registros de otra columna, el resultado de la
consulta minimizada produce unas filas adicionales. Puede evitar este hecho
definiendo el tipo de generación de SQL como Como vista.
Por ejemplo, si hay tipos de productos que no utiliza ninguno de los productos y
todos estos tipos de productos tienen una línea de producto común, se notifica una
línea de producto para la que haya tipos de productos, pero para la que no haya
productos relacionados.
Procedimiento
1. Pulse el asunto de consulta que desea cambiar.
2. Pulse Acciones, Editar definición y, después, pulse la pestaña Información de
consulta.
El cuadro Resultados de la prueba está vacío hasta que se ejecuta la consulta.
3. Pulse Opciones, Valores SQL.
4. Defina Generar SQL como Como vista o Minimizado.
5. Pulse Aceptar.
6. Si desea ver el SQL, pulse Probar muestra.
7. Si desea ver la consulta actual, pulse Consulta.
8. Si desea ver el xml que utiliza IBM Cognos BI, pulse Respuesta.
9. Pulse Aceptar.
Asuntos de consulta de modelo y tipos de SQL
Un asunto de consulta de modelo basado en otro asunto de consulta de modelo
puede utilizar la lógica del asunto de consulta padre en lugar de su propia lógica.
Si el asunto de consulta de modelo hijo utiliza el tipo de SQL Minimizado, no
utiliza la lógica del padre. Si el asunto de consulta de modelo hijo utiliza el tipo de
SQL Como vista, utiliza la lógica del padre.
Pongamos por caso que crea un asunto de consulta de modelo denominado
Productos devueltos, que muestra todos los motivos de devolución de todos los
productos. Al ejecutar Productos devueltos, verá una lista de más de 700
elementos. Entonces crea otro asunto de consulta de modelo basado en Productos
devueltos que se llama Motivos de devolución. Este asunto de consulta de modelo
sólo contiene el elemento de consulta Motivo de devolución. Si el tipo de SQL está
establecido en Minimizado, el asunto de consulta Motivos de devolución muestra
cinco motivos de devolución cuando se ejecuta. Si el tipo de SQL está establecido
en Como vista, el asunto de consulta Motivos de devolución utiliza la lógica del
asunto de consulta Productos devueltos y muestra más de 700 elementos.
Una dimensión es una amplia agrupación de datos acerca de un aspecto
importante de una empresa, como productos, fechas o mercados.
Los tipos de dimensiones con los que puede trabajar en IBM Cognos Framework
Manager son dimensiones regulares y dimensiones de medida. En SAP BW, las
dimensiones de medida se conocen como cifras clave.
Capítulo 5. Modelado de metadatos relacionales 105

Por ejemplo, en un proyecto para análisis de ventas, incluye estas dimensiones:
Nombre Tipo Descripción
Tiempo Dimensión regular Fechas de ventas organizadas
en años, trimestres, meses,
semanas y días en los que se
realizaron las ventas.
Region Dimensión regular Ubicaciones de las ventas
agrupadas en regiones de
ventas, países y ciudades.
Product Dimensión regular Detalles del producto
organizados por tipo de
producto, marca, modelo,
color y empaquetado.
Cliente Dimensión regular Información sobre el cliente.
Sales Dimensión de medida Detalles de la compra como
unidades vendidas, ingresos
y beneficios.
Debe utilizar dimensiones regulares y de medida para habilitar análisis en el
origen de datos relacionales. En la mayoría de los orígenes de datos, es probable
que las dimensiones de medida estén compartidas por más de una dimensión
regular. Las dimensiones regulares a menudo se denominan dimensiones
compartidas. Una dimensión de medida y dimensiones regulares organizadas en
un clúster se suele denominar grupo de esquema en estrella, aunque también
puede denominarse grupo de área temática o funcional.
También puede interesarle este tema: “Asuntos de consulta frente a dimensiones”
en la página 334.
Orígenes de datos normalizados
Los orígenes de datos normalizados o en copo de nieve tienen con frecuencia
varias tablas que describen un único concepto empresarial. Por ejemplo, una
representación normalizada de Product puede incluir cuatro tablas relacionadas
mediante relaciones 1..n. Cada Product Line tiene uno o varios Product Types.
Cada Product Type tiene uno o varios Products. Los Products tienen nombres y
descripciones en varios idiomas por lo que existen en la tabla de consulta Product
Multilingual.
106 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Una manera de simplificar el modelo es crear un asunto de consulta de modelo
para cada concepto descriptivo empresarial. Es posible que los usuarios no
conozcan la relación entre los asuntos de consulta individuales por lo que es útil
agruparlos; además, al tener que expandir cada objeto de modelo y seleccionar un
elemento de consulta se necesita más esfuerzo.
El paso siguiente del análisis es crear una dimensión regular con un nivel para
cada asunto de consulta.
Creación de dimensiones regulares
Una dimensión regular contiene información clave de la empresa y descriptiva que
organiza en una jerarquía, desde el nivel más alto de granularidad al más bajo.
Normalmente tiene varios niveles y cada uno de ellos necesita una clave y un
título. Si no tiene una única clave para su nivel, se recomienda crear una en un
cálculo.
Las dimensiones regulares de modelo se basan en un origen de datos o en asuntos
de consulta de modelo que ya se han definido en el modelo. Se debe definir una
clave de empresa y un título de tipo de cadena para cada nivel. Al verificar el
modelo, se detecta la ausencia de la información de claves de empresa e título. En
lugar de unir dimensiones regulares de modelo a dimensiones de medida, cree
uniones en los asuntos de consulta subyacentes y cree una relación de ámbito entre
la dimensión regular y la dimensión de medida.
Cuando cree dimensiones regulares, debe comprender la dimensionalidad de los
datos. Debe poder responder a las preguntas siguientes:
v ¿Cuáles son los niveles de la dimensión?
v ¿Cuál es el orden y la combinación de niveles que forman jerarquías?
v ¿Cuáles son las relaciones entre los niveles?
v ¿Qué identifica exclusivamente un nivel?
v ¿Qué elementos de datos están asociados en cada nivel?
v ¿Dispone de más de un nivel de granularidad, como que algunos datos se
registren mensualmente y otros diariamente?
v ¿Se han definido claves foráneas en el origen de datos?
Puede especificar varias jerarquías en dimensiones regulares en IBM Cognos
Framework Manager. Varias jerarquías para una dimensión regular se comportan
Capítulo 5. Modelado de metadatos relacionales 107

como vistas de la misma consulta. Sin embargo, solo puede utilizar una jerarquía
cada vez en una consulta. Por ejemplo, no puede utilizar una jerarquía en las filas
de un informe de tabla de referencias cruzadas y otra jerarquía de la misma
dimensión en las columnas. Si necesita ambas jerarquías en el mismo informe, debe
crear dos dimensiones, una para cada jerarquía. Para obtener más información,
consulte: “Modelado de dimensiones con varias jerarquías” en la página 351.
Además de crear dimensiones regulares, también puede combinar dimensiones en
una única dimensión o convertir asuntos de consulta en dimensiones.
La consulta de varios hechos está habilitada con dimensiones compatibles.
Aunque puede utilizar dimensiones de origen de datos, tienen una funcionalidad
limitada en comparación con las dimensiones de modelo o asuntos de consulta.
Deje de utilizar dimensiones de orígenes de datos, regulares y de medida. Cree
modelos según las prácticas recomendadas en Capítulo 9, “Directrices de modelado
de metadatos”, en la página 321 para utilizar los asuntos de consulta como una
base relacional del modelo. Defina dimensiones regulares y de medida como
objetos de modelos basados en asuntos de consulta de orígenes de datos o asuntos
de consulta de modelos. En versiones futuras, se proporcionarán directrices sobre
la migración para usuarios existentes de dimensiones de origen de datos.
Pasos para crear una dimensión regular
Procedimiento
1. Seleccione un espacio de nombres o una carpeta donde colocar la dimensión.
2. Pulse Acciones, Crear, Dimensión regular y en la pestaña Dimensión.
3. Pulse Añadir jerarquía y, después, arrastre uno o varios objetos desde el
cuadro Elementos disponibles al cuadro Jerarquías.
Puede definir varias jerarquías para una dimensión. La primera jerarquía se
utiliza como jerarquía predeterminada o principal.
Puede crear una jerarquía alternativa copiando un nivel. Pulse un nivel y
arrástrelo al borde derecho de la dimensión. Dentro de la misma dimensión,
solo puede copiar un nivel.
4. Pulse Añadir nivel y, después, arrastre uno o varios objetos desde el cuadro
Elementos disponibles al nuevo nivel.
Asimismo, puede crear copias de los niveles en el cuadro de diálogo
Definición de dimensión o en la pestaña Mapa de dimensiones. Pulse el nivel
y arrástrelo a otra posición en la jerarquía. Se copiarán también todos los
atributos del nivel. Dentro de la misma dimensión, solo puede copiar un nivel.
5. Si desea utilizar otro elemento de un nivel, arrástrelo desde el cuadro
Elementos disponibles al cuadro Seleccione un nivel del control de jerarquías
para ver los elementos de consulta.
Se le solicitará que especifique su rol.
De forma predeterminada, Framework Manager añade el nombre del espacio
de nombres.
Sugerencia: Para tener una clave compuesta de varias partes, como el nombre
y el apellido, cree un atributo que combine los elementos y, después,
especifique que el atributo nuevo es una clave de empresa.
6. Si desea indicar que las claves de los niveles superiores al nivel actual no son
necesarias para identificar los miembros de este nivel, seleccione el elemento y
marque la casilla de verificación Nivel exclusivo. Esto indica que los valores
clave que pertenecen al nivel deben considerarse exclusivos con independencia
108 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

del contexto. En algunos casos, el valor Nivel exclusivo se utiliza en el
software de IBM Cognos para optimizar las consultas.
Nota: La casilla de verificación Nivel exclusivo no afecta a la generación y
tratamiento de los identificadores MUN para los miembros de este nivel. Todos
los MUN tienen nombres completos.
7. Elija las tareas adicionales que desea realizar:
v Especificar roles “Roles” en la página 115.
v Incluir cálculos pulsando en Añadir y definiendo la expresión “Creación de
cálculos” en la página 150.
Para cambiar un cálculo que se ha incluido en la dimensión, en la pestaña
Mapa de dimensiones, pulse Atributos, pulse con el botón derecho en el
elemento de consulta y pulse Editar expresión.
v Incluir filtros “Creación de filtros” en la página 152.
v Especificar las características de ordenación de niveles “Ordenación de
miembros de un nivel” en la página 113.
v Probar la dimensión “Prueba de dimensiones” en la página 120.
v Editar el SQL y cambiar las diversas opciones “Cognos SQL” en la página
101.
8. Pulse Aceptar.
9. Para cambiar la jerarquía predeterminada por una dimensión con varias
jerarquías, realice lo siguiente:
v En el panel Propiedades, pulse el botón de puntos suspensivos (...) en el
cuadro Jerarquía predeterminada.
v Seleccione una jerarquía y pulse Aceptar.
Resultados
También puede utilizar la pestaña Mapa de dimensiones para crear una dimensión
regular. Pulse el botón de dimensión regular .
Jerarquías de dimensiones regulares
Una jerarquía es una lista ordenada de niveles o una colección de elementos. Cada
elemento de consulta de una jerarquía debe tener un nombre exclusivo.
Puede especificar varias jerarquías en dimensiones regulares en IBM Cognos
Framework Manager. Varias jerarquías para una dimensión regular se comportan
como vistas de la misma consulta. La primera jerarquía es la jerarquía principal o
predeterminada.
Solo se puede utilizar una jerarquía cada vez en una consulta. Por ejemplo, no
puede utilizar una jerarquía en las filas de un informe de tabla de referencias
cruzadas y otra jerarquía de la misma dimensión en las columnas. Si necesita
ambas jerarquías en el mismo informe, debe crear dos dimensiones, una para cada
jerarquía. Para obtener más información, consulte: “Modelado de dimensiones con
varias jerarquías” en la página 351.
Por ejemplo, el personal de ventas (Sales Staff) puede verse por director (Manager)
o por sucursal de ventas (Sales Branch) y puede modelarse como una única
dimensión con dos jerarquías.
Capítulo 5. Modelado de metadatos relacionales 109

Si necesita las dos jerarquías en la misma consulta de informe, como en ejes
opuestos, deberá crear una dimensión regular para cada jerarquía. Por ejemplo,
aquí el personal de ventas se presenta como dos dimensiones.
Sugerencia: Para cambiar la jerarquía predeterminada por una dimensión con
varias jerarquías, en el panel Propiedades pulse el botón de puntos suspensivos
(...) en el cuadro Jerarquía predeterminada y seleccione otra jerarquía.
Si una jerarquía de una dimensión contiene muchos miembros, ejecutar una
consulta en uno de los estudios de IBM Cognos puede resultar lento porque el
motor de IBM Cognos genera una gran consulta para un cubo construido
localmente. Para solucionar este problema, asigne el valor true a la propiedad
Árbol de miembros amplio en el panel Propiedades. El motor generará varias
consultas más pequeñas para el cubo construido localmente.
Jerarquía equilibrada:
Todas las rutas de una jerarquía equilibrada descienden hasta la misma
profundidad.
Por ejemplo, en el diagrama siguiente, el nivel más alto es Línea de producto
(nivel 1), el nivel 2 es Tipo de producto y el nivel 3 es Productos.
110 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Jerarquía desequilibrada:
Las ramas de una jerarquía desequilibrada descienden varios niveles.
Por ejemplo, en el diagrama siguiente, el nivel más alto de una organización es
Director general (nivel 1), el nivel 2 es Vicepresidente y el asistente ejecutivo del
Director general. El asistente ejecutivo no tiene subordinados a diferencia de los
vicepresidentes.
Una jerarquía desequilibrada también puede ser irregular. En una jerarquía
desequilibrada irregular, hay espacios en los niveles y los niveles descienden varias
profundidades.
Jerarquías irregulares y de red:
Para metadatos relacionales, aplane las jerarquías irregulares y las jerarquías de red
en el origen de datos.
Capítulo 5. Modelado de metadatos relacionales 111

Niveles para dimensiones regulares
La definición más sencilla de un nivel consta de una clave de empresa y un título,
donde cada uno de estos elementos hace referencia a un elemento de consulta. Una
instancia (o fila) de un nivel se define como miembro de ese nivel. Se identifica por
un nombre exclusivo de miembro, que contiene los valores de las claves de
empresa de los niveles actual y superior. Por ejemplo,
[gosales].[Products].[ProductsOrg].[Product]->[All Products].[1].[1].[2]
identifica un miembro que se encuentra en el cuarto nivel, Product, de la jerarquía
ProductsOrg de la dimensión [Products] que se encuentra en el espacio de
nombres [gosales]. El título para este producto es TrailChef Canteen, que es el
nombre que aparece en el árbol de metadatos y en el informe.
El primer nivel de la jerarquía se define automáticamente como nivel Todo.
Contiene un único miembro raíz, que representa el nivel superior de la jerarquía.
Por ejemplo, el nivel Todo para la dimensión de tiempo se llama Tiempo (Todos).
No se puede suprimir ni mover el nivel Todo. Sí se puede cambiar el nombre, la
descripción y la sugerencia.
Si no especifica los niveles de la jerarquía correctamente, se podrían producir
agregaciones incorrectas.
Nombres exclusivos de miembro:
El nombre exclusivo de miembro (MUN) es cómo se encuentra el miembro en el
origen de datos, similar al uso de claves de empresa para buscar registros en una
tabla.
El nombre exclusivo de miembro se utiliza en la expresión para un elemento de
datos de miembro que se usa en un informe, una referencia a miembros en filtros y
expresiones, y también se utiliza en el acceso a los detalles entre orígenes de datos
OLAP. Las claves de miembro en el MUN para los diferentes orígenes de datos
OLAP deben coincidir.
Si un nombre exclusivo de miembro cambia, ya no se podrán encontrar los
miembros a los que se haga referencia directamente en expresiones, filtros o
informes, porque el MUN se incluye en la especificación de informe. Los nombres
exclusivos de miembro pueden cambiar por diversas razones:
v Cambios en las estructuras de nivel y jerarquía pueden cambiar el nombre
exclusivo de nivel.
v Los valores de clave de empresa han cambiado y esto ha cambiado la ruta de
clave del miembro.
v La aplicación ha cambiado durante el diseño o con el tiempo.
v El cubo tiene códigos de categoría que son únicos de forma impredecible.
v El entorno de producción tiene más miembros que el entorno de prueba.
v El miembro ya no existe en el origen de datos.
Para evitar estos problemas, siga estas prácticas recomendadas:
v Utilice códigos y claves únicos en una dimensión para las claves de miembro.
v Utilice valores únicos compatibles para dimensiones similares entre los entornos
de origen y de destino al habilitar la función de acceso a detalles.
v Al utilizar un modelo relacional modelado dimensionalmente para el acceso a
detalles, asegúrese de que la clave de empresa raíz se ajusta a los miembros raíz
de los otros orígenes de datos.
112 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

v Asegúrese de que las claves de empresa y la estructura de metadatos de
dimensión son las mismas en los entornos de producción y de prueba.
v No cambie las claves de empresa en IBM Cognos Framework Manager después
de pasar a producción.
v Resuelva las claves que no sean únicas dentro de una dimensión en el origen de
datos. No utilice tildes en los códigos de categoría.
v Si tiene un cubo de Transformer construido con valores de origen que no son
únicos, no utilice la característica de limpieza (Clean House) en Transformer, ya
que probablemente cambiará los códigos de categoría. Guarde una copia de
seguridad del archivo MDL.
Claves para niveles:
Una clave es un elemento de consulta que identifica de forma única miembros en
un nivel. Por ejemplo, Número de producto identifica un producto de forma única,
mientras que, para identificar de forma única una ciudad, se necesitan Ciudad,
Estado y País. La clave puede estar o no contenida en un nivel. Las claves foráneas
se utilizan para relacionar la dimensión de medida con sus dimensiones regulares.
Cada nivel necesita un elemento, definido como una clave.
Si una dimensión de modelo contiene un elemento de consulta cuyo tipo de datos
es BLOB, cree un asunto de consulta con determinantes y luego cree una dimensión
de modelo basada en el asunto de consulta de modelo.
Ordenación de miembros de un nivel
Para metadatos relacionales modelados dimensionalmente, puede especificar
características de ordenación en una dimensión. También puede especificar la
ordenación en niveles individuales dentro de la dimensión. Al ordenar niveles
determinados de una dimensión, se puede garantizar que el orden en que se
proporcionan los datos al modelo es el correcto. El orden en que los datos se
proporcionan al modelo puede ser especialmente importante cuando se informa
sobre los datos de determinados períodos.
El orden de clasificación predeterminado es el alfabético, en orden ascendente,
según el título del nivel. Cuando se especifica un orden de clasificación, los datos
se almacenan en otra columna, como la clave de empresa.
Procedimiento
1. En el panel Visor de proyectos, seleccione una dimensión o nivel.
2. Pulse Acciones, Editar definición.
3. Pulse la pestaña Orden de miembros.
4. Seleccione la opción de ordenación que desea aplicar.
Opción de ordenación Descripción
Metadatos (como aparecen en el árbol de
miembros)
Solo se utiliza para especificar cómo se
ordenan los miembros cuando se muestran
en el árbol de metadatos.
Los autores de los informes no pueden
cambiar el orden del árbol de metadatos.
Capítulo 5. Modelado de metadatos relacionales 113

Opción de ordenación Descripción
Datos - Sólo como orden de informe
predeterminado
Se utiliza como orden de datos
predeterminado para los miembros de un
informe.
Si no se especifica un orden de datos, los
datos se recuperan en el orden en el que se
introdujeron en la base de datos.
Los autores de los informes pueden
reemplazar este valor y aplicar un orden
diferente a los miembros que se muestran en
un informe.
Datos - Siempre (compatible con OLAP) Se utiliza para proporcionar funciones
relativas de los miembros (MRF) con un
orden coherente de los miembros. Este valor
solo se debe utilizar si las MRF son
necesarias. Si no, la ordenación genera una
sobrecarga innecesaria. Los autores de los
informes no pueden cambiar el orden de los
miembros tal como se suministran a las
MRF. Sin embargo, los autores pueden
aplicar un orden diferente a los miembros
que se muestran en un informe.
Si no se especifica ningún orden y se
utilizan MRF, el autor del informe recibirá
un error cuando se procesen las MRF.
Cuando se establezca esta opción, los
miembros del nivel también se ordenan en el
árbol de metadatos aunque la opción
Metadatos no esté seleccionada. Los autores
de los informes no pueden cambiar el orden
del árbol de metadatos.
Sugerencias
v Para aplicar el orden de clasificación predeterminado a todos los niveles hijo
de los niveles de la dimensión que no tienen una opción de ordenación
definida, pulse Detectar.
v Para eliminar las opciones de ordenación de todos los niveles hijo de los
niveles de la dimensión, pulse Borrar todo.
5. En el cuadro Seleccionar un nivel para asignar propiedades de clasificación,
pulse un nivel.
6. En el cuadro Elementos de datos disponibles, pulse un elemento para ordenar
y pulse la flecha derecha para añadirlo al cuadro Propiedades de clasificación
de nivel. Utilice las flechas arriba y abajo para cambiar el orden de los
elementos.
Sugerencia: Para cambiar el orden de clasificación por ascendente o
descendente, pulse Orden de clasificación.
7. Para especificar cómo se ordenan los valores nulos de los informes, pulse el
cuadro Valores nulos situado junto al elemento y pulse Primero, Último, oNo
especificado.
Primero coloca los valores nulos al principio y Último los coloca al final. No
especificado utiliza la configuración definida en el origen de datos.
8. Pulse Aceptar.
114 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Roles
Los roles definen lo que se visualiza en el árbol de miembros en los estudios de
IBM Cognos. Utilice roles para organizar y gestionar metadatos y para determinar
cómo presentar los datos a los usuarios.
También puede crear expresiones que hagan referencia a roles en vez de a
elementos de consulta. Debe utilizar la función roleValue para hacer referencia a
un rol particular. Por ejemplo, quiere realizar una consulta a un rol específico de
una jerarquía, pero el elemento de consulta que interpreta ese rol es diferente en
cada nivel de la jerarquía. Una única consulta puede abarcar los diferentes
elementos de consulta de cada nivel. También puede utilizar la función roleValue
cuando conoce el rol pero no el elemento de consulta subyacente.
Puede asignar varios roles a un elemento de consulta, pero el mismo rol no se
puede asignar a diferentes elementos de consulta del mismo nivel.
Los roles predeterminados están predefinidos para todas las jerarquías padre-hijo y
para todos los niveles de jerarquías basadas en niveles. La mayoría de estos roles
no se pueden ver en los estudios de IBM Cognos.
Los roles reservados por IBM Cognos BI empiezan con un guión bajo. El nombre
de un rol personalizado no puede empezar con un guión bajo.
Roles predeterminados
Los roles predeterminados incluyen los siguientes:
v _businessKey
Representa la clave del nivel. El nivel se puede definir como exclusivo si la clave
de empresa es suficiente para identificar cada conjunto de datos para un nivel.
El rol _businessKey sólo se puede asignar a un atributo en un nivel.
La propiedad Clave de empresa raíz muestra el valor de la clave de empresa del
miembro raíz. El miembro raíz es un nivel artificial creado para modelos
relacionales modelados dimensionalmente. Para habilitar el acceso a los detalles
en dimensiones conformes, debe definir la propiedad Clave de empresa raíz.
v _memberCaption
Presenta el título de un miembro que se mostrará en los estudios de IBM
Cognos.
El rol _memberCaption es necesario para aprovechar las funciones de miembro y
para habilitar la función de arrastrar y soltar niveles en los estudios de IBM
Cognos.
Asegúrese de que el tipo de datos está definido en cadena para el elemento que
se asignará al rol _memberCaption.
v _memberDescription
Devuelve la descripción de un miembro de una dimensión.
Roles personalizados
De forma predeterminada, los atributos se incluyen sin ningún rol. Puede asignar
atributos a roles existentes o crear roles personalizados. Cada rol que cree deberá
tener un nombre exclusivo.
Puede traducir los roles personalizados en el modelo.
Capítulo 5. Modelado de metadatos relacionales 115

Especificación de roles
Los roles definen lo que se visualiza en el árbol de miembros en los estudios de
IBM Cognos. Utilice roles para organizar y gestionar metadatos y para determinar
cómo presentar los datos a los usuarios.
Procedimiento
1. Pulse la dimensión cuyos roles desea definir.
2. En el menú Acciones, pulse Editar definición.
3. Pulse la pestaña Dimensión.
4. En el cuadro Jerarquías, pulse el nivel que desee.
5. En el cuadro Seleccione un nivel del control de jerarquías para ver los
elementos de consulta, pulse un elemento de consulta.
6. En Rol, pulse el botón de puntos suspensivos (...) .
7. Realice una de las siguientes acciones:
v Para utilizar un rol definido por Framework Manager, pulse la pestaña Roles
predeterminados y seleccione un rol.
v Para crear un rol, pulse la pestaña Roles personalizados y pulse Añadir.
8. Pulse Cerrar.
9. Pulse Aceptar.
Resultados
También puede utilizar la pestaña Mapa de dimensiones para definir los roles.
Pulse Atributos, pulse con el botón derecho en el elemento de consulta y pulse
Editar roles.
Creación de dimensiones de medida
En la dimensión de medida del modelo, solo se ven medidas. Los elementos de
consulta, como las claves, permanecen ocultos.
Una dimensión de medida es una colección de hechos. Se puede crear una
dimensión de medida para uno o varios asuntos de consulta que tienen una
relación válida entre ellos.
Las dimensiones de medida de modelo deben estar compuestas únicamente de
elementos cuantitativos. Por su diseño, las dimensiones de medida de modelo no
contienen claves en las que se pueda realizar una unión, por lo que no es posible
crear uniones para modelar dimensiones de medida de modelo. En lugar de unir
dimensiones de medida de modelo a dimensiones regulares, cree uniones en los
asuntos de consulta subyacentes. A continuación, cree manualmente una relación
de ámbito entre ellas o detecte el ámbito si ambas dimensiones se encuentran en el
mismo espacio de nombres.
Aunque puede utilizar dimensiones de origen de datos, tienen una funcionalidad
limitada en comparación con las dimensiones de modelo o asuntos de consulta.
Deje de utilizar dimensiones de orígenes de datos, regulares y de medida. Cree
modelos según las prácticas recomendadas en Capítulo 9, “Directrices de modelado
de metadatos”, en la página 321 para utilizar los asuntos de consulta como una
base relacional del modelo. Defina dimensiones regulares y de medida como
objetos de modelos basados en asuntos de consulta de orígenes de datos o asuntos
de consulta de modelos. En versiones futuras, se proporcionarán directrices sobre
la migración para usuarios existentes de dimensiones de origen de datos.
116 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Puede añadir un valor incluyendo cálculos basados en reglas de negocio existentes,
como Margen de beneficio.
Puede cambiar el orden de las medidas, los elementos de consulta y los cálculos.
Si la dimensión de medida contiene una carpeta, puede cambiar el orden solo en el
Visor de proyectos.
No se pueden definir jerarquías ni niveles para una dimensión de medida.
Procedimiento
1. Pulse el espacio de nombres donde desea colocar la dimensión de medida.
2. Pulse Acciones, Crear, Dimensión de medida.
3. Pulse la pestaña Dimensión de medida.
4. Arrastre las medidas desde el cuadro Objetos de modelo al cuadro Medidas.
5. Realice las acciones que desee.
Objetivo Acción
Incluir un cálculo Pulse Añadir.
También puede pulsar con el botón derecho
en una medida y pulsar en Añadir o Editar.
Incluir un filtro Pulse la pestaña Filtros.
Probar la dimensión de medida Pulse la pestaña Probar o en la pestaña
Información sobre consultas.
Convertir una medida en un elemento de
consulta
Pulse con el botón derecho en la medida y
pulse Convertir en elemento de consulta.
Nota: Si prueba la dimensión de medida utilizando la pestaña Información
sobre consultas, IBM Cognos BI valida la dimensión de medida. Si prueba la
dimensión de medida utilizando la pestaña Probar, IBM Cognos BI ejecuta la
dimensión de medida. El SQL para validar es algo diferente del SQL para
ejecutar. Para generar el SQL definitivo para la dimensión de medida, utilice la
pestaña Probar.
6. Pulse Aceptar.
Resultados
También puede utilizar la pestaña Mapa de dimensiones para crear una dimensión
de medida. Pulse el botón de dimensión de medida .
También puede estar interesado en los temas siguientes:
v “Consultas de varios hechos y granularidades” en la página 328
v “Creación de cálculos” en la página 150
v “Creación de filtros” en la página 152
v “Prueba de dimensiones” en la página 120
v “Modificar cómo se agregan los elementos de consulta” en la página 134
Capítulo 5. Modelado de metadatos relacionales 117

Conversión de medidas en elementos de consulta
Si ha creado una dimensión de medida y desea unirla a dimensiones regulares
debe crear uniones. Las uniones necesitan claves y las claves son elementos de
consulta, no medidas. Debe convertir la medida que desee utilizar como clave en
un elemento de consulta.
También puede convertir un elemento de consulta en una medida “Conversión de
elementos en medidas” en la página 149.
Procedimiento
1. Efectúe una doble pulsación en la dimensión de medida que contiene la
medida.
2. Pulse la pestaña Dimensión de medida.
3. Pulse con el botón derecho en la medida y pulse Convertir en elemento de
consulta, Aceptar.
Relaciones de ámbito
Las relaciones de ámbito son necesarias para definir qué dimensiones y medidas se
utilizan conjuntamente para modelos relacionales modelados dimensionalmente.
Una relación de ámbito se genera automáticamente al arrastrar una dimensión al
mapa de dimensiones o al mover un asunto de consulta al espacio de nombres de
dimensión y convertirlo en una dimensión regular.
Nota: Los atajos para las relaciones de ámbito no están soportados.
Las relaciones de ámbito solo existen entre las dimensiones de medida y las
dimensiones regulares para definir el nivel en el que las medidas están disponibles
para la creación de informes. No son iguales que las uniones y no influyen en la
cláusula Where. No existen condiciones ni criterios establecidos en una relación de
ámbito para regular cómo se forma una consulta, solo especifica si una dimensión
se puede consultar con un hecho especificado. La ausencia de una relación de
ámbito genera un error en tiempo de ejecución.
Si se establece la relación de ámbito para la dimensión de medida, se aplican los
valores a todas las medidas de la dimensión de medida. Si se notifican los datos a
un nivel diferente para las medidas de la dimensión de medida, puede establecer
el ámbito en una medida. Puede especificar el nivel más bajo en el que se pueden
notificar los datos.
Cuando se crea una dimensión de medida, IBM Cognos Framework Manager crea
una relación de ámbito entre la dimensión de medida y cada dimensión regular
existente. Framework Manager busca una ruta de unión entre la dimensión de
medida y las dimensiones regulares, empezando por el nivel más bajo de detalle.
Si hay muchas rutas de unión disponibles, la relación de ámbito que Framework
Manager crea puede no ser la esperada. En este caso, debe editar la relación de
ámbito.
Definición de relaciones de ámbito
Las relaciones de ámbito solo existen entre las dimensiones de medida y las
dimensiones regulares para definir el nivel en el que las medidas están disponibles
para la creación de informes.
118 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Procedimiento
1. Pulse la pestaña Mapa de dimensiones.
Sugerencia: Para ver las relaciones de ámbito resaltadas con un color de fondo,
pulse el botón mostrar ámbito .
2. Pulse una o más dimensiones de medida.
3. Pulse el nivel de la dimensión en el que desea definir el ámbito.
Sugerencia: Si desea que Framework Manager defina la relación de ámbito,
seleccione la dimensión de medida y la dimensión regular y pulse el botón
determinar ámbito .
4. Pulse el botón definir ámbito .
Resultados
Si desea eliminar el ámbito, seleccione la jerarquía o dimensión y pulse el botón
eliminar ámbito .
Si selecciona una jerarquía, puede eliminar el ámbito de una jerarquía específica sin
que afecte al ámbito definido en otras jerarquías de la dimensión.
Si selecciona la dimensión, se eliminan todos los ámbitos de todas las jerarquías.
También se elimina la relación de ámbito entre la dimensión de medida y la
dimensión regular.
Creación de dimensiones regulares basadas en objetos
existentes
Puede crear una dimensión regular fusionando objetos existentes. Estos objetos
pueden ser dimensiones, asuntos de consulta o elementos de consulta.
Procedimiento
1. Seleccione los objetos que desea en una dimensión.
2. Pulse Acciones, Fusionar en dimensión regular nueva.
Visualización de objetos relacionados
Puede explorar una representación visual de los objetos que están conectados con
el asunto de consulta o la dimensión que ha seleccionado en el Visor del proyecto.
El Explorador de contexto muestra los objetos a los que está conectado el objeto
seleccionado. Asimismo, puede seleccionar un objeto conectado y ver sus
referencias.
Puede ocultar un objeto en el Explorador de contexto. Puede cambiar el diseño,
colocar todos los objetos en el Explorador de contexto, ampliar o disminuir,
imprimir, obtener vistas previas de los diagramas antes de imprimir y cambiar la
configuración de la página.
También puede utilizar la pestaña Mapa de dimensiones para explorar
dimensiones.
Capítulo 5. Modelado de metadatos relacionales 119

Acerca de esta tarea
Procedimiento
1. Seleccione uno o más objetos para explorar.
2. En el menú Herramientas, pulse Lanzar explorador de contexto.
3. Para ver los objetos conectados, pulse uno o varios objetos y pulse el botón
adecuado.
Objetivo Botón
Ver los objetos relacionados con el objeto seleccionado.
Ver las referencias intermedias de los objetos.
Ver todas las referencias de los objetos.
4. Si desea ver los detalles sobre un objeto, como sus relaciones y elementos de
consulta, pulse con el botón derecho en el objeto, pulse Navegar por diagrama,
Valores de diagrama y seleccione los detalles que desee.
Prueba de dimensiones
Si se prueba una dimensión regular, se obtienen los atributos asociados con la
jerarquía definida como predeterminada.
Acerca de esta tarea
Prueba de objetos
Para ver los resultados que devuelve un objeto, puede probarlo. Puede probar un
objeto al crearlo, o más tarde. Los objetos que se pueden probar son dimensiones,
asuntos de consulta, conjuntos de consulta, jerarquías, niveles, cálculos y elementos
de consulta.
Puede ver los datos que se visualizarán en un informe específico antes de publicar
un paquete seleccionando y probando los objetos que se visualizarán en el informe.
Esto permite depurar fácilmente un modelo y verificar que el modelo cumple los
requisitos de creación de informes, porque no necesita crear y publicar los
paquetes primero.
Al probar un objeto, IBM Cognos Framework Manager devuelve datos de ejemplo.
No se aplica formateo a los datos de ejemplo. Si debe probar formateo, deberá
publicar el paquete y visualizar los objetos en los estudios de IBM Cognos.
Puede ver resultados diferentes según lo que pruebe. Por ejemplo, si utiliza el
editor de expresiones para probar un cálculo incluido en un asunto de consulta,
Framework Manager sólo prueba la expresión, pero no el elemento, de modo que
la configuración de agregación para el elemento de consulta no se aplica en la
prueba. Al probar todo el asunto de consulta, que incluye el cálculo, se obtiene un
resultado diferente, porque sí se aplica la configuración de agregación. Por
ejemplo, si la configuración de agregación es resumir, verá un número menor de
filas en la prueba.
Al probar una dimensión de medida, el SQL usa agregados, no las medidas.
Si prueba un segmento hijo de un modelo segmentado, puede ver un error si un
objeto de los que está probando hace referencia a un objeto de otro segmento hijo y
120 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

el objeto al que se hace referencia no está disponible para el proyecto en cuestión.
Compruebe que el modelo padre contiene todos los objetos y que este mensaje de
error no se visualiza al probar el modelo padre.
Los valores del regulador pueden afectar a los resultados de la prueba. Para
obtener más información, consulte: “Reguladores” en la página 304.
Puede cambiar la configuración de prueba existente para personalizar los
resultados que muestra la prueba. Por ejemplo, entre otros valores, puede controlar
el número de filas devueltas.
Pasos para crear o modificar el objeto
Procedimiento
1. Seleccione el objeto que desea probar.
2. Pulse Acciones, Editar definición y, después, pulse la pestaña Probar o
Consulta Información.
El cuadro Resultados de la prueba está vacío hasta que se ejecuta la consulta.
Los conjuntos de resultado que contengan objetos binarios grandes se
mostrarán como [blob].
3. Para ejecutar la consulta y recuperar todos los resultados de la prueba, pulse
Probar muestra.
4. Si desea añadir un recuento de las filas, pulse Total de filas.
5. Si desea aplicar la propiedad Agregado regular del elemento de consulta o la
propiedad Reglas de agregado de una medida semiaditiva referenciada en la
expresión, seleccione la casilla de verificación Suma automática.
Si desmarca esta casilla de verificación, se devuelve una fila para cada fila del
conjunto de resultados de la consulta.
6. Si desea obtener más información sobre los resultados de la consulta, pulse la
pestaña Información de consulta.
7. Pulse Aceptar.
Pasos para ver los datos que se mostrarán en un informe
determinado
Procedimiento
1. Seleccione los objetos que se mostrarán en el informe.
2. Pulse Herramientas, Probar.
3. Para ejecutar la consulta y recuperar todos los resultados de la prueba, pulse
Probar muestra.
4. Si desea ver los detalles de los problemas detectados, pulse la pestaña
Información sobre consultas.
Si no ve los resultados de la consulta en la ventana de prueba, significa que los
datos del origen de datos superan el valor de uno de los reguladores. La
consulta se detiene en el límite especificado, pero la ventana de resultados de
prueba no contiene datos. Sugerencia: Defina todos los reguladores con el valor
cero.
Cambio de los valores de la prueba
Puede personalizar las pruebas cambiando sus valores.
Procedimiento
1. Seleccione el objeto que desee.
Capítulo 5. Modelado de metadatos relacionales 121

2. Pulse Acciones, Editar definición y, después, pulse la pestaña Probar o
Información de consulta.
3. Pulse Opciones, Probar valores.
4. Elija las opciones que desee.
Objetivo Acción Persistencia
Recuperar un parámetro y
mostrar un número
determinado de filas
Seleccione la casilla de
verificación Restringir el
número máximo de filas
que se devolverán y escriba
el numero de filas que desee.
Este valor no mejora el
rendimiento de la
recuperación de datos
cuando se prueban
dimensiones, asuntos de
consulta y conjuntos de
consulta.
Especificar el nivel de detalle Arrastre el control deslizante
del nivel de información
que se muestra en la
información de resultados
hasta el punto que represente
el nivel de detalle que
requiera.
Reemplazar temporalmente
parámetros de sesión
Aplicar filtros de modo de
diseño relevantes
Aplicar un filtro de
seguridad
122 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario
En el cuadro Parámetros de
sesión, pulse Definir.
Aparece el cuadro de diálogo
Parámetros de sesión.
Seleccione la casilla de
verificación Aplicar todos
los filtros de modo de
diseño durante las pruebas.
Esto aplica todos los filtros
pertinentes cuyo uso se
defina en el modo de diseño
en otra dimensión, asunto de
consulta o conjunto de
consultas.
En el cuadro Filtros de
seguridad, pulse Editar.
Este valor se aplica a todas
las dimensiones, asuntos de
consulta y conjuntos de
consulta del modelo.
Este valor se guarda y se usa
en la siguiente sesión con
cualquier otro modelo.
Este valor se guarda y se usa
en la siguiente sesión con
este modelo.
Los valores de reemplazo no
se guardan con el modelo.
Este valor solo sirve en la
sesión actual.
Este valor se guarda y se usa
en la siguiente sesión con
cualquier otro modelo.
Este valor se guarda y se usa
en la siguiente sesión con
este modelo.

Objetivo Acción Persistencia
Cambiar valores de solicitud En el cuadro Valores de
solicitud actuales, pulse
Solicitudes.
Aparece el cuadro de diálogo
Gestor de solicitudes de
modelos, que muestra todas
las peticiones, y sus valores,
que están en el modelo.
5. Efectúe una doble pulsación en Aceptar.
Resultados
Los valores de la solicitud no
se guardan con el modelo.
Este valor solo sirve en la
sesión actual.
También puede estar interesado en los temas siguientes:
v Trabajo con dimensiones “Dimensiones” en la página 105
v Trabajo con asuntos de consulta “Asuntos de consulta” en la página 75
Conversión de dimensiones en asuntos de consulta
Puede convertir una dimensión regular en un asunto de consulta de modelo o en
un asunto de consulta de orígenes de datos.
Metadatos multilingües
Asimismo, puede convertir un asunto de consulta en una dimensión. Consulte:
“Conversión de asuntos de consulta en dimensiones” en la página 97.
Si una dimensión tiene varias jerarquías, solo la jerarquía predeterminada se
incluye al convertir la dimensión en un asunto de consulta.
Procedimiento
1. Pulse la dimensión regular.
2. Pulse Acciones, Convertir en asunto de consulta.
Para modelos que se publican en varios idiomas, puede visualizar y modificar
objetos de modelo en los distintos idiomas.
Debe gestionar soporte multilingüe en la vista de importación por diversas
razones. Puede reducir el número de elementos de consulta contenidos en cada
dimensión y asunto de consulta. Con menos dimensiones, asuntos de consulta y
elementos de consulta, el modelo resulta más manejable. Puede simplificar el
mantenimiento realizando todas las tareas multilingües en un mismo lugar en vez
de en diferentes vistas empresariales. Esto asegura coherencia, ya que los idiomas
están correctamente configurados para todos los modeladores. Esto es
especialmente importante en el caso de modelos segmentados.
Soporte de metadatos multilingües
Deben seguirse varios pasos adicionales para añadir soporte para metadatos
multilingües.
Capítulo 5. Modelado de metadatos relacionales 123

Procedimiento
1. Importe los metadatos de los orígenes de datos multilingües. Consulte:
“Modelado con orígenes de datos multilingües” en la página 125.
2. Defina los idiomas que soporta el modelo. Consulte: “Adición de un idioma a
un proyecto” en la página 127.
3. Defina uno o varios mapas de parámetros que conviertan el entorno local, que
se utiliza cuando el informe se ejecuta, en los valores del idioma del origen de
datos. Consulte: “Creación de mapas de parámetros” en la página 157.
4. Utilice una macro para sustituir dinámicamente valores de idioma de la tabla
de consulta de idiomas con el parámetro de sesión runLocale como clave.
Consulte: “Crear solicitudes con macros de consulta” en la página 162.
5. Exporte las propiedades multilingües de las tablas de traducción, que los
traductores utilizarán para escribir el texto adecuado para cada idioma.
Consulte: “Exportación de tablas de traducción” en la página 128.
6. Importe la tabla que contiene los valores de propiedad traducidos. Consulte:
“Importación de tablas de traducción” en la página 129.
7. Publique los metadatos en los idiomas que especifique. Consulte: Capítulo 7,
“Publicación de paquetes”, en la página 249.
Resultados
Para obtener información sobre cómo habilitar el modelado multilingüe, consulte:
“Ejemplo: crear proyectos multilingües para metadatos relacionales” en la página
129.
Configuración de un entorno de creación de informes
multilingüe
Puede crear informes que muestren datos en más de un idioma y utilizar distintas
configuraciones regionales. Esto significa que puede crear un único informe que
pueden utilizarlo consumidores de informes de todo el mundo.
Las bases de datos de ejemplo proporcionadas con IBM Cognos almacenan una
selección de campos de texto, como nombres y descripciones, en más de 25
idiomas para mostrar un entorno de creación de informes multilingüe. Para
obtener más información sobre cómo se almacenan los datos en las bases de datos
de ejemplo y cómo se configuran las bases de datos de ejemplo para utilizar datos
multilingües, consulte la publicación IBM Cognos Business Intelligence Guía de
administración y seguridad.
A continuación se indica el proceso para crear un entorno de creación de informes
multilingüe:
v Utilice metadatos multilingües.
El administrador de orígenes de datos puede almacenar datos multilingües en
columnas, filas o tablas individuales.
Para obtener más información sobre la configuración de la base de datos para la
creación de informes multilingüe, consulte la publicación IBM Cognos Business
Intelligence Guía de administración y seguridad.
v Cree un modelo multilingüe.
Los modeladores utilizan Framework Manager para añadir metadatos
multilingües al modelo desde cualquier tipo de origen de datos, excepto OLAP.
Añaden metadatos multilingües mediante la definición de los idiomas que el
modelo soporta, la traducción de cadenas de texto en el modelo para elementos
124 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

como descripciones y nombres de objetos, y la definición de los idiomas que se
exportan en cada paquete. Si el origen de datos contiene datos multilingües, los
modeladores pueden definir consultas que recuperen datos en el idioma
predeterminado para el usuario del informe.
Para obtener más información, consulte la publicación IBM Cognos Framework
Manager Guía del usuario.
v Cree mapas multilingües.
Los administradores y los modeladores utilizan un programa de utilidad del
sistema operativo Microsoft Windows denominado Map Manager para importar
mapas y actualizar las etiquetas para mapas en IBM Cognos Report Studio. Para
las características del mapa, como los nombres de país o región y ciudad, los
administradores y los modeladores pueden definir nombres alternativos para
ofrecer versiones multilingües del texto que aparece en el mapa.
Para obtener más información, consulte la publicación IBM Cognos Map Manager
Installation and User Guide.
v Cree un informe multilingüe.
El autor de informes utiliza Report Studio para crear un informe que se pueda
visualizar en distintos idiomas. Por ejemplo, puede especificar que el texto,
como por ejemplo el título, aparezca en alemán cuando el informe lo abra un
usuario alemán. También puede añadir traducciones para objetos de texto y
crear otros objetos dependientes del idioma.
Para obtener más información, consulte la publicación IBM Cognos Report Studio
Guía del usuario.
v Especifique el idioma en el que se visualiza un informe.
Puede utilizar IBM Cognos Connection para realizar las acciones siguientes:
– Definir propiedades multilingües, como un nombre, una sugerencia y una
descripción, para cada entrada en el portal.
– Especificar el idioma predeterminado que desea que se emplee cuando se
ejecute un informe.
Sugerencia: Puede especificar el idioma predeterminado en la página de
opciones de ejecución, en las propiedades de informe o en sus preferencias.
– Especificar un idioma, distinto del predeterminado, que desee que se emplee
cuando se ejecute un informe.
Para obtener más información, consulte la publicación IBM Cognos Connection -
Guía del usuario.
Los datos aparecerán en el idioma y con la configuración regional especificados en
v las opciones del navegador web del usuario
v las opciones de ejecución
v las preferencias de IBM Cognos Connection
Cualquier texto que añadan los usuarios o los autores aparecerá en el idioma en el
que lo hayan escrito.
Modelado con orígenes de datos multilingües
Para habilitar un proyecto para trabajar con varios idiomas, debe configurar los
orígenes de datos para que den soporte a varios idiomas.
Capítulo 5. Modelado de metadatos relacionales 125

Orígenes de datos relacionales multilingües
Para orígenes de datos relacionales, puede dar soporte a varios idiomas utilizando
una o varias de las siguientes opciones:
v Tablas de base de datos específicas de idioma
El origen de datos debe contener las mismas tablas para cada idioma soportado.
Por ejemplo, si la tabla Product soporta inglés, francés y alemán, el origen de
datos tendrá tablas denominadas Product_en, Product_fr y Product_de.
v Columnas específicas de idioma
Una tabla de base de datos debe contener las mismas columnas para cada
idioma soportado. Por ejemplo, si la tabla Product soporta inglés, francés y
alemán, la tabla tendrá columnas para ProductName_en, ProductName_fr y
ProductName_de.
v Filas específicas de idioma
Una tabla de base de datos debe contener una columna adicional para identificar
el idioma de cada fila de datos, como una columna denominada LANG.
Estas soluciones pueden hacer que los orígenes de datos multilingües sean grandes
y difíciles de gestionar.
Puede modelar un único asunto de consulta relacional para que represente todos
los idiomas de origen de datos posibles utilizando mapas de parámetros y
parámetros de sesión en la definición de asunto de consulta. Para obtener más
información, consulte: “Crear solicitudes con macros de consulta” en la página 162
y “Metadatos multilingües” en la página 123.
Nota: La sintaxis de la expresión es específica del idioma de diseño del modelo. Si
importa objetos de un modelo diseñado en otro idioma, tal vez deba ajustar la
sintaxis de la expresión.
Orígenes de datos de SAP BW multilingües
En el caso de metadatos de SAP BW, no necesita utilizar parámetros para dar
soporte a la creación de informes multilingüe, ya que SAP BW proporciona
automáticamente datos en el idioma que coincide con la configuración de inicio de
sesión para el usuario actual. Si no existen metadatos para el idioma del usuario
actual, Framework Manager recupera los datos en el idioma predeterminado.
Uso de macros para modelar datos multilingües
Puede modelar datos multilingües almacenados en varias tablas, columnas o filas
para cada idioma soportado. Puede utilizar macros con mapas de parámetros y
parámetros de sesión para crear dimensiones o asuntos de consulta que recuperen
datos en el idioma preferido de la persona que visualiza el informe.
La ubicación de un parámetro en la definición del asunto de consulta depende de
la ubicación de los datos multilingües en el origen de datos. Debe tener un mapa
de parámetros en la macro.
126 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Ubicación del origen de datos Ejemplo
Una columna con una clave de idioma en
otra columna
Filas cuyo idioma se identifica con una
columna especial, como LANG
La ubicación del parámetro se encuentra en
la lista Seleccionar.
Select
PRODUCT_TYPE.PRODUCT_TYPE_CODE,
PRODUCT_TYPE.PRODUCT_LINE_CODE,
PRODUCT_TYPE.PRODUCT_TYPE_
#$Language_lookup
{$runLocale}# as Product_type
from
[gosales].PRODUCT_TYPE
PRODUCT_TYPE
La ubicación del parámetro se encuentra en
el filtro.
Select
PRODUCT.PRODUCT_NAME,
PRODUCT_MULTILINGUAL.
PRODUCT_NUMBER
from
[gosales].PRODUCT,
[gosales].PRODUCT_MULTILINGUAL
Where
PRODUCT.PRODUCT_NUMBER =
PRODUCT_MULTILINGUAL.
PRODUCT_NUMBER
and
(PRODUCT_MULTILINGUAL."LANGUAGE" =
#sq($Language_lookup{$runLocale})#
Adición de un idioma a un proyecto
Puede añadir un idioma a un proyecto cuando lo desee. Lo hará, por ejemplo, si
los valores de un idioma no se han traducido anteriormente.
Cuando se añade un idioma a un proyecto, IBM Cognos Framework Manager
representa un valor de propiedad nuevo para cada propiedad multilingüe de cada
objeto del proyecto. Una propiedad multilingüe es cualquier propiedad de texto
que se muestre en un informe, como Nombre, Descripción y Sugerencia de
pantalla.
Los valores nuevos que Framework Manager asigna a estas propiedades de texto
son una combinación del valor de propiedad original precedido de un código de
idioma. Por ejemplo, si una dimensión se denomina País y desea añadir el idioma
Holandés, Framework Manager inserta un nombre cuyo valor es (nl)País.
Cada proyecto contiene dos tipos de definiciones de idioma:
v Idioma de diseño
Es el idioma en el que se creó el proyecto. Este valor se almacena en el modelo y
no puede cambiarse. Sirve de valor de idioma predeterminado.
v Idioma activo
Es el idioma en el que se muestra el contenido del modelo actualmente. Cuando
se abre un modelo, el idioma activo se define con el idioma del modelo que se
aproxime más a la zona y la configuración de idioma del sistema. Puede cambiar
este valor en cualquier momento solo para la sesión actual. En las sesiones
siguientes, el modelo continuará abriéndose en el idioma del diseño.
Capítulo 5. Modelado de metadatos relacionales 127

Procedimiento
1. Pulse Proyecto, Idiomas, Definir idiomas.
2. En el cuadro Idiomas disponibles, seleccione cada uno de los idiomas que
desee añadir y pulse el botón de flecha para moverlo al cuadro Idiomas del
proyecto.
Sugerencia: Para eliminar un idioma, selecciónelo en el cuadro Idiomas del
proyecto y pulse el botón de flecha para moverlo al cuadro Idiomas
disponibles.
3. Si desea cambiar el idioma activo, en el cuadro Idiomas del proyecto, pulse el
idioma y pulse Definir como activo, Aceptar.
En la solicitud, acepte los cambios que ha realizado en el proyecto y pulse
Aceptar.
4. Si desea ver valores de propiedad multilingüe en el panel Propiedades, pulse la
pestaña Idiomas.
Exportación de tablas de traducción
Puede generar y exportar una tabla de traducción para simplificar la tarea de
traducir los objetos del modelo. La tabla de traducción contiene una lista de todas
las cadenas de texto definidas para propiedades multilingües como, por ejemplo,
Nombre, Descripción y Sugerencia. Los traductores pueden utilizar una aplicación
externa, como Microsoft Excel, para escribir la información necesaria en la tabla.
Puede exportar una tabla de traducción como un archivo de valores separados por
comas (.csv) o un archivo de texto Unicode (.txt). Debe exportar la tabla de
traducción como un archivo de texto Unicode si contiene un idioma no latino o se
va a importar por un sistema con una configuración de idioma diferente de su
propio sistema.
Exportación de una tabla de traducción
Procedimiento
1. Seleccione los objetos que desea exportar.
2. Pulse Proyecto, Idiomas, Exportar archivo de traducción.
3. En el cuadro Idiomas del proyecto, seleccione cada uno de los idiomas que
desee exportar y pulse el botón de flecha para moverlos al cuadro Idiomas
para exportar.
Debe exportar el idioma de diseño del modelo que se utilizará en la tabla de
traducción. Por ejemplo, si la tabla de traducción se va a utilizar en un modelo
que utiliza el francés como idioma de diseño, debe exportar Francés.
IBM Cognos Framework Manager exporta el código de entorno local adecuado
para cada idioma que seleccione. Si no selecciona todos los idiomas para
traducir, debe especificar manualmente los códigos de idioma en la primera fila
de cada columna de idioma nueva en la tabla de conversión.
4. En el cuadro Objetos de modelo que se van a exportar, seleccione si desea
exportar todos los objetos de modelo o solo los objetos preseleccionados y sus
hijos.
5. Escriba la ubicación y el nombre de la tabla de traducción.
6. Pulse Aceptar.
128 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Importación de tablas de traducción
Puede añadir valores de propiedades de texto para cada idioma definido en el
modelo mediante la importación de datos traducidos desde un archivo. El archivo
importado debe ser una tabla de traducción que los traductores han utilizado para
especificar los valores traducidos necesarios.
La tabla de traducción debe contener el idioma de diseño del modelo que la tabla
de traducción utilizará. La tabla de traducción puede contener un subconjunto de
idiomas definidos para el proyecto.
Importación de una tabla de traducción
Procedimiento
1. Pulse Proyecto, Idiomas, Importar archivo de traducción.
2. En el cuadro Idiomas del proyecto, seleccione los idiomas de la tabla de
traducción y pulse los botones de flecha para moverlos al cuadro Convertir de
y Traducir a.
Debe seleccionar el idioma de diseño de este modelo.
3. En el cuadro Aplicar conversión a, seleccione si desea aplicar la traducción a
todos los objetos de modelo o solo los objetos preseleccionados y sus hijos.
4. Escriba la ubicación y el nombre del archivo de traducción.
5. Pulse Aceptar.
Ejemplo: crear proyectos multilingües para metadatos
relacionales
Puede crear un modelo que podrán utilizar autores ingleses, franceses y alemanes.
También puede hacer que los estudios de IBM Cognos muestren automáticamente
los metadatos en el idioma que requiera el autor del informe.
En el proyecto de muestra go_data_warehouse, debe realizar las acciones
siguientes:
v Traducir los metadatos.
v Utilizar macros para crear un proyecto multilingüe.
Puede modificar las dimensiones y los asuntos de consulta para que muestren
contenido multilingüe mediante el mapa de parámetros Language_lookup y el
parámetro de sesión runLocale.
Procedimiento
1. Abra el proyecto go_data_warehouse.
2. Compruebe que inglés, francés y alemán sean idiomas soportados:
v Pulse Proyecto, Idiomas, Definir idiomas.
v Compruebe que el panel Idiomas del proyecto contiene Inglés, Francés y
Alemán.
v En el panel Visor de proyectos, pulse un elemento de consulta y, en el
panel Propiedades, pulse la pestaña Idioma.
Se ve una entrada de nombre, descripción y texto de la ayuda contextual en
cada idioma.
3. Exporte todos los idiomas y objetos del proyecto a un archivo con valores
separados por comas (.csv) denominado GOSLDW-ML.csv.
v Pulse Proyecto, Idiomas, Exportar archivo de traducción.
Capítulo 5. Modelado de metadatos relacionales 129

Elementos de consulta
v En el cuadro Idiomas del proyecto, pulse Ctrl e Inglés, Francés y Alemán y
pulse la flecha superior para moverlos al cuadro Idiomas para exportar.
v En el cuadro Exportar idiomas a este archivo, indique la ubicación de
GOSLDW-ML.csv.
4. Abra el archivo GOSLDW-ML.csv Microsoft Excel y traduzca las cadenas.
Observe que cada columna representa un idioma determinado y que el
archivo contiene solo las cadenas de texto que existen en el modelo.
5. En Framework Manager, importe el archivo traducido:
v Pulse Proyecto, Idiomas, Importar archivo de traducción.
v En el cuadro Idiomas del proyecto, mueva Francés y Alemán al cuadro
Traducir a.
v En el cuadro Importar tabla de conversión desde este archivo, indique la
ubicación de GOSLDW-ML.csv.
6. En el panel Visor de proyectos, efectúe una doble pulsación en el mapa de
parámetros Language_lookup.
Observe que las claves coinciden con los valores posibles para el parámetro de
sesión runLocale, lo que identifica el idioma del usuario actual. Estas claves se
asignan a los valores de idioma que están definidas en la base de datos de
go_data_warehouse.
7. Compruebe que el mapa de parámetros contiene la información siguiente.
Clave Valor
de DE
en EN
fr FR
8. Seleccione un objeto que contenga columnas multilingües, como la dimensión
de método Pedido y pulse Acciones, Editar definición.
El identificador de idiomas que se añadió al final del nombre del elemento de
consulta se sustituye por un mapa de parámetros y el parámetro de sesión
runLocale:
Select
ORDER_METHOD_DIMENSION.ORDER_METHOD_KEY,
ORDER_METHOD_DIMENSION.ORDER_METHOD_CODE,
ORDER_METHOD_DIMENSION.ORDER_METHOD_#$Language_lookup{$runLocale}
# AS ORDER_METHOD
from
[go_data_warehouse].ORDER_METHOD_DIMENSION
9. Para obtener una vista previa de los resultados, pulse Probar, Probar muestra.
10. Pulse Proyecto, Parámetros de sesión y cambie el valor del parámetro de
sesión runLocale por fr.
11. Pruebe la dimensión de método Pedido de nuevo para ver el resultado.
Un elemento de consulta es el objeto más pequeño del modelo que puede incluirse
en un informe. Representa una única instancia de algo, como la fecha en que se
presentó un producto.
130 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

En el caso de metadatos relacionales, puede modificar las propiedades de los
elementos de consulta de las siguientes formas:
v Configurando las propiedades Uso y Agregado regular para reflejar el uso
previsto del elemento de consulta.
v Formateando los elementos de consulta para controlar cómo se visualizan los
datos en un informe.
v Identificando una columna como una solicitud y controlando cómo los usuarios
ven la información de solicitud.
También puede modificar las propiedades para varios elementos de consulta al
mismo tiempo. Para obtener más información, consulte: “Sustitución de varios
valores de propiedad” en la página 21.
Puede cambiar el nombre de un elemento de consulta en el cuadro de diálogo
Definición de cálculo. Al cambiar el nombre del elemento de consulta, se
actualizan las referencias a dicho elemento de consulta.
Los informes pueden contener diferentes elementos de consulta de uno o más
objetos del modelo, por lo que las propiedades de los elementos de consulta
controlan numerosos aspectos del informe final. Al crear una dimensión de modelo
o un asunto de consulta de modelo, los elementos de consulta heredan las
propiedades de los elementos de consulta del origen de datos en los que se basan.
Las propiedades de elementos de consulta o medidas incluyen las siguientes:
Propiedad del elemento de consulta Descripción
Nombre Nombre del elemento de consulta o medida.
Descripción Descripción del elemento de consulta o
medida.
Última modificación Fecha en que se modificó por última vez el
elemento de consulta o medida. La
propiedad se actualiza automáticamente con
la fecha y hora actuales.
Última modificación realizada por Usuario que modificó por última vez el
elemento de consulta o medida. Esta
propiedad se actualiza automáticamente
cuando se modifica el elemento.
El valor es el nombre de usuario de inicio de
sesión actual.
Comentarios sobre modelo Se utiliza para añadir comentarios internos
sobre el modelo. La información se utiliza en
el diálogo Analizar el impacto de la
publicación yenInforme de modelo. Los
usuarios del paquete no tienen acceso a los
comentarios.
Sugerencia Descripción que puede visualizarse en el
paquete publicado para los usuarios.
Capítulo 5. Modelado de metadatos relacionales 131

Propiedad del elemento de consulta Descripción
Expresión Se utiliza para crear cálculos incluidos que
proporcionan a los usuarios los valores
calculados que suelen usar.
Esta propiedad es sólo para medidas.
Nota: SAP BW no utiliza la propiedad
Expresión.
Nombre externo Nombre que se muestra en el origen de
datos.
Está oculto Indica si se oculta o se muestra el elemento
de consulta o la medida en el paquete
publicado.
Incluso cuando Está oculto tiene el valor
true y el elemento de consulta o la medida
resulta invisible para los usuarios, siempre
está presente en el paquete publicado,
porque otros objetos del modelo pueden
necesitar el elemento de consulta o la
medida. El elemento de consulta o la
medida no se ven en el asistente de
publicación de paquetes.
Por ejemplo, un cálculo puede utilizar un
elemento de consulta oculto.
Uso Uso previsto para los datos representados
por el elemento de consulta.
Esta propiedad es sólo para elementos de
consulta.
Formato Cómo se visualiza la información en un
informe.
Moneda Moneda utilizada.
Esta propiedad no se puede cambiar en el
panel Propiedad. Utilice la propiedad
Formato para cambiar la moneda.
Tipo de datos Tipo de datos definido en el origen de datos.
Esta propiedad se establece en el origen de
datos, por lo que en Framework Manager es
de sólo lectura.
Precisión Número total de dígitos.
132 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario
Esta propiedad se establece en el origen de
datos, por lo que en Framework Manager es
de sólo lectura.

Propiedad del elemento de consulta Descripción
Escala Cuántos dígitos se representan en la escala.
Por ejemplo, se pueden mostrar los números
en millares, de modo que 100.000 signifique
100.000.000.
Esta propiedad se establece en el origen de
datos, por lo que en Framework Manager es
de sólo lectura.
Tamaño Tamaño del elemento de consulta o medida.
Esta propiedad se establece en el origen de
datos, por lo que en Framework Manager es
de sólo lectura.
Admite nulos Indica si el elemento de consulta o la
medida pueden contener un valor nulo.
Esta propiedad se establece en el origen de
datos, por lo que en Framework Manager es
de sólo lectura.
Tipo de visualización Cómo se muestra el elemento de consulta.
El valor de columna puede visualizarse en
los estudios de IBM Cognos como una
imagen, como un enlace o como un valor.
La configuración predeterminada es como
valor.
Esta propiedad es sólo para elementos de
consulta.
Tipo MIME Formato que utiliza el valor de columna.
Por ejemplo, si Tipo de visualización se
define como imagen, Tipo MIME podría ser
jpeg.
Esta propiedad es sólo para elementos de
consulta.
Nota: SAP BW no utiliza la propiedad Tipo
MIME.
Información de solicitud Comportamiento de la solicitud.
Agregado regular Tipo de agregación que se asocia con el
elemento de consulta, medida o cálculo en el
paquete publicado.
Capítulo 5. Modelado de metadatos relacionales 133

Propiedad del elemento de consulta Descripción
Reglas de agregado Para metadatos relacionales modelados
dimensionalmente, reglas para la agregación
semiaditiva.
Para metadatos de SAP BW, la propiedad
Reglas de agregado es de sólo lectura.
Regla de asignación Especifica el tipo de asignación definida
para la medida.
El valor predeterminado especifica que se
usa asignación constante en consultas de
lista y asignación sólo una vez en consultas
de tabla de referencias cruzadas. Un valor
constante especifica que se usa asignación
constante en todas las consultas.
No es ordenable Indica si los valores de este elemento de
consulta se pueden ordenar.
Esta propiedad es para elementos de
consulta que contienen objetos grandes,
como blob.
Modificar cómo se agregan los elementos de consulta
Puede cambiar cómo se agregan algunos elementos de consulta y medidas en los
informes. IBM Cognos Framework Manager aplica reglas de agregación cuando los
usuarios crean un informe que resume un elemento de consulta o una medida.
Cuando se importan metadatos, Framework Manager asigna valores a las
propiedades Uso y Agregado regular para los elementos de consulta y medidas
según el tipo de objeto en el que se encuentre el elemento de consulta o la medida.
La propiedad Uso identifica el uso que se pretende dar a los datos representados
por el elemento de consulta “propiedad Uso” en la página 138. La propiedad
Agregado regular identifica el tipo de agregación que se aplica al elemento de
consulta oalamedida “Propiedad Agregado regular” en la página 139. Los
usuarios pueden reemplazar los valores de la propiedad Agregado regular. Para
las medidas semiaditivas, puede especificar reglas de agregación adicionales
modificando la propiedad Agregado regular “Definición de reglas de agregado
para medidas semiaditivas” en la página 139.
Al modificar la propiedad Agregado regular, puede seleccionar los valores que no
están disponibles mediante la importación, como el promedio y el máximo. Debe
comprender lo que los datos representan para conocer qué valor de agregado se
necesita. Por ejemplo, si agrega un número de pieza, los únicos valores de
agregado que son aplicables son recuento, recuento Distinct, máximo y mínimo.
En general, utilice la propiedad Agregado regular en lugar de añadir funciones de
resumen a las expresiones. Utilice funciones de resumen en expresiones si la
propiedad de agregado no soporta el resumen necesario o si la complejidad de la
expresión no se puede gestionar utilizando las propiedades de elemento.
134 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Para contar valores diferenciados tales como clientes diferenciados, la técnica
siguiente asegura resultados coherentes en las listas, las tablas de referencias
cruzadas y los gráficos. Es mejor contar de modo individualizado en una clave de
empresa que identifica de forma exclusiva los valores que hacerlo en un valor de
cadena. Esto evita la pérdida accidental de filas donde se utiliza el mismo nombre
pero que son realmente exclusivas.
A continuación se muestra un ejemplo de recuento de clientes individualizados, en
un modelo relacional. Cree una copia de Clave de cliente en el asunto de consulta
Cliente, denomínelo Recuento de clientes, establezca la propiedad de Uso en
Hecho y, a continuación, establezca la propiedad Agregado regular en Recuento
Distinct. No es recomendable crear un elemento de consulta con la expresión de
Count (distinct [Customer Key]) porque el elemento de consulta puede
comportarse de manera imprevisible en diversos escenarios. Si se necesita
formatear, establezca el Tipo de formato en Número y especifique las propiedades
de Formato tales como el Número de posiciones decimales y Separador de miles
según sea necesario.
Para un modelo relacional modelado dimensionalmente (DMR), añada el elemento
de consulta Recuento de clientes que se acaba de crear en el asunto de consulta
Cliente, a una dimensión de medida. Los valores de la propiedad Agregado
regular y de la propiedad Formato se heredan. Alternativamente, puede añadir la
Clave de cliente original del asunto de consulta Cliente a la dimensión de medida,
establecer la propiedad Agregado regular en Recuento Distinct y establecer el
formato como corresponda.
Reglas para definir propiedades para dimensiones
IBM Cognos Framework Manager utiliza las siguientes reglas para definir las
propiedades Uso y Agregado regular.
Objeto propiedad Uso propiedad Agregado regular
Elemento de consulta en una
dimensión regular
Elemento de consulta en una
dimensión de medida
Medida en una dimensión de
medida
Atributo No soportado
Identificador Recuento
Hecho Automático si la medida es
un cálculo
Suma si la medida no es un
cálculo
Si la medida es semiaditiva, utilice la propiedad Reglas de agregado para definir
reglas para la agregación semiaditiva. Consulte: “Definición de reglas de agregado
para medidas semiaditivas” en la página 139.
Reglas para definir propiedades para asuntos de consulta
Puede cambiar las propiedades Uso y Agregado regular para todos los tipos de
asuntos de consulta. Los valores para estas propiedades se basan en características
como el tipo de datos y la participación en claves y relaciones.
Capítulo 5. Modelado de metadatos relacionales 135

Para asuntos de consulta de modelo, IBM Cognos Framework Manager utiliza los
valores de los asuntos de consulta subyacentes. Si el asunto de consulta de origen
no utiliza estas propiedades, se aplican las reglas para asuntos de consulta de
orígenes de datos y de procedimiento almacenado.
Para asuntos de consulta de orígenes de datos o de procedimiento almacenado,
Framework Manager utiliza las siguientes reglas para definir las propiedades Uso
y Agregado regular al importar los asuntos de consulta.
Objeto propiedad Uso propiedad Agregado regular
El elemento de consulta
forma parte de una clave en
un determinante.
El elemento de consulta
participa en una relación.
El elemento de consulta es
de tipo de datos fecha u
hora.
El elemento de consulta es
de tipo de datos numérico o
intervalo de tiempo.
No se aplica ninguno de los
casos anteriores.
Identificador Recuento
Identificador Recuento
Identificador Recuento
Hecho Automático si el elemento es
un cálculo.
Atributo No soportado
Suma si el elemento no es un
cálculo.
Reglas para definir propiedades para cálculos
IBM Cognos Framework Manager utiliza varias reglas para definir las propiedades
Uso y Agregado regular para cálculos.
Reglas para interpretar agregaciones calculadas:
El valor Calculado en la propiedad Agregado regular controla el orden de las
operaciones para los cálculos
En Framework Manager, el valor de tipo de agregación Calculado sólo se aplica:
v cálculos independientes
v cálculos que se basan en medidas de una dimensión de medida y se incluyen en
la misma dimensión de medida.
No está soportado para cálculos incluidos en asuntos de consulta.
Para obtener más información, consulte: “Establecimiento del orden de las
operaciones para cálculos de modelo” en la página 337.
Framework Manager utiliza las reglas siguientes para interpretar el tipo de
agregación calculada en la propiedad Agregado regular.
136 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

v Las funciones de agregación estándar (promedio, recuento, máximo, mínimo,
desviación estándar, suma, varianza) y las referencias a asuntos de consulta de
modelo se agregan primero. Las demás operaciones se aplican luego al resultado
de la agregación.
Por ejemplo, para dividir deuda por crédito para cada fila, el SQL presenta el
siguiente aspecto:
Select
customer, debt, credit, debt/credit as
percent_debt from x
Para agregar para todos los clientes, el SQL presenta el siguiente aspecto:
Select sum(debt), sum(credit), sum(debt)/sum(credit)
as percent_debt from (Select customer, debt, credit from x)
v Si el elemento de consulta del cálculo es un hecho y el tipo de agregación para
el elemento de consulta es promedio, recuento, máximo, mínimo o suma, se
utiliza el tipo de agregación del elemento de consulta.
v Si el elemento de consulta del cálculo no tiene ningún tipo de agregación
establecido, se aplica el tipo de agregación mínimo en la consulta. En el SQL no
es posible no tener ningún valor de agregación.
v Las funciones de agregado se interpretan como si se aplicasen a un valor en una
sola fila cuando estas funciones se utilizan en el contexto de detalle. Por
ejemplo, un informe de Report Studio tiene la propiedad Agrupar y resumir
automáticamente establecida en falso (false).
v La agregación de un elemento de consulta se basa en la expresión agregada
derivada de la definición del elemento.
Por ejemplo, quiere sumar este cálculo independiente:
[namespace].[Company].[debt]
/ [namespace].[Company].[credit]
El cálculo se agrega con esta expresión:
Total([namespace].[Company].[debt]) / Total([namespace].[Company].[credit])
v Los agregados escalares, también conocidos como agregados de ejecución,
clasificación y movimiento, se calculan para la granularidad del informe a no ser
que se especifique explícitamente la cláusula For.
v La granularidad de las funciones de agregado se define mediante agrupación
para determinantes o mediante claves de niveles correspondientes en el cubo.
Por ejemplo, Rank([namespace].[Company].[debt] se interpreta como
Rank([namespace].[Company].[debt] for Report).
Reglas para determinar el tipo de agregación automática:
Para cálculos independientes e incluidos, IBM Cognos Framework Manager utiliza
una de estas reglas para determinar el tipo de agregación.
Cálculo Tipo de agregación
Se basa en una expresión que contiene una
función de agregado como promedio,
máximo, mínimo o suma.
Tiene una operación if-then-else y la
condición if hace referencia a elementos de
hecho.
Calculado
Calculado
Capítulo 5. Modelado de metadatos relacionales 137

Cálculo Tipo de agregación
Hace referencia a un cálculo que utiliza
cualquier tipo excepto no soportado.
Tiene un tipo de agregación distinto a no
soportado.
Se basa en una expresión que hace referencia
a un asunto de consulta de modelo cuyo uso
está definido como hecho y cuyo tipo de
agregación está definido como promedio,
recuento, máximo, mínimo o suma, pero la
expresión del elemento de consulta no
utiliza una función de agregado.
Calculado
Calculado
Resumir
No se aplica ninguna de estas reglas. No soportado
Reglas para determinar el tipo de agregación de resumen:
Consulte más abajo las reglas para Resumir.
Para cálculos independientes e incluidos, IBM Cognos Framework Manager utiliza
una de estas reglas para determinar el tipo de agregación.
Cálculo Tipo de agregación
Es un hecho que contiene sólo una referencia
a un elemento de consulta cuyo tipo de
agregación es promedio, recuento, máximo,
mínimo o suma.
Tipo numérico o de intervalo. Suma
Tipo de hora, fecha y hora o fecha. Máximo
No se aplica ninguna de estas reglas. Recuento
Utiliza el tipo de agregación del elemento de
consulta.
propiedad Uso
La propiedad Uso identifica el uso que se pretende dar a los datos representados
por cada elemento de consulta. Durante la importación, la propiedad Uso se define
de acuerdo con el tipo de datos que los elementos de la consulta representan en el
origen de datos.
Debe comprobar que esta propiedad esté definida correctamente. Por ejemplo, si
importa una columna numérica que participa en una relación, la propiedad Uso
debe tener el valor identificador. Puede cambiar la propiedad.
Para los elementos de consulta relacionales, el valor de la propiedad Uso depende
del tipo de objeto de base de datos en el que se basa el elemento de consulta.
138 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

propiedad Uso Objeto de base de datos Descripción
Identificador key, index, date, datetime Representa una columna que
se usa para agrupar o
resumir los datos de una
columna Hecho con la que se
tiene una relación.
También representa una
columna indizada.
Hecho numeric, timeinterval
También representa una
columna del tipo date o time.
Representa una columna que
contiene datos numéricos
que pueden agruparse o
resumirse como Coste de
producto.
Atributo string Representa una columna que
no es un identificador ni un
hecho, como una descripción.
Propiedad Agregado regular
La propiedad Agregado regular identifica el tipo de agregación para el elemento
de consulta o el cálculo cuando se publica. Los usuarios pueden utilizar este valor
predeterminado para realizar cálculos sobre grupos de datos o aplicar otro tipo de
agregación.
Por ejemplo, si el valor de la propiedad Agregado regular del elemento de
consulta Cantidad corresponde a suma y está agrupado por Nombre de producto
en un informe, la columna Cantidad del informe muestra la cantidad total de cada
producto.
Se da soporte a los siguientes tipos de agregación para orígenes de datos
relacionales:
v Automático
v Promedio
v Calculado
v Recuento
v Recuento Distinct
v Máximo
v Mínimo
v Suma
Definición de reglas de agregado para medidas semiaditivas
Para las medidas de los metadatos relacionales con modelado dimensional, se
puede definir una regla de agregado para cada dimensión relacionada. Estas reglas
son adicionales a la propiedad Agregado regular y sirven para especificar cómo
deben añadirse las medidas semiaditivas en relación con la información de dicha
dimensión. Una medida semiaditiva es aquella que se va a sumar para algunas
dimensiones, pero no debe sumarse en otras dimensiones. Para las dimensiones en
las que la medida no es sumativa, debe especificarse una regla de agregación
distinta.
Capítulo 5. Modelado de metadatos relacionales 139

Si una expresión de medida contiene una función de agregación, la regla de
agregación para dicha medida se pasa por alto.
Las reglas de agregado se aplican en este orden:
v La propiedad Agregado regular se aplica a las dimensiones que se incluyen en
la consulta, pero que no están referenciadas en el cuadro de diálogo Reglas de
agregado.
v La agregación que se especifica en el cuadro de diálogo Reglas de agregado se
aplica a sus dimensiones especificadas, en el orden en el que se han especificado
las reglas.
v La agregación de nivel de informe que se especifica en la consulta.
Por ejemplo, el inventario se registra en el almacén de datos con saldos iniciales y
finales en la granularidad de mes. Si tiene que informar sobre el inventario para
diferentes periodos, debe aplicar un agregado que tome el valor del intervalo de
tiempo adecuado del periodo. En un saldo inicial, el valor es el último saldo del
mes anterior. En un saldo final, el valor es el último saldo del mes actual. En este
ejemplo, la medida de inventario tiene una propiedad Agregado regular de total y
una regla de agregado para la dimensión de tiempo con un valor de último.
Puede tener una sola regla de agregado para cada dimensión.
Nota: Debe haber una relación directa entre los asuntos de consulta subyacentes
sobre los que se crean la medida y la dimensión. Por ejemplo, examinemos las
dimensiones de tiempo y de medida de inventario:
Para definir una regla de agregado para el inventario final que genere el último
inventario final registrado para cualquier periodo determinado:
140 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Para que IBM Cognos aplique la regla de agregado de último en el inventario final
basada en la dimensión de tiempo, debe haber una relación directa entre los
asuntos de consulta subyacentes utilizados para crear la dimensión de tiempo y la
medida de inventario final. Esto es adicional a la relación de ámbito definida entre
la dimensión de medida de inventario y la dimensión de tiempo:
Si no existe una relación, al ejecutar una consulta que contiene la medida de
inventario final se genera el siguiente error:
RQP-DEF-0564 No se puede determinar la granularidad del hecho de la dimensión
semiaditiva '[Vista dimensional].[Dimensión de tiempo]' para la medida '[Vista
dimensional].[Inventario].[Inventario final]'. Compruebe que se haya definido una
relación entre los asuntos de consulta subyacentes sobre los que se construyen las
dimensiones.
Las medidas semiaditivas no están soportadas en los datos difusos. Los datos
difusos son datos multidimensionales en los que muchas de las combinaciones de
los valores de dimensión no tienen datos de hechos relacionados.
Para los metadatos de SAP BW, el valor de la propiedad Reglas de agregado es de
solo lectura. La propiedad Semiagregado en utiliza en su lugar.
Procedimiento
1. Pulse la medida con la que desea trabajar.
2. En el panel Propiedades, pulse el botón de puntos suspensivos (...) en la
propiedad Reglas de agregado.
3. Para añadir una dimensión a esta medida, pulse Añadir y seleccione la
dimensión.
Puede incluir un atajo a una dimensión si existe una relación de ámbito entre la
dimensión de medida y a dimensión regular.
4. Para especificar la operación de agregado, pulse el botón de puntos
suspensivos (...) del cuadro Reglas de agregado.
Se da soporte a las operaciones siguientes:
v Suma
v Mínimo
v Máximo
v Promedio
Capítulo 5. Modelado de metadatos relacionales 141

v Primero
v Último
5. Si desea cambiar el orden de las reglas de agregado, utilice los botones de
flecha.
6. Pulse Aceptar.
Resultados
Tras definir una regla de agregado, el icono de la medida cambia.
Propiedad Semiagregado
Para los metadatos relacionales, el valor de la propiedad Semiagregado está
definido como no soportado y es de solo lectura.
Si el valor se define como No soportado en IBM Cognos Framework Manager, el
comportamiento de semiagregado se pasa por alto en los estudios de IBM Cognos.
La propiedad Semiagregado no estará soportada en versiones posteriores. En su
lugar, utilice la propiedad Reglas de agregado para las medidas semiaditivas.
Determinación del uso y las reglas de agregación
Al utilizar los comandos Determinar uso y Determinar reglas de agregación en
IBM Cognos Framework Manager, restablecerá los valores de Uso y Agregado
regular a sus valores predeterminados. Esto sobrescribe todos los cambios que
haya realizado en estas propiedades.
Al generar valores de agregación, Framework Manager asigna un valor basado en
el valor de la propiedad Uso y en el tipo de objeto que es.
Valor de la propiedad Uso Valor de la propiedad Agregado regular
Identificador Recuento
Atributo No soportado
Hecho Suma
Pasos para determinar el uso y las reglas de agregación:
Procedimiento
1. En el panel Visor de proyectos, pulse una o más dimensiones o asuntos de
consulta.
2. En el panel Propiedades, pulse la pestaña Propiedad.
3. Cambie el valor de la propiedad Uso por desconocido.
4. Cambie el valor de la propiedad Agregado regular por no soportado.
5. Pulse Herramientas, Determinar uso.
6. Pulse Herramientas, Determinar reglas de agregación.
142 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Formateo de elementos de consulta
Se puede especificar cómo se visualizan los valores de elementos de consulta en los
informes. Utilice la propiedad Formato para elegir un tipo de formato, como texto,
fecha y moneda. Cada tipo de formato contiene propiedades que especifican con
más detalle cómo se visualizan los datos.
Por ejemplo, puede asignar el tipo de formato Moneda a un elemento de consulta
numérico y utilizar la propiedad Número de posiciones decimales del cuadro de
diálogo Formato de datos para especificar cuántas posiciones decimales se
visualizan en los informes.
Algunos caracteres dependen del idioma y solo se visualizan correctamente cuando
el entorno local soporta la fuente aplicable. Por ejemplo, para que los símbolos de
moneda de Japón se visualicen correctamente, el entorno local se debe establecer
en japonés.
Si IBM Cognos Framework Manager no muestra la moneda que necesita, debe
asegurarse de instalar los paquetes de idioma adecuados para soportar los
símbolos de moneda. Por ejemplo, para que se visualice el símbolo de moneda de
la India (rupia), debe ejecutar un sistema operativo o instalar un paquete de
idioma que pueda mostrar este símbolo. El sistema operativo japonés o el idioma
japonés es uno de los que puede mostrar el símbolo de moneda de la India.
Puede definir propiedades para varios elementos de consulta a la vez. Sin
embargo, si los elementos de consulta tienen diferentes tipos de formato, se
reemplazan todas las propiedades que se habían especificado previamente y se
utilizan los valores predeterminados del origen de datos. Si los tipos de formato
originales de los elementos de consulta seleccionados son los mismos, todas las
propiedades para los elementos de consulta seleccionados se establecen
idénticamente.
Por ejemplo, para utilizar el mismo separador decimal para dos elementos de
consulta y mantener diferente el número de decimales, cada elemento de consulta
se debe cambiar individualmente. Si se seleccionan ambos y se cambian a la vez,
todas las propiedades que incluyen el número de decimales se establecen
idénticamente para ambos elementos de consulta.
Pasos para dar formato a un elemento de consulta
Procedimiento
1. En el panel Visor de proyectos, pulse el elemento de consulta al que desea dar
formato.
2. En la pestaña Propiedades del panel Propiedades, pulse la propiedad Formato.
3. Seleccione el tipo de formato adecuado.
4. En el cuadro Propiedades, seleccione o escriba el valor de propiedad
correspondiente.
5. Pulse Aceptar.
Definición de controles de solicitud
Las solicitudes ayudan a los usuarios a encontrar rápidamente la información que
necesitan en un informe. Generalmente, se definen solicitudes en informes. Aunque
puede cambiar el comportamiento de solicitudes en los estudios modificando la
definición de las dimensiones o los asuntos de consulta en el modelo.
Capítulo 5. Modelado de metadatos relacionales 143

Es útil para los elementos de consulta, como ProductTypeCode, cuyos valores no
se muestran en un informe pero son útiles para filtrar datos. En general, es mejor
definir las solicitudes de introducir en los informes que utilizan las características
de solicitud adicionales. Sin embargo, los usuarios no pueden modificar algunas
variables. Para estas variables, puede utilizar IBM Cognos Framework Manager en
lugar de los informes para definir solicitudes de introducir.
Las propiedades de información de solicitud establecidas en Framework Manager
proporcionan la posibilidad de controlar el filtrado y las solicitudes
predeterminados. Las propiedades se utilizan por:
v Query Studio para crear una expresión de filtro y establecer los elementos de
uso y visualización en una solicitud o consulta de solicitud
v La herramienta Crear página de solicitud de Report Studio para crear una
expresión de filtro y establecer los elementos de uso y visualización en una
solicitud y consulta de solicitud
v Solicitudes generadas de Report Studio para establecer los elementos de uso y
visualización en la solicitud y consulta de solicitud
La sintaxis para utilizar una solicitud como valor es
??
Puede utilizar las solicitudes en
v Mapas de parámetros
v Parámetros de sesión
v Argumentos de procedimiento almacenado
v Expresiones, incluidos los filtros, los cálculos y las relaciones
Por ejemplo, un procedimiento almacenado devuelve todas las filas con un número
de producto específico. En lugar de utilizar el número de producto como
argumento para el procedimiento almacenado, puede utilizar una solicitud, como
?Product_Number?.
Para ver ejemplos de solicitudes, consulte: “Crear solicitudes con macros de
consulta” en la página 162 y “Ejemplo: Uso de solicitudes con un procedimiento
almacenado” en la página 83.
Para obtener más información acerca de la creación de solicitudes, consulte: Report
Studio Guía de usuario.
Pasos para definir un control de solicitud
Procedimiento
1. Pulse el elemento de consulta.
2. En el panel Propiedades, pulse la pestaña Propiedad.
3. Pulse el signo más (+) situado junto a la propiedad Información de solicitud.
Es una propiedad de elemento de consulta compuesto.
4. Modifique las propiedades siguiente para reflejar el comportamiento que desee.
Objetivo Propiedad
Definir el tipo de control de solicitud que se
va a generar cuando se ejecute el informe.
144 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario
Tipo de solicitud

Objetivo Propiedad
Definir la solicitud generada como parte de
una serie de solicitudes en cascada
generadas.
Especifica qué elemento de consulta se
muestra al usuario del informe en la
solicitud.
Los valores de la solicitud son valores de
datos de elemento de consulta.
Cada valor de la solicitud se asocia con un
valor en el elemento de consulta
especificado en la propiedad Usar referencia
de elemento.
Especifica qué elemento de consulta se pasa
de la solicitud al filtro.
Cada valor se asocia con un valor del
elemento de consulta especificado en la
propiedad Referencia de elemento de
visualización.
Especifica qué elemento de consulta se
utiliza en la expresión de filtro para
recuperar datos.
Referencia de elemento de cascada
Referencia de elemento de visualización
Utilizar referencia de elemento
Referencia de elemento de filtro
Propiedad Tipo de solicitud
La propiedad Tipo de solicitud define el tipo de control de solicitud que se genera
al ejecutar el informe, como un cuadro de edición o una lista desplegable.
El valor predeterminado de esta propiedad es Determinado por el servidor.
Nota: Ahora se procesan los tipos de solicitud establecidos en los atributos. El
usuario del informe verá la solicitud que coincide con el tipo de solicitud del
atributo. Dado que en la versión anterior no se procesaban los tipos de solicitud en
los atributos, puede haber alguna diferencia.
Valor Control de solicitud
Determinado por el servidor El tipo de control de solicitud se basa en
información del servidor, como el tipo de
datos del elemento de consulta.
Cuadro de edición Un sencillo cuadro de texto. Si el tipo de
datos de la columna es fecha o fecha y hora,
este valor genera un control de fecha o de
fecha y hora, además del cuadro de texto.
Seleccionar fecha Control de fecha con una interfaz de
calendario.
Capítulo 5. Modelado de metadatos relacionales 145

Valor Control de solicitud
Seleccionar fecha y hora Control de fecha y hora con una interfaz de
calendario.
En el caso de metadatos de SAP BW, este
valor no es relevante.
Seleccionar intervalo Control de intervalo de fecha y hora.
En el caso de metadatos de SAP BW, este
valor no es relevante.
Seleccionar hora Control de hora que filtra datos basándose
en el periodo de tiempo seleccionado. Por
ejemplo, si define una solicitud Seleccionar
hora para Order Time, el usuario puede
utilizar el control de hora para mostrar
todos los pedidos realizados después de la
1:00 o todos los pedidos realizados entre las
10:00 y las 11:00.
Si hace referencia a un miembro de tiempo,
deberá utilizar sólo los valores exactos.
Si utiliza un rango, los puntos finales del
rango deben corresponderse con valores del
origen de datos.
Seleccionar valor Lista desplegable.
Seleccionar mediante búsqueda Control de lista para que los usuarios
puedan buscar valores.
En el caso de metadatos de SAP BW, este
valor no es relevante.
Seleccionar mediante árbol Control de solicitud de árbol para solicitudes
basadas en un nodo de la jerarquía.
Propiedad de referencia de elemento de cascada
La propiedad Referencia de elemento de cascada indica que la solicitud generada
forma parte de una serie de solicitudes en cascada generadas. El elemento de
consulta al que se hace referencia en esta propiedad es el elemento padre de la
cascada. El sistema solicita al usuario el elemento en cascada antes de solicitar el
elemento de consulta actual.
Por ejemplo, si desea solicitar Línea de producto y luego Producto dentro de la
línea seleccionada, defina la propiedad Referencia de elemento de cascada del
elemento de consulta Producto en Línea de producto.
Propiedades Referencia de elemento de visualización y Utilizar
referencia de elemento
La propiedad Referencia de elemento de visualización especifica qué elemento de
consulta se muestra al usuario en la solicitud. La propiedad Utilizar referencia de
elemento especifica qué elemento de consulta se pasa de la solicitud al filtro. Cada
valor de la lista de elementos de visualización se asocia con un valor del elemento
de consulta especificado en la propiedad Utilizar referencia de elemento.
Por ejemplo, si desea que la solicitud muestre Nombre de país aunque se utilice el
Código de país para recuperar los datos. Establezca la propiedad Referencia de
elemento de visualización en Nombre de país y la propiedad Utilizar referencia
146 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

de elemento en Código de país. La solicitud de Nombre de país facilita que el
usuario del informe seleccione los valores necesarios. Sin embargo, la utilización
del Código de país en el filtro es más eficiente para la recuperación de datos.
Estas propiedades se utilizan por
v Query Studio para crear una expresión de filtro y establecer los elementos de
uso y visualización en una solicitud o consulta de solicitud
v La herramienta Crear página de solicitud de Report Studio para establecer los
elementos de utilización y visualización en una solicitud y consulta de solicitud
v Solicitudes generadas de Report Studio para establecer los elementos de uso y
visualización en la solicitud y consulta de solicitud
Nota: Los valores de las propiedades Utilizar referencia de elemento y Referencia
de elemento de filtro deben ser compatibles. De lo contrario, el usuario del
informe puede recibir resultados inesperados. Para obtener más información,
consulte: “Propiedad de referencia de elementos de filtro”.
Valor predeterminado: Si no se establece ningún valor, las propiedades serán de
forma predeterminada el nombre del elemento de consulta.
Estas propiedades solo se utilizan para los controles de solicitud de dirigidos por
datos cuya propiedad Tipo de solicitud se establece en Seleccionar valor o
Seleccionar mediante búsqueda.
Propiedad de referencia de elementos de filtro
La propiedad Referencia de elemento de filtro identifica el elemento de consulta
utilizado cuando Report Studio o Query Studio generan un filtro. Esta propiedad
ayuda a crear consultas más eficientes, ya que asegura que un filtro utiliza una
columna numérica indexada en lugar de una columna de cadenas no indexadas.
Por ejemplo, el autor de un informe desea crear un filtro para el elemento de
consulta Nombre de país. Por lo tanto, establece la propiedad Referencia de
elemento de filtro para que utilice el Código de país en lugar del Nombre de país
en todos los filtros que utilizan el elemento de consulta Nombre de país.
En otro ejemplo, el autor de un informe desea crear un filtro para el elemento de
consulta Código de país que se visualiza en la tabla Pedidos. Usted desea que el
filtro utilice el Código de país en la tabla País porque hay menos filas para leer en
la tabla País, por lo que establece la Referencia de elemento de filtro del modelo
en Country.Country Code.
Esta propiedad se utiliza por:
v Query Studio para crear una expresión de filtro
v La herramienta Crear página de solicitud de Report Studio para crear una
expresión de filtro
Valor predeterminado: si no se establece ningún valor, la propiedad toma de forma
predeterminada el nombre del elemento de consulta.
Utilización de las propiedades Referencia de elemento de filtro y
Utilizar referencia de elemento
Los valores de las propiedades Referencia de elemento de filtro y Utilizar
referencia de elemento deben ser compatibles. El valor de la propiedad Utilizar
referencia de elemento debe ser del tipo esperado en la propiedad Referencia de
Capítulo 5. Modelado de metadatos relacionales 147

elemento de filtro. De lo contrario, el usuario del informe puede recibir resultados
inesperados. Esto puede ocurrir cuando un usuario de informe crea un filtro sin
crear una página de solicitud.
En un modelo de ejemplo, la propiedad Utilizar referencia de elemento se
establece en Número de empleado y la propiedad Referencia de elemento de
filtro es Nombre de empleado. En Report Studio, el autor de un informe crea el
siguiente filtro sin crear una página de solicitud:
Reference.EmployeeName in ?parm1?
Report Studio generará automáticamente solicitudes cuando cree un filtro sin crear
una página de solicitud. Debido a que se genera la solicitud, Report Studio utiliza
las propiedades Información de solicitud del elemento de consulta Nombre de
empleado en el modelo de Framework Manager.
Utilizar referencia de elemento indica que los valores que se pasan al filtro son
números de empleados. Referencia de elemento de filtro filtra los datos según el
Nombre de empleado. El filtro es el siguiente: Reference].[Employee Name] in
("1", "2"). Puesto que no hay ningún valor para Nombre de empleado que sea
"1" o "2", el informe estará en blanco.
Utilización de Referencia de elemento de filtro para metadatos
relacionales modelados dimensionalmente
Para metadatos relacionales modelados dimensionalmente, Información de
solicitud se especifica en el atributo con el rol de _memberCaption, en lugar del
nivel. Aunque se establezcan en el atributo, las propiedades Información de
solicitud se procesan como si estuvieran en el nivel. De forma predeterminada,
cuando el nivel se incluye en un informe, se solicita a los usuarios que
especifiquen los MUN en la solicitud del nivel. Para especificar los valores de
título en su lugar, establezca la propiedad Referencia de elemento de filtro del
atributo en sí misma. Cuando se aplique el filtro solicitado, los valores filtrados se
basarán en los valores de atributo.
Por ejemplo, el nivel Línea de producto tiene un atributo Línea de producto con el
rol _memberCaption. Si el valor de la propiedad Referencia de elemento de filtro
se establece en Línea de producto, se solicita a los usuarios del informe que
especifiquen valores para Línea de producto. Si el valor de la propiedad
Referencia de elemento de filtro se deja en blanco, se solicita a los usuarios que
especifiquen los MUN.
Nota: No utilice la propiedad Referencia de elemento de filtro con el tipo de
solicitud Seleccionar mediante árbol. Debido a que una solicitud Seleccionar
mediante árbol solo se puede filtrar en un nivel o jerarquía, si se establece la
propiedad Referencia de elemento de filtro producirá un error.
Prueba de solicitudes
Cuando se prueba un objeto de modelo que hace referencia a una solicitud IBM
Cognos Framework Manager le pide que especifique el valor adecuado.
Framework Manager utiliza este valor mientras dure la sesión o hasta que se borre
el valor de la solicitud.
Puede cambiar el valor de la sesión para los valores de solicitud en el cuadro de
diálogo Opciones. Este cuadro de diálogo aparece cuando se modifica una
dimensión o un asunto de consulta o bien cuando se define un cálculo, un filtro,
148 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

un conjunto de consultas o una relación compleja. Puede cambiar el valor de
solicitud en el momento en que prueba la expresión que hace referencia a dicho
valor.
Si selecciona la casilla de verificación Solicitar siempre valores durante la prueba
en el cuadro de diálogo Solicitud, Framework Manager le solicita un objeto cada
vez que pruebe el objeto. Al actualizar el objeto o realizar un recuento, Framework
Manager utiliza el valor de solicitud existente, si lo hay.
Una solicitud en un elemento de consulta en un asunto de consulta de modelo se
asocia solo con un elemento de consulta. Una solicitud en un elemento de consulta
en un asunto de consulta de orígenes de datos se asocia con todo el asunto de
consulta y, por lo tanto, la solicitud se muestra cuando se prueba cualquier
elemento de consulta en el asunto de consulta.
Conversión de elementos en medidas
Puede convertir un elemento de consulta de una dimensión de medida de nuevo
en medida
Reglas de negocio
Para convertir una medida en un elemento de consulta, consulte: “Conversión de
medidas en elementos de consulta” en la página 118.
Procedimiento
1. Efectúe una doble pulsación en la dimensión de medida que contiene el
elemento de consulta.
2. Pulse la pestaña Dimensión de medida.
3. Pulse con el botón derecho en el elemento de consulta y pulse Convertir en
medida.
4. Pulse Aceptar.
Puede añadir reglas de negocio a las dimensiones y a los asuntos de consulta del
modelo para refinar los datos recuperados y asegurarse de que los usuarios tienen
disponible la información correcta.
La creación de reglas de negocio y su almacenamiento en el modelo en lugar de
hacerlo en informes tiene muchas ventajas. Se ahorra tiempo porque tanto usted
como sus usuarios no tendrán que volver a crear reglas de negocio cada vez que
las necesiten. Las reglas de negocio aseguran la coherencia porque todos los
usuarios utilizan las mismas definiciones. Por ejemplo, Margen pequeño significa
lo mismo en toda la organización. Son fáciles de actualizar porque las reglas de
negocio se mantienen centralmente, por lo que todos los informes se actualizan
automáticamente cuando las reglas evolucionan. Por ejemplo, si la definición de
Margen pequeño cambia, todos los informes que utilizan el cálculo de Margen
pequeño se actualizan automáticamente. Las reglas de negocio mejoran la
seguridad.
Por ejemplo, puede
v Añadir cálculos para que los usuarios puedan incluir datos calculados en sus
informes. Consulte: “Creación de cálculos” en la página 150.
v Crear y aplicar filtros para limitar los datos que un asunto de consulta recupera.
Consulte: “Creación de filtros” en la página 152.
Capítulo 5. Modelado de metadatos relacionales 149

v Añadir solicitudes que se visualizarán automáticamente cuando se utilice una
dimensión o asunto de consulta en un informe; se solicitará a los usuarios de
informes que filtren los datos. Consulte: “Definición de controles de solicitud”
en la página 143.
v Utilizar parámetros de sesión y mapas de parámetros en macros para resolver
expresiones dinámicamente. Consulte: “Creación de parámetros de sesión” en la
página 160, “Creación de mapas de parámetros” en la página 157, “Crear
solicitudes con macros de consulta” en la página 162.
v Crear un filtro de seguridad para controlar los datos que se muestran a los
usuarios cuando configuran sus informes. Consulte: “Adición de seguridad de
datos” en la página 255.
Creación de cálculos
Puede crear cálculos para proporcionar a los usuarios los valores calculados que
utilizan regularmente. Los cálculos pueden utilizar elementos de consulta,
parámetros, variables, miembros calculados, expresiones y componentes de
expresiones como, por ejemplo, funciones.
Los signos de puntuación, como el signo de interrogación (?), deben estar en el
código de caracteres ASCII de 7 bits. Si escribe un carácter de puntuación desde un
teclado habilitado para varios bytes, asegúrese de que escribe la representación
ASCII de 7 bits del carácter. Por ejemplo, escriba Alt+063 para el signo de
interrogación.
Evite emplear caracteres que se utilizan como operadores de expresiones en el
nombre del cálculo. Se podrían producir errores de sintaxis cuando se evalúa la
expresión. Por ejemplo, un cálculo denominado Margen * 10 genera errores cuando
se utiliza en una expresión como [Margen * 10]< 20.
En las expresiones, es posible que un operador o función necesiten que los
operandos sean de un tipo dimensional en particular. Cuando un operando no es
del tipo necesario, se pueden aplicar una o varias reglas de conversión forzada
para convertir el operando al tipo apropiado. Puesto que las reglas de conversión
forzada no se aplican a las expresiones de los asuntos de consulta de modelo,
asegúrese de que estas expresiones sean válidas sin depender de las reglas de
conversión forzada. Para obtener más información sobre las reglas de conversión
forzada, consulte: IBM Cognos Report Studio Guía del usuario.
Si inserta en el cálculo una función definida por el usuario importada, asegúrese
de que el nombre de función no repita ningún nombre específico del proveedor.
Por ejemplo, si el nombre de función definido por el usuario es CHAR recibirá un
error al probar la función en el cuadro de diálogo Definición de cálculo porque
este nombre se considera idéntico a char en Microsoft SQL Server. Para obtener
información sobre los nombres de función utilizados en la base de datos, consulte
la documentación del producto de base de datos.
En el momento de la consulta, IBM Cognos Framework Manager devuelve un
valor nulo para cualquier cálculo que contenga un divisor cuyo valor sea cero.
Framework Manager no puede detectar errores de división por cero en funciones
como average y mod, porque el operador de división no es explícito.
Framework Manager soporta cálculos autónomos y cálculos incluidos.
v Utilice un cálculo independiente cuando desee reutilizar la expresión o controlar
el orden de las operaciones utilizando el valor Calculado en la propiedad
150 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Agregado regular. Para obtener más información, consulte: “Establecimiento del
orden de las operaciones para cálculos de modelo” en la página 337.
Puede aplicar un cálculo independiente a una o varias dimensiones o asuntos de
consulta para proporcionar datos calculados a un informe, o incluirlo en un
paquete para que esté disponible para los usuarios. Si se mueve un cálculo
independiente o su atajo a una carpeta, se pueden organizar mejor los objetos de
modelo.
No puede utilizar cálculos autónomos en Analysis Studio. En su lugar, utilice un
cálculo incluido en la dimensión de medida.
v Emplee un cálculo incluido cuando desee utilizar un cálculo con una sola
dimensión o asunto de consulta.
Puede crear un cálculo incluido al modificar un asunto de consulta de orígenes
de datos relacionales, un asunto de consulta de modelo o una dimensión.
Si comienza con un cálculo incluido, luego podrá convertirlo en una expresión
autónoma que podrá aplicar a otras dimensiones o asuntos de consulta.
Sugerencia: Pulse con el botón derecho del ratón en la expresión de cálculo de
la pestaña Cálculos y pulse Convertir a cálculo independiente.
Cuando incluya un cálculo, el asunto de consulta de orígenes de datos debe
tener una relación con cualquier asunto de consulta al que la expresión haga
referencia. Esta relación es necesaria aunque la expresión haga referencia a un
asunto de consulta de modelo basado en la misma tabla que el asunto de
consulta de orígenes de datos en la que incluye la expresión.
Pasos para crear un cálculo
Procedimiento
1. Realice una de las siguientes acciones:
v Para crear un cálculo independiente, pulse el espacio de nombres o carpeta y
pulse Acciones, Crear, Cálculo.
v Para crear un cálculo incluido para una dimensión de medida, efectúe una
doble pulsación en la dimensión. En la pestaña Dimensión de medida, pulse
Añadir.
v Para crear un cálculo incluido para una dimensión regular, efectúe una doble
pulsación en la dimensión. En la pestaña Dimensión, seleccione una
jerarquía y pulse Añadir.
v Para crear un cálculo incluido para un asunto de consulta de orígenes de
datos, efectúe una doble pulsación en el asunto de consulta de orígenes de
datos. En la pestaña Cálculos, pulse Añadir.
v Para crear un cálculo incluido para un asunto de consulta de modelo, efectúe
una doble pulsación en el asunto de consulta de modelo. En la pestaña
Definición de asunto de consulta, pulse Añadir.
Se muestra el diálogo Definición de cálculo.
2. Escriba un nombre para el cálculo en el cuadro Nombre.
3. Defina la expresión.
Objetivo Acción
Añadir elementos En la pestaña Modelo, pulse un elemento de
consulta, filtro o cálculo y pulse la flecha.
Añadir funciones En la pestaña Funciones, elija un
componente y pulse la flecha.
Capítulo 5. Modelado de metadatos relacionales 151

Objetivo Acción
Añadir parámetros En la pestaña Parámetros, pulse un
parámetro y pulse la flecha.
Recuperar un parámetro y mostrar un
número determinado de filas
Pulse el botón de opciones, seleccione la
casilla de verificación Limitar el número
máximo de filas que se devolverán y
escriba el número de filas que desee que se
devuelvan.
Este valor no mejora el rendimiento de la
recuperación de datos cuando se prueban
dimensiones, asuntos de consulta y
conjuntos de consulta.
Reemplazar los parámetros de la sesión Pulse el botón de opciones, pulse Definir,
especifique un valor en el campo
Reemplazar valor y pulse Aceptar.
Reemplazar valores de solicitud Pulse el botón de opciones y después pulse
Solicitudes.
Aparece el cuadro de diálogo Gestor de
solicitudes de modelos, que muestra todas
las peticiones, y sus valores, que están en el
modelo.
4. Para probar el cálculo, pulse el botón de prueba .
Puede probar solo los cálculos que contienen elementos de consulta. Si un
cálculo contiene una función (por ejemplo, _add_days), el botón Probar
muestra no está disponible.
Sugerencia: Si en el cálculo hay una expresión no válida, consulte el cuadro de
Sugerencias en el editor de expresiones para obtener más información.
5. Pulse Aceptar.
6. Modifique la propiedad Tipo de datos para identificar el tipo de datos que
devuelve el cálculo.
El estudio de IBM Cognos utiliza esta información para dar formato a los datos
que devuelve el cálculo.
Resultados
También puede estar interesado en los temas siguientes:
v Apéndice C, “Uso del editor de expresiones”, en la página 395
v “Creación de parámetros de sesión” en la página 160
v “Prueba de dimensiones” en la página 120
Creación de filtros
Un filtro es una expresión que especifica las condiciones que las filas o las
instancias deben cumplir para que se puedan recuperar para la dimensión, el
152 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

asunto de consulta, el cálculo o el informe al que se aplica el filtro. Un filtro
devuelve un valor booleano para limitar las filas devueltas por una dimensión o
un asunto de consulta.
Por ejemplo, puede utilizar la función in_range para crear un filtro que recupere
datos de productos incorporados en un intervalo de tiempo específico. La sintaxis
para este ejemplo tiene el aspecto siguiente:
[gosales_goretailers].[Products].[Introduction
date]
in_range {Feb 14, 1999 : July 14, 2007}
Nota: Cuando se utiliza una función de fecha u hora, se debe utilizar un reloj de
24 horas. IBM Cognos Framework Manager no soporta "a.m." o "p.m." en
expresiones. Por ejemplo, utilice 20:00 para expresar 8 p.m.
Puede restringir los datos representados por dimensiones o asuntos de consulta de
un proyecto mediante la creación de un filtro de seguridad. El filtro de seguridad
controla los datos que los usuarios pueden ver cuando configuran sus informes.
Puede aplicar reguladores para limitar los datos que recuperan las consultas de un
paquete.
Framework Manager soporta filtros autónomos y filtros incluidos.
v Utilice un filtro autónomo cuando desee reutilizar la expresión.
Puede añadir un filtro autónomo a una o varias dimensiones o a asuntos de
consulta para limitar los datos que la consulta recupera cuando, en un informe,
se utiliza la dimensión o el asunto de consulta filtrados, o cuando se incluye en
un paquete para que esté disponible para los usuarios. Si se mueve un filtro
autónomo o su atajo a una carpeta, se pueden organizar mejor los objetos de
modelo.
v Emplee un filtro incluido cuando desee utilizar un filtro con una sola dimensión
o asunto de consulta.
Puede crear un filtro incluido al modificar una dimensión, un asunto de consulta
de orígenes de datos relacionales o un asunto de consulta de modelo.
Si empieza por un filtro incluido, luego podrá convertirlo en una expresión
autónoma que podrá aplicar a otras dimensiones o asuntos de consulta.
Sugerencia: Pulse con el botón derecho del ratón en la expresión de filtro en la
pestaña Filtros y pulse Convertir a filtro independiente.
Cuando se incluye un filtro, el asunto de consulta de orígenes de datos debe
tener una relación con cualquier asunto de consulta al que la expresión hace
referencia. Esta relación es necesaria aunque la expresión haga referencia a un
asunto de consulta de modelo basado en la misma tabla que el asunto de
consulta de orígenes de datos en la que incluye la expresión.
Para crear un filtro en un asunto de consulta no relacionado, efectúe una de las
acciones siguientes:
– Asegúrese de que haya una ruta de unión entre el nuevo asunto de consulta y
el que contiene el filtro.
– Base el filtro incluido en un elemento de consulta que esté basado en el
asunto de consulta de orígenes de datos que desee.
– Convierta el cálculo en un filtro autónomo, para que no forme parte del
asunto de consulta.
– Cree un filtro autónomo que haga referencia al objeto incluido.
Capítulo 5. Modelado de metadatos relacionales 153

Pasos para crear filtros
Procedimiento
1. Realice una de las siguientes acciones:
v Para crear un filtro autónomo, pulse el espacio de nombres o la carpeta y
pulse Acciones, Crear, Filtro.
v Si desea crear un filtro incluido, efectúe una doble pulsación en la dimensión
o asunto de consulta que contendrá el filtro, pulse la pestaña Filtros y,
después, pulse Añadir.
2. En el cuadro Nombre, escriba un nombre para el filtro.
3. Defina la expresión.
Sugerencia: Si en el filtro hay una expresión no válida, consulte el cuadro de
Sugerencias en el editor de expresiones para obtener más información.
Objetivo Acción
Añadir elementos de consulta y filtros En la pestaña Modelo, arrastre los objetos
que desee al cuadro Definición de
expresión.
Añadir funciones En la pestaña Funciones, arrastre las
funciones al cuadro Definición de
expresión.
Añadir parámetros En la pestaña Parámetros, arrastre los
parámetros al cuadro Definición de
expresión.
Recuperar un parámetro y mostrar un
número determinado de filas
Pulse el botón de opciones, seleccione la
casilla de verificación Limitar el número
máximo de filas que se devolverán y
escriba el número de filas que desee que se
devuelvan.
Este valor no mejora el rendimiento de la
recuperación de datos cuando se prueban
dimensiones, asuntos de consulta y
conjuntos de consulta.
Reemplazar los parámetros de la sesión Pulse el botón de opciones, pulse Definir,
especifique un valor en el campo
Reemplazar valor y pulse Aceptar.
Reemplazar valores de solicitud Pulse el botón de opciones y después pulse
Solicitudes.
4. Pulse Aceptar.
154 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario
Aparece el cuadro de diálogo Gestor de
solicitudes de modelos, que muestra todas
las peticiones, y sus valores, que están en el
modelo.

Resultados
Puede aplicar reguladores para limitar los datos que recuperan las consultas de un
paquete. Para obtener más información, consulte: “Reguladores” en la página 304.
También puede estar interesado en los temas siguientes:
v “Adición de seguridad de datos” en la página 255
v Apéndice C, “Uso del editor de expresiones”, en la página 395
v “Creación de mapas de parámetros” en la página 157
v “Creación de parámetros de sesión” en la página 160
v “Prueba de asuntos de consulta o conjuntos de consultas” en la página 92
v “Solicitudes obligatorias y opcionales” en la página 165
Aplicación de filtros
Para aplicar un filtro, debe modificar la dimensión, el asunto de consulta de
orígenes de datos o el asunto de consulta de modelo. El asunto de consulta debe
contener los elementos de consulta a los que el filtro hace referencia, o tener una
ruta de relación para los asuntos de consulta que contienen los elementos de
consulta.
Puede incluir un filtro independiente en dimensiones o asuntos de consulta, pero si
desea aplicar un uso diferente para cada filtro incluido, debe crear versiones
distintas del filtro independiente. De lo contrario, se podría solicitar a los usuarios
que rellenasen una solicitud que se había pensado como opcional, si hay alguna
instancia en la que el uso se ha establecido como obligatorio. Para obtener
información sobre solicitudes obligatorias y opcionales, consulte: “Solicitudes
obligatorias y opcionales” en la página 165.
Por ejemplo, en el asunto de consulta A, incluye un filtro independiente y lo define
como opcional. En el asunto de consulta B, lo define como obligatorio. Cuando los
usuarios crean un informe que utiliza ambos asuntos de consulta, se les solicita
que elijan valores en ambos filtros, incluso en el definido como opcional. Todas las
instancias del filtro se consideran obligatorias cuando se utilizan en la misma
consulta. La solución es crear diferentes versiones del filtro, cada una con su
propio nombre.
Pasos para crear un filtro
Procedimiento
1. Cree un filtro.
2. Seleccione el filtro y pulse Acciones, Editar definición.
3. Pulse la pestaña Filtros y arrastre el filtro que ha creado al cuadro Filtros.
4. Seleccione un valor de uso para el filtro.
Valor de uso Descripción
Siempre Utilice este uso para que los datos
especificados se filtren de todos los
informes. Por ejemplo, la información
obsoleta de la compañía que se sigue
almacenando, pero sobre la que no hace
falta informar.
Siempre es el valor de uso predeterminado.
Capítulo 5. Modelado de metadatos relacionales 155

Valor de uso Descripción
Solo modo de diseño Recupera un pequeño subconjunto de datos
para el informe de ejemplo. Utilice este valor
de uso cuando no necesite ver todos los
datos; por ejemplo, cuando pruebe un
asunto de consulta.
Para aplicar los filtros del modo de diseño
en Framework Manager, seleccione la opción
Aplicar todos los filtros de modo de diseño
durante las pruebas. Esta opción está
disponible en la pestaña Probar valores.
Los usuarios pueden necesitar el filtro de
modo de diseño en Query Studio cuando
desean centrarse en el diseño y el formato
de un informe y no recuperar todos los
datos mientras trabajan. Para acceder al
filtro del modo de diseño en Query Studio,
ejecute el informe con un número limitado
de datos.
Opcional Especifica que el filtro es opcional. Se solicita
al usuario que filtre los datos y puede dejar
la solicitud en blanco. Si la solicitud se deja
en blanco, Framework Manager pasa por
alto el filtro y recupera todos los datos para
la dimensión y el asunto de consulta.
La sintaxis ??es necesaria para las
solicitudes opcionales.
Utilice este valor de uso si los usuarios
desean controlar cuándo se aplica el filtro.
Por ejemplo, desean ver datos de un país
algunas veces y los datos de todos los países
otras veces. Un filtro opcional para un país
tiene el aspecto siguiente:
([GeoNamespace].[Countries]
.[CountryName]
=
?WhichCountry?)
5. Si desea ver el SQL, pulse la pestaña Información sobre consultas.
6. Pulse Aceptar.
Ejemplo: mostrar el nombre de moneda de cada país
Supongamos que desea crear una consulta que muestre el nombre de moneda de
un país determinado. Para ello, debe crear un filtro que devuelva datos para un
código de país determinado y aplicar el filtro al asunto de consulta de modelo que
recupera el nombre de moneda de cada país.
En el ejemplo siguiente, se utiliza un origen de datos relacionales.
Procedimiento
1. Abra el modelo go_sales sample. Se encuentra en c10_location/webcontent/
samples/Models/go_sales/go_sales.cpf
156 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

2. Cree un filtro para limitar la recuperación de datos a solo aquellos códigos de
país de la tabla de tipo de cambio cuyo valor sea 2.
v Pulse la carpeta Filtros y, después, en Acciones, Crear, Filtro y el nombre del
filtro nuevo ConversionRateCountryCode.
v Pulse la pestaña Modelo.
v En el cuadro Componentes disponibles, abra la carpeta de vista Base de
datos y abra la carpeta GoSales.
v Añada el elemento de consulta Código de país del asunto de consulta Tipo
de cambio al cuadro Definición de expresión y escriba ='2' al final de a
expresión.
v Pulse Aceptar.
3. Cree un asunto de consulta de modelo denominado Código ISO.
v En el cuadro Objetos de modelo disponibles, abra la carpeta de vista Base
de datos.
v Añada el elemento de consulta País y el elemento de consulta de código de
tres letras ISO del asunto de consulta País al cuadro Elementos de consulta y
cálculos.
4. Aplique el filtro ConversionRateCountryCode:
v Pulse la pestaña Filtros.
v Abra la carpeta Filtros y arrastre ConversionRateCountryCode al cuadro
Filtros.
5. Pulse la pestaña Información de consultas.
El SQL generado contiene el filtro aunque no afecte al conjunto de resultados.
6. Cambie el uso del filtro ConversionRateCountryCode a Opcional:
v Pulse la pestaña Filtros.
v Pulse el botón de puntos suspensivos (...) en Uso para el filtro
ConversionRateCountryCode y pulse Opcional.
7. Si desea ver el SQL, pulse la pestaña Información sobre consultas.
8. Pulse Aceptar.
Creación de mapas de parámetros
Utilice parámetros para crear asuntos de consulta condicionales que permitan
realizar sustituciones al ejecutar el informe. Los mapas de parámetros son objetos
que almacenan pares de clave-valor.
Los mapas de parámetros son similares a tablas de búsqueda de origen de datos.
Cada mapa de parámetros tiene dos columnas, una para la clave y otra para el
valor que la clave representa. Puede especificar manualmente las claves y los
valores, importarlos de un archivo o basarlos en elementos de consulta del modelo.
También puede exportar mapas de parámetros a un archivo. Para modificar el
mapa de parámetros, puede exportar los valores del mapa a un archivo, realizar
las adiciones o modificaciones y luego volverlo a importar a IBM Cognos
Framework Manager. Esto es especialmente útil para manipular mapas de
parámetros grandes y complejos.
Todas las claves del mapa de parámetros deben ser exclusivas para que
Framework Manager pueda recuperar coherentemente el valor correcto. No
coloque comillas alrededor de un valor de parámetro. Puede utilizar comillas en la
expresión en la que utiliza el parámetro.
Capítulo 5. Modelado de metadatos relacionales 157

El valor de un parámetro puede ser otro parámetro. Sin embargo, debe especificar
todo el valor entre signos de número (#). El límite para anidar parámetros en
forma de valores es cinco niveles.
Cuando se utiliza un mapa de parámetros como argumento para una función, se
debe utilizar un signo de porcentaje (%) en lugar de un signo de dólar ($).
Asigne un alias a un elemento de consulta que utiliza un mapa de parámetros
como parte de su nombre y para añadir nombres multilingües al objeto en la
pestaña Idioma (panel Propiedades).
No base un mapa de parámetros en un elemento de consulta o una tabla con un
conjunto de resultados grande, como 50.000 filas. Cada vez que utilice el mapa de
parámetros en una expresión o en SQL, Framework Manager ejecuta esta consulta
grande. El rendimiento se reduce. Los mapas de parámetros deben utilizarse para
tablas de consulta más pequeñas.
Pasos para crear manualmente un mapa de parámetros
Procedimiento
1. Pulse la carpeta Mapas de parámetros y pulse Acciones, Crear, Mapa de
parámetros.
2. Escriba un nombre para el mapa de parámetros en el cuadro Nombre.
3. Pulse Especifique manualmente las claves de parámetros y/o impórtelas
desde un archivo y pulse Siguiente.
4. Realice una de las siguientes acciones:
v Para especificar los valores manualmente, pulse Clave nueva, escriba una
clave y pulse el tabulador para especificar un valor para dicha clave.
v Para importar claves y valores, pulse Importar archivo e identifique la
ubicación del archivo .csv o .txt correspondiente. Para utilizar un archivo .txt
para la importación, los valores deben estar separados por tabulaciones y el
archivo debe guardarse con formato UTF8 o Unicode. Los archivos de texto
ANSI no se soportan.
Nota: Si va a utilizar un parámetro en un asunto de consulta de orígenes de
datos, el valor debe utilizar la puntuación específica del inglés. Esto significa
que debe utilizar un punto (.) para representar un decimal y una coma (,) para
separar las listas de valores.
5. Modifique los parámetros existentes como desee.
Objetivo Acción
Asignar un valor predeterminado En el cuadro Valor predeterminado, escriba
un valor.
158 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario
Si la clave utilizada en una expresión no está
asignada, se utiliza el valor predeterminado.
Especificar un valor predeterminado es
opcional. No obstante, si no se proporciona
un valor predeterminado, una clave no
asignada podría producir un error.

Objetivo Acción
Cargar a petición La carga de un mapa de parámetros que
contenga un gran número de claves puede
ser lenta cuando se ejecuta un informe.
Puede limitar la carga a solo aquellas claves
que sean necesarias para un informe
determinado definiendo Cargar a petición
con el valor verdadero.
De forma predeterminada, el valor es falso y
todas las claves se cargan.
Eliminar un parámetro Seleccione una fila y pulse Eliminar.
Modificar un parámetro Seleccione la fila que desee modificar, pulse
el botón Editar y escriba un valor.
Borrar todas las claves y valores Pulse Borra mapa.
6. Pulse Finalizar.
Pasos para basar un mapa de parámetros en elementos de
consulta existentes
Procedimiento
1. Pulse la carpeta Mapas de parámetros y pulse Acciones, Crear, Mapa de
parámetros.
2. Escriba un nombre para el mapa de parámetros en el cuadro Nombre.
3. Pulse Utilice como base para el mapa de parámetros los elementos de
consulta existentes, Siguiente.
4. Pulse el elemento de consulta que desea utilizar como la clave y pulse el
elemento de consulta que desea utilizar como el valor.
Los dos elementos de consulta deben ser del mismo asunto de consulta.
5. Pulse Siguiente.
6. En el cuadro Valor predeterminado, escriba un valor.
Si la clave utilizada en una expresión no está asignada, se utiliza el valor
predeterminado.
Especificar un valor predeterminado es opcional. No obstante, si no se
proporciona un valor predeterminado, una clave no asignada podría producir
un error.
7. Pulse Finalizar.
Resultados
Ejemplo: especificación de valores de idioma para metadatos
relacionales
Una compañía internacional almacena la información de sus productos en inglés y
francés. Con la utilización de un mapa de parámetros y macros, los empleados
pueden recuperar datos que corresponden a la información que necesitan.
Cree el mapa de parámetros Language_lookup que contenga lo siguiente:
Capítulo 5. Modelado de metadatos relacionales 159

Clave Valor
en EN
fr FR
Cuando examine el SQL para el asunto de consulta Product Line, verá lo siguiente:
Select
PRODUCT_LINE.PRODUCT_LINE_CODE,
#’PRODUCT_LINE.PRODUCT_LINE_’ + $Language_lookup{$runLocale}#
as Product_Line
from
[gosales].PRODUCT_LINE PRODUCT_LINE
La macro runLocale devuelve un valor de entorno local que la macro
Language_lookup utiliza para especificar un valor de idioma.
Creación de parámetros de sesión
Un parámetro de sesión es una variable que IBM Cognos Framework Manager
asocia a una sesión.
Por ejemplo, el ID de usuario y el idioma preferido son dos parámetros de sesión.
Debido a que los parámetros de sesión son pares de clave y valor, se puede decir
que cada parámetro de sesión es una entrada del mapa de parámetros denominada
Parámetros de sesión. Un parámetro de sesión se utiliza de la misma manera que
una entrada del mapa de parámetros, aunque la sintaxis de los parámetros de
sesión es ligeramente diferente.
Hay dos tipos de parámetros de sesión: entorno y modelo.
Los parámetros de sesión de entorno están predefinidos y almacenados en Content
Manager. De forma predeterminada, los parámetros de sesión siguientes se
visualizan en Framework Manager:
v runLocale
Devuelve el código para el idioma activo actual en Framework Manager. El
contenido del modelo se muestra en este idioma.
Puede cambiar el idioma activo en cualquier momento solo para la sesión actual.
En las sesiones siguientes, el modelo continuará abriéndose en el idioma del
diseño. Para obtener más información, consulte:“Adición de un idioma a un
proyecto” en la página 127.
v account.defaultName
Especifica el nombre del usuario actual tal como está definido en el proveedor
de autenticación. Por ejemplo, el nombre y apellido del usuario.
Si inicia sesión anónimamente, verá Anónimo.
v account.personalInfo.userName
Especifica el ID de usuario utilizado para iniciar sesión en IBM Cognos BI.
Si inicia sesión anónimamente, no verá este parámetro.
v current_timestamp
Especifica la fecha y hora actual.
v machine
Especifica el nombre del sistema donde Framework Manager está instalado.
160 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Si el origen de autenticación soporta otros parámetros y ha especificado
información sobre ellos en el origen de autenticación, verá otros parámetros de
sesión, como account.personalInfo.email o account.personalInfo.surname.
Puede definir parámetros adicionales utilizando parámetros de sesión de modelo.
Los parámetros de sesión de modelo están almacenados en un mapa de
parámetros denominado _env. Se establecen en el proyecto y se pueden publicar
con un paquete.
Los valores de los parámetros de sesión de modelo deben estar establecidos dentro
del ámbito de objetos del modelo de Framework Manager. El ámbito puede incluir
el uso de parámetros de sesión de entorno existentes, así como valores estáticos.
Cada parámetro de sesión debe tener un nombre y un valor predeterminado.
Puede definir un valor de reemplazo para probar los resultados que ese valor
devuelve. El valor de reemplazo solo es válido mientras el modelo está abierto y
no se guarda al guardar el modelo. Si no existe un valor de reemplazo, Framework
Manager utiliza el valor predeterminado cuando ejecuta una consulta que contiene
un parámetro de sesión.
Las reglas que controlan el uso de parámetros son las siguientes:
v Todos los valores de retorno posibles deben tener el mismo tipo de datos.
v Solo se puede definir un valor.
Pasos para crear parámetros de sesión
Procedimiento
1. Pulse Proyecto, Parámetros de sesión.
2. Pulse Nueva clave y escriba un valor y una clave de parámetro de sesión
nuevos.
3. Elija cómo desea gestionar el valor de reemplazo.
v Para no tener que definir el valor de reemplazo cada vez que edite el
proyecto, defina el parámetro de sesión como un valor.
v Para no tener que eliminar el valor del proyecto cada vez antes de
publicarlo, defina el parámetro de sesión como un reemplazo de sesión.
4. Modifique los parámetros existentes como desee.
Objetivo Acción
Cambiar el valor del parámetro Pulse la fila que contiene el valor que desea
cambiar, pulse Editar y escriba un valor.
Asignar un valor predeterminado En el cuadro Valor predeterminado, escriba
un valor. Framework Manager utiliza el
valor predeterminado su una clave tiene un
valor no válido.
Eliminar un parámetro Pulse una fila y pulse el botón Eliminar. No
se puede suprimir un parámetro de sesión
de entorno.
Borrar un valor de reemplazo Pulse una fila y pulse Borrar reemplazar.
5. Pulse Aceptar.
Capítulo 5. Modelado de metadatos relacionales 161

Utilizar parámetros con asuntos de consulta de orígenes de
datos relacionales
Los objetos de modelo no reflejan los cambios en los objetos de origen de datos en
los que se basan. Por consiguiente, cuando añada un parámetro a un asunto de
consulta de orígenes de datos, piense si desea crear un objeto de modelo que haga
referencia al parámetro. Si es así, debe asignar un alias al objeto parametrizado en
el asunto de consulta de orígenes de datos. Esto garantiza que los asuntos de
consulta del modelo, los filtros o los cálculos que hacen referencia al objeto
devuelvan los resultados correctos cuando cambie el valor del parámetro.
Por ejemplo, el SQL siguiente define un asunto de consulta de orígenes de datos
que contiene un parámetro de sesión denominado runLocale. El valor del
parámetro runLocale especifica qué columna recupera la consulta. El alias se
comporta como un atajo de forma que cuando un objeto de modelo hace referencia
a CountryNameAlias, IBM Cognos Framework Manager recupera el valor al que
está asignado el alias.
Select
#$ColumnMap{$runLocale}# as
CountryNameAlias
From
[GoSales].Country
Crear solicitudes con macros de consulta
Las macros son fragmentos de código que se pueden insertar en cualquier parte de
la sentencia Select que define un asunto de consulta. Puede incluir referencias a
parámetros de sesión, mapas de parámetros y entradas de mapas de parámetro.
Los valores de los parámetros se definen cuando se ejecuta la consulta.
Por ejemplo, puede utilizar el parámetro de sesión de idioma para mostrar solo los
datos que coinciden con la configuración de idioma para el usuario actual.
Las macros se pueden utilizar de los siguientes modos:
v Pueden insertarse en el SQL.
Un ejemplo es Select * from Country where Country.Name =
#$myMap{$runLocale}#
v Pueden proporcionar un argumento a un asunto de consulta de procedimiento
almacenado.
Si se trata de un valor no modificable para el argumento, el asunto de consulta
de procedimiento almacenado se puede usar para devolver varios datos.
v Pueden insertarse en expresiones como cálculos y filtros.
Un ejemplo es un filtro [gosales].[Sales staff].[Staff name] =
#$UserLookUpMap{$UserId}#
v Pueden utilizarse para completar dinámicamente las propiedades de un asunto
de consulta de orígenes de datos.
Esto permite que varios usuarios proporcionen información de conexión
diferente y, por lo tanto, acceso a diferentes orígenes de datos. Las propiedades
que pueden contener macros son: Origen de datos de Content Manager,
Catálogo, Cubo y Esquema.
Un ejemplo con la propiedad Origen de datos de Content Manager es
#$DataSourceMap{$UserId}#
v Se pueden utilizar como un asistente de parámetros.
162 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Los parámetros pueden hacer referencia a otros parámetros. Un ejemplo es Map1,
Key = en-us, Value = #$myMap{$UserId}#
v Se pueden utilizar en el cuadro de diálogo Parámetro de sesión.
Un ejemplo es MySessionParameter, value = #$myMap{$UserGroup}#
Puede sustituir los elementos de asunto de consulta siguientes con un parámetro.
Elemento Ejemplo
Elementos de consulta identificados en la
lista Select
#’Product_name_’+ $languageCode#
Tablas identificadas en la cláusula From Product_#$language#
Cláusula Where Product_lang = #sq($languageCode)#
Nombre del origen de datos, el esquema o la
propiedad de origen
#$data_source#.#$schema#.Products
Sintaxis
Utilice la sintaxis siguiente para hacer referencia a valores de parámetros y
parámetros de la sesión.
Objeto Sintaxis Ejemplo
Clave de sesión $session_key #$my_account#
Clave de mapa de
parámetros
$map{} #$map_one{’abc’}#
Entrada de mapa de
parámetros cuya clave está
definida por un parámetro
de sesión
$map{$session_key} #$map_one{$my_account}#
Puede añadir los siguientes elementos para definir más la expresión de macro.
Símbolo Función
Comilla simple ' Define una cadena literal que incluye una
comilla simple como parte de la cadena.
Si la comilla simple se visualiza en una
cadena, como un elemento de consulta, la
cadena debe estar encerrada entre comillas
simples a ambos lados de la cadena y la
comilla simple debe duplicarse. Por ejemplo,
ab'c se escribiría ’ab’’c’
Si la comilla simple se visualiza en una
macro, la cadena debe encerrarse entre
corchetes. Por ejemplo, ab'c se escribiría
[ab’c]
Si la comilla simple se visualiza en una
solicitud, no hay necesidad de delimitar la
cadena.
Para añadir un carácter de escape a una
comilla simple en una expresión, utilice
&apos;
Capítulo 5. Modelado de metadatos relacionales 163

Símbolo Función
Corchetes [ ] Encierra objetos de modelo, como un espacio
de nombres o un asunto de consulta y
nombres de macro que contienen caracteres
restringidos, como un signo numérico, un
guión o un espacio.
Llaves { } Invoca una función que es desconocida para
el analizador, como dateadd en DB2, y cuyo
primer argumento es una palabra clave.
Ejemplo:
dateadd
({month},2,)
+ operador Concatena dos cadenas, como ’abc’ + ’xyz’
Función de comillas simples (sq) Encierra el resultado de una expresión de
cadena entre comillas simples. Si la comilla
simple se visualiza en una cadena, como un
elemento de consulta, la cadena debe estar
encerrada entre comillas simples a ambos
lados de la cadena y la comilla simple debe
duplicarse. Puede utilizar esta función para
construir cláusulas para probarlas con
valores literales controlados por parámetros.
A continuación se incluye un ejemplo:
#sq($my_sp)#
Si un parámetro de sesión (my_sp) tiene el
valor ab'cc, el resultado es:
’ab"cc’
Función de comillas dobles (dq) Encierra el resultado de una expresión de
cadena entre comillas dobles. Puede utilizar
esta función para hacer referencia a nombres
de columna y de tabla con caracteres que no
son identificadores, como un espacio en
blanco o un signo de porcentaje (%).
A continuación se incluye un ejemplo:
#dq
(’Column’ + $runLocale)#
Si runLocale=en-us, el resultado es:
"Column en-us"
Función de corchetes (sb) Inserta un par de corchetes en el argumento
para crear referencias de objeto en una
consulta de modelo y expresiones de
modelo, como filtros y cálculos.
164 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario
A continuación se incluye un ejemplo:
#sb
(’my item in ’ + $runLocale)#
Si runLocale=en-us, el resultado es:
[my item in en-us]

Para obtener información sobre funciones, consulte Apéndice C, “Uso del editor de
expresiones”, en la página 395.
Creación de macros
Las macros son fragmentos de código que se pueden insertar en cualquier parte de
la sentencia Select que define un asunto de consulta. Puede incluir referencias a
parámetros de sesión, mapas de parámetros y entradas de mapas de parámetro.
Los valores de los parámetros se definen cuando se ejecuta la consulta.
Cuando haga referencia a un parámetro, debe hacer lo siguiente:
v Utilice un signo de almohadilla (#) al principio y otro al final de cada conjunto
de uno o varios parámetros.
Los elementos incluidos entre los signos de almohadilla se consideran una
expresión de macro y se ejecutan en tiempo de ejecución. Framework Manager
elimina todo lo que esté fuera de los signos de almohadilla.
v Anteceda cada entrada de mapa de parámetros con un símbolo de dólar ($).
v Utilice un nombre que empiece con un carácter alfabético (a..z, A..Z).
No inserte macros entre comillas o corchetes existentes porque IBM Cognos
Framework Manager no ejecuta nada que se encuentre dentro de estos elementos.
Procedimiento
1. Seleccione el asunto de consulta de orígenes de datos que desea cambiar.
2. Pulse Acciones, Editar definición.
3. En la pestaña SQL, pulse Insertar macro para iniciar el editor de macros.
4. En el cuadro Componentes disponibles, pulse los mapas de parámetros,
parámetros de sesión o funciones que desee utilizar y arrástrelos al cuadro
Definición de macro.
No olvide escribir la expresión de macro entre signos de almohadilla. Si escribe
el texto antes o después de los signos de almohadilla, cuando pulse Aceptar,
Framework Manager eliminará este texto.
5. Inserte funciones de comillas simples o dobles.
Sugerencia: Pulse la flecha situada junto a estos botones para
obtener un menú de opciones para colocar las comillas.
6. Si desea editar un mapa de parámetros o un parámetro de sesión, pulse en él
en el cuadro Definición de macro.
Aparece el cuadro de diálogo Mapa de parámetros o Parámetros de sesión.
Puede definir valores de reemplazo para los parámetros de sesión, añadir
elementos nuevos o cambiar valores.
7. Compruebe la macro en el cuadro Información.
Si una macro no es correcta, aparece un mensaje de error.
Sugerencia: Para borrar una macro, pulse el icono para borrar todo .
8. Pulse Aceptar.
Solicitudes obligatorias y opcionales
Puede crear solicitudes obligatorias y opcionales en los modelos de IBM Cognos
Framework Manager usando macros de consulta. Puede usar dos funciones de
macro de solicitud, prompt y promptmany, para crear solicitudes de un único valor y
solicitudes de varios valores. Puede insertar una macro de solicitud en cualquier
parte de la sentencia SQL que defina el asunto de la consulta.
Capítulo 5. Modelado de metadatos relacionales 165

Si desea usar una macro de solicitud en una expresión, como un cálculo, debe
especificar el tipo de datos al usar el operador sobrecargado, como un signo más
(+). Puede usar el signo más (+)para concatenar dos elementos y añadir dos
elementos.
Si desea definir un filtro de un nivel de dimensión y que el filtro use la macro
prompt o promptmany, debe proporcionar el tipo de datos memberuniquename yun
valor predeterminado. Para obtener información sobre como aplicar filtros,
consulte: “Aplicación de filtros” en la página 155.
A continuación se incluye un ejemplo:
members( [MS_gosales].[New Dimension].[PRODUCTLINE].[PRODUCTLINE])
in ( set( #promptmany(’what’, ’memberuniquename’,
’[MS_gosales].[PROD1].[PRODUCTLINE].[PRODUCTLINE]
->[all].[1]’)# ) )
A continuación, se muestra un ejemplo de una solicitud obligatoria:
select
COUNTRY_MULTILINGUAL.COUNTRY_CODE as COUNTRY_CODE,
COUNTRY_MULTILINGUAL.COUNTRY as COUNTRY,
COUNTRY_MULTILINGUAL."LANGUAGE" as LANGUAGE1,
COUNTRY_MULTILINGUAL.CURRENCY_NAME as CURRENCY_NAME
from
gosales.gosales.dbo.COUNTRY_MULTILINGUAL COUNTRY_MULTILINGUAL
where COUNTRY_MULTILINGUAL.COUNTRY = #prompt(’CountryName’)#
cuando se especifican valores predeterminados en la sintaxis de las solicitudes de
macro, puede ver un error. Use la sintaxis de solicitud adecuada como Country =
?Enter Country?.
Las funciones prompt y promptmany tienen los parámetros siguientes. Todos los
valores de los argumentos deben especificarse como cadenas.
Nombre
Este parámetro obligatorio es el nombre de la solicitud. El nombre también puede
hacer referencia al nombre de un parámetro de una página de solicitud creada por
el usuario, en cuyo caso, aparece la página de solicitud creada por el usuario
cuando se ejecuta el informe, en lugar de la página de solicitud predeterminada
que la macro generaría.
Datatype
Este parámetro opcional es el tipo de datos del valor de la solicitud. El valor
predeterminado es string. Los valores de solicitud se validan. En el caso de
cadenas, el valor proporcionado se incluye entre comillas simples y las comillas
simples incluidas se doblan.
Los valores son los siguientes:
v boolean
v date
v datetime
v decimal
v double
v float
166 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

v int
v integer
v interval
v long
v memberuniquename
Memberuniquename no es un tipo de datos real. Este valor se debe utilizar
cuando el tipo de datos del parámetro sea un nombre exclusivo de miembro
(MUN).
v numeric
v real
v short
v string
v time
v timeinterval
v timestamp
v token
Token no es un tipo de datos real. Es una manera de pasar SQL. Una señal
(token) no pasa valores.
v xsddate
v xsddatetime
v xsddecimal
v xsddouble
v xsdduration
v xsdfloat
v xsdint
v xsdlong
v xsdshort
v xsdstring
v xsdtime
DefaultText
Este parámetro opcional es el texto que se debe utilizar de forma predeterminada.
Si se especifica un valor, la solicitud es opcional.
Si se utiliza un espacio y no se proporcionan valores en el cuadro de diálogo Valor
de solicitud, normalmente no se genera una cláusula Where.
Si se utiliza texto y no se proporcionan valores en el cuadro de diálogo Valor de
solicitud, normalmente se genera una cláusula Where utilizando el valor
predeterminado.
Asegúrese de que el texto que proporciona genera una sentencia SQL válida.
Nota: Si el tipo de datos es memberuniquename, se debe proporcionar un valor para
el parámetro DefaultText. Por ejemplo:
(#prompt(’WhichLevel’, ’memberuniquename’,
’[goSalesAgain].[PRODUCT1].[PRODUCT].[PRODUCT(All)]->[all]’)#)
Capítulo 5. Modelado de metadatos relacionales 167

Text
Este parámetro opcional es el texto que precede a cualquier valor proporcionado
por el usuario, como 'y columna1 = '.
QueryItem
Este parámetro es opcional. El motor de solicitudes puede aprovechar las
propiedades Información de solicitud del elemento de consulta. Puede mostrarse
información descriptiva, aunque el valor de solicitud sea un código.
TextFollowing
Este parámetro opcional es el paréntesis de cierre que se utiliza con más frecuencia
para la función promptmany. Este parámetro también es útil cuando la solicitud es
opcional y va seguida de filtros codificados en la sentencia SQL.
Ejemplos: solicitudes de selección de país o región
Al ejecutar un informe, desea que se solicite a los usuarios que elijan el país o la
región para los que desean ver los datos. Los ejemplos de código siguientes
describen cómo puede utilizar macros para crear diferentes solicitudes.
Solicitud obligatoria sin tipo de datos especificado:
Tenga en cuenta lo siguiente:
v El argumento Datatype no está especificado. Por consiguiente, es una cadena, lo
que es correcto en este caso.
v El argumento DefaultText no está especificado. Por consiguiente, es una
solicitud obligatoria.
select
COUNTRY_MULTILINGUAL.COUNTRY_CODE as COUNTRY_CODE,
COUNTRY_MULTILINGUAL.COUNTRY as COUNTRY,
COUNTRY_MULTILINGUAL."LANGUAGE" as LANGUAGE1,
COUNTRY_MULTILINGUAL.CURRENCY_NAME as CURRENCY_NAME
from
gosales.gosales.dbo.COUNTRY_MULTILINGUAL COUNTRY_MULTILINGUAL
where COUNTRY_MULTILINGUAL.COUNTRY = #prompt(’CountryName’)#
Solicitud obligatoria con tipo de datos especificado:
Tenga en cuenta lo siguiente:
v Esta solicitud requiere un valor entero válido como respuesta.
v El argumento DefaultText no está especificado. Por consiguiente, es una
solicitud obligatoria.
select
COUNTRY_MULTILINGUAL.COUNTRY_CODE as COUNTRY_CODE,
COUNTRY_MULTILINGUAL.COUNTRY as COUNTRY,
COUNTRY_MULTILINGUAL."LANGUAGE" as LANGUAGE1,
COUNTRY_MULTILINGUAL.CURRENCY_NAME as CURRENCY_NAME
from
gosales.gosales.dbo.COUNTRY_MULTILINGUAL COUNTRY_MULTILINGUAL
where COUNTRY_MULTILINGUAL.COUNTRY_CODE >
#prompt(’Starting CountryCode’,
’integer’,
’’,
’’,
’[gosales].[COUNTRY_MULTILINGUAL].[COUNTRY_CODE]’)#
168 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Solicitud opcional y filtro obligatorio con el tipo de datos y el valor
predeterminado especificado:
Tenga en cuenta lo siguiente:
v Esta solicitud permite a los usuarios proporcionar una respuesta íntegra válida.
v Se especifica el argumento DefaultText. Por consiguiente, el usuario puede optar
por no especificar un valor, en cuyo caso se utiliza el valor 10. Esto hace que sea
una solicitud opcional, pero no un filtro opcional.
Ejemplo 1:
select
COUNTRY_MULTILINGUAL.COUNTRY_CODE as COUNTRY_CODE,
COUNTRY_MULTILINGUAL.COUNTRY as COUNTRY,
COUNTRY_MULTILINGUAL."LANGUAGE" as LANGUAGE1,
COUNTRY_MULTILINGUAL.CURRENCY_NAME as CURRENCY_NAME
from
gosales.gosales.dbo.COUNTRY_MULTILINGUAL COUNTRY_MULTILINGUAL
where COUNTRY_MULTILINGUAL.COUNTRY_CODE >
#prompt(’Starting CountryCode’,
’integer’,
’10’
)#
Ejemplo 2:
[gosales].[COUNTRY].[COUNTRY] = #prompt(’countryPrompt’,’string’,’’’Canada’’’)#
Result 2:
[gosales].[COUNTRY].[COUNTRY] = 'Canada’
Tenga en cuenta lo siguiente:
v Se debe especificar el parámetro defaultText de forma que sea literalmente
válido en el contexto de la macro, ya que no se produce ningún formateo en este
valor. Vea los detalles a continuación.
v La cadena predeterminada Canada del ejemplo 2 se ha especificado como una
cadena entre comillas simples, en la que las comillas simples incluidas están
duplicadas y, por lo tanto, son 3 comillas. El resultado es que la cadena se
muestra correctamente entre comillas simples en la expresión.
v Como regla general para la cadena datatype, defaultText debe especificarse
siempre de esta forma, salvo en el contexto de un parámetro de procedimiento
almacenado.
v Para defaultText de los tipos date o datetime, se debe utilizar un formato
especial en el contexto de SQL. Son ejemplos de estos formatos ’DATE
’’2012-12-25’’’ y ’DATETIME ’’2012-12-25 12:00:00’’’. En todos los demás
contextos, utilice date/datetime sin la palabra clave y las comillas simples de
escape (por ejemplo, ’2012-12-25’).
Solicitud que añade texto al final del valor:
Tenga en cuenta lo siguiente:
v Se especifica el argumento DefaultText como un carácter de espacio. En este
caso, el texto generado es solo el carácter de espacio, que elimina la cláusula
Where de la consulta.
v Se especifica el argumento Text, que se escribe en el SQL generado antes del
valor de solicitud proporcionado por el usuario.
select
COUNTRY_MULTILINGUAL.COUNTRY_CODE as COUNTRY_CODE,
COUNTRY_MULTILINGUAL.COUNTRY as COUNTRY,
Capítulo 5. Modelado de metadatos relacionales 169

COUNTRY_MULTILINGUAL."LANGUAGE" as LANGUAGE1,
COUNTRY_MULTILINGUAL.CURRENCY_NAME as CURRENCY_NAME
from
gosales.gosales.dbo.COUNTRY_MULTILINGUAL COUNTRY_MULTILINGUAL
#prompt(’Starting CountryCode’,
’integer’,
’’, //’
)#
Sustitución de sintaxis:
Tenga en cuenta lo siguiente:
v El argumento Datatype tiene el valor token, lo que significa que el valor
proporcionado por el usuario se especifica sin comprobar el valor suministrado.
Puesto que no se realiza una comprobación del valor, el editor de expresiones
puede indicar que la expresión no es válida. Cuando se suministra un valor
proporcionado por el usuario válido o se suministra un valor predeterminado
válido, el editor de expresiones interpreta la expresión como válida.
v Token solo debe utilizarse si hay una lista de valores de selección para el
usuario.
v Se especifica el argumento DefaultText. Por consiguiente, es una solicitud
opcional y group by COUNTRY se utiliza en el SQL generado.
Select
COUNTRY_MULTILINGUAL.COUNTRY_CODE as COUNTRY_CODE,
COUNTRY_MULTILINGUAL.COUNTRY as COUNTRY,
COUNTRY_MULTILINGUAL."LANGUAGE" as LANGUAGE1,
COUNTRY_MULTILINGUAL.CURRENCY_NAME as CURRENCY_NAME
from
gosales.gosales.dbo.COUNTRY_MULTILINGUAL COUNTRY_MULTILINGUAL
#prompt(’Sort column’,
’token’,
’group by COUNTRY’,
’group by ’
)#
Ejemplos: creación de solicitudes que utilizan mapas de
parámetros
Al ejecutar un informe, desea que los usuarios seleccionen un idioma para los
datos del informe. Los ejemplos siguientes describen varios modos de poder
hacerlo.
La solicitud utiliza variables de sesión:
Tenga en cuenta lo siguiente:
v El nombre de la solicitud se especifica mediante una búsqueda en el mapa de
parámetros denominado PromptLabels. El valor clave es la variable de sesión
$language.
v La cláusula Where utiliza una columna parametrizada.
select
ORDER_METHOD.ORDER_METHOD_CODE as ORDER_METHOD_CODE,
ORDER_METHOD.ORDER_METHOD_#$language#
as ORDER_METHOD_EN
from
gosales.gosales.dbo.ORDER_METHOD ORDER_METHOD
#prompt($PromptLabels{$language},
’’,
170 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

’’,
’where ORDER_METHOD.ORDER_METHOD_’ + $language + ’
>’
)#
Mapa de parámetros que anida solicitudes:
Tenga en cuenta lo siguiente:
v En el modelo, hay un mapa de parámetros DynPromptLabels con
#$PromptLabels{$language}#
v Parte de la información de solicitud se ejecuta desde un mapa de parámetros en
lugar de codificarse directamente en el SQL.
v Toda la macro que contiene la solicitud puede ser un valor en un mapa de
parámetros.
select
ORDER_METHOD.ORDER_METHOD_CODE as ORDER_METHOD_CODE,
ORDER_METHOD.ORDER_METHOD_#$language#
as ORDER_METHOD_EN
from
gosales.gosales.dbo.ORDER_METHOD ORDER_METHOD
#prompt($DynPromptLabels{’ex9’},
’’,
’’,
’where ORDER_METHOD.ORDER_METHOD_’ + $language + ’
>’
)#
Ejemplos: creación de una solicitud de varios valores
Al ejecutar un informe, desea que los usuarios seleccionen uno o varios valores.
Los ejemplos siguientes describen varios modos de poder hacerlo.
Solicitud con un mínimo requerido:
Tenga en cuenta lo siguiente:
v El usuario debe especificar al menos un único valor.
v Se parece al primer ejemplo sobre solicitar un país o una región (“Solicitud
obligatoria sin tipo de datos especificado” en la página 168).
select
COUNTRY_MULTILINGUAL.COUNTRY_CODE as COUNTRY_CODE,
COUNTRY_MULTILINGUAL.COUNTRY as COUNTRY,
COUNTRY_MULTILINGUAL."LANGUAGE" as LANGUAGE1,
COUNTRY_MULTILINGUAL.CURRENCY_NAME as CURRENCY_NAME
from
gosales.gosales.dbo.COUNTRY_MULTILINGUAL COUNTRY_MULTILINGUAL
where COUNTRY_MULTILINGUAL.COUNTRY IN (#promptmany(’CountryName’)#)
Solicitud con un mínimo requerido con el tipo de datos especificado:
Tenga en cuenta lo siguiente:
v Se parece al segundo ejemplo sobre solicitar un país o una región (“Solicitud
obligatoria con tipo de datos especificado” en la página 168).
select
COUNTRY_MULTILINGUAL.COUNTRY_CODE as COUNTRY_CODE,
COUNTRY_MULTILINGUAL.COUNTRY as COUNTRY,
COUNTRY_MULTILINGUAL."LANGUAGE" as LANGUAGE1,
COUNTRY_MULTILINGUAL.CURRENCY_NAME as CURRENCY_NAME
from
gosales.gosales.dbo.COUNTRY_MULTILINGUAL COUNTRY_MULTILINGUAL
where COUNTRY_MULTILINGUAL.COUNTRY_CODE IN (
Capítulo 5. Modelado de metadatos relacionales 171

#promptmany(’Selected CountryCodes’,
’integer’,
’’,
’’,
’[gosales].[COUNTRY_MULTILINGUAL].[COUNTRY_CODE]’)#
)
Solicitud opcional con el tipo de datos y el valor predeterminado especificados:
La cláusula In y los dos paréntesis forman parte de la sentencia SQL.
select
COUNTRY_MULTILINGUAL.COUNTRY_CODE as COUNTRY_CODE,
COUNTRY_MULTILINGUAL.COUNTRY as COUNTRY,
COUNTRY_MULTILINGUAL."LANGUAGE" as LANGUAGE1,
COUNTRY_MULTILINGUAL.CURRENCY_NAME as CURRENCY_NAME
from
gosales.gosales.dbo.COUNTRY_MULTILINGUAL COUNTRY_MULTILINGUAL
where COUNTRY_MULTILINGUAL.COUNTRY_CODE IN (
#promptmany(’Selected CountryCodes’,
’integer’,
’10’
)#
)
Solicitud que añade texto delante de la sintaxis:
Tenga en cuenta lo siguiente:
v Este ejemplo utiliza el argumento TextFollowing.
select
COUNTRY_MULTILINGUAL.COUNTRY_CODE as COUNTRY_CODE,
COUNTRY_MULTILINGUAL.COUNTRY as COUNTRY,
COUNTRY_MULTILINGUAL."LANGUAGE" as LANGUAGE1,
COUNTRY_MULTILINGUAL.CURRENCY_NAME as CURRENCY_NAME
from
gosales.gosales.dbo.COUNTRY_MULTILINGUAL COUNTRY_MULTILINGUAL
#promptmany(’Selected CountryCodes’,
’integer’,
’’, //

Organización de modelos
Cuando se organiza el modelo, se facilita a los usuarios la búsqueda y
comprensión de los datos del modelo. También se facilita la gestión y el
mantenimiento del modelo.
Una práctica recomendada es crear varias vistas, o capas, en el modelo:
v Conserve los metadatos del origen de datos en un espacio de nombres o carpeta
independiente.
En IBM Cognos Framework Manager, se denomina vista de importación.
v Cree uno o varios espacios de nombres o carpetas opcionales para resolver las
complejidades que afectan a las consultas que utilizan asuntos de consulta u
objetos dimensionales.
Para utilizar IBM Cognos Analysis Studio o cualquier consulta de estilo OLAP,
debe haber un espacio de nombres o carpeta en el modelo que represente los
metadatos con objetos dimensionales.
v Cree uno o varios espacios de nombres o carpetas para la vista empresarial
aumentada de los metadatos que contiene los atajos para las dimensiones o los
asuntos de consulta.
En Framework Manager, se denomina vista empresarial. Utilice conceptos
empresariales para modelar la vista empresarial. Un modelo puede contener
muchas vistas empresariales, cada una de las cuales adecuada para un grupo de
usuarios diferente. Publique las vistas empresariales.
Se puede definir la seguridad en cualquiera de las vistas. Depende de los
requisitos de la empresa. Por ejemplo, si se necesita que nadie vea un objeto, se
añade seguridad al objeto en la vista de importación. Normalmente la seguridad se
aplica en la vista empresarial.
Creación de grupos de esquema en estrella
Utilice el asistente Grupos de esquema en estrella para crear rápidamente grupos
de atajos que proporcionen contexto a los usuarios en relación a qué objetos deben
permanecer juntos. De este modo, el modelo resulta más intuitivo para los
usuarios. Los grupos de esquema en estrella también facilitan la creación de
informes de varios hechos ya que permiten la repetición de dimensiones
compartidas en grupos diferentes. Esto ayuda a los usuarios a ver lo que tienen en
común los distintos grupos y cómo pueden crear informes de funciones cruzadas o
de varios hechos. Para obtener más información, consulte: “Consultas de varios
hechos y granularidades” en la página 328.
Los grupos de esquema en estrella también proporcionan contexto para consultas
con varias rutas de unión. Mediante la creación de grupos de esquema en estrella
en la vista empresarial del modelo, puede aclarar qué ruta de unión se debe
seleccionar cuando hay varias disponibles. Esto es especialmente útil para las
consultas sin hechos.
En un diseño de esquema en estrella, los datos numéricos transaccionales están
contenidos en una tabla de hechos central con tablas de dimensiones relacionales
que irradian de ella.
Capítulo 5. Modelado de metadatos relacionales 173

Los grupos de esquema en estrella pueden contener las dimensiones, los asuntos
de consulta o los atajos seleccionados. Los objetos de un grupo de esquema en
estrella no pueden hacer referencia a ningún objeto fuera del grupo, ni éste puede
hacer referencia a ellos. Por lo tanto, Framework Manager crea automáticamente
un atajo para cualquier objeto al que haga referencia otro objeto fuera del grupo.
Por ejemplo, en un proyecto para análisis de ventas, incluye estas dimensiones:
v Fechas de ventas (Tiempo)
v Ubicaciones de ventas (Región)
v Detalles del producto (Producto)
v Información del cliente (Cliente)
Se incluyen cantidades en la tabla de hechos.
Creación de un esquema en estrella
Procedimiento
1. Seleccione una o varias dimensiones o asuntos de consulta.
2. Pulse Herramientas, Crear grupos de esquema en estrella.
3. Si desea excluir un objeto del grupo, en el cuadro Objetos disponibles,
desmarque la casilla de verificación situada junto al objeto.
4. Realice una de las siguientes acciones:
v Para añadir atajos al grupo, pulse Crear un acceso directo para todos los
objetos seleccionados.
v Para mover los objetos al grupo, pulse Crear atajos solo para objetos que se
utilicen fuera del esquema en estrella.
5. Para mover los objetos seleccionados a un espacio de nombres separado,
compruebe que la casilla de verificación Crear un espacio de nombres nuevo
para este grupo esté seleccionada y escriba el nombre en el cuadro Nombre de
espacio de nombres.
6. Pulse Aceptar.
174 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

7. Si hay varias relaciones, también conocidas como dimensiones de rol, cree
atajos de relaciones para ellas “Creación de un atajo de relación” en la página
74, o cree dimensiones o asuntos de consulta individuales si debe cambiarles de
nombre.
Un grupo de esquemas en estrella basado en una dimensión o
asunto de consulta
Generalmente, se selecciona un solo objeto cuando se sabe que tiene una relación
con cada dimensión o asunto de consulta que desea en el grupo de esquemas en
estrella. Al crear un grupo de esquemas en estrella basado en un objeto, sucede lo
siguiente:
v Framework Manager muestra una lista de objetos con los que tiene relaciones de
modo que pueda rápidamente seleccionar los objetos que desee en el grupo.
v El nombre del grupo se basa en el nombre de la tabla de hechos.
v El grupo nuevo se crea bajo el mismo padre que el objeto seleccionado.
Un grupo de esquemas en estrella basado en varias
dimensiones o asuntos de consulta
Seleccionar varias dimensiones o asuntos de consulta es útil si desea agrupar
dimensiones o asuntos de consulta que no tienen una relación definida. El grupo
nuevo se coloca bajo el padre común más cercano de las dimensiones o asuntos de
consulta.
Resolución de varios esquemas en estrella compatibles
Es probable que se visualicen asuntos de consulta dimensionales unidos a más de
un asunto de consulta de hechos. La ambigüedad de la unión es un problema
cuando se crean informes utilizando elementos de varias dimensiones o asuntos de
consulta dimensionales sin incluir ningún elemento de la dimensión de medida o
asunto de consulta de hechos. Se denomina consulta sin hechos.
Por ejemplo, las dimensiones Product y Time están relacionadas con los hechos
Product forecast y Sales.
Capítulo 5. Modelado de metadatos relacionales 175

Si utiliza estas relaciones, ¿cómo se escribe un informe que solo utilice elementos
de Product y Time? La pregunta de negocio podría ser qué productos se habían
previsto para la venta en 2005 o qué productos se han vendido realmente en 2005.
Aunque esta consulta solo implique Product y Time, estas dimensiones están
relacionadas a través de varios hechos. No hay manera de averiguar cuál es la
pregunta de negocio. Debe establecer el contexto para la consulta sin hechos.
En este ejemplo, se recomienda crear dos espacios de nombres, uno que contenga
atajos para Product, Time y Product forecast, y otro que contenga Product, Time y
Sales.
176 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Cuando se sigue este procedimiento para todos los esquemas en estrella, se
resuelve la ambigüedad de la unión colocando atajos para el hecho y todas las
dimensiones en un único espacio de nombres. Los atajos para dimensiones
compatibles en cada espacio de nombres son idénticos y son referencias al objeto
original. Nota: Se aplica exactamente la misma regla a dimensiones regulares y
dimensiones de medida.
Con un espacio de nombres para cada esquema en estrella, los usuarios tienen
claro los elementos que deben utilizar. Para crear un informe sobre qué productos
se han vendido realmente en 2005, utilizan Product y Year del espacio de nombres
Sales. La única relación pertinente en este contexto es la relación entre Product,
Time y Sales, y se utiliza para devolver los datos.
Resolución de un esquema en estrella:
Procedimiento
1. Seleccione una de las dimensiones de medida.
2. En el menú Herramientas, pulse Crear grupos de esquema en estrella.
3. Si desea excluir un objeto del grupo, en el cuadro Objetos disponibles,
desmarque la casilla de verificación situada junto al objeto.
4. Pulse Crear un acceso directo para todos los objetos seleccionados.
5. Para mover los objetos seleccionados a un espacio de nombres separado,
compruebe que la casilla de verificación Crear un espacio de nombres nuevo
para este grupo esté seleccionada y escriba el nombre en el cuadro Nombre de
espacio de nombres.
6. Pulse Aceptar.
7. Repita estos pasos para el resto de las dimensiones de medida.
Modelado de dimensiones en copo de nieve como dimensiones
de estrella
Una dimensión en copo de nieve elimina los atributos de cardinalidad de nivel
inferior de las tablas de dimensión y los coloca en dimensiones secundarias que se
enlazan de nuevo con las dimensiones originales mediante claves artificiales.
Para modelar una dimensión en copo de nieve como una dimensión de estrella,
realice las acciones siguientes:
Capítulo 5. Modelado de metadatos relacionales 177

Procedimiento
1. Seleccione los asuntos de consulta necesarios para acceder a los datos y
colóquelos en un nuevo espacio de nombres “Creación de carpetas o espacios
de nombres” en la página 181.
2. Compruebe que todas las relaciones sean correctas “Relaciones” en la página
68.
3. Gestione los metadatos multilingües “Metadatos multilingües” en la página
123.
4. Cree una dimensión de modelo para cada dimensión en copo de nieve:
v Seleccione los asuntos de consulta que necesita.
v Pulse Acciones, Fusionar en dimensión regular nueva.
v Cambie el nombre de la nueva dimensión de modelo. de forma
predeterminada, su nombre está compuesto por los nombres concatenados de
los objetos originales.
5. Si necesita varios niveles, realice una de las acciones siguientes:
v Utilice el mapa de dimensiones para definir las jerarquías y los niveles de la
dimensión “Creación de dimensiones regulares” en la página 107.
v Especifique los determinantes si los niveles están almacenados en un solo
asunto de consulta “Determinantes” en la página 84.
Atajos
Un atajo es un puntero a un objeto, como una relación, una dimensión, un asunto
de consulta o una carpeta. Puede utilizar los atajos en las vistas empresariales
cuando haya una superposición entre los grupos de usuarios y desee incluir
metadatos en más de una carpeta. Con los atajos, puede tener varias referencias a
un objeto.
Por ejemplo, puede crear carpetas con los nombres, Pedidos, Productos y Clientes.
Si quiere que tanto Pedidos como Clientes contengan la misma dimensión, debe
crear un atajo a la dimensión y añadirlo a ambas carpetas.
Nota: Dos atajos a los mismos espacios de nombres o carpetas no deben tener el
mismo nombre en un modelo. Para otros tipos de atajos (por ejemplo, un atajo a
un asunto de consulta), el nombre debe ser exclusivo en el espacio de nombres
padre.
Al crear un atajo, IBM Cognos Framework Manager no define las propiedades
Sugerencia y Descripción. A menos que defina estas propiedades, los valores
mostrados en los estudios IBM Cognos son los mismos que los definidos en el
objeto al que hace referencia el atajo.
Sugerencia: Para ir al objeto al que hace referencia el atajo, pulse con el botón
derecho del ratón en el atajo y pulse Ir a destino.
Los atajos son menos flexibles desde el punto de vista de la presentación que los
objetos de modelo, pero necesitan mucho menos mantenimiento porque se
actualizan automáticamente cuando se actualiza el objeto de destino. Si el
mantenimiento es una cuestión clave y no hay necesidad de personalizar el aspecto
del asunto de consulta, utilice atajos.
IBM Cognos Framework Manager dispone de dos tipos de atajos:
v Los atajos regulares, que son una mera referencia al objeto de destino.
178 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

v Los atajos de alias, que se comportan como si fueran una copia del objeto
original con comportamiento completamente independiente. Los atajos de alias
solo están disponibles para asuntos de consulta y dimensiones.
Los atajos regulares se utilizan generalmente como dimensiones compatibles con
grupos de esquema en estrella que crean varias referencias con el mismo nombre y
aspecto en varios lugares. En el ejemplo siguiente, los atajos creados para Products
y Order Time se comportan como referencias. Si se escribe una consulta que toma
Products tanto de Product Forecast como de Sales Target, la consulta utiliza la
definición de Products basada en el original y esta definición solo aparece una vez
en la consulta.
Normalmente, los atajos de alias se utilizan en dimensiones de rol o en tablas
compartidas. Como ya existe un ejemplo de dimensiones de rol en este documento,
expondremos el caso de tablas compartidas. En este ejemplo, Sales Staff y Sales
Branch se pueden tratar como jerarquías diferentes. Por lo que indican los datos,
sabemos que debido a que el personal se puede mover entre sucursales,
necesitamos poder informar de los pedidos para Sales Branch y Sales Staff tanto de
forma independiente como conjunta. Para conseguirlo, debemos crear un alias para
Sales Branch que se pueda utilizar como nivel en la jerarquía Sales Staff.
Capítulo 5. Modelado de metadatos relacionales 179

Con el nuevo atajo de alias, es posible crear consultas que necesiten pedidos por
Sales Branch y pedidos por Sales Staff con la información de su sucursal actual
simultáneamente.
Atajos y relaciones
Cuando decida dónde colocar los atajos, tenga en cuenta cómo afecta el ámbito del
atajo a las relaciones. Los atajos de una carpeta diferente del asunto de consulta de
destino usan las relaciones del asunto de consulta de destino. Los atajos de la
misma carpeta que el asunto de consulta de destino pasan por alto las relaciones
del asunto de consulta de destino y utilizan solo las especificadas para el atajo.
Puede especificar una relación diferente para un atajo que las relaciones del asunto
de consulta de destino. Al crear relaciones desde el atajo a otros asuntos de
consulta, se evitan los errores de uniones cruzadas del modelo.
No se pueden crear atajos para las relaciones de ámbito.
Atajos y dimensiones o asuntos de consulta
Los atajos dan como resultado menos dimensiones o asuntos de consulta para
mantener. Puede guardar las dimensiones o asuntos de consulta en la vista de
importación y guardar los atajos en la vista empresarial. Los atajos se usan con
más frecuencia al crear grupos de esquema en estrella.
Al crear un atajo a una dimensión oaunasunto de consulta, no puede
personalizar los elementos de consulta que hay en el atajo. La dimensión o asunto
de consulta completo se incluyen en el atajo.
Cuando se abre un modelo de una versión anterior, el regulador Procesamiento de
atajos tiene el valor Automático. Cuando se utiliza Automático, los atajos
funcionan igual que en versiones anteriores, es decir, un atajo que existe en la
misma carpeta que su destino se comporta como un alias, o instancia
independiente, mientras que un atajo que existe en otro lugar del modelo se
comporta como una referencia para el original. Para aprovechar las ventajas de la
propiedad Tratar como, se recomienda verificar el modelo y, cuando se repare,
cambiar el regulador a Explícito. La operación de reparación cambia todos los
atajos al valor correcto de la propiedad Tratar como en función de las reglas que
sigue el valor Automático, es decir, no debe haber ningún cambio en el
comportamiento del modelo a menos que elija realizar uno o varios cambios en las
propiedades Tratar como de los atajos.
Cuando se crea un modelo, el regulador Procesamiento de atajos tiene siempre el
valor Explícito.
Cuando el regulador se establece en Explícito, el comportamiento del atajo se toma
de la propiedad Tratar como y el usuario tiene todo el control sobre cómo se
comportan los atajos sin necesidad de preocuparse del lugar del modelo en el que
están ubicados.
Los atajos pueden crearse con el asistente para Crear grupos de esquema en
estrella. Por ejemplo, una tabla de hechos y sus tablas de dimensiones se
almacenan en la vista de importación. Si desea representar dimensiones
conformadas en varios grupos de esquema en estrella, solo una dimensión o
asunto de consulta puede existir para cada tabla de dimensiones. Utilice los atajos
para el resto de las instancias de la dimensión o asunto de consulta. Mediante los
180 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

atajos, puede crear consultas que impliquen a tablas de hechos que estén
relacionadas mediante tablas de dimensiones compartidas.
En el caso de los dominios que desempeñen roles, existen dos estrategias
documentadas en “Dimensiones de rol” en la página 343. Puede crear un asunto
de consulta y una dimensión regular para cada rol y, después, utilizar los atajos
como referencias en los grupos de esquema en estrella para permitir el uso de las
dimensiones que desempeñan roles como dimensiones conformadas o puede crear
un atajo para cada rol de cada grupo de esquema en estrella y crear una nueva
unión entre cada atajo que desempeñe un rol y sus atajos de hechos relacionados.
Mientras el destino de los atajos no se encuentre en la misma carpeta, todos los
atajos se comportarán como alias.
La seguridad que especifica para un objeto se pasa a los atajos que hacen
referencia al objeto protegido. Si dispone de un atajo para un objeto protegido, solo
los usuarios con permiso para ver el objeto protegido pueden ver el atajo en el
paquete publicado.
Al crear un atajo a una dimensión oaunasunto de consulta, puede especificar el
comportamiento del atajo en la propiedad Tratar como. Puede definir la propiedad
como una de las siguientes:
v Referencia
Utilice este valor cuando desee que una réplica exacta de un asunto de consulta
en varios lugares se comporte como un objeto si está referenciado en la misma
consulta.
v Alias
Utilice este valor cuando desee que una réplica exacta de un asunto de consulta
se comporte como un objeto independiente que sigue una ruta de unión
independiente. Las rutas de unión independiente deben definirse primero en el
modelo.
El regulador Procesamiento de atajos controla el comportamiento de todos los
atajos. El regulador Procesamiento de atajos toma prioridad sobre la propiedad
Tratar como. Por ejemplo, si el regulador tiene el valor Automático, el
comportamiento del atajo viene determinado por la ubicación del atajo en relación
con su destino, con independencia de cuál sea el valor de la propiedad Tratar
como. Para obtener más información, consulte: “Reguladores” en la página 304.
Pasos para crear atajos
Procedimiento
1. Pulse con el botón derecho en los asuntos de consulta, dimensiones o carpetas
para los que desea crear atajos y realice una de las acciones siguientes:
v Pulse Crear, Atajo de alias.
v Pulse Crear, Atajo.
v Pulse Crear grupos de esquema en estrella. Este comando también está
disponible en el menú Herramientas.
2. Para los atajos de asuntos de consulta o dimensiones, en el panel Propiedades,
defina la propiedad Tratar como con el valor Alias o Referencia.
Creación de carpetas o espacios de nombres
Se pueden crear carpetas o espacios de nombres para organizar los objetos del
modelo.
Capítulo 5. Modelado de metadatos relacionales 181

Lo más importante que se debe saber sobre los espacios de nombres es que cuando
ya se ha empezado a crear informes, los cambios efectuados en los nombres de los
espacios de nombres publicados afectarán al contenido de IBM Cognos. Esto es así
porque al cambiar el nombre de un espacio de nombres, se cambian los ID de los
objetos publicados en los metadatos. Como el espacio de nombres se utiliza como
parte del ID del objeto en IBM Cognos Framework Manager, cada espacio de
nombres debe tener un nombre exclusivo en el modelo. Cada objeto de un espacio
de nombres también debe tener un nombre exclusivo. Parte de la estrategia de los
grupos de esquema en estrella es colocar atajos en un espacio de nombres
separado, que automáticamente crea un ID exclusivo para cada objeto del espacio
de nombres. En el caso de base de datos relacionales, nos permitirá utilizar el
mismo nombre para atajos de dimensiones conformadas en diferentes grupos de
esquema en estrella.
La próxima vez que intente ejecutar una consulta, un informe o un análisis en el
modelo actualizado, obtendrá un error. Si es necesario cambiar el nombre del
espacio de nombres que ha publicado, utilice Analizar el impacto de la
publicación para determinar a qué informes afecta.
Las carpetas son mucho más sencillas que los espacios de nombres. Tienen una
finalidad meramente organizativa y no afectan a los ID de los objetos ni a su
contenido. Puede crear carpetas para organizar objetos por asunto o área funcional.
Esto facilitará la localización de los metadatos, especialmente en proyectos grandes.
El inconveniente principal de las carpetas es que necesitan nombres exclusivos
para todos los asuntos de consulta, dimensiones y atajos. Por lo tanto no son la
solución ideal para contener objetos compartidos.
Sugerencia: Cuando visualice metadatos en la pestaña Diagrama, puede expandir
o contraer carpetas y espacios de nombres. En el menú Diagrama, pulse Contraer
todo o Expandir todo.
Si establece la seguridad en una carpeta y luego mueve objetos a la carpeta,
confirme que las exclusiones estén definidas correctamente.
Pasos para crear una carpeta
Procedimiento
1. Pulse Acciones, Crear, Carpeta.
2. Escriba un nombre para la carpeta en el cuadro Carpeta.
3. Pulse Siguiente.
4. Elija si desea mover los objetos o crear atajos:
v Para mover los objetos seleccionados a la carpeta, pulse Mover los
elementos seleccionados a la nueva carpeta. Cuando se mueve un objeto
que participa de una relación, las relaciones con este objeto también se
mueven.
v Para crear objetos que hagan referencia a los objetos seleccionados, pulse
Crear un atajo para los elementos seleccionados. No seleccione todos los
objetos del espacio de nombres para evitar crear una estructura recursiva en
el paquete publicado.
5. Seleccione los objetos que desee añadir a la carpeta.
6. Pulse Finalizar.
182 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Pasos para crear un espacio de nombres
Procedimiento
1. Pulse Acciones, Crear, Espacio de nombres.
2. Pulse con el botón derecho en el espacio de nombres, pulse Cambiar nombre y
dé un nombre descriptivo y exclusivo al espacio de nombres.
3. Añada objetos importando metadatos o moviendo los objetos del modelo o
atajos a los objetos en el espacio de nombres.
Creación de carpetas de elementos de consulta
Si crea una carpeta de elementos de consulta, no puede cambiar el orden de
elementos de consulta en el cuadro de diálogo Editar definición para el asunto de
consulta de modelo. Puede cambiar el orden de los elementos solo en el Visor de
proyectos.
Puede crear carpetas de elementos de consulta para organizar asuntos de consulta
o dimensiones que contienen un gran número de elementos de consulta. Una
carpeta de elementos de consulta puede contener solo elementos de consulta y
carpetas de elementos de consulta.
Pasos para crear una carpeta de elemento de consulta
Procedimiento
1. En el panel Visor de proyectos, pulse una dimensión o asunto de consulta de
medida.
2. Pulse Acciones, Crear, Carpeta de elemento de consulta.
En el Visor de proyectos, se muestra una nueva carpeta de elemento de
consulta, debajo de los elementos de consulta que pertenecen a dicha
dimensión o asunto de consulta.
3. Arrastre los elementos de consulta que desee a la carpeta de elementos de
consulta.
No se pueden añadir elementos de consulta que no existan en la dimensión o
asunto de consulta padre.
Creación de carpetas de medidas
Puede crear carpetas de medidas para organizar dimensiones de medida que
contengan una gran cantidad de elementos de consulta. Puede anidar carpetas de
medidas dentro de otras carpetas de medidas.
No se puede crear una carpeta de medidas desde un atajo de medida.
Si crea una carpeta de medidas, no puede cambiar el orden de las medidas del
cuadro de diálogo Editar definición para la dimensión de medida. Puede cambiar
el orden de medidas sólo en el Visor de proyectos.
Pasos para crear una carpeta de medidas
Procedimiento
1. En el panel Visor de proyectos, pulse una dimensión de medida.
2. Pulse Acciones, Crear, Carpeta de medidas.
En el Visor de proyectos, se muestra una nueva carpeta, debajo de las medidas
que pertenecen a dicha dimensión de medida.
Capítulo 5. Modelado de metadatos relacionales 183

Modelos duraderos
3. Arrastre los elementos de consulta que desee a la carpeta de medidas.
No se pueden añadir medidas que no existan en la dimensión de medida
padre.
Al crear un modelo, debería considerar la posibilidad de que se produzcan
cambios posteriores en los requisitos del usuario que deba reflejar en el modelo. El
objetivo es crear un modelo flexible que pueda resistir los cambios necesarios sin
influir en los informes existentes, los autores de informes y los usuarios finales.
El cambio de nombre de los elementos de consulta es uno de los cambios más
frecuentes que los modeladores tienen que implementar en sus modelos. Si los
modelos son duraderos, puede realizar estos tipos de cambio rápidamente, sin
influir en los informes existentes. Los cálculos y filtros que hacen referencia a los
elementos de consulta a los que se ha cambiado el nombre continúan siendo
válidos.
Los modelos duraderos son útiles tanto en entornos de un único idioma como en
entornos de varios idiomas en los que el cambio de nombre de elementos de
consulta da lugar al cambio de requisitos empresariales. En un entorno de varios
idiomas, los modelos duraderos también simplifican el proceso de traducción ya
que permiten especificar etiquetas específicas del idioma para los elementos de
consulta sin que exista riesgo de romper las referencias de informes existentes para
otros idiomas.
Al trabajar con modelos duraderos, recuerde las condiciones siguientes:
v Especifique un idioma de diseño para el proyecto.
Elija la versión de entorno local del idioma que no se incluya en los requisitos
empresariales. Podría ser un entorno local utilizado con menos frecuencia, por
ejemplo, Inglés (Zimbabue). Por ejemplo, cuando se crea un proyecto con el
idioma de diseño Inglés (Zimbabue), el idioma activo es también Inglés
(Zimbabue). No se puede cambiar el idioma de diseño de un proyecto después
de crear un modelo.
v Cuando se diseña el modelo, el idioma de diseño y el idioma activo deben ser el
mismo.
El diseño incluye crear nuevos elementos como espacios de nombre, asuntos de
consulta, incluidos cálculos, o cambiar el modelo de estructura. Por ejemplo,
para las actividades de diseño, tanto el idioma de diseño como el idioma activo
deberían ser Inglés (Zimbabue)
v Cuando se cambia el nombre de los elementos de modelo para los usuarios
empresariales, el idioma activo no debe ser el mismo que el idioma de diseño.
Cuando esté preparado para cambiar los nombres de los elementos de consulta,
cambie el valor de idioma activo a un idioma distinto del idioma de diseño. Por
ejemplo, al renombrar elementos de consulta, el idioma de diseño es Inglés
(Zimbabue). El idioma activo es alemán.
v Aunque el idioma activo no sea el mismo que el idioma de diseño, no cambie la
estructura de su modelo.
Para realizar cambios estructurales, debe devolver el idioma activo al idioma de
diseño antes de realizar los cambios necesarios.
Para que el modelo sea duradero, establezca la propiedad Utilizar entorno local de
diseño para ID de referencia en verdadera.
184 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Nota: Los procesos de modelos duraderos no están soportados para el modelado
dimensional de orígenes de datos relacionales (DMR).
Para obtener más información sobre modelos duraderos, acceda a la
documentación sobre prácticas recomendadas en la sección dedicada al soporte del
centro del cliente de IBM Cognos (http://www.ibm.com/software/data/support/
cognos_crc.html).
Creación de un modelo duradero
Procedimiento
1. En la página Bienvenidos, pulse Crear un proyecto nuevo.
Sugerencia: Si se encuentra en IBM Cognos Framework Manager, pulse la
opción Nuevo del menú Archivo.
2. En la página Nuevo proyecto, especifique un nombre y una ubicación para el
proyecto y pulse Aceptar.
3. En la página Seleccionar idioma, pulse el idioma de diseño del proyecto y en
Aceptar.
Compruebe que elige el idioma de diseño adecuado, como se ha indicado
anteriormente en este apartado. No se puede cambiar el idioma seleccionado
después de pulsar en Aceptar, pero se pueden añadir otros idiomas del
proyecto posteriormente.
4. En el asistente de metadatos, pulse Siguiente para importar los metadatos.
5. Siga las instrucciones del asistente de metadatos:
v Seleccione una conexión de origen de datos y pulse Siguiente.
Si la conexión de origen de datos que desea no está listada, deberá crearla
“Creación de conexiones de origen de datos” en la página 44.
v Seleccione las casillas de verificación de los objetos que desea importar.
v Especifique cómo desea que la importación gestione los nombres de objetos
duplicados. Elija si va a importar y crear un nombre exclusivo. Si decide
crear un nombre exclusivo, el objeto importado se muestra con un número.
Por ejemplo, en su proyecto verá QuerySubject y QuerySubject1.
v Si desea importar objetos de sistema, seleccione la casilla de verificación
Mostrar objetos del sistema y seleccione los objetos del sistema que desea
importar.
v Especifique los criterios que va a usar para crear relaciones y pulse
Importar.
Para obtener más información, consulte: “Relaciones” en la página 68.
Se muestra una lista de objetos que no han podido importarse y un recuento
de los objetos que se importaron.
6. Pulse Finalizar.
Guarde el archivo del proyecto (.cpf) y todos los archivos relacionados en una
carpeta. Si guarda un proyecto con un nombre o formato diferente, recuerde
guardar el proyecto en otra carpeta.
7. Pulse el nombre del proyecto en el Visor de proyectos y defina la propiedad
del proyecto Utilizar entorno local de diseño para ID de referencia con el
valor verdadero.
Nota: Si cambia el valor de esta propiedad por falso más adelante, después de
cambiar los elementos de consulta del modelo, los informes basados en este
modelo presentarían errores.
Capítulo 5. Modelado de metadatos relacionales 185

8. Pulse Proyecto, Idiomas, Definir idiomas y añada los idiomas necesarios al
proyecto, y elija uno de ellos como Idioma activo.
El idioma activo debe ser diferente del idioma de diseño. Para obtener más
información, consulte: “Adición de un idioma a un proyecto” en la página
127.
9. Guarde el proyecto.
10. Cree los paquetes necesarios y publíquelos en IBM Cognos Connection.
Utilice los paquetes ubicados para crear contenido en IBM Cognos Report
Studio, IBM Cognos Query Studio o IBM Cognos Event Studio. Por ejemplo,
cree informes en Report Studio o Query Studio.
Resultados
Ahora puede probar el modelo para comprobar que funciona del modo previsto.
Prueba de un modelo duradero
Procedimiento
1. Lance Report Studio utilizando el paquete publicado en Creación de un modelo
duradero y cree y guarde un informe.
2. En Framework Manager, abra el proyecto creado en el apartado Creación de un
paquete duradero y compruebe que el idioma activo del proyecto y el idioma
de diseño sean diferentes.
3. En el idioma activo, cambie el nombre de algunos de los elementos de consulta
incluidos en el paquete publicado en el paso 1.
4. Vuelva a publicar el paquete en IBM Cognos Connection reemplazando el
paquete original.
5. Lance Report Studio de nuevo utilizando el paquete que ha vuelto a publicar y
abra el informe creado en el paso 1.
El informe muestra los nombres de los elementos de consulta cambiados en el
panel Objetos insertables. No obstante, la especificación del informe muestra
los nombres de los elementos de consulta en el idioma de diseño, no en el
idioma activo, en el que se han realizado los cambios.
6. Ejecute el informe.
Las columnas que representan los elementos de consulta con los nombres
cambiados muestran los nombres nuevos.
Resultados
Análisis de modelos
El modelo es duradero porque el cambio de nombre de sus elementos de consulta
no produjo errores en los informes existentes.
Puede analizar los metadatos de un modelo utilizando Model Advisor, que es una
herramienta automatizada que aplica reglas basadas en directrices de modelado
actuales e identifica las áreas del modelo que necesita examinar. Para ayudarle a
comprender la naturaleza del problema resaltado, así como algunas acciones
posibles, se proporcionan enlaces para las secciones apropiadas de la
documentación. Model Advisor no sirve de sustituto para un modelador instruido;
proporciona nuevos modeladores con una herramienta asistencial y más
modeladores con experiencia con una herramienta de diagnóstico.
186 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Puede seleccionar una o varias pruebas para ejecutarlas en el modelo seleccionado
o el subconjunto de un modelo. Verifique el modelo y arregle los errores antes de
analizar el modelo. Para obtener más información, consulte: “Verificación de
modelos o paquetes” en la página 249.
Si analiza un modelo nuevo, utilice el siguiente flujo de trabajo:
v Analice los objetos que acaba de importar, especialmente sus relaciones y
determinantes.
v Utilice los problemas que se identifican para resolver posibles problemas de
generación de consultas.
v Cuando vaya creando más vistas, utilice Model Advisor para analizar cada uno
de los posibles problemas.
v Antes de publicar el modelo, utilice Model Advisor en los objetos que se
publicarán.
Si analiza un modelo establecido anterior o un modelo que aún no se ha
completado, utilice Model Advisor para validar las prácticas de modelado. El flujo
de trabajo es similar al utilizado para los nuevos modelos: se inicia en la vista de
base de datos y sigue hacia arriba.
Hechos identificados por cardinalidad
Esta prueba busca asuntos de consulta que solo tengan la cardinalidad muchos (n)
en los extremos de la relación en la que están implicados. Los asuntos de consulta
con esta cardinalidad se tratan como hechos al generar consultas, por lo que es
importante asegurarse de que están identificados correctamente.
Asuntos de consulta que se pueden comportar como hechos o
dimensiones
Esta prueba busca asuntos de consulta que tengan una combinación de la
cardinalidad varios (n) yunoocero(1,0). La cardinalidad mixta significa que el
comportamiento de un asunto de consulta puede cambiar en función de los demás
asuntos de consulta utilizados en una consulta. Esto puede generar consultas
imprevisibles en algunos casos. Si el asunto de consulta se evalúa como un hecho,
se incluirá en la ruta de la consulta. Si se evalúa como una dimensión, se puede
omitir si no está referenciado directamente en la consulta. Para asegurar un
comportamiento previsible, debe resolver estos escenarios.
La cardinalidad mixta puede indicar un asunto de consulta que forma parte de una
dimensión en copo de nieve o una relación maestro-detalle. En caso de tablas
intermedias de dimensiones en copo de nieve, no existe ningún problema que se
deba resolver. Pueden producirse problemas en las situaciones en las que hay
varias rutas de consulta disponibles; la prueba para asuntos de consulta con varias
relaciones debe resaltar estos casos.
Asuntos de consulta con varias relaciones
Esta prueba busca asuntos de consulta que tengan muchas relaciones entre dos
objetos o una unión de bucle que no represente el modelo de unión de esquema en
estrella.
Con frecuencia, varias relaciones entre dos asuntos de consulta están asociadas a
dimensiones de rol. Con las dimensiones de rol, se crean alias que permiten que
cada rol tenga una unión diferente y un comportamiento independiente distinto.
Capítulo 5. Modelado de metadatos relacionales 187

Varias rutas de uniones que indican uniones de bucle (excepto para esquemas en
estrella) pueden generar problemas de consultas que se dividen incorrectamente.
Esto influye en la previsibilidad de la generación de consultas para los usuarios.
Si el software de IBM Cognos tiene varias relaciones sin criterios característicos
entre los que se pueda elegir, utiliza la primera relación del orden alfabético. Si
necesita crear una consulta que utilice una relación diferente, siempre se produce
un problema. Además, si desea utilizar filtros en los criterios específicos del rol
definido por las relaciones y los filtros se excluyen mutuamente, no aparecen datos
en el informe. Para obtener información sobre las dimensiones de rol y un ejemplo,
consulte: “Dimensiones de rol” en la página 343.
Nota: Cuando la cardinalidad identifica claramente hechos y dimensiones, el
software de IBM Cognos puede resolver automáticamente uniones de bucle
causadas por datos de esquema en estrella cuando dispone de varias tablas de
hechos unidas a un conjunto de tablas de dimensiones común. Model Advisor
ignora los modelos de unión de esquema en estrella porque no se califican como
uniones problemáticas.
Asuntos de consulta que se unen a sí mismos
Esta prueba busca relaciones reflexivas o recursivas. Estas relaciones implican dos
o varios niveles de granularidad. IBM Cognos Framework Manager importa
relaciones reflexivas pero no las utiliza al ejecutar consultas. Las relaciones
reflexivas, también denominadas uniones automáticas, solo aparecen en el modelo
para su representación.
Con frecuencia, un asunto de consulta que se une a sí misma indica una relación
padre-hijo. Los conjuntos de datos que tienen relaciones padre-hijo pueden tener
una profundidad definida o indefinida. La única manera de saber de cuál se trata
es comprender los datos y el concepto de negocio representados.
Si existe un problema o no cuando encuentre una relación padre-hijo dependerá de
cómo tenga previsto utilizar los datos en la aplicación. Puede haber casos en los
que solo sea necesario un nivel de relación, y se trate de un escenario bastante
sencillo de modelar. Si sabe que se han rellenado completamente los datos para
cada nivel y que hay un número definido de niveles, también puede elegir una
solución de únicamente modelado. Sin embargo, en los casos en que exista una
cantidad importante de datos, que éstos no se hayan rellenado completamente en
cada nivel (jerarquía irregular o desequilibrada) o que el número de niveles en los
datos pueda cambiar en el tiempo, o ambos, debe transformar los datos en una
estructura plana con un número fijo de columnas antes del modelado en
Framework Manager.
Determinantes que entran en conflicto con relaciones
Esta prueba busca determinantes que entren en conflicto con la relación definida
para el asunto de consulta. Los determinantes se utilizan para asegurar que la
agregación en informes es correcta y que las consultas se generan correctamente.
Los determinantes reflejan la granularidad mediante la representación de
subconjuntos o grupos de datos en un asunto de consulta y se utilizan para
asegurar la agregación correcta de estos datos repetidos. Los determinantes están
más directamente relacionados con el concepto de claves e índices del origen de
datos y se importan en función de la información de claves exclusivas y de índice
del origen de datos. Revise siempre los determinantes que se importan y, si es
188 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

necesario, modifíquelos o cree otros adicionales. Mediante la modificación de
determinantes, puede reemplazar la información de índice y claves del origen de
datos, sustituyéndola por información mejor alineada con sus necesidades de
informe y análisis. Mediante la adición de determinantes, puede representar
grupos de datos repetidos que son pertinentes para su aplicación.
Model Advisor comprueba los asuntos de consulta con determinantes y distintivos
que cumplen uno de los criterios siguientes:
v La relación hace referencia a todos los elementos de consulta en un determinante
exclusivo y la cardinalidad de la relación no es 1:1 ni 0:1
v La relación hace referencia a algunos de los elementos de consulta en un
determinante exclusivo y la cardinalidad de la relación no es 1:n ni 0:n
Model Advisor también señala las apariciones en las que las claves de una relación
no coinciden con las claves de un grupo por determinante.
Factores que reemplazarán el valor de SQL minimizado
Esta prueba busca diversos factores que reemplacen el valor del tipo de generación
de SQL minimizado, como asuntos de consulta de orígenes de datos modificados,
relaciones entre asuntos de consulta de modelo o determinantes para asuntos de
consulta de modelo.
Cuando utiliza SQL minimizado, el SQL generado solo contiene el conjunto de
tablas mínimo y las uniones necesarias para obtener los valores para los elementos
de consulta seleccionados.
Para ilustrar un ejemplo del significado de SQL minimizado, se presentan cuatro
asuntos de consulta, Product Line, Product Type, Product y Product Multilingual
que están unidos entre sí.
Se pueden combinar en un asunto de consulta de modelo.
Capítulo 5. Modelado de metadatos relacionales 189

Por ejemplo, si prueba el asunto de consulta Products (modelo) como una unidad,
verá que se hace referencia a las cuatro tablas en la cláusula from de la consulta.
select
PRODUCT_LINE.PRODUCT_LINE_CODE as Product_Line_Code,
PRODUCT_LINE.PRODUCT_LINE_EN as Product_Line,
PRODUCT_TYPE.PRODUCT_TYPE_CODE as Product_Type_Code,
PRODUCT_TYPE.PRODUCT_TYPE_EN as Product_Type,
PRODUCT.PRODUCT_NUMBER as Product_Number,
PRODUCT_MULTILINGUAL.PRODUCT_NAME as Product_Name
PRODUCT_MULTILINGUAL.DESCRIPTION as Product_Description,
PRODUCT.INTRODUCTION_DATE as Introduction_Date,
PRODUCT.PRODUCT_IMAGE as Product_Image,
PRODUCT.PRODUCTION_COST as Production_Cost,
PRODUCT.MARGIN as Margin
from
gosl_82..gosl.PRODUCT_LINE PRODUCT_LINE,
gosl_82..gosl.PRODUCT_TYPE PRODUCT_TYPE,
gosl_82..gosl.PRODUCT PRODUCT,
gosl_82..gosl.PRODUCT_MULTILINGUAL PRODUCT_MULTILINGUAL
where
(PRODUCT_MULTILINGUAL."LANGUAGE" - N’EN’)
and
(PRODUCT_LINE.PRODUCT_LINE_CODE = PRODUCT_TYPE.PRODUCT_LINE_CODE)
and
(PRODUCT_TYPE.PRODUCT_TYPE_CODE = PRODUCT.PRODUCT_TYPE_CODE)
and
(PRODUCT.PRODUCT_NUMBER = PRODUCT_MULTILINGUAL.PRODUCT_NUMBER
Si solo prueba Product Name, verá que la consulta resultante únicamente utiliza
Product Multilingual, que es la tabla necesaria. Es el efecto del SQL minimizado.
select
PRODUCT_MULTILINGUAL.PRODUCT_NAME as Product_Name
from
gosl_82..gosl.PRODUCT_MULTILINGUAL PRODUCT_MULTILINGUAL
where
(PRODUCT_MULTILINGUAL."LANGUAGE" - N’EN")
Cálculos incluidos que utilizan el tipo de agregación calculada
Esta prueba detecta si ha establecido la propiedad Agregado regular en calculado
para los cálculos incluidos.
El tipo de agregación calculada solo está soportado en los siguientes casos:
190 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

v Cálculos independientes
v Cálculos incluidos en dimensiones de medida y que se basan en medidas de la
misma dimensión de medida
Para obtener más información sobre las agregaciones calculadas, consulte: “Reglas
para interpretar agregaciones calculadas” en la página 136.
Asuntos de consulta que pueden comportar un conflicto de
almacenamiento en memoria caché de metadatos
Esta prueba busca factores que reemplacen metadatos almacenados en memoria
caché, como asuntos de consultas de orígenes de datos cuyo SQL se ha modificado
o asuntos de consultas que pueden contener cálculos o filtros.
IBM Cognos Framework Manager almacena los metadatos que se importan del
origen de datos. Sin embargo, en función de los valores del regulador y
determinadas acciones que se pueden realizar en el modelo, es posible que estos
metadatos no se utilicen al preparar una consulta. Si selecciona el regulador
Permitir portabilidad de modelo mejorada en tiempo de ejecución, Framework
Manager siempre consulta el origen de datos para obtener información sobre los
metadatos antes de preparar una consulta. Si no ha seleccionado el regulador
Permitir portabilidad de modelo mejorada en tiempo de ejecución, Framework
Manager accede a los metadatos que se han almacenado en el modelo en lugar de
consultar el origen de datos. Existen excepciones y los casos principales son:
v Cualquier modificación del SQL en un asunto de consulta de orígenes de datos.
Se incluye el uso de macros.
v La adición de un cálculo o filtro a un asunto de consulta de orígenes de datos.
Nota: La mayoría de proveedores de sistemas de gestión de bases de datos
relacionales soportan perfectamente las consultas de metadatos generadas por el
software de IBM Cognos, por lo que no deberían tener un impacto apreciable en la
mayoría de aplicaciones de creación de informes.
Model Advisor solo está pensado para utilizarse con modelos de metadatos
basados en relaciones. No ejecute Model Advisor en todo un modelo; en su lugar,
aplíquelo a vistas específicas una a una, para asegurarse de que los comentarios se
toman según el contexto. Por ejemplo, si un problema de una vista de importación
no se ha resuelto, el problema se puede resolver mediante el modelado que se
realiza en una vista intermedia.
En modelos grandes o espacios de nombres, Model Advisor puede no devolver
resultados inmediatamente.
Debido a que Model Advisor no es sensible a los datos, debe conocer los datos y
modelar los metadatos de forma correspondiente a las necesidades que su
inteligencia empresarial necesite. No todos los elementos señalados por Model
Advisor indican un problema. El contexto de cada problema indicado por Model
Advisor es importante.
Pasos para analizar un modelo
Procedimiento
1. Pulse uno o varios objetos para analizar.
Capítulo 5. Modelado de metadatos relacionales 191

v Seleccione los asuntos de consulta, las dimensiones, las jerarquías, el cálculo,
los elementos de consulta o los atajos para analizar objetos que se mostrarán
en un informe determinado para probar el informe antes de crearlo.
v Seleccione una carpeta o espacio de nombres para analizar todos sus objetos.
Si un objeto hace referencia a un objeto de otra carpeta o espacio de
nombres, el objeto referenciado también se analiza.
v Seleccione un paquete antes de publicarlo para que siga las directrices del
modelado.
2. Pulse Herramientas, Ejecutar Model Advisor.
Sugerencia: También puede pulsar con el botón derecho en uno o varios
objetos y, después, pulsar Ejecutar Model Advisor.
3. En la pestaña Opciones, seleccione los criterios que desea utilizar en el análisis.
4. Pulse Analizar.
5. En la pestaña Model Advisor, repase los problemas que se han identificado.
Se muestra una descripción de cada problema, un enlace a más información y
una lista de los objetos afectados por el problema.
6. Para saber si existe un problema con un objeto, pulse el icono del explorador
de contexto en la columna Acción del informe.
El Explorador de contexto muestra los objetos a los que está conectado el
objeto seleccionado. Puede seleccionar un objeto relacionado y ver a qué objetos
está conectado.
192 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Capítulo 6. metadatos de SAP BW
Nota: La información sobre metadatos relacionales se encuentra en otro tema.
Tras importar metadatos, deberá asegurarse de que están configurados de modo
que cumplan los requisitos de creación de informes de sus usuarios, así como
proporcionar la información adicional que necesiten. Las mejoras realizadas en IBM
Cognos Framework Manager no afectan al origen de datos original.
Sugerencia: Para verificar que el modelo cumple los requisitos de creación de
informes, puede seleccionar los objetos que se visualizarán en un informe y
probarlos. Los resultados de la prueba mostrarán el informe que verán los
usuarios, así como el SQL y los mensajes del software de IBM Cognos, si los
hubiera. También puede publicar un paquete en cualquier momento y luego
utilizarlo para crear informes.
Puede comprobar el proyecto en cualquier momento para asegurarse de que las
referencias entre los objetos que contiene son válidas. Consulte: “Verificación de
modelos o paquetes” en la página 249.
Al trabajar con metadatos de SAP BW en IBM Cognos Framework Manager, puede
realizar lo siguiente:
v Importar los metadatos.
v Trabajar con dimensiones.
v Controlar cómo se usan y formatean los datos comprobando las propiedades de
los elementos de consulta.
v Si es preciso, añadir más reglas de negocio, como cálculos y filtros, para refinar
los datos recuperados y asegurarse de que la información adecuada esté
disponible para sus usuarios.
v Organizar el modelo creando vistas separadas para cada grupo de usuarios que
reflejen los conceptos empresariales familiares para sus usuarios.
v Si es preciso, ajustar la configuración en Framework Manager y los estudios de
IBM Cognos para optimizar el rendimiento.
Después de trabajar con el modelo, puede crear un paquete y publicarlo para sus
usuarios. Para obtener más información, consulte: “Publicación de paquetes” en la
página 264.
Nota: También puede crear paquetes para consultas y cubos SAP BW directamente
en IBM Cognos Connection. Para obtener más información, consulte la sección
sobre paquetes en la Guía de administración y seguridad.
Importación desde un origen de datos de SAP BW
Al importar desde un origen de datos de SAP BW, puede importar todos los
metadatos o importar solo los objetos que seleccione.
Para obtener información sobre la correlación de objetos de metadatos de SAP BW
con objetos de IBM Cognos Framework Manager, consulte: “Correlación de objetos
de SAP BW con Framework Manager” en la página 199.
© Copyright IBM Corp. 2005, 2013 193

Puede disponer de diferentes vistas (o capas) en el modelo: una vista de
importación que contenga los metadatos que ha importado del origen de datos y
una vista empresarial donde puede mejorar los metadatos. Después de la
importación, puede copiar los metadatos en la vista empresarial. De esta manera
tendrá dos vistas que se deberán sincronizar con BW InfoProvider.
Sugerencia: Si desea exponer cifras clave calculadas de una consulta SAP BW, debe
importar la consulta SAP BW.
Acceso a metadatos y datos de SAP BW
Cuando se utiliza un origen de datos SAP BW, el acceso de los usuarios a los
metadatos de un cubo de información o una consulta de información no implica
que también tengan acceso a los datos contenidos en estos objetos. Para permitir
que Framework Manager recupere metadatos de SAP BW, se deben configurar
privilegios de acceso en el sistema SAP BW. Para garantizar que los usuarios
tengan los permisos de acceso apropiados, verifique los permisos asignados a los
roles de los usuarios.
Se deben configurar los siguientes objetos de autorización para que Framework
Manager pueda importar cubos de información u orígenes de datos, conocidos
como cubos de información en el sistema SAP BW.
v S_RFC
Asigne el valor 16 al campo Actividad.
Asigne al campo Nombre del RFC que se va a proteger el valor SYST, RSOB,
SUGU, RFC1, RS_UNIFICATION, RSAB, SDTX, SU_USER, RSNDI_SHIE.
Asigne el valor FUGR al campo Tipo del objeto RFC que se va a proteger.
v S_TABU_DIS
Asigne el valor 03 al campo Actividad.
Asigne al campo Grupo de autorización el valor &NC&.
Nota: &NC& representa cualquier tabla que no tenga un grupo de autorización.
Por razones de seguridad, cree un nuevo grupo de autorización y asígnele la
tabla RSHIEDIR. El nuevo grupo de autorización restringe el acceso del usuario
sólo a la tabla anteriormente indicada, que la herramienta de modelado necesita.
Cree el nuevo grupo de autorización como personalización del sistema SAP.
v S_USER_GRP
Asigne al campo Actividad el valor 03, 05.
Asigne el valor predeterminado al campo Grupo de usuarios en principal
maestro de usuario.
v S_RS_COMP
Asigne el valor predeterminado al campo Actividad.
Asigne al campo Área de información el valor Nombre técnico del área de
información.
Asigne al campo Cubo de información el valor Nombre técnico del cubo de
información.
Asigne el valor predeterminado al campo Nombre (ID) de los componentes de
informe.
Asigne el valor predeterminado al campo Tipo de componentes de informe.
v S_RS_COMP1
Asigne el valor predeterminado al campo Actividad.
194 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Asigne el valor predeterminado al campo Nombre (ID) de los componentes de
informe.
Asigne el valor predeterminado al campo Tipo de componentes de informe.
Asigne el valor predeterminado al campo Propietario (persona responsable).
v S_RS_HIER
Asigne el valor 71 al campo Actividad.
Asigne al campo Nombre de jerarquía el valor Nombre de jerarquía.
Asigne al campo InfoObjeto el valor Nombre técnico del InfoObjeto.
Asigne el valor Versión jerárquica al campo Versión.
v S_RS_ICUBE
Asigne el valor 03 al campo Actividad.
Asigne los valores DATOS y DEFINICIÓN al campo Subobjeto del cubo de
información.
Asigne al campo Área de información el valor Nombre técnico del área de
información.
Asigne al campo Cubo de información el valor Nombre técnico del cubo de
información.
Sugerencias
v &NC& representa cualquier tabla que no tenga un grupo de autorización. Por
razones de seguridad, cree un nuevo grupo de autorización y asígnele la tabla
RSHIEDIR. El nuevo grupo de autorización restringe el acceso de usuario a la
tabla anterior solo, que Framework Manager necesita. Cree el nuevo grupo de
autorización como una personalización en el sistema SAP BW.
v Puede utilizar el asterisco (*) para representar todos los valores, cuando se
visualiza solo o valores parciales, cuando se utiliza en cualquier lugar de una
cadena.
Estructuras de SAP BW
Muchas consultas SAP BW existentes contienen estructuras que puede utilizar en
consultas de IBM Cognos para controlar la cantidad y el orden de la información
que ven los usuarios. Por ejemplo, con estructuras duales puede crear un informe
de tabla de referencias cruzadas con una estructura en cada eje.
Las estructuras son:
v Estructura de cifras clave
SAP BW Query Designer crea automáticamente una estructura de cifras clave
cuando se añaden cifras clave a una consulta. Debe tener al menos una cifra
clave para importar los metadatos de la consulta a IBM Cognos Framework
Manager. Esto es así incluso cuando no utiliza la cifra clave en informes. Por lo
tanto, siempre tendrá una estructura de cifras clave.
v Estructura de características
Una estructura de características es una colección de valores de características
(miembros) de una o más dimensiones. Para crear una estructura de
características en SAP, añada una estructura a la consulta y luego añada los
miembros requeridos a la estructura. En el software de IBM Cognos, la
estructura se visualiza como una dimensión adicional que sólo tiene un nivel de
varias raíces.
Capítulo 6. metadatos de SAP BW 195

Al importar la consulta de SAP BW a Framework Manager, la estructura de cifras
clave se visualiza en la dimensión de medida denominada Cifras clave y la
estructura de características se visualiza como una dimensión adicional.
Si vuelve a importar la misma consulta de SAP BW a Framework Manager, deberá
usar la misma configuración para la casilla de verificación Soporte para estructuras
duales de SAP BW. Framework Manager no permite seleccionar una configuración
diferente para la misma consulta porque entonces se generan diferentes objetos en
el modelo, lo cual da lugar a errores. Puede utilizar diferentes configuraciones para
consultas diferentes.
Jerarquías SAP BW
Al importar metadatos, Framework Manager genera una dimensión en cada
característica SAP BW.
Sólo una jerarquía asociada a una característica determinada se puede utilizar en
un informe. Por lo tanto, deberá agrupar las dimensiones que representen las
jerarquías de una misma característica en una carpeta o un asunto de consulta de
modelo para que la creación de informes resulte más sencilla para los usuarios.
Si hay varias jerarquías en un origen de datos de SAP BW, la primera jerarquía que
se importa se convierte en la jerarquía predeterminada.
Framework Manager da soporte a los siguientes tipos de jerarquías:
v Característica
Es una lista de todos los valores de características.
v Nodo de texto
Los nodos no hoja contienen sólo texto y no hacen referencia a ningún otro
objeto de origen de datos.
v Valor de característica
Los nodos de cada nivel de una jerarquía de presentación son valores de otra
característica.
v Recursiva
Los nodos de toda la jerarquía de presentación son de la propia característica.
Si una característica no está en una dimensión de tiempo, sino que es fecha y se
trata como una fecha en SAP BW, la característica se importa con el tipo de datos
de fecha.
Framework Manager no da soporte a jerarquías que contienen dos o más tipos de
nodos. Estas jerarquías se importan pero se ocultan en el modelo de Framework
Manager.
Dado que los metadatos jerárquicos se generan automáticamente para SAP BW, no
se pueden cambiar en Framework Manager.
Jerarquías versionadas
Puede importar los siguientes tipos de jerarquías versionadas desde un origen de
datos SAP BW:
v Jerarquía dependiente de versión
Una jerarquía puede tener varias versiones. Cada versión de una jerarquía puede
tener una estructura diferente, como Ventas por región y Ventas por director.
196 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Durante la importación de metadatos, Framework Manager identifica cada
versión como una jerarquía independiente y crea una dimensión para cada una
de ellas.
v Jerarquía completa dependiente de tiempo
Cada versión tiene asociado un periodo que no se superpone con ninguna
versión de la misma jerarquía. La estructura de cada versión puede ser diferente.
Durante la importación de metadatos, Framework Manager identifica cada
versión como una jerarquía e incluye el tiempo aplicable como parte del nombre
de la dimensión.
v Estructura de jerarquía dependiente de tiempo
Hay una única versión de la jerarquía, pero se pueden asignar periodos a los
nodos de la jerarquía. Con el tiempo, la estructura de la jerarquía puede cambiar
con nuevos niveles que se incorporen o eliminen. Por ejemplo, con el tiempo,
pueden agregarse niveles que representan diferentes distritos de ventas. Durante
la importación de metadatos, Framework Manager identifica una estructura de
jerarquía dependiente de tiempo como una jerarquía no versionada y reconoce la
estructura de la jerarquía a partir de la fecha actual.
El tipo de dimensión determina qué jerarquía se utiliza y, para las jerarquías
dependientes de tiempo, qué fecha se utiliza para controlar la versión.
Framework Manager define la fecha clave de consulta de las jerarquías
dependientes de tiempo sobre la base de las fechas que se contienen en la jerarquía
dependiente de tiempo. Puede seleccionar versiones específicas de las jerarquías.
Para las jerarquías con versiones basadas en el tiempo, el valor predeterminado es
la fecha y hora actuales. La jerarquía que se aplique a una característica depende
del tipo de fecha clave de consulta: fija, actual o variable. La fecha clave de
consulta se define para una fecha determinada.
Para una fecha fija, se incluye solo la versión que se corresponde con la fecha fija
en la consulta de SAP BW subyacente. Por ejemplo, si la consulta de SAP BW tiene
una fecha fija como 2005, solo se importa 2005.
Para la fecha actual, se incluye solo la versión que incluye un periodo adecuado
para el presente hasta un tiempo razonable del futuro.
Para la variable, se define una fecha para la variable en Framework Manager y se
incluye solo la versión de la jerarquía aplicable a esta fecha.
Cuando se utiliza Framework Manager para modelar datos de SAP BW,
cualesquiera versiones o fechas aplicadas a una jerarquía de presentación en SAP
BW no se importan en el modelo. Por consiguiente, todas las versiones de la
jerarquía son accesibles en Framework Manager.
Puede tener una jerarquía dependiente de tiempo y una variable definidas en SAP
BW para establecer la fecha efectiva para la jerarquía. En este caso, asigne una
fecha fija a la variable en Framework Manager e incluya solo la dimensión que se
corresponda con la fecha en el modelo.
En Framework Manager, si una jerarquía versionada no es dependiente de tiempo
y tiene una versión fija, incluya solo la versión de la jerarquía asociada con la
versión seleccionada. En otro caso, los usuarios verán una jerarquía a la que no
pueden acceder.
Capítulo 6. metadatos de SAP BW 197

Pasos para acceder a un cubo de información protegido
Procedimiento
1. Cree una consulta en Business Explorer Query Designer que pueda acceder al
cubo de información.
2. Cree una variable de autorización para cada InfoObjeto en el cubo de
información subyacente para el que hay autorizaciones.
3. Para cada variable, compruebe que la opción Listo para entrada esté
inhabilitada.
De forma predeterminada, esta opción está activada.
4. Permita que la consulta acceda a través de OLE DB para OLAP.
5. Guarde la consulta.
6. En Framework Manager, haga referencia a la consulta en lugar de al cubo de
información.
Pasos para importar de un origen de datos de SAP BW
Procedimiento
1. Compruebe que haya una conexión al origen de datos.
Para obtener más información sobre la creación de conexiones de origen de
datos, consulte la publicación IBM CognosGuía de administración y seguridad
2. Pulse el espacio de nombres, carpeta o segmento al que desea importar y, en
el menú Acciones, pulse el asistente para ejecutar metadatos.
3. Seleccione Orígenes de datos y pulse Siguiente.
4. Seleccione una conexión de origen de datos de SAP BW y pulse Siguiente.
5. Seleccione los objetos que desea importar.
Si está realizando la importación de nuevo, el objeto existente se actualiza.
Si está importando objetos nuevos y existe un objeto con el mismo nombre, se
importa el objeto nuevo y se agrega un número al final del nombre original.
Por ejemplo, en su proyecto verá QuerySubject y QuerySubject1.
Una vez importados los elementos de consulta, estos no se pueden suprimir
sin suprimir todo el asunto de consulta.
6. Si desea importar una estructura de características y una estructura de cifras
clave, seleccione la casilla de verificación Soporte para estructuras duales de
SAP BW.
El contenido de la página Seleccionar objetos se actualiza para reflejar las
estructuras duales del origen de datos.
Nota: Si está volviendo a importar la misma consulta de SAP BW (por
ejemplo, porque el origen de datos subyacente ha cambiado), debe utilizar el
mismo valor para esta casilla de verificación. No puede utilizar otro valor
para la misma consulta porque entonces se generan diferentes objetos en el
modelo, lo cual da lugar a errores.
7. Seleccione los idiomas que desea importar.
Estos idiomas deben existir en el origen de datos.
Puede añadir idiomas al proyecto posteriormente, pero no puede retroceder e
importar metadatos específicos del idioma del origen de datos. Al finalizar la
importación, debe añadir manualmente los metadatos específicos del idioma.
8. Indique si desea que Framework Manager muestre el nombre abreviado, el
nombre largo o el nombre técnico de las dimensiones.
198 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

v Si selecciona el nombre abreviado y el campo está vacío, se muestra el
nombre largo.
v Si selecciona el nombre largo y el campo está vacío, se muestra el nombre
abreviado.
v Si selecciona el nombre abreviado o el nombre largo y ambos campos están
vacíos, se muestra el nombre técnico.
9. Para que los objetos del modelo estén organizados del mismo modo que en
Business Explorer Query Designer, seleccione la opción Mejorar el modelo
para la organización de objetos en SAP BW.
Tendrá una carpeta para cada característica.
10. Pulse Siguiente.
Se muestra una lista de objetos que no han podido importarse con un
recuento de los objetos que se importaron.
11. Pulse Finalizar.
Resultados
Después de la importación, verifique el uso y la propiedad de agregación. Las
tablas de hechos pueden contener columnas numéricas que no deben agregarse,
como los tipos de cambio.
Si va a recrear una consulta en otro sistema de SAP BW, utilice el mecanismo de
migración de SAP BW para transportar la consulta. De este modo, el nombre
técnico de cada medida no cambiará y cualquier proyecto que haga referencia a la
consulta podrá dirigirse a cualquier sistema sin realizar modificaciones en el
proyecto.
Correlación de objetos de SAP BW con Framework Manager
Los objetos de SAP BW se correlacionan con los siguientes objetos de IBM Cognos
Framework Manager.
Objeto de SAP BW Objeto de Framework Manager
Consulta, cubo de información, cubo remoto,
cubo múltiple
Espacio de nombres.
Característica Una carpeta que contiene dimensiones.
Debe seleccionar la opción Mejorar el
modelo para la organización de objetos en
SAP BW al importar metadatos para tener
una carpeta para cada característica.
Nota: De forma predeterminada, Framework
Manager importa las características de
moneda y unidad de medida de SAP BW.
Puede eliminar estas características si no las
necesita.
Capítulo 6. metadatos de SAP BW 199

Dimensiones (SAP BW)
Objeto de SAP BW Objeto de Framework Manager
Dimensión Dimensión. La dimensión puede contener
jerarquías que representan cada jerarquía de
presentación. La jerarquía predeterminada
contiene dos niveles que representan
- la agregación de todos los valores de
características, también conocido como valor
Todo
- todos los valores de características
Cifra clave Elemento de consulta que forma parte de
una dimensión de medida denominada
Cifras clave.
Nivel de jerarquía de presentación Nivel.
Nota: Los nombres de nivel deben definirse
en Administrator Workbench para que sean
significativos.
Atributo Elemento de consulta asociado con un nivel
cuya propiedad Uso tenga el valor Atributo.
Variable de SAP BW Propiedad de origen de datos.
Para obtener información acerca de las
variables de SAP BW soportadas por
Framework Manager, consulte: “Variables de
SAP BW” en la página 229.
Para obtener información sobre la configuración de los privilegios de acceso para
recuperar metadatos de SAP BW, consulte: “Acceso a metadatos y datos de SAP
BW” en la página 194.
Una dimensión es una amplia agrupación de datos acerca de un aspecto
importante de una empresa, como productos, fechas o mercados.
Los tipos de dimensiones con los que puede trabajar en IBM Cognos Framework
Manager son dimensiones regulares y dimensiones de medida. En SAP BW, las
dimensiones de medida se conocen como cifras clave.
Por ejemplo, en un proyecto para análisis de ventas, incluye estas dimensiones:
Nombre Tipo Descripción
Tiempo Dimensión regular Fechas de ventas organizadas
en años, trimestres, meses,
semanas y días en los que se
realizaron las ventas.
200 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Nombre Tipo Descripción
Region Dimensión regular Ubicaciones de las ventas
agrupadas en regiones de
ventas, países y ciudades.
Product Dimensión regular Detalles del producto
organizados por tipo de
producto, marca, modelo,
color y empaquetado.
Cliente Dimensión regular Información sobre el cliente.
Sales Dimensión de cifras clave Detalles de la compra como
unidades vendidas, ingresos
y beneficios.
Modificar una dimensión regular (SAP BW)
Una dimensión regular contiene información clave de la empresa y descriptiva que
organiza en una jerarquía, desde el nivel más alto de granularidad al más bajo.
Normalmente tiene varios niveles y cada uno de ellos necesita una clave y un
título. Si no tiene una única clave para su nivel, se recomienda crear una en un
cálculo.
Las dimensiones regulares de modelo se basan en un origen de datos o en asuntos
de consulta de modelo que ya se han definido en el modelo. Se debe definir una
clave de empresa y un título de tipo de cadena para cada nivel. Al verificar el
modelo, se detecta la ausencia de la información de claves de empresa e título. En
lugar de unir dimensiones regulares de modelo a dimensiones de medida, cree
uniones en los asuntos de consulta subyacentes y cree una relación de ámbito entre
la dimensión regular y la dimensión de medida.
Cuando las dimensiones se basan en metadatos de SAP BW, no se puede editar la
consulta subyacente.
Pasos para modificar una dimensión regular
Procedimiento
1. Pulse la dimensión regular que desea cambiar.
2. En el menú Acciones, pulse Editar definición.
3. Elija la acción que desee:
v Incluir cálculos seleccionando el nivel, pulsando en Añadir y definiendo la
expresión “Creación de un cálculo (SAP BW)” en la página 236.
v Incluya los filtros “Creación de un filtro (SAP BW)” en la página 237.
v Pruebe la dimensión “Prueba de una dimensión o de otro objeto (SAP BW)”
en la página 211.
4. Pulse Aceptar.
Jerarquías para una dimensión regular (SAP BW)
Una jerarquía es una lista ordenada de niveles o una colección de elementos. Cada
elemento de consulta de una jerarquía debe tener un nombre exclusivo.
Capítulo 6. metadatos de SAP BW 201

Puede especificar varias jerarquías en dimensiones regulares en IBM Cognos
Framework Manager. Varias jerarquías para una dimensión regular se comportan
como vistas de la misma consulta. La primera jerarquía es la jerarquía principal o
predeterminada.
Solo se puede utilizar una jerarquía cada vez en una consulta. Por ejemplo, no
puede utilizar una jerarquía en las filas de un informe de tabla de referencias
cruzadas y otra jerarquía de la misma dimensión en las columnas. Si necesita
ambas jerarquías en el mismo informe, debe crear dos dimensiones, una para cada
jerarquía. Para obtener más información, consulte: “Modelado de dimensiones con
varias jerarquías” en la página 351.
Por ejemplo, Sales Staff puede visualizarse por Manager o por Geography y se
puede modelar como una única dimensión con dos jerarquías.
El software de IBM Cognos utiliza valores predeterminados que no fallarán para el
tipo de jerarquía.
v Para dimensiones que representan características de SAP BW, la propiedad
Equilibrada se establece en true y la propiedad Irregular en false.
v Para dimensiones que representan jerarquías de presentación, la propiedad
Equilibrada se establece en false y la propiedad Irregular en true.
Puede que estos valores no reflejen los valores adecuados ya que el software de
IBM Cognos no determina la estructura de la jerarquía real. Puede mejorar el
rendimiento de modelos y consultas SAP BW ajustando los valores de dimensión
en IBM Cognos Framework Manager y en los estudios de IBM Cognos. Para cada
dimensión, compruebe los valores de las propiedades Equilibrada e Irregular para
asegurarse de que están establecidos correctamente.
Además de las jerarquías de las dimensiones, hay jerarquías en los metadatos de
SAP BW. Para obtener más información, consulte: “Jerarquías SAP BW” en la
página 196.
Jerarquía equilibrada:
Todas las rutas de una jerarquía equilibrada descienden hasta la misma
profundidad.
Por ejemplo, en el diagrama siguiente, el nivel más alto es Línea de producto
(nivel 1), el nivel 2 es Tipo de producto y el nivel 3 es Productos.
202 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

En SAP BW, todos los nodos hoja de una jerarquía son valores de la característica,
pero no todas las rutas necesitan descender hasta el nivel más bajo de la jerarquía.
Puede definir si una dimensión representa una jerarquía equilibrada mediante la
modificación de la propiedad Equilibrada de una dimensión. El valor que
establezca dependerá del tipo de objeto que la dimensión represente y si la
jerarquía está equilibrada.
Representación de la dimensión Valor de la propiedad Equilibrada
característica true
jerarquía de presentación equilibrada true
jerarquía de presentación no equilibrada false
jerarquía de presentación cuya estructura es
desconocida
false
En caso de una dimensión que representa una característica sin una jerarquía de
presentación, esta propiedad es de solo lectura y tiene asignado el valor true.
Si una jerarquía de presentación está equilibrada, establezca la propiedad
Equilibrada de su dimensión asociada en true. De forma predeterminada, contiene
el valor false para todas las jerarquías de representación. Una jerarquía está
equilibrada si todos los valores de característica hoja aparecen en el nivel más bajo
de la jerarquía. Si se establece la propiedad Equilibrada en true como apropiada, el
servidor de IBM Cognos BI puede generar MDX más eficiente.
Cuando todas las rutas tienen la misma profundidad, establezca la propiedad
Equilibrada en true, de lo contrario, establézcala en false.
Si asigna el valor true a la propiedad Equilibrada de una jerarquía desequilibrada,
las consultas en las que se implica esta dimensión pueden devolver datos
incorrectos.
Capítulo 6. metadatos de SAP BW 203

Si asigna el valor false a la propiedad Equilibrada de una jerarquía equilibrada, el
rendimiento puede ser menor.
Jerarquía desequilibrada:
Las ramas de una jerarquía desequilibrada descienden varios niveles.
Por ejemplo, en el diagrama siguiente, el nivel más alto de una organización es
Director general (nivel 1), el nivel 2 es Vicepresidente y el asistente ejecutivo del
Director general. El asistente ejecutivo no tiene subordinados a diferencia de los
vicepresidentes.
Una jerarquía desequilibrada también puede ser irregular. En una jerarquía
desequilibrada irregular, hay espacios en los niveles y los niveles descienden varias
profundidades.
En SAP BW, esto sucede solo cuando hay nodos "no asignados" (o "#") en una
jerarquía de presentación. No obstante, la presencia de un nodo de este tipo no
garantiza que la jerarquía esté desequilibrada. Debe estudiar el diseño de la
jerarquía para estar seguro.
Una jerarquía desequilibrada también puede ser irregular. En una jerarquía
desequilibrada irregular, hay espacios en los niveles y los niveles descienden varias
profundidades.
Jerarquía irregular:
Al menos una ruta de la jerarquía se salta al menos un nivel.
Por ejemplo, el nivel más alto es Compañía (nivel 1); el nivel 2 es Sucursal; el nivel
3 es Edificio, y el nivel 4 es Departamento. Algunas sucursales pueden tener sólo
un edificio, con los mismos departamentos que otras con varios edificios.
204 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

En SAP BW, esto sucede sólo cuando hay nodos "no asignados" (o #) en una
jerarquía de presentación. No obstante, la presencia de un nodo de este tipo no
garantiza que la jerarquía sea irregular. Debe estudiar el diseño de la jerarquía para
estar seguro.
El software de IBM Cognos utiliza valores predeterminados que no fallarán para el
tipo de jerarquía.
v Para dimensiones que representan características de SAP BW, la propiedad
Equilibrada se establece en true y la propiedad Irregular en false.
v Para dimensiones que representan jerarquías de presentación, la propiedad
Equilibrada se establece en false y la propiedad Irregular en true.
Puede definir si una dimensión representa una jerarquía irregular mediante la
modificación de la propiedad Irregular de una dimensión. El valor que establezca
dependerá del tipo de objeto que la dimensión represente y si sabe si la jerarquía
es irregular.
Representación de la dimensión Valor de la propiedad Irregular
característica false
Jerarquía de presentación que no es irregular false
Jerarquía de presentación que es irregular true
jerarquía de presentación cuya estructura es
desconocida
true
Capítulo 6. metadatos de SAP BW 205

Una dimensión que representa una característica sin una jerarquía de presentación
es de sólo lectura.
Si una jerarquía de presentación no es irregular, establezca la propiedad Irregular
de su dimensión asociada en false. Al establecer la propiedad Irregular en false
como apropiada, el servidor de IBM Cognos BI puede generar MDX más eficiente.
Si asigna un valor true a la propiedad Irregular de una jerarquía que no es
irregular, las consultas en las que interviene esta dimensión pueden devolver datos
incorrectos.
Si asigna un valor false a la propiedad Irregular de una jerarquía irregular, el
rendimiento puede ser menor.
Limitaciones con jerarquías irregulares y desequilibradas y valores agregados:
Las jerarquías irregulares y desequilibradas pueden crear espacios vacíos dentro de
rutas individuales de una jerarquía, así como nodos en niveles intermedios sin
descendientes a niveles inferiores. Si un informe incluye elementos de consulta de
una única dimensión que corresponden a niveles consecutivos o adyacentes en una
jerarquía, los valores de hecho asociados con los niveles inferiores siempre deberán
agregarse a los valores asociados con los niveles superiores de la dimensión en el
informe.
No obstante, si los elementos de consulta no son de niveles consecutivos o
adyacentes, y la jerarquía SAP BW subyacente es irregular o desequilibrada, es
posible que los valores de los niveles superiores no reflejen la agregación de los
valores de hecho de los niveles inferiores. Los valores de hecho agregados
asociados con los niveles superiores reflejan los valores agregados en el origen de
datos. Este es un comportamiento típico en los orígenes de datos OLAP, pero
puede resultar contrario a lo que dicta la intuición para las personas
acostumbradas a crear informes con orígenes de datos relacionales.
Jerarquía de red:
Un miembro de la jerarquía tiene más de un padre.
Por ejemplo, un empleado puede crear informes a través de diferentes
organizaciones y tener varios directores. En SAP BW, este empleado se incluiría en
el recuento de todos los empleados sólo una vez y no se incluiría en cada
organización.
206 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Niveles de una dimensión regular (SAP BW)
Un nivel es una colección de atributos, normalmente de una granularidad común.
Cada nivel necesita un elemento definido como una clave y otro elemento definido
como un título. En el caso de orígenes de datos de SAP BW, los niveles contienen
miembros.
El primer nivel de la jerarquía se define automáticamente como nivel Todo.
Contiene un único miembro raíz, que representa el nivel superior de la jerarquía.
Por ejemplo, el nivel Todo para la dimensión de tiempo se llama Tiempo (Todos).
No se puede suprimir ni mover el nivel Todo. Sí se puede cambiar el nombre, la
descripción y la sugerencia.
Si no especifica los niveles de la jerarquía correctamente, se podrían producir
agregaciones incorrectas.
Nombres exclusivos de miembro:
El nombre exclusivo de miembro (MUN) es cómo se encuentra el miembro en el
origen de datos, similar al uso de claves de empresa para buscar registros en una
tabla.
El nombre exclusivo de miembro se utiliza en la expresión para un elemento de
datos de miembro que se usa en un informe, una referencia a miembros en filtros y
expresiones, y también se utiliza en el acceso a los detalles entre orígenes de datos
OLAP. Las claves de miembro en el MUN para los diferentes orígenes de datos
OLAP deben coincidir.
Roles (SAP BW)
También puede crear expresiones que hagan referencia a roles en vez de a
elementos de consulta. Debe utilizar la función roleValue para hacer referencia a
un rol particular. Por ejemplo, quiere realizar una consulta a un rol específico de
una jerarquía, pero el elemento de consulta que interpreta ese rol es diferente en
cada nivel de la jerarquía. Una única consulta puede abarcar los diferentes
Capítulo 6. metadatos de SAP BW 207

elementos de consulta de cada nivel. También puede utilizar la función roleValue
cuando conoce el rol pero no el elemento de consulta subyacente.
Puede asignar varios roles a un elemento de consulta, pero el mismo rol no se
puede asignar a diferentes elementos de consulta del mismo nivel.
Los roles predeterminados están predefinidos para todas las jerarquías padre-hijo y
para todos los niveles de jerarquías basadas en niveles. La mayoría de estos roles
no se pueden ver en los estudios de IBM Cognos.
Los roles reservados por IBM Cognos BI empiezan con un guión bajo. El nombre
de un rol personalizado no puede empezar con un guión bajo.
Roles predeterminados
Los roles predeterminados incluyen los siguientes:
v _businessKey
Representa la clave del nivel. Este rol también se utiliza para acceder a detalles
de un origen de datos a otro, porque la clave de empresa debe ser coherente en
toda la organización.
El rol _businessKey sólo se puede asignar a un atributo en un nivel.
v _dimensionUniqueName
Devuelve el nombre de la dimensión según está definido en el modelo de
Framework Manager.
v _hierarchyUniqueName
Devuelve el nombre de la jerarquía según está definido en el modelo de
Framework Manager.
v _levelLabel
Devuelve la etiqueta asignada al nivel.
v _levelNumber
Devuelve el número del nivel.
v _levelUniqueName
Devuelve el nombre asignado al nivel.
v _longName
Se asigna al elemento de consulta que representa el nombre largo de un nivel.
v _memberCaption
Presenta el título de un miembro que se mostrará en los estudios de IBM
Cognos.
v _memberDescription
Devuelve la descripción de un miembro de una dimensión.
v _memberUniqueName
Devuelve el nombre exclusivo de miembro de IBM Cognos.
v _parentUniqueName
Define el nombre asignado al padre del elemento de consulta seleccionado.
v _planningDefault
Especifica qué elemento de consulta debe utilizarse cuando se seleccionan
medidas. Este rol sólo se aplica para IBM Cognos Planning y SAP BW.
v _rollupType
Define cómo se agrega un elemento de consulta.
208 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

v _shortName
Se asigna al elemento de consulta que representa el nombre abreviado de un
nivel.
Si un elemento de consulta utiliza un rol predeterminado, no puede cambiar su rol.
Esto sólo se aplica a metadatos de SAP BW.
Roles personalizados
Puede crear roles personalizados. Cada rol que cree deberá tener un nombre
exclusivo. Los roles reservados por IBM Cognos empiezan con un guión bajo. El
nombre de un rol personalizado no puede empezar con un guión bajo. Puede
traducir los roles personalizados en el modelo.
A las propiedades definidas por el usuario en orígenes de datos OLAP se les
asignan roles con el mismo nombre que el elemento de consulta.
Especificación de roles (SAP BW)
Los roles definen lo que se visualiza en el árbol de miembros en los estudios de
IBM Cognos. Utilice roles para organizar y gestionar metadatos y para determinar
cómo presentar los datos a los usuarios.
Procedimiento
1. Pulse la dimensión cuyos roles desea definir.
2. En el menú Acciones, pulse Editar definición.
3. Pulse la pestaña Dimensión.
4. En el cuadro Jerarquías, pulse el nivel que desee.
5. En el cuadro Seleccione un nivel del control de jerarquías para ver los
elementos de consulta, pulse un elemento de consulta.
6. En Rol, pulse el botón de puntos suspensivos (...) .
7. Pulse la pestaña Roles personalizados y pulse Añadir.
8. Pulse Cerrar.
9. Pulse Aceptar.
Resultados
También puede utilizar la pestaña Mapa de dimensiones para definir los roles.
Pulse Atributos, pulse con el botón derecho en el elemento de consulta y pulse
Editar roles.
Modificación de una dimensión de cifras clave (SAP BW)
Una dimensión de cifras clave es un conjunto de hechos, como Cantidad vendida o
Precio.
Las cifras clave se relacionan entre sí mediante dimensiones regulares. Cuando se
utiliza en un informe o en un análisis, la dimensión de cifras clave muestra el
valor del elemento de consulta, como un nombre o número, o muestra nulo, cero o
no válido. Para crear informes que comparen y contrasten completamente áreas
funcionales, es posible que tenga que utilizar más de una dimensión de cifras clave
en un informe.
Puede añadir un valor incluyendo cálculos basados en reglas de negocio existentes,
como Margen de beneficio.
Capítulo 6. metadatos de SAP BW 209

También puede modificar las propiedades de varias dimensiones al mismo tiempo
“Sustitución de varios valores de propiedad” en la página 21.
No se pueden definir jerarquías ni niveles para una dimensión de cifras clave.
Cuando las dimensiones se basan en metadatos de SAP BW, no se puede editar la
consulta subyacente. Sin embargo, puede añadir cálculos y filtros.
Procedimiento
1. Pulse la dimensión de cifras clave que desea cambiar.
2. En el menú Acciones, pulse Editar definición.
3. Elija la acción que desee:
v Incluya cálculos pulsando en Añadir y definiendo la expresión “Creación de
un cálculo (SAP BW)” en la página 236.
v Cambie el orden de las medidas, elementos o cálculos mediante los botones
de flecha. Sin embargo, si la dimensión de medida contiene una carpeta,
puede cambiar el orden solo en el Visor de proyectos.
v Incluya los filtros “Creación de un filtro (SAP BW)” en la página 237.
v Pruebe la dimensión “Prueba de una dimensión o de otro objeto (SAP BW)”
en la página 211.
4. Pulse Aceptar.
Visualización de objetos relacionados (SAP BW)
Puede explorar una representación visual de los objetos que están conectados con
el asunto de consulta o la dimensión que ha seleccionado en el Visor del proyecto.
El Explorador de contexto muestra los objetos a los que está conectado el objeto
seleccionado. Asimismo, puede seleccionar un objeto conectado y ver sus
referencias.
Puede ocultar un objeto en el Explorador de contexto. Puede cambiar el diseño,
colocar todos los objetos en el Explorador de contexto, ampliar o disminuir,
imprimir, obtener vistas previas de los diagramas antes de imprimir y cambiar la
configuración de la página.
También puede utilizar la pestaña Mapa de dimensiones para explorar
dimensiones.
Procedimiento
1. Seleccione uno o más objetos para explorar.
2. En el menú Herramientas, pulse Lanzar explorador de contexto.
3. Para ver los objetos conectados, pulse uno o varios objetos y pulse el botón
adecuado.
Objetivo Botón
Ver los objetos relacionados con el objeto seleccionado.
Ver las referencias intermedias de los objetos.
Ver todas las referencias de los objetos.
210 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

4. Si desea ver los detalles sobre un objeto, como sus relaciones y elementos de
consulta, pulse con el botón derecho en el objeto, pulse Navegar por diagrama,
Valores de diagrama y seleccione los detalles que desee.
Prueba de una dimensión o de otro objeto (SAP BW)
Puede probar una dimensión, un nivel, una jerarquía, elementos de consulta o
asuntos de consulta de modelo.
Si se prueba una dimensión regular, se obtienen los atributos asociados con la
primera jerarquía que se encuentra en la dimensión.
Prueba de objetos
Para ver los resultados que devuelve un objeto, puede probarlo. Puede probar un
objeto al crearlo, o más tarde. Los objetos que se pueden probar son dimensiones,
asuntos de consulta, conjuntos de consulta, jerarquías, niveles, cálculos y elementos
de consulta.
Puede ver los datos que se visualizarán en un informe específico antes de publicar
un paquete seleccionando y probando los objetos que se visualizarán en el informe.
Esto permite depurar fácilmente un modelo y verificar que el modelo cumple los
requisitos de creación de informes, porque no necesita crear y publicar los
paquetes primero.
Al probar un objeto, IBM Cognos Framework Manager devuelve datos de ejemplo.
No se aplica formateo a los datos de ejemplo. Si debe probar formateo, deberá
publicar el paquete y visualizar los objetos en los estudios de IBM Cognos.
Puede ver resultados diferentes según lo que pruebe. Por ejemplo, si utiliza el
editor de expresiones para probar un cálculo incluido en un asunto de consulta,
Framework Manager sólo prueba la expresión, pero no el elemento, de modo que
la configuración de agregación para el elemento de consulta no se aplica en la
prueba. Al probar todo el asunto de consulta, que incluye el cálculo, se obtiene un
resultado diferente, porque sí se aplica la configuración de agregación. Por
ejemplo, si la configuración de agregación es resumir, verá un número menor de
filas en la prueba.
Al probar una dimensión de medida, el SQL usa agregados, no las medidas.
Si prueba un segmento hijo de un modelo segmentado, puede ver un error si un
objeto de los que está probando hace referencia a un objeto de otro segmento hijo y
el objeto al que se hace referencia no está disponible para el proyecto en cuestión.
Compruebe que el modelo padre contiene todos los objetos y que este mensaje de
error no se visualiza al probar el modelo padre.
Los valores del regulador pueden afectar a los resultados de la prueba. Para
obtener más información, consulte: “Reguladores” en la página 304.
Puede cambiar la configuración de prueba existente para personalizar los
resultados que muestra la prueba. Por ejemplo, entre otros valores, puede controlar
el número de filas devueltas.
Pasos para realizar pruebas al crear o modificar objetos (SAP
BW)
Procedimiento
1. Seleccione el objeto que desea probar.
Capítulo 6. metadatos de SAP BW 211

2. En el menú Acciones, pulse Editar definición y pulse la pestaña Probar o
Información de consultas.
El cuadro Resultados de la prueba está vacío hasta que se ejecuta la consulta.
Los conjuntos de resultado que contengan objetos binarios grandes se
mostrarán como [blob].
3. Para ejecutar la consulta y recuperar todos los resultados de la prueba, pulse
Probar muestra.
4. Si prueba una expresión y desea aplicar la propiedad Agregado regular del
elemento de consulta o medida referenciado en la expresión, seleccione la
casilla de verificación Suma automática.
Si desmarca esta casilla de verificación, se devuelve una fila para cada fila del
conjunto de resultados de la consulta.
5. Si desea obtener más información sobre los resultados de la consulta, pulse la
pestaña Información de consulta.
6. Pulse Aceptar.
Pasos para ver los datos que se mostrarán en un informe
determinado
Procedimiento
1. Seleccione los objetos que se mostrarán en el informe.
2. Pulse Herramientas, Probar.
3. Para ejecutar la consulta y recuperar todos los resultados de la prueba, pulse
Probar muestra.
4. Si desea ver los detalles de los problemas detectados, pulse la pestaña
Información sobre consultas.
Si no ve los resultados de la consulta en la ventana de prueba, significa que los
datos del origen de datos superan el valor de uno de los reguladores. La
consulta se detiene en el límite especificado, pero la ventana de resultados de
prueba no contiene datos. Sugerencia: Defina todos los reguladores con el valor
cero.
Cambio de los valores de prueba (SAP BW)
Puede personalizar las pruebas cambiando sus valores.
Procedimiento
1. Seleccione el objeto que desee.
2. Pulse Acciones, Editar definición y, después, pulse la pestaña Probar o
Información de consulta.
3. Pulse Opciones, Probar valores.
4. Elija las opciones que desee.
212 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Objetivo Acción Persistencia
Recuperar un parámetro y
mostrar un número
determinado de filas
Seleccione la casilla de
verificación Restringir el
número máximo de filas
que se devolverán y escriba
el numero de filas que desee.
Este valor no mejora el
rendimiento de la
recuperación de datos
cuando se prueban
dimensiones, asuntos de
consulta y conjuntos de
consulta.
Especificar el nivel de detalle Arrastre el control deslizante
del nivel de información
que se muestra en la
información de resultados
hasta el punto que represente
el nivel de detalle que
requiera.
Reemplazar temporalmente
parámetros de sesión
Aplicar filtros de modo de
diseño relevantes
Aplicar un filtro de
seguridad
En el cuadro Parámetros de
sesión, pulse Definir.
Aparece el cuadro de diálogo
Parámetros de sesión.
Seleccione la casilla de
verificación Aplicar todos
los filtros de modo de
diseño durante las pruebas.
Esto aplica todos los filtros
pertinentes cuyo uso se
defina en el modo de diseño
en otra dimensión, asunto de
consulta o conjunto de
consultas.
En el cuadro Filtros de
seguridad, pulse Editar.
Cambiar valores de solicitud En el cuadro Valores de
solicitud actuales, pulse
Solicitudes.
Aparece el cuadro de diálogo
Gestor de solicitudes de
modelos, que muestra todas
las peticiones, y sus valores,
que están en el modelo.
5. Efectúe una doble pulsación en Aceptar.
Este valor se aplica a todas
las dimensiones, asuntos de
consulta y conjuntos de
consulta del modelo.
Este valor se guarda y se usa
en la siguiente sesión con
cualquier otro modelo.
Este valor se guarda y se usa
en la siguiente sesión con
este modelo.
Los valores de reemplazo no
se guardan con el modelo.
Este valor solo sirve en la
sesión actual.
Este valor se guarda y se usa
en la siguiente sesión con
cualquier otro modelo.
Este valor se guarda y se usa
en la siguiente sesión con
este modelo.
Los valores de la solicitud no
se guardan con el modelo.
Este valor solo sirve en la
sesión actual.
Capítulo 6. metadatos de SAP BW 213

Resultados
Para obtener más información, consulte: “Dimensiones (SAP BW)” en la página 200
y “Asuntos de consulta de modelo (SAP BW)”.
Asuntos de consulta de modelo (SAP BW)
Un asunto de consulta es un conjunto de elementos de consulta que tienen una
relación inherente.
IBM Cognos Framework Manager se utiliza para modificar los asuntos de consulta
a fin de optimizar y personalizar los datos que recuperan. Por ejemplo, puede
añadir filtros o cálculos. Cuando se cambia la definición de un asunto de consulta,
Framework Manager vuelve a generar los elementos de consulta asociados,
asegurando así que los cambios en las propiedades del asunto de consulta queden
reflejados en todos los elementos de consulta de ese asunto de consulta.
En el caso de metadatos de SAP BW, puede trabajar con asuntos de consulta de
modelo en IBM Cognos Framework Manager.
Los asuntos de consulta de modelo no se generan directamente desde un origen de
datos, sino que se basan en elementos de consulta de otras dimensiones o asuntos
de consulta, incluidos otros asuntos de consulta de modelo. Al utilizar asuntos de
consulta de modelo, puede crear una vista más abstracta de orientación
empresarial de un origen de datos.
Si crea un asunto de consulta de modelo que contiene varias dimensiones, pueden
surgir problemas al utilizar el asunto de consulta de modelo junto con otros
asuntos de consulta o dimensiones. Asegúrese de que los elementos de un asunto
de consulta de modelo no contravengan la lógica del modelo como, por ejemplo, se
inserta el elemento del producto entre los elementos de país o región y ciudad.
Pruebe el asunto de consulta de modelo en un informe; si la agrupación funciona,
el asunto de consulta de modelo es válido.
Creación de asuntos de consulta de modelo (SAP BW)
También puede crear un asunto de consulta de modelo fusionando asuntos de
consulta existentes y elementos de consulta “Creación de asuntos de consulta de
modelo basados en objetos existentes (SAP BW)” en la página 215.
Procedimiento
1. Seleccione la carpeta de espacio de nombres y, desde el menú Acciones, pulse
Crear, Asunto de consulta.
2. Escriba un nombre para el asunto de consulta nuevo en el cuadro Nombre.
3. Pulse Modelo y Aceptar.
Nota: Para los metadatos SAP BW, solo puede crear asuntos de consulta de
modelo.
4. Pulse la pestaña Definición de asunto de consulta.
5. Para añadir elementos al asunto de consulta de modelo, arrastre los elementos
desde el cuadro Objetos de modelo disponibles al cuadro Elementos de
consulta y cálculos.
Puede cambiar el orden de los elementos y de los cálculos. Sin embargo, si el
asunto de consulta contiene una carpeta de elementos de consulta, puede
cambiar el orden solo en el Visor de proyectos.
214 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

6. Para incluir cálculos en el asunto de consulta de modelo, pulse Añadir y defina
el cálculo.
7. Para incluir filtros en el asunto de consulta de modelo, pulse la pestaña Filtros.
8. Para probar el asunto de consulta de modelo, pulse la pestaña Probar.
9. Pulse Aceptar.
Un aviso muestra si las modificaciones han invalidado relaciones, otros asuntos
de consulta, cálculos o filtros.
Resultados
También puede estar interesado en los temas siguientes:
v cálculos incluidos “Creación de un cálculo (SAP BW)” en la página 236
v filtros incluidos “Creación de un filtro (SAP BW)” en la página 237
v probar y configurar opciones de prueba “Prueba de una dimensión o de otro
objeto (SAP BW)” en la página 211
v modificar las propiedades de varios asuntos de consulta al mismo tiempo
“Sustitución de varios valores de propiedad” en la página 21
Creación de asuntos de consulta de modelo basados en objetos
existentes (SAP BW)
Puede seleccionar objetos de modelo existentes y fusionarlos en un asunto de
consulta de modelo nuevo.
Esto significa que puede reutilizar metadatos existentes para crear con mayor
rapidez asuntos de consulta.
Puede fusionar, entre otros, los objetos siguientes:
v Asuntos de consulta de modelo y sus atajos.
v Elementos de consulta, filtros y cálculos de los asuntos de consulta de modelo.
Puede fusionar todos los objetos del mismo tipo que desee en una nueva consulta
en una sola operación. La consulta siempre crea un asunto de consulta de modelo.
El asunto de consulta nuevo contiene todos los filtros que existen en el asunto de
consulta original.
Compruebe que los asuntos de consulta de modelo no contravengan la lógica del
modelo. Por ejemplo, si un asunto de consulta con varias características se utiliza
en combinación con otros asuntos de consulta, puede haber problemas cuando se
ejecute el informe.
No incluya elementos de consulta de diferentes asuntos de consulta o jerarquías de
la misma dimensión. Esto genera un error de tiempo de ejecución.
Procedimiento
1. Pulse Ctrl y los objetos que desea fusionar en un único asunto de consulta.
2. Pulse Acciones, Fusionar en asunto de consulta nuevo.
Validación de asuntos de consulta de modelo (SAP BW)
Puede validar la definición de un asunto de consulta sin tener que abrir el cuadro
de diálogo Definición de asunto de consulta. Esto es útil cuando:
v Se han añadido elementos de consulta nuevos a un asunto de consulta
Capítulo 6. metadatos de SAP BW 215

v La definición del asunto de consulta subyacente ha cambiado
El comando Validar objeto evalúa los objetos seleccionados y garantiza que se
puedan ejecutar.
Cuando IBM Cognos Framework Manager evalúa un asunto de consulta, se envía
una petición al origen de datos de SAP BW. Los atributos físicos, como el tipo de
datos, se actualizan según sea necesario para el asunto de consulta.
También puede sincronizar todo el proyecto “Sincronización de proyectos” en la
página 301.
Procedimiento
1. Seleccione el asunto de consulta que desea evaluar.
2. En el menú Herramientas, pulse Validar objeto.
Resultados
Si ha cambiado la propiedad Agregado regular con el valor no soportado, la
propiedad se restablecerá cuando se evalúe el asunto de consulta. Si la propiedad
se define con otro valor, esta no se cambia.
Nota: Aparece un mensaje de error para cada asunto de consulta no válido. El
objeto también tendrá el estatus de No válido.
Elementos de consulta (SAP BW)
Un elemento de consulta es la parte más pequeña del modelo que puede incluirse
en un informe. Representa una única instancia de algo, como la fecha en que se
presentó un producto.
Los atributos y cifras clave se importan como elementos de consulta en IBM
Cognos Framework Manager.
En el mismo informe sólo debe utilizarse una jerarquía de una dimensión.
En el caso de metadatos de SAP BW, sólo se pueden modificar propiedades
basadas en texto, como el nombre o una sugerencia.
Los informes pueden contener diferentes elementos de consulta de uno o más
objetos del modelo, por lo que las propiedades de los elementos de consulta
controlan numerosos aspectos del informe final. Al crear una dimensión de modelo
o un asunto de consulta de modelo, los elementos de consulta heredan las
propiedades de los elementos de consulta del origen de datos en los que se basan.
Las propiedades de elementos de consulta o medidas incluyen las siguientes:
Propiedad del elemento de consulta Descripción
Nombre Nombre del elemento de consulta o medida.
Descripción Descripción del elemento de consulta o
medida.
216 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Propiedad del elemento de consulta Descripción
Última modificación Fecha en que se modificó por última vez el
elemento de consulta o medida. La
propiedad se actualiza automáticamente con
la fecha y hora actuales.
Última modificación realizada por Usuario que modificó por última vez el
elemento de consulta o medida. Esta
propiedad se actualiza automáticamente
cuando se modifica el elemento.
El valor es el nombre de usuario de inicio de
sesión actual.
Comentarios sobre modelo Se utiliza para añadir comentarios internos
sobre el modelo. La información se utiliza en
el diálogo Analizar el impacto de la
publicación yenInforme de modelo. Los
usuarios del paquete no tienen acceso a los
comentarios.
Sugerencia Descripción que puede visualizarse en el
paquete publicado para los usuarios.
Expresión Se utiliza para crear cálculos incluidos que
proporcionan a los usuarios los valores
calculados que suelen usar.
Esta propiedad es sólo para medidas.
Nota: SAP BW no utiliza la propiedad
Expresión.
Nombre externo Nombre que se muestra en el origen de
datos.
Está oculto Indica si se oculta o se muestra el elemento
de consulta o la medida en el paquete
publicado.
Incluso cuando Está oculto tiene el valor
true y el elemento de consulta o la medida
resulta invisible para los usuarios, siempre
está presente en el paquete publicado,
porque otros objetos del modelo pueden
necesitar el elemento de consulta o la
medida. El elemento de consulta o la
medida no se ven en el asistente de
publicación de paquetes.
Por ejemplo, un cálculo puede utilizar un
elemento de consulta oculto.
Capítulo 6. metadatos de SAP BW 217

Propiedad del elemento de consulta Descripción
Uso Uso previsto para los datos representados
por el elemento de consulta.
Esta propiedad es sólo para elementos de
consulta.
Formato Cómo se visualiza la información en un
informe.
Moneda Moneda utilizada.
Esta propiedad no se puede cambiar en el
panel Propiedad. Utilice la propiedad
Formato para cambiar la moneda.
Tipo de datos Tipo de datos definido en el origen de datos.
Esta propiedad se establece en el origen de
datos, por lo que en Framework Manager es
de sólo lectura.
Precisión Número total de dígitos.
Esta propiedad se establece en el origen de
datos, por lo que en Framework Manager es
de sólo lectura.
Escala Cuántos dígitos se representan en la escala.
Por ejemplo, se pueden mostrar los números
en millares, de modo que 100.000 signifique
100.000.000.
Esta propiedad se establece en el origen de
datos, por lo que en Framework Manager es
de sólo lectura.
Tamaño Tamaño del elemento de consulta o medida.
Esta propiedad se establece en el origen de
datos, por lo que en Framework Manager es
de sólo lectura.
Admite nulos Indica si el elemento de consulta o la
medida pueden contener un valor nulo.
218 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario
Esta propiedad se establece en el origen de
datos, por lo que en Framework Manager es
de sólo lectura.

Propiedad del elemento de consulta Descripción
Tipo de visualización Cómo se muestra el elemento de consulta.
El valor de columna puede visualizarse en
los estudios de IBM Cognos como una
imagen, como un enlace o como un valor.
La configuración predeterminada es como
valor.
Esta propiedad es sólo para elementos de
consulta.
Tipo MIME Formato que utiliza el valor de columna.
Por ejemplo, si Tipo de visualización se
define como imagen, Tipo MIME podría ser
jpeg.
Esta propiedad es sólo para elementos de
consulta.
Nota: SAP BW no utiliza la propiedad Tipo
MIME.
Información de solicitud Comportamiento de la solicitud.
Agregado regular Tipo de agregación que se asocia con el
elemento de consulta, medida o cálculo en el
paquete publicado.
Reglas de agregado Para metadatos relacionales modelados
dimensionalmente, reglas para la agregación
semiaditiva.
Para metadatos de SAP BW, la propiedad
Reglas de agregado es de sólo lectura.
Regla de asignación Especifica el tipo de asignación definida
para la medida.
El valor predeterminado especifica que se
usa asignación constante en consultas de
lista y asignación sólo una vez en consultas
de tabla de referencias cruzadas. Un valor
constante especifica que se usa asignación
constante en todas las consultas.
No es ordenable Indica si los valores de este elemento de
consulta se pueden ordenar.
También puede estar interesado en los temas siguientes:
Esta propiedad es para elementos de
consulta que contienen objetos grandes,
como blob.
Capítulo 6. metadatos de SAP BW 219

v Las propiedades Uso y Agregado regular “Modificar cómo se agregan los
elementos de consulta (SAP BW)”
v Cambio del símbolo de moneda “Formateo de elementos de consulta (SAP BW)”
en la página 223
v Solicitudes “Definición de un control de solicitud (SAP BW)” en la página 224
v Modificación de las propiedades para varios elementos de consulta al mismo
tiempo “Sustitución de varios valores de propiedad” en la página 21
Modificar cómo se agregan los elementos de consulta (SAP
BW)
Cuando se importan metadatos, Framework Manager asigna valores a las
propiedades Uso y Agregado regular para los elementos de consulta y medidas
según el tipo de objeto en el que se encuentre el elemento de consulta o la medida.
La propiedad Uso identifica el uso que se pretende dar a los datos representados
por el elemento de consulta “propiedad Uso” en la página 138. La propiedad
Agregado regular identifica el tipo de agregación que se aplica al elemento de
consulta oalamedida “Propiedad Agregado regular” en la página 139. Los
usuarios pueden reemplazar los valores de la propiedad Agregado regular. Para
las medidas semiaditivas, puede especificar reglas de agregación adicionales
modificando la propiedad Agregado regular “Definición de reglas de agregado
para medidas semiaditivas” en la página 139.
Al modificar la propiedad Agregado regular, puede seleccionar los valores que no
están disponibles mediante la importación, como el promedio y el máximo. Debe
comprender lo que los datos representan para conocer qué valor de agregado se
necesita. Por ejemplo, si agrega un número de pieza, los únicos valores de
agregado que son aplicables son recuento, recuento Distinct, máximo y mínimo.
En general, utilice la propiedad Agregado regular en lugar de añadir funciones de
resumen a las expresiones. Utilice funciones de resumen en expresiones si la
propiedad de agregado no soporta el resumen necesario o si la complejidad de la
expresión no se puede gestionar utilizando las propiedades de elemento.
Para contar valores diferenciados tales como clientes diferenciados, la técnica
siguiente asegura resultados coherentes en las listas, las tablas de referencias
cruzadas y los gráficos. Es mejor contar de modo individualizado en una clave de
empresa que identifica de forma exclusiva los valores que hacerlo en un valor de
cadena. Esto evita la pérdida accidental de filas donde se utiliza el mismo nombre
pero que son realmente exclusivas.
A continuación se muestra un ejemplo de recuento de clientes individualizados, en
un modelo relacional. Cree una copia de Clave de cliente en el asunto de consulta
Cliente, denomínelo Recuento de clientes, establezca la propiedad de Uso en
Hecho y, a continuación, establezca la propiedad Agregado regular en Recuento
Distinct. No es recomendable crear un elemento de consulta con la expresión de
Count (distinct [Customer Key]) porque el elemento de consulta puede
comportarse de manera imprevisible en diversos escenarios. Si se necesita
formatear, establezca el Tipo de formato en Número y especifique las propiedades
de Formato tales como el Número de posiciones decimales y Separador de miles
según sea necesario.
Para un modelo relacional modelado dimensionalmente (DMR), añada el elemento
de consulta Recuento de clientes que se acaba de crear en el asunto de consulta
Cliente, a una dimensión de medida. Los valores de la propiedad Agregado
220 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

egular y de la propiedad Formato se heredan. Alternativamente, puede añadir la
Clave de cliente original del asunto de consulta Cliente a la dimensión de medida,
establecer la propiedad Agregado regular en Recuento Distinct y establecer el
formato como corresponda.
Reglas para definir propiedades para dimensiones (SAP BW)
IBM Cognos Framework Manager utiliza las siguientes reglas para definir las
propiedades Uso y Agregado regular.
Objeto propiedad Uso propiedad Agregado regular
Elemento de consulta en una
dimensión regular
Elemento de consulta en una
dimensión de medida
Medida en una dimensión de
medida
Atributo No soportado
Identificador Recuento
Hecho Automático si la medida es
un cálculo
Suma si la medida no es un
cálculo
Si la medida es semiaditiva, utilice la propiedad Reglas de agregado para definir
reglas para la agregación semiaditiva. Consulte: “Definición de reglas de agregado
para medidas semiaditivas” en la página 139.
En el caso de metadatos de SAP BW, no puede cambiar estas propiedades para
dimensiones.
Reglas para definir propiedades para cálculos (SAP BW)
La propiedad Agregado regular para un cálculo en metadatos de SAP BW se
establece en Automático. Para determinar lo que significa automático, se aplican
estas reglas.
Cálculo Tipo de agregación
elementos clave no soportados
todos los demás elementos calculada
Reglas para definir propiedades para asuntos de consulta de
modelo (SAP BW)
Para asuntos de consulta de modelo, Framework Manager utiliza los valores del
objeto en el que se basa el asunto de consulta de modelo.
Nota: Si cambia un valor de agregación para metadatos de SAP BW, la agregación
no puede realizar consultas basadas en el tiempo porque no se aplican las reglas
de agregación.
propiedad Uso
Debe comprobar que esta propiedad esté definida correctamente. Por ejemplo, si
importa una columna numérica que participa en una relación, la propiedad Uso
debe tener el valor identificador. Puede cambiar la propiedad.
Capítulo 6. metadatos de SAP BW 221

Para los elementos de consulta de SAP BW, el valor de la propiedad Uso depende
del tipo de elemento dimensional en el que se basa el elemento de consulta.
Valor de la propiedad Uso Objeto de SAP BW Descripción
Identificador nivel de jerarquía Identifica de forma exclusiva
los valores de las
características en un nivel
determinado de la jerarquía.
Hecho cifra clave Representa una cifra clave
que normalmente son datos
numéricos. También se
soportan los datos de fecha y
de hora.
Atributo atributo de visualización Representa un atributo de
visualización que está
asociado con una
característica.
Propiedad Agregado regular
Por ejemplo, si el valor de la propiedad Agregado regular del elemento de
consulta Cantidad corresponde a suma y está agrupado por Nombre de producto
en un informe, la columna Cantidad del informe muestra la cantidad total de cada
producto.
Se da soporte a los siguientes tipos de agregación para orígenes de datos de SAP
BW:
v Automático
v Promedio
v Promedio distinto a cero
Sólo se da soporte a este tipo cuando está definido en el origen de datos. No se
puede cambiar la propiedad a un promedio distinto a cero en Framework
Manager.
v Calculado
v Recuento
v Recuento Distinct
v Recuento distinto a cero
Sólo se da soporte a este tipo cuando está definido en el origen de datos. No se
puede cambiar la propiedad a recuento distinto a cero en Framework Manager.
v Máximo
v Mediana
v Mínimo
v Desviación estándar
v Suma
v Varianza
222 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Reglas para determinar el tipo de agregación automática:
Si el cálculo se realiza en un objeto de SAP BW, se aplican estas reglas.
Cálculo Tipo de agregación
elementos clave no soportados
todos los demás elementos calculada
Propiedad de reglas de agregado
Para metadatos relacionales modelados dimensionalmente, esta propiedad define
cómo se agrega una medida semiaditiva para las dimensiones que seleccione.
Para metadatos de SAP BW, la propiedad Reglas de agregación es de solo lectura.
La propiedad Semiagregado en utiliza en su lugar.
Propiedad Semiagregado
Para metadatos de SAP BW, la propiedad Semiagregado muestra el valor definido
en el origen de datos, y la propiedad es de solo lectura.
Si el valor se define como No soportado en IBM Cognos Framework Manager, el
comportamiento de semiagregado se pasa por alto en los estudios de IBM Cognos.
La propiedad Semiagregado no estará soportada en versiones posteriores. En su
lugar, utilice la propiedad Reglas de agregado para las medidas semiaditivas.
Formateo de elementos de consulta (SAP BW)
Por ejemplo, puede asignar el tipo de formato Moneda a un elemento de consulta
numérico y utilizar la propiedad Número de posiciones decimales del cuadro de
diálogo Formato de datos para especificar cuántas posiciones decimales se
visualizan en los informes.
Algunos caracteres dependen del idioma y solo se visualizan correctamente cuando
el entorno local soporta la fuente aplicable. Por ejemplo, para que los símbolos de
moneda de Japón se visualicen correctamente, el entorno local se debe establecer
en japonés.
Si IBM Cognos Framework Manager no muestra la moneda que necesita, debe
asegurarse de instalar los paquetes de idioma adecuados para soportar los
símbolos de moneda. Por ejemplo, para que se visualice el símbolo de moneda de
la India (rupia), debe ejecutar un sistema operativo o instalar un paquete de
idioma que pueda mostrar este símbolo. El sistema operativo japonés o el idioma
japonés es uno de los que puede mostrar el símbolo de moneda de la India.
Puede definir propiedades para varios elementos de consulta a la vez. Sin
embargo, si los elementos de consulta tienen diferentes tipos de formato, se
reemplazan todas las propiedades que se habían especificado previamente y se
utilizan los valores predeterminados del origen de datos. Si los tipos de formato
originales de los elementos de consulta seleccionados son los mismos, todas las
propiedades para los elementos de consulta seleccionados se establecen
idénticamente.
Por ejemplo, para utilizar el mismo separador decimal para dos elementos de
consulta y mantener diferente el número de decimales, cada elemento de consulta
Capítulo 6. metadatos de SAP BW 223

se debe cambiar individualmente. Si se seleccionan ambos y se cambian a la vez,
todas las propiedades que incluyen el número de decimales se establecen
idénticamente para ambos elementos de consulta.
Pasos para dar formato a elementos de consulta (SAP BW)
Procedimiento
1. En el panel Visor de proyectos, pulse el elemento de consulta al que desea dar
formato.
2. En la pestaña Propiedades del panel Propiedades, pulse la propiedad Formato.
3. Defina el tipo de formato con el valor Moneda para que el formateo de moneda
se aplique a todos los tipos de informe.
4. En el cuadro Ámbito de moneda, especifique el tipo de moneda. Si no ve la
moneda que desea usar, pulse el botón Añadir.
5. En el cuadro Propiedades, seleccione o escriba el valor de propiedad
correspondiente.
6. Pulse Aceptar.
Definición de un control de solicitud (SAP BW)
Puede utilizar solicitudes en:
v Mapas de parámetros
v Parámetros de sesión
v Expresiones, incluidos los filtros y cálculos
Nota: Si el título es de un tipo de datos diferente que la clave de empresa (MUN)
para el nivel, utilice Referencia de elemento de filtro junto con el valor de Tipo
de solicitud para el título. Esto asegura que se utilizará el tipo de datos correcto al
aplicar filtros en los estudios.
Es útil para los elementos de consulta, como ProductTypeCode, cuyos valores no
se muestran en un informe pero son útiles para filtrar datos. En general, es mejor
definir las solicitudes de introducir en los informes que utilizan las características
de solicitud adicionales. Sin embargo, los usuarios no pueden modificar algunas
variables. Para estas variables, puede utilizar IBM Cognos Framework Manager en
lugar de los informes para definir solicitudes de introducir.
Las propiedades de información de solicitud establecidas en Framework Manager
proporcionan la posibilidad de controlar el filtrado y las solicitudes
predeterminados. Las propiedades se utilizan por:
v Query Studio para crear una expresión de filtro y establecer los elementos de
uso y visualización en una solicitud o consulta de solicitud
v La herramienta Crear página de solicitud de Report Studio para crear una
expresión de filtro y establecer los elementos de uso y visualización en una
solicitud y consulta de solicitud
v Solicitudes generadas de Report Studio para establecer los elementos de uso y
visualización en la solicitud y consulta de solicitud
La sintaxis para utilizar una solicitud como valor es
??
224 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Pasos para definir un control de solicitud
Procedimiento
1. Pulse el elemento de consulta.
2. En el panel Propiedades, pulse la pestaña Propiedad.
3. Pulse el signo más (+) situado junto a la propiedad Información de solicitud.
Es una propiedad de elemento de consulta compuesto.
4. Modifique las propiedades siguiente para reflejar el comportamiento que desee.
Objetivo Propiedad
Definir el tipo de control de solicitud que se
va a generar cuando se ejecute el informe.
Definir la solicitud generada como parte de
una serie de solicitudes en cascada
generadas.
Especifica qué elemento de consulta se
muestra al usuario del informe en la
solicitud.
Los valores de la solicitud son valores de
datos de elemento de consulta.
Cada valor de la solicitud se asocia con un
valor en el elemento de consulta
especificado en la propiedad Usar referencia
de elemento.
Especifica qué elemento de consulta se pasa
de la solicitud al filtro.
Cada valor se asocia con un valor del
elemento de consulta especificado en la
propiedad Referencia de elemento de
visualización.
Especifica qué elemento de consulta se
utiliza en la expresión de filtro para
recuperar datos.
Tipo de solicitud
Referencia de elemento de cascada
Referencia de elemento de visualización
Utilizar referencia de elemento
Referencia de elemento de filtro
Propiedad Tipo de solicitud
La propiedad Tipo de solicitud define el tipo de control de solicitud que se genera
al ejecutar el informe, como un cuadro de edición o una lista desplegable.
El valor predeterminado de esta propiedad es Determinado por el servidor.
Nota: Ahora se procesan los tipos de solicitud establecidos en los atributos. El
usuario del informe verá la solicitud que coincide con el tipo de solicitud del
atributo. Dado que en la versión anterior no se procesaban los tipos de solicitud en
los atributos, puede haber alguna diferencia.
Capítulo 6. metadatos de SAP BW 225

Valor Control de solicitud
Determinado por el servidor El tipo de control de solicitud se basa en
información del servidor, como el tipo de
datos del elemento de consulta.
Cuadro de edición Un sencillo cuadro de texto. Si el tipo de
datos de la columna es fecha o fecha y hora,
este valor genera un control de fecha o de
fecha y hora, además del cuadro de texto.
Seleccionar fecha Control de fecha con una interfaz de
calendario.
Seleccionar fecha y hora Control de fecha y hora con una interfaz de
calendario.
En el caso de metadatos de SAP BW, este
valor no es relevante.
Seleccionar intervalo Control de intervalo de fecha y hora.
En el caso de metadatos de SAP BW, este
valor no es relevante.
Seleccionar hora Control de hora que filtra datos basándose
en el periodo de tiempo seleccionado. Por
ejemplo, si define una solicitud Seleccionar
hora para Order Time, el usuario puede
utilizar el control de hora para mostrar
todos los pedidos realizados después de la
1:00 o todos los pedidos realizados entre las
10:00 y las 11:00.
Si hace referencia a un miembro de tiempo,
deberá utilizar sólo los valores exactos.
Si utiliza un rango, los puntos finales del
rango deben corresponderse con valores del
origen de datos.
Seleccionar valor Lista desplegable.
Seleccionar mediante búsqueda Control de lista para que los usuarios
puedan buscar valores.
En el caso de metadatos de SAP BW, este
valor no es relevante.
Seleccionar mediante árbol Control de solicitud de árbol para solicitudes
basadas en un nodo de la jerarquía.
Propiedad de referencia de elemento de cascada
La propiedad Referencia de elemento de cascada indica que la solicitud generada
forma parte de una serie de solicitudes en cascada generadas. El elemento de
consulta al que se hace referencia en esta propiedad es el elemento padre de la
cascada. El sistema solicita al usuario el elemento en cascada antes de solicitar el
elemento de consulta actual.
Por ejemplo, si desea solicitar Línea de producto y luego Producto dentro de la
línea seleccionada, defina la propiedad Referencia de elemento de cascada del
elemento de consulta Producto en Línea de producto.
226 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Propiedades Referencia de elemento de visualización y Utilizar
referencia de elemento
La propiedad Referencia de elemento de visualización especifica qué elemento de
consulta se muestra al usuario en la solicitud. La propiedad Utilizar referencia de
elemento especifica qué elemento de consulta se pasa de la solicitud al filtro. Cada
valor de la lista de elementos de visualización se asocia con un valor del elemento
de consulta especificado en la propiedad Utilizar referencia de elemento.
Por ejemplo, si desea que la solicitud muestre Nombre de país aunque se utilice el
Código de país para recuperar los datos. Establezca la propiedad Referencia de
elemento de visualización en Nombre de país y la propiedad Utilizar referencia
de elemento en Código de país. La solicitud de Nombre de país facilita que el
usuario del informe seleccione los valores necesarios. Sin embargo, la utilización
del Código de país en el filtro es más eficiente para la recuperación de datos.
Estas propiedades se utilizan por
v Query Studio para crear una expresión de filtro y establecer los elementos de
uso y visualización en una solicitud o consulta de solicitud
v La herramienta Crear página de solicitud de Report Studio para establecer los
elementos de utilización y visualización en una solicitud y consulta de solicitud
v Solicitudes generadas de Report Studio para establecer los elementos de uso y
visualización en la solicitud y consulta de solicitud
Nota: Los valores de las propiedades Utilizar referencia de elemento y Referencia
de elemento de filtro deben ser compatibles. De lo contrario, el usuario del
informe puede recibir resultados inesperados. Para obtener más información,
consulte: “Propiedad de referencia de elementos de filtro” en la página 147.
Valor predeterminado: Si no se establece ningún valor, las propiedades serán de
forma predeterminada el nombre del elemento de consulta.
Estas propiedades solo se utilizan para los controles de solicitud de dirigidos por
datos cuya propiedad Tipo de solicitud se establece en Seleccionar valor o
Seleccionar mediante búsqueda.
Propiedad de referencia de elementos de filtro
La propiedad Referencia de elemento de filtro identifica el elemento de consulta
utilizado cuando Report Studio o Query Studio generan un filtro. Esta propiedad
ayuda a crear consultas más eficientes, ya que asegura que un filtro utiliza una
columna numérica indexada en lugar de una columna de cadenas no indexadas.
Por ejemplo, el autor de un informe desea crear un filtro para el elemento de
consulta Nombre de país. Por lo tanto, establece la propiedad Referencia de
elemento de filtro para que utilice el Código de país en lugar del Nombre de país
en todos los filtros que utilizan el elemento de consulta Nombre de país.
En otro ejemplo, el autor de un informe desea crear un filtro para el elemento de
consulta Código de país que se visualiza en la tabla Pedidos. Usted desea que el
filtro utilice el Código de país en la tabla País porque hay menos filas para leer en
la tabla País, por lo que establece la Referencia de elemento de filtro del modelo
en Country.Country Code.
Esta propiedad se utiliza por:
v Query Studio para crear una expresión de filtro
Capítulo 6. metadatos de SAP BW 227

v La herramienta Crear página de solicitud de Report Studio para crear una
expresión de filtro
Valor predeterminado: si no se establece ningún valor, la propiedad toma de forma
predeterminada el nombre del elemento de consulta.
Utilización de las propiedades Referencia de elemento de filtro y
Utilizar referencia de elemento
Los valores de las propiedades Referencia de elemento de filtro y Utilizar
referencia de elemento deben ser compatibles. El valor de la propiedad Utilizar
referencia de elemento debe ser del tipo esperado en la propiedad Referencia de
elemento de filtro. De lo contrario, el usuario del informe puede recibir resultados
inesperados. Esto puede ocurrir cuando un usuario de informe crea un filtro sin
crear una página de solicitud.
En un modelo de ejemplo, la propiedad Utilizar referencia de elemento se
establece en Número de empleado y la propiedad Referencia de elemento de
filtro es Nombre de empleado. En Report Studio, el autor de un informe crea el
siguiente filtro sin crear una página de solicitud:
Reference.EmployeeName in ?parm1?
Report Studio generará automáticamente solicitudes cuando cree un filtro sin crear
una página de solicitud. Debido a que se genera la solicitud, Report Studio utiliza
las propiedades Información de solicitud del elemento de consulta Nombre de
empleado en el modelo de Framework Manager.
Utilizar referencia de elemento indica que los valores que se pasan al filtro son
números de empleados. Referencia de elemento de filtro filtra los datos según el
Nombre de empleado. El filtro es el siguiente: Reference].[Employee Name] in
("1", "2"). Puesto que no hay ningún valor para Nombre de empleado que sea
"1" o "2", el informe estará en blanco.
Utilización de Referencia de elemento de filtro para metadatos
relacionales modelados dimensionalmente
Para metadatos relacionales modelados dimensionalmente, Información de
solicitud se especifica en el atributo con el rol de _memberCaption, en lugar del
nivel. Aunque se establezcan en el atributo, las propiedades Información de
solicitud se procesan como si estuvieran en el nivel. De forma predeterminada,
cuando el nivel se incluye en un informe, se solicita a los usuarios que
especifiquen los MUN en la solicitud del nivel. Para especificar los valores de
título en su lugar, establezca la propiedad Referencia de elemento de filtro del
atributo en sí misma. Cuando se aplique el filtro solicitado, los valores filtrados se
basarán en los valores de atributo.
Por ejemplo, el nivel Línea de producto tiene un atributo Línea de producto con el
rol _memberCaption. Si el valor de la propiedad Referencia de elemento de filtro
se establece en Línea de producto, se solicita a los usuarios del informe que
especifiquen valores para Línea de producto. Si el valor de la propiedad
Referencia de elemento de filtro se deja en blanco, se solicita a los usuarios que
especifiquen los MUN.
Nota: No utilice la propiedad Referencia de elemento de filtro con el tipo de
solicitud Seleccionar mediante árbol. Debido a que una solicitud Seleccionar
mediante árbol solo se puede filtrar en un nivel o jerarquía, si se establece la
228 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

propiedad Referencia de elemento de filtro producirá un error.
Prueba de solicitudes
Cuando se prueba un objeto de modelo que hace referencia a una solicitud IBM
Cognos Framework Manager le pide que especifique el valor adecuado.
Framework Manager utiliza este valor mientras dure la sesión o hasta que se borre
el valor de la solicitud.
Puede cambiar el valor de la sesión para los valores de solicitud en el cuadro de
diálogo Opciones. Este cuadro de diálogo aparece cuando se modifica una
dimensión o un asunto de consulta o bien cuando se define un cálculo, un filtro,
un conjunto de consultas o una relación compleja. Puede cambiar el valor de
solicitud en el momento en que prueba la expresión que hace referencia a dicho
valor.
Si selecciona la casilla de verificación Solicitar siempre valores durante la prueba
en el cuadro de diálogo Solicitud, Framework Manager le solicita un objeto cada
vez que pruebe el objeto. Al actualizar el objeto o realizar un recuento, Framework
Manager utiliza el valor de solicitud existente, si lo hay.
Una solicitud en un elemento de consulta en un asunto de consulta de modelo se
asocia solo con un elemento de consulta. Una solicitud en un elemento de consulta
en un asunto de consulta de orígenes de datos se asocia con todo el asunto de
consulta y, por lo tanto, la solicitud se muestra cuando se prueba cualquier
elemento de consulta en el asunto de consulta.
Variables de SAP BW
Las variables de SAP BW son parámetros de una consulta SAP BW que se
configuran durante la definición de la consulta. Cuando se ejecuta la consulta, las
variables de SAP BW se rellenan con los valores. Funcionan como marcadores y se
pueden procesar de modos diferentes. En tiempo de ejecución, quedan expuestos
automáticamente como solicitudes.
Se incluye la información de variables de SAP BW en una propiedad personalizada
compuesta denominada Variables de SAP BW que solamente existe si un origen
de datos tiene una o varias variables asociadas. La propiedad Variables de SAP
BW contiene una o varias propiedades compuestas y a cada una de ellas se les
debe asignar un nombre exclusivo. Cada propiedad representa una descripción de
una sola variable de SAP BW. Dado que la información de las variables se
especifica en una propiedad personalizada, Framework Manager no valida estas
propiedades.
La información de las variables de SAP BW se obtiene utilizando la BAPI de SAP
BW MDDataProviderBW::GetVariables.
Framework Manager da soporte a estos tipos de variables de SAP BW:
v Característica
Existen dos tipos de variables de características: el valor de la característica y el
nodo de la jerarquía. Las variables de valores de características seleccionan
valores de características. Las variables de nodo de jerarquía seleccionan los
valores de cualquier posición de una jerarquía de presentación.
v Jerarquía.
Al usuario no se le solicita un valor debido a que el software de IBM Cognos lo
rellena automáticamente en tiempo de ejecución, basándose en la jerarquía
seleccionada. Las variables para la función de jerarquías actúan como
Capítulo 6. metadatos de SAP BW 229

marcadores para la jerarquía de una característica. Todos los valores de las
variables de jerarquías son de sólo lectura.
v Fórmula
El usuario escribe un valor numérico en tiempo de ejecución. Utilice las
variables de fórmula si se debe especificar un componente de fórmula solamente
cuando se ejecuta una consulta. Por ejemplo, se puede utilizar una variable de
fórmula para que se procese la tasa impositiva actual del impuesto sobre el valor
añadido en tiempo de ejecución.
v Autorización
Las variables de autorización son como las otras variables, pero el software de
IBM Cognos automáticamente rellena los valores de las variables con las
credenciales de usuario. SAP BW utiliza estas credenciales para suministrar la
información que necesita una consulta SAP BW a la que se le ha aplicado la
seguridad.
Las variables para jerarquías funcionan como marcadores para la jerarquía de una
característica. Todos los valores de las variables de jerarquías son de sólo lectura.
Propiedad Nombre
Esta propiedad es un valor de cadena.
Equivalente de SAP BW: VARIABLE_NAME
Restricciones: Sólo lectura.
Propiedad Título
El valor de esta propiedad es un valor de cadena compuesto y que depende del
entorno local. Represente cada entorno local del modelo mediante una propiedad
personalizada cuyo valor sea el nombre del entorno local. Por ejemplo, si en el
modelo existen los entornos locales en-ca y fr-fr, defina dos propiedades
personalizadas con el nombre en-ca y fr-fr.
El valor predeterminado se obtiene de SAP BW.
Propiedad Tipo de selección
Los valores posibles son value, interval, complex y multiValued.
Tabla 2. Equivalentes de propiedad Tipo de selección
Valor Equivalente de SAP BW
value
interval
complex
multiValued
Restricciones: Sólo lectura.
230 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario
SAP_VAR_SEL_TYPE_VALUE
SAP_VAR_SEL_TYPE_INTERVAL
SAP_VAR_SEL_TYPE_COMPLEX
SAP_VAR_SEL_TYPE_COMPLEX

Propiedad Tipo de entrada
El valor predeterminado se obtiene de SAP BW.
Tabla 3. Equivalentes de propiedad Tipo de entrada
Valor Equivalente de SAP BW
opcional
obligatorio
mandatoryNotInitial
Restricciones: Sólo lectura.
SAP_VAR_INPUT_TYPE_OPTIONAL
SAP_VAR_INPUT_TYPE_MANDATORY
SAP_VAR_INPUT_TYPE_MANDATORY_NOT_INITIAL
Propiedades Valor bajo predeterminado y Valor elevado
predeterminado
Cada una de estas propiedades especifica un rango de valores.
El valor predeterminado se obtiene de SAP BW.
Restricciones: La propiedad Valor elevado predeterminado se puede aplicar
únicamente a las variables cuyo Tipo de selección sea interval.
Propiedad Descripción
Esta propiedad es un valor de cadena.
Propiedad Tipo de variable de SAP BW
Los valores posibles son numeric, characteristic, hierarchy o hierarchicalNode.
El valor predeterminado se obtiene de SAP BW.
Restricciones: Sólo lectura.
Propiedad Tipo de solicitud
El valor predeterminado depende del tipo de variable. Si el valor de esta
propiedad no es uno de los valores predefinidos, se utiliza el valor
hierarchyPickList. Los valores predefinidos para la propiedad de tipo de solicitud
son los siguientes.
Tabla 4. Equivalentes de propiedad Tipo de solicitud
Valor Restricciones
typeIn Obligatorio para las variables numéricas y opcional para los
valores de características.
pickList Opcional para variables de características.
calendar Sólo para variables de características basadas en 0CALDAY.
Capítulo 6. metadatos de SAP BW 231

Tabla 4. Equivalentes de propiedad Tipo de solicitud (continuación)
Valor Restricciones
hierarchyPickList Opcional para todas las jerarquías de presentación.
notApplicable Necesario para variables de jerarquías.
Utilice esta propiedad para especificar el tipo de solicitud.
Puede mejorar el rendimiento de las solicitudes de variables que utilizan una lista
de selección o una lista de selección jerárquica. Utilice las propiedades Restricción
de nivel, Número inicial de valores de lista de selección y Utilizar valor
predeterminado para controlar el rendimiento de esos tipos de solicitudes de
variables.
Si se cambia una solicitud de lista de selección o de lista de selección jerárquica a
una solicitud de introducir se puede mejorar de forma drástica el rendimiento ya
que no es necesario que el servidor de aplicaciones rellene una lista de selección
con valores. No obstante, requiere que los usuarios puedan entrar con exactitud los
valores de las características.
Restricciones: De sólo lectura para algunos tipos de variables, como de
características y de fórmula.
Propiedad Restricción de nivel
Esta propiedad es un valor numérico.
El valor predeterminado es 1.
Utilice esta propiedad para disminuir el número de valores de características que
rellenan una lista de selección jerárquica. Existe un número limitado de niveles de
una jerarquía de los que se pueden obtener valores.
Si el valor es cero (0), que es el valor predeterminado, entonces los valores de
características de todos los niveles de una jerarquía (si es aplicable al tipo de
solicitud) rellenan la lista de selección. De lo contrario, la propiedad especifica un
rango de niveles separado por un signo de dos puntos de donde se obtienen los
valores (el nivel raíz es cero).
Para una jerarquía irregular, debe especificar todos los niveles que es posible que
desee utilizar incluso si algunas sucursales no tienen dicho nivel.
Restricciones: Sólo es aplicable a las variables de nodo jerárquicas cuyo Tipo de
solicitud sea hierarchyPickList.
Propiedad Utilizar valor predeterminado
Esta propiedad es una propiedad booleana que determina si se utilizan los valores
predeterminados. Si esta propiedad se define como true, no se solicita a los
usuarios la variable asociada sino que siempre se utiliza el valor predeterminado.
Utilice esta propiedad para establecer la variable en un único valor. A los usuarios
no se les solicita el valor de una variable y, por lo tanto, el servidor de IBM
232 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Cognos BI no rellena una lista de selección con valores. No obstante, los usuarios
ya no pueden cambiar el valor de una variable.
El valor predeterminado es false.
Propiedad Mostrar clave y título
Para mostrar las claves y los títulos de las variables de SAP BW, defina esta
propiedad en true. Esta propiedad sólo se puede aplicar a las solicitudes de lista
de selección y a las solicitudes de nodo jerárquico.
El valor predeterminado es false.
Propiedad Número inicial de valores de lista de selección
Esta propiedad especifica el número inicial de valores que se utilizan para rellenar
una lista de selección, una lista de selección jerárquica o una solicitud.
El valor predeterminado es cero (0), lo que significa todos.
Valores de propiedad de variable numérica (SAP BW)
Las siguientes propiedades de variable son aplicables a variables numéricas:
Propiedad Valor predeterminado
Tipo
Título
numeric
Tipo de selección value
Tipo de entrada
Valor bajo predeterminado
Valor alto predeterminado
Obtenido de SAP BW
Tipo de solicitud typeIn
Utilizar valor predeterminado false
Puede cambiar los valores predeterminados para una variable numérica, excepto
para la propiedad Tipo de solicitud, que es de sólo lectura.
Valores de las propiedades de variables de característica
(SAP BW)
Existen dos tipos de variables de características: el valor de la característica y el
nodo de la jerarquía. Las variables de valores de características seleccionan los
valores de las características. Las variables de nodo de jerarquía seleccionan los
valores de cualquier posición de una jerarquía de presentación.
Valores de las propiedades de variables de valor de
característica
Las siguientes propiedades de variables se aplican a todas las variables de valor de
característica:
Propiedad Valor predeterminado
Tipo
Título
característica
Capítulo 6. metadatos de SAP BW 233

Propiedad Valor predeterminado
Tipo de selección Obtenido de SAP BW
Tipo de entrada Obtenido de SAP BW
Valor bajo predeterminado Si el tipo de entrada es de valor o complejo,
se muestra la propiedad predeterminada.
Si el tipo de entrada es intervalo, se muestra
la propiedad baja predeterminada. Este valor
se obtiene de SAP BW.
Valor alto predeterminado Si el tipo de entrada es de valor o complejo,
se muestra la propiedad predeterminada.
Si el tipo de entrada es intervalo, se muestra
la propiedad alta predeterminada. Este valor
se obtiene de SAP BW.
Tipo de solicitud typeIn o pickList
Depende del número de miembros de la
dimensión de referencia.
Si el valor no es válido, se utiliza typeIn.
Utilizar valor predeterminado false
Mostrar clave y título false
Número inicial de valores de lista de Cero (0)
selección
Una variable de valor de característica para la dimensión 0CALDAY se muestra en
el modelo como una fecha. La propiedad Tipo de datos se establece en xsdDate y
la propiedad Tipo de solicitud se establece en calendario. La propiedad Tipo de
solicitud es de solo lectura para la dimensión 0CALDAY.
Valores de las propiedades de variables de nodo de jerarquía
Las siguientes propiedades de variables se aplican a las variables de nodo de
jerarquía:
Propiedad Valor predeterminado
Tipo
Título
característica
Tipo de selección Obtenido de SAP BW
Tipo de entrada
LowValue predeterminado
HighValue predeterminado
Obtenido de SAP BW
Tipo de solicitud PickList de jerarquía
Puede cambiar la propiedad Tipo de
solicitud por typeIn o pickList.
Restricción de nivel Cero (0)
Utilizar valor predeterminado false
234 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Solicitudes de lista de selección (SAP BW)
Cada solicitud de lista de selección contiene un número de valores predefinido.
Estos valores los determina la propiedad de número máximo de valores
(Maximum Number of Values).
Si el número de valores reales es igual o inferior al número predeterminado de
valores, la solicitud se genera como una única solicitud de lista de selección. Si el
número de valores reales es superior al número predeterminado, se generan dos
solicitudes en este orden:
v Un parámetro de rango de límites con un valor inicial de 1 y un valor final
determinado por la propiedad de número máximo de valores (Maximum
Number of Values).
Este parámetro es del tipo xsdUnsignedLong y es opcional. El nombre del
parámetro es el nombre de la solicitud original seguido de _solicitud_de_rango.
El título es específico del entorno local. Si se trata de un modelo multilingüe,
deberá almacenar la plantilla para el título en un archivo de mensaje.
v Una solicitud de lista de selección que contiene el número predeterminado de
valores.
Adición de reglas de negocio (SAP BW)
Las reglas de negocio creadas en SAP BW se importan a IBM Cognos Framework
Manager. Puede añadir más reglas de negocio al modelo para refinar los datos
recuperados y para que sus usuario puedan disponer de la información adecuada.
La creación de reglas de negocio y su almacenamiento en el modelo en lugar de
hacerlo en informes tiene muchas ventajas. Se ahorra tiempo porque tanto usted
como sus usuarios no tendrán que volver a crear reglas de negocio cada vez que
las necesiten. Las reglas de negocio aseguran la coherencia porque todos los
usuarios utilizan las mismas definiciones. Por ejemplo, Margen pequeño significa
lo mismo en toda la organización. Son fáciles de actualizar porque las reglas de
negocio se mantienen centralmente, por lo que todos los informes se actualizan
automáticamente cuando las reglas evolucionan. Por ejemplo, si la definición de
Margen pequeño cambia, todos los informes que utilizan el cálculo de Margen
pequeño se actualizan automáticamente. Las reglas de negocio mejoran la
seguridad.
Procedimiento
1. Añada cálculos para que los usuarios puedan incluir datos calculados en sus
informes “Creación de un cálculo (SAP BW)” en la página 236.
2. Cree y aplique filtros para limitar los datos que un asunto de consulta puede
recuperar “Creación de un filtro (SAP BW)” en la página 237.
3. Añada solicitudes que se visualizarán automáticamente cuando se utilice una
dimensión o asunto de consulta en un informe; se solicitará a los usuarios de
informes que filtren los datos “Definición de un control de solicitud (SAP BW)”
en la página 224.
4. Utilice parámetros de sesión “Creación de un parámetro de sesión (SAP BW)”
en la página 243 y mapas de parámetros “Creación de un mapa de parámetros
(SAP BW)” en la página 241 para resolver expresiones dinámicamente.
5. Cree un filtro de seguridad para controlar los datos que se muestran a los
usuarios cuando configuran sus informes “Adición de seguridad de datos” en
la página 255.
Capítulo 6. metadatos de SAP BW 235

Creación de un cálculo (SAP BW)
Los signos de puntuación, como el signo de interrogación (?), deben estar en el
código de caracteres ASCII de 7 bits. Si escribe un carácter de puntuación desde un
teclado habilitado para varios bytes, asegúrese de que escribe la representación
ASCII de 7 bits del carácter. Por ejemplo, escriba Alt+063 para el signo de
interrogación.
Evite emplear caracteres que se utilizan como operadores de expresiones en el
nombre del cálculo. Se podrían producir errores de sintaxis cuando se evalúa la
expresión. Por ejemplo, un cálculo denominado Margen * 10 genera errores cuando
se utiliza en una expresión como [Margen * 10]< 20.
En las expresiones, es posible que un operador o función necesiten que los
operandos sean de un tipo dimensional en particular. Cuando un operando no es
del tipo necesario, se pueden aplicar una o varias reglas de conversión forzada
para convertir el operando al tipo apropiado. Puesto que las reglas de conversión
forzada no se aplican a las expresiones de los asuntos de consulta de modelo,
asegúrese de que estas expresiones sean válidas sin depender de las reglas de
conversión forzada. Para obtener más información sobre las reglas de conversión
forzada, consulte: IBM Cognos Report Studio Guía del usuario.
Si inserta en el cálculo una función definida por el usuario importada, asegúrese
de que el nombre de función no repita ningún nombre específico del proveedor.
Por ejemplo, si el nombre de función definido por el usuario es CHAR recibirá un
error al probar la función en el cuadro de diálogo Definición de cálculo porque
este nombre se considera idéntico a char en Microsoft SQL Server. Para obtener
información sobre los nombres de función utilizados en la base de datos, consulte
la documentación del producto de base de datos.
En el momento de la consulta, IBM Cognos Framework Manager devuelve un
valor nulo para cualquier cálculo que contenga un divisor cuyo valor sea cero.
Framework Manager no puede detectar errores de división por cero en funciones
como average y mod, porque el operador de división no es explícito.
Puede aplicar un cálculo independiente a una o varias dimensiones o asuntos de
consulta para proporcionar datos calculados a un informe, o incluirlo en un
paquete para que esté disponible para los usuarios. Si se mueve un cálculo
independiente o su atajo a una carpeta, se pueden organizar mejor los objetos de
modelo.
Pasos para crear un cálculo
Procedimiento
1. Pulse la carpeta o espacio de nombres y, desde el menú Acciones, pulse Crear,
Cálculo.
2. Escriba un nombre para el cálculo en el cuadro Nombre.
3. Defina la expresión.
Objetivo Acción
Añadir elementos En la pestaña Modelo, pulse un elemento de
consulta, filtro o cálculo y pulse la flecha.
236 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Objetivo Acción
Añadir funciones En la pestaña Funciones, elija un
componente y pulse la flecha.
Añadir parámetros En la pestaña Parámetros, pulse un
parámetro y pulse la flecha.
Recuperar un parámetro y mostrar un
número determinado de filas
Pulse el botón de opciones, seleccione la
casilla de verificación Limitar el número
máximo de filas que se devolverán y
escriba el número de filas que desee que se
devuelvan.
Este valor no mejora el rendimiento de la
recuperación de datos cuando se prueban
dimensiones y asuntos de consulta.
Reemplazar los parámetros de la sesión Pulse el botón de opciones, pulse Definir,
especifique un valor en el campo
Reemplazar valor y pulse Aceptar.
Reemplazar valores de solicitud Pulse el botón de opciones y después pulse
Solicitudes.
Aparece el cuadro de diálogo Gestor de
solicitudes de modelos, que muestra todas
las peticiones, y sus valores, que están en el
modelo.
4. Para probar el cálculo, pulse el botón de prueba .
Puede probar solo los cálculos que contienen elementos de consulta. Si un
cálculo contiene una función (por ejemplo, _add_days), el botón Probar
muestra no está disponible.
5. Pulse Aceptar.
6. Modifique la propiedad Tipo de datos para identificar el tipo de datos que
devuelve el cálculo.
Los estudios de IBM Cognos utilizan esta información para dar formato a los
datos que devuelve el cálculo.
Resultados
Para obtener información sobre funciones, consulte Apéndice C, “Uso del editor de
expresiones”, en la página 395.
Creación de un filtro (SAP BW)
Por ejemplo, puede utilizar la función in_range para crear un filtro que recupere
datos de productos incorporados en un intervalo de tiempo específico. La sintaxis
para este ejemplo tiene el aspecto siguiente:
Capítulo 6. metadatos de SAP BW 237

[gosales_goretailers].[Products].[Introduction
date]
in_range {Feb 14, 1999 : July 14, 2007}
Nota: Cuando se utiliza una función de fecha u hora, se debe utilizar un reloj de
24 horas. IBM Cognos Framework Manager no soporta "a.m." o "p.m." en
expresiones. Por ejemplo, utilice 20:00 para expresar 8 p.m.
Puede restringir los datos representados por dimensiones o asuntos de consulta de
un proyecto mediante la creación de un filtro de seguridad. El filtro de seguridad
controla los datos que los usuarios pueden ver cuando configuran sus informes.
Puede aplicar reguladores para limitar los datos que recuperan las consultas de un
paquete.
Framework Manager soporta filtros autónomos y filtros incluidos.
v Utilice un filtro autónomo cuando desee reutilizar la expresión.
Puede añadir un filtro autónomo a una o varias dimensiones o a asuntos de
consulta para limitar los datos que la consulta recupera cuando, en un informe,
se utiliza la dimensión o el asunto de consulta filtrados, o cuando se incluye en
un paquete para que esté disponible para los usuarios. Si se mueve un filtro
autónomo o su atajo a una carpeta, se pueden organizar mejor los objetos de
modelo.
v Emplee un filtro incluido cuando desee utilizar un filtro con una sola dimensión
o asunto de consulta.
Puede crear un filtro incluido al modificar una dimensión, un asunto de consulta
de orígenes de datos relacionales o un asunto de consulta de modelo.
Si empieza por un filtro incluido, luego podrá convertirlo en una expresión
autónoma que podrá aplicar a otras dimensiones o asuntos de consulta.
Sugerencia: Pulse con el botón derecho del ratón en la expresión de filtro en la
pestaña Filtros y pulse Convertir a filtro independiente.
Cuando se incluye un filtro, el asunto de consulta de orígenes de datos debe
tener una relación con cualquier asunto de consulta al que la expresión hace
referencia. Esta relación es necesaria aunque la expresión haga referencia a un
asunto de consulta de modelo basado en la misma tabla que el asunto de
consulta de orígenes de datos en la que incluye la expresión.
Para crear un filtro en un asunto de consulta no relacionado, efectúe una de las
acciones siguientes:
– Asegúrese de que haya una ruta de unión entre el nuevo asunto de consulta y
el que contiene el filtro.
– Base el filtro incluido en un elemento de consulta que esté basado en el
asunto de consulta de orígenes de datos que desee.
– Convierta el cálculo en un filtro autónomo, para que no forme parte del
asunto de consulta.
– Cree un filtro autónomo que haga referencia al objeto incluido.
También puede estar interesado en los temas siguientes:
v Filtros de seguridad “Adición de seguridad de datos” en la página 255
v Funciones Apéndice C, “Uso del editor de expresiones”, en la página 395
v Parámetros “Creación de un mapa de parámetros (SAP BW)” en la página 241
v Parámetros de sesión “Creación de un parámetro de sesión (SAP BW)” en la
página 243
238 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Puede aplicar reguladores para limitar los datos que recuperan las consultas de un
paquete.
Pasos para crear filtros
Procedimiento
1. Realice una de las siguientes acciones:
v Para crear un filtro autónomo, pulse el espacio de nombres o la carpeta y
pulse Acciones, Crear, Filtro.
v Si desea crear un filtro incluido, efectúe una doble pulsación en la dimensión
o asunto de consulta que contendrá el filtro, pulse la pestaña Filtros y,
después, pulse Añadir.
2. En el cuadro Nombre, escriba un nombre para el filtro.
3. Defina la expresión.
Sugerencia: Si en el filtro hay una expresión no válida, consulte el cuadro de
Sugerencias en el editor de expresiones para obtener más información.
Objetivo Acción
Añadir elementos de consulta y filtros En la pestaña Modelo, arrastre los objetos
que desee al cuadro Definición de
expresión.
Añadir funciones En la pestaña Funciones, arrastre las
funciones al cuadro Definición de
expresión.
Añadir parámetros En la pestaña Parámetros, arrastre los
parámetros al cuadro Definición de
expresión.
Recuperar un parámetro y mostrar un
número determinado de filas
Pulse el botón de opciones, seleccione la
casilla de verificación Limitar el número
máximo de filas que se devolverán y
escriba el número de filas que desee que se
devuelvan.
Este valor no mejora el rendimiento de la
recuperación de datos cuando se prueban
dimensiones, asuntos de consulta y
conjuntos de consulta.
Reemplazar los parámetros de la sesión Pulse el botón de opciones, pulse Definir,
especifique un valor en el campo
Reemplazar valor y pulse Aceptar.
Reemplazar valores de solicitud Pulse el botón de opciones y después pulse
Solicitudes.
Aparece el cuadro de diálogo Gestor de
solicitudes de modelos, que muestra todas
las peticiones, y sus valores, que están en el
modelo.
Capítulo 6. metadatos de SAP BW 239

4. Pulse Aceptar.
Resultados
Puede aplicar reguladores para limitar los datos que recuperan las consultas de un
paquete. Para obtener más información, consulte: “Reguladores” en la página 304.
También puede estar interesado en los temas siguientes:
v “Adición de seguridad de datos” en la página 255
v Apéndice C, “Uso del editor de expresiones”, en la página 395
v “Creación de mapas de parámetros” en la página 157
v “Creación de parámetros de sesión” en la página 160
v “Prueba de asuntos de consulta o conjuntos de consultas” en la página 92
v “Solicitudes obligatorias y opcionales” en la página 165
Aplicación de un filtro (SAP BW)
Puede incluir un filtro independiente en dimensiones o asuntos de consulta, pero si
desea aplicar un uso diferente para cada filtro incluido, debe crear versiones
distintas del filtro independiente. De lo contrario, se podría solicitar a los usuarios
que rellenasen una solicitud que se había pensado como opcional, si hay alguna
instancia en la que el uso se ha establecido como obligatorio. Para obtener
información sobre solicitudes obligatorias y opcionales, consulte: “Solicitudes
obligatorias y opcionales” en la página 165.
Por ejemplo, en el asunto de consulta A, incluye un filtro independiente y lo define
como opcional. En el asunto de consulta B, lo define como obligatorio. Cuando los
usuarios crean un informe que utiliza ambos asuntos de consulta, se les solicita
que elijan valores en ambos filtros, incluso en el definido como opcional. Todas las
instancias del filtro se consideran obligatorias cuando se utilizan en la misma
consulta. La solución es crear diferentes versiones del filtro, cada una con su
propio nombre.
Pasos para crear un filtro
Procedimiento
1. Cree un filtro.
2. Seleccione el filtro y pulse Acciones, Editar definición.
3. Pulse la pestaña Filtros y arrastre el filtro que ha creado al cuadro Filtros.
4. Seleccione un valor de uso para el filtro.
Valor de uso Descripción
Siempre Utilice este uso para que los datos
especificados se filtren de todos los
informes. Por ejemplo, la información
obsoleta de la compañía que se sigue
almacenando, pero sobre la que no hace
falta informar.
240 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario
Siempre es el valor de uso predeterminado.

Valor de uso Descripción
Solo modo de diseño Recupera un pequeño subconjunto de datos
para el informe de ejemplo. Utilice este valor
de uso cuando no necesite ver todos los
datos; por ejemplo, cuando pruebe un
asunto de consulta.
Para aplicar los filtros del modo de diseño
en Framework Manager, seleccione la opción
Aplicar todos los filtros de modo de diseño
durante las pruebas. Esta opción está
disponible en la pestaña Probar valores.
Los usuarios pueden necesitar el filtro de
modo de diseño en Query Studio cuando
desean centrarse en el diseño y el formato
de un informe y no recuperar todos los
datos mientras trabajan. Para acceder al
filtro del modo de diseño en Query Studio,
ejecute el informe con un número limitado
de datos.
Opcional Especifica que el filtro es opcional. Se solicita
al usuario que filtre los datos y puede dejar
la solicitud en blanco. Si la solicitud se deja
en blanco, Framework Manager pasa por
alto el filtro y recupera todos los datos para
la dimensión y el asunto de consulta.
La sintaxis ??es necesaria para las
solicitudes opcionales.
Utilice este valor de uso si los usuarios
desean controlar cuándo se aplica el filtro.
Por ejemplo, desean ver datos de un país
algunas veces y los datos de todos los países
otras veces. Un filtro opcional para un país
tiene el aspecto siguiente:
([GeoNamespace].[Countries]
.[CountryName]
=
?WhichCountry?)
5. Si desea ver el SQL, pulse la pestaña Información sobre consultas.
6. Pulse Aceptar.
Creación de un mapa de parámetros (SAP BW)
Los mapas de parámetros son similares a tablas de búsqueda de origen de datos.
Cada mapa de parámetros tiene dos columnas, una para la clave y otra para el
valor que la clave representa. Puede especificar manualmente las claves y los
valores, importarlos de un archivo o basarlos en elementos de consulta del modelo.
También puede exportar mapas de parámetros a un archivo. Para modificar el
mapa de parámetros, puede exportar los valores del mapa a un archivo, realizar
Capítulo 6. metadatos de SAP BW 241

las adiciones o modificaciones y luego volverlo a importar a IBM Cognos
Framework Manager. Esto es especialmente útil para manipular mapas de
parámetros grandes y complejos.
Todas las claves del mapa de parámetros deben ser exclusivas para que
Framework Manager pueda recuperar coherentemente el valor correcto. No
coloque comillas alrededor de un valor de parámetro. Puede utilizar comillas en la
expresión en la que utiliza el parámetro.
El valor de un parámetro puede ser otro parámetro. Sin embargo, debe especificar
todo el valor entre signos de número (#). El límite para anidar parámetros en
forma de valores es cinco niveles.
Cuando se utiliza un mapa de parámetros como argumento para una función, se
debe utilizar un signo de porcentaje (%) en lugar de un signo de dólar ($).
Asigne un alias a un elemento de consulta que utiliza un mapa de parámetros
como parte de su nombre y para añadir nombres multilingües al objeto en la
pestaña Idioma (panel Propiedades).
Nota: Si se utilizan metadatos de SAP BW, no se puede utilizar un elemento de
consulta para generar las claves y los valores para un mapa de parámetros.
Pasos para crear manualmente un mapa de parámetros
Procedimiento
1. Pulse la carpeta Mapas de parámetros y pulse Acciones, Crear, Mapa de
parámetros.
2. Escriba un nombre para el mapa de parámetros en el cuadro Nombre.
3. Pulse Especifique manualmente las claves de parámetros y/o impórtelas
desde un archivo y pulse Siguiente.
4. Realice una de las siguientes acciones:
v Para especificar los valores manualmente, pulse Clave nueva, escriba una
clave y pulse el tabulador para especificar un valor para dicha clave.
v Para importar claves y valores, pulse Importar archivo e identifique la
ubicación del archivo .csv o .txt correspondiente. Para utilizar un archivo .txt
para la importación, los valores deben estar separados por tabulaciones y el
archivo debe guardarse con formato UTF8 o Unicode. Los archivos de texto
ANSI no se soportan.
Nota: Si va a utilizar un parámetro en un asunto de consulta de orígenes de
datos, el valor debe utilizar la puntuación específica del inglés. Esto significa
que debe utilizar un punto (.) para representar un decimal y una coma (,) para
separar las listas de valores.
5. Modifique los parámetros existentes como desee.
242 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Objetivo Acción
Asignar un valor predeterminado En el cuadro Valor predeterminado, escriba
un valor.
Si la clave utilizada en una expresión no está
asignada, se utiliza el valor predeterminado.
Especificar un valor predeterminado es
opcional. No obstante, si no se proporciona
un valor predeterminado, una clave no
asignada podría producir un error.
Cargar a petición La carga de un mapa de parámetros que
contenga un gran número de claves puede
ser lenta cuando se ejecuta un informe.
Puede limitar la carga a solo aquellas claves
que sean necesarias para un informe
determinado definiendo Cargar a petición
con el valor verdadero.
De forma predeterminada, el valor es falso y
todas las claves se cargan.
Eliminar un parámetro Seleccione una fila y pulse Eliminar.
Modificar un parámetro Seleccione la fila que desee modificar, pulse
el botón Editar y escriba un valor.
Borrar todas las claves y valores Pulse Borra mapa.
6. Pulse Finalizar.
Valores predeterminados y mapas de parámetros
Las propiedades Valor bajo predeterminado y Valor elevado predeterminado
pueden contener expresiones que utilicen mapas de parámetros. Puede utilizar
mapas de parámetros para definir un valor para una variable de moneda de
destino basada en el entorno local del usuario. Por ejemplo, si define un mapa de
parámetros que proporciona un código de moneda ISO. El valor para la propiedad
Valor bajo predeterminado se puede definir como
#$Currency_Map[runLocale}#
Este mapa de parámetros se utiliza cuando la variable de moneda de destino de
SAP BW se utiliza en un informe.
Son las únicas propiedades relacionadas con variables de SAP BW que pueden
utilizar mapas de parámetros.
Creación de un parámetro de sesión (SAP BW)
Por ejemplo, el ID de usuario y el idioma preferido son dos parámetros de sesión.
Debido a que los parámetros de sesión son pares de clave y valor, se puede decir
que cada parámetro de sesión es una entrada del mapa de parámetros denominada
Parámetros de sesión. Un parámetro de sesión se utiliza de la misma manera que
una entrada del mapa de parámetros, aunque la sintaxis de los parámetros de
sesión es ligeramente diferente.
Capítulo 6. metadatos de SAP BW 243

Hay dos tipos de parámetros de sesión: entorno y modelo.
Los parámetros de sesión de entorno están predefinidos y almacenados en Content
Manager. De forma predeterminada, los parámetros de sesión siguientes se
visualizan en Framework Manager:
v runLocale
Devuelve el código para el idioma activo actual en Framework Manager. El
contenido del modelo se muestra en este idioma.
Puede cambiar el idioma activo en cualquier momento solo para la sesión actual.
En las sesiones siguientes, el modelo continuará abriéndose en el idioma del
diseño. Para obtener más información, consulte:“Adición de un idioma a un
proyecto” en la página 127.
v account.defaultName
Especifica el nombre del usuario actual tal como está definido en el proveedor
de autenticación. Por ejemplo, el nombre y apellido del usuario.
Si inicia sesión anónimamente, verá Anónimo.
v account.personalInfo.userName
Especifica el ID de usuario utilizado para iniciar sesión en IBM Cognos BI.
Si inicia sesión anónimamente, no verá este parámetro.
v current_timestamp
Especifica la fecha y hora actual.
v machine
Especifica el nombre del sistema donde Framework Manager está instalado.
Si el origen de autenticación soporta otros parámetros y ha especificado
información sobre ellos en el origen de autenticación, verá otros parámetros de
sesión, como account.personalInfo.email o account.personalInfo.surname.
Puede definir parámetros adicionales utilizando parámetros de sesión de modelo.
Los parámetros de sesión de modelo están almacenados en un mapa de
parámetros denominado _env. Se establecen en el proyecto y se pueden publicar
con un paquete.
Los valores de los parámetros de sesión de modelo deben estar establecidos dentro
del ámbito de objetos del modelo de Framework Manager. El ámbito puede incluir
el uso de parámetros de sesión de entorno existentes, así como valores estáticos.
Cada parámetro de sesión debe tener un nombre y un valor predeterminado.
Puede definir un valor de reemplazo para probar los resultados que ese valor
devuelve. El valor de reemplazo solo es válido mientras el modelo está abierto y
no se guarda al guardar el modelo. Si no existe un valor de reemplazo, Framework
Manager utiliza el valor predeterminado cuando ejecuta una consulta que contiene
un parámetro de sesión.
Las reglas que controlan el uso de parámetros son las siguientes:
v Todos los valores de retorno posibles deben tener el mismo tipo de datos.
v Solo se puede definir un valor.
Pasos para crear parámetros de sesión
Procedimiento
1. Pulse Proyecto, Parámetros de sesión.
244 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

2. Pulse Nueva clave y escriba un valor y una clave de parámetro de sesión
nuevos.
3. Elija cómo desea gestionar el valor de reemplazo.
v Para no tener que definir el valor de reemplazo cada vez que edite el
proyecto, defina el parámetro de sesión como un valor.
v Para no tener que eliminar el valor del proyecto cada vez antes de
publicarlo, defina el parámetro de sesión como un reemplazo de sesión.
4. Modifique los parámetros existentes como desee.
Objetivo Acción
Cambiar el valor del parámetro Pulse la fila que contiene el valor que desea
cambiar, pulse Editar y escriba un valor.
Asignar un valor predeterminado En el cuadro Valor predeterminado, escriba
un valor. Framework Manager utiliza el
valor predeterminado su una clave tiene un
valor no válido.
Eliminar un parámetro Pulse una fila y pulse el botón Eliminar. No
se puede suprimir un parámetro de sesión
de entorno.
Borrar un valor de reemplazo Pulse una fila y pulse Borrar reemplazar.
5. Pulse Aceptar.
Organización del modelo (SAP BW)
Una práctica recomendada es crear varias vistas, o capas, en el modelo:
v Conserve los metadatos del origen de datos en un espacio de nombres o carpeta
independiente.
En IBM Cognos Framework Manager, se denomina vista de importación.
v Cree uno o varios espacios de nombres o carpetas opcionales para resolver las
complejidades que afectan a las consultas que utilizan asuntos de consulta u
objetos dimensionales.
Para utilizar IBM Cognos Analysis Studio o cualquier consulta de estilo OLAP,
debe haber un espacio de nombres o carpeta en el modelo que represente los
metadatos con objetos dimensionales.
v Cree uno o varios espacios de nombres o carpetas para la vista empresarial
aumentada de los metadatos que contiene los atajos para las dimensiones o los
asuntos de consulta.
En Framework Manager, se denomina vista empresarial. Utilice conceptos
empresariales para modelar la vista empresarial. Un modelo puede contener
muchas vistas empresariales, cada una de las cuales adecuada para un grupo de
usuarios diferente. Publique las vistas empresariales.
Se puede definir la seguridad en cualquiera de las vistas. Depende de los
requisitos de la empresa. Por ejemplo, si se necesita que nadie vea un objeto, se
añade seguridad al objeto en la vista de importación. Normalmente la seguridad se
aplica en la vista empresarial.
Para organizar un modelo se pueden incluir metadatos en varias carpetas
utilizando atajos o crear espacios de nombres o carpetas.
Capítulo 6. metadatos de SAP BW 245

Atajos (SAP BW)
Por ejemplo, puede crear carpetas con los nombres, Pedidos, Productos y Clientes.
Si quiere que tanto Pedidos como Clientes contengan la misma dimensión, debe
crear un atajo a la dimensión y añadirlo a ambas carpetas.
Nota: Dos atajos a los mismos espacios de nombres o carpetas no deben tener el
mismo nombre en un modelo. Para otros tipos de atajos (por ejemplo, un atajo a
un asunto de consulta), el nombre debe ser exclusivo en el espacio de nombres
padre.
Al crear un atajo, IBM Cognos Framework Manager no define las propiedades
Sugerencia y Descripción. A menos que defina estas propiedades, los valores
mostrados en los estudios IBM Cognos son los mismos que los definidos en el
objeto al que hace referencia el atajo.
Sugerencia: Para ir al objeto al que hace referencia el atajo, pulse con el botón
derecho del ratón en el atajo y pulse Ir a destino.
Los atajos son menos flexibles desde el punto de vista de la presentación que los
objetos de modelo, pero necesitan mucho menos mantenimiento porque se
actualizan automáticamente cuando se actualiza el objeto de destino. Si el
mantenimiento es una cuestión clave y no hay necesidad de personalizar el aspecto
del asunto de consulta, utilice atajos.
IBM Cognos Framework Manager dispone de dos tipos de atajos:
v Los atajos regulares, que son una mera referencia al objeto de destino.
v Los atajos de alias, que se comportan como si fueran una copia del objeto
original con comportamiento completamente independiente. Los atajos de alias
solo están disponibles para asuntos de consulta y dimensiones.
Atajos y dimensiones
Los atajos dan como resultado menos dimensiones para mantener. Puede guardar
las dimensiones en la vista de importación y guardar los atajos en la vista
empresarial.
Al crear un atajo a una dimensión, no puede personalizar los elementos de
consulta que hay en el atajo. La dimensión completa se incluye en el atajo.
La seguridad que especifica para un objeto se pasa a los atajos que hacen
referencia al objeto protegido. Si dispone de un atajo para un objeto protegido, solo
los usuarios con permiso para ver el objeto protegido pueden ver el atajo en el
paquete publicado.
Pulse con el botón derecho en los asuntos de consulta, dimensiones o carpetas a
los que desea crear atajos y pulse Crear, Atajo.
Creación de carpetas o espacios de nombres (SAP BW)
Se pueden crear carpetas o espacios de nombres para organizar los objetos del
modelo.
Lo más importante que se debe saber sobre los espacios de nombres es que cuando
ya se ha empezado a crear informes, los cambios efectuados en los nombres de los
espacios de nombres publicados afectarán al contenido de IBM Cognos. Esto es así
246 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

porque al cambiar el nombre de un espacio de nombres, se cambian los ID de los
objetos publicados en los metadatos. Como el espacio de nombres se utiliza como
parte del ID del objeto en IBM Cognos Framework Manager, cada espacio de
nombres debe tener un nombre exclusivo en el modelo. Cada objeto de un espacio
de nombres también debe tener un nombre exclusivo. Parte de la estrategia de los
grupos de esquema en estrella es colocar atajos en un espacio de nombres
separado, que automáticamente crea un ID exclusivo para cada objeto del espacio
de nombres. En el caso de base de datos relacionales, nos permitirá utilizar el
mismo nombre para atajos de dimensiones conformadas en diferentes grupos de
esquema en estrella.
La próxima vez que intente ejecutar una consulta, un informe o un análisis en el
modelo actualizado, obtendrá un error. Si es necesario cambiar el nombre del
espacio de nombres que ha publicado, utilice Analizar el impacto de la
publicación para determinar a qué informes afecta.
Las carpetas son mucho más sencillas que los espacios de nombres. Tienen una
finalidad meramente organizativa y no afectan a los ID de los objetos ni a su
contenido. Puede crear carpetas para organizar objetos por asunto o área funcional.
Esto facilitará la localización de los metadatos, especialmente en proyectos grandes.
El inconveniente principal de las carpetas es que necesitan nombres exclusivos
para todos los asuntos de consulta, dimensiones y atajos. Por lo tanto no son la
solución ideal para contener objetos compartidos.
Sugerencia: Cuando visualice metadatos en la pestaña Diagrama, puede expandir
o contraer carpetas y espacios de nombres. En el menú Diagrama, pulse Contraer
todo o Expandir todo.
Si establece la seguridad en una carpeta y luego mueve objetos a la carpeta,
confirme que las exclusiones estén definidas correctamente.
En el caso de metadatos de SAP BW, los atajos para espacios de nombres no están
soportados.
Pasos para crear una carpeta
Procedimiento
1. Pulse Acciones, Crear, Carpeta.
2. Escriba un nombre para la carpeta en el cuadro Carpeta.
3. Pulse Siguiente.
4. Elija si desea mover los objetos o crear atajos:
v Para mover los objetos seleccionados a la carpeta, pulse Mover los
elementos seleccionados a la nueva carpeta. Cuando se mueve un objeto
que participa de una relación, las relaciones con este objeto también se
mueven.
v Para crear objetos que hagan referencia a los objetos seleccionados, pulse
Crear un atajo para los elementos seleccionados. No seleccione todos los
objetos del espacio de nombres para evitar crear una estructura recursiva en
el paquete publicado.
5. Seleccione los objetos que desee añadir a la carpeta.
6. Pulse Finalizar.
Capítulo 6. metadatos de SAP BW 247

Pasos para crear un espacio de nombres
Procedimiento
1. Pulse Acciones, Crear, Espacio de nombres.
2. Pulse con el botón derecho en el espacio de nombres, pulse Cambiar nombre y
dé un nombre descriptivo y exclusivo al espacio de nombres.
3. Añada objetos importando metadatos o moviendo los objetos del modelo o
atajos a los objetos en el espacio de nombres.
248 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Capítulo 7. Publicación de paquetes
Publique un paquete para que los metadatos estén disponibles para sus usuarios.
Cree paquetes basados en sus grupos de usuarios. Los paquetes deben contener
toda la información que un usuario específico o un grupo de usuarios necesita
para crear informes.
En la publicación de paquetes intervienen las siguientes tareas:
v Verificar el modelo y reparar los posibles problemas.
v Analizar el modelo para identificar posibles problemas de modelado que habría
que examinar antes de publicar los metadatos.
v Definir la seguridad para restringir el acceso a los metadatos y los datos en los
productos de IBM Cognos.
v Especificar los idiomas publicados con cada paquete.
v Crear o modificar un paquete.
v Especificar las opciones de supresión que estarán disponibles para los usuarios
del paquete.
v Publicar el paquete.
v Verificar el paquete y reparar los posibles problemas.
Al publicar paquetes, tiene la opción de externalizar los asuntos de consulta y las
dimensiones para convertirlos en formatos que pueda utilizar en IBM Cognos
Transformer o en otras aplicaciones.
Nota: Futuras versiones de Transformer no darán soporte a la externalización de
consultas.
Verificación de modelos o paquetes
En cualquier momento, durante el proceso de modelado, puede comprobar la
validez de todo el modelo o de un objeto determinado del modelo, como un
paquete. Primero, compruebe el modelo y solucione los problemas y, después,
compruebe cada paquete del modelo individualmente. Al verificar un paquete,
puede encontrar y eliminar los objetos no válidos que pueden provocar errores en
una consulta.
Cuando se verifica un paquete o un modelo, IBM Cognos Framework Manager
busca mensajes en las categorías siguientes:
Categoría Descripción
Incoherencias internas del modelo Verifica que los objetos están correctamente
definidos y que no se utilizan nombres
duplicados. Ejecute siempre este grupo de
pruebas.
Referencias de objetos incompletas o no
válidas
Comprueba la existencia de referencias
pendientes o de referencias a objetos que
faltan.
© Copyright IBM Corp. 2005, 2013 249

Categoría Descripción
Integridad de los determinantes Verifica que los determinantes se han
definido completamente con claves y
atributos y que todos los elementos de
consulta están representados en un
determinante.
Integridad de las dimensiones Verifica que todas las dimensiones están
totalmente definidas con los títulos de
miembros de nivel y las claves de empresa.
Estado de la consulta
Verifica que el estado de evaluación de los
asuntos de consulta y dimensiones es válido
y no está definido como "Necesita
reevaluación" o "No válido".
El estado de consulta no verifica los objetos
de atajo. Por ejemplo, puede crear un atajo a
un objeto. El objeto deja de ser válido por
algún motivo. Cuando verifique el objeto,
aparecerá un mensaje porque no es válido.
Cuando verifique el atajo, no aparecerá
ningún mensaje.
Retrocompatibilidad Le informa de que un modelo contiene
características de una versión anterior que se
han mantenido, pero que quedarán obsoletas
en una versión futura.
Verificar la cardinalidad de las relaciones Advierte del hallazgo de relaciones de
muchos a muchos.
Cada categoría puede generar varios mensajes para un objeto. Para cada mensaje,
se proporciona la gravedad, el icono del objeto, el ID del objeto, la descripción del
mensaje, la explicación de cómo corregir el problema y las posibles acciones que
puede realizarse en el objeto. Puede corregir un problema inmediatamente
modificando el objeto que ocasionó el problema o solicitando a Framework
Manager que solvente el problema.
Procedimiento
1. Elija una de las acciones siguientes:
Objetivo Acción
Verificar un modelo En el menú Proyecto, pulse Verificar
modelo.
Verificar un paquete En el Visor de proyectos, pulse con el botón
derecho en un paquete y pulse Verificar
objetos seleccionados.
Verificar objetos seleccionados En el Visor de proyectos, seleccione uno o
más objetos, pulse con el botón derecho y
pulse Verificar objetos seleccionados.
2. En la pestaña Opciones, seleccione los niveles de gravedad de mensaje que
desea que se vean en los resultados.
De forma predeterminada, están seleccionadas las casillas de verificación de
todos los niveles de gravedad de mensaje. Desmarque las que no desee.
3. Seleccione las categorías que desea verificar.
250 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

De forma predeterminada, están seleccionadas las casillas de verificación de
todas las categorías. Desmarque las que no desee.
4. Pulse Verificar modelo.
La pestaña Verificar resultados del modelo muestra los resultados.
5. Para ordenar los mensajes, pulse Ordenar en la cabecera de columna de
gravedad, tipo de objeto o nombre.
6. Para ver el objeto que está relacionado con el mensaje, en la cabecera Acciones,
pulse Buscar en visor de proyectos.
7. Para solucionar los problemas de un grupo, seleccione un criterio de
agrupación de la lista.
8. Seleccione la casilla de verificación situada junto a cada mensaje para el
problema que desea solucionar.
Sugerencias:
v Para seleccionar todos los mensajes, seleccione la casilla de verificación
situada sobre la columna de casillas de verificación. Para desmarcar todos los
mensajes, desmarque la casilla de verificación situada sobre la columna de
casillas de verificación.
v si ha agrupado los mensajes, seleccione la casilla de verificación situada
sobre la columna de casillas de verificación del grupo y seleccione todos los
mensajes del grupo.
v Para ocultar la información detallada de los mensajes, pulse Contraer en la
cabecera del grupo.
9. Pulse Reparar seleccionado.
Framework Manager soluciona los problemas en el orden siguiente:
v referencias no válidas
v objetos no válidos, relaciones no válidas, reglas de agregado no válidas,
configuraciones regionales que faltan, tipos de solicitudes no soportadas,
roles inferidos y reevaluaciones; sin orden determinado.
v errores de modelos actualizados
También puede solucionar los problemas pulsando en el icono Editar
definición en la cabecera Acciones del mensaje. En el cuadro de diálogo,
modifique la definición del objeto como sea necesario.
Resultados
Cuando el proceso de reparación haya finalizado, se mostrará un resumen de los
resultados de la reparación. El modelo o paquete se verifica de nuevo y los
resultados se muestran en la pestaña Verificar resultados del modelo.
Consejo: Los problemas que no puedan solucionarse durante la verificación de un
paquete pueden solucionarse utilizando el modelo verificado.
Para los filtros autónomos, si los objetos subyacente pudieran no ser válidos, se
muestra un mensaje que indica que necesitan reevaluarse. La opción de reparación
no funciona para los filtros autónomos. Para comprobar si los filtros autónomos
son válidos, abra cada filtro y guárdelo.
Capítulo 7. Publicación de paquetes 251

Creación o modificación de paquetes
Puede crear un paquete para que los metadatos estén disponibles para sus
usuarios. Un paquete es un subconjunto de un proyecto. Debe contener toda la
información que un usuario específico o un grupo de usuarios necesita para crear
informes. También puede aplicar seguridad al paquete.
Por ejemplo, si el origen de datos contiene información de diferentes áreas de una
empresa, podría optar por crear paquetes diferentes para Recursos humanos y
Finanzas. Compruebe que el paquete dé respuesta a una amplia y relacionada
gama de necesidades de generación de informes. Cada informe puede contener
información de un único paquete.
Al crear o modificar paquetes, tenga en cuenta la información siguiente:
v Reutilizar paquetes
Puede reutilizar paquetes creando paquetes anidados. Cuando se crean paquetes
anidados, se crea un paquete maestro que se basa en otros paquetes existentes.
El uso de paquetes anidados permite ahorrar tiempo, aparte de que su
mantenimiento es más sencillo. Otra ventaja del uso de paquetes anidados es
que se publica solo el paquete maestro.
Por ejemplo, puede crear tres paquetes independientes denominados Canadá,
México y Estados Unidos. Cada paquete contiene los objetos del proyecto y la
seguridad correspondiente para dicho paquete. Puede crear un paquete maestro
Norte América e incluir los paquetes Canadá, México y Estados Unidos.
Puede volver a utilizar los paquetes para crear un paquete consolidado con
conexiones a varios orígenes de datos.
v Seleccionar, ocultar, anular selección de objetos
Cuando se crea un paquete, se puede decidir si los objetos del proyecto podrán
seleccionarse en función de las necesidades de los usuarios.
Opción Descripción
Seleccionar El objeto se puede utilizar en los informes y
los usuarios pueden seleccionarlo.
Ocultar Los datos del objeto no se pueden utilizar en
los informes porque los usuarios no pueden
seleccionarlo.
Por ejemplo, supongamos que incluye un
asunto de consulta de modelo en un
paquete. Puesto que los asuntos de consulta
de modelo dependen de los asuntos de
consulta de orígenes de datos“Asuntos de
consulta” en la página 75, debe añadir el
asunto de consulta de orígenes de datos al
paquete. Si no desea que los usuarios vean
el asunto de consulta de orígenes de datos,
ocúltelo.
Anular selección El objeto no está publicado. No puede
utilizarse en los informes y los usuarios no
pueden seleccionarlo.
252 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Nota: IBM Cognos Framework Manager da soporte a las combinaciones
Ctrl+Mayús y Alt+Mayús. Utilice estas teclas para seleccionar varios objetos que
desee incluir u ocultar. Por ejemplo, si desea incluir solo dos elementos de una
bifurcación grande, seleccione toda la bifurcación y, después, utilice Ctrl+Mayús
para anular la selección de los elementos que desee incluir y oculte los
elementos que queden seleccionados.
v Incluir un asunto de consulta de modelo en un paquete
Si un asunto de consulta de modelo hace referencia a otros asuntos de consulta
de una macro o solicitud, no olvide que debe incluir los asuntos de consulta
referenciados en el paquete.
Esto puede suceder en las situaciones siguientes:
– Una macro del asunto de consulta de modelo hace referencia a elementos de
consulta de otro asunto de consulta.
– Se hace referencia a otro asunto de consulta en las propiedades Información
de solicitud.
Después de publicar un paquete en el servidor, este queda a disposición de los
usuarios.
Creación de un paquete
Procedimiento
1. Pulse la carpeta Paquetes y, desde el menú Acciones, pulse Crear, Paquete.
2. En la página Proporcionar nombre, escriba el nombre del paquete y, si lo
desea, una descripción y una sugerencia. Pulse Siguiente.
3. Especifique si va a incluir objetos de paquetes existentes o del proyecto y
especifique qué objetos desea incluir.
Si ha creado otros paquetes, es recomendable que añada referencias de paquete;
para ello, pulse Utilizar paquetes existentes.
4. Elija si desea utilizar los permisos de acceso predeterminados para el paquete.
v Para aceptar los permisos de acceso predeterminados, pulse Finalizar.
v Para definir los permisos de acceso, pulse Siguiente.
5. Especifique quién puede acceder al paquete y pulse Siguiente.
Puede añadir usuarios, grupos o roles.
6. Mueva el idioma que se va a incluir en el paquete al cuadro Idiomas
seleccionados y pulse Siguiente.
7. Mueva los conjuntos de funciones de origen de datos que desea que estén
disponibles en el paquete al cuadro Conjuntos de funciones seleccionados.
Si el conjunto de funciones del proveedor de origen de datos no está
disponible, compruebe que se haya añadido al proyecto. Para obtener más
información, consulte: “Selección de conjuntos de funciones” en la página 316.
8. Pulse Finalizar y elija si va a publicar el paquete.
Modificación de un paquete
Procedimiento
1. Pulse el paquete que desea modificar.
2. Pulse Acciones, Editar definición.
3. Pulse los objetos que desee añadir al paquete o eliminar de este.
Capítulo 7. Publicación de paquetes 253

Seguridad
Sugerencia: Para alternar entre las opciones de un objeto, pulse el icono del
objeto o seleccione una opción de la lista.
4. Pulse Aceptar.
5. Si desea añadir referencias de paquete al paquete que está modificando o
eliminarlas, pulse Editar.
En IBM Cognos Framework Manager, la seguridad es un modo de limitar el acceso
a los metadatos y a los datos en todos los productos de IBM Cognos.
Hay diferentes tipos de seguridad para las consultas en Framework Manager:
v Seguridad de datos
Puede crear un filtro de seguridad y aplicarlo a un asunto de consulta
determinado. El filtro controla los datos que se muestran a los usuarios cuando
configuran sus informes.
v Seguridad de objetos
Los objetos se protegen directamente permitiendo a los usuarios el acceso al
objeto, denegándoles el acceso o manteniendo el objeto oculto a todos los
usuarios.
v Seguridad de paquete
Se puede aplicar la seguridad a un paquete y determinar quién tiene acceso a
dicho paquete.
Cada tipo de seguridad utiliza usuarios, grupos y roles para definir el acceso.
Existen motivos empresariales para limitar el acceso a los datos. Por ejemplo,
puede tener datos confidenciales que solo pueden ver determinados usuarios. Es
posible que tenga datos de diferentes tipos y los usuarios solo tengan que
recuperar datos de determinadas tablas o columnas. O es posible que tenga una
tabla que contenga muchos registros y los usuarios solo necesiten recuperar un
subconjunto de los registros de la tabla.
Si utiliza metadatos de SAP BW, pueda existir una seguridad de SAP BW que
afecte el acceso del usuario a lo miembros de nivel. No puede reemplazar la
seguridad de SAP BW en Framework Manager. Para obtener más información,
consulte: “Importación desde un origen de datos de SAP BW” en la página 193.
Antes de añadir seguridad a Framework Manager, compruebe que la seguridad
esté bien configurada en IBM Cognos BI. Para obtener información, consulte la
Guía de administración y seguridad.
Usuarios, grupos y roles
Los usuarios y los grupos se crean para la autenticación y la autorización. Puede
crear sus propios usuarios y grupos en IBM Cognos BI o utilizar usuarios y grupos
creados en otros proveedores de autenticación.
Para obtener más información sobre la seguridad, grupos y roles, consulte la Guía
de administración y seguridad.
254 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Usuarios
Una entrada de usuario se crea y mantiene en un proveedor de autenticación para
identificar de forma exclusiva una persona o una cuenta de sistema. No puede
crear usuarios en IBM Cognos BI.
La información sobre los usuarios, como el nombre y los apellidos, las contraseñas,
los ID, los entornos locales y las direcciones de correo electrónico se almacena en
los proveedores.
Los usuarios pueden convertirse en miembros de grupos definidos en los
proveedores de autenticación y grupos definidos en IBM Cognos BI. Un usuario
puede pertenecer a uno o varios grupos. Si los usuarios son miembros de más de
un grupo, sus permisos de acceso se fusionan.
Grupos y roles
Son ejemplos de grupos los empleados, los desarrolladores o el personal de ventas.
Los miembros de grupos pueden ser usuarios y otros grupos. La pertenencia a
grupo es parte de la identidad básica del usuario. Cuando los usuarios inician la
sesión, no pueden seleccionar el grupo que desean utilizar para una sesión.
Siempre inician la sesión con todos los permisos asociados a los grupos a los que
pertenecen.
Un rol es un grupo especial. Representa una colección de usuarios que tienen
responsabilidades y privilegios similares en la organización. Los miembros de roles
pueden ser usuarios, grupos y otros roles. La pertenencia a un rol no forma parte
de la identidad básica del usuario.
Puede utilizar grupos creados por la organización en los proveedores de
autenticación o crear nuevos grupos en el espacio de nombres de Cognos.
Cree grupos de IBM Cognos cuando:
v No pueda crear grupos en el proveedor de autenticación.
v Se necesiten grupos que abarquen varios espacios de nombres.
v Se necesiten grupos que se puedan desplegar.
v Desee solucionar necesidades específicas de administración de IBM Cognos.
v Desee evitar abarrotar los sistemas de seguridad de organización con
información utilizada solamente en el software de IBM Cognos BI.
Adición de seguridad de datos
Puede limitar los datos representados por los asuntos de consulta en un proyecto
creando un filtro de seguridad. El filtro de seguridad controla los datos que se
muestran a los usuarios cuando estos configuran sus informes.
Por ejemplo, el equipo de ventas está formado por un director de ventas y jefes de
ventas. Puede crear un filtro de seguridad que incluya un grupo para el director de
ventas y un grupo para los jefes de ventas, y aplicar el filtro al asunto de consulta
Salario. Cuando el paquete esté disponible para los usuarios, y se genere un
informe para los jefes y el director de ventas, solo el director de ventas podrá ver
la información salarial de los jefes de ventas. Para obtener más información sobre
los grupos, consulte: “Usuarios, grupos y roles” en la página 254.
Capítulo 7. Publicación de paquetes 255

Si un usuario tiene varios roles, los filtros de seguridad que pertenecen a estos
roles se unen con OR. Si un rol se basa en otro rol, los filtros de seguridad se unen
con AND.
Puede basar el filtro de seguridad en un filtro de seguridad existente. Si elige esta
opción, el filtro de seguridad hereda el filtro y todas las propiedades de este.
Cuando se crea un filtro de seguridad, se pueden utilizar los filtros del proyecto
existentes o crear filtros con el editor de expresiones. Para obtener más
información, consulte: “Creación de filtros” en la página 152.
Procedimiento
1. Pulse el asunto de consulta que desee.
2. Pulse Acciones, Especificar datos de seguridad.
3. Para añadir usuarios, grupos o roles nuevos, realice las acciones siguientes:
v Pulse Añadir grupos.
v En la ventana Seleccionar usuarios y grupos, añada los usuarios, grupos y
roles. Para obtener información sobre cómo hacerlo, consulte la Guía de
administración y seguridad.
v En la ventana Seleccionar usuarios y grupos, pulse Aceptar.
4. Si desea basar el grupo en un grupo existente, pulse un grupo de la columna
Basado en.
Sugerencia: Si no ve el grupo que desea en la lista, debe añadirlo al filtro de
seguridad.
5. Si desea añadir un filtro a un grupo, en la columna Filtro, pulse Crear/Editar
filtro incluido o Insertar desde modelo.
La función de macro CSVIdentityName
Si desea una seguridad de nivel de fila basada en los valores de UserClass
almacenados en el origen de datos, implemente un mapa de parámetros que asigne
los valores del origen de datos a los roles y grupos correspondientes en función del
usuario con el que se ha iniciado la sesión.
Esto se realiza usando un mapa de parámetros como un argumento con la función
de macro CSVIdentityName. Esta función de macro recupera la información de
cuenta, grupo y rol para el usuario actual. Devuelve una cadena de valores
separados por comas del mapa de parámetros entre apóstrofos, como
'administrativos', 'técnicos' o 'mecanógrafos'.
La función de macro CSVIdentityName se utiliza como una clave en el mapa
especificado. Puede utilizar la lista que se devuelve para crear cláusulas In
parciales o para filtrar datos en función del nombre de identidad del usuario
actual.
Por ejemplo, puede tener clases de usuario cuyos nombres no se correspondan con
el mapa de parámetros Roles_Groups:
Clave (rol o grupo) Valor (clases de usuario)
Todos Grupo1
Autores Grupo2
Administradores del sistema Grupo3
Usuarios de consulta Grupo2
256 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Clave (rol o grupo) Valor (clases de usuario)
NTLM Grupo2
Tiene este asunto de consulta:
(Security_column, value 1, value 2, value 3)
Cuando se añade un filtro al asunto de consulta, el filtro usa una macro para
buscar una lista de valores, por ejemplo:
Security_column in (#CSVIdentityName(%Roles_Groups)#)
Para los usuarios de los roles Todos, Autores y Administradores del sistema, la
prueba muestra esto como:
Security_column in (’Group1’,’Group2’,’Group3’)
La función de macro CSVIdentityNameList
Si los datos de seguridad del origen de datos son idénticos a los roles y grupos
definidos en IBM Cognos BI, puede usar la función de macro CSVIdentityNameList.
La función de macro acepta opcionalmente un separador de lista como un
parámetro y, después, devuelve una lista delimitada por separadores que se puede
usar en un filtro con el operador En. No necesita un mapa de parámetros.
A continuación se incluye un ejemplo:
Security_column in (#CSVIdentityNameList()#)
Para los usuarios de los roles Todos, Autores y Administradores del sistema, la
prueba muestra esto como:
Security_column in (’Everyone’,’Authors’,’System
Administrators’)
Tenga en cuenta lo siguiente:
v Los usuarios pueden pertenecer a varios grupos o roles.
v No hay modo de distinguir entre grupos y roles de forma que cada grupo y rol
debe tener un nombre exclusivo.
v Esta función solo funciona en un filtro y siempre devuelve los valores de 0..n.
Seguridad de objetos
La seguridad de los metadatos se puede aplicar directamente a los objetos de un
proyecto.
Si no establece la seguridad basada en objetos, todos los objetos del proyecto
estarán visibles para cualquiera que acceda al paquete. Los usuarios, los grupos o
los roles que no tienen valores de permiso o denegación para un objeto se
consideran no definidos. El objeto hereda la seguridad definida para su objeto
padre. Cuando se permite o deniega explícitamente el acceso a un objeto, se
reemplazan los valores heredados. Los objetos padre e hijo tendrán valores
diferentes. Cuando se aplica seguridad a un objeto padre, también se aplicará a
todos los objetos hijo del modelo. Después de establecer la seguridad para un
objeto, debe establecerse para todos los objetos. Para ello, puede establecer la
seguridad en el espacio de nombres raíz.
Capítulo 7. Publicación de paquetes 257

Puede que desee que un objeto solo esté visible para usuarios, grupos o roles
seleccionados. Por ejemplo, puede tener en el proyecto un asunto de consulta
Salario. El asunto de consulta Salario puede estar visible para el grupo Directores y
mantenerlo oculto para los demás.
Si un usuario es miembro de varios grupos de usuarios y un objeto solo está
visible para un grupo de usuarios y se ha denegado para los demás, el usuario no
tendrá acceso al objeto. Por ejemplo, Juana pertenece a dos grupos de usuarios:
Ventas y Marketing. El grupo Ventas tiene acceso a los asuntos de consulta
Productos y Ventas, y tiene denegado el acceso al asunto de consulta Previsión de
ventas. El grupo Marketing tiene acceso a los asuntos de consulta Productos,
Ventas y Previsión de ventas. Juana no tendrá acceso a Previsión de ventas.
Cuando se protege un objeto, se crea automáticamente un paquete en IBM Cognos
Framework Manager. El nombre del paquete consta de un guión bajo (_) y el
nombre del objeto protegido. Estos paquetes basados en objetos están visibles en el
Explorador. Puede utilizar este paquete para ver qué objetos del proyecto se
incluyen, ocultan o excluyen de un grupo de usuarios específico.
Cada vez que incluye este objeto en un paquete, y lo publica para los usuarios, se
aplican las mismas reglas de seguridad para el objeto. Cuando publica un paquete
que contiene objetos protegidos, los objetos visibles para los usuarios son la
intersección de la definición de paquete y los valores de seguridad del objeto. Si la
seguridad basada en objetos no se utiliza, la seguridad aplicada a un paquete no
cambia.
Ámbito de seguridad de objetos
La seguridad que especifica para un objeto se pasa a los atajos que hacen
referencia al objeto protegido. Si dispone de un atajo para un objeto protegido, solo
los usuarios con permiso para ver el objeto protegido pueden ver el atajo en el
paquete publicado.
Si un asunto de consulta de modelo, un cálculo o un filtro hacen referencia a un
objeto protegido, la seguridad del objeto no se pasa al asunto de consulta de
modelo, el cálculo o el filtro.
Al crear un paquete que contiene el atajo, no es necesario incluir el objeto
protegido en el paquete.
Por ejemplo, solo los directores comerciales tienen permitido ver el asunto de
consulta Sales Target. Crea un atajo para Sales Target. Al empaquetar el modelo,
incluye el atajo pero no el asunto de consulta Sales Target. Los directores de ventas
son los únicos que pueden ver el atajo en el paquete publicado.
Si el modelo se segmenta, la seguridad del objeto no se hereda del modelo
maestro. Debe definir la seguridad del objeto en todos los segmentos de modelo.
Adición de seguridad basada en objetos
Para implementar seguridad basada en objetos, añada un usuario, grupo o rol
determinado al objeto. Solo estos usuarios, grupos o roles podrán acceder al objeto.
Tenga en cuenta estas sugerencias al añadir seguridad basada en objetos:
v Para ver una lista de los paquetes basados en objetos, efectúe una doble
pulsación en la carpeta Paquetes. La lista se muestra en la pestaña Explorador.
Para ver qué objetos están protegidos ante un paquete basado en objetos
258 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

determinado, pulse la carpeta Paquetes y desde el menú Acciones, pulse
Paquetes, Explorar paquetes “Exploración de paquetes” en la página 271.
v Para determinar si la seguridad basada en objetos está definida en el modelo,
pulse la carpeta Paquetes y desde el menú Acciones, pulse Paquetes, Explorar
paquetes. Pulse la pestaña Explorador de roles. Si la seguridad basada en
objetos está establecida, verá un paquete para el rol Todos.
v Para determinar los objetos que están explícitamente protegidos en el modelo,
observe el icono de objeto del Visor de proyectos. La esquina superior izquierda
del icono está marcada con una superposición.
v Para localizar todos los objetos que están protegidos explícitamente en un objeto
determinado, seleccione el objeto y pulse Herramientas, Buscar todos los
objetos protegidos.
Procedimiento
1. Pulse el objeto que desea proteger y, en el menú Acciones, pulse Especificar
seguridad de objeto.
Sugerencia: Puede seleccionar simultáneamente más de un objeto.
2. Seleccione los usuarios, grupos o roles que desea cambiar. O, pulse Añadir para
añadir usuarios, grupos o roles nuevos.
Para obtener información, consulte la Guía de administración y seguridad.
3. Especifique los derechos de seguridad para cada usuario, grupo o rol,
realizando una de las acciones siguientes:
v Para denegar el acceso a un usuario, grupo o rol, seleccione la casilla de
verificación Denegar situada junto al nombre del usuario, grupo o rol.
Denegar tiene prioridad sobre Permitir.
v Para conceder el acceso a un usuario, grupo o rol, seleccione la casilla de
verificación Permitir.
Sugerencia: Para permitir que todos los usuarios vean todos los objetos a
menos que se haya denegado específicamente el acceso, seleccione la casilla de
verificación Permitir para el rol Todos.
4. Pulse Aceptar.
Aparece una lista de los paquetes basados en objetos nuevos y actualizados.
Eliminación de seguridad basada en objeto de un objeto
determinado
Para suprimir la seguridad basada en objeto de un usuario, grupo o rol
determinado, suprima el paquete de dicho usuario, grupo o rol del Visor de
proyectos.
Para suprimir completamente la seguridad basada en objeto del modelo, elimine el
paquete para el rol Todos del Visor de proyectos. No puede denegar al grupo
Todos acceso a todos los objetos.
Procedimiento
1. Pulse el objeto que desee.
2. Pulse Acciones, Especificar seguridad de objeto.
3. Elimine los derechos de seguridad desmarcando las casillas de verificación
Permitir y Denegar de todos los usuarios, grupos o roles.
4. Pulse Aceptar.
Aparece una lista de los paquetes afectados por estos cambios.
Capítulo 7. Publicación de paquetes 259

Modificación de la seguridad de los paquetes
Puede utilizar IBM Cognos Connection para definir o cambiar la seguridad de los
metadatos tras la publicación de un paquete.
Especificación de idiomas
La configuración de seguridad modificada mediante IBM Cognos Connection se
añade a la definición de seguridad del portal del paquete. La configuración afecta
al acceso, pero no cambia la definición del paquete en IBM Cognos Framework
Manager.
Para definir la seguridad de los metadatos la primera vez que se publican los
datos, consulte: “Publicación de paquetes” en la página 264.
Puede organizar la seguridad especificando qué usuarios, grupos y roles tienen
acceso a determinadas partes del modelo publicado.
Para añadir seguridad de metadatos, realice las acciones siguientes:
v Determine si los objetos pueden seleccionarse, deseleccionarse u ocultarse en el
paquete.
v Determine qué usuarios tendrán acceso administrativo a un paquete.
v Añada usuarios, grupos y roles al paquete.
Al aplicar el acceso administrativo a un paquete, concede acceso al usuario o
usuarios que son responsables de
v volver a publicar un paquete de Framework Manager en el servidor de IBM
Cognos
v asegurarse de que ningún informe queda afectado por que un paquete de
Framework Manager se haya vuelto a publicar en el servidor
Procedimiento
1. Pulse el paquete que desea editar y, en el menú Acciones, pulse Paquete,
Editar valores del paquete.
Aparece IBM Cognos Connection.
2. En IBM Cognos Connection, pulse la pestaña Permisos.
3. Cree, añada o elimine grupos o roles como desee. Para obtener más
información sobre cómo hacerlo, consulte: IBM Cognos Connection Guía del
usuario.
4. Una vez que haya acabado de modificar la definición de seguridad del paquete,
pulse Aceptar para regresar a Framework Manager.
Puede especificar los idiomas publicados con cada paquete. Puede crear varios
paquetes basados en el mismo modelo, cada uno con un idioma diferente.
Por ejemplo, el paquete para la oficina de ventas de México puede incluir español
e inglés. El paquete para la oficina de venta de Canadá puede incluir francés e
inglés.
También puede especificar los idiomas de todos los paquetes a la vez.
Para poder especificar los idiomas que los usuarios necesitan en el paquete,
primero debe añadir idiomas al proyecto “Metadatos multilingües” en la página
123.
260 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Definición de idiomas para un paquete
Procedimiento
1. En el Visor de proyectos, pulse el paquete que desee cambiar.
2. En la pestaña Propiedades, localice la propiedad Idioma y pulse Pulse para
editar....
3. Pulse un idioma (o pulse Ctrl y pulse al mismo tiempo en varios idiomas) en el
cuadro Idiomas de proyecto disponibles y utilice el icono de flecha para
moverlos al cuadro Idiomas seleccionados.
Definición de idiomas para todos los paquetes
Procedimiento
1. En el Visor de proyectos, pulse la carpeta Paquetes.
2. En el menú Acciones, pulse Paquetes, Especificar idioma de paquete.
3. Seleccione la casilla de verificación del idioma que desea para cada paquete.
Definición de opciones de supresión
Puede definir propiedades de supresión para el paquete publicado con IBM
Cognos Framework Manager. Estas propiedades determinan si los usuarios del
estudio de IBM Cognos pueden elegir la supresión de varios bordes o de un solo
borde. Las propiedades determinan también qué tipos de valores pueden
suprimirse. Los tipos de valores que los usuarios pueden optar por suprimir
dependen del estudio.
Cuando se crea un paquete, las propiedades de supresión se establecen
automáticamente con el valor true. Si desea cambiar los valores de un paquete
publicado, debe volver a publicar el paquete.
Procedimiento
1. En el Visor de proyectos, pulse el paquete que desee cambiar.
2. En la pestaña Propiedades, localice la propiedad de supresión y seleccione uno
de los valores siguientes:
v No permitir ninguna opción de supresión: Cuando tiene el valor true, esta
propiedad pone la supresión a disposición de los usuarios del estudio de
IBM Cognos. Cuando tiene el valorfalse, la supresión no está disponible en
el paquete publicado.
v Permitir supresión de varios bordes: Cuando tiene el valor true, los
usuarios pueden seleccionar las opciones de supresión de varios bordes o de
un solo borde. Cuando tiene el valor false, los usuarios solo tienen acceso a
la supresión de un solo borde. La propiedad No permitir ninguna opción de
supresión también debe ser true.
v Permitir acceso a las opciones de supresión: Cuando tiene el valor true, los
usuarios pueden elegir los tipos de valores que se suprimirán, como cero o
valores que faltan. De forma predeterminada, se suprimen todos los tipos de
valores. La propiedad No permitir ninguna opción de supresión también
debe ser true.
Capítulo 7. Publicación de paquetes 261

Asuntos de consulta y dimensiones externalizados
Al publicar un paquete, existe la opción de externalizar los asuntos de consulta y
las dimensiones en formatos que se puedan utilizar en IBM Cognos Transformer o
en otras aplicaciones. Se deben tener en cuenta algunas consideraciones especiales
al externalizar modelos basados en metadatos de SAP BW.
Para obtener más información, consulte: “Cómo trabajar con datos de SAP BW
utilizando archivos CSV externalizados en Framework Manager” en la página 641.
En primer lugar se define cómo se externalizará cada objeto mediante la
especificación del método que se debe utilizar. Cuando se publica el paquete, se
especifica que los asuntos de consulta y las dimensiones se deben externalizar.
Si ha especificado un número máximo de filas para la recuperación en el cuadro de
diálogo Reguladores, este valor se ignora.
Dispone de varias opciones para el método de externalización.
Método predeterminado
Utilice el método predeterminado para especificar los objetos de un paquete que
no desea que se externalicen. Para mejorar el rendimiento, es aconsejable no
externalizar todos los objetos de un paquete.
Método CSV
Utilice el método CSV para generar un archivo de datos separados por comas que
contenga los resultados del asunto de consulta. En un archivo CSV, la primera fila
representa los nombres de columna y cada una de las filas siguientes contiene un
registro del conjunto de resultados de la consulta. Se genera un archivo para cada
asunto de consulta o dimensión para los que se ha establecido la externalización.
Con el método CSV, puede utilizar funciones procesadas localmente para crear un
conjunto de datos para utilizarlo en Transformer. Puede procesar Cognos SQL
localmente o en el origen de datos, y capturar el conjunto de resultados en un
archivo que se pueda utilizar en IBM Cognos Transformer.
El tamaño del archivo generado está limitado a2GBycontiene datos basados en
la codificación nativa del sistema operativo actual. Por ejemplo, para Windows
2000, se especifica mediante el entorno local predeterminado del sistema en la
configuración regional de Windows. Para Windows XP y 2003, se especifica
mediante la opción Idioma para programas no Unicode en la configuración
regional de Windows.
Esta opción está pensada para utilizarla con Transformer solo. Para cualquier otra
finalidad, utilice el método Tab.
Para externalizar asuntos de consulta SAP BW, utilice el método CSV. Para obtener
más información, consulte: “Cómo trabajar con datos de SAP BW utilizando
archivos CSV externalizados en Framework Manager” en la página 641.
Método Tab
Utilice el método Tab para generar un archivo delimitado tab que contenga los
resultados del asunto de consulta o dimensión. El archivo generado se puede
262 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

utilizar directamente como origen de datos. El archivo generado contiene datos
basados en Unicode y utiliza la codificación UTF-16 LE (Little Endian) con BOM
(marca de orden de byte). Se genera un archivo para cada asunto de consulta o
dimensión para los que se ha establecido la externalización.
Este método no funciona con Transformer porque no soporta Unicode. Utilice el
método CSV para crear archivos para Transformer.
Método IQD
Utilice el método IQD para generar un archivo de definición de consulta para
utilizarlo en IBM Cognos Transformer. Se genera un archivo con SQL nativo para
cada asunto de consulta o dimensión para los que se ha establecido la
externalización. El archivo generado contiene datos basados en la codificación
nativa del sistema operativo actual. Por ejemplo, para Windows 2000, se especifica
mediante el entorno local predeterminado del sistema en la configuración regional
de Windows. Para Windows XP y 2003, se especifica mediante la opción Idioma
para programas no Unicode en la configuración regional de Windows.
El asunto de consulta no debe necesitar ningún procesamiento local. Debe poder
ejecutarse completamente en Data Server. Pruebe el asunto de consulta
estableciendo el procesamiento de consultas para este origen de datos en la base de
datos solo. Se visualiza un mensaje de error si el asunto de consulta necesita el
procesamiento local.
Si debe utilizar funciones procesadas localmente para crear un conjunto de datos,
utilice el método CSV. Con el método CSV, puede procesar Cognos SQL localmente
o en el origen de datos y capturar el conjunto de resultados en un archivo que se
puede utilizar en Transformer.
Los asuntos de consulta de procedimiento almacenado se pueden externalizar para
utilizarlos en Transformer. Los procedimientos almacenados no deben contener
parámetros.
Nota: Tenga en cuenta que el método IQD continúa soportado en esta versión pero
no se mejora.
Propiedad Externalizar resumen automático
Puede especificar que la salida se agregue o se agrupe o ambas opciones. De forma
predeterminada, IBM Cognos Framework Manager devuelve filas en el nivel de
detalle sin aplicar ninguna agregación ni agrupación. Esta propiedad se utiliza
cuando se desea agregar datos relacionales al externalizarlos. Especifique
determinantes para el asunto de consulta antes de externalizarlo.
Utilice la propiedad Externalizar resumen automático para aplicar el valor de la
propiedad Agregado regular a los elementos de consulta cuya propiedad Uso esté
establecida en hecho.
Si desea un orden específico de elementos en la cláusula Group By, especifique los
determinantes primero y, luego, establezca la propiedad Externalizar resumen
automático.
Puede utilizar la propiedad Externalizar resumen automático con todos los
métodos de externalización.
Capítulo 7. Publicación de paquetes 263

Tipos de datos soportados
Framework Manager soporta cadenas, enteros y fechas. No soporta dimensiones de
tiempo. Utilice una clave de fecha en el asunto de consulta de hechos en
Framework Manager, y deje que Transformer genere la dimensión de tiempo.
Atajos
Publicación de paquetes
Si se incluye un atajo en un paquete que señala a un asunto de consulta que se ha
externalizado, el atajo también se externaliza. El nombre del archivo de datos es el
nombre del asunto de consulta al que señala el atajo. Si más de un atajo señala al
mismo asunto de consulta, éste se externaliza cada vez que se encuentra el atajo.
Procesamiento de consultas
Se utiliza SQL nativo para generar un IQD, por lo que el SQL nativo producido
debe ejecutarse satisfactoriamente al externalizarse.
Algunas consultas generan la emisión de más de una consulta, o procesamiento
local para recuperar datos, o ambos. Para evitarlo, asegúrese de que la propiedad
Procesamiento de consultas para todos los objetos de orígenes de datos del
modelo se haya establecido en Sólo base de datos. Para obtener más información
sobre el procesamiento de consultas, vea “Mejora del rendimiento mediante el
establecimiento del tipo de procesamiento de consultas” en la página 313.
Proceso para externalizar dimensiones
Lleve a cabo las tareas siguientes para externalizar dimensiones:
v Cree un asunto de consulta de modelo o un asunto de consulta de orígenes de
datos que contenga las dimensiones que desee externalizar. Para obtener
información, consulte: “Asuntos de consulta” en la página 75.
v Añada los filtros que necesite.
Para obtener información sobre filtros para metadatos relacionales, consulte
“Creación de filtros” en la página 152. Para obtener información sobre filtros
para metadatos SAP BW, consulte “Creación de un filtro (SAP BW)” en la página
237.
v En el panel Propiedades, establezca la propiedad Método de externalización en
el método que desee.
v Publique el paquete para externalizar las dimensiones que ha seleccionado.
En IBM Cognos Framework Manager, se puede publicar un paquete en cualquier
carpeta de Content manager para que los usuarios pueden tener acceso a él.
Igualmente, puede publicar un paquete en una ubicación de red. Los paquetes
publicados en una ubicación de red no pueden ser utilizados por los usuarios.
Publicar el paquete en una ubicación de red es útil para realizar copias de
seguridad del paquete. Si publica en una ubicación LAN, debe estar atento a no
sobrescribir los archivos existentes; en particular, los modelos de Framework
Manager y el modelo que está actualmente abierto.
Los objetos que se excluyen o están ocultos, pero son necesarios en una ruta de
consulta, se incluyen pero se marcan como ocultos en un paquete publicado.
264 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Los valores del regulador que tienen prioridad son los que hacen referencia al
modelo que está abierto (con independencia de que sea un modelo padre o hijo).
Para evitar problemas, solucione los errores del paquete antes de publicarlo; para
ello, utilice la casilla de verificación Verificar el paquete antes de publicarlo en el
asistente de publicación para que esté completo y no contenga errores.
Al publicar un paquete puede:
v Definir el número de versiones de modelo que se van a conservar en el servidor.
Para obtener más información sobre las versiones de modelo, consulte:
“Actualización de informes para utilizar la versión de paquete más reciente” en
la página 269.
Sugerencia: Para ver el número de versiones de modelo definidas para un
paquete, seleccione un paquete y, en el panel Propiedad, localice la propiedad
Versiones máx..
v Externalizar los asuntos de consulta y las dimensiones de modo que se puedan
utilizar con Transformer “Asuntos de consulta y dimensiones externalizados” en
la página 262.
v Especifique si el paquete va a utilizar el modo de consulta dinámica.
Para obtener más información sobre el modo de consulta dinámica, consulte la
publicación Guía de consultas dinámicas.
Nota: Puede crear directamente paquetes en IBM Cognos Connection para IBM
Cognos PowerCubes y cubos y consultas de SAP BW. Para obtener más
información, consulte la sección sobre paquetes en la Guía de administración y
seguridad.
Procedimiento
1. Seleccione el paquete que desea publicar.
2. En el menú Acciones, pulse Paquetes, Publicar .
3. Elija donde desea publicar el paquete:
v Para publicar el paquete en el servidor de informes, pulse IBM Cognos
Content Store, Abrir y seleccione una carpeta existente o cree una en
Content Store.
v Para publicar el paquete en una ubicación de red, pulse Ubicación en la
red. No olvide que debe seleccionar una ubicación que no sea el directorio
donde se encuentran almacenados los archivos del proyecto. Por lo general,
procure no guardar en la misma ubicación que el modelo ya que este
podría sobrescribirse.
4. Para activar la creación de versiones del modelo al publicar en IBM Cognos
Content Store, seleccione la casilla de verificación Habilitar control de
versiones de modelos y escriba el número de versiones de modelo del
paquete que se desean conservar.
Sugerencia: Para eliminar todas salvo la versión publicada más reciente en el
servidor, seleccione la casilla de verificación Suprimir todas las versiones
anteriores del modelo.
5. Pulse Siguiente.
6. En la ventana Añadir seguridad, defina la seguridad del paquete (opcional):
Capítulo 7. Publicación de paquetes 265

Objetivo Acciones
Crear, añadir o eliminar un usuario, grupo o
rol
Otorgar acceso administrativo a un usuario,
grupo o rol
En la pestaña Acceso a usuario, pulse
Añadir.
En la ventana Seleccionar usuarios y
grupos, defina la seguridad de usuario. Para
obtener información sobre cómo utilizar la
ventana Seleccionar usuarios y grupos,
consulte la publicación Guía de administración
y seguridad. Los usuarios, grupos o roles
definidos en la pestaña Acceso de usuario
tienen permisos de lectura, escritura,
ejecución y visita.
En la pestaña Acceso de administrador,
pulse Añadir.
En la ventana Seleccionar usuarios y
grupos, defina la seguridad de
administrador. Para obtener información
sobre cómo utilizar la ventana Seleccionar
usuarios y grupos, consulte la publicación
Guía de administración y seguridad. Los
usuarios, grupos o roles definidos en la
pestaña Acceso de administrador tienen
permisos de lectura, escritura, definición de
políticas y visita.
Nota: La ventana Añadir seguridad del asistente de publicación solo está
disponible la primera vez que se publica un paquete. Si se vuelve a publicar
el paquete en la misma ubicación, no se puede reemplazar la seguridad
existente. Para cambiar la seguridad de los paquetes publicados, consulte:
“Modificación de la seguridad de los paquetes” en la página 260.
7. Pulse Siguiente.
8. Si desea externalizar los asuntos de consulta, seleccione la casilla de
verificación Generar los archivos para asuntos de consulta externalizados.
9. De forma predeterminada, el paquete se verifica antes de su publicación. Si no
desea que el modelo se verifique antes de su publicación, desmarque la casilla
de verificación Verificar el paquete antes de publicarlo.
10. Si el paquete contiene orígenes de datos soportados por el modo de consulta
dinámica, tiene la posibilidad de habilitar el modo de consulta dinámica para
el paquete. Seleccione la casilla de verificación Utilizar modo de consulta
dinámica. Se le pedirá que confirme esta selección cuando pulse Publicar.
Este paso se aplica cuando la propiedad Modo de consulta del proyecto se
define en Compatible.
Nota: Si un paquete que contiene orígenes de datos soportados y no
soportados se publica con el modo de consulta dinámico, los usuarios
obtendrán un error cuando abran el paquete en los estudios.
Para obtener más información sobre los orígenes de datos soportados por el
modo de consulta dinámica, consulte la publicación IBM Cognos Guía de
administración y seguridad.
11. Pulse Publicar.
Si opta por externalizar los asuntos de consulta, Framework Manager lista los
archivos que se crean.
266 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

12. Pulse Finalizar.
Publicación de paquetes basados en orígenes de datos de
OLAP
Puede utilizar IBM Cognos Framework Manager para conectarse a un origen de
datos de OLAP y crear un paquete basado en un cubo. Después, puede publicar
directamente el paquete en IBM Cognos Connection, de modo que esté disponible
para utilizarse en los estudios de IBM Cognos.
De forma predeterminada, cada paquete contiene una conexión a un único cubo. Si
desea crear un paquete con varios cubos, ejecute el asistente de metadatos y cree
un paquete para cada cubo. Después, cree un paquete que incluya los paquetes
individuales que desee.
Antes de crear un paquete con varios cubos, piense en el posible impacto que ello
pueda tener en el rendimiento. En IBM Cognos Connection, cada vez que se utiliza
un paquete, se realiza una conexión con cada uno de los orígenes de datos
definidos en el paquete. Los paquetes grandes con varios cubos, pueden incidir
negativamente en el rendimiento. Para evitar el posible impacto en el rendimiento
que puede tener un gran paquete con muchos cubos, cree un solo paquete por
cubo y, después, cree combinaciones menores de paquetes según le resulte
necesario.
De forma predeterminada, los paquetes basados en un origen de datos de OLAP
no contienen listas de funciones de proveedor. Si desea incluir la lista de funciones
de proveedor, especifique los conjuntos de funciones para incluir y, después,
vuelva a publicar el paquete.
Nota: Para publicar un paquete que contenga un solo cubo, utilice IBM Cognos
Connection. Para obtener información sobre cómo publicar un paquete desde IBM
Cognos Connection, consulte la Guía de administración y seguridad.
Pasos para crear y publicar un paquete
Procedimiento
1. En la página Bienvenidos, pulse Crear un proyecto nuevo.
Sugerencia: Si ya se encuentra en Framework Manager, pulse Archivo, Nuevo.
2. En la página Nuevo proyecto, especifique un nombre y una ubicación para el
proyecto y pulse Aceptar.
Es posible que se le solicite información de autenticación.
3. En la página Seleccionar idioma, pulse el idioma de diseño del proyecto.
No se puede cambiar el idioma seleccionado después de pulsar en Aceptar,
pero se pueden añadir otros idiomas. Para obtener más información, consulte:
“Adición de un idioma a un proyecto” en la página 127.
4. En el cuadro de diálogo Asistente de metadatos, pulse Origen de datos,
Siguiente.
5. Seleccione el origen de datos de la lista de conexiones de origen de datos
disponibles y pulse Siguiente.
Si la conexión de origen de datos no está disponible en la lista, puede pulsar en
Nuevo para crear una. Para obtener más información, consulte: “Creación de
conexiones de origen de datos” en la página 44.
6. Especifique el nombre del paquete y pulse Siguiente.
También puede especificar una descripción y una sugerencia para el paquete.
Capítulo 7. Publicación de paquetes 267

7. Especifique quién puede acceder al paquete.
Puede añadir usuarios, grupos o roles. Para obtener más información, consulte:
“Usuarios, grupos y roles” en la página 254.
8. Pulse Finalizar para importar los metadatos y crear el paquete.
9. Cuando se le solicite, pulse Sí para publicar el paquete o pulse No para
regresar al Visor de proyectos.
Resultados
El espacio de nombres se muestra en el Visor de proyectos. No se pueden ver los
objetos del modelo de metadatos nativo desde Framework Manager. Los objetos de
metadatos nativos se pueden ver desde los estudios de IBM Cognos cuando se
utiliza el paquete de metadatos nativos.
Pasos para añadir otro paquete
Procedimiento
1. En el Visor de proyectos, pulse con el botón derecho en el modelo que desea
utilizar y pulse Ejecutar asistente de metadatos.
2. En el cuadro de diálogo Asistente de metadatos, pulse Orígenes de datos,
Siguiente.
3. Seleccione el origen de datos de la lista de conexiones de origen de datos
disponibles y pulse Siguiente.
Si la conexión de origen de datos no está disponible en la lista, puede pulsar en
Nuevo para crear una. Para obtener más información, consulte: “Creación de
conexiones de origen de datos” en la página 44.
4. Especifique el nombre del paquete y pulse Siguiente.
También puede especificar una descripción y una sugerencia para el paquete.
5. Especifique los permisos de acceso para el paquete.
Puede Añadir al paquete usuarios, grupos o roles. Para obtener más
información, consulte: “Usuarios, grupos y roles” en la página 254.
6. Pulse Finalizar para importar los metadatos y crear el paquete.
7. Cuando se le solicite, pulse Sí para publicar el paquete o pulse No para
regresar al Visor de proyectos.
Resultados
El espacio de nombres se muestra en el Visor de proyectos. No se pueden ver los
objetos del modelo de metadatos nativo desde Framework Manager. Los objetos de
metadatos nativos se pueden ver desde los estudios de IBM Cognos cuando se
utiliza el paquete de metadatos nativos.
Publicación de paquetes mediante la ejecución de scripts
Los informes de IBM Cognos dependen de los objetos del paquete en los que se
basa el informe. Si el informe utiliza objetos que ya no existen en el paquete, los
informes no se ejecutarán. Este problema puede presentarse si realiza cambios en el
origen de datos físico y, después, utiliza un script para generar el modelo y volver
a publicar el paquete. Después de ejecutar el script y publicar el paquete, los
informes con errores no se identifican analizando el impacto de la publicación del
paquete.
268 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Para evitar este problema cuando publique paquetes mediante scripts, realice las
tareas de publicación en el orden especificado.
Procedimiento
1. Ejecute el script excluyendo los pasos que sirvan para publicar el paquete.
2. Verifique el modelo o analice el impacto de la publicación del paquete.
3. Publicar el paquete.
Actualización de informes para utilizar la versión de paquete
más reciente
Cuando se publica un paquete por primera vez, se crea un paquete
correspondiente en el servidor de IBM Cognos. El paquete contiene un modelo,
pero no contiene informes.
Cuando publica un paquete, puede seleccionar el número de versiones del modelo
que se van a guardar en el servidor. La siguiente vez que se publique el paquete,
la versión del modelo se actualizará en el paquete existente en el servidor.
Los informes nuevos o modificados utilizan la versión más reciente del modelo del
paquete. Cuando un informe se guarda, la versión del modelo utilizado se guarda
en la especificación del informe. Si el paquete vuelve a publicarse, el autor del
informe recibe una notificación en la que se indica que el informe utiliza la versión
más reciente del modelo del paquete. El autor del informe debe guardar el informe
para completar la actualización. Si abre un informe guardado después de que el
paquete en el que se basa se haya vuelto a publicar, se produce una de estas dos
circunstancias:
v Si la versión origina del paquete existe, el informe se ejecuta con la versión
original. Si desea que el informe se ejecute con la versión más reciente del
paquete, debe actualizar el informe para que utilice dicha versión más reciente.
Consulte los pasos siguientes.
v Si la versión original del paquete ya no existe, el informe se actualiza para
ejecutarse con la versión más reciente.
Procedimiento
Realice una de las siguientes acciones:
v Mueva un informe a la versión más reciente del modelo; para ello, edite y
guarde el informe.
v Antes de volver a publicar el modelo, mueva todos los informes a la versión
más reciente del modelo; para ello, seleccione la casilla de verificación Suprimir
todas las versiones anteriores del modelo en el asistente de publicación.
v Antes de volver a publicar el modelo, inhabilite la creación de versiones del
modelo; para ello, defina el límite de versiones del modelo con el valor 1.
Capítulo 7. Publicación de paquetes 269

270 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Capítulo 8. Gestión de proyecto
Metadatos del modelo
Durante la vida de un proyecto, los datos pueden cambiar y pueden surgir nuevos
requisitos que suponen actualizar modelos y orígenes de datos.
Después de publicar un proyecto, puede realizar las siguientes operaciones para
gestionar el contenido:
v Entender qué metadatos están en el modelo.
v Implementar modelado multiusuario.
v Administrar los metadatos.
v Sincronizar proyectos.
v Controlar y optimizar el comportamiento de las consultas.
Antes de realizar cambios en un modelo publicado, puede conocer mejor los
metadatos mediante las acciones siguientes:
v Explorar los proyectos para ver los paquetes y roles de un proyecto.
v Ver los objetos de los paquetes para ver dónde se encuentran determinados
objetos.
v Crear documentación sobre el modelo para satisfacer determinados requisitos de
la compañía.
Exploración de paquetes
Si tiene muchos proyectos y la seguridad basada en objetos en un proyecto, puede
ser difícil mantener todo bien organizado. Puede explorar los paquetes para ver los
paquetes y roles de un proyecto.
En la pestaña Contenido del paquete, puede ver una lista de todos los paquetes
(normales y basados en objetos) de un proyecto, así como los objetos que se
seleccionaron, deseleccionaron u ocultaron para cada paquete.
En la pestaña Seguridad del objeto, puede ver una lista de todos los usuarios,
grupos y roles de un proyecto, y en qué paquete se aplica la seguridad basada en
objetos. Asimismo, puede ver si los objetos del proyecto están ocultos oalavista
de un usuario, grupo o rol determinado.
Procedimiento
1. Seleccione la carpeta Paquetes.
2. En el menú Acciones, pulse Paquetes, Explorar paquetes.
3. Elija la acción que desea realizar.
Objetivo Acción
Ver el contenido de un paquete Pulse la pestaña Contenido del paquete.
© Copyright IBM Corp. 2005, 2013 271

Objetivo Acción
Editar el paquete Pulse la pestaña Contenido del paquete,
seleccione el paquete y pulse Editar.
Para obtener más información, consulte:
“Creación o modificación de paquetes” en la
página 252.
Ver la seguridad de cada paquete Pulse la pestaña Seguridad del objeto y
seleccione un paquete.
4. Pulse Cerrar.
Visualización de la distribución de los objetos en paquetes
Cuando se visualiza la inclusión de paquetes de un objeto, se ve, por paquete,
donde existe el objeto y si está seleccionado, deseleccionado u oculto en dicho
paquete.
Si el objeto está protegido, se verá también el paquete basado en objeto en el que
existe el objeto.
Procedimiento
1. Pulse el objeto que desee ver y pulse Acciones, Editar inclusión de paquete.
2. Para editar el paquete, pulse Editar paquete.
Para obtener más información, consulte: “Creación o modificación de paquetes”
en la página 252.
3. Pulse Aceptar.
Creación de documentación del modelo
Después de modelar los metadatos, puede crear una representación HTML o XML
del modelo, que se puede personalizar e imprimir. Esto es útil para depurar el
modelo o si la compañía necesita este tipo de documentación para dar respuesta a
los requisitos del proceso.
Cuando se crea la documentación del modelo, se puede documentar todo el
modelo o se puede seleccionar un subconjunto del modelo. Para documentar todo
el modelo, pulse el espacio de nombres del nivel superior. La documentación del
modelo muestra el objeto seleccionado y todas las propiedades e hijos de dicho
objeto.
Puede ver, guardar o imprimir el informe en formato XML o HTML. De forma
predeterminada, el formato XML de IBM Cognos Framework Manager es siempre
XML sin procesar. Para personalizar la salida del informe XML en el navegador,
puede proporcionar su propia transformación XSLT.
Para personalizar la salida HTML, puede utilizar su propio XSLT especificando la
ruta y el archivo XSL en la sección ModelDocXSL del archivo fm.ini ubicado en el
directorio ubicación_instalación/configuration. Framework Manager utilizará el
archivo XSL especificado cuando muestre la versión HTML del informe de modelo.
Procedimiento
1. Pulse el objeto que desee documentar.
272 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Modelado multiusuario
Consejo: Pulse el espacio de nombres de nivel superior para documentar todo
el modelo.
2. Pulse Herramientas, Informe de modelo.
Se muestra el informe del modelo.
Puede guardar, imprimir o cambiar el formato del informe.
Puede implementar modelado multiusuario en IBM Cognos Framework Manager
mediante bifurcación y fusión o mediante segmentación y enlace.
v Bifurcación y fusión
Si utiliza bifurcación y fusión para gestionar un proyecto multiusuario, cada
usuario puede modificar los mismos objetos en un proyecto al mismo tiempo.
Cada usuario tiene una copia de todo el proyecto y puede trabajar en cualquier
parte de éste. Cuando las bifurcaciones se fusionan de nuevo en el proyecto raíz,
se resuelven todos los conflictos entre el proyecto raíz y las bifurcaciones. Para
obtener más información, consulte: “Bifurcación y fusión de proyectos”.
v Segmentación y enlace
Si utiliza segmentación y enlace para gestionar un proyecto multiusuario, cada
usuario puede observar las mismas partes del proyecto al mismo tiempo. No
obstante, deberá asegurarse de que cada usuario modifica partes diferenciadas
del proyecto. Use enlaces para permitir que diferentes usuarios hagan referencia
a un proyecto al mismo tiempo que otro usuario trabaja en él. Para obtener más
información, consulte: “Proyectos segmentados y enlazados” en la página 279.
Bifurcación y fusión de proyectos
La bifurcación y la fusión permiten que varios usuarios trabajen simultáneamente
con el mismo modelo. Para ello, el propietario del proyecto crea una bifurcación
del proyecto raíz, que es una copia del proyecto. Un miembro del equipo puede
modificar la bifurcación como desee, independientemente del proyecto raíz. Las
bifurcaciones pueden fusionarse de nuevo con el proyecto raíz, cuando se requiera.
Los conflictos entre el proyecto raíz y las bifurcaciones se solucionan durante el
proceso de fusión.
Se pueden crear tantas bifurcaciones como se desee. Puede crear una bifurcación a
partir de otra.
Bifurcación y fusión
Utilice las siguientes directrices para bifurcar un proyecto.
v Debe decidir cómo desea compartir los metadatos de la organización. Para
obtener más información, consulte: “Metodologías de bifurcación” en la página
274.
v Divida el proyecto en partes lógicas y bifúrquelo para crearlas. Para obtener más
información, consulte: “Modos de bifurcar un proyecto” en la página 276.
v Es muy importante la comunicación entre los miembros del equipo que trabajan
con varias bifurcaciones. Antes de realizar un cambio importante en la
bifurcación, coméntelo con los demás miembros del equipo para determinar
cómo afectará a las bifurcaciones de estos. Por ejemplo, la adición de objetos a
una bifurcación probablemente no afectará a los demás miembros del equipo,
pero la eliminación de un objeto que otros miembros del equipo utilizan en sus
bifurcaciones creará un conflicto cuando fusione la bifurcación de nuevo en el
proyecto raíz.
Capítulo 8. Gestión de proyecto 273

v Debe fusionar las bifurcaciones en el orden inverso en el que las creó. Por
ejemplo, Sean crea una bifurcación a partir de proyecto raíz. Susan crea una
bifurcación a partir de la de Sean. En el momento de fusionar de nuevo las
bifurcaciones con el proyecto raíz, Susan debe fusionar primero su bifurcación
con la de Sean y, después, Sean debe fusionar la suya con el proyecto raíz.
v Es mejor fusionar las bifurcaciones en el proyecto raíz con frecuencia tras
realizar unos pocos cambios en esta, en lugar de realizar muchos cambios y
fusionar solo de vez en cuando. Así, es más sencillo resolver los conflictos
durante el proceso de fusión. Puede fusionar todas las bifurcaciones en el
proyecto raíz y, después, bifurcar de nuevo el proyecto. Cada miembro del
equipo recibe una versión actualizada del modelo.
v En un proyecto bifurcado, las transacciones archivadas no estarán disponibles
cuando se fusione de nuevo en el proyecto principal. Para obtener más
información, consulte: “Visualización y almacenamiento del historial de
transacciones” en la página 295
Metodologías de bifurcación
Antes de bifurcar un proyecto, debe decidir cómo desea compartir los metadatos
en el proyecto. En esta sección se describen algunas metodologías comunes para
compartir metadatos.
Concentrador y radio
En la metodología de concentrador y radio, un proyecto utiliza metadatos comunes
que todas las áreas funcionales deben compartir. El proyecto raíz consiste en una
capa física completamente modelada que contiene los objetos que requieren todas
las áreas funcionales. El proyecto raíz está bifurcado para cada área funcional.
Cada área funcional puede crear sus propias bifurcaciones si hay varias personas
trabajando en ella. En cualquier momento un modelador de área funcional puede
fusionar una bifurcación de nuevo en el proyecto raíz para actualizar el proyecto
raíz y luego volver a bifurcarlo para recibir actualizaciones. Los objetos comunes a
todas las áreas funcionales se conservan en el proyecto raíz.
Concentrador y radio
El modelador maestro crea
un proyecto raíz que contiene
una capa de metadatos
compartidos para todas las
áreas funcionales.
FA 1
bifurcación
common
FA 1 metadatos
Proyecto raíz
common
FA 1 metadatos
FA 2 metadatos
El modelador mejora esta bifurcación mediante la
importación de orígenes de datos, añadiendo
cálculos y creando y publicar paquetes especificos
de la aréa funcional 1.
274 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario
FA 2
branch
common
FA 2 metadatos
El modelador mejora esta bifurcación mediante
la importación de orígenes de datos, añadiendo
cálculos y creando y publicar paquetes
especificos de la aréa funcional 2.

Metadatos específicos de área funcional
En la metodología de metadatos específicos de área funcional, no hay metadatos
comunes, o muy pocos, en el proyecto. Cada área funcional desarrolla sus propios
objetos en el proyecto de forma independiente. Cada área funcional desconoce los
objetos de las otras áreas funcionales. El modelador maestro controla la fusión de
las bifurcaciones para evitar que un área funcional vea los objetos de las otras
áreas funcionales.
Metadatos específicos de área funcional
FA 1
bifurcación
FA 1
metadatos
La bifurcación contiene los metadatos
completos para la aréa funcional 1.
Distribución por capas
Proyecto raiz
FA 2
matadatos
FA 1
metadatos
FA 2
branch
FA 2
metadatos
La bifurcación contiene los metadatos
completos para la aréa funcional 2.
En la metodología de distribución por capas, los metadatos se organizan en capas.
Cada capa requiere acceso a los metadatos de la capa superior. Por ejemplo, un
modelo contiene tres capas. La capa superior es el proyecto raíz, que consiste en
una capa física completamente modelada. El proyecto raíz se bifurca para crear la
segunda capa, la bifurcación intermedia. La bifurcación intermedia contiene una
capa de desarrollo completamente modelada. La bifurcación intermedia se bifurca
para crear la tercera capa, la bifurcación de presentación. La bifurcación de
presentación contiene una capa de empresa completamente modelada donde se
definen y publican paquetes de informes.
Capítulo 8. Gestión de proyecto 275

Distribución por capas
Capa Fisica
Proyecto raiz
Las bifurcaciones se pueden crear en una capa.
Las bifurcaciones se tienen que fusionar antes
de bifurcar en el nuevo año.
bifurcación
bifurcación
Capa de desarrollo
Capa de presentación
fusionar
El modelador maestro crea el proyecto raiz.
El proyecto raiz contiene una capa física completa.
bifurcación intermedia
Modos de bifurcar un proyecto
A continuación, se indican algunos modos de dividir un proyecto:
v Por tarea y conjunto de habilidades
Puede crear bifurcaciones separadas para que una persona trabaje con esquemas
en estrella y paquetes, otra trabaje con cálculos y filtros, otra trabaje con
dimensiones y otra trabaje con consultas y denominación de objetos.
v Por capas de modelos
Puede crear bifurcaciones separadas para la capa de importación, la intermedia y
la de presentación.
v Por unidad de negocio o área funcional
Puede crear bifurcaciones separadas para las ventas y los minoristas.
v Por tipo de origen de datos
Puede crear bifurcaciones separadas para orígenes de datos relacionales,
dimensionales y ERP.
Creación de bifurcaciones
Puede crear una bifurcación en un proyecto.
La bifurcación se hace despues que la
capa física está completamente modelada.
Un modelador mejora la bifurcación
intermedia a traves de la construción
de un capa de desarollo completa.
La bifurcación está completa despues que la
capa de desarollo está completamente modelada
Un modelador mejora la bifurcación de
presentación y crea y publica paquetes
empresariales
Bifurcación de
presentación
El archivo de registro asociado con la bifurcación nueva estará vacío. Cuando cree
una bifurcación para un proyecto de solo lectura, se podrá escribir en la
bifurcación resultante.
276 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Procedimiento
1. Abra el proyecto a partir del que desea la bifurcación.
2. Pulse Proyecto, Sucursal para.
3. Escriba un nombre para el proyecto en el cuadro Nombre de proyecto.
4. En el cuadro Ubicación, escriba la ruta de la carpeta donde desea almacenar la
versión bifurcada.
Fusión de proyectos
Una bifurcación puede fusionarse de nuevo con su proyecto raíz.
Para fusionar una bifurcación de nuevo con el proyecto raíz, IBM Cognos
Framework Manager muestra una lista de las transacciones que se han realizado
en la bifurcación. Junto a cada transacción se presenta una casilla de verificación.
Para cada transacción cuya casilla de verificación esté seleccionada, Framework
Manager intenta realizar una transacción en el proyecto con el que se realiza la
fusión. Cuando una transacción finaliza correctamente, se indica con una marca de
selección y se continúa con la siguiente transacción. Si una transacción falla, se
marca con una "X" y el procesamiento se detiene.
Cuando una transacción falla, es posible que el problema pueda corregirse
inmediatamente. Por ejemplo, si falta un objeto, Framework Manager lo identifica
y solicita al usuario que lo sustituya por otro.
Una vez alcanzado el final de la lista de transacciones, puede aceptar o cancelar los
cambios. Si acepta los cambios, las transacciones finalizadas correctamente se
eliminan de la lista. Si no acepta los cambios, la lista de transacciones no se
actualiza y puede realizar la misma fusión posteriormente.
Algunos problemas no pueden resolverse durante el proceso de fusión o es posible
que haya más de una transacción relacionada con una transacción que ha tenido
errores. En estas situaciones, se pueden omitir las transacciones seleccionando la
casilla de verificación Desmarcar transacciones dependientes. Framework
Manager desmarca la casilla de verificación de todas las transacciones relacionadas
con la transacción que ha tenido errores. Cuando Framework Manager reanuda la
ejecución de la lista de transacciones, no ejecuta las transacciones que tienen las
casillas de verificación desmarcadas. Una vez alcanzado el final de la lista de
transacciones, puede aceptar los cambios, estudiar los problemas de las
transacciones que se han omitido, solucionar los errores y después realizar la
fusión de nuevo. Cuando realice la fusión de nuevo, la lista de transacciones solo
contendrá las transacciones que no se realizaron.
Nota: Antes de que se ejecute la lista de transacciones, Framework Manager
realiza una copia de seguridad del proyecto de fusión. La copia de seguridad se
almacena en el mismo directorio que el proyecto de fusión.
Procedimiento
1. Abra el proyecto con el que desea fusionar la bifurcación.
2. Pulse Proyecto, Fusionar desde.
3. En el cuadro de diálogo Seleccionar proyecto desde el que fusionar, pulse
Archivos de tipo, Todos los archivos (*.*).
4. Localice el archivo log.xml de la bifurcación que desea fusionar y pulse Abrir.
La ventana Realizar la fusión se abre con una lista de las transacciones. Se
ejecutan las transacciones que haya seleccionado.
Capítulo 8. Gestión de proyecto 277

Framework Manager solo requiere los archivos log.xml e IdLog.xml, no todo el
conjunto de archivos del proyecto para rellenar la lista del historial de
transacciones. Si no abre el archivo .cpf directamente cuando se le solicita,
Framework Manager localiza y abre el archivo log.xml. La ventaja de abrir
directamente el archivo log.xml es que se reduce el número de archivos
grandes que pueden tener que distribuirse en un entorno de varios usuarios.
5. Decida cómo ejecutar las transacciones:
v Para ejecutar la lista de transacciones sin interrupción desde el principio
hasta el final, pulse Ejecutar.
v Para ejecutar una transacción y luego pausarla, pulse Paso.
Cuando la transacción se complete, aparecerá una marca de selección o una "X"
junto a ella. Una marca de selección indica que la transacción se aplicó
correctamente al modelo con el que está realizado la fusión. Una "X" significa
que la transacción tuvo errores. En Detalles de transacción, se lista información
detallada sobre cada transacción. Si una transacción tiene errores, el proceso de
fusión se pausa.
6. Elija una de las acciones siguientes:
Objetivo Acción
Consulte: “Arreglo de transacciones que han
Arreglar una transacción con errores fallado”.
Omitir la transacción en curso y ejecutar la Pulse Omitir.
siguiente
Ejecutar la transacción en curso y pausar Pulse Paso.
Ejecutar la lista de transacciones desde la Pulse Continuar.
transacción en curso hasta el final
Aceptar las transacciones ejecutadas hasta el Pulse Aceptar.
momento y regresar a la página del proyecto
Cancelar todas las transacciones ejecutadas Pulse Revertir.
hasta el momento y regresar a la página del
proyecto
7. Realice los pasos anteriores hasta que alcance el final de la lista de
transacciones o haya aceptado o revertido los cambios.
Si acepta los cambios, se mostrarán en el Visor de proyectos. Si los revierte, no
se muestran.
8. Si acepta los cambios, guarde el proyecto en la página del proyecto. Si decide
no guardarlos, cierre el proyecto sin guardarlo.
Nota: Si acepta los cambios de la ventana Realizar la fusión, pero no guarda el
proyecto, nunca podrá realizar la fusión de nuevo. Después de aceptar las
transacciones, se eliminan de la lista de transacciones.
Arreglo de transacciones que han fallado:
Durante el proceso de combinación, pueden fallar transacciones. Se pueden
arreglar la mayoría de transacciones sustituyendo un objeto por otro. Se pueden
arreglar todas las transacciones modificando el proyecto.
278 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Caso 1
Un objeto utilizado en un proyecto de sucursal no está en el proyecto raíz. En el
cuadro de diálogo Combinar, se visualiza el cuadro Sustituir que indica el nombre
del objeto que falta en el proyecto raíz.
Para resolver este problema, puede seleccionar un objeto alternativo del proyecto
raíz del modo siguiente:
v En Visor de proyectos o Diagrama, seleccione el nombre del objeto que se debe
utilizar en lugar del objeto que falta.
En el cuadro de diálogo Combinar, el objeto se visualiza en Campo de
sustitución.
v Pulse Sustituir.
La transacción se vuelve a ejecutar, sustituyendo el objeto de sustitución para el
objeto que falta.
En problemas más complejos, se le puede solicitar que seleccione el objeto que no
se ha podido encontrar en el proyecto raíz en el cuadro de diálogo Resolución de
conflictos de nombres de objetos. Si se visualiza un aviso, no podrá resolver el
problema utilizando este cuadro de diálogo. En su lugar, puede modificar el
proyecto raíz o saltarse la transacción.
Caso 2
Para todas las transacciones que han fallado, puede resolver el problema
modificando el proyecto raíz. Primero, modifique el modelo según necesite y, a
continuación, desde el cuadro de diálogo Realizar la fusión, pulse Continuar para
ejecutar toda la lista de transacciones empezando por la transacción que ha fallado.
Caso 3
No puede arreglar la transacción. Para resolver este problema, haga lo siguiente:
v Pulse Saltar para saltar a la siguiente transacción.
v Borre la casilla de verificación para la transacción que ha fallado.
v Asegúrese de que la casilla de verificación Desmarcar transacciones
dependientes está seleccionada.
v En el cuadro de diálogo Realizar la fusión, pulse Continuar.
Proyectos segmentados y enlazados
Puede usar IBM Cognos Framework Manager para crear y enlazar segmentos,
proyectos y carpetas. Un segmento es un proyecto dentro de un proyecto principal.
Un segmento es propiedad de su proyecto principal. Un enlace es un atajo a un
proyecto existente. El proyecto que se enlaza puede ser compartido por varios
proyectos.
Un segmento de proyecto es un proyecto completo y los cambios que se realicen
en dicho proyecto influirán en todos los proyectos a los que esté enlazado. Si desea
abrir un segmento como proyecto independiente, debe estar estructurado como
proyecto completo. Debe existir una capa física en cada segmento que contenga un
subconjunto de los asuntos de consulta de orígenes de datos en los que se basan.
Estos asuntos de consulta de orígenes de datos proporcionan acceso a los datos y
metadatos y deben incluirse en los segmentos adecuados.
Capítulo 8. Gestión de proyecto 279

No cambie la capa física de un segmento. Los cambios se reflejarán en el modelo
padre enlazado y tendrán un impacto en todos los segmentos del modelo que
comparten los asuntos de consulta de orígenes de datos. Es posible que los
cambios no sean apreciables desde fuera del modelo en el que se han realizado
hasta que el modelo se cierre y vuelva a abrirse.
Antes de segmentar un proyecto, compruebe que la carpeta y el espacio de
nombres tengan nombres correctos. No puede cambiar el nombre de la carpeta ni
del espacio de nombres una vez que se haya segmentado.
Los cambios realizados en el modelo raíz, como la actualización y la definición de
la seguridad de objetos, no se heredan en el modelo segmentado. Debe aplicar los
cambios en cada segmento del modelo.
Los valores del regulador que tienen prioridad son los que hacen referencia al
modelo que está abierto (con independencia de que sea un modelo padre o hijo).
El proyecto principal tiene acceso a todo el modelo, incluidos los segmentos. Puede
realizar cambios en los segmentos mientras trabaja en el proyecto principal; no
obstante, si más de un usuario accede simultáneamente al segmento, es posible que
se pierdan las actualizaciones.
Nota: Cuando cambie la estructura del proyecto, no abra los segmentos como
proyectos individuales. En su lugar, marque el proyecto principal y realice los
cambios desde este.
Puede enlazar los segmentos a otros proyectos que contienen información
relacionada para conservar la coherencia y reutilizar la información. Si tiene la
intención de enlazar segmentos de modelo, siga los pasos de la segmentación de
proyectos. Como regla general, realice los enlaces con segmentos completos y
compruebe el modelo con regularidad.
Segmentación de proyectos
Conocer el proceso de segmentación de proyectos es vital para conseguir
estabilidad y simplificar los entornos de modelado multiusuario. Si piensa
segmentar un proyecto, debe:
v Modelar la capa física lo máximo posible; para ello:
– Compruebe que el espacio de nombres del proyecto principal y todos los
enlaces del proyecto a las carpetas tengan el mismo identificador. Consulte:
“Importación de objetos con el mismo nombre” en la página 65.
Por ejemplo: tiene un proyecto principal y un enlace en el proyecto a una
carpeta. La carpeta enlazada debe existir en un espacio de nombres que tenga
el mismo nombre que el del proyecto principal. Si los identificadores del
proyecto principal y de la carpeta enlazada no son iguales, es posible que las
relaciones, atajos o expresiones que hagan referencia a los objetos del enlace,
desde el proyecto principal, no funcionen.
– Compruebe que todos los objetos del proyecto tienen identificadores
exclusivos.
Por ejemplo, tiene un proyecto principal que contiene un asunto de consulta
denominado NewQS y un segmento en el proyecto. Abre el segmento, añade
un asunto de consulta nuevo denominado NewQS y guarda el segmento. Al
abrir el proyecto principal, se produce un error porque el asunto de consulta
denominado NewQS ya existe en dicho proyecto.
280 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

– Actualice las referencias del proyecto principal y de los segmentos del
proyecto.
Por ejemplo, tiene un proyecto principal y un segmento en el proyecto. En el
proyecto principal tiene una relación denominada qs1_qs2 que existe entre el
asunto de consulta 1yelasunto de consulta 2. El asunto de consulta 2 está en
el segmento. Abre el segmento, cambia el nombre asunto de consulta 2 por
asunto de consulta 3 y guarda el segmento. Al abrir el proyecto principal, se
produce un error porque la relación qs1_qs2 se ha roto. En Framework
Manager, también se ven afectados los objetos que se basan en una referencia,
como los atajos, los asuntos de consulta de modelos y las expresiones.
– Compruebe que el proyecto principal y todos los segmentos del proyecto
tienen el mismo idioma.
Por ejemplo, tiene un proyecto principal y un segmento en el proyecto. En el
segmento, ha definido los idiomas inglés y francés. Abre el proyecto principal,
añade el idioma chino y guarda el segmento. Al abrir el segmento, se produce
un error porque el idioma chino no está definido en el segmento.
v Organizar la capa física utilizando espacios de nombres.
Debe crear un espacio de nombres para los asuntos de consulta, los cálculos y
los filtros que cree que necesitará para más de un segmento.
Debe crear un espacio de nombres para cada colección de asuntos de consulta
que sea exclusivo de un segmento de modelo planificado.
v Aceptar el nombre de proyecto predeterminado al crear el proyecto segmentado.
El proyecto segmentado debe crearse en una subcarpeta de la carpeta de
proyecto maestra. El nombre de proyecto predeterminado es el mismo que el de
la carpeta o espacio de nombres que la contiene.
v Segmentar el modelo para cada espacio de nombres que ha creado.
v Usar el repositorio de control de origen, cuando pueda, para limitar el acceso y
realizar el seguimiento de los cambios que se realizan en sus proyectos y
segmentos.
Limitaciones de segmentar y enlazar proyectos
Las siguientes limitaciones se aplican a la segmentación y el enlace de proyectos:
v No se pueden probar objetos en un segmento o un proyecto enlazado si hacen
referencia a objetos que existen en un segmento no disponible.
v No se pueden crear nuevos objetos en un segmento o un proyecto enlazado si
hacen referencia a objetos que existen en un segmento no disponible.
v Al enlazar con un proyecto, se enlazan todos los objetos con referencias (objetos
de espacio de nombres, orígenes de datos y mapas de parámetros). Los paquetes
no se enlazan.
v Los cambios realizados en un segmento hijo no se reflejan en el proyecto
principal, ni siquiera después de renovar (F5). Esto sucede porque ya hay otro
segmento hijo enlazado con el proyecto padre o principal abierto. Cierre todos
los proyectos del segmento hijo y luego vuelva a abrir el proyecto principal.
v El punto en el que se crea un segmento en un proyecto determina el punto en el
que se puede ver el segmento. Si crea un segmento anidado desde el proyecto
principal, podrá ver el segmento anidado desde el proyecto principal. Si abre el
segmento que contiene el segmento anidado como proyecto independiente, no
podrá ver el segmento anidado. Si crea un segmento anidado desde un
segmento abierto como proyecto independiente, podrá ver el segmento anidado
desde el proyecto independiente. Si abre el proyecto principal, no podrá ver el
segmento anidado creado desde el proyecto segmentado independiente.
Capítulo 8. Gestión de proyecto 281

Creación de segmentos
Con los segmentos, se puede organizar un proyecto de acuerdo con las reglas y las
necesidades organizativas de la empresa,y compartir y reutilizar la información del
proyecto.
Puede crear segmentos en el nivel de carpetas o de espacios de nombres. Puede
crear un proyecto en una carpeta, completo con sus propios archivos de proyecto
asociados.
Cuando se crea un segmento, los mapas de parámetros existentes del proyecto
principal se copian en el nuevo segmento. Una vez que el segmento se ha creado,
los mapas de parámetros son exclusivos de cada segmento y no pueden
compartirse entre segmentos. Por ejemplo, si está trabajando en el proyecto
principal, puede utilizar un mapa de parámetros de un asunto de consulta que
pertenece a un segmento. No obstante, si abre el segmento, el mapa de parámetros
no está disponible.
Puede acceder a un segmento solo desde el proyecto en el que se creó. Por
ejemplo, si abre el proyecto principal y crea un segmento (Segmento A) y después
crea otro segmento (Segmento B) dentro del Segmento A. Desde el proyecto
principal, puede ver el Segmento A y el Segmento B, pero si abre el Segmento A
por sí mismo, no podrá ver el Segmento B.
Antes de crear segmentos, plantéese la posibilidad de dividir el proyecto en
unidades de negocio. Por ejemplo, supongamos que tiene un proyecto denominado
Ventas. Puede crear dos carpetas: una denominada Productos y la otra, Pedidos.
Puede dividir el proyecto Ventas en la carpeta Productos y en la carpeta Pedidos.
Procedimiento
1. Pulse la carpeta o espacio de nombres que desee dividir.
2. Pulse Proyecto, Crear segmento.
Puede aceptar la configuración predeterminada para el nombre del proyecto.
3. Para cambiar el nombre del segmento, en el cuadro Nombre de proyecto,
escriba otro nombre.
De este modo, no se cambia el nombre de la carpeta. Si desea cambiar el
nombre de la carpeta, debe cambiar el nombre de esta en el visor de proyectos
antes de crear el segmento.
Por cuestiones de facilidad de uso, mantenga el mismo nombre para la carpeta
y para el segmento.
4. Pulse Aceptar.
El visor de proyectos se actualiza y aparecen los iconos que representan la
carpeta segmentada o el espacio de nombres segmentado.
Creación de enlaces
Los enlaces sirven para ayudar en la organización del trabajo en proyectos
grandes, conservar la coherencia y reutilizar la información.
Por ejemplo, el proyecto denominado Inventario contiene la carpeta denominada
Productos. Puede crear un enlace desde los Productos de ventas a los Productos de
inventario. Si se realizan cambios en la carpeta Productos de inventario, aparecerán
en la carpeta Productos de ventas.
282 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Si tiene la intención de enlazar segmentos de modelo, debe seguir los pasos para la
segmentación de modelos. Para obtener más información, consulte: “Segmentación
de proyectos” en la página 280.
Un proyecto enlazado se comparte con otros proyectos. No debe crearse en un
subdirectorio en el directorio del proyecto maestro.
Antes de empezar
Debe haber creado antes el proyecto, la carpeta o el espacio de nombres para
poder enlazarlo.
Los proyectos que enlace deben tener el mismo idioma de diseño y los mismos
idiomas definidos.
Procedimiento
1. En el Visor de proyectos, pulse el proyecto, segmento, espacio de nombres o
carpeta al que se desea enlazar.
Sugerencia: Puede crear enlaces solo a carpetas, espacios de nombres,
proyectos o segmentos.
2. Pulse Proyecto, Enlazar segmento.
3. Localice y pulse el archivo .cpf del proyecto que contiene el objeto al que se
desea enlazar.
4. Pulse Abrir.
v Si el proyecto que ha seleccionado necesita una actualización, se le solicitará.
Para obtener más información, consulte: Capítulo 11, “Actualización de
modelos”, en la página 375.
v Si el proyecto utiliza una letra de unidad correlacionada, se le solicitará que
conserve la letra de unidad correlacionada o que la cambie por una ruta
UNC.
Debe seleccionar la ruta UNC si el proyecto va a compartirse con otros.
5. Elija el proyecto, segmento, espacio de nombres o carpeta para enlazar:
v Para enlazar con otro proyecto, pulse Añadir proyecto, localice el archivo
.cpf y pulse Abrir. Seleccione el proyecto y pulse Añadir.
v Para enlazar con un segmento, pulse el segmento y pulse Añadir.
6. Pulse Aceptar.
Aparece una nueva carpeta en el Visor de proyectos.
Utilidad de proyectos de solo lectura
Puede poner a disposición de otros desarrolladores proyectos de solo lectura a fin
de que puedan aprovecharlos, pero sin que puedan aplicar cambios no deseados
por el autor.
Para que un proyecto sea de solo lectura, debe cambiar las propiedades del
archivo. La interfaz de usuario cambia cuando un proyecto es de solo lectura. Los
nombres, las propiedades y las acciones aparecen en gris, lo que significa que no se
pueden realizar modificaciones.
Procedimiento
1. Cree un recurso compartido para alojar el proyecto que va a protegerse.
2. Dé al recurso compartido acceso de solo lectura para los desarrolladores que
quieran aprovechar el proyecto.
Capítulo 8. Gestión de proyecto 283

Control de repositorio externo
Puede utilizar IBM Cognos Framework Manager con un sistema de control de
código fuente externo. Este procedimiento explica cómo colocar los archivos del
proyecto de Framework Manager en un repositorio externo. Puede trabajar en el
proyecto en Framework Manager y el repositorio externo puede gestionar el
control de versiones de los archivos del proyecto.
Para utilizar un sistema de control de código fuente externo, realice las acciones
siguientes:
v Compruebe que el proyecto esté cerrado.
v Suprima el archivo repository.xml, si existe.
v Añada todos los archivos que existen en el directorio del proyecto al repositorio
externo.
El directorio del proyecto es el directorio que contiene el archivo nombre de
proyecto.cpf.
v Reserve los archivos del proyecto del repositorio externo.
v Trabaje en el proyecto en Framework Manager.
v Guarde los cambios.
v Incorpore los archivos en el repositorio externo.
Segmentación de proyectos
Administración de metadatos
Puede crear un segmento para un proyecto que esté almacenado en un repositorio
externo. Los segmentos son directorios de proyecto que se almacenan en el
directorio de proyecto principal. Conserve la misma jerarquía en el repositorio que
en el directorio del proyecto.
Los segmentos también pueden abrirse individualmente como proyectos
autónomos.
Un segmento también puede abrirse como parte del proyecto principal. En este
caso, debe reservar el proyecto para cada segmento que desee modificar.
Puede cambiar los metadatos de los modelos para que cumplan sus objetivos de
modelado específicos.
Puede hacer lo siguiente:
v Copiar, mover, cambiar de nombre o suprimir los proyectos para organizarlos de
modo intuitivo para el entorno de creación de informes.
v Analizar los cambios realizados en un modelo para ver cómo afectan a los
paquetes y a los informes que utilizan el modelo.
v Reasignar un objeto a un nuevo origen.
v Exportar el modelo para intercambiar metadatos entre las diferentes
herramientas y repositorios del almacén de datos.
v Reutilizar el mismo modelo y los mismos informes con diferentes conjuntos de
datos.
v Mover un modelo de una base de datos relacional a otra.
284 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Copiar, mover, renombrar o suprimir proyectos
Los proyectos deben organizarse de una forma significativa que permita
localizarlos fácilmente. Dentro de IBM Cognos Framework Manager, puede copiar,
mover, renombrar y suprimir proyectos.
Puede gestionar sus proyectos segmentándolos o enlazándolos. Estas características
de gestión de proyectos ayudan a organizar un proyecto en función de las reglas
de negocio y las necesidades organizativas, establecer opciones de procesamiento
en tiempo de ejecución y dar acceso a otros usuarios a secciones del proyecto. Para
obtener más información, consulte: “Creación de segmentos” en la página 282 y
“Creación de enlaces” en la página 282.
También puede identificar las funciones específicas de proveedor que desea utilizar
para cada origen de datos que importe al proyecto. Para obtener más información,
consulte: “Selección de conjuntos de funciones” en la página 316
Si el proyecto está segmentado, los segmentos se tratan como proyectos
independientes. Si guarda o copia un proyecto dentro de otro proyecto existente, se
tratará como un segmento.
Copia de proyectos
Cuando se copia un proyecto, se crea una réplica de dicho proyecto en otro lugar.
Todos los archivos de la carpeta del proyecto, incluidas las subcarpetas, se copian
en una nueva ubicación. Cuando se realizan cambios en el proyecto de una
carpeta, estos cambios no se reflejan en las copias del proyecto guardadas en otras
carpetas.
Copiar un modelo segmentado copia todos los segmentos así como el proyecto
principal.
A veces, no se puede copiar un proyecto; en ese caso, debe utilizarse Guardar
como. Si se guarda el proyecto con un nombre nuevo se crea una carpeta de
proyecto mientras que si se guarda el proyecto con el nombre existente se
sobrescribe el proyecto actual. Esto es útil para guardar los cambios realizados en
un proyecto de solo lectura o si desea guardar un proyecto con un nombre
diferente o en una nueva ubicación sin sobrescribir el proyecto original.
No se puede crear una copia de un proyecto en la misma carpeta que el original. Si
copia un proyecto en una carpeta de proyecto existente, Framework Manager lo
trata como un segmento de proyecto. Para obtener más información, consulte:
“Proyectos segmentados y enlazados” en la página 279.
Si un proyecto o segmento está abierto cuando se copia, se copia la última versión
guardada.
Procedimiento
1. Pulse Archivo, Gestionar proyectos, Copiar.
2. En el cuadro Desde pulse el botón Examinar y seleccione el archivo .cpf del
proyecto que desea copiar.
Nota: El nombre de la carpeta del proyecto se muestra en el cuadro de texto.
3. En el cuadro Hasta, escriba el nombre del proyecto.
De forma predeterminada, el nombre del proyecto y el directorio donde se
guarda el proyecto son iguales.
Capítulo 8. Gestión de proyecto 285

4. En el cuadro Ubicación, escriba la nueva ubicación o pulse el botón Examinar y
seleccione la nueva ubicación del proyecto.
5. Pulse Aceptar.
Traslado de proyectos
Puede decidir mover un proyecto porque la carpeta está tan llena que es difícil
localizar determinados proyectos. Cuando se mueve un proyecto, en realidad, se
copia en una nueva carpeta y se elimina de la carpeta actual. Todos los archivos de
la carpeta del proyecto, incluidas las subcarpetas, se mueven a una nueva
ubicación.
Mover un modelo segmentado mueve todos los segmentos así como el proyecto
principal.
Para poder mover un proyecto, este debe estar cerrado en Framework Manager.
Procedimiento
1. Pulse Archivo, Gestionar proyectos, Mover.
2. En el cuadro Desde, pulse el botón Examinar y seleccione el archivo .cpf del
proyecto que desea mover.
Nota: El nombre de la carpeta del proyecto se muestra en el cuadro de texto.
3. En el cuadro A, escriba la nueva ubicación o pulse el botón Examinar y
seleccione la nueva ubicación del proyecto.
4. Pulse Aceptar.
Cambio de nombre de los proyectos
Cuando se cambia el nombre del proyecto, se proporciona un nombre nuevo para
el archivo .cpf. No se cambia la ubicación del proyecto. Los archivos de proyecto
secundarios y los archivos de registro conservan su nombre original.
Si un proyecto se muestra en la lista de proyectos recientes en la página
Bienvenidos de Framework Manager y procede a cambiar su nombre, no podrá
abrir el proyecto pulsando en el enlace. Deberá abrir el proyecto con el comando
Abrir del menú Archivo.
Para poder cambiar el nombre de un proyecto, este debe estar cerrado en
Framework Manager.
Procedimiento
1. Pulse Archivo, Gestionar proyectos, Cambiar nombre.
2. En el cuadro Desde, pulse el botón Examinar y seleccione el archivo .cpf del
proyecto cuyo nombre desea cambiar.
Nota: El nombre de la carpeta del proyecto se muestra en el cuadro de texto.
3. En el cuadro A, escriba el nombre nuevo del proyecto y pulse Aceptar.
Si la carpeta del proyecto original y el archivo .cpf tienen el mismo nombre, se
cambia el nombre de la carpeta y del archivo .cpf.
Supresión de proyectos
Cuando se suprime un proyecto, la carpeta del proyecto y todo su contenido se
suprimen del sistema de archivos y se envían a la papelera de reciclaje.
286 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Si el proyecto está segmentado y se suprime el proyecto principal, los segmentos
también se suprimen. Suprimir un segmento de proyecto suprime solo el segmento
y no el modelo en el que se basa.
Como regla general, suprima los segmentos del modelo. Si suprime el segmento
con la opción Suprimir del menú Archivo, se muestra como si el segmento todavía
existiese en el modelo. Para obtener más información, consulte: “Proyectos
segmentados y enlazados” en la página 279.
Para poder suprimir un proyecto, este y sus segmentos deben estar cerrados.
Framework Manager no soporta un mecanismo de bloqueo de archivos de modo
que, en determinadas circunstancias, puede suceder que se suprima un proyecto
con segmentos abiertos. Si suprime un proyecto con segmentos abiertos, estos ya
no se podrán salvar.
Procedimiento
1. Pulse Archivo, Gestionar, Proyectos, Suprimir.
2. En el cuadro Carpeta de proyecto, pulse el botón Examinar y seleccione el
archivo .cpf del proyecto que desee suprimir.
Nota: El nombre de la carpeta del proyecto se muestra en el cuadro de texto.
3. Pulse Aceptar.
La carpeta y todo su contenido se suprimirá.
Análisis del impacto de los cambios en los paquetes
Antes de publicar los paquetes y ejecutar los informes, puede ver cómo afectarán
al paquete y a los informes que lo usan los cambios realizados en un modelo.
Puede localizar los cambios que se han realizado en el paquete y ver los detalles
sobre cada cambio y qué informes se han visto afectados por un cambio
determinado.
Los informes que se han creado usando el paquete pueden verse afectados por los
cambios que se hayan realizado en el modelo. Por ejemplo, la adición de objetos
nuevos en un paquete no afecta a los informes. El cambio del nombre de un
elemento de consulta afecta a un informe. La definición del informe no será válida
si el elemento de consulta no está en la definición del paquete. Si utiliza la función
de modelo duradero, puede evitar que los informes se vean afectados por un
cambio en los nombres de los elementos de consulta. Para obtener más
información, consulte: “Modelos duraderos” en la página 184.
Nota: Puesto que los informes utilizan paquetes publicados, si realiza cambios en
el modelo, pero no publica el paquete que lo usa, el informe no se ve afectado por
los cambios.
Si cambia el nombre de un objeto, se muestra como "modificado" en el resultado
del análisis.
El análisis se realiza en los objetos que el modelo utiliza directamente, así como en
los objetos subyacentes. Por ejemplo, suponga que tiene un asunto de consulta de
modelo que se basa en un asunto de consulta de orígenes de datos. Si cambia el
asunto de consulta de modelo, se mostrará como un objeto modificado. Si cambia
el asunto de consulta de orígenes de datos, también se mostrará como un objeto
modificado.
Capítulo 8. Gestión de proyecto 287

Se analizan los siguientes tipos de objetos: asuntos de consulta, elementos de
consulta, medidas, dimensiones regulares, dimensiones de medida, jerarquías,
niveles, filtros autónomos y cálculos autónomos.
Procedimiento
1. En el Visor de proyectos, pulse un paquete que se haya publicado.
2. Pulse Acciones,Paquete, Analizar el impacto de la publicación.
3. Elija la acción que desea realizar:
Objetivo Acción
Ver las dependencias de un informe Consulte: “Localización de dependencias de
informe”.
Ver las dependencias de un objeto Consulte: “Cómo mostrar dependencias de
objetos” en la página 289.
Ver los detalles de un objeto Pulse la fila que contiene el objeto.
Los detalles del objeto se muestran debajo
de Cambiar detalles de.
Localizar un objeto en el Visor de proyectos En la fila que contiene el objeto, debajo de
Acciones, pulse Buscar en vista de proyecto.
Ordenar los resultados Pulse Ordenar en la parte superior de la
columna.
Mostrar los comentarios del modelador, el Pulse la flecha hacia abajo doble.
autor del último cambio y la fecha de la
última modificación
4. Pulse Cerrar.
Localización de dependencias de informe
Puede localizar los informes que utiliza un objeto.
Procedimiento
1. En el cuadro de diálogo Analizar el impacto de la publicación, realice una de
las acciones siguientes:
v Seleccione cada uno de los objetos para los que desee determinar las
dependencias de informe seleccionando sus casillas de verificación.
v Para seleccionar todos los objetos, seleccione la casilla de verificación situada
sobre la columna de casillas de verificación.
2. Pulse Buscar dependencias de informe.
3. Especifique el alcance de la búsqueda:
Objetivo Acción
Buscar en todas las carpetas Pulse Todas las carpetas.
Limitar la búsqueda a una carpeta
Pulse Búsqueda restringida (examinar y
determinada
seleccionar una carpeta). Escriba el nombre
de la carpeta o pulse la pestaña Examinar
para buscar una carpeta.
4. Pulse Buscar.
Aparece una lista de nombres de informe en la ventana Dependencia de
informe debajo de Informes afectados. Los resultados muestran las
288 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

dependencias directas y las indirectas. Los nombres de los objetos que afectan
indirectamente a los informes se muestran en un color más claro.
5. Para ordenar los resultados, pulse Ordenar en la parte superior de la columna.
6. Pulse Cerrar.
Cómo mostrar dependencias de objetos
Puede encontrar objetos que dependen de otros objetos o mostrar dependencias de
un objeto hijo.
No se pueden mostrar dependencias de los mapas de parámetros.
Procedimiento
1. En el Visor de proyectos, pulse un objeto.
2. Pulse Herramientas, Mostrar dependencias de objetos.
Los objetos que dependen del objeto seleccionado se muestran en Objetos
dependientes.
3. Para mostrar el identificador de objeto de los objetos dependientes, seleccione
la casilla de verificación Mostrar ID de objeto.
4. Si el objeto tiene hijos y desea ver las dependencias de un objeto hijo, pulse el
signo más (+) situado junto al objeto que contiene el objeto hijo.
5. Pulse un objeto hijo situado debajo de un objeto padre.
Los objetos que dependen del objeto hijo se muestran en Objetos
dependientes.
6. Opcional: También puede mostrar las dependencias de objeto del siguiente
modo:
v En el Visor de proyectos, pulse con el botón derecho en un objeto y
seleccione Mostrar dependencias de objetos.
v En la ventana Explorador de contexto, pulse con el botón derecho en un
objeto y seleccione Mostrar dependencias de objetos.
v En la ventana Analizar el impacto de la publicación, pulse el icono Mostrar
dependencias en Acciones en la fila que contiene el objeto.
Recorrelación de objetos con nuevos orígenes
Durante el ciclo de vida del modelo de IBM Cognos Framework Manager, puede
ser necesario cambiar el origen de datos que se utiliza. Por ejemplo, le puede
resultar útil utilizar el modelo con una base de datos diferente con los mismos
datos, migrar el modelo de un esquema transaccional a un esquema en copo de
nieve o en estrella o sustituir una base de datos existente, o importar una vista con
una nueva vista. Todas estas acciones pueden afectar a los informes. Por ejemplo,
si cambia los nombres de los objetos, los informes pueden dejar de ser válidos.
Puede minimizar el efecto de los cambios del modelo y los cambios de los orígenes
de datos recorrelacionando los objetos del modelo de nivel superior para que sigan
ejecutándose y devuelvan los datos correctos. Cuando se recorrelaciona, se
comparan y sustituyen nombres o referencias de objetos de un objeto original con
los nombres o referencias de objetos de otro objeto. Puede recorrelacionar
elementos de consulta y medidas. Puede recorrelacionar manualmente objetos
individuales o puede recorrelacionar varios objetos a la vez. Cuando se
recorrelacionan varios objetos, Framework Manager compara los elementos del
objeto original con los elementos de otro objeto utilizando los criterios coincidentes
que se hayan especificado. Solo se recorrelacionan los objetos que cumplen los
Capítulo 8. Gestión de proyecto 289

criterios coincidentes. Puede utilizar el nombre o la referencia de objeto como
criterio coincidente para el original y el otro objeto.
Cuando se cambian los criterios coincidentes para la recorrelación, se están
definiendo los criterios que se utilizarán para recorrelacionar los objetos
subsiguientes.
Si un asunto de consulta de modelo o dimensión de modelo contiene un filtro o un
cálculo, el filtro o cálculo de modelo también se recorrelacionan cuando se
recorrelacionan el asunto de consulta de modelo o la dimensión de modelo. No
aparece ningún mensaje ni aviso que alerte de que esto sucede.
Valide todos los informes afectados siempre que realice cambios en el modelo. Para
identificar los informes afectados, consulte: “Cómo mostrar dependencias de
objetos” en la página 289 y “Localización de dependencias de informe” en la
página 288.
No se pueden recorrelacionar asuntos de consulta de orígenes de datos ni
dimensiones de origen de datos. La recorrelación solo se soporta cuando se utiliza
el entorno local de diseño del modelo.
Procedimiento
1. En el Visor de proyectos, pulse con el botón derecho en un objeto y pulse
Recorrelacionar con origen nuevo.
2. Si desea cambiar los criterios coincidentes, pulse Opciones y realice las acciones
siguientes:
v Elija el criterio coincidente del objeto que está utilizando para la recorrelación
y para el objeto original que está recorrelacionando.
Puede comparar los objetos por el nombre o por referencia al objeto.
v Las opciones del criterio predeterminado son Por nombre para el objeto que
se utiliza para la recorrelación y Por referencia de objeto para el objeto
original que está recorrelacionando.
v Pulse Aceptar.
v Para utilizar los criterios especificados, seleccione la casilla de verificación
Utilizar opciones de criterio coincidentes.
Si el criterio coincidente es de Por nombre a Por nombre, se eliminan los
espacios de la cadena.
Si no hay referencia de objeto se utiliza el nombre de objeto.
3. Realice una de las acciones siguientes:
Objetivo Acción
Recorrelacionar manualmente un objeto
determinado
290 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario
En Objetos de modelo disponible, arrastre
un objeto al objeto que desea recorrelacionar
a Elementos de consulta, Medidas, Cálculos
y Filtros.
El nuevo valor para el objeto se muestra en
Recorrelacionar con.

Objetivo Acción
Recorrelacionar automáticamente varios
objetos
En Objetos de modelo disponible, arrastre
un asunto de consulta a cualquier fila de
Elementos de consulta, Medidas, Cálculos y
Filtros.
Todos los objetos que cumplan los criterios
coincidentes se recorrelacionarán y sus
valores se mostrarán en Recorrelacionar con.
Cambiar la expresión de un objeto Pulse el botón de puntos suspensivos (...)
situado junto al objeto. Para obtener más
información sobre cómo crear una expresión,
consulte: “Creación de cálculos” en la página
150.
Restaurar un valor de recorrelación con su
valor de origen original
Borrar el valor de recorrelación y el valor
original para el objeto seleccionado
Borrar el valor de recorrelación para todos
los objetos
Pulse con el botón derecho en la fila que
contiene el objeto que desea restaurar y
seleccione Restaurar a valor original.
Pulse la fila que contiene el objeto y pulse
Borrar.
Pulse Borrar todo.
4. Pulse Aceptar cuando haya finalizado la recorrelación.
Exportación de metadatos
Puede exportar el modelo de IBM Cognos Framework Manager como un archivo
CWM (Common Warehouse Metamodel). CWM intercambia metadatos entre las
diferentes herramientas y repositorios del almacén de datos. Cada instancia de
metamodelo CWM se intercambia utilizando documentos XMI (intercambio de
metadatos XL).
Cuando se exporta un modelo de Framework Manager como archivo CW
(Common Warehouse Metamodel), las uniones, las carpetas, los espacios de
nombres, las solicitudes y los cálculos no se exportan. Solo se exportan los asuntos
de consulta, los elementos de consulta y las funciones.
Cuando exporte a CWM, utilice las opciones predeterminadas, que optimizan la
exportación de metadatos. Cambie estas opciones solo si usted dispone de
información especifica que afecte a su exportación. Para obtener más información
sobre las opciones de exportación, consulte el sitio web de Meta Integration.
No utilice caracteres japoneses en la ruta de exportación.
Procedimiento
1. Pulse con el botón derecho en el espacio de nombres raíz de los metadatos que
desea exportar y pulse Exportar modelo.
Se le solicitará que guarde el proyecto.
2. Seleccione el destino de exportación.
3. En el cuadro de diálogo Opciones de exportación específicas de Framework
Manager, pulse las opciones que desee.
Capítulo 8. Gestión de proyecto 291

Nota: Como regla general, utilice las opciones predeterminadas. Estas opciones
optimizan la importación de metadatos. Si cambia las opciones, pueden
producirse resultados imprevistos. Para revertir a las opciones predeterminadas,
pulse Usar valores predeterminados.
4. Pulse Siguiente.
5. En el cuadro de diálogo Opciones de exportación específicas de terceros,
utilice la opción Archivo para identificar el archivo que debe contener los
metadatos exportados.
Pulse el resto de las opciones que desee.
En el panel Descripción de la opción, verá una descripción de las opciones
disponibles. Las opciones se basan en el origen de datos seleccionado. Para
obtener más información, consulte la documentación del proveedor del origen
de datos.
6. Pulse Siguiente.
Se muestran los resultados de validación de entrada del proceso de
exportación.
7. Pulse Siguiente, Finalizar.
Reutilización de proyecto
Es posible que tenga que utilizar el mismo modelo y los mismos informes con
diferentes conjuntos de datos reales. Los conjuntos de datos pueden ser diferentes
bases de datos, cuentas o esquemas de una única base de datos.
Puede encontrar varios conjuntos de datos en las siguientes situaciones:
v Cuando utiliza un conjunto de datos diferente al utilizado en producción.
v En grandes empresas, donde cada división tiene su propio conjunto de datos.
v En aplicaciones de OEM que no tienen control directo sobre los datos del cliente.
Las tablas y columnas utilizadas por el proyecto lógicamente deben ser las mismas
en todos los conjuntos de datos. También debe asegurarse de que se identifica el
conjunto de datos correcto en cada caso.
Los orígenes de datos en IBM Cognos Framework Manager contienen información
que identifica la ubicación de las tablas de origen de datos que se puedan necesitar
para los asuntos de consulta. Esta información es el nombre del origen de datos en
el almacén de contenido, así como los nombres de esquema y de catálogo
opcionales. Asegúrese de que los nombres de esquema y de catálogo utilizan el
conjunto de datos deseado.
Si hay diversos almacenes de contenido en uso y se despliega una versión distinta
del proyecto para cada almacén de contenido, puede especificar la información de
origen de datos del proyecto para cada sitio. Si sólo tiene un almacén de
contenido, puede publicar cada proyecto como un paquete distinto. Estas
soluciones requieren mucho mantenimiento manual. Para reducir este nivel de
mantenimiento, puede utilizar una de las opciones que se indican a continuación.
Determinación de la información del origen de datos
La solución más sencilla consiste en determinar el nombre del origen de datos en
el almacén de contenido, el nombre del catálogo, si procede, y el nombre del
esquema de la base de datos. Luego podrá utilizar esos nombres en todos los
conjuntos de datos.
292 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Si algunos conjuntos de datos utilizan el mismo almacén de contenido, cree una
conexión distinta para cada conjunto de datos en un único almacén de contenido.
Para obtener más información, consulte la publicación IBM Cognos Guía de
administración y seguridad. Para obtener información acerca de cómo Framework
Manager maneja varias conexiones, consulte: “Varias conexiones de origen de
datos” en la página 41.
El nombre del origen de datos en el almacén de contenido puede diferir del
nombre de la base de datos del cliente, por lo que esta solución ofrece mucha
flexibilidad. Sin embargo, aún requiere que los nombres de catálogo y de esquema
sean idénticos en todos los conjuntos de datos. Incluso aunque todos los conjuntos
de datos utilicen el mismo tipo de base de datos, esto puede resultar difícil de
garantizar. Y si intervienen diferentes tipos de base de datos, puede resultar
imposible. Por ejemplo, SQL Server tiene un nivel de catálogo, pero Oracle no.
Utilización de identificación del conjunto de datos
predeterminado basada en el usuario
Cada usuario de base de datos tiene acceso a un catálogo y un esquema
predeterminados, si procede. Si el esquema y el catálogo no están definidos, o si
están en blanco en el origen de datos del proyecto de Framework Manager, se
utilizan los valores predeterminados. Como en la solución anterior, esta opción
puede combinarse con múltiples conexiones, de modo que diferentes usuarios
puedan utilizar diferentes bases de datos para el mismo origen de datos.
Sin embargo, al editar un asunto de consulta, IBM Cognos Framework Manager
utiliza los nombres de catálogo y de esquema de los orígenes de datos para
establecer una coincidencia con los elementos arrastrados a las ventanas SQL desde
el árbol de origen de datos. Por este motivo los nombres de catálogo y de esquema
no pueden estar en blanco en el origen de datos del proyecto mientras se realiza el
modelado.
Por lo tanto, deberá utilizar una expresión de macro en el catálogo y el esquema
de cada origen de datos del proyecto. Esto garantiza que los nombres de catálogo
o de esquema están en blanco en tiempo de ejecución, pero establece
explícitamente el catálogo o el esquema que desea durante el modelado.
Pasos para definir explícitamente un catálogo o un esquema
Procedimiento
1. Cree un parámetro de sesión único cuyo valor identifique si se encuentra en
modo de diseño. Cuando esté en modo de diseño, defina el valor de este
parámetro de sesión con un valor determinado, como por ejemplo, diseño. O
bien, deje el valor vacío.
Sugerencia: Si utiliza un proyecto o reemplaza un valor, debe definirlo cada
vez que abre el modelo para su edición.
2. Para cada catálogo y esquema de cada origen de datos del proyecto, cree un
mapa de parámetros que contenga:
v Un valor predeterminado vacío.
v Una clave cuyo nombre sea el valor de diseño del parámetro de sesión
anterior y cuyo valor sea el nombre del esquema o catálogo de modo de
diseño de dicho origen de datos.
3. Seleccione el origen de datos y sustituya los valores de la propiedad de
catálogo o esquema con una macro que utilice el mapa de parámetros
correspondiente y el parámetro de sesión.
Capítulo 8. Gestión de proyecto 293

Por ejemplo, utilice:
#$DBSchemaName ($DeployOrDesign) #
Portabilidad de modelos
Puede utilizar un modelo de IBM Cognos Framework Manager para acceder a
datos de diversas instancias de bases de datos. las instancias de bases de datos
pueden ser del mismo o de diferentes proveedores.
Hay varios aspectos que se deben tener en cuenta cuando se traslada un modelo
de Framework Manager de una base de datos relacional a otra. A diferencia de los
que ocurre cuando se cambia de una base de datos idéntica a otra en la misma
plataforma, en este caso es posible que cambiar la información de conexión de
origen de datos no sea suficiente.
Examine la generación de determinantes y relaciones basadas en índices y no dé
por supuesto que los índices describen fielmente las dependencias funcionales o las
relaciones para la creación de informes.
Se importan funciones escalares en un modelo prefijado por una calificación de
catálogo o esquema en la sentencia SQL. Al igual que ocurre con las tablas y las
vistas, puede ser necesario eliminar o alterar la calificación de ubicación cuando
cambie de proveedores. Por ejemplo, si crea un modelo para una base de datos
ORACLE y la conexión se cambia para que señale a una base de datos de SQL
Server, se producirá un error porque el tipo de origen de datos del modelo sigue
siendo OR en lugar de cambiar al tipo de origen de datos adecuado.
Para mover un modelo de una base de datos relacional a otra, realice estas
acciones:
v Evalúe el lenguaje de definición de datos (DDL) para determinar la portabilidad
de los nombres físicos del siguiente modo:
– Limite los nombres físicos a un mínimo denominador común, como 31
caracteres.
– Evite el uso de palabras clave reservadas en la documentación ANSI estándar
y del proveedor.
– Evite el uso de campos de datos específicos del proveedor.
– Evite las conversiones.
– Confirme que todos los proveedores soportan la precisión y la escala.
– Utilice ordenaciones coherentes y compatibles.
– Utilice mayúsculas o minúsculas de forma coherente en los nombres, por
ejemplo todos en minúsculas.
v Evalúe el DDL para determinar la portabilidad de la calificación de la base de
datos.
v Evalúe el DDL para determinar la portabilidad de los tipos de datos en relación
con la compatibilidad y la precisión y escala de los tipos de datos.
v Repase todas las sentencias SQL nativo de sus modelos e informes en busca de
sintaxis de tipo relacional que pueda no estar soportada.
v Repase el uso de funciones específicas del proveedor.
Es posible que no haya una función de proveedor equivalente o común. Una
función común que no esté soportada en la base de datos relacional puede
generar un procesamiento local que no se producía anteriormente.
v Revise el tipo de propiedades del origen de datos.
294 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Si cambia el RDBMS que utiliza, como Oracle o SQL Server, cambie la propiedad
de tipo del origen de datos en Framework Manager.
v Actualice las consultas del origen de datos.
Cuando se importan tablas, Framework Manager importa información física
sobre las tablas y las columnas que se utilizan internamente en el tiempo de
ejecución. Por ejemplo, la información de ordenación se concilia solo al volver a
crear las tablas físicas.
v Pruebe el modelo que ha movido.
Habrá otras diferencias, como las características de rendimiento o cómo se
ordenan los datos en función de las ordenaciones, que solo se descubrirán en las
pruebas.
Traslado de modelos a diferentes entornos utilizando archivos
de registro
En IBM Cognos Framework Manager, puede visualizar y reproducir acciones
ejecutadas en el proyecto o puede utilizar Script Player para reproducir
transacciones en modo de proceso por lotes. Un registro de acción es un archivo
XML que contiene un conjunto de transacciones. Cada transacción tiene un número
de secuencia y una o más acciones. Cada acción consta de un nombre y parámetros
de entrada. Algunas acciones también tienen parámetros de salida. El archivo de
registro de acción está en la carpeta del proyecto.
Por ejemplo, realiza modificaciones en un proyecto en un entorno de prueba. En el
momento de trasladar el proyecto a producción, puede utilizar los archivos de
registro para reproducir cada acción, o series de acciones, que ejecutó en el entorno
de prueba para crear un proyecto idéntico en el entorno de producción.
Hay dos archivos de registro de acción. El archivo log.xml contiene todas las
transacciones que se han ejecutado y guardado en el proyecto. Este archivo se crea
la primera vez que guarda el proyecto y existe hasta que suprima el proyecto. El
archivo temporal contiene transacciones que se han ejecutado durante la sesión
actual, pero no se han guardado. El archivo temporal se suprime al cerrar el
proyecto.
Nota: Si el script tiene dependencias del proyecto existente, deberá asegurarse de
que el proyecto esté alineado con las transacciones del script para garantizar los
resultados deseados.
Un archivo de registro grande puede afectar al rendimiento. Puede archivar
entradas en archivos de registro para reducir sus tamaño.
Visualización y almacenamiento del historial de transacciones:
Puede ver el historial de transacciones en el archivo de registro de acción y
guardarlo como script.
Procedimiento
1. Pulse Proyecto, Ver historial de transacciones.
Sugerencia: Para agrandar el cuadro de diálogo, efectúe una doble pulsación en
el título. Efectúe una doble pulsación de nuevo para devolver al cuadro de
diálogo su tamaño original.
2. Pulse los números de transacción que desee.
Sugerencia: Para ver los detalles de una transacción, pulse el signo más (+)
situado junto a un número de transacción.
Capítulo 8. Gestión de proyecto 295

3. Pulse Guardar como script.
4. Escriba un nombre para el archivo.
5. Pulse Guardar. No guarde el archivo en la carpeta logs.
6. Pulse Cerrar.
Reproducir transacciones a partir de un archivo de registro:
Puede reproducir una transacción determinada o una combinación de transacciones
en un proyecto o archivo de registro de acción de segmento.
Cuando se reproducen transacciones a partir de un archivo de registro, el
reproductor de scripts aplica los comandos del archivo de registro al contenido del
modelo existente. Se muestran errores si los objetos creado por el archivo de
registro ya existen en el modelo.
Una vez que el script del archivo de registro se ha ejecutado correctamente, se crea
una copia de seguridad del proyecto original en el directorio padre del proyecto. Si
desea deshacer las transacciones realizadas en el script, puede utilizar la copia de
seguridad para restaurar el proyecto y devolverle su estado original.
Debe inhabilitar o borrar los comandos que estén en conflicto con el contenido del
modelo. Después, puede ejecutar el script de nuevo. O puede utilizar el comando
sincronizar, que empieza con un modelo vacío.
Si genera un script propio externo a Framework Manager, las indicaciones de fecha
y hora deben ser en orden ascendente y sin duplicados.
Procedimiento
1. Pulse Proyecto, Ejecutar script.
2. Seleccione el script que desee y pulse Abrir.
3. Si desea ver los detalles de una transacción, pulse la transacción.
4. Defina el punto de inicio o detención que desee.
v Para definir un punto de inicio para ejecutar el script, seleccione el script y
pulse Establecer el punto de partida. Puede hacerlo cuando desee para
omitir una instrucción o ejecutar instrucciones que ya se han ejecutado .
v Para definir un punto de detención para le script, seleccione el script y pulse
Establecer el punto de detención .
Puede detener el script para realizar un arreglo manual y, después,
reanudarlo.
Sugerencia: Para eliminar el punto de detención, pulse Eliminar el punto de
detención .
5. Con los botones de la barra de herramientas, elija la acción que desee que se
ejecute.
Botón Descripción
Ejecuta el script.
296 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario
Si se detecta un error, puede pulsar en este botón para intentar
volver a ejecutar la instrucción fallida.
Salta a la siguiente transacción y ejecuta el script hasta el final.

Botón Descripción
Ejecuta solo la transacción seleccionada.
Salta a la siguiente transacción y se detiene, pero no ejecuta
ninguna transacción.
La ventana del proyecto se actualiza y el script se ejecuta.
6. Solucione los errores que encuentre el script ya sea destinando los objetos a
otros destinos o modificando el proyecto temporalmente, según sea necesario.
Para obtener más información, consulte: “Arreglo de errores causados por
objetos no válidos” en la página 300.
7. Cuando el script se haya completado, pulse Aceptar pata aceptar los cambios o
pulse Revertir para deshacer los cambios.
Nota: Después de pulsar en Aceptar o Revertir, no puede utilizar Deshacer y
Rehacer para la sesión actual.
Ejecución de registros de acción en modo de proceso por lotes:
Utilización del reproductor de script:
Sintaxis
En el indicador de comandos, asegúrese de navegar hasta la ubicación de
instalación de BmtScriptPlayer.exe.
Utilice la siguiente sintaxis para ejecutar el reproductor de script:
BmtScriptPlayer [-c|-m] [-a ][options]
donde es el nombre del proyecto y es el nombre
del registro de acción.
Por ejemplo,
BmtScriptPlayer -m goSales.cpf -a import.xml
Opciones
Puede especificar cómo se ejecuta el reproductor de script con las siguientes
opciones.
Nota: Si trabaja en un entorno UNIX, puede crear un script para ocultar las
credenciales que se pasan en la línea de comandos.
Opción Descripción
-a FILEPATH
Aplica el registro de acción especificado.
FILEPATH es la ruta, que incluye el nombre
de archivo, para el archivo de registro de
acción.
Capítulo 8. Gestión de proyecto 297

Opción Descripción
-b NUM
-c FILEPATH
-e NUM
-g
-k DIRECTORY
-m FILEPATH
-n
-p PASSWORD
298 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario
Ejecuta transacciones con el número de
secuencia igual o superior al número
especificado por NUM.
El valor predeterminado es la primera
transacción.
Crea un proyecto nuevo.
FILEPATH es la ruta, que incluye el nombre
de archivos, para el archivo del proyecto de
modelos (.cpf).
Cuando se utiliza esta opción sin especificar
un registro de acción, se crea un modelo
vacío.
Nota: Si el modelo especificado en
FILEPATH ya existe, se sustituye
silenciosamente.
Ejecuta las transacciones con el número de
secuencia igual o inferior al número
especificado por NUM.
Si no se especifica la opción, la ejecución
finaliza en la transacción con el número de
secuencia más alto o el número de
transacción 9999, la que aparezca antes. Se
debe utilizar esta opción para los registros
de acción que contienen transacciones con
números de secuencia 10.000 y superiores.
Actualiza el modelo (si es necesario).
Si no se especifica esta opción y el modelo
se ha creado con una versión anterior, la
ejecución termina.
Si especifica esta opción sin especificar un
registro de acción, solo se realiza la
actualización del modelo.
Especifica el directorio de instalación.
Abre un proyecto existente.
FILEPATH es la ruta, que incluye el nombre
de archivos, para el archivo del proyecto de
modelos (.cpf).
No guarda el modelo.
Esta opción se puede utilizar para probar
archivos de registro de acción.
Realiza la autenticación utilizando la
contraseña especificada (si es necesario).

Opción Descripción
-s NAMESPACE
-t DIRECTORY
-T PASSPORT
-u USER
-x
-y PASSPORT
Ejemplos
Realiza la autenticación utilizando el espacio
de nombres especificado (si es necesario).
Especifica el directorio de plantillas.
Especifica un pasaporte de seguridad. Un
pasaporte es una cadena cifrada utilizada
para permitir conversaciones seguras para
los conectores que lo necesiten.
Realiza la autenticación utilizando el nombre
de usuario especificado (si es necesario).
Termina la ejecución de la prueba cuando se
produce un error de transacción.
De forma predeterminada, el reproductor de
script solo termina con errores graves como,
por ejemplo, un modelo o un registro de
acción no válidos, y continúa con la
ejecución aunque fallen algunas
transacciones secundarias.
Realiza la autenticación utilizando el
pasaporte especificado (si es necesario).
Esta opción reemplaza otras credenciales
especificadas (-s, -p y -u). El reproductor de
script se salta la autenticación y asocia el
pasaporte especificado con la sesión.
Esta tabla muestra algunos ejemplos de comandos del reproductor de script.
Comando Descripción
BmtScriptPlayer -c
BmtScriptPlayer -c
-a
BmtScriptPlayer -c
-a -b2 -e20
BmtScriptPlayer -m
-a -e20
BmtScriptPlayer-m
-a -n
Crea un proyecto.
Crea un proyecto y aplica todas las
transacciones del registro de acción.
Crea un proyecto y aplica las transacciones
numeradas del 2 al 20 del registro de acción.
Abre un proyecto existente y aplica las
transacciones numeradas del 1 al 20 del
registro de acción.
Abre un proyecto existente y aplica todas las
transacciones del registro de acción. No
guarda el proyecto.
Capítulo 8. Gestión de proyecto 299

Arreglo de errores causados por objetos no válidos:
Se pueden encontrar errores al ejecutar archivos de script o verificar modelos si ya
no existe un objeto al que una transacción hace referencia o si se ha cambiado el
nombre de objetos.
Si ya no existe un objeto, redirija el objeto que falta a otro objeto.
Utilización de scripts
Si trabaja con scripts y redirige un objeto, todas las demás transacciones utilizan el
nuevo objeto. Si se detiene el script por otra razón, debe modificar el proyecto
temporal para corregir el problema.
Nota: Cuando se arreglan errores realizando cambios en el proyecto principal, se
pueden producir resultados imprevisibles. Siempre se deben arreglar los errores
cambiando el proyecto temporal.
Cuando un script encuentra errores, puede elegir cómo desea resolver el problema.
Solución Acción
Saltar las transacciones que incluyen este
objeto
Sustituir esta aparición y todas las siguientes
del objeto
Pulse Excluir y en el cuadro de diálogo para
excluir las transacciones que utilizan este
objeto, seleccione el nivel de exclusión que
desee.
Se ignora la transacción actual y todas las
subsiguientes que hacen referencia al objeto
excluido. Por ejemplo, si una transacción
intenta crear un paquete que utiliza el objeto
excluido, el paquete no se crea.
Nota: Se deben arreglar los errores antes de
saltarse transacciones.
Pulse Sustituir y en el cuadro de diálogo
Sustituir objeto que falta, seleccione la
opción que desee.
Arreglar el problema manualmente Pulse Detener y luego arregle el problema
en el proyecto temporal.
Redirección de un objeto
Si una transacción hace referencia a un objeto que ya no existe, el script se detiene
y se visualiza un cuadro de diálogo con el nombre del objeto problemático. Puede
redirigir el objeto pulsando Sustituir y seleccionando un objeto nuevo.
Si un objeto que falta aparece en una expresión, el script se detiene y se muestra
un cuadro de diálogo con el nombre del objeto problemático. Debe arreglar el
problema manualmente abriendo la expresión que contiene el objeto que falta.
Arreglo de otros errores encontrados por el script
Debe arreglar los errores de script modificando el proyecto temporal. Cuando se
arreglan errores realizando cambios en el proyecto principal se pueden producir
resultados imprevisibles.
300 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Sincronización de proyectos
Sugerencia: Puede mover o minimizar el cuadro de diálogo Sincronizar para ver y
modificar el proyecto.
Archivado de las entradas del archivo de registro
Con el tiempo, los archivos de registro de un proyecto pueden alcanzar un gran
tamaño. Un archivo de registro grande puede afectar al rendimiento de IBM
Cognos Framework Manager; especialmente, en la manipulación de los archivos de
registro. Puede eliminar una parte de las entradas de un archivo de registro y
añadirlas al final del contenido del archivo archive-log.xml. Framework Manager
archiva todas las entradas del archivo de registro antes de la transacción
seleccionada. La transacción seleccionada no se archiva.
Las transacciones archivadas están disponibles al sincronizar los proyectos. Para
obtener más información, consulte: “Sincronización de proyectos”.
Las transacciones archivadas dejan de mostrarse en el historial de transacciones.
Estas transacciones no están disponibles al realizar bifurcaciones o fusiones en los
proyectos. Por ejemplo, en un proyecto bifurcado, las transacciones archivadas no
estarán disponibles cuando se fusione de nuevo en el proyecto principal.
Procedimiento
1. Pulse Proyecto, Ver historial de transacciones.
2. Localice en el archivo de registro la entrada de la transacción que se ha
producido después de la última transacción que desea archivar.
Se archivarán todas las transacciones del archivo de registro actual anteriores a
la transacción seleccionada.
3. Pulse Archivar archivo de registro.
Puede utilizar los archivos de registro de IBM Cognos Framework Manager para
sincronizar el proyecto.
Puede optar por sincronizar el proyecto si:
v Ha actualizado metadatos en una herramienta de modelado de otro fabricante.
v Ha realizado cambios utilizando una herramienta de modelado de varias
dimensiones.
Al sincronizar el proyecto, se crea un proyecto sustituyendo, a partir de los
archivos de registro, todas las acciones realizadas en el proyecto original.
Deben tenerse en cuenta ciertas consideraciones antes de sincronizar proyectos que
contengan modelos segmentados o modelos enlazados.
Si el origen de datos es una base de datos relacional, solo puede actualizar los
asuntos de consulta y no es necesario realizar una sincronización de todo el
proyecto. Debe realizar una sincronización de proyecto para sincronizar los
cambios realizados en otro origen de datos.
Si importa un subconjunto de un origen de datos, cualesquiera objetos nuevos que
se agreguen al origen de datos no se incluyen en la sincronización. El registro de
acción ha registrado la importación de objetos que ha especificado originalmente.
Al realizar la sincronización, solo se vuelven a importar los objetos importados
originalmente.
Capítulo 8. Gestión de proyecto 301

Puede utilizar la sincronización de proyectos para ejecutar el historial de acciones
completo del modelo y actualizar los metadatos del modelo. Asimismo, puede
guardar partes del registro de acción en un archivo de script aparte para utilizarlo
posteriormente o puede guardar todo el registro de acción en un archivo de script
si desea crear el mismo modelo en modo de proceso por lotes. Si detecta errores al
ejecutar el script de registro de acción, consulte: “Arreglo de errores causados por
objetos no válidos” en la página 300.
Tras la sincronización, puede aceptar los cambios nuevos y crear un proyecto o
bien regresar al proyecto original. Si acepta los cambios nuevos, el proyecto
original se sustituye.
Puesto que se vuelve a ejecutar cada acción que se realizó en el proyecto, la
sincronización puede tardar mucho tiempo en realizarse.
Si un objeto al que hace referencia una transacción ya no existe, porque se ha
cambiado de nombre o se ha eliminado, recibirá errores durante la sincronización.
Por ejemplo, si ha importado una tabla denominada Productos y le ha cambiado el
nombre por Productos nuevos en el origen de datos, recibirá un error al
sincronizar el proyecto. La sincronización no puede detectar que la tabla
denominada Productos nuevos se importó anteriormente con un nombre diferente.
Debe redestinar manualmente el objeto para completar la sincronización. Para
obtener información sobre cómo solucionar los errores de sincronización, consulte:
“Arreglo de errores causados por objetos no válidos” en la página 300.
Nota: Los registros de acciones de IBM Cognos ReportNet no están soportados en
esta versión.
Antes de sincronizar un proyecto, debe comprender cómo incide la sincronización
en los modelos segmentados y enlazados. También debe asegurarse de que las
conexiones de origen de datos no han cambiado y de que los orígenes de datos
están en línea. Puede comprobar las conexiones probando algunos asuntos de
consulta claves.
Modelos segmentados
Un modelo segmentado debe sincronizarse solo al sincronizar el proyecto
principal. Los resultados de la sincronización de todo el proyecto se graban en el
archivo de registro del proyecto principal. La posibilidad de sincronizar segmentos
individuales se pierde tras la primera sincronización del proyecto principal.
Si trabaja en el proyecto principal y cambia un segmento, se actualiza el archivo de
registro principal. Si trabaja en el segmento y realiza cambios, se actualiza el
archivo de registro de segmento.
Los comandos de sincronización no se ejecutan necesariamente en el orden en el
que se visualizan en los archivos de registro. Esto ocurre porque es posible
actualizar los segmentos simultáneamente y los registros de acciones se vuelven a
reproducir sobre la base del tiempo de la acción original. Los comandos pueden
visualizarse para saltar entre archivos de registro, lo que dificulta el uso de las
características de depuración, como las fases únicas.
Modelos enlazados
Los archivos de registro se encuentran en el proyecto que está abierto y no en el
modelo que se actualiza.
302 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Si abre un proyecto principal y realiza cambios en un modelo enlazado, las
acciones se registran en el archivo de registro del proyecto principal. Si, a
continuación, sincroniza el modelo enlazado, el cambio se pierde porque no se
mostró en el conjunto de archivos de registro utilizado durante la sincronización.
La sincronización solo puede ejecutarse en el proyecto principal o en un segmento
autónomo. No se pueden sincronizar proyectos o segmentos enlazados en el
proyecto principal. Si el proyecto enlazado actualiza los segmentos, la
sincronización puede producir resultados imprevistos en el proyecto principal.
No utilice la sincronización de modelos con proyectos enlazados.
Pasos para sincronizar
Procedimiento
1. Pulse Proyecto, Sincronizar.
2. Puede crear una copia de seguridad del proyecto Framework Manager
seleccionando la casilla de verificación Proyecto de copia de seguridad en este
directorio.
3. Si desea ver los detalles de una transacción, pulse la transacción.
4. Defina el punto de inicio o detención que desee.
v Para definir un punto de inicio para ejecutar el script, seleccione el script y
pulse Establecer el punto de partida. Puede hacerlo cuando desee para
omitir una instrucción o ejecutar instrucciones que ya se han ejecutado .
v Para definir un punto de detención para le script, seleccione el script y pulse
Establecer el punto de detención .
Puede detener el script para realizar un arreglo manual y, después,
reanudarlo.
Sugerencia: Para eliminar el punto de detención, pulse Eliminar el punto de
detención .
5. Con los botones de la barra de herramientas, elija la acción que desee que se
ejecute.
Botón Descripción
Ejecuta el script.
Si se detecta un error, puede pulsar en este botón para intentar
volver a ejecutar la instrucción fallida.
Salta a la siguiente transacción y ejecuta el script hasta el final.
Ejecuta solo la transacción seleccionada.
Salta a la siguiente transacción y se detiene, pero no ejecuta
ninguna transacción.
La ventana del proyecto se actualiza y el script se ejecuta.
6. Solucione los errores que encuentre el script ya sea destinando los objetos a
otros destinos o modificando el proyecto temporalmente, según sea necesario.
Para obtener más información, consulte: “Arreglo de errores causados por
objetos no válidos” en la página 300.
Capítulo 8. Gestión de proyecto 303

7. Cuando el script se haya completado, pulse Aceptar.
El objeto original se sustituye por el contenido del proyecto temporal.
Sugerencia: Para devolver al proyecto su estado anterior, pulse Revertir.
Comportamiento de las consultas
Mediante la supervisión y el ajuste del comportamiento de las consultas en el
proyecto de IBM Cognos Framework Manager, puede mejorar el rendimiento del
modelo.
Puede realizar cualquiera de los pasos siguientes:
Procedimiento
1. Definir reguladores para reducir las necesidades de recursos del sistema y
mejorar el rendimiento asegurándose de que los metadatos del paquete
contengan los límites adecuados. Por ejemplo, puede limitar la cantidad de
datos recuperados o el tiempo que una consulta puede tardar. Para obtener más
información, consulte: “Reguladores”.
2. Especificar si los resúmenes de agregado se calculan localmente o en la base de
datos. Para metadatos relacionales, puede mejorar el rendimiento seleccionando
el tipo correcto de procesamiento de consultas. Tras la ejecución del informe
inicial, si activa la característica de reutilización de consulta, podrá crear
informes sin consultar la base de datos de nuevo. Para obtener más
información, consulte: “Lugar de procesamiento de los resúmenes de agregado”
en la página 312.
3. Mejorar el rendimiento definiendo el tipo de procesamiento de consultas para
determinar si el procesamiento de SQL lo realiza el servidor de bases de datos
o si se procesa localmente. Para obtener más información, consulte: “Mejora del
rendimiento mediante el establecimiento del tipo de procesamiento de
consultas” en la página 313.
4. Especificar el modo de transacción para un asunto de consulta con un
procedimiento almacenado para que se pueda utilizar el asunto de consulta en
todos los estudios. Para obtener más información, consulte: “Especificar modos
de transacción” en la página 315.
5. Mejorar el rendimiento reutilizando datos de la memoria caché al ejecutar un
informe. Al reutilizar los datos almacenados en la memoria caché, se puede
crear un informe sin consultar la base de datos de nuevo. Para obtener más
información, consulte: “Mejora del rendimiento reutilizando datos de la
memoria caché al ejecutar un informe” en la página 314.
6. Seleccionar los conjuntos de funciones específicos de proveedor para los
orígenes de datos definidos en el proyecto. Para obtener más información,
consulte: “Selección de conjuntos de funciones” en la página 316.
7. Indicar el comportamiento de funciones individuales que están basadas en los
orígenes de datos del proyecto. Para obtener más información, consulte:
“Calidad de servicio” en la página 317.
8. Controlar y optimizar el modo en que se ejecutan las consultas modificando las
propiedades de un origen de datos que se creó con el asistente de metadatos en
IBM Cognos Framework Manager. Para obtener más información, consulte:
“Control y optimización de consultas” en la página 319.
Reguladores
Utilice los reguladores para reducir las necesidades de recursos del sistema y
mejorar el rendimiento. Los reguladores se definen antes de crear paquetes para
304 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

garantizar que los metadatos del paquete se ajustan a los límites especificados.
Todos los paquetes que se publiquen posteriormente, utilizarán los nuevos valores.
Los valores del regulador que tienen prioridad son los que hacen referencia al
modelo que está abierto (con independencia de que sea un modelo padre o hijo).
En un proyecto nuevo, los reguladores no tienen valores definidos en el modelo.
Debe abrir la ventana Reguladores y cambiar los valores si es necesario. Los
valores de los reguladores se definen al guardar los valores en la ventana
Reguladores y pulsando en Aceptar. Asimismo, puede definir los reguladores en
Report Studio. Los valores de los reguladores de Report Studio reemplazan a los
valores de los reguladores del modelo.
Para obtener información sobre los reguladores específicos del modo de consulta
dinámica (DQM), consulte la guía de las consultas dinámicas.
Número máximo de tablas de informes
Puede controlar el número de tablas que un usuario puede recuperar de una
consulta o informe. Cuando una tabla se recupera, se cuenta cada vez que se
muestra en la consulta o informe. El límite no es el número de tablas exclusivas. Si
la consulta o el informe supera el límite definido para el número de tablas, aparece
un mensaje de error y la consulta o el informe se muestra sin datos.
El valor cero (0) significa que no se ha definido ningún límite.
Nota: Este regulador no se utiliza en el modo de consulta dinámica.
Número máximo de filas recuperadas
Se pueden definir los límites de recuperación de datos controlando el numero de
filas que se devuelven en una consulta o informe. Las filas se cuentan a medida
que se recuperan.
Cuando al ejecutar un informe, se excede el límite de recuperación de datos,
aparece un mensaje de error y la consulta o el informe se muestra sin datos.
También puede usar este regulador para definir los límites para los datos
recuperados en una prueba de asunto de consulta o en el modo de diseño de
informe.
El valor cero (0) significa que no se ha definido ningún límite.
Si se externaliza un asunto de consulta, este valor se pasa por alto al publicar el
modelo. Para obtener más información, consulte: “Asuntos de consulta y
dimensiones externalizados” en la página 262.
Nota: Este regulador no se utiliza en el modo de consulta dinámica.
Límite de tiempo de ejecución de consulta
Puede limitar el tiempo que una consulta tarda en realizarse. Se muestra un
mensaje de error cuando se alcanza el número de segundos predefinido.
El valor cero (0) significa que no se ha definido ningún límite.
Capítulo 8. Gestión de proyecto 305

Nota: Este regulador no se utiliza en el modo de consulta dinámica.
Límite de elementos de texto grandes
Puede controlar la longitud de caracteres de los objetos grandes binarios (BLOB)
que un usuario puede recuperar de una consulta o un informe. Cuando la longitud
de caracteres del BLOB supera el límite definido, aparece un mensaje de error y la
consulta o el informe se muestra sin datos.
El valor cero (0) significa que no se ha definido ningún límite.
Uniones externas
Puede controlar si se pueden usar uniones externas en la consulta o el informe.
Una unión externa recupera todas las filas de una tabla, aunque no haya una fila
coincidente en la otra tabla. Este tipo de unión puede producir consultas e
informes muy grandes y que requieran muchos recursos.
Los reguladores están definidos para que rechacen las uniones externas de forma
predeterminada. Por ejemplo, las uniones externas no se generan automáticamente
cuando se prueba un elemento de consulta en Framework Manager.
SQL se genera automáticamente cuando
v Se ejecuta un informe.
v Se prueba un elemento de consulta o relación en Framework Manager.
v Se crea un asunto de consulta de modelo basado en otros objetos.
Si conserva el valor Denegar, solo se le enviará una notificación si crea una
relación en la pestaña Diagrama que incluya uniones externas. No recibirá
notificación si crea una relación en un asunto de consulta de orígenes de datos que
incluya uniones externas.
Si se define el regulador con el valor Permitir, las relaciones entre dimensión y
hecho se modifican de uniones internas a uniones externas.
El regulador de uniones externas no funciona en las circunstancias siguientes:
v SQL generado por otros medios. Si define este regulador con el valor Denegar,
no se aplica el SQL permanente encontrado en un asunto de consulta de
orígenes de datos, con independencia de si el SQL se ha generado en una
importación, se ha especificado manualmente o se basa en objetos existentes.
v Framework Manager tiene que generar una unión externa para crear una
consulta enlazada. Una consulta enlazada es aquella que combina localmente los
resultados de dos o más subconsultas utilizando una unión externa procesada
localmente.
Nota: Este regulador no se utiliza en los orígenes de datos de SAP BW.
Nota: Este regulador no se utiliza en el modo de consulta dinámica.
Uniones entre productos
Puede controlar si se pueden utilizar uniones entre productos en la consulta o el
informe. Una unión entre productos recupera datos de tablas sin uniones. Este tipo
de unión pueda tardar mucho en recuperar datos.
306 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

El valor predeterminado de este regulador es Rechazar. Seleccione Permitir para
permitir las uniones entre productos.
Procesamiento de atajos
Puede controlar el modo en que el software IBM Cognos puede controlar los
atajos.
Cuando se abre un modelo de una versión anterior, el regulador Procesamiento de
atajos tiene el valor Automático. Automático es un atajo que existe en la misma
carpeta que su destino y se comporta como un alias o una instancia independiente.
No obstante, un atajo de cualquier otra parte del modelo se comporta como una
referencia al original. Cuando se crea un modelo, el regulador Procesamiento de
atajos tiene siempre el valor Explícito.
Si define el regulador con el valor Explícito, el comportamiento del atajo se toma
de la propiedad Tratar como. Si el regulador Procesamiento de atajos tiene el valor
Automático, compruebe el modelo y, cuando lo repare, cambie el valor del
regulador por Explícito. Esto cambia todos los atajos al valor correcto de la
propiedad Tratar como según las reglas que sigue el valor Automático.
El regulador Procesamiento de atajos toma prioridad sobre la propiedad Tratar
como. Por ejemplo, si el regulador tiene el valor Automático, el comportamiento
del atajo viene determinado por la ubicación del atajo en relación con su destino,
con independencia de cuál sea el valor de la propiedad Tratar como.
Sintaxis de unión SQL
Se puede controlar el modo en que SQL se genera para las uniones internas en un
modelo seleccionando uno de los valores siguientes:
v Si el regulador tiene el valor Determinado por el servidor, el archivo
CQEConfig.xml se usa para determinar el valor del regulador. Si no hay un
archivo CQEConfig.xml activo o no hay una entrada de parámetro para el
regulador en el archivo CQEConfig.xml, se usa el valor Implícito.
v El valor Implícito usa la cláusula where.
Por ejemplo,
SELECT publishers.name, publishers.id,
books.title FROM publishers, books WHERE publishers.id
= books.publisher_id ORDER BY publishers.name, books.title;
v El valor Explícito usa la cláusula from con las palabras clave inner join en un
predicado on.
Por ejemplo,
SELECT
publishers.name, publishers.id,
books.title FROM publishers INNER JOIN books ON publishers.id
= books.publisher_id ORDER BY publishers.name, books.title;
Puede definir el tipo de unión en la propiedad de consulta en Report Studio para
reemplazar el valor de este regulador.
Con independencia del valor que se utilice para este regulador, el valor Explícito
se utiliza para las uniones externas izquierdas, derechas y completas.
Este regulador no tiene efecto en el SQL introducido.
Capítulo 8. Gestión de proyecto 307

Agrupación de atributos de medida (elementos de consulta)
Si el regulador tiene el valor Determinado por el servidor, el archivo
CQEConfig.xml se usa para determinar el valor del regulador. Si no hay un
archivo CQEConfig.xml activo o no hay una entrada de parámetro para el
regulador en el archivo CQEConfig.xml, se usa el valor Inhabilitado.
El valor Inhabilitado impide la agregación de la medida para los atributos. Este es
el comportamiento predeterminado. Por ejemplo,
select Product.Product_line_code as Product_line_code,
Order_method.Order_method_code as Order_method_code,
XSUM(Sales.Quantity for Product.Product_line_code) as Quantity from ...
El valor Habilitado permite la agregación de la medida para los atributos. Nota:
Este es el comportamiento predeterminado para las versiones de IBM Cognos
Framework Manager anteriores a la 8.3.
select Product.Product_line_code as Product_line_code,
Order_method.Order_method_code as Order_method_code,
XSUM(Sales.Quantity for Order_method.Order_method_code,
Product.Product_line_code)
as Quantity
from ...
En estos ejemplos, Order_method.Order_method_code as Order_method_code define
el atributo de medida.
La sintaxis XSUM define la medida agregada.
Generación de SQL para atributos de nivel
Puede controlar el uso del agregado mínimo en el SQL generado para los atributos
de un nivel (título de miembro).
Si el regulador tiene el valor Determinado por el servidor, el archivo
CQEConfig.xml se usa para determinar el valor del regulador. Si no hay un
archivo CQEConfig.xml activo o no hay una entrada de parámetro para el
regulador en el archivo CQEConfig.xml, se usa el valor Mínimo.
El valor Mínimo genera el agregado mínimo para el atributo. Este valor garantiza
la integridad de los datos si existe la posibilidad de registros duplicados. Por
ejemplo,
select XMIN(Product.Product_line
for Product.Product_line_code) as Product_line, //level attribute
Product.Product_line_code as Product_line_code
from
(...) Product
El valor Agrupar por agrega los atributos del nivel en la cláusula group by sin
agregación para el atributo. La cláusula distinct indica un group by en todos los
elementos de la lista de proyección. El valor Agrupar por se usa si los datos no
tienen registros duplicados. Puede mejorar el uso de las vistas materializadas y
puede producir un mejor resultado. Por ejemplo,
select distinct
Product.Product_line as Product_line,//level attribute
,Product.Product_line_code
as Product_line_code
from(...) Product
308 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Nota: Este regulador no se utiliza en el modo de consulta dinámica.
Generación de SQL para atributos de determinantes
Puede controlar el uso del agregado mínimo en el SQL generado para los atributos
de un determinante con la propiedad Agrupar por habilitada.
Si el regulador tiene el valor Determinado por el servidor, el archivo
CQEConfig.xml se usa para determinar el valor del regulador. Si no hay un
archivo CQEConfig.xml activo o no hay una entrada de parámetro para el
regulador en el archivo CQEConfig.xml, se usa el valor Mínimo.
El valor Mínimo genera el agregado mínimo para el atributo. Este valor garantiza
la integridad de los datos si existe la posibilidad de registros duplicados. Por
ejemplo,
select PRODUCT_LINE.PRODUCT_LINE_CODE
as Product_line_code,
XMIN(PRODUCT_LINE.PRODUCT_LINE_EN
for PRODUCT_LINE.PRODUCT_LINE_CODE)
as Product_line //attribute
from
great_outdoors_sales..GOSALES.PRODUCT_LINE PRODUCT_LINE
group by
PRODUCT_LINE.PRODUCT_LINE_CODE //key
El valor Agrupar por agrega los atributos de los determinantes en la cláusula
group by sin agregación para el atributo. Este valor se usa si los datos no tienen
registros duplicados. Puede mejorar el uso de las vistas materializadas y puede
producir un mejor resultado. Por ejemplo,
select
PRODUCT_LINE.PRODUCT_LINE_CODE as Product_line_code,
PRODUCT_LINE.PRODUCT_LINE_EN as Product_line //attribute
from
great_outdoors_sales..GOSALES.PRODUCT_LINE PRODUCT_LINE
group by
PRODUCT_LINE.PRODUCT_LINE_CODE //key
PRODUCT_LINE.PRODUCT_LINE_EN //attribute
Sintaxis de parámetros SQL
Este regulador especifica si el SQL generado usa marcadores de parámetro o
valores literales.
Si el regulador tiene el valor Determinado por el servidor, el archivo
CQEConfig.xml se usa para determinar el valor del regulador. Si no hay un
archivo CQEConfig.xml activo o no hay una entrada de parámetro para el
regulador en el archivo CQEConfig.xml, se usa el valor Marcador.
Puede reemplazar el valor de este regulador en Report Studio.
Las aplicaciones de SQL dinámico tienen la capacidad de preparar sentencias que
incluyan marcadores en el texto que indica que el valor se proporcionará
posteriormente. Es más eficiente cuando la misma consulta se usa varias veces con
valores diferentes. La técnica reduce el número de veces que una base de datos
tiene que analizar una sentencia SQL y aumenta la reutilización de sentencias
almacenadas en la memoria caché. No obstante, cuando las consultas buscan en
cantidades de datos mayores con sentencias más complejas, tienen menos
posibilidades de coincidir con otras consultas. En este caso, el uso de valores
Capítulo 8. Gestión de proyecto 309

literales en lugar de marcadores puede mejorar el rendimiento.
Permitir portabilidad de modelo mejorada en tiempo de
ejecución
Este regulador se selecciona en la actualización inicial de un modelo de Cognos
ReportNet 1.x. Impide la aplicación estricta de tipos de datos de modo que un
modelo de IBM Cognos puede funcionar como un modelo de ReportNet 1.x hasta
que se actualicen los tipos de datos en los metadatos. Tras verificar que el modelo
se ha actualizado correctamente, desactive este regulador.
Aparte de la actualización inicial, este regulador tiene usos limitados. Por ejemplo,
si ha creado un modelo para utilizar con un origen de datos y desea ejecutarlo
contra un origen de datos diferente. El nuevo origen de datos debe ser
estructuralmente similar al origen de datos original y el esquema de base de datos
debe ser igual entre los dos orígenes de datos. Si selecciona este regulador, IBM
Cognos BI recupera los metadatos del origen de datos y los guarda en la memoria
caché en lugar de utilizar los metadatos ya almacenados en la memoria caché en el
modelo. Cuando haya acabado de modificar y probar el modelo contra el nuevo
origen de datos, desactive este regulador.
Si no utiliza este regulador, los metadatos siguientes deben ser iguales en el origen
de datos original y en el nuevo:
v Nombre de secuencia de ordenación
v Nivel de ordenación
v Juego de caracteres
v Nulabilidad
v Precisión
v Escala
v Longitud de columna
v Tipo de datos
Permitir uso de memoria caché local
Seleccione este regulador para especificar que todos los informes basados en este
modelo utilizarán datos almacenados en memoria caché. Para un modelo nuevo,
este regulador está habilitado de forma predeterminada.
Este valor afecta a todos lo informes que utilizan el modelo. Utilice Report Studio
si desea que un informe utilice un valor diferente que el del modelo. Para obtener
más información, consulte: “Mejora del rendimiento reutilizando datos de la
memoria caché al ejecutar un informe” en la página 314.
Permitir generación dinámica de información de dimensiones
Este regulador se selecciona solo en la actualización inicial de un modelo de
ReportNet 1.x. Este regulador permite un comportamiento coherente con
ReportNet 1.x al obtener una forma de información de dimensiones a partir de las
relaciones, la información clave y la información de índice del origen de datos.
Utilizar cláusula WITH al generar SQL
Puede optar por utilizar la cláusula With con IBM Cognos SQL si el origen de
datos da soporte a la cláusula With.
310 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

La cláusula With se activa para los modelos creados en IBM Cognos BI. Para los
modelos actualizados, se desactiva a menos que se haya activado explícitamente en
el modelo de Cognos ReportNet antes de la actualización.
Suprimir valores nulos para orígenes de datos de SAP BW
Puede controlar si los valores nulos son suprimidos por los informes o análisis que
utilizan el paquete publicado. El regulador también se aplica a los resultados de
prueba durante la sesión de Framework Manager actual. Se soporta solo para los
orígenes de datos de SAP BW.
Algunas consultas pueden ser muy grandes porque los valores nulos no se filtran.
La eliminación de los valores nulos quita las filas o columnas cuya totalidad de
valores son nulos (vacíos). SAP BW realiza la eliminación de los valores nulos. Esto
reduce la cantidad de datos transferidos a los productos cliente de IBM Cognos y
mejora el rendimiento.
De forma predeterminada, los valores nulos se eliminan. Si desactiva este
regulador, los valores nulos no se eliminan.
Existe una propiedad denominada Suprimir en Report Studio que reemplaza este
regulador. Si el valor de la propiedad Suprimir se define como Ninguno, los
valores nulos se incluyen en el conjunto de resultados aunque el regulador esté
configurado para eliminar los valores nulos.
Nota: Este regulador no se aplica cuando se crean archivos csv; por consiguiente,
los archivos CSV incluyen los valores nulos si existen en los datos.
Procesar modelo entero al publicar
Un paquete publicado incluye los objetos de modelo que se seleccionaron cuando
el paquete se creó. Además, estos objetos de modelo se analizan para identificar e
incluir los objetos dependientes en el paquete.
En un modelo complejo o muy grande, el análisis puede tardar bastante tiempo en
realizarse. Para abreviar el tiempo de publicación, defina este regulador para que
se omita este paso de análisis y que el modelo completo se grabe en el almacén de
contenido. El paquete resultante puede ser más grande porque se publica todo el
modelo en lugar de los objetos necesarios; no obstante, el tiempo necesario para la
publicación debe disminuir.
Orígenes de datos externos máximos que pueden fusionarse con
un modelo
Para usar datos externos, los usuarios de los informes importan sus datos en un
paquete existente. Este regulador controla el número de archivos de datos externos
que pueden importarse.
El valor predeterminado es 1.
Para obtener más información sobre los orígenes de datos externos, consulte la
publicación IBM Cognos Report Studio Guía del usuario.
Capítulo 8. Gestión de proyecto 311

Tamaño máximo de archivo de datos externos (KB)
Para usar datos externos, los usuarios de los informes importan sus datos en un
paquete existente. Este regulador controla el tamaño de cada archivo de datos
externos.
De forma predeterminada, el tamaño máximo de archivo que pueden importar los
usuarios del informe es 2560 KB.
Para obtener más información sobre los orígenes de datos externos, consulte la
publicación IBM Cognos Report Studio Guía del usuario.
Recuento máximo de filas de datos externos
Para usar datos externos, los usuarios de los informes importan sus datos en un
paquete existente. Este regulador controla el número de filas que puede existir en
cada archivo de datos externos.
De forma predeterminada, el número máximo de filas que pueden importar los
usuarios del informe es 20000.
Para obtener más información sobre los orígenes de datos externos, consulte la
publicación IBM Cognos Report Studio Guía del usuario.
Lugar de procesamiento de los resúmenes de agregado
La propiedad Procesamiento de resumen para los orígenes de datos determina
cómo se calculan los resúmenes de agregado por encima de nivel de detalle del
informe. El valor predeterminado es Local si el procesamiento de consultas local
está habilitado y, si no lo está, el valor es Base de datos.
Nota: Esta propiedad no se utiliza en los orígenes de datos de SAP BW.
Las opciones posibles de esta propiedad son:
v No especificado
El resumen de agregado no está especificado.
v Local
Todos los resúmenes de agregado se calculan localmente (en el servidor de
informes) mediante un agregado en ejecución (por ejemplo, RSUM). Los
agregados en ejecución distribuyen el coste de este cálculo a medida que se
recuperan los datos. Utilice esta opción si el sistema local tiene más recursos
inactivos que el sistema de la base de datos, o si sabe por experiencia que este
método es más rápido.
v Base de datos
El software de la base de datos subyacente calcula los resúmenes de agregado, si
es posible. Si no, se calculan localmente (si el procesamiento de consultas local
está activado). Se utilizan los agregados en ejecución, pero el coste es a cargo del
servidor de bases de datos en lugar del servidor de informes. Utilice esta opción
si el sistema de la base de datos tiene más recursos inactivos que el sistema
local, o si sabe por experiencia que este método es más rápido.
v Extendido
El servidor de bases de datos calcula todos los resúmenes de agregado mediante
un agregado extendido (por ejemplo, XSUM). Los agregados extendidos corren
con el coste de este cálculo al principio. Normalmente, este es el método más
312 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

ápido, pero solo si la base de datos está configurada para utilizar las vistas
materializadas. Para las bases de datos en las que se da soporte a la
funcionalidad OLAP, se convierte a las funciones de agregado OLAP adecuadas.
Procedimiento
1. En el Visor de proyectos, pulse el origen de datos que desee cambiar.
2. En el panel Propiedades, en el cuadro de lista Procesamiento de consultas,
seleccione el tipo de procesamiento de resúmenes que desee.
Mejora del rendimiento mediante el establecimiento del tipo
de procesamiento de consultas
La propiedad de procesamiento de consultas para orígenes de datos determina si el
procesamiento de SQL se realiza por el servidor de bases de datos o si se procesa
localmente. Para metadatos relacionales, puede mejorar el rendimiento
seleccionando el tipo correcto de procesamiento de consultas.
Hay dos tipos de procesamiento de consultas:
v Local limitado
El servidor de bases de datos realiza todo el procesamiento y ejecución de SQL
que puede. Sin embargo, algunos informes o secciones de informe utilizan el
procesamiento de SQL local.
v Solo base de datos
El servidor de bases de datos realiza todo el procesamiento y ejecución de SQL.
Se visualiza un error si algún informe o sección de informe necesita el
procesamiento de SQL local.
Aunque normalmente el servidor de bases de datos puede ejecutar el SQL y los
informes con mucha más rapidez, a veces es necesario el procesamiento local. Por
ejemplo, se debe elegir el procesamiento local limitado si se desea crear uniones de
bases de datos cruzadas, o si se desea que los usuarios utilicen funciones no
soportadas de SQL99.
Algunas consultas complejas necesitan procesamiento local limitado, como una
consulta que debe generar una cláusula At para evitar que se realicen recuentos
dobles.
Procesamiento de consultas para el modo de consulta dinámica
En el modo de consulta dinámica, los valores de procesamiento de consultas tienen
solo efecto en orígenes de datos SAP BW.
v Local limitado
Local limitado solo está soportado ahora.
v Solo base de datos
El servidor de informes realiza poco o, posiblemente, nada del procesamiento de
consultas. El procesamiento local solo se produce si la base de datos no puede
gestionar la consulta. Considere la posibilidad de utilizar este valor solo si el
rendimiento del informe no es aceptable con el valor predeterminado, y se
puede utilizar con este valor. Tenga en cuenta que los resultados pueden
cambiar con este valor; pruebe con mucha atención para confirmar que los
resultados siguen siendo correctos.
Capítulo 8. Gestión de proyecto 313

En el Visor de proyectos, pulse el origen de datos que desee cambiar. En el panel
Propiedades, en el cuadro de lista Procesamiento de consultas, pulse Local
limitado o Solo base de datos
Mejora del rendimiento reutilizando datos de la memoria
caché al ejecutar un informe
Al ejecutar un informe, la solicitud de consulta se envía a la base de datos y se
devuelve el conjunto de resultados. Tras la ejecución del informe inicial, tal vez
decida realizar algún cambio en el informe. A menudo el informe se puede crear
sin enviar una nueva consulta a la base de datos. Para aprovechar esta posibilidad,
active la característica de reutilización de consulta.
Cuando la reutilización de consulta está activada y ejecuta un informe por primera
vez, la consulta se almacena en la memoria caché del servidor de informes.
Asimismo, algunos recursos del origen de datos pueden no estar disponibles hasta
que se libere la transacción que los utiliza. El tiempo de espera predeterminado
actual es de 60 minutos. Si algunas actividades de la base de datos implican
modificar objetos de la base de datos, deberá esperar a que termine el periodo de
tiempo de espera, o bien puede inhabilitar la reutilización de consulta para
informes.
La primera vez que se ejecuta el informe y se crea la memoria caché, el tiempo de
respuesta puede verse ligeramente afectado de forma negativa. La mejora del
rendimiento puede constatarla el usuario de informe en las posteriores ejecuciones
del informe, cuando el tiempo de respuesta mejora hasta un 80%. Esta mejora del
rendimiento se produce porque el informe no tiene que volver a enviar la consulta
a la base de datos. Además, una reducción de las consultas a la base de datos
produce una mejora del rendimiento global del sistema, lo cual tiene un impacto
positivo para todos los usuarios.
La reutilización de consulta puede definirse en el modelo o en informes
individuales. Para especificar que todos los informes que usen un modelo
particular deben utilizar datos de la memoria caché, habilite el regulador Permitir
uso de memoria caché local en el modelo en IBM Cognos Framework Manager y
vuelva a publicar el modelo. De forma predeterminada, esta configuración afecta a
todos los informes que utilizan este modelo, incluidos los análisis que se ejecutan
como informes en IBM Cognos Viewer.
Reutilización de consulta en IBM Cognos Viewer
Si desea que un informe utilice una configuración diferente de la del modelo,
puede hacerlo en IBM Cognos Report Studio. En el panel Propiedades, cambie la
propiedad Utilizar memoria caché local. Establezca la propiedad en No si desea
ejecutar siempre la consulta. Establezca la propiedad en Sí si desea utilizar los
resultados almacenados en memoria caché. Si desea que el informe utilice la misma
configuración que el modelo, cambie el valor por Predeterminado.
El cambio de la propiedad Utilizar memoria caché local para un informe no afecta
a otros informes.
Reutilización de datos de la memoria caché en Query Studio
IBM Cognos Query Studio reutiliza datos de la memoria caché en diversas
circunstancias. Si la reutilización de consulta está activada en el modelo y un
subconjunto del conjunto de datos de la memoria caché puede satisfacer la acción,
314 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

el informe utiliza los datos de la memoria caché. Por ejemplo, cambios realizados
en el informe, como añadir un filtro o eliminar una columna, pueden cambiar los
datos del informe, pero la solicitud aún puede satisfacerse desde un subconjunto
de los datos de la memoria caché.
Si la reutilización de consulta está desactivada y la acción puede satisfacerse desde
el conjunto de datos de la memoria caché sin modificaciones, el informe sigue
utilizando los datos de la memoria caché. Por ejemplo, cambiar el formato del
informe utiliza el conjunto de datos anteriores incluso aunque la reutilización de
consulta esté desactivada. Es lo que se conoce como reutilización de cursor. La
reutilización de cursor se usa cuando los datos de la memoria caché pueden
satisfacer la solicitud sin modificaciones.
Los informes creados en Query Studio siempre utilizan la misma configuración
especificada en el modelo. Si el modelo tiene la reutilización de consulta activada,
el informe intenta utilizar los datos de la memoria caché.
Decisión sobre el uso de reutilización de consulta en su entorno
Antes de decidir si desea activar o no la reutilización de consulta, tenga en cuenta
lo siguiente:
v Si la mayoría de los usuarios de informe ejecutan informes de forma interactiva
pero los ejecutan una sola vez, es posible que no experimente gran mejora en el
rendimiento al almacenar datos en la memoria caché.
Nota: Independientemente de la configuración de la reutilización de consulta,
los informes que se ejecutan en modo de proceso por lotes no almacenan datos
en la memoria caché.
v El tamaño de la memoria caché puede afectar a la escalabilidad. Por ejemplo, si
un informe tiene un conjunto de resultados grande, la memoria caché también
será grande. Esto debe tenerse en cuenta al ajustar el tamaño y configurar el
entorno de servidor.
Especificar modos de transacción
Puede especificar el tipo de transacción utilizada por los asuntos de consulta con
los procedimientos almacenados.
De forma predeterminada, un asunto de consulta que contiene un procedimiento
almacenado se ejecuta en una transacción de sólo lectura. Sin embargo, el
procedimiento almacenado puede incluir operaciones que requieran una
transacción de lectura/escritura. Las propiedades Modo de acceso a transacción y
Modo de sentencia de transacción permiten que los asuntos de consulta que se
ejecutan en transacciones de lectura/escritura se utilicen en todos los demás
estudios.
La propiedad Modo de acceso a transacción para los orígenes de datos especifica
el modo de acceso de una nueva transacción. Están disponibles las siguientes
opciones de modo de acceso:
v Sin especificar: Se inicia una transacción nueva en el modo predeterminado.
v Sólo lectura: Se inicia una transacción nueva en modo de sólo lectura.
v Leer-Grabar: Se inicia una transacción nueva en modo de lectura/escritura.
Capítulo 8. Gestión de proyecto 315

Valores predeterminados: Para el modo de consulta dinámica, el valor
predeterminado está sin especificar. Para el modo de consulta compatible, el valor
predeterminado es sólo lectura.
Límite: En modo de consulta dinámica, la propiedad Modo de acceso a
transacción sólo se soporta para procedimientos almacenados basados en asuntos
de consulta.
La propiedad Modo de sentencia de transacción especifica la acción que se debe
realizar cuando finaliza una transacción. Son posibles las acciones siguientes:
v Sin especificar: Especifica la acción predeterminada realizada cuando finaliza
una transacción.
v Retrotraer: una transacción se retrotrae cuando finaliza.
v Confirmar: una transacción se confirma cuando finaliza.
v Confirmar automáticamente: se realiza la confirmación automática cuando
finaliza una transacción.
Valor predeterminado: Retrotraer. Si la base de datos subyacente soporta la
confirmación automática, la acción predeterminada es confirmar.
Límite: El modo de consulta dinámica ignora la propiedad Modo de sentencia de
transacción.
En el Visor de proyectos, pulse el origen de datos que desea cambiar. En el panel
Propiedades, en los cuadros de lista Modo de acceso a transacción y Modo de
sentencia de transacción, pulse los valores necesarios.
Selección de conjuntos de funciones
Un conjunto de funciones es una colección de funciones específicas del proveedor.
Cuando se crea un proyecto que contiene metadatos relacionales, el editor de
expresiones muestra los conjuntos de funciones para todos lo proveedores
disponibles. No obstante, puede limitar los conjuntos de funciones de modo que
solo se listen los proveedores que desea utilizar en el proyecto. Los conjuntos de
funciones se personalizan identificando el proveedor específico para cada origen de
datos definido en el proyecto.
Puede utilizar funciones definidas en el origen de datos relacionales en IBM
Cognos Framework Manager. Si ha importado las funciones definidas por el
usuario, se listan en Framework Manager para facilitar la selección. Si no las ha
importado, puede escribir el nombre de la función en una expresión. Si la función
debe calificarse, debe importarla a Framework Manager.
Algunas veces las funciones específicas de los proveedores se crean en esquemas
con permisos de acceso más amplios. No puede utilizar estas funciones en el
software de IBM Cognos en un esquema con permisos de acceso restringidos si
ambos esquemas están en la misma instancia de base de datos.
Si se escribe una función no reconocida en un informe, se presupone que la
función es nativa. Para obtener más información, consulte: “SQL nativo” en la
página 102.
Nota: Si se crea un proyecto que contiene metadatos de SAP BW, Framework
Manager lista automáticamente solo las funciones aplicables a los datos de SAP
BW.
316 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Procedimiento
1. Pulse Proyecto, Lista de funciones del proyecto.
2. Seleccione la casilla de verificación Establecer lista de funciones basándose en
el tipo de origen de datos.
Sugerencia: Para inhabilitar este filtro, seleccione la casilla de verificación
Incluir todos los conjuntos de funciones.
3. En la página Conjunto de funciones, pulse la fila de origen de datos adecuada.
4. En la lista desplegable del campo Conjunto de funciones, seleccione el
conjunto de funciones que desea utilizar con este origen de datos.
5. Repita los pasos 2a4hasta que finalice la operación.
6. Pulse Aceptar.
Calidad de servicio
Con IBM Cognos Framework Manager, puede realizar consultas sobre cualquier
combinación de tipos de origen de datos, pero no todos los orígenes de datos dan
soporte a las funciones del mismo modo. El indicador de calidad de servicio
proporciona una pista visual sobre el comportamiento de funciones individuales
utilizadas en combinación con los orígenes de datos del modelo.
Cada función especificada en el origen de datos puede tener una calidad de
servicio distinta, en función del tipo de origen de datos en uso. Para cada
característica de la consulta que no tenga la misma calidad de servicio en todos los
paquetes, puede reemplazar el nivel de servicio y añadir texto para describir la
situación específica en ese modelo. Los usuarios podrán ver los indicadores de
calidad de servicio y la descripción específica del contexto, y utilizar esta
información a la hora de determinar qué funciones utilizar en los informes.
Impacto de reemplazar el indicador de calidad de servicio
IBM Cognos Framework Manager determina la calidad de servicio de funciones
basadas en el tipo de origen de datos. Teniendo en cuenta el contexto del modelo,
puede reemplazar la calidad de servicio determinada por el producto. Reemplazar
la calidad de servicio ofrece orientación a los usuarios. No cambia el nivel de
soporte para esa función en el origen de datos.
Cuando un paquete se forma combinando subpaquetes, tienen prioridad los
reemplazos de calidad de servicio del paquete padre. Si no hay ningún reemplazo
en el padre, se agrega la calidad de servicio para los paquetes hijo.
Consideración de los usuarios
En última instancia, el objetivo es proporcionar a los usuarios información
suficiente para satisfacer sus requisitos empresariales, pero no tanta que llegue a
confundirlos. Si los usuarios no son capaces de tomar decisiones en cuanto a qué
funciones utilizar basándose en los indicadores de calidad de servicio, tal vez
debería considerar la posibilidad de publicar paquetes separados para diferentes
grupos de usuarios. Si los usuarios requieren acceso a funciones cuya calidad de
servicio es inferior a Sin restricciones, deberá documentar las restricciones de esas
funciones al definir la calidad de servicio.
Impactos en el rendimiento
Los indicadores de calidad de servicio no tienen un impacto directo en el
rendimiento de las consultas. La finalidad de los indicadores de servicio es darle
Capítulo 8. Gestión de proyecto 317

control sobre las funciones disponibles. Así, puede evitar que los usuarios utilicen
funciones que podrían dar lugar a consultas de larga ejecución o consultas que dan
error.
Cabe destacar que si utiliza funciones que no están disponibles en el origen de
datos, Framework Manager intenta compensar utilizando procesamiento local en el
servidor de informes. Esto puede influir en el rendimiento de las consultas, porque
el trabajo se realiza en el servidor de informes en vez de en el servidor de origen
de datos.
En algunas situaciones, el procesamiento local puede necesitar recuperar más datos
del servidor de origen de datos, lo cual tiene un impacto tanto en el servidor de
origen de datos como en la red. Por ejemplo, las funciones OLAP no están
disponibles en un origen de datos relacionales. Si intenta utilizar funciones OLAP
con un origen de datos relacionales, Framework Manager utiliza la información de
dimensión en el origen de datos para generar un cubo local y ejecutar las
funciones OLAP contra el cubo. Esto requiere recuperar información de dimensión
del servidor de origen de datos y un procesamiento adicional en el servidor de
informes.
Definición de indicadores de calidad de servicio
La calidad de servicio de una función se especifica en el origen de datos y puede
definirse para una función particular o para todas las funciones del paquete.
Para obtener más información sobre las funciones individuales, consulte
Apéndice C, “Uso del editor de expresiones”, en la página 395.
La calidad de los indicadores de servicio son:
v No disponible (X)
Esta función no está disponible para ningún origen de datos del paquete.
v Disponibilidad limitada (!!)
La función no está disponible para algunos orígenes de datos del paquete.
v Soporte limitado (!)
La función está disponible para todos los orígenes de datos del paquete, pero no
está naturalmente soportada para este origen de datos. El software de IBM
Cognos utiliza una aproximación local para esta función. Puesto que se usa una
aproximación, el rendimiento puede ser bajo y los resultados pueden no ser los
previstos.
v Sin restricciones (marca de selección)
La función está disponible para todos los orígenes de datos.
Si hay más de un tipo de origen de datos en el modelo, los valores de calidad del
servicio se agregan de acuerdo con las siguientes reglas:
v Si la calidad del servicio está definida como Sin restricciones, Soporte limitado o
Disponibilidad limitada en un origen de datos y definida como No disponible en
otro origen de datos, la calidad del servicio para dicha función pasa a ser
Disponibilidad limitada.
v En el resto de los casos, se utiliza el denominador común más pequeño. Por
ejemplo, si la calidad del servicio es Sin restricciones en un origen de datos y
Soporte limitado en otro origen de datos, la calidad del servicio para dicha
función pasa a ser Soporte limitado. Si la calidad del servicio es Soporte limitado
en un origen de datos y Disponibilidad limitada en otro origen de datos, la
calidad del servicio para dicha función pasa a ser Disponibilidad limitada.
318 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Procedimiento
1. Pulse Proyecto, Lista de funciones de proyecto, Definir calidad de servicio.
2. Amplíe los nodos del árbol para ver la calidad del servicio de cada función.
3. Para reemplazar la calidad de servicio, pulse la flecha situada junto a cada
función y seleccione el indicador de calidad de servicio de la lista.
4. Después de cambiar la calidad del servicio, puede añadir información detallada
sobre la función del cuadro de texto a la derecha.
Esta información pasa a estar disponible para los usuarios y puede ayudarles a
determinar si deben utilizar esta función en su informes.
Sugerencia: Pulse Eliminar reemplazar para definir la calidad del servicio de
nuevo con su valor predeterminado.
5. Pulse Aceptar.
Control y optimización de consultas
Puede modificar las propiedades de un origen de datos que se ha creado
utilizando el Asistente de metadatos de IBM Cognos Framework Manager. Las
propiedades del origen de datos ayudan a controlar y optimizar el modo en que se
ejecutan las consultas en la base de datos.
No se pueden modificar las propiedades de un origen de datos que se ha creado
utilizando el portal. Estos orígenes de datos solo se pueden modificar en el portal.
Para obtener más información, consulte: IBM Cognos Guía de administración y
seguridad.
Propiedad de origen de datos Descripción
Nombre Nombre descriptivo de la conexión de
origen de datos proporcionada por el
usuario en el momento de la creación.
Procesamiento de consultas Determina si el procesamiento de SQL se
realiza por el servidor de bases de datos o si
se procesa localmente.
Procesamiento de resumen Determina si los resúmenes de agregado se
calculan localmente o en la base de datos.
Modo de acceso a transacción Especifica el modo de acceso de una nueva
transacción. Para obtener más información,
consulte: “Especificar modos de transacción”
en la página 315.
Modo de sentencia de transacción Especifica la acción que se debe realizar
cuando finaliza una transacción. Para
obtener más información, consulte:
“Especificar modos de transacción” en la
página 315.
Origen de datos de Content Manager Especifica el nombre del origen de datos tal
como se identifica en Content Manager. Si se
utiliza un origen de datos XML, esta
propiedad se debe parametrizar.
Capítulo 8. Gestión de proyecto 319

Propiedad de origen de datos Descripción
Catálogo Representa diferente información para bases
de datos distintas. Por ejemplo, si la base de
datos es SQL Server, el elemento contiene el
nombre de la base de datos; si la base de
datos es Oracle, no se utiliza.
Cubo Especifica el nombre del cubo.
Esquema Representa diferente información para bases
de datos distintas. Por ejemplo, para SQL
Server u Oracle, el elemento contiene el
nombre del propietario.
Tipo Especifica el tipo del objeto padre.
Tipo de consulta Especifica el tipo de modelo de consulta que
este origen de datos comprende. Por
ejemplo, los orígenes de SQL son
relacionales y los orígenes de MDS son
multidimensionales.
Interfaz de consulta Este elemento contiene dos letras, que
identifican el tipo de proveedor. Se mantiene
por la aplicación.
ID de conjunto de funciones Define el conjunto de funciones que se
aplica a un origen de datos. Se utiliza
cuando se rellenan inicialmente los
conjuntos de funciones de una vista de
seguridad al crear un paquete.
Mapas de parámetros Hace referencia a parameterMap que
representa un mapa de tablas de alias de
Oracle Essbase.
320 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Capítulo 9. Directrices de modelado de metadatos
IBM Cognos Framework Manager es una herramienta de modelado de metadatos
que controla la generación de consultas para IBM Cognos BI. Un modelo es una
colección de metadatos que incluye información física e información de la empresa
para uno o varios orígenes de datos. IBM Cognos BI permite la gestión del
rendimiento en orígenes de datos relacionales normalizados y desnormalizados, así
como una variedad de datos OLAP.
Para acceder a la documentación de IBM CognosDirectrices de modelado de metadatos
en un idioma diferente, vaya a ubicación_instalación\c10\webcontent\
documentation y abra la carpeta para el idioma que desee. Luego abra ug_best.pdf.
Introducción a los conceptos del modelado de IBM Cognos
Antes de empezar, debe comprender los conceptos fundamentales del modelado de
IBM Cognos acerca del modelado de metadatos para utilizarlos en la creación de
informes y análisis empresariales.
Conceptos de modelado relacional
Cuando se realiza un modelado en IBM Cognos Framework Manager, es
importante ser consciente de que no es necesario que el origen de datos que se
diseñe sea un esquema en estrella perfecto. Los esquemas en copo de nieve y otras
formas normalizadas también son aceptables, siempre que se optimice el origen de
datos para que ofrezca el rendimiento que necesita la aplicación. En general,
recomendamos crear un modelo lógico que se adapte a los conceptos de esquema
en estrella. Se trata de un requisito para IBM Cognos Analysis Studio y también se
ha comprobado que es un modo efectivo de organizar los datos para los usuarios.
Cuando empiece a desarrollar la aplicación con un origen de datos complejo, se
recomienda crear una vista simplificada que represente la forma en la que los
usuarios ven la empresa y que se diseñe siguiendo las directrices contenidas en
este documento para generar consultas y resultados predecibles. Un modelo
relacional bien construido actúa como base de la aplicación y proporciona un
punto de partida sólido si se opta por aprovechar las ventajas de las funciones
dimensionales del software de IBM Cognos.
Si se empieza con un origen de datos en esquema de estrella, se requiere un
esfuerzo menor para el modelado porque los conceptos empleados al crear un
esquema en estrella se prestan para la construcción de aplicaciones para consultas
y análisis. Las directrices de este documento le ayudarán en el diseño de un
modelo que satisfará las necesidades de la aplicación.
Cardinalidad
Entre dos asuntos de consulta, existen relaciones. La cardinalidad de una relación
es el número de filas relacionadas para cada uno de los dos asuntos de consulta.
Las filas se relacionan mediante la expresión de la relación; normalmente, esta
expresión hace referencia a las claves principal y foránea de las tablas subyacentes.
El software de IBM Cognos utiliza la cardinalidad de una relación de las siguientes
formas:
© Copyright IBM Corp. 2005, 2013 321

v Para evitar contar por partida doble los datos de hechos
v Para soportar uniones de bucle, habituales en modelos de esquema en estrella
v Para optimizar el acceso al sistema de origen de datos subyacente
v Para identificar asuntos de consulta que se comportan como hechos o
dimensiones
Una consulta que utiliza varios hechos de diferentes tablas subyacentes se divide
en consultas independientes para cada tabla de hechos subyacente. Cada consulta
de hecho único hace referencia a su tabla de hechos respectiva así como a las tablas
dimensionales relacionadas con la tabla de hechos. Se utiliza otra consulta para
combinar estas consultas individuales en un único conjunto de resultados.
Generalmente se hace referencia esta última operación como consulta enlazada. Se
puede reconocer que una consulta está enlazada cuando se muestra coalesce y
una unión externa completa.
Una consulta enlazada también permite que el software de IBM Cognos relacione
correctamente los datos en diferentes niveles de granularidad. Consulte: “Consultas
de varios hechos y granularidades” en la página 328.
Cardinalidad en consultas generadas:
El software de IBM Cognos soporta tanto la cardinalidad mínima y máxima como
la opcional.
En 0:1, 0 es la cardinalidad mínima, 1 es la cardinalidad máxima.
En 1:n, 1 es la cardinalidad mínima, n es la cardinalidad máxima.
Una relación con una cardinalidad especificada de 1:1 a 1:n se denomina
generalmente como 1 a n cuando se centra en las cardinalidades máximas.
Una cardinalidad mínima de 0 indica que la relación es opcional. Se especifica una
cardinalidad mínima de 0 si se desea que la retenga conserve la información en el
otro lado de la relación en ausencia de una coincidencia. Por ejemplo, una relación
entre un cliente y las ventas reales puede especificarse como 1:1 a 0:n. Indica que
los informes mostrarán la información de cliente solicitada incluso si no existieran
datos de ventas.
Por lo tanto una relación de 1 a n también se puede especificar como:
v 0:1 a 0:n
v 0:1 a 1:n
v 1:1 a 0:n
v 1:1 a 1:n
Utilice la sentencia Impacto de relación del cuadro de diálogo Definición de
relación para comprender mejor la cardinalidad. Por ejemplo, Sales Staff (1:1) está
unido a Orders (0:n).
322 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Es importante asegurarse de que la cardinalidad se capture correctamente en el
modelo porque determina la detección de asuntos de consulta de hechos y se
utiliza para evitar el recuento doble de datos de hechos.
Al generar consultas, el software de IBM Cognos sigue estas reglas básicas para
aplicar la cardinalidad:
v La cardinalidad se aplica en el contexto de una consulta.
v La cardinalidad 1 a n implica datos de hechos en el lado de n e implica datos de
dimensión en el lado de 1.
v Un asunto de consulta puede comportarse como un asunto de consulta de
hechos o un asunto de consulta dimensional, en función de las relaciones que
son necesarias para responder a una consulta determinada.
Utilice Model Advisor para ver una valoración del comportamiento implicado por
la cardinalidad del modelo.
Para obtener más información, consulte: “Consulta de hecho único” en la página
357 y “Consulta de varios hechos y consultas de granularidad múltiple en
dimensiones compatibles” en la página 359.
Cardinalidad en el contexto de una consulta:
El rol de la cardinalidad en el contexto de una consulta es importante porque la
cardinalidad se utiliza para determinar cuándo y dónde se debe dividir una
consulta al generar consultas de varios hechos. Si las dimensiones y los hechos se
identifican incorrectamente, se pueden crear innecesariamente consultas enlazadas,
lo que representa un coste para el rendimiento, o se pueden formar consultas
incorrectamente, lo que puede producir resultados incorrectos.
En los ejemplos siguientes, se muestra la forma en que el software de IBM Cognos
interpreta la cardinalidad.
Ejemplo: asuntos de consulta que se comportan como una dimensión y un hecho:
En este ejemplo, Sales Branch se comporta como una dimensión en relación a
Order Header y Order Header se comporta como un hecho en relación a Sales
Branch.
Capítulo 9. Directrices de modelado de metadatos 323

Ejemplo: cuatro asuntos de consulta incluidos en una consulta:
En este ejemplo, los cuatro asuntos de consulta se incluyen en una consulta. Sales
staff y Order details se tratan como hechos. Order header y Sales branch se tratan
como dimensiones.
El SQL generado para esta consulta se dividirá y tratará Sales staff y Order details
como hechos. Los resultados de estas dos subconsultas se enlazan utilizando la
información recuperada de Sales branch. Esto produce un informe que muestra la
información de Sales staff por Sales branch junto a la información de Order details
y Order header por Sales branch.
Ejemplo: tres asuntos de consulta incluidos en una consulta:
En este ejemplo, solo se incluyen tres asuntos de consulta en una consulta. Order
details no se utiliza. Order header se trata ahora como un hecho. Sales staff
continúa tratándose como un hecho.
El SQL de este ejemplo también genera una consulta enlazada, que devuelve un
resultado similar al de arriba. Tenga en cuenta que una operación de enlace retiene
información de ambos lados de la operación utilizando una unión externa
completa.
Determinantes
Los determinantes reflejan la granularidad mediante la representación de
subconjuntos o grupos de datos en un asunto de consulta y se utilizan para
asegurar la agregación correcta de estos datos repetidos. Los determinantes están
más directamente relacionados con el concepto de claves e índices del origen de
datos y se importan en función de la información de claves exclusivas y de índice
del origen de datos. Se recomienda revisar siempre los determinantes que se
importan y, si es necesario, modificarlos o crear otros nuevos. Mediante la
324 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

modificación de determinantes, puede reemplazar la información de índice y claves
del origen de datos, sustituyéndola por información mejor alineada con sus
necesidades de informe y análisis. Mediante la adición de determinantes, puede
representar grupos de datos repetidos que son pertinentes para su aplicación.
Un ejemplo de determinante único es Day en el ejemplo de Time siguiente. Un
ejemplo de determinante no único es Month; la clave de Month se repite para el
número de días de un mes determinado. Cuando se define un determinante no
único, se debe especificar Agrupar por. Indica al software de IBM Cognos que
cuando las claves o atributos asociados a este determinante se repitan en los datos,
se deben aplicar funciones de agregado y agrupación para evitar el recuento doble.
No se recomienda especificar determinantes que tengan seleccionadas las dos
opciones Identificado exclusivamente y Agrupar por o que no tengan ninguna de
ellas seleccionadas.
Year Key Month Key Month Name Day Key Day Name
2006 200601 January 06 20060101 Sunday, January
1, 2006
2006 200601 January 06 20060102 Monday, January
2, 2006
Se pueden definir tres determinantes para este conjunto de datos de la siguiente
forma: dos determinantes Agrupar por (Year y Month) y un determinante único
(Day). El concepto es similar al concepto de niveles y jerarquías, pero no idéntico.
Nombre del
determinante Clave Atributos
Identificado
exclusivamente Agrupar por
Year Year Key Ninguno No Sí
Month Month Key Month Name No Sí
Day Day Key Day Name Sí No
Month Key
Month Name
Year Key
En este caso, solo utilizamos una clave para cada determinante porque cada una de
ellas contiene suficiente información para identificar un grupo contenido en los
datos. Con frecuencia Month se convierte en un reto si la clave no contiene
suficiente información para aclarar el año al que pertenece el mes. Sin embargo, en
este caso, la clave de Month incluye la clave de Year y, por lo tanto por sí misma
es suficiente para identificar los meses como una subagrupación de años.
Nota: Aunque puede crear un determinante que agrupe meses sin el contexto de
años, es la opción menos común para la creación de informes porque se agruparían
todos los datos para febrero de todos los años, en lugar de todos los datos para
febrero de 2006.
Utilización de determinantes con claves de varias partes
En la dimensión de tiempo del ejemplo anterior, una clave era suficiente para
identificar cada conjunto de datos para un determinante, pero esto no es siempre
así.
Capítulo 9. Directrices de modelado de metadatos 325

Por ejemplo, la dimensión Geography siguiente utiliza definiciones de clave de
varias partes para todos los determinantes, excepto para uno.
Region Region Key State/Province Key City Key
North America USA Illinois Springfield
North America USA Missouri Springfield
North America USA California Dublin
Europe Ireland n/a Dublin
De forma similar al ejemplo sobre Time, puede definir tres determinantes para este
conjunto de datos, de la forma siguiente: dos determinantes Agrupar por (Region y
State/Province) y un determinante único (City).
Nombre del
determinante Clave Atributos
Identificado
exclusivamente Agrupar por
Region Region Key Ninguno No Sí
State/Province State/Province
Key
Ninguno No Sí
City
Region Key
Ninguno Sí No
State/Province
Key
City Key
En este caso, se ha utilizado Region Key, State/Province Key y City Key para
asegurar que City fuera única. Se ha utilizado esta opción porque en los datos
proporcionados, algunos nombres de ciudad se repetían entre los estados o
provincias, que a su vez se repetían para las regiones.
Los determinantes se evalúan en el orden en el que se especifican
No hay ningún concepto de jerarquía en los determinantes, pero existe un orden
de evaluación. Cuando el software de IBM Cognos consulta una selección de
elementos de un asunto de consulta, los compara con todos los determinantes
(claves y atributos), uno a uno, en el orden establecido en la pestaña
Determinantes. De esta forma, el software de IBM Cognos selecciona el
determinante que resulta ser la mejor coincidencia.
En el ejemplo siguiente, los atributos de mes actual, días del mes y nombres de
mes localizados se asocian a la clave Month. Cuando se envía una consulta que
hace referencia a cualquiera de estos atributos, el determinante Month es el primer
determinante en el que se cumplen los criterios de coincidencia. Si no se necesitan
otros atributos, la evaluación de determinantes se detiene en Month y se utiliza
este determinante para las cláusulas group y for en el SQL.
En los casos en que también se incluyen otros atributos de la dimensión, si estos
atributos no tienen ninguna coincidencia con un determinante anterior, el software
de IBM Cognos continúa la evaluación hasta que encuentra una coincidencia o
llega al último determinante. Por esta razón, un determinante único tiene todos los
elementos de consulta asociados. Si no se encuentra ninguna otra coincidencia, se
utiliza la clave única de todo el conjunto de datos para determinar cómo se
326 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

agrupan los datos.
Cuándo se deben utilizar determinantes
Aunque se pueden utilizar determinantes para resolver una variedad de problemas
relacionados con la granularidad de los datos, los casos principales en los que
siempre se deben utilizar son los siguientes:
v Un asunto de consulta se comporta como una dimensión que tiene varios niveles
de granularidad y se unirá en diferentes conjuntos de claves a datos de hechos.
Por ejemplo, Time tiene varios niveles y se une a Inventory en la clave Month y
a Sales en la clave Day. Para obtener más información, consulte: “Consultas de
varios hechos y granularidades” en la página 328.
v Surge la necesidad de contar o realizar otras funciones de agregado en una clave
o atributo que se repite.
Por ejemplo, Time tiene la clave Month y un atributo, Days in the month, que se
repite para cada día. Si desea utilizar Days in the month en un informe, no
desea la suma de Days in the month para cada día del mes. En su lugar, desea
el valor único de Days in the month para la clave Month que se ha elegido. En
SQL, es XMIN(Days in the month for Month_Key). También existe una cláusula
Group by en Cognos SQL.
Hay menos casos comunes en los que se necesita utilizar determinantes:
v Desea identificar de forma única la fila de datos al recuperar datos BLOB de
texto del origen de datos.
Para la consulta de blobs es necesaria información adicional de tipo de clave o
de índice. Si esta información no está presente en el origen de datos, puede
añadirla utilizando determinantes. Reemplace los determinantes importados del
origen de datos que entran en conflicto con las relaciones creadas para informe.
No puede utilizar claves de varios segmentos cuando el asunto de consulta
accede a datos blob. Con consultas de resumen, los datos blob se deben
recuperar por separado de la parte de resumen de la consulta. Para hacerlo,
necesita una clave que identifique de forma única la fila y que no tenga varios
segmentos.
Capítulo 9. Directrices de modelado de metadatos 327

v Se especifica una unión que utiliza menos claves que un determinante único que
se ha especificado para un asunto de consulta.
Si la unión se ha creado en base a un subconjunto de las columnas a las que
hacen referencia las claves de un determinante único en el lado de 0..1 o 1..1
de las relaciones, habrá un conflicto. Resuelva este conflicto modificando la
relación para que esté completamente de acuerdo con el determinante o
modificando el determinante para que soporte la relación.
v Desea reemplazar los determinantes importados del origen de datos que entran
en conflicto con relaciones creadas para informe.
Por ejemplo, hay determinantes en dos asuntos de consulta para varias
columnas pero la relación entre los asuntos de consulta solo utiliza un
subconjunto de estas columnas. Modifique la información de determinante del
asunto de consulta si no es adecuado para utilizar las columnas adicionales en la
relación.
Consultas de varios hechos y granularidades
Las consultas de varios hechos y granularidades en orígenes de datos relacionales
se producen cuando una tabla que contiene datos dimensionales se une a varias
tablas de hechos de diferentes columnas de claves.
Tenga en cuenta que, en esta sección, el término dimensión se utiliza en sentido
conceptual. Un asunto de consulta con la cardinalidad 1:1 o 0:1 se comporta como
una dimensión. Para obtener más información, consulte: “Cardinalidad” en la
página 321.
Un asunto de consulta dimensional tiene normalmente distintos grupos, o niveles,
de datos de atributos con claves que se repiten. Los estudios de IBM Cognos
realizan agregaciones automáticamente al nivel de granularidad común más bajo
presente en el informe. La posibilidad de que se produzcan recuentos dobles surge
cuando se crean totales en columnas que contienen datos repetidos. Cuando el
nivel de granularidad de los datos se modela correctamente, se puede evitar el
doble recuento.
Nota: Puede notificar datos a un nivel de granularidad por debajo del nivel común
más bajo. Esto hace que los datos de granularidad más alta se repitan, pero los
totales no se verán afectados si los determinantes se aplican correctamente.
En este ejemplo se muestran dos asuntos de consulta de hechos, Sales y Product
forecast, que comparten dos asuntos de consulta dimensionales, Time y Product.
328 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Time es el punto focal del problema de granularidad en este ejemplo. Sales se une
a Time en la clave Day, y Product forecast se une a Time en la clave Month.
Debido a las distintas claves de unión, se deben identificar claramente un mínimo
de dos determinantes en Time. Por ejemplo, los determinantes para Month y Day
tienen identificadas sus claves. Day es la clave exclusiva de Time, las claves de
Month se repiten para cada día del mes.
Por ejemplo, el determinante de Month es el siguiente.
Capítulo 9. Directrices de modelado de metadatos 329

El asunto de consulta Product puede tener al menos tres determinantes: Product
line, Product type y Product. Tiene relaciones con las dos tablas de hechos de la
clave Product. No hay problemas de granularidad con respecto al asunto de
consulta Product.
De forma predeterminada, se agrega un informe para recuperar registros de cada
tabla de hechos en el nivel de granularidad común más bajo. Si crea un informe
que utiliza Quantity de Sales, Expected volume de Product forecast, Month de
Time y Product name de Product, el informe recupera registros de cada tabla de
hechos en el nivel de granularidad común más bajo. En este ejemplo, es en nivel
de mes y producto.
Para evitar el recuento doble cuando existen datos en varios niveles de
granularidad, cree al menos dos determinantes para el asunto de consulta Time.
Por ejemplo, consulte: “Determinantes” en la página 324.
Month Product name Quantity Expected volume
April 2007 Aloe Relief 1,410 1,690
April 2007 Course Pro Umbrella 132 125
February 2007 Aloe Relief 270 245
February 2007 Course Pro Umbrella 1
February 2006 Aloe Relief 88 92
Si no especifica los determinantes apropiadamente en el asunto de consulta Time,
se puede producir una agregación incorrecta. Por ejemplo, los valores de Expected
volume que existen a nivel de Month en Product forecast se repiten para cada día
en el asunto de consulta Time. Si los determinantes no se establecen correctamente,
los valores para Expected volume se multiplican por el número de días del mes.
Month Product name Quantity Expected volume
April 2007 Aloe Relief 1,410 50,700
330 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Month Product name Quantity Expected volume
April 2007 Course Pro Umbrella 132 3,750
February 2007 Aloe Relief 270 7,134
February 2007 Course Pro Umbrella 29
February 2006 Aloe Relief 88 2,576
Observe los diferentes números de la columna Expected volume.
Consideraciones sobre el diseño de modelos
Cuando se crea un modelo, es importante comprender que no hay ningún flujo de
trabajo único que vaya a entregar un modelo adecuado para todas las aplicaciones.
Antes de empezar el modelo, es importante comprender los requisitos para la
funcionalidad, la facilidad de uso y el rendimiento de la aplicación. El diseño del
origen de datos y los requisitos de la aplicación determinarán la respuesta a
muchas de las preguntas formuladas en esta sección.
Cómo determinar dónde crear relaciones y determinantes
Una pregunta formulada con frecuencia es dónde se deben crear las relaciones. ¿Se
deben crear relaciones entre asuntos consulta de orígenes de datos, entre asuntos
de consulta de modelo o entre ambos? La respuesta puede variar porque depende
de la complejidad del origen de datos que se modela.
Cuando trabaje con asuntos de consulta de orígenes de datos, las relaciones y los
determinantes deben ir juntos.
Al trabajar con asuntos de consulta de modelo, debe tener en cuenta los efectos
laterales de utilizar relaciones y determinantes:
v El asunto de consulta de modelo empieza a funcionar como una vista, que
reemplaza al valor Como vista o Minimizado en el tipo Generación de SQL
para un asunto de consulta.
Esto significa que el SQL no cambia, independientemente de los elementos del
asunto de consulta a los que haga referencia. Para obtener más información,
consulte: “¿Qué es SQL minimizado?” en la página 332.
v El asunto de consulta de modelo se convierte en un objeto autónomo.
Esto significa que ya no se aplican relaciones subyacentes, excepto las que
existen entre los objetos a los que se hace referencia. Podría ser necesario crear
relaciones adicionales a partir de las previamente obtenidas de los metadatos de
los asuntos de consulta subyacentes.
v Cuando se crea un determinante en un asunto de consulta de modelo, se ignora
el determinante a menos que también se cree una relación.
Éste es un ejemplo de la relación en un asunto de consulta de modelo que
reemplaza deliberadamente el valor de SQL minimizado y simplifica el modelo.
En este ejemplo, Order Header y Order Details se combinan para que se
comporten como un único hecho. Se colocan en su propia carpeta y todas las
relaciones con ellos se suprimen, excepto la relación entre Order Header y Order
Details. Esta es la única relación relevante después de crear el asunto de consulta
de modelo y conectar relaciones.
Capítulo 9. Directrices de modelado de metadatos 331

Para decidir dónde se deben especificar las relaciones y determinantes en el
modelo, debe comprender el impacto del SQL minimizado en la aplicación.
Para obtener más información sobre relaciones, determinantes y SQL minimizado,
consulte los temas sobre Model Advisor de la publicación IBM Cognos Framework
Manager Guía del usuario.
¿Qué es SQL minimizado?
Cuando utiliza SQL minimizado, el SQL generado solo contiene el conjunto de
tablas mínimo y las uniones necesarias para obtener los valores para los elementos
de consulta seleccionados.
Para ver un ejemplo de lo que significa SQL minimizado, puede utilizar las
siguientes tablas Product. Cuatro asuntos de consulta, Product Line, Product Type,
Product y Product Multilingual están unidos entre sí.
Se pueden combinar en un asunto de consulta de modelo.
332 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Si prueba el asunto de consulta de modelo Products como una unidad, verá que se
hace referencia a cuatro tablas en la cláusula from de la consulta.
select
PRODUCT_LINE.PRODUCT_LINE_CODE as Product_Line_Code,
PRODUCT_LINE.PRODUCT_LINE_EN as Product_Line,
PRODUCT_TYPE.PRODUCT_TYPE_CODE as Product_Type_Code,
PRODUCT_TYPE.PRODUCT_TYPE_EN as Product_Type,
PRODUCT.PRODUCT_NUMBER as Product_Number,
PRODUCT_MULTILINGUAL.PRODUCT_NAME as Product_Name
PRODUCT_MULTILINGUAL.DESCRIPTION as Product_Description,
PRODUCT.INTRODUCTION_DATE as Introduction_Date,
PRODUCT.PRODUCT_IMAGE as Product_Image,
PRODUCT.PRODUCTION_COST as Production_Cost,
PRODUCT.MARGIN as Margin
from
gosl_82..gosl.PRODUCT_LINE PRODUCT_LINE,
gosl_82..gosl.PRODUCT_TYPE PRODUCT_TYPE,
gosl_82..gosl.PRODUCT PRODUCT,
gosl_82..gosl.PRODUCT_MULTILINGUAL PRODUCT_MULTILINGUAL
where
(PRODUCT_MULTILINGUAL."LANGUAGE" - N’EN’)
and
(PRODUCT_LINE.PRODUCT_LINE_CODE = PRODUCT_TYPE.PRODUCT_LINE_CODE)
and
(PRODUCT_TYPE.PRODUCT_TYPE_CODE = PRODUCT.PRODUCT_TYPE_CODE)
and
(PRODUCT.PRODUCT_NUMBER = PRODUCT_MULTILINGUAL.PRODUCT_NUMBER
Si solo prueba Product Name, verá que la consulta resultante únicamente utiliza
Product Multilingual, que es la tabla necesaria. Es el efecto del SQL minimizado.
select
PRODUCT_MULTILINGUAL.PRODUCT_NAME as Product_Name
from
gosl_82..gosl.PRODUCT_MULTILINGUAL PRODUCT_MULTILINGUAL
where
(PRODUCT_MULTILINGUAL."LANGUAGE" - N’EN")
Ejemplo: determinar cuándo es importante utilizar SQL minimizado
Si modela un origen de datos normalizado, puede interesarle más utilizar SQL
minimizado porque reducirá el número de tablas utilizadas en algunas solicitudes
y mejorará el rendimiento. En este caso, sería mejor crear relaciones y
Capítulo 9. Directrices de modelado de metadatos 333

determinantes entre los asuntos de consulta de orígenes de datos y luego crear
asuntos de consulta de modelo que no tengan relaciones.
Existe la idea equivocada de que si no hay relaciones entre objetos, no se pueden
crear grupos de esquema en estrella. No es cierto. Seleccione los asuntos de
consulta de modelo que deben incluirse en el grupo y utilice el asistente
Agrupaciones de esquemas en estrella. O bien puede crear atajos y moverlos a un
nuevo espacio de nombres. No hay necesidad de que hayan atajos para las
relaciones; esta característica es meramente visual en el diagrama. El efecto en la
generación y presentación de consultas en los estudios es el mismo.
Ejemplo: determinar cuándo SQL minimizado no es tan importante
como las consultas predecibles
Pueden haber algunos elementos en un origen de datos que se deban resumir para
garantizar que se comporten como si fueran un objeto de datos. Un ejemplo puede
ser una tabla de seguridad que debe unirse siempre a un hecho. En el modelo
Great Outdoors Sales, Order Header y Order Details son un conjunto de tablas que
combinadas representan un hecho y se desea que siempre se consulten a la vez.
Por ejemplo, consulte: “Cómo determinar dónde crear relaciones y determinantes”
en la página 331.
¿Qué es el almacenamiento en memoria caché de metadatos?
IBM Cognos Framework Manager almacena los metadatos que se importan del
origen de datos. Sin embargo, en función de los valores del regulador y
determinadas acciones que se pueden realizar en el modelo, es posible que estos
metadatos no se utilicen al preparar una consulta.
Si habilita el regulador Permitir portabilidad de modelo mejorada en tiempo de
ejecución, Framework Manager siempre consulta el origen de datos para obtener
información sobre los metadatos antes de preparar una consulta. Si no ha
habilitado este regulador, en la mayoría de casos Framework Manager accede a los
metadatos que se han almacenado en el modelo en lugar de consultar el origen de
datos. Las excepciones principales son:
v El SQL de un asunto de consulta de orígenes de datos se ha modificado. Se
incluye el uso de macros.
v Se ha añadido un cálculo o filtro a un asunto de consulta de orígenes de datos.
Nota: La mayoría de proveedores de sistemas de gestión de bases de datos
relacionales soporta perfectamente las consultas de metadatos generadas, por lo
que no deberían tener un impacto apreciable en la mayoría de aplicaciones de
creación de informes.
Asuntos de consulta frente a dimensiones
Los asuntos de consulta y las dimensiones sirven para diferentes propósitos. El
asunto de consulta se utiliza para generar consultas relacionales y se puede crear
utilizando reglas de esquema en estrella, mientras que la dimensión se utiliza para
el modelado dimensional de orígenes relacionales, que incorpora el
comportamiento OLAP. Como los asuntos de consulta son la base de las
dimensiones, un criterio de éxito clave para cualquier modelo dimensional es un
modelo relacional sólido.
Un modelo dimensional solo es necesario si desea utilizar IBM Cognos Analysis
Studio, para detallar más y menos en informes, o para acceder a funciones de
miembro en los estudios. Para muchas aplicaciones, no es necesaria la
funcionalidad OLAP. Por ejemplo, la aplicación se utiliza principalmente para
334 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

consultas o creación de informes ad hoc sin necesidad de detallar más y menos. O
bien mantiene un modelo IBM Cognos ReportNet. En estos casos, puede decidir
publicar paquetes basados en asuntos de consulta únicamente.
Los determinantes para asuntos de consulta no son igual a los niveles y jerarquías
de dimensiones regulares pero están estrechamente relacionados con una jerarquía
única. Si piensa utilizar los asuntos de consulta como base para dimensiones, debe
tomar en consideración la estructura de las jerarquías que espera crear y
asegurarse de que ha creado determinantes que soportarán resultados correctos en
la agregación. Asegúrese de que se cumplen las condiciones siguientes:
v El asunto de consulta debe tener especificado un determinante para cada nivel
de la jerarquía en la dimensión regular.
v Los determinantes se deben especificar en el mismo orden que los niveles de la
dimensión regular.
v Si espera disponer de varias jerarquías cuya agregación se realice de forma
diferente, es posible que deba considerar la creación de un asunto de consulta
adicional con diferentes determinantes como origen para la otra jerarquía.
Con la creación de un modelo relacional completo que entregue resultados
correctos y un buen rendimiento, dispondrá de una base sólida para desarrollar un
modelo dimensional. Además, si se asegura de que existe una capa de objetos de
modelo, ya sean asuntos de consulta o dimensiones, entre el origen de datos y los
objetos expuestos en los estudios, podrá proteger mejor a los usuarios con respecto
a los cambios.
Objetos de modelo frente a atajos
La diferencia principal entre los objetos de modelo y los atajos es que los objetos
de modelo ofrecen la libertad de incluir o excluir elementos y cambiarles el
nombre. Puede utilizar objetos de modelo en lugar de atajos si necesita limitar los
elementos de la consulta incluidos o para cambiar los nombres de elementos.
Los atajos son menos flexibles desde el punto de vista de la presentación que los
objetos de modelo, pero necesitan mucho menos mantenimiento porque se
actualizan automáticamente cuando se actualiza el objeto de destino. Si el
mantenimiento es una cuestión clave y no hay necesidad de personalizar el aspecto
del asunto de consulta, utilice atajos.
IBM Cognos Framework Manager dispone de dos tipos de atajos:
v Los atajos regulares, que son una mera referencia al objeto de destino.
v Los atajos de alias, que se comportan como si fueran una copia del objeto
original con comportamiento completamente independiente. Los atajos de alias
solo están disponibles para asuntos de consulta y dimensiones.
Los atajos regulares se utilizan generalmente como dimensiones compatibles con
grupos de esquema en estrella que crean varias referencias con el mismo nombre y
aspecto en varios lugares. En el ejemplo siguiente, los atajos creados para Products
y Order Time se comportan como referencias. Si se escribe una consulta que toma
Products tanto de Product Forecast como de Sales Target, la consulta utiliza la
definición de Products basada en el original y esta definición solo aparece una vez
en la consulta.
Capítulo 9. Directrices de modelado de metadatos 335

Normalmente, los atajos de alias se utilizan en dimensiones de rol o en tablas
compartidas. Como ya existe un ejemplo de dimensiones de rol en este documento,
expondremos el caso de tablas compartidas. En este ejemplo, Sales Staff y Sales
Branch se pueden tratar como jerarquías diferentes. Por lo que indican los datos,
sabemos que debido a que el personal se puede mover entre sucursales,
necesitamos poder informar de los pedidos para Sales Branch y Sales Staff tanto de
forma independiente como conjunta. Para conseguirlo, debemos crear un alias para
Sales Branch que se pueda utilizar como nivel en la jerarquía Sales Staff.
Con el nuevo atajo de alias, es posible crear consultas que necesiten pedidos por
Sales Branch y pedidos por Sales Staff con la información de su sucursal actual
simultáneamente.
Cuando se abre un modelo de una versión anterior, el regulador Procesamiento de
atajos tiene el valor Automático. Cuando se utiliza Automático, los atajos
funcionan igual que en versiones anteriores, es decir, un atajo que existe en la
misma carpeta que su destino se comporta como un alias, o instancia
independiente, mientras que un atajo que existe en otro lugar del modelo se
comporta como una referencia para el original. Para aprovechar las ventajas de la
propiedad Tratar como, se recomienda verificar el modelo y, cuando se repare,
cambiar el regulador a Explícito. La operación de reparación cambia todos los
atajos al valor correcto de la propiedad Tratar como en función de las reglas que
336 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

sigue el valor Automático, es decir, no debe haber ningún cambio en el
comportamiento del modelo a menos que elija realizar uno o varios cambios en las
propiedades Tratar como de los atajos.
Cuando se crea un modelo, el regulador Procesamiento de atajos tiene siempre el
valor Explícito.
Cuando el regulador se establece en Explícito, el comportamiento del atajo se toma
de la propiedad Tratar como y el usuario tiene todo el control sobre cómo se
comportan los atajos sin necesidad de preocuparse del lugar del modelo en el que
están ubicados.
Carpetas frente a espacios de nombres
Lo más importante que se debe saber sobre los espacios de nombres es que cuando
ya se ha empezado a crear informes, los cambios efectuados en los nombres de los
espacios de nombres publicados afectarán al contenido de IBM Cognos. Esto es así
porque al cambiar el nombre de un espacio de nombres, se cambian los ID de los
objetos publicados en los metadatos. Como el espacio de nombres se utiliza como
parte del ID del objeto en IBM Cognos Framework Manager, cada espacio de
nombres debe tener un nombre exclusivo en el modelo. Cada objeto de un espacio
de nombres también debe tener un nombre exclusivo. Parte de la estrategia de los
grupos de esquema en estrella es colocar atajos en un espacio de nombres
separado, que automáticamente crea un ID exclusivo para cada objeto del espacio
de nombres. En el caso de base de datos relacionales, nos permitirá utilizar el
mismo nombre para atajos de dimensiones conformadas en diferentes grupos de
esquema en estrella.
La próxima vez que intente ejecutar una consulta, un informe o un análisis en el
modelo actualizado, obtendrá un error. Si es necesario cambiar el nombre del
espacio de nombres que ha publicado, utilice Analizar el impacto de la
publicación para determinar a qué informes afecta.
Las carpetas son mucho más sencillas que los espacios de nombres. Tienen una
finalidad meramente organizativa y no afectan a los ID de los objetos ni a su
contenido. Puede crear carpetas para organizar objetos por asunto o área funcional.
Esto facilitará la localización de los metadatos, especialmente en proyectos grandes.
El inconveniente principal de las carpetas es que necesitan nombres exclusivos
para todos los asuntos de consulta, dimensiones y atajos. Por lo tanto no son la
solución ideal para contener objetos compartidos.
Establecimiento del orden de las operaciones para cálculos de
modelo
En algunos casos, normalmente para cálculos relacionados con proporciones, es útil
realizar la agregación en los términos del cálculo antes de la operación matemática.
Por ejemplo, el siguiente hecho Order details contiene información sobre cada
pedido:
Capítulo 9. Directrices de modelado de metadatos 337

Margin es un cálculo cuyo resultado es la tasa de beneficio:
Margin = (Revenue - Product cost) / Revenue
Si ejecutamos una consulta para mostrar Revenue, Product cost y Margin para
cada producto utilizando el hecho Order details, obtenemos los resultados
siguientes:
Product number Revenue Product cost Margin
1 $23,057,141 $11,292,005 61038%
2 $11,333,518 $6,607,904 49606%
Observe que el valor para Margin parece incorrecto. Es debido al orden de
operaciones que se ha utilizado en el cálculo de Margin. Margin se calcula del
modo siguiente:
Margin = sum( (Revenue - Product cost) / Revenue )
La agregación ha tenido lugar después de la operación matemática y, en este caso,
produce resultados no deseados.
Para producir los valores deseados para Margin, se debe realizar la agregación
antes de la operación matemática:
Margin = ( sum(Revenue) - sum(Product cost) ) / sum(Revenue)
Esto produce el siguiente resultado:
Product number Revenue Product cost Margin
1 $23,057.141 $11,292,005 51.03%
2 $11,333,518 $6,607,904 41.70%
En IBM Cognos Framework Manager puede conseguir esto creando un cálculo
independiente para Margin y estableciendo su propiedad Agregado regular en
Calculado. Cada elemento de consulta de la expresión del cálculo se agrega según
lo especificado en su propiedad Agregado regular. Las propiedades de Agregado
338 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

egular para Revenue y Product cost se establecen en Sum y, por lo tanto, al
realizar el cálculo, se utiliza sum para agregar estos términos.
Nota: El tipo de agregación calculado no está soportado para los cálculos
integrados en asuntos de consulta. Solo está soportado para cálculos autónomos y
para cálculos integrados dentro de dimensiones de medida y que se basan en
medidas de la misma dimensión de medida.
Por ejemplo, considere el cálculo Margin que está integrado en la dimensión de
medida Sales:
En este ejemplo, Margin se basa en las medidas Product cost y Revenue que se
encuentran dentro de la misma dimensión de medida, Sales. Si la propiedad
Agregado regular para Margin se establece en Calculado, se acumula del siguiente
modo:
Margin = sum(Revenue - Product cost ) / sum(Revenue)
Si Margin se basa en los elementos de consulta de origen de las medidas Product
cost y Revenue (Sales (model).Product cost, Sales (model).Revenue), la agregación
calculada no está soportada y la agregación se comporta como automática. En este
caso, Margin se acumula del siguiente modo:
Margin = sum( Revenue - Product cost) / Revenue)
Para obtener más información sobre cómo modificar el modo de agregación de
elementos de consulta, consulte la publicación IBM Cognos Framework Manager Guía
del usuario.
Impacto del tamaño del modelo
El tamaño del modelo puede afectar a la eficiencia de la aplicación Framework
Manager.
Los modelos muy grandes causarán tiempos de procesamiento prolongados y, en
casos extremos, que se agote la memoria. Acciones como Analizar el impacto de la
publicación, Buscar dependencias de informe, Publicar paquetes y Ejecutar Model
Advisor se ejecutan de forma óptima en modelos inferiores a 50 megabytes.
Conceptos de modelado dimensional
Las dimensiones regulares y de medida se utilizan para habilitar la presentación
OLAP de metadatos, detallar más y detallar menos, así como una variedad de
funciones OLAP. Debe utilizar grupos de esquema en estrella (un hecho con varias
dimensiones) si desea utilizar IBM Cognos Analysis Studio con un origen de datos
relacionales.
Al crear un modelo, se recomienda crear dimensiones regulares de modelo y
dimensiones de medida de modelo basadas en un modelo relacional en el que se
hayan aplicado conceptos de esquema en estrella.
Capítulo 9. Directrices de modelado de metadatos 339

Aunque los asuntos de consulta de orígenes de datos se pueden convertir en
dimensiones de origen de datos, éstas tienen una funcionalidad limitada en
comparación con los asuntos de consulta o dimensiones de modelo, y no se
recomiendan para uso general.
Dimensiones regulares
Las dimensiones regulares representan datos descriptivos que proporcionan
contexto para datos modelados en dimensiones de medida. Una dimensión regular
se divide en grupos de información denominados niveles. A su vez, los distintos
niveles se pueden organizar en jerarquías. Por ejemplo, la dimensión de un
producto puede contener los niveles Product Line, Product Type y Product
organizados en una única jerarquía denominada Product. Otro ejemplo es una
dimensión de tiempo que tiene los niveles Year, Quarter, Month, Week y Day,
organizados en dos jerarquías. La primera jerarquía YQMD contiene los niveles
Year, Quarter, Month y Day, la otra jerarquía YWD contiene los niveles Year, Week
y Day.
La definición más sencilla de un nivel consta de una clave de empresa y un título,
donde cada uno de estos elementos hace referencia a un elemento de consulta. Una
instancia (o fila) de un nivel se define como miembro de ese nivel. Se identifica por
un nombre exclusivo de miembro, que contiene los valores de las claves de
empresa de los niveles actual y superior. Por ejemplo,
[gosales].[Products].[ProductsOrg].[Product]->[All Products].[1].[1].[2]
identifica un miembro que se encuentra en el cuarto nivel, Product, de la jerarquía
ProductsOrg de la dimensión [Products] que se encuentra en el espacio de
nombres [gosales]. El título para este producto es TrailChef Canteen, que es el
nombre que aparece en el árbol de metadatos y en el informe.
El nivel se puede definir como exclusivo si la clave de empresa es suficiente para
identificar cada conjunto de datos para un nivel. En el modelo Great Outdoors
Sales, los miembros del nivel Product no necesitan la definición de tipo Product
porque muchos tipos de producto diferentes no tienen números de producto
asignados. Un nivel que no está definido como exclusivo es similar a un
determinante que utiliza claves de varias partes porque se necesitan claves de
niveles superiores de granularidad. Consulte: “Utilización de determinantes con
claves de varias partes” en la página 325. Si miembros de los miembros ancestro
no son exclusivos pero el nivel se ha identificado como exclusivo, los datos para
los miembros no exclusivos se informan como un único miembro. Por ejemplo, si
City se define como exclusivo y se identifica por el nombre, los datos para London,
England y London, Canada, se combinarán.
Dimensiones de medida
Las dimensiones de medida representan los datos cuantitativos descritos por
dimensiones regulares. Una dimensión de medida, denominada de muchas otras
formas en distintos productos OLAP, es simplemente el objeto que contiene los
datos de hechos. Las dimensiones de medida difieren de los asuntos de consulta
de hechos porque no incluyen las claves foráneas utilizadas para unir un asunto de
consulta de hechos a un asunto de consulta dimensional. Esto es debido a que la
dimensión de medida no está pensada para unirse como si fuera un objeto de
datos relacional. Para la generación de consultas, una dimensión de medida deriva
su relación con una dimensión regular a través de los asuntos de consulta
subyacentes. De forma similar la relación con otras dimensiones de medida se
realiza a través de dimensiones regulares que se basan en asuntos de consulta
creados para comportarse como dimensiones compatibles. Para habilitar consultas
340 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

de varios hechos y granularidad múltiple, debe haber creado correctamente los
asuntos de consulta y determinantes antes de crear dimensiones de consulta
regulares y dimensiones de medida.
Relaciones de ámbito
Las relaciones de ámbito solo existen entre las dimensiones de medida y las
dimensiones regulares para definir el nivel en el que las medidas están disponibles
para la creación de informes. No son iguales que las uniones y no influyen en la
cláusula Where. No existen condiciones ni criterios establecidos en una relación de
ámbito para regular cómo se forma una consulta, solo especifica si una dimensión
se puede consultar con un hecho especificado. La ausencia de una relación de
ámbito puede generar un error en tiempo de ejecución o causar que los datos de
hechos se acumulen en un nivel superior al esperado según los demás elementos
del informe.
Si se establece la relación de ámbito para la dimensión de medida, se aplican los
valores a todas las medidas de la dimensión de medida. Si se notifican los datos a
un nivel diferente para las medidas de la dimensión de medida, puede establecer
el ámbito en una medida. Puede especificar el nivel más bajo en el que se pueden
notificar los datos.
En este ejemplo, la dimensión de medida Sales Target solo tiene una medida que
está en el ámbito del nivel Order Month de la dimensión Order Time y en el nivel
Product de la dimensión Product. Esto significa que si los usuarios intentan
acceder a los detalles más allá del nivel de mes, verán datos repetidos.
Creación del modelo relacional
El modelado dimensional de orígenes de datos relacionales está disponible en IBM
Cognos Framework Manager, sin embargo depende de la existencia de un modelo
relacional sólido.
IBM Cognos ReportNet proporcionaba algunas prestaciones dimensionales para
permitir la consulta de hechos múltiples y evitar el recuento doble. Con
posterioridad a IBM Cognos ReportNet, el software de IBM Cognos dispone de
características diseñadas explícitamente para la representación dimensional de
metadatos y la función OLAP con orígenes de datos relacionales. Los conceptos
aplicados al modelado relacional en IBM Cognos ReportNet se han mantenido con
unos pocos cambios, que se encuentran documentados en la publicación Framework
Manager Guía del usuario.
Cuando cree un nuevo modelo de Framework Manager, seguirá un conjunto de
pasos comunes para definir la generación de consultas aunque no tenga previsto
utilizar las prestaciones de modelado dimensional. Debe modelar
dimensionalmente un origen de datos relacionales cuando desee utilizarlo en IBM
Capítulo 9. Directrices de modelado de metadatos 341

Cognos Analysis Studio, para permitir detallar más o menos en informes o para
acceder a funciones de miembro en los estudios.
Definición de la base de modelado dimensional
Un modelo es un conjunto de objetos relacionados necesarios para una o varias
aplicaciones de creación de informes relacionadas. Un modelo relacional sólido es
la base de un modelo dimensional.
Cuando defina la base de modelado, tenga en cuenta lo siguiente:
v Importación de los metadatos. Para obtener más información sobre la
importación, consulte la publicación IBM Cognos Framework Manager Guía del
usuario.
v “Verificación de metadatos importados”.
v “Resolución de relaciones ambiguas” en la página 343.
v Simplificación del modelo relacional mediante el uso de conceptos de esquema
en estrella, el análisis de la cardinalidad de los hechos y dimensiones y la
determinación dónde se deben colocar las relaciones y determinantes
“Consideraciones sobre el diseño de modelos” en la página 331.
v Añadir seguridad de datos, si es necesario. Para obtener información acerca de
la seguridad de los datos, consulte: Framework Manager Guía del usuario.
A continuación, puede definir la representación dimensional del modelo si es
necesario, y organizar el modelo para la presentación.
Verificación de metadatos importados
Después de importar metadatos, debe comprobarlos.
Verifique estas áreas:
v Relaciones y cardinalidad
v determinantes
v La propiedad Uso para los elementos de consulta
v La propiedad Agregado regular para los elementos de consulta
Las relaciones y la cardinalidad se explican aquí. Para obtener información sobre
las propiedades Uso y Agregado regular, consulte: Framework Manager Guía del
usuario.
Análisis de la cardinalidad para hechos y dimensiones:
La cardinalidad de una relación define el número de filas de una tabla que están
relacionadas con las filas de otra tabla en función de un conjunto (o unión) de
claves determinado. El software de IBM Cognos utiliza la cardinalidad para
deducir qué asuntos de consulta se comportan como hechos o dimensiones. El
resultado es que el software de IBM Cognos puede resolver automáticamente una
forma común de unión de bucle causada por datos de esquema en estrella cuando
hay tablas de hechos múltiples unidas a un conjunto común de tablas de
dimensión.
Para garantizar consultas previsibles, es importante comprender cómo se utiliza la
cardinalidad y aplicarla correctamente en el modelo. Se recomienda examinar el
esquema del origen de datos subyacente y las áreas de direcciones donde la
cardinalidad identifica incorrectamente hechos o dimensiones que pueden causar
342 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

esultados de consulta imprevisibles. La característica Model Advisor de
Framework Manager se puede utilizar como ayuda para comprender la forma en
que se interpreta la cardinalidad.
Para obtener más información, consulte: “Cardinalidad” en la página 321.
Resolución de relaciones ambiguas
Se pueden producir relaciones ambiguas cuando los datos representados por un
asunto de consulta o una dimensión se pueden visualizar en más de un contexto o
rol, o se pueden unir de más de una manera.
Las relaciones ambiguas más comunes son:
v “Dimensiones de rol”
v “Uniones de bucle” en la página 346
v “Relaciones reflexivas y recursivas” en la página 347
Puede utilizar Model Advisor para resaltar las relaciones que pueden causar
problemas para la generación de consultas y resolverlos de una de las maneras
describas abajo. Tenga en cuenta que hay otras maneras de resolver problemas de
los que se explican aquí. El objetivo principal es habilitar las rutas de consulta
claras.
Dimensiones de rol:
Una tabla con varias relaciones válidas entre ella y otra tabla se denomina
dimensión de rol. Normalmente, esto se da en dimensiones como Time y
Customer.
Por ejemplo, el hecho Sales tiene varias relaciones con el asunto de consulta Time
en las claves Order Day, Ship Day y Close Day.
Elimine las relaciones para los objetos importados, los asuntos de consulta de
hechos y los asuntos de consulta dimensionales de rol. Cree un asunto de consulta
de modelo para cada rol. Considere la exclusión de elementos de consulta
innecesarios para reducir la longitud del árbol de metadatos mostrado a los
usuarios. Asegúrese de que existe una única relación apropiada entre cada asunto
de consulta de modelo y el asunto de consulta de hecho. Nota: Esto reemplazará el
valor de SQL minimizado pero dada una única representación de tabla de la
Capítulo 9. Directrices de modelado de metadatos 343

dimensión de tiempo, no se considera problemático en este caso.
Decida cómo se deben utilizar estos roles con otros hechos que no comparten los
mismos conceptos. Por ejemplo, el hecho Product forecast solo tiene una clave de
tiempo. Necesita conocer sus datos y negocios para determinar si todos o alguno
de los roles creados para Time son aplicables al hecho Product forecast.
En este ejemplo, puede realizar lo siguiente:
v Crear un asunto de consulta adicional para que sea la dimensión de tiempo
compatible y darle un nombre que indique claramente que es una dimensión
compatible.
Escoja el rol más común que va a utilizar. Luego puede asegurarse de que esta
versión se une a todos los hechos que la necesitan. En este ejemplo, se ha
elegido Close Day.
344 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

v Puede tratar Ship Day, Order Day y Close Day como asuntos de consulta de
tiempo intercambiables con el hecho Product forecast.
En este caso, debe crear uniones entre cada una de las dimensiones de rol y el
hecho Product forecast. Cuando realice consultas del hecho Product forecast
podrá utilizar solo una dimensión de tiempo a la vez ya que, de lo contrario, es
posible que su informe no contenga datos. Por ejemplo, Month_key=Ship Month
Key (200401) y Month key=Close Month Key (200312).
Capítulo 9. Directrices de modelado de metadatos 345

Si se realiza un modelado dimensional, utilice cada asunto de consulta de modelo
como origen para una dimensión regular, y asigne un nombre apropiado a la
dimensión y jerarquías. Asegúrese de que haya una relación de ámbito
correspondiente específica de cada rol.
Uniones de bucle:
Las uniones de bucle del modelo son normalmente una fuente de comportamiento
imprevisible. No se incluyen las uniones de bucle de esquema en estrella.
Nota: Cuando la cardinalidad identifica claramente hechos y dimensiones, el
software de IBM Cognos puede resolver automáticamente uniones de bucle
causadas por datos de esquema en estrella cuando dispone de varias tablas de
hechos unidas a un conjunto de tablas de dimensiones común.
En el caso de uniones de bucle, los asuntos de consulta definidos ambiguamente
son el principal signo de problemas. Cuando los asuntos de consultas se definen
ambiguamente y forman parte de una unión de bucle, las uniones utilizadas en
una consulta determinada se deciden en función de un número de factores, como
pueden ser la ubicación de las relaciones, el número de segmentos en las rutas de
unión y, si todo lo demás es igual, la primera ruta de unión del orden alfabético.
Esto crea confusión entre los usuarios y se recomienda que se modele para
identificar claramente las rutas de unión.
Personal de ventas y Sucursal proporcionan un buen ejemplo de una unión de
bucle con asuntos de consulta definidos ambiguamente.
En este ejemplo, es posible unir Sucursal directamente a Pedido o a través de
Personal de ventas a Pedido. El principal problema es que cuando Sucursal y
346 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Pedido están juntos, se obtiene un resultado diferente de cuando la ruta de unión
es de Sucursal a Personal de ventas y a Pedido. Esto se debe a que los empleados
se pueden mover entre sucursales, por lo que los empleados que se han movido
durante al año se acumulan en la sucursal actual, aunque muchas de las ventas
que hayan realizado sean atribuibles a su sucursal anterior. Debido a la forma en
que se modela, no existe garantía de la ruta de unión que se elegirá y es probable
que varíe en función de los elementos que se seleccionen en la consulta.
Relaciones reflexivas y recursivas:
Las relaciones reflexivas y recursivas implican dos o más niveles de granularidad.
IBM Cognos Framework Manager importa relaciones reflexivas pero no las utiliza
al ejecutar consultas. Las relaciones reflexivas, que también son automáticas, solo
aparecen en el modelo para su representación.
Para crear una relación reflexiva que funcione, puede crear un atajo de alias, una
copia del asunto de consulta de orígenes de datos o un asunto de consulta de
modelo. Después, se crea una relación entre el asunto de consulta original y el
nuevo. La mejor opción para la flexibilidad suele ser la utilización de un asunto de
consulta de modelo porque se pueden especificar qué elementos de consulta se
Capítulo 9. Directrices de modelado de metadatos 347

incluyen en el asunto de consulta. Los atajos son la mejor solución desde el punto
de vista de mantenimiento. Para obtener más información, consulte: “Objetos de
modelo frente a atajos” en la página 335.
Por ejemplo, el asunto de consulta Sales Staff tiene una relación recursiva entre
Sales_Staff_Code y Manager_Code.
Cree un asunto de consulta de modelo que represente Manager. Cree una relación
con un valor de 1..1 a 1..n entre Manager y Sales Staff. A continuación,
combínelos en un nuevo asunto de consulta de modelo.
Para una estructura de dos niveles simple que utiliza un asunto de consulta de
modelo para Manager que se basa en Sales Staff, el modelo tiene este aspecto:
Para una jerarquía recursiva y equilibrada, repita este procedimiento para cada
nivel adicional de la jerarquía.
Para una jerarquía muy recursiva o desequilibrada, recomendamos que ésta se
aplane en el origen de datos y que se modele la jerarquía plana en una dimensión
regular.
348 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Simplificación del modelo relacional
Puede simplificar el modelo mediante la aplicación de conceptos de esquema en
estrella a los datos dimensionales y los datos de hechos.
Modelado de asuntos de consulta que representan datos descriptivos:
El modelado dimensional de IBM Cognos necesita que se apliquen los principios
de esquema en estrella a las capas lógicas del modelo.
Los orígenes de datos normalizados o en copo de nieve tienen con frecuencia
varias tablas que describen un único concepto empresarial. Por ejemplo, una
representación normalizada de Product puede incluir cuatro tablas relacionadas
mediante relaciones 1..n. Cada Product Line tiene uno o varios Product Types.
Cada Product Type tiene uno o varios Products. Los Products tienen nombres y
descripciones en varios idiomas por lo que existen en la tabla de consulta Product
Multilingual.
Una manera de simplificar el modelo es crear un asunto de consulta de modelo
para cada concepto descriptivo empresarial. Es posible que los usuarios no
conozcan la relación entre los asuntos de consulta individuales por lo que es útil
agruparlos; además, al tener que expandir cada objeto de modelo y seleccionar un
elemento de consulta se necesita más esfuerzo.
El paso siguiente del análisis es crear una dimensión regular con un nivel para
cada asunto de consulta.
Modelado de datos de hechos:
Los orígenes de datos tienen, con frecuencia, tablas maestro-detalle que contienen
hechos. Por ejemplo, cuando se utilizan las tablas Encabezado de pedido y Detalles
de pedido para insertar y actualizar datos, la estructura maestro-detalle tiene
ventajas. Cuanto se utilizan estas tablas para la creación de informes y análisis, se
pueden combinar en un concepto lógico empresarial para simplificar el modelo. O
también puede insertar una dimensión entre ellas, como Elementos devueltos. La
solución que elija dependerá de sus requisitos.
Capítulo 9. Directrices de modelado de metadatos 349

Para simplificar el modelo de este ejemplo, aplique conceptos de esquema en
estrella para crear un asunto de consulta de modelo que combine claves foráneas
de Encabezado de pedido y Detalles de pedido e incluya todas las medidas en el
nivel de Detalles de pedido. Este asunto de consulta se debe unir a los mismos
asuntos de consulta a los que se han unido Encabezado de pedido y Detalles de
pedido. Puede eliminar las relaciones originales de los dos asuntos de consulta de
orígenes de datos, excepto la relación que define la unión entre ellos. Para ver una
explicación de los pros y los contras de crear relaciones con asuntos de consulta de
modelo, consulte los ejemplos de “¿Qué es SQL minimizado?” en la página 332.
En el ejemplo de abajo, Encabezado de pedido y Detalles de pedido se han
combinado en un nuevo asunto de consulta de modelo denominado Ventas. Este
asunto de consulta se ha unido a Producto, Tiempo y Método de pedido.
El paso siguiente del análisis es crear una dimensión de medida basada en el
asunto de consulta de modelo.
Definición de la representación dimensional del modelo
El modelado dimensional de orígenes de datos relacionales es una prestación
disponible en IBM Cognos Framework Manager. Puede modelar dimensiones con
350 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

jerarquías y niveles, y los hechos pueden tener varias medidas. Luego puede
relacionar las dimensiones con las medidas mediante la definición del ámbito en el
modelo.
Debe modelar dimensionalmente un origen de datos relacionales cuando desee
utilizarlo en IBM Cognos Analysis Studio, habilitar detallar más o menos en
informes o acceder a funciones de miembro en los estudios.
Puede utilizar el modelo relacional como capa base y luego definir la
representación dimensional del modelo.
Luego puede organizar la presentación del modelo. Consulte: “Organización del
modelo” en la página 354.
Creación de dimensiones regulares
Una dimensión regular contiene información clave de la empresa y descriptiva que
organiza en una jerarquía, desde el nivel más alto de granularidad al más bajo.
Normalmente tiene varios niveles y cada uno de ellos necesita una clave y un
título. Si no tiene una única clave para su nivel, se recomienda crear una en un
cálculo.
Las dimensiones regulares de modelo se basan en un origen de datos o en asuntos
de consulta de modelo que ya se han definido en el modelo. Se debe definir una
clave de empresa y un título de tipo de cadena para cada nivel. Al verificar el
modelo, se detecta la ausencia de la información de claves de empresa e título. En
lugar de unir dimensiones regulares de modelo a dimensiones de medida, cree
uniones en los asuntos de consulta subyacentes y cree una relación de ámbito entre
la dimensión regular y la dimensión de medida.
Modelado de dimensiones con varias jerarquías
Se pueden darse varias jerarquías cuando se pueden aplicar diferentes vistas
estructurales a los mismos datos. En función de la naturaleza de las jerarquías y
los informes necesarios, es posible que necesite evaluar la técnica de modelado
aplicada a un caso en particular.
Por ejemplo, Sales Staff se puede visualizar por Manager o Geography. En los
estudios de IBM Cognos, estas jerarquías son estructuras lógicas separadas pero
intercambiables, que están vinculadas a la misma consulta subyacente.
A continuación se muestra Sales Staff como una única dimensión con dos
jerarquías:
Capítulo 9. Directrices de modelado de metadatos 351

Las jerarquías se definen en Framework Manager de la forma siguiente.
Puede especificar varias jerarquías en dimensiones regulares de Framework
Manager. Varias jerarquías para una dimensión regular se comportan como vistas
de la misma consulta. Sin embargo, solo puede utilizar una jerarquía cada vez en
una consulta. Por ejemplo, no puede utilizar una jerarquía en las filas de un
informe de tabla de referencias cruzadas y otra jerarquía de la misma dimensión en
las columnas. Si necesita ambas jerarquías en el mismo informe, debe crear dos
dimensiones, una para cada jerarquía. En los casos en que tenga varias jerarquías
con niveles o agregación significativamente diferentes, puede optar por realizar un
modelado para que un asunto de consulta independiente con determinantes
352 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

apropiados exista como base para esa jerarquía. El único requisito es que cualquier
asunto de consulta utilizado como base para una jerarquía debe tener una unión
definida con el asunto de consulta que proporciona los datos de hechos.
Éstas son dimensiones independientes para cada jerarquía.
Utilice este enfoque si es importante que existan conjuntos de columnas muy
diferentes para cada jerarquía y es más intuitivo para los usuarios modelar las
jerarquías como dimensiones independientes con consultas separadas y más
simples.
Creación de dimensiones de medida
Una dimensión de medida es una colección de hechos. Se puede crear una
dimensión de medida para uno o varios asuntos de consulta que tienen una
relación válida entre ellos.
Las dimensiones de medida de modelo deben estar compuestas únicamente de
elementos cuantitativos. Por su diseño, las dimensiones de medida de modelo no
contienen claves en las que se pueda realizar una unión, por lo que no es posible
crear uniones para modelar dimensiones de medida de modelo. En lugar de unir
dimensiones de medida de modelo a dimensiones regulares, cree uniones en los
asuntos de consulta subyacentes. A continuación, cree manualmente una relación
de ámbito entre ellas o detecte el ámbito si ambas dimensiones se encuentran en el
mismo espacio de nombres.
Creación de relaciones de ámbito
Las relaciones de ámbito solo existen entre las dimensiones de medida y las
dimensiones regulares para definir el nivel en el que las medidas están disponibles
para la creación de informes. No son iguales que las uniones y no influyen en la
cláusula Where. No existen condiciones ni criterios establecidos en una relación de
ámbito para regular cómo se forma una consulta, solo especifica si una dimensión
se puede consultar con un hecho especificado. La ausencia de una relación de
ámbito genera un error en tiempo de ejecución.
Si se establece la relación de ámbito para la dimensión de medida, se aplican los
valores a todas las medidas de la dimensión de medida. Si se notifican los datos a
Capítulo 9. Directrices de modelado de metadatos 353

un nivel diferente para las medidas de la dimensión de medida, puede establecer
el ámbito en una medida. Puede especificar el nivel más bajo en el que se pueden
notificar los datos.
Cuando se crea una dimensión de medida, IBM Cognos Framework Manager crea
una relación de ámbito entre la dimensión de medida y cada dimensión regular
existente. Framework Manager busca una ruta de unión entre la dimensión de
medida y las dimensiones regulares, empezando por el nivel más bajo de detalle.
Si hay muchas rutas de unión disponibles, la relación de ámbito que Framework
Manager crea puede no ser la esperada. En este caso, debe editar la relación de
ámbito.
Organización del modelo
Después de trabajar en la base del modelado relacional y crear una representación
dimensional, puede organizar el modelo.
v Conserve los metadatos del origen de datos en un espacio de nombres o carpeta
independiente.
v Cree uno o varios espacios de nombres o carpetas opcionales para resolver las
complejidades que afectan a las consultas que utilizan asuntos de consulta.
Para utilizar IBM Cognos Analysis Studio, debe haber un espacio de nombres o
una carpeta en el modelo que represente los metadatos con objetos
dimensionales.
v Cree uno o varios espacios de nombres o carpetas para la vista empresarial
aumentada de los metadatos que contiene los atajos para las dimensiones o los
asuntos de consulta.
Utilice conceptos empresariales para modelar la vista empresarial. Un modelo
puede contener muchas vistas empresariales, cada una de las cuales adecuada
para un grupo de usuarios diferente. Publique las vistas empresariales.
v Cree “Grupos de esquema en estrella”.
v Aplique seguridad de objetos, si es necesario.
v Cree paquetes y publique los metadatos.
Para obtener información sobre los temas que no se explican aquí, consulte:
Framework Manager Guía del usuario.
Grupos de esquema en estrella
El concepto de dimensión compatible no se limita al modelado dimensional,
también se aplica a asuntos de consulta.
Utilice el asistente Grupos de esquema en estrella para crear rápidamente grupos
de atajos que proporcionen contexto a los usuarios en relación a qué objetos deben
permanecer juntos. De este modo, el modelo resulta más intuitivo para los
usuarios. Los grupos de esquema en estrella también facilitan la creación de
informes de varios hechos ya que permiten la repetición de dimensiones
compartidas en grupos diferentes. Esto ayuda a los usuarios a ver lo que tienen en
común los distintos grupos y cómo pueden crear informes de funciones cruzadas o
de varios hechos. Para obtener más información, consulte: “Consultas de varios
hechos y granularidades” en la página 328.
Los grupos de esquema en estrella también proporcionan contexto para consultas
con varias rutas de unión. Mediante la creación de grupos de esquema en estrella
en la vista empresarial del modelo, puede aclarar qué ruta de unión se debe
seleccionar cuando hay varias disponibles. Esto es especialmente útil para las
consultas sin hechos.
354 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Varios esquemas en estrella compatibles o consultas sin hechos:
Es probable que se visualicen asuntos de consulta dimensionales unidos a más de
un asunto de consulta de hechos. La ambigüedad de la unión es un problema
cuando se crean informes utilizando elementos de varias dimensiones o asuntos de
consulta dimensionales sin incluir ningún elemento de la dimensión de medida o
asunto de consulta de hechos. Se denomina consulta sin hechos.
Por ejemplo, las dimensiones Product y Time están relacionadas con los hechos
Product forecast y Sales.
Si utiliza estas relaciones, ¿cómo se escribe un informe que solo utilice elementos
de Product y Time? La pregunta de negocio podría ser qué productos se habían
previsto para la venta en 2005 o qué productos se han vendido realmente en 2005.
Aunque esta consulta solo implique Product y Time, estas dimensiones están
relacionadas a través de varios hechos. No hay manera de averiguar cuál es la
pregunta de negocio. Debe establecer el contexto para la consulta sin hechos.
En este ejemplo, se recomienda crear dos espacios de nombres, uno que contenga
atajos para Product, Time y Product forecast, y otro que contenga Product, Time y
Sales.
Capítulo 9. Directrices de modelado de metadatos 355

Cuando se sigue este procedimiento para todos los esquemas en estrella, se
resuelve la ambigüedad de la unión colocando atajos para el hecho y todas las
dimensiones en un único espacio de nombres. Los atajos para dimensiones
compatibles en cada espacio de nombres son idénticos y son referencias al objeto
original. Nota: Se aplica exactamente la misma regla a dimensiones regulares y
dimensiones de medida.
Con un espacio de nombres para cada esquema en estrella, los usuarios tienen
claro los elementos que deben utilizar. Para crear un informe sobre qué productos
se han vendido realmente en 2005, utilizan Product y Year del espacio de nombres
Sales. La única relación pertinente en este contexto es la relación entre Product,
Time y Sales, y se utiliza para devolver los datos.
356 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Capítulo 10. SQL generado por el software de IBM Cognos
Con frecuencia, el SQL que genera el software IBM Cognos se presta a confusión.
Este documento explica el SQL que se genera en situaciones habituales.
Nota: Los ejemplos de SQL que se muestran en este documento se han limitado en
cuanto a longitud y se utilizan para resaltar ejemplos específicos. Estos ejemplos
utilizan el modelo de ejemplo de la versión 8.2.
Para acceder a la documentación de IBM CognosDirectrices de modelado de metadatos
en un idioma diferente, vaya a ubicación_instalación\c10\webcontent\
documentation y abra la carpeta para el idioma que desee. Luego abra ug_best.pdf.
Introducción a las consultas dimensionales
Las consultas dimensionales se han ideado para habilitar las consultas de varios
hechos.
Los objetivos básicos de las consultas de varios hechos son:
v Conservar los datos cuando los datos de hechos no se alinean perfectamente
entre las distintas dimensiones habituales, como por ejemplo, cuando existen
más filas en los hechos que en las dimensiones.
v Evitar recuentos dobles cuando existen datos de hechos en niveles diferentes de
granularidad, asegurando que cada hecho se represente en una sola consulta con
la agrupación adecuada. Es posible que en algunos casos sea necesario crear
determinantes para los asuntos de consulta subyacentes.
Consulta de hecho único
Una consulta sobre un grupo de esquema en estrella genera una consulta sobre un
solo hecho.
En este ejemplo, todas las consultas escritas se basas en Sales. Las dimensiones
ofrecen atributos y descripciones para que los datos de Sales sean más
significativos. Todas las relaciones entre las dimensiones y el hecho son 1-n.
© Copyright IBM Corp. 2005, 2013 357

Cuando filtra por mes y producto, el resultado es el siguiente.
358 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Consulta de varios hechos y consultas de granularidad
múltiple en dimensiones compatibles
Una consulta sobre hechos múltiples y dimensiones compatibles respeta la
cardinalidad entre cada tabla de hechos y sus dimensiones, y escribe SQL para
devolver todas las filas de cada tabla de hechos.
Por ejemplo, tanto Sales como Product Forecast son hechos.
Tenga en cuenta que se trata de una representación simplificada y no de un
ejemplo de cómo debería aparecer en un modelo creado mediante las
recomendaciones de modelado de IBM Cognos.
Resultado
Las distintas consultas sobre Sales y Product Forecast por Month y Product arrojan
los siguientes resultados. Los datos de Sales se almacenan realmente en el nivel de
día.
Capítulo 10. SQL generado por el software de IBM Cognos 359

Una consulta sobre Sales y Product Forecast respeta la cardinalidad entre cada
tabla de hechos y sus dimensiones, y escribe SQL para devolver todas las filas de
cada tabla de hechos. Las tablas de hechos se correlacionan con sus claves comunes
(de mes y producto) y, allí donde es posible, se agregan al nivel común más bajo
de granularidad. En este caso, los días se acumulan a los meses. Este tipo de
consulta suele devolver valores nulos ya que una combinación de elementos
dimensionales en una tabla de hechos puede no existir en la otra tabla.
Tenga en cuenta que, en febrero de 2004, el producto Course Pro Umbrellas
formaba parte de la previsión pero no hubo ventas reales. Los datos de Sales y
Product Forecast existen en niveles diferentes de granularidad. Los datos de Sales
están en el nivel de día y Product Forecast está en el nivel de mes.
SQL
El SQL generado por el software de IBM Cognos, denominado consulta enlazada, a
menudo se presta a confusión. Una consulta enlazada utiliza varias subconsultas
(una para cada estrella), unidas por una unión externa completa de las claves
comunes. El objetivo es conservar todos los miembros dimensionales que se
generan a cualquier lado de la consulta.
El siguiente ejemplo se ha editado en cuanto a longitud, y se utiliza para entender
las características principales de las consultas enlazadas.
select
coalesce(D2.MONTH_NAME,D3.MONTH_NAME) as MONTH_NAME,
coalesce(D2.PRODUCT_NAME,D3.PRODUCT_NAME) as PRODUCT_NAME,
D2.EXPECTED_VOLUME as EXPECTED_VOLUME,
D3.QUANTITY as QUANTITY
from (select TIME.MONTH_NAME as MONTH_NAME,
PRODUCT_LOOKUP.PRODUCT_NAME as PRODUCT_NAME,
XSUM(PRODUCT_FORECAST_FACT.EXPECTED_VOLUME for
TIME.CURRENT_YEAR,TIME.QUARTER_KEY,TIME.MONTH_KEY,
PRODUCT.PRODUCT_LINE_CODE, PRODUCT.PRODUCT_TYPE_CODE,
PRODUCT.PRODUCT_KEY) as EXPECTED_VOLUME
from
(select TIME.CURRENT_YEAR as CURRENT_YEAR,
360 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

TIME.QUARTER_KEY as QUARTER_KEY,
TIME.MONTH_KEY as MONTH_KEY,
XMIN(TIME.MONTH_NAME for TIME.CURRENT_YEAR,
TIME.QUARTER_KEY,TIME.MONTH_KEY) as MONTH_NAME
from TIME_DIMENSION TIME
group by TIME.MONTH_KEY) TIME
join PRODUCT_FORECAST_FACT PRODUCT_FORECAST_FACT
on (TIME.MONTH_KEY = PRODUCT_FORECAST_FACT.MONTH_KEY)
join PRODUCT PRODUCT on (PRODUCT.PRODUCT_KEY =
PRODUCT_FORECAST_FACT.PRODUCT_KEY)
where
(PRODUCT.PRODUCT_NAME in (’Aloe Relief’,’Course Pro
Umbrella’)) and
(TIME.MONTH_NAME in (’April 2004’,’February 2004’,’February
2006’))
group by
TIME.MONTH_NAME,
PRODUCT_LOOKUP.PRODUCT_NAME
)D2
full outer join
(select TIME.MONTH_NAME as MONTH_NAME,
PRODUCT_LOOKUP.PRODUCT_NAME as PRODUCT_NAME,
XSUM(SALES_FACT.QUANTITY for TIME.CURRENT_YEAR,
TIME.QUARTER_KEY, TIME.MONTH_KEY,
PRODUCT.PRODUCT_LINE_CODE, PRODUCT.PRODUCT_TYPE_CODE,
PRODUCT.PRODUCT_KEY ) as QUANTITY
from
select TIME.DAY_KEY,TIME.MONTH_KEY,TIME.QUARTER_KEY,
TIME.CURRENT_YEAR,TIME.MONTH_EN as MONTH_NAME
from TIME_DIMENSION TIME) TIME
join SALES_FACT SALES_FACT
on (TIME.DAY_KEY = SALES_FACT.ORDER_DAY_KEY)
join PRODUCT PRODUCT on (PRODUCT.PRODUCT_KEY = SALES_FACT.PRODUCT_KEY)
where
PRODUCT.PRODUCT_NAME in (’Aloe Relief’,’Course Pro Umbrella’))
and (TIME.MONTH_NAME in (’April 2004’,’February 2004’,’February
2006’))
group by
TIME.MONTH_NAME,
PRODUCT.PRODUCT_NAME
)D3
on ((D2.MONTH_NAME = D3.MONTH_NAME) and
(D2.PRODUCT_NAME = D3.PRODUCT_NAME))
Significado de la sentencia Coalesce
Una sentencia coalesce es simplemente una forma eficaz de gestionar los
elementos de consulta de las dimensiones compatibles. Se utiliza para aceptar el
primer valor no nulo devuelto de cualquiera de los asuntos de consulta. Esta
sentencia permite obtener una lista completa de claves sin repeticiones cuando se
realiza una unión externa completa.
¿Por qué existe una unión externa completa?
Una unión externa completa es necesaria para garantizar que se recuperen todos
los datos de cada tabla de hechos. Una unión interna genera resultados sólo si se
vendió un artículo del inventario. Una unión externa derecha permite obtener
todas las ventas cuyos elementos estaban en el inventario. Una unión externa
izquierda permite obtener todos los elementos del inventario de los que haya
habido ventas. Una unión externa completa es la única forma de saber el contenido
del inventario y qué elementos se han vendido.
Capítulo 10. SQL generado por el software de IBM Cognos 361

Modelado de relaciones 1-n como relaciones 1-1
Si existe una relación 1-n en los datos pero está modelada como una relación 1-1,
no se puede evitar realizar capturas SQL porque la información proporcionada por
los metadatos al software IBM Cognos resulta insuficiente.
Los problemas más habituales que se presentan si las relaciones 1-n se modelan
como 1-1 son los siguientes:
v El recuento doble para consultas de granularidad múltiple no se evita
automáticamente.
El software IBM Cognos no puede detectar los hechos y después generar una
consulta enlazada para compensar el recuento doble, que se puede dar al
trabajar con relaciones jerárquicas y diferentes niveles de granularidad en
dimensiones compatibles.
v Las consultas de varios hechos no se detectan automáticamente.
El software IBM Cognos no dispondrá de información suficiente para detectar
una consulta de varios hechos. Para las consultas de varios hechos, se realiza
una unión interna y la unión de bucle se elimina al eliminar la última unión
evaluada. Al eliminar una unión es posible que se produzcan resultados
incorrectos o impredecibles, en función de las dimensiones y los hechos que se
incluyan en la consulta.
Si la cardinalidad se modificara para utilizar sólo relaciones 1-1 entre los asuntos
de consulta o las dimensiones, el resultado de una consulta sobre Product Forecast
y Sales con Time o Time y Product genera una sentencia única Select que elimina
una unión para impedir una referencia circular.
El ejemplo siguiente muestra que los resultados de esta consulta son incorrectos
cuando se comparan con los resultados de consultas individuales contra Sales o
Product Forecast.
Los resultados de las consultas individuales son los siguientes.
362 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Cuando combina estas consultas en una sola, los resultados son los siguientes.
SQL
Como se ha detectado una ruta de unión circular en el modelo, el SQL generado
no incluía una de las relaciones que no era necesaria para completar la ruta de
unión. En este ejemplo se han eliminado las relaciones entre Time y Product
Forecast.
Una ruta de unión circular raramente da lugar a una consulta que genere
resultados útiles.
select
TIME_.MONTH_NAME as MONTH_NAME,
PRODUCT_LOOKUP.PRODUCT_NAME as PRODUCT_NAME,
XSUM(SALES_FACT.QUANTITY for
TIME_.CURRENT_YEAR, TIME_.QUARTER_KEY, TIME_.MONTH_KEY,
PRODUCT.PRODUCT_LINE_CODE, PRODUCT.PRODUCT_TYPE_CODE,
PRODUCT.PRODUCT_KEY ) as QUANTITY,
XSUM(PRODUCT_FORECAST_FACT.EXPECTED_VOLUME for TIME_.CURRENT_YEAR,
TIME_.QUARTER_KEY, TIME_.MONTH_KEY, PRODUCT.PRODUCT_LINE_CODE,
PRODUCT.PRODUCT_TYPE_CODE, PRODUCT.PRODUCT_KEY ) as EXPECTED_VOLUME
from
(select TIME.DAY_KEY,TIME.MONTH_KEY, TIME.QUARTER_KEY,
TIME.CURRENT_YEAR,TIME.MONTH_EN as MONTH_NAME
from TIME_DIMENSION TIME) TIME
join
SALES_FACT on (TIME_.DAY_KEY = SALES_FACT.ORDER_DAY_KEY)
join
PRODUCT_FORECAST_FACT on (TIME_.MONTH_KEY =
PRODUCT_FORECAST_FACT.MONTH_KEY)
join
PRODUCT (PRODUCT.PRODUCT_KEY = PRODUCT_FORECAST_FACT.PRODUCT_KEY)
where
(PRODUCT.PRODUCT_NAME in (’Aloe Relief’,’Course Pro Umbrella’))
and
(TIME_.MONTH_NAME in (’April 2004’,’February 2004’,’February 2006’))
group by
TIME_.MONTH_NAME, PRODUCT.PRODUCT_NAME
Consulta de varios hechos y consultas de granularidad
múltiple en dimensiones no compatibles
Si se añade una dimensión no compatible a la consulta, la naturaleza de los
resultados devueltos por la consulta enlazada cambiará. Ya no es posible agregar
registros al nivel común más bajo de granularidad, porque una parte de la consulta
tiene una dimensionalidad diferente a la de la otra parte de la consulta. El
resultado devuelto se compone, en realidad, de dos listas correlacionadas.
Capítulo 10. SQL generado por el software de IBM Cognos 363

Resultado
Los resultados de las distintas consultas sobre los esquemas en estrella respectivos
tienen este aspecto.
364 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Si se consultan los mismos elementos de los dos esquemas en estrella, se obtiene el
siguiente resultado.
Capítulo 10. SQL generado por el software de IBM Cognos 365

En este resultado, el nivel más bajo de granularidad para los registros de Sales
genera la devolución de más registros por cada combinación de mes y producto.
Ahora existe una relación 1-n entre las filas que se han devuelto de Product
Forecast y las que se han devuelto de Sales.
Cuando se compara esto con el resultado devuelto en el ejemplo de esta consulta
de varios hechos y granularidad múltiple sobre dimensiones compatibles, se puede
observar que se devuelven más registros y que los resultados de Expected Volume
se repiten varias veces para Order Method. Al añadir Order Method a la consulta,
se cambia de forma efectiva la relación entre datos de Quantity y de Expected
Volume a una relación 1-n. Ya no será posible relacionar un valor único de
Expected Volume con un valor de Quantity.
La agrupación por clave Month demuestra que el resultado de este ejemplo se basa
en el mismo conjunto de datos que el resultado de consultas de varios hechos y
granularidad múltiple pero con un nivel mayor de nivel de granularidad.
SQL
El SQL unido generado para este ejemplo es muy parecido al SQL generado en la
consulta de varios hechos y granularidad múltiple. La principal diferencia es que
se ha añadido Order Method. Order Method no es una dimensión compatible y
afecta sólo a las consultas relativas a la tabla Sales Fact.
select
D2.QUANTITY as QUANTITY,
D3.EXPECTED_VOLUME as EXPECTED_VOLUME,
coalesce(D2.PRODUCT_NAME,D3.PRODUCT_NAME) as PRODUCT_NAME,
coalesce(D2.MONTH_NAME,D3.MONTH_NAME) as MONTH_NAME,
D2.ORDER_METHOD as ORDER_METHOD
from
(select
PRODUCT.PRODUCT_NAME as PRODUCT_NAME,
TIME.MONTH_NAME as MONTH_NAME,
ORDER_METHOD.ORDER_METHOD as ORDER_METHOD,
XSUM(SALES_FACT.QUANTITY for TIME.CURRENT_YEAR,TIME.QUARTER_KEY,
TIME.MONTH_KEY,PRODUCT.PRODUCT_LINE_CODE,PRODUCT.PRODUCT_TYPE_CODE,
366 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

PRODUCT.PRODUCT_KEY,ORDER_METHOD_DIMENSION.ORDER_METHOD_KEY) as
QUANTITY
from
PRODUCT_DIMENSION PRODUCT
join
SALES_FACT SALES_FACT
on (PRODUCT.PRODUCT_KEY = SALES_FACT.PRODUCT_KEY)
join
ORDER_METHOD_DIMENSION ORDER_METHOD
on (ORDER_METHOD.ORDER_METHOD_KEY = SALES_FACT.ORDER_METHOD_KEY)
join TIME_DIMENSION TIME
on ( TIME.DAY_KEY = SALES_FACT.ORDER_DAY_KEY)
where
(PRODUCT.PRODUCT_NAME in (’Aloe Relief’,’Course Pro Umbrella’))
and
( TIME.MONTH_NAME in (’April 2004’,’February 2004’,’February 2006’))
group by
PRODUCT.PRODUCT_NAME,
TIME.MONTH_NAME,
ORDER_METHOD.ORDER_METHOD
)D2
full outer join
(select
PRODUCT.PRODUCT_NAME as PRODUCT_NAME,
TIME.MONTH_NAME as MONTH_NAME,
XSUM(PRODUCT_FORECAST_FACT.EXPECTED_VOLUME for TIME.CURRENT_YEAR,
TIME.QUARTER_KEY,TIME.MONTH_KEY,PRODUCT.PRODUCT_LINE_CODE,
PRODUCT.PRODUCT_TYPE_CODE,PRODUCT.PRODUCT_KEY) as EXPECTED_VOLUME
from
PRODUCT_DIMENSION PRODUCT
join
PRODUCT_FORECAST_FACT PRODUCT_FORECAST_FACT
on (PRODUCT.PRODUCT_KEY = PRODUCT_FORECAST_FACT.PRODUCT_KEY)
join
(select
TIME.CURRENT_YEAR as CURRENT_YEAR,
TIME.QUARTER_KEY as QUARTER_KEY,
TIME.MONTH_KEY as MONTH_KEY,
XMIN(TIME.MONTH_NAME for TIME.CURRENT_YEAR, TIME.QUARTER_KEY,
TIME.MONTH_KEY) as MONTH_NAME
from
TIME_DIMENSION TIME
group by
TIME.CURRENT_YEAR,
TIME.QUARTER_KEY,
TIME.MONTH_KEY
) TIME
on (TIME.MONTH_KEY = PRODUCT_FORECAST_FACT.MONTH_KEY)
where
(PRODUCT.PRODUCT_NAME in (’Aloe Relief’,’Course Pro Umbrella’))
and
(TIME.MONTH_NAME in (’April 2004’,’February 2004’,’February 2006’))
group by
PRODUCT.PRODUCT_NAME,
TIME.MONTH_NAME
)D3
on ((D2.PRODUCT_NAME = D3.PRODUCT_NAME) and
(D2.MONTH_NAME = D3.MONTH_NAME))
Resolución de dimensiones y hechos identificados de forma ambigua
Se considera que una consulta se ha definido de forma ambigua si participa tanto
en relaciones n como en 1 respecto a otros asuntos de consulta. Un asunto de
consulta definido de forma ambigua no siempre resulta perjudicial desde el punto
de vista de la generación de la consulta. Se recomienda evaluar los asuntos de
Capítulo 10. SQL generado por el software de IBM Cognos 367

consulta mediante los siguientes supuestos. El objetivo de esta evaluación es
impedir divisiones de consultas innecesarias y garantizar que cualquier división
que se produzca sea intencionada y correcta.
Asuntos de consulta que representan un nivel de jerarquía
Un supuesto frecuente de asunto de consulta definido de forma ambigua que no
resulta perjudicial se da cuando el asunto de consulta representa un nivel
intermedio de una jerarquía descriptiva. Un ejemplo es la jerarquía Product
siguiente.
En este ejemplo, tanto Product type como Product se podrían identificar como
elementos definidos de forma ambigua. Sin embargo, esta ambigüedad no es
perjudicial ni para los resultados generados ni para el rendimiento de ninguna
consulta que utilice uno o varios de estos asuntos de consulta. No es necesario
corregir este modelo de consulta ya que, al utilizar las reglas para la detección de
hechos, sólo se identifica un hecho en cualquier consulta que combine un elemento
de los asuntos de consulta Product forecast o Sales. La mejor estrategia sigue
consistiendo en contraer las jerarquías en una única dimensión regular cuando el
modelado se realice con fines de análisis.
368 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Algunas consultas que se pueden realizar utilizando este ejemplo, son las
siguientes:
Elementos de estos asuntos de consulta
usados en una consulta:
Product line y Product type Product type
Product line, Product type y Product Product
Product line, Product type, Product y Sales Sales
Product line y Sales Sales
Product type y Product forecast Product forecast
Asunto de consulta que se comporta como
un hecho en la consulta:
Resolución de consultas que no se deberían haber dividido
Si las consultas están divididas pero no se deberían haber dividido, deberá
resolverlas.
Los asuntos de consulta en la parte n de todas las relaciones se identifican como
hechos. Puede observarse que, en el siguiente ejemplo, Order Header y Country
Multilingual se comportan como hechos. En realidad, el asunto de consulta
Country Multilingual contiene sólo información descriptiva y parece una tabla de
consulta. Desde una perspectiva dimensional o de modelado empresarial, Country
Multilingual es una extensión de Country.
¿Por qué supone un problema dejar el modelo así?
Pruebe este modelo mediante la creación de un informe sobre el número de
pedidos por ciudad y por país o región. Al utilizar este modelo, se devuelve un
resultado incorrecto. Los números son correctos para las ciudades pero algunas de
éstas se muestran en el país o región equivocado. Este es un ejemplo de un
resultado relacionado incorrecto.
Capítulo 10. SQL generado por el software de IBM Cognos 369

Normalmente, el primer lugar que hay que analizar cuando se observa un
resultado como éste es el SQL.
SQL
En este ejemplo, se ve una consulta enlazada, que tiene sentido si hay hechos
múltiples en el modelo. Una consulta enlazada es esencialmente una consulta que
intenta unir varios hechos. Utiliza las relaciones que relacionan los hechos entre sí,
así como los determinantes para las dimensiones compatibles, o comunes,
definidas en el modelo. Una consulta enlazada se puede identificar mediante dos
consultas con una unión externa completa. La consulta wrapper debe incluir una
sentencia coalesce sobre las dimensiones compatibles.
Tenga en cuenta los siguientes problemas del SQL:
v La consulta no tiene una sentencia coalesce.
v RSUM indica un intento de crear una clave válida.
select
D3.COUNTRY as COUNTRY,
D2.CITY as CITY,
D2.number_of_orders as number_of_orders
from
(select
SALES_BRANCH.CITY as CITY,
XCOUNT(ORDER_HEADER.ORDER_NUMBER for SALES_BRANCH.CITY) as
number_of_orders,
RSUM(1 at SALES_BRANCH.CITY order by SALES_BRANCH.CITY
asc local)
as sc
from
gosales.gosales.dbo.SALES_BRANCH SALES_BRANCH
join
gosales.gosales.dbo.ORDER_HEADER ORDER_HEADER
on (SALES_BRANCH.SALES_BRANCH_CODE = ORDER_HEADER.SALES_BRANCH_CODE)
group by
SALES_BRANCH.CITY
order by
CITY asc
)D2
full outer join
(select
COUNTRY_MULTILINGUAL.COUNTRY as COUNTRY,
RSUM(1 at COUNTRY_MULTILINGUAL.COUNTRY order by
COUNTRY_MULTILINGUAL.COUNTRY asc local) as sc
from
gosales.gosales.dbo.COUNTRY_MULTILINGUAL COUNTRY_MULTILINGUAL
group by
COUNTRY_MULTILINGUAL.COUNTRY
order by
COUNTRY asc
)D3
on (D2.sc = D3.sc)
370 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Si se analizan las columnas enlazadas en cada consulta, se observa que se están
calculando según criterios no relacionados. Esto explica por qué no existe una
relación aparente entre los países o regiones y las ciudades del informe.
Entonces, ¿por qué hay una consulta enlazada? Para responder a esta pregunta hay
que analizar el modelo.
En este ejemplo, los elementos de consulta utilizados en el informe provenían de
asuntos de consulta diferentes. Country o Region provenía de Country
Multilingual, City provenía de Sales Branch y Number of Orders provenía de un
recuento de Order Number del asunto de consulta Order Header.
El problema es que la consulta se divide porque el motor de consultas la considera
una consulta de varios hechos. Sin embargo, la división no tiene una clave válida a
la que enlazarse porque no existe un elemento común a los dos hechos.
Existe más de una forma de resolver este problema pero en ambos casos es
necesario conocer los datos.
Solución 1
Puede añadir un filtro a Country Multilingual que cambie la cardinalidad de la
relación a 1-1.
Select *
from [GOSL].COUNTRY_MULTILINGUAL
Where
COUNTRY_MULTILINGUAL."LANGUAGE"=’EN’
O bien, puede añadir un filtro a la relación y cambiar la cardinalidad a 1-1.
COUNTRY.COUNTRY_CODE = COUNTRY_MULTILINGUAL.COUNTRY_CODE
and COUNTRY_MULTILINGUAL.LANGUAGE = ’EN’
Capítulo 10. SQL generado por el software de IBM Cognos 371

Con ambas opciones, se genera un modelo que tiene un solo hecho en esta
consulta.
Solución 2
Simplifique el modelo mediante la consolidación de los asuntos de consulta
relacionados. Ésta es la mejor solución porque simplifica el modelo y reduce las
posibilidades de que se produzca un error al generar la consulta.
Ahora, con cualquiera de las dos soluciones, se obtiene una consulta correcta.
El SQL ya no es una consulta enlazada.
select
Country.c7 as COUNTRY,
SALES_BRANCH.CITY as CITY,
XCOUNT(ORDER_HEADER.ORDER_NUMBER for Country.c7,SALES_BRANCH.CITY)
as number_of_orders
from
(select
COUNTRY.COUNTRY_CODE as c1,
COUNTRY_MULTILINGUAL.COUNTRY as c7
from
gosales.gosales.dbo.COUNTRY COUNTRY
join
gosales.gosales.dbo.COUNTRY_MULTILINGUAL COUNTRY_MULTILINGUAL
on (COUNTRY.COUNTRY_CODE = COUNTRY_MULTILINGUAL.COUNTRY_CODE)
where COUNTRY_MULTILINGUAL.LANGUAGE=’EN’
) Country
join
gosales.gosales.dbo.SALES_BRANCH SALES_BRANCH
on (SALES_BRANCH.COUNTRY_CODE = Country.c1)
join
gosales.gosales.dbo.ORDER_HEADER ORDER_HEADER
372 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

on (SALES_BRANCH.SALES_BRANCH_CODE = ORDER_HEADER.SALES_BRANCH_CODE)
group by
Country.c7,
SALES_BRANCH.CITY
Capítulo 10. SQL generado por el software de IBM Cognos 373

374 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Capítulo 11. Actualización de modelos
Cuando se actualiza un modelo, se prepara para que pueda beneficiarse de las
nuevas características de esta versión.
Cuando se instala la última versión del software de IBM Cognos, la mayoría de los
modelos creados con versiones anteriores del producto se actualizan
automáticamente. Los paquetes que se publican para los usuarios se actualizan
automáticamente en la base de datos de Content Manager. Estos paquetes siguen
funcionando como lo hacían anteriormente y todos lo informes siguen
ejecutándose. Solo debe modificar el modelo en IBM Cognos Framework Manager
si desea modificar los metadatos publicados.
Si un modelo no se actualiza correctamente, los informes que utilizan el modelo no
se ejecutarán. Entonces, deberá abrir el modelo en Framework Manager,
actualizarlo manualmente y volver a publicarlo.
El proceso de actualización de los modelos es diferente en función de si actualiza
un modelo creado en IBM Cognos ReportNet o en versiones anteriores de IBM
Cognos BI.
Para actualizar el modelo, siga estos pasos:
v Compruebe el modelo antes de actualizarlo.
v Abra y actualice el modelo.
v Verifique y repare el modelo de ReportNet actualizado.
Para buscar la documentación más reciente sobre los productos, incluida toda la
documentación traducida, acceda a uno de los Information Center de IBM Cognos
en http://publib.boulder.ibm.com/infocenter/cogic/v1r0m0/index.jsp.
Verificación del modelo antes de la actualización
El proceso de actualización no soluciona los problemas que existían en el modelo
antes de dicho proceso. Antes de actualizar, verifique el modelo y solucione los
problemas notificados en el entorno existente.
Cuando actualice de IBM Cognos ReportNet a IBM Cognos BI, compruebe que la
información de dimensiones esté correctamente definida en el modelo ReportNet.
Para obtener más información, consulte: “Conversión de la información de
dimensiones en determinantes o dimensiones” en la página 378.
Apertura y actualización de modelos
Cuando se instala la última versión del software de IBM Cognos, la mayoría de los
modelos creados con versiones anteriores del producto se actualizan
automáticamente.
Cuando actualice el modelo, debe:
v Comprender el impacto de los reguladores que se definen durante la
actualización.
© Copyright IBM Corp. 2005, 2013 375

Para obtener más información, consulte: “Actualización y reguladores”.
v Revisar el tipo de datos modificados.
Para obtener más información, consulte: “Actualización y tipos de datos” en la
página 377.
v Comprender el impacto de la actualización en los asuntos de consulta basados
en los metadatos de SAP BW.
Para obtener más información, consulte: “Actualización y asuntos de consulta
basados en metadatos de SAP BW” en la página 377.
Para obtener más información, consulte: “Actualización de proyectos segmentados
y enlazados” en la página 382.
Actualización y reguladores
Durante el proceso de actualización se definen automáticamente algunos
reguladores:
v El regulador Permitir portabilidad de modelo mejorada en tiempo de ejecución
“Permitir portabilidad de modelo mejorada en tiempo de ejecución” en la página
310 se selecciona.
Este regulador se usa al actualizar al modelo de ReportNet 1.x. Impide la
aplicación estricta de tipos de datos de modo que un modelo de IBM Cognos BI
puede funcionar como un modelo de ReportNet 1.x hasta que se actualicen los
tipos de datos en los metadatos. Tras verificar que el modelo se ha actualizado
correctamente, desactive este regulador.
La propiedad de estado de todos los asuntos de consulta de orígenes de datos se
define en Necesita reevaluación. El motor de la consulta pasa por alto los tipos
de datos del modelo que están marcados como Necesita reevaluación y recupera
la información del tipo de datos del origen de datos. Esto puede incidir algo
negativamente en el rendimiento al ejecutar los informes.
v El regulador Permitir generación dinámica de información de dimensión
“Permitir generación dinámica de información de dimensiones” en la página 310
se selecciona.
Este regulador asegura un comportamiento coherente con ReportNet al obtener
una forma de información de dimensiones a partir de las relaciones, la
información clave y la información de índice del origen de datos.
Cuando este regulador está seleccionado y un modelo contiene asuntos de
consulta pero no dimensiones, IBM Cognos BI genera consultas que evitan el
doble recuento. Esto proporciona compatibilidad con ReportNet. Cuando se
verifica el modelo, se muestra un aviso si este regulador está seleccionado.
v El regulador Procesamiento de atajos “Procesamiento de atajos” en la página
307 se define como Automático.
Este regulador controla el modo en que IBM Cognos BI procesa los atajos.
Cuando el regulador se define con el valor Automático, el modelo funciona del
mismo modo que en ReportNet; es decir, un atajo que existe en la misma carpeta
que su destino se comporta como un alias o una instancia independiente. No
obstante, un atajo que exista en cualquier otra parte del modelo se comporta
como una referencia al original. Cuando se crea un modelo, este regulador tiene
siempre el valor Explícito.
v El regulador Suprimir valores nulos para orígenes de datos de SAP BW
“Suprimir valores nulos para orígenes de datos de SAP BW” en la página 311 se
selecciona solo para los metadatos de SAP BW.
376 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Este regulador controla la creación de uniones externas en los modelos basados
en metadatos de SAP BW.
Algunas consultas pueden ser muy grandes porque los valores nulos no se
filtran. La eliminación de los valores nulos quita las filas o columnas cuya
totalidad de valores son nulos (vacíos).
SAP BW realiza la eliminación supresión de valores nulos. Esto reduce la
cantidad de datos transferidos a los estudios de IBM Cognos y mejora el
rendimiento.
Actualización y tipos de datos
IBM Cognos Business Intelligence soporta tipos de datos que no están disponibles
en IBM Cognos ReportNet. Esto puede influir en cómo se correlacionan los tipos
de datos durante la importación de metadatos al realizar una actualización.
Nota: La correlación de tipos de datos varía según el proveedor de origen de
datos.
La tabla siguiente muestra las diferencias principales entre los tipos de datos de
ReportNet y de IBM Cognos BI.
ReportNet IBM Cognos BI
char nChar
decimal numeric
varChar nVarChar
varChar timestampTZ
varChar IntervalTZ
Los tipos de datos se almacenan en el modelo, por lo que IBM Cognos BI puede
impedir el acceso al origen de datos cada vez que necesite determinar los tipos de
datos para los elementos de consulta. Esto mejora el rendimiento.
Es posible que algunos elementos de consulta, en su mayoría cálculos, se
visualicen divididos después de la actualización. Puede suceder bajo las siguientes
circunstancias:
v El tipo de datos de los elementos subyacentes para un cálculo se ha cambiado y
no es posible asignar automáticamente el tipo de datos al cálculo.
v Un cálculo guardado que contiene una solicitud no se ha probado correctamente.
Debe probar los cálculos afectados y corregir los problemas.
Actualización y asuntos de consulta basados en metadatos de
SAP BW
Un asunto de consulta basado en metadatos de SAP BW no se convierte en una
dimensión. En su lugar, el proceso de actualización crea una dimensión oculta y un
nuevo asunto de consulta de modelo con el mismo nombre y elementos de
consulta que el asunto de consulta original. El asunto de consulta de modelo
señala a la dimensión oculta recién creada, que mantiene compatibilidad con los
informes existentes.
Los asuntos de consulta de modelo que no contienen niveles y jerarquías se
convierten a dimensiones de medida.
Capítulo 11. Actualización de modelos 377

Después de la actualización, revise el modelo para asegurarse de que las
dimensiones de medida y regular recién creadas cumplen las necesidades de
análisis y creación de informes.
Tras actualizar un modelo ReportNet 1.x a un modelo IBM Cognos 8.3, las medidas
que se añadieron a la carpeta de cifras clave para el objeto de SAP BW subyacente
tras la importación inicial no se añaden durante la fase de sincronización. La
solución consiste en volver a importar el objeto.
Esto no afecta a modelos en versiones posteriores de IBM Cognos BI.
Verificación y reparación de modelos de IBM Cognos ReportNet
Esta sección y sus subsecciones sirven únicamente para actualizar modelos de IBM
Cognos ReportNet a IBM Cognos Business Intelligence.
Después de actualizar los metadatos, IBM Cognos Framework Manager le solicita
que verifique el modelo. Verá avisos para cada objeto que contenga información de
dimensiones o uno de los tipos de datos enumerados en la sección que trata de la
actualización y los tipos de datos. Cuando verifique modelos grandes, compruebe
los espacios de nombres uno por uno. También puede comprobar un objeto en
particular.
El proceso de reparación evalúa primero todos los elementos seleccionados. Esta
evaluación resuelve automáticamente los problemas con los tipos de datos nuevos
y le solicita que repare la información de dimensiones del modelo. Puede
seleccionar una o varias casillas de verificación y reparar los elementos.
La verificación del modelo aparte del proceso de actualización ofrece un buen
número de ventajas. Permite:
v Abrir un modelo existente, actualizarlo y publicarlo sin cambios en la
funcionalidad de la consulta.
v Dedicar un tiempo a reevaluar los requisitos del modelo.
v Continuar el diseño del modelo de producción, publicarlo sin la información de
dimensión y pasar gradualmente a las dimensiones y los determinantes.
Durante el proceso de actualización deberá:
v Convertir los asuntos de consulta con información de dimensiones en asuntos
de consulta con determinantes o en dimensiones.
v Seleccionar y repara objetos.
Si realiza cambios en el modelo sin verificación antes de verificarlo, no realice
cambios en los determinantes. Si lo hace, se puede perder información de
dimensiones y no se podrá verificar el modelo posteriormente.
Conversión de la información de dimensiones en
determinantes o dimensiones
En IBM Cognos ReportNet, la información de dimensiones combinaba exclusividad
con jerarquías dimensionales. En IBM Cognos BI, la información de las
dimensiones regulares se divide entre determinantes y jerarquías. Los
determinantes controlan la exclusividad y la granularidad. Este control es necesario
para los asuntos de consulta basados en orígenes de datos relacionales;
particularmente, en consultas de varios hechos y de granularidad múltiple. Las
378 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

jerarquías gestionan conceptos sobre dimensiones de jerarquías, niveles, claves y
atributos para todos los orígenes de datos.
Los asuntos de consulta con información de dimensiones no se convierten en
determinantes o en dimensiones durante la actualización. Los metadatos que
especificaba anteriormente la información de dimensiones se conserva en el
modelo y sigue existiendo para los asuntos de consulta hasta que se reparan. No se
puede cambiar la información de dimensiones en IBM Cognos BI, pero se puede
actualizar esta información a determinantes o a dimensiones. Mientras no actualice
los asuntos de consulta, IBM Cognos BI utilizará la información de dimensiones
especificada anteriormente en ReportNet. Para obtener más información, consulte:
“Correlación de información de dimensiones”.
Si realiza cambios en el modelo sin verificación tras la actualización, no realice
cambios en los determinantes. Si lo hace, puede perder información sobre las
dimensiones. Al recuperar la información de dimensiones, debe comprender cómo
se aplica al asunto de consulta y cómo utilizará el asunto de consulta en un
modelo de IBM Cognos BI. Para obtener más información, consulte: “Revisión
posterior a la conversión” en la página 380.
Para obtener más información sobre el trabajo con metadatos, consulte: Capítulo 9,
“Directrices de modelado de metadatos”, en la página 321.
Correlación de información de dimensiones
Se puede correlacionar la información de dimensiones de los asuntos de consulta
de modelo de ReportNet con asuntos de consulta con determinantes o con
dimensiones del modelo de IBM Cognos BI.
v Determinantes
Utilice determinantes para conservar los informes existentes cuando amplíe la
aplicación.
Los determinantes reflejan la granularidad representando subconjuntos o grupos
de datos en un asunto de consulta. Aseguran la correcta agregación de los datos
repetidos. Los determinantes se importan según la información de claves
exclusivas y de índice del origen de datos.
A diferencia de la información de dimensiones, los asuntos de consulta de
modelo heredan los determinantes especificados para los asuntos de consulta
subyacentes. Especifique los determinantes lo más pronto posible en el modelo,
normalmente en el asunto de consulta de orígenes de datos. En los casos en que
especifique distintos determinantes para controlar granularidades diferentes, cree
varias instancias del asunto de consulta de orígenes de datos o elimine
determinantes del asunto de consulta de orígenes de datos. Luego cree nuevos
determinantes en cada asunto de consulta de modelo que necesite un control de
granularidad diferente.
v Dimensiones
Use dimensiones si utiliza el modelo en Analysis Studio, habilita detallar más y
menos en informes o accede a funciones de miembro en los estudios. Solo se
crean dimensiones regulares. Durante la actualización, no existen suficientes
metadatos para crear dimensiones de medida por lo que debe crearlas
manualmente. Luego puede relacionar las dimensiones con las medidas
mediante la definición del ámbito en el modelo.
Si actualiza asuntos de consulta a dimensiones, los nombres de los elementos de
consulta del modelo se cambian. Por ejemplo, un elemento de consulta calificado
previamente como espacio_nombres.asunto_consulta.elemento_consulta ahora se
califica como espacio_nombres.dimensión.jerarquía.nivel.elemento_consulta. Debido a
Capítulo 11. Actualización de modelos 379

que este cambio de nombres puede invalidar informes existentes, actualice los
asuntos de consulta a dimensiones solo cuando desee utilizar un modelo
existente para construir una nueva aplicación que necesite la capacidad
dimensional.
La información de dimensiones se correlaciona con los determinantes y las
dimensiones de la manera siguiente.
Información de dimensiones Determinantes Dimensiones
Jerarquías En orígenes de datos
relacionales, la primera
jerarquía crea el
determinante.
Niveles Determinantes, ya sean
identificados de forma
exclusiva o agrupar por
Claves Si no se selecciona Clave
exclusiva, los segmentos de
clave de niveles superiores se
incluyen en la clave.
Atributo de texto por orden
alfabético
Atributos Atributos
Si se selecciona Clave
exclusiva, solo el segmento o
segmentos de clave, para el
nivel se incluyen en la clave.
Los atributos no asociados se
asignan al último
determinante que,
generalmente, corresponde al
nivel más bajo.
Jerarquías
En orígenes de datos SAP
BW, las jerarquías
alternativas se actualizan a
jerarquías alternativas de una
dimensión.
Niveles
El primer nivel de la
jerarquía se define
automáticamente como nivel
Todo. Contiene un único
miembro raíz, que representa
el nivel superior de la
jerarquía.
No se puede suprimir ni
mover el nivel Todo. Sí se
puede cambiar el nombre, la
descripción y la sugerencia.
_businessKey role
Nivel exclusivo
_memberCaption role
Se puede asignar
manualmente para que sea el
rol _memberDescription, el
rol personalizado o ningún
rol.
Revisión posterior a la conversión
Después de convertir los asuntos de consulta con información de dimensiones en
asuntos de consulta con determinantes, deberá revisar los siguientes valores:
380 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

v Identificado exclusivamente
Al definir un determinante único, está indicando que la clave contiene suficiente
información para identificar un grupo en los datos.
v Agrupar por
Deberá especificar Agrupar por cuando defina un determinante no único. Esto
indica a IBM Cognos BI que, cuando las claves o los atributos asociados a ese
determinante se repitan en los datos, deberá aplicar funciones de agregado y
agrupación para evitar el recuento doble.
v Varias jerarquías, o alternativas, existentes en ReportNet
Si existían dos jerarquías en un asunto de consulta en ReportNet, sólo se
actualiza la primera jerarquía a un determinante para orígenes de datos
relacionales. Deberá crear un segundo asunto de consulta y especificar
manualmente los determinantes para la otra jerarquía.
En orígenes de datos de SAP BW, las jerarquías alternativas se actualizan a
determinantes.
Después de convertir los asuntos de consulta con información de dimensiones,
deberá revisar los siguientes valores:
v _businessKey role
Este rol representa la clave para el nivel y sólo se puede asignar a un atributo en
un nivel.
v Nivel exclusivo
Un nivel exclusivo indica que las claves de los niveles superiores no son
necesarias para identificar los miembros de este nivel.
v _memberCaption role
Para aprovechar las funciones de miembros en los estudios de IBM Cognos,
debe asignar un rol _memberCaption a cada nivel en una dimensión. Si no hay
atributos para el nivel, la ausencia de un título se resalta al verificar el modelo.
Todos los títulos deben tener el tipo de datos de cadena. Si no hay ningún
atributo de este tipo disponible, cree un cálculo que sea un tipo de datos de
cadena y asigne el rol _memberCaption al nuevo elemento. Esto es
principalmente un problema para Analysis Studio.
v Atributos
Incluya atributos en la dimensión y asócielos al nivel correcto. De forma
predeterminada, se incluyen sin ningún rol. Puede crear roles personalizados o
asignar atributos a roles existentes.
v Varias jerarquías
Una dimensión regular puede tener varias jerarquías; sin embargo, sólo puede
utilizar una jerarquía cada vez en una consulta. Por ejemplo, no puede utilizar
una jerarquía en las filas de un informe de tabla de referencias cruzadas y otra
jerarquía de la misma dimensión en las columnas. Si necesita ambas jerarquías
en el mismo informe, debe crear dos dimensiones, una para cada jerarquía.
Selección y reparación de objetos en modelos de IBM Cognos
ReportNet actualizados
El proceso de reparación evalúa primero todos los elementos seleccionados. Esta
evaluación resuelve automáticamente los problemas con los tipos de datos nuevos
y le solicita que repare la información de dimensiones del modelo.
Pueden aparecer los avisos siguientes cuando verifique y repare un modelo
actualizado:
Capítulo 11. Actualización de modelos 381

Aviso Descripción
Necesita reevaluación
Este mensaje tiene que ver la mayoría de las
veces con cambios en los tipos de datos.
La expresión de unión entra en conflicto con
la información de determinante definida en
el asunto de consulta
Puede seleccionar y reparar la mayoría de
los elementos con este aviso. Utilice la
opción de reparación para evaluar y
actualizar los metadatos específicos.
Algunas veces la información de índice y de
clave que se especifica para un asunto de
consulta implica un nivel de granularidad
que no coincide con las relaciones que se
han especificado en el asunto de consulta.
Ninguno de los elementos de consulta de
este nivel tienen un rol de título especificado Al definir niveles, compruebe que se
especifiquen una clave de empresa y roles
de títulos. Estos roles son necesarios para las
funciones de miembros de los estudios de
IBM Cognos y para ayudar en el árbol
orientado a miembros de Analysis Studio.
Uno o más determinantes que describen las
claves y los atributos del asunto de consulta
deben especificarse
Actualización de proyectos segmentados y enlazados
Todos los títulos deben tener el tipo de datos
de cadena. Si no hay ningún atributo de este
tipo disponible, cree un cálculo que sea un
tipo de datos de cadena y asigne el rol de
título de miembro al nuevo elemento. Esto
es principalmente un problema para
Analysis Studio.
Los determinantes se basan en la
información de clave del origen de datos. Es
posible que no existan determinantes para
un asunto de consulta actualizado desde
ReportNet; especialmente, para un asunto de
consulta de modelo. Utilice determinantes
para especificar la granularidad de los datos
de un asunto de consulta y las dependencias
funcionales entre los elementos de consulta.
No obstante, no es obligatorio especificar
determinantes para los asuntos de consulta
que representan un único nivel de datos de
hechos.
Esta información sirve para cualquier versión del producto desde la que esté
realizando la actualización.
En los proyectos segmentados, los segmentos se actualizan automáticamente al
abrir el proyecto maestro.
Debe actualizar un proyecto enlazado antes de actualizar los proyectos que utilizan
el proyecto enlazado.
Si el modelo segmentado o enlazado se ha creado con una versión anterior de IBM
Cognos Framework Manager, debe revisar los valores de los reguladores para cada
382 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

modelo padre e hijo antes y después de la actualización. Los valores de los
reguladores del modelo padre de nivel superior se aplican durante la publicación.
Si ejecuta un script creado con una versión anterior de Framework Manager, el
script pasa por alto el proceso de actualización. Repase la precisión de los valores
de los reguladores antes y después de ejecutar el script.
Si un proyecto segmentado no se actualiza automáticamente, siga estos pasos:
Procedimiento
1. Abra cada segmento como un proyecto separado, empezando por el segmento
de nivel inferior de la jerarquía.
2. Siga los pasos para actualizar el modelo.
Para obtener más información, consulte: Capítulo 11, “Actualización de
modelos”, en la página 375.
No repare el segmento.
3. Una vez que la actualización haya finalizado, guarde el proyecto.
4. Actualice cada uno de los segmentos de la jerarquía, regresando al proyecto
principal.
5. Repare todo el modelo en el proyecto maestro.
6. Después de actualizar el proyecto maestro, incorpore cada segmento y, después,
incorpore el proyecto maestro.
Capítulo 11. Actualización de modelos 383

384 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Apéndice A. Características de accesibilidad
Las características de accesibilidad ayudan a los usuarios que tienen una
discapacidad física, por ejemplo movilidad restringida o visión limitada, a utilizar
productos de tecnología de la información.
Características de accesibilidad en Framework Manager
Las características principales de accesibilidad son las teclas de aceleración y de
comandos que se pueden utilizar para navegar en Framework Manager.
v Una letra subrayada en la pantalla indica un acelerador; por ejemplo, A es la
tecla de aceleración para el menú Archivo. En Microsoft Windows, pulse la tecla
Alt y luego la tecla de aceleración para activar una acción; por ejemplo, Alt+A
muestra el menú Archivo. Si están habilitadas, también puede utilizar las teclas
de aceleración ampliadas.
v Las teclas de comando activan directamente una acción y normalmente se utiliza
la tecla Ctrl. Por ejemplo, para imprimir, pulse Ctrl+P.
Atajos de teclado para Framework Manager
Puede utilizar atajos de teclado para navegar por Framework Manager y realizar
algunas tareas.
Este producto utiliza las teclas de navegación estándar del sistema operativo
Microsoft Windows, además de teclas específicas de la aplicación.
Los siguientes atajos del teclado se basan en teclados estándar de EE. UU.
Descripción Atajo
Ayuda contextual F1
Nuevo archivo Ctrl + N
Abrir archivo Ctrl + O
Guardar archivo Ctrl + S
Deshacer Ctrl + Z
Rehacer Ctrl + Y
Cortar Ctrl+X
Copiar Ctrl+C
Pegar Ctrl+V
Suprimir Supr
Atajos de teclado para Model Design Accelerator
Puede utilizar atajos de teclado para navegar por Model Design Accelerator y
realizar algunas tareas.
Descripción Atajo en el diagrama
Diseño automático como árbol Ctrl + A
Diseño automático como estrella Ctrl + S
© Copyright IBM Corp. 2005, 2013 385

IBM y accesibilidad
Descripción Atajo en el diagrama
Acercar Ctrl + +
Alejar Ctrl + -
Ajustar diagrama a ventana Ctrl + 0 (cero)
Ajustar al 100% Ctrl + 1 (uno)
Deshacer Ctrl + Z
Rehacer Ctrl + Y
Añadir directamente tablas relacionadas Ctrl + D
Añadir recurrentemente todas las tablas
enlazadas por relaciones de tipo Muchos a
uno
Ctrl + T
Añadir tablas con Uno a muchos Ctrl + O
Añadir tablas con Muchos a uno Ctrl + M
Eliminar tablas seleccionadas Supr
Eliminar todas las tablas excepto las
seleccionadas
Mayús + Supr
Descripción Atajo en el acelerador de modelos
Cambiar nombre F2
Suprimir Supr
Acercar Ctrl + +
Alejar Ctrl + -
Ajustar diagrama a ventana Ctrl + 0 (cero)
Ajustar al 100% Ctrl + 1 (uno)
Deshacer Ctrl + Z
Rehacer Ctrl + Y
Visite IBM Accessibility Center (http://ibm.com/able) para obtener más
información sobre el compromiso que tiene IBM con respecto a la accesibilidad.
386 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Apéndice B. Resolución de problemas
Es posible que le surjan problemas al trabajar con Framework Manager.
Para otros temas de resolución de problemas, consulte: IBM CognosGuía de
administración y seguridad.
No se pueden comparar dos CLOB en Oracle
Si utiliza Oracle y solicita a IBM Cognos Business Intelligence que compare dos
CLOB, por ejemplo si C2 es igual a C3 (C2 = C3), recibirá un error de tiempo de
ejecución de Oracle.
Para evitar este problema, utilice el método DBMS_LOB.compare:
where 0 = dmbs_lob.compare (c1, c2)
Error de memoria insuficiente con metadatos ERWin importados
Cuando se prueban asuntos de consulta basados en una tabla Ver, puede
producirse un error de memoria insuficiente al realizar la operación
sqlPrepareWithOptions.
La solución es crear un asunto de consulta de orígenes de datos utilizando la
misma conexión de Content Manager que el modelo ERWin.
Framework Manager no puede acceder al URI de pasarela
Cuando crea un proyecto en Framework Manager, Framework Manager no puede
acceder al URI de la pasarela.
Aparece el siguiente mensaje:
No se puede acceder al servicio en el URL:
http://nombrehost:80/ibmcognos/cgi-bin/cognos.cgi/
b_acton=xts.run&m=portal/close.xts
Compruebe que la información del URI de la pasarela está configurada
correctamente y que el servicio se encuentra disponible.
Para obtener más información, póngase en contacto con su administrador de
servicio.
Este mensaje aparece si la pasarela no está bien configurada. El URI de pasarela
debe estar establecido en el nombre del sistema en el que IBM Cognos BI esté
instalado y reflejar el tipo de pasarela que esté usando. Debe iniciar sesión como
administrador para configurar el URI de pasarela.
Procedimiento
1. Cierre Framework Manager.
2. En la ventana Explorador de IBM Cognos Configuration, pulse Entorno.
© Copyright IBM Corp. 2005, 2013 387

3. En el cuadro URI de pasarela de la ventana Propiedades, escriba el valor
adecuado:
v Para usar ISAPI, sustituya cognos.cgi por cognosisapi.dll.
v Para usar apache_mod, sustituya cognos.cgi por mod_cognos.dll.
v Para usar una pasarela de servlet, escriba lo siguiente:
http[s]://host:puerto/context_name/servlet/Gateway
Nota: nombre_contexto es el nombre que asignó a la aplicación web
ServletGateway al desplegar el archivo WAR de ServletGateway.
v Si no está usando un servidor web, para utilizar el asignador como pasarela,
escriba lo siguiente:
http[s]://host:puerto/p2pd/servlet/dispatch
4. Si es necesario, cambie la parte del nombre de host del URI de pasarela de
localhost a la dirección IP o el nombre del sistema.
5. En el menú Archivo, pulse Guardar.
6. En el menú Acciones, pulse Reiniciar.
Los nombres de objetos aparecen en un idioma incorrecto
Al importar varios idiomas desde una consulta SAP BW a un modelo de
Framework Manager, no todos los nombres de objetos recuperados de SAP BW
aparecen en el idioma correcto.
Para evitar este problema, guarde la consulta SAP BW de nuevo en cada uno de
los idiomas de inicio de sesión en Business Explorer Query Designer. A
continuación, los textos del idioma correcto se mostrarán correctamente en
Framework Manager.
Las uniones externas completas en Oracle devuelven resultados
incorrectos
Cuando se utiliza un origen de datos Oracle anterior a la versión 10.2, las uniones
externas completas devuelven resultados incorrectos. Para evitar este problema,
IBM Cognos BI las procesa como operaciones locales.
Como resultado de este procesamiento, debe establecer el procesamiento de
consultas en limitedLocal para cualquier proyecto que espere uniones externas
explícitas o implícitas.
Error al probar asuntos de consulta en un modelo importado de
Teradata
Se utiliza un modelo importado de Teradata. Cuando se prueban algunos asuntos
de consulta que contienen elementos gráficos, se ve este error:
QE-DEF-0177 Se ha producido un error al realizar la operación 'sqlOpenResult'
estado='-28'.
UDA-SQL-0114 El cursor suministrado a la operación "sqlOpenResult" está
inactivo.
UDA-SQL-0107 Se ha producido una excepción general durante la operación
"SgiCursor::doOpenResult()".
388 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

[NCR][Controlador Teradata ODBC][Teradata RDBMS] Se ha solicitado una
traducción de cadena de caracteres desconocida.
La razón es que los tipos de datos GRAPHIC y VARGRAPHIC no están soportados.
Error para el asunto de consulta SQL de introducir
Error QE-DEF-0259
Se define lo siguiente en DB2:
create type address as (
number character (6),
street varchar(35),
city varchar(35)
)
MODE DB2SQL;
create table emp ( emp_no int, emp_address address);
Select e.emp_no, e.emp_address..street from emp e
SQL0206N "aBmtQuerySubject.2
Cuando se define un asunto de consulta SQL de introducir, aparece un error
debido al nombre asignado a la referencia del atributo en el tipo estructurado.
Para resolver este problema, dispone de dos opciones:
v Asignar un nombre de correlación simple a la columna en el asunto de consulta
original, como Select e.emp_no, e.emp_address..street as "ABC" from emp e
v Utilizar una notación pass-through para el asunto de consulta especificando la
columna entre llaves dobles ({{ }})
Este error se produce si coloca llaves {}enunaexpresión en una posición
incorrecta. IBM Cognos BI espera que todo lo que haya entre las llaves { } tenga el
mismo nivel que una función. Si ha usado llaves en otra posición de una
expresión, aparecerá el siguiente mensaje de error:
QE-DEF-0259 Se ha producido un error de análisis
También puede usar llaves para enviar una sintaxis única al origen de datos. Por
ejemplo, su base de datos usa una palabra clave para una función, pero esta
palabra clave no se utiliza en IBM Cognos BI.
IBM Cognos BI no valida la sintaxis que especifica entre llaves. La sintaxis se envía
simplemente al origen de datos.
La solución pasa por asegurarse de no usar llaves en una posición incorrecta.
Por ejemplo, escribe lo siguiente en una expresión:
[ss_ole_both].[authors_lith].[au_id] = [ss_ole_both].[authors_latin].[au_id]
{ collate Lithuanian_CI_AI}
Aparecerá el siguiente mensaje de error:
QE-DEF-0259 Se ha producido un error de análisis antes o cerca de la posición: 75,
el texto comienza en la posición: 5
"le_both].[authors_lith].[au_id]=[ss_ole_both].[authors_latin].[au_id]{"
En cambio, la siguiente expresión es válida:
Apéndice B. Resolución de problemas 389

{ Q3.au_id } = { Q4.au_id collate lithuanian_CI_AI
}
La dimensión de cifras clave externalizada conserva un valor de
solicitud anterior
Dispone de una dimensión de cifras clave (SAP BW) que contiene una solicitud
opcional. Si externaliza esta dimensión como archivo csv o tab, el archivo
externalizado no contiene todas las filas de datos. Esto es debido a que se ha
conservado el valor de solicitud.
Por ejemplo, establece el valor de solicitud para la dimensión al probar la
dimensión en Framework Manager. El valor de solicitud se conserva en la memoria
caché. Aunque borre el valor de la solicitud del cuadro de diálogo Solicitud, la
externalización de la dimensión de cifras clave da lugar a un archivo que contiene
datos filtrados por la solicitud utilizada más recientemente.
Para evitar este problema, realice una de las acciones siguientes:
v No pruebe la dimensión de cifras clave antes de externalizarla.
v Cierre el modelo, vuélvalo a abrir y externalice la dimensión de cifras clave.
Los modelos antiguos muestran seguridad de objetos de nivel
Si está usando un modelo creado antes en IBM Cognos, puede que se haya
definido la seguridad de objetos en un nivel. No se soporta la seguridad de objetos
en un nivel.
La solución pasa por verificar y reparar el modelo anterior antes de publicarlo.
Procedimiento
1. En el menú Proyecto, pulse Verificar modelo.
2. Seleccione la vista de seguridad que hace referencia a un nivel y pulse Reparar.
La exportación de un modelo de Framework Manager a un archivo
CWM falla con el error No se ha encontrado MILOG.TXT
La exportación de un modelo de Framework a un archivo CWM falla con el error
No se ha encontrado MILOG.TXT cuando la ruta contiene caracteres japoneses.
Realice una de las acciones siguientes para resolver este problema:
v Especifique una ruta de exportación que no utilice caracteres japoneses.
v Cambie el idioma predeterminado del sistema a japonés. Puede establecer el
idioma predeterminado del sistema en el Panel de control, bajo Configuración
regional y de idioma -> Avanzada. Para obtener más información sobre cómo
hacerlo, consulte la ayuda del sistema operativo Microsoft Windows.
Diferencia en las uniones internas de SQL después de actualizar a IBM
Cognos BI, versión 8.3 y posteriores
Si ha migrado desde una versión del producto anterior a 8.3, puede haber
diferencias en la generación del SQL utilizado para la sintaxis INNER JOIN.
390 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Puede controlar la sintaxis SQL utilizada en las uniones internas configurando el
valor del regulador Sintaxis de unión SQL. La sintaxis de unión SQL generada en
todas las versiones de IBM Cognos BI produce el mismo resultado.
Si está usando una tecnología de materialización RDBMS que se puede
implementar por medio de sintaxis implícita o explícita, debe asegurarse de que
selecciona el mismo valor de sintaxis para el regulador Sintaxis de unión SQL de
su modelo.
Uniones externas completas no enviadas a Oracle 9i y 10GR1
De forma predeterminada, IBM Cognos BI no enviará uniones externas completas a
ORACLE 9i y 10GR1 debido al error de Oracle #2874433. Esto necesita la
utilización de procesamiento local limitado en IBM Cognos BI.
Para habilitar las uniones externas completas, debe
v Asegurarse de que tiene los conjuntos de parches necesarios, que incluyen el
arreglo para el error #2874433
v Modificar el archivo cogdmor.ini para activar las uniones externas completas
(unión_externa_completa=T)
Como las ediciones manuales de los valores de ini se sobrescriben por la siguiente
instalación, debe replicarlos en todas las máquinas donde ha instalado IBM Cognos
BI o Framework Manager.
Discrepancias injustificadas en cálculos numéricos
Es posible que encuentre discrepancias injustificadas en los cálculos numéricos
debido a la existencia de errores de redondeo.
Por ejemplo:
v Ejecuta pruebas de regresión y detecta diferencias en números. Lo único que les
diferencia es el redondeo aplicado a las posiciones decimales.
v Opta por que no se visualicen los ceros en los informes, pero los ceros siguen
mostrándose de todas formas porque existen posiciones decimales (por ejemplo:
0,00000000000000426) que se han redondeado a cero en los informes.
Los problemas de redondeo no son específicos del software de IBM Cognos.
Pueden producirse en cualquier entorno en el que tenga lugar el redondeo.
Errores de redondeo binario
Es posible que se produzcan discrepancias en los cálculos debido a la existencia de
errores de redondeo binario. Por ejemplo, si el número 1,1 se representa como un
número binario decimal flotante y el formato de informe utilizado incluye un
número grande de posiciones decimales, puede que el número 1,1 sea en realidad
1,09999999999997.
Si en el formato del informe se ha definido que solo se utilice una coma flotante, se
realizará el redondeo decimal y se compensará el redondeo binario. Por lo tanto, el
número aparece como 1,1 cuando en realidad es 1,09999999999997. Cuando el
número se utilice en los cálculos, puede que obtenga errores de redondeo. Por
ejemplo, los cálculos de Microsoft Excel utilizan números binarios (sin redondear
las posiciones decimales) pero el formateo de los informes muestra posiciones
decimales redondeadas, lo cual puede crear pequeñas discrepancias.
Apéndice B. Resolución de problemas 391

Errores de redondeo en divisiones
Por lo general, los cálculos que implican divisiones suelen generar errores de
redondeo, con independencia de la forma en que se representen los números.
Ejemplos de este tipo de cálculos son las operaciones Promedio y Porcentaje de
base.
Directrices de diseño para minimizar el efecto del redondeo
La mejor solución es cambiar el esquema de base de datos o modelo de cubo
subyacente, aunque no siempre es posible hacerlo. Otra solución es minimizar el
efecto del redondeo siguiendo las directrices que se indican a continuación al crear
informes y al crear modelos en IBM Cognos Framework Manager y cubos OLAP
externos:
v No almacene los datos en formato con coma flotante siempre que sea posible. En
especial, cuando se gestionan valores de moneda que deben almacenarse como
decimales de coma fija o bien como enteros con un valor de escala, como 2.
Por ejemplo, en un cubo, los Ingresos de Equipo de acampada de 2012 son
20.471.328,88 $. Si los detalles de los ingresos se almacenan como números
decimales flotantes, pueden producirse errores de redondeo al calcular los
ingresos.
Es posible que los errores de redondeo sólo generen ligeras diferencias, en
función del orden del cálculo. Si los ingresos de Productos se calculan en primer
lugar y los ingresos de Tiempo se calculan en segundo lugar, puede que obtenga
un error de redondeo distinto del que obtendría si Tiempo se calculara en
primer lugar y Productos se calculara en segundo lugar.
El cálculo de los ingresos totales podría producir el número anteriormente
indicado. O puede que existan ligeras discrepancias; por ejemplo,
20.471.328,8800001 euros en lugar de 20.471.328,88 euros. El número interno
podría ser ligeramente distinto del valor que se muestra. El número incluso
podría ser otro para distintas ejecuciones del mismo informe, en función del
orden que el motor de OLAP utilice para los cálculos.
v En los informes, evite las divisiones siempre que sea posible. Cuando sea
ineludible aplicar divisiones, intente aplicarlas siempre en las últimas fases del
proceso de cálculo. Por ejemplo, en lugar de Total([Ingresos]/1000), utilice
Total([Ingresos])/1000.
v Al realizar comparaciones, permita un margen para el redondeo. Por ejemplo,
desea que [Porcentaje de beneficios] sea un valor fraccional con formato de
porcentaje sin decimales. Sin embargo, el filtro [Porcentaje de beneficios]0 (o
[Porcentaje de beneficios] NO ENTRE 0y0)rechaza los valores cero y, aun así,
puede devolver valores que aparecen como 0% después de aplicar el formateo.
Para evitar esto, aplique el filtro de una de estas dos formas:
– [Porcentaje de beneficios] NO ENTRE -0,005 y 0,005
– ([Porcentaje de beneficios] 0,005)
Observe que 0,005 equivale a 0,5%, que se muestra como 0% o 1%, según las
pérdidas de precisión de la coma flotante.
En algunos casos, puede ser preferible controlar los errores de redondeo
redondeando los valores de forma explícita. Por ejemplo, en lugar de [Porcentaje
de beneficios], utilice round([Porcentaje de beneficios],2).
v Vuelva a calcular las cifras cada vez en lugar de reutilizar cálculos que podrían
contener decimales redondeados.
392 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Puede que tengan consideraciones adicionales para Microsoft Analysis Services
2005/2008, en especial cuando se comparan resultados de informes de distintas
ejecuciones (como sucede en Lifecycle Manager). Para obtener más información,
consulte la documentación de Microsoft.
La búsqueda de valores podría devolver resultados no esperados
En el editor de expresiones, al buscar valores un elemento de datos, los resultados
que se obtienen podrían contener resultados no esperados si el elemento de datos
no es del tipo de datos de cadena. Debido a que se puede editar la expresión para
un elemento de datos, IBM Cognos Business Intelligence no puede determinar con
exactitud de qué tipo de datos se trata.
Por lo tanto, IBM Cognos Business Intelligence adivina el tipo de datos del
elemento de datos consultando su agregado y el conjunto de agregados de
resumen.
Apéndice B. Resolución de problemas 393

394 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Apéndice C. Uso del editor de expresiones
Operadores
(
)
*
,
/
Una expresión es cualquier combinación de operadores, constantes, funciones y
otros componentes que evalúa un solo valor. Se construyen expresiones para crear
definiciones de cálculo y de filtro. Un cálculo es una expresión que se usa para
crear un nuevo valor a partir de valores existentes contenidos en un elemento de
datos. Un filtro es una expresión que se usa para recuperar un subconjunto
específico de registros.
Cree expresiones utilizando los componentes que se definen más abajo.
Los operadores especifican lo que ocurre a los valores en los dos lados del
operador. Los operadores son similares a las funciones, ya que manipulan
elementos de datos y devuelven un resultado.
Identifica el principio de una expresión.
Sintaxis
( expression )
Identifica el final de una expresión.
Sintaxis
( expression )
Multiplica dos valores numéricos.
Sintaxis
value1 * value2
Separa los componentes de la expresión.
Sintaxis
expression ( parameter1, parameter2 )
Divide dos valores numéricos.
Sintaxis
value1 / value2
© Copyright IBM Corp. 2005, 2013 395

||
+
-
<
Concatena, o une, cadenas.
Sintaxis
string1 || string2
Añade dos valores numéricos.
Sintaxis
value1 + value2
Resta dos valores numéricos o convierte un valor numérico en negativo.
Sintaxis
value1 - value2
or
- value
Compara los valores representados por "value1" con los valores de "value2" y
recupera los valores que son menores que "value2".
Sintaxis
value1 < value2
Compara los valores representados por "value1" con "value2" y recupera los valores
que son menores o iguales a "value2".
Sintaxis
value1

->
>=
and
auto
Sintaxis
value1 > value2
Separa los componentes de una expresión de miembros literales.
Sintaxis
[namespace].[dimension].[hierarchy].[level]->[L1]
Compara los valores representados por "value1" con los valores de "value2" y
recupera los valores que son mayores que o iguales a "value2".
Sintaxis
value1 >= value2
Devuelve "true" si las condiciones de ambos lados de la expresión son verdaderas.
Sintaxis
argument1 and argument2
Se utiliza con expresiones de resumen para definir el ámbito que se debe ajustar
según las columnas de agrupación de la consulta. El ámbito depende del contexto.
Sintaxis
aggregate_function ( expression AUTO )
between
Determina si un valor está comprendido en un rango determinado.
Sintaxis
expression between value1 and value2
Ejemplo
[Revenue] between 200 and 300
Resultado
Devuelve el número de resultados con ingresos entre 200 y 300.
Datos de resultado
Revenue Between
$332.06 false
$230.55 true
$107.94 false
Apéndice C. Uso del editor de expresiones 397

case
Se utiliza con when, then, else y end. Case identifica el principio de una situación
específica, en la que están definidas las acciones when, then y else.
Sintaxis
case expression { when expression then expression } [ else
expression ] end
contains
Determina si "string1" contiene "string2".
Sintaxis
string1 contains string2
currentMeasure
Palabra clave que se puede utilizar como primer argumento de funciones de
resumen de los miembros. Esta función aparece en el informe de ejemplo Ingresos
totales por país del paquete Almacén de datos VA (consulta).
Sintaxis
aggregate_function ( currentMeasure within set expression )
default
Se utiliza con la construcción lookup.
Sintaxis
lookup (....) in (....) default (....)
distinct
Una palabra clave utilizada en una expresión de agregado para incluir solo las
apariciones distintas de valores. Consulte también la función unique.
else
Sintaxis
distinct dataItem
Ejemplo
count ( distinct [OrderDetailQuantity] )
Resultado
1704
Se utiliza con las construcciones if o case. Si la condición if o la expresión case no
son verdaderas, se utiliza la expresión else. Esta función aparece en el informe de
ejemplo 10 mejores minoristas para 2005 del paquete Almacén de datos VA
(análisis).
Sintaxis
if ( condition ) then .... else ( expression ),orcase .... else (
expression ) end
398 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

end
Indica el final de una construcción case o when.
Sintaxis
case .... end
ends with
Determina si "string1" finaliza en "string2".
Sintaxis
string1 ends with string2
escape
Determina si "string1" coincide con el patrón de "string2", con el carácter "char"
utilizado opcionalmente para escapar caracteres de la cadena de patrón.
for
for all
Sintaxis
string1 LIKE string2 [ ESCAPE char ]
Ejemplo 1
[PRODUCT_LINE] like ’G%’
Resultado
Todas las líneas de producto que empiezan por 'G'.
Ejemplo 2
[PRODUCT_LINE] like ’%Ga%’ escape ’a’
Resultado
Todas las líneas de producto que terminan por 'G%'.
Se utiliza con expresiones de resumen para definir el ámbito de la agregación en la
consulta.
Sintaxis
aggregate_function ( expression for expression { , expression } )
Se utiliza con expresiones de resumen para definir que el ámbito sea todas las
columnas de agrupación especificadas en la consulta. Consulte también la cláusula
for.
Sintaxis
aggregate_function ( expression for ALL expression { , expression } )
for any
Se utiliza con expresiones de resumen para definir que el ámbito se debe ajustar
según un subconjunto de columnas de agrupación de la consulta. Equivale a la
cláusula for.
Apéndice C. Uso del editor de expresiones 399

Sintaxis
aggregate_function ( expression for ANY expression { , expression } )
for report
Se utiliza con expresiones de resumen para definir que el ámbito sea toda la
consulta. Consulte también la cláusula for. Esta función aparece en el informe de
ejemplo Devoluciones de cliente y satisfacción del paquete Almacén de datos VA
(análisis).
if
in
Sintaxis
aggregate_function ( expression for report )
Se utiliza con las construcciones then y else. Si define una condición; cuando la
condición if es verdadera, se utiliza la expresión then. Cuando la condición if no es
verdadera, se utiliza la expresión. Esta función aparece en el informe de ejemplo 10
mejores minoristas para 2005 del paquete Almacén de datos VA (análisis).
Sintaxis
if ( condition ) then ( expression ) else ( expression )
Determina si "expression1" existe en una lista de expresiones determinada.
Sintaxis
expression1 in ( expression_list )
in_range
Determina si "expression1" existe en una lista de valores o rangos constantes.
Sintaxis
expression1 in_range { constant : constant [ , constant :
constant ] }
Ejemplo 1
[code] in_range {5}
Resultado
Esto es equivalente a [código] = 5.
Ejemplo 2
[code] in_range { 5: }
Resultado
Es equivalente a [code] >= 5.
Ejemplo 3
[code] in_range { :5 }
Resultado
400 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Es equivalente a [code] = 5 y [code]

Todas las líneas de producto que empiezan por 'G'.
Ejemplo 2
[PRODUCT_LINE] like ’%Ga%’ escape ’a’
Resultado
Todas las líneas de producto que terminan por 'G%'.
lookup
Busca y sustituye datos por el valor que especifique. Es preferible utilizar la
construcción case.
not
or
Sintaxis
lookup ( name ) in ( value1 --> value2 ) default ( expression )
Ejemplo
lookup ( [Country]) in ( ’Canada’--> ( [List Price] * 0.60),
’Australia’--> ( [List Price] * 0.80 ) ) default ( [List Price] )
Devuelve TRUE si "argument" es falso o devuelve FALSE si "argument" es
verdadero.
Sintaxis
NOT argument
Devuelve TRUE si ni "argument1" ni "argument2" son verdaderos.
Sintaxis
argument1 or argument2
prefilter
Realiza un cálculo de resumen antes de aplicar el filtro de resumen.
Sintaxis
summary_function ([expression] prefilter)
Ejemplo
total ( [Quantity] for report prefilter )
summaryFilter: total(
[Quantity] for [ProductNo] ) > 50000
Resultado
Suma las cantidades de un informe antes de que se aplique el filtro de resumen.
Datos de resultado
ProductNo Total_forProductNo Total_forReport Total_forReport_Prefilter
88 54928 298140 2215354
89 51126 298140 2215354
402 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

ows
rows
ProductNo Total_forProductNo Total_forReport Total_forReport_Prefilter
90 69996 298140 2215354
94 69004 298140 2215354
95 53086 298140 2215354
Cuenta el número de filas devueltas por la consulta. Se utiliza con Count ().
Sintaxis
count ( ROWS )
Cuenta el número de filas devueltas por la consulta. Se utiliza con Count ().
Sintaxis
count ( ROWS [ expression ])
starts with
Determina si "string1" comienza por "string2".
then
when
Funciones de resumen
Sintaxis
string1 starts with string2
Se utiliza con las construcciones if o case. Cuando la condición if o la expresión
then son verdaderas, se utiliza la expresión then. Esta función aparece en el
informe de ejemplo 10 mejores minoristas para 2005 del paquete Almacén de datos
VA (análisis).
Sintaxis
if ( condition ) then ..., or case expression when expression
then .... end
Se utiliza con la construcción case. Puede definir las condiciones que han de
producirse cuando la expresión WHEN es verdadera.
Sintaxis
case [expression] when ... end
Esta lista contiene funciones predefinidas que devuelven un valor de resumen
único para un grupo de valores relacionados o un valor de resumen diferente para
cada instancia de un grupo de valores relacionados.
Funciones estadísticas
Esta lista contiene funciones de resumen predefinidas de naturaleza estadística.
Apéndice C. Uso del editor de expresiones 403

corr
Devuelve el coeficiente de correlación de un conjunto de pares de números. Esto se
calcula de la manera siguiente: COVAR_POP(expresión_numérica1,
expresión_numérica2) / (STDDEV_POP(expresión_numérica1) *
STDDEV_POP(expresión_numérica2))
Sintaxis
corr ( numeric_expression1 , numeric_expression2 [ auto ] )
corr ( numeric_expression1 ,
expression { , expression } )
numeric_expression2 for [ all|any ]
corr ( numeric_expression1 , numeric_expression2 for report )
Ejemplo
corr ( Cost , Margin for report)
Resultado
El coeficiente de correlación entre Coste y Margen.
Datos de resultado
Cost Margin
corr (Cost, Margin for
report)
4 0.33 0.0872648
5 0.28 0.0872648
9.22 0.23 0.0872648
15.93 0.28 0.0872648
34.97 0.3 0.0872648
covariance-pop
Devuelve la covarianza de población de un conjunto de pares de números.
Sintaxis
covariance-pop ( numeric_expression1 , numeric_expression2 )
covariance-pop ( numeric_expression1 , numeric_expression2 for
[ all|any ] expression { , expression } )
covariance-pop ( numeric_expression1 , numeric_expression2 for
report )
Ejemplo
covariance-pop ( Cost , Margin for report)
Resultado
La covarianza de población entre Coste y Margen.
Datos de resultado
Cost Margin
covariance-pop (Cost,
Margin for report)
4 0.33 0.032384
5 0.28 0.032384
9.22 0.23 0.032384
15.93 0.28 0.032384
34.97 0.3 0.032384
404 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

covariance-samp
Devuelve la covarianza de ejemplo de un conjunto de pares de números.
Sintaxis
covariance-samp ( numeric_expression1 , numeric_expression2 )
covariance-samp ( numeric_expression1 , numeric_expression2 for
[ all|any ] expression { , expression } )
covariance-samp ( numeric_expression1 , numeric_expression2 for
report )
Ejemplo
covariance-samp ( Cost , Margin for report)
Resultado
La covarianza de ejemplo entre Coste y Margen.
Datos de resultado
Cost Margin
covariance-samp (Cost,
Margin for report)
4 0.33 0.04048
5 0.28 0.04048
9.22 0.23 0.04048
15.93 0.28 0.04048
34.97 0.3 0.04048
regression-average-x
Devuelve el promedio de la variable independiente (expresión_numérica2) de la
línea de regresión.
Sintaxis
regression-average-x ( numeric_expression1 , numeric_expression2 )
regression-average-x ( numeric_expression1 , numeric_expression2 for
[ all|any ] expression { , expression } )
regression-average-x ( numeric_expression1 , numeric_expression2 for
report )
Ejemplo
regression-average-x ( Cost , Margin for report)
Resultado
El promedio de Margen en la línea de regresión para Coste y Margen.
Datos de resultado
Cost Margin
regression-average-x (Cost,
Margin for report)
4 0.33 0.284
5 0.28 0.284
9.22 0.23 0.284
15.93 0.28 0.284
34.97 0.3 0.284
Apéndice C. Uso del editor de expresiones 405

egression-average-y
Devuelve el promedio de la variable dependiente (expresión_numérica1) de la línea
de regresión.
Sintaxis
regression-average-y ( numeric_expression1 , numeric_expression2 )
regression-average-y ( numeric_expression1 , numeric_expression2 for
[ all|any ] expression { , expression } )
regression-average-y ( numeric_expression1 , numeric_expression2 for
report )
Ejemplo
regression-average-y ( Cost , Margin for report)
Resultado
El promedio de Coste en la línea de regresión para Coste y Margen.
Datos de resultado
Cost Margin
regression-average-y (Cost,
Margin for report)
4 0.33 13.824
5 0.28 13.824
9.22 0.23 13.824
15.93 0.28 13.824
34.97 0.3 13.824
regression-count
Devuelve el número de números no nulos utilizados para ajustarse a la línea de
regresión.
Sintaxis
regression-count ( numeric_expression1 , numeric_expression2 )
regression-count ( numeric_expression1 , numeric_expression2 for
[ all|any ] expression { , expression } )
regression-count ( numeric_expression1 , numeric_expression2 for
report )
Ejemplo
regression-count ( Cost , Margin for report)
Resultado
El número de números no nulos utilizados para ajustarse a la línea de regresión
para Coste y Margen.
Datos de resultado
Cost Margin
regression-count (Cost,
Margin for report)
4 0.33 5
5 0.28 5
9.22 0.23 5
15.93 0.28 5
34.97 0.3 5
406 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

egression-intercept
Devuelve la intersección Y de la línea de regresión. Esto se calcula de la manera
siguiente: AVG(expresión_numérica1) - REGR_SLOPE(expresión_numérica1,
expresión_numérica2) * AVG(expresión_numérica2)
Sintaxis
regression-intercept ( numeric_expression1 , numeric_expression2 )
regression-intercept ( numeric_expression1 , numeric_expression2 for
[ all|any ] expression { , expression } )
regression-intercept ( numeric_expression1 , numeric_expression2 for
report )
Ejemplo
regression-intercept ( Cost , Margin for report)
Resultado
La intersección Y de la línea de regresión para Coste y Margen.
Datos de resultado
Cost Margin
regression-intercept (Cost,
Margin for report)
4 0.33 5.18015038
5 0.28 5.18015038
9.22 0.23 5.18015038
15.93 0.28 5.18015038
34.97 0.3 5.18015038
regression-r2
Devuelve el coeficiente de determinación (también conocido como "R al cuadrado"
o "bondad de ajuste") de la línea de regresión. Este valor se calcula basándose en
las condiciones siguientes: IF VAR_POP(expresión_numérica2) = 0 THEN NULL IF
VAR_POP(expresión_numérica1) = 0 AND VAR_POP(expresión_numérica2) 0
THEN 1 IF VAR_POP(expresión_numérica1) >0and
VAR_POP(expresión_numérica2) 0 THEN POWER(CORR
(expresión_numérica1, expresión_numérica2))
Sintaxis
regression-r2 ( numeric_expression1 , numeric_expression2 )
regression-r2 ( numeric_expression1 , numeric_expression2 for
[ all|any ] expression { , expression } )
regression-r2 ( numeric_expression1 , numeric_expression2 for
report )
Ejemplo
regression-r2 ( Cost , Margin for report)
Resultado
El coeficiente de determinación de la línea de regresión para Coste y Margen.
Datos de resultado
Apéndice C. Uso del editor de expresiones 407

Cost Margin
regression-r2 (Cost, Margin
for report)
4 0.33 0.00761514
5 0.28 0.00761514
9.22 0.23 0.00761514
15.93 0.28 0.00761514
34.97 0.3 0.00761514
regression-slope
Devuelve la pendiente de la línea de regresión. Esto se calcula de la manera
siguiente: COVAR_POP(expresión_numérica1,expresión_numérica2) /
VAR_POP(expresión_numérica2)
Sintaxis
regression-slope ( numeric_expression1 , numeric_expression2 )
regression-slope ( numeric_expression1 , numeric_expression2 for
[ all|any ] expression { , expression } )
regression-slope ( numeric_expression1 , numeric_expression2 for
report )
Ejemplo
regression-slope ( Cost , Margin )
Resultado
La pendiente de la línea de regresión para Coste y Margen.
Datos de resultado
Cost Margin
regression-slope (Cost,
Margin for report)
4 0.33 30.43609023
5 0.28 30.43609023
9.22 0.23 30.43609023
15.93 0.28 30.43609023
34.97 0.3 30.43609023
regression-sxx
Devuelve el cálculo siguiente después de eliminar los pares NULL:
REGR_COUNT(expresión_numérica1, expresión_numérica2) *
VAR_POP(expresión_numérica2)
Sintaxis
regression-sxx ( numeric_expression1 , numeric_expression2 )
regression-sxx ( numeric_expression1 , numeric_expression2 for
[ all|any ] expression { , expression } )
regression-sxx ( numeric_expression1 , numeric_expression2 for
report )
Ejemplo
regression-sxx ( Cost , Margin for report)
Resultado
El cálculo sxx de la línea de regresión para Coste y Margen.
408 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Datos de resultado
Cost Margin
regression-sxx (Cost,
Margin for report)
4 0.33 0.00532
5 0.28 0.00532
9.22 0.23 0.00532
15.93 0.28 0.00532
34.97 0.3 0.00532
regression-sxy
Devuelve el cálculo siguiente después de eliminar los pares NULL:
REGR_COUNT(expresión_numérica1, expresión_numérica2) *
COVAR_POP(expresión_numérica1, expresión_numérica2)
Sintaxis
regression-sxy ( numeric_expression1 , numeric_expression2 )
regression-sxy ( numeric_expression1 , numeric_expression2 for
[ all|any ] expression { , expression } )
regression-sxy ( numeric_expression1 , numeric_expression2 for
report )
Ejemplo
regression-sxy ( Cost , Margin for report)
Resultado
El cálculo sxy de la línea de regresión para Coste y Margen.
Datos de resultado
Cost Margin
regression-sxy (Cost,
Margin for report)
4 0.33 0.16192
5 0.28 0.16192
9.22 0.23 0.16192
15.93 0.28 0.16192
34.97 0.3 0.16192
regression-syy
Devuelve el cálculo siguiente después de eliminar los pares NULL:
REGR_COUNT(expresión_numérica1, expresión_numérica2) *
VAR_POP(expresión_numérica1)
Sintaxis
regression-syy ( numeric_expression1 , numeric_expression2 )
regression-syy ( numeric_expression1 , numeric_expression2 for
[ all|any ] expression { , expression } )
regression-syy ( numeric_expression1 , numeric_expression2 for
report )
Ejemplo
regression-syy ( Cost , Margin for report)
Resultado
Apéndice C. Uso del editor de expresiones 409

El cálculo syy de la línea de regresión para Coste y Margen.
Datos de resultado
Cost Margin
regression-syy (Cost,
Margin for report)
4 0.33 647.15932
5 0.28 647.15932
9.22 0.23 647.15932
15.93 0.28 647.15932
34.97 0.3 647.15932
standard-deviation
Devuelve la desviación estándar de los elementos de datos seleccionados.
Sintaxis
standard-deviation ( expression [ auto ] )
standard-deviation ( expression for [ all|any ] expression { ,
expression } )
standard-deviation ( expression for report )
Ejemplo
standard-deviation ( ProductCost )
Resultado
Devuelve un valor que indica la desviación entre el coste del producto y el coste
medio del producto.
standard-deviation-pop
Calcula la desviación estándar de la población y devuelve la raíz cuadrada de la
varianza de la población.
Sintaxis
standard-deviation-pop ( expression [ auto ] )
standard-deviation-pop ( expression for [ all|any ] expression { ,
expression } )
standard-deviation-pop ( expression for report )
Ejemplo
standard-deviation-pop ( ProductCost )
Resultado
Devuelve un valor de la raíz cuadrada de la varianza de la población.
standard-deviation-samp
Calcula la desviación estándar de ejemplo y devuelve la raíz cuadrada de la
varianza de población.
Sintaxis
standard-deviation-samp ( expression [ auto ] )
standard-deviation-samp ( expression for [ all|any ] expression { ,
expression } )
standard-deviation-samp ( expression for report )
410 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Ejemplo
standard-deviation-samp ( ProductCost )
Resultado
Devuelve un valor de la raíz cuadrada de la varianza de ejemplo.
variance
Devuelve la varianza de los elementos de datos seleccionados.
Sintaxis
variance ( expression [ auto ] )
variance ( expression for [ all|any ] expression { , expression } )
variance ( expression for report )
Ejemplo
variance ( Product Cost )
Resultado
Devuelve un valor que indica hasta qué punto varía el coste del producto respecto
al coste medio del producto.
variance-pop
Devuelve la varianza de la población de un conjunto de números tras descartar los
valores nulos del conjunto.
Sintaxis
variance-pop ( expression [ auto ] )
variance-pop ( expression for [ all|any ] expression { ,
expression } )
variance-pop ( expression for report )
Ejemplo
variance-pop ( Qty )
Resultado
Por cada fila, devuelve la varianza de población de un conjunto de números tras
descartar los valores nulos del conjunto.
variance-samp
Devuelve la varianza de ejemplo de un conjunto de números después de descartar
los nulos de este conjunto.
Sintaxis
variance-samp ( expression [ auto ] )
variance-samp ( expression for [ all|any ] expression { ,
expression } )
variance-samp ( expression for report )
Ejemplo
variance-samp ( Qty )
Resultado
Apéndice C. Uso del editor de expresiones 411

Para cada fila, devuelve la varianza de ejemplo de un conjunto de números
después de descartar los nulos de este conjunto.
aggregate
Devuelve un valor calculado mediante la utilización de la función de agregación
adecuada, según el tipo de agregación de la expresión. Esta función aparece en el
informe de ejemplo Presupuesto frente a real del paquete Almacén de datos VA
(análisis).
Sintaxis
aggregate ( expression [ auto ] )
aggregate ( expression for [ all|any ] expression { , expression } )
aggregate ( expression for report )
average
Devuelve el valor promedio de los elementos de datos seleccionados. Distinct es
una expresión alternativa compatible con versiones anteriores del producto.
count
Sintaxis
average ( [ distinct ] expression [ auto ] )
average ( [ distinct ] expression for [ all|any ] expression { ,
expression } )
average ( [ distinct ] expression for report )
Ejemplo
average ( Sales )
Resultado
Devuelve el promedio de todos los valores de Ventas.
Devuelve el número de elementos de datos seleccionados sin contar los valores
nulos. Distinct es una expresión alternativa compatible con versiones anteriores del
producto.
Sintaxis
count ( [ distinct ] expression [ auto ] )
count ( [ distinct ] expression for [ all|any ] expression { ,
expression } )
count ( [ distinct ] expression for report )
Ejemplo
count ( Sales )
Resultado
Devuelve el número total de entradas en Ventas.
maximum
Devuelve el valor máximo de los elementos de datos seleccionados. Distinct es una
expresión alternativa compatible con versiones anteriores del producto.
Sintaxis
412 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

maximum ( [ distinct ] expression [ auto ] )
maximum ( [ distinct ] expression for [ all|any ] expression { ,
expression } )
maximum ( [ distinct ] expression for report )
Ejemplo
maximum ( Sales )
Resultado
Devuelve el valor máximo de todos los valores de Ventas.
median
Devuelve el valor de la mediana de los elementos de datos seleccionados.
Sintaxis
median ( expression [ auto ] )
median ( expression for [ all|any ] expression { , expression } )
median ( expression for report )
minimum
Devuelve el valor mínimo de los elementos de datos seleccionados. Distinct es una
expresión alternativa compatible con versiones anteriores del producto.
Sintaxis
minimum ( [ distinct ] expression [ auto ] )
minimum ( [ distinct ] expression for [ all|any ] expression { ,
expression } )
minimum ( [ distinct ] expression for report )
Ejemplo
minimum ( Sales )
Resultado
Devuelve el valor mínimo de todos los valores de Ventas.
moving-average
Devuelve un promedio móvil por fila para un conjunto de valores especificado
sobre un número de filas especificado. "" define el ámbito de la
función. La opción "at" define el nivel de agregación y sólo puede utilizarse en el
contexto de los orígenes de datos relacionales.
Sintaxis
moving-average ( numeric_expression , numeric_expression [ at
expression { , expression }][ ] [ prefilter ] )
moving-average ( numeric_expression , numeric_expression
[ ] [ prefilter ] )
::= for expression { , expression }|for report|auto
Ejemplo
moving-average ( Qty ,3)
Resultado
Apéndice C. Uso del editor de expresiones 413

Por cada fila, devuelve la cantidad y un promedio móvil de la fila actual y de las
dos filas anteriores.
Datos de resultado
Qty Moving-Average (Qty, 3)
200 200
700 450
400 433.3333
200 433.3333
200 266.6667
500 300.0000
moving-total
Devuelve un total móvil por fila para un conjunto de valores especificado sobre un
número de filas especificado. "" define el ámbito de la función. La
opción "at" define el nivel de agregación y sólo puede utilizarse en el contexto de
los orígenes de datos relacionales.
Sintaxis
moving-total ( numeric_expression , numeric_expression [ at
expression { , expression }][ ] [ prefilter ] )
moving-total ( numeric_expression , numeric_expression
[ ] [ prefilter ] )
::= for expression { , expression }|for report|auto
Ejemplo
moving-total ( Qty ,3)
Resultado
Por cada fila, devuelve la cantidad y un total móvil de la fila actual y de las dos
filas anteriores.
Datos de resultado
Qty Moving-Total (Qty, 3)
200 200
700 900
400 1300
200 1300
200 800
500 900
percentage
Devuelve el porcentaje del valor total para los elementos de datos seleccionados.
"" define el ámbito de la función. La opción "at" define el nivel de
agregación y sólo puede utilizarse en el contexto de los orígenes de datos
relacionales. Esta función aparece en el informe de ejemplo interactivo Cálculo
porcentual (por año).
Sintaxis
414 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

percentage ( numeric_expression [ at expression { , expression } ]
[ ] [ prefilter ] )
percentage ( numeric_expression [ ] [ prefilter ] )
::= for expression { , expression }|for report|auto
Ejemplo
percentage ( Sales 98 )
Resultado
Devuelve el porcentaje de las ventas totales del año 1998 que corresponde a cada
representante de ventas.
Datos de resultado
Sales Rep Sales 98 Percentage
Gibbons 60646 7.11%
Flertjan 62523 7.35%
Cornel 22396 2.63%
percentile
Devuelve un valor, en una escala de cien, que indica el porcentaje de una
distribución que es igual o menor que los elementos de datos seleccionados.
"" define el ámbito de la función. La opción "at" define el nivel de
agregación y sólo puede utilizarse en el contexto de los orígenes de datos
relacionales.
Sintaxis
percentile ( numeric_expression [ at expression { , expression } ]
[ ] [ prefilter ] )
percentile ( numeric_expression [ ] [ prefilter ] )
::= for expression { , expression }|for report|auto
Ejemplo
percentile ( Sales 98 )
Resultado
Por cada fila, devuelve el porcentaje de filas que tienen un valor de cantidad igual
o inferior al de esa fila.
Datos de resultado
Qty Percentile (Qty)
800 1
700 0.875
600 0.75
500 0.625
400 0.5
400 0.5
200 0.25
200 0.25
Apéndice C. Uso del editor de expresiones 415

quantile
Devuelve la clasificación de un valor dentro de un rango especificado. Devuelve
números enteros para representar cualquier rango de clasificaciones, por ejemplo,
de 1 (máximo) a 100 (mínimo). "" define el ámbito de la función. La
opción "at" define el nivel de agregación y sólo puede utilizarse en el contexto de
los orígenes de datos relacionales.
Sintaxis
quantile ( numeric_expression , numeric_expression [ at expression { ,
expression }][ ] [ prefilter ] )
quantile ( numeric_expression , numeric_expression [ ]
[ prefilter ] )
::= for expression { , expression }|for report|auto
Ejemplo
quantile ( Qty ,4)
Resultado
Devuelve la cantidad, la clasificación del valor de cantidad y los valores de
cantidad fragmentados en 4 grupos de cuantiles (cuartiles).
Datos de resultado
Qty Rank (Qty) Quantile (Qty, 4)
800 1 1
700 2 1
600 3 2
500 4 2
400 5 3
400 5 3
200 7 4
200 7 4
quartile
Devuelve la clasificación de un valor, representado como enteros del 1 (máximo) al
4 (mínimo), en relación a un grupo de valores. "" define el ámbito de
la función. La opción "at" define el nivel de agregación y sólo puede utilizarse en
el contexto de los orígenes de datos relacionales.
Sintaxis
quartile ( numeric_expression [ at expression { , expression } ]
[ ] [ prefilter ] )
quartile ( numeric_expression [ ] [ prefilter ] )
::= for expression { , expression }|for report|auto
Ejemplo
quartile ( Qty )
Resultado
Devuelve la cantidad y el cuartil del valor de cantidad representado como números
enteros de 1 (máximo) a 4 (mínimo).
Datos de resultado
416 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

ank
Qty Quartile (Qty)
450 1
400 1
350 2
300 2
250 3
200 3
150 4
100 4
Devuelve el valor de clasificación de los elementos de datos seleccionados. El
orden de clasificación es opcional; de forma predeterminada se presupone del
orden descendente (DESC). Si se unen dos o más filas, existirá un espacio en la
secuencia de valores clasificados (conocida también como clasificación olímpica).
"" define el ámbito de la función. La opción "at" define el nivel de
agregación y sólo puede utilizarse en el contexto de los orígenes de datos
relacionales. Distinct es una expresión alternativa compatible con versiones
anteriores del producto. Los valores nulos se clasifican los últimos. Esta función
aparece en el informe de ejemplo 10 mejores minoristas para 2005 del paquete
Almacén de datos VA (análisis).
Sintaxis
rank ( expression [ ASC|DESC ]{,expression [ ASC|DESC ]}[at
expression { , expression }][ ] [ prefilter ] )
rank ( [ distinct ] expression [ ASC|DESC ]{,expression
[ ASC|DESC ]}[] [ prefilter ] )
::= for expression { , expression }|for report|auto
Ejemplo
rank ( Sales 98 )
Resultado
Por cada fila, devuelve el valor de clasificación de las ventas del año 1998 que
corresponde a cada representante de ventas. Se saltan algunos números cuando se
produce una unión entre filas.
Datos de resultado
Sales Rep Sales 98 Rank
Gibbons 60000 1
Flertjan 50000 2
Cornel 50000 2
Smith 48000 4
running-average
Devuelve la media parcial por fila (incluida la fila actual) para un conjunto de
valores. "" define el ámbito de la función. La opción "at" define el nivel
de agregación y sólo puede utilizarse en el contexto de los orígenes de datos
relacionales.
Sintaxis
Apéndice C. Uso del editor de expresiones 417

unning-average ( numeric_expression [ at expression { ,
expression }][ ] [ prefilter ] )
running-average ( numeric_expression [ ] [ prefilter ] )
::= for expression { , expression }|for report|auto
Ejemplo
running-average ( Qty )
Resultado
Por cada fila, devuelve la cantidad y el promedio parcial de la fila actual y las filas
anteriores.
Datos de resultado
Name Qty Avg
Running-Average for
name
Smith 7 5 7
Smith 3 5 5
Smith 6 5 5.33
Smith 4 5 5
Wong 3 4 3
Wong 5 4 4
running-count
Devuelve el recuento parcial por fila (incluida la fila actual) para un conjunto de
valores. "" define el ámbito de la función. La opción "at" define el nivel
de agregación y sólo puede utilizarse en el contexto de los orígenes de datos
relacionales.
Sintaxis
running-count ( numeric_expression [ at expression { , expression } ]
[ ] [ prefilter ] )
running-count ( numeric_expression [ ] [ prefilter ] )
::= for expression { , expression }|for report|auto
Ejemplo
running-count ( Qty )
Resultado
Por cada fila, devuelve la cantidad y el recuento parcial de la posición de la fila
actual.
Datos de resultado
Name Qty Count
Running-Count for
name
Smith 7 4 1
Smith 3 4 2
Smith 6 4 3
Smith 4 4 4
Wong 3 3 1
Wong 5 3 2
418 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

unning-difference
Devuelve una diferencia parcial por fila, calculada como la diferencia entre el valor
para la fila actual y la fila precedente, (incluida la fila actual) para un conjunto de
valores. "" define el ámbito de la función. La opción "at" define el nivel
de agregación y sólo puede utilizarse en el contexto de los orígenes de datos
relacionales.
Sintaxis
running-difference ( numeric_expression [ at expression { ,
expression }][ ] [ prefilter ] )
running-difference ( numeric_expression [ ]
[ prefilter ] )
::= for expression { , expression }|for report|auto
Ejemplo
running-difference ( Qty )
Resultado
Por cada fila, devuelve la cantidad y una diferencia parcial entre el valor de la fila
actual y la fila anterior.
Datos de resultado
Name Qty Running-Difference for name
Smith 7 NULL
Smith 3 -4
Smith 6 3
Smith 4 -2
Wong 3 -1
Wong 5 2
running-maximum
Devuelve el valor máximo parcial por fila (incluida la fila actual) para un conjunto
de valores. "" define el ámbito de la función. La opción "at" define el
nivel de agregación y sólo puede utilizarse en el contexto de los orígenes de datos
relacionales.
Sintaxis
running-maximum ( numeric_expression [ at expression { ,
expression }][ ] [ prefilter ] )
running-maximum ( numeric_expression [ ] [ prefilter ] )
::= for expression { , expression }|for report|auto
Ejemplo
running-maximum ( Qty )
Resultado
Por cada fila, devuelve la cantidad y un valor máximo parcial de la fila actual y de
las filas anteriores.
Datos de resultado
Apéndice C. Uso del editor de expresiones 419

Name Qty Max
Running-Maximum
(Qty) for name
Smith 2 7 2
Smith 3 7 3
Smith 6 7 6
Smith 7 7 7
Wong 3 5 3
Wong 5 5 5
running-minimum
Devuelve el valor mínimo parcial por fila (incluida la fila actual) para un conjunto
de valores. "" define el ámbito de la función. La opción "at" define el
nivel de agregación y sólo puede utilizarse en el contexto de los orígenes de datos
relacionales.
Sintaxis
running-minimum ( numeric_expression [ at expression { ,
expression }][ ] [ prefilter ] )
running-minimum ( numeric_expression [ ] [ prefilter ] )
::= for expression { , expression }|for report|auto
Ejemplo
running-minimum ( Qty )
Resultado
Por cada fila, devuelve la cantidad y un valor mínimo parcial de la fila actual y de
las filas anteriores.
Datos de resultado
Name Qty Min
Running-Minimum
(Qty) for name
Smith 7 2 7
Smith 3 2 3
Smith 6 2 3
Smith 2 2 2
Wong 4 3 4
Wong 5 3 4
running-total
Devuelve un valor total acumulado (incluida la fila actual) para un conjunto de
valores. "" define el ámbito de la función. La opción "at" define el nivel
de agregación y sólo puede utilizarse en el contexto de los orígenes de datos
relacionales.
Sintaxis
running-total ( numeric_expression [ at expression { ,
expression } ] [ ] [ prefilter ] )
running-total ( numeric_expression [ ] [ prefilter ] )
::= for expression { , expression }|for report|auto
Ejemplo
running-total ( Qty )
420 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

total
Resultado
Por cada fila, devuelve la cantidad y un total acumulado de la fila actual y de las
filas anteriores.
Datos de resultado
Name Qty Total
Running-Total (Qty)
for name
Smith 2 18 2
Smith 3 18 5
Smith 6 18 11
Smith 7 18 18
Wong 3 12 3
Wong 5 12 8
Devuelve el valor total de los elementos de datos seleccionados. Distinct es una
expresión alternativa compatible con versiones anteriores del producto. Esta
función aparece en el informe de ejemplo Presupuesto frente a real del paquete
Almacén de datos VA (análisis).
Sintaxis
total ( [ distinct ] expression [ auto ] )
total ( [ distinct ] expression for [ all|any ] expression { ,
expression } )
total ( [ distinct ] expression for report )
Ejemplo
total ( Sales )
Resultado
Resúmenes de miembros
Devuelve el valor total de todos los valores de Ventas.
Esta lista contiene funciones predefinidas que devuelven un valor de resumen
único para un conjunto de miembros o un valor de resumen diferente para cada
miembro de un conjunto de miembros.
aggregate
Devuelve un valor calculado mediante la utilización de la función de agregación
adecuada en función del tipo de agregación de la expresión.
Sintaxis
aggregate ( < currentMeasure|numeric_expression > within set
set_expression )
aggregate ( < currentMeasure|numeric_expression > within <
detail|aggregate > expression )
Apéndice C. Uso del editor de expresiones 421

average
Devuelve el valor promedio de los elementos de datos seleccionados.
count
Sintaxis
average ( < currentMeasure|numeric_expression > within set
set_expression )
average ( < currentMeasure|numeric_expression > within <
detail|aggregate > expression )
Ejemplo
average ( Sales )
Resultado
Devuelve el promedio de todos los valores de Ventas.
Devuelve el número de elementos de datos seleccionados sin contar los valores
nulos.
Sintaxis
count ( < currentMeasure|numeric_expression > within set
set_expression )
count ( < currentMeasure|numeric_expression > within <
detail|aggregate > expression )
Ejemplo
count ( Sales )
Resultado
Devuelve el número total de entradas en Ventas.
maximum
Devuelve el valor máximo de los elementos de datos seleccionados.
Sintaxis
maximum ( < currentMeasure|numeric_expression > within set
set_expression )
maximum ( < currentMeasure|numeric_expression > within <
detail|aggregate > expression )
Ejemplo
maximum ( Sales )
Resultado
Devuelve el valor máximo de todos los valores de Ventas.
median
Devuelve el valor de la mediana de los elementos de datos seleccionados.
Sintaxis
422 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

median ( < currentMeasure|numeric_expression > within set
set_expression )
median ( < currentMeasure|numeric_expression > within <
detail|aggregate > expression )
minimum
Devuelve el valor mínimo de los elementos de datos seleccionados.
Sintaxis
minimum ( < currentMeasure|numeric_expression > within set
set_expression )
minimum ( < currentMeasure|numeric_expression > within <
detail|aggregate > expression )
Ejemplo
minimum ( Sales )
Resultado
Devuelve el valor mínimo de todos los valores de Ventas.
percentage
Devuelve el porcentaje del valor total de los elementos de datos seleccionados.
Sintaxis
percentage ( numeric_expression [ tuple member_expression { ,
member_expression } ] within set set_expression )
Ejemplo
percentage ( [gosales].[sales measures].[quantity] tuple [gosales].
[Staff].[].[department] -> [West] within set children ( [gosales].
[Staff].[].[Staff] ) )
percentile
Devuelve un valor, en una escala de 0 a 100, que indica el porcentaje de una
distribución igual o menor que los elementos de datos seleccionados.
Sintaxis
percentile ( numeric_expression [ tuple member_expression { ,
member_expression } ] within set set_expression )
quantile
Devuelve la clasificación de un valor para el rango especificado. Devuelve
números enteros para representar cualquier rango de clasificaciones, por ejemplo,
de 1 (máximo) a 100 (mínimo).
Sintaxis
quantile ( numeric_expression , numeric_expression [ tuple
member_expression { , member_expression } ] within set
set_expression )
quartile
Devuelve la clasificación de un valor, representado como enteros del 1 (máximo) al
4 (mínimo), en relación a un grupo de valores.
Apéndice C. Uso del editor de expresiones 423

ank
Sintaxis
quartile ( numeric_expression [ tuple member_expression { ,
member_expression } ] within set set_expression )
Devuelve el valor de clasificación de los elementos de datos seleccionados. El tipo
de clasificación devuelto (olímpico, denso o serie) depende del origen de datos. El
orden de clasificación es opcional; de forma predeterminada se presupone DESC.
Sintaxis
rank ( numeric_expression [ ASC|DESC ] [ tuple member_expression { ,
member_expression } ] within set set_expression )
Ejemplo
rank ( [gosales].[sales measures].[quantity] tuple [gosales].[Staff].
[].[department] -> [West] within set children ( [gosales].[Staff].[].
[Staff] ) )
standard-deviation
Devuelve la desviación estándar de los elementos de datos seleccionados.
Sintaxis
standard-deviation ( < currentMeasure|numeric_expression > within set
set_expression )
standard-deviation ( < currentMeasure|numeric_expression > within <
detail|aggregate > expression )
standard-deviation-pop
Devuelve la población de desviación estándar de los elementos de datos
seleccionados.
total
Sintaxis
standard-deviation-pop ( < currentMeasure|numeric_expression > within
set set_expression )
standard-deviation-pop ( < currentMeasure|numeric_expression > within
< detail|aggregate > expression )
Devuelve el valor total de los elementos de datos seleccionados.
Sintaxis
total ( < currentMeasure|numeric_expression > within set
set_expression )
total ( < currentMeasure|numeric_expression > within <
detail|aggregate > expression )
variance
Devuelve la varianza de los elementos de datos seleccionados.
Sintaxis
variance ( < currentMeasure|numeric_expression > within set
set_expression )
variance ( < currentMeasure|numeric_expression > within <
detail|aggregate > expression )
424 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Constantes
variance-pop
Devuelve la población de varianza de los elementos de datos seleccionados.
date
Sintaxis
variance-pop ( < currentMeasure|numeric_expression > within set
set_expression )
variance-pop ( < currentMeasure|numeric_expression > within <
detail|aggregate > expression )
Una constante es un valor fijo que se puede utilizar en una expresión.
Inserta la fecha actual del sistema.
date-time
Inserta la fecha y hora actuales del sistema.
time with time zone
Inserta una hora cero con huso horario.
timestamp with time zone
Inserta un ejemplo de indicación de fecha y hora con huso horario.
interval
Inserta un intervalo cero: 000 00:00:00.000.
interval year
Inserta un intervalo de año cero: año 0.
interval month
Inserta un intervalo de mes cero: mes 0.
interval year to month
Inserta un intervalo de año a mes cero: año a mes 0000-00.
interval day
Inserta un intervalo de día cero: día 0.
interval hour
Inserta un intervalo de hora cero: hora 0.
interval minute
Inserta un intervalo de minuto cero: minuto 0.
interval second
Inserta un intervalo de segundo cero: segundo 0.
Apéndice C. Uso del editor de expresiones 425

interval day to hour
Inserta un intervalo de día a hora cero: día a hora 0 00.
interval day to minute
Inserta un intervalo de día a minuto cero: día a minuto 0 00:00.
interval day to second
Inserta un intervalo de día a segundo cero: día a segundo 0 00:00:00.000000000
interval hour to minute
Inserta un intervalo de hora a minuto cero: hora a minuto 00:00.
interval hour to second
Inserta un intervalo de hora a segundo cero: hora a segundo 00:00:00.000000000.
interval minute to second
Inserta un intervalo de minuto a segundo cero: minuto a segundo 00:00.000000000.
null
Inserta "null" si no se cumplen las condiciones de la expresión.
number
Inserta el número 0, que se puede sustituir por un valor numérico nuevo.
string
time
Construcciones
Inserta una cadena vacía como dos comillas simples entre las que se puede escribir
una cadena.
Inserta la hora actual del sistema.
Esta lista contiene las construcciones y las plantillas que se pueden utilizar para
crear una expresión. Las plantillas combinan varias funciones formando un grupo.
Por ejemplo, la plantilla search case incluye las funciones case, when, else y end.
if then else
Esta construcción es la plantilla para una sentencia if...then...else. Esta construcción
aparece en el informe de ejemplo 10 mejores minoristas para 2005 del paquete
Almacén de datos VA (análisis).
Sintaxis
IF ([Country] = ’Canada’) THEN ([List Price] * 0.60) ELSE ([List
Price])
in_range
Es la plantilla para una expresión in_range.
Sintaxis
426 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

[code] IN_RANGE { :30 , 40, 50, 999: }
Ejemplo 1
[code] IN_RANGE {5}
Resultado
Esto es equivalente a [código] = 5.
Ejemplo 2
[code] IN_RANGE { 5: }
Resultado
Es equivalente a [code] >= 5.
Ejemplo 3
[code] IN_RANGE { :5 }
Resultado
Es equivalente a [code] = 5 y [code] 100 THEN [List Price] * 0.80
ELSE [List Price] END
simple case
Esta construcción es la plantilla para un caso simple, que incluye las funciones
CASE, WHEN, ELSE y END.
Sintaxis
CASE [Country] WHEN ’Canada’ THEN ([List Price] * 0.60) WHEN
’Australia’ THEN [List Price] * 0.80
ELSE [List Price] END
Apéndice C. Uso del editor de expresiones 427

Funciones de fecha/hora
Esta lista contiene funciones empresariales para realizar cálculos de fecha y hora.
_add_days
Devuelve la fecha o la fecha y hora, en función del formato de "date_expression",
que resulta de añadir "integer_expression" días a "date_expression".
Sintaxis
_add_days ( date_expression, integer_expression )
Ejemplo 1
_add_days ( 2002-04-30 ,1)
Resultado
2002-05-01
Ejemplo 2
_add_days ( 2002-04-30 12:10:10.000, 1 )
Resultado
2002-05-01 12:10:10.000
Ejemplo 3
_add_days ( 2002-04-30 00:00:00.000, 1/24 )
Note that the second
argument is not a whole number. This is supported by some database
technologies and increments the time portion.
Resultado
2002-04-30 01:00:00.000
_add_months
Devuelve la fecha o la fecha y la hora, en función del formato de
"date_expression", que resulta de añadir "integer_expression" días a
"date_expression".
Sintaxis
_add_months ( date_expression, integer_expression )
Ejemplo 1
_add_months ( 2002-04-30 ,1)
Resultado
2002-05-30
Ejemplo 2
_add_months ( 2002-04-30 12:10:10.000, 1 )
Resultado
428 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

2002-05-30 12:10:10.000
_add_years
Devuelve la fecha o la fecha y la hora, en función del formato de
"date_expression", que resulta de añadir "integer_expression" años a
"date_expression".
_age
Sintaxis
_add_years ( date_expression, integer_expression )
Ejemplo 1
_add_years ( 2002-04-30 ,1)
Resultado
2003-04-30
Ejemplo 2
_add_years ( 2002-04-30 12:10:10.000 ,1)
Resultado
2003-04-30 12:10:10.000
Devuelve el número obtenido de restar "date_expression" de la fecha actual. El
valor devuelto tiene el formato AAAAMMDD, donde AAAA representa el número
de años, MM el número de meses y DD el número de días.
Sintaxis
_age ( date_expression )
Ejemplo
_age ( 1990-04-30 ) (if today’s date is 2003-02-05)
Resultado
120906, que es igual a 12 años, 9 meses y 6 días.
_day_of_week
Devuelve el día de la semana (de 1 a 7), donde 1 es el primer día de la semana, tal
como indica el segundo parámetro (de 1a7,siendo 1 el lunes y7eldomingo).
Tenga en cuenta que en el estándar ISO 8601, la semana comienza en lunes, siendo
éste el día 1.
Sintaxis
_day_of_week ( date_expression, integer )
Ejemplo
_day_of_week ( 2003-01-01 ,1)
Resultado
Apéndice C. Uso del editor de expresiones 429

3
_day_of_year
Devuelve el día del año (de 1 a 366) en "date_expression". También denominado
día Juliano.
Sintaxis
_day_of_year ( date_expression )
Ejemplo
_day_of_year ( 2003-03-01 )
Resultado
61
_days_between
Devuelve un número positivo o negativo que representa el número de días entre
"date_expression1" y "date_expression2". Si "date_expression1" <
"date_expression2", el resultado será un número negativo.
Sintaxis
_days_between ( date_expression1 , date_expression2 )
Ejemplo
_days_between ( 2002-04-30 , 2002-06-21 )
Resultado
-52
_days_to_end_of_month
Devuelve un número que representa el número de días que quedan del mes,
representado por "date_expression".
Sintaxis
_days_to_end_of_month ( date_expression )
Ejemplo
_days_to_end_of_month ( 2002-04-20 14:30:22.123 )
Resultado
10
_first_of_month
Devuelve una fecha o una fecha y hora, en función del argumento, mediante la
conversión de "date_expression" en una fecha con el mismo año y mes pero con el
día establecido en 1.
Sintaxis
_first_of_month ( date_expression )
430 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Ejemplo 1
_first_of_month ( 2002-04-20 )
Resultado
2002-04-01
Ejemplo 2
_first_of_month ( 2002-04-20 12:10:10.000 )
Resultado
2002-04-01 12:10:10.000
_last_of_month
Devuelve una fecha o una fecha y hora, en función del argumento, que es el
último día del mes representado por "date_expression".
Sintaxis
_last_of_month ( date_expression )
Ejemplo 1
_last_of_month ( 2002-01-14 )
Resultado
2002-01-31
Ejemplo 2
_last_of_month ( 2002-01-14 12:10:10.000 )
Resultado
2002-01-31 12:10:10.000
_make_timestamp
Devuelve una indicación de fecha y hora construida por "integer_expression1"
(año), "integer_expression2" (mes) y "integer_expression3" (día). La parte
correspondiente a la hora se establece de forma predeterminada en 00:00:00.000.
Sintaxis
_make_timestamp ( integer_expression1, integer_expression2,
integer_expression3 )
Ejemplo
_make_timestamp ( 2002 , 01 , 14 )
Resultado
2002-01-14 00:00:00.000
Apéndice C. Uso del editor de expresiones 431

_months_between
Devuelve un número entero positivo o negativo que representa el número de
meses entre "date_expression1" y "date_expression2". Si "date_expression1" es
anterior a "date_expression2", el resultado será un número negativo.
Sintaxis
_months_between ( date_expression1, date_expression2 )
Ejemplo
_months_between ( 2002-04-03 , 2002-01-30 )
Resultado
2
_week_of_year
Devuelve el número de la semana del año de "date_expression" según el estándar
ISO 8601. La semana 1 del año es la primera semana del año que contiene un
jueves, que es equivalente a la primera semana que contiene el 4 de enero. La
semana empieza el lunes (día 1) y termina el domingo (día 7).
Sintaxis
_week_of_year ( date_expression )
Ejemplo
_week_of_year ( 2003-01-01 )
Resultado
1
_years_between
Devuelve un número entero positivo o negativo que representa el número de años
entre "date_expression1" y "date_expression2". Si "date_expression1" <
"date_expression2", se devuelve un valor negativo.
Sintaxis
_years_between ( date_expression1, date_expression2 )
Ejemplo
_years_between ( 2003-01-30 , 2001-04-03 )
Resultado
1
_ymdint_between
Devuelve un número que representa la diferencia entre "date_expression1" y
"date_expression2". El valor devuelto tiene el formato AAAAMMDD, donde
AAAA representa el número de años, MM el número de meses y DD el número de
días.
Sintaxis
432 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

_ymdint_between ( date_expression1 , date_expression2 )
Ejemplo
_ymdint_between ( 1990-04-30 , 2003-02-05 )
Resultado
Funciones de bloque
120906, que es igual a 12 años, 9 meses y 6 días.
Esta lista contiene funciones utilizadas para acceder a miembros de un conjunto,
normalmente en el contexto de Analysis Studio.
_firstFromSet
Devuelve los primeros miembros encontrados en el conjunto hasta
"numeric_expression_maximum" + "numeric_expression_overflow". Si se excede
"numeric_expression_maximum" + "numeric_expression_overflow", solo se
devuelve el número máximo de miembros. En el caso de que un conjunto solo
tenga unos cuantos miembros más que el valor especificado en
numeric_expression_maximum, numeric_expression_overflow permite incluir el
pequeño conjunto de miembros adicionales. Si el conjunto tiene más miembros de
lo que el desbordamiento permite, solo se devolverán los miembros indicados en
numeric_expression_maximum.
Sintaxis
_firstFromSet ( set_expression , numeric_expression_maximum ,
numeric_expression_overflow )
Ejemplo 1
_firstFromSet ( [great_outdoors_company].[Products].[Products].
[Product line] ,2,8)
Resultado
Devuelve los cinco miembros del conjunto Línea de producto. Los dos primeros
miembros se devuelven dentro del máximo y los tres miembros siguientes se
devuelven como desbordamiento.
Datos de resultado
Camping Equipment
Golf Equipment
Mountaineering Equipment
Outdoor Protection
Personal Accessories
Ejemplo 2
_firstFromSet ( [great_outdoors_company].[Products].[Products].
[Product line] ,2,2)
Resultado
Equipo de acampada, Equipo de golf
Apéndice C. Uso del editor de expresiones 433

Datos Aster
_remainderSet
Devuelve el conjunto que contiene "member_expression" cuando el tamaño de
"set_expression" es mayor que "numeric_expression"; por ejemplo, se generará un
nuevo miembro si el número de miembros de "set_expression" es mayor que el
valor especificado en "numeric_expression".
Sintaxis
_remainderSet ( member_expression, set_expression ,
numeric_expression )
Ejemplo
_remainderSet ( member ( aggregate ( currentMeasure within set
[great_outdoors_company].[Products].[Products].[Product line] ) ,
’Product Aggregate’ , ’Product Aggregate’ , [great_outdoors_company].
[Products].[Products] ) , [great_outdoors_company].[Products].
[Products].[Product line] ,1)
Resultado
Cantidad vendida de Agregado de productos
Cadena de datos Aster
overlay
Devuelve "string_exp1" que sustituye a "string_exp2" desde la posición del carácter
numeric_exp.
Sintaxis
overlay ( string_exp1, string_exp2, numeric_exp1 [, numeric_exp2] )
btrim
Devuelve string_exp1 después de eliminar la cadena más larga de caracteres de
string_exp2.
Sintaxis
btrim( string_exp1 [, string_exp2] )
initcap
Devuelve "string_exp", con la primera letra de cada palabra en mayúsculas y todas
las demás letras en minúsculas. Las palabras están delimitadas por un espacio en
blanco o caracteres que no son alfanuméricos.
Sintaxis
initcap ( string_exp )
lpad
Devuelve "string_exp1" que se ha rellenado hasta la longitud "integer_exp" con
apariciones de "string_exp2". Si "string_exp1" tiene una longitud superior a
"integer_exp", se devuelve la parte apropiada de "string_exp1".
Sintaxis
lpad ( string_exp1, integer_exp [ , string_exp2 ] )
434 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

ltrim
Devuelve "string_exp1", donde se han eliminado los caracteres iniciales hasta el
primer carácter que no se encuentra en "string_exp2", por ejemplo,
ltrim('xyxXxyAB', 'xy') devuelve 'XxyAB'.
Sintaxis
ltrim ( string_exp1 [ , string_exp2 ] )
md5
Devuelve el hash MD5 de "string_exp1".
Sintaxis
md5 ( string_exp1 )
to_hex
Devuelve la representación en forma de cadena hexadecimal de "numeric_exp1".
Sintaxis
to_hex ( numeric_exp1 )
repeat
Devuelve "string_exp" repetida "numeric_exp1" veces.
Sintaxis
repeat ( string_exp, numeric_exp1 )
replace
Devuelve "string_exp" donde se ha sustituido "string_exp2" por "string_exp3".
Sintaxis
replace( string_exp, string_exp2, string_exp3)
rpad
Devuelve "string_exp1" que se ha rellenado por la derecha hasta la longitud
"integer_exp" con apariciones de "string_exp2". Si "string_exp1" tiene una longitud
superior a "integer_exp", se devuelve la parte apropiada de "string_exp1". Si
"string_exp2" no se especifica, se utilizan espacios.
Sintaxis
rpad ( string_exp1, integer_exp [ , string_exp2 ] )
rtrim
Devuelve "string_exp1", donde se han eliminado los caracteres finales después del
último carácter que no se encuentra en "string_exp2", por ejemplo, rtrim('ABxXxyx',
'xy') devuelve 'ABxX'. Si "string_exp2" no se especifica, se eliminan los caracteres
de espacio finales.
Sintaxis
rtrim ( string_exp1 [ , string_exp2 ] )
split_part
Devuelve el campo "numeric_exp" después de haber dividido "string_exp1" en
"string_exp2".
Sintaxis
Apéndice C. Uso del editor de expresiones 435

split_part ( string_exp1 , string_exp2 , numeric_exp )
Formateo de tipo de datos de los datos Aster
to_char
Devuelve la representación en forma de cadena de "exp" con el formato de
"string_exp". "Exp" puede ser un valor de fecha o un valor numérico.
Sintaxis
to_char ( exp , string_exp )
to_date
Convierte "string_exp1" en un valor de fecha, según especifica el formato
"string_exp2".
Sintaxis
to_date ( string_exp1 , string_exp2 )
to_number
Convierte "string_exp1" en un valor numérico, según especifica el formato
"string_exp2".
Sintaxis
to_number ( string_exp1, string_exp2 )
to_timestamp
Convierte "string_exp1" en un valor de indicación de fecha y hora, según especifica
el formato "string_exp2".
Sintaxis
to_timestamp ( string_exp1, string_exp2 )
Funciones matemáticas de datos Aster
log
Devuelve el logaritmo en base 10 de "numeric_exp1" o el logaritmo en base
"numeric_exp2".
Sintaxis
log ( numeric_exp1[, numeric_exp2] )
ln
Devuelve el logaritmo natural de "numeric_exp1".
Sintaxis
ln ( numeric_exp )
cbrt
Devuelve la raíz del cubo de "numeric_exp1".
Sintaxis
cbrt ( numeric_exp )
436 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

pi
Devuelve la constante pi.
Sintaxis
pi( )
Trigonometría de datos Aster
acos
Devuelve el arcocoseno de "numeric_exp" en radianes. El arcocoseno es el ángulo
cuyo coseno es "numeric_exp".
Sintaxis
acos ( numeric_exp )
asin
Devuelve el arcoseno de "numeric_exp" en radianes. El arcoseno es el ángulo cuyo
seno es "numeric_exp".
Sintaxis
asin ( numeric_exp )
atan
Devuelve la arcotangente de "numeric_exp" en radianes. La arcotangente es el
ángulo cuya tangente es "numeric_exp".
Sintaxis
atan ( numeric_exp )
atan2
Devuelve la arcotangente de las coordenadas xeyespecificadas por
"numeric_exp1" y "numeric_exp2", respectivamente, en radianes. La arcotangente es
el ángulo cuya tangente es "numeric_exp2" / "numeric_exp1".
Sintaxis
atan2 ( numeric_exp1, numeric_exp2 )
cos
Devuelve el coseno de "numeric_exp", donde "numeric_exp" es un ángulo
expresado en radianes.
Sintaxis
cos ( numeric_exp )
cot
Devuelve la cotangente de "numeric_exp", donde "numeric_exp" es un ángulo
expresado en radianes.
Sintaxis
cot ( numeric_exp )
degrees
Devuelve los grados donde "numeric_exp" es un ángulo expresado en radianes.
Sintaxis
Apéndice C. Uso del editor de expresiones 437

ascii
chr
degrees ( numeric_exp )
radians
Devuelve los radianes donde "numeric_exp" es un ángulo expresado en grados.
Sintaxis
radians ( numeric_exp )
sin
Devuelve el seno de "numeric_exp", donde "numeric_exp" es un ángulo expresado
en radianes.
Sintaxis
sin ( numeric_exp )
tan
Devuelve la tangente de "numeric_exp", donde "numeric_exp" es un ángulo
expresado en radianes.
Sintaxis
tan ( numeric_exp )
Devuelve un número que representa el valor del código ASCII del carácter situado
más a la izquierda de "string_exp", por ejemplo, ascii('A') es 65.
Sintaxis
ascii ( string_exp )
Devuelve el carácter que tiene el valor del código ASCII especificado por
"integer_exp". "Integer_exp" debe estar entre 0 y 255.
Sintaxis
chr ( integer_exp )
current_schema
Devuelve el nombre del esquema actual.
Sintaxis
current_schema ()
translate
Devuelve "string_exp1", donde todas las apariciones de cada carácter de
"string_exp2" se han sustituido por su carácter correspondiente de "string_exp3".
Sintaxis
translate ( string_exp1, string_exp2, string_exp3 )
date_trunc
Devuelve la indicación de fecha y hora a la precisión especificada.
Sintaxis
438 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

DB2
date_trunc ( string_exp, timestamp_exp)
version
Devuelve el valor de cadena de la versión de la base de datos.
Sintaxis
version ( )
Funciones matemáticas de DB2
log
Devuelve el logaritmo natural de "numeric_expression".
Sintaxis
log ( numeric_expression )
log10
Devuelve el logaritmo de base diez de "numeric_expression".
Sintaxis
log10 ( numeric_expression )
rand
Genera un número aleatorio utilizando "integer_expression" como valor de origen.
Sintaxis
rand ( integer_expression )
Funciones trigonométricas de DB2
acos
Devuelve el arcocoseno de "numeric_expression" en radianes. El arcocoseno es el
ángulo cuyo coseno es "numeric_expression".
Sintaxis
acos ( numeric_expression )
asin
Devuelve el arcoseno de "numeric_expression" en radianes. El arcoseno es el
ángulo cuyo seno es "numeric_expression".
Sintaxis
asin ( numeric_expression )
atan
Devuelve la arcotangente de "numeric_expression" en radianes. La arcotangente es
el ángulo cuya tangente es "numeric_expression".
Sintaxis
atan ( numeric_expression )
Apéndice C. Uso del editor de expresiones 439

atanh
Devuelve la arcotangente hiperbólica de "numeric_expression", donde
"numeric_expression" es un ángulo expresado en radianes.
Sintaxis
atanh ( numeric_expression )
atan2
Devuelve la arcotangente de las coordenadas xeyespecificadas por
"numeric_expression1" y "numeric_expression2", respectivamente, en radianes. La
arcotangente es el ángulo cuya tangente es "numeric_expression2" /
"numeric_expression1".
Sintaxis
atan2 ( numeric_expression1 , numeric_expression2 )
cos
Devuelve el coseno de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
Sintaxis
cos ( numeric_expression )
cosh
Devuelve el coseno hiperbólico de "numeric_expression", donde
"numeric_expression" es un ángulo expresado en radianes.
Sintaxis
cosh ( numeric_expression )
cot
Devuelve la cotangente de "numeric_expression", donde "numeric_expression" es
un ángulo expresado en radianes.
Sintaxis
cot ( numeric_expression )
degrees
Devuelve "numeric_expression" radianes convertidos a grados.
Sintaxis
degrees ( numeric_expression )
sin
Devuelve el seno de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
Sintaxis
sin ( numeric_expression )
sinh
Devuelve el seno hiperbólico de "numeric_expression", donde
"numeric_expression" es un ángulo expresado en radianes.
Sintaxis
440 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

ascii
sinh ( numeric_expression )
tan
Devuelve la tangente de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
Sintaxis
tan ( numeric_expression )
tanh
Devuelve la tangente hiperbólica de "numeric_expression", donde
"numeric_expression" es un ángulo expresado en radianes.
Sintaxis
tanh ( numeric_expression )
Devuelve el valor del código ASCII del carácter que se encuentra más a la
izquierda del argumento como un entero.
Sintaxis
ascii ( string_expression )
Ejemplo
ascii (a)
Resultado
Devuelve 65, el valor del código ASCII de "a".
ceiling
Devuelve el entero más pequeño igual o mayor que "numeric_expression".
char
chr
Sintaxis
ceiling ( numeric_expression )
Ejemplo
ceiling ( 0.75 )
Resultado
Devuelve 0,8.
Devuelve una representación en forma de cadena de un valor de fecha/hora o un
número decimal.
Sintaxis
char ( expression )
Devuelve el carácter que tiene el valor del código ASCII especificado por
"integer_expression". "Integer_expression" debe estar entre 0 y 255.
Apéndice C. Uso del editor de expresiones 441

Sintaxis
chr ( integer_expression )
Ejemplo
chr(65)
Resultado
Devuelve un carácter, el carácter del valor del código ASCII correspondiente a 65.
concat
Devuelve una cadena que es el resultado de la concatenación de
"string_expression1" con "string_expression2".
date
day
Sintaxis
concat ( string_expression1, string_expression2 )
Ejemplo
concat ( [Sales target (query)].[Sales staff].[First name], [Sales
target (query)].[Sales staff].[Last name] )
Resultado
Devuelve el nombre y el apellido; por ejemplo, Roberto Rodríguez.
Devuelve una fecha de un único valor de entrada. "Expression" puede ser una
representación en forma de cadena o de entero de una fecha.
Sintaxis
date ( expression )
Ejemplo
date ( ’1998-01-08’ )
Resultado
Devuelve 8 enero 1998.
Devuelve el día del mes (de 1 a 31) de "date_expression". "Date_expression" puede
ser un valor de fecha o una representación en forma de cadena de una fecha.
Sintaxis
day ( date_expression )
Ejemplo
day ( ’1998-01-08’ )
Resultado
Devuelve 8.
442 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

dayname
Devuelve una cadena de caracteres que contiene el nombre específico del origen de
datos del día (por ejemplo, de Sunday a Saturday o de Sun. a Sat. para un origen
de datos en inglés, o de Sonntag a Samstag para un origen de datos en alemán)
para la parte del día de "date_expression". "Date_expression" puede ser un valor de
fecha o una representación en forma de cadena de una fecha.
Sintaxis
dayname ( date_expression )
Ejemplo
dayname ( ’1998-01-08’ )
Resultado
Devuelve Jueves.
dayofweek
Devuelve el día de la semana de "date_expression" como un entero en el rango de
1 a 7, donde 1 representa el domingo. "date_expression" puede ser un valor de
fecha o una representación en forma de cadena de una fecha.
Sintaxis
dayofweek ( date_expression )
Ejemplo
dayofweek ( ’1998-01-08’ )
Resultado
Devuelve 5.
dayofweek_iso
Devuelve el día de la semana de "date_expression" como un entero en el rango de
1 a 7, donde 1 representa el lunes. "date_expression" puede ser un valor de fecha o
una representación en forma de cadena de una fecha.
Sintaxis
dayofweek_iso ( date_expression )
Ejemplo
dayofweek_iso ( ’1998-01-08’ )
Resultado
Devuelve 4.
dayofyear
Devuelve el día del año de "date_expression" como un entero en el rango de 1 a
366. "Date_expression" puede ser un valor de fecha o una representación en forma
de cadena de una fecha.
Sintaxis
Apéndice C. Uso del editor de expresiones 443

days
dec
dayofyear ( date_expression )
Ejemplo
dayofyear ( current_date )
Resultado
Devuelve el día del año de la fecha actual; por ejemplo, si fuera el 28 de enero, la
expresión devolvería 28.
Devuelve una representación en forma de entero de una fecha. "Expression" puede
ser un valor de fecha o la representación en forma de cadena de una fecha.
Sintaxis
days ( expression )
Devuelve la representación decimal de "expresión-cadena" utilizando
"entero-precisión" y "entero-escala". El "carácter-decimal" se puede utilizar para
especificar la conste de carácter de un solo byte utilizada para delimitar los dígitos
decimales en "expresión-cadena". La "expresión-cadena" se debe formatear como
una constante decimal o un entero SQL. Sintaxis alternativa: dec
( expresión-numérica [ , entero-precisión [ , entero-escala ]])Devuelve la
representación decimal de "expresión-numérica" utilizando "entero-precisión" y
"entero-escala".
Sintaxis
dec ( string-expression [ , precision-integer [ , scale-integer [ ,
decimal-character ]]])
decimal
Devuelve la representación decimal de "expresión-cadena" utilizando
"entero-precisión" y "entero-escala". El "carácter-decimal" se puede utilizar para
especificar la conste de carácter de un solo byte utilizada para delimitar los dígitos
decimales en "expresión-cadena". La "expresión-cadena" se debe formatear como
una constante decimal o un entero SQL. Sintaxis alternativa: decimal
( expresión-numérica [ , entero-precisión [ , entero-escala ]])Devuelve la
representación decimal de "expresión-numérica" utilizando "entero-precisión" y
"entero-escala".
Sintaxis
decimal ( string-expression [ , precision-integer [ , scale-integer
[ , decimal-character ]]])
difference
Devuelve un valor entero que representa la diferencia entre los valores devueltos
por la función soundex específica del origen de datos para "string_expression1" y
"string_expression2". El valor devuelto se encuentra en el rango de 0a4,donde 4
indica la mejor coincidencia. No obstante, el valor 4 no significa que las cadenas
sean idénticas.
Sintaxis
difference ( string_expression1 , string_expression2 )
444 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

digits
Ejemplo 1
difference ([Sales target (query)].[Sales staff].[First name],[Sales (
query)].[Retailers].[Contact first name])
Resultado
0
Ejemplo 2
difference ([Sales target (query)].[Sales staff].[First name],[Sales
target (query)].[Sales staff].[First name])
Resultado
4
Devuelve la representación en forma de cadena de caracteres de un número de
decimal no flotante.
Sintaxis
digits ( numeric_expression )
double
Devuelve la representación de decimal flotante de una expresión. "Expression"
puede ser una expresión numérica o de cadena.
Sintaxis
double ( expression )
event_mon_state
Devuelve el estado operativo de un supervisor de estado en particular.
float
hex
hour
Sintaxis
event_mon_state ( string_expression )
Devuelve la representación de decimal flotante de un número.
Sintaxis
float ( numeric_expression )
Devuelve la representación hexadecimal de un valor.
Sintaxis
hex ( expression )
Devuelve la hora, un entero comprendido entre 0 (medianoche) y 23 (11:00 pm), de
"time_expression". "Time_expression" puede ser un valor de hora o una
representación en forma de cadena de una hora.
Apéndice C. Uso del editor de expresiones 445

insert
Sintaxis
hour ( time_expression )
Ejemplo
hour ( 01:22:45 )
Resultado
Devuelve 1.
Devuelve una cadena donde "integer_expression2" caracteres se han suprimido de
"string_expression1" a partir de "integer_expression1" y donde "string_expression2"
se ha insertado al principio de "string_expression1". El primer carácter de la cadena
se encuentra en la posición 1.
Sintaxis
insert ( string_expression1, integer_expression1,
integer_expression2, string_expression2 )
integer
Devuelve la representación en forma de entero de una expresión. "Expression"
puede ser un valor numérico o una representación en forma de cadena de un
número.
int
Sintaxis
integer ( expression )
Ejemplo
integer ( 84.95 )
Resultado
85
Devuelve la representación en forma de entero de una expresión. "Expression"
puede ser un valor numérico o una representación en forma de cadena de un
número.
Sintaxis
int ( expression )
Ejemplo
int ( 84.95 )
Resultado
85
446 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

julian_day
Devuelve un valor entero que representa el número de días desde el 1 de enero de
4712 AC (fecha de inicio del calendario juliano) hasta el valor de fecha especificado
en "expression". "Expression" puede ser un valor de fecha o la representación en
forma de cadena de una fecha.
lcase
left
length
Sintaxis
julian_day ( expression )
Ejemplo
julian_day ( ’2009-06-29’ )
Resultado
2455012.22130739595741034
Devuelve "string_expression" con todos los caracteres en mayúsculas convertidos a
minúsculas.
Sintaxis
lcase ( string_expression )
Ejemplo
lcase ( [Sales (query)].[Sales staff].[Last name] )
Resultado
Devuelve los apellidos sin ninguna letra en mayúsculas.
Devuelve los caracteres indicados por "integer_expression" más a la izquierda de
"string_expression".
Sintaxis
left ( string_expression, integer_expression )
Ejemplo
left ( [Sales (query)].[Sales staff].[Last name] ,3)
Resultado
Devuelve los tres primeros caracteres de cada apellido.
Devuelve la longitud del operando en bytes. Excepción: Los tipos de cadenas de
doble byte devuelven la longitud en caracteres.
Sintaxis
length ( expression )
Ejemplo
length ( [Sales (query)].[Sales staff].[Record start date] )
Apéndice C. Uso del editor de expresiones 447

locate
Resultado
Devuelve 4; las fechas siempre devuelven un valor de 4.
Devuelve la posición inicial de la primera aparición de "string_expression1" dentro
de "string_expression2". La búsqueda empieza a partir de la posición inicial
"integer_expression" de "string_expression2". El primer carácter de una cadena se
encuentra en la posición 1. Si no se encuentra "string_expression1", se devuelve
cero.
Sintaxis
locate ( string_expression1, string_expression2 [ ,
integer_expression ] )
Ejemplo
locate ( A, [Sales (query)].[Sales staff].[Last name] ,2)
Resultado
Devuelve la posición del carácter A en los apellidos, empezando por el segundo
carácter del apellido.
long_varchar
Devuelve una cadena larga.
ltrim
Sintaxis
long_varchar ( string_expression )
Devuelve "string_expression" sin espacios iniciales.
Sintaxis
ltrim ( string_expression )
Ejemplo
ltrim ( [Sales (query)].[Sales staff].[Last name] )
Resultado
Devuelve los apellidos con los espacios iniciales eliminados.
microsecond
Devuelve la parte de microsegundo (unidad de tiempo) de un valor. "Expression"
puede ser una indicación de fecha y hora o una representación en forma de cadena
de una representación de fecha y hora.
Sintaxis
microsecond ( expression )
Ejemplo
microsecond ( 01:45:34.056 )
448 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Resultado
Devuelve 056.
midnight_seconds
Devuelve un valor entero dentro del rango de 0 a 86400 que representa el número
de segundos entre la medianoche y el valor de hora especificado en el argumento.
"Expression" puede ser un valor de hora, una indicación de fecha y hora o una
representación en forma de cadena de una hora.
Sintaxis
midnight_seconds ( expression )
Ejemplo
midnight_seconds ( 01:45:34.056 )
Resultado
Devuelve 6334.
minute
Devuelve los minutos (un entero de 0 a 59) de "time_expression".
"Time_expression" puede ser un valor de hora, una indicación de fecha y hora o
una representación en forma de cadena de una hora.
Sintaxis
minute ( time_expression )
Ejemplo
minute ( 01:45:34.056 )
Resultado
Devuelve 45.
month
Devuelve el mes (un entero del 1 al 12) de "date_expression".
Sintaxis
month ( date_expression )
Ejemplo
month ( 2005-11-01 )
Resultado
Devuelve 11.
monthname
Devuelve una cadena de caracteres que contiene el nombre del mes específico del
origen de datos (por ejemplo, de January a December o de Jan. a Dec. para un
origen de datos en inglés, o Januar a Dezember para un origen de datos en
alemán) para la parte del mes de "date_expression".
Apéndice C. Uso del editor de expresiones 449

Sintaxis
monthname ( date_expression )
Ejemplo
monthname ( 2005-11-01 )
Resultado
Noviembre
quarter
Devuelve el trimestre de "date_expression" como un número en el rango de 1a4,
donde 1 representa del 1 de enero al 31 de marzo.
Sintaxis
quarter ( date_expression )
Ejemplo
quarter ( 2005-11-01 )
Resultado
Devuelve 4.
radians
Devuelve el número de radianes convertidos desde los grados indicados en
"numeric_expression".
repeat
Sintaxis
radians ( numeric_expression )
Devuelve una cadena que consta de "string_expression" repetida el número de
veces que "integer_expression" indica.
Sintaxis
repeat ( string_expression, integer_expression )
Ejemplo
repeat ( XYZ, 3 )
Resultado
Devuelve XYZXYZXYZ.
replace
Sustituye todas las apariciones de "string_expression2" en "string_expression1" por
"string_expression3".
Sintaxis
replace ( string_expression1, string_expression2, string_expression3 )
Ejemplo
450 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

ight
round
rtrim
replace ( [Sales (query)].[Sales staff].[Position code], A, a )
Resultado
Devuelve los códigos de cargo con todas las apariciones de "A" sustituidas por "a".
Devuelve los caracteres indicados por "integer_expression" más a la derecha de
"string_expression".
Sintaxis
right ( string_expression, integer_expression )
Ejemplo
right ( [Sales (query)].[Sales staff].[Position code], 3 )
Resultado
Devuelve los 3 caracteres del extremo derecho de cada código de cargo.
Devuelve "numeric_expression" redondeado a "integer_expression" posiciones a la
derecha del separador decimal. Si el valor de "integer_expression" es negativo,
"numeric_expression" se redondea al número de posiciones indicado por el valor
absoluto más cercano de "integer_expression" a la izquierda del separador decimal.
El redondeo tiene lugar antes de formatear los datos.
Sintaxis
round ( numeric_expression, integer_expression )
Ejemplo
round ( 3.14159265, 3 )
Resultado
Devuelve 3,142.
Devuelve "string_expression" sin los espacios finales.
Sintaxis
rtrim ( string_expression )
Ejemplo
rtrim ( [Sales (query)].[Sales staff].[Last name] )
Resultado
Devuelve los apellidos sin espacios al final del nombre.
Apéndice C. Uso del editor de expresiones 451

second
Devuelve los segundos (un entero de 0 a 59) de "time_expression".
sign
Sintaxis
second ( time_expression )
Ejemplo
second ( 01:45:34.056 )
Resultado
Devuelve 34.
Devuelve un indicador del signo de "numeric_expression": +1 si el valor de
"numeric_expression" es positivo, 0 si es cero o -1 si es negativo.
Sintaxis
sign ( numeric_expression )
Ejemplo
sign ( [Revenue] )
Resultado
Devuelve + para los valores positivos y - para los valores negativos.
smallint
Devuelve la representación en forma de Small Integer de un número.
Sintaxis
smallint ( expression )
soundex
Devuelve un código de cadena de 4 caracteres obtenido al abreviar
sistemáticamente las palabras y los nombres de "string_expression" conforme a la
fonética. Se puede utilizar para determinar si dos cadenas suenan igual. Por
ejemplo, el sonido de ('BACA') es igual que el de ('VACA').
space
Sintaxis
soundex ( string_expression )
Devuelve una cadena que consta de los espacios indicados en "integer_expression".
Sintaxis
space ( integer_expression )
Ejemplo
space (5)
Resultado
452 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Devuelve 5 espacios.
substr
Devuelve la subcadena de "string_expression" que empieza en la posición indicada
por "integer_expression1" y tiene una longitud de "integer_expression2" caracteres.
El primer carácter de "string_expression" se encuentra en la posición 1.
Sintaxis
substr ( string_expression , integer_expression1 [ ,
integer_expression2 ] )
Ejemplo
substr ( [Sales (query)].[Sales staff].[Position code], 3,5)
Resultado
Devuelve los caracteres del 3 al 7 de los códigos de cargo.
table_name
Devuelve un nombre no calificado de una tabla o vista en función del nombre de
objeto de "string_expression1" y el nombre de esquema proporcionado en
"string_expression2". Se utiliza para resolver los alias.
Sintaxis
table_name ( string_expression1 [ , string_expression2 ] )
table_schema
Devuelve la parte correspondiente al nombre de esquema de un nombre de tabla o
vista compuesto de dos partes en función del nombre de objeto indicado en
"string_expression1" y el nombre de esquema indicado en "string_expression2". Se
utiliza para resolver los alias.
time
Sintaxis
table_schema ( string_expression1 [ , string_expression2 ] )
Devuelve una hora a partir de un valor.
Sintaxis
time ( expression )
timestamp
Devuelve una indicación de fecha y hora a partir de un valor o un par de valores.
"Expression1" debe representar un valor de fecha y "expression2" un valor de hora.
Sintaxis
timestamp ( expression1 [ , expression2 ] )
Ejemplo
timestamp ( 11 November 2005 , 12:00:00.000000 )
Resultado
Apéndice C. Uso del editor de expresiones 453

Devuelve 2005-11-11-12:00:00.000000.
timestamp_iso
Devuelve un valor fecha y hora en formato ISO (aaaa-mm-dd hh:mm:ss.nnnnnn)
convertido a partir del formato de IBM (aaaa-mm-dd-hh.mm.ss.nnnnnn). Si
"expression" es una hora, inserta el valor de FECHA ACTUAL para los elementos
de fecha y cero para el elemento de fracción horaria.
Sintaxis
timestamp_iso ( expression )
Ejemplo
timestamp_iso ( 11 November 2005 , 12:00:00.000000 )
Resultado
Devuelve 2005-11-11 12:00:00.000000.
timestampdiff
Devuelve un número estimado de intervalos de tipo "expression1" en función de la
diferencia entre dos indicaciones de fecha y hora. "Expression2" es el resultado de
restar dos tipos de indicaciones de fecha y hora y convertir el resultado en CHAR.
Los valores válidos de "expression1" son: 1 Fracciones de segundo; 2 Segundos; 4
Minutos; 8 Horas; 16 Días; 32 Semanas; 64 Meses; 128 Trimestres; 256 Años.
Sintaxis
timestampdiff ( expression1, expression2 )
to_char
Devuelve la representación en forma de cadena de una indicación de fecha y hora
con el formato "string_expression".
Sintaxis
to_char ( timestamp_expression , string_expression )
translate
Devuelve "string_expression1" donde los caracteres de "string_expression3" se
convierten en los caracteres equivalentes de "string_expression2".
"String_expression4" es un único carácter que se utiliza para rellenar
"string_expression2", si es más corto que "string_expression3". Si solo está presente
"string_expression1", esta función la convierte a caracteres mayúsculas.
Sintaxis
translate ( string_expression1 [ , string_expression2,
string_expression3 [ , string_expression4 ]])
Ejemplo 1
translate ( ’abcdefg’ )
Resultado
Devuelve ABCDEFG.
454 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

trunc
Ejemplo 2
translate ( ’mnlop’ , n, m,-)
Resultado
Devuelve n-nlop.
Devuelve el valor de "numeric_expression1" truncado al número de posiciones
indicado en "numeric_expression2" a la derecha del separador decimal. Si el valor
de "numeric_expression2" es negativo, "numeric_expression1" se trunca hasta el
valor absoluto de "numeric_expression2" posiciones a la izquierda del separador
decimal.
Sintaxis
trunc ( numeric_expression1, numeric_expression2 )
Ejemplo
trunc ( 3.14159265, 3 )
Resultado
Devuelve 3,141.
truncate
Devuelve el valor de "numeric_expression1" truncado al número de posiciones
indicado en "numeric_expression2" a la derecha del separador decimal. Si el valor
de "numeric_expression2" es negativo, "numeric_expression1" se trunca hasta el
valor absoluto de "numeric_expression2" posiciones a la izquierda del separador
decimal.
ucase
Sintaxis
truncate ( numeric_expression1, numeric_expression2 )
Ejemplo
truncate ( 3141.59265, -3 )
Resultado
Devuelve 3.
Devuelve "string_expression" con todos los caracteres en minúsculas cambiados a
mayúsculas.
Sintaxis
ucase ( string_expression )
Ejemplo
ucase ( XY896Zbced789 )
Resultado
Apéndice C. Uso del editor de expresiones 455

value
Devuelve XY896ZBCED789.
Devuelve el primer argumento no nulo (o nulo si todos los argumentos son nulos).
La función Value requiere dos o más argumentos.
Sintaxis
value ( expression_list )
Ejemplo
value ( [Unit cost], [Unit price], [Unit sale price] )
Resultado
Devuelve el primer valor no nulo.
varchar
Devuelve una representación de tipo VARCHAR de la expresión, con la longitud
indicada en numeric_expression.
week
year
Sintaxis
varchar ( expression [ , numeric_expression ] )
Devuelve la semana del año en "date_expression" como un valor entero en el rango
de 1 a 53.
Sintaxis
week ( date_expression )
Ejemplo
week ( 11 November 2005 )
Resultado
Devuelve 45.
Devuelve el año de "date_expression".
Sintaxis
year ( date_expression )
Ejemplo
year ( 11 November 2005 )
Resultado
Devuelve 2005.
456 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Greenplum
Cadena de Greenplum
overlay
Devuelve "string_expression1" que sustituye a "string_expression2" desde la
posición "numeric_expression" en los caracteres.
Sintaxis
overlay ( string_expression1 , string_expression2 ,
numeric_expression1 [ , numeric_expression2 ] )
btrim
Devuelve "string_expression1" después de eliminar la cadena de caracteres más
larga de "string_expression2".
Sintaxis
btrim ( string_expression1 [ , string_expression2 ] )
initcap
Devuelve "string_expression" con la primera letra de cada palabra en mayúsculas y
todas las demás letras en minúsculas. Las palabras están delimitadas por un
espacio en blanco o caracteres que no son alfanuméricos.
Sintaxis
initcap ( string_expression )
lpad
Devuelve "string_expression1" que se ha rellenado hasta la longitud indicada en
"integer_expression" con apariciones de "string_expression2". Si
"string_expression1" tiene una longitud superior a "integer_expression", se
devuelve la parte apropiada de "string_expression1".
Sintaxis
lpad ( string_expression1 , integer_expression [ , string_expression2
])
ltrim
Devuelve "string_expression1", donde se han eliminado los caracteres iniciales
hasta el primer carácter que no se encuentra en "string_expression2"; por ejemplo,
ltrim ( 'xyxXxyAB' , 'xy' ) devuelve XxyAB.
Sintaxis
ltrim ( string_expression1 [ , string_expression2 ] )
md5
Devuelve el hash MD5 de "string_expression1".
Sintaxis
md5 ( string_expression1 )
to_hex
Devuelve la representación en forma de cadena hexadecimal de
"numeric_expression1".
Apéndice C. Uso del editor de expresiones 457

Sintaxis
to_hex ( numeric_expression1 )
repeat
Devuelve "string_expression" repetida el número de veces indicado en
"numeric_expression1".
Sintaxis
repeat ( string_expression , numeric_expression1 )
replace
Devuelve "string_expression", después de haber sustituido "string_expression2" por
"string_expression3".
Sintaxis
replace ( string_expression , string_expression2 , string_expression3)
rpad
Devuelve "string_expression1" que se ha rellenado por la derecha hasta la longitud
"integer_expression" con apariciones de "string_expression2". Si
"string_expression1" tiene una longitud superior a "integer_expression", se
devuelve la parte apropiada de "string_expression1". Si "string_expression2" no se
especifica, se utilizan espacios.
Sintaxis
rpad ( string_expression1 , integer_expression [ , string_expression2
])
rtrim
Devuelve "string_expression1", donde se han eliminado los caracteres finales
después del último carácter que no se encuentra en "string_expression2"; por
ejemplo, rtrim ( 'ABxXxyx' , 'xy' ) devuelve ABxX. Si "string_expression2" no se
especifica, se eliminan los caracteres de espacio finales.
Sintaxis
rtrim ( string_expression1 [ , string_expression2 ] )
split_part
Devuelve el campo "numeric_expression" después de haber dividido
"string_expression1" en "string_expression2".
Sintaxis
split_part ( string_expression1 , string_expression2 ,
numeric_expression )
Formateo de tipo de datos de Greenplum
to_char
Devuelve la representación en forma de cadena de "expression" con el formato de
"string_expression". "Expression" puede ser un valor de fecha o un valor numérico.
Sintaxis
to_char ( expression , string_expression )
458 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

to_date
Convierte "string_expression1" en un valor de fecha, según especifica el formato
"string_expression2".
Sintaxis
to_date ( string_expression1 , string_expression2 )
to_number
Convierte "string_expression1" en un valor numérico, según especifica el formato
"string_expression2".
Sintaxis
to_number ( string_expression1 , string_expression2 )
to_timestamp
Convierte "string_expression1" en un valor de indicación de fecha y hora, según
especifica el formato "string_expression2".
Sintaxis
to_timestamp ( string_expression1 , string_expression2 )
Funciones matemáticas de Greenplum
log
Devuelve el logaritmo en base 10 de "numeric_expression1" o el logaritmo en base
"numeric_expression2".
Sintaxis
log ( numeric_expression1 [ , numeric_expression2 ] )
ln
Devuelve el logaritmo natural de "numeric_expression1".
Sintaxis
ln ( numeric_expression )
cbrt
Devuelve la raíz cúbica de "numeric_expression1".
Sintaxis
cbrt ( numeric_expression )
pi
Devuelve la constante pi.
Sintaxis
pi ()
Funciones trigonométricas de Greenplum
acos
Devuelve el arcocoseno de "numeric_expression" en radianes. El arcocoseno es el
ángulo cuyo coseno es "numeric_expression".
Sintaxis
Apéndice C. Uso del editor de expresiones 459

acos ( numeric_expression )
asin
Devuelve el arcoseno de "numeric_expression" en radianes. El arcoseno es el
ángulo cuyo seno es "numeric_expression".
Sintaxis
asin ( numeric_expression )
atan
Devuelve la arcotangente de "numeric_expression" en radianes. La arcotangente es
el ángulo cuya tangente es "numeric_expression".
Sintaxis
atan ( numeric_expression )
atan2
Devuelve la arcotangente de las coordenadas xeyespecificadas por
"numeric_expression1" y "numeric_expression2", respectivamente, en radianes. La
arcotangente es el ángulo cuya tangente es "numeric_expression2" /
"numeric_expression1".
Sintaxis
atan2 ( numeric_expression1 ,numeric_expression2 )
cos
Devuelve el coseno de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
Sintaxis
cos ( numeric_expression )
cot
Devuelve la cotangente de "numeric_expression", donde "numeric_expression" es
un ángulo expresado en radianes.
Sintaxis
cot ( numeric_expression )
degrees
Devuelve los grados, donde "numeric_expression" es un ángulo expresado en
radianes.
Sintaxis
degrees ( numeric_expression )
radians
Devuelve los radianes, donde "numeric_expression" es un ángulo expresado en
grados.
Sintaxis
radians ( numeric_expression )
sin
Devuelve el seno de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
460 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

ascii
chr
Sintaxis
sin ( numeric_expression )
tan
Devuelve la tangente de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
Sintaxis
tan ( numeric_expression )
Devuelve un número que representa el valor del código ascii del carácter que se
encuentra más a la izquierda de "string_expression"; por ejemplo, ascii ( 'A' )
devuelve 65.
Sintaxis
ascii ( string_expression )
Devuelve el carácter que tiene el valor del código ASCII especificado por
"integer_expression". "Integer_expression" debe estar entre 0 y 255.
Sintaxis
chr ( integer_expression )
current_database
Devuelve el nombre de la base de datos actual.
Sintaxis
current_database ()
current_schema
Devuelve el nombre del esquema actual.
Sintaxis
current_schema ()
{current_user}
Sintaxis
{current_user}
{session_user}
Sintaxis
{session_user}
translate
Devuelve "string_expression1" con todas las apariciones de cada carácter incluido
en "string_expression2" sustituidas por su carácter correspondiente de
"string_expression3".
Sintaxis
Apéndice C. Uso del editor de expresiones 461

Informix
translate ( string_expression1 , string_expression2 ,
string_expression3 )
date_trunc
Devuelve la indicación de fecha y hora a la precisión especificada.
Sintaxis
date_trunc ( string_expression , timestamp_expression)
version
Devuelve el valor de cadena de la versión de la base de datos.
Sintaxis
version ()
Funciones matemáticas de Informix
log10
Devuelve el logaritmo decimal de "numeric_expression".
Sintaxis
log10 ( numeric_expression )
logn
Devuelve el logaritmo natural de "numeric_expression".
Sintaxis
logn ( numeric_expression )
root
Devuelve el valor de la raíz de "numeric_expression1". Necesita al menos un
argumento numérico (argumento de radianes). Si sólo se proporciona
"numeric_expression1", se utilizará 2 como valor predeterminado para
"numeric_expression2". No puede utilizarse cero como valor de
"numeric_expression2".
Sintaxis
root ( numeric_expression1 [ , numeric_expression2 ] )
Funciones trigonométricas de Informix
acos
Devuelve el arcocoseno de "numeric_expression" en radianes. El arcocoseno es el
ángulo cuyo coseno es "numeric_expression".
Sintaxis
acos ( numeric_expression )
asin
Devuelve el arcoseno de "numeric_expression" en radianes. El arcoseno es el
ángulo cuyo seno es "numeric_expression".
462 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Sintaxis
asin ( numeric_expression )
atan
Devuelve la arcotangente de "numeric_expression" en radianes. La arcotangente es
el ángulo cuya tangente es "numeric_expression".
Sintaxis
atan ( numeric_expression )
atan2
Devuelve la arcotangente de las coordenadas xeyespecificadas por
"numeric_expression1" y "numeric_expression2", respectivamente, en radianes. La
arcotangente es el ángulo cuya tangente es "numeric_expression1".
Sintaxis
atan2 ( numeric_expression1 , numeric_expression2 )
cos
Devuelve el coseno de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
Sintaxis
cos ( numeric_expression )
sin
Devuelve el seno de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
Sintaxis
sin ( numeric_expression )
tan
Devuelve la tangente de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
Sintaxis
tan ( numeric_expression )
cardinalidad
Devuelve el número de elementos en una columna de colección (SET, MULTISET,
LIST).
Sintaxis
cardinality ( string_expression )
char_length
Devuelve el número de caracteres lógicos de "string_expression". El número de
caracteres lógicos puede ser distinto del número de bytes en algunos entornos
locales de Asia Oriental.
Sintaxis
char_length ( string_expression )
Apéndice C. Uso del editor de expresiones 463

concat
Devuelve una cadena que es el resultado de concatenar, o unir,
"string_expression1" con "string_expression2".
date
day
Sintaxis
concat ( string_expression1 , string_expression2 )
Ejemplo
concat ( [Sales (query)].[Sales staff].[First name], [Sales (query)].
[Sales staff].[Last name] )
Resultado
Devuelve el nombre y el apellido; por ejemplo, Roberto Rodríguez.
Devuelve el valor de fecha de "string_expression", "date_expression" o
"integer_expression".
Sintaxis
date ( string_expression|date_expression|integer_expression )
Devuelve un entero que representa el día del mes (1-31).
Sintaxis
day ( date_expression )
extend
Ajusta la precisión de una expresión de fecha o de fecha y hora. La expresión no
puede ser una representación en forma de cadena entrecomillada de un valor de
fecha. Si no especifica el primer y el último calificador, los calificadores
predeterminados serán de año a fracción (3). Si la expresión contiene campos no
especificados por los calificadores, se descartan los campos no deseados. Si el
primer calificador especifica un campo mayor (más significativo) que el de la
expresión, los nuevos campos se rellenan con los valores devueltos por la función
actual. Si el último calificador especifica un campo menor (menos significativo) que
el de la expresión, los nuevos campos se rellenan con valores constantes. Los
campos de mes o de día que faltan se rellenan con 1, y los campos de hora a
fracción que faltan se rellenan con 0.
hex
Sintaxis
extend ( date_expression ,’{’year to second ’}’)
Ejemplo
extend ( some_date_column , { year to second } )
Devuelve la codificación hexadecimal de "integer_expression".
Sintaxis
hex ( integer_expression )
464 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

initcap
Devuelve "string_expression" con la primera letra de cada palabra en mayúsculas y
todas las demás letras en minúsculas. Una palabra empieza después de cualquier
carácter que no sea una letra. Por lo tanto, además de un espacio en blanco, los
símbolos como las comas, los puntos y los dos puntos pueden iniciar una nueva
palabra.
length
lpad
mdy
Sintaxis
initcap ( string_expression )
Devuelve el número de bytes de "string_expression", sin incluir ningún espacio en
blanco al final. Para "string_expression" de bytes o texto, length devuelve el
número total de bytes, incluidos los espacios en blanco al final.
Sintaxis
length ( string_expression )
Devuelve "string_expression1" ampliada por la izquierda con "string_expression2"
hasta el número total de caracteres especificados por "integer_expression". La
secuencia de "string_expression2" se repite tantas veces como sea necesario hasta
que la cadena devuelta alcance la longitud especificada por "integer_expression".
Sintaxis
lpad ( string_expression1 , integer_expression , string_expression2 )
Devuelve un valor de tipo fecha con tres expresiones que se evalúan como enteros
que representan el mes (integer_expression1), el día (integer_expression2) y el año
(integer_expression3).
Sintaxis
mdy ( integer_expression1 , integer_expression2 ,
integer_expression3 )
month
Devuelve un entero que corresponde a la parte del mes de "date_expression".
nvl
Sintaxis
month ( date_expression )
Devuelve el valor de "expression1" si "expression1" no es NULL. Si "expression1"
es NULL, entonces devuelve el valor de "expression2".
Sintaxis
nvl ( expression1 , expression2 )
Ejemplo
nvl ( [Unit sale price] , [Unit price] )
Apéndice C. Uso del editor de expresiones 465

Resultado
Devuelve el precio de venta unitario o bien devuelve el precio unitario si el precio
de venta unitario es NULL.
octet_length
Devuelve el número de bytes de "string_expression", incluidos los espacios en
blanco finales.
Sintaxis
octet_length ( string_expression )
replace
Devuelve "string_expression1", donde cada aparición de "string_expression2" se
sustituye por "string_expression3". Si omite la opción "string_expression3", todas
las apariciones de "string_expression2" se omiten de la cadena devuelta.
round
rpad
Sintaxis
replace ( string_expression1 , string_expression2 [ ,
string_expression3 ] )
Ejemplo
replace ( [Sales (query)].[Products].[Product line code] ,-)
Resultado
Devuelve todos los códigos de línea de producto sin el carácter "-"
Devuelve el valor redondeado de "numeric_expression". Si omite la variable
"integer_expression", el valor se redondea a cero dígitos o a las unidades. El rango
de dígitos de 32 (+ y -) hace referencia a todo el valor decimal. El redondeo tiene
lugar antes de formatear los datos.
Sintaxis
round ( numeric_expression [ , integer_expression ] )
Ejemplo
round (125, -1)
Resultado
130
Devuelve "string_expression1" ampliada por la derecha con "string_expression2"
hasta el número total de caracteres especificados por "integer_expression". La
secuencia de "string_expression2" se repite tantas veces como sea necesario hasta
que la cadena devuelta alcance la longitud especificada por "integer_expression".
Sintaxis
rpad ( string_expression1 , integer_expression , string_expression2 )
466 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

substr
Devuelve la subcadena de "string_expression" que empieza en la posición indicada
por "integer_expression1" y tiene una longitud de "integer_expression2" caracteres.
El primer carácter de "string_expression" se corresponde con la posición 1. Si omite
"integer_expression2", devuelve la subcadena de "string_expression" que comienza
en la posición indicada por "integer_expression1" y acaba al final de
"string_expression".
Sintaxis
substr ( string_expression , integer_expression1 [ ,
integer_expression2 ] )
Ejemplo
substr ( [Sales (query)].[Sales staff].[Position code], 3,5)
Resultado
Devuelve los caracteres del 3 al 7 de los códigos de cargo.
to_char
Devuelve la cadena de caracteres "date_expression" con el formateo de
"string_expression" especificado. Sólo puede utilizar esta función con tipos de datos
incorporados.
Sintaxis
to_char ( date_expression , string_expression )
to_date
Devuelve "string_expression1" como una fecha en función del formato de fecha que
se ha especificado en "string_expression2". Si la variable "string_expression1" es
NULL, se devuelve un valor NULL.
trunc
Sintaxis
to_date ( string_expression1 , string_expression2 )
Devuelve el valor truncado de "numeric_expression". Si se omite
"integer_expression", "numeric_expression" se trunca a cero dígitos oalas
unidades. El límite de dígitos de 32 (+ y -) hace referencia a todo el valor decimal.
Sintaxis
trunc ( numeric_expression [ , integer_expression ] )
weekday
Devuelve un entero que representa el día de la semana de "date_expression". Cero
(0) representa el domingo, uno (1) representa el lunes, y así sucesivamente.
Sintaxis
weekday ( date_expression )
Apéndice C. Uso del editor de expresiones 467

year
MS Access
Devuelve un entero de cuatro dígitos que representa el año de "date_expression".
Sintaxis
year ( date_expression )
Funciones cast de MS Access
cast_decimal
Devuelve el valor de "expression" convertido en un decimal.
Sintaxis
cast_decimal ( expression )
cast_float
Devuelve el valor de "expression" convertido en un valor flotante.
Sintaxis
cast_float ( expression )
cast_integer
Devuelve el valor de "expression" convertido en un entero.
Sintaxis
cast_integer ( expression )
Ejemplo
cast_integer ( 84.95 )
Resultado
84
cast_numeric
Devuelve el valor de "string_expression" convertido en un valor numérico.
Sintaxis
cast_numeric ( string_expression )
cast_real
Devuelve el valor de "expression" convertido en un valor real.
Sintaxis
cast_real ( expression )
cast_smallint
Devuelve el valor de "expression" convertido en un entero pequeño.
Sintaxis
cast_smallint ( expression )
468 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

cast_varchar
Devuelve el valor de "expression" convertido en un campo de caracteres variables.
Sintaxis
cast_varchar ( expression )
Funciones matemáticas de MS Access
log
Devuelve el logaritmo natural de "numeric_expression".
Sintaxis
log ( numeric_expression )
rand
Genera un número aleatorio utilizando "integer_expression" como valor de origen.
Sintaxis
rand ( integer_expression )
Funciones trigonométricas de MS Access
ascii
atan
Devuelve la arcotangente de "numeric_expression" en radianes. La arcotangente es
el ángulo cuya tangente es "numeric_expression".
Sintaxis
atan ( numeric_expression )
cos
Devuelve el coseno de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
Sintaxis
cos ( numeric_expression )
sin
Devuelve el seno de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
Sintaxis
sin ( numeric_expression )
tan
Devuelve la tangente de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
Sintaxis
tan ( numeric_expression )
Devuelve el valor del código ASCII del carácter que se encuentra más a la
izquierda de "string_expression".
Apéndice C. Uso del editor de expresiones 469

Sintaxis
ascii ( string_expression )
ceiling
Devuelve el entero más pequeño igual o mayor que "numeric_expression".
chr
Sintaxis
ceiling ( numeric_expression )
Devuelve el carácter que tiene el valor del código ASCII especificado por
"integer_expression". "Integer_expression" debe estar entre 0 y 255.
Sintaxis
chr ( integer_expression )
concat
Devuelve una cadena que es el resultado de concatenar, o unir,
"string_expression1" con "string_expression2".
Sintaxis
concat ( string_expression1 , string_expression2 )
Ejemplo
concat ( [Sales (query)].[Sales staff].[First name], [Sales (query)].
[Sales staff].[Last name] )
Resultado
Devuelve el nombre y el apellido; por ejemplo, Roberto Rodríguez.
curdate
Devuelve un valor de fecha que representa la fecha actual del sistema en el que se
ejecuta el software de bases de datos.
Sintaxis
curdate ()
curtime
Devuelve un valor de hora que representa la hora actual del sistema en el que se
ejecuta el software de bases de datos.
Sintaxis
curtime ()
dayname
Devuelve una cadena de caracteres que contiene el nombre específico del origen de
datos del día (por ejemplo, de Sunday a Saturday o de Sun. a Sat. para un origen
de datos en inglés, o de Sonntag a Samstag para un origen de datos en alemán)
para la parte de día indicada en "date_expression".
Sintaxis
470 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

dayname ( date_expression )
dayofmonth
Devuelve el día del mes (de 1 a 31) de "date_expression". Devuelve el campo de
los días (en forma de entero con signo) de "interval_expression".
Sintaxis
dayofmonth ( date_expression|interval_expression )
dayofweek
Devuelve el día de la semana de "date_expression" como un entero (del 1 al 7),
donde el 1 representa el lunes.
Sintaxis
dayofweek ( date_expression )
dayofyear
Devuelve el día del año de "date_expression" como un entero (del 1 al 366).
hour
instr
lcase
left
Sintaxis
dayofyear ( date_expression )
Devuelve la hora de "time_expression" como un entero comprendido entre el 0
(medianoche) y el 23 (11:00 pm).
Sintaxis
hour ( time_expression )
Busca en "string_expression1" la primera aparición de "string_expression2" y
devuelve un entero que especifica la posición de "string_expression2".
"Integer_expression1" establece la posición inicial de la búsqueda. Si se omite
"integer_expression1", la búsqueda empieza por la posición que ocupa el primer
carácter de "string_expression1". "Integer_expression2" especifica el tipo de
comparación de cadenas. Se necesitará "integer_expression1" si se ha especificado
"integer_expression2".
Sintaxis
instr ( [ integer_expression1 , ] string_expression1 ,
string_expression2 [ , integer_expression2 ] )
Devuelve "string_expression" con todos los caracteres en mayúsculas convertidos a
minúsculas.
Sintaxis
lcase ( string_expression )
Devuelve los caracteres indicados por "integer_expression" más a la izquierda de
"string_expression".
Apéndice C. Uso del editor de expresiones 471

length
locate
ltrim
Sintaxis
left ( string_expression , integer_expression )
Ejemplo
left ( [Sales (query)].[Sales staff].[Last name] ,3)
Resultado
Devuelve los tres primeros caracteres de cada apellido.
Devuelve el número de caracteres de "string_expression", sin incluir los espacios en
blanco finales ni el carácter de fin de cadena.
Sintaxis
length ( string_expression )
Devuelve la posición inicial de la primera aparición de "string_expression1" dentro
de "string_expression2". La búsqueda comienza a partir de la posición
"integer_expression" de "string_expression2". El primer carácter de una cadena se
encuentra en la posición 1. Si no se encuentra "string_expression1", el valor
devuelto es cero.
Sintaxis
locate ( string_expression1 , string_expression2 [ ,
integer_expression ] )
Devuelve "string_expression" sin espacios iniciales.
Sintaxis
ltrim ( string_expression )
minute
Devuelve los minutos (un entero de 0 a 59) de "time_expression".
Sintaxis
minute ( time_expression )
month
Devuelve el mes (un entero del 1 al 12) de "date_expression".
Sintaxis
month ( date_expression )
monthname
Devuelve una cadena de caracteres que contiene el nombre del mes específico del
origen de datos (por ejemplo, de January a December o de Jan. a Dec. para un
origen de datos en inglés, o Januar a Dezember para un origen de datos en
alemán) para la parte del mes de "date_expression".
472 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

now
Sintaxis
monthname ( date_expression )
Ejemplo
monthname ( 2005-11-01 )
Resultado
Noviembre
Devuelve un valor de fecha y hora que representa la fecha y hora actual del
sistema en el que se ejecuta el software de bases de datos.
Sintaxis
now ()
position
Devuelve la posición inicial de "string_expression1" en "string_expression2". El
primer carácter de una cadena se encuentra en la posición 1.
Sintaxis
position ( string_expression1 , string_expression2 )
quarter
Devuelve el trimestre de "date_expression" como un número (de 1 a 4), donde 1
significa de 1 de enero a 31 de marzo.
right
round
Sintaxis
quarter ( date_expression )
Devuelve los caracteres indicados por "integer_expression" más a la derecha de
"string_expression".
Sintaxis
right ( string_expression , integer_expression )
Devuelve "numeric_expression" redondeado al valor más cercano
"integer_expression" posiciones a la derecha del separador decimal. Si el valor de
"integer_expression" es negativo, "numeric_expression" se redondea al número de
posiciones indicado por el valor absoluto más cercano de "integer_expression" a la
izquierda del separador decimal. El redondeo tiene lugar antes de formatear los
datos.
Sintaxis
round ( numeric_expression , integer_expression )
Ejemplo
round (125, -1)
Apéndice C. Uso del editor de expresiones 473

trim
sign
space
Resultado
130
Devuelve "string_expression" sin los espacios finales.
Sintaxis
rtrim ( string_expression )
Ejemplo
rtrim ( [Sales (query)].[Sales staff].[Last name] )
Resultado
Devuelve los apellidos sin espacios al final del nombre.
Devuelve un indicador del signo de "numeric_expression": +1 si es positiva, 0 si es
cero o -1 si es negativa.
Sintaxis
sign ( numeric_expression )
Devuelve una cadena que consta de los espacios indicados en "integer_expression".
Sintaxis
space ( integer_expression )
substr
Devuelve la subcadena de "string_expression" que empieza en la posición indicada
por "integer_expression1" y tiene una longitud de "integer_expression2" caracteres.
El primer carácter de "string_expression" se encuentra en la posición 1.
Sintaxis
substr ( string_expression , integer_expression1 ,
integer_expression2 )
Ejemplo
substr ( [Sales (query)].[Sales staff].[Position code], 3,5)
Resultado
Devuelve los caracteres del 3 al 7 de los códigos de cargo.
substring
Devuelve la subcadena de "string_expression" que empieza en la posición indicada
por "integer_expression1" y tiene una longitud de "integer_expression2" caracteres.
El primer carácter de "string_expression" se encuentra en la posición 1.
Sintaxis
474 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

MySQL
substring ( string_expression , integer_expression1 ,
integer_expression2 )
Ejemplo
substring ( [Sales (query)].[Sales staff].[Position code], 3,5)
Resultado
Devuelve los caracteres del 3 al 7 de los códigos de cargo.
truncate
Devuelve "string_expression" sin los espacios finales.
ucase
week
year
Sintaxis
truncate ( string_expression )
Devuelve "string_expression" con todos los caracteres en minúsculas convertidos a
mayúsculas.
Sintaxis
ucase ( string_expression )
Devuelve la semana del año de "date_expression" como un valor entero (del 1 al
53), donde el 1 representa la primera semana del año.
Sintaxis
week ( date_expression )
Devuelve el año de "date_expression".
Sintaxis
year ( date_expression )
Cadena de MySQL
lpad
Devuelve "string_expression1" que se ha rellenado hasta la longitud indicada en
"integer_expression" con apariciones de "string_expression2". Si
"string_expression1" tiene una longitud superior a "integer_expression", se
devuelve la parte apropiada de "string_expression1".
Sintaxis
lpad ( string_expression1 , integer_expression [ , string_expression2
])
Apéndice C. Uso del editor de expresiones 475

ltrim
Devuelve "string_expression1", donde se han eliminado los caracteres iniciales
hasta el primer carácter que no se encuentra en "string_expression2"; por ejemplo,
ltrim ( 'xyxXxyAB' , 'xy' ) devuelve XxyAB.
Sintaxis
ltrim ( string_expression1 [ , string_expression2 ] )
hex
Devuelve la representación en forma de cadena hexadecimal de
"numeric_expression1".
Sintaxis
hex ( numeric_expression1 )
repeat
Devuelve "string_expression" repetida el número de veces indicado en
"numeric_expression1".
Sintaxis
repeat ( string_expression , numeric_expression1 )
replace
Devuelve "string_expression", después de haber sustituido "string_expression2" por
"string_expression3".
Sintaxis
replace ( string_expression , string_expression2 , string_expression3
)
reverse
Devuelve "string_expression" invertida.
Sintaxis
reverse ( string_expression )
right
Devuelve los caracteres de "numeric_expression" más a la derecha de
"string_expression1".
Sintaxis
right ( string_expression1 , numeric_expression )
rpad
Devuelve "string_expression1" que se ha rellenado por la derecha hasta la longitud
"integer_expression" con apariciones de "string_expression2". Si
"string_expression1" tiene una longitud superior a "integer_expression", se
devuelve la parte apropiada de "string_expression1". Si "string_expression2" no se
especifica, se utilizan espacios.
Sintaxis
rpad ( string_expression1 , integer_expression [ , string_expression2
])
476 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

trim
Devuelve "string_expression1", donde se han eliminado los caracteres finales
después del último carácter que no se encuentra en "string_expression2"; por
ejemplo, rtrim ( 'ABxXxyx' , 'xy' ) devuelve ABxX. Si "string_expression2" no se
especifica, se eliminan los caracteres de espacio finales.
Sintaxis
rtrim ( string_expression1 [ , string_expression2 ] )
soundex
Devuelve una cadena soundex de "string_expression1".
Sintaxis
soundex ( string_expression1 )
Funciones matemáticas de MySQL
log
Devuelve el logaritmo en base 10 de "numeric_expression1" o el logaritmo en base
"numeric_expression2".
Sintaxis
log ( numeric_expression )
ln
Devuelve el logaritmo natural de "numeric_expression1".
Sintaxis
ln ( numeric_expression )
pi
Devuelve la constante pi.
Sintaxis
pi ()
Funciones trigonométricas de MySQL
acos
Devuelve el arcocoseno de "numeric_expression" en radianes. El arcocoseno es el
ángulo cuyo coseno es "numeric_expression".
Sintaxis
acos ( numeric_expression )
asin
Devuelve el arcoseno de "numeric_expression" en radianes. El arcoseno es el
ángulo cuyo seno es "numeric_expression".
Sintaxis
asin ( numeric_expression )
atan
Devuelve la arcotangente de "numeric_expression" en radianes. La arcotangente es
el ángulo cuya tangente es "numeric_expression".
Apéndice C. Uso del editor de expresiones 477

Sintaxis
atan ( numeric_expression )
atan2
Devuelve la arcotangente de las coordenadas xeyespecificadas por
"numeric_expression1" y "numeric_expression2", respectivamente, en radianes. La
arcotangente es el ángulo cuya tangente es "numeric_expression2" /
"numeric_expression1".
Sintaxis
atan2 ( numeric_expression1 ,numeric_expression2 )
cos
Devuelve el coseno de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
Sintaxis
cos ( numeric_expression )
cot
Devuelve la cotangente de "numeric_expression", donde "numeric_expression" es
un ángulo expresado en radianes.
Sintaxis
cot ( numeric_expression )
degrees
Devuelve los grados, donde "numeric_expression" es un ángulo expresado en
radianes.
Sintaxis
degrees ( numeric_expression )
radians
Devuelve los radianes, donde "numeric_expression" es un ángulo expresado en
grados.
Sintaxis
radians ( numeric_expression )
sin
Devuelve el seno de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
Sintaxis
sin ( numeric_expression )
tan
Devuelve la tangente de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
Sintaxis
tan ( numeric_expression )
478 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Netezza
ascii
Devuelve un número que representa el valor del código ascii del carácter que se
encuentra más a la izquierda de "string_expression"; por ejemplo, ascii ( 'A' )
devuelve 65.
Sintaxis
ascii ( string_expression )
database
Devuelve el nombre de la base de datos actual
Sintaxis
database ()
esquema
Devuelve el nombre del esquema actual
Sintaxis
schema ()
session_user
Devuelve el nombre de usuario devuelto por el cliente.
Sintaxis
session_user ()
system_user
Devuelve el nombre de usuario devuelto por el cliente.
Sintaxis
system_user ()
version
Devuelve el valor de cadena de la versión de la base de datos.
Sintaxis
version ()
Funciones matemáticas de Netezza
log
Devuelve el logaritmo de "expresión_numérica2" en base "expresión_numérica1".
Cuando no se especifica el argumento opcional "expresión_numérica1", se utiliza la
base 10.
Sintaxis
log ( [numeric_expression1 ,] numeric_expression2 )
Apéndice C. Uso del editor de expresiones 479

Funciones trigonométricas de Netezza
acos
Devuelve el arcocoseno de "numeric_expression" en radianes. El arcocoseno es el
ángulo cuyo coseno es "numeric_expression".
Sintaxis
acos ( numeric_expression )
asin
Devuelve el arcoseno de "numeric_expression" en radianes. El arcoseno es el
ángulo cuyo seno es "numeric_expression".
Sintaxis
asin ( numeric_expression )
atan
Devuelve la arcotangente de "numeric_expression" en radianes. La arcotangente es
el ángulo cuya tangente es "numeric_expression".
Sintaxis
atan ( numeric_expression )
atan2
Devuelve la arcotangente de las coordenadas xeyespecificadas por
"numeric_expression1" y "numeric_expression2", respectivamente, en radianes. La
arcotangente es el ángulo cuya tangente es "numeric_expression2" /
"numeric_expression1".
Sintaxis
atan2 ( numeric_expression1 , numeric_expression2 )
cos
Devuelve el coseno de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
Sintaxis
cos ( numeric_expression )
degrees
Devuelve los grados, donde "numeric_expression" es un ángulo expresado en
radianes.
Sintaxis
degrees ( numeric_expression )
radians
Devuelve los radianes, donde "numeric_expression" es un ángulo expresado en
grados.
Sintaxis
radians ( numeric_expression )
480 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

sin
Devuelve el seno de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
Sintaxis
sin ( numeric_expression )
tan
Devuelve la tangente de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
Sintaxis
tan ( numeric_expression )
Netezza Fuzzy
le_dst
Devuelve un valor que indica las diferencias que existen entre dos cadenas de
entrada, cuyo cálculo se realiza de acuerdo con el algoritmo de distancia de edición
de Levenshtein.
Sintaxis
le_dst ( string_expression1 , string_expression2 )
dle_dst
Devuelve un valor que indica las diferencias que existen entre dos cadenas de
entrada, cuyo cálculo se realiza de acuerdo con el algoritmo de distancia de
Damerau-Levenshtein.
Sintaxis
dle_dst ( string_expression1 , string_expression2 )
Funciones fonéticas de Netezza
nysiis
Devuelve una representación de Soundex de "string_expression" mediante el uso
de la variación New York State Identification and Intelligence System (NYSIIS) de
Soundex.
Sintaxis
nysiis ( string_expression )
dbl_mp
Devuelve un valor de 32 bits compuesto de "string_expression".
Sintaxis
dbl_mp ( string_expression )
pri_mp
Devuelve la cadena metáfona primaria de cuatro caracteres de
"numeric_expression" devuelta por dbl_mp.
Sintaxis
pri_mp ( numeric_expression )
Apéndice C. Uso del editor de expresiones 481

ascii
chr
sec_mp
Devuelve la cadena metáfona secundaria de cuatro caracteres de
"numeric_expression" devuelta por dbl_mp.
Sintaxis
sec_mp ( numeric_expression )
score_mp
Devuelve una puntuación que representa el grado de coincidencia entre
"numeric_expression" y "numeric_expression2".
Sintaxis
score_mp ( numeric_expression , numeric_expression2 ,
numeric_expression3 , numeric_expression4 , numeric_expression5 ,
numeric_expression6 )
Devuelve un número que representa el valor del código ascii del carácter que se
encuentra más a la izquierda de "string_expression"; por ejemplo, ascii ( 'A' )
devuelve 65.
Sintaxis
ascii ( string_expression )
Devuelve el carácter que tiene el valor del código ASCII especificado por
"integer_expression". "Integer_expression" debe estar entre 0 y 255.
Sintaxis
chr ( integer_expression )
decode
Compara "expr" con cada uno de los valores de la búsqueda, uno a uno. Si "expr"
coincide con una búsqueda, se devuelve el resultado correspondiente. Si no se
encuentra ninguna coincidencia, devuelve "default". Si se omite "default", devuelve
un valor nulo.
Sintaxis
decode ( expr , search , result [ , search , result]... [ , default] )
initcap
Devuelve "string_expression", con la primera letra de cada palabra en mayúsculas
y todas las demás letras en minúsculas. Las palabras están delimitadas por un
espacio en blanco o caracteres que no son alfanuméricos.
instr
Sintaxis
initcap ( string_expression )
Realiza una búsqueda en "string_expression1" a partir de la posición
"integer_expression1" para localizar la aparición "integer_expression2" de
"string_expression2". Si "integer_expression1" es un valor negativo, la búsqueda se
482 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

lpad
ltrim
realiza hacia atrás, desde el final de "string_expression1". Devuelve un entero que
indica la posición de "string_expression2".
Sintaxis
instr ( string_expression1 , string_expression2 [ ,
integer_expression1 [ , integer_expression2 ]])
Devuelve "string_expression1" que se ha rellenado hasta la longitud indicada en
"integer_expression" con apariciones de "string_expression2". Si
"string_expression1" tiene una longitud superior a "integer_expression", se
devuelve la parte apropiada de "string_expression1".
Sintaxis
lpad ( string_expression1 , integer_expression [ , string_expression2
])
Devuelve "string_expression1", donde se han eliminado los caracteres iniciales
hasta el primer carácter que no se encuentra en "string_expression2"; por ejemplo,
ltrim ( 'xyxXxyAB' , 'xy' ) devuelve XxyAB.
Sintaxis
ltrim ( string_expression1 [ , string_expression2 ] )
months_between
Devuelve el número de meses desde "date_expression1" hasta "date_expression2".
Si "date_expression1" es posterior a "date_expression2", el resultado será un
número positivo. Se ignoran las partes de día y hora de la diferencia, es decir, los
meses no se redondean, excepto si "date_expression1" y "date_expression2" son los
últimos días de un mes.
Sintaxis
months_between ( date_expression1 , date_expression2 )
next_day
Devuelve la fecha y hora del primer día de la semana designado en
"string_expression" que es posterior a "datetime_expression". El valor devuelto
contiene las mismas horas, minutos y segundos que "datetime_expression".
nvl
Sintaxis
next_day ( datetime_expression , string_expression )
Devuelve el valor de "expression1" si "expression1" no es NULL. Si "expression1"
es NULL, entonces devuelve el valor de "expression2".
Sintaxis
nvl ( expression1 , expression2 )
Ejemplo
nvl ( [Unit sale price] ,0)
Apéndice C. Uso del editor de expresiones 483

ound
rpad
rtrim
Resultado
Devuelve el precio de venta unitario, o devuelve 0 si el precio de venta unitario es
NULL.
Devuelve "numeric_expression" redondeado al valor más cercano
"integer_expression" posiciones a la derecha del separador decimal. Si el valor de
"integer_expression" es negativo, el valor de "numeric_expression" se redondea al
número de dígitos indicado por el valor absoluto más cercano de
"integer_expression" a la izquierda del separador decimal; por ejemplo, round (125,
-1) se redondea a 130.
Sintaxis
round ( numeric_expression [ , integer_expression ] )
Devuelve "string_expression1" que se ha rellenado por la derecha hasta la longitud
"integer_expression" con apariciones de "string_expression2". Si
"string_expression1" tiene una longitud superior a "integer_expression", se
devuelve la parte apropiada de "string_expression1". Si "string_expression2" no se
especifica, se utilizan espacios.
Sintaxis
rpad ( string_expression1 , integer_expression [ , string_expression2
])
Devuelve "string_expression1", donde se han eliminado los caracteres finales
después del último carácter que no se encuentra en "string_expression2"; por
ejemplo, rtrim ( 'ABxXxyx' , 'xy' ) devuelve ABxX. Si "string_expression2" no se
especifica, se eliminan los caracteres de espacio finales.
Sintaxis
rtrim ( string_expression1 [ , string_expression2 ] )
substr
Devuelve la subcadena de "string_expression" que comienza en la posición
indicada por "integer_expression1". El primer carácter de "string_expression" se
corresponde con la posición 1. Se puede utilizar la variable "integer_expression2"
para seleccionar menos caracteres; de forma predeterminada, se seleccionan los
caracteres hasta el final de la cadena.
Sintaxis
substr ( string_expression , integer_expression1 [ ,
integer_expression2 ] )
{current_db}
Sintaxis
{current_db}
484 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

{current_user}
Sintaxis
{current_user}
{session_user}
Sintaxis
{session_user}
to_char
Devuelve la representación en forma de cadena de "expression" con el formato de
"string_expression". "Expression" puede ser un valor de fecha o un valor numérico.
Sintaxis
to_char ( expression [ , string_expression ] )
to_date
Convierte "string_expression1" en un valor de fecha y hora, según especifica el
formato "string_expression2".
Sintaxis
to_date ( string_expression1 , string_expression2 )
to_number
Convierte "string_expression1" en un valor numérico, según especifica el formato
"string_expression2".
Sintaxis
to_number ( string_expression1 , string_expression2 )
translate
Devuelve "string_expression1", donde todas las apariciones de cada carácter
incluido en "string_expression2" se han sustituido por el carácter correspondiente
de "string_expression3".
Sintaxis
translate ( string_expression1 , string_expression2 ,
string_expression3 )
date_trunc
Trunca "date_expression1" a un valor con el formato especificado por
"string_expression1".
trunc
Sintaxis
date_trunc ( string_expression1 , date_expression1 )
Trunca los dígitos de "numeric_expression1" utilizando "numeric_expression2"
como precisión.
Sintaxis
trunc ( numeric_expression1 [ , numeric_expression2 ] )
Apéndice C. Uso del editor de expresiones 485

Oracle
version
Devuelve el valor "string_expression1" de la versión de la base de datos.
Sintaxis
version ()
Funciones matemáticas de Oracle
log
Devuelve el logaritmo de "expresión_numérica2" en base "expresión_numérica1".
Cuando no se especifica el argumento opcional "expresión_numérica1", la base
utilizada es la constante e (que es aproximadamente igual a 2,71282).
Sintaxis
log ([ numeric_expression1 , ] numeric_expression2 )
Funciones trigonométricas de Oracle
acos
Devuelve el arcocoseno de "numeric_expression" en radianes. El arcocoseno es el
ángulo cuyo coseno es "numeric_expression".
Sintaxis
acos ( numeric_expression )
asin
Devuelve el arcoseno de "numeric_expression" en radianes. El arcoseno es el
ángulo cuyo seno es "numeric_expression".
Sintaxis
asin ( numeric_expression )
atan
Devuelve la arcotangente de "numeric_expression" en radianes. La arcotangente es
el ángulo cuya tangente es "numeric_expression".
Sintaxis
atan ( numeric_expression )
atan2
Devuelve la arcotangente de las coordenadas xeyespecificadas por
"numeric_expression1" y "numeric_expression2", respectivamente, en radianes. La
arcotangente es el ángulo cuya tangente es "numeric_expression2" /
"numeric_expression1".
Sintaxis
atan2 ( numeric_expression1 ,numeric_expression2 )
cos
Devuelve el coseno de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
486 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Sintaxis
cos ( numeric_expression )
cosh
Devuelve el coseno hiperbólico de "numeric_expression", donde
"numeric_expression" es un ángulo expresado en radianes.
Sintaxis
cosh ( numeric_expression )
sin
Devuelve el seno de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
Sintaxis
sin ( numeric_expression )
sinh
Devuelve el seno hiperbólico de "numeric_expression", donde
"numeric_expression" es un ángulo expresado en radianes.
Sintaxis
sinh ( numeric_expression )
tan
Devuelve la tangente de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
Sintaxis
tan ( numeric_expression )
tanh
Devuelve la tangente hiperbólica de "numeric_expression", donde
"numeric_expression" es un ángulo expresado en radianes.
Sintaxis
tanh ( numeric_expression )
add_months
Devuelve la fecha y hora que resulta de añadir los meses de "integer_expression" a
"date_expression".
ascii
Sintaxis
add_months ( date_expression , integer_expression )
Devuelve un número que representa el valor de código ASCII del carácter que se
encuentra más a la izquierda de "string_expression".
Sintaxis
ascii ( string_expression )
Ejemplo
ascii ( ’A’ )
Apéndice C. Uso del editor de expresiones 487

ceil
Resultado
Devuelve '65'.
Devuelve el entero más pequeño igual o mayor que "numeric_expression".
Sintaxis
ceil ( numeric_expression )
char_length
Devuelve el número de caracteres lógicos de "string_expression". El número de
caracteres lógicos puede ser distinto del número de bytes en algunos entornos
locales de Asia Oriental.
chr
Sintaxis
char_length ( string_expression )
Devuelve el carácter que tiene el valor del código ASCII especificado por
"integer_expression". "Integer_expression" debe estar entre 0 y 255.
Sintaxis
chr ( integer_expression )
concat
Devuelve una cadena que es el resultado de concatenar, o unir,
"string_expression1" con "string_expression2".
Sintaxis
concat ( string_expression1 , string_expression2 )
Ejemplo
concat ( [Sales (query)].[Sales staff].[First name], [Sales (query)].
[Sales staff].[Last name] )
Resultado
Devuelve el nombre y el apellido; por ejemplo, Roberto Rodríguez.
decode
Compara "expression" con cada uno de los valores de la búsqueda, uno a uno. Si
"expression" coincide con una búsqueda, se devuelve el resultado correspondiente.
Si no se encuentra ninguna coincidencia, devuelve "default" o, si se omite "default",
devuelve un valor nulo.
Sintaxis
decode ( expression , search , result [ , search , result ]... [ ,
default ] )
488 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

dump
Devuelve la representación interna de "expression" con el formato de
"numeric_expression1" desde la posición "numeric_expression2" para los caracteres
de "numeric_expression3".
Sintaxis
dump ( expression [ , numeric_expression1 [ , numeric_expression2 [ ,
numeric_expression3 ]]])
greatest
Devuelve el valor más alto de "expression_list".
Sintaxis
greatest ( expression_list )
initcap
Devuelve "string_expression" con la primera letra de cada palabra en mayúsculas y
todas las demás letras en minúsculas. Las palabras están delimitadas por un
espacio en blanco o caracteres que no son alfanuméricos.
instr
instrb
least
Sintaxis
initcap ( string_expression )
Realiza una búsqueda en "string_expression1" a partir de la posición
"integer_expression1" para localizar la aparición "integer_expression2" de
"string_expression2". Si "integer_expression1" es un valor negativo, la búsqueda se
realiza hacia atrás, desde el final de "string_expression1". Devuelve un entero que
indica la posición de "string_expression2".
Sintaxis
instr ( string_expression1, string_expression2 [ ,
integer_expression1 [ , integer_expression2 ]])
Realiza una búsqueda en "string_expression1" a partir de la posición
"integer_expression1" para localizar la aparición "integer_expression2" de
"string_expression2". Si "integer_expression1" es un valor negativo, la búsqueda se
realiza hacia atrás, desde el final de "string_expression1". Devuelve la posición
(número de byte) en la que se ha encontrado "string_expression2".
Sintaxis
instrb ( string_expression1, string_expression2 [ ,
integer_expression1 [ , integer_expression2 ]])
Devuelve el valor más bajo de "expression_list".
Sintaxis
least ( expression_list )
Apéndice C. Uso del editor de expresiones 489

length
Devuelve el número de caracteres de "string_expression".
Sintaxis
length ( string_expression )
lengthb
Devuelve el número de bytes de "string_expression".
lpad
ltrim
Sintaxis
lengthb ( string_expression )
Devuelve "string_expression1" rellenada por la izquierda, hasta la longitud definida
en "integer_expression", con apariciones de "string_expression2". Si
"string_expression1" tiene una longitud superior a "integer_expression", se
devuelve la parte apropiada de "string_expression1".
Sintaxis
lpad ( string_expression1, integer_expression [ ,
string_expression2 ] )
Devuelve "string_expression1", de la que se eliminan los caracteres iniciales hasta
el primer carácter que no aparece en "string_expression2".
Sintaxis
ltrim ( string_expression1 [ , string_expression2 ] )
Ejemplo
ltrim ( ’xyxXxyAB’ , ’xy’ )
Resultado
XxyAB
months_between
Devuelve el número de meses desde "date_expression1" hasta "date_expression2".
Si "date_expression1" es posterior a "date_expression2", el resultado será un
número positivo. La parte del día y la hora de la diferencia se ignora, por lo tanto,
los meses no se redondean a menos que "date_expression1" y "date_expression2"
sean los últimos días de un mes.
Sintaxis
months_between ( date_expression1 , date_expression2 )
new_time
Devuelve la fecha y la hora en el huso horario "new_timezone" para
"datetime_expression" en el huso horario "old_timezone". Las variables
"old_timezone" y "new_timezone" pueden tener uno de los siguientes valores:
'AST', 'ADT', 'BST', 'BDT', 'CST', 'CDT', 'EST', 'EDT', 'HST', 'HDT', 'MST', 'MDT',
'NST', 'PST', 'PDT', 'YST' o 'YDT'.
490 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Sintaxis
new_time ( datetime_expression , old_timezone , new_timezone )
next_day
Devuelve la fecha y hora del primer día de la semana designado en
"string_expression" que es posterior a "datetime_expression". El valor devuelto
tiene el mismo formato que "datetime_expression".
Sintaxis
next_day ( datetime_expression , string_expression )
nls_initcap
Devuelve "string_expression1" con la primera letra de cada palabra en mayúsculas
y todas las demás letras en minúsculas. Una palabra empieza después de cualquier
carácter que no sea una letra. Por lo tanto, además de un espacio en blanco, los
símbolos como las comas, los puntos y los dos puntos pueden iniciar una nueva
palabra. "String_expression2" especifica la secuencia de ordenación.
Sintaxis
nls_initcap ( string_expression1 [ , string_expression2 ] )
nls_lower
Devuelve "string_expression1" con todas las letras en minúsculas.
"String_expression2" especifica la secuencia de ordenación.
Sintaxis
nls_lower ( string_expression1 [ , string_expression2 ] )
nls_upper
Devuelve "string_expression1" con todas las letras en mayúsculas.
"String_expression2" especifica la secuencia de ordenación.
nvl
Sintaxis
nls_upper ( string_expression1 [ , string_expression2 ] )
Devuelve el valor de "expression1" si "expression1" no es NULL. Si "expression1"
es NULL, entonces devuelve el valor de "expression2".
Sintaxis
nvl ( expression1 , expression2 )
Ejemplo
nvl ( [Unit sale price] ,0)
Resultado
Devuelve el precio de venta unitario, o devuelve 0 si el precio de venta unitario es
NULL.
Apéndice C. Uso del editor de expresiones 491

eplace
Sustituye todas las apariciones de "string_expression2" en "string_expression1" por
"string_expression3". Si no se especifica "string_expression3", se eliminan todas las
apariciones de "string_expression2".
round
rpad
rtrim
Sintaxis
replace ( string_expression1 , string_expression2 [ ,
string_expression3 ] )
Devuelve "numeric_expression" redondeado al valor más cercano
"integer_expression" posiciones a la derecha del separador decimal. Si el valor de
"integer_expression" es negativo, "numeric_expression" se redondea al número de
posiciones indicado por el valor absoluto más cercano de "integer_expression" a la
izquierda del separador decimal. El redondeo tiene lugar antes de formatear los
datos.
Sintaxis
round ( numeric_expression [ , integer_expression ] )
Ejemplo
round ( 125 , -1 )
Resultado
Devuelve 130
Devuelve "string_expression1" que se ha rellenado por la derecha hasta la longitud
"integer_expression" con apariciones de "string_expression2". Si
"string_expression1" tiene una longitud superior a "integer_expression", se
devuelve la parte apropiada de "string_expression1". Si no se especifica
"string_expression2", las apariciones de "string_expression2" se sustituyen por
espacios.
Sintaxis
rpad ( string_expression1 , integer_expression [ ,
string_expression2 ] )
Devuelve "string_expression1", de la que se han eliminado los caracteres finales
posteriores al último carácter que no aparece en "string_expression2". Si
"string_expression2" no se especifica, se eliminan los caracteres de espacio finales.
Sintaxis
rtrim ( string_expression1 [ , string_expression2 ] )
Ejemplo
rtrim ( ’ABxXxyx’ , ’xy’ )
Resultado
Devuelve 'ABxX'
492 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

sign
Devuelve un indicador del signo de "numeric_expression": +1 si es positiva, 0 si es
cero o -1 si es negativa.
Sintaxis
sign ( numeric_expression )
soundex
Devuelve una cadena de caracteres que contiene la representación fonética de
"string_expression".
Sintaxis
soundex ( string_expression )
substr
Devuelve la subcadena de "string_expression" que comienza en la posición
indicada por "integer_expression1" y tiene una longitud de "integer_expression2"
caracteres o hasta el final de "string_expression" si se omite "integer_expression2".
El primer carácter de "string_expression" se encuentra en la posición 1.
Sintaxis
substr ( string_expression , integer_expression1 [ ,
integer_expression2 ] )
Ejemplo
substr ( [Sales (query)].[Sales staff].[Position code], 3,5)
Resultado
Devuelve los caracteres del 3 al 7 de los códigos de cargo.
substrb
Devuelve la subcadena de "string_expression" que comienza en la posición
indicada por "numeric_expression1" y acaba después del número de bytes
indicados por "numeric_expression2". El primer byte de "string_expression" se
corresponde con la posición 1. Si omite "numeric_expression2", devuelve la
subcadena de "string_expression" que comienza en la posición indicada por
"numeric_expression1" y acaba al final de "string_expression".
Sintaxis
substrb ( string_expression , numeric_expression1 [ ,
numeric_expression2 ] )
Ejemplo
substrb ( [Sales (query)].[Sales staff].[Position code], 3,5)
Resultado
Devuelve los caracteres del 3 al 7 de los códigos de cargo.
{sysdate}
Devuelve un valor de fecha y hora que representa la fecha y hora actual del
sistema en el que se ejecuta el software de bases de datos.
Apéndice C. Uso del editor de expresiones 493

Sintaxis
{ sysdate }
to_char
Devuelve la representación en forma de cadena de "expression" con el formato de
"string_expression". "Expression" puede ser un valor de fecha o un valor numérico.
Sintaxis
to_char ( expression [ , string_expression ] )
to_date
Convierte "string_expression1" en un valor de fecha y hora, según especifica el
formato "string_expression2". "String_expression3" especifica los elementos de
formato, como el idioma.
Sintaxis
to_date ( string_expression1 [ , string_expression2 [ ,
string_expression3 ]])
to_number
Convierte "string_expression1" en un valor numérico, según especifica el formato
"string_expression2". "String_expression3" especifica los elementos de formato,
como la información de la moneda.
Sintaxis
to_number ( string_expression1 , string_expression2 ,
string_expression3 )
translate
Devuelve "string_expression1", donde todas las apariciones de cada carácter de
"string_expression2" se han sustituido por el carácter correspondiente de
"string_expression3".
trunc
Sintaxis
translate ( string_expression1 , string_expression2 ,
string_expression3 )
Trunca "date_expression" según el formato especificado por "string_expression".
Por ejemplo, si "string_expression" es 'year', "date_expression" se trunca hasta el
primer día del año.
Sintaxis
trunc ( date_expression , string_expression )
Ejemplo
trunc ( 2003-08-22 , ’year’ )
Resultado
Devuelve 2003-01-01.
494 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Paraccel
trunc
{user}
vsize
Trunca los dígitos de "numeric_expression1" utilizando "numeric_expression2"
como precisión.
Sintaxis
trunc ( numeric_expression1 , numeric_expression2 )
Devuelve el nombre de usuario de Oracle actual.
Sintaxis
{ user }
Devuelve el número de bytes de la representación interna de "expression".
"Expression" debe ser una expresión de cadena.
Sintaxis
vsize ( expression )
Cadena de Paraccel
overlay
Devuelve la "string_expression1" que sustituye a "string_expression2" desde la
posición numeric_expression del carácter.
Sintaxis
overlay ( string_expression1 , string_expression2 ,
numeric_expression1 [ , numeric_expression2 ] )
ltrim
Devuelve "string_expression1", donde se han eliminado los caracteres iniciales
hasta el primer carácter que no se encuentra en "string_expression2"; por ejemplo,
ltrim ( 'xyxXxyAB' , 'xy' ) devuelve XxyAB.
Sintaxis
ltrim ( string_expression1 [ , string_expression2 ] )
replace
Devuelve "string_expression", después de haber sustituido "string_expression2" por
"string_expression3".
Sintaxis
replace ( string_expression , string_expression2 , string_expression3
)
rtrim
Devuelve "string_expression1", donde se han eliminado los caracteres finales
después del último carácter que no se encuentra en "string_expression2"; por
ejemplo, rtrim ( 'ABxXxyx' , 'xy' ) devuelve ABxX. Si "string_expression2" no se
especifica, se eliminan los caracteres de espacio finales.
Apéndice C. Uso del editor de expresiones 495

Sintaxis
rtrim ( string_expression1 [ , string_expression2 ] )
Formateo de tipo de datos de Paraccel
to_char
Devuelve la representación en forma de cadena de "expression" con el formato de
"string_expression". "Expression" puede ser un valor de fecha o un valor numérico.
Sintaxis
to_char ( expression , string_expression )
to_date
Convierte "string_expression1" en un valor de fecha, según especifica el formato
"string_expression2".
Sintaxis
to_date ( string_expression1 , string_expression2 )
to_number
Convierte "string_expression1" en un valor numérico, según especifica el formato
"string_expression2".
Sintaxis
to_number ( string_expression1 , string_expression2 )
Funciones matemáticas de Paraccel
cbrt
Devuelve la raíz cúbica de "numeric_expression1".
Sintaxis
cbrt ( numeric_expression )
pi
Devuelve la constante pi.
Sintaxis
pi ()
current_database
Devuelve el nombre de la base de datos actual.
Sintaxis
current_database ()
current_schema
Devuelve el nombre del esquema actual.
Sintaxis
current_schema ()
496 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Postgres
{current_user}
Sintaxis
{current_user}
{session_user}
Sintaxis
{session_user}
translate
Devuelve "string_expression1", donde todas las apariciones de cada carácter
incluido en "string_expression2" se han sustituido por el carácter correspondiente
de "string_expression3".
Sintaxis
translate ( string_expression1 , string_expression2 ,
string_expression3 )
version
Devuelve el valor de cadena de la versión de la base de datos.
Sintaxis
version ()
Cadena de Postgres
overlay
Devuelve la "string_expression1" que sustituye a "string_expression2" desde la
posición numeric_expression del carácter.
Sintaxis
overlay ( string_expression1 , string_expression2 ,
numeric_expression1 [ , numeric_expression2 ] )
btrim
Devuelve expresión_cadena1 después de eliminar la cadena de caracteres más larga
de "expresión_cadena2".
Sintaxis
btrim ( string_expression1 [ , string_expression2 ] )
initcap
Devuelve "string_expression", con la primera letra de cada palabra en mayúsculas
y todas las demás letras en minúsculas. Las palabras están delimitadas por un
espacio en blanco o caracteres que no son alfanuméricos.
Sintaxis
initcap ( string_expression )
Apéndice C. Uso del editor de expresiones 497

lpad
Devuelve "string_expression1" que se ha rellenado hasta la longitud indicada en
"integer_expression" con apariciones de "string_expression2". Si
"string_expression1" tiene una longitud superior a "integer_expression", se
devuelve la parte apropiada de "string_expression1".
Sintaxis
lpad ( string_expression1 , integer_expression [ , string_expression2
])
ltrim
Devuelve "string_expression1", donde se han eliminado los caracteres iniciales
hasta el primer carácter que no se encuentra en "string_expression2"; por ejemplo,
ltrim ( 'xyxXxyAB' , 'xy' ) devuelve XxyAB.
Sintaxis
ltrim ( string_expression1 [ , string_expression2 ] )
md5
Devuelve el hash MD5 de "string_expression1".
Sintaxis
md5 ( string_expression1 )
to_hex
Devuelve la representación en forma de cadena hexadecimal de
"numeric_expression1".
Sintaxis
to_hex ( numeric_expression1 )
repeat
Devuelve "string_expression" repetida el número de veces indicado en
"numeric_expression1".
Sintaxis
repeat ( string_expression , numeric_expression1 )
replace
Devuelve "string_expression" con "string_expression2" sustituida por
"string_expression3".
Sintaxis
replace ( string_expression , string_expression2 , string_expression3)
rpad
Devuelve "string_expression1" que se ha rellenado por la derecha hasta la longitud
"integer_expression" con apariciones de "string_expression2". Si
"string_expression1" tiene una longitud superior a "integer_expression", se
devuelve la parte apropiada de "string_expression1". Si "string_expression2" no se
especifica, se utilizan espacios.
Sintaxis
rpad ( string_expression1 , integer_expression [ , string_expression2
])
498 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

trim
Devuelve "string_expression1", donde se han eliminado los caracteres finales
después del último carácter que no se encuentra en "string_expression2"; por
ejemplo, rtrim ( 'ABxXxyx' , 'xy' ) devuelve ABxX. Si "string_expression2" no se
especifica, se eliminan los caracteres de espacio finales.
Sintaxis
rtrim ( string_expression1 [ , string_expression2 ] )
split_part
Devuelve el campo "numeric_expression" después de haber dividido
"string_expression1" en "string_expression2".
Sintaxis
split_part ( string_expression1 , string_expression2 ,
numeric_expression )
Formateo de tipo de datos de Postgres
to_char
Devuelve la representación en forma de cadena de "expression" con el formato de
"string_expression". "Expression" puede ser un valor de fecha o un valor numérico.
Sintaxis
to_char ( expression , string_expression )
to_date
Convierte "string_expression1" en un valor de fecha, según especifica el formato
"string_expression2".
Sintaxis
to_date ( string_expression1 , string_expression2 )
to_number
Convierte "string_expression1" en un valor numérico, según especifica el formato
"string_expression2".
Sintaxis
to_number ( string_expression1 , string_expression2 )
to_timestamp
Convierte "string_expression1" en un valor de indicación de fecha y hora, según
especifica el formato "string_expression2". Sintaxis alternativa: to_timestamp
( expresión-numérica ) Convierte una hora de reloj de época Unix en un valor de
indicación de fecha y hora.
Sintaxis
to_timestamp ( string_expression1 , string_expression2 )
Funciones matemáticas de Postgres
log
Devuelve el logaritmo en base 10 de "numeric_expression1" o el logaritmo en base
"numeric_expression2".
Apéndice C. Uso del editor de expresiones 499

Sintaxis
log ( numeric_expression1 [ , numeric_expression2 ] )
ln
Devuelve el logaritmo natural de "numeric_expression1".
Sintaxis
ln ( numeric_expression )
cbrt
Devuelve la raíz cúbica de "numeric_expression1".
Sintaxis
cbrt ( numeric_expression )
div
Devuelve el cociente entero de "numeric_expression1" dividido entre
"numeric_expression2".
Sintaxis
div ( numeric_expression1 , numeric_expression2 )
pi
Devuelve la constante pi.
Sintaxis
pi ()
Funciones trigonométricas de Postgres
acos
Devuelve el arcocoseno de "numeric_expression" en radianes. El arcocoseno es el
ángulo cuyo coseno es "numeric_expression".
Sintaxis
acos ( numeric_expression )
asin
Devuelve el arcoseno de "numeric_expression" en radianes. El arcoseno es el
ángulo cuyo seno es "numeric_expression".
Sintaxis
asin ( numeric_expression )
atan
Devuelve la arcotangente de "numeric_expression" en radianes. La arcotangente es
el ángulo cuya tangente es "numeric_expression".
Sintaxis
atan ( numeric_expression )
500 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

ascii
atan2
Devuelve la arcotangente de las coordenadas xeyespecificadas por
"numeric_expression1" y "numeric_expression2", respectivamente, en radianes. La
arcotangente es el ángulo cuya tangente es "numeric_expression2" /
"numeric_expression1".
Sintaxis
atan2 ( numeric_expression1 , numeric_expression2 )
cos
Devuelve el coseno de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
Sintaxis
cos ( numeric_expression )
cot
Devuelve la cotangente de "numeric_expression", donde "numeric_expression" es
un ángulo expresado en radianes.
Sintaxis
cot ( numeric_expression )
degrees
Devuelve los grados, donde "numeric_expression" es un ángulo expresado en
radianes.
Sintaxis
degrees ( numeric_expression )
radians
Devuelve los radianes, donde "numeric_expression" es un ángulo expresado en
grados.
Sintaxis
radians ( numeric_expression )
sin
Devuelve el seno de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
Sintaxis
sin ( numeric_expression )
tan
Devuelve la tangente de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
Sintaxis
tan ( numeric_expression )
Devuelve un número que representa el valor del código ascii del carácter que se
encuentra más a la izquierda de "string_expression"; por ejemplo, ascii ( 'A' )
devuelve 65.
Apéndice C. Uso del editor de expresiones 501

chr
Sintaxis
ascii ( string_expression )
Devuelve el carácter que tiene el valor del código ASCII especificado por
"integer_expression". "Integer_expression" debe estar entre 0 y 255.
Sintaxis
chr ( integer_expression )
{current_db}
Sintaxis
current_database()
{current_catalog}
Sintaxis
{current_catalog}
{current_schema}
Sintaxis
{current_schema}
{current_user}
Sintaxis
{current_user}
{session_user}
Sintaxis
{session_user}
translate
Devuelve "string_expression1", donde todas las apariciones de cada carácter
incluido en "string_expression2" se han sustituido por el carácter correspondiente
de "string_expression3".
Sintaxis
translate ( string_expression1 , string_expression2 ,
string_expression3 )
date_trunc
Devuelve la indicación de fecha y hora a la precisión especificada.
Sintaxis
date_trunc ( string_expression , timestamp_expression )
version
Devuelve el valor de cadena de la versión de la base de datos.
Sintaxis
version ()
502 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Red Brick
ceil
Devuelve el entero más pequeño que sea igual o mayor que "numeric_expression"
o "string_expression". Tenga en cuenta que "string_expression" debe representar un
valor numérico válido.
Sintaxis
ceil ( numeric_expression|string_expression )
concat
Devuelve una cadena que es el resultado de concatenar, o unir,
"string_expression1" con "string_expression2".
Sintaxis
concat ( string_expression1 , string_expression2 )
Ejemplo
concat ( [Sales (query)].[Sales staff].[First name], [Sales (query)].
[Sales staff].[Last name] )
Resultado
Devuelve el nombre y el apellido; por ejemplo, Roberto Rodríguez.
{current_user}
Devuelve el nombre de usuario de la base de datos (identificador de autorización)
del usuario actual.
date
Sintaxis
{ current_user }
Devuelve un valor de fecha. "Expression" puede ser caracteres o una indicación de
fecha y hora.
Sintaxis
date ( expression )
dateadd
Añade "interval" a "datetime_expression" y devuelve un resultado que tiene el
mismo tipo de datos de fecha y hora que el de "datetime_expression". "Datepart"
hace referencia al año, mes, día, hora, minuto y segundo. "Interval" debe ser un
entero y "datetime_expression" puede ser una fecha, una hora o una indicación de
fecha y hora.
Sintaxis
dateadd ( { datepart } , interval, datetime_expression )
Apéndice C. Uso del editor de expresiones 503

datediff
Determina la diferencia entre dos expresiones de fecha y hora y devuelve un
resultado entero en las unidades de "datepart". "Datepart" hace referencia a un año,
mes, día, hora, minuto o segundo. "Datetime_expression1" y
"datetime_expression2" pueden ser fechas, horas o indicaciones de fecha y hora.
Sintaxis
datediff ( { datepart } , datetime_expression1, datetime_expression2 )
datename
Extrae "datepart" de "datetime_expression" y devuelve su valor como una cadena
de caracteres. "Datepart" hace referencia a un año, mes, día, hora, minuto o
segundo. "Datetime_expression" puede ser una fecha, una hora o una indicación de
fecha y hora.
dec
Sintaxis
datename ( { datepart } , datetime_expression )
Convierte "expression" en un valor decimal con el tipo de datos decimal (precisión,
escala). El valor de precisión predeterminado es 9. El valor de escala
predeterminado es 0.
Sintaxis
dec ( expression , [ precision , scale ] )
decimal
Convierte "expression" en un valor decimal con el tipo de datos decimal (precisión,
escala). El valor de precisión predeterminado es 9. El valor de escala
predeterminado es 0.
Sintaxis
decimal ( expression , [ precision , scale ] )
decode
Compara y convierte "expression" en otro valor. Si "expression" coincide con
"target", se sustituye; de lo contrario, se sustituye por "default" o por "null" si no se
especifica ningún valor predeterminado. Las expresiones pueden ser de cualquier
tipo de datos mientras todas sean del mismo tipo de datos.
float
Sintaxis
decode ( expression , target , replacement [ ,default ] )
Convierte "numeric_expression" en un valor de coma flotante de doble precisión.
Sintaxis
float ( numeric_expression )
504 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

ifnull
int
Comprueba si en "expression" faltan valores y los sustituye por "substitute". Si el
valor de "expression" es nulo, se devuelve "substitute"; de lo contrario, se devuelve
el valor de "expression". Las expresiones pueden ser de cualquier tipo de datos
mientras todas sean del mismo tipo de datos.
Sintaxis
ifnull ( expression, substitute )
Convierte "numeric_expression" en un valor entero y devuelve un valor entero. Si
el valor de "numeric_expression" es nulo, devuelve NULL.
Sintaxis
int ( numeric_expression )
integer
Convierte "numeric_expression" en un valor entero y devuelve un valor entero. Si
el valor de "numeric_expression" es nulo, devuelve NULL.
length
Sintaxis
integer ( numeric_expression )
Ejemplo
integer ( 84.95 )
Resultado
85
Devuelve un resultado entero que especifica el número de caracteres de
"string_expression". Si el valor de "string_expression" es nulo, devuelve NULL.
Sintaxis
length ( string_expression )
lengthb
Devuelve un resultado entero que especifica el número de bytes de
"string_expression". Si el valor de "string_expression" es nulo, devuelve NULL.
ltrim
Sintaxis
lengthb ( string_expression )
Elimina los espacios en blanco iniciales de "string_expression". Si el valor de
"string_expression" es nulo, devuelve NULL.
Sintaxis
ltrim ( string_expression )
Apéndice C. Uso del editor de expresiones 505

nullif
Devuelve NULL si tanto "expression1" como "expression2" tienen el mismo valor.
Si tienen valores distintos, se devuelve el valor de "expression1". "Expression1" y
"expression2" pueden tener cualquier tipo de datos, siempre y cuando ambas sean
del mismo tipo de datos.
Sintaxis
nullif ( expression1 , expression2 )
positionb
Devuelve un entero que está relacionado con la posición del byte de comienzo de
"string_expression1" en "string_expression2". Si no se encuentra
"string_expression1", el resultado es 0. Si "string_expression1" tiene una longitud
cero, el resultado es 1. Si el valor de "string_expression1" es nulo, se devuelve un
mensaje de error. Si el valor de "string_expression2" es nulo, el resultado es 0.
real
round
rtrim
Sintaxis
positionb ( string_expression1, string_expression2 )
Devuelve un valor real. Si el valor de "numeric_expression" es nulo, devuelve
NULL.
Sintaxis
real ( numeric_expression )
Devuelve "numeric_expression" redondeado al número de posiciones indicado por
el valor más cercano de "integer_expression" a la derecha del separador decimal. Si
el valor de "integer_expression" es negativo, "numeric_expression" se redondea al
número de posiciones indicado por el valor absoluto más cercano de
"integer_expression" a la izquierda del separador decimal. El redondeo tiene lugar
antes de formatear los datos.
Sintaxis
round ( numeric_expression , integer_expression )
Ejemplo
round (125, -1)
Resultado
130
Elimina los espacios en blanco finales de "string_expression". Si el valor de
"string_expression" es nulo, devuelve NULL.
Sintaxis
rtrim ( string_expression )
Ejemplo
506 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

sign
string
rtrim ( [Sales (query)].[Sales staff].[Last name] )
Resultado
Devuelve los apellidos sin espacios al final del nombre.
Determina el signo de "numeric_expression" y devuelve 1 si el valor es positivo, –1
si es negativo y0sielvalor es cero.
Sintaxis
sign ( numeric_expression )
Convierte "expression" en una cadena de caracteres. El valor de "expression" puede
ser numérico o de fecha y hora.
Sintaxis
string ( expression [ , length [ , scale ]])
substr
Devuelve una subcadena de "string_expression" que comienza en la posición
indicada por "start_integer" y continúa con el número de caracteres indicado en
"length_integer". Si el valor de "length_integer" no está especificado, se devuelve
una subcadena desde "start_integer" hasta el final de "string_expression".
Sintaxis
substr ( string_expression , start_integer , length_integer )
Ejemplo
substr ( [Sales (query)].[Sales staff].[Position code], 3,5)
Resultado
Devuelve los caracteres del 3 al 7 de los códigos de cargo.
substrb
Devuelve una subcadena de "string_expression" que comienza en la posición
indicada por "start_integer" y cuya longitud es "length_integer" bytes. Si el valor de
"length_integer" no está especificado, se devuelve una subcadena desde
"start_integer" hasta el final de "string_expression".
time
Sintaxis
substrb ( string_expression , start_integer , length_integer )
Crea un valor de hora a partir de "expression", que puede ser una cadena de
caracteres o una expresión de tipo de datos de marca de hora.
Sintaxis
time ( expression )
Apéndice C. Uso del editor de expresiones 507

SAP BW
timestamp
Crea un valor de marca de hora a partir de "timestamp_expression", que es una
cadena de caracteres.
Sintaxis
timestamp ( timestamp_expression )
timestamp
Crea un valor de marca de hora a partir de "time_expression" y "date_expression".
Si cualquiera de los valores "time_expression" o "date_expression" es nulo, la
expresión de marca de hora resultante también será nula.
Sintaxis
timestamp ( date_expression , time_expression )
to_char
Convierte "source_date" en la cadena de caracteres especificada en "format_string".
"Source_date" puede ser un tipo de datos de fecha, hora o indicación de fecha y
hora.
Sintaxis
to_char ( source_date, format_string )
Funciones trigonométricas de SAP BW
arccos
Devuelve el arcocoseno de "numeric_expression" en radianes. El arcocoseno es el
ángulo cuyo coseno es "numeric_expression".
Sintaxis
arccos ( numeric_expression )
arcsin
Devuelve el arcoseno de "numeric_expression" en radianes. El arcoseno es el
ángulo cuyo seno es "numeric_expression".
Sintaxis
arcsin ( numeric_expression )
arctan
Devuelve la arcotangente de "numeric_expression" en radianes. La arcotangente es
el ángulo cuya tangente es "numeric_expression".
Sintaxis
arctan ( numeric_expression )
cos
Devuelve el coseno de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
Sintaxis
508 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Salesforce.com
cos ( numeric_expression )
sin
Devuelve el seno de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
Sintaxis
sin ( numeric_expression )
tan
Devuelve la tangente de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
Sintaxis
tan ( numeric_expression )
coshyp
Devuelve el coseno hiperbólico de "numeric_expression", donde
"numeric_expression" es un ángulo expresado en radianes.
Sintaxis
coshyp ( numeric_expression )
sinhyp
Devuelve el seno hiperbólico de "numeric_expression", donde
"numeric_expression" es un ángulo expresado en radianes.
Sintaxis
sinhyp ( numeric_expression )
tanhyp
Devuelve la tangente hiperbólica de "numeric_expression", donde
"numeric_expression" es un ángulo expresado en radianes.
Sintaxis
tanhyp ( numeric_expression )
Funciones matemáticas de SAP BW
log10
Devuelve el logaritmo de base diez de "numeric_expression".
Sintaxis
log10 ( numeric_expression )
Funciones de fecha
CALENDAR_MONTH
Devuelve un número que representa el mes natural de "expresión_fecha".
Sintaxis
CALENDAR_MONTH ( date_expression )
Apéndice C. Uso del editor de expresiones 509

Ejemplo
CALENDAR_MONTH ( ’2012-02-29’ )
Resultado
2
CALENDAR_QUARTER
Devuelve un número que representa el trimestre natural de "expresión_fecha".
Sintaxis
CALENDAR_QUARTER ( date_expression )
Ejemplo
CALENDAR_QUARTER ( ’2012-02-29’ )
Resultado
1
CALENDAR_YEAR
Devuelve un número que representa el año natural de "expresión_fecha".
Sintaxis
CALENDAR_YEAR ( date_expression )
Ejemplo
CALENDAR_YEAR ( ’2012-02-29’ )
Resultado
2012
DAY_IN_MONTH
Devuelve un número que representa el día del mes de "expresión_fecha".
Sintaxis
DAY_IN_MONTH ( date_expression )
Ejemplo
DAY_IN_MONTH ( ’2012-02-29’ )
Resultado
29
DAY_IN_WEEK
Devuelve un número que representa el día de la semana para "expresión_fecha" 1
para domingo, 7 para sábado.
Sintaxis
DAY_IN_WEEK ( date_expression )
Ejemplo
DAY_IN_WEEK ( ’2012-02-29’ )
510 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Resultado
4 (miércoles)
DAY_IN_YEAR
Devuelve un número que representa el día del año de "expresión_fecha".
Sintaxis
DAY_IN_YEAR ( date_expression )
Ejemplo
DAY_IN_YEAR ( ’2012-02-29’ )
Resultado
60
DAY_ONLY
Devuelve una fecha que representa la parte del día de "expresión_fechayhora".
Sintaxis
DAY_ONLY ( dateTime_expression )
Ejemplo
DAY_ONLY ( ’2012-02-29T23:00:01Z’ )
Resultado
2012-02-29
FISCAL_MONTH
Devuelve un número que representa el mes fiscal de "expresión_fecha". Es distinto
de CALENDAR_MONTH() si su organización utiliza un año fiscal que no coincide
con el calendario gregoriano. Si su año fiscal comienza en marzo, 1 para marzo y
12 para febrero.
Sintaxis
FISCAL_MONTH ( date_expression )
Ejemplo
FISCAL_MONTH ( ’2012-02-29’ )
Resultado
12
FISCAL_QUARTER
Devuelve un número que representa el trimestre fiscal de "expresión_fecha". Es
distinto de CALENDAR_QUARTER() si su organización utiliza un año fiscal que
no coincide con el calendario gregoriano. Si su año fiscal comienza en julio, 1 para
15 de julio y 4 para 6 de junio.
Sintaxis
FISCAL_QUARTER ( date_expression )
Apéndice C. Uso del editor de expresiones 511

Ejemplo
FISCAL_QUARTER ( ’2012-02-29’ )
Resultado
3
FISCAL_YEAR
Devuelve un número que representa el año fiscal de "expresión_fecha". Es distinto
de CALENDAR_YEAR() si su organización utiliza un año fiscal que no coincide
con el calendario gregoriano.
Sintaxis
FISCAL_YEAR ( date_expression )
Ejemplo
FISCAL_YEAR ( ’2012-02-29’ )
Resultado
2012
HOUR_IN_DAY
Devuelve un número que representa la hora del día de "expresión_fechayhora".
Sintaxis
HOUR_IN_DAY ( dateTime_expression )
Ejemplo
HOUR_IN_DAY ( ’2012-02-29T23:00:01Z’ )
Resultado
23
WEEK_IN_MONTH
Devuelve un número que representa la semana del mes de "expresión_fecha". La
primera semana es del primer al séptimo día del mes
Sintaxis
WEEK_IN_MONTH ( date_expression )
Ejemplo
WEEK_IN_MONTH ( ’2012-02-29’ )
Resultado
5
WEEK_IN_YEAR
Devuelve un número que representa la semana natural de una "expresión_fecha".
La primera semana es del 1 de enero al 7 de enero
Sintaxis
WEEK_IN_YEAR ( date_expression )
512 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

SQL Server
Ejemplo
WEEK_IN_YEAR ( ’2012-02-29’ )
Resultado
9
convertCurrency
Convierte "expresión_numérica" a la moneda del usuario cuando está habilitada la
opción de varias monedas.
Sintaxis
convertCurrency ( numeric_expression )
convertTimezone
Convierte "expresión_fechayhora" al huso horario del usuario.
Sintaxis
convertTimezone ( dateTime_expression )
Funciones matemáticas de SQL Server
log
Devuelve el logaritmo natural de "numeric_expression".
Sintaxis
log ( numeric_expression )
log10
Devuelve el logaritmo de base diez de "numeric_expression".
Sintaxis
log10 ( numeric_expression )
pi
Devuelve el valor de la constante pi como valor de coma flotante.
Sintaxis
pi ()
rand
Genera un número aleatorio utilizando "integer_expression" como valor de origen.
Sintaxis
rand ( integer_expression )
Funciones trigonométricas de SQL Server
acos
Devuelve el arcocoseno de "numeric_expression" en radianes. El arcocoseno es el
ángulo cuyo coseno es "numeric_expression".
Apéndice C. Uso del editor de expresiones 513

Sintaxis
acos ( numeric_expression )
asin
Devuelve el arcoseno de "numeric_expression" en radianes. El arcoseno es el
ángulo cuyo seno es "numeric_expression".
Sintaxis
asin ( numeric_expression )
atan
Devuelve la arcotangente de "numeric_expression" en radianes. La arcotangente es
el ángulo cuya tangente es "numeric_expression".
Sintaxis
atan ( numeric_expression )
atn2
Devuelve la arcotangente de las coordenadas xeyespecificadas por
"numeric_expression1" y "numeric_expression2", respectivamente, en radianes. La
arcotangente es el ángulo cuya tangente es "numeric_expression1".
Sintaxis
atn2 ( numeric_expression1, numeric_expression2 )
cos
Devuelve el coseno de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
Sintaxis
cos ( numeric_expression )
cot
Devuelve la cotangente de "numeric_expression", donde "numeric_expression" es
un ángulo expresado en radianes.
Sintaxis
cot ( numeric_expression )
degrees
Devuelve "numeric_expression" radianes convertidos a grados.
Sintaxis
degrees ( numeric_expression )
radians
Devuelve el número de radianes convertidos desde los grados indicados en
"numeric_expression".
Sintaxis
radians ( numeric_expression )
sin
Devuelve el seno de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
514 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

ascii
char
Sintaxis
sin ( numeric_expression )
tan
Devuelve la tangente de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
Sintaxis
tan ( numeric_expression )
Devuelve un número que representa el valor de código ASCII del carácter que se
encuentra más a la izquierda de "string_expression".
Sintaxis
ascii ( string_expression )
Ejemplo
ascii ( ’A’ )
Resultado
65
Devuelve el carácter que tiene el valor del código ASCII especificado por
"integer_expression". "Integer_expression" debe estar entre 0 y 255.
Sintaxis
char ( integer_expression )
Ejemplo
char(65)
Resultado
A
charindex
Busca en "string_expression2" la primera aparición de "string_expression1" y
devuelve un entero. "Start_location" es la posición del carácter en la que debe
iniciarse la búsqueda de "string_expression1" en "string_expression2". Si
"start_location" no se especifica, es un número negativo o es cero, la búsqueda se
inicia al principio de "string_expression2".
Sintaxis
charindex ( string_expression1 , string_expression2 [ ,
start_location ] )
{current_user}
Devuelve el nombre del usuario actual.
Sintaxis
Apéndice C. Uso del editor de expresiones 515

{ current_user }
datalength
Devuelve la longitud en bytes de "string_expression".
Sintaxis
datalength ( string_expression )
dateadd
Devuelve la fecha que resulta de añadir "integer_expression" unidades (indicadas
mediante "datepart" (día, mes, año)) a "date_expression".
Sintaxis
dateadd ( { datepart } , integer_expression , date_expression )
datediff
Devuelve el número de unidades de "datepart" (día, mes, año) existente entre
"date_expression1" y "date_expression2".
Sintaxis
datediff ( {datepart} , date_expression1 , date_expression2 )
Ejemplo
datediff ( {yy} , 1984-01-01 , 1997-01-01 )
Resultado
13
datename
Devuelve el valor "datepart" de "date_expression", que puede ser un valor
datetime, smalldatetime, date o time, en forma de cadena ASCII. Tenga en cuenta
que "parte_fecha" debe ser una palabra clave que represente una parte de fecha o
su abreviatura reconocida por Microsoft ® SQL Server y debe estar entre llaves.
Sintaxis
datename (’{’datepart ’}’,date_expression )
Ejemplo
datename ( {mm} , 2000-01-01 )
Resultado
Enero
datepart
Devuelve parte de "date_expression" (por ejemplo, el mes) como entero.
"date_expression" puede ser un valor datetime, smalldatetime, date o time. Tenga
en cuenta que "parte_fecha" debe ser una palabra clave que represente una parte
de fecha o su abreviatura reconocida por Microsoft ® SQL Server y debe estar entre
llaves.
Sintaxis
516 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

day
datepart (’{’datepart ’}’,date_expression )
Ejemplo
datepart ( {wk} , 2000-01-01 )
Resultado
1 (la primera semana del año)
Devuelve la parte del día de "date_expression". Igual que extract (day from
date_expression).
Sintaxis
day ( date_expression )
difference
Devuelve un valor entero que representa la diferencia entre los valores devueltos
por la función soundex específica del origen de datos para "string_expression1" y
"string_expression2". El valor devuelto se encuentra en el rango de 0a4,donde 4
indica la mejor coincidencia. No obstante, el valor 4 no significa que las cadenas
sean idénticas.
Sintaxis
difference ( string_expression1 , string_expression2 )
Ejemplo 1
difference ([Sales target (query)].[Sales Staff].[First name],[Sales (
query)].[Retailers].[Contact first name])
Resultado
0
Ejemplo 2
difference ([Sales target (query)].[Sales Staff].[First name],[Sales
target (query)].[Sales Staff].[First name])
Resultado
4
getdate
Devuelve un valor de fecha y hora que representa la fecha y hora actual del
sistema en el que se ejecuta el software de bases de datos.
isnull
Sintaxis
getdate ()
Devuelve el primer argumento no nulo (o nulo si los dos argumentos son nulos).
Se recomienda utilizar la función COALESCE estándar de SQL en su lugar.
Apéndice C. Uso del editor de expresiones 517

left
ltrim
Sintaxis
isnull ( expression , expression )
Ejemplo
isnull ( [Sales (query)].[Sales Fact].[Sales quantity] ,0)
Resultado
Devuelve la cantidad de ventas si no es nula; en caso contrario, devuelve 0.
Devuelve los caracteres indicados por "integer_expression" más a la izquierda de
"string_expression".
Sintaxis
left ( string_expression , integer_expression )
Ejemplo
left ( [Sales (query)].[Sales staff].[Last name] ,3)
Resultado
Devuelve los tres primeros caracteres de cada apellido.
Devuelve "string_expression" sin espacios iniciales.
Sintaxis
ltrim ( string_expression )
month
Devuelve la parte del mes de "date_expression". Igual que extract (month from
date_expression).
Sintaxis
month ( date_expression )
patindex
Devuelve un entero que representa la posición inicial de la primera aparición de
"string_expression1" en "string_expression2". Devuelve 0 si "string_expression1" no
se encuentra. El carácter comodín % debe preceder y seguir a "string_expression1",
excepto cuando se busca el primer o el último carácter.
Sintaxis
patindex ( string_expression1 , string_expression2 )
Ejemplo
patindex ( ’%po%’, ’Report’ )
Resultado
3
518 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

eplace
Sustituye todas las apariciones de "string_expression2" en "string_expression1" por
"string_expression3".
Sintaxis
replace ( string_expression1 , string_expression2 ,
string_expression3 )
replicate
Devuelve una cadena que consta de "string_expression" repetida el número de
veces que "integer_expression" indica.
Sintaxis
replicate ( string_expression , integer_expression )
reverse
Devuelve "string_expression" en orden inverso.
right
round
rtrim
Sintaxis
reverse ( string_expression )
Devuelve los caracteres indicados por "integer_expression" más a la derecha de
"string_expression".
Sintaxis
right ( string_expression , integer_expression )
Devuelve "numeric_expression" redondeado al número de posiciones indicado por
el valor más cercano de "integer_expression" a la derecha del separador decimal. El
redondeo tiene lugar antes de formatear los datos.
Sintaxis
round ( numeric_expression , integer_expression )
Ejemplo
round (125, -1)
Resultado
130
Devuelve "string_expression" sin los espacios finales.
Sintaxis
rtrim ( string_expression )
Ejemplo
rtrim ( [Sales (query)].[Sales staff].[Last name] )
Apéndice C. Uso del editor de expresiones 519

sign
Resultado
Devuelve los apellidos sin espacios al final del nombre.
Devuelve un indicador del signo de "numeric_expression": +1 si
"numeric_expression" es positiva, 0 si es cero o -1 si es negativa.
Sintaxis
sign ( numeric_expression )
soundex
Devuelve una cadena de cuatro caracteres que representan el sonido de las
palabras de "string_expression".
space
str
stuff
year
Sintaxis
soundex ( string_expression )
Devuelve una cadena que consta de los espacios indicados en "integer_expression".
Sintaxis
space ( integer_expression )
Devuelve una representación en forma de cadena de "numeric_expression" donde
"integer_expression1" es la longitud de la cadena devuelta e "integer_expression2"
es el número de dígitos decimales.
Sintaxis
str ( numeric_expression [ , integer_expression1 [ ,
integer_expression2 ]])
Devuelve una cadena en la que los caracteres de "integer_expression2" se han
suprimido de "string_expression1" a partir del valor de "integer_expression1" y
donde "string_expression2" se ha insertado al principio de "string_expression1". El
primer carácter de una cadena se encuentra en la posición 1.
Sintaxis
stuff ( string_expression1 , integer_expression1 ,
integer_expression2 , string_expression2 )
Devuelve la parte de año de "date_expression". Igual que extract (year from
date_expression).
Sintaxis
year ( date_expression )
520 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Sybase
Funciones matemáticas de Sybase
log
Devuelve el logaritmo natural de "numeric_expression".
Sintaxis
log ( numeric_expression )
log10
Devuelve el logaritmo de base diez de "numeric_expression".
Sintaxis
log10 ( numeric_expression )
pi
Devuelve el valor de la constante pi como valor de coma flotante.
Sintaxis
pi ()
sign
Devuelve un indicador que representa el signo de "numeric_expression": +1 si
"numeric_expression" es positiva, 0 si es cero o -1 si es negativa.
Sintaxis
sign ( numeric_expression )
Funciones trigonométricas de Sybase
acos
Devuelve el arcocoseno de "numeric_expression" en radianes. El arcocoseno es el
ángulo cuyo coseno es "numeric_expression".
Sintaxis
acos ( numeric_expression )
asin
Devuelve el arcoseno de "numeric_expression" en radianes. El arcoseno es el
ángulo cuyo seno es "numeric_expression".
Sintaxis
asin ( numeric_expression )
atan
Devuelve la arcotangente de "numeric_expression" en radianes. La arcotangente es
el ángulo cuya tangente es "numeric_expression".
Sintaxis
atan ( numeric_expression )
Apéndice C. Uso del editor de expresiones 521

ascii
tan
Devuelve la tangente de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
Sintaxis
tan ( numeric_expression )
atn2
Devuelve el ángulo en radianes cuya tangente es "numeric_expression1"/
"numeric_expression2".
Sintaxis
atn2 ( numeric_expression1, numeric_expression2 )
cos
Devuelve el coseno de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
Sintaxis
cos ( numeric_expression )
cot
Devuelve la cotangente de "numeric_expression", donde "numeric_expression" es
un ángulo expresado en radianes.
Sintaxis
cot ( numeric_expression )
degrees
Devuelve "numeric_expression" radianes convertidos a grados.
Sintaxis
degrees ( numeric_expression )
radians
Devuelve el equivalente en grados de "numeric_expression". Los resultados son del
mismo tipo que "numeric_expression". Para las expresiones numéricas o decimales,
los resultados tienen una precisión interna de 77 y una escala igual a la de
"numeric_expression". Si se utiliza el tipo de datos de divisa, la conversión interna
a flotante puede causar una pérdida de precisión.
Sintaxis
radians ( numeric_expression )
sin
Devuelve el seno de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
Sintaxis
sin ( numeric_expression )
Devuelve un número que representa el valor de código ASCII del carácter que se
encuentra más a la izquierda de "string_expression".
522 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

char
Sintaxis
ascii ( string_expression )
Ejemplo
ascii ( ’A’ )
Resultado
65
Convierte el valor de "integer_expression" en un valor de carácter. Char suele
utilizarse como el inverso de ascii, donde "integer_expression" debe estar
comprendido entre 0 y 255. Si el valor resultante es el primer byte de un carácter
de varios bytes, puede que el carácter no esté definido.
Sintaxis
char ( integer_expression )
charindex
Devuelve un entero que representa la posición inicial de "string_expression1" en
"string_expression2". Devuelve cero si "string_expression1" no se encuentra. Si
"string_expression1" incluye caracteres comodín, charindex los trata como literales.
Sintaxis
charindex ( string_expression1 , string_expression2 )
datalength
Devuelve la longitud en bytes de "string_expression".
Sintaxis
datalength ( string_expression )
dateadd
Devuelve la fecha que resulta de añadir "integer_expression" unidades, indicadas
mediante datepart (día, mes, año), a "date_expression". Tenga en cuenta que
"datepart" debe especificarse entre llaves.
Sintaxis
dateadd (’{’datepart ’}’,integer_expression ,
date_expression )
Ejemplo
dateadd ( {dd} , 16 , 1997-06-16 )
Resultado
2 de julio de 1997
Apéndice C. Uso del editor de expresiones 523

datediff
Devuelve el número de unidades indicado mediante "datepart" (día, mes, año)
existente entre "date_expression1" y "date_expression2". Tenga en cuenta que
"datepart" debe especificarse entre llaves.
Sintaxis
datediff (’{’datepart ’}’,date_expression1 ,
date_expression2 )
Ejemplo
datediff ( {yy} , 1984-01-01 , 1997-01-01 )
Resultado
13
datename
Devuelve el valor de "datepart" de "date_expression" en forma de cadena ASCII.
"Date_expression" puede ser un valor datetime, smalldatetime, date o time. Tenga
en cuenta que "datepart" debe especificarse entre llaves.
Sintaxis
datename (’{’datepart ’}’,date_expression )
Ejemplo
datename ( {mm} , 1999-05-01 )
Resultado
Mayo
datepart
Devuelve el valor de "datepart" de "date_expression" en forma de entero.
"Date_expression" puede ser un valor datetime, smalldatetime, date o time. Tenga
en cuenta que el argumento datepart debe estar entre llaves.
day
Sintaxis
datepart (’{’datepart ’}’,date_expression )
Ejemplo
datepart ( {mm} , 1999-05-01 )
Resultado
5
Devuelve el día del mes (de 1 a 31) de "date_expression".
Sintaxis
day ( date_expression )
524 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

difference
Devuelve un valor entero que representa la diferencia entre los valores devueltos
por la función soundex específica del origen de datos para "string_expression1" y
"string_expression2". El valor que se devuelve está comprendido entre 0y4,donde
4 indica la mejor coincidencia. No obstante, el valor 4 no significa que las cadenas
sean idénticas.
Sintaxis
difference ( string_expression1 , string_expression2 )
Ejemplo 1
difference ([Sales target (query)].[Sales staff].[First name],[Sales (
query)].[Retailers].[Contact first name])
Resultado
0
Ejemplo 2
difference ([Sales target (query)].[Sales staff].[First name],[Sales
target (query)].[Sales staff].[First name])
Resultado
4
getdate
Devuelve la fecha y hora actuales del sistema.
left
ltrim
Sintaxis
getdate ()
Devuelve los caracteres indicados por "integer_expression" más a la izquierda de
"string_expression".
Sintaxis
left ( string_expression , integer_expression )
Ejemplo
left ( [Sales (query)].[Sales staff].[Last name] ,3)
Resultado
Devuelve los tres primeros caracteres de cada apellido.
Devuelve "string_expression" con los espacios iniciales eliminados.
Sintaxis
ltrim ( string_expression )
Apéndice C. Uso del editor de expresiones 525

month
Devuelve el número del mes (1-12) de "date_expression".
Sintaxis
month ( date_expression )
patindex
Devuelve un entero que representa la posición inicial de la primera aparición de
"string_expression1" en "string_expression2" o bien devuelve 0 si no se encuentra
"string_expression1". De manera predeterminada, patindex devuelve el
desplazamiento en caracteres. El desplazamiento se puede devolver en bytes si se
establece el tipo de devolución en bytes. El carácter comodín % debe preceder y
seguir el modelo de "string_expression1", excepto cuando se busca el primer o el
último carácter.
rand
Sintaxis
patindex ( string_expression1 , string_expression2 [ using
{bytes|chars|characters} ] )
Devuelve un valor flotante aleatorio entre 0y1,utilizando el valor
"integer_expression" opcional como valor de origen.
Sintaxis
rand ( integer_expression )
replicate
Devuelve una cadena con el mismo tipo de datos que "string_expression", que
contiene la misma expresión repetida "integer_expression" veces o tantas veces
como tenga cabida en un espacio de 225 bytes, el valor que sea menor.
Sintaxis
replicate ( string_expression , integer_expression )
reverse
Devuelve "string_expression" invertida.
right
round
Sintaxis
reverse ( string_expression )
Devuelve los caracteres indicados por "integer_expression" más a la derecha de
"string_expression".
Sintaxis
right ( string_expression , integer_expression )
Devuelve "numeric_expression" redondeado al número de posiciones indicado por
el valor más cercano de "integer_expression" a la derecha del separador decimal. El
redondeo tiene lugar antes de formatear los datos.
526 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

trim
Sintaxis
round ( numeric_expression, integer_expression )
Ejemplo
round (125, -1)
Resultado
130
Devuelve "string_expression" sin los espacios finales.
Sintaxis
rtrim ( string_expression )
Ejemplo
rtrim ( [Sales (query)].[Sales staff].[Last name] )
Resultado
Devuelve los apellidos sin espacios al final del nombre.
soundex
Devuelve un código soundex de cuatro caracteres para las cadenas de caracteres
compuestas por una secuencia continua de letras Roman de uno o dos bytes
válidas.
space
str
stuff
Sintaxis
soundex ( string_expression )
Devuelve una cadena con el espaciado de un solo byte que "integer_expression"
especifica.
Sintaxis
space ( integer_expression )
Devuelve la representación en forma de cadena de "numeric_expression".
"Integer_expression1" es la longitud de la cadena devuelta y su valor
predeterminado es 10. "Integer_expression2" es el número de dígitos decimales y
su valor predeterminado es 0. Ambos son valores opcionales.
Sintaxis
str ( numeric_expression [ , integer_expression1 [ ,
integer_expression2 ]])
Suprime los caracteres "integer_expression2" de "string_expression1" empezando en
"integer_expression1" e inserta "string_expression2" en "string_expression1" en esa
Apéndice C. Uso del editor de expresiones 527

posición. Para suprimir caracteres sin insertar otros, la variable "string_expression2"
debe ser NULL y no " ", que indica un solo espacio.
Sintaxis
stuff ( string_expression1 , integer_expression1 ,
integer_expression2 , string_expression2 )
substring
Devuelve la subcadena de "string_expression" que comienza en la posición
indicada por "integer_expression1". La variable "integer_expression2" especifica el
número de caracteres de la subcadena.
Sintaxis
substring ( string_expression , integer_expression1 ,
integer_expression2 )
Ejemplo
substring ( [Sales (query)].[Sales staff].[Position code], 3,5)
Resultado
Devuelve los caracteres del 3 al 7 de los códigos de cargo.
to_unichar
Devuelve una expresión de un solo carácter con el valor "integer_expression". Si
"integer_expression" es un valor comprendido dentro del rango 0xD800..0xDFFF, la
operación se anula. Si "integer_expression" es un valor comprendido dentro del
rango 0..0xFFFF, se devuelve un solo valor Unicode. Si "integer_expression" es un
valor comprendido dentro del rango 0x10000..0x10FFFF, se devuelve un par
suplente.
Sintaxis
to_unichar ( integer_expression )
uhighsurr
Devuelve 1 si el valor Unicode de "expresión_entero" es la mitad superior de un
par suplente (que debe aparecer en primer lugar en el par). De lo contrario,
devolverá 0. Esta función permite escribir un código explícito para la gestión
suplentes. En concreto, si una subcadena empieza en un carácter Unicode en el que
uhighsurr() es verdadero, extraiga una subcadena de al menos 2 valores Unicode,
ya que substr() no extrae solo 1. Substr() no extrae la mitad de un par suplente.
Sintaxis
uhighsurr ( string_expression , integer_expression )
ulowsurr
Devuelve 1 si el valor Unicode de "expresión_entero" es la mitad inferior de un par
suplente (que debe aparecer en segundo lugar en el par). De lo contrario, devuelve
0. Esta función permite codificar explícitamente los ajustes realizados por substr (),
stuff () y right (). En concreto, si una subcadena termina con un valor Unicode en
el que ulowsurr() es true, extraiga una subcadena de 1 carácter menos (o 1 más),
ya que substr() no extrae ninguna cadena que contenga un par suplente que no
coincida.
528 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Teradata
Sintaxis
ulowsurr ( string_expression , integer_expression )
uscalar
Devuelve el valor escalar Unicode para el primer carácter Unicode de
"string_expression". Si el primer carácter no es la mitad superior de un par
suplente, el valor estará en el rango 0..0xFFFF. Si el primer carácter es la mitad
superior de un par suplente, debe haber un segundo valor como mitad inferior y el
valor de retorno estará en el rango 0x10000..0x10FFFF. Si se llama a esta función en
una expresión de caracteres Unicode que contiene una mitad suplente no
coincidente, la operación se anulará.
year
Sintaxis
uscalar ( string_expression )
Devuelve el año de date_expression.
Sintaxis
year ( date_expression )
Funciones trigonométricas de Teradata
acos
Devuelve el arcocoseno de "numeric_expression" en radianes. El arcocoseno es el
ángulo cuyo coseno es "numeric_expression". El valor de "numeric_expression"
debe estar comprendido entre -1 y 1, ambos inclusive.
Sintaxis
acos ( numeric_expression )
acosh
Devuelve el coseno hiperbólico inverso de "numeric_expression", donde el valor de
"numeric_expression" puede ser cualquier número real igual o mayor que 1.
Sintaxis
acosh ( numeric_expression )
asin
Devuelve el arcoseno de "numeric_expression" en radianes. El arcoseno es el
ángulo cuyo seno es "numeric_expression". El valor de "numeric_expression" debe
estar comprendido entre -1 y 1, ambos inclusive.
Sintaxis
asin ( numeric_expression )
asinh
Devuelve el seno hiperbólico inverso de "numeric_expression", donde el valor de
"numeric_expression" puede ser cualquier número real.
Sintaxis
Apéndice C. Uso del editor de expresiones 529

asinh ( numeric_expression )
atan
Devuelve la arcotangente de "numeric_expression" en radianes, donde la
arcotangente es el ángulo cuya tangente es "numeric_expression".
Sintaxis
atan ( numeric_expression )
atan2
Devuelve la arcotangente de las coordenadas xeyespecificadas por
"numeric_expression1" y "numeric_expression2", respectivamente, en radianes. El
ángulo devuelto estará entre -ypradianes, excluyendo p.
Sintaxis
atan2 ( numeric_expression1, numeric_expression2 )
atanh
Devuelve la tangente hiperbólica inversa de "numeric_expression", donde el valor
de "numeric_expression" puede ser cualquier número real comprendido entre 1 y
-1 (excepto 1 y -1).
Sintaxis
atanh ( numeric_expression )
cos
Devuelve el coseno de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
Sintaxis
cos ( numeric_expression )
cosh
Devuelve el coseno hiperbólico de "numeric_expression", donde el valor de
"numeric_expression" puede ser cualquier número real.
Sintaxis
cosh ( numeric_expression )
sin
Devuelve el seno de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
Sintaxis
sin ( numeric_expression )
sinh
Devuelve el seno hiperbólico de "numeric_expression", donde el valor de
"numeric_expression" puede ser cualquier número real.
Sintaxis
sinh ( numeric_expression )
tan
Devuelve la tangente de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
530 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Sintaxis
tan ( numeric_expression )
tanh
Devuelve la tangente hiperbólica de "numeric_expression", donde el valor de
"numeric_expression" puede ser cualquier número real.
Sintaxis
tanh ( numeric_expression )
account
Devuelve la cadena de la cuenta del usuario actual.
Sintaxis
{account}
add_months
Devuelve la fecha o la fecha y hora que resulta de añadir los meses indicados por
"integer_expression" a "date_expression "o "datetime_expression".
bytes
Sintaxis
add_months ( date_expression|datetime_expression ,
integer_expression )
Devuelve el número de bytes contenido en "byte_expression". El valor de
"byte_expression" está restringido a BYTE o VARBYTE.
Sintaxis
bytes ( byte_expression )
case_n
Evalúa "condition_expression_list" y devuelve la posición de la primera condición
que se cumple (TRUE), siempre y cuando ninguna condición anterior de la lista se
evalúe como UNKNOWN. Las palabras clave deben incluirse entre llaves. NO
CASE es una condición opcional que se evalúa como TRUE si todas las expresiones
de la lista se evalúan como FALSE. NO CASE o UNKNOWN son condiciones
opcionales que se evalúan como TRUE si todas las expresiones de la lista se
evalúan como FALSE, o si una expresión se evalúa como UNKNOWN y todas las
condiciones anteriores de la lista se evalúan como FALSE. UNKNOWN es una
condición opcional que se evalúa como TRUE si una expresión se evalúa como
UNKNOWN y todas las condiciones anteriores de la lista se evalúan como FALSE.
Sintaxis
case_n ( condition_expression_list [,NOCASE|UNKNOWN|NO CASE OR
UNKNOWN [ , UNKNOWN ]])
char2hexint
Devuelve la representación hexadecimal de "string_expression".
Sintaxis
char2hexint ( string_expression )
Apéndice C. Uso del editor de expresiones 531

characters
Devuelve un valor entero que representa el número de bytes o caracteres lógicos
contenidos en "string_expression".
Sintaxis
characters ( string_expression )
database
Devuelve el nombre de la base de datos predeterminada del usuario actual.
date
Sintaxis
{database}
Devuelve la fecha actual.
Sintaxis
{date}
format
Devuelve el formato declarado de "expression" como cadena de caracteres variables
compuesta por un máximo de 30 caracteres.
index
log
nullif
Sintaxis
format ( expression )
Devuelve la posición inicial de "string_expression2" en "string_expression1".
Sintaxis
index ( string_expression1 , string_expression2 )
Calcula el logaritmo en base 10 de "numeric_expression". "Numeric_expression"
debe ser una expresión numérica positiva y distinta de cero.
Sintaxis
log ( numeric_expression )
Devuelve NULL si "scalar_expression1" y "scalar_expression2" son iguales. De lo
contrario, devuelve "scalar_expression1". El valor de "scalar_expression1" y de
"scalar_expression2" puede ser cualquier tipo de datos.
Sintaxis
nullif ( scalar_expression1 , scalar_expression2 )
nullifzero
Si "numeric_expression" es cero, convierte ésta en un valor nulo para evitar la
división por cero.
532 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Sintaxis
nullifzero ( numeric_expression )
profile
Devuelve el perfil actual de la sesión o NULL si no hay ninguno.
Sintaxis
{profile}
random
Devuelve un entero aleatorio para cada fila de la tabla de resultados.
"Lower_bound" y "upper_bound" son constantes de números enteros. Los límites
de "lower_bound" y "upper_bound" van de -2147483648 a 2147483647, ambos
inclusive. "Upper_bound" debe ser mayor o igual que "lower_bound".
role
Sintaxis
random ( lower_bound , upper_bound )
Devuelve el rol actual de la sesión o NULL si no hay ninguno.
Sintaxis
{role}
sesión
Devuelve el número de la sesión del usuario actual.
Sintaxis
{session}
soundex
Devuelve una cadena de caracteres que representa el código Soundex de
"string_expression".
Sintaxis
soundex ( string_expression )
substr
Devuelve la subcadena de "string_expression" que empieza en la posición indicada
por "integer_expression1" y tiene una longitud de "integer_expression2" caracteres.
El primer carácter de "string_expression" se corresponde con la posición 1. Si se
omite "numeric_expression2", devuelve la parte de "string_expression" que
comienza en la posición indicada por "integer_expression1" y acaba al final de
"string_expression".
Sintaxis
substr ( string_expression , integer_expression1 [ ,
integer_expression2 ] )
Ejemplo
substr ( [Sales (query)].[Sales staff].[Position code], 3,5)
Apéndice C. Uso del editor de expresiones 533

time
type
user
Vectorwise
Resultado
Devuelve los caracteres del 3 al 7 de los códigos de cargo.
Devuelve la hora actual según un día de 24 horas. De acuerdo con la
documentación de Teradata, la función de sistema TIME ha quedado en desuso. En
su lugar, utilice la función CURRENT_TIME. Tenga en cuenta que en modo
compatible TIME devuelve el tipo de datos de hora, mientras que en modo de
consulta dinámica, TIME devuelve un valor de tipo FLOAT.
Sintaxis
{time}
Devuelve el tipo de datos definido para "expression".
Sintaxis
type ( expression )
Devuelve el nombre de usuario del usuario actual.
Sintaxis
{user}
vargraphic
Devuelve una cadena de caracteres que representa el código vargraphic de
"string_expression".
Sintaxis
vargraphic ( string_expression )
zeroifnull
Convierte los datos NULL en 0 para que no se produzcan los errores que un valor
NULL crea. Si "numeric_expression" no es NULL, devuelve el valor de
"numeric_expression". Si "numeric_expression" es una cadena de caracteres, se
convierte en un valor numérico de tipo de datos FLOAT. Si el valor de
"numeric_expression" es NULL o cero, devuelve cero.
Sintaxis
zeroifnull ( numeric_expression )
Cadena de Vectorwise
lpad
Devuelve "string_exp1" que se ha rellenado hasta la longitud "integer_exp" con
apariciones de "string_exp2". Si "string_exp1" tiene una longitud superior a
"integer_exp", se devuelve la parte apropiada de "string_exp1".
534 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Sintaxis
lpad ( string_exp1, integer_exp [ , string_exp2 ] )
ltrim
Devuelve "exp_cadena1", con los caracteres en blanco iniciales eliminados.
Sintaxis
ltrim ( string_exp1 )
rtrim
Devuelve "exp_cadena1", con los caracteres en blanco finales eliminados.
Sintaxis
rtrim ( string_exp1 )
shift
Devuelve "exp_cadena1" con un desplazamiento de "exp_numérica" caracteres. Si
"exp_numérica" es mayor que cero, se producirá un desplazamiento hacia la
derecha; en caso contrario, se producirá un desplazamiento hacia la izquierda.
Sintaxis
shift ( string_exp1, numeric_exp )
soundex
Devuelve un código de cuatro caracteres para "exp_cadena1".
Sintaxis
soundex ( string_exp1 )
squeeze
Devuelve "exp_cadena1" con varios caracteres de espacio en blanco reducidos a un
solo carácter de espacio en blanco.
Sintaxis
squeeze ( string_exp1 )
Funciones matemáticas de Vectorwise
log
Devuelve el logaritmo en base 10 de "exp_numérica1".
Sintaxis
log ( numeric_exp1 )
ln
Devuelve el logaritmo natural de "numeric_exp1".
Sintaxis
ln ( numeric_exp )
pi
Devuelve la constante pi.
Sintaxis
pi( )
Apéndice C. Uso del editor de expresiones 535

Funciones trigonométricas de Vectorwise
acos
Devuelve el arcocoseno de "numeric_exp" en radianes. El arcocoseno es el ángulo
cuyo coseno es "numeric_exp".
Sintaxis
acos ( numeric_exp )
asin
Devuelve el arcoseno de "numeric_exp" en radianes. El arcoseno es el ángulo cuyo
seno es "numeric_exp".
Sintaxis
asin ( numeric_exp )
atan
Devuelve la arcotangente de "numeric_exp" en radianes. La arcotangente es el
ángulo cuya tangente es "numeric_exp".
Sintaxis
atan ( numeric_exp )
atan2
Devuelve la arcotangente de las coordenadas xeyespecificadas por
"numeric_exp1" y "numeric_exp2", respectivamente, en radianes. La arcotangente es
el ángulo cuya tangente es "numeric_exp2" / "numeric_exp1".
Sintaxis
atan2 ( numeric_exp1 ,numeric_exp2 )
cos
Devuelve el coseno de "exp_numérica", donde "exp_numérica" es un ángulo
expresado en radianes.
Sintaxis
cos ( numeric_exp )
sin
Devuelve el seno de "exp_numérica", donde "exp_numérica" es un ángulo
expresado en radianes.
Sintaxis
sin ( numeric_exp )
tan
Devuelve la tangente de "exp_numérica", donde "exp_numérica" es un ángulo
expresado en radianes.
Sintaxis
tan ( numeric_exp )
536 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Vertica
{initial_user}
Devuelve el nombre de usuario inicial.
Sintaxis
{ initial_user }
{session_user}
Devuelve el nombre de usuario de la sesión.
Sintaxis
{ session_user }
numeric_trunc
Devuelve exp_numérica1 truncada por la posición decimal o por "exp_numérica2"
dígitos a la izquierda o la derecha de la posición decimal.
Sintaxis
trunc ( numeric_exp1 , numeric_exp2 )
Vertica String
overlay
Devuelve la "string_expression1" que sustituye a "string_expression2" desde la
posición numeric_expression del carácter.
Sintaxis
overlay ( string_expression1 , string_expression2 ,
numeric_expression1 [ , numeric_expression2 ] )
btrim
Devuelve expresión_cadena1 después de eliminar la cadena de caracteres más larga
de expresión_cadena2.
Sintaxis
btrim ( string_expression1 [ , string_expression2 ] )
initcap
Devuelve "string_expression", con la primera letra de cada palabra en mayúsculas
y todas las demás letras en minúsculas. Las palabras están delimitadas por un
espacio en blanco o caracteres que no son alfanuméricos.
Sintaxis
initcap ( string_expression )
lpad
Devuelve "string_expression1" que se ha rellenado hasta la longitud indicada en
"integer_expression" con apariciones de "string_expression2". Si
"string_expression1" tiene una longitud superior a "integer_expression", se
devuelve la parte apropiada de "string_expression1".
Sintaxis
Apéndice C. Uso del editor de expresiones 537

lpad ( string_expression1 , integer_expression [ , string_expression2
])
ltrim
Devuelve "string_expression1", donde se han eliminado los caracteres iniciales
hasta el primer carácter que no se encuentra en "string_expression2"; por ejemplo,
ltrim ( 'xyxXxyAB' , 'xy' ) devuelve XxyAB.
Sintaxis
ltrim ( string_expression1 [ , string_expression2 ] )
to_hex
Devuelve la representación en forma de cadena hexadecimal de "numeric_exp1".
Sintaxis
to_hex ( numeric_expression1 )
repeat
Devuelve "string_expression" repetida el número de veces indicado en
"numeric_expression1".
Sintaxis
repeat ( string_expression , numeric_expression1 )
replace
Devuelve "string_expression", después de haber sustituido "string_expression2" por
"string_expression3".
Sintaxis
replace ( string_expression , string_expression2 , string_expression3
)
rpad
Devuelve "string_expression1" que se ha rellenado por la derecha hasta la longitud
"integer_expression" con apariciones de "string_expression2". Si
"string_expression1" tiene una longitud superior a "integer_expression", se
devuelve la parte apropiada de "string_expression1". Si "string_expression2" no se
especifica, se utilizan espacios.
Sintaxis
rpad ( string_expression1 , integer_expression [ , string_expression2
])
rtrim
Devuelve "string_expression1", donde se han eliminado los caracteres finales
después del último carácter que no se encuentra en "string_expression2"; por
ejemplo, rtrim ( 'ABxXxyx' , 'xy' ) devuelve ABxX. Si "string_expression2" no se
especifica, se eliminan los caracteres de espacio finales.
Sintaxis
rtrim ( string_expression1 [ , string_expression2 ] )
538 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Formateo de tipo de datos de Vertica
Vertica Math
to_char
Devuelve la representación en forma de cadena de "expression" con el formato de
"string_expression". "Expression" puede ser un valor de fecha o un valor numérico.
Sintaxis
to_char ( expression , string_expression )
to_date
Convierte "string_expression1" en un valor de fecha, según especifica el formato
"string_expression2".
Sintaxis
to_date ( string_expression1 , string_expression2 )
to_number
Convierte "string_expression1" en un valor numérico, según especifica el formato
"string_expression2".
Sintaxis
to_number ( string_expression1, string_expression2 )
to_timestamp
Convierte "string_expression1" en un valor de indicación de fecha y hora, según
especifica el formato "string_expression2".
Sintaxis
to_timestamp ( string_expression1, string_expression2 )
log
Devuelve el logaritmo en base 10 de "numeric_expression1" o el logaritmo en base
"numeric_expression2".
Sintaxis
log ( numeric_expression1 [ , numeric_expression2 ] )
ln
Devuelve el logaritmo natural de "numeric_expression1".
Sintaxis
ln ( numeric_expression )
cbrt
Devuelve la raíz cúbica de "numeric_expression1".
Sintaxis
cbrt ( numeric_expression )
pi
Devuelve la constante pi.
Sintaxis
Apéndice C. Uso del editor de expresiones 539

pi ()
Vertica Trigonometry
acos
Devuelve el arcocoseno de "numeric_expression" en radianes. El arcocoseno es el
ángulo cuyo coseno es "numeric_expression".
Sintaxis
acos ( numeric_expression )
asin
Devuelve el arcoseno de "numeric_expression" en radianes. El arcoseno es el
ángulo cuyo seno es "numeric_expression".
Sintaxis
asin ( numeric_expression )
atan
Devuelve la arcotangente de "numeric_expression" en radianes. La arcotangente es
el ángulo cuya tangente es "numeric_expression".
Sintaxis
atan ( numeric_expression )
atan2
Devuelve la arcotangente de las coordenadas xeyespecificadas por
"numeric_expression1" y "numeric_expression2", respectivamente, en radianes. La
arcotangente es el ángulo cuya tangente es "numeric_expression2" /
"numeric_expression1".
Sintaxis
atan2 ( numeric_expression1 , numeric_expression2 )
cos
Devuelve el coseno de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
Sintaxis
cos ( numeric_expression )
cot
Devuelve la cotangente de "numeric_expression", donde "numeric_expression" es
un ángulo expresado en radianes.
Sintaxis
cot ( numeric_expression )
degrees
Devuelve los grados, donde "numeric_expression" es un ángulo expresado en
radianes.
Sintaxis
degrees ( numeric_expression )
540 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

ascii
chr
radians
Devuelve los radianes, donde "numeric_expression" es un ángulo expresado en
grados.
Sintaxis
radians ( numeric_expression )
sin
Devuelve el seno de "numeric_exp", donde "numeric_expression" es un ángulo
expresado en radianes.
Sintaxis
sin ( numeric_expression )
tan
Devuelve la tangente de "numeric_expression", donde "numeric_expression" es un
ángulo expresado en radianes.
Sintaxis
tan ( numeric_expression )
Devuelve un número que representa el valor del código ascii del carácter que se
encuentra más a la izquierda de "string_expression"; por ejemplo, ascii ( 'A' )
devuelve 65.
Sintaxis
ascii ( string_expression )
Devuelve el carácter que tiene el valor del código ASCII especificado por
"integer_expression". "Integer_expression" debe estar entre 0 y 255.
Sintaxis
chr ( integer_expression )
current_database
Devuelve el nombre de la base de datos actual.
Sintaxis
current_database ()
current_schema
Devuelve el nombre del esquema actual.
Sintaxis
current_schema ()
{current_user}
Sintaxis
{current_user}
Apéndice C. Uso del editor de expresiones 541

{session_user}
Sintaxis
{session_user}
translate
Devuelve "string_expression1", donde todas las apariciones de cada carácter
incluido en "string_expression2" se han sustituido por el carácter correspondiente
de "string_expression3".
Sintaxis
translate ( string_expression1 , string_expression2 ,
string_expression3 )
date_trunc
Devuelve la indicación de fecha y hora a la precisión especificada.
Sintaxis
date_trunc ( string_expression , timestamp_expression)
version
Devuelve el valor de cadena de la versión de la base de datos.
Sintaxis
version ()
Funciones de macro
+
Esta lista contiene funciones que se pueden utilizar en una macro. Cada macro
puede contener una o varias funciones de macro. La macro está delimitada por un
signo de almohadilla (#) situado al principio y otro al final. Los elementos
incluidos entre los signos de almohadilla se consideran la expresión de macro y se
ejecutan en tiempo de ejecución. En una función de macro que acepte como
argumentos expresiones de indicación de fecha y hora con huso horario como tipo
de datos, el formato aceptado es 'aaaa-mm-dd hh:mm:ss[.ff]+hh:mm', donde la
fracción de los segundos es opcional y se puede representar mediante 1a9dígitos.
En lugar de un espacio que separe la parte de la fecha de la parte de la hora,
también se admite el carácter "T". Asimismo, en lugar del huso horario '+hh:mm',
se admite el carácter "Z", que se procesará internamente como '+00:00'. Las
funciones de macro que devuelven expresiones con indicación de fecha y hora con
huso horario como tipo de datos devuelven 9 dígitos de manera predeterminada
para la fracción de los segundos. La función de macro timestampMask() se puede
utilizar para reducir la salida si es necesario.
Concatena dos cadenas.
Sintaxis
value1 + value2
Ejemplo
# ’{ ’ + $runLocale +’}’#
Resultado
542 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

{es-es}
_add_days
Devuelve la indicación de fecha y hora con huso horario (en forma de cadena) que
resulta de sumar el número de días de "integer_expression" a "string_expression",
donde "string_expression" representa una indicación de fecha y hora con huso
horario.
Sintaxis
_add_days ( string_expression , integer_expression )
Ejemplo 1
# _add_days ( ’2005-11-01 12:00:00.000-05:00’ , -1 ) #
Resultado
2005-10-31 12:00:00.000000000-05:00
Ejemplo 2
# _add_days ( $current_timestamp ,1)#
Resultado
2005-11-02 12:00:00.000000000-05:00
Ejemplo 3
# timestampMask ( _add_days ( $current_timestamp ,1),
’yyyy-mm-dd’ ) #
Resultado
2005-11-02
_add_months
Devuelve la indicación de fecha y hora con huso horario (en forma de cadena) que
resulta de sumar el número de meses de "integer_expression" a "string_expression",
donde "string_expression" representa una indicación de fecha y hora con huso
horario.
Sintaxis
_add_months ( string_expression , integer_expression )
Ejemplo 1
# _add_months ( ’2005-11-01 12:00:00.000-05:00’ , -1 ) #
Resultado
2005-10-01 12:00:00.000000000-05:00
Ejemplo 2
# _add_months ( $current_timestamp ,1)#
Resultado
Apéndice C. Uso del editor de expresiones 543

2005-12-01 12:00:00.000000000-05:00
Ejemplo 3
# timestampMask ( _add_months ( $current_timestamp ,1),
’yyyy-mm-dd’ ) #
Resultado
2005-12-01
_add_years
Devuelve la indicación de fecha y hora con huso horario (en forma de cadena) que
resulta de sumar el número de años de "integer_expression" a "string_expression",
donde "string_expression" representa una indicación de fecha y hora con huso
horario.
array
Sintaxis
_add_years ( string_expression , integer_expression )
Ejemplo 1
# _add_years ( ’2005-11-01 12:00:00.000-05:00’ , -1 ) #
Resultado
2004-11-01 12:00:00.000000000-05:00
Ejemplo 2
# _add_years ( $current_timestamp ,1)#
Resultado
2006-11-01 12:00:00.000000000-05:00
Ejemplo 3
# timestampMask ( _add_years ( $current_timestamp ,1),
’yyyy-mm-dd’ ) #
Resultado
2006-11-01
Crea una matriz a partir de la lista de parámetros.
Sintaxis
array ( string_expression|array_expression { ,
string_expression|array_expression } )
Ejemplo
# csv ( array ( ’a1’ , array ( ’x1’ , ’x2’ ),’a2’))#
Resultado
'a1' , 'x1' , 'x2' , 'a2'
544 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

csv
dq
Construye una cadena con los elementos de la matriz en la que los valores están
separados por comas. También se pueden especificar el separador y las cadenas
con comillas. El separador predeterminado es la coma (,) y el carácter de comilla
predeterminado es la comilla simple (').
Sintaxis
csv ( array_expression [ , separator_string [ , quote_string ]])
Ejemplo
# csv ( array ( ’a1’ , ’a2’ ))#
Resultado
'a1', 'a2'
Encierra entre comillas dobles "string_expression".
Sintaxis
dq ( string_expression )
Ejemplo
# dq ( ’zero’ ) #
Resultado
"cero"
getConfigurationEntry
Obtiene una entrada del archivo de configuración de IBM ® Cognos ® . El parámetro
force_decode_flag es opcional y debe ser uno de los siguientes: 'true', '1', 1, 'false',
'0', 0. El valor predeterminado es 'true'. Cuando es true (verdadero), el valor de la
entrada de configuración se descifrará en texto sin formato si está cifrado.
grep
Sintaxis
getConfigurationEntry ( entry_string , force_decode_flag )
Ejemplo
# getConfigurationEntry ( ’serverLocale’ ) #
Resultado
en
Busca y devuelve elementos de una matriz que coinciden con el modelo
especificado en "pattern_string".
Sintaxis
grep ( pattern_string , array_expression )
Ejemplo
Apéndice C. Uso del editor de expresiones 545

# csv ( grep ( ’s’ , array ( ’as’, ’an’, ’arts’ )))#
Resultado
'as', 'arts'
_first_of_month
Devuelve una indicación de fecha y hora con huso horario (en forma de cadena)
mediante la conversión en 1 del valor de día indicado en "string_expression",
donde "string_expression" es una indicación de fecha y hora con huso horario.
Sintaxis
_first_of_month ( string_expression )
Ejemplo 1
# _first_of_month ( ’2005-11-11 12:00:00.000-05:00’ ) #
Resultado
2005-11-01 12:00:00.000000000-05:00
Ejemplo 2
# timestampMask ( _first_of_month ( ’2005-11-11 12:00:00.
000-05:00’ ) , ’yyyymmdd’ ) #
Resultado
20051101
_last_of_month
Devuelve una indicación de fecha y hora con huso horario (en forma de cadena)
que representa el último día del mes indicado en "string_expression", donde
"string_expression" es una indicación de fecha y hora con huso horario.
Sintaxis
_last_of_month ( string_expression )
Ejemplo 1
# _last_of_month ( ’2005-11-11 12:00:00.000-05:00’ ) #
Resultado
2005-11-30 12:00:00.000000000-05:00
Ejemplo 2
# timestampMask ( _last_of_month ( ’2005-11-11 12:00:00.000-05:00’ ) ,
’yyyy-mm-dd’ ) #
Resultado
2005-11-30
546 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

join
lstrip
Une los elementos de una matriz mediante "separator_string".
Sintaxis
join ( separator_string , array_expression )
Ejemplo
#sq(join(’||’,array ( ’as’, ’an’, ’arts’ )))#
Resultado
'as||an||arts'
Quita los caracteres iniciales del primer argumento. El segundo argumento
opcional define el conjunto de caracteres que se quitará. De forma predeterminada,
esta función quita el espacio en blanco (esto es, espacio, tabulador, retorno de carro
y salto de línea).
Sintaxis
lstrip ( string_expression [ , set_of_characters ] )
Ejemplo 1
# sq( lstrip ( ’ abc ’))#
Resultado
'abc '
Ejemplo 2
’)#
Resultado
53,2100
prompt
Solicita al usuario que escriba un único valor. Sólo es obligatorio "prompt_name".
Cuando no se especifica el tipo de datos (datatype), se utiliza "string" de forma
predeterminada. La solicitud es opcional si está especificado "defaultText". Cuando
se especifique "text", irá delante del valor. Puede especificarse "queryItem" para
beneficiarse de las propiedades de solicitud de información de "queryItem".
Cuando se especifique "trailing_text", se añadirá al valor.
Sintaxis
prompt ( prompt_name , datatype , defaultText , text , queryItem ,
trailing_text )
Ejemplo 1
select ...where COUNTRY_MULTILINGUAL.COUNTRY_CODE > #prompt (
’Starting CountryCode’ , ’integer’ , ’10’ ) #
Resultado
Apéndice C. Uso del editor de expresiones 547

select ...where COUNTRY_MULTILINGUAL.COUNTRY_CODE > 10
Ejemplo 2
[gosales].[COUNTRY].[COUNTRY] = # prompt ( ’countryPrompt’ ,
’string’ , ’’’Canada’’’ ) #
Resultado
[gosales].[PAÍS].[PAÍS] = 'Canadá'
Notas
v Se debe especificar el parámetro "defaultText" de forma que sea literalmente
válido en el contexto de la macro, ya que no se produce ningún formateo en este
valor. La cadena predeterminada '''Canada''' del ejemplo 2 se ha especificado
como una cadena entre comillas simples, en la que las comillas simples incluidas
están duplicadas y, por lo tanto, son 3 comillas. El resultado es que la cadena se
muestra correctamente entre comillas simples en la expresión. Como norma
general para el tipo de datos de cadena, "defaultText" debe especificarse siempre
de esta forma, salvo en el contexto de un parámetro de procedimiento
almacenado. Para "defaultText" de los tipos "date" o "datetime", se debe utilizar
un formato especial en el contexto de SQL. Son ejemplos de estos formatos
'DATE ''2001-12-25''' y 'DATETIME ''2001-12-25 12:00:00'''. En todos los demás
contextos, utilice date/datetime sin la palabra clave y las comillas simples de
escape (por ejemplo, '2001-12-25').
promptmany
Solicita al usuario que especifique uno o más valores. Sólo es obligatorio
"prompt_name". Cuando no se especifica el tipo de datos, se utiliza "string" de
forma predeterminada. La solicitud es opcional si está especificado "defaultText".
Cuando se especifique "text", irá delante de la lista de valores. Puede especificarse
"queryItem" para beneficiarse de las propiedades de solicitud de información de
"queryItem". Cuando se especifique "trailing_text", se añadirá a la lista de valores.
Sintaxis
promptmany ( prompt_name , datatype , defaultText , text , queryItem ,
trailing_text )
Ejemplo 1
select ...where COUNTRY_MULTILINGUAL.COUNTRY in ( # promptmany (
’CountryName’ )#)
Resultado
select ...where COUNTRY_MULTILINGUAL.COUNTRY_CODE in
( 'Canada' , 'The Netherlands' , 'Russia' )
Ejemplo 2
select ...from gosales.gosales.dbo.COUNTRY_MULTILINGUAL
COUNTRY_MULTILINGUAL , gosales.gosales.dbo.COUNTRY XX where
COUNTRY_MULTILINGUAL.COUNTRY_CODE = XX.COUNTRY_CODE # promptmany (
’Selected CountryCodes’ , ’integer’ ,’’,’and
COUNTRY_MULTILINGUAL.COUNTRY_CODE in (’,’’,’)’)#
Resultado
548 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

strip
sb
sq
select ...fromgosales.gosales.dbo.COUNTRY_MULTILINGUAL
COUNTRY_MULTILINGUAL , gosales.gosales.dbo.COUNTRY XX where
COUNTRY_MULTILINGUAL.COUNTRY_CODE = XX.COUNTRY_CODE and
COUNTRY_MULTILINGUAL.COUNTRY_CODE in ( 'Canada' , 'The
Netherlands' , 'Russia' )
Quita los caracteres finales del primer argumento. El segundo argumento opcional
define el conjunto de caracteres que se quitará. De forma predeterminada, esta
función quita el espacio en blanco (esto es, espacio, tabulador, retorno de carro y
salto de línea).
Sintaxis
rstrip ( string_expression [ , set_of_characters ] )
Ejemplo 1
# sq( rstrip ( ’ abc ’))#
Resultado
' abc'
Ejemplo 2
’)#
Resultado
0053,21
Encierra entre corchetes "string_expression".
Sintaxis
sb ( string_expression )
Ejemplo
# sb ( ’abc’ ) #
Resultado
[abc]
Encierra entre comillas simples "string_expression".
Sintaxis
sq ( string_expression )
Ejemplo
# sq ( ’zero’ ) #
Resultado
Apéndice C. Uso del editor de expresiones 549

sort
split
strip
'cero'
Ordena alfabéticamente los elementos de la matriz. Los duplicados se mantienen.
Sintaxis
sort ( array_expression )
Ejemplo
# csv ( sort ( array ( ’s3’, ’a’, ’x’ )))#
Resultado
'a', 's3', 'x'
Divide una cadena o los elementos de una cadena de la matriz en elementos
separados.
Sintaxis
split ( pattern_string, string_expression|array_expression )
Ejemplo 1
# csv ( split ( ’::’, ’ab=c::de=f::gh=i’ ))#
Resultado
'ab=c', 'de=f', 'gh=i'
Ejemplo 2
# csv ( split ( ’=’ , split ( ’::’, ’ab=c::de=f::gh=i’ )))#
Resultado
'ab', 'c', 'de', 'f', 'gh', 'i'
Quita los caracteres iniciales y finales del primer argumento. El segundo
argumento opcional define el conjunto de caracteres que se quitará. De forma
predeterminada, esta función quita el espacio en blanco (esto es, espacio, tabulador,
retorno de carro y salto de línea).
Sintaxis
strip ( string_expression [ , set_of_characters ] )
Ejemplo 1
# sq( strip ( ’ abc ’))#
Resultado
'abc'
Ejemplo 2
550 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

’)#
Resultado
53,21
substitute
Busca un modelo en una cadena o en los elementos de una cadena de una matriz y
sustituye la primera aparición de "pattern_string" por "replacement_string".
Sintaxis
substitute ( pattern_string, replacement_string,
string_expression|array_expression )
Ejemplo 1
#sq ( substitute ( ’^cn=’, ’***’, ’cn=help’ ) )#
Resultado
'***help'
Ejemplo 2
# csv ( substitute ( ’^cn=’, ’***’, array ( ’cn=help’ , ’acn=5’ )))
#
Resultado
'***help', 'acn=5'
Ejemplo 3
# csv ( substitute ( ’cn=’, ’’, array ( ’cn=help’ , ’acn=5’ )))#
Resultado
'help', 'a5'
timestampMask
Devuelve "string_expression1", que representa una indicación de fecha y hora con
huso horario, reducida de acuerdo con el formato especificado en
"string_expression2". El formato de "string_expression2" debe ser uno de los
siguientes: 'aaaa', 'mm', 'dd', 'aaaa-mm', 'aaaamm', 'aaaa-mm-dd', 'aaaammdd',
'aaaa-mm-dd hh:mm:ss', 'aaaa-mm-dd hh:mm:ss+hh:mm', 'aaaa-mm-dd
hh:mm:ss.ff3', 'aaaa-mm-dd hh:mm:ss.ff3+hh:mm', 'aaaa-mm-ddThh:mm:ss',
'aaaa-mm-ddThh:mm:ss+hh:mm', 'aaaa-mm-ddThh:mm:ss.ff3+hh:mm' o
'aaaa-mm-ddThh:mm:ss.ff3+hh:mm'. Las funciones de macro que devuelven una
representación en forma de cadena de una indicación de fecha y hora con huso
horario muestran de manera predeterminada una precisión de 9 dígitos para la
fracción de los segundos. Las opciones de formato permiten reducir esta cifra hasta
una precisión de 3o0.
Sintaxis
timestampMask ( string_expression1 , string_expression2 )
Ejemplo 1
Apéndice C. Uso del editor de expresiones 551

# timestampMask ( $current_timestamp , ’yyyy-dd-mm’ ) #
Resultado
2005-11-01
Ejemplo 2
# timestampMask ( ’2005-11-01 12:00:00.000-05:00’ , ’yyyy-mm-dd
hh:mm:ss+hh:mm’ ) #
Resultado
2005-11-01 12:00:00-05:00
Ejemplo 3
# timestampMask ( ’2005-11-01 12:00:00.123456789-05:00’ ,
’yyyy-mm-ddThh:mm:ss+hh:mm.ff3+hh:mm’ ) #
Resultado
2005-11-01T12:00:00.123-05:00
toLocal
Devuelve la cadena que representa una indicación de fecha y hora con huso
horario que resulta de ajustar "string_expression" al huso horario del sistema
operativo. Tenga en cuenta que la función de macro timestampMask() se puede
utilizar para reducir la salida.
Sintaxis
toLocal ( string_expression )
Ejemplo 1
# toLocal ( ’2005-11-01 17:00:00.000-00:00’ ) # where OS local time
zone is -05:00
Resultado
2005-11-01 12:00:00.000000000-05:00
Ejemplo 2
# timestampMask ( toLocal ( ’2005-11-01 17:00:00.000-00:00’ ) ,
’yyyy-mm-dd hh:mm:ss+hh:mm’ ) # where OS local time zone is -05:00
Resultado
2005-11-01 12:00:00-05:00
Ejemplo 3
# toLocal ( ’2005-11-01 13:30:00.000-03:30’ ) # where OS local time
zone is -05:00
Resultado
2005-11-01 12:00:00.000000000-05:00
552 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

tolower
Devuelve la cadena "expresión_cadena" con todos los caracteres convertidos a
minúscula aplicando las reglas del entorno local definido en
"cadena_entorno_local". Si no se ha especificado ningún entorno local, se utiliza el
entorno local 'en'.
Sintaxis
tolower ( string_expression [ , locale_string ] )
Ejemplo 1
# tolower ( ’ABC’ ) #
Resultado
abc
Ejemplo 2
# tolower ( ’ABC’ , ’fr’ ) #
Resultado
abc
toupper
Devuelve la cadena "expresión_cadena" con todos los caracteres convertidos a
mayúscula aplicando las reglas del entorno local definido en
"cadena_entorno_local". Si no se ha especificado la "cadena_entorno_local", se
utiliza el entorno local 'en'.
toUTC
Sintaxis
toupper ( string_expression [ , locale_string ] )
Ejemplo 1
# toupper ( ’abc’ ) #
Resultado
ABC
Ejemplo 2
# toupper ( ’abc’ , ’fr’ ) #
Resultado
ABC
Devuelve la cadena que representa una indicación de fecha y hora con huso
horario resultante de ajustar "string_expression" al huso horario UTC de referencia
de punto cero, también conocido como hora GMT. Tenga en cuenta que la función
de macro timestampMask() se puede utilizar para reducir la salida.
Sintaxis
Apéndice C. Uso del editor de expresiones 553

toUTC ( string_expression )
Ejemplo 1
# toUTC ( ’2005-11-01 12:00:00.000-05:00’ ) #
Resultado
2005-11-01 17:00:00.000000000-00:00
Ejemplo 2
# timestampMask( toUTC ( ’2005-11-01 12:00:00.000-05:00’ ) ,
’yyyy-mm-dd hh:mm:ss.ff3+hh:mm’ ) #
Resultado
2005-11-01 17:00:00.000-00:00
Ejemplo 3
# toUTC ( $current_timestamp ) #
Resultado
2005-11-01 17:00:00.000000000-00:00
exclusivos
Elimina las entradas duplicadas de la matriz. Se mantiene el orden de los
elementos.
Sintaxis
unique ( array_expression )
Ejemplo
# csv ( unique ( array ( ’s3’, ’a’, ’s3’, ’x’ )))#
Resultado
's3', 'a', 'x'
urlencode
Codifica como URL el argumento pasado. Esta función es útil cuando se
especifican cadenas de conexión XML.
Sintaxis
urlencode ( prompt ( ’userValue’ ) )
Ejemplo
urlencode ( prompt ( ’some_val’ ) )
Resultado
%27testValue%27
554 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

CSVIdentityName
Utiliza la información de identidad del usuario autenticado actual para buscar
valores en el mapa de parámetros especificado. Cada parte de la identidad del
usuario (nombre de cuenta, nombres de grupo, nombres de rol) se utiliza como
una clave en la correlación. La lista única de valores que se recupera del mapa de
parámetros se devuelve en forma de cadena, en la que cada valor aparece
especificado entre comillas simples y donde los diversos valores aparecen
separados mediante comas.
Sintaxis
CSVIdentityName ( %parameter_map_name [ , separator_string ] )
Ejemplo
# CSVIdentityName ( %security_clearance_level_map ) #
Resultado
'nivel_500'; 'nivel_501'; 'nivel_700'
CSVIdentityNameList
Devuelve las partes de la identidad del usuario (nombre de cuenta, nombres de
grupo, nombres de rol) como una lista de cadenas. La lista única de valores se
devuelve en forma de cadena, en la que cada valor aparece encerrado entre
comillas simples y con los valores múltiples separados por comas.
Sintaxis
CSVIdentityNameList ( [ separator_string ] )
Ejemplo
# CSVIdentityNameList ()#
Resultado
'Todos'; 'Administradores de informes'; 'Usuario de la consulta'
CAMPassport
Devuelve el pasaporte de Cognos ® Access Manager.
Sintaxis
CAMPassport ( )
Ejemplo
# CAMPassport ()#
Resultado
111:98812d62-4fd4-037b-4354-26414cf7ebef:3677162321
CAMIDList
Devuelve las partes de Cognos ® Access Manager ID (CAMID) del usuario (nombre
de cuenta, nombres de grupo, nombres de rol) como una lista de valores separados
por comas.
Apéndice C. Uso del editor de expresiones 555

Sintaxis
CAMIDList ( [ separator_string ] )
Ejemplo
#CAMIDList ()#
Resultado
CAMID ( "::Todos" ) , CAMID ( ":Autores" ) , CAMID ( ":Usuarios de
consultas" ) , CAMID ( ":Consumidores" ) , CAMID ( ":Autores de métrica" )
CAMIDListForType
Devuelve una matriz de Cognos ® Access Manager ID (CAMID) del usuario según
el tipo de identidad (cuenta, grupo o rol). CAMIDListForType puede utilizarse con
las funciones de macro csv o join.
Sintaxis
CAMIDListForType ( identity type )
Ejemplo
[qs].[userRole] in ( # csv ( CAMIDListForType ( ’role’ ))#)
Resultado
[qs].[rolUsuario] in ( 'CAMID ("::Administradores del sistema")', 'CAMID
(":Autores")' )
simple case
Esta construcción de macro es la plantilla para un case simple, que incluye las
funciones case, when, else y end. Tenga en cuenta que esta construcción de macro
sólo se soporta en modo DQM.
Sintaxis
CASE WHEN THEN [ELSE
] END
Ejemplo
#CASE prompt(’pDateRange’,’token’) WHEN ’Current Week’ THEN ’[PR
Current Week]’ ELSE ’[PR Prior Week]’ END#
Resultado
Funciones comunes
abs
[PR semana actual]
Devuelve el valor absoluto de "numeric_expression". Los valores negativos se
devuelven como valores positivos.
Sintaxis
abs ( numeric_expression )
556 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

cast
Ejemplo 1
abs(15)
Resultado
15
Ejemplo 2
abs ( -15 )
Resultado
15
Convierte "expression" en el tipo de datos especificado. Algunos tipos de datos
permiten especificar longitud y precisión. Asegúrese de que el destino es del tipo y
tamaño adecuados. Para "datatype_specification", puede utilizarse lo siguiente:
character, varchar, char, numeric, decimal, integer, smallint, real, float, date, time,
timestamp, time with time zone, timestamp with time zone e interval. Cuando
especifica casting para un tipo de intervalo, debe especificar uno de los siguientes
calificadores de intervalo: year, month o year to month para el tipo de datos de
intervalo de año a mes; day, hour, minute, second, day to hour, day to minute, day
to second, hour to minute, hour to second o minute to second para el tipo de datos
de intervalo de día a segundo. Notas: Cuando convierte un valor de tipo
timestamp en el tipo date, se pasa por alto la parte de la hora del valor de la
indicación de fecha y hora. Cuando convierte un valor de tipo timestamp en el tipo
time, se ignora la parte de la fecha de la indicación de fecha y hora. Cuando
convierte un valor de tipo date en el tipo timestamp, los componentes de hora de
la indicación de fecha y hora se establecen en cero. Cuando convierte un valor de
tipo time en el tipo timestamp, los componentes de la fecha se establecen en la
fecha actual del sistema. No se puede convertir un tipo de datos de intervalo en
otro (por ejemplo, porque el número de días de un mes es variable). Tenga en
cuenta que sólo puede especificar el número de dígitos para el calificador inicial,
por ejemplo, YEAR(4) TO MONTH, DAY(5). Se notificarán errores si el tipo y el
tamaño del destino no son compatibles con el tipo y el tamaño del origen.
Sintaxis
cast ( expression , datatype_specification )
Ejemplo 1
cast ( ’123’ , integer )
Resultado
123
Ejemplo 2
cast ( 12345 , varchar ( 10 ) )
Resultado
una cadena que contiene 12345
Apéndice C. Uso del editor de expresiones 557

ceil
Devuelve el entero más pequeño que sea igual o mayor que "numeric_expression".
Sintaxis
ceil ( numeric_expression )
ceiling
Devuelve el entero más pequeño que sea igual o mayor que "numeric_expression".
Sintaxis
ceiling ( numeric_expression )
Ejemplo 1
ceiling ( 4.22 )
Resultado
5
Ejemplo 2
ceiling ( -1.23 )
Resultado
-1
char_length
Devuelve el número de caracteres lógicos de "string_expression". El número de
caracteres lógicos puede ser distinto del número de bytes en algunos entornos
locales de Asia Oriental.
Sintaxis
char_length ( string_expression )
Ejemplo
char_length ( ’Canada’ )
Resultado
6
character_length
Devuelve el número de caracteres de "string_expression".
Sintaxis
character_length ( string_expression )
Ejemplo
character_length ( ’Canada’ )
Resultado
6
558 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

coalesce
Devuelve el primer argumento no nulo (o nulo si todos los argumentos son nulos).
Necesita dos o más argumentos en "expression_list".
Sintaxis
coalesce ( expression_list )
Ejemplo
coalesce ( [Unit price], [Unit sale price] )
Resultado
Devuelve el precio unitario, o bien devuelve el precio de venta unitario si el precio
unitario es NULL.
current_date
Devuelve un valor de fecha que representa la fecha actual del sistema en el que se
ejecuta el software de bases de datos.
Sintaxis
current_date
Ejemplo
current_date
Resultado
2003-03-04
current_time
Devuelve una hora con valor de huso horario que representa la hora actual del
sistema en el que se ejecuta el software de bases de datos si la base de datos
soporta esta función. De lo contrario, representa la hora actual del sistema en el
que se ejecuta el software IBM ® Cognos ® BI.
Sintaxis
current_time
Ejemplo
current_time
Resultado
16:33:11.354+05:00
current_timestamp
Devuelve una fecha y hora con valor de huso horario que representa la hora actual
del sistema en el que se ejecuta el software de bases de datos si la base de datos
soporta esta función. De lo contrario, representa la hora actual del sistema en el
que se ejecuta el software IBM ® Cognos ® BI.
Sintaxis
current_timestamp
Apéndice C. Uso del editor de expresiones 559

exp
Ejemplo
current_timestamp
Resultado
2003-03-03 16:40:15.535+05:00
Devuelve "e" elevado a "numeric_expression". La constante 'e' es la base del
logaritmo natural.
Sintaxis
exp ( numeric_expression )
Ejemplo
exp(2)
Resultado
7,389056
extract
Devuelve un entero que representa el valor de datepart (año, mes, día, hora,
minuto, segundo) de "datetime_expression".
floor
Sintaxis
extract ( datepart , datetime_expression )
Ejemplo 1
extract ( year , 2003-03-03 16:40:15.535 )
Resultado
2003
Ejemplo 2
extract ( hour , 2003-03-03 16:40:15.535 )
Resultado
16
Devuelve el entero más grande que sea igual o menor que "numeric_expression".
Sintaxis
floor ( numeric_expression )
Ejemplo 1
floor ( 3.22 )
Resultado
560 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

ln
3
Ejemplo 2
floor ( -1.23 )
Resultado
-2
Devuelve el logaritmo natural de "numeric_expression".
Sintaxis
ln ( numeric_expression )
Ejemplo
ln(4)
Resultado
1,38629
localtime
Devuelve un valor de hora que representa la hora actual del sistema en el que se
ejecuta el software de bases de datos.
Sintaxis
localtime
Ejemplo
localtime
Resultado
16:33:11
localtimestamp
Devuelve un valor de fecha y hora que representa la indicación de fecha y hora
actual del sistema en el que se ejecuta el software de bases de datos.
lower
Sintaxis
localtimestamp
Ejemplo
localtimestamp
Resultado
2003-03-03 16:40:15
Devuelve "string_expression" con todos los caracteres en mayúsculas convertidos a
minúsculas.
Apéndice C. Uso del editor de expresiones 561

mod
nullif
Sintaxis
lower ( string_expression )
Ejemplo
lower ( ’ABCDEF’ )
Resultado
abcdef
Devuelve el resto de la división (módulo) de "integer_expression1" entre
"integer_expression2". "Integer_expression2" no puede ser igual a cero; de lo
contrario, se crea una condición de excepción.
Sintaxis
mod ( integer_expression1, integer_expression2 )
Ejemplo
mod(20,3)
Resultado
2
Devuelve un valor nulo si "expression1" es igual a "expression2"; de lo contrario,
devuelve "expression1".
Sintaxis
nullif ( expression1, expression2 )
octet_length
Devuelve el número de bytes de "string_expression".
Sintaxis
octet_length ( string_expression )
Ejemplo 1
octet_length ( ’ABCDEF’ )
Resultado
6
Ejemplo 2
octet_length ( ’’ )
Resultado
0
562 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

position
Devuelve el valor entero que representa la posición inicial de "string_expression1"
en "string_expression2" o bien 0 cuando no se encuentra "string_expression1".
power
Sintaxis
position ( string_expression1 , string_expression2 )
Ejemplo 1
position ( ’C’ , ’ABCDEF’ )
Resultado
3
Ejemplo 2
position ( ’H’ , ’ABCDEF’ )
Resultado
0
Devuelve "numeric_expression1" elevado a "numeric_expression2". Si el valor de
"numeric_expression1" es negativo, el resultado de "numeric_expression2" deberá
ser un valor entero.
Sintaxis
power ( numeric_expression1 , numeric_expression2 )
Ejemplo
power (3,2)
Resultado
9
_round
Devuelve "numeric_expression" redondeado a "integer_expression" posiciones a la
derecha del separador decimal. Notas: "integer_expression" debe ser un entero no
negativo. El redondeo tiene lugar antes de formatear los datos.
Sintaxis
_round ( numeric_expression , integer_expression )
Ejemplo
_round ( 1220.42369, 2 )
Resultado
1220,42
Apéndice C. Uso del editor de expresiones 563

ow
sqrt
El constructor de filas representa una colección de valores organizados como una
fila de datos. Se puede utilizar en expresiones condicionales (es decir
IF-THEN-ELSE) y expresiones de filtro (es decir la cláusula IN).
Sintaxis
row ( expression_list )
Ejemplo 1
if ( row([RetailerName],[OrderMethodCode]) = row(’ActiForme’,4) )
then (’A’)
else (’B’)
Resultado
Devuelve 'A' si el nombre de minorista es 'ActiForme' y el código de método de
pedido es 4. De lo contrario, se devuelve el valor 'B'.
Ejemplo 2
case row([RetailerName],[OrderMethodCode])
when row(’Advanced
Climbing Ltd’,3) then 1
when row(’ActiForme’,5) then 2
else 3
end
Resultado
Devuelve 1 si el nombre de minorista es 'Advanced Climbing Ltd' y el código de
método de pedido es 3. Devuelve 2 si el nombre de minorista es 'ActiForme' y el
código de método de pedido es 5. De lo contrario, se devuelve el valor 3.
Ejemplo 3
row ( [OrderMethodCode], [Year] ) in ( [Query].[OMC], [Query].[YR] )
Resultado
Los datos devueltos se filtran en las dos condiciones siguientes: 1)
[CódigoMétodoPedido] en ([Consulta].[OMC]) 2) [Año] en ([Consulta].[YR])
Devuelve la raíz cuadrada de "numeric_expression". El valor de
"numeric_expression" debe ser un valor no negativo.
Sintaxis
sqrt ( numeric_expression )
Ejemplo
sqrt(9)
Resultado
3
564 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

substring
Devuelve la subcadena de "string_expression" que comienza en la posición
indicada por "integer_expression1" y tiene una longitud de "integer_expression2"
caracteres o hasta el final de "string_expression" si se omite "integer_expression2".
El primer carácter de "string_expression" se encuentra en la posición 1.
trim
upper
Sintaxis
substring ( string_expression , integer_expression1 [ ,
integer_expression2 ] )
Ejemplo
substring ( ’abcdefg’ ,3,2)
Resultado
cd
Devuelve la "string_expression" de la que se han eliminado los espacios en blanco
anteriores y posteriores o bien un determinado carácter especificado en
"match_character_expression". Se presupone el parámetro "both" cuando el primer
argumento no está definido. Si no se define el segundo argumento, se presupone
una cadena vacía.
Sintaxis
trim([[trailing|leading|both ] [ match_character_expression ],]
string_expression )
Ejemplo 1
trim ( trailing ’A’ , ’ABCDEFA’ )
Resultado
ABCDEF
Ejemplo 2
trim ( both , ’ ABCDEF ’ )
Resultado
ABCDEF
Devuelve "string_expression" con todos los caracteres en minúsculas convertidos a
mayúsculas.
Sintaxis
upper ( string_expression )
Ejemplo
upper ( ’abcdef’ )
Resultado
Apéndice C. Uso del editor de expresiones 565

ABCDEF
width-bucket
Para una expresión determinada, esta función devuelve el número de grupo en el
que estará el valor de esta expresión después de evaluarse.
Sintaxis
width-bucket ( numeric_expression ,
num_of_buckets )
min_value , max_value ,
Ejemplo
width-bucket ( Quantity , 100 , 5000 , 10 )
Resultado
Para cada fila, devuelve el número de grupo (de 0a11)para el valor de cantidad
actual.
Datos de resultado
Quantity width-bucket (Quantity)
50 0
450 1
1400 3
3600 8
4900 10
5000 11
Funciones trigonométricas
arccos
Esta función trigonométrica inversa devuelve el arcocoseno del argumento, donde
el argumento está en el rango de -1 a1yelresultado es un valor expresado en
radianes.
Sintaxis
arccos ( numeric_expression )
Ejemplo
arccos ( -1 )
Resultado
3,1415
arcsin
Esta función trigonométrica inversa devuelve el arcoseno del argumento, donde el
argumento está en el rango de -1 a1yelresultado es un valor expresado en
radianes.
Sintaxis
arcsin ( numeric_expression )
Ejemplo
566 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

arcsin (0)
Resultado
3,1415
arctan
Esta función trigonométrica inversa devuelve la tangente de arco del argumento,
donde el argumento está en el rango de -1 a1yelresultado es un valor expresado
en radianes.
Sintaxis
arctan ( numeric_expression )
Ejemplo
arctan (0)
Resultado
3,1415
cos
Esta función trigonométrica devuelve el coseno del argumento, donde el
argumento es un ángulo expresado en radianes.
Sintaxis
cos ( numeric_expression )
Ejemplo
cos ( 0.3333 * 3.1415 )
Resultado
0,5
coshyp
Esta función trigonométrica devuelve el coseno hiperbólico del argumento, donde
el argumento es un ángulo expresado en radianes.
Sintaxis
coshyp ( numeric_expression )
Ejemplo
coshyp (0)
Resultado
1
sin
Esta función trigonométrica devuelve el seno del argumento, donde el argumento
es un ángulo expresado en radianes.
Sintaxis
sin ( numeric_expression )
Apéndice C. Uso del editor de expresiones 567

Ejemplo
sin ( 0.1667 * 3.1415 )
Resultado
0,5
sinhyp
Esta función trigonométrica devuelve el seno hiperbólico del argumento, donde el
argumento es un ángulo expresado en radianes.
Sintaxis
sinhyp ( numeric_expression )
Ejemplo
sinhyp (0)
Resultado
0
tan
Esta función trigonométrica devuelve la tangente del argumento, donde el
argumento es un ángulo expresado en radianes.
Sintaxis
tan ( numeric_expression )
Ejemplo
tan ( 0.25 * 3.1415 )
Resultado
1
tanhyp
Esta función trigonométrica devuelve la tangente hiperbólica del argumento, donde
el argumento es un ángulo expresado en radianes.
Sintaxis
tanhyp ( numeric_expression )
Ejemplo
tanhyp (0)
Resultado
0
568 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Funciones dimensionales
ancestor
Devuelve el ancestro de "member" en el "level" o en el número de niveles indicado
por "integer" por encima de "member". Nota: No se garantiza que el resultado sea
coherente si existe más de un ancestro.
Sintaxis
ancestor ( member, level|integer )
Ejemplo 1
ancestor ( [TrailChef Water Bag] ,1)
Resultado
Material de cocina
Ejemplo 2
ancestor ( [TrailChef Water Bag] ,2)
Resultado
Equipo de acampada
Ejemplo 3
ancestor ( [TrailChef Water Bag] , [great_outdoors_company].
[Products].[Products].[Product type] )
Resultado
Material de cocina
ancestors
Devuelve todos los ancestros de "member" que se encuentran en "level" oala
distancia de "index" por encima del miembro. (La mayor parte de los orígenes de
datos soportan sólo un ancestro en un nivel especificado. Si el origen de datos
soporta más de un ancestro, el resultado es un conjunto de miembros).
Sintaxis
ancestors ( member , level|index )
Ejemplo 1
ancestors ( [TrailChef Water Bag] ,1)
Resultado
Material de cocina
Ejemplo 2
ancestors ( [TrailChef Water Bag] ,2)
Resultado
Apéndice C. Uso del editor de expresiones 569

Equipo de acampada
Ejemplo 3
ancestors ( [TrailChef Water Bag] , [great_outdoors_company].
[Products].[Products].[Product type] )
Resultado
Material de cocina
bottomCount
Ordena un conjunto en función del valor de "numeric_expression" evaluado en
cada uno de los miembros de "set_expression" y devuelve los últimos miembros
"index_expression".
Sintaxis
bottomCount ( set_expression , index_expression , numeric_expression )
Ejemplo
bottomCount ( [great_outdoors_company].[Products].[Products].[Product
line] ,2,[Revenue] )
Resultado
Devuelve los dos últimos miembros del conjunto ordenados por ingresos.
Datos de resultado
Product line Revenue
Outdoor Protection $3,171,114.92
Mountaineering Equipment $20,891,350.60
bottomPercent
Ordena el conjunto especificado en "set_expression" en orden ascendente y
devuelve los elementos de las últimas posiciones del conjunto ordenado cuyo
porcentaje acumulativo del total es igual o mayor que "percentage".
Sintaxis
bottomPercent ( set_expression , percentage , numeric_expression )
Ejemplo
bottomPercent ( set ( [Camping Equipment] , [Golf Equipment] ,
[Mountaineering Equipment] ),40,[2006] )
Resultado
Para el conjunto de Equipo de acampada, Equipo de golf y Equipo de
montañismo, devuelve los miembros con el menor beneficio bruto cuyo total para
el año 2006 asciende al menos al 40% del total global.
bottomSum
Ordena el conjunto especificado en "set_expression" en orden ascendente y
devuelve los elementos de las últimas posiciones del conjunto ordenado cuyo total
acumulativo es igual o mayor que "value".
570 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Sintaxis
bottomSum ( set_expression , value , numeric_expression )
Ejemplo
bottomSum ( members ( [great_outdoors_company].[Products].[Products].
[Product line] ) , 6000000 , tuple ( [2006] ,
[great_outdoors_company].[Measures].[Gross profit] ) )
Resultado
Para los miembros de Línea de producto, devuelve los miembros con el menor
beneficio bruto cuyo total para el año 2006 asciende al menos a seis millones de
dólares.
caption
Devuelve los valores de título de "level", "member" o "set_expression". El título es
el nombre de visualización de cadena de un elemento y no coincide
necesariamente con el identificador exclusivo que se utiliza para generar el nombre
exclusivo de miembro (MUN) o la clave de empresa del elemento. El título no es
necesariamente exclusivo; por ejemplo, el título de un mes podría devolver el
nombre del mes sin detalles adicionales acerca del año que hagan que el valor sea
exclusivo.
Sintaxis
caption ( level|member|set_expression )
Ejemplo 1
caption ( [TrailChef Water Bag] )
Resultado
Cantimplora flexible Cocinero Viajero
Ejemplo 2
caption ( [great_outdoors_company].[Products].[Products].[Product
line] )
Resultado
Devuelve los valores de título del conjunto Línea de producto.
Datos de resultado
Camping Equipment
Mountaineering Equipment
Personal Accessories
Outdoor Protection
Golf Equipment
children
Devuelve el conjunto de hijos del miembro especificado.
Sintaxis
children ( member )
Ejemplo
Apéndice C. Uso del editor de expresiones 571

children ( [Camping Equipment] )
Resultado
Devuelve el conjunto de hijos de Equipo de acampada.
Datos de resultado
Cooking Gear
Tents
Sleeping Bags
Packs
Lanterns
closingPeriod
Devuelve el último miembro hermano entre los descendientes de un miembro en el
nivel ("level") especificado. Esta función se suele utilizar con una dimensión de
tiempo.
Sintaxis
closingPeriod ( level [ , member ] )
Ejemplo 1
closingPeriod ( [great_outdoors_company].[Years].[Years].[Month] )
Resultado
2006/Dic
Ejemplo 2
closingPeriod ( [great_outdoors_company].[Years].[Years].[Year] )
Resultado
2006
Ejemplo 3
closingPeriod ( [great_outdoors_company].[Years].[Years].[Month] ,
[2006 Q 4] )
Resultado
2006/Dic
cousin
Devuelve el miembro hijo del "member2" con la misma posición relativa que tiene
el "member1" con respecto al padre. Esta función aparece en el informe de ejemplo
Ingresos por filial VA 2005 del paquete Almacén de datos VA (análisis).
Sintaxis
cousin ( member1 , member2 )
Ejemplo 1
cousin ( [Irons] , [Camping Equipment] )
Resultado
572 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Material de cocina
Ejemplo 2
cousin ( [Putters] , [Camping Equipment] )
Resultado
Sacos de dormir
completeTuple
Identifica la ubicación de una celda (intersección) según los miembros
especificados, cada uno de los cuales debe ser de una dimensión diferente. Sin
embargo, completeTuple () incluye implícitamente el miembro predeterminado de
todas las dimensiones en lugar del miembro actual, a menos que se especifique lo
contrario en los argumentos. CompleteTuple utilizará la medida predeterminada en
lugar de currentMeasure en la consulta si la medida no se ha definido en la
función completetuple. Esta función aparece en el informe de ejemplo Personal
planificado del paquete Almacén de datos VA (análisis).
Sintaxis
completeTuple ( member { , member } )
Ejemplo 1
completeTuple ( [Mountaineering Equipment] , [Fax] )
Resultado
El valor completeTuple no selecciona el valor currentMember de forma
predeterminada como hace la función tuple. Los valores de la primera columna
son idénticos cada año porque se utiliza el miembro predeterminado de la
dimensión Años, el miembro raíz, en lugar del miembro actual. Asimismo, en la
primera columna se muestra Ingresos en lugar de Cantidad vendida porque la
medida Ingresos es el valor predeterminado de la dimensión Medidas.
CompleteTuple utilizará la medida predeterminada en lugar de currentMeasure en
la consulta si la medida no se ha definido en la función completetuple.
Datos de resultado
Quantity Sold Mountaineering Sales by Fax
2004 $1,220,329.38
2005 $1,220,329.38
2006 $1,220,329.38
Ejemplo 2
completeTuple ( [Mountaineering Equipment] , [Fax] , [Quantity sold] ,
currentMember ( [great_outdoors_company].[Years].[Years] ) )
Resultado
La función completeTuple utiliza el valor currentMember de la dimensión Años y
la medida Cantidad vendida.
Datos de resultado
Apéndice C. Uso del editor de expresiones 573

Quantity Sold Mountaineering Sales by Fax
2004 0
2005 8,746
2006 7,860
currentMember
Devuelve el miembro actual de la jerarquía durante una iteración. Si "hierarchy" no
está presente en el contexto en que se evalúa la expresión, se presupone el
miembro predeterminado. Esta función aparece en el informe de ejemplo
interactivo Promedios renovables y móviles.
Sintaxis
currentMember ( hierarchy )
defaultMember
Devuelve el miembro predeterminado de "hierarchy".
Sintaxis
defaultMember ( hierarchy )
Ejemplo 1
defaultMember ( [great_outdoors_company].[Products].[Products] )
Resultado
Productos
Ejemplo 2
defaultMember ( [great_outdoors_company].[Years].[Years] )
Resultado
Year
Ejemplo 3
defaultMember ( hierarchy ( [great_outdoors_company].[Measures].
[Quantity sold] ) )
Resultado
Revenue
descendants
Devuelve el conjunto de descendientes de "member" o "set_expression" en "level"
(nombre cualificado) o "distance" (entero 0..n) de la raíz. Se pueden especificar
varias opciones (separadas por un espacio) para determinar los miembros que se
devuelven. self: Sólo los miembros de un nivel especificado se incluyen en el
conjunto final (se trata del comportamiento predeterminado cuando faltan
opciones). before: Si hay algún nivel intermedio entre el nivel del miembro y el
especificado, se incluyen los miembros de estos niveles. Si el nivel especificado es
igual que el miembro en el que se aplica la función, el miembro se incluye en el
conjunto final. beforewithmember: Si hay algún nivel intermedio entre el nivel del
miembro y el especificado, se incluyen los miembros de estos niveles. El miembro
574 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

en el que se aplica la función también se incluye en el conjunto final. after: Si
existen otros niveles después del especificado, los miembros de esos niveles se
incluyen en el conjunto final. Esta función aparece en el informe de ejemplo
Comisiones de ventas para Europa central del paquete Almacén de datos VA
(análisis).
Sintaxis
descendants ( member|set_expression , level|distance [ ,
{ self|before|beforewithmember|after }])
Ejemplo 1
descendants ( [great_outdoors_company].[Products].[Products].
[Products] , [great_outdoors_company].[Products].[Products].[Product
type] )
Resultado
Devuelve el conjunto de descendientes del conjunto Productos en el nivel Tipo de
producto. Nota: [great_outdoors_company].[Products].[Products].[Products] es el
miembro raíz de la jerarquía Products.
Datos de resultado
Cooking Gear
Sleeping Bags
Packs
Tents
...
Eyewear
Knives
Watches
Ejemplo 2
descendants ( [great_outdoors_company].[Products].[Products].
[Products] ,1)
Resultado
Devuelve el conjunto de descendientes del conjunto Productos del primer nivel.
Datos de resultado
Camping Equipment
Golf Equipment
Mountaineering Equipment
Outdoor Protection
Personal Accessories
Ejemplo 3
descendants ( [great_outdoors_company].[Products].[Products].
[Products] ,3,before )
Resultado
Devuelve los descendientes del conjunto Productos anteriores al tercer nivel.
Datos de resultado
Camping Equipment
Cooking Gear
Sleeping Bags
Apéndice C. Uso del editor de expresiones 575

Packs
Tents
...
Eyewear
Knives
Watches
Ejemplo 4
descendants ( [great_outdoors_company].[Products].[Products].
[Products] ,2,self before )
Resultado
Devuelve el conjunto de descendientes del conjunto Productos anteriores al
segundo nivel, éste inclusive.
Datos de resultado
Camping Equipment
Cooking Gear
Sleeping Bags
Packs
Tents
...
Eyewear
Knives
Watches
except
Devuelve los miembros de "set_expression1" que no están también en
"set_expression2". Los duplicados sólo se retienen si se proporciona la palabra
clave opcional "all" como tercer argumento.
filter
Sintaxis
except ( set_expression1 , set_expression2 [,all])
Ejemplo
except ( set ( [Camping Equipment] , [Mountaineering Equipment] ) ,
set ( [Camping Equipment] , [Golf Equipment] ) )
Resultado
Equipo de montañismo
Devuelve el conjunto que se obtiene de filtrar un conjunto especificado basado en
una condición booleana. En el resultado se incluyen todos los miembros si, y sólo
si, el valor correspondiente de "Boolean_expression" es verdadero.
Sintaxis
filter ( set_expression , Boolean_expression )
Ejemplo
filter ( [Product line] , [Gross margin] > .30 )
Resultado
Equipo de montañismo
576 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

firstChild
Devuelve el primer hijo de "member".
Sintaxis
firstChild ( member )
Ejemplo 1
firstChild ( [By Product Lines] )
Resultado
Equipo de acampada
Ejemplo 2
firstChild ( [Camping Equipment] )
Resultado
Material de cocina
firstSibling
Devuelve el primer hijo del elemento padre de "member".
Sintaxis
firstSibling ( member )
Ejemplo 1
firstSibling ( [Outdoor Protection] )
Resultado
Equipo de acampada
Ejemplo 2
firstSibling ( [Camping Equipment] )
Resultado
Equipo de acampada
_format
Asocia un formato a la expresión. La palabra_clave_formato puede ser
PERCENTAGE_0, PERCENTAGE_1 o PERCENTAGE_2. PERCENTAGE_1 devuelve
un porcentaje con un dígito a la derecha del separador decimal, PERCENTAGE_2
devuelve un porcentaje con dos dígitos a la derecha del separador decimal y
PERCENTAGE_3 devuelve un porcentaje con tres dígitos a la derecha del
separador decimal (por ejemplo, 0,965).
Sintaxis
_format ( expression , format_keyword )
Ejemplo
_format ( [Unit Sale Price] / [Unit Price] , PERCENTAGE_2 )
Apéndice C. Uso del editor de expresiones 577

Resultado
75,12%
emptySet
Devuelve un conjunto de miembros vacío para "hierarchy". Se suele utilizar como
marcador de posición durante el desarrollo o con el diseño de informes dinámicos
(ya sea con IBM ® Cognos ® Software Development Kit o mediante el diseño de
informes). Mediante la creación de un elemento de datos que contiene la función
emptyset, se pueden crear expresiones complejas que posteriormente se pueden
revisar volviendo a definir el elemento de datos emptyset.
Sintaxis
emptySet ( hierarchy )
Ejemplo
except ( [great_outdoors_company].[Products].[Products].[Product
line] , emptySet ( [great_outdoors_company].[Products].[Products] ) )
Resultado
Devuelve el conjunto Línea de producto y un conjunto vacío para el conjunto
Productos.
Datos de resultado
Camping Equipment
Golf Equipment
Mountaineering Equipment
Outdoor Protection
Personal Accessories
generate
Evalúa "set_expression2" para cada miembro de "set_expression1" y une los
conjuntos resultantes por unión. El resultado sólo retiene los duplicados cuando se
proporciona la palabra clave opcional "all" como tercer argumento.
head
Sintaxis
generate ( set_expression1 , set_expression2 [,all])
Ejemplo
generate ( [Product line] , topCount ( descendants ( currentMember (
[great_outdoors_company].[Products].[Products] ) ,
[great_outdoors_company].[Products].[Products].[Product name] ),2,
[Revenue] ) )
Resultado
Devuelve los dos primeros productos por ingresos para cada línea de producto.
Devuelve el primero de los elementos de "index_expression" de "set_expression". El
valor predeterminado de "index_expression" es 1.
Sintaxis
head ( set_expression [ , index_expression ] )
578 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Ejemplo 1
head ( members ( [great_outdoors_company].[Products].[Products].
[Product line] ) )
Resultado
Equipo de acampada
Ejemplo 2
head ( members ( [great_outdoors_company].[Products].[Products].
[Product line] ),2)
Resultado
Devuelve los dos primeros miembros del conjunto Línea de producto.
Datos de resultado
Camping Equipment
Mountaineering Equipment
hierarchize
Ordena los miembros de "set_expression" en una jerarquía. Los miembros de un
nivel se ordenan según su orden natural. Éste es el orden predeterminado de los
miembros de una dimensión si no se especifica ninguna otra condición de
ordenación.
Sintaxis
hierarchize ( set_expression )
Ejemplo
hierarchize ( set ( [Golf Equipment] , [Mountaineering Equipment] ,
[Camping Equipment] ) )
Resultado
Devuelve Equipo de acampada, Equipo de golf, Equipo de montañismo.
hierarchy
Devuelve la jerarquía que contiene "level", "member" o "set_expression".
Sintaxis
hierarchy ( level|member|set_expression )
Ejemplo 1
hierarchy ( [Cooking Gear] )
Resultado
Devuelve cada miembro de la jerarquía que contenga Material de cocina.
Datos de resultado
Products
Camping Equipment
Cooking Gear
TrailChef Water Bag
Apéndice C. Uso del editor de expresiones 579

item
TrailChef Canteen
...
Mountain Man Extreme
Mountain Man Deluxe
Ejemplo 2
hierarchy ( [great_outdoors_company].[Products].[Products].[Product
line] )
Resultado
Devuelve cada miembro de la jerarquía que contenga Línea de producto.
Datos de resultado
Products
Camping Equipment
Cooking Gear
TrailChef Water Bag
TrailChef Canteen
...
Mountain Man Extreme
Mountain Man Deluxe
Devuelve un miembro de la ubicación "index" dentro de "set_expression". El índice
del conjunto empieza desde cero.
Sintaxis
item ( set_expression , index )
Ejemplo
item ( children ( [Camping Equipment] ),2)
Resultado
Sacos de dormir
intersect
Devuelve la intersección de "set_expression1" y "set_expression2". El resultado sólo
retiene los duplicados cuando se proporciona la palabra clave opcional "all" como
tercer argumento.
lag
Sintaxis
intersect ( set_expression1 , set_expression2 [,all])
Ejemplo
intersect ( set ( [Camping Equipment] , [Mountaineering Equipment] ) ,
set ( [Camping Equipment] , [Outdoor Protection] ,),all)
Resultado
Equipo de acampada
Devuelve el miembro hermano que aparece el número de posiciones de
"index_expression" antes de "member".
580 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Sintaxis
lag ( member , index_expression )
Ejemplo 1
lag ( [Tents] ,1)
Resultado
Material de cocina
Ejemplo 2
lag ( [Tents] , -2 )
Resultado
Paquetes
lastChild
Devuelve el último hijo del miembro especificado.
Sintaxis
lastChild ( member )
Ejemplo 1
lastChild ( Cooking Gear )
Resultado
Cubiertos Cocinero Viajero
Ejemplo 2
lastChild ( [By Product Line] )
Resultado
Equipo de golf
lastPeriods
Devuelve el conjunto de miembros del mismo nivel que termina con "member". El
número de miembros devueltos es el valor absoluto de "integer_expression". Si
"integer_expression" es un valor negativo, se devuelven los miembros que se
encuentran a continuación del miembro especificado, éste inclusive. Se utiliza
normalmente con una dimensión de tiempo. Esta función aparece en el informe de
ejemplo interactivo Promedios renovables y móviles.
Sintaxis
lastPeriods ( integer_expression , member )
Ejemplo 1
lastPeriods (2,[2006 Q 4] )
Resultado
Devuelve los dos últimos miembros a partir del nivel que termina con 2006 T 4.
Apéndice C. Uso del editor de expresiones 581

Datos de resultado
2006 Q 3
2006 Q 4
Ejemplo 2
lastPeriods ( -3 , [2006 Q 4] )
Resultado
Devuelve los tres últimos miembros a partir del nivel que empieza con 2006 T 4.
Datos de resultado
2006 Q 4
2007 Q 1
2007 Q 2
lastSibling
Devuelve el último hijo del padre de un miembro especificado.
lead
Sintaxis
lastSibling ( member )
Ejemplo
lastSibling ( [Camping Equipment] )
Resultado
Equipo de golf
Devuelve el miembro hermano que aparece el número de posiciones de
"index_expression" después de "member". Si "index_expression" es negativa,
devuelve el miembro hermano que aparece el número de posiciones
"index_expression" antes de "member".
Sintaxis
lead ( member , index_expression )
Ejemplo 1
lead ( [Outdoor Protection] ,1)
Resultado
Accesorios personales
Ejemplo 2
lead ( [Outdoor Protection] , -2 )
Resultado
Equipo de golf
582 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

level
Devuelve el nivel de "member".
Sintaxis
level ( member )
Ejemplo
level ( [Golf Equipment] )
Resultado
Devuelve los miembros del nivel Equipo de golf.
Datos de resultado
Camping Equipment
Mountaineering Equipment
Personal Accessories
Outdoor Protection
Golf Equipment
niveles
Devuelve el nivel de "hierarchy" cuya distancia desde la raíz se especifica en
"index".
Sintaxis
levels ( hierarchy , index )
Ejemplo 1
levels ( [great_outdoors_company].[Products].[Products] ,2)
Resultado
Devuelve los miembros a dos niveles de la jerarquía raíz Productos.
Datos de resultado
Cooking Gear
Sleeping Bags
Packs
Tents
...
Irons
Putters
Woods
Golf Accessories
Ejemplo 2
levels ( [great_outdoors_company].[Products].[Products] ,1)
Resultado
Devuelve los miembros a un nivel de la jerarquía raíz Productos.
Datos de resultado
Apéndice C. Uso del editor de expresiones 583

Camping Equipment
Mountaineering Equipment
Personal Accessories
Outdoor Protection
Golf Equipment
linkMember
Devuelve el miembro correspondiente del "level" o la "hierarchy" (de la misma
dimensión). En las jerarquías basadas en niveles, debe especificarse un nivel como
segundo argumento y, en las jerarquías padre-hijo, debe especificarse una jerarquía.
Se envía una excepción cuando el segundo parámetro no se resuelve como una
jerarquía de la dimensión del miembro. Tenga en cuenta que no se soportan
miembros calculados como el primer argumento.
Sintaxis
linkMember ( member , level|hierarchy )
members
Devuelve el conjunto de miembros de "hierarchy" o "level". En el caso de una
jerarquía, no se garantiza el orden de los miembros en el resultado. Si se necesita
un orden predecible, se debe utilizar una función de ordenación explícita (como
hierarchize).
Sintaxis
members ( hierarchy|level )
Ejemplo 1
members ( [great_outdoors_company].[Years].[Years] )
Resultado
Devuelve los miembros de Años.
Ejemplo 2
members ( [great_outdoors_company].[Products].[Products].[Product
line] )
Resultado
Devuelve los miembros de Línea de producto.
nextMember
Devuelve el siguiente miembro del nivel "member".
Sintaxis
nextMember ( member )
Ejemplo
nextMember ( [Outdoor Protection] )
Resultado
Equipo de golf
584 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

openingPeriod
Devuelve el primer miembro hermano entre los descendientes de un miembro en
el nivel ("level") especificado. Esta función se suele utilizar con una dimensión de
tiempo.
order
Sintaxis
openingPeriod ( level [ , member ] )
Ejemplo 1
openingPeriod ( [great_outdoors_company].[Years].[Years].[Month] )
Resultado
2004/Ene
Ejemplo 2
openingPeriod ( [great_outdoors_company].[Years].[Years].[Year] )
Resultado
2004
Ejemplo 3
openingPeriod ( [great_outdoors_company].[Years].[Years].[Month] ,
[2006 Q 4] )
Resultado
2006/Oct
Organiza los miembros de "set_expression" en función de su "value_expression" y
el tercer parámetro. ASC y DESC organizan los miembros en orden ascendente o
descendente respectivamente, según su posición en la jerarquía del conjunto. A
continuación, se distribuyen los hijos de cada miembro según "value_expression".
BASC y BDESC organizan los miembros del conjunto sin tener en cuenta la
jerarquía. Si no se especifica otro valor, ASC es el valor predeterminado.
Sintaxis
order ( set_expression , value_expression [ , ASC|DESC|BASC|BDESC ] )
Ejemplo 1
order ( members ( [Great Outdoors Company].[Product].[Product].
[Product type] ) , [Quantity sold] , BASC )
Resultado
Devuelve la cantidad vendida de cada tipo de producto sin ningún orden en
particular.
Datos de resultado
Product Line Quantity
Woods 13,924
Apéndice C. Uso del editor de expresiones 585

Product Line Quantity
Irons 14,244
Safety 22,332
... ...
Sunscreen 215,432
Insect Repellents 270,074
Lanterns 345,096
Ejemplo 2
order ( members ( [Great Outdoors Company].[Product].[Product].
[Product type] ) , [Quantity sold] , ASC )
Resultado
Devuelve la cantidad vendida de cada tipo de producto en orden ascendente.
Datos de resultado
Product Line Quantity
Woods 13,924
Irons 14,244
Putters 23,244
... ...
Tents 130,664
Cooking Gear 198,676
Lanterns 345,096
ordinal
Devuelve el valor ordinal basado en cero (distancia desde el nivel raíz) de "level".
Sintaxis
ordinal ( level )
Ejemplo 1
ordinal ( [great_outdoors_company].[Products].[Products].[Product
line] )
Resultado
1
Ejemplo 2
ordinal ( [great_outdoors_company].[Products].[Products].[Product
type] )
Resultado
2
parallelPeriod
Devuelve un miembro de un periodo anterior en la misma posición relativa que
"member". Esta función es similar a la función cousin, pero está más directamente
relacionada con la serie temporal. Toma el ancestro de "member" en "level"
586 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

(denominado "ancestor") y el hermano de "ancestor" que queda atrás
"integer_expression" posiciones y devuelve el periodo paralelo de "member"
existente entre los descendientes de ese hermano. Cuando no se especifica,
"integer_expression" toma 1 como valor predeterminado y "member" toma el
miembro actual como valor predeterminado.
Sintaxis
parallelPeriod ( level [ , integer_expression [ , member ]])
Ejemplo 1
parallelPeriod ( [great_outdoors_company].[Years].[Years].[Quarter] ,
-1 , [2006/Aug] )
Resultado
2006/Nov
Ejemplo 2
parallelPeriod ( [great_outdoors_company].[Years].[Years].[Quarter] ,
1 , [2006/Aug] )
Resultado
2006/May
Ejemplo 3
parallelPeriod ( [great_outdoors_company].[Years].[Years].[Year] ,2,
[2006/Aug] )
Resultado
2004/Ago
parent
Devuelve el miembro que es el elemento padre de "member" o "measure".
Sintaxis
parent ( member|measure )
Ejemplo
parent ( [Cooking Gear] )
Resultado
Equipo de acampada
periodsToDate
Devuelve un conjunto de miembros hermanos del mismo nivel que "member", en
función de la restricción de "level". Localiza el ancestro de "member" de "level" y
devuelve los descendientes de ese ancestro que corresponden al mismo nivel que
"member" (hasta "member", éste inclusive). Se utiliza normalmente con una
dimensión de tiempo. Esta función aparece en el informe de ejemplo interactivo
Promedios renovables y móviles.
Apéndice C. Uso del editor de expresiones 587

Sintaxis
periodsToDate ( level , member )
Ejemplo
periodsToDate ( [great_outdoors_company].[Years].[Years].[Year] ,
[2004/Mar] )
Resultado
Devuelve valores de [2004/Ene], [2004/Feb], [2004/Mar]
prevMember
Devuelve el miembro inmediatamente anterior a "member" en el mismo nivel. Esta
función aparece en el informe de ejemplo Crecimiento de ventas año tras año en el
paquete Almacén de datos VA (análisis).
Sintaxis
prevMember ( member )
Ejemplo 1
prevMember ( [Outdoor Protection] )
Resultado
Accesorios personales
Ejemplo 2
prevMember ( [2005] )
Resultado
2004
member
Define un miembro en función de "value_expression" de "hierarchy". "String1"
identifica el miembro que se crea mediante esta función. Debe ser exclusivo en la
consulta y diferente de cualquier otro miembro de la misma jerarquía. "String2" es
el título del miembro; si no está presente, el título está vacío. Para garantizar la
obtención de resultados previsibles, se recomienda proporcionar la "jerarquía".
Nota: Todos los cálculos que se han utilizado para agrupar elementos cuyos
elementos hermanos son otros cálculos o conjuntos de miembros deben asignarse
de forma explícita a una jerarquía mediante la utilización de esta función. De lo
contrario, los resultados no son predecibles. La única excepción se produce cuando
el cálculo incluye sólo miembros de la misma jerarquía que los hermanos. En este
caso, se presupone que el cálculo pertenece a esa jerarquía.
Sintaxis
member ( value_expression [ , string1 [ , string2 [ ,
hierarchy ]]])
Ejemplo
588 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

member ( total ( currentMeasure within set filter (
[great_outdoors_company].[Products].[Products].[Product name] ,
caption ( [great_outdoors_company].[Products].[Products].[Product
name] ) starts with ’B’ )),’BProducts’ , ’B Products’ ,
[great_outdoors_company].[Products].[Products] )
Resultado
Devuelve la cantidad vendida y los ingresos de todos los productos que empiecen
por la letra B.
nestedSet
Esta función se ha concebido para utilizarse únicamente con Analysis Studio.
set
Sintaxis
nestedSet ( set_expression1 , set_expression2 )
Devuelve la lista de miembros definida en la expresión. Los miembros deben
pertenecer a la misma jerarquía.
Sintaxis
set ( member { , member } )
Ejemplo
set ( [Golf Equipment] , [Irons] , [TrailChef Cup] )
Resultado
Devuelve Equipo de golf, Hierros y Taza Cocinero Viajero.
siblings
Devuelve los hijos del padre del miembro especificado.
tail
Sintaxis
siblings ( member )
Ejemplo
siblings ( [Golf Equipment] )
Resultado
Devuelve los hermanos de Equipo de golf.
Datos de resultado
Camping Equipment
Golf Equipment
Mountaineering Equipment
Outdoor Protection
Personal Accessories
Devuelve los últimos elementos de "index_expression" de "set_expression". El valor
predeterminado de "index_expression" es 1.
Apéndice C. Uso del editor de expresiones 589

Sintaxis
tail ( set_expression [ , index_expression ] )
Ejemplo 1
tail (members ( [great_outdoors_company].[Products].[Products].
[Product line] ) )
Resultado
Devuelve el último miembro del conjunto Línea de producto.
Datos de resultado
Personal Accessories
Ejemplo 2
tail ( members ( [great_outdoors_company].[Products].[Products].
[Product line] ),2)
Resultado
Devuelve los dos últimos miembros del conjunto Línea de producto.
Datos de resultado
Outdoor Protection
Personal Accessories
topCount
Ordena un conjunto en función de los valores de "numeric_expression" que se han
evaluado en cada uno de los miembros de "set_expression" y devuelve los
primeros miembros de "index_expression".
Sintaxis
topCount ( set_expression , index_expression , numeric_expression )
Ejemplo
topCount ( [great_outdoors_company].[Products].[Products].[Product
line] ,2,[Revenue] )
Resultado
Devuelve los dos primeros ingresos del conjunto Línea de producto.
Datos de resultado
Product line Revenue
Camping Equipment $89,713,990.92
Personal Accessories $31,894,465.86
topPercent
Ordena el conjunto especificado en "set_expression" en orden descendente y
devuelve los elementos de las primeras posiciones del conjunto ordenado cuyo
porcentaje acumulativo del total es igual o mayor que "percentage".
Sintaxis
590 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

topPercent ( set_expression , percentage , numeric_expression2 )
Ejemplo
topPercent ( set ( [Camping Equipment] , [Golf Equipment] ,
[Mountaineering Equipment] ),40,[2006] )
Resultado
Para el conjunto de Equipo de acampada, Equipo de golf y Equipo de
montañismo, devuelve los miembros con el mayor beneficio bruto cuyo total para
el año 2006 asciende al menos al 40% del total global.
topSum
Ordena el conjunto especificado en "set_expression" en orden descendente y
devuelve los elementos de las primeras posiciones del conjunto ordenado cuyo
total acumulativo es igual o mayor que "value".
tuple
union
Sintaxis
topSum ( set_expression , value , numeric_expression2 )
Ejemplo
topSum ( children ( [Products] ) , 16000000 , tuple ( [2006] ,
[great_outdoors_company].[Measures].[Gross profit] ) )
Resultado
Para los miembros de Línea de producto, devuelve los miembros con el mayor
beneficio bruto cuyo total para el año 2006 asciende al menos a seis millones de
dólares.
Identifica la ubicación de una celda (intersección) según los miembros
especificados, cada uno de los cuales debe ser de una dimensión diferente. Esta
función incluye de manera implícita el miembro actual de todas las dimensiones
que no se han especificado de otra forma en los argumentos. Se presupone que el
miembro actual de cualquier dimensión no especificada en el contexto de
evaluación es el miembro predeterminado de dicha dimensión. El valor de esta
celda se puede obtener con la función "value".
Sintaxis
tuple ( member { , member } )
Ejemplo
tuple ( [Mountaineering Equipment] , [Fax] )
Resultado
Devuelve las ventas de Equipo de montañismo por fax.
Devuelve datos para "set_expression1" y "set_expression2". El resultado sólo retiene
los duplicados cuando se proporciona la palabra clave opcional "all" como tercer
argumento.
Apéndice C. Uso del editor de expresiones 591

Sintaxis
union ( set_expression1 , set_expression2 [,all])
Ejemplo 1
union ( set ( [Camping Equipment] , [Golf Equipment] ) , set ( [Golf
Equipment] , [Mountaineering Equipment] ) )
Resultado
Devuelve datos para ambos conjuntos como un solo conjunto nuevo y muestra la
columna Equipo de golf sólo una vez.
Ejemplo 2
union ( set ( [Camping Equipment] , [Golf Equipment] ) , set ( [Golf
Equipment] , [Mountaineering Equipment] ) , all )
Resultado
Devuelve datos para ambos conjuntos como un solo conjunto nuevo y muestra la
columna Equipo de golf dos veces.
roleValue
Devuelve el valor del atributo asociado al rol cuyo nombre especifica "string" en el
contexto especificado. "Member" o "set_expression" sólo es opcional en un reducido
número de circunstancias, donde puede obtenerse de otro contexto. Las
aplicaciones se pueden trasladar de un origen de datos o modelo a otro si se
accede a los atributos por rol, en lugar de por el ID del elemento de consulta. En
los orígenes de datos relacionales modelados dimensionalmente (DMR), la
asignación de los roles es responsabilidad del modelador. Los roles intrínsecos que
se definen para los miembros de todos los tipos de orígenes de datos incluyen:
'_businessKey', '_memberCaption', '_memberDescription' y '_memberUniqueName'.
Se pueden definir más roles en Framework Manager para cada uno de los niveles
de una jerarquía. Por ejemplo, un nivel de tipo de producto podría tener una
columna de atributos denominada "Tipo de contenedor de envío", y el nivel de
producto podría tener un atributo "Contenedor de envío del producto". A cada uno
de ellos se le podría asignar un rol personalizado en Framework Manager
denominado "Contenedor". A continuación, se podría hacer referencia a la
propiedad independientemente del nombre de columna real mediante la función
roleValue.
Sintaxis
roleValue ( string [ , member|set_expression ] )
Ejemplo 1
roleValue ( ’_memberCaption’ , [Sales].[Product].[Product].[Product
line] -> [all].[1] )
Resultado
Equipo de acampada
Ejemplo 2
roleValue ( ’_businessKey’ , [great_outdoors_company].[Years].[Years].
[Year] )
592 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Resultado
Devuelve el valor del atributo asociado al rol clave de empresa.
Datos de resultado
("2004-01-01","2004-12-31")
("2005-01-01","2005-12-31")
("2006-01-01","2006-12-31")
Ejemplo 3
roleValue ( ’_memberUniqueName’ , [great_outdoors_company].[Years].
[Years].[Year] )
Resultado
Devuelve el valor del atributo que se asocia al rol del MUN.
Datos de resultado
[great_outdoors_company].[Years].[Years].[Year] ->:[PC].[Years (
Root)].[20040101-20041231]
[great_outdoors_company].[Years].[Years].[Year] ->:[PC].[Years (
Root)].[20050101-20051231]
[great_outdoors_company].[Years].[Years].[Year] ->:[PC].[Years (
Root)].[20060101-20061231]
rootMember
Devuelve el miembro raíz de una jerarquía de raíz única. Esta función aparece en
el informe de ejemplo Éxito promocional del paquete Almacén de datos VA
(análisis).
Sintaxis
rootMember ( hierarchy )
rootMembers
Devuelve los miembros raíz de una jerarquía.
Sintaxis
rootMembers ( hierarchy )
Ejemplo
rootMembers ( [great_outdoors_company].[Years].[Years] )
Resultado
Por tiempo
subset
Devuelve un subconjunto de miembros de "set_expression" empezando por
"index_expression1" desde el principio. Si se especifica el recuento
"index_expression2", se devuelve ese número de miembros (si están disponibles).
De lo contrario, se devuelven todos los miembros restantes.
Sintaxis
subset ( set_expression, index_expression1 [ , index_expression2 ] )
Apéndice C. Uso del editor de expresiones 593

Ejemplo 1
subset ( members ( [great_outdoors_company].[Products].[Products].
[Product line] ),2)
Resultado
Devuelve los miembros del conjunto Línea de producto empezando en el segundo
miembro.
Datos de resultado
Mountaineering Equipment
Outdoor Protection
Personal Accessories
Ejemplo 2
subset ( members ( [great_outdoors_company].[Products].[Products].
[Product line] ),2,2)
Resultado
Devuelve dos miembros del conjunto Línea de producto empezando en el segundo
miembro.
Datos de resultado
Mountaineering Equipment
Outdoor Protection
exclusivos
Elimina todos los duplicados de "set_expression". Los miembros que quedan
permanecen en el orden original.
value
Sintaxis
unique ( set_expression )
Devuelve el valor de la celda identificada por "tuple". Tenga en cuenta que el
miembro predeterminado de la dimensión de medidas es la medida
predeterminada.
Sintaxis
value ( tuple )
Ejemplo 1
value ( tuple ( [great_outdoors_company].[Years].[Years].[Year]
->:[PC].[Years (Root)].[20040101-20041231] , [great_outdoors_company].
[Measures].[Revenue] ) )
Resultado
$34.750.563,50
Ejemplo 2
value ( tuple ( [2004] , [Camping Equipment] , [Revenue] ) )
Resultado
594 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

$20.471.328,88
Funciones de informe
Today
Now
Devuelve la fecha actual del sistema.
Sintaxis
Today ()
Devuelve la hora actual del sistema.
Sintaxis
Now ()
AsOfDate
Devuelve el valor de fecha de la expresión AsOfDate, si se ha definido. De lo
contrario, AsOfDate devuelve la fecha de ejecución del informe.
Sintaxis
AsOfDate ()
AsOfTime
Devuelve el valor de hora de la expresión AsOfTime, si se ha definido. De lo
contrario, AsOfTime devuelve la hora de ejecución del informe.
Sintaxis
AsOfTime ()
ReportDate
Devuelve la fecha y la hora de ejecución del informe.
Sintaxis
ReportDate ()
ReportName
Devuelve el nombre de informe. Esta función sólo está activa cuando el informe se
ejecuta desde IBM ® Cognos ® Connection.
Sintaxis
ReportName ()
ReportPath
Devuelve la ruta del informe. Esta función sólo está activa cuando el informe se
ejecuta desde IBM ® Cognos ® Connection.
Sintaxis
ReportPath ()
Apéndice C. Uso del editor de expresiones 595

ReportDescription
Devuelve la descripción del informe. Esta función sólo está activa cuando el
informe se ejecuta desde IBM ® Cognos ® Connection.
Sintaxis
ReportDescription ()
ReportLocale
Devuelve el entorno local de ejecución.
Sintaxis
ReportLocale ()
GetLocale
Devuelve el entorno local de ejecución (obsoleto).
Sintaxis
GetLocale ()
Locale
Devuelve el entorno local de ejecución.
Sintaxis
Locale ()
ReportProductLocale
Devuelve el entorno local del producto.
Sintaxis
ReportProductLocale ()
ReportAuthorLocale
Devuelve el entorno local del autor.
Sintaxis
ReportAuthorLocale ()
ReportSaveDate
Devuelve la fecha de la última vez que se ha guardado el informe.
Sintaxis
ReportSaveDate ()
ReportCreateDate
Devuelve la fecha de creación del informe.
Sintaxis
ReportCreateDate ()
596 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

ReportID
Devuelve el ID de informe.
Sintaxis
ReportID ()
ReportOutput
Devuelve el nombre del formato de salida, como CSV, HTML, layoutDataXML,
MHT, PDF, rawXML, singleXLS, spreadsheetML, XLS, XML o XLWA.
Sintaxis
ReportOutput ()
ReportOption
Devuelve el valor de la variable de opción de ejecución identificada por
"optionName", como attachmentEncoding, burst, cssURL, email,
emailAsAttachment, emailAsURL, emailBody, emailSubject, emailTo,
emailToAddress, metadataModel, outputEncapsulation, outputFormat,
outputLocale, outputPageDefinition, outputPageOrientation,
primaryWaitThreshold, print, printer, printerAddress, prompt, promptFormat,
saveAs, saveOutput, secondaryWaitThreshold, verticalElements o xslURL.
Sintaxis
ReportOption (’optionName’)
ServerName
Devuelve el nombre del servidor web en el que se ha originado la solicitud. El
valor puede estar vacío si la solicitud se ejecuta desde el planificador.
Sintaxis
ServerName ()
ServerLocale
Devuelve el entorno local del servidor que ejecuta el informe.
Sintaxis
ServerLocale ()
ModelPath
Devuelve la ruta del modelo.
Sintaxis
ModelPath ()
BurstKey
Devuelve la clave de separación.
Sintaxis
BurstKey ()
Apéndice C. Uso del editor de expresiones 597

BurstRecipients
Devuelve la lista de distribución de los destinatarios de la separación.
Sintaxis
BurstRecipients ()
IsBursting
Devuelve el valor booleano 1 (true) cuando el informe se va a distribuir al
destinatario; de lo contrario, devuelve el valor booleano 0 (false).
Sintaxis
IsBursting (’recipientName’)
ParamNames
Devuelve todos los nombres de parámetro.
Sintaxis
ParamNames ()
ParamName
Devuelve el nombre de parámetro de "parameterName".
Sintaxis
ParamName (’parameterName’)
ParamDisplayValue
Devuelve una cadena que es el valor de visualización del parámetro de
"parameterName". Esta función aparece en el informe de ejemplo Informe de
contratación del paquete Almacén de datos VA (análisis).
Sintaxis
ParamDisplayValue (’parameterName’)
ParamValue
Devuelve el valor de parámetro de "parameterName".
Sintaxis
ParamValue (’parameterName’)
ParamCount
Devuelve el recuento de parámetros de "parameterName".
Sintaxis
ParamCount (’parameterName’)
RowNumber
Devuelve la fila actual.
Sintaxis
RowNumber ()
598 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

PageNumber
Devuelve el número de la página actual.
Sintaxis
PageNumber ()
PageCount
Devuelve el recuento de páginas actual. Esta función sólo está activa cuando el
informe se genera en formato Adobe ® PDF o Microsoft ® Excel. Si guarda la salida
del informe, esta función sirve para todos los formatos.
Sintaxis
PageCount ()
IsPageCountAvailable
Devuelve el valor booleano 1 (true) si el recuento de páginas está disponible para
la ejecución actual del informe; en caso contrario, devuelve el valor booleano 0
(false).
Sintaxis
IsPageCountAvailable ()
HorizontalPageNumber
Devuelve el número actual de página horizontal.
Sintaxis
HorizontalPageNumber ()
HorizontalPageCount
Devuelve el recuento actual de páginas horizontales.
Sintaxis
HorizontalPageCount ()
PageName
Devuelve el nombre de la página actual.
Sintaxis
PageName ()
URLEncode
Devuelve el valor codificado de URL del texto de entrada.
Sintaxis
URLEncode (’text’)
TOCHeadingCount
Devuelve el recuento de cabeceras de la tabla de contenido para un nivel de
cabecera especificada.
Sintaxis
Apéndice C. Uso del editor de expresiones 599

TOCHeadingCount ( headingLevel )
IsAccessible
Devuelve el valor booleano 1 (true) si el informe se ejecuta con las características
de accesibilidad habilitadas. Utilice esta función como expresión variable con un
bloque condicional para que los informes sean accesibles. Por ejemplo, puede
añadir un equivalente de lista o tabla de referencias cruzadas a un gráfico en los
informes que se ejecutan con las características de accesibilidad habilitadas.
Sintaxis
IsAccessible()
ColumnNumber
Devuelve el número de columna actual.
Sintaxis
ColumnNumber ()
IsCrosstabRowNodeMember
Devuelve el valor booleano 1 (true) si el nodo actual es un miembro de nodo de
fila de tabla de referencias cruzadas.
Sintaxis
IsCrosstabRowNodeMember ()
IsCrosstabColumnNodeMember
Devuelve el valor booleano 1 (true) si el nodo actual es un miembro de nodo de
columna de tabla de referencias cruzadas.
Sintaxis
IsCrosstabColumnNodeMember ()
IsInnerMostCrosstabRowNodeMember
Devuelve el valor booleano 1 (true) si el nodo actual es un miembro de nodo de la
fila más interna de tabla de referencias cruzadas.
Sintaxis
IsInnerMostCrosstabRowNodeMember ()
IsInnerMostCrosstabColumnNodeMember
Devuelve el valor booleano 1 (true) si el nodo actual es un miembro de nodo de la
columna más interna de tabla de referencias cruzadas.
Sintaxis
IsInnerMostCrosstabColumnNodeMember ()
IsOuterMostCrosstabRowNodeMember
Devuelve el valor booleano 1 (true) si el nodo actual es un miembro de nodo de la
fila más externa de la tabla de referencias cruzadas.
Sintaxis
600 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

IsOuterMostCrosstabRowNodeMember ()
IsOuterMostCrosstabColumnNodeMember
Devuelve el valor booleano 1 (true) si el nodo actual es un miembro de nodo de la
columna más externa de la tabla de referencias cruzadas.
Sintaxis
IsOuterMostCrosstabColumnNodeMember ()
IsFirstColumn
Devuelve el valor booleano 1 (true) si la columna actual es la primera columna.
Sintaxis
IsFirstColumn ()
IsLastColumn
Devuelve el valor booleano 1 (true) si la columna actual es la última columna.
Sintaxis
IsLastColumn ()
IsLastInnerMostCrosstabColumnNodeMember
Devuelve el valor booleano 1 (true) si el nodo actual es el último miembro de nodo
de la columna más interna de tabla de referencias cruzadas.
Sintaxis
IsLastInnerMostCrosstabColumnNodeMember ()
IsLastInnerMostCrosstabRowNodeMember
Devuelve el valor booleano 1 (true) si el nodo actual es el último miembro de nodo
de la fila más interna de tabla de referencias cruzadas.
Sintaxis
IsLastInnerMostCrosstabRowNodeMember ()
CubeName
Devuelve el nombre del cubo. "Dimension" especifica el cubo del que se recuperan
los metadatos.
Sintaxis
CubeName ( dimension )
CubeDescription
Devuelve la descripción del cubo. "Dimension" especifica el cubo del que se
recuperan los metadatos.
Sintaxis
CubeDescription ( dimension )
Apéndice C. Uso del editor de expresiones 601

CubeCreatedOn
Devuelve la fecha y hora de creación del cubo. "Dimension" especifica el cubo del
que se recuperan los metadatos. Si el origen de dimensión es un archivo IBM ®
Cognos ® PowerCube (.mdc), la función devuelve una cadena en blanco porque la
fecha de creación inicial de un archivo PowerCube no se conserva.
Sintaxis
CubeCreatedOn ( dimension )
CubeDataUpdatedOn
Devuelve la fecha y la hora de la última actualización de los datos del cubo.
"Dimension" especifica el cubo del que se recuperan los metadatos.
Sintaxis
CubeDataUpdatedOn ( dimension )
CubeSchemaUpdatedOn
Devuelve la fecha y la hora de la última actualización del esquema del cubo.
"Dimension" especifica el cubo del que se recuperan los metadatos.
Sintaxis
CubeSchemaUpdatedOn ( dimension )
CubeIsOptimized
Devuelve "true" si el cubo está optimizado. "Dimension" especifica el cubo del que
se recuperan los metadatos.
Sintaxis
CubeIsOptimized ( dimension )
CubeDefaultMeasure
Devuelve el nombre de la medida predeterminada del cubo. "Dimension" especifica
el cubo del que se recuperan los metadatos.
Sintaxis
CubeDefaultMeasure ( dimension )
CubeCurrentPeriod
Devuelve el periodo actual para el cubo. "Dimension" especifica el cubo del que se
recuperan los metadatos.
Sintaxis
CubeCurrentPeriod ( dimension )
CellValue
Devuelve el valor de la celda actual de tabla de referencias cruzadas.
Sintaxis
CellValue ()
602 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

InScope
Devuelve el valor booleano 1 (true) cuando la celda se encuentra en el ámbito de
los elementos de datos y los MUN; de lo contrario, devuelve el valor booleano 0
(false).
Sintaxis
InScope ( dataItem , MUN, ... )
Funciones de conversión de tipo de datos
_add_days
Devuelve la fecha y hora resultante de añadir los días de "integer_expression" a
"timestamp_expression".
Sintaxis
_add_days ( timestamp_expression , integer_expression )
Ejemplo
_add_days ( 2007-01-14 00:00:00.000 ,3)
Resultado
2007-01-17 00:00:00.000
_add_months
Devuelve la fecha y hora resultante de añadir los meses de "integer_expression" a
"timestamp_expression".
Sintaxis
_add_months ( timestamp_expression , integer_expression )
_add_years
Devuelve la fecha y hora resultante de añadir los años de "integer_expression" a
"timestamp_expression".
_age
Sintaxis
_add_years ( timestamp_expression , integer_expression )
Devuelve el número resultante de restar "timestamp_expression" de la fecha de
hoy.
Sintaxis
_age ( timestamp_expression )
Ejemplo
_age ([Query1].[Date]), where [Query1].[Date] is March 2, 2004, and
today is July 8, 2009
Resultado
Apéndice C. Uso del editor de expresiones 603

50.406, donde 5 es el número de años, 04 es el número de meses y 06 es el número
de días.
_day_of_week
Devuelve el día de la semana (entre 1y7)para "timestamp_expression" donde
"integer_expression" indica el día de la semana que es el día 1. Para determinar
"integer_expression", elija el día de la semana y cuente desde el lunes; por ejemplo,
si elige miércoles, "integer_expression" sería 3 porque el miércoles es el tercer día a
partir del lunes.
Sintaxis
_day_of_week ( timestamp_expression , integer_expression )
Ejemplo
_day_of_week ( 2009-01-01 ,7),where 7 means that Sunday is the
first day of the week.
Resultado
5
_day_of_year
Devuelve el ordinal para el día del año en "timestamp_expression" (de 1 a 366).
También denominado día Juliano.
Sintaxis
_day_of_year ( timestamp_expression )
_days_between
Devuelve un número positivo o negativo que representa el número de días entre
"timestamp_expression1" e "timestamp_expression2". Si "timestamp_expression1" <
"timestamp_expression2", el resultado será un número negativo.
Sintaxis
_days_between ( timestamp_expression1 , timestamp_expression2 )
_days_to_end_of_month
Devuelve un número que representa el número de días que quedan del mes,
representado por "timestamp_expression".
Sintaxis
_days_to_end_of_month ( timestamp_expression )
_first_of_month
Devuelve una fecha y hora que es el primer día del mes representado por
"timestamp_expression".
Sintaxis
_first_of_month ( timestamp_expression )
Ejemplo 1
_first_of_month ( 2009-05-04 00:00:00.000 )
604 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Resultado
Devuelve 2009-05-01 00:00:00.000
Ejemplo 2
_first_of_month (current_date)
Resultado
Devuelve Jul 1, 2009 si la fecha actual es 30 de julio de 2009.
_last_of_month
Devuelve una fecha y hora que es el último día del mes representado por
"timestamp_expression".
Sintaxis
_last_of_month ( timestamp_expression )
_make_timestamp
Devuelve una indicación de fecha y hora construida por "integer_expression1"
(año), "integer_expression2" (mes) y "integer_expression3" (día). La parte
correspondiente a la hora se establece de forma predeterminada en 00:00:00.000.
Sintaxis
_make_timestamp ( integer_expression1 , integer_expression2 ,
integer_expression3 )
_months_between
Devuelve un número positivo o negativo que representa el número de meses entre
"timestamp_expression1" y "timestamp_expression2". Si "timestamp_expression1" <
"timestamp_expression2", el resultado será un número negativo.
Sintaxis
_months_between ( timestamp_expression1 , timestamp_expression2 )
_week_of_year
Devuelve el número de semana (de 1 a 53) del año para "timestamp_expression".
Según ISO 8601, la semana 1 del año es la primera semana que contiene un jueves,
lo que es equivalente a la primera semana que contiene el 4 de enero. Una semana
empieza en lunes (día 1) y termina en domingo (día 7).
Sintaxis
_week_of_year ( timestamp_expression )
_years_between
Devuelve un entero positivo o negativo que representa el número de años entre
"timestamp_expression1" y "timestamp_expression2". Si "timestamp_expression1" <
"timestamp_expression2", se devolverá un valor negativo.
Sintaxis
_years_between ( timestamp_expression1 , timestamp_expression2 )
Apéndice C. Uso del editor de expresiones 605

_ymdint_between
Devuelve un número que representa la diferencia entre "timestamp_expression1" y
"timestamp_expression2". Este valor tiene el formato AAMMDD, donde AA
representa el número de años, MM el número de meses y DD el número de días.
abs
Sintaxis
_ymdint_between ( timestamp_expression1 , timestamp_expression2 )
Ejemplo
_ymdint_between ( [Query1].[Date (close date)] , [Query1].[Date (ship
date)] ), where [Query1].[Date (close date)] is February 20, 2004,
and [Query1].[Date (ship date)] is January 19, 2004.
Resultado
101, donde 1 es el número de meses y 01 es el número de días.
Devuelve el valor absoluto de "numeric_expression". Si el valor de
"numeric_expression" es negativo, devuelve un valor positivo.
Sintaxis
abs ( numeric_expression )
ceiling
Devuelve el entero más pequeño que sea igual o mayor que "numeric_expression".
Sintaxis
ceiling ( numeric_expression )
character_length
Devuelve el número de caracteres de "string_expression".
Sintaxis
character_length ( string_expression )
date2string
Devuelve la fecha como una cadena con el formato AAAA-MM-DD.
Sintaxis
date2string ( date_expression )
date2timestamp
Convierte "date_expression" a una indicación de fecha y hora. La parte de la hora
de la indicación de fecha y hora será igual a cero.
Sintaxis
date2timestamp ( date_expression )
606 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

date2timestampTZ
Convierte "date_expression" a una indicación de fecha y hora con un huso horario.
Las partes de hora y huso horario de la indicación de fecha y hora serán igual a
cero.
Sintaxis
date2timestampTZ ( date_expression )
DTinterval2string
Devuelve un intervalo de fechas y horas como cadena en formato DDDD
HH:MM:SS.FFFFFFF o -DDDD HH:MM:SS.FFF.
Sintaxis
DTinterval2string ( date_time_interval_expression )
DTinterval2stringAsTime
Devuelve un intervalo de fechas y horas como una cadena en formato
HHHH:MM:SS.FFFFFFF o HH:MM:SS.FFF. Los días se convierten a horas.
exp
Sintaxis
DTinterval2stringAsTime ( date_time_interval_expression )
Devuelve la constante 'e' elevada a la "numeric_expression" potencia. La constante
'e' es la base del logaritmo natural.
Sintaxis
exp ( numeric_expression )
Ejemplo
exp(2)
Resultado
7,389056
extract
Devuelve un entero que representa el valor de "date_part_expression" en
"datetime_expression". "Date_part_expression" puede ser el año, el mes, el día, la
hora, los minutos o los segundos.
Sintaxis
extract ( date_part_expression , datetime_expression )
Ejemplo 1
extract ( year , 2003-03-03 16:40:15.535 )
Resultado
2003
Ejemplo 2
Apéndice C. Uso del editor de expresiones 607

floor
extract ( hour , 2003-03-03 16:40:15.535 )
Resultado
16
Devuelve el entero más grande que sea igual o menor que "numeric_expression".
Sintaxis
floor ( numeric_expression )
int2DTinterval
Convierte un entero en un intervalo de fechas y horas. "String_expression"
especifica qué "integer_expression" representa: "ns" = nanosegundos, "s" =
segundos (valor predeterminado), "m" = minutos, "h" = horas, "d" = días.
Sintaxis
int2DTinterval ( integer_expression , string_expression )
Ejemplo 1
int2DTinterval (1020,"h")
Resultado
42 días 12 horas
Ejemplo 2
int2DTinterval (1020,"s")
Resultado
17 minutos
int2YMinterval
Convierte "integer_expression" en un intervalo de año a mes. "String_expression"
especifica qué "integer_expression" representa: "y" = años, "m" = meses (valor
predeterminado).
ln
lower
Sintaxis
int2YMinterval ( integer_expression , string_expression )
Devuelve el logaritmo natural de "numeric_expression".
Sintaxis
ln ( numeric_expression )
Devuelve "string_expression" con todos los caracteres en mayúsculas convertidos a
minúsculas. Esta función aparece en el informe de ejemplo Informe de rendimiento
de ventas separado del paquete Almacén de datos VA (consulta).
608 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Sintaxis
lower ( string_expression )
mapNumberToLetter
Añade "integer_expression" a "string_expression".
mod
nullif
Sintaxis
mapNumberToLetter ( string_expression , integer_expression )
Ejemplo
mapNumberToLetter ( ’a’ ,1)
Resultado
b
Devuelve un valor entero que representa el resto (módulo) de
"integer_expression1" / "integer_expression2".
Sintaxis
mod ( integer_expression1 , integer_expression2 )
Devuelve nulo si "string_expression1" es igual a "string_expression2" (sin distinguir
entre mayúsculas y minúsculas), de lo contrario devuelve "string_expression1".
Sintaxis
nullif ( string_expression1 , string_expression2 )
number2string
Convierte "numeric_expression" en una cadena, utilizando el especificador de
formato %g (sintaxis C/C++).
Sintaxis
number2string ( numeric_expression )
octet_length
Devuelve el número de bytes de "string_expression".
Sintaxis
octet_length ( string_expression )
position
Devuelve el valor entero que representa la posición de inicio de
"string_expression1" en "string_expression2". Devuelve 0 si "string_expression1" no
se encuentra.
Sintaxis
position ( string_expression1 , string_expression2 )
Apéndice C. Uso del editor de expresiones 609

power
Devuelve "numeric_expression1" elevada a la "numeric_expression2" potencia.
round
sqrt
status
Sintaxis
power ( numeric_expression1 , numeric_expression2 )
Ejemplo
power (3,2)
Resultado
9
Devuelve "numeric_expression" redondeada al valor más cercano con el número de
dígitos significativos de "integer_expression" a la derecha del separador decimal. Si
"integer_expression" es negativa, "numeric_expression" se redondea al valor
absoluto más cercano con el número de dígitos significativo de
"integer_expression" a la izquierda del separador decimal. El redondeo tiene lugar
antes de formatear los datos.
Sintaxis
round ( numeric_expression , integer_expression )
Ejemplo
round (125, -1)
Resultado
130
Devuelve la raíz cuadrada de "numeric_expression". "Numeric_expression" no debe
ser un valor negativo.
Sintaxis
sqrt ( numeric_expression )
Devuelve el estado de "expression". Los valores posibles son: 0 - Aceptar, 1 - nulo,
2 - no disponible, 4 - dividir por cero, 8 - desbordamiento, 16 - seguridad, 32 -
error, 64 - nuevo, 128 - ejemplo, 256 - pendiente.
Sintaxis
status ( expression )
string2date
Devuelve "string_expression" como una fecha con el formato AAAA-MM-DD.
Sintaxis
string2date ( string_expression )
610 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

string2double
Devuelve un número decimal flotante. "String_expression" tiene el formato
siguiente: "[espacio en blanco] [signo] [dígitos] [dígitos]
[ {d|D|e|E }[signo]dígitos]"
Sintaxis
string2double ( string_expression )
string2DTinterval
Devuelve "string_expression" como un intervalo de fechas y horas con el formato
[-]DD HH:MM[:SS[.FFF]].
Sintaxis
string2DTinterval ( string_expression )
string2int32
Devuelve un entero. "String_expression" tiene el formato siguiente: "[espacio en
blanco] [{+|-}] [dígitos]"
Sintaxis
string2int32 ( string_expression )
string2int64
Devuelve un entero largo. "String_expression" tiene el formato siguiente: "[espacio
en blanco] [{+|-}] [dígitos]"
Sintaxis
string2int64 ( string_expression )
string2time
Devuelve "string_expression" como una hora con el formato HH:MM:SS.FFFFFFF.
Sintaxis
string2time ( string_expression )
string2timestamp
Devuelve "string_expression" como una indicación de fecha y hora con el formato
AAAA-MM-DD [T|t|[espacio en blanco]+] HH:MM:SS.FFFFFFF.
Sintaxis
string2timestamp ( string_expression )
string2timestampTZ
Devuelve "string_expression" con el formato AAAA-MM-DD HH:MM:SS.FFFFFFF
+HHMM o AAAA-MM-DD [T|t] HH:MM:SS.FFF -HHMM.
Sintaxis
string2timestampTZ ( string_expression )
Apéndice C. Uso del editor de expresiones 611

string2YMinterval
Devuelve "string_expression" como un intervalo de año y mes con el formato
[-]AA MM.
Sintaxis
string2YMinterval ( string_expression )
substring
Devuelve la subcadena de "string_expression" que empieza en la posición
"integer_expression1" para caracteres "integer_expression2" o al final de
"string_expression" si "integer_expression2" es -1. El primer carácter de
"string_expression" se encuentra en la posición 1.
Sintaxis
substring ( string_expression , integer_expression1 ,
integer_expression2 )
Ejemplo
substring ( [Sales (analysis)].[Sales staff].[Sales staff].[Sales
staff].[Position code], 3,5)
Resultado
Devuelve los caracteres del 3 al 7 de los códigos de cargo.
time2string
Devuelve una hora como una cadena con el formato HH:MM:SS.FFF.
Sintaxis
time2string ( time_expression )
timestamp2date
Convierte "timestamp_expression" en una fecha. La parte de la hora de la
indicación de fecha y hora se ignorará.
Sintaxis
timestamp2date ( timestamp_expression )
timestamp2string
Devuelve una indicación de fecha y hora como una cadena con el formato
AAAA-MM-DD HH:MM:SS.FFFFFFF.
Sintaxis
timestamp2string ( timestamp_expression )
timestamp2timestampTZ
Convierte "timestamp_expression" en una indicación de fecha y hora con un huso
horario. La parte de desplazamiento de la indicación de fecha y hora con el huso
horario será cero.
Sintaxis
timestamp2timestampTZ ( timestamp_expression )
612 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

timestampTZ2date
Convierte "timestamp_time_zone_expression" en una fecha. Las partes de hora y
huso horario de la indicación de fecha y hora se ignorarán.
Sintaxis
timestampTZ2date ( timestamp_time_zone_expression )
timestampTZ2string
Devuelve una indicación de fecha y hora con el huso horario como una cadena con
el formato AAAA-MM-DD HH:MM:SS.FFFFFFF +HHMM o AAAA-MM-DD
HH:MM:SS.FFF -HHMM.
Sintaxis
timestampTZ2string ( timestamp_time_zone_expression )
timestampTZ2timestamp
Convierte "timestamp_time_zone_expression" en una indicación de fecha y hora.
La parte de desplazamiento de la indicación de fecha y hora con el huso horario se
ignorará.
Sintaxis
timestampTZ2timestamp ( timestamp_time_zone_expression )
timeTZ2string
Devuelve una hora con el huso horario como una cadena con el formato
HH:MM:SS.FFF +HHMM o HH:MM:SS.FFFFFFF -HHMM. Por ejemplo, -05:30
significa un huso horario de GMT menos 5 horas y 30 minutos.
trim
upper
Sintaxis
timeTZ2string ( timeTZ_expression )
Devuelve "string_expression" sin los espacios en blanco iniciales y finales o sin el
carácter especificado por "match_character_expression". "Trim_what_expression"
puede ser "leading", "trailing" o "both" (valor predeterminado).
"Match_character_expression" puede ser una cadena vacía para recortar los
espacios en blanco o puede especificar un carácter que se deba recortar.
Sintaxis
trim ( trim_what_expression , match_character_expression ,
string_expression )
Devuelve "string_expression" con todos los caracteres en minúsculas convertidos a
mayúsculas.
Sintaxis
upper ( string_expression )
YMinterval2string
Devuelve "year_month_interval_expression" como una cadena con el formato (AA
MM) o -(AA MM).
Apéndice C. Uso del editor de expresiones 613

Sintaxis
YMinterval2string ( year_month_interval_expression )
614 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Apéndice D. Referencia de formateo de datos
Este capítulo contiene definiciones de las propiedades de formateo de datos que se
encuentran en IBM Cognos Framework Manager. La definición de cada propiedad
de formateo de datos también se muestra al seleccionar una propiedad en el
cuadro de diálogo Formato de datos de Framework Manager.
En el caso de metadatos de SAP BW:
v La información de cualquier unidad de medida que existe en SAP BW se añade
automáticamente al valor de datos.
v No puede definir un formato para cada moneda de un asunto de consulta de
varias monedas.
Propiedades de formateo de datos
La siguiente es una lista de propiedades disponible en el diálogo de formateo de
datos.
Caracteres "no aplicables"
Especifica los caracteres que se mostrarán cuando el valor al que se va a dar
formato no sea aplicable. El valor predeterminado son dos guiones (--). Tenga en
cuenta que el formato sólo se aplicará si el origen de datos soporta esta condición
de error.
Cualquier carácter de error
Especifica los caracteres que se mostrarán cuando el valor al que se va a dar
formato no esté disponible debido a un error. Esta propiedad se reemplaza por las
condiciones de error de formateo más específicas, como Caracteres de errores de
seguridad. El valor predeterminado son dos guiones (--). Tenga en cuenta que el
formato sólo se aplicará si el origen de datos soporta esta condición de error.
Tipo de calendario
Especifica el tipo de calendario que se mostrará. Los valores de datos se
correlacionarán al calendario seleccionado antes de que se les aplique el formato.
El valor predeterminado se hereda del idioma de contenido del usuario. Tenga en
cuenta que el valor Imperial japonés sólo se aplica a los idiomas japoneses.
Reloj
Especifica si la hora se mostrará en formato de 12 ó 24 horas. El valor
predeterminado se hereda del idioma de contenido del usuario.
Moneda
Especifica la moneda que se va a utilizar. El símbolo de moneda predeterminado
se mostrará si no se cambian los valores de las propiedades Visualización de
moneda y Símbolo de moneda. El valor predeterminado se hereda del modelo.
© Copyright IBM Corp. 2005, 2013 615

Visualización de moneda
Especifica si se debe mostrar el símbolo de la moneda local o de la moneda
internacional. De manera predeterminada, se muestra el símbolo de la moneda
local.
Símbolo de moneda
Especifica uno o varios caracteres utilizados como un símbolo identificativo de la
moneda local. Este símbolo irá delante del número y de cualquier signo, incluso si
se trata de un signo inicial. Se puede especificar un espacio entre el símbolo y el
valor numérico escribiéndolo en esta propiedad después del símbolo. El valor
predeterminado se hereda del idioma de contenido del usuario.
Posición del símbolo de moneda
Especifica dónde aparecerá el símbolo de moneda. Si se selecciona Fin, los espacios
que siguen al carácter o caracteres de las propiedades Símbolo de moneda o
Símbolo de moneda internacional se presentarán entre el número y el símbolo. El
valor predeterminado se hereda del idioma de contenido del usuario.
Orden de fechas
Especifica el orden en que se mostrará el día, el mes y el año. El valor
predeterminado se hereda del idioma de contenido del usuario.
Separador de fecha
Especifica el carácter que se mostrará entre el año, el mes y el día. El valor
predeterminado se hereda del idioma de contenido del usuario.
Estilo de fecha
Especifica el estilo de fecha. El idioma determina los resultados que se presentan.
Normalmente, Corto utiliza sólo números, Medio utiliza algunas palabras
abreviadas, Largo utiliza palabras completas y Completo incluye todos los detalles
disponibles.
Separador decimal
Especifica el carácter que separará los números no decimales de los decimales. Esta
propiedad se omite si no se muestran decimales. El valor predeterminado se
hereda del idioma de contenido del usuario.
Formato de los dígitos
Especifica la opción de formato de dígitos que se aplicará. Si se selecciona el
formato nacional, la forma de los dígitos se determina en función del idioma de
contenido del usuario. Si se selecciona el formato contextual, la forma de los
dígitos se determina de acuerdo con los caracteres adyacentes del valor. Por
ejemplo, si el carácter direccional fuerte más reciente anterior al carácter numérico
es de izquierda a derecha, el número se visualiza como un número europeo. Si el
carácter direccional fuerte más reciente anterior al carácter numérico es de derecha
a izquierda, el número se visualiza en formato arábigo-índico. Si no hay caracteres
direccionales fuertes antes del carácter numérico, el número se muestra siguiendo
la dirección del texto de base del campo. Si se selecciona Ninguno, no se aplica
ningún cambio de forma y se muestra el valor tal y como aparece en el origen de
datos. El valor predeterminado depende del tipo de valor. Cuando el valor es una
cadena, el valor predeterminado es Ninguno.
616 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Formato de los dígitos
Especifica la opción de formato de dígitos que se aplicará. Si se selecciona el
formato nacional, la forma de los dígitos se determina en función del idioma de
contenido del usuario. Si se selecciona Ninguno, no se aplica ningún cambio de
forma y se muestra el valor tal y como aparece en el origen de datos. El valor
predeterminado depende del tipo de valor. Cuando el valor es un número, el valor
predeterminado es el valor predeterminado ICU del idioma.
Mostrar símbolos AM / PM
Especifica si se mostrarán los símbolos AM o PM. El valor predeterminado se
hereda del idioma de contenido del usuario.
Mostrar como exponente
Especifica si los valores se representarán con notación científica, mediante el uso de
exponentes. Si esta propiedad se establece en No, no se utilizará notación científica.
Si no se especifica esta propiedad, sólo se utilizará notación científica cuando los
valores excedan el número máximo de dígitos. El valor predeterminado se hereda
del idioma de contenido del usuario.
Mostrar días
Especifica si se mostrará el día. El formato del día se puede controlar mediante la
selección de uno de los formatos específicos. Si se selecciona Juliano, significa que
se mostrará el día del año con 3 dígitos. El valor predeterminado se hereda del
idioma de contenido del usuario.
Mostrar eras
Especifica si se mostrará la época. El valor predeterminado se hereda del idioma
de contenido del usuario.
Mostrar horas
Especifica si se mostrarán las horas. El valor predeterminado se hereda del idioma
de contenido del usuario.
Mostrar milisegundos
Especifica si se mostrarán los milisegundos. El formato de los milisegundos se
puede controlar mediante la selección de uno de los formatos específicos. Esta
propiedad se ignora si no se muestran los segundos. El valor predeterminado se
hereda del idioma de contenido del usuario.
Mostrar minutos
Especifica si se mostrarán los minutos. El formato de los minutos se puede
controlar mediante la selección de uno de los formatos específicos. El valor
predeterminado se hereda del idioma de contenido del usuario.
Mostrar meses
Especifica si se mostrará el mes. El formato del mes se puede controlar mediante la
selección de uno de los formatos específicos. El valor predeterminado se hereda del
idioma de contenido del usuario.
Mostrar meses
Especifica si se mostrará el mes.
Apéndice D. Referencia de formateo de datos 617

Mostrar segundos
Especifica si se mostrarán los segundos. El formato de los segundos se puede
controlar mediante la selección de uno de los formatos específicos. El valor
predeterminado se hereda del idioma de contenido del usuario.
Mostrar huso horario
Especifica si se mostrará el huso horario. El valor predeterminado se hereda del
idioma de contenido del usuario.
Mostrar días de la semana
Especifica si se mostrará el día de la semana. El formato del día laborable se puede
controlar mediante la selección de uno de los formatos específicos. El valor
predeterminado se hereda del idioma de contenido del usuario.
Mostrar años
Especifica si se mostrará el año. Los dos primeros dígitos del año, que indican el
siglo, se pueden controlar mediante la selección de uno de los valores de
propiedad asociados. El valor predeterminado se hereda del idioma de contenido
del usuario.
Mostrar años
Especifica si se mostrará el año.
Caracteres de división por cero
Especifica los caracteres que se mostraran cuando un valor numérico sea el
resultado de una separación por cero. El valor predeterminado es /0. Tenga en
cuenta que el formato sólo se aplicará si el origen de datos soporta esta condición
de error.
Símbolo de exponente
Especifica el carácter que se mostrará para identificar exponentes si se utiliza la
notación científica. El símbolo se presentará después del número, separado por un
espacio. El valor predeterminado se hereda del idioma de contenido del usuario.
Tamaño de grupo (dígitos)
Especifica el tamaño de la agrupación principal. Si se especifica un valor, éste
representa el número de dígitos a la izquierda de la coma decimal que se
agruparán y se separarán con el separador de miles. El valor predeterminado se
hereda del idioma de contenido del usuario.
Símbolo de moneda internacional
Especifica uno o varios caracteres utilizados como un símbolo para identificar la
moneda internacional. Este símbolo sustituirá al símbolo de moneda. Se puede
especificar un espacio entre el símbolo y el valor numérico escribiéndolo en esta
propiedad después del símbolo. El valor predeterminado se hereda del idioma de
contenido del usuario.
Mantisa (dígitos)
Especifica el número de dígitos que se mostrarán detrás del símbolo de exponente
si se utiliza la notación científica.
618 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Número máximo de dígitos
Especifica el número máximo de dígitos que se pueden mostrar. Si el número
máximo de dígitos no es suficiente para mostrar el valor, se utilizará una notación
científica. El valor predeterminado se hereda del idioma de contenido del usuario.
Número mínimo de dígitos
Especifica el número mínimo de dígitos que se pueden mostrar. Si el número
mínimo de dígitos es demasiado alto para mostrar un valor, se utilizará el carácter
de almohadilla. El valor predeterminado se hereda del idioma de contenido del
usuario.
Caracteres de los valores ausentes
Especifica el carácter o caracteres que se mostrarán si falta el valor. Si no se escribe
ningún valor para esta propiedad, se mostrará una cadena vacía.
Modelo para números negativos
Especifica un formato de presentación basado en modelos para números negativos.
Existen algunas restricciones. Se ignora la parte numérica del modelo para
números negativos. Sólo se utilizan el sufijo y el prefijo. Por ejemplo, en el modelo
ABC#.##0,#EFG, ABC es el prefijo, EFG es el sufijo y "#.##0,#" es la parte numérica
del patrón.
Posición del signo negativo
Especifica dónde aparecerá el signo negativo. El valor predeterminado se hereda
del idioma de contenido del usuario.
Símbolo de signo negativo
Especifica cómo se mostrarán los números negativos. El valor predeterminado se
hereda del idioma de contenido del usuario.
Número de posiciones decimales
Especifica el número de dígitos que se mostrarán a la derecha de la coma decimal.
Si esta propiedad no está configurada, el número de posiciones decimales variará
según el número especificado.
Caracteres de desbordamiento numérico
Especifica los caracteres que se mostrarán cuando un valor numérico sea el
resultado de un desbordamiento numérico. El valor predeterminado son dos
guiones (--). Tenga en cuenta que el formato sólo se aplicará si el origen de datos
soporta esta condición de error.
Carácter de relleno
Especifica el carácter que se utilizará para poner almohadilla a los valores con
menos dígitos que el número mínimo de dígitos. El valor predeterminado se
hereda del idioma de contenido del usuario.
Modelo
Especifica un formato de presentación basado en modelos. El formato de los
modelos reemplaza los formatos especificados en otras propiedades. Por ejemplo,
para dar a la fecha el formato 2009/12/31 23:59:59 PM, utilice el patrón
Apéndice D. Referencia de formateo de datos 619

aaaa/MM/dd hh:mm:ss aa. Por ejemplo, para dar formato a los millares mediante
la letra K, establezca el tipo de formato en Número, la escala en -3 (para suprimir
los 000) y utilice el modelo ####K.
Símbolo de porcentaje
Especifica si se mostrarán los valores por cien (porcentaje) o por mil. El símbolo se
anexará al número y a cualquier signo al final. Se puede especificar un espacio
entre el valor numérico y el símbolo escribiéndolo en esta propiedad después del
símbolo. El valor predeterminado se hereda del idioma de contenido del usuario.
Escala de porcentaje (entero)
Se aplica esta escala al valor después de dar formateo. Si se omite, no se aplicará
ninguna escala de porcentaje y se dará formato al valor de acuerdo con la posición
decimal normal asociada al símbolo de tanto por ciento (o por mil).
Escala
Especifica el número de dígitos que se moverá el delimitador decimal con fines de
formateo. Por ejemplo, mueva el decimal tres espacios para presentar valores en
millares. El valor predeterminado se hereda del campo de base de datos.
Tamaño de grupo secundario (dígitos)
Especifica el tamaño de la agrupación secundaria. Si se especifica un valor, éste
representa el número de dígitos a la izquierda del grupo principal que se
agruparán y se separarán con el separador de miles. Si esta propiedad se deja en
blanco, el grupo de dígitos secundario es el mismo número que el tamaño de la
agrupación principal, como se especifica en la propiedad Tamaño de grupo
(dígitos). El valor predeterminado se hereda del idioma de contenido del usuario.
Caracteres de errores de seguridad
Especifica los caracteres que se mostrarán cuando el valor al que se va a dar
formato no esté disponible por razones de seguridad. El valor predeterminado es
#!Security. Tenga en cuenta que el formato sólo se aplicará si el origen de datos
soporta esta condición de error.
Separador de miles
Especifica cómo delimitar grupos de dígitos, por ejemplo, miles. Esta propiedad
sólo se utiliza si la propiedad Usar separador de miles se establece en Sí. El valor
predeterminado se hereda del idioma de contenido del usuario.
Separador de hora
Especifica el carácter que se mostrará entre la hora, el minuto y el segundo. El
valor predeterminado se hereda del idioma de contenido del usuario.
Estilo de hora
Especifica el estilo de hora que se mostrará. El idioma determinará los resultados
exactos que se presentarán. Normalmente, Corto significa que se mostrarán los
detalles mínimos, Largo agregar segundos y Completo significa que se mostrarán
todos los detalles, incluido el huso horario. El valor predeterminado se hereda del
idioma de contenido del usuario.
620 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Unidad de tiempo
Especifica la unidad de medida del valor. Esta propiedad se ignorará si se muestra
algún componente de día u hora. El valor predeterminado se hereda del idioma de
contenido del usuario.
Usar separador de miles
Especifica si se aplicará el delimitador de agrupación como se define en la
propiedad Tamaño de grupo. El valor predeterminado se hereda del idioma de
contenido del usuario.
Caracteres con valor cero
Especifica el carácter o caracteres que se mostrarán cuando el valor es cero (0). Si
no se especifica ningún valor para esta propiedad, la propiedad Número máximo
de dígitos determina cuántos dígitos cero se muestran.
Apéndice D. Referencia de formateo de datos 621

622 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Apéndice E. Utilización de modelos para formatear datos
Directrices de modelos
Se pueden formatear los datos para que coincidan con cualquier modelo de texto y
números cuando los formatos predeterminados no son adecuados. Por ejemplo, se
pueden formatear las fechas para que utilicen el texto completo que incluye la era,
o se pueden formatear para que solo utilicen números y muestren los dos últimos
dígitos del año para ahorrar espacio.
La utilización de símbolos y modelos puede proporcionar resultados similares a las
tareas básicas de formateo de datos. Por ejemplo, se puede definir el número de
dígitos que deben aparecen después del separador decimal. Puede conseguir este
tipo de resultado con un modelo, o bien puede definir la propiedad Número de
posiciones decimales. Los modelos ofrecen flexibilidad para requisitos más
complejos.
Para cada código de idioma de contenido soportado es necesario utilizar un
conjunto de símbolos específico en los modelos. Para cada código de idioma, se
necesitarán dos tablas; una para los símbolos de fecha y hora y otra para los
símbolos decimales. Los símbolos decimales son iguales para todos los entornos
locales, sin embargo, los símbolos de fecha y hora se agrupan en seis grupos de
entornos locales. Compruebe en la sección Símbolos de fecha y hora qué grupo de
entornos locales se utiliza para su entorno local.
Para definir modelos, abra el cuadro de diálogo Formato de datos y edite la
propiedad Diseño para cada tipo de formato. Utilice los símbolos que están
definidos en las tablas de códigos de idioma y siga estas directrices.
Al definir un modelo, el número de símbolos empleado afecta a la visualización de
los datos. Existen diferentes reglas para texto, números y valores que pueden
adoptar la forma de texto o números.
Text
Puede especificar si el texto se produce de forma completa o abreviada.
Número de símbolos Significado Ejemplo
4 o más Texto completo EEEE produce Lunes
Menos de 4 Forma abreviada EEE produce Lun
Números
El número de símbolos empleado en un modelo establece el número de dígitos
mínimo que se produce en un informe. Se añaden ceros a los números con menos
dígitos de los especificados. Por ejemplo, si especifica mm para minutos, y el valor
de la base de datos es 6, en el informe se mostrará 06.
© Copyright IBM Corp. 2005, 2013 623

Nota: El valor de año se trata de forma distinta. Si especifica dos símbolos para
año, se muestran los dos últimos dígitos del valor de año. Por ejemplo, aaaa
produce 2013 y aa produce 13.
Texto y números
Símbolos de fecha y hora
Para valores que pueden producir texto o números, como los meses, puede
especificar si se producirá texto o números, y si las palabras se muestran
abreviadas.
Número de símbolos Significado Ejemplo
3 o más Text MMMM produce Enero
MMM produce Ene
Menos de 3 Números MM produce 01
M produce 1
Los símbolos de fecha y hora se dividen en entornos locales, cada uno de los
cuales se detalla a continuación.
Grupo A de entornos locales
Entornos locales: af-za, en, en-au, en-be, en-bw, en-ca, en-gb, en-hk, en-ie, en-in,
en-mt, en-nz, en-ph, en-sg, en-us, en-vi, en-za, fo-fo, gl-es, id, id-id, is, is-is, it, it-ch,
it-it, kk-kz, ms, ms-bn, ms-my, nb-no, nl, nl-be, nl-nl, no, no-no, om-et, om-so, pl,
pl-pl, pt, pt-br, pt-pt, so-dj, so-et, so-ke, so-so, sv, sv-fi, sv-se, sw-ke, sw-tz
Significado Símbolo Presentación Ejemplo
Era G Text d.C.
Year y Número 2013
Año (de 'semana del
año')
Y Número 2013
Mes del año M Texto y número Julio y 07
Semana del año w Número 27
Semana del mes W Número 2
Día del año D Número 189
Día del mes d Número 10
Día de la semana del
mes
624 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario
F Número 2 (2º miércoles de
julio)

Significado Símbolo Presentación Ejemplo
Día de la semana
(1=primer día)
e Número 2
Día de la semana E Text Martes
Marcador a.m. o p.m. a Text pm
Hora del día (de 1 a
24)
Hora en a.m. o p.m.
(de0a11)
Hora en a.m. o p.m.
(de 1 a 12)
Hora del día (de 0 a
23)
k Número 24
K Número 0
h Número 12
H Número 0
Minuto de la hora m Número 30
Segundo del minuto s Número 55
Milisegundo S Número 978
Huso horario z Text Franja horaria del
Pacífico
Escape utilizado en el
texto
' n/a n/a
Comillas simples '' n/a '
Grupo B de entornos locales
Entornos locales: be-by, bg-bg, el, el-gr, fi, fi-fi, hr, hr-hr, hu, hu-hu, ja, ja-jp, ko,
ko-kr, ro, ro-ro, ru, ru-ua, ru-ru, sh-yu, sk, sk-sk, sl-si, sq-al, sr-sp, th, tr, tr-tr, uk-ua,
zh, zh-cn, zh-hk, zh-mo, zh-sg, zh-tw
Significado Símbolo Presentación Ejemplo
Era G Text d.C.
Year a Número 2013
Año (de 'semana del
año')
A Número 2013
Mes del año n Texto y número Julio y 07
Apéndice E. Utilización de modelos para formatear datos 625

Significado Símbolo Presentación Ejemplo
Semana del año w Número 27
Semana del mes W Número 2
Día del año D Número 189
Día del mes j Número 10
Día de la semana del
mes
Día de la semana
(1=primer día)
F Número 2 (2º miércoles de
julio)
e Número 2
Día de la semana E Text Martes
Marcador a.m. o p.m. x Text pm
Hora del día (de 1 a
24)
Hora en a.m. o p.m.
(de0a11)
Hora en a.m. o p.m.
(de 1 a 12)
Hora del día (de 0 a
23)
h Número 24
K Número 0
k Número 12
H Número 0
Minuto de la hora m Número 30
Segundo del minuto s Número 55
Milisegundo S Número 978
Huso horario z Text Franja horaria del
Pacífico
Escape utilizado en el
texto
' n/a n/a
Comillas simples '' n/a '
Grupo C de entornos locales
Entornos locales: ca-es, cs, cs-cz, da, da-dk, es, es-ar, es-bo, es-cl, es-co, es-cr, es-do,
es-ec, es-es, es-gt, es-hn, es-mx, es-ni, es-pa, es-pe, es-pr, es-py, es-sv, es-us, es-uy,
es-ve, eu-es, mk-mk
626 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Significado Símbolo Presentación Ejemplo
Era G Text d.C.
Year u Número 2013
Año (de 'semana del
año')
U Número 2013
Mes del año M Texto y número Julio y 07
Semana del año w Número 27
Semana del mes W Número 2
Día del año D Número 189
Día del mes t Número 10
Día de la semana del
mes
Día de la semana
(1=primer día)
F Número 2 (2º miércoles de
julio)
e Número 2
Día de la semana E Text Martes
Marcador a.m. o p.m. a Text pm
Hora del día (de 1 a
24)
Hora en a.m. o p.m.
(de0a11)
Hora en a.m. o p.m.
(de 1 a 12)
Hora del día (de 0 a
23)
h Número 24
K Número 0
k Número 12
H Número 0
Minuto de la hora m Número 30
Segundo del minuto s Número 55
Milisegundo S Número 978
Huso horario z Text Franja horaria del
Pacífico
Escape utilizado en el
texto
' n/a n/a
Apéndice E. Utilización de modelos para formatear datos 627

Significado Símbolo Presentación Ejemplo
Comillas simples '' n/a '
Grupo D de entornos locales
Entornos locales: de, de-at, de-be, de-ch, de-de, de-lu
Significado Símbolo Presentación Ejemplo
Era G Text d.C.
Year j Número 2013
Año (de 'semana del
año')
J Número 2013
Mes del año M Texto y número Julio y 07
Semana del año w Número 27
Semana del mes W Número 2
Día del año D Número 189
Día del mes t Número 10
Día de la semana del
mes
Día de la semana
(1=primer día)
F Número 2 (2º miércoles de
julio)
e Número 2
Día de la semana E Text Martes
Marcador a.m. o p.m. a Text pm
Hora del día (de 1 a
24)
Hora en a.m. o p.m.
(de0a11)
Hora en a.m. o p.m.
(de 1 a 12)
Hora del día (de 0 a
23)
h Número 24
K Número 0
k Número 12
H Número 0
Minuto de la hora m Número 30
Segundo del minuto s Número 55
628 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Significado Símbolo Presentación Ejemplo
Milisegundo S Número 978
Huso horario z Text Franja horaria del
Pacífico
Escape utilizado en el
texto
' n/a n/a
Comillas simples '' n/a '
Grupo E de entornos locales
Entornos locales: fr, fr-be, fr-ca, fr-ch, fr-fr, fr-lu
Significado Símbolo Presentación Ejemplo
Era G Text d.C.
Year a Número 2013
Año (de 'semana del
año')
A Número 2013
Mes del año M Texto y número Julio y 07
Semana del año w Número 27
Semana del mes W Número 2
Día del año D Número 189
Día del mes j Número 10
Día de la semana del
mes
Día de la semana
(1=primer día)
F Número 2 (2º miércoles de
julio)
e Número 2
Día de la semana E Text Martes
Marcador a.m. o p.m. x Text pm
Hora del día (de 1 a
24)
Hora en a.m. o p.m.
(de0a11)
h Número 24
K Número 0
Apéndice E. Utilización de modelos para formatear datos 629

Significado Símbolo Presentación Ejemplo
Hora en a.m. o p.m.
(de 1 a 12)
Hora del día (de 0 a
23)
k Número 12
H Número 0
Minuto de la hora m Número 30
Segundo del minuto s Número 55
Milisegundo S Número 978
Huso horario z Text Franja horaria del
Pacífico
Escape utilizado en el
texto
' n/a n/a
Comillas simples '' n/a '
Grupo F de entornos locales
Entornos locales: ga-ie
Significado Símbolo Presentación Ejemplo
Era R Text d.C.
Year b Número 2013
Año (de 'semana del
año')
B Número 2013
Mes del año M Texto y número Julio y 07
Semana del año t Número 27
Semana del mes T Número 2
Día del año l Número 189
Día del mes L Número 10
Día de la semana del
mes
Día de la semana
(1=primer día)
F Número 2 (2º miércoles de
julio)
e Número 2
Día de la semana E Text Martes
630 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Significado Símbolo Presentación Ejemplo
Marcador a.m. o p.m. a Text pm
Hora del día (de 1 a
24)
Hora en a.m. o p.m.
(de0a11)
Hora en a.m. o p.m.
(de 1 a 12)
Hora del día (de 0 a
23)
u Número 24
K Número 0
k Número 12
U Número 0
Minuto de la hora n Número 30
Segundo del minuto s Número 55
Milisegundo S Número 978
Huso horario c Text Franja horaria del
Pacífico
Escape utilizado en el
texto
Símbolos de formato decimal
' n/a n/a
Comillas simples '' n/a '
Todos los entornos locales
Símbolo Significado
0 Dígito que se visualiza aunque el valor sea
cero.
# Dígito que se suprime si el valor es cero.
. Marcador de posición para separador
decimal.
, Marcador de posición para separador de
millares.
E Separa mantisa y exponente para formatos
exponenciales.
; Separa formatos para números positivos y
formatos para números negativos.
- Prefijo negativo predeterminado.
% Multiplicado por 100, como porcentaje.
Multiplicado por 1000, como tanto por mil.
Apéndice E. Utilización de modelos para formatear datos 631

Símbolo Significado
Símbolo de moneda. Si este símbolo está
presente en un modelo, el separador decimal
monetario se utiliza en lugar del separador
decimal.
Signo de moneda internacional. Se sustituirá
por un símbolo de moneda internacional. Si
está presente en un modelo, se utiliza el
separador decimal monetario en lugar del
separador decimal.
X Se pueden utilizar otros caracteres en el
prefijo o el sufijo.
' Se utiliza para entrecomillar caracteres
especiales en un prefijo o sufijo.
/u221E Símbolo de infinito.
/uFFFD Símbolo de un valor que no es un número.
632 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Apéndice F. Directrices para trabajar con datos de SAP BW
para su uso en Transformer
A partir de la versión 8.4 de Transformer, puede utilizar paquetes de Framework
Manager publicados en Content Manager para aprovechar los datos de SAP BW.
Los paquetes basados en SAP se pueden utilizar como orígenes de datos para crear
modelos de Transformer. Como resultado, se pueden usar PowerCubes de
Transformer como métodos de memoria caché de acceso a datos de alta velocidad
para distribuir áreas más pequeñas o detalladas de información de la empresa. Este
es el método recomendado para aprovechar los datos de SAP BW.
Existen consideraciones especiales al utilizar paquetes SAP creados en Framework
Manager. Para obtener información detallada sobre cómo crear consultas SAP, crear
paquetes basados en SAP en Framework Manager y utilizarlos en Transformer,
consulte la sección sobre cómo trabajar con datos SAP BW utilizando un paquete
en Framework Manager. Para obtener información general sobre cómo crear
paquetes en Framework Manager, consulte el apartado "Crear o modificar un
paquete" en la publicación IBM Cognos Framework Manager Guía del usuario.
Versiones 7.x, 8.1, 8.2 y 8.3 de Transformer
En las versiones 7.x, 8.1 y 8.2 de Transformer, puede aprovechar los datos de SAP
BW utilizando un paquete de Framework Manager en el que los asuntos de
consulta y las dimensiones se externalizan utilizando archivos CSV. Transformer
puede utilizar los archivos CSV como origen de datos para crear un modelo y
generar PowerCubes. Este método sólo debería usarse en un entorno IBM Cognos
cuando quiera aprovechar datos en IBM Cognos BI para construir PowerCubes
para IBM Cognos BI.
En la versión 8.3 de Transformer, utilice paquetes publicados para dimensiones y
utilice archivos CSV para hechos.
Existen consideraciones especiales al utilizar archivos CSV externalizados con datos
de SAP en Framework Manager. Para obtener más información, consulte: “Cómo
trabajar con datos de SAP BW utilizando archivos CSV externalizados en
Framework Manager” en la página 641. Para obtener información general sobre la
externalización de asuntos de consulta y dimensiones utilizando el método CSV,
consulte el apartado "Asuntos de consulta y dimensiones externalizados" en la
publicación Framework Manager Guía del usuario.
Cómo trabajar con datos de SAP BW utilizando un paquete de
Framework Manager
Puede aprovechar los datos de SAP BW en Transformer mediante un paquete
basado en SAP creado en Framework Manager y publicado en Content Manager.
Este es el método recomendado para aprovechar los datos de SAP BW. Existen
consideraciones especiales al utilizar paquetes SAP creados en Framework
Manager.
Puede utilizar Transformer para importar tanto datos dimensionales como de
hechos desde un origen de datos de SAP BW. A continuación se describe cómo
© Copyright IBM Corp. 2005, 2013 633

econstruir un cubo SAP BW como un cubo de IBM Cognos Transformer. Para ello,
el paquete de consultas SAP BW debe tener un formato específico.
Existen tres fases para importar una consulta SAP BW para acceder tanto a
dimensiones como a hechos mediante IBM Cognos BI:
v Crear una consulta en SAP BW Business Explorer Query Designer
v Crear un paquete en Framework Manager
v Crear un modelo en Transformer
Limitaciones
v Este proceso de extracción se limita sólo a orígenes de datos de SAP BW.
v El origen de datos debe ser una consulta construida específicamente definida en
el origen de datos de SAP BW.
Para obtener información general sobre la creación de paquetes, consulte: "Crear o
modificar un paquete" en la publicación Framework Manager Guía del usuario.
Creación de una consulta BW en SAP Business Explorer
Query Designer
Debe crear una consulta que incluya el cubo que desee importar. Es recomendable
que base la consulta en un solo cubo de información de la base de datos. Es
posible que una consulta basada en varias fuentes genere errores BW SAP durante
la recuperación de datos.
Tras crear la consulta puede crear una variable “Creación de una variable” en la
página 635.
Procedimiento
1. En Query Designer, pulse Nueva consulta.
2. En el cuadro de diálogo Nueva consulta, seleccione el proveedor de
información que contenga el cubo que desee importar.
3. Pulse el icono Herramientas para consultar el nombre técnico del InfoObjeto.
4. Arrastre una característica que desee importar del catálogo de InfoObjeto que
está situado en la columna izquierda hasta uno de los campos que aparecen en
la parte derecha de la página. Por ejemplo, Columnas o Filas.
Las características que seleccione definirán los metadatos del cubo de Cognos
Transformer. Las características deben ajustarse a las siguientes restricciones:
v Debe tener al menos una única variable opcional para segmentar los datos.
v Seleccione una característica que represente el origen de datos. Las
características pueden ser cifras clave, que se convertirán en medidas de
Cognos Transformer o dimensiones, que se convertirán en las dimensiones
de Cognos Transformer.
v No asigne a ninguna de las características una jerarquía de visualización, ni
explícitamente ni a través de una variable.
v Todas las cifras clave de la consulta BW SAP deben ser numéricas.
v No seleccione la característica Moneda/Unidad.
v Asegúrese de que todas las cifras clave seleccionadas utilicen la misma
moneda.
634 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

v Únicamente incluya características en la consulta BW SAP que desee extraer
con Framework Manager. Si incluye características innecesarias, aumentará el
volumen de datos, por lo que el rendimiento se verá afectado de forma
negativa.
v Se deben copiar las características en los campos Columnas o Filas de la
definición de consulta. Si se copian en los campos de características libres o
de filtro, las características se muestran como dimensiones al importarse
desde el paquete, pero el procesamiento de extracción de secuencias no
puede obtener los valores.
v Si ha definido filtros, estos deben hacer referencia únicamente a las
dimensiones incluidas en otra parte de la definición de consulta.
v Si incluye una característica libre, no aparecerá ningún valor para dicha
característica en la extracción de cifras clave. Un filtro aplicado a una
característica libre actúa como filtro en los datos BW SAP devueltos. Puede
utilizarlo como filtro para definir un subconjunto de un cubo de información.
v Utilice una solicitud de lista de selección, en lugar de una solicitud de
introducir para la consulta. Una solicitud de lista de selección ofrece valores
para segmentar los datos.
5. Si desea definir los metadatos que rellenarán el cubo de Cognos Transformer,
deberá modificar las propiedades de cada característica que haya seleccionada
para su inclusión. Pulse con el botón derecho en una característica y seleccione
Propiedades.
6. En el cuadro de diálogo Propiedades de característica, cambie el valor Mostrar
como por Clave y el valor Suprimir filas de resultado por Siempre. Tenga en
cuenta que cualquier restricción o filtro que se aplique aquí se mantendrá de
ahora en adelante en Cognos Transformer.
7. Repita los pasos 5y6para cada característica que seleccionó en el paso 4.
Nota: Solo debe seleccionar las características que necesite. Para evitar el
consumo excesivo de memoria, la disminución del rendimiento del sistema o
que se produzca un error, piense con detenimiento qué características desea
incluir en la consulta. Le recomendamos que consulte a un administrador BW
SAP para asegurarse de que no se superen los volúmenes de datos.
8. Pulse el icono Propiedades de las consultas y en la pestaña Ampliadas active
la casilla de verificación Permitir acceso externo a esta consulta. Así se expone
la consulta a Framework Manager.
9. Pulse Guardar y proporcione una Descripción yunNombre técnico para la
nueva consulta. Le recomendamos que utilice la convención de nomenclatura
BW SAP en el campo Nombre técnico. Es decir, comience la entrada con la
letra 'Z' seguida de un nombre intuitivo o la convención de nomenclatura
estándar. Es muy importante anotar este nombre técnico, puesto que lo
necesitará para encontrar la consulta en Framework Manager.
Resultados
Ahora puede crear una variable “Creación de una variable”. Para obtener más
información sobre cómo usar SAP Query Designer, consulte la documentación de
SAP BW.
Creación de una variable
Ahora debe crear un parámetro de solicitud opcional para la consulta de modo que
Cognos Transformer pueda emitir consultas más pequeñas para SAP y, así,
recuperar todo el conjunto de datos.
Apéndice F. Directrices para trabajar con datos de SAP BW para su uso en Transformer 635

No existen reglas establecidas para utilizar las variables al extraer datos BW SAP a
fin de utilizarse en Cognos Transformer. Sin embargo, debe procurar no solicitar
demasiados datos, ya que podría disminuir el rendimiento o producirse un error
con mensajes de memoria insuficiente en su entorno SAP.
Una directriz básica que se debe seguir es que cuando se utiliza una variable para
la extracción de datos, Cognos Transformer obtendrá en primer lugar todos los
miembros que existan para la dimensión en relación a la cual se define la variable.
A continuación, Cognos Transformer obtendrá datos de forma individual para
extraer los datos de hechos de cada miembro individual de la dimensión, a fin de
satisfacer la variable.
Esto permite a Cognos Transformer descomponer la extracción de datos en grupos
que puede gestionar el servidor BW SAP. No existen estándares establecidos con
respecto a qué dimensiones se deben aplicar. Para alcanzar un rendimiento óptimo,
debe comprender los datos BW SAP y determinar qué dimensión descompone los
datos de hecho equitativamente.
Debe seleccionar con detenimiento qué dimensiones se definirán en la variable.
Para obtener un rendimiento óptimo, es posible que se necesite algo de
experiencia. Por ejemplo, es posible que tenga una dimensión País o región que
contenga tres países o regiones como elementos, Estados Unidos (US), Canadá
(CA) y México (MX). Si la mayor parte del negocio se lleva cabo en Estados
Unidos (90%) y el resto (10%) se registra en Canadá y México a partes iguales, esta
dimensión no descompondría los datos equitativamente. Las consultas que
aparecen como resultado tendrían una petición de gran tamaño (US) y dos más
pequeñas (CA y MX). Por lo tanto, esta dimensión no sería una buena candidata.
No es conveniente aplicar una variable a una dimensión que podría generar
demasiadas peticiones pequeñas. Por ejemplo, [0MATERIAL], una dimensión que
se utiliza a menudo en entornos BW SAP, probablemente no sería una buena
candidata porque generaría demasiadas peticiones pequeñas.
Es posible que se haya definido una dimensión para [COSTCENTER] que divida
equitativamente los datos en 10 centros de costes distintos que pueden utilizarse
para segmentar los datos en partes iguales. Otra buena alternativa podría ser el
año o el mes natural, ya que puede dividir los datos en secciones que funcionen
adecuadamente.
No es necesario aplicar ninguna variable a consultas para la extracción de datos.
Algunas extracciones se llevarán a cabo perfectamente cuando no se aplican
variables. Por ejemplo, una buena estrategia puede ser aplicar una variable a una
dimensión que divida los datos en 20 obtenciones individuales y probar la
extracción. Si esta se lleva a cabo correctamente, puede optar por aplicar una
variable en una dimensión diferente que puede contener 5 miembros diferentes y
ver cómo se compara.
No se puede aplicar ninguna fórmula, puesto que no existen dos entornos
parecidos. Sin embargo, se recomienda utilizar un método prudente para evitar
perturbar el entorno BW SAP.
Procedimiento
1. En Query Designer, pulse con el botón derecho en una característica que ha
seleccionado en el procedimiento anterior y seleccione Restringir.
636 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Para asegurarse de que los datos se distribuyen uniformemente, seleccione una
característica que represente al cubo y no genere un gran número de valores.
Necesita una variable en la que el número de filas de cada valor de la variable
sea similar; no necesita una variable demasiado específica (por ejemplo, no
demasiadas filas por valor que generen un número excesivo de consultas), ni
una variable demasiado general (por ejemplo, más de un millón de filas por
valor).
2. En el cuadro de diálogo Selección para... , pulse la pestaña Variables, pulse
con el botón derecho en el interior de la ventana Descripción y seleccione
Nueva variable.
Nota: Si una de las características que ha seleccionado ya contiene una
variable, no es necesario crear una variable; continúe en el paso 7 de este
procedimiento.
3. En la página Información general del Asistente de nueva variable, escriba un
Nombre de variable y una Descripción y seleccione una dimensión como
característica. Pulse Siguiente.
4. En la página Detalles, seleccione Valor único, Múltiples valores únicos, o
Intervalo en el campo La variable representa, Opcional en el campo La
entrada de variable es y active la casilla de verificación Listo para entrada.
Pulse Siguiente.
5. En la página Valores predeterminados, asegúrese de que el campo Valor por
defecto esté vacío.
6. Pulse Siguiente hasta que vuelva al cuadro de diálogo Selección de ... .La
nueva variable aparece en la ventana Descripción.
7. Seleccione la variable y pulse la flecha hacia la derecha para mover la variable
seleccionada a la ventana Selección. Guarde la consulta. Ya puede importar la
consulta en Framework Manager.
Creación de un paquete en Framework Manager
Para crear un paquete en IBM Cognos Framework Manager, debe hacer lo
siguiente:
v Importe los metadatos de SAP BW con el asistente de metadatos “Pasos para
importar con el asistente de metadatos” en la página 638
Framework Manager importa la consulta de SAP BW en un modelo y define un
paquete que exporta a Content Manager.
En la importación, tenga en cuenta lo siguiente:
– Las dimensiones seleccionadas en la consulta de SAP BW están disponibles en
Carpetas de dimensiones en el cuadro de diálogo Importar.
– Cada dimensión contendrá al menos una jerarquía.
– Seleccione siempre la jerarquía principal cuyo nombre coincida con la
jerarquía.
– Si hay otras jerarquías disponibles, seleccione una que dé los conjuntos
deseados de niveles en la jerarquía.
– Framework Manager importa las dimensiones de tiempo en el modelo desde
el origen de datos de SAP BW solo si se activa un parámetro de
configuración. Definir la configuración como una dimensión de tiempo es una
entrada global; cada dimensión importada se tratará como cadena de tiempo.
v Cree un paquete “Pasos para crear un paquete” en la página 638
Al crear el paquete para publicarlo en Content Manager, oculte la jerarquía
principal en aquellas dimensiones donde haya importado dos jerarquías. La
Apéndice F. Directrices para trabajar con datos de SAP BW para su uso en Transformer 637

jerarquía principal es necesaria y debe estar en el paquete para que las consultas
se realicen correctamente. Puede ocultarla si no desea que esté visible.
Pasos para importar con el asistente de metadatos
Procedimiento
1. En Framework Manager, pulse Crear un proyecto nuevo.
2. Complete los campos del cuadro de diálogo Nuevo proyecto. Pulse Aceptar.
3. Complete los pasos del asistente de metadatos. Cuando se le solicite
seleccionar un origen de datos, si necesita crear un origen de datos, pulse
Nuevo...
4. En la página Seleccionar objetos, localice la consulta que ha definido en el
diseñador de consultas de SAP BW en los pasos anteriores “Creación de una
consulta BW en SAP Business Explorer Query Designer” en la página 634.
Desplácese por la lista hasta localizar el nombre técnico que proporcionó al
crear la variable. La estructura de carpetas es la siguiente: Jerarquías >
Definiciones de nivel > Definiciones de elementos de consulta.
5. Seleccione los elementos de consulta principales relacionados directamente con
el nivel. Es decir, los que tienen la etiqueta (Clave), (Nombre), etc.
Sugerencia: Los atributos secundarios o adicionales se eliminan durante la
importación a Transformer. Solo se importan los elementos necesarios. No
obstante, para mejorar el rendimiento es aconsejable no seleccionar los atributos
secundarios o adicionales. Si selecciona todos los atributos, puede excluir los
elementos de consulta que no desee al publicar el paquete.
6. Complete las pantallas restantes del asistente de metadatos, aceptando los
valores predeterminados y pulsando en Siguiente. Se generarán dimensiones y
se importarán los metadatos.
7. En la última pantalla del asistente, compruebe los resultados y pulse Finalizar.
Resultados
Ahora puede crear un modelo en Transformer. Para obtener más información sobre
la creación de paquetes, consulte: "Creación o modificación de un paquete" en la
publicación Framework Manager Guía del usuario.
Pasos para crear un paquete
Procedimiento
1. Pulse la carpeta Paquetes y, desde el menú Acciones, pulse Crear, Paquete.
2. En la página Proporcionar nombre, escriba el nombre del paquete y, si lo
desea, una descripción y una sugerencia. Pulse Siguiente.
3. Seleccione la consulta que ha importado en el apartado anterior.
Para obtener más información, consulte: “Creación de una consulta BW en SAP
Business Explorer Query Designer” en la página 634.
4. En la página Definir objetos, cuando oculte o excluya objetos hijo del paquete,
debe seleccionar cada uno de ellos individualmente. Al excluir los objetos
padre, se excluyen todos sus objetos hijo. Observe que si se excluyen (o anula
la selección) muchos paquetes de cubos grandes se tardará mucho tiempo en
ejecutar la operación.
Nota: Framework Manager da soporte a la funcionalidad Ctrl+Mayús y
Alt+Mayús. Utilice estas teclas para seleccionar varios objetos que desee incluir
u ocultar en el cubo. Por ejemplo, si desea incluir solo dos elementos de una
638 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

ifurcación grande, seleccione toda la bifurcación y, después, utilice Ctrl+Mayús
para anular la selección de los elementos que desee incluir y oculte los
elementos que queden seleccionados.
Para obtener más información sobre la inclusión, exclusión u ocultación de
objetos, consulte: "Creación o modificación de un paquete" en la publicación
Framework Manager Guía del usuario.
5. Elija si desea utilizar los permisos de acceso predeterminados para el paquete.
v Para aceptar los permisos de acceso predeterminados, pulse Finalizar.
v Para definir los permisos de acceso, pulse Siguiente.
6. Cuando se le solicite abrir el asistente para publicación de paquetes, pulse Sí.
7. Seleccione los valores predeterminados y pulse Publicar. De este modo, se
publicará el paquete en el almacén de contenido y se podrá acceder al paquete
en Transformer.
8. En la última pantalla, compruebe los resultados y pulse Finalizar.
Resultados
Ahora puede crear un modelo en Transformer. Para obtener más información sobre
la creación de paquetes, consulte: "Creación o modificación de un paquete" en la
publicación Framework Manager Guía del usuario.
Creación de un modelo en Transformer
Utilice Transformer para acceder a un paquete basado en SAP publicado y
utilizarlo como origen de datos para crear un modelo. Después de crear el modelo,
puede crear PowerCubes para utilizarlos con el componente de IBM Cognos que
desee, accediendo a los datos dimensionales y de hechos del origen SAP BW
original. Además, puede combinar metadatos de SAP en un modelo de
Transformer con otros metadatos corporativos u orígenes personales siempre que
disponga de la información de clave coincidente necesaria para unir los datos
durante la construcción de cubos.
Al crear el modelo de Transformer, debe utilizar el asistente de Insertar dimensión
de paquete en lugar del Asistente para nuevo modelo. Se utiliza el asistente de
Insertar dimensión de paquete porque
v Crea una única consulta para cada dimensión y para los hechos.
v Importa hechos y dimensiones de la misma manera que modelos relacionales
modelados dimensionalmente. Es decir, los hechos y las dimensiones se
importan a la vez.
v Asegura que el ámbito esté definido correctamente entre las dimensiones y los
hechos.
v Rellena la dimensión con la información apropiada de clave de empresa y título.
v Solo importa los elementos necesarios del paquete BW para la creación del cubo,
cuando se importan los metadatos. Esto reduce el número de atributos y
conserva los volúmenes de datos de únicamente los elementos necesarios para la
construcción del cubo.
Si desea definir reglas de negocio, debe hacerlo en el modelo de Transformer en
lugar de hacerlo en Framework Manager. Los cálculos que se definen en
Framework Manager no se importan a Transformer.
Apéndice F. Directrices para trabajar con datos de SAP BW para su uso en Transformer 639

Pasos para crear un modelo en Transformer
Procedimiento
1. En Transformer, pulse Crear un modelo nuevo.
2. En el asistente de modelos nuevos, pulse Cancelar.
3. Con el panel Mapa de dimensiones seleccionado, en el menú Editar, pulse
Insertar dimensión de paquete.
4. Pulse Examinar para abrir el navegador de metadatos.
5. En el cuadro de diálogo Explorar metadatos, seleccione el paquete que
contiene la consulta de SAP BW y pulse Aceptar.
6. En el cuadro de diálogo Insertar dimensión de paquete, pulse Finalizar.
7. En el cuadro de diálogo Seleccionar dimensión y medidas de paquete, pulse
las dimensiones y medidas para incluir en el origen de datos.
Seleccione un elemento de consulta que le proporcionará las fechas para el
PowerCube. Tenga en cuenta que las fechas de PowerCube pueden obtenerse
completamente de los datos de transacción.
8. Si se producen errores o avisos, se le notificarán. En el panel Orígenes de
datos, amplíe el paquete para ver las consultas de origen de datos y los
elementos de consulta. Las cifras clave o medidas aparecen en el panel
Medidas.
Compruebe que la regla de agregación de cada medida esté correctamente
definida en Transformer para que esté lo máximo alineada posible con la regla
de agregación definida en SAP BW.
Se recomienda que el tipo de almacenamiento de todas las medidas esté
definido como coma flotante de 64 bits.
Para el nivel de raíz de cada característica (dimensión), compruebe que esté
marcado como exclusivo.
Las jerarquías de presentación de SAP BW puede contener rutas irregulares,
normalmente asociadas con nodos"no asignados" y "#" de la jerarquía. Los
huecos de estas jerarquías producen espacios en blanco en el nivel asociado en
la jerarquía de Transformer. En Transformer, se puede definir el texto que debe
usarse para los espacios en blanco (el texto predeterminado es ""). Sin
embargo, es más conveniente definir un texto más adecuado para las entradas
en blanco de todos estos niveles.
9. Si desea añadir otra consulta, repita los pasos 3a7.
Sugerencia: Si añade una dimensión nueva a un modelo después de añadir
las medidas, Transformer no añade automáticamente la clave para la nueva
dimensión a las cifras clave. En consecuencia, el ámbito no está definido en el
mapa de dimensiones. En tales casos, debe añadir manualmente la clave para
la nueva dimensión del nivel inferior de la dimensión a las cifras clave.
10. Guarde el modelo.
Resultados
Ahora puede utilizar este modelo para crear PowerCubes para utilizarlos con el
componente de IBM Cognos que desee, accediendo a los datos dimensionales y de
hechos del origen de datos de SAP BW original. Para obtener más información,
consulte el apartado relativo a la creación de modelos en la publicación
Transformer Manager Guía del usuario.
640 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Cómo trabajar con datos de SAP BW utilizando archivos CSV
externalizados en Framework Manager
Cuando se externalizan asuntos de consulta y dimensiones en formatos que se
pueden utilizar en otras aplicaciones, se deben tener en cuenta algunas
consideraciones especiales. Cuando se extraen datos de SAP BW utilizando
Framework Manager, se debe comprender la distinción que hace Framework
Manager entre los diferentes tipos de dimensiones. Cada tipo de dimensión se
comporta de forma diferente cuando se externaliza, y se puede modificar antes de
la externalización.
En las versiones 7.x, 8.1 y 8.2 de Transformer, puede aprovechar los datos de SAP
BW utilizando un paquete de Framework Manager en el que los asuntos de
consulta y las dimensiones se externalizan utilizando archivos CSV. Transformer
puede utilizar los archivos CSV como origen de datos para crear un modelo y
generar PowerCubes. Los archivos CSV también están soportados en Transformer
versión 8.3 pero se recomienda utilizar el soporte de paquete para datos
dimensionales y los archivos CSV para datos de hechos.
En esta versión de Transformer, la utilización de paquetes de Framework Manager
publicados en Content Manager es el método preferido para utilizar datos de SAP
BW. Para obtener información general sobre la creación de paquetes, consulte:
"Crear o modificar un paquete" en la publicación Framework Manager Guía del
usuario. Para obtener información específica de SAP sobre cómo crear paquetes,
consulte el tema "Cómo trabajar con datos de SAP BW utilizando un paquete de
Framework Manager".
Tamaño de extracción
La propiedad de origen de datos Tamaño de extracción en Framework Manager
controla la cantidad de datos recuperados de SAP BW en cualquier momento.
Si este valor es negativo, cero o está vacío, se emite una única consulta a SAP BW
para extraer los datos de característica.
Si el valor es positivo, Framework Manager emite varias consultas a SAP BW, cada
una de las cuales devuelve aproximadamente el número de megabytes especificado
por la propiedad Tamaño de extracción.
Esta característica puede reducir el tamaño global del resultado de la consulta en el
servidor SAP BW. La ejecución de la consulta global puede tardar más, pero para
características grandes, si no se utiliza esta función se puede llegar a consumir el
espacio de memoria asignado a un usuario en el servidor SAP BW.
Todos los datos de una dimensión de característica se encontrarán en la memoria
de Framework Manager antes de producir un archivo de extracción. Es importante
que solo los elementos de consulta necesarios se extraigan de SAP BW para
asegurar que la extracción no falle debido a errores de asignación de memoria en
Framework Manager.
Los asuntos de consulta se extraen utilizando el mismo mecanismo con el que se
ejecutan las consultas en IBM Cognos. Por lo tanto, la propiedad Tamaño de
extracción no tiene ningún efecto en la ejecución de la consulta.
Apéndice F. Directrices para trabajar con datos de SAP BW para su uso en Transformer 641

Dimensiones de medida
Al extraer una dimensión de medida, debe crear un asunto de consulta de modelo
que contenga las medidas que desee. Debe incluir el elemento de consulta de clave
de empresa de cada uno de los niveles de cada dimensión, en función del nivel de
granularidad que intente conseguir.
Para obtener información sobre la externalización de asuntos de consulta de
modelo, consulte: “Consideraciones sobre Framework Manager” en la página 644.
Dimensiones de característica
Las dimensiones de característica se externalizan independientemente del tipo de
origen de datos de SAP BW, como InfoCube o consulta de SAP BW.
Framework Manager utiliza un único enfoque para externalizar todas las
dimensiones que no contienen elementos de consulta de hechos. En estos casos, el
valor de configuración del tamaño de extracción se utiliza para controlar la manera
en que se extraen los datos de SAP BW.
Nota: Los asuntos de consulta de modelo se externalizan de manera diferente,
independientemente de si contienen elementos de consulta de hechos o no. Para
obtener información sobre la externalización de asuntos de consulta de modelo,
consulte: “Consideraciones sobre Framework Manager” en la página 644.
Dimensiones de cifras clave de un InfoCube de SAP BW
Al externalizar la dimensión de cifras clave de un modelo basado en un InfoCube,
Framework Manager utiliza exactamente el mismo enfoque que el utilizado para
externalizar asuntos de consulta de modelo.
Para un InfoCube que contiene más de unos cuantos miles de transacciones, la
externalización de un InfoCube directamente de Framework Manager puede
exceder fácilmente los límites de tiempo y memoria en el cliente o el servidor. En
estos casos, se recomienda encarecidamente que se utilice una consulta SAP BW
como base de la externalización de los metadatos de SAP BW.
Dimensiones de cifras clave de una consulta SAP BW
La utilización de una consulta BEx como base para la externalización de cifras
clave de un origen de datos de SAP BW es, en la mayoría de casos, el mejor
enfoque. Mediante la utilización de una variable BEx para dividir los datos de la
dimensión de cifras clave en secciones manejables, se pueden extraer volúmenes
arbitrariamente grandes de datos de transacción de SAP BW.
Sin embargo, tenga en cuenta que este enfoque incurre en algunas restricciones
como lo que se puede extraer de SAP BW y cómo se puede extraer. El resto de esta
sección describe cómo se utiliza la consulta SAP BW para extraer datos de SAP
BW, incluidas todas las restricciones y limitaciones conocidas.
Requisitos de una consulta SAP BW
En el resto de esta sección, se supondrá que se usa una consulta SAP BW como
base para externalizar los datos, no como base para la generación de informes, y
no con la intención de superar las limitaciones de memoria y tiempo asociadas con
la extracción de datos directamente de un cubo de información.
642 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

No se puede externalizar una consulta SAP BW arbitraria. Una consulta SAP BW
debe cumplir las siguientes limitaciones si desea externalizarla:
v Defina la visualización de características con el valor Clave. Si define la
visualización con otro valor pueden obtenerse datos incorrectos.
Para cambiar los elementos que aparecen para una característica, pulse con el
botón derecho en la característica y pulse Propiedades. En el cuadro de diálogo
Propiedades de característica, cambie el valor Mostrar como por Clave.
Es extremadamente aconsejable utilizar el valor Clave.
v Para reducir los volúmenes de datos, así como la cantidad de agregación que
realiza el servidor de SAP BW, se recomienda inhabilitar el resumen para todas
las características de la consulta en la hoja de propiedades de esta.
Para inhabilitar el resumen para una característica, pulse con el botón derecho
en la característica en el borde de la consulta SAP BW y pulse Propiedades. En
el cuadro de diálogo Propiedades, defina Suprimir filas de resultados con el
valor Siempre.
v Si se muestra por lo menos una característica de la consulta SAP BW como algo
diferente de Clave, debe suprimirse el resumen para todas las características.
v La consulta no puede contener la característica Moneda/Unidad.
v No se puede asignar a ninguna de las características una jerarquía de
visualización, ni explícitamente ni por una variable.
v Si en una consulta SAP BW se incluye una característica como característica
libre, no aparecerá ningún valor para dicha característica en la extracción de
cifras clave.
Un filtro aplicado a una característica libre actúa como filtro en los datos que
devuelve BW SAP. Es un mecanismo eficaz para definir un subconjunto de un
cubo de información.
Un filtro de este tipo puede aplicarse a una característica a lo largo del eje de
una consulta SAP BW, en cuyo caso los valores filtrados aparecen en la
extracción de cifras clave.
v Todas las cifras clave de la consulta BW SAP deben ser numéricas.
v Los valores de cada cifra clave deben estar en una sola moneda. No se debe usar
una variable para realizar la asignación de una moneda de destino.
v Incluya en la consulta SAP BW solo las características que deban extraerse con
Framework Manager. Si incluye características innecesarias, aumentará el
volumen de datos transferidos de SAP BW, lo que afectará al rendimiento.
Directrices y restricciones al trabajar con cubos SAP BW
Debe utilizar archivos CSV al importar metadatos de cubos SAP BW. Por razones
de rendimiento, se recomienda filtrar por geografía, períodos de tiempo o alguna
otra dimensión que limite la cantidad de datos que se recuperan. Recuerde que
debe aplicar el filtro de dimensión a las dimensiones relacionadas y a sus tablas de
hechos (medidas).
Para obtener más información, consulte el apartado relativo a la creación de filtros
en la publicación Framework Manager Guía del usuario.
Debido a que los cubos SAP BW son multidimensionales, se aplican resúmenes al
origen. Si cambia el tipo de resumen después de importar los datos a Cognos
Transformer, los resultados no serán válidos.
Los datos o metadatos que faltan y están fuera del ámbito para una medida en
particular pueden dar lugar a resultados diferentes, en función del contexto. Puede
ver:
Apéndice F. Directrices para trabajar con datos de SAP BW para su uso en Transformer 643

v Valores nulos
v Símbolos #
v REST_H
v No asignado
Puesto que estas señales duplicadas pueden provocar problemas en Cognos
Transformer, en niveles exclusivos por ejemplo, se recomienda asignar filtros a las
dimensiones para que no aparezcan en los datos importados.
Por último, recuerde seleccionar solo los elementos de consulta necesarios para
generar los datos filtrados.
Consideraciones sobre Framework Manager
Al extraer la dimensión de medida de una consulta SAP BW, la propiedad Tamaño
de extracción del origen de datos controla la cantidad de datos recuperada a la vez
del servidor SAP BW. Los asuntos de consulta de modelo se externalizan de
manera diferente, independientemente de si contienen elementos de consulta de
hechos o no. En este escenario, el valor no tiene efecto en el servidor SAP BW, pero
limita la cantidad de memoria que Framework Manager asigna en cualquier
momento a recuperar los datos.
Tenga en cuenta que los filtros definidos en la dimensión de cifras clave no se
imponen al extraer datos de una consulta SAP BW. Para obtener beneficios en el
rendimiento de la extracción de datos de una consulta SAP BW, se deben definir
filtros en una consulta SAP BW.
Además, se ignoran los cálculos definidos dentro de la dimensión de cifras clave.
Se deben definir dentro de la consulta SAP BW en BEx, o en un asunto de consulta
de modelo de Framework Manager.
Cada característica extraída debe contener al menos un elemento de consulta del
nivel más bajo de su jerarquía (si la hay) para proporcionar un enlace con la
extracción de cifras clave. Debe incluir el elemento de consulta de clave de
empresa de cada uno de los niveles de cada dimensión, en función del nivel de
granularidad que intente conseguir.
Uso de variables para externalizar cifras clave desde una
consulta de SAP BW
El volumen de transacciones en una consulta de SAP BW es tal que, en la mayoría
de los casos, el uso de una sola consulta para extraer los datos de SAP BW
superará la memoria asignada a un usuario en un servidor de SAP BW. En
Framework Manager, puede utilizar una única variable opcional para extraer datos
de hechos de una consulta de SAP BW en secciones de tamaños razonables.
Para utilizar esta función, se asigna a una característica incluida en la consulta de
SAP BW (pero no incluida como característica gratuita) una variable que cumple
las siguientes condiciones:
v Debe ser un valor único.
v Debe ser opcional.
v No debe ser un valor predeterminado.
v Puede estar definido en la característica o en una jerarquía de presentación.
Si una consulta de SAP BW contiene una variable así y la dimensión de cifras clave
se externaliza, Framework Manager ejecuta una consulta para cada valor posible
644 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

asociado con una variable. Así, al elegir una característica adecuada, la dimensión
de cifras clave puede extraerse sin superar las limitaciones de memoria del cliente
o del servidor. Las memorias caché del cliente y del servidor se borran después de
cada consulta.
Si se utiliza una jerarquía de presentación para dirigir la creación de secciones
extracción, es importante que puedan obtenerse los valores de una variable de un
único nivel en la jerarquía; si no es así, la extracción contendrá los datos resumidos
en varios niveles. Para limitar los valores de una variable a un único nivel de una
jerarquía, edite la restricción de niveles de la variable en Framework Manager. Por
ejemplo, si usa un valor como "2:2" significa que solo se van a usar los valores del
segundo nivel de la jerarquía (el nivel 0 es la raíz de una jerarquía).
Si hay una consulta de SAP BW con una variable de este tipo, el valor de la
variable se restablece después de cada consulta.
Si una consulta de SAP BW contiene algo más que una sola variable o una variable
que se haya definido de forma diferente que la descrita anteriormente, Framework
Manager no intenta utilizar una variable para dividir la extracción de la dimensión
de cifras clave en secciones más pequeñas.
Solución temporal para problemas detectados durante la
externalización
Al externalizar un origen de datos de Framework Manager, puede producirse un
error de autenticación si
v El modelo está publicado en Content Manager
v La externalización de los datos tarda más en realizarse que el tiempo de espera
asignado a los pasaportes de la configuración de IBM Cognos
No se solicita a los usuarios que vuelvan a especificar las credenciales de
autenticación.
Si se produce un error, los datos externalizados siguen estando completos y siendo
válidos. Sin embargo, si el modelador opta por publicar realmente el modelo, el
modelador deberá volver a autenticar y publicar el modelo, pero sin externalizar
los datos.
Otra solución es publicar el modelo en la red, en cuyo caso el error de
autenticación no se produce.
Creación de PowerCubes a partir de datos SAP BW
Se pueden crear IBM Cognos PowerCubes a partir de datos SAP BW. Existen
directrices que se deben tener en cuenta tanto para Framework Manager como
para Transformer.
Para obtener más información, consulte: “Directrices de Framework Manager” y
“Directrices para Transformer” en la página 646.
Directrices de Framework Manager
Cuando externalice datos para la creación de uno o varios PowerCubes, recuerde
estas consideraciones.
v La extracción de cada característica debe tener un elemento de consulta de clave
común que sea equivalente a una consulta de clave suplente en la extracción de
cifras clave.
Apéndice F. Directrices para trabajar con datos de SAP BW para su uso en Transformer 645

v En una extracción basada en una consulta SAP BW, se recomienda
encarecidamente que todas las características se visualicen como clave en la
consulta SAP BW.
v Si una característica no tiene una jerarquía de presentación, o se desea una
nueva, extraiga uno o varios elementos de consulta que puedan formar la base
para los niveles de una jerarquía.
v Durante la importación de metadatos de SAP BW a un modelo que va a extraer
datos, limite el modelo a solo los elementos de consulta que son absolutamente
necesarios para crear un PowerCube. Esto mejorará el rendimiento de la
extracción.
v Los valores nulos se incluyen en archivos CSV al externalizar asuntos de
consulta y dimensiones basados en SAP BW.
v Un límite práctico para PowerCubes es 2.000.000 categorías (valores) para una
dimensión (característica).
Directrices para Transformer
Cuando utilice datos de SAP BW que se han extraído de Framework Manager,
tenga en cuenta lo que se indica a continuación.
v En Transformer versión 8.3, puede insertar dimensiones regulares desde orígenes
de datos de SAP directamente desde un origen de datos de IBM Cognos con la
opción Insertar dimensión de paquete.
v Con el asistente para modelos de Transformer, inserte un origen de datos de tipo
texto con campos delimitados con títulos de columna y empiece seleccionando el
archivo CSV. No ejecute el diseño automático.
v Arrastre todas las columnas de cifras clave desde el panel de origen de datos al
panel de medidas. Compruebe que la regla de agregación de cada medida esté
correctamente definida en Transformer para que esté lo máximo alineada posible
con la regla de agregación definida en SAP BW.
v Se recomienda que el tipo de almacenamiento de todas las medidas esté definido
como coma flotante de 64 bits.
v Con el asistente para fechas, seleccione un elemento de consulta que
proporcionará las fechas para PowerCube. Tenga en cuenta que las fechas de
PowerCube pueden obtenerse completamente de los datos de transacción.
v Inserte los diversos archivos CSV correspondientes a las características que se
externalizaron con Framework Manager.
Cada archivo CSV contiene una columna que se corresponde con una columna
de archivo CSV de cifras clave. Al pulsar con el botón derecho las diversas
columnas y editar sus propiedades, compruebe que las columnas que
proporcionen un enlace entre una característica y las cifras clave tenga el mismo
nombre. Por ejemplo, si una columna de cifra clave tiene el nombre Cliente y la
columna correspondiente del archivo CSV de clientes se denomina Cliente -
Clave, el nombre de la columna del archivo CSV de cifras clave debe cambiarse
por Cliente - Clave.
v Para cada característica, cree una dimensión, usando las columnas clave u otros
atributos de una característica, para indicar los niveles de la dimensión. Para
cada nivel, compruebe que las propiedades de la etiqueta, el nombre abreviado
y la descripción tienen asignadas columnas de origen, si procede.
v Para el nivel de raíz de cada característica (dimensión), compruebe que esté
marcado como exclusivo.
v Las jerarquías de presentación de SAP BW puede contener rutas irregulares,
normalmente asociadas con nodos"no asignados" y "#" de la jerarquía. Los
huecos de estas jerarquías producen espacios en blanco en el nivel asociado en la
jerarquía de Transformer.
646 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

En Transformer, se puede definir el texto que debe usarse para los espacios en
blanco. El texto predeterminado es blank, pero debe definir un texto más adecuado
para las entradas en blanco para todos estos niveles.
Apéndice F. Directrices para trabajar con datos de SAP BW para su uso en Transformer 647

648 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Apéndice G. Palabras reservadas
Los nombres de orígenes de datos, tablas y columnas no deben ser nombres
reservados por IBM Cognos Software.
Si tiene que usar una palabra reservada, inclúyala entre comillas en la
especificación SQL. Por ejemplo, select Orderdate, "Timezone".
Las palabras siguientes están reservadas:
Rango Palabras reservadas
A a C abs, all, and, any, as, asc, at, avg, between,
bigint, bit_length, boolean, both, by, call,
case, cast, ceil, ceiling, char, char_length,
character, character_length, coalesce, count,
create, cross, cube, cume_dist, current,
current_date, current_time,
current_timestamp, cursor
D a M date, day, dbkey, dec, decimal, declare,
delete, dense_rank, desc, distinct, double,
else, end, escape, except, exists, exp, extract,
false, filename, filter, first, first_value, float,
floor, following, for, from, full, group,
grouping, hash, having, hour, in, inner,
insert, int, integer, intersect, interval, into, is,
join, last, last_value, leading, left, like, ln,
local, localtime, localtimestamp, loop, lower,
max, merge, min, minute, mod, month
N a Q national, natural, nchar, no, not, ntile, null,
nullif, nulls, numeric, nvarchar, octet_length,
of, on, or, order, others, out, outer, over,
partition, perc, percent_rank, percentile,
percentile_cont, percentile_disc, position,
power, preceding, precision, qualify
R a T range, rank, ratio_to_report, ravg, rcount,
rdiff, real, recursive, returning, right, rmax,
rmin, rollup, row, row_number, rows, rsum,
scroll, second, select, set, sets, smallint,
snapshot, some, sqrt, stddev, stddev_pop,
stddev_samp, substring, sum, table, tertile,
then, time, timestamp, timezone_hour,
timezone_minute, to, top, trailing, trim, true,
U a Z unbounded, union, unknown, updatable,
update, upper, user, using, values, var_pop,
var_samp, varchar, variance, varying, when,
where, window, with, within, without, xavg,
xcount, xfirst, xlast, xmax, xmin,
xmovingavg, xmovingsum, xntile, xperc,
xrank, xratio, xstddev, xstddev_pop, xsum,
xtertile, xvariance, xvariance_pop, year, zone
También están reservadas las palabras siguientes: _cursor, _local y _rowset.
© Copyright IBM Corp. 2005, 2013 649

650 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Apéndice H. Tipos de datos XML
Puede importar XML como un origen de datos tabulares en IBM Cognos
Framework Manager.
Se da soporte a los tipos de datos siguientes al importar de XML en Framework
Manager.
v boolean
v byte
v date
v dateTime
v decimal
v double
v ENTITIES
v ENTITY
v float
v ID
v IDREF
v int
v integer
v language
v long
v Nombre
v NCName
v negativeInteger
v NMTOKEN
v NMTOKENS
v nonNegativeInteger
v NonPositiveInteger
v NOTATION
v positiveInteger
v QName
v short
v string
v time
v token
v unsignedLong
v unsignedInt
v unsignedShort
v unsignedByte
No se da soporte a los siguientes tipos de datos.
v base64Binary
v duration
© Copyright IBM Corp. 2005, 2013 651

v gYearMonth
v gYear
v gMonthDay
v gMonth
v hexBinary
652 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Avisos
Esta información se ha desarrollado para productos y servicios ofrecidos en todo el
mundo.
Puede que IBM no ofrezca en algunos países los productos, servicios o
características que se explican en este documento. Póngase en contacto con el
representante local de IBM para obtener información acerca de los productos y
servicios que actualmente están disponibles en su zona. Cualquier referencia hecha
a un producto, programa o servicio de IBM no implica ni pretende indicar que sólo
pueda utilizarse ese producto, programa o servicio de IBM. En su lugar, podrá
utilizarse cualquier producto, programa o servicio con características equivalentes
que no infrinja ningún derecho de propiedad intelectual de IBM. Sin embargo, será
responsabilidad del usuario evaluar y verificar el funcionamiento de cualquier
programa, producto o servicio que no sea de IBM. Este documento puede incluir
descripciones de productos, servicios o características que no forman parte de la
titularidad de licencia o programa que ha adquirido.
Puede que IBM tenga patentes o solicitudes de patentes pendientes relacionadas
con los temas principales que se tratan en este documento. La posesión de este
documento no le otorga ninguna licencia sobre estas patentes. Puede enviar sus
consultas sobre licencias, por escrito, a la dirección siguiente:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
EE. UU.
Para realizar consultas sobre licencias relacionadas con la información de doble
byte (DBCS), póngase en contacto con el Departamento de propiedad intelectual de
IBM de su país o envíe sus consultas, por escrito, a la dirección:
Intellectual Property Licensing
Legal and Intellectual Property Law
IBM Japan Ltd.
1623-14, Shimotsuruma, Yamato-shi
Kanagawa 242-8502 Japón
El párrafo siguiente no tiene aplicación en el Reino Unido ni en ningún otro país
en el que tales provisiones sean incoherentes con la legislación local:
INTERNATIONAL BUSINESS MACHINES CORPORATION PROPORCIONA
ESTA PUBLICACIÓN "TAL CUAL", SIN GARANTÍAS DE NINGÚN TIPO, YA
SEAN EXPRESAS O IMPLÍCITAS, INCLUIDAS, PERO SIN LIMITARSE A, LAS
GARANTÍAS IMPLÍCITAS DE NO INFRACCIÓN, COMERCIALIZACIÓN O
IDONEIDAD PARA UNA FINALIDAD DETERMINADA. En algunos estados no
está permitida la renuncia de las garantías expresas o implícitas en determinadas
transacciones, por lo tanto, puede que esta declaración no se aplique a su caso.
Esta información podría incluir imprecisiones técnicas o errores tipográficos.
Periódicamente se realizan cambios en la información que aquí se presenta; tales
cambios se incorporarán en nuevas ediciones de la publicación. IBM podría realizar
© Copyright IBM Corp. 2005, 2013 653

mejoras y/o cambios en el producto o productos y/o programa o programas que
se describen en esta publicación en cualquier momento y sin previo aviso.
Cualquier referencia hecha en esta información a sitios web que no son de IBM
sólo se proporciona para su comodidad y bajo ninguna circunstancia ha de
interpretarse que IBM representa o se hace responsable del contenido de esos sitios
web. Los materiales de esos sitios web no forman parte de los materiales de este
producto de IBM y la utilización de esos sitios web será responsabilidad del
usuario.
IBM podría utilizar o distribuir la información que se le envía de la forma que
considere más oportuna sin incurrir por ello en ninguna obligación con el
remitente de la información.
Los tenedores de licencias de este programa que deseen obtener información acerca
de éste con el fin de permitir: (i) el intercambio de información entre programas
creados independientemente y otros programas (incluido el presente) y (ii) la
utilización mutua de la información que se ha intercambiado, deben ponerse en
contacto con:
IBM Software Group
Attention: Licensing
3755 Riverside Dr
Ottawa, ON K1V 1B7
Canadá
Esta información podría estar disponible, de acuerdo con los términos y
condiciones aplicables, incluyendo en algunos casos el pago de una tarifa.
El programa bajo licencia que se describe en este documento y todo el material
bajo licencia disponible para éste los proporciona IBM en función de lo dispuesto
en el IBM Customer Agreement, el Acuerdo Internacional de Licencia de Programa
de IBM o cualquier otro acuerdo equivalente celebrado entre ambas partes.
Los datos relacionados con el rendimiento que pudiera contener este documento se
han determinado en un entorno controlado. Por lo tanto, los resultados obtenidos
en otros entornos operativos podrían variar significativamente. Puede que algunas
mediciones se hayan obtenido en sistemas de desarrollo y no existe ninguna
garantía que permita afirmar que puedan obtenerse las mismas mediciones en
sistemas de disponibilidad general. Es más, puede que algunas mediciones sean
estimaciones obtenidas por extrapolación. Los resultados reales podrían variar. Los
usuarios de este documento deben verificar los datos que se aplican a su entorno
específico.
La información relacionada con productos que no son de IBM se ha obtenido de
los proveedores de esos productos, los anuncios que han publicado u otras fuentes
de disponibilidad pública. IBM no ha probado esos productos y no puede
confirmar la precisión de la información relacionada con el rendimiento, la
compatibilidad ni ningún otro aspecto relacionado con productos que no son de
IBM. Las preguntas relacionadas con las prestaciones de los productos que no son
de IBM deben dirigirse a los proveedores de esos productos.
Todas las declaraciones relacionadas con futuras directrices o intenciones de IBM
están sujetas a cambios oasuretirada sin previo aviso y sólo representan
objetivos.
654 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Marcas registradas
Esta información contiene ejemplos de datos e informes que se utilizan en
operaciones empresariales de uso habitual. Para ilustrarlas de la forma más
completa posible, los ejemplos incluyen nombres de personas, empresas, marcas y
productos. Todos estos nombres son ficticios y cualquier similitud que pudiera
darse con nombres y direcciones que utilice una empresa real es pura coincidencia.
Puede que si visualiza esta información en copia software, las fotografías e
ilustraciones a color no aparezcan.
IBM, el logotipo de IBM e ibm.com son marcas registradas de International
Business Machines Corp., registradas en muchas jurisdicciones de todo el mundo.
Otros nombres de productos y servicios pueden ser marcas registradas de IBM o
de otras compañías. Hay disponible una lista actual de marcas registradas de IBM
en la web en “ Información de copyright y marcas registradas ” en
www.ibm.com/legal/copytrade.shtml.
Los términos siguientes son marcas registradas de otras empresas:
v Adobe, el logotipo de Adobe, PostScript y el logotipo de PostScript son marcas
registradas de Adobe Systems Incorporated en los Estados Unidos o en otros
países.
v Microsoft, Windows, Windows NT y el logotipo de Windows son marcas
registradas de Microsoft Corporation en los Estados Unidos o en otros países.
v UNIX es una marca registrada de The Open Group en los Estados Unidos o en
otros países.
v Java y todas las marcas registradas y logotipos basados en Java son marcas
registradas de Oracle o sus filiales.
Avisos 655

656 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Glosario
Este glosario incluye términos y definiciones de
IBM Cognos Business Intelligence e IBM Cognos
Framework Manager.
En este glosario se utilizan las referencias
cruzadas siguientes:
v Consulte le remite de un término a un
sinónimo preferido, o de un acrónimo o
abreviatura al término definido en su formato
completo.
v Consulte también le remite a un término
relacionado u opuesto.
Para ver glosarios de otros productos de IBM,
vaya a www.ibm.com/software/globalization/
terminology (se abre en una ventana nueva).
“A” “C” en la página 658 “D” en la página 659
“E” en la página 660 “G” en la página 661 “H” en
la página 661 “I” en la página 661 “J” en la
página 661 “L” en la página 661 “M” en la página
661 “N” en la página 662 “O” en la página 662
“P” en la página 662 “R” en la página 663 “S” en
la página 664 “T” en la página 664 “U” en la
página 665 “V” en la página 665
A
acceso anónimo
Tipo de acceso que permite a los usuarios
y servidores acceder a un servidor sin
autenticarse primero.
agente Proceso que realiza una acción en nombre
de un usuario u otro programa sin la
intervención del usuario o en una
planificación regular, e informa de los
resultados al usuario o programa.
agrupación
En la creación de informes, el proceso de
organizar juntos valores comunes de los
elementos de consulta y sólo visualizar el
valor una vez.
alias Nombre alternativo utilizado en vez del
nombre principal.
almacén de contenido
Base de datos que contiene los datos
necesarios para trabajar, tales como
especificaciones de informe, modelos
publicados y derechos de seguridad.
almacén de métricas
Base de datos que incluye contenido para
paquetes de métricas. Un almacén de
métricas también contiene los valores de
Metric Studio, como por ejemplo las
preferencias del usuario.
árbol de datos
Dentro de un estudio, estructura que
contiene objetos como asuntos de
consulta, elementos de consultas,
dimensiones, niveles y miembros. Un
árbol de datos se utiliza como paleta de
los datos disponibles que se pueden
insertar en cálculos, filtros, áreas de
visualización y otros gestos de creación.
archivo de despliegue
Archivo utilizado para el despliegue. Este
archivo de despliegue contiene los datos
del almacén de contenido que se está
moviendo.
archivo de respuestas
Archivo ASCII que se puede personalizar
con los datos de instalación y
configuración que automatizan una
instalación. Durante una instalación
interactiva, se deben especificar los datos
de instalación y configuración. Sin
embargo, con un archivo de respuestas, la
instalación puede continuar sin ninguna
intervención.
área de trabajo
Área dentro de un estudio que contiene el
informe, el análisis, la consulta o el agente
que se está utilizando.
asunto de consulta
Colección con nombre de elementos de
consulta con funcionalidades muy
similares. Los asuntos de consulta se
definen mediante Framework Manager
con el fin de representar datos
relacionales y constituyen el conjunto de
datos disponibles para crear informes en
Query Studio y Report Studio. Un asunto
de consulta es similar a una vista
relacional, en el sentido de que se puede
considerar como una tabla, si bien no
© Copyright IBM Corp. 2005, 2013 657

epresenta necesariamente el
almacenamiento de datos.
atributo
1. En los modelos dimensionales,
propiedad que proporciona
información cualitativa sobre los
miembros de un nivel en una
dimensión. Por ejemplo, el nivel
Almacén de la dimensión Minorista
puede tener propiedades como
dirección o espacio minorista. En
general, los atributos de dimensión no
tienen resúmenes o valores de medida
asociados, pero se utilizan para
localizar o filtrar miembros.
2. En los modelos relacionales, un
elemento de consulta que no es una
medida ni un identificador. Cuando
un elemento de consulta es un
atributo, no debe utilizarse para
agregarse, ni para agruparse o generar
listas de selección de solicitudes.
3. En BI Modeling, característica de una
entidad que es descriptiva en lugar de
un identificador exclusivo o una
medida agregativa.
autenticación
Proceso de validación de la identidad de
un usuario o servidor.
C
CA Consulte: entidad emisora de certificados.
cardinalidad
1. Para los orígenes de datos
relacionales, indicación numérica de la
relación entre dos asuntos de consulta,
elementos de consulta u otros objetos
de modelo.
2. Para los orígenes de datos OLAP,
número de miembros de una
jerarquía. La propiedad de
cardinalidad de una jerarquía se
utiliza para asignar órdenes de
resolución a expresiones.
certificado
En seguridad informática, un documento
digital que vincula una clave pública a la
identidad del propietario de certificado, lo
que permite autenticar al propietario del
certificado. Un certificado está expedido
por una entidad emisora de certificados y
cuenta con la firma digital de dicha
658 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario
entidad. Consulte también entidad
emisora de certificados.
CGI Consulte interfaz de pasarela común.
clave de evento
Combinación de elementos de datos que
definen de forma única una instancia de
evento. Al identificar una instancia de
evento, el agente puede determinar si es
nuevo, está en curso o detenido.
clave de separación
La dimensión o el nivel de una consulta
en la especificación del informe que se
utiliza para crear, o separar, un conjunto
de resultados del informe.
CM Consulte Content Manager.
columna definida por el usuario
En la administración de métricas,
columna utilizada para representar un
valor diferente del actual o del destino.
Puede tratarse de un valor de referencia
de la industria o cualquier otra
información numérica adicional útil para
un periodo, incluido un cálculo basado en
otros valores de la métrica. Las columnas
definidas por el usuario pueden ser
diferentes para cada tipo de métrica.
componente de nivel de aplicación
En la instalación, el conjunto de
procesadores que acceden a las bases de
datos de consultas para reunir
información y luego presentar los
resultados como informes y métricas en
PDF y HTML. Los componentes de nivel
de aplicación también pasan solicitudes a
Content Manager y presentan los
resultados que Content Manager recupera
del almacén de contenido.
condición
Expresión que puede evaluarse como
verdadera, falsa o desconocida. Se puede
expresar en texto de lenguaje natural, en
notación formal matemáticamente o en
lenguaje que una máquina puede leer.
conexión de origen de datos
Información con nombre que define el
tipo del origen de datos, su ubicación
física y los requisitos de inicio de sesión si
los hubiese. Un origen de datos puede
tener más de una conexión.
conjunto
Colección de miembros o elementos

elacionados. Los miembros de un
conjunto se pueden seleccionar de forma
específica o mediante una o más reglas de
filtro. Consulte también conjunto
personalizado, conjunto basado en
detalles, conjunto de páginas, conjunto
predefinido, conjunto basado en
selecciones, conjunto apilado.
conjunto apilado
Dos o más conjuntos dispuestos uno
sobre otro en filas o en forma de mosaico
en columnas. Consulte también conjunto.
conjunto basado en detalles
Conjunto basado en un elemento y sus
detalles inmediatos. Consulte también
conjunto.
conjunto basado en selecciones
Colección de elementos individuales
seleccionados expresamente por el
usuario. Los elementos o miembros se
pueden seleccionar de entre uno o más
niveles de la misma jerarquía. Consulte
también conjunto.
conjunto con nombre
Consulte conjunto predefinido.
conjunto de páginas
En Report Studio, conjunto de una o
varias páginas diseñadas que se repiten
en la salida del informe para cada
instancia de un elemento de consulta
seleccionado. Consulte también conjunto.
conjunto de unión
Consulte conjunto apilado.
conjunto personalizado
En Analysis Studio, objeto con nombre
que puede incluir reglas de filtro, cálculos
y reglas de orden. Los conjuntos
personalizados pueden definir un
conjunto de miembros que sea diferente
de cualquier conjunto definido
originariamente en el modelo de cubo.
Consulte también conjunto predefinido,
conjunto.
conjunto predefinido
Conjunto de miembros definidos en el
interior de un origen de datos OLAP
como una lista o mediante una expresión.
Los conjuntos predefinidos se pueden
utilizar en la creación de informes y
análisis. Consulte también conjunto
personalizado, conjunto.
consulta
Especificaciones de informe simple
creadas y editadas por Query Studio.
contacto
Dirección de correo electrónico con
nombre a la que se pueden enviar
informes y correos electrónicos de
agentes. Los contactos nunca están
autenticados.
Content Manager (CM)
Servicio que recupera información del
almacén de contenido y guarda
información en dicho almacén.
credencial
Conjunto de información que otorga a un
usuario o proceso determinados derechos
de acceso.
cubo Representación multidimensional de datos
necesaria para las aplicaciones de
procesamiento analítico en línea,
generación de informes
multidimensionales o planificación
multidimensional.
D
despliegue
Proceso de mover una aplicación (como
un informe o un modelo) a una instancia
diferente. Por ejemplo, es habitual crear
informes en un entorno de prueba y
después desplegarlos en producción. Al
desplegar una aplicación, ésta se exporta,
transfiere e importa.
detallar más
En una representación multidimensional
de datos, acceder a la información
empezando por una categoría general y
descendiendo por la jerarquía de
información, por ejemplo de años a
trimestres y a meses.
dimensión
Agrupación amplia de datos descriptivos
acerca de un aspecto importante de una
empresa, como productos, fechas o
ubicaciones. En cada dimensión se
incluyen distintos niveles de miembros en
una o más jerarquías y un conjunto
opcional de miembros calculados o
categorías especiales.
dimensión compatible
Dimensión con una única definición que
Glosario 659

diseño
E
puede reutilizarse o compartirse en varias
despensas de datos coordinados.
Organización del material impreso en una
pantalla o página, incluidos los márgenes,
el interlineado, la especificación de tipo,
la información de cabecera y pie de
página, las sangrías, etc.
elemento
Consulte miembro.
elemento de consulta
Representación de una columna de datos
en un origen de datos. Los elementos de
consulta pueden aparecer en un modelo o
en un informe y contienen una referencia
a una columna de la base de datos, una
referencia a otro elemento de la consulta o
un cálculo.
elemento de noticias
Una única entrada en un formato
compatible de sindicación realmente
simple (RSS). Puede incluir un título,
texto y un enlace a información adicional.
Una tarea de elemento de noticias de un
agente se puede utilizar para crear
elementos de noticias que mostrar en un
portlet de Cognos Connection.
entidad emisora de certificados (CA)
Componente que expide certificados para
todos los sistemas en los que hay
instalados componentes.
entorno local
Valor que identifica el idioma o la
geografía y determina las convenciones de
formateo, como ordenación, conversión de
mayúsculas y minúsculas, clasificación de
caracteres, idioma de los mensajes,
representación de fecha y hora y
representación numérica.
entorno local del contenido
Código que se utiliza para establecer el
idioma o el dialecto utilizado para los
navegadores, el texto del informe y las
preferencias regionales, como los formatos
de hora, fecha, dinero, expresiones de
dinero y hora del día.
entorno local del producto
Código o configuración que especifica qué
idioma o configuración regional debe
660 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario
utilizarse para partes de la interfaz del
producto, como los comandos de menú.
espacio de nombres
Parte del modelo en la que pueden
definirse y utilizarse nombres. En un
espacio de nombres, cada nombre tiene
un significado exclusivo.
espacio de trabajo
Consulte panel de control.
especificación de despliegue
Definición de los paquetes que hay que
mover (desplegar) entre los entornos
origen y destino, las preferencias de
despliegue y el nombre del archivo. Las
especificaciones de despliegue se utilizan
para la importación y exportación.
especificación de informe
Definición ejecutable de un informe,
incluidas las reglas de consulta y diseño,
que se puede combinar con datos para
generar una salida de informe.
estilo de clase
Combinación de características de
formateo, como la fuente, el tamaño de la
fuente y el borde, que el usuario guarda y
nombra como un conjunto.
estrategia
Plan de acción general (por ejemplo, para
una unidad de marca, una unidad de
negocio, un canal o una compañía) para
alcanzar un objetivo indicado. Las
estrategias suelen abarcar un periodo de
más de un año.
estructura de tabla de puntuación
Jerarquía de tablas de puntuación que
refleja la organización de las métricas de
una empresa.
evento
Cambio a un estado, como la finalización
o el error de una operación, un proceso
empresarial o una tarea humana, que
puede activar una acción posterior, como
la persistencia de los datos de evento en
un repositorio de datos o la invocación de
otro proceso empresarial.
extracción de objeto
Extracción que define los metadatos de un
objeto de Metric Studio, como una
columna definida por el usuario, una
tabla de puntuación o un origen de datos.

extracción métrica
Conjunto de correlaciones entre un origen
de datos de Cognos existente y un valor u
objeto de Metric Studio. Por ejemplo, una
medida de cubo denominada Ingresos se
correlaciona con una métrica de Metric
Studio denominada Valor real de ingresos.
G
glifo Forma real (modelo de bits, contorno) de
la imagen de un carácter. Por ejemplo,
una A en cursiva y una A latina son dos
tipos distintos de glifos que representan el
mismo carácter subyacente. En sentido
estricto, dos imágenes cualesquiera con
formas diferentes constituyen dos glifos
diferentes. En este sentido, glifo es
sinónimo de imagen de carácter o
sencillamente de imagen (estándar
Unicode, versión 1.0).
grupo Colección de usuarios que pueden
compartir autoridades de acceso a
recursos protegidos.
H
hecho Consulte medida.
I
índice derivado
Métrica calculada que proporciona un
estado y una puntuación en base a otras
métricas.
informe
Un conjunto de datos que se muestra
específicamente para comunicar
información de la empresa.
iniciativa
Tarea desarrollada para alcanzar objetivos
o estrechar la diferencia entre el
rendimiento y los objetivos. Cada objetivo
tiene asociadas iniciativas, conocidas a
menudo como proyectos, acciones o
actividades.
Interfaz de pasarela común (CGI)
Estándar de Internet para definir
secuencias de comandos que transmiten
información desde un servidor web a un
programa de aplicación, a través de una
solicitud HTTP, y viceversa.
J
jerarquía
Organización de un conjunto de entidades
en una estructura en árbol, en la que cada
entidad (salvo la raíz) tiene una o varias
entidades padre y un número arbitrario
de entidades hijo.
L
Lenguaje de expresiones multidimensionales
(MDX)
Equivalente multidimensional del
lenguaje de consulta estructurado (SQL).
lienzo Área de un panel de control o espacio de
trabajo con la que los usuarios interactúan
para crear, ver y manipular el contenido y
los datos.
lista de eventos
Conjunto de instancias de eventos
detectadas evaluadas por las reglas de
ejecución de tareas para determinar las
tareas de agente que han de realizarse.
lista de observación
Lista de métricas que ha elegido cada
usuario para realizar una supervisión
exhaustiva. Si se habilita la notificación en
Metric Studio, el usuario recibirá una
notificación por correo electrónico con los
cambios en esas métricas. Los usuarios
también pueden elegir mostrar su lista de
observación como un portlet dentro de
Cognos Connection.
M
mapa de estrategia
En Metric Studio, representación visual de
la estrategia y los objetivos de dicha
estrategia para una organización. Por
ejemplo, un mapa de estrategia puede
demostrar a los empleados que sus
trabajos están alineados con los objetivos
generales de la organización.
MDX Consulte lenguaje de expresiones
multidimensionales.
medida
Indicador de rendimiento que puede
cuantificarse y que se usa para determinar
el funcionamiento general de una
empresa. Por ejemplo, las medidas
Glosario 661

pueden ser Ingresos, Ingresos/Empleado
y Porcentaje de margen de beneficio.
métrica
Una medida para evaluar el rendimiento
en un área clave de una empresa.
miembro
Elemento único dentro de una jerarquía.
Por ejemplo, Equipo de acampada y
Tienda para 4 personas son miembros de
la jerarquía Productos.
miembro calculado
Miembro de una dimensión cuyos valores
de medida no se guardan sino que se
calculan en tiempo de ejecución mediante
una expresión.
miniatura
Representación del tamaño de un icono
de una imagen gráfica más grande que
permite al usuario obtener la vista previa
de la imagen sin abrir un editor gráfico o
de visualización.
modelo
Representación física o empresarial de la
estructura de los datos de uno o más
orígenes de datos. Un modelo describe
objetos de datos, su estructura y
agrupación, así como las relaciones y la
seguridad. En Cognos BI, un modelo se
crea y mantiene en Framework Manager.
El modelo, o un subconjunto del modelo,
debe publicarse en el servidor de Cognos
como un paquete para que los usuarios
creen y ejecuten informes.
N
nivel Conjunto de entidades o miembros que
constituyen una sección de una jerarquía
en una dimensión y representan el mismo
tipo de objeto. Por ejemplo, una
dimensión geográfica puede contener
niveles de región, estado y ciudad.
normalización
Proceso de reestructuración de un modelo
de datos mediante la reducción de sus
relaciones a sus formatos más sencillos. Se
trata de un paso clave en la tarea de
creación de un diseño de base de datos
relacional lógica. La normalización
permite evitar las redundancias y las
inconsistencias en los datos. Una entidad
está normalizada si cumple un conjunto
662 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario
O
de restricciones de una forma normal
concreta (primera forma normal, segunda
forma normal, etc.).
objeto En Report Studio, contenedor de
información vacío que se puede arrastrar
a un informe desde la pestaña Caja de
herramientas y, a continuación, rellenar
con datos. Los informes están compuestos
por objetos, que incluyen tablas de
referencias cruzadas, elementos de texto,
cálculos, gráficos y tablas.
origen de datos
El propio origen de los datos, por
ejemplo, una base de datos o un archivo
XML, y la información de conexión
necesaria para acceder a los mismos.
origen de datos dimensionales
Origen de datos que contiene datos
modelados mediante conceptos de OLAP,
incluidas dimensiones, jerarquías y
medidas.
origen de datos multidimensionales
Consulte origen de datos dimensionales.
P
panel de control
Página web que puede contener uno o
varios widgets que representan
gráficamente los datos empresariales.
panel de información
En Analysis Studio, panel que ayuda al
usuario a confirmar la selección en el
árbol de datos mostrando información
relacionada, como el nivel y los atributos.
panel de propiedades
Dentro de un estudio, panel que ofrece
una descripción general de las
propiedades de los datos seleccionados. El
panel de propiedades también se puede
utilizar para realizar modificaciones y
aplicarlas al mismo tiempo, en lugar de
repetir varios comandos diferentes.
paquete
Subconjunto de un modelo, que puede
tratarse de todo el modelo, que se habilita
para el servidor de Cognos. Consulte
también paquete de métricas.

paquete de cifrado
La combinación de autenticación,
algoritmo de intercambio de claves y la
especificación de cifrado de Secure
Sockets Layer (SSL) que se utiliza para el
intercambio seguro de datos.
paquete de métricas
En Cognos Connection, representación de
una aplicación de Metric Studio. Un
paquete de métricas contiene información
de la conexión, informes y tareas de
administración de métricas para dicha
aplicación. Consulte también paquete.
pasaporte
Información basada en la sesión,
almacenada y cifrada en la memoria de
Content Manager, referente a usuarios
autenticados. Un pasaporte se crea la
primera vez que un usuario accede a
Cognos 8yseretiene hasta que finaliza la
sesión, ya sea porque el usuario cierra la
sesión o porque se ha sobrepasado un
tiempo determinado de inactividad.
pasarela
Extensión de un programa de servidor
web que transfiere información desde el
servidor web a otro servidor. Aunque las
pasarelas suelen ser programas CGI,
pueden seguir otros estándares como
ISAPI y módulos de Apache.
paso de trabajo
Parte más pequeña de un trabajo que se
puede ejecutar por separado. Un paso de
trabajo puede ser un informe u otro
trabajo.
permiso de acceso
Privilegio que permite el acceso a un
objeto o la utilización del mismo.
plantilla
En la creación de informes, el estilo o el
diseño de informe reutilizable que se
puede utilizar para definir la presentación
de una consulta o un informe.
portlet
Componente reutilizable que forma parte
de una aplicación web que proporciona
información o servicios específicos que se
presentan en el contexto de un portal.
prestación
Grupo de funciones y características que
se pueden ocultar o mostrar para
simplificar la interfaz de usuario. Las
prestaciones se pueden habilitar o
inhabilitar modificando los valores de
preferencias o se pueden controlar
mediante una interfaz de administración.
proveedor de autenticación
Mecanismo de comunicación con un
origen de autenticación externo. A través
de los proveedores de autenticación están
disponibles funcionalidades como la
autenticación de usuarios, pertenencia a
grupos y búsquedas en espacios de
nombres.
proveedor de seguridad
Consulte proveedor de autenticación.
proyecto
1. En Metric Studio, tarea o conjunto de
tareas emprendidas por un equipo y
supervisadas en una tabla de
puntuación. Un proyecto realiza el
seguimiento de las fechas, los recursos
y el estado del propio proyecto.
2. En Framework Manager, conjunto de
modelos, paquetes e información
relacionada para administración, y
para compartir información del
modelo.
3. En Metric Designer, grupo de
extracciones. Cada extracción contiene
los metadatos que se utilizan para
rellenar el almacén de datos de Metric
Studio o para crear aplicaciones.
publicar
En Cognos BI, exponer la totalidad o
parte de un modelo de Framework
Manager o PowerCube de Transformer
mediante un paquete al servidor Cognos,
de modo que puedan utilizarse los datos
para crear informes y otro contenido.
puntuación
Número o clasificación que expresa la
capacidad de aplicación con relación a un
estándar.
R
Really Simple Syndication (RSS)
Formato de archivo XML para contenido
web corporativo basado en la
especificación Really Simple Syndication
(RSS 2.0). Los usuarios de Internet
utilizan los formatos de archivo XML RSS
para suscribirse a sitios web que
Glosario 663

proporcionan entradas RSS. Consulte
también Rich Site Summary.
regla de ejecución de tarea
Opción especificada por el usuario dentro
de un agente que determina qué estados
y valores producen la ejecución de una
tarea. Determina las tareas que se van a
ejecutar para cada instancia de evento.
regla de observación
Condición definida por el usuario que
determina si se entrega un informe al
usuario. Cuando se ejecuta la regla, se
evalúa la salida y, si ésta cumple la
condición o regla, el informe se entrega
por correo electrónico o como elemento
de noticias. Las reglas de observación
limitan la entrega de informes a aquellos
que contengan datos de relevancia para el
usuario.
regulador
Conjunto de reglas que limitan las
actividades del usuario, como la ejecución
de informes, que tardan demasiado
tiempo o que consumen demasiados
recursos.
repetidor
En Report Studio, contenedor de celdas
que repite los valores dentro de sí mismo
sin una estructura interna predefinida.
restricción
1. Se trata de una especificación de
seguridad que deniega a uno o más
usuarios la capacidad de acceder a un
componente de modelo o de realizar
una tarea de modelado o creación.
2. Restricción de los posibles valores que
los usuarios pueden especificar en un
campo.
resumen
En análisis y creación de informes, valor
agregado que se calcula para todos los
valores de una dimensión o nivel en
particular. Algunos ejemplos de
resúmenes son total, mínimo, máximo,
promedio y recuento.
Rich Site Summary (RSS)
Formato basado en XML para contenido
Web corporativo basado en la
especificación RSS 0.91. Los usuarios de
Internet utilizan los formatos de archivo
XML RSS para suscribirse a sitios web
RSS
664 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario
S
que proporcionan entradas RSS. Consulte
también Really Simple Syndication (RSS).
1. Consulte Really Simple Syndication
(RSS).
2. Consulte Rich Site Summary.
salida de informe
Salida que se produce como resultado de
la ejecución de una especificación de
informe con respecto a un conjunto de
datos.
segmento de modelo
Parte de un proyecto de Framework
Manager, como un mapa de parámetros,
un origen de datos, un espacio de
nombres o una carpeta, que es un atajo a
un segundo proyecto. Se pueden utilizar
segmentos para simplificar el
mantenimiento del modelo o para facilitar
el modelado multiusuario.
separar
Crear varios resultados de informes
ejecutando un único informe una vez. Por
ejemplo, el usuario puede crear un
informe que muestre las ventas de cada
empleado y ejecutarlo una vez, enviando
los distintos resultados, separándolos por
región, a los directores regionales.
sesión Tiempo durante el cual un usuario
autenticado tiene una sesión iniciada.
solicitud
Elemento de informe que pide valores de
los parámetros antes de la ejecución del
informe.
solicitud en cascada
Solicitud que utiliza valores de una
solicitud anterior para filtrar los valores
de la solicitud o lista de selección actual.
T
tabla de puntuación
Colección de métricas que representan el
rendimiento de una unidad o aspecto de
una organización.
tabla de puntuación de responsabilidad
Tabla de puntuación creada
automáticamente por Metric Studio para

cada usuario que contiene las métricas y
los proyectos que poseen los usuarios.
tabla de repetidor
En Report Studio, contenedor parecido a
una tabla que repite las celdas en
horizontal y hacia abajo en la página o
fila de la consulta asociada.
tarea Acción realizada por un agente si el
estado del evento cumple las reglas de
ejecución de tareas. Por ejemplo, un
agente puede enviar un mensaje de correo
electrónico, publicar un elemento de
noticias o ejecutar un informe.
tarjeta de información
Presentación de información de alto nivel
acerca del contenido del panel de control,
espacio de trabajo o informe, como el
propietario, la información de contacto y
la fecha de modificación, así como una
vista en miniatura opcional del panel de
control, espacio de trabajo o informe.
tipo de métrica
Categoría de métrica que define reglas de
negocio como el modelo de rendimiento,
las unidades y el significado de un grupo
de métricas. Por ejemplo, Ingresos puede
ser un tipo de métrica, e Ingresos
europeos e Ingresos americanos serían
métricas de este tipo.
trabajo
Grupo de objetos ejecutables, como
informes, agentes y otros trabajos, que el
usuario ejecuta y planifica como un lote.
tupla Colección ordenada de dos o más
miembros de dimensiones diferentes. Por
ejemplo, la tupla (2007, Equipo de
acampada, Japón) devuelve el valor para
la intersección de los tres miembros: 2007,
Equipo de acampada y Japón. Las tuplas
se pueden utilizar para filtrar y ordenar
los datos, además de para crear cálculos.
U
usuario
Persona, organización, proceso,
dispositivo, programa, protocolo o sistema
que utiliza los servicios de un sistema
informático.
V
vista de informe
Una referencia de otro informe que posee
sus propias propiedades, como los valores
de solicitud, las planificaciones y los
resultados. Las vistas de informe se
pueden utilizar para compartir una
especificación de informe en lugar de
realizar copias de la misma.
W
Web Services for Remote Portlets
Estándar en la creación de servicios web
orientados a la presentación para que se
puedan integrar fácilmente en otras
aplicaciones, como los portales web.
widget
Parte de contenido dinámico o aplicación
portátil, reutilizable, que puede ubicarse
en una página web, recibir entrada y
comunicarse con una aplicación o con
otro widget.
Glosario 665

666 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario

Índice
A
abrir
proyectos 14
acceder
conexiones de origen de datos 44
InfoCube protegido 193
acceso administrativo 260
acceso administrativo a paquete
modificar 260
Acelerador de modelos 31
actualizar
asuntos de consulta 97
modelos 14, 375
modelos de IBM Cognos ReportNet 376
proyectos enlazados 383
proyectos segmentados 383
versiones de modelo 265
actualizar modelos
avisos 382
aditivo 139, 222
agregación 324
reglas para metadatos de SAP BW 220, 221, 222, 223
reglas para metadatos relacionales 134, 136, 137, 139
tipos 222
tipos de metadatos relacionales 139
agregación para cálculos 337
agregaciones calculadas
metadatos relacionales 136
agregaciones de resumen
metadatos relacionales 138
Agrupación de atributos de medida
regulador 308
ajuste de rendimiento
procesamiento de consultas 313
alias
utilizar con parámetros 157, 241
almacén de datos
relaciones 68
analizar
modelos 187
problemas 7
publicar impacto en paquetes 288
Analysis Studio y datos difusos 72
añadir
conjuntos de funciones 317
funciones de origen de datos 317
grupos 254
idiomas para metadatos relacionales 128
idiomas para paquetes 261
reglas de negocio para metadatos de SAP BW 235
reglas de negocio para metadatos relacionales 149
roles 254
seguridad 260
seguridad de metadatos 260
seguridad de objetos 257
usuarios 254
aplicar
filtros para metadatos de SAP BW 240
filtros para metadatos relacionales 155
Árbol del explorador 29
archivo de registro
archivar entradas 301
archivos csv 262, 265
archivos de Impromptu Query Definition 262, 265
archivos de registro 295
reproducir 296
archivos de script
arreglar errores 300
archivos incluidos 262, 265
archivos tab 262, 265
archivos XML
importar 65
archivos XML de Architect
importar 50
archivos XML de Impromptu
importar 50
arreglar
transacciones que han fallado 279
asesor de modelos 187
asistente de metadatos 34
asunto de consulta de hechos detallado 633
asuntos de consulta
archivos csv 262, 265
archivos de Impromptu Query Definition 262, 265
archivos de Transformer 262, 265
archivos incluidos 262, 265
archivos tab 262, 265
buscar 23
cardinalidad mixta 187
construir mediante Model Design Accelerator 35
convertir en dimensiones 379
DB2 389
definición 12
determinantes 187, 334, 379
dimensiones 187, 328
explorar 19, 30
externalizados 262, 265
grupos de esquema en estrella 354
hechos 187
modos de transacción 315
probar 63
propiedades 21
SAP BW 377
seguridad 256
SQL minimizado 187
utilizar en Transformer 262
varias relaciones 187
asuntos de consulta condicionales 157, 241
asuntos de consulta de modelo
definición 12
externalización 641
seguridad 258
asuntos de consulta de modelo para metadatos de SAP
BW 214
crear 214
crear desde objetos existentes 215
asuntos de consulta de modelo para metadatos
relacionales 78
crear 79
crear desde objetos existentes 88
determinantes 84, 86
© Copyright IBM Corp. 2005, 2013 667

asuntos de consulta de modelo para metadatos relacionales
(continuación)
tipo de SQL 105
asuntos de consulta de orígenes de datos
crear 77
definición 12
asuntos de consulta de orígenes de datos para metadatos
relacionales 76
determinantes 84, 86
usar parámetros 162
asuntos de consulta de orígenes de datos relacionales
actualizar 97
evaluar 95
asuntos de consulta de procedimiento almacenado 79
actualizar 97
Composite 80
crear 82
definición 12
ejemplo 83
evaluar 95
Informix 80
modificar 82
asuntos de consulta para metadatos de SAP BW
crear 214, 215
evaluar 216
mapas de parámetros 241
modelo 214
asuntos de consulta para metadatos relacionales
actualizar 97
atajos 180
cambiar tipo de SQL 99
conjuntos de consultas 89
convertir 97, 98
convertir a partir de dimensiones 123
crear 77, 79, 88
determinantes 84, 86
editar SQL 98
evaluar 95
explorar 89
generar SQL 105
mapas de parámetros 157
modelo 78
modificar 21, 82
origen de datos 76
probar 92
procedimiento almacenado 79
relaciones 68
SQL 75
tipos 75
asuntos de consulta SAP BW 377
atajos 335
comportamiento 305, 307
seguridad 258
atajos de teclado 385
atajos para metadatos de SAP BW
dimensiones 246
utilizar 246
atajos para metadatos relacionales
dimensiones y asuntos de consulta 180
relaciones 74, 180
utilizar 178
atributos 105, 106, 115, 116, 201, 207, 209, 379
auditar 272, 288
668 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario
B
bases de datos
importar 48
bifurcación
metodologías 274
proyectos 273
bifurcaciones
crear 277
BLOB 306
BmtScriptPlayer
sintaxis 297
borrar
seguridad de objetos 257
buscar
objetos 21, 23
C
cadenas incorporadas 162
en expresiones 162
en macros 162
cadenas literales 162
en expresiones 162
en macros 162
cálculos
crear para metadatos de SAP BW 236
crear para metadatos relacionales 150
discrepancias numéricas injustificadas 391
orden de operaciones 337
seguridad 258
cálculos numéricos injustificados 391
cambiar
metadatos 285
tipo de SQL 99
cambiar de nombres
proyectos 286
relaciones 72
cambiar paquetes
analizar efectos 288
cambios en el modelo y no en el informe 269
capa de base de datos 67
capa de presentación 67
capa empresarial 67
capa física 67
capas 67
caracteres japoneses
rutas de exportación 390
característica
correlación con Framework Manager 199
características
eliminadas 1
modificadas 1
nuevas 1
obsoletas 1
características de accesibilidad 385
atajos de teclado 385
características eliminadas 1
características modificadas 1
características nuevas 1
características obsoletas 1
cardinalidad
1-1 362
1-n 362
comprobar 342
consultas 71, 322
dimensiones y hechos 342

cardinalidad (continuación)
hechos 187
mixta 187
notación 70
origen de datos 69
reglas 71, 322
tipos 71, 322
volver a definir 72
cardinalidad máxima 71, 322
cardinalidad mínima 71, 322
cardinalidad obligatoria 71
cardinalidad opcional 71, 322
carpetas
crear 182, 183
elemento de consulta 183
medida 183
usar atajos 178
carpetas de medidas 183
carpetas para metadatos de SAP BW
crear 246
usar atajos 246
catálogo 319
categorías
para verificar 250
cifras clave 193
correlación con Framework Manager 199
estructuras 195
modificar 210
solicitudes 390
cifras clave calculadas 193
cifras clave de consulta de SAP BW
externalización 642
cifras clave de InfoCube
externalización 642
cifras clave detalladas 633
claves 106, 201, 379
cardinalidad 69
especificar roles 115, 116
foráneo 74
para niveles 113
para roles 207, 209
principal 74
claves foráneas 74
claves principales 74
claves únicas 379
CLOB
Oracle 387
Cognos PowerCubes
Véase IBM Cognos PowerCubes
Cognos SQL 101
comentarios
añadir a SQL 98
comillas 162
en expresiones 162
en macros 162
comillas dobles 162
comillas simples 162
Common Warehouse Metamodel 291
exportar 390
comparar tablas 89
comprender
metadatos 271
comprobar
proyectos 250
relaciones 68
con cláusula 305
conceptos 321
conceptos de esquema en estrella 349
conceptos de modelado relacional 321
conectar a varios PowerCubes 41
conexiones de bases de datos,
Véase conexiones de origen de datos
conexiones de origen de datos 44
acceder 44
crear 44
cubos OLAP 41
Microsoft SQL 44
niveles de aislamiento 42
probar 47
conexiones entre
asuntos de consulta 89
dimensiones 120, 210
configuración regional
configurar un entorno multilingüe 123
configuración regional,
Véase idiomas
conjunto de consultas de excepción 89
conjunto de consultas de intersección 89
conjunto de consultas de todas las excepciones 89
conjunto de consultas de todas las intersecciones 89
conjunto de consultas de todas las uniones 89
conjunto de consultas de unión 89
conjunto de datos predeterminado
establecer 293
conjuntos de consultas para metadatos relacionales
crear 89
probar 92
conjuntos de funciones
añadir 253, 317
definir 317
Consulta, SAP BW
correlación con Framework Manager 199
consulta SAP BW
permisos para acceder a metadatos 194
consulta sin hechos 355
consultas
enlazadas 342
hecho único 357
sin hechos 355
split 369
varias granularidades 328
varios hechos 328, 359, 364
consultas de hechos únicos 357
consultas de varias granularidades 328, 359, 364
consultas de varios hechos 328, 359, 364
consultas dimensionales 357
hecho único 357
hechos y granularidad múltiples 359, 364
consultas divididas 369
consultas enlazadas 342
consultas sobre hechos cruzados 342
controlar
acceso 254
generación de SQL 305
convenciones de nomenclatura
objetos 25
convertir
asuntos de consulta de modelo en asuntos de consulta de
orígenes de datos 98
asuntos de consulta en dimensiones 97
dimensiones regulares 123
elementos de consulta en medidas 149
medidas en elementos de consulta 117, 118
Índice 669

copiar
proyectos 285
corchetes 162
correlacionar
objetos de SAP BW con Framework Manager 199
valores de parámetros para metadatos de SAP BW 241
valores de parámetros para metadatos relacionales 157
crear 291
asuntos de consulta para metadatos de SAP BW 214
asuntos de consulta para metadatos relacionales 77, 79, 82
atajos de relación para metadatos relacionales 74
bifurcaciones 277
cálculos para metadatos de SAP BW 236
cálculos para metadatos relacionales 150
carpetas de elementos de consulta para metadatos
relacionales 183
carpetas de medidas para metadatos relacionales 183
carpetas para metadatos de SAP BW 246
carpetas para metadatos relacionales 182
conexiones de origen de datos 44
conjuntos de consultas para metadatos relacionales 89
dimensiones de medida 353
dimensiones de medida para metadatos relacionales 117
dimensiones para metadatos de SAP BW 201
dimensiones para metadatos relacionales 105, 106, 115,
116
dimensiones regulares 351
dimensiones regulares para metadatos relacionales 107,
119
enlaces 283
espacios de nombres 65
espacios de nombres para metadatos de SAP BW 246
espacios de nombres para metadatos relacionales 182
filtros para metadatos de SAP BW 237
filtros para metadatos relacionales 153
grupos de esquema en estrella 354
mapas de parámetros para metadatos de SAP BW 241
mapas de parámetros para metadatos relacionales 157
paquetes 253
proyectos 13, 34
relaciones para metadatos relacionales 73
segmentos 282
solicitudes con macros de consulta 166
cubo de información
correlación con Framework Manager 199
permisos para acceder a metadatos 194
cubo múltiple
correlación con Framework Manager 199
cubo remoto
correlación con Framework Manager 199
cubos 319
cubos OLAP
como orígenes de datos 41
CWM,
Véase Common Warehouse Metamodel
D
date
solicitudes 145, 225
tipo de formato 143, 223
datos
formatear para metadatos de SAP BW 223
formatear para metadatos relacionales 143
multilingües, utilizar 123
seguridad 254, 256
Datos Aster 2, 3
670 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario
datos de hechos 350
datos de la memoria caché 305
reutilizar 314
datos de SAP BW
Cognos Planning 633
crear paquetes 5
datos difusos
medidas semiaditivas 141
datos difusos y Analysis Studio 72
datos dimensionales 349
DB2 389
DB2 Cube Views
expresiones importadas 63
DecisionStream
importar 50
definir
conjuntos de funciones 317
controles de solicitud 144
controles de solicitud para metadatos de SAP BW 224
idiomas para metadatos relacionales 128
dependencias, informe 288
dependencias, objeto 289
detectar
relaciones 74
determinantes 84
asuntos de consulta 334
cardinalidad 69
convertir información de dimensiones 379
definir 324
especificar 84, 86
generación de SQL 87
identificados exclusivamente 84, 86
relaciones 187
determinantes identificados exclusivamente 84, 86
Diagrama de asunto de consulta 31
Diagrama del explorador 30
diagramas 14
valores 20, 33
ver 19, 30, 31
dimensiones
ambiguas 368
asuntos de consulta 328
buscar 23
cardinalidad mixta 187
compartidas 339
convertir desde asuntos de consulta 379
crear 20
definición 11
explorar 19, 30
grupos de esquema en estrella 354
identificar 342
jerarquías 351
medida 339, 353
medidas semiaditivas 141
modelo 328
modificar 20
propiedades 21
regular 328, 334, 339, 351
rol 343
SAP BW 633
dimensiones compartidas 339
dimensiones compatibles 355
crear 89
SAP BW 6
varios hechos 359, 364
dimensiones de característica
externalización 642

dimensiones de estrella 178
dimensiones de medida 339
crear 353
externalización de SAP BW 642
rol 343
dimensiones de medida para metadatos de SAP BW
explorar 210
dimensiones de medida para metadatos relacionales
crear 117
explorar 120
relaciones de ámbito 118, 119
dimensiones de rol 187, 343
dimensiones de SAP BW 633
dimensiones en copo de nieve 178
dimensiones externalizadas
solicitudes 390
dimensiones para metadatos de SAP BW 200
atajos 246
cifras clave 210
jerarquías 201
jerarquías de red 206
jerarquías desequilibradas 204
jerarquías equilibradas 202
jerarquías irregulares 204
mapa de dimensiones 201
niveles 201, 207
probar 211
regular 201
roles 207, 209
dimensiones para metadatos relacionales 105, 173
atajos 180
claves 113
convertir 123
convertir desde asuntos de consulta 97
copo de nieve 178
explorar 120
fusión 119
jerarquías 109
jerarquías de red 112
jerarquías desequilibradas 111
jerarquías equilibradas 110
jerarquías irregulares 112
mapa de dimensiones 105, 106, 115, 116
medida 117
modificar 21
niveles 109, 112
probar 120
regular 107
relaciones de ámbito 118, 119
roles 115, 116
dimensiones regulares 328, 334, 339
crear 351
jerarquías 351
rol 343
dimensiones regulares para metadatos de SAP BW 201
explorar 210
jerarquías 201
niveles 201, 207
dimensiones regulares para metadatos relacionales 107
convertir 123
explorar 120
fusión 119
jerarquías 109
niveles 109, 112
relaciones de ámbito 118, 119
documentación de modelo 272
documentar el modelo 272
E
editar
SQL 98
editor de expresiones
buscar valores 393
Cadena de datos Aster 434
Cadena de Greenplum 457
Cadena de MySQL 475
Cadena de Paraccel 495
Cadena de Postgres 497
Cadena de Vectorwise 534
conjuntos de funciones 317
Constantes 425
Construcciones 426
Datos Aster 434
DB2 439
Formateo de tipo de datos de Greenplum 458
Formateo de tipo de datos de los datos Aster 436
Formateo de tipo de datos de Paraccel 496
Formateo de tipo de datos de Postgres 499
Formateo de tipo de datos de Vertica 539
Funciones cast de MS Access 468
Funciones comunes 556
Funciones de bloque 433
funciones de fecha 509
Funciones de fecha/hora 428
Funciones de informe 595
Funciones de macro 542
Funciones de resumen 403
Funciones dimensionales 569
Funciones estadísticas 404
Funciones fonéticas de Netezza 481
Funciones matemáticas de datos Aster 436
Funciones matemáticas de DB2 439
Funciones matemáticas de Greenplum 459
Funciones matemáticas de Informix 462
Funciones matemáticas de MS Access 469
Funciones matemáticas de MySQL 477
Funciones matemáticas de Netezza 479
Funciones matemáticas de Oracle 486
Funciones matemáticas de Paraccel 496
Funciones matemáticas de Postgres 499
Funciones matemáticas de SAP BW 509
Funciones matemáticas de SQL Server 513
Funciones matemáticas de Sybase 521
Funciones matemáticas de Vectorwise 535
Funciones trigonométricas 566
Funciones trigonométricas de DB2 439
Funciones trigonométricas de Greenplum 459
Funciones trigonométricas de Informix 462
Funciones trigonométricas de MS Access 469
Funciones trigonométricas de MySQL 477
Funciones trigonométricas de Netezza 480
Funciones trigonométricas de Oracle 486
Funciones trigonométricas de Postgres 500
Funciones trigonométricas de SAP BW 508
Funciones trigonométricas de SQL Server 513
Funciones trigonométricas de Sybase 521
Funciones trigonométricas de Teradata 529
Funciones trigonométricas de Vectorwise 536
Greenplum 457
Informix 462
MS Access 468
MySQL 475
Netezza 479
Netezza Fuzzy 481
Operadores 395
Índice 671

editor de expresiones (continuación)
Oracle 486
Paraccel 495
Postgres 497
Red Brick 503
Resúmenes de miembros 421
Salesforce.com 509
SAP BW 508
SQL Server 513
Sybase 521
Teradata 529
Trigonometría de datos Aster 437
Vectorwise 534
Vertica 537
Vertica Math 539
Vertica String 537
Vertica Trigonometry 540
ejemplos para metadatos de SAP BW
función in_range 237
ejemplos para metadatos relacionales
filter 156
función in_range 153
mapa de parámetros 159
modelado multilingüe 129
solicitudes 168
elementos de consulta
convertir 118, 149
convertir a partir de medidas 117
definición 12
propiedades 21
elementos de consulta para metadatos de SAP BW
agregación 222
formatear 223
modificar 216
reglas de agregación 222
roles 207, 209
uso 221
elementos de consulta para metadatos relacionales
cambiar de nombres 288
carpetas 183
función de modelo duradero 288
modificar 21, 131
reglas de agregación 139
roles 115, 116
uso 138
eliminar
seguridad de objetos 257
encontrar
objetos 23
enlace
limitaciones 281
enlaces 279
crear 283
entorno
Framework Manager 9
entorno de creación de informes multilingüe
configurar 123
entornos soportados
multilingüe 123
error de memoria insuficiente 387
errores
reparar 250
errores de redondeo 391
errores de redondeo binario 391
espacios de nombres 9
crear 65
crear para metadatos de SAP BW 246
672 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario
espacios de nombres (continuación)
crear para metadatos relacionales 182
definición 11
esquema 319
esquemas en estrella
agrupaciones 173
creación mediante Model Design Accelerator 35
gestionar usando Model Design Accelerator 36
varias 175
establecer
reguladores 305
supresión 261
estadísticas
ver 22
estructuras
SAP BW 195
estructuras de características 195
Estructuras de SAP BW 195
evaluar
asuntos de consulta relacionales 95
Asuntos de consulta SAP BW 216
Event Studio
procedimientos almacenados 82
Explorador de contexto 89, 120, 210
explorar
asuntos de consulta 89
dimensiones 105, 120, 201, 210
objetos 19, 30
paquetes 271
roles 271
seguridad basada en objetos 271
exportar
archivo CWM 390
metadatos como archivos CWM 291
tablas de traducción 128
expresiones
importadas 63
llaves 389
personalizar 72
relaciones 73
utilizar solicitudes 144
expresiones complejas
relaciones 73
expresiones de relación personalizadas 72
externalización
asuntos de consulta 262, 265
asuntos de consulta de modelo 641
cifras clave de consulta de SAP BW 642, 644
cifras clave de InfoCube 642
dimensiones de característica 642
dimensiones de medida 642
dimensiones de SAP BW 633
requisitos de Framework Manager 644
requisitos de una consulta SAP BW 643
extracción de datos
directrices de SAP BW para uso de variables 636
F
filtros
obligatorio 155
opcional 155
seguridad 256, 258
filtros para metadatos de SAP BW
aplicar 240
crear 237
determinar el uso 240

filtros para metadatos de SAP BW (continuación)
modificar 237
filtros para metadatos relacionales
aplicar a asuntos de consulta 155
crear 153
determinar el uso 155
modificar 153
obligatorio 153
opcional 153
varias dimensiones 21
varios asuntos de consulta 21
varios elementos de consulta 21
formatear
datos para metadatos de SAP BW 223
datos para metadatos relacionales 143
formatos de datos
símbolos de fecha y hora 624
símbolos de formato decimal 631
utilizar modelos 623
Framework Manager
proyecto 9
fuente
valores 20, 33
Función CSVIdentityName 256
función CSVIdentityNameList 257
función in_range 153, 237
funciones 2, 3
proyecto 317
funciones de base de datos
específica de proveedor 317
funciones de base de datos específicas de proveedor 317
funciones de origen de datos
añadir 317
fusión
asuntos de consulta, relacionales 88
asuntos de consulta, SAP BW 215
dimensiones regulares, relacionales 119
proyectos 273
G
generación de SQL
controlar 305
Generación de SQL para atributos de determinantes
regulador 309
Generación de SQL para atributos de nivel
regulador 308
generar
modelos, mediante Model Design Accelerator 36
relaciones 74
gestionar
paquetes 257, 260, 271, 272
proyecto 271
proyectos 285, 295
glosario 657
granularidad 347
grupos
añadir 254
esquema en estrella 173
grupos de esquema en estrella 339
crear 354
varios compatibles 355
grupos de esquema en estrella compatibles 355
guardado automático
opciones 17
guardar automáticamente
opciones 17
guardar como
copiar proyectos 285
H
hechos 353
ambiguas 368
cardinalidad 187
cardinalidad mixta 187
identificar 342
reglas de agregación 141
historial de transacciones
ver 295
I
IBM Cognos 8 Planning y datos de SAP BW 633
IBM Cognos PowerCubes
publicar 267
ID de conjunto de funciones 319
identificadores
exclusivos 84
identificadores exclusivos 84
objetos 25
idioma de interfaz de usuario 2
idiomas
añadir metadatos relacionales 128
configurar entorno multilingüe 123
definir metadatos relacionales 128
especificar para paquetes 261
incorrecto en consulta SAP BW 388
importar
archivos XML de Architect 50
archivos XML de Impromptu 50
bases de datos 48
DecisionStream 50
jerarquías SAP BW 196
metadatos a Framework Manager 47
metadatos de SAP BW 193, 198
metadatos desde archivos XML 65
metadatos relacionales 74
Modelos de IBM Cognos 49
nombres de objeto duplicados 47
orígenes de datos 57
relaciones 68
tablas de traducción para metadatos relacionales 129
importar vista 67
InfoCube protegido
acceder 193
información de dimensiones 379
informe
dependencias 288
informes
multilingüe 124
no mostrar cambios en modelo 269
informes con errores 269
informes multilingües 124
Informix
funciones 80
procedimientos almacenados 80
iniciar sesión
en Microsoft SQL 44
IQD
archivos 262, 265
Índice 673

J
jerarquías 324, 328, 379
dependientes del tiempo 5, 196
desequilibrada 111, 204
dimensión regular 109, 201
equilibradas 110, 202
especificar roles 115, 116
irregulares 112, 204
red 112, 206
SAP BW 196
varias 351
versionada 196
jerarquías de red 112, 206
jerarquías dependientes del tiempo 5
jerarquías desequilibradas 111, 204
jerarquías equilibradas 110, 202
jerarquías irregulares 112, 204
jerarquías versionadas 196
L
limitaciones
enlace 281
macros 165
segmentación 281
Límite de elementos de texto grandes 306
límite de fila 305
límites de tiempo 305
llaves 162
llaves en expresiones 389
local limitado 313
M
macros
crear 165
limitaciones 165
solicitudes 162
utilizar 162
macros de consulta
utilizar para crear solicitudes 166
mapa de dimensiones 105, 106, 115, 116, 201
mapas de parámetros para metadatos de SAP BW 241
crear 241
mapas de parámetros para metadatos relacionales
crear 157
uso como tablas de consulta 123
medidas
actualización de IBM Cognos BI 377
convertir 118, 149
convertir en elementos de consulta 117
para IBM Cognos 8 Planning 633
semiaditivo 141
tipo de agregación calculada 187
medidas semiaditivas 141, 223
mejorar el rendimiento
reutilizar datos de la memoria caché 314
members
ordenar 113
mensajes de error
QE-DEF-0177 388
QE-DEF-0259 389
UDA-SQL-0107 388
UDA-SQL-0114 388
metadatos
cambiar 285
674 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario
metadatos (continuación)
comprender 271
de memoria caché 187
exportar 291
fusión 88, 215
importar 47
mover 285
publicar 249
relacionales 67
SAP BW 193
seguridad 254, 260
sincronizar 301
metadatos de memoria caché 187
metadatos de SAP BW 193
importar 193
metadatos DMR (relacionales modelados
dimensionalmente) 351
metadatos ERWin
error de memoria insuficiente 387
metadatos importados
comprobar 342
metadatos nativos 41
metadatos relacionales 67
elementos de consulta 131
esquemas en estrella 173
importar vista 67
reglas de negocio 149
vista empresarial 67
metadatos relacionales con modelado dimensional
medidas semiaditivas 141
metodologías
bifurcación 274
Microsoft
orígenes de datos de SQL Server 48
SQL Server e inicio de sesión 44
Microsoft Analysis Server
orígenes de datos 48
migrar
modelos 295
Model Design Accelerator 29
Acelerador de modelos 31
Árbol del explorador 29
asistente de metadatos 34
colores del diagrama 30
construir asuntos de consulta 35
creación de esquemas en estrella 35
crear proyectos 34
Diagrama de asunto de consulta 31
Diagrama del explorador 30
generar modelos 36
gestionar esquemas en estrella 36
Modo de edición de relación 32
uniones 32
valores de diagramas 33
vista Aviso de modelo 32
modelado
modelos distribuidos 273
multilingüe 126
multiusuario 273
orígenes de datos 126
proyectos principales 273
modelado dimensional de metadatos relacionales 351
modelado multilingüe
ejemplo de metadatos relacionales 129
metadatos relacionales 123
paquetes 261
parámetros 126

modelado multiusuario 273
modelo
duración 184
versiones 269
modelo, asesor 187
modelos 9
actualizar 14, 375
analizar 187
definición 11
ejemplo 26
generar, mediante Model Design Accelerator 36
migrar de una base de datos relacional en otra 295
preparar metadatos de SAP BW 193
publicar 249
relacionales, preparar 67
verificar 250
versiones 265
modelos de ejemplo 26
Modelos de IBM Cognos
importar 49
modelos dimensionales
esquemas en estrella 173
modelos duraderos 4, 184
cambiar de nombre elementos de consulta 288
modelos relacionales
migrar 295
modificar
acceso a paquete 260
acceso administrativo a paquete 260
asuntos de consulta de procedimiento almacenado 82
asuntos de consulta relacionales 21
dimensiones relacionales 21
elementos de consulta para metadatos de SAP BW 216
elementos de consulta para metadatos relacionales 131
filtros para metadatos de SAP BW 237
filtros para metadatos relacionales 153
paquetes 253
parámetros de sesión 160, 243
propiedades 21
propiedades de elemento de consulta 21
relaciones 72
SQL en tiempo de ejecución 166
modo de acceso a transacción 1, 315
modo de consulta
dinámica 3, 4
modo de consulta dinámica 3, 4, 265, 266, 305, 306, 309
Modo de edición de relación 32
modo de sentencia de transacción 1, 315
moneda
tipo de formato 143, 223
mostrar dependencias 289
mover
metadatos 285
proyectos 286
multidimensional
asuntos de consulta 214
multilingüe
orígenes de datos 126
utilizar datos 123
múltiples relaciones válidas 343, 346
N
necesidades de creación de informes 7
nivel de detalles
valores 20, 33
nivel de jerarquía de presentación
correlación con Framework Manager 199
niveles 105, 109, 201, 207, 209, 379
dimensión regular 112, 207
especificar roles 115, 116
exclusivos 107
nombres exclusivos de miembro 112, 207
ordenar 113
seguridad 390
niveles de aislamiento 42
niveles exclusivos 107
no aditivo 139, 222
no se puede acceder al servicio en el URL 387
nombres de objeto duplicados
importar 47
nombres exclusivos de miembro
metadatos de SAP BW 207
metadatos relacionales 112
notación 20, 33, 69, 70
notación crowfoot 20, 33
notación merise 20, 33
O
objetos
buscar 23
convenciones de nomenclatura 25
explorar 19, 30
identificadores exclusivos 25
propiedades 21
recorrelacionar 290
reordenar 19
objetos ambiguos 368
objetos de modelo 14
atajos 335
usar parámetros 157, 241
ver 14, 29
objetos de proyecto
convenciones de nomenclatura 25
objetos relacionados 89, 120, 210
opciones de instantánea
valores 20, 33
opciones de supresión 261
operaciones para cálculos 337
operador más 162
Oracle
Designer 63
uniones externas completas 391
orden de operaciones para cálculos 337
ordenar
members 113
niveles 113
objetos 21
ordenar objetos 19
organizar modelos 173, 245
origen de datos
actualizado por procedimiento almacenado 82
añadir funciones 317
origen de datos de Content Manager 319
orígenes de datos
archivos XML 65
archivos XML de Architect 50
archivos XML de Impromptu 50
bases de datos relacionales 48
DecisionStream 50
ERwin 57
IBM DB2 Cube Views 57
Índice 675

orígenes de datos (continuación)
Microsoft Analysis Server 48
Microsoft SQL Server 48
Modelos de IBM Cognos 49
modificar propiedades 319
multilingüe 126
niveles de conexión 42
Oracle Designer 63
otros orígenes de metadatos 57
propiedades 207, 313
rutas para conexiones de origen de datos basados en
archivos 45
SAP BW 6, 193
orígenes de datos basados en archivos
rutas 45
orígenes de datos de OLAP
publicar 267
orígenes de datos en copo de nieve 349
orígenes de datos normalizados 349
P
Página de accesibilidad de IBM 387
página del proyecto 14
palabras reservadas 649
paquetes 9
acceso 260
acceso administrativo 260
analizar cambios 288
añadir seguridad 260
con varios cubos 267
crear 253
crear en Cognos Connection 193, 265
definición 11
explorar 271
gestionar 257, 260, 271, 272
modificar 253
orígenes de datos de SAP BW 5
publicar 249, 265
seguridad 254
soporte multilingüe 261
ver inclusión 272
verificar 250
parámetros
en asuntos de consulta de orígenes de datos 162
parámetros anidados 157, 241
parámetros de sesión
modificar para metadatos relacionales 160
modificar para metadatos SAP BW 243
parámetros de sesión de modelo
metadatos de SAP BW 243
metadatos relacionales 160
parámetros para metadatos de SAP BW
crear 241
mapas 241
sesión 243
parámetros para metadatos relacionales
alias 157
anidados 157
asuntos de consulta de orígenes de datos 162
crear 157
modelado multilingüe 126
objetos de modelo 157
sesión 160
utilizar 162
pasarelas
no se puede acceder al URI 387
676 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario
pestaña Diagrama 19
pestaña Explorador 19
pestaña Mapa de dimensiones 20
portabilidad 295
portabilidad de modelos 295, 305
PowerCubes
conectar a varios orígenes de datos 41
crear a partir de datos SAP BW 645
directrices de Framework Manager 645
Directrices para Transformer 646
rutas para archivos de cubos 45
probar
asuntos de consulta 63, 388
asuntos de consulta relacionales 92
cambiar valores 94, 121, 212
conexiones de origen de datos 47
conjuntos de consulta relacionales 92
dimensiones de medida de SAP BW 211
dimensiones de medida relacionales 120
dimensiones regulares de SAP BW 211
dimensiones regulares relacionales 120
proyectos 250
solicitudes 148, 229
problemas de ámbito de medida 118
problemas de modelado 187
procedimientos almacenados
base de datos de actualizaciones de consulta de datos 82
procedimientos almacenados de Composite 80
procesamiento de consultas 313, 319
seleccionar 313
procesamiento de consultas local
procesamiento de resumen 313
procesamiento de resumen 313, 319
propiedad Agregado regular 139
metadatos de SAP BW 220, 222
metadatos relacionales 134
propiedad de reglas de agregación
metadatos relacionales 134
propiedad Información de solicitud 144, 224
propiedad Semiagregado
metadatos de SAP BW 220
Propiedad Semiagregado 142
metadatos de SAP BW 223
propiedad Uso
metadatos de SAP BW 220, 221
metadatos relacionales 134, 138
propiedades
agregado regular 134, 220
catálogo 319
cubos 319
esquema 319
filtro en referencia 147, 227
ID de conjunto de funciones 319
Información de solicitud 144, 224
interfaz de consulta 319
mapa de parámetros 319
modificar 21
modo de acceso a transacción 319
modo de sentencia de transacción 319
origen de datos de Content Manager 319
origen de datos de SAP BW 207
orígenes de datos 313
procesamiento de consultas 319
procesamiento de resumen 319
referencia de cascada 146, 226
referencia de elemento de visualización 146, 227
reglas de agregación 134

propiedades (continuación)
reglas de agregación para metadatos de SAP BW 220
semiagregado 220
tipo de consulta 319
tipo de solicitud 145, 225
uso 134, 220
utilizar referencia de elemento 146, 227
variables de SAP BW 207
ver 21
propiedades de información de solicitud 144
propiedades personalizadas
SAP BW 229
proyecto
gestionar 271
proyectos 9
abrir 14
archivos 9
arreglar errores de sincronización 300
atajos 283
bifurcación 273
cambiar de nombres 286
copiar 285
crear 13, 34
definición 9
enlace 283
Framework Manager 9
funciones 317
fusión 273
gestionar 285, 295
mover 286
opciones 17
reproducir transacciones 296
segmentación 282
sincronizar 301
suprimir 287
ver historial de transacciones 295
proyectos enlazados 279, 383
sincronizar 302
proyectos principales 282
proyectos segmentados 279, 282, 383
copiar 285
mover 286
sincronizar 302
suprimir 287
publicar
metadatos 249
paquetes 249, 265, 269
paquetes basados en orígenes de datos de OLAP 267
Q
QE-DEF-0177 388
QE-DEF-0259 389
R
rastrear
historial de transacciones 295
recorrelacionar objetos 290
recuento Distinct 134
recuento doble 84, 342, 362, 368
registros de acción 295
ejecutar en modo de proceso por lotes 297
reglas
agregación para metadatos de SAP BW 220
cardinalidad 71
reglas (continuación)
negocio 149
negocio para metadatos SAP BW 235
reglas de agregación 141
reglas de cardinalidad 322
reglas de negocio para metadatos de SAP BW 235
cálculos 236
filtros 237
reglas de negocio para metadatos relacionales 149
cálculos 150
filtros 153
macros 162
mapas de parámetros 157
parámetros 162
parámetros de sesión 160
solicitudes 144
regulador
Agrupación de atributos de medida 308
Generación de SQL para atributos de determinantes 309
Generación de SQL para atributos de nivel 308
Límite de tiempo de ejecución de consulta 305
Número máximo de filas recuperadas 305
Número máximo de tablas de informes 305
Orígenes de datos externos máximos 311
Permitir generación dinámica de información de
dimensión 310
Permitir portabilidad de modelo mejorada en tiempo de
ejecución 310
Permitir uso de memoria caché local 310
Procesamiento de atajos 307
Procesar modelo entero al publicar 311
Recuento máximo de filas de datos externos 312
Sintaxis de parámetros SQL 309
Sintaxis de unión SQL 307
Suprimir valores nulos para orígenes de datos de SAP
BW 311
Tamaño máximo de archivo de datos externos 312
Uniones entre productos 306
Uniones externas 306
Utilizar cláusula WITH al generar SQL 310
reguladores
actualización de IBM Cognos ReportNet 376
establecer 305
permitir uso de memoria caché local 314
relaciones
0-1 69
0-n 69
1-1 69
1-n 69, 362
ambiguas 343
ámbito 118, 119
atajos 74, 180
cambiar 72
cardinalidad 69, 322
comprobar 68, 342
crear 73
definición 68
desde Oracle Designer 63
detectar 74
determinantes 187
expresiones complejas 73
generar 74
importar 68
modificar 72
muchos a muchos 69
muchos a uno 69
múltiples válidas 343, 346
Índice 677

elaciones (continuación)
n-n 69
niveles de granularidad 347
personalizar 72
reflexivas y recursivas 187
uno a muchos 69
uno a uno 69
varias 187
verificar 68
relaciones ambiguas 343
relaciones de ámbito 105, 106, 115, 116, 118, 119, 201
relaciones de muchos a muchos 69
relaciones de muchos a uno 69
relaciones de uno a muchos 69, 362
relaciones opcionales 69
relaciones recursivas 187, 347
relaciones reflexivas 187, 347
relaciones uno a uno 69, 362
relaciones válidas
varias 343
reordenar objetos 19
reparar
modelos de IBM Cognos ReportNet 378
reparar modelos 250
reproducir
registros de acción 297
resolución de problemas 387
resolver
consultas divididas 369
objetos ambiguos 368
restablecer
propiedad Agregado regular 142
propiedad Uso 142
restringir
acceso 254
BLOB 306
datos recuperados 305
resúmenes
ver 22
resúmenes de agregado 313
reutilización de consulta 314
reutilizar datos de la memoria caché 314
roles
añadir 254
dimensiones 115, 116
explorar 271
roles para metadatos de SAP BW
dimensiones 207, 209
rutas ambiguas 175
S
SAP BW
dimensiones compatibles 6
directrices para utilizar datos de hechos 636
idioma incorrecto en consulta 388
importar cifras clave 193
propiedades personalizadas 229
Transformer 641
scripts
ejecutar 269
segmentación
limitaciones 281
proyectos 282
segmentos 279
recomendaciones de uso 280
678 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario
seguridad
explorar 271
filtros 256
Función CSVIdentityName 256
función CSVIdentityNameList 257
niveles 390
paquetes 253
tipos 254
seguridad de objetos 254
añadir 257
asuntos de consulta de modelo 258
atajos 258
cálculos 258
eliminar 257
explorar 271
filtros 258
seleccionar
procesamiento de consultas 313
semiaditivo 142
signo de almohadilla
reservado para macros 162
símbolo de escape 162
símbolos reservados
signo de almohadilla 162
sin opciones de supresión 261
sincronizar
arreglar errores 300
asuntos de consulta 97
metadatos 301
proyectos 301
proyectos enlazados 302
proyectos segmentados 302
sintaxis
BmtScriptPlayer 297
Sintaxis de parámetros SQL
regulador 309
solicitudes
buscar 144, 145, 224, 225
cifras clave 390
crear 166
crear con macros 166
cuadro de texto 145, 224, 225
date 144, 145, 224, 225
definir 144, 224
ejemplo de procedimiento almacenado 83
ejemplos 168
en expresiones 144
filtro en referencia 147, 227
introducir 144, 145, 224, 225
lista desplegable 144, 145, 224, 225
obligatorio 166
opcional 166
probar 148, 229
propiedades 144, 145, 224, 225
referencia de cascada 146, 226
referencia de elemento de visualización 146, 227
time 144, 145, 224, 225
utilizar referencia de elemento 146, 227
valores diferentes para utilizar y visualizar 146, 227
variables de SAP BW 229
solicitudes de búsqueda 144, 145, 224, 225
solicitudes de cuadro de texto 144, 145, 224, 225
solicitudes de fecha 144, 224
solicitudes de hora 144, 145, 224, 225
solicitudes de introducir 144, 145, 224, 225
solicitudes de lista desplegable 144, 145, 224, 225
solicitudes obligatorias 166

solicitudes opcionales 166
solo base de datos 313
soporte
varios usuarios 273
SQL 357
asuntos de consulta 75
asuntos de consulta de modelo 105
cambiar tipo 99
Cognos 98, 101
comentarios 98
Como vista 105
determinantes 87
editar 98
minimizado 105, 187
nativo 98, 102
nativo independiente 98, 103
pass-through 98, 103
servidor, conectar 44
tipos de generación 105
uniones internas 391
SQL Como vista 105
asuntos de consulta de modelo 105
SQL de introducir 389
SQL minimizado 105, 187
asuntos de consulta de modelo 105
SQL nativo 102
SQL pass-through 103
supresión
null 261
varios bordes 261
supresión de varios bordes 261
suprimir
proyectos 287
T
tablas de hechos 117, 173
tablas de traducción
exportar 128
importar 129
tablas maestro-detalle 350, 353
tareas
ver 22
tipo de agregación
calculada 187
tipo de agregación calculada 187, 337
tipo de consulta 319
tipo de datos graphic 388
tipo de formato de texto 143, 223
tipos de agregación automática
metadatos de SAP BW 221, 223
metadatos relacionales 137
tipos de datos 377
graphic 388
tipos de datos vargraphic 388
tipos de formato
date 143, 223
moneda 143, 223
texto 143, 223
transacciones
arreglar 279
modo 315
reproducir 296
transacciones de grabación 295
Transformer
SAP BW 641
Transformer versión 7.x
archivos CSV externalizados 641
Transformer versión 8.x
archivos CSV externalizados 641
Transformer y asuntos de consulta 262, 265
U
UDA-SQL-0107 388
UDA-SQL-0114 388
uniones 68
bucle 346
crear 32
externas 70, 72
externas completas 69, 388
internas 70, 74, 391
modificar 32, 72
Oracle 391
reemplazar 32
suprimir 32
uniones automáticas 187
uniones de bucle 342, 346
uniones entre productos 305
uniones externas 70, 74, 305
Analysis Studio 72
completas 69, 388
Oracle 391
uniones externas completas 69, 388
Oracle 391
uniones externas completas de Oracle 388
uniones internas 70, 74, 391
URI
no se puede acceder al servicio 387
usuarios
añadir 254
paquetes 253
utilizar
varias conexiones de origen de datos 41, 44
varios conjuntos de datos 292
utilizar cadenas incluidas
en expresiones 243
en macros 243
utilizar cadenas literales
en expresiones 243
en macros 243
utilizar comillas
en expresiones 243
en macros 243
V
validar 2
asuntos de consulta relacionales 95
Asuntos de consulta SAP BW 216
valores
fuente 20, 33
nivel de detalle 20, 33
notación 20, 33
opciones de instantánea 20, 33
prueba 94, 121, 212
valores nulos
SAP BW 305
variables
directrices para utilizar datos de hechos SAP BW 636
procedimiento almacenado 83
SAP BW 229
Índice 679

variables (continuación)
usar al externalizar 644
variables de SAP BW 207
Variables de SAP BW 229
varias conexiones de origen de datos
utilizar 41, 44
varias jerarquías 351
varias relaciones 187
varios conjuntos de datos 292
establecer el conjunto de datos predeterminado 293
varios cubos en paquetes 267
varios usuarios
modelado 273
ver
diagramas 19, 30, 31
estadísticas 22
inclusión de paquete 272
objetos de modelo 14, 29
objetos relacionados 89, 120, 210
propiedades 21
resúmenes 22
SQL 98
tareas 22
verificar
modelos 250
680 IBM Cognos Framework Manager Versión 10.2.1: Guía del usuario
verificar (continuación)
modelos de IBM Cognos ReportNet 375, 378
paquetes 250
relaciones 68
versiones
modelos 265
versiones de modelo
actualizar 265
versiones de modelos 269
Visor de proyectos 14
vista Aviso de modelo 32
vista empresarial 67
vista empresarial para metadatos de SAP BW 245
atajos 246
atajos y dimensiones 246
carpetas 246
espacios de nombres 246
vista empresarial para metadatos relacionales 173
atajos 178, 180
atajos y relaciones 180
carpetas 182
espacios de nombres 182
vistas empresariales de modelos 173, 245