IBM Cognos Real-time MonitoringWorkbench Versión 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/es/1… · Tipos de datos de terceros que se correlacionan con el

IBM Cognos Real-time Monitoring WorkbenchVersión 10.2.2

Guía de referencia de modelado

��

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

Información sobre el producto

Este documento se aplica a IBM Cognos Business Intelligence Versión 10.2.2 y puede aplicarse también a lasversiones posteriores.

Licensed Materials - Property of IBM

© Copyright IBM Corporation 2007, 2014.

Contenido

Introducción . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv

Novedades . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviiCaracterísticas nuevas de la versión 10.2.2 . . . . . . . . . . . . . . . . . . . . . . . . xviiCaracterísticas nuevas de la versión 10.2.1 . . . . . . . . . . . . . . . . . . . . . . . . xviiCaracterísticas nuevas en la versión 10.2.0. . . . . . . . . . . . . . . . . . . . . . . . . xviiCaracterísticas nuevas de la versión 10.1.1 . . . . . . . . . . . . . . . . . . . . . . . . xvii

Capítulo 1. Cómo empezar . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Lanzamiento de Real-time Monitoring Workbench . . . . . . . . . . . . . . . . . . . . . . . 1Cómo trabajar con el producto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Capítulo 2. Filtros de acceso . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Condiciones de filtro de acceso . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Nombres de usuario en filtros de acceso . . . . . . . . . . . . . . . . . . . . . . . . . 4Tabla de consulta en filtros de acceso . . . . . . . . . . . . . . . . . . . . . . . . . . 4Tablas de consulta de usuarios en filtros de acceso. . . . . . . . . . . . . . . . . . . . . . 4

Comportamiento de filtro de acceso y restricciones . . . . . . . . . . . . . . . . . . . . . . 6Creación de un filtro de acceso en una vista . . . . . . . . . . . . . . . . . . . . . . . . . 6Creación de filtros de acceso basados en tablas de consulta . . . . . . . . . . . . . . . . . . . . 7Creación de un filtro de acceso simple . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Asignación de un filtro de acceso a usuarios y roles . . . . . . . . . . . . . . . . . . . . . . 8

Capítulo 3. Infraestructura de adaptador . . . . . . . . . . . . . . . . . . . . . . 9Creación de una infraestructura de adaptador externo . . . . . . . . . . . . . . . . . . . . . 9Conector de adaptador externo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Configuración del archivo de configuración . . . . . . . . . . . . . . . . . . . . . . . 12Archivo ConfigXML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12Carpeta de archivos JAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Compilación e inicio de una aplicación externa . . . . . . . . . . . . . . . . . . . . . . . 14Agentes externos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15Flujos de datos externos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Tablas de consulta externas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Capítulo 4. Agentes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23Orígenes externos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23Creación de agentes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26Edición de agentes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27Agente de archivos sin formato. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Creación de un agente de archivos sin formato . . . . . . . . . . . . . . . . . . . . . . 28Programa de agente de archivo . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Agentes de sistema de archivos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32Creación de un agente de sistema de archivos . . . . . . . . . . . . . . . . . . . . . . . 32

Agentes de colas Java Messaging Service . . . . . . . . . . . . . . . . . . . . . . . . . 33Propiedades de JNDI para conectarse a un espacio de nombres remoto . . . . . . . . . . . . . . 34Creación de un agente de colas JMS . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Agentes de tema JMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Creación de un agente de temas JMS . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Agentes TIBCO Rendezvous . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37Atributos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38Creación de un agente TIBCO Rendezvous . . . . . . . . . . . . . . . . . . . . . . . . 38

Agentes de servicio web . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Atributos de agentes de servicio web . . . . . . . . . . . . . . . . . . . . . . . . . . 39Creación de un agente de servicio web . . . . . . . . . . . . . . . . . . . . . . . . . 40

© Copyright IBM Corp. 2007, 2014 iii

Capítulo 5. Alertas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41Creación de una alerta independiente. . . . . . . . . . . . . . . . . . . . . . . . . . . 41Creación de una alerta asociada a una regla . . . . . . . . . . . . . . . . . . . . . . . . 42Clonación de una alerta existente . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42Atributos de alerta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43Texto del asunto y el cuerpo del mensaje . . . . . . . . . . . . . . . . . . . . . . . . . 44Suscriptores de alertas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44Gestión de mensajes de notificación de alerta . . . . . . . . . . . . . . . . . . . . . . . . 45Estados de alerta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Escalamiento de alertas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46Consolidación de mensajes múltiples . . . . . . . . . . . . . . . . . . . . . . . . . . . 47Establecimiento de una alerta para invocar a un servicio web externo . . . . . . . . . . . . . . . . 47

Función definida por el usuario del servicio web . . . . . . . . . . . . . . . . . . . . . . 48Adición de reportlets a una notificación de alerta . . . . . . . . . . . . . . . . . . . . . . . 49Filtro de reportlet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Datos de reportlet basados en opción . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Capítulo 6. Reglas de negocio. . . . . . . . . . . . . . . . . . . . . . . . . . 55Acerca de las reglas de negocio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55Creación de una regla de negocio . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

Capítulo 7. Common Event Infrastructure . . . . . . . . . . . . . . . . . . . . . 57Funcionamiento de Common Event Infrastructure . . . . . . . . . . . . . . . . . . . . . . 57Flujo de datos Common Event Infrastructure . . . . . . . . . . . . . . . . . . . . . . . . 57

Requisitos previos para la creación de un flujo de datos de Common Event Infrastructure . . . . . . . . 58Creación de una tabla de flujos de datos desde una conexión de Common Event Infrastructure . . . . . . 60Información de la columna Common Event Infrastructure . . . . . . . . . . . . . . . . . . . 60Intervalo de borrado de estados . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

Capítulo 8. Cubos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63Medidas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64Dimensiones en cubos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64Creación de cubos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

Columnas de medida . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66Creación de un cubo con columnas de dimensión . . . . . . . . . . . . . . . . . . . . . 66

Capítulo 9. Tipos de datos . . . . . . . . . . . . . . . . . . . . . . . . . . . 69Conversión de tipo de datos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

Conversión explícita . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69Conversión implícita . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69Orden de prioridad. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

Tipos de datos C-SQL para valores numéricos . . . . . . . . . . . . . . . . . . . . . . . . 71Tipos de datos de terceros que se correlacionan con los tipos de datos numéricos C-SQL . . . . . . . . 71Combinación de tipos numéricos . . . . . . . . . . . . . . . . . . . . . . . . . . . 72Conversión de tipos numéricos . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72Directrices de conversión de números a cadenas . . . . . . . . . . . . . . . . . . . . . . 73Resultados de precisión decimal . . . . . . . . . . . . . . . . . . . . . . . . . . . 73Conversión . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73Multiplicación . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73División . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74Suma y resta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74Todas las demás funciones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

Cadena . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74Anchura de cadena . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74Tipos de datos de terceros que se correlacionan con VARCHAR . . . . . . . . . . . . . . . . . 75Concatenación de cadenas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75Literal de cadena . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75Conversión de cadenas en otros tipos de datos . . . . . . . . . . . . . . . . . . . . . . 75

Fecha y hora . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76Conversión entre valores de fecha-hora y cadenas . . . . . . . . . . . . . . . . . . . . . 76

iv IBM Cognos Real-time Monitoring Workbench Versión 10.2.2: Guía de referencia de modelado

Comparación de valores fecha-hora . . . . . . . . . . . . . . . . . . . . . . . . . . 76Aritmética de fecha-hora . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77Tipos de datos de terceros que se correlacionan con el tipo date-time C-SQL . . . . . . . . . . . . 77Literal TIMESTAMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78Literal INTERVAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78Formato de fecha y hora . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

Operadores booleanos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

Capítulo 10. Flujos de datos . . . . . . . . . . . . . . . . . . . . . . . . . . 85Funcionamiento de los flujos de datos . . . . . . . . . . . . . . . . . . . . . . . . . . 85Orígenes de eventos externos para flujos de datos . . . . . . . . . . . . . . . . . . . . . . 86Atributos de flujo de datos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87Creación de tablas de flujos de datos . . . . . . . . . . . . . . . . . . . . . . . . . . . 87Edición de tablas de flujos de datos . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

Capítulo 11. Dimensiones. . . . . . . . . . . . . . . . . . . . . . . . . . . . 91Jerarquía de niveles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92Nombres de alias en cubos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92Campo de la columna Order By . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92Categorías geográficas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92Columnas de claves . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93Creación de dimensiones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

Capítulo 12. Sistema de archivos de Cognos Real-time Monitoring . . . . . . . . . . 97Tablas de consulta de archivos sin formato . . . . . . . . . . . . . . . . . . . . . . . . . 97

Pestaña Información de campo . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99La pestaña Almacenamiento de datos en memoria caché . . . . . . . . . . . . . . . . . . . 99Creación de una tabla de consulta a partir de un archivo sin formato. . . . . . . . . . . . . . . 101

Capítulo 13. Archivos sin formato . . . . . . . . . . . . . . . . . . . . . . . 103Datos de archivos sin formato . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

Funcionamiento de los datos de archivos sin formato . . . . . . . . . . . . . . . . . . . . 103Tablas de flujos de datos de los archivos sin formato . . . . . . . . . . . . . . . . . . . . 104

Archivos delimitados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109Archivos de anchura fija. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110Soporte de archivos XML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

Ubicación XPath de columnas y filas en archivos XML . . . . . . . . . . . . . . . . . . . 111Información de campo XML . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112Tipos de datos XML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112Cómo se aplanan los archivos XML . . . . . . . . . . . . . . . . . . . . . . . . . . 114

Capítulo 14. Fórmulas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125Funciones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125Tipos de funciones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

Funciones escalares . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125Funciones de conjunto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126Funciones de clasificación . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127Funciones de conjunto móvil . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127Funciones de conjunto en movimiento . . . . . . . . . . . . . . . . . . . . . . . . . 128

Categorías de funciones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128Funciones matemáticas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129Funciones de clasificación . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129Funciones de reglas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129Funciones estadísticas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130Funciones de texto y de cadena . . . . . . . . . . . . . . . . . . . . . . . . . . . 130Funciones de serie de tiempo y de agregación . . . . . . . . . . . . . . . . . . . . . . 131Funciones de vistas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131

Contenido v

Capítulo 15. Funciones C-SQL . . . . . . . . . . . . . . . . . . . . . . . . . 133MOV_function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136

Sintaxis de las funciones MOV_function . . . . . . . . . . . . . . . . . . . . . . . . 137Intervalos de serie de tiempo . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139Aviso sobre vistas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140Interacciones GROUP BY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140

Sentencia Case . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141CASE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141ELSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142END . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142THEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142WHEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142

Conversión . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142CAST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142

Fecha y hora . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143CURRENT_TIMESTAMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143DATE_ADD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144DATE_DIFF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145GREATEST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146LAST_DAY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146LEAST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147PRIOR_VALUE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148TIMESTAMP_DIFF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149TO_CHAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150TO_DATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150

Números . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151ABS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151CEIL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152DISPLAY_MONEY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152EXP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154FLOOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155GREATEST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155LEAST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156LOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157MOD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157POWER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158PRIOR_VALUE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159ROUND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160SAFE_DIVIDE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161SIGN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162SQRT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162TRUNC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162

IS_ACKED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164IS_RAISED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164PRIOR_VALUE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165Sistema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166

CURRENT_USER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166Texto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166

CHAR_LENGTH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166CONCAT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167GREATEST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168LEAST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168LOWER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169LPAD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170LTRIM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170POSITION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171PRIOR_VALUE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172RPAD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173RTRIM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174SUBSTRING. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174UPPER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175

vi IBM Cognos Real-time Monitoring Workbench Versión 10.2.2: Guía de referencia de modelado

Serie temporal y conjunto de agregados . . . . . . . . . . . . . . . . . . . . . . . . . 176AVG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176COUNT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178CURRENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178MAX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179MIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180MOV_AVG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180MOV_COUNT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181MOV_MAX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183MOV_MIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184MOV_SUM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185PREV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186SUM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187TUMBLE_AVG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188TUMBLE_COUNT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189TUMBLE_MAX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190TUMBLE_MIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192TUMBLE_SUM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193

Serie temporal y estadística. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194MOV_STD_DEVIATION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195MOV_VARIANCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196NTILE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197RANK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199RATIO_TO_REPORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200STD_DEVIATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201SUM_OVER_GROUPS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202TUMBLE_STD_DEVIATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203TUMBLE_VARIANCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204VARIANCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205

Funciones proporcionadas como UDF de ejemplo . . . . . . . . . . . . . . . . . . . . . . 206concatList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206concatSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207gammaDist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208logNormDist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209median . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211yield . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212

Capítulo 16. HTTP Post . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213Funcionamiento de HTTP Post . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213Tablas de flujos de datos para HTTP Post . . . . . . . . . . . . . . . . . . . . . . . . . 213

Creación de una tabla de flujos de datos para HTTP Post . . . . . . . . . . . . . . . . . . 215Información de la columna de HTTP Post . . . . . . . . . . . . . . . . . . . . . . . . 215

Publicación en una tabla de flujos de datos desde HTTP Post . . . . . . . . . . . . . . . . . . 217Publicación en campos de mensaje . . . . . . . . . . . . . . . . . . . . . . . . . . 217Valores contabilizados en el URL . . . . . . . . . . . . . . . . . . . . . . . . . . . 218Varios eventos de entrada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218

Capítulo 17. Java Messaging Service . . . . . . . . . . . . . . . . . . . . . . 219Flujos de datos JMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219

Creación de una tabla de flujos de datos a partir de una conexión Java Messaging Service . . . . . . . 221Información sobre las columnas Java Messaging Service . . . . . . . . . . . . . . . . . . . 222Tipos de datos de Java Messaging Service . . . . . . . . . . . . . . . . . . . . . . . . 222

Capítulo 18. Java Database Connectivity . . . . . . . . . . . . . . . . . . . . 225Tablas Java Database Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . 225

Tablas de consulta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225Creación de un origen Java Database Connectivity para una tabla de flujos de datos . . . . . . . . . 226Creación de un origen Java Database Connectivity para una tabla de consulta. . . . . . . . . . . . 227Tablas de flujos de datos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227

Contenido vii

Origen de consulta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230Ejemplo de una tabla de flujos de datos que utiliza una consulta de sondeo . . . . . . . . . . . . 231Sondeo del origen Java Database Connectivity . . . . . . . . . . . . . . . . . . . . . . 231Upsert. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232Origen de procedimientos almacenados . . . . . . . . . . . . . . . . . . . . . . . . 233Ejemplo de recepción de datos de tabla de consulta con un procedimiento almacenado. . . . . . . . . 234Ejemplo de recepción de un evento con un procedimiento almacenado . . . . . . . . . . . . . . 235Correlación de tipos de datos Java Database Connectivity . . . . . . . . . . . . . . . . . . 235

Agentes Java Database Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . 236Creación de un agente JDBC . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237

Capítulo 19. Acceso Java Database Connectivity a los datos de vista y cubo . . . . . 241Ruta de clase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241URL Java Database Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241Interfaces de vista de Java Database Connectivity . . . . . . . . . . . . . . . . . . . . . . 242

Correlaciones de tipo de datos. . . . . . . . . . . . . . . . . . . . . . . . . . . . 243etiqueta de resumen getColumns() . . . . . . . . . . . . . . . . . . . . . . . . . . 243Resumen de la columna getTables() . . . . . . . . . . . . . . . . . . . . . . . . . . 244Valores de retorno DATA_TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . 245

Ejemplos de descriptores de acceso JDBC . . . . . . . . . . . . . . . . . . . . . . . . . 246Java . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246Ejemplo: establecer una conexión con los servidores IBM Cognos Real-time Monitoring . . . . . . . . 246Ejemplo: consultar el contenido de una vista . . . . . . . . . . . . . . . . . . . . . . . 247Ejemplo: consultar las especificaciones de columna de una vista . . . . . . . . . . . . . . . . 248Ejemplo: consultar metadatos de columna . . . . . . . . . . . . . . . . . . . . . . . . 250Ejemplo: consultar metadatos de vista . . . . . . . . . . . . . . . . . . . . . . . . . 251

Interfaces de cubo de Java Database Connectivity . . . . . . . . . . . . . . . . . . . . . . 252IOlapStatement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253IOlapDatabaseMetadata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253Ejemplo: consultar todos los cubos . . . . . . . . . . . . . . . . . . . . . . . . . . 253Ejemplo: consultar los metadatos de un cubo . . . . . . . . . . . . . . . . . . . . . . . 254Ejemplo: recuperar los miembros hijo de un miembro de nivel en un cubo . . . . . . . . . . . . . 258Ejemplo: consultar datos de cubo utilizando XML de consulta de cubo . . . . . . . . . . . . . . 258Ejemplo: recuperación de datos de un cubo mediante consultas MDX . . . . . . . . . . . . . . 260

Capítulo 20. Tablas de consulta . . . . . . . . . . . . . . . . . . . . . . . . 261Funcionamiento de las tablas de consulta . . . . . . . . . . . . . . . . . . . . . . . . . 261Creación de tablas de consulta. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262Edición de tablas de consulta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263Limitaciones de columna en consultas de tablas de consulta . . . . . . . . . . . . . . . . . . . 264Almacenamiento de consultas de tabla de consulta en la memoria caché . . . . . . . . . . . . . . 265

Almacenamiento de datos en caché por solicitud . . . . . . . . . . . . . . . . . . . . . 266Almacenamiento de datos en caché con prerrecuperación. . . . . . . . . . . . . . . . . . . 266Almacenamiento en memoria caché de almacén Java Database Connectivity . . . . . . . . . . . . 267

Capítulo 21. Objetos en Cognos Real-time Monitoring Workbench . . . . . . . . . 269Estados de objetos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269Nombres de objeto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270

Palabras reservadas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270Espacio de nombres de objeto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277Exportación selectiva de objetos . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278

Ejemplo: exportar objetos con dependencias . . . . . . . . . . . . . . . . . . . . . . . 279Ejemplo: exportar objetos con requisitos . . . . . . . . . . . . . . . . . . . . . . . . 281Ejemplo: exportar objetos con requisitos y dependencias . . . . . . . . . . . . . . . . . . . 282Exportación de objetos seleccionados . . . . . . . . . . . . . . . . . . . . . . . . . 284

Capítulo 22. Operadores y constantes. . . . . . . . . . . . . . . . . . . . . . 287Operadores numéricos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287Operadores de cadena . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287Operadores de comparación . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288

viii IBM Cognos Real-time Monitoring Workbench Versión 10.2.2: Guía de referencia de modelado

Operador LIKE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288Operadores lógicos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289Constantes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290

Capítulo 23. Permisos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291Permisos de acceso . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291

Permisos de acceso de nivel de tipo . . . . . . . . . . . . . . . . . . . . . . . . . . 292Permisos de acceso a objetos específicos . . . . . . . . . . . . . . . . . . . . . . . . 293

Cómo otorgar permiso para crear objetos . . . . . . . . . . . . . . . . . . . . . . . . . 294Visualización de los tipos de objetos que puede crear . . . . . . . . . . . . . . . . . . . . 295

Otorgar permisos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295Restricciones de permisos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296Herencia de permisos y dependencias . . . . . . . . . . . . . . . . . . . . . . . . . 296Dependencias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296

Capítulo 24. Integración de servidor de portal . . . . . . . . . . . . . . . . . . 299Requisitos previos para integración de servidor de portal. . . . . . . . . . . . . . . . . . . . 299Integración con BEA WebLogic Portal Server . . . . . . . . . . . . . . . . . . . . . . . . 299

Conversión del archivo lavaJSR168.war. . . . . . . . . . . . . . . . . . . . . . . . . 299Despliegue del archivo lavaJSR168.war en WebLogic Portal Server . . . . . . . . . . . . . . . 300

Integración con IBM WebSphere Portal Server . . . . . . . . . . . . . . . . . . . . . . . 300Integración con JBoss Portal Server . . . . . . . . . . . . . . . . . . . . . . . . . . . 301

Múltiples instancias de portlet en un JBoss Portal Server . . . . . . . . . . . . . . . . . . . 302

Capítulo 25. Procesos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303Funcionamiento de los procesos . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303Creación y utilización de procesos . . . . . . . . . . . . . . . . . . . . . . . . . . . 304

Tablas de flujos de datos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305Búsqueda de tabla de consulta . . . . . . . . . . . . . . . . . . . . . . . . . . . 305Archivos de definición de proceso . . . . . . . . . . . . . . . . . . . . . . . . . . 305Creación de definiciones de procesos . . . . . . . . . . . . . . . . . . . . . . . . . 306Creación de diagramas de proceso . . . . . . . . . . . . . . . . . . . . . . . . . . 307

Capítulo 26. Reportlets . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309Creación de reportlets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309Atributos de reportlets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310Atributos de reportlets externos . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310Vistas de reportlet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311

Capítulo 27. Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313Creación de roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313Atributos de rol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314Pestaña de permisos de acceso . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314

Capítulo 28. Reglas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317Creación de reglas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317Clonación de reglas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318Atributos de regla . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318Condiciones de regla . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319Acciones de regla . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320

Ejemplos de reglas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320Reglas que supervisan alertas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321

Alertas específicas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321Registro del sistema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322

Capítulo 29. Salesforce . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323Creación de un agente Salesforce . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323Importación de flujos de datos y tabla de consulta desde Salesforce . . . . . . . . . . . . . . . . 323Función de aplanado de Salesforce . . . . . . . . . . . . . . . . . . . . . . . . . . . 324

Contenido ix

Función de lista de selección de Salesforce. . . . . . . . . . . . . . . . . . . . . . . . . 326Consola de administración de Salesforce . . . . . . . . . . . . . . . . . . . . . . . . . 327

Capítulo 30. Conectividad SAP . . . . . . . . . . . . . . . . . . . . . . . . . 329Creación de un agente SAP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329Importación de objetos de almacén de datos operativos . . . . . . . . . . . . . . . . . . . . 330Importación de cubos OLAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330

Capítulo 31. Escenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331Creación de escenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332

Capítulo 32. Sentencias SELECT . . . . . . . . . . . . . . . . . . . . . . . . 333Sintaxis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333Lista de selección . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334

Expresión CASE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335Cláusula FROM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336

Restricciones de vista. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336Operaciones de unión . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336Uniones internas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337Uniones externas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337Uniones anidadas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338Expresiones de tabla . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338Sintaxis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338Restricciones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339Ejemplo de cláusula HAVING . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339

Cláusula WHERE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339Predicados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340Alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340

cláusula GROUP BY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340Alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341Vistas derivadas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342Semántica de vista completa . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342

Cláusula ORDER BY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342

Capítulo 33. TIBCO Rendezvous . . . . . . . . . . . . . . . . . . . . . . . . 345Funcionamiento de TIBCO Rendezvous . . . . . . . . . . . . . . . . . . . . . . . . . 345Tablas de TIBCO Rendezvous . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345

Limitaciones. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345Creación de una tabla de flujos de datos para TIBCO Rendezvous. . . . . . . . . . . . . . . . . 346

Información de la columna de TIBCO . . . . . . . . . . . . . . . . . . . . . . . . . 348Tipos de datos de TIBCO Rendezvous . . . . . . . . . . . . . . . . . . . . . . . . . 350

Capítulo 34. Usuarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353Editar la información de su propia cuenta . . . . . . . . . . . . . . . . . . . . . . . . . 353Crear, suprimir o editar una cuenta de usuario . . . . . . . . . . . . . . . . . . . . . . . 353Pestaña Detalles del usuario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353Pestaña Perfiles de entrega . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354

Correo electrónico . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354Servicio web. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354

Pestaña Permisos de acceso. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355

Capítulo 35. Funciones definidas por el usuario . . . . . . . . . . . . . . . . . 357Restricciones de las funciones definidas por el usuario . . . . . . . . . . . . . . . . . . . . 357Creación y uso de una función diseñada por el usuario . . . . . . . . . . . . . . . . . . . . 358Modificación de una función diseñada por el usuario . . . . . . . . . . . . . . . . . . . . . 358Archivos de manifiesto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359

Capítulo 36. Vistas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361Creación de vistas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361

x IBM Cognos Real-time Monitoring Workbench Versión 10.2.2: Guía de referencia de modelado

Copia de una vista . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362Atributos de vista . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362Restricciones de vista. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364Uniones sincronizadas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364

Restricción . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365Ejemplo de una unión sincronizada . . . . . . . . . . . . . . . . . . . . . . . . . . 365

Flujos de datos consolidados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367Vistas agregadas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367Actualización de vistas mediante la propagación de eventos. . . . . . . . . . . . . . . . . . . 368Vistas completas y sin estado . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368Inicialización de vistas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368Mantenimiento de eventos en vistas sin estado . . . . . . . . . . . . . . . . . . . . . . . 369Persistencia de vistas para una base de datos. . . . . . . . . . . . . . . . . . . . . . . . 370

Vista de atributos de persistencia . . . . . . . . . . . . . . . . . . . . . . . . . . . 371Vista de columnas persistentes . . . . . . . . . . . . . . . . . . . . . . . . . . . 371

Habilitación de la obtención de detalles . . . . . . . . . . . . . . . . . . . . . . . . . 372Datos de IBM Cognos Real-time Monitoring en IBM Cognos Business Intelligence . . . . . . . . . . . 373

Visualización de datos de IBM Cognos Real-time Monitoring en IBM Cognos Business Intelligence. . . . . 373

Capítulo 37. servicios web . . . . . . . . . . . . . . . . . . . . . . . . . . . 375Flujos de datos del servicio web . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375

Atributos de flujo de datos para servicios web . . . . . . . . . . . . . . . . . . . . . . 376Atributos de flujo de datos para servicios web de sondeo . . . . . . . . . . . . . . . . . . 377Creación de un flujo de datos para un servicio web . . . . . . . . . . . . . . . . . . . . 378

Tablas de consulta para servicios web . . . . . . . . . . . . . . . . . . . . . . . . . . 379Creación de una tabla de consulta para datos de un servicio web . . . . . . . . . . . . . . . . 381Columnas de salida . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382Columnas de entrada. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382Plantillas de sustitución de cadenas . . . . . . . . . . . . . . . . . . . . . . . . . . 383

Procesos externos del servicio web . . . . . . . . . . . . . . . . . . . . . . . . . . . 384Publicar un elemento en un servicio web externo . . . . . . . . . . . . . . . . . . . . . 384Atributos de proceso externo . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384Creación de un proceso externo . . . . . . . . . . . . . . . . . . . . . . . . . . . 384Implementación del servicio externo. . . . . . . . . . . . . . . . . . . . . . . . . . 385Campos de mensaje . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385WSDL de servicio web . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386

Capítulo 38. Ventanas de consulta . . . . . . . . . . . . . . . . . . . . . . . 389Visión general de las ventanas de consulta . . . . . . . . . . . . . . . . . . . . . . . . 389

Tipos de ventana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389Declaraciones y referencias de ventanas . . . . . . . . . . . . . . . . . . . . . . . . . 390

En línea . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390Referencia por nombre . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390Varias ventanas por consulta . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391Ampliación de una definición de ventana con otra . . . . . . . . . . . . . . . . . . . . . 391Restricciones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391

Ventanas de serie de eventos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392Cláusula EVENTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392Evento actual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393

Ventanas de serie de tiempo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394Cláusula RANGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394¿Qué eventos se incluyen? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396Cláusula ORDER BY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396Llegada en otro orden . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397Descendente. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397Indicaciones de fecha y hora de valor NULL . . . . . . . . . . . . . . . . . . . . . . . 398Series de tiempo en enteros. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398

Particiones de ventana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399Cláusula PARTITION BY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400Actualización de vista para una cláusula GROUP BY simple . . . . . . . . . . . . . . . . . 400

Contenido xi

Actualización de vista para una partición con referencia FRAME . . . . . . . . . . . . . . . . 400Actualización de vista para una partición con referencia OPERATOR . . . . . . . . . . . . . . . 401Ventaja de las particiones respecto a los grupos . . . . . . . . . . . . . . . . . . . . . . 401Uso de las ventanas para hacer caducar GROUP BY . . . . . . . . . . . . . . . . . . . . 402Resultados históricos de vistas divididas . . . . . . . . . . . . . . . . . . . . . . . . 402

Avance de las ventanas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403Cláusula SLIDE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403Ventanas en movimiento . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404Ventanas finales en movimiento . . . . . . . . . . . . . . . . . . . . . . . . . . . 404Funciones TUMBLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405

Referencia de actualización de ventana . . . . . . . . . . . . . . . . . . . . . . . . . . 406Cláusula REFERENCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406

Inicialización de ventanas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407Cláusula INITIALIZE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407Ejemplo de la cláusula INITIALIZE . . . . . . . . . . . . . . . . . . . . . . . . . . 408

Capítulo 39. Archivos XML y XSD utilizados por IBM Cognos Real-time Monitoring 409Archivos XML y XSD en Cognos Real-time Monitoring . . . . . . . . . . . . . . . . . . . . 409

Dependencias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409Espacio en blanco . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409Caracteres de escape . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410Datos de caracteres . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410

Carga de archivos XML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410Carga de archivos XML de una línea de comandos . . . . . . . . . . . . . . . . . . . . . 411Carga de archivos XML desde un navegador web . . . . . . . . . . . . . . . . . . . . . 411

Definición de un objeto con XML. . . . . . . . . . . . . . . . . . . . . . . . . . . . 412Ejemplo: crear usuario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412

Definición de varios objetos con XML . . . . . . . . . . . . . . . . . . . . . . . . . . 413Ejemplo: comando por lotes . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413

Modificación de un objeto existente con XML . . . . . . . . . . . . . . . . . . . . . . . 414Dependencias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415

Emisión de comandos con XML . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416Ejemplo: habilitar un objeto y sus dependencias . . . . . . . . . . . . . . . . . . . . . . 416

Archivos XSD de Cognos Real-time Monitoring . . . . . . . . . . . . . . . . . . . . . . . 416

Apéndice A. Métodos Java Database Connectivity . . . . . . . . . . . . . . . . 421Controlador . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422Sentencia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425DatabaseMetaData. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428ResultSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441ResultSetMetaData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450

Apéndice B. API UM-SSO . . . . . . . . . . . . . . . . . . . . . . . . . . . 453Cómo funciona UM-SSO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453

Primer inicio de sesión en IBM Cognos Real-time Monitoring . . . . . . . . . . . . . . . . . 453Inicio de sesión en IBM Cognos Real-time Monitoring y navegación a la aplicación externa . . . . . . . 454Inicio de sesión en la aplicación externa y navegación posterior a IBM Cognos Real-time Monitoring . . . . 454Sincronización de usuarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454

Instalación de un conector UM-SSO . . . . . . . . . . . . . . . . . . . . . . . . . . . 454XML setPropertyDetails . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455

Elementos del XML setPropertyDetails . . . . . . . . . . . . . . . . . . . . . . . . . 455UMAPI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458

doAuthenticate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458doLogout. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459fetchAllUsers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460fetchRoles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460getResourceBundle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461getRoles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461

xii IBM Cognos Real-time Monitoring Workbench Versión 10.2.2: Guía de referencia de modelado

getSettings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462onPropertyChange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462

Credential . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462getPassword. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463getUserName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463setPassword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463setUserName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463

Role . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463getAttributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464getRoleDescription . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464getRoleName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464getUsers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464setAttributes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464setRoleDescription. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465setRoleName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465setUsers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465

SessionInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465getAttributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465getUser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466setAttributes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466setUser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466

User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466getAttributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466getUserDescription . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466getUserId. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467setAttributes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467setUserDescription . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467setUserId . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467

Excepciones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468ApplicationNotAvailableException . . . . . . . . . . . . . . . . . . . . . . . . . . 468InvalidCredentialException . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468SessionTimedOutException . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468

Avisos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469

Glosario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473F . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473H . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474I. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474M . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474N . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474P . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474T . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474U . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474V . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474

Contenido xiii

xiv IBM Cognos Real-time Monitoring Workbench Versión 10.2.2: Guía de referencia de modelado

Introducción

Este documento se ha diseñado para utilizarse con IBM® Cognos Real-timeMonitoring Workbench.

Público

Este documento está diseñado para administradores y modeladores.

Búsqueda de información

Para buscar documentación de productos en la web, incluida toda ladocumentación traducida, acceda al Knowledge Center de IBM(http://www.ibm.com/support/knowledgecenter).

Características de accesibilidad

IBM Cognos Real-time Monitoring Workbench actualmente no soportacaracterísticas de accesibilidad que ayudan a los usuarios con una discapacidadfísica, como movilidad reducida o visión limitada, a utilizar este producto.

Proyecciones futuras

En esta documentación se describe la funcionalidad actual del producto. Es posibleque también se incluyan referencias a elementos que no están disponibles. Sinembargo, no debe entenderse que estos vayan a estar disponibles en un futuro.Tales referencias no suponen el compromiso, promesa u obligación legal de lanzarel material, el código ni la funcionalidad correspondiente. El desarrollo, la versióny la duración de las características la funcionalidad dependen exclusivamente deIBM.

© Copyright IBM Corp. 2007, 2014 xv

http://www.ibm.com/support/knowledgecenter

xvi IBM Cognos Real-time Monitoring Workbench Versión 10.2.2: Guía de referencia de modelado

Novedades

Esta sección contiene una lista de características nuevas, modificadas y eliminadasde esta versión. Esta información le permitirá planificar las estrategias deactualización y despliegue de aplicaciones, así como las necesidades de formaciónde los usuarios.

Para obtener información sobre la actualización, consulte la publicación IBMCognos Business Intelligence Guía de instalación y configuración correspondiente alproducto.

Para obtener información sobre otras características nuevas de esta versión,consulte la publicación IBM Cognos Business Intelligence Guía de características nuevas.

Encontrará información sobre las novedades de las versiones anteriores si accede ala documentación del Knowledge Center de IBM (http://www.ibm.com/support/knowledgecenter).

Para ver una lista actualizada de los entornos soportados por los productos de IBMCognos, como sistemas operativos, parches, navegadores, servidores web,servidores de directorios, servidores de bases de datos y servidores de aplicaciones,visite el centro del cliente de IBM Cognos (http://www.ibm.com/software/data/cognos/customercenter).

Características nuevas de la versión 10.2.2Esta versión de IBM Cognos Real-time Monitoring Workbench no incorporaninguna característica nueva.

Características nuevas de la versión 10.2.1Esta versión de IBM Cognos Real-time Monitoring Workbench no incorporaninguna característica nueva.

Características nuevas en la versión 10.2.0A continuación encontrará una lista de características nuevas respecto a la versiónanterior.

Workbench Technical Reference ahora es Workbench Referenciade modelado

El documento que anteriormente se titulaba IBM Cognos Real-time MonitoringWorkbench Technical Reference ahora se titula IBM Cognos Real-time MonitoringWorkbench Referencia de modelado.

Características nuevas de la versión 10.1.1A continuación se enumeran las características nuevas de la versión 10.1.1.

© Copyright IBM Corp. 2007, 2014 xvii

http://www.ibm.com/support/knowledgecenter

http://www.ibm.com/software/data/cognos/customercenter/

Integración más estrecha entre IBM Cognos Real-time MonitoringDashboard e IBM Cognos Business Insight

Cuando se trabaja con objetos de IBM Cognos Real-time Monitoring Dashboard enIBM Cognos Business Insight, se puede:v Convertir un tipo de visualización en otrov Cambiar los estilos de medida en una visualizaciónv Cambiar las propiedades específicas en una visualizaciónv Utilizar los widgets de filtro de IBM Cognos Business Insight

Para obtener más información, consulte los temas sobre la modificación de lostipos de visualización, los estilos de medida y las propiedades específicas degráficos y los widgets de filtrado en la publicación IBM Cognos Real-time MonitoringDashboard Guía del usuario.

Las tablas de consulta de secuencia soportan las dimensionesen línea

Si se utiliza una tabla de consulta de flujo basada en una secuencia de eventos, losvalores de la tabla de consulta se actualizan a la misma velocidad que se procesanlos datos y pueden extraerse de orígenes no JDBC, como JMS o WebSphere MQ.Ahora puede utilizar dimensiones en línea en los cubos y en las vistas sin lanecesidad de crear de nuevo uniones con la dimensión: la dimensión se crea enuna tabla de consulta siguiendo los mismos pasos que una dimensión tradicional.Para obtener más información, consulte el tema sobre la creación de tablas deconsulta sobre secuencias de datos y vistas en la publicación IBM Cognos Real-timeMonitoring Workbench Guía del usuario.

Soporte para upsert ampliado a los archivos sin formato y alformato de servicio de mensajes JDBC

En la versión 10.1.0, la funcionalidad upsert, que combina las acciones deactualizar, insertar y suprimir datos de las tablas de secuencia de datos, sólo estabadisponible para los flujos de datos Java™ Database Connectivity (JDBC). En laversión 10.1.1 se amplía el soporte de esta característica a las secuencias dearchivos sin formato, las secuencias JMS y otros. Para obtener más información,consulte los temas sobre habilitación de upsert para una secuencia de datos en lapublicación IBM Cognos Real-time Monitoring Workbench Guía del usuario. Consultetambién el tema sobre upsert de la publicación IBM Cognos Real-time MonitoringWorkbench Referencia de modelado.

Búsqueda de objetos

En versiones anteriores, se consumía demasiado tiempo en la búsqueda de objetosde interés mediante listas ordenadas. Ahora, puede buscar texto específicocontenido en la definición XML. Para obtener más información, consulte el temasobre búsquedas en la biblioteca de objetos en la publicación IBM Cognos Real-timeMonitoring Workbench Guía del usuario.

Dependencias y requisitos de objetos de vista

Puede utilizar la pestaña Relaciones para ver todas las dependencias y losrequisitos de un objeto. Para obtener más información, consulte el tema sobre lasdependencias y los requisitos de los objetos en la publicación IBM Cognos Real-timeMonitoring Workbench Guía del usuario.

xviii IBM Cognos Real-time Monitoring Workbench Versión 10.2.2: Guía de referencia de modelado

Creación de una infraestructura de adaptador externo

Puede configurar un adaptador externo para convertir los datos en un formato nosoportado anteriormente (como JSON y una entrada RSS) en un formato soportadopor RTM (como el tabular, el archivo sin formato o XML). Para obtener másinformación, consulte el tema sobre las infraestructuras de adaptador en lapublicación IBM Cognos Real-time Monitoring Workbench Referencia de modelado.

Novedades xix

xx IBM Cognos Real-time Monitoring Workbench Versión 10.2.2: Guía de referencia de modelado

Capítulo 1. Cómo empezar

En primer lugar, el administrador del sistema debe instalar, configurar e iniciar loscomponentes de servidor de IBM Cognos Real-time Monitoring. Para recibireventos o recuperar datos de la tabla de consulta, los servidores deben localizar yrecopilar los datos. Por ejemplo, para acceder a un DBMS con el fin de recuperardatos de una tabla de consulta, los servidores deben configurarse con la contraseñay el nombre de acceso de la base de datos.

Para obtener más información, consulte la publicación IBM Cognos Real-timeMonitoring Guía de instalación y configuración.

Lanzamiento de Real-time Monitoring WorkbenchSi es un administrador del sistema, en primer lugar acceda a IBM CognosReal-time Monitoring Workbench para configurar los valores del sistema para queotros usuarios puedan acceder al producto.

Antes de empezar

Antes de lanzar IBM Cognos Real-time Monitoring Workbench, asegúrese de quese dan las condiciones siguientes:v El navegador web de que dispone es Microsoft Internet Explorer 6.0 o posterior.v Los servidores Cognos Real-time Monitoring están en ejecución.v Se ha habilitado JavaScript.v Se ha instalado Adobe Flash versión 9.

Acerca de esta tarea

Para iniciar la sesión, debe utilizar la cuenta de usuario rtmadmin y la contraseñamanager. Para obtener más información, consulte la sección sobre la configuraciónde Cognos Real-time Monitoring tras la instalación en la publicación IBM CognosReal-time Monitoring Guía de instalación y configuración.

Cuando se ha habilitado el modo a prueba de fallos, Cognos Real-time MonitoringWorkbench visualiza un banner que indica que el sistema se encuentra en modo aprueba de fallos y que todos los eventos están en pausa. El flujo de datos sedetiene cuando el sistema se encuentra en modo a prueba de fallos. Para obtenermás información, consulte la publicación IBM Cognos Real-time Monitoring Guía deinstalación y configuración.

Procedimiento1. En el navegador web, escriba el URL, siendo nombre_servidor el nombre del

sistema host y el número de puerto:http://nombre_servidor/cognos/realtime/landing/landingpage.htmSe abrirá la página de bienvenida de Cognos Real-time Monitoring.

2. En función de si su rol es administrador, modelador o desarrollador, pulse unode los enlaces siguientes:v Administrar el contenido en tiempo real.v Modelar mis datos en tiempo real.

© Copyright IBM Corp. 2007, 2014 1

v Crear mi panel de control en tiempo real.3. Inicie la sesión con el nombre de usuario y la contraseña que le ha asignado el

administrador.Nota: Si el inicio de sesión único entre IBM Cognos Business Intelligence (BI) yCognos Real-time Monitoring está habilitado, y si ya ha iniciado la sesión enIBM Cognos Business Intelligence, la página de inicio de sesión no aparecerá.Se iniciará la sesión de forma automática en Cognos Real-time MonitoringWorkbench.

Cómo trabajar con el productoSe pueden realizar las siguientes tareas mediante IBM Cognos Real-timeMonitoring Workbench.v Configuración de cuentas de usuario.

Todas las personas que utilizan Cognos Real-time Monitoring Workbench oCognos Real-time Monitoring Dashboard necesitan una cuenta de usuario. Paraver la información de sus cuentas, los usuarios deben pulsar la opción Valoresde cuenta de la aplicación.Los administradores del sistema pueden añadir y modificar las cuentas deusuario con Consola de administración.

v Creación y modificación de agentes.Los agentes recopilan eventos y datos de la tabla de consulta para ponerlos adisposición de Real-time Monitoring.Los administradores del sistema crean y modifican los agentes medianteConsola de administración.

v Creación de flujos de datos y tablas de consulta.Los agentes insertan datos en las tablas de flujos de datos y en las tablas deconsulta. Estas tablas son el origen de las vistas empresariales que presentan yagregan la información.Puede crear flujos de datos y tablas de consulta por medio de Workbench .

v Utilización de vistas empresariales.Las vistas empresariales contienen, agregan y proporcionan información de lastablas de consulta y de flujos de datos.Con el Modelador de escenarios puede crear vistas empresariales complejas.

v Creación de escenarios, reglas y alertas.Puede utilizar Cognos Real-time Monitoring para identificar eventosempresariales excepcionales y notificar a los usuarios la actividad.Para ello, cree escenarios, reglas y alertas en el Modelador de escenarios.También puede utilizar el Modelador de escenarios para definir reportlets queproporcionen las métricas que se asocian a los eventos.

2 IBM Cognos Real-time Monitoring Workbench Versión 10.2.2: Guía de referencia de modelado

Capítulo 2. Filtros de acceso

Varios usuarios pueden utilizar filtros de acceso para ver diferentes filas de lamisma vista o cubo, según los criterios especificados en el filtro, eliminando así lanecesidad de definir una vista o cubo nuevos para cada usuario.

Por ejemplo, observe esta vista de ventas totales por región:Total Sales Region

----------- -------

763000.00 West

489500.00 Central

522950.00 South

650740.00 East

Al definir un filtro de acceso que especifica, por ejemplo,OrderTotals.Region=Employees.Region, puede hacer que los usuarios sólo vean lasfilas aplicables a su región de negocio. En este ejemplo, un usuario de la regiónCentral que consulta la vista verá el siguiente resultado:Total Sales Region

----------- -------

489500.00 Central

Los filtros son expresiones lógicas similares a la cláusula WHERE de unadefinición de vista. Para ver una descripción completa de los filtros, consulte:“Condiciones de filtro de acceso”. Para obtener más información sobre lascláusulas WHERE, consulte: “Cláusula WHERE” en la página 339.

Los filtros de acceso se definen vista por vista y cubo por cubo, y se aplican a losusuarios y roles que tengan permiso Filtrado/Sólo lectura en la vista o cubo. Paraobtener información sobre cómo funcionan los filtros de acceso, consulte:“Comportamiento de filtro de acceso y restricciones” en la página 6.

Para aplicar filtros de acceso a una vista o cubo, primero se debe crear el filtro y, acontinuación, asignarlo a los usuarios o roles, como se describe en las siguientessecciones:v “Creación de un filtro de acceso en una vista” en la página 6v “Asignación de un filtro de acceso a usuarios y roles” en la página 8

Condiciones de filtro de accesoLas condiciones de filtro de acceso son expresiones lógicas que se aplican a cadafila de la vista o nivel de dimensión de un cubo.

El usuario que consulta la vista o el cubo sólo ve las filas en las que la expresiónda TRUE como resultado.

Como mínimo, cada filtro debe contener alguna condición que evalúe datosencontrados en la vista o cubo. Por ejemplo, la siguiente condición simple muestrasólo las filas de OrderTotals que se encuentran en la región de negocioEast:OrderTotals.Region='East'


Los filtros de acceso pueden incluir operadores booleanos (AND, OR y NOT), ypueden utilizar paréntesis para agruparlos. Por ejemplo, OrderTotals.Region='East'AND (CURRENT_USER()='Skyler' OR CURRENT_USER()='Nina').

Nombres de usuario en filtros de accesoUn filtro de acceso puede incluir los nombres de usuarios específicos.

Se debe asignar un filtro de acceso como OrderTotal.Region=’East’ a cada usuarioo rol de la región Este para limitar el acceso a ese usuario. Una expresión queespecifica el nombre del usuario sería más potente. La función CURRENT_USER(consulte: “CURRENT_USER” en la página 166) devuelve el nombre de inicio desesión del usuario que consulta la vista. Se puede incluir esa función en lacondición de filtro para aplicar el filtro a usuarios específicos.

Por ejemplo, la siguiente condición también identifica a dos usuarios; por lo tanto,estos dos usuarios consultan los resultados para la región Este:OrderTotals.Region=’East’ AND

(CURRENT_USER()=’Skyler’ OR CURRENT_USER()=’Nina’)

Una limitación de los anteriores dos ejemplos es que tienen valores literales nomodificables dentro de las expresiones: el nombre de la región y los nombres deusuario. Esto es un problema porque se deben editar los filtros siempre quecambian los nombres y se debe crear una expresión para cada región.

Una expresión más potente es la que se puede aplicar a todos los usuariosrecuperando información de forma dinámica sobre el usuario y aplicándola a lavista.

Tabla de consulta en filtros de accesoAdemás de recuperar datos de la vista actual, los filtros de acceso puedenrecuperar datos de una tabla de consulta.

Si define una tabla de consulta que contenga información sobre los usuarios, puedecomparar dicha información con los datos de la vista para crear un filtro de tablade consulta dinámica.

Observe el siguiente filtro, que utiliza una tabla de consulta de empleados.OrderTotals.Region=Employees.Region AND

CURRENT_USER()=Employees.User_Name

Ahora puede aplicar el filtro para muchos usuarios y roles, y sólo ven los datos losusuarios asignados a la misma región empresarial que los datos. En las siguientessecciones se muestran ejemplos.

Para utilizar consultas dinámicas debe proporcionar la información en una tabla deconsulta externa

Tablas de consulta de usuarios en filtros de accesoLas tablas de consulta normalmente soportan tablas de flujos de datos yproporcionan información contextual adicional.

Cuando se utiliza en un filtro de acceso, la tabla de consulta proporcionainformación que soporta el filtro; por ejemplo, información sobre el usuario actual.


La tabla de consulta de un usuario debe tener al menos una columna que contengael nombre de usuario que coincida con el nombre que utiliza el usuario para iniciarsesión en IBM Cognos Real-time Monitoring.

La función CURRENT_USER devuelve el nombre de inicio de sesión del usuariotal como se define en IBM Cognos Real-time Monitoring, con las mismasmayúsculas y minúsculas, y tal como aparece en Cognos Real-time MonitoringWorkbench. Es importante que el uso de mayúsculas y minúsculas coincidaexactamente. Algunos DBMS proporcionan comparaciones que no son sensibles alas mayúsculas y minúsculas, en cuyo caso esto no representará ningún problema.Para evitar discrepancias, especifique los nombres en la tabla de consulta usandosólo mayúsculas o sólo minúsculas, y luego utilice UPPER() o LOWER() en laexpresión de filtro, como por ejemplo:UPPER(CURRENT_USER())=Employees.User_Name

No se puede utilizar UPPER() ni LOWER() en la referencia a la tabla de consultade empleados. Para obtener información, consulte: “Limitaciones de columna enconsultas de tablas de consulta” en la página 264.

De forma similar, todas las columnas de texto referenciadas en un filtro debentener en cuenta las diferencias entre mayúsculas y minúsculas.

Para utilizar una tabla de consulta en un filtro de acceso, añada la tabla al conjuntode trabajo del filtro a la hora de definir el filtro. Para obtener detalles, consulte:“Creación de un filtro de acceso en una vista” en la página 6. Para obtener másinformación acerca de las tablas de consulta, consulte: Capítulo 20, “Tablas deconsulta”, en la página 261.

La tabla de consulta de un usuario debe reunir las condiciones siguientes:v Una fila para cada usuario al que se asigna un permiso de acceso Filtrado/Sólo

lectura. Si el usuario no se encuentra en la tabla de consulta, el filtro no puedeencontrar ninguna fila para ese usuario.Para obtener más información sobre los permisos, consulte: “Permisos deacceso” en la página 291.

v Al menos una columna de texto que contenga el nombre de inicio de sesión delusuario. Si el DBMS proporciona coincidencias de mayúsculas y minúsculas,especifique los nombres exactamente como se definen en Cognos Real-timeMonitoring. Si tiene previsto utilizar UPPER() o LOWER() en sus filtros,especifique el nombre de usuario con los mismos caracteres sólo en minúsculaso en mayúsculas.

v Una columna para cada referencia que aparezca en el filtro, y los tipos de datosdeben coincidir. Para los valores de caracteres, las cadenas de la vista debencoincidir exactamente con las cadenas de la tabla de consulta.

Si los datos de la tabla de consulta se almacenan en la memoria caché, los filtrospueden fallar si los datos de usuario no se encuentran en la memoria caché. Siañade un usuario a la base de datos, invalide la memoria caché de la tabla deconsulta antes de que el usuario intente consultar vistas o cubos filtrados. Paraobtener más información sobre el almacenamiento en memoria caché, consulte:“Almacenamiento de consultas de tabla de consulta en la memoria caché” en lapágina 265.

Capítulo 2. Filtros de acceso 5

Comportamiento de filtro de acceso y restriccionesLos filtros de acceso se aplican sólo cuando un usuario con permiso filtrado/desólo lectura de una vista consulta o solicita datos desde la vista o define una vistanueva por encima de la vista.

Los filtros no afectan a los usuarios o roles con permiso de sólo lectura o delectura/escritura sobre la vista, ni tampoco se aplican a usuarios que recibenreportlets enviados como archivos adjuntos para notificaciones de alerta.

Al utilizar filtros de acceso, recuerde lo siguiente:v El permiso de acceso predeterminado para las clases de objetos de vista y de

cubo es "Sin acceso para todos los usuarios nuevos".Para que los usuarios puedan ver los resultados, primero se les debe asignarpermisos de sólo lectura o de lectura/escritura (directamente o como miembrosde un rol) para los tipos de objeto de Vista y Cubo (todas las vistas y cubos), ypermiso al menos de filtrado/sólo lectura para la vista específica.

v Cuando se asigna a un usuario varios filtros de acceso a la misma vista o cubo(quizás porque es miembro de varios roles, cada uno con filtros asignados), elusuario ve las filas en que alguno de los filtros es verdadero para la fila.Por ejemplo, un filtro puede restringir a un usuario a ver sólo los datos de laregión Oeste, pero otro puede permitir al usuario ver todos los resultados parauna familia específica de productos. Por consiguiente, el usuario ve todos losresultados para la familia, independientemente de la región.

v Los reportlets siempre incluyen todos los datos de la vista a la que hacenreferencia, independientemente de los filtros de acceso asociados con la vista.Los usuarios que reciben reportlets como parte de notificaciones de alertasiempre ven toda la vista a la que se hace referencia en el reportlet.

v Cuando un usuario con acceso filtrado a una vista crea una vista nueva porencima de la vista filtrada, la nueva vista hereda esos resultados filtrados delusuario, pero no la definición de filtro.Posteriormente, cualquier usuario que consulte la vista derivada verá losresultados como filtrados para el usuario que la ha creado. Por ejemplo, si Skylersólo puede ver Total Sales de la región West y crea una vista nueva denominadaWrapUp derivada de la vista Total Sales, cualquier otro usuario que tengapermiso para ver WrapUp verá los datos para la región West,independientemente de su propio permiso sobre Total Sales.

v Cuando un usuario con acceso filtrado a una vista crea una regla basada en lavista, la regla hereda los resultados filtrados de dicho usuario.Dicha regla sólo se aplica a los eventos que coinciden con la condición de filtrode acceso del usuario, y los suscriptores de la alerta asociada con la vista recibenalertas sólo para los eventos filtrados.

Para obtener más información sobre los permisos, consulte: “Permisos de acceso”en la página 291.

Creación de un filtro de acceso en una vistaPara crear un filtro de acceso, debe disponer de permiso de lectura y escritura parala vista.


Procedimiento1. En IBM Cognos Real-time Monitoring Workbench, pulse en la pestaña

Workbench y seleccione la vista que ha de tener el filtro.2. Seleccione la pestaña Filtros de acceso para ver la lista de filtros que

actualmente se asocian a esta vista.3. Pulse en Crear filtro de acceso para crear un nuevo filtro.4. Añada una tabla de consulta al conjunto de trabajo pulsando en Agregar tablas

de consulta.5. En el cuadro Crear filtro de acceso, asigne el nombre del filtro y,

opcionalmente, proporcione una descripción.6. Defina la condición de filtro siguiendo las instrucciones de la sección

“Condiciones de filtro de acceso” en la página 3. Ahora puede asignar el filtro alos usuarios que disponen de acceso de lectura filtrado para la vista.

Creación de filtros de acceso basados en tablas de consultaPuede crear filtros de acceso basados en tablas de consulta. Cuando se utiliza enun filtro de acceso, la tabla de consulta proporciona información que soporta elfiltro; por ejemplo, información sobre el usuario actual.

Antes de empezar

Debe disponer de permiso de lectura y escritura para el cubo.

Procedimiento1. En IBM Cognos Real-time Monitoring Workbench, pulse la pestaña

Workbench.2. Seleccione el cubo en el que desea crear un filtro de acceso.3. Pulse en la pestaña Filtros de acceso para ver la lista de filtros que

actualmente se asocian a este cubo.4. Pulse en Crear filtro de acceso.5. En la ventana Configurar filtro de cubo, asigne el nombre del filtro y,

opcionalmente, proporcione una descripción.6. Pulse en Agregar filtro. Si crea más de un filtro, se realiza una operación

AND en los filtros para producir el resultado del filtro de acceso.7. Seleccione una función.8. Pulse en Examinar y seleccione una tabla de consulta y columnas.9. Pulse en Examinar y seleccione una dimensión y un miembro.

10. Asigne el filtro a los usuarios que disponen de acceso Filtrado/Sólo lecturapara el cubo. Para obtener información acerca de cómo afecta la definición alas condiciones de filtro, consulte: “Condiciones de filtro de acceso” en lapágina 3.

Creación de un filtro de acceso simpleLos filtros simples restringen los resultados de la vista para incluir sólo las filasque cumplen la condición especificada.


Workbench.

Capítulo 2. Filtros de acceso 7

2. Seleccione el cubo en el que desea crear un filtro de acceso.3. Pulse en la pestaña Filtros de acceso para ver la lista de filtros que

actualmente se asocian a este cubo.4. Pulse en Crear filtro de acceso.5. Seleccione Utilizar filtros sencillos.6. Pulse en Examinar y seleccione la dimensión que ha de utilizarse para el filtro

simple.7. Seleccione un miembro. Por ejemplo, si tiene una dimensión de ubicación,

puede que uno de los miembros sea una región o estado.8. Seleccione un valor para el filtro. Por ejemplo, si ha seleccionado un estado

como miembro de una dimensión de ubicación, el valor podría ser California.9. Pulse en Agregar.

10. Pulse Guardar.11. Asigne el filtro a los usuarios que disponen de acceso Filtrado/Sólo lectura

para el cubo.

Asignación de un filtro de acceso a usuarios y rolesPuede asignar un filtro de acceso a un usuario o un rol.

Cuando se asignan varios filtros, el usuario ve las filas que satisfacen alguna de lascondiciones. Por ejemplo, cuando un filtro muestra únicamente las filas queforman parte de la clasificación del departamento del usuario y otro filtro muestralas filas aplicables a su región empresarial, el usuario ve la fila si alguna de las doscondiciones es verdadera.

Antes de empezar

Para realizar este procedimiento, debe disponer de permiso de lectura y escrituraen la vista o el cubo, y los filtros ya deben estar definidos.

Procedimiento1. En IBM Cognos Real-time Monitoring Workbench, pulse la pestaña Workbench.2. Seleccione la vista a la que quiere asignar el permiso de lectura filtrado.3. Pulse Actividades y seleccione Permisos.4. Seleccione los usuarios o roles que deben tener acceso filtrado.5. Pulse Cambiar permisos.6. Seleccione Filtrado / Sólo lectura y seleccione el o los filtros de acceso que se

utilizarán.7. Pulse Aceptar.8. Pulse Listo.


Capítulo 3. Infraestructura de adaptador

La infraestructura de adaptador es un conjunto de componentes que puedeutilizarse para añadir agentes externos a IBM Cognos Real-time Monitoring.

Algunos agentes están fuertemente acoplados al origen de datos que utilizan;Real-time Monitoring no puede comunicarse con el origen de datos paraintercambiar datos.

La infraestructura de adaptador le permite conectar IBM Cognos Real-timeMonitoring a aplicaciones y orígenes de datos externos mediante su agenteexterno, en lugar de utilizar uno de los agentes disponibles en IBM CognosReal-time Monitoring. Puede crear adaptadores externos que son configurables yque pueden soportar operaciones generales tales como iniciar, detener y sondear.

Cuando implementa un agente adaptador externo, también puede crear objetos deflujo de datos y tabla de consulta que utilizan el agente.

La infraestructura de adaptador consta de diversos componentes que debeimplementar para conectar la aplicación externa a IBM Cognos Real-timeMonitoring. Estos componentes son:v Archivo de configuración de agente externo

El archivo de configuración de agente externo es un archivo XML que especificala configuración del agente externo. El archivo de configuración especifica el tipode datos que recibe el agente, que también determina los tipos de flujos de datosy tablas de consulta disponibles tras configurar un agente externo. Para obtenermás información, consulte: “Configuración del archivo de configuración” en lapágina 12.

v Agente externoDebe definir el agente externo en IBM Cognos Real-time Monitoring paraconectarse a la aplicación externa. Para obtener más información, consulte:“Creación de agentes” en la página 26.

v Cliente externoEl cliente externo es la aplicación externa que adapta el origen de datos a losrequisitos de Cognos Real-time Monitoring. El cliente externo tiene doscomponentes: la infraestructura de cliente externo y el conector de clienteexterno.– Infraestructura de cliente externo

Debe implementar la infraestructura del cliente externo para gestionar larecepción comandos y el envío de datos a Cognos Real-time Monitoring. Lainfraestructura de cliente externa se proporciona en el archivo Java Archive(JAR) que contiene las API para el conector de cliente externo.

– Conector de cliente externoEl conector de cliente externo se crea mediante las API de la infraestructurade cliente externo. El conector recupera datos del origen de datos.

Creación de una infraestructura de adaptador externoPuede crear una infraestructura para añadir agentes externos a IBM CognosReal-time Monitoring.


Procedimiento1. Implemente un conector de cliente externo.

Para obtener más información, consulte: “Conector de adaptador externo”.2. Cree un archivo XML AgentConfig basado en el conector.

Para obtener más información, consulte: “Configuración del archivo deconfiguración” en la página 12.

3. Empaquete el archivo XML ExternalAgentConfig en un archivo JARExternalAgentConfig.Para obtener más información, consulte: “Archivo ConfigXML” en la página 12.

4. Cargue el archivo JAR en Cognos Real-time Monitoring Workbench comoarchivo JAR.Para obtener más información, consulte: “Carpeta de archivos JAR” en lapágina 14.

5. Coloque el conector compilado junto con el archivo JAR de adaptador externoen la máquina desde la que el conector puede acceder a los datos para los queha sido creado. Incluya las clases para el conector en la ruta de clase cuandoinicie el adaptador externo.Para obtener más información, consulte: “Compilación e inicio de unaaplicación externa” en la página 14.

6. En Cognos Real-time Monitoring Workbench, cree un agente del tipo definidoen el archivo XML ExternalAgentConfig.

7. Cree una tabla de flujos de datos o de consulta en Workbench, mediante elagente que ha creado.

8. Utilice los datos de Cognos Real-time Monitoring para crear vistas y cubos.

Conector de adaptador externoSe puede utilizar un conector existente, como el que se incluye con IBM CognosReal-time Monitoring, o puede implementar un nuevo conector.

El conector implementa una clase que se extiende desde la clasecom.ibm.cognos.externaladapter.ExternalAdapterPlugin.

Esta clase extrae datos del sistema de origen y lo convierte a uno de los formatosde datos que soporta la infraestructura del adaptador externo.

Se deben implementar los siguientes métodos en la clase de conector. Puede ver unejemplo aquí: ubicación_instalación/realtime/webcontent/samples/sdk/adapters/jdbc_sample/src/com/externalApplication/jdbc, dondeubicación_instalación especifica la ubicación de instalación de IBM CognosBusiness Intelligence.

Init()

Se llama a este método cuando se crea el flujo de datos del adaptador externo. Estemétodo tiene dos parámetros, uno para detalles del agente y otro para detalles deflujo de datos. Si un procedimiento necesita ejecutarse durante la inicialización delflujo de datos, este método puede añadirlo.

Atención: No se llama a ningún método cuando se crea el agente en Workbench.La validación de los datos de entrada del agente se puede realizar utilizando elmétodo testAgentCredentials() que se describe en la siguiente sección.


Destroy()

Se llama a este método durante la supresión del flujo de datos. Vacía todos losdatos creados durante el método init().

testAgentCredentials()

Este método se utiliza para la funcionalidad Conexión de prueba. Este método sepuede utilizar para validad los datos proporcionados por el agente. Si el agente norequiere validación, este método se debe implementar vacío, lo cual devuelve unvalor predeterminado de true.

validateDataStream()

Este método valida los datos de flujo de datos que recibe el conector. El conectorproporciona la implementación predeterminada para este método, lo cual devuelvetrue. Supongamos, por ejemplo, que tiene una aplicación JDBC y proporciona unnombre de tabla como entrada. La validación para el flujo de datos comprueba queel nombre de la tabla es correcto o que el nombre de la tabla existe en la base dedatos. Este método es opcional.

getTabularData()

Este método obtiene los datos del flujo de datos tabular y coloca los datos en elobjeto de respuesta en un formato reconocido por Cognos Real-time Monitoring.Este método tiene dos parámetros, uno para los detalles del flujo de datos y otropara la respuesta, que se envía de vuelta a la aplicación Cognos Real-timeMonitoring.

La llamada IExternalAdapterTabularDataStreams getInputData() devuelve laentrada especificada en el campo Entrada del origen de datos en Cognos Real-timeMonitoring Workbench. El método isIncrementalField() de los objetosIExternalAdapterTabularDataStreamColumn indica si el conector trata la columnacomo campo incremental. El conector mantiene el mayor valor encontrado por estacolumna. Cuando el conector devuelve datos, tiene en cuenta este valor mayor y elvalor devuelto por getInitialValue().

Cada objeto de celda representa las columnas independientes especificadas durantela creación del flujo de datos. Este objeto de clase esExternalAdapterTabularDataStreamCellData. Contiene dos objetos distintos: el tipode datos de la columna y los datos reales.

getFlatFileData() y getXMLData()

Estos métodos se utilizan para el archivo sin formato y los flujos de datos XML.

Estos archivos también aceptan los dos parámetros como en getTabularData(). Sinembargo, el formato del objeto de respuesta es distinto del tabular. Para ambasfunciones, en vez de enviar una lista de filas, se rellena un FileInputStream.

Exception.properties

El archivo exception.properties muestra un mensaje localizado detallado de laexcepción en la interfaz de usuario.

Capítulo 3. Infraestructura de adaptador 11

Las clases de excepción, que se crean en la API, toman una clave de mensaje comoparámetro. Cuando se pasa una clave a la clase de excepción, primero extrae elmensaje del archivo exception.properties para el entorno local adecuado y lomuestra en la interfaz de usuario.

Se puede ver un ejemplo de archivo de propiedades de excepción:exception_en.properties. De forma predeterminada, este archivo se encuentra enubicación_instalación/realtime/webcontent/samples/sdk/adapters/template,donde ubicación_instalación especifica la ubicación de instalación de IBMCognos BI.

Configuración del archivo de configuraciónEl archivo de configuración determina qué tipos de transporte y qué opcionesestán disponibles en el cuadro de diálogo Crear agente.

Puede utilizar un archivo de configuración de ejemplo existente, comosampleAgentConfig1.xml. De forma predeterminada, este archivo se encuentra enubicación_instalación/realtime/webcontent/samples/sdk/adapters/jdbc_sample/config, donde ubicación_instalación especifica la ubicación de instalación de IBMCognos BI.

El archivo de configuración es un archivo XML que contiene:v name: identificador de este agente.v nameKey: nombre de tipo del agente. Se trata de una clave localizable para la

cadena que se muestra en el cuadro de diálogo Crear agente.v supportsIncrementingField: distintivo booleano que indica si el adaptador

soporta un campo de aumento.v transportType: lista separada por comas que indica el formato de los datos.

Determina qué representa la interfaz de usuario.– TABULAR– DELIMITED– FIXEDWIDTH– XMLFILE

v ExternalAgentVersionSupported: versión del conector de adaptador externo.

Archivo ConfigXMLConfigXML se comprime en un archivo JAR (Java Archive).


El archivo JAR utiliza una estructura de carpeta parecida a la de la siguienteilustración:

archivo de manifiesto

archivo de recursos

configuración configuración

Creación de JAR

Tabla 1. Componentes del archivo JAR

Componente delarchivo JAR Descripción

Archivos deconfiguración

Al cargar el archivo JAR, IBM Cognos Real-time Monitoringconvierte los archivos XML en objetos ExternalAgentConfig. Estosobjetos se ven como dependencias del archivo JAR cargado.

Archivo de manifiesto Este archivo proporciona la representación del JAR en CognosReal-time Monitoring. Este archivo contiene la información paralos archivos de configuración y el paquete de recursos.

Archivos de recursos Estos archivos proporcionan las cadenas localizadas. Esta cadenaes el nombre de visualización del objeto ExternalAgentConfig. Lacadena localizada se proporciona en Cognos Real-time Monitoringde acuerdo con el entorno local de la aplicación.

Las claves del archivo de recursos se proporcionan en el archivode configuración como claves de nombre. Cuando se crea el objetode configuración de agente utilizando la clave de nombre y elentorno local, la cadena real se recupera del paquete de recursos yse visualiza en la pantalla.

Puede utilizar una herramienta de compilación Java, como Ant, para crear elarchivo JAR. Ant se utiliza para compilar y crear el adaptador, comprimir losarchivos y crear una carpeta JAR.

Si utiliza Ant para automatizar este proceso, puede utilizar el ejemplo build.xml,que se encuentra en directorio_instalación\realtime\webcontent\samples\sdk\fileagent\com\ibm\cognos\externaladapter, donde directorio_instalaciónespecifica la ubicación de instalación de IBM Cognos BI.

Ejecute el destino de build-config-jar para crear el archivo JAR ConfigXML.

Si desea hacerlo manualmente, debe crear una carpeta y, dentro de ésta, debevolver a crear la misma estructura de directorios que se muestra en el diagramaanterior. Luego, debe ir a la carpeta que ha creado y ejecutar el comando que creael archivo JAR.

Al crear el archivo JAR, no añada la carpeta raíz en dicho archivo.


v Utilice el comando de DOS CD para navegar a la carpeta raíz.Por ejemplo, si el nombre de la carpeta raíz es AgentConfig:CD <path of the root directory> AgentConfig

v Ejecute este comando:jar cvf * <jar file name>

'v' es opcional.

Carpeta de archivos JARLos archivos JAR contienen uno o más programas Java.

La carpeta de archivos JAR proporciona acceso a los archivos JAR disponibles paraIBM Cognos Real-time Monitoring. Seleccione la carpeta para ver una lista dearchivos JAR instalados y para cargar otros nuevos. Seleccione un archivo JAR dela carpeta para ver las funciones que contiene ese archivo JAR y los objetos quedependen de las funciones de dicho archivo JAR.

Procedimiento1. En Workbench, pulse la carpeta Archivos JAR.2. Pulse Nuevo archivo JAR.3. Escriba el nombre que desea dar al archivo JAR en el campo Nombre y, si lo

desea, una descripción.4. Pulse Examinar para localizar el archivo en el campo Ruta.5. Pulse Guardar.

El archivo JAR estará disponible en el sistema.

Compilación e inicio de una aplicación externaPuede utilizar un archivo build.xml para compilar el conector de adaptadorexterno.

El valor de clase principal en el archivo build.xml siempre escom.ibm.cognos.externaladapter.ExternalAdapterServer porque esta clase inicia elservidor externo. El archivo ExternalAdapter.jar contiene las clases de adaptadorexterno principales necesarias para la compilación de la clase del conector.

Inicio del proceso de adaptador externo

Para ejecutar el agente externo, debe invocar el proceso Java con la clasecom.ibm.cognos.externaladapter.ExternalAdapterServer y una ruta de claseconfigurada correctamente. La ruta de clase debe incluir el archivoExternalAdapter.jar, el archivo JAR que contiene las clases para laimplementación del conector, los archivos JAR de los que depende laimplementación, el archivo log4j-1.2.7.jar y el directorio en el que residen losarchivos config.properties y exception*.properties. Por ejemplo: java-classpath lib\ExternalAdapter.jar;lib\your plug-in JAR;lib\log4j-1.2.7.jar;lib\SampleApplication.jar;.com.ibm.cognos.externaladapter.ExternalAdapterServer

Atención: Si utiliza el ejemplo build.xml suministrado, el destino de ejecuciónconfigura la ruta de clase e inicia el adaptador externo.


Valores de los parámetros en el archivo build.xmlv Propiedad para el directorio que contiene todos los archivos de compilación:

<property name="build.dir" value="ExternalAdaperSampleApplication"/>

v Propiedad para el nombre y destino del archivo de aplicación ejecutable deejemplo:<property name="externalapplicationjar" value="SampleApplication.jar"/>

v Propiedad para el directorio de origen que contiene todos los archivos Javacreados para la implementación de conector, como la clase de conector:<property name="src" value="."/>

v Propiedad para el directorio que contiene todas las clases compiladas:<property name="classes" value="${build.dir}"/>

config.properties

Se requiere un archivo de configuración para ejecutar aplicaciones externas. Laclase de servidor utiliza este archivo para cargar propiedades de configuraciónespecíficas, como la propiedad PORT.

PORT especifica el número de puerto en el que se ejecuta la aplicación externa y secomunica con IBM Cognos Real-time monitoring.

Para obtener un ejemplo de un archivo config.properties, consulte:ubicación_instalación\realtime\webcontent\samples\sdk\fileagent\com\ibm\cognos\externaladapter, donde ubicación_instalación es la ubicación deinstalación de IBM Cognos BI.

Archivos JAR adicionales

La aplicación externa requiere archivos JAR adicionales al arrancar.

La aplicación externa necesita los archivos log4j-1.2.7.jar, ExternalAdapter.jary SampleApplication.jar. Si para iniciar la aplicación se requieren más archivosJAR, como archivos jar del controlador JDBC, debe añadirlos a la ruta de clasecuando ejecuta el adaptador externo.

Agentes externosPuede crear un agente externo basado en el objeto ExternalAgentConfig de unarchivo JAR cargado.

Cree un agente. Para obtener más información, consulte: “Creación de agentes” enla página 26.

En la lista desplegable Tipo de agente, busque la cadena localizada deExternalAgentTypeNameKey, según se define en el objeto ExternalAgentConfig.Para obtener más información, consulte: “Configuración del archivo deconfiguración” en la página 12.

Tras seleccionar el agente, en Detalles del agente, especifique los atributossiguientes:


Tabla 2. Detalles de agente externo

Detalle de agente Descripción

Nombre de host externo Dirección IP de la máquina donde se ejecuta la aplicaciónexterna.

Puerto externo Número de puerto en el que se ejecuta la aplicación externa, quese especifica en el archivo config.properties. Para obtener másinformación, consulte:

.“Compilación e inicio de una aplicación externa” en la página14

Entrada Propiedades de la conexión necesarias para la aplicación externa.Este mismo valor se especifica para la funcióntestAgentCredentials() e init() en la clase de conector.

Para obtener más información, consulte: “Conector de adaptadorexterno” en la página 10.

Flujos de datos externosTras implementar el agente externo en IBM Cognos Real-time Monitoring, puedeconfigurar flujos de datos que puede utilizar el agente externo.

Los tipos de flujos de datos que puede crear dependen de los elementostransportType que especifique en el archivo de configuración para su agenteexterno. Para obtener más información, consulte: “Configuración del archivo deconfiguración” en la página 12.

Para obtener más información sobre los flujos de datos, consulte: Capítulo 10,“Flujos de datos”, en la página 85

Puede crear cuatro tipos de flujos de datos, en función del tipo de transportesoportado por el agente externo. Los tipos de flujos de datos son:v Tabularv Archivo sin formato delimitadov Archivo sin formato de anchura fijav Archivo XML

Seleccione el tipo en la ventana que se muestra tras seleccionar el agente externo.

Flujos de datos tabulares

Un flujo de datos tabular es similar a un flujo de datos HTTP Post. En la siguientetabla se describen los atributos de un flujo de datos tabular. Puede configurar unflujo de datos tabular en Cognos Real-time Monitoring Workbench si el archivo deconfiguración del agente externo tiene Tabular especificado como tipo detransporte.

Los campos de la pestaña Información de la columna definen cómo correlacionarlos campos del origen de datos en columnas de la tabla de flujos de datos. Hay uncampo para cada columna de la tabla de flujos de datos, y cada uno contiene losatributos descritos en la siguiente tabla:

Cada campo del mensaje puede ser un campo simple que se correlacionedirectamente con una columna de la tabla de flujos de datos, o puede ser un


campo complejo (un campo de archivo sin formato) que contenga varios camposque se correlacionen de forma individual con las columnas de la tabla. Los camposcomplejos se tratan como archivos sin formato en formato delimitado (CSV) o deanchura fija.

Flujos de datos de archivo sin formato delimitado

Un flujo de datos para archivos sin formato delimitados recibe datos en dondecada campo (columna) está separado por un carácter (habitualmente una coma).Puede configurar un flujo de datos para archivos sin formato delimitados enCognos Real-time Monitoring Workbench si el archivo de configuración del agenteexterno tiene especificado Delimited como tipo de transporte.


Flujos de datos de archivos sin formato de anchura fija

Un flujo de datos para archivos sin formato de anchura fija recibe datos y cadacampo (columna) tiene la misma anchura predefinida en cada fila del archivo, deforma similar a una tabla de una hoja de cálculo. Puede configurar un flujo dedatos para archivos sin formato de anchura fija en Cognos Real-time MonitoringWorkbench si el archivo de configuración del agente externo tiene especificadoFixedWidth como tipo de transporte.


Flujos de datos XML

Un flujo de datos XML recibe datos con formato XML. Puede configurar un flujode datos XML externo en IBM Cognos Real-time Monitoring Workbench si elarchivo de configuración para el agente externo tiene especificado XMLFile comotipo de transporte.


Sondeo e intervalo de borrado de estados

Todos los flujos de datos externos tienen las pestañas Borrar intervalo de estados ySondeo.

Para obtener más información sobre la pestaña Borrar intervalo de estados,consulte: “Intervalo de borrado de estados” en la página 60.

La pestaña Sondeo es donde se especifica la frecuencia con la que el agenteconsulta el origen externo para ver si hay datos nuevos.


Tabla 3. Atributos de flujos de datos tabulares

Parámetro Descripción

Intervalo de sondeo Frecuencia con la que se emite la consulta.

Deshabilitar flujo dedatos después de estenúmero de erroresconsecutivos

Inhabilita el flujo de datos (detiene el sondeo) después de que seproduzca el número de errores consecutivos especificado. Deforma predeterminada, el sondeo se detiene tras cinco erroresconsecutivos. Para volver a habilitar el flujo de datos, cambie suvalor. Establezca esta opción en cero (0) para evitar inhabilitar elflujo de datos automáticamente.

Campo de aumento Identifica la columna de la tabla de origen que contiene un valorque se incrementa con cada evento. Por ejemplo, si la tabla que seconsulta contiene valores de ID exclusivos y ascendentes, laconsulta utiliza ese campo mediante la lógica en que el ID esmayor que el ID máximo de la última consulta.

El campo de aumento sólo está disponible sisupportsIncrementingField está establecido como verdadero en elarchivo de configuración de agente externo.

Valor inicial Valores de inicio asignados al campo de aumento. Sin embargo,este valor inicial no se incluye en el resultado. El primer valorincluido en el resultado será el siguiente valor más pequeñomayor que el valor inicial. Por ejemplo, si especifica 500 comovalor inicial de ID, el primer valor incluido será 501. Para lasconsultas posteriores, los valores son mayores que el valor decampo de aumento más grande devuelto por la última consulta.

Tablas de consulta externasTras implementar el agente externo en IBM Cognos Real-time Monitoring, puedeconfigurar tablas de consulta que puede utilizar el agente externo.

Los tipos de tabla de consulta que puede crear dependen de los elementostransportType que especifique en el archivo de configuración para su agenteexterno. Para obtener más información sobre el archivo de configuración, consulte:“Configuración del archivo de configuración” en la página 12.

Para obtener más información sobre las tablas de consulta, consulte: Capítulo 20,“Tablas de consulta”, en la página 261

Puede crear cuatro tipos de tabla de consulta, en función del tipo de transportesoportado por el agente externo. Los tipos de tablas de consulta son:v Tabularv Archivo sin formato delimitadov Archivo sin formato de anchura fijav Archivo XML

Seleccione el tipo en la ventana que se muestra tras seleccionar el agente externo.

Tablas de consulta tabulares

Una tabla de consulta tabular es similar a una tabla de consulta del sistema dearchivos. Una tabla de consulta tabular tiene los atributos descritos en la tablasiguiente. Puede configurar una tabla de consulta tabular en IBM Cognos Real-time


Monitoring Workbench si el archivo de configuración del agente externo tieneTabular especificado como tipo de transporte.

Los campos de la pestaña Información de la columna definen cómo correlacionarlos campos del origen de datos en columnas de la tabla de consulta. Hay uncampo para cada columna de la tabla de consulta, y cada uno contiene losatributos descritos en la siguiente tabla:

Cada campo del mensaje puede ser un campo simple que se correlacionedirectamente con una columna de la tabla de consulta, o puede ser un campocomplejo (un campo de archivo sin formato) que contenga varios campos que secorrelacionen de forma individual con las columnas de la tabla. Los camposcomplejos se tratan como archivos sin formato en formato delimitado (CSV) o deanchura fija.

Tablas de consulta de archivo sin formato delimitado

Una tabla de consulta para archivos sin formato delimitados recibe datos en dondecada campo (columna) está separado por un carácter (habitualmente una coma).Puede configurar una tabla de consulta para archivos sin formato delimitados enIBM Cognos Real-time Monitoring Workbench si el archivo de configuración delagente externo tiene especificado Delimited como tipo de transporte.


Tablas de consulta de archivos sin formato de anchura fija

Una tabla de consulta para archivos sin formato de anchura fija recibe datos deforma que cada campo (columna) tiene la misma anchura predefinida en cada filadel archivo, de forma similar a una tabla de una hoja de cálculo. Puede configuraruna tabla de consulta para archivos sin formato de anchura fija en IBM CognosReal-time Monitoring Workbench si el archivo de configuración del agente externotiene especificado FixedWidth como tipo de transporte.


Tablas de consulta de datos XML

Una tabla de consulta XML recibe datos con formato XML. Puede configurar unatabla de consulta XML externa en IBM Cognos Real-time Monitoring Workbench siel archivo de configuración para el agente externo tiene especificado XMLFilecomo tipo de transporte.



Almacenamiento de datos en memoria caché y planificación deinvalidación

Cada tipo de tabla de consulta externa tiene una pestaña Almacenamiento dedatos en memoria caché y una pestaña Planificación de invalidación.

Si va a utilizar almacenamiento de JDBC para su memoria caché de datos,necesitará un agente JDBC.

La pestaña Almacenamiento de datos en memoria caché contiene las opcionespara el almacenamiento de datos en memoria caché:v Tipo de memoria caché

Puede utilizar almacenamiento en memoria o almacenamiento JDBC para elalmacenamiento de datos en memoria caché.– En la memoria

Cuando se habilita el almacenamiento en caché en memoria, se almacena enla memoria caché toda la tabla de consulta externa del origen de datosexterno, convirtiéndose en una alternativa al origen de consultas externo. Estoes lo mismo que seleccionar el almacenamiento de datos en caché conprerrecuperación para los orígenes de tabla de consulta de agentes de servicioJDBC y web, como se describe en Almacenamiento de datos en caché conprerrecuperación.Si selecciona esta opción, Almacenamiento de JDBC no está disponible, y elcampo Agente JDBC aparece atenuado.

– Almacenamiento de JDBC

Cuando selecciona Almacenamiento de JDBC, los datos de la tabla deconsulta se envían a una base de datos local, según lo haya especificado elagente JDBC.La lista desplegable Agente JDBC muestra los agentes disponibles. Seleccioneel agente que debe utilizarse para la base de datos local.

Recuperar y almacenar al reiniciar

Esta opción especifica que cuando se reinicia IBM Cognos Real-time Monitoring,el sistema siempre recupera datos del origen de consultas externo, y luego losalmacena en la base de datos local. De lo contrario, si existe un almacén localpreviamente rellenado, éste se utiliza hasta la siguiente planificación deinvalidación. Si no existe ningún almacén local previamente rellenado, se realizauna consulta al origen externo inmediatamente después del reinicio.

v Retirada al origen externo

Esta opción especifica que si el sistema no puede acceder a la base de datoslocal, utilizará los datos de la base de datos externa. Esta opción no estádisponible para tablas de consulta basadas en un agente de sistema dearchivos.Número de conjuntos de resultados a guardar en memoria caché

Esta opción especifica el recuento de conjuntos de resultados que se debenalmacenar en la memoria caché. Cada conjunto de resultados puede conteneruna o varias filas de datos de tabla de consulta relacionadas con el flujo dedatos. Por ejemplo, si se realizan tres consultas y cada conjunto de resultadoscontiene cinco filas, se almacenarán 15 filas en la memoria caché.

La planificación de invalidación identifica cuándo se debe invalidar la memoriacaché y descartar toda la información que hay actualmente en la memoria caché.Para crear una planificación de invalidación, pulse el botón Agregar planificación.Puede hacer lo siguiente:


v Borrar la memoria caché a una hora específica o en un intervalo de horasv Borrar la memoria caché todos los días, uno o varios días específicos de la

semana, o uno o varios días específicos del mesv Borrar la memoria caché durante uno o varios meses específicos

Por ejemplo, para planificar que el borrado de la memoria caché ha de tener lugarcada 3 meses, el día 30 del mes a las 10 de la noche, puede llevar a cabo lasacciones siguientes:v Seleccione Agregar una hora específica y establezca Planificar en a las 10:00

PM.v Seleccione Los días del mes seleccionados a continuación y seleccione 30.v Para el mes, seleccione Marzo, Junio, Septiembre y Diciembre.



Capítulo 4. Agentes

Los agentes son procesos que recuperan información de orígenes externos cuandotiene lugar una actualización en esa información.

Cuando un agente detecta esta información nueva, transfiere esos datos a flujos dedatos y tablas de consulta que se utilizarán en las vistas.

Un agente puede dar soporte a varios flujos de datos o tablas de consulta.

Mientras que un agente sabe cómo comunicarse con un origen externo, los flujosde datos y las tablas de consulta pueden determinar qué información se necesita.La mayoría de los flujos de datos y tablas de consulta definen los detalles queindican al agente qué se debe buscar.

Orígenes externosHay agentes para gestionar diversos orígenes de información externos.

La información se inserta en el sistema a medida que se producen actualizacionesde la información, o se extrae del sistema como resultado de una solicitud de unabase de datos o de un archivo de texto. La información para las tablas de consultasiempre se extrae del origen.

En las siguientes secciones se resumen los orígenes disponibles y se identifican losagentes de origen que soportan. La tabla de cada sección indica si el agente insertao extrae información de actualización a una tabla de consulta o de flujos de datos.

Conectividad de base de datos JDBC

Cuando JDBC (Java Database Connectivity) utiliza un origen externo, suele ser deuna base de datos relacional (RDBMS).

Entorno de servidorde aplicaciones

Agente JDBC

DBMS

Agente deservicios web

Aplicaciónweb

Agente JMS

Aplicación Java

AgenteTIBCO Rend.

TIBCO MessagingApplication

Agente dearchivo sin

formato

Archivosin

formato

Agente de sistemade archivos

Archivosin

formato

Tabla de consultay de flujo de

datos

Figura 1. Diagrama de flujo de trabajo de actividad del agente


Tabla 4. Inserción o extracción de JDBC

AgenteInserción de flujosde datos

Extracción de flujosde datos

Extracción de tablade consulta

JDBC (consulte:Capítulo 18, “JavaDatabaseConnectivity”, en lapágina 225.)

No Sí Sí

Java Messaging Service de una aplicación Java

Cuando JMS es un origen externo, es JMS de una aplicación Java.

Tabla 5. Inserción o extracción de JMS




Cola JMS (consulte:Capítulo 17, “JavaMessaging Service”,en la página 219.)

Sí No No

Tema JMS (consulte:Capítulo 17, “JavaMessaging Service”,en la página 219.)

Sí No No

Archivos de texto

Los archivos de texto son archivos sin formato. Los archivos de texto puedenutilizar un agente de archivos sin formato o un agente de sistema de archivos.

Tabla 6. Inserción o extracción de archivos de texto




Archivos sin formato(consulte:Capítulo 13,“Archivos sinformato”, en lapágina 103.)

No Sí No

Sistema de archivos(consulte:Capítulo 12, “Sistemade archivos deCognos Real-timeMonitoring”, en lapágina 97.)

No No Sí

TIBCO Rendezvous (RV)

Cuando TIBCO RV es un origen externo, es de una aplicación empresarial queutiliza secuencias de mensajes TIBCO.


Tabla 7. Inserción o extracción de TIBCO Rendezvous




TIBCO Rendezvous(consulte:Capítulo 33, “TIBCORendezvous”, en lapágina 345).

Sí No No

Servicio web

Cuando un servicio web es un origen externo, el origen es de una aplicación web através de una conexión HTTP.

Tabla 8. Inserción o extracción de servicio web




Servicios web(consulte: “Procesosexternos del servicioweb” en la página384.)

Sí No Sí

Conectividad SAP

Cuando el origen externo es una base de datos para el sistema SAP, el agente ERPse utiliza para acceder al sistema SAP como tipo de origen a través de un agenteJDBC de metadatos de SAP.

Tabla 9. Inserción o extracción de SAP




ERP (consulte:Capítulo 30,“Conectividad SAP”,en la página 329.)

No Sí No

Sistema Salesforce

Cuando el origen externo es un sistema Salesforce, el origen son tablas deSalesforce.

Tabla 10. Inserción o extracción de Salesforce




Salesforce (consulte:Capítulo 29,“Salesforce”, en lapágina 323.)

No Sí Sí

Capítulo 4. Agentes 25

Creación de agentesPuede crear agentes para recuperar información de orígenes externos cuando tienelugar una actualización en esa información.

Consejo:

Utilice agentes JDBC basados en orígenes en lugar de agentes basados en URL. Losagentes basados en orígenes (o JNDI) permiten agrupar conexiones, pero no ocurrelo mismo con los agentes basados en URL.

Asegúrese de que el número de conexiones de la agrupación de conexiones JNDIes suficiente. El valor predeterminado suele ser 5 o 20, que es demasiado bajocuando todas las tablas de consulta y los flujos de datos comparten el mismoagente. Incremente el número de conexiones entre 50 y 100.

Utilice Máximo de filas por consulta para un agente JDBC para repartir la carga.Si no se establece este valor, una consulta que utiliza un agente JDBC recuperatodo el conjunto de resultados a la vez. Si el conjunto de resultados tiene una grancantidad de datos, el sistema no procesa ningún dato hasta que se recupera elconjunto completo de resultados. Si se especifica este número, sólo se recupera y seprocesa un número determinado de filas de la base de datos. Las filas restantes seobtienen en el siguiente ciclo de recuperación. Los ciclos de recuperación vienendeterminados por el sondeo. El sondeo indica al objeto con qué frecuencia debeconsultar el DBMS para determinar si hay eventos nuevos. Una buena técnica esrealizar sondeos frecuentes, con 5.000 filas por sondeo. Esta técnica no debeutilizarse para los agentes de tablas de consulta, porque no se cargan todas lasfilas.

Utilice agentes distintos para las tablas de consulta y los flujos de datos. Asegúresede que el tamaño de agrupación de conexión de tablas de consulta es suficientepara manejar todas las tablas de consulta que se crean en la agrupación. Si no tieneprerrecuperación en la tabla de consulta, ésta debe tener un agente dedicado paraevitar el bloqueo del acceso a la base de datos a otras tablas de consulta o flujos dedatos.

Para las implementaciones JBoss, debe configurar una definición JNDIcorrespondiente en un archivo celequest_context-ds.xml. Para obtener másinformación, consulte las instrucciones del despliegue de JBoss en la guía deinstalación.

Para obtener más información acerca de los tipos de agentes, consulte: “Orígenesexternos” en la página 23.

Si utiliza un agente externo, el nombre del agente se visualiza en la lista de tiposde agentes disponibles.

Para obtener información acerca de la creación de un agente ERP, consulte:“Creación de un agente SAP” en la página 329. Para obtener información acerca dela creación de un agente JDBC, consulte: Capítulo 18, “Java DatabaseConnectivity”, en la página 225. Para obtener información acerca de la creación deun agente Salesforce, consulte: Capítulo 29, “Salesforce”, en la página 323.

Para obtener más información sobre los tipos de origen, consulte estos temas:v “Agente de archivos sin formato” en la página 28


v “Creación de un agente de sistema de archivos” en la página 32v “Agentes Java Database Connectivity” en la página 236v “Agentes de colas Java Messaging Service” en la página 33v “Agentes de tema JMS” en la página 35v “Agentes TIBCO Rendezvous” en la página 37v “Agentes de servicio web” en la página 39

Antes de empezar

Antes de crear un agente, debe disponer de permisos de creación para agentes yde las especificaciones de conexión para el tipo de agente específico. Para obtenermás información sobre los permisos, consulte: “Cómo otorgar permiso para crearobjetos” en la página 294.

Procedimiento1. En IBM Cognos Real-time Monitoring Workbench, pulse la pestaña Workbench.2. Pulse Actividades.3. Seleccione Crear nuevo > Agente.4. Seleccione el tipo de agente para el agente.5. Especifique los detalles para el tipo de origen específico.6. Guarde el objeto como habilitado.

Edición de agentesPuede que necesite modificar un agente existente.

Antes de empezar

Antes de editar un agente, debe disponer de permisos de lectura y escritura para elagente. Para obtener más información sobre los permisos, consulte: “Permisos deacceso” en la página 291.

Procedimiento1. En IBM Cognos Real-time Monitoring Workbench, pulse la pestaña Workbench.2. Seleccione el agente realizando una de las tareas siguientes:

v En el panel Tablas y vistas, busque el agente que desea editar y efectúe unadoble pulsación en el nombre de éste.

v Seleccione el agente en el panel de la derecha, pulse en Actividades y, acontinuación, pulse en Editar.

3.

4. Si ha efectuado una doble pulsación para seleccionar el agente, pulse en Editaren la parte superior de la pantalla Dependencias. De otro modo, continúe conel paso 5.

5. Especifique los detalles para el tipo de agente específico.6. Guarde el objeto como habilitado.


Agente de archivos sin formatoUn agente de archivos sin formato recupera datos de un archivo de texto.

Tabla 11. Inserción o extracción de archivos sin formato

Inserción de flujos de datosExtracción de flujos dedatos

Extracción de tabla deconsulta

No Sí No

Procesamiento de archivos

El agente de archivos sin formato busca archivos en una ubicación específica en unintervalo definido. El nombre de los archivos para buscar pueden incluir asteriscos(*) y signos de interrogación (?) como comodines. Cuando el agente localiza elarchivo, recupera los datos del evento o la tabla de consulta y, a continuación,suprime, mueve o cambia el nombre del archivo de origen. Cuando hay variosarchivos localizados en la ubicación con nombre, el agente los procesa por ordende nombre de archivo.

Requisitos previos

Antes de crear un agente de archivo plano, necesita lo siguiente:v Permisos de creación para los agentes. Para obtener más información, consulte:

“Cómo otorgar permiso para crear objetos” en la página 294.v Un programa de agente de archivo en ejecución. Para obtener más información,

consulte: “Programa de agente de archivo” en la página 29.

Los agentes de archivo tienen los siguientes atributos:

Tabla 12. Atributos de agente de archivos

Atributo Necesario Descripción

Nombre Sí Identifica el agente. Este nombre debe serexclusivo entre agentes. Para los datos de losarchivos sin formato, es el nombre tal como lodefine el elemento agentName en el archivo deconfiguración de “TestAgent.xml” en la página29. Para obtener más información, consulte:“Programa de agente de archivo” en la página29.

Estado Sí Si el agente está habilitado (preparado pararecibir datos) o inhabilitado (no preparado pararecibir datos).

Guardar en Sí La carpeta en la que ha de almacenarse elagente. La carpeta predeterminada es Carpetaspúblicas. Para seleccionar una carpeta, pulse elbotón Seleccionar carpeta.

Descripción No Descripción opcional que puede contenercualquier carácter de texto.

Creación de un agente de archivos sin formatoEn esta sección se describe cómo crear un agente de archivos sin formato.



Workbench y pulse en Actividades.2. Seleccione Crear nuevo y seleccione Agente en la lista desplegable.3. Seleccione Archivo sin formato como tipo de agente.4. Especifique el valor de los campos que definen los atributos para el agente.5. Guarde el agente como habilitado. Éste iniciará inmediatamente la supervisión

de eventos.

Programa de agente de archivoEl programa de agente de archivo es un programa Java independiente que seejecuta en un host y recopila datos de un archivo de texto. El host puede serdistinto del host del servidor IBM Cognos Real-time Monitoring. Cuando elprograma de agente de archivo encuentra datos, los pasa a los servidores deCognos Real-time Monitoring para que se procesen.

El programa de agente de archivo no es aplicable para datos de tabla de consultade un archivo de texto.

El agente tiene dos archivos de configuración XML:v TestAgent.xml (basado en VCAgent.xsd) define la información de conexión, como

por ejemplo, cómo localizar los servidores de Cognos Real-time Monitoring ycómo dichos servidores pueden localizar el agente de archivos.

v FileAgent.xml (basado en FileAgent.xsd) identifica el archivo de texto y quéhacer con el archivo cuando ya se han cargado los datos.

Para iniciar el agente, ejecute el archivo cqagent.jar en Java y pase el archivo deconfiguración TestAgent.xml como argumento de este modo:java -jar ...\cqagent.jar TestAgent.xml

Opcionalmente, puede identificar el directorio del archivo de configuración deregistro y el nivel de registro mediante la inclusión de propiedades de registro. Enel ejemplo siguiente se establece el nivel de registro para todos los mensajes:java "-Dcom.cognos.obi.property.Logging Directory=C:\logs\agents"

"-Dcom.cognos.obi.property.Detailed Log File Level=All"-jar ...\cqagent.jar TestAgent.xml

TestAgent.xmlEsta sección describe los atributos y elementos de configuración del archivoTestAgent.xml.

Tabla 13. Atributos de TestAgent.xml

Atributo Descripción

serverPort (atributo) (Opcional: 80 predeterminado) Puerto HTTP en el servidor deaplicaciones donde se están ejecutando servidores CognosReal-time Monitoring y que el agente utiliza para comunicarsecon el servidor. Es el mismo puerto que utilizan los usuariospara conectarse a Cognos Real-time Monitoring Workbench.

pingInterval (atributo) (Opcional: predeterminado 20 segundos) Con qué frecuencia elagente prueba para ver si el servidor Cognos Real-timeMonitoring se está ejecutando. Cuando el servidor no se estáejecutando, el agente no recopila eventos.


Tabla 13. Atributos de TestAgent.xml (continuación)


agentName (Obligatorio) Identifica a este agente y es el mismo nombre quese debe utilizar al crear el agente en la Consola deadministración. Este nombre debe ser exclusivo entre agentes.Para obtener información, consulte: “Espacio de nombres deobjeto” en la página 277.

serverHost (Obligatorio) Nombre de la máquina host que ejecuta losservidores de Cognos Real-time Monitoring. Si se estánejecutando en la misma máquina que el agente de archivo,especifique localhost como nombre.

agentImplClass (Obligatorio) Clase de implementación de agente. No cambieeste valor. Actualmente es obligatoriocom.cognos.obi.agent.FileAgent.

agentImplConfigFile (Obligatorio) Identifica el archivo de configuración para laimplementación (el componente de archivo de texto),normalmente FileAgent.xml. Para obtener más información,consulte: “FileAgent.xml” en la página 31.

agentPort (Obligatorio) Puerto utilizado para comunicarse con el agenteen el host. Utilizado para la comunicación con el agente porparte del servidor, para habilitar e inhabilitar los cambios deestado. Utilice cualquier número de puerto válido, como 5050.

pollingInterval (Obligatorio) Con qué frecuencia (en segundos) se deben buscarnuevos eventos.

loggingDirectory (Opcional: el valor predeterminado es el directorio del archivode configuración). Directorio en el cual registrar información dearchivo. El nombre del archivo de registro es agentName.log.

serverPath Especifique este atributo para apuntar al URL del servlet ffs.Puede que apunte al servidor de aplicaciones o al servidorweb. Si cqagent puede acceder al servidor web de aplicaciones,cambia a /realtime/ffs. Si utiliza la interfaz de servidor web,cambie a /cognos/realtime/ffs.

Ejemplo

El siguiente ejemplo nombra al agente de flujo de datos como "orderStatusEvent",identifica el archivo de configuración de implementación como FileAgent.xml yestablece el puerto de servidor en 8080:<?xml version="1.0" encoding="UTF-8" ?>

<VCAgent xmlns="http://cognos.obi.com/5"

xmlns:xsi="http://www.w3.org/2001/xmlSchema-instance"

xsi:schemaLocation="http://cognos.obi.com/5 VCAgent.xsd"

serverPort="80"

>

<agentName>flatFileEvent</agentName>

<serverHost>localhost</serverHost>

<agentImplClass>com.cognos.obi.agent.FileAgent</agentImplClass>

<agentImplConfigFile>FileAgent.xml</agentImplConfigFile>

<agentPort>5050</agentPort>

<pollingInterval>20</pollingInterval>

</VCAgent>


FileAgent.xmlEste archivo configura el componente de archivo de texto (la implementación) delagente de archivo.

El nombre y la ubicación del archivo se identifican en el archivo TestAgent.xml(consulte: “TestAgent.xml” en la página 29), y generalmente se encuentra en elmismo directorio que dicho archivo. Este archivo de configuración tiene cuatroelementos de configuración, aunque la mayoría de las configuraciones utilizan sólolos elementos <filename> y <fileDisposal>.

Elementos

El archivo tiene los siguientes elementos de configuración.

Tabla 14. Elementos de FileAgent.xml

Elemento Descripción

filename Nombre y ubicación del archivo de texto de origen que contiene loseventos. Se presupone que el archivo se encuentra en el mismodirectorio que el archivo de configuración, a menos que identifiqueotra ubicación en el nombre de archivo. Puede utilizarespecificaciones de ruta de archivo relativa o completa. Y el nombrede archivo puede incluir los caracteres * y ? como comodines. Ensistemas UNIX, utilice una barra inclinada para separar los nombresde rutas de directorio, como por ejemplo, data_streams/file*.txt. Ensistemas Microsoft Windows, utilice dos barras inclinadas invertidaspara separar nombres de ruta de directorio, comodata_streams\\file*.txt.

tipo Identifica el origen como archivo STREAM o FILE. Utilice FILEcuando deba cargarse automáticamente todo el archivo de texto(todo o nada), como para un archivo XML. De lo contrario, utiliceSTREAM para cargar líneas en lotes definidos por el elementobuffersize.

buffersize (Opcional: el valor predeterminado es 4.000+EOL). Recuento decaracteres que se deben almacenar en búfer o enviar por lotes alservidor. Utilice este valor para evitar cargar cantidades demasiadograndes de texto de una sola vez.

fileDisposal(Opcional). Especifica qué se debe hacer con el archivo de origentras cargar sus datos. Las opciones disponibles son el valorpredeterminado Eliminar, que suprime el archivo después de lacarga; Mover, que mueve el archivo a un directorio especificado porel atributo de destino, y Renombrar, que cambia el nombre delarchivo añadiendo el atributo de extensión al nombre de archivo.

Tanto la opción de mover como la opción de renombrarsobrescriben los archivos existentes del mismo nombre en laubicación de destino si avisar.

Ejemplo

En este ejemplo se identifica el archivo de texto de origen como orderStatusData.txten el subdirectorio data_stream\ de un host Windows, y mueve el archivoterminado al directorio hermano ..\done\:<?xml version="1.0" encoding="UTF-8" ?>

<FileAgent xmlns="http://cognos.obi.com/5"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"


xmlns:schemaLocation="http://cognos.obi.com/5 FileAgent.xsd">

<fileName>data_stream\\orderStatusData.txt</fileName>

<fileDisposal>

<move target="..\\done\\" />

</fileDisposal>

</FileAgent>

Agentes de sistema de archivosUn agente de sistema de archivos recupera datos de tabla de consulta de unarchivo de texto buscando archivos en una ubicación especificada y en un intervalodefinido. Cuando el agente localiza un archivo, recupera los datos de tabla deconsulta del archivo de origen.

Tabla 15. Inserción o extracción de agentes del sistema de archivos

Inserción de flujos dedatos

Extracción de flujos dedatos Extracción de tabla de consulta

No No Sí

Un agente de sistema de archivos tiene los atributos siguientes.

Tabla 16. Atributos de agente de sistema de archivos


Nombre Sí Identifica el agente. Este nombredebe ser exclusivo entre agentes.

Estado Sí Si el agente está habilitado(preparado para recibir datos) oinhabilitado (no preparado pararecibir datos).

Guardar en Sí La carpeta en la que ha dealmacenarse el agente. La carpetapredeterminada es Carpetaspúblicas. Para seleccionar unacarpeta, pulse el botón Seleccionarcarpeta.

Descripción No Descripción opcional que puedecontener cualquier carácter de texto.

Ruta del archivo raíz Sí Especifica la ruta al archivo de textoque debe utilizar el agente desistema de archivos.

Creación de un agente de sistema de archivosPuede crear un agente de sistema de archivos para recuperar datos de tabla deconsulta de un archivo de texto.

Procedimiento1. En IBM Cognos Real-time Monitoring Workbench, pulse la pestaña Workbench.2. Pulse Actividades.3. Seleccione Crear nuevo > Agente.4. Seleccione Sistema de archivos como tipo de agente.


5. Especifique el valor de los campos necesarios que definen los atributos para elagente.

6. Guarde el agente como habilitado.

Agentes de colas Java Messaging ServiceUn agente de cola de Java Messaging Service (JMS) se comunica con un productorde mensajes JMS a través de una cola JMS que se ejecuta en el entorno de servidorde aplicaciones.

El agente le dice al productor qué mensajes JMS debe enviar. A continuación, elproductor envía esos mensajes al flujo de datos a través del agente.

Los agentes de cola JMS son asíncronos, es decir, reciben mensajes de eventos amedida que suceden los eventos. No se pueden recuperar datos de tabla deconsulta de un agente de cola JMS.

Tabla 17. Inserción o extracción de agentes de colas JMS

Inserción de flujos dedatos

Extracción de flujos dedatos Extracción de tabla de consulta

Sí No No

Los agentes de cola JMS tienen los siguientes atributos:

Tabla 18. Atributos de agentes de colas JMS


Nombre Sí Identifica el agente. Este nombre debeser exclusivo entre agentes. Para obtenermás información, consulte: “Espacio denombres de objeto” en la página 277.

Estado Sí Si el agente está habilitado (preparadopara recibir datos) o inhabilitado (nopreparado para recibir datos).

Guardar en Sí La carpeta en la que ha de almacenarseel agente. La carpeta predeterminada esCarpetas públicas. Para seleccionar unacarpeta, pulse el botón Seleccionarcarpeta.

Descripción No Descripción opcional que puede contenercualquier carácter de texto.

Fábrica de conexionesde colas

Sí Identifica la fábrica de conexiones J2EEque mantiene la cola que se desea. Estacadena identifica la fábrica por sunombre de búsqueda JNDI, por ejemplo,jms.ManufacturingQueue. EspecifiqueCNowBusQueueConnectionFactoryJNDIen este campo. En un entorno OracleWebLogic, se identifica el nombre JNDIde fábrica en la Oracle WebLogicConsole, pestaña Services > JMS >Connection Factories > factoryName >General. En JBoss, el valorpredeterminado es ConnectionFactory.


Tabla 18. Atributos de agentes de colas JMS (continuación)


Modo deconfirmación

No Protocolo que debe utilizarse paraconfirmar la recepción del mensaje.

AUTO - El proveedor confirma larecepción del mensaje cuando se entrega(predeterminado).

CLIENT - Confirma la recepción delmensaje cuando el agente lo recibe.

DUPS OK - Dice al editor que escorrecto enviar un mensaje más de unavez. Las recepciones posteriores delmismo mensaje se tratan como eventosnuevos y exclusivos.

Nombre de usuario No Nombre de usuario que ha de utilizarsepara conectarse con la fábrica JMS.

Contraseña No Contraseña para el nombre de usuario.

Propiedades de JNDI No Propiedades opcionales de Java Namingand Directory Interface (JNDI) necesariaspara crear o mantener el agente en latabla JMS. Estos pares de nombre-valorle permiten especificar propiedades JMSreconocidas por JNDI.

Cuando se está ejecutando la cola JMSen un espacio de nombres distinto de losservidores Cognos Real-time Monitoring,defina las propiedades descritas en“Propiedades de JNDI para conectarse aun espacio de nombres remoto”.

Propiedades de JNDI para conectarse a un espacio denombres remoto

Cuando se está ejecutando la cola JMS en un espacio de nombres distinto de losservidores IBM Cognos Real-time Monitoring, debe definir las propiedades deJNDI para realizar la conexión.

Los nombres de estas propiedades de JNDI son:java.naming.factory.initial

java.naming.provider.url

Además, si está utilizando seguridad, defina también estas propiedades:java.naming.security.authentication

java.naming.security.principal

java.naming.security.credentials

Ejemplo para JNDI de Oracle WebLogicjava.naming.factory.initial=weblogic.jndi.WLInitiallookuptableFactory

java.naming.provider.url=t3://localhost:9180


Ejemplo para IBM Webspherejava.naming.factory.initial=com.ibm.websphere.naming.WsnInitiallookuptableFactory

java.naming.provider.url=iiop://localhost:9180

Ejemplo para JBOSSjava.naming.factory.initial=org.jnp.interfaces.NaminglookuptableFactory

java.naming.provider.url=jnp://localhost:1099

Ejemplo para LDAP de Sun One Directory Serverjava.naming.factory.initial=com.sun.jndi.ldap.LdapCtxFactory

java.naming.provider.url=ldap://ldap.mycompany.com:59226/dc=mycompany,dc=com

Asimismo, especifique como prefijo el valor del parámetro de Fábrica deconexiones de colas con: cn=

Creación de un agente de colas JMSPuede crear un agente de colas JMS para comunicarse con un productor demensajes JMS mediante una cola JMS que se ejecute en el entorno del servidor deaplicaciones.

Antes de empezar

Antes de crear un agente de colas JMS, necesita los elementos siguientes:v En el servidor de aplicaciones del host, debe desplegarse un bean controlado por

mensaje (MDB) personalizado, que tenga el nombre del flujo de datos codificadoen el archivo de propiedades y que reciba los mensajes de la cola.Los servidores de aplicaciones no admiten suscripciones dinámicas en colas JMS.Para esta finalidad debe crearse un MDB personalizado. Para obtener ayudapara crear y configurar este MDB, consulte los archivos README.txt incluidosen la carpeta de ejemplos, en el directorio <dir_instalación_c10>.

v Permiso de creación para los agentes. Para obtener más información, consulte:“Cómo otorgar permiso para crear objetos” en la página 294.

v La ubicación JNDI de la fábrica de conexiones de tema del servidor deaplicaciones que recibe los mensajes de la cola.

Procedimiento1. En IBM Cognos Real-time Monitoring Workbench, pulse la pestaña Workbench.2. Pulse Actividades.3. Seleccione Crear nuevo > Agente.4. Seleccione Cola JMS como tipo de origen.5. Cumplimente los campos obligatorios que definen los atributos necesarios.6. Guarde el agente como habilitado.

Agentes de tema JMSUn agente de tema de Java Messaging Service (JMS) se comunica con un productorde mensajes JMS a través de un tema JMS que se ejecuta en el entorno de servidorde aplicaciones.


El agente le dice al editor qué mensajes debe enviar. A continuación, el editor envíaesos mensajes al flujo de datos a través del agente.

Los agentes de tema JMS son asíncronos y reciben mensajes de eventos a medidaque suceden los eventos. Como se muestra en la tabla siguiente, no se puedenrecuperar datos de tabla de consulta de un agente de temas JMS.

Tabla 19. Inserción o extracción de agente de temas JMS

Inserción deflujos de datos

Extracción deflujos de datos Extracción de tabla de consulta

Sí No No

Un agente JMS tiene los atributos que se describen en esta tabla:

Tabla 20. Atributos de agente de temas JMS


Nombre Sí Identifica el agente. Este nombre debe ser exclusivoentre agentes. Para obtener más información sobrelos nombres de objeto, consulte: “Espacio denombres de objeto” en la página 277.

Estado Sí Si el agente está habilitado (preparado para recibirdatos) o inhabilitado (no preparado para recibirdatos).

Guardar en Sí La carpeta en la que ha de almacenarse el agente. Lacarpeta predeterminada es Carpetas públicas. Paraseleccionar una carpeta, pulse el botón Seleccionarcarpeta.

Descripción No Descripción opcional que puede contener cualquiercarácter de texto.

Fábrica deconexiones detemas

Sí Identifica la fábrica de conexiones J2EE quemantiene los temas que se desean. Esta cadenaidentifica la fábrica por su nombre de búsquedaJNDI, por ejemplo jms.ManufacturingTopic.jms.ManufacturingQueue. EscribaCNowBusTopicConnectionFactoryJNDI en estecampo. En un entorno Oracle WebLogic, se identificael nombre JNDI de fábrica en la Oracle WebLogicConsole, pestaña Services > JMS > ConnectionFactories > factoryName > General. En JBoss, elvalor predeterminado es ConnectionFactory.

Modo deconfirmación

No Protocolo que debe utilizarse para confirmar larecepción del mensaje.

El valor predeterminado es AUTO, donde elproveedor confirma la recepción del mensaje cuandose entrega; CLIENT, que confirma la recepción delmensaje cuando el agente lo recibe; y DUPS OK,que le dice al editor que es correcto enviar unmensaje más de una vez. Las recepciones posterioresdel mismo mensaje se tratan como eventos nuevos yexclusivos.

Nombre deusuario

No Nombre de usuario que ha de utilizarse paraconectarse con la fábrica JMS.

Contraseña No Contraseña para el nombre de usuario.


Tabla 20. Atributos de agente de temas JMS (continuación)


Propiedades deJNDI

No Propiedades opcionales de Java Naming andDirectory Interface (JNDI) necesarias para crear omantener el agente en la tabla JMS. Estos pares denombre-valor le permiten especificar propiedadesJMS reconocidas por JNDI. Cuando se estáejecutando el tema JMS en un espacio de nombresdistinto de los servidores Cognos Real-timeMonitoring, defina las propiedades que se describenen el apartado “Propiedades de JNDI paraconectarse a un espacio de nombres remoto” en lapágina 34.

Creación de un agente de temas JMSPuede crear un agente de temas JMS para comunicarse con un productor demensajes JMS mediante un tema JMS que se ejecute en el entorno del servidor deaplicaciones.

Antes de empezar

Antes de crear un agente, necesita los elementos siguientes:v En el servidor de aplicaciones del host, debe desplegarse un bean controlado por

mensaje (MDB) personalizado, que tenga el nombre del flujo de datos codificadoen el archivo de propiedades y que se suscriba al tema.Los servidores de aplicaciones no admiten suscripciones dinámicas en temasJMS. Para esta finalidad debe crearse un MDB personalizado.

v Permiso de creación para los agentes. Para obtener más información, consulte:“Cómo otorgar permiso para crear objetos” en la página 294.

v La ubicación JNDI de la fábrica de conexiones de tema del servidor deaplicaciones que publica los temas.

Procedimiento1. En IBM Cognos Real-time Monitoring Workbench, pulse la pestaña Workbench.2. Pulse Actividades.3. Seleccione Crear nuevo > Agente.4. Seleccione Tema JMS como origen de datos.5. Especifique el valor de los campos necesarios que definen los atributos para el

agente.6. Guarde el agente como habilitado.

Agentes TIBCO RendezvousLos agentes TIBCO Rendezvous se comunican con un daemon TIBCO Rendezvousque se ejecuta en el entorno del servidor de aplicaciones. El daemon escuchamensajes de una secuencia de mensajes de TIBCO Rendezvous.

Cuando el daemon encuentra un mensaje solicitado por una de las tablas deTIBCO Rendezvous (consulte: “Tablas de TIBCO Rendezvous” en la página 345),recupera los datos del mensaje y los transmite a la tabla a través del agente.


Los agentes de TIBCO Rendezvous son asíncronos y reciben mensajes de eventos amedida que suceden los eventos, tal como se muestra en la tabla siguiente. No sepueden recuperar datos de tabla de consulta de un agente de TIBCO Rendezvous.

Tabla 21. Inserción o extracción de agentes TIBCO Rendezvous



Sí No No

AtributosEsta sección proporciona información sobre los atributos de un agente de TIBCORendezvous.

Tabla 22. Atributos de agente TIBCO Rendezvous


Nombre Sí Identifica el agente. Este nombre debe ser exclusivo entreagentes. Para obtener más información, consulte: “Espacio denombres de objeto” en la página 277.

Estado Sí Si el agente está habilitado (preparado para recibir datos) oinhabilitado (no preparado para recibir datos).

Guardar en Sí La carpeta en la que ha de almacenarse el agente. La carpetapredeterminada es Carpetas públicas. Pulse Seleccionar carpetapara seleccionar una carpeta.

Descripción No Descripción opcional que puede contener cualquier carácter detexto.

Servicio No Puerto de servicio de TIBCO Rendezvous. Para utilizar el puertopredeterminado 7500, déjelo en blanco. Cambie este valor sólo sisu administrador de TIBCO Rendezvous le proporciona otropuerto.

Red Sí Identifica la interfaz de red que se debe utilizar cuando el hostestá conectado a más de una red, o cuando el host soportamultidifusión (en cuyo caso la dirección tendrá un aspectosimilar a éste: ;222.1.2.3). Cambie este valor sólo cuando lamáquina de host no se encuentre en la red predeterminada; enese caso, utilice la dirección IP que le proporcione suadministrador de TIBCO Rendezvous.

Daemon No Puerto del daemon de direccionamiento del host TIBCORendezvous, que se encuentra en la red y viene identificado porel atributo de red. Para utilizar el puerto predeterminado 7500,déjelo en blanco. Cambie este valor sólo si su administrador deTIBCO Rendezvous le proporciona otro puerto.

Creación de un agente TIBCO RendezvousEn esta sección se describe cómo crear un agente para que se comunique con undaemon TIBCO Rendezvous que se ejecuta en el entorno del servidor deaplicaciones.

Antes de empezar

Antes de crear un agente, debe:v Asignar permisos de creación para agentes. Para obtener más información,

consulte: “Cómo otorgar permiso para crear objetos” en la página 294.


v Conectarse con el daemon de escucha TIBCO Rendezvous.

Para conectarse, necesita los nombres del servicio, de la red y del daemon. Paraconocer valores específicos, consulte al especialista de TI que realiza elmantenimiento del sistema TIBCO Rendezvous.

Procedimiento1. En IBM Cognos Real-time Monitoring Workbench, pulse la pestaña Workbench.2. Pulse Actividades.3. Pulse Crear nuevo > Agente.4. Seleccione TIBCO Rendezvous como tipo de origen.5. Especifique el valor de los campos que definen los atributos para el agente.6. Guarde el agente.

Agentes de servicio webLos agentes de servicio web se comunican con una aplicación que se ejecuta en unservidor de aplicaciones web para recuperar datos de tabla de consulta. El agentese conecta con la aplicación a través de una conexión HTTP mediante Protocolo deacceso a objetos simple (SOAP).

Los agentes de servicio web son síncronos. Recuperan datos de tabla de consultacomo resultado de una solicitud específica.

Tabla 23. Inserción o extracción de agente de servicio web



Sí No Sí

Atributos de agentes de servicio webEsta sección proporciona información sobre los atributos de un agente de servicioweb.

Tabla 24. Atributos de agentes de servicio web


Nombre Sí Identifica el agente. Este nombre debe ser exclusivo entreagentes. Para obtener más información, consulte: “Espacio denombres de objeto” en la página 277.

Estado Sí Si el agente está habilitado (preparado para recibir datos) oinhabilitado (no preparado para recibir datos).

Guardar en Sí La carpeta en la que ha de almacenarse el agente. La carpetapredeterminada es Carpetas públicas. Para seleccionar unacarpeta, pulse el botón Seleccionar carpeta.

Descripción No Descripción opcional que puede contener cualquier carácter detexto.

URL Sí Ubicación HTTP del archivo de lenguaje de definición deservicio web (WSDL) que define el servicio que se deseautilizar. Los datos que se devuelven deben ser un mensaje deestilo de documento SOAP; no se soporta el enlace RPC.


Tabla 24. Atributos de agentes de servicio web (continuación)


Nombre deusuario

No (Opcional) Nombre de usuario para usar al conectarse alservicio. Este parámetro se transmite al servidor cuando elservidor requiere un nombre de usuario.

Contraseña No (Opcional) Contraseña de usuario para usar al conectarse alservicio. Este parámetro se transmite al servidor cuando elservidor requiere una contraseña.

Creación de un agente de servicio webPuede crear un agente de servicio web para comunicarse con una aplicación que seejecute en un servidor de aplicaciones para recuperar datos de tabla de consulta.

Antes de empezar

Antes de crear un agente de servicio web, debe:v Asignar permisos de creación para agentes. Para obtener información, consulte:

“Cómo otorgar permiso para crear objetos” en la página 294.v Conocer la ubicación HTTP del archivo de lenguaje de definición de servicio

web (WSDL) que define el servicio que se desea utilizar. El servicio debe utilizarenlaces SOAP para poder publicar datos. Los enlaces RPC no reciben soporte.

Procedimiento1. En IBM Cognos Real-time Monitoring Workbench, pulse la pestaña Workbench.2. Pulse Actividades.3. Seleccione Crear nuevo > > Agente.4. Seleccione Servicio web como tipo de agente.5. Especifique el valor de los campos que definen los atributos para el agente.6. Guarde el agente como habilitado.


Capítulo 5. Alertas

Las alertas son notificaciones de incidencias excepcionales enviadas a usuarios osistemas externos.

Una alerta puede ser un simple mensaje que indique un incidente. Una alertatambién puede incluir más detalles, como por ejemplo, información sobre la causadel incidente y posibles soluciones.

Una alerta puede ser independiente o estar asociada con una regla. También puedeser un clon de una alerta existente.

Un mensaje de alerta contiene texto que describe el incidente excepcional alsuscriptor. Este texto aparece en la pestaña Workbench y en cualquier otrodispositivo identificado por el perfil de entrega del suscriptor. La forma derepresentar el mensaje depende del dispositivo que lo muestra al suscriptor.

Creación de una alerta independienteEn IBM Cognos Real-time Monitoring Workbench, puede crear una alertaautónoma que no esté asociada con ninguna regla.

Antes de empezar

Para crear una alerta, necesita los permisos siguientes:v Permisos de creación de actividades empresariales. Para obtener información,

consulte: “Cómo otorgar permiso para crear objetos” en la página 294.v Permisos de lectura y escritura para la actividad empresarial que contiene la

alerta.v Permisos de sólo lectura para la vista o cubo que proporciona información para

la alerta.

Procedimiento1. En Modelador de escenarios, seleccione una actividad empresarial existente.2. En el panel Objetos del sistema, seleccione un escenario existente para que

contenga la alerta.3. Seleccione la pestaña Alertas.4. Pulse Nueva alerta.5. Seleccione el origen de datos que proporciona información para la alerta.

v Si el escenario tiene una vista predeterminada, ese escenario apareceráseleccionado. Seleccione otro origen para su supervisión pulsando enSeleccionar origen de datos.

v Para una vista, seleccione la vista.v Para un cubo, seleccione el nivel de dimensión en un cubo. Opcionalmente,

también puede aplicar un filtro que restrinja aún más los datos que el cuboproporciona para la alerta.

v Si el origen contiene datos, esos datos aparecerán para proporcionar unejemplo de lo que ha de esperarse. Cuando el origen está vacío, el formulariosólo visualiza los nombres de las columnas y el mensaje No hay datosdisponibles.


6. Especifique el valor de los campos de la ventana Crear alerta:v Nombre de la alerta

v Descripción (opcional)v Gravedad

v Suscriptores

Utilice el botón Agregar/Eliminar para seleccionar los usuarios y roles comosuscriptores de este evento. Pueden ser Destinatarios obligatorios oDestinatarios opcionales.

v Asunto

Utilice el botón Agregar campo para insertar campos en la línea del asuntode esta alerta. Son campos que insertarán valores reales en la alerta.

v Cuerpo (opcional)Utilice este campo para crear un mensaje de alerta para los suscriptores deesta alerta. Puede utilizar los botones Agregar campo, Agregar reportlet yAgregar confirmación para construir un mensaje con datos relacionados.

Creación de una alerta asociada a una reglaPuede crear una alerta asociada con una regla, en lugar de estar asociada a unaalerta autónoma.

Antes de empezar

Para crear una alerta, necesita los permisos siguientes:v Permisos de creación de actividades empresariales. Para obtener información,

consulte: “Cómo otorgar permiso para crear objetos” en la página 294.v Permisos de lectura y escritura para la actividad empresarial que contiene la

alerta.v Permisos de sólo lectura para la vista o cubo que proporciona información para

la alerta.

Procedimiento1. Siga las instrucciones de la sección “Creación de reglas” en la página 317.2. En la pestaña Básico, pulse Seleccionar.3. En la ventana Seleccionar alerta, seleccione una alerta o pulse Crear alerta para

crear una.

Clonación de una alerta existentePuede clonar una alerta existente para ahorrarse tiempo y esfuerzos.

Procedimiento1. Copie la definición de una alerta existente en una nueva alerta.2. Edite la alerta que desea clonar.3. Cambie el nombre de la alerta y otros atributos que sean distintos de los de la

alerta original.4. Seleccione Guardar como nueva alerta.


Atributos de alertaSe puede modificar la configuración de notificación que controla el númeromáximo de alertas que se pueden enviar dentro de un intervalo de tiempoespecificado.

Para obtener más información, consulte el tema sobre cómo definir limitaciones denotificaciones de alerta en la publicación IBM Cognos Real-time MonitoringWorkbench Guía del usuario.

Todas las alertas tienen los atributos de la lista siguiente:

Nombre de la alertaIdentifica el objeto de alerta. El nombre puede contener sólo letras ynúmeros. Este nombre debe ser exclusivo entre alertas dentro del mismoescenario. Para obtener información, consulte: “Espacio de nombres deobjeto” en la página 277.

EstadoEspecifica si la regla está habilitada (recibiendo nueva información de flujode datos) o inhabilitada. Cuando el escenario que la contiene estáinhabilitado, no se puede habilitar la alerta. El escenario debe habilitarseantes de poder habilitar la alerta.

GravedadSugerencia sobre la importancia de un mensaje. Los valores son HIGH,NORMAL (predeterminado) o LOW. Los mensajes que llegan a Real-timeMonitoring Dashboard se clasifican por carpetas que se corresponden conel nivel de importancia. Además, los mensajes de correo electrónico semarcan de acuerdo con el campo de cabecera de correo "Importancia"según los estándares de correo.

DescripciónDescripción opcional que puede contener cualquier carácter de texto.

Origen de datosVista o nivel de dimensiones de cubo que define las columnas de la alerta.Debería tener el mismo origen que la regla asociada, o uno derivado de eseorigen; de otro modo, puede que la alerta generada no contengainformación válida.

SuscriptoresUsuarios que reciben la alerta. Para obtener información, consulte:“Suscriptores de alertas” en la página 44.

AsuntoMensaje de texto que es el asunto de la alerta, parecido a una línea deasunto de correo electrónico. Puede contener referencias de columna a lavista empresarial subyacente.

CuerpoMensaje de texto que es el cuerpo de la alerta. Puede contener referenciasde columna a la vista empresarial subyacente, y puede contenerconfirmaciones y reportlets. Para obtener más detalles acerca de lasconfirmaciones, consulte la publicación IBM Cognos Real-time MonitoringWorkbench Guía del usuario. Para obtener más información sobre losreportlets, consulte: Capítulo 26, “Reportlets”, en la página 309.

Capítulo 5. Alertas 43

Texto del asunto y el cuerpo del mensajeCada mensaje de alerta emplea texto para describir la incidencia excepcional alsuscriptor.

Este es el texto que aparece en IBM Cognos Real-time Monitoring Workbench, IBMCognos Real-time Monitoring Dashboard y en cualquier otro dispositivoidentificado por el perfil de entrega del suscriptor. La forma de representar elmensaje depende del dispositivo que lo muestra al suscriptor.

Los atributos de alerta del asunto y el cuerpo definen el texto del mensaje. Cadaatributo contiene texto estático y campos. Cuando la alerta genera el mensaje,sustituye los campos por los valores de las columnas que tienen el mismo nombreen la fila de la vista empresarial que ha causado la alerta.

Por ejemplo, observe esta definición de mensaje predeterminado:

Asunto: AVISO -- Un cliente ha abierto un tíquet de problema. Cuerpo:CUST_NAME es un cliente de ALTO nivel y ha abierto el tíquet de problemanúmero TICKET.

Cuando la alerta se activa, genera un mensaje parecido al siguiente:

Puede incluir cualquier código HTML válido en el cuerpo del mensaje. Si deseahacer referencia a un objeto externo, como un gráfico, hágala a un servidor HTTP,no a un archivo local, porque no se incluirá en el mensaje.

Suscriptores de alertasAl definir una alerta, también puede indicar uno o varios usuarios que recibirán lanotificación de alerta.

Mediante el botón Agregar/Eliminar que aparece junto a la lista de subscriptoresdel editor de alertas, puede designar los usuarios individuales y roles que debenrecibir la alerta. También puede identificar las columnas de la vista de la alerta queproporcionan listas de usuarios, roles o direcciones de correo electrónico pararecibir la notificación.

La ventana Suscriptores de alerta tiene dos pestañas: una para suscripcionesindividuales y otra para subscripciones controladas por datos.

En la pestaña Suscripción individual debe seleccionar los usuarios que van arecibir la notificación.

De: IBM Cognos Real-time MonitoringFecha: 3/05/2007 07:45 PMAsunto: Aviso -- Un cliente ha abierto un tíquet de problema

Acme Works es un cliente de alto nivel que ha abierto el tíquet deproblema número 0703.

Figura 2. Mensaje de una alerta activada


v Los suscriptores obligatorios siempre reciben la notificación. Estos usuarios nopueden anular la suscripción de la alerta de forma voluntaria en IBM CognosReal-time Monitoring Dashboard. Deben eliminarse de la pestaña Suscripciónindividual.

v Los suscriptores opcionales reciben notificaciones, pero pueden anular lasuscripción mediante Cognos Real-time Monitoring Dashboard.

La pestaña Suscripción controlada por datos permite identificar las columnas de lavista que contienen los nombres o direcciones de los usuarios o roles que debenrecibir la notificación. Una columna de la vista puede contener una lista deusuarios y roles o bien una lista de direcciones de correo electrónico que recibiránlas notificaciones. Cada lista de valores de una columna está separada por unacoma o un punto y coma, y cada elemento puede estar entre comillas (").Seleccione la columna que se debe utilizar en las listas desplegables Destinatarioscontrolados por datos (usuario o rol) y Destinatarios controlados por datos(direcciones de correo electrónico).

Las suscripciones controladas por datos son obligatorias: los usuarios, roles ydirecciones de correo electrónico que las reciben no pueden anular la suscripción.Los usuarios que reciben estas suscripciones como resultado de una lista dedirecciones de correo electrónico no las ven en la lista de suscripciones deReal-time Monitoring Dashboard. Cuando la columna contiene varias instancias dela misma dirección de correo electrónico, sólo se envía un mensaje. Sin embargo, sihay pequeñas diferencias en las entradas, se generará un mensaje para cadainstancia. Por ejemplo, estas dos variaciones de la misma direcció[email protected] y "Nombre" <[email protected]> generarán dos mensajes.

Gestión de mensajes de notificación de alertaLas alertas permanecen en la lista del gestor de alertas hasta que el usuario laselimina manualmente o el sistema las elimina automáticamente.

El sistema elimina los mensajes después del número de días especificado por eladministrador del sistema en la ventana Valores del sistema, como se describe enlas secciones sobre los valores del sistema en la publicación IBM Cognos Real-timeMonitoring Workbench Guía del usuario.

De igual forma, puede controlar el número máximo de alertas que pueden enviarsedentro de un intervalo de tiempo especificado. Para obtener más información,consulte el tema sobre cómo definir limitaciones de notificaciones de alerta en lapublicación IBM Cognos Real-time Monitoring Workbench Guía del usuario.

Los usuarios reciben notificaciones de alerta en los dispositivos identificados porsus perfiles de entrega en la pestaña Perfiles de entrega (consulte: “Pestaña Perfilesde entrega” en la página 354).

Para obtener información sobre cómo utilizar el gestor de alertas en IBM CognosReal-time Monitoring Dashboard para ver, suprimir y suscribirse a notificaciones,consulte "Interacción con alertas" en la documentación del panel de control.

Estados de alertaIBM Cognos Real-time Monitoring proporciona dos tipos de alerta: sin estado ycon estado.


Las alertas sin estado son notificaciones puntuales relativas a la condiciónempresarial cuando se cumple la condición.

Las alertas sin estado se envían cuando se cumple la condición de regla. Porejemplo, una alerta sin estado puede enviar una notificación a un director dealmacén cuando un recuento de inventario de producto dé como resultado unvalor inferior a un umbral específico. Tenga en cuenta que cada cambio posterioren los niveles de inventario para ese producto hará que se envíe otra notificaciónsiempre que el recuento de inventario permanezca por debajo del umbral.

Para las alertas con estado, se crea o se confirma el estado siempre que se cumplela condición de negocio, y se cancela cuando la condición ya no existe.

Con una alerta con estado, los directores de almacén reciben la alerta cuando elinventario está por debajo del umbral, y no vuelven a recibir otra hasta que secancela la alerta, probablemente cuando los niveles de inventario se han restauradopor encima del umbral. Cuando hay varias partes interesadas en una alerta, una deellas puede elegir gestionar la alerta emitida y confirmarla. Para ello, debe pulsarseel enlace Confirmar del cuerpo del mensaje. El creador de la alerta coloca el enlaceen el cuerpo del mensaje cuando crea la alerta. Para obtener más información,consulte el tema acerca de las confirmaciones en la publicación IBM CognosReal-time Monitoring Workbench Guía del usuario.

Mediante la combinación de una alerta con estado y un periodo de tiempo"Corresponde a", puede retardar la notificación. Por ejemplo, para advertir algestor del almacén de datos solamente si el recuento de inventario de un productoha permanecido por debajo de un umbral determinado durante un día, lacondición de la alerta corresponde a un día. En este caso, el director no recibe lanotificación si el inventario cae por debajo del umbral pero se repone ese mismodía.

Escalamiento de alertasPuede supervisar el estado de la alerta y generar nuevas alertas si las condicionesasí lo requieren.

Por ejemplo, si una alerta no se ha gestionado de forma oportuna, puede enviarseuna nueva alerta a los usuarios de un nivel superior de la organización con el finde escalar la alerta original. Para comprobar estos estados, utilice la funciónIS_RAISED (consulte: “IS_RAISED” en la página 164). Para obtener información,consulte: “Reglas que supervisan alertas” en la página 321.

Emitida Confirmar

Reducida

Emitida Reducir

Confirmar

Reducir

Figura 3. Estados de alerta


Consolidación de mensajes múltiplesLos eventos pueden contener varias filas de información. Cuando el evento cumpleuna condición de regla, la regla genera una alerta para cada fila del evento.

Con frecuencia es conveniente enviar únicamente un mensaje que describa todaslas alertas. Esto se denomina alerta consolidada.

Por ejemplo, se va a entrar una orden de compra en el sistema (un evento). Si lacantidad de elementos en stock no basta para responder a la orden, se podríagenerar una alerta para anotar esta condición. Cuando varios elementos de línea enla orden no cuentan con un inventario suficiente, cada elemento genera una alertanueva. Para enviar una sola notificación en lugar de varias, utilice una alertaconsolidada.

Procedimiento

En la ventana Crear regla, seleccione la opción Consolidar varios mensajes desdeel mismo evento.

Establecimiento de una alerta para invocar a un servicio web externoPara configurar un mensaje de alerta para invocar a un servicio web externo, debecrear una función Java empaquetada que construya el mensaje de servicio webbasándose en el contenido de la alerta.

Esta función determinará qué elementos de datos del contenido de la alerta han decorrelacionarse con las entradas que el servicio web espera.

Se carga en IBM Cognos Real-time Monitoring en forma de función definida por elusuario (UDF). El servicio web se especifica en un perfil de servicio web que llamaa la UDF. A continuación, el perfil de servicio web puede establecerse comosuscriptor de la alerta que desee.

La creación de esta función requiere disponer de amplios conocimientos yexperiencia en programación. Para obtener más información, consulte: “Funcióndefinida por el usuario del servicio web” en la página 48.

Procedimiento1. Cree una alerta nueva.

No suscriba usuarios a la nueva alerta. Añadirá los suscriptores posteriormente.2. Cree una función que construya el mensaje de servicio web utilizando partes de

los datos de la alerta y empaquete éste como un archivo JAR.Para obtener más información, consulte: “Función definida por el usuario delservicio web” en la página 48.

3. Cargue el archivo JAR como una función definida por el usuario enWorkbench.Para obtener más información, consulte: “Creación y uso de una funcióndiseñada por el usuario” en la página 358.

4. Cree un nuevo usuario y guárdelo.Debe crear y guardar el nuevo usuario para poder cambiar las propiedades delperfil de panel de control predeterminado.

5. Edite el nuevo usuario como se indica a continuación:


v En la ventana Editar usuario, pulse la pestaña Perfiles de entrega.v Abra el perfil de panel de control predeterminado.v Elimine la selección de la opción Agregar automáticamente este perfil.v Pulse Aceptar.

6. Para el nuevo usuario, cree un perfil de entrega, tal como se indica acontinuación:v En la ventana Editar usuario, seleccione la pestaña Perfil de entrega.v Pulse Crear nuevo perfil.v En la ventana resultante, para Tipo de perfil, seleccione Servicio web.v Para Nombre del perfil, especifique un valor adecuado.v Para URL del servicio web, especifique el punto final para el WSDL.v Para Método, especifique el método (operación) que desee que se invoque en

el servicio web.v Especifique el Nombre de usuario y la Contraseña, según proceda.v Para UDF, seleccione el archivo JAR que ha cargado para esta invocación de

servicio web.v Asegúrese de que la opción Agregar automáticamente este perfil no está

seleccionada.v Pulse Aceptar.

7. Vuelva a la configuración para la alerta que ha creado en el paso 1.8. Añada el usuario que acaba de crear como suscriptor.9. Pulse Guardar.

Cuando se active la alerta, se invocará al servicio web.

Función definida por el usuario del servicio webEsta función recibe como entrada un elemento DOM que describe los datos dealerta generados por IBM Cognos Real-time Monitoring y que cumple conalertMessage.xsd. La salida generada es un mensaje AXIS que contiene el SOAPque se envía al servicio web.

La función que se cree debe ampliar la clasecom.cognos.obi.api.function.webservice. IAlertWSMessageConstructor.

Interfaz com.cognos.obi.api.function.webservice.IAlertWSMessageConstructor:package com.cognos.obi.api.function.webservice;

import com.cognos.obi.api.function.*;

import org.apache.axis.Message;

import org.w3c.dom.Element;

import java.lang.Exception;

public interface IAlertWSMessageConstructor extends IUDFunction

{

public Message constructMessage(Element alertData, StringwsdlURI,

String soapOperation) throws Exception;

}


Adición de reportlets a una notificación de alertaLos reportlets describen el contenido de una vista y presentan esa información enun informe que está asociado a un mensaje de alerta.

Los reportlets ofrecen información sobre un incidente que permite poner dichoincidente en contexto.

Las alertas que se muestran en el panel de control de operaciones incluyen elreportlet como tabla HTML en línea. La opción Enviar como especifica el formatodel reportlet que se adjuntará a la notificación de alerta que se envía a los perfilesde suscripción de los usuarios. El reportlet se puede incrustar en el cuerpo delmensaje o se puede incluir como archivo adjunto en uno de los formatosdisponibles.

Procedimiento1. Abra la ventana Agregar reportlet.2. Seleccione el reportlet de la lista y pulse Aceptar para añadirlo a la alerta.

Filtro de reportletCuando se crea el reportlet, se identifica la vista o el cubo del que obtienen losdatos el reportlet. Sin embargo, los datos que aparecen en el reportlet dependendel tipo de origen, con estados o sin estados, y de cómo se filtran las filas de datos.

Se especifica cómo se filtran las filas de datos en el cuadro Agregar reportlet. Engeneral, las siguientes opciones afectan a cómo se filtran los datos:v La opción Datos de reportlet basados en especifica si el origen completo de un

reportlet debe incluir datos basados en todos los eventos, o sólo aquellos quehan cumplido la condición de regla.

v La opción Los datos de reportlet son limita si las filas del origen del reportletincluyen sólo las relacionadas con el evento que activó la alerta, o todos losdatos de evento anteriores también en el origen.

Para comprender mejor cómo afectan estos valores a los datos de reportlet, observeestas dos vistas que realizan seguimientos e informes sobre los pedidos deproducto. La vista sin estados OrderDetails es un resumen de cada evento depedido, mientras que la vista completa OrderAggregates realiza un seguimientodel promedio de cantidad para cada producto solicitado.

Observe los siguientes eventos:

SELECT prod_name, AVG (ord_qty), COUNT(*) AS Ct FROM OrderDetailsGROUP BY prod_name

SELECT prod_name, ord_qty FROM OrderEvent,Product WHERE OrderEvent.prod_id= Product.prod id SEND ALERT BigOrder

WHEN ord_qty>3000

OrderAggregates

OrderDetails

ProductOrderEvent

Vista de reglas

Vista de Reportlets


prod_name ord_qty

--------- -------

nails 1000

plywood 1000

nails 4000

nails 4000

plywood 5000

Una vez que el evento ha entrado en el flujo de datos, la vista OrderAggregatescontiene estos valores:prod_name AVG(ord_qty) Ct

--------- ----------- --

nails 3000 3

plywood 3000 2

De forma predeterminada, un reportlet que utiliza la vista OrderAggregatesmuestra los detalles para ambos productos, independientemente de qué evento deproducto haya generado la alerta. Aunque sólo los tres últimos eventos cumplen lacondición de regla de ord_qty mayor que 3.000, el reportlet muestra los resultadosde todos los eventos, lo cual puede no ser lo que se pretendía.

Las dos opciones de filtro del cuadro Agregar reportlet alteran los resultadosfiltrando los resultados que aparecen en el reportlet.

La opción Los datos de reportlet son hace que el reportlet muestre los datossiguientes:v Todos los datos de su vista o cara de cubov Sólo los datos relacionados con el evento encontrado por la regla

Para mostrar sólo el evento con los datos relacionados, se debe definir la relaciónentre los orígenes del evento y el reportlet. Por ejemplo, si desea que el reportletmuestre sólo el resultado para "products" en ambas vistas, defina la relacióndiscriminando la columna prod_name de ambas vistas. Esto le indica al reportletque muestre sólo las filas de la vista OrderAggregates cuyo valor prod_namecoincida con el nombre de la vista OrderDetails. A continuación, el reportletmuestra el valor de nails sólo cuando la regla genera la alerta.prod_name AVG(ord_qty) Ct

--------- ----------- --

nails 3000 3

Al trabajar con una cara de cubo, se discriminan las columnas que mejoridentifican el evento para el reportlet.

Datos de reportlet basados en opciónEsta opción especifica si una vista completa debe incluir datos basados en todoslos eventos, o sólo aquellos que han cumplido la condición de regla.

Según el ejemplo de “Filtro de reportlet” en la página 49, la columna AVG(ord_qty)de la vista OrderAggregates tiene un valor de 3.000 para "nails" una vezprocesados ambos eventos. Es lo que ocurre cuando el valor de esta opción esDatos de flujo de datos. Sin embargo, la condición de regla indica que se genereuna alerta sólo cuando la cantidad de pedido es mayor que 3.000. Para realizar unseguimiento sólo de eventos que cumplen la condición de regla, cambie el valor


para esta opción a Filtro de regla de datos de flujo de datos. Entonces, el reportletmuestra un promedio de 4.000 porque 4.000 es el promedio de los dos eventosmayores que 3.000.

Las siguientes ilustraciones muestran los resultados de la vista en los datos deejemplo cuando se utilizan las dos opciones de filtro de reportlet. Tenga en cuentaque el primer evento no pasa el filtro de regla, y no aparece en esas vistas.

Del mismo modo, el segundo evento tampoco pasa el filtro de regla. Tenga encuenta que la vista que muestra datos relacionados con eventos ahora sólo incluyeel evento plywood.

Datos de flujo dedatos

Todos los datos en la vistade reportle

Solo los datos relacionadoscon el suceso (prod_name)

Filtro de reglas dedatos de flujo de datos(ord_qty>3000)

prod_name ord_qty Ct-------- --------- --nails 1000 1


prod_name ord_qty Ct-------- --------- --


prod_name ord_qty Ct-------- --------- --nails 1000

Sucesos

Figura 4. Visualización de los resultados sobre los datos de ejemplo


Todos los datos en la vistade reportlet

Solo los datos relacionadoscon el suceso (prod_name)

Filtro de reglas dedatos de flujo dedatos(ord_qty>3000)

prod_name ord_qty Ct-------- --------- --nails 1000 1plywood 1000 1

prod_name ord_qty Ct-------- --------- --plywood 1000 1



prod_name ord_qty Ct-------- --------- --nails 1000plywood 1000

Sucesos



El tercer evento ahora pasa el filtro de regla y aparece en las vistas inferiores. Unavez más, "nails" es el producto en el evento relacionado con las vistas.

El cuarto evento "nails" también pasa el filtro de regla.

El evento final de nuevo cambia el evento relacionado con las vistas. Debe tener encuenta que todos los eventos se reflejan en una vista, mientras que en la vista defiltro de regla sólo se muestran los que han pasado el filtro de la regla.


Todos los datos de la vista del reportlet

Solo los datos relacionadoscon el evento (prod_name)

Filtro de reglas delos datos de flujode datos(ord_qty>3000)





prod_name ord_qty Ct-------- --------- --nails 1000plywood 1000nails 4000

Sucesos



Todos los datos ev la i rsta del peSoptlet

colo los datos pelanrovadosnov el ei evto (prod_name)

Frltpo de peglas delos datos de flujode datos(ord_qty>3000)


prod_name ord_qty Ct-------- --------- --plywood 3000



prod_name ord_qty Ct-------- --------- --nails 1000plywood 1000nails 4000varls 4000

cunesos




Todos los datos en la vista del reportlet

Solo los datos relacionados con el suceso(pr od_name )

Filtro de reglas delos datos de flujode datospdo_nqty>3000

r od_name ) ((((((do_nqty((((((Ct--------(((((((((((((((---------(((((((--amils(((((((((((((((((3000((((((((((3r ly2 dd_((((((((((((3000((((((((((5

r od_name ) ((((((do_nqty((((((Ct--------(((((((((((((((---------(((((((--r ly2 dd_((((((((((((3000((((((((((5

r od_name ) ((((((do_nqty((((((Ct--------(((((((((((((((---------(((((((--r ly2 dd_((((((((((((w000((((((((((1

r od_name ) ((((((do_nqty((((((Ct--------(((((((((((((((---------(((((((--amils((((((((((((((((((4000(((((((((5r ly2 dd_(((((((((((((w000((((((((1(

r od_name ) ((((((do_nqty((((((Ct--------(((((((((((((((---------(((((((--amils((((((((((((((((((1000r ly2 dd_(((((((((((((1000amils(((((((((((((((((((4000amils(((((((((((((((((((4000plywood 5000

Sucesos



Capítulo 6. Reglas de negocio

En este capítulo se describen las reglas de negocio para supervisar los flujos dedatos y generar mensajes que describen las condiciones de alerta.

Acerca de las reglas de negocioLas reglas de negocio supervisan los flujos de datos para buscar condiciones denegocio excepcionales y generar mensajes de alerta en los que se describan esascondiciones si existen. Además, las reglas pueden supervisar una condición que seha encontrado y determinar cuándo deja de existir.

En IBM Cognos Real-time Monitoring Dashboard, puede crear reglas de negocio apartir de plantillas que definen lógica condicional. El usuario selecciona lacondición de la regla y determina los valores que se deben probar. El sistemanotifica al usuario siempre que se cumple la condición. Por ejemplo, con la regla"Cuando el total del pedido sea superior a cantidad" está identificando el valor dela cantidad, y recibirá notificaciones cada vez que un pedido exceda la cantidadque ha seleccionado.

En esta sección se explica cómo crear reglas de negocio a partir de plantillas ycómo se gestionan las reglas en Cognos Real-time Monitoring Dashboard. Lasplantillas de reglas permiten a un usuario avanzado crear una condición de reglacompleja y definir parámetros para determinados valores con el fin de que losusuarios de Cognos Real-time Monitoring Dashboard puedan crear instanciaspersonalizadas de la plantilla. Por ejemplo, un usuario desea instanciar una reglade negocio en la que la cantidad de las ventas sea superior a 20.000 euros, mientrasque otro usuario desea que se le notifique acerca de los pedidos de ventas quesuperen los 5.000 euros. Las plantillas de las reglas de negocio se crean en CognosReal-time Monitoring Workbench. Para obtener más información, consulte lapublicación IBM Cognos Real-time Monitoring Workbench Guía del usuario.

Atención: IBM Cognos Real-time Monitoring da soporte a otro tipo de regla denegocio: las reglas que se definen y gestionan por completo a través delModelador de escenarios de IBM Cognos Real-time Monitoring Workbench. Paraobtener más información, consulte la documentación técnica de Workbench.

El Gestor de reglas de negocio muestra las reglas disponibles y es el lugar dondese pueden crear, gestionar y suprimir.

La eliminación de una regla de negocio no afecta a los mensajes de alerta delGestor de alertas. Todos los mensajes del Gestor de alertas generados a partir deuna regla de negocio se almacenan en el Gestor de alertas hasta que se suprimen.

Creación de una regla de negocioPuede crear reglas de negocio en el Gestor de reglas de negocio.

Es necesario tener al menos permiso de Lectura sobre la actividad empresarial delModelador de escenarios en el que se haya definido la plantilla de regla.

Para obtener más información, consulte el tema acerca de los permisos en lapublicación IBM Cognos Real-time Monitoring Workbench Referencia de modelado y el


tema sobre cómo trabajar con plantillas de regla en la publicación IBM CognosReal-time Monitoring Workbench Guía del usuario.

Procedimiento1. Abra el Gestor de reglas de negocio y pulse Crear regla de negocio.2. Seleccione la plantilla de regla que desee utilizar.3. Identifique los valores de los parámetros de la regla.4. Escriba el nombre de la regla y, opcionalmente, una descripción.5. Guarde la nueva regla.

La nueva regla aparecerá en el Gestor de reglas de negocio, e inmediatamenteempezará a buscar nuevas condiciones excepcionales.Atención: Las reglas de negocio se basan en la definición de la plantilla deregla en el momento de su creación. Los cambios que se realicenposteriormente en la plantilla (incluido el mensaje de alerta o reportlet) noafectarán a las reglas de negocio creadas a partir de esa plantilla.


Capítulo 7. Common Event Infrastructure

Common Event Infrastructure (CEI) es un servicio que puede crear, almacenar ydistribuir eventos.

IBM WebSphere utiliza Common Event Infrastructure. CEI recibe información delsistema o empresarial encapsulada en un Common Business Event (CBE). Cuandose produce un evento importante, se crea un CBE y se envía al servidor CEImediante un emisor, donde los datos pueden persistir, se pueden distribuir oambas cosas.

IBM Cognos Real-time Monitoring proporciona la funcionalidad para comunicarsecon un servidor que utiliza el CEI.

Funcionamiento de Common Event InfrastructureIBM Cognos Real-time Monitoring se comunica con un servlet y un beancontrolado por mensaje (MDB).

El MDB se despliega en el servidor que ejecuta Common Event Infrastructure(CEI). El MDB se suscribe al tema o cola JMS a que hace referencia el proceso detransmisión JMS. A su vez, el emisor de CEI hace referencia al proceso detransmisión JMS. Todos los mensajes se serializan y se envían a Cognos Real-timeMonitoring a través de HTTP a un servlet HTTP Post. La solicitud HTTP del MDBincluye parámetros que dirigen el mensaje a la secuencia de datos CEI en CognosReal-time Monitoring.

En el diagrama se ilustra cómo se entrega un mensaje CEI a Cognos Real-timeMonitoring.

Flujo de datos Common Event InfrastructureLos CBE (Common Business Events) son documentos XML y el flujo de datos CEI(Common Event Infrastructure) los trata como tales.

Puede recuperar filas y columnas utilizando expresiones XPath de la misma formaque recupera archivos XML sin formato. El flujo de datos CEI procesa un CBE de

AplicaciónCEIEmisor de CEI

Transmisión JMS

Cola o tema JMSA

IBM CognosReal-time Monitoring

WebSphere Application Server

CBE

CBE

CBE

CEI


la misma manera que un archivo sin formato. Por consiguiente, debe configurar loseventos del mismo modo que configura eventos para un archivo sin formato.

Requisitos previos para la creación de un flujo de datos deCommon Event Infrastructure

Antes de crear un flujo de datos CEI (Common Event Infrastructure), debe llevar acabo varias tareas:

Realice las tareas siguientes:v Cree un bean controlado por mensaje CEI (MDB).v Despliegue el MDB de CEI.v Busque un archivo sin formato de ejemplo (opcional).v Configure CEI para que conecte con el MDB.

Debe tener IBM WebSphere Process Server instalado, configurado y en ejecuciónpara CEI.

Existe un MDB de CEI disponible en el directorio webcontent/samples/sdk/cei.

Para crear correctamente el archivo cei_mdb.ear al ejecutar la prueba de CEI, senecesitan los archivos JAR siguientes:v emf.jar

v com.ibm.events.client_6.1.0.jar

Para crear correctamente el archivo eventsimulator.war al ejecutar la prueba deCEI, se necesitan los archivos JAR siguientes:v ws_runtime.jar

v com.ibm.events.client_6.1.0.jar

Para el archivo ws_runtime.jar, en la ubicación de instalación de IBM WebSpherevaya a ubicación_instalación/usr/IBM/WebSphere/AppServer/deploytool/itp/plugins/com.ibm.websphere.v61_6.1.200.

Para el archivo com.ibm.events.client_6.1.0.jar, en la ubicación de instalaciónde IBM WebSphere vaya a ubicación_instalación/usr/IBM/WebSphere/AppServer/plugins.

La siguiente tabla describe los atributos de un flujo de datos de CEI.

Tabla 25. Atributos de secuencia de datos de CEI


NombreIdentifica la tabla.

El nombre debe ser exclusivo entre todos los objetos de lamisma carpeta (incluidos los objetos del panel de control y lospaneles de control). La carpeta raíz también contiene objetosglobales como usuarios y roles, y actividades empresariales.Para obtener más información, consulte: “Espacio de nombresde objeto” en la página 277.

EstadoEspecifica si el objeto está habilitado (preparado para recibirdatos) o inhabilitado (no preparado para recibir datos).


Tabla 25. Atributos de secuencia de datos de CEI (continuación)


DescripciónDescripción opcional que puede contener cualquier carácter detexto.

Guardar en Especifica la carpeta en la que se guardará el agente. Lapredeterminada es Carpetas públicas. Para seleccionar unacarpeta, pulse el botón Seleccionar carpeta.

Habilitar recuperaciónCuando está habilitado, registra los datos de un evento que sereciben después de que se inicie el punto de comprobación.Este registro de recuperación se utiliza para restaurar el estadodel sistema después de un cierre anómalo de los servidores.Para obtener más detalles, consulte la información sobre elpunto de comprobación y la recuperación en la publicaciónIBM CognosReal-time Monitoring Workbench Guía del usuario.

Información de lacolumna

Los campos de Información de la columna definen cómocorrelacionar los campos del mensaje de CEI con las columnasde la tabla de flujos de datos. Hay una columna por cadacampo en la tabla de flujos de datos. Para obtener másinformación, consulte: “Información de la columna CommonEvent Infrastructure” en la página 60.

Borrar intervalo deestados

Esta pestaña contiene varias opciones para borrar datos deeventos persistentes. Para obtener más información, consulte:“Intervalo de borrado de estados” en la página 60.

Despliegue de un bean controlado por mensajePuede desplegar un bean controlado por mensaje.

Procedimiento1. Inicie sesión en Process Server Integrated Solutions Console.2. Vaya a Aplicaciones, Empresa, Instalar.3. Busque el archivo cei_mdb.ear en la carpeta de despliegue y cárguelo.

Configuración de Common Event Infrastructure para conectarcon el bean controlado por mensajePuede configurar Common Event Infrastructure para que se conecte con el MDB.

Procedimiento1. Asegúrese de que la configuración de la aplicación CEI habilita la autorización

para emisores.2. Vaya a la consola administrativa de IBM WebSphere.3. Compruebe que existe el tema o la cola que definió en su MDB. El tema o la

cola debe coincidir con QueueConnectionFactory.4. Asegúrese de que tiene una Especificación de activación que asocia el tema o

la cola con el MDB. Cuando se despliega el MDB, se utiliza la Especificaciónde activación para suscribirse al tema o la cola.

5. Configure la Transmisión JMS para especificar el tema o la cola a la que estásuscrito su MDB, y asigne un nombre JNDI a la Transmisión JMS.

6. Configure el emisor de CEI que la aplicación CEI utiliza para hacer referencia aTransmisión JMS con el nombre JNDI que ha asignado en el paso 5.

Capítulo 7. Common Event Infrastructure 59

Creación de una tabla de flujos de datos desde una conexiónde Common Event Infrastructure

Puede crear una tabla de flujos de datos desde una conexión de Common EventInfrastructure.

Procedimiento1. En IBM Cognos Real-time Monitoring Workbench, pulse la pestaña Workbench.2. Pulse Actividades.3. Seleccione Crear nuevo.4. Pulse Flujo de datos.5. Seleccione Flujo de datos único y, a continuación, pulse Continuar

6. Seleccione Common Event Infrastructure, y, a continuación, pulse Continuar.7. En Información de la columna, defina las columnas de la tabla de flujos de

datos.8. Guarde el flujo de datos de CEI como habilitado.

Información de la columna Common Event InfrastructureLos campos de información de la columna definen cómo correlacionar los camposdel mensaje de JMS con las columnas de la tabla de flujos de datos. Hay un campopor cada columna en la tabla de flujos de datos.

Cada campo del mensaje puede ser un campo simple que se correlacionedirectamente con una columna de un flujo de datos. También puede ser un campocomplejo (un campo de archivo sin formato) que contenga varios campos que secorrelacionen de forma individual con las columnas de la tabla. Los camposcomplejos se tratan como archivos sin formato en formatos delimitados (CSV), deanchura fija o XML. Para obtener descripciones detalladas de estos tipos dearchivo, consulte: Capítulo 13, “Archivos sin formato”, en la página 103.

Cada columna de la tabla de flujos de datos contiene los atributos descritos en lasiguiente tabla.

Tabla 26. Atributos de columna de CEI


Nombre de campo Nombre de la columna en la tabla de flujos de datos.

Tipo de datos Tipo de datos de la columna de la columna de flujos dedatos. Para obtener más información sobre tipos de datos,consulte: “Tipos de datos de Java Messaging Service” en lapágina 222.

Formato (Opcional) Formato de la columna de flujos de datos paravalores VARCHAR (cadena) y DECIMAL.

Se añaden columnas pulsando Agregar campo o Agregar campo de archivo sinformato.

Intervalo de borrado de estadosHay varias opciones disponibles para borrar datos en memoria de todas las vistasy cubos que reciben datos de una secuencia de datos.

La pestaña Borrar intervalo de estados contiene las siguientes opciones:


v No borrar estado

Es el valor predeterminado. Los datos en memoria no se borran, y se propagandel flujo de datos a las vistas, objetos y paneles de control.

v Borrar estado en una planificación

Si selecciona esta opción se activan los controles de planificación Cambiarorigen de hora, Agregar planificación, Editar planificación y Quitarplanificación.

v Borrar siempre estado para datos nuevos

Los datos en memoria para cada vista y cubo se borran antes de cargar nuevasfilas de datos en las vistas y cubos. Cada fila de datos de un sondeo puedeactivar el borrado del estado en memoria de datos. Seleccione Tratar todas lasfilas del conjunto de resultados como un solo evento para mantener múltiplesfilas en memoria.

Borrar estado en una planificaciónPuede utilizar esta opción para activar controles de planificación.

Si pulsa Agregar planificación, puede especificar las opciones siguientes:v Borrar el estado a una hora específica o en un intervalo de horasv Borrar el estado todos los días, uno o varios días específicos de la semana, o uno

o varios días específicos del mesv Borrar el estado durante uno o varios meses específicos

Por ejemplo, para planificar que el intervalo de borrado de estados se produzcacada tres meses el día 30 del mes a las 10 de la noche:1. Seleccione Agregar una hora específica y establezca Planificar en a las 10:00

p.m.2. Seleccione Los días del mes seleccionados más abajo y seleccione 30.3. Para el mes, seleccione Marzo, Junio, Septiembre y Diciembre.

Pulse Editar planificación para modificar una planificación seleccionada.

Pulse el botón Quitar planificación para suprimir una planificación seleccionada.

Cambiar origen de horaPuede seleccionar las opciones de hora que especifican cuándo deben borrarsedatos.

Cambiar origen de hora abre una ventana en la que puede seleccionar cuándo sedeben borrar datos, de acuerdo con estas opciones:v A la hora especificada

Los datos se borran sólo a las horas especificadas en una planificación. Siselecciona esta opción, puede que la vista no contenga datos durante un periodode tiempo determinado. Para evitar que una vista no contenga datos, seleccionela opción Cuando los datos llegan tras la hora especificada.

v Cuando los datos llegan tras la hora especificada

Los datos existentes se borran cuando llegan nuevos datos tras la horaespecificada en una planificación.

v Cuando el valor de la columna de indicación de fecha y hora es posterior a lahora especificada

Los datos se borran en función del valor de una columna de indicación de fechay hora específica. Si la columna de indicación de fecha y hora contiene una hora

Capítulo 7. Common Event Infrastructure 61

que es posterior a la hora de una planificación, los datos existentes se borran. Sila hora indicada en la columna de indicación de fecha y hora es anterior a lahora de una planificación, los datos existentes no se borran. Utilice la listadesplegable Seleccionar columna para seleccionar la columna que se debeutilizar para las indicaciones de fecha y hora. Si no hay ninguna columna deindicación de fecha y hora, esta opción no está disponible.


Capítulo 8. Cubos

Un cubo es un conjunto de datos organizado por dimensiones y medidas paraagregar distintos subconjuntos del conjunto de datos más grande.

Cuando los cubos se representan como objetos del panel de control, puedenutilizarse para especificar categorías que filtren datos para mostrar los resultadosque coincidan con la sección. Por ejemplo, un cubo de datos de ventas puedeproporcionar agregaciones de los mismos datos por dimensiones de producto,tiempo o región de ventas. Al observar el cubo, puede elegir ver el total de ventasde un producto (Nails) de una región empresarial (West) durante un trimestrefiscal (el primer trimestre).West

Q1 January HardwareNails 120,000

WestQ1

March Hardware Nails98,000

Total 218,000

Si se elimina la especificación de dimensión de producto, cambia la clasificaciónpara ver todas las ventas para esa región y trimestre:West

Q1January Hardware Nails120,000

WestQ1

March Hardware Nails98,000

WestQ1

March Hardware Screws97,000

WestQ1

January Lumber Studs137,000

Total 452,000

O para todas las ventas durante el mes de marzo:West Q1March Hardware Nails98,000

West Q1March Hardware Screws97,000

East Q1March Lumber Plywood92,000

South Q1March Hardware Nails98,000

Total 385,000


O para todas las ventas de la región West de la familia de productos Lumber:West Q1January Lumber Studs137,000

Total 137,000

Para obtener más información, consulte los ejemplos de los gráficos de cubos y delas tablas de cubos de la publicación IBM CognosReal-time Monitoring DashboardGuía del usuario.

MedidasLas medidas son los valores centrales que se agregan y analizan.

En los ejemplos del tema de cubos, el total de ventas es el valor agregado. En cadaejemplo, el total se calcula midiendo la suma de todas las ventas del conjunto. Lasmedidas se crean con funciones de conjunto C-SQL, como SUM, AVG, MIN, MAX,STD_DEVIATION y VARIANCE.

Para obtener más información sobre las medidas, consulte: “Columnas de medida”en la página 66.

Dimensiones en cubosUna dimensión es un orden de clasificaciones que describe conjuntos menores ydiferenciados de datos relacionados del nivel más alto al nivel más bajo.

En los ejemplos del tema de cubos, la región de negocio es un nivel de unadimensión geográfica, las columnas de trimestre y mes son cada una niveles deuna dimensión de tiempo, y la familia de productos y el nombre de producto sonparte de una dimensión de inventario. En la dimensión de tiempo, los meses sonconjuntos menores de trimestres fiscales, igual que nombre de producto es unconjunto menor del nivel de familia de productos. La siguiente tabla muestraejemplos de dimensiones:

Tabla 27. Ejemplos de dimensiones

Hora Geografía Inventario Seguridad Taxonomía

año

trimestre

mes

semana

día

hora

minuto

continente

país o región

región

estado

condado

ciudad

distrito

clasificación

tipo

fabricante

modelo

configuración

tipo

clasificación

empresa

CUSIP

reino

grupo

clase

orden

familia

género

especie

Para obtener más información, consulte: Capítulo 11, “Dimensiones”, en la página91.


Se puede limitar el acceso de usuario a los datos de un cubo con un filtro deacceso. Para obtener más información, consulte: Capítulo 2, “Filtros de acceso”, enla página 3.

Creación de cubosLos cubos son similares a las vistas empresariales en tanto que agregan datos deeventos, pero las agregan en dimensiones distintas.

La vista que un cubo agrega es una tabla de hechos: una vista o tabla en un eventoque contiene una o varias columnas para la medición (agregación), y tambiéncontiene columnas que identifican los elementos de dimensión que se asocian alevento. Una tabla de hechos podría contener un evento similar al del ejemplosiguiente:Cost Quantity Product State Month

------ -------- ------- ---------- -------

200.00 1600 Nails California January

Sin embargo, en la práctica, los elementos de dimensión se almacenan endimensiones (tablas de consulta especiales) y se hace referencia a éstos mediantelos ID, por ejemplo:Cost Quantity prod_id region_id ddim_id

------ -------- ------- --------- -------

200.00 1600 100 7 39

En la siguiente ilustración se muestra un cubo creado a partir de la tabla de hechosOrderDetails, y mide las ventas totales de diversas regiones empresariales,productos y fechas y horas.

Procedimiento1. En IBM Cognos Real-time Monitoring Workbench, pulse la pestaña Workbench.2. Seleccione Cubos.3. En el menú Actividades, pulse en Crear nuevo.4. Pulse en Examinar y seleccione una tabla o tablas de hechos y columnas para

la medición.

Figura 8. Un cubo creado a partir de la tabla de hechos OrderDetails

Capítulo 8. Cubos 65

5. Especifique cómo han de medirse (fórmulas agregadas que han de utilizarse).6. Seleccione una o varias dimensiones que clasifiquen las mediciones.

Columnas de medidaLas columnas de medida definen las agregaciones que calcula el cubo. Un cubodebe tener una columna de medida como mínimo. Cada columna de medidadefine una expresión que contiene una función de conjunto C-SQL que agregaotras columnas de la tabla de hechos.

Por ejemplo, para determinar el total de ventas a partir de la tabla de hechosOrderDetails, se puede definir una columna de medida como:SUM(OrderDetails.prod_cost*OrderDetails.order_qty) ASTotalOrderSales

Creación de un cubo con columnas de dimensiónLas columnas de dimensión categorizan las mediciones. Un cubo debe tener unadimensión como mínimo y puede tener más. Asimismo, los datos de la tabla dehechos deben ser capaces de identificar un elemento exclusivo en cada dimensiónasociada.

Para obtener más información, consulte: Capítulo 11, “Dimensiones”, en la página91.

Antes de empezar

Antes de crear un cubo, debe disponer de permiso de creación para vistas, cubos ydimensiones. También debe tener los requisitos previos siguientes:v Como mínimo, acceso de sólo lectura para las dimensiones que han de incluirse.

Para obtener información, consulte: “Creación de dimensiones” en la página 94.v Una dimensión con Categorías geográficas habilitadas, si el cubo se utiliza para

gráficos geográficos.

Procedimiento1. En IBM Cognos Real-time Monitoring Workbench, pulse la pestaña Workbench.2. Pulse Actividades.3. Pulse Crear nuevo > Cubo.4. Especifique un nombre para el cubo en el campo Nombre y, opcionalmente,

proporcione una descripción del cubo.5. Seleccione la Tabla de hechos que contiene los datos que han de medirse y que

contiene las columnas que identifican los elementos de dimensión. PulseExaminar para seleccionar Tabla de hechos.

6. En el cuadro Seleccionar objeto, seleccione el objeto que ha de utilizarse parala Tabla de hechos y pulse el botón Aceptar.

7. Defina una o varias columnas de medida (consulte: “Columnas de medida”).v Pulse en Agregar columna de medida para definir una columna.v Especifique el nombre de la columna en el campo Nombre de medida.v Defina la fórmula de medida con una función de conjunto C-SQL (consulte:

“Funciones de conjunto” en la página 126) en el campo Expresión deagregado. La función debe hacer referencia a una columna de la tabla dehechos. Por ejemplo, la expresión SUM() siguiente totaliza el producto de lascolumnas de coste y cantidad:SUM(OrderDetails.prod_cost*OrderDetails.order_qty)


Para obtener más información acerca de las expresiones C-SQL, consulte:Capítulo 14, “Fórmulas”, en la página 125.

8. Defina una o varias columnas de dimensión.v Pulse en Agregar dimensión para definir una columna.v Seleccione la dimensión que ha de incluirse en la lista desplegable de la

columna Dimensión. Esta lista incluye todas las dimensiones para las quedispone de, como mínimo, acceso de sólo lectura.

v Identifique las columnas de clave en la dimensión y en la tabla de hechos.Para obtener más información acerca de las claves, consulte: “Columnas declaves” en la página 93.

El tipo de datos para la clave de la tabla de hechos debe ser el mismo que parala clave de la dimensión (tabla de consulta). No puede, por ejemplo, mezclarenteros y decimales; los dos deben ser o enteros o decimales.

9. Guarde el cubo.

Capítulo 8. Cubos 67


Capítulo 9. Tipos de datos

IBM Cognos Real-time Monitoring y C-SQL soportan varios tipos de datos SQL-99.

Tabla 28. Tipos de datos C-SQL

Tipo de datos C-SQL Categoría de tipo de datos

BOOLEAN “Operadores booleanos” en la página 82

DECIMAL “Tipos de datos C-SQL para valoresnuméricos” en la página 71

DOUBLE PRECISION “Tipos de datos C-SQL para valoresnuméricos” en la página 71

INTEGER “Tipos de datos C-SQL para valoresnuméricos” en la página 71

INTERVAL “Fecha y hora” en la página 76

LONG “Tipos de datos C-SQL para valoresnuméricos” en la página 71

TIMESTAMP “Fecha y hora” en la página 76

VARCHAR “Cadena” en la página 74

C-SQL proporciona medios para convertir los datos de un tipo a otro. Para obtenermás información, consulte: “Conversión de tipo de datos”.

Conversión de tipo de datosEn IBM Cognos Real-time Monitoring, existen dos maneras de convertir valores deun tipo de datos a otro: la conversión explícita y la conversión implícita.

Conversión explícitaCualquier argumento C-SQL puede contener CAST() para convertir el tipo dedatos de un valor.

Para obtener más información, consulte: “CAST” en la página 142.

Por ejemplo, puede convertir una cadena de caracteres numéricos en un valornumérico y utilizar el resultado como argumento para FLOOR (consulte: “FLOOR”en la página 155):FLOOR( CAST( ’1234.56’ AS DECIMAL) )

Conversión implícitaC-SQL intenta convertir automáticamente un tipo de datos al tipo correcto para elargumento donde se encuentra el valor.

Por ejemplo, si C-SQL encuentra VARCHAR '1234,56' en el argumento FLOOR(),convierte automáticamente el valor a un valor numérico DOUBLE PRECISIONantes de truncar los dígitos decimales. Por ejemplo:FLOOR( ’1234.56’ ) << Implicit cast to DOUBLEPRECISION.


Cuando un valor de un tipo de datos se compara con un valor de un tipo distinto,C-SQL convierte primero uno de los valores para que coincida con el otro. En elejemplo siguiente, C-SQL convierte la cadena VARCHAR en BOOLEAN antes deevaluar la expresión:’true’ = TRUE << Implicit cast to BOOLEAN.

El contexto también afecta a la conversión. Por ejemplo, como el siguienteoperador de suma aritmética espera argumentos numéricos, aunque los dos valoressean caracteres, los valores se convierten primero en valores numéricos:’2’ + ’3’ << Both cast to numeric to matchoperator data type.

El valor debe poder convertirse al tipo requerido; de lo contrario, la expresión dacomo resultado un error de tipo de datos incorrecto.

Orden de prioridadA cada conversión de tipo de datos posible se le asigna un orden de prioridad.

La siguiente tabla muestra qué tipos son convertibles y el orden de prioridadasignado a cada posible conversión de tipo de datos, donde cero (0) es la prioridadmás alta y un millón (1.000.000) es la más baja:

Tabla 29. Orden de prioridad asignado a cada conversión de tipo de datos

A\De VARCHAR BOOLEAN TIMESTAMPDOUBLEPRECISION DECIMAL INTEGER LONG

VARCHAR 0 1.000.000 1.000.000 1.000.000 1.000.000 1.000.000 10

BOOLEAN 1 0

TIMESTAMP 2 0

DOUBLEPRECISION

3 0 1 3 2

DECIMAL 4 2 2 2 1

INTEGER 5 4 0 0 3

LONG 6 3 1 1 0

En el ejemplo de comparación de “Conversión implícita” en la página 69, C-SQLconvierte el valor VARCHAR en un valor BOOLEAN porque el nivel de prioridadpara esa conversión es 1, en oposición a 10 para convertir de un valor BOOLEANa un valor VARCHAR. Del mismo modo, en el ejemplo de FLOOR("1234,56"),C-SQL convierte la cadena a DOUBLE PRECISION porque DOUBLE PRECISIONtiene una prioridad más alta que DECIMAL, aunque un decimal pueda parecermás apropiado para el valor.

Consulte las descripciones de los tipos de datos C-SQL individuales para obtenerinformación específica sobre la conversión de esos tipos.


Tipos de datos C-SQL para valores numéricosC-SQL presenta varios tipos de datos para los valores numéricos.

Tabla 30. Tipos de datos para valores numéricos

Tipo Descripción

INTEGEREntero con signo

32 bits

-2.147.483.648 valor mínimo

2.147.483.647 valor máximo

DECIMALDecimal

Mínimo un dígito

256 dígitos máximo

El recuento total de dígitos DECIMAL, tanto antes comodespués del separador decimal, es 256.

DOUBLE PRECISIONComa flotante IEEE 754

64 bits

+/-4,94065645841246544E-324 valor mínimo

+/-1,79769313486231570E-308 valor máximo

Para expresar una DOUBLE PRECISION como literal, utilicenotación científica, como 1e24.

LONGCon signo largo

64 bits

-264 valor mínimo

264 -1 valor máximo

Atención:

v El recuento total de dígitos DECIMAL, tanto antes como después del separadordecimal, es 256.

v Para expresar una DOUBLE PRECISION como literal, utilice notación científica,como 1e24.

Tipos de datos de terceros que se correlacionan con los tiposde datos numéricos C-SQL

Los tipos de datos numéricos C-SQL se correlacionan con los tipos de datos deotros sistemas de soporte.

La siguiente tabla describe la correlación de numéricos C-SQL con los tipos dedatos de otros sistemas de soporte, donde p significa precisión:

Capítulo 9. Tipos de datos 71

Tabla 31. Correlación de datos numéricos C-SQL con tipos de datos de otros sistemas

Sistema desoporte Entero Largo Decimal Doble

C-SQL/JDBC INTEGER LONG DECIMAL DOUBLEPRECISION

Java int long BigDecimal double

Oracle Number(p=38) Number((19,0) Number Number(p=38)

Servidor SQL Int(32 bit) BigIntDecimal

Numérico

Money

SmallMoney

double real(4bytes)

Sybase Int(32 bit) BigIntDecimal(p=38)

Numeric(p=38)

Money(64bit)

SmallMoney(32bit)

double real(4bytes)

MySQLTINYINT

SMALLINT

MEDIUMINT

INT, INTEGER

BIGINT

BIGINT DECIMALNUMERIC

DOUBLE REAL

PostgreSQLSMALLINT

INT, INTEGER

BITINT

BIGINT DECIMALNUMERIC

DOUBLEPRECISIONREAL

Combinación de tipos numéricosAl combinar dos tipos numéricos, el resultado es el tipo con una prioridad másalta. Por ejemplo, sumar un valor entero a un decimal da como resultado unasuma decimal.

La prioridad se basa en el “Orden de prioridad” en la página 70.

Convertir un número fraccionario en un entero trunca la fracción sin avisar(redondeo a la baja) para ajustarse al destino. Por ejemplo, forzar una DOUBLEPRECISION en un INTEGER trunca la parte fraccionaria del valor.

Conversión de tipos numéricosEs posible convertir numéricos a tipos de diferente tamaño de almacenamiento siel destino es suficientemente grande para el resultado; en caso contrario, laconversión falla con un error de número fuera de rango. Por ejemplo, intentar


colocar un tipo numérico de coma flotante de un tamaño de almacenamientomayor en una ubicación de un tamaño menor produce un error.

Directrices de conversión de números a cadenasSe deben tener en cuenta algunas directrices a la hora de convertir números encadenas.

Estas directrices incluyen:v Para los números decimales (DECIMAL), se añaden ceros a los valores decimales

del resultado para que coincida con la precisión y la escala definidas para lacolumna. Por ejemplo, si se define una columna con precisión 5 y escala 4, unvalor de 1,1 en la columna se convierte a ' 1,1000 '.

v Para números de precisión doble (DOUBLE PRECISION), 'e' se convierte amayúsculas. Por ejemplo, +1e11 se convierte a ' 1,0E11 '.

Resultados de precisión decimalTodos los números decimales tienen dos componentes: precisión y escala.v Precisión

Recuento de dígitos, tanto a la izquierda como a la derecha de la coma decimal.El máximo es 256. El mínimo es 1.

v EscalaRecuento de dígitos del componente fraccionario. Es menor o igual que laprecisión. Cuando no se especifica la escala, el valor predeterminado es 2.

Cuando un valor tiene una escala o precisión mayor que el almacenamiento dedestino, como un campo de base de datos con una precisión menor, IBM CognosReal-time Monitoring trunca decimales y redondea a la baja el resultado para quese ajuste.

ConversiónAl convertir un valor decimal, puede declarar la precisión y la escala.

La precisión y la escala se declaran como se indica a continuación:DECIMAL( precision, scale )

Por ejemplo,CAST( ’4.012345’, DECIMAL(5,4) ) --> 4.0123

Al convertir de una columna de decimal con formato a una cadena, se añadenceros en los decimales del resultado para que coincida con la escala. Por ejemplo,cuando la columna tiene una precisión 5 y escala 4, al convertir el valor 1,1 de lacolumna en una cadena el resultado es ' 1,1000 '.

MultiplicaciónEn multiplicación, la precisión resultante es la suma de las precisiones, y la escalaes la suma de las escalas.

Los resultados se determinan mediante este cálculo:PrecisionResult = MIN( PrecisionLeft+PrecisionRight,256)

ScaleResult = MIN( ScaleLeft+ScaleRight, 256)

Por ejemplo, el resultado de (4,55*1,414) es la precisión 7 (3+4) y la escala 5 (2+3).


DivisiónLos resultados de la división se determinan utilizando este cálculo.

Por ejemplo, el resultado de (4,55/1,414) es la escala 4 (2+4-1) y la precisión 10(3+3+4). El cálculo es:ScaleResult = MIN(MAX((ScaleLeft+PrecisionRight-ScaleRight+1),2),256)

PrecisionResult = MIN((PrecisionLeft + ScaleRight + ScaleResult),256)

Suma y restaLos resultados de la suma o resta se determinan utilizando este cálculo.PrecisionResult = MIN( (MAX( PrecisionLeft - ScaleLeft,

PrecisionRight - ScaleRight) +

MAX( ScaleLeft, ScaleRight ) + 1),256)

ScaleResult = MAX( ScaleLeft, ScaleRight )

Todas las demás funcionesPara otras funciones y operaciones, el resultado viene determinado por el valor conla mayor precisión y el valor con la mayor escala. Los resultados pueden estardeterminados a partir del mismo valor.PrecisionResult = MIN( MAX( Precision[i] ), 256)

ScaleResult = MIN( MAX( Scale[i] ), 256)

CadenaEl tipo de datos C-SQL VARCHAR mantiene valores de cadena de caracteres.

Tabla 32. Tipo de datos C-SQL VARCHAR

Tipo Descripción Relleno Tamaño mínimo Tamaño máximo

VARCHAR Longitudvariable

No 1 carácter(predeterminado),puede ser nulo.

Infinitos caracteres.Tenga en cuenta quese produce un errorsi se intentaalmacenar un valoren un DBMS que esmás largo que eltamaño de lacolumna definida enla tabla.

Anchura de cadenaAunque el límite máximo de tamaño para los valores de cadena es infinito, procureno sobrepasar los 255 caracteres, porque ése es el límite impuesto en muchossistemas DBM.

Sin embargo, para mejorar el rendimiento, facilitar el almacenamiento de datos yayudar en las comparaciones de cadenas, declare una anchura máxima adecuada aldefinir una columna VARCHAR. La anchura debe ser suficiente para admitir lalongitud máxima de cualquier resultado de cadena que se inserte en el campo. Eltexto que es más largo que la anchura máxima se trunca al almacenar la cadena.


Tipos de datos de terceros que se correlacionan conVARCHAR

El tipo de cadena C-SQL/JDBC VARCHAR se correlaciona con los tipos de datosde otros sistemas de soporte.

La siguiente tabla describe la correlación del tipo de cadena C-SQL/JDBCVARCHAR con tipos de datos de otros sistemas de soporte:

Tabla 33. Correlación entre el tipo de cadena C-SQL/JDBC VARCHAR y tipos de datos deotros sistemas

Java Oracle Servidor SQL Sybase MySQL PostgreSQL

Cadena Char

Varchar

Varchar2(4k)

Varchar(8k) Varchar(8k) CHAR

VARCHAR

BINARY

VARBINARY

BLOB

ENUM

SET

CHAR[n]

VARCHAR[n

Concatenación de cadenasSe pueden concatenar dos cadenas.

Para concatenar dos cadenas, utilice CONCAT o el operador ||. Para obtener másinformación, consulte: “CONCAT” en la página 167.

Literal de cadenaPara expresar una cadena como literal, encierre el texto entre comillas simples (').Para incluir una comilla simple, escriba dos.

Por ejemplo:’Couldn’’t’ Returns: Couldn’t

Conversión de cadenas en otros tipos de datosAl combinar una cadena con otro tipo de datos, o al expresar una cadena donde seesperaba otro tipo de datos, la cadena se convierte automáticamente en el nuevotipo en función del orden de prioridad.

Para obtener más información, consulte: “Orden de prioridad” en la página 70.

Durante la conversión, se producen los siguientes comportamientos:v Se eliminan todos los espacios en blanco que están delante y detrás.v Si la cadena contiene un carácter no válido o tiene un formato no válido, se

produce un error. Un carácter no válido es un carácter no adecuado para el tipode datos de destino. Por ejemplo, 'hola' no puede convertirse en INTEGER.

v El formateo que no es coherente con la definición de un valor de datos literal deltipo de destino se considera no válido. Por ejemplo, para que una cadena seconvierta implícitamente en un tipo de datos de indicación de fecha y hora, la


cadena de origen debe estar contenida en el formato de fecha C-SQLpredeterminado. Para obtener información sobre el formateo de cadenas paratipos de fecha-hora, consulte: “Fecha y hora”.

Fecha y horaLos tipos de datos de fecha y hora almacenan la fecha y la hora del día de esafecha como valor único.

No se puede acceder directamente a un tipo de datos de día y hora como supropia representación numérica interna. En lugar de esto, para acceder a losvalores de fecha y hora de un modo racional, C-SQL proporciona varias funcionespara manipular los valores, y proporciona construcciones literales para representarlos valores de las expresiones.

Tabla 34. Tipos de datos de fecha y hora

Función Descripción

TIMESTAMP literal (consulte:“Literal TIMESTAMP” en la página78)

Representación en forma de cadena de caracteres deun valor de fecha y hora. Puede ser cualquiercombinación de año, mes, día del mes, hora, minuto,segundo y fracciones de segundo.

INTERVAL literal (consulte: “LiteralINTERVAL” en la página 78).

Representación en forma de cadena de caracteres deun intervalo: lapso de tiempo que consta de años ymeses, o días, horas, minutos y segundos.

Los valores de fecha y hora están en el huso horario del entorno local del servidorque ejecuta IBM Cognos Real-time Monitoring.

Conversión entre valores de fecha-hora y cadenasPuede convertir un valor de fecha-hora en una cadena de caracteres (VARCHAR) yconvertir una cadena en un valor de datos de fecha-hora. Para ambos tipos deconversiones, puede especificar el formato de la cadena.

Convierta un valor de fecha-hora en una cadena de caracteres (VARCHAR) conTO_CHAR (consulte: “TO_CHAR” en la página 150), y convierta una cadena en unvalor de fecha-hora con TO_DATE (consulte: “TO_DATE” en la página 150).

Cuando se incluye un literal TIMESTAMP (consulte: “Literal TIMESTAMP” en lapágina 78) en una cadena, un argumento convierte automáticamente el valor enuna cadena con el formato predeterminado de fecha-hora, que es aaaa-MM-ddhh:mm:ss.SSS. Para obtener más información sobre la conversión entre valores defecha-hora y cadenas, consulte: “Conversión de tipo de datos” en la página 69.

Comparación de valores fecha-horaUn valor de fecha-hora se almacena internamente como un número que representala fecha-hora en milisegundos. Por consiguiente, tenga cuidado al comparar dosvalores de fecha-hora.

Por ejemplo, esta comparación sólo es verdadera cuando las dos fechas tienen elmismo número de milisegundos:first_date = second_date


Si la granularidad exacta no es importante, considere primero la opción deconvertir los valores de fecha-hora en cadenas que representen justo la parte defecha:TO_CHAR(first_date,"yyyy-MM-dd") = TO_CHAR(second_date,"yyyy-MM-dd")

Según el “Orden de prioridad” en la página 70, comparar una cadena con unafecha-hora primero convierte la cadena en una fecha-hora antes de que seproduzca la comparación. Observe este ejemplo, donde birth_date es un valor defecha-hora. Si birth_date tiene una hora asociada, la comparación nunca esverdadera:’2010-02-18’ = birth_date

Una comparación más exacta consiste en convertir primero birth_date en unacadena sin hora:’2010-02-18’ = TO_CHAR( birth_date, "yyyy-MM-dd" )

Aritmética de fecha-horaPuede sumar y restar intervalos de años, meses, días, horas, minutos y segundosen valores de fecha-hora.

Para obtener más información, consulte las descripciones de dichas funciones.Algunas cláusulas de consulta, sin embargo, requieren un literal INTERVAL.

Para obtener información acerca del literal INTERVAL, consulte: “LiteralINTERVAL” en la página 78.

Tipos de datos de terceros que se correlacionan con el tipodate-time C-SQL

El tipo de fecha y hora C-SQL se correlaciona con los tipos de datos en otrossistemas de soporte.

La siguiente tabla describe las correlaciones de tipo fecha y hora.

Tabla 35. Correlaciones del tipo de fecha y hora

Sistema de soporte Tipo fecha y hora

C-SQL/JDBCFecha y hora

JavaDate

Hora

Indicación de fecha y hora

OracleDate(YMDHMS)

servidor SQLDatetime(YMDHMS.xx)

SmallDateTime (YMDHMS)

SybaseDatetime (YMDHMS.xx)

SmallDateTime (YMDHMS)


Tabla 35. Correlaciones del tipo de fecha y hora (continuación)

Sistema de soporte Tipo fecha y hora

MySQLDATE

DATETIME

TIMESTAMP

TIME

YEAR

PostgreSQLTIMESTAMP

Literal TIMESTAMPEl literal TIMESTAMP representa un valor de fecha-hora como una cadena decaracteres. Para expresar una fecha=hora como valor literal, debe especificarsecomo prefijo la palabra 'TIMESTAMP' y encerrar todos los datos entre comillassimples (').

Por ejemplo:TIMESTAMP ’2010-03-05 19:45:23.123’

El formato de la cadena es aaaa-MM-dd hh:mm:ss.SSS, donde S (las fracciones desegundo) son opcionales y pueden contener de cero a nueve dígitos de precisión.Para obtener más información acerca de los caracteres de formateo, consulte:“Formato de fecha y hora” en la página 80.

Literal INTERVALUn literal INTERVAL identifica un intervalo de tiempo formado por años y meses(intervalos año-mes) o por días, horas, minutos y segundos (intervalos día-hora).

No puede combinar año-mes y día-hora en una declaración de intervalo. Losintervalos se aplican a valores de fecha y hora para calcular el lapso de tiempotranscurrido desde dicha instancia.

Normalmente, los intervalos se utilizan en expresiones para compensar lascolumnas de fecha y hora y los literales TIMESTAMP, como por ejemplo al declararel rango desde una fecha o una hora en las ventanas de consulta. Para obtener másinformación, consulte: Capítulo 38, “Ventanas de consulta”, en la página 389. Porejemplo, la siguiente ventana de consulta genera los totales de todos los eventosque han llegado durante la última hora (se aplica de forma implícita a la hora dellegada del último evento):SUM(Qty) AS Total_Of_Qty OVER (RANGE INTERVAL’1’ HOUR PRECEDING)

Cuando se aplica un intervalo a una fecha y hora, el intervalo se suma o se resta aeste valor. Por ejemplo, si la fecha y hora actual es el 5 de marzo de 2010, 7:45 dela tarde, si se añade un intervalo de un año a esa fecha se obtiene como resultadoel 5 de marzo de 2011 exactamente a la misma hora. La aritmética de calendariosigue las reglas del calendario gregoriano. Para obtener más información, consulte:“DATE_DIFF” en la página 145.


Intervalos año-mesUn intervalo año-mes utiliza uno de los campos de fecha-hora YEAR o MONTH, oambos combinados.

Las definiciones posibles son:INTERVAL ’yy’ YEAR[(<precision>)]

INTERVAL ’mm’ MONTH[(<precision>)]

INTERVAL ’yymm’ YEAR[(<precision>)] TOMONTH[(<precision>)]

Los ejemplos siguientes definen intervalos de tres años y de diez meses:INTERVAL ’3’ YEAR

INTERVAL ’10’ MONTH

Se puede definir un intervalo de fracción de año expresando el resultado en mesestotales, como 46 meses, o combinando el campo. El siguiente ejemplo identifica unintervalo de tres años y diez meses:INTERVAL ’3-10’ YEAR TO MONTH

Puede especificar un valor de cero (0) para uno de los campos. Los intervalossiguientes son de dos años cada uno:INTERVAL ’2-0’ YEAR TO MONTH

INTERVAL ’1-12’ YEAR TO MONTH

INTERVAL ’0-24’ YEAR TO MONTH

Precisión de intervalos año-mesEl argumento <precision> es un estándar ANSI que declara el número máximo dedígitos en el entero. De forma predeterminada, <precision> es 2.

Dado este valor predeterminado, las siguientes dos declaraciones de intervalos de100 meses cada una fallan:INTERVAL ’100’ MONTH(2) <<ERROR, precision is less than value size.

INTERVAL ’100’ MONTH << ERROR,defaultprecision is 2.

Para usar más de dos dígitos, declare una precisión del siguiente modo:INTERVAL ’100’ MONTH(3)

Al utilizar ambos campos, aplique la precisión sólo en el campo YEAR; el campoMONTH utiliza su precisión predeterminada de 2. por ejemplo, lo siguiente esincorrecto porque el mes es mayor que el valor predeterminado.INTERVAL ’100-123’ YEAR(3) TO MONTH << ERROR,monthis 3 digits

Intervalos día-horaUn intervalo día-hora consta de una combinación de días, horas, minutos ysegundos.

Las definiciones posibles son las siguientes, y .nn es una fracción de segundo:INTERVAL ’dd’ DAY

INTERVAL ’ddhh’ DAY TO HOUR

INTERVAL ’ddhh:mm’ DAY TO MINUTE

INTERVAL ’ddhh:mm:ss[.nn ]’ DAY TO SECOND


INTERVAL ’hh’ HOUR

INTERVAL ’hh:mm’ HOUR TO MINUTE

INTERVAL ’hh:mm:ss[.nn ]’ HOUR TO SECOND

INTERVAL ’mm’ MINUTE

INTERVAL ’mm:ss[.nn ]’ MINUTE TO SECOND

INTERVAL ’ss[.nn ]’ SECOND

A continuación se ofrecen algunos ejemplos de intervalos día-hora:INTERVAL ’27 23:59:59.999999999’ DAY TO SECOND

INTERVAL ’100 10:10’ DAY(3) TO MINUTE

Precisión de intervalos día-horaCada uno de los campos día-hora tienen también un argumento de precisión.

Por ejemplo:MINUTE(<precision>)

El argumento <precision> es un estándar ANSI que declara el número máximo dedígitos en el entero. De forma predeterminada, <precision> es 2 (excepto para lasfracciones de segundo, cuyo valor predeterminado es 9. Para obtener másinformación, consulte el ejemplo siguiente). Por lo tanto, las siguientes dosdeclaraciones de intervalos de 100 horas cada una fallan:INTERVAL ’100’ HOUR(2) << ERROR,precisionis less than value size.

INTERVAL ’100’ HOUR << ERROR,defaultprecision is 2.

Para usar más de dos dígitos, declare una precisión del siguiente modo:INTERVAL ’100’ HOUR(3)

Al declarar la precisión para SECOND con un componente fraccionario, especifiquedos valores de precisión separados por una coma. Observe los siguientes ejemplos:INTERVAL ’12.345’ SECOND(2, 3)

INTERVAL ’12.123456789’ SECOND(2, 9)

INTERVAL ’12.123456789’ SECOND

Tenga en cuenta que los dos últimos ejemplos tienen el mismo efecto, porque elvalor predeterminado es (2, 9) para SECOND.

Al utilizar varios campos, exprese sólo la precisión del primer campo. Los camposrestantes utilizan su valor predeterminado. Por ejemplo, la precisión en el siguienteejemplo se aplica sólo a los minutos y no afecta a las fracciones de segundo:INTERVAL ’100:23.123456789’ MINUTE(3) TO SECOND

Formato de fecha y horaSe puede definir el formato de la cadena de fecha y hora para algunas funciones.

Las funciones TO_CHAR (consulte: “TO_CHAR” en la página 150) y TO_DATE(consulte: “TO_DATE” en la página 150) contienen argumentos que definen elformato de la cadena de fecha y hora. La cadena de modelo de formato de fechade la tabla siguiente es idéntica a la utilizada por la clase Java SimpleDateFormat,que utiliza estas letras en los modelos:


Tabla 36. Cadena de modelo de formato de fecha que utiliza la clase JavaSimpleDateFormat

LetraComponente de fechay hora Presentación Ejemplos

G Designador de era Texto dC

y Año Año 2010; 10

M Mes del año Mes Julio; Jul; 10

w Semana del año Number 27

W Semana del mes Number 2

D Día del año Number 189

d Día del mes Number 10

F Día de la semana en elmes

Number 2

E Día de la semana Texto Martes; Mar

a Marcador AM/PM Texto PM

H Hora del día (de 0 a 23) Number 0

k Hora del día (de 1 a 24) Number 24

K Hora en am/pm (de 0a 11)

Number 0

h Hora en am/pm (de 1a 12)

Number 12

m Minuto de una hora Number 30

s Segundo de un minuto Number 55

S Fracción de segundo(una S siempredevuelve un entero de0 a 9 dígitos)

Number 978

' Escape para texto Delimitador

'' Comillas simples Literal '

Algunas letras tienen varios resultados, según el número de letras consecutivas enel formato. El resultado es el valor que mejor se ajusta al modelo. Para losnúmeros, si el modelo es mayor que el valor, el resultado se ampliará con cerosdelante (0). Para obtener información, consulte los ejemplos en la siguiente tabla.

Los ejemplos de la siguiente tabla, modificados desde la documentación de claseJava SimpleDateFormat, muestran cómo se interpretan los modelos de fecha y horaen el entorno local de EE. UU. La fecha y hora son 2010-08-04 12:08:56 hora localen los EE. UU.

Tabla 37. Modelos de fecha y hora interpretadas en el entorno local de los EE. UU.

Modelo de fecha y hora Resultado

'd M yy' 4 8 10

'dd MM yy' 04 08 10

'ddd MMM yyy' 004 Ago 2010

'dddd MMMM yyyy' 0004 Agosto 2010

"yyyy.MM.dd G 'at' HH:mm:ss z" 2010.08.04 AD a las 12:08:56 PDT


Tabla 37. Modelos de fecha y hora interpretadas en el entorno local de los EE.UU. (continuación)

Modelo de fecha y hora Resultado

"EEE, MMM d, ''yy" Sáb, Ago 4, '10

"h:mm a" 12:08 PM

"hh 'o'clock' a, zzzz" 12 o'clock PM, Pacific Daylight Time

"K:mm a, z" 0:08 PM, PDT

"yyyyy.MMMMM.dd GGG hh:mm aaa" 02010.Agosto.04 AD 12:08 PM

"EEE, d MMM yyyy HH:mm:ss Z" Sáb, 4 Ago 2010 12:08:56 -0700

"yyMMddHHmmssZ" 100704120856-0700

Operadores booleanosC-SQL sigue el uso que SQL-99 hace de la lógica de tres valores (TRUE, FALSE yUNKNOWN) para aceptar la semántica de valor nulo.

Por ejemplo:WHERE OnSale IS TRUE

WHERE (Age >= 21) IS UNKNOWN

Tabla de verdad para NOT

Al utilizar operadores booleanos para evaluar si una expresión es verdadera, losvalores se evalúan según se describe en las tablas de verdad:

Tabla 38. Tabla de verdad para NOT

NOT TRUE FALSE UNKNOWN

FALSE TRUE UNKNOWN

Tabla de verdad para AND

La tabla siguiente es una tabla de verdad para AND.

Tabla 39. Tabla de verdad para AND

AND TRUE FALSE UNKNOWN

TRUE TRUE FALSE UNKNOWN

FALSE FALSE FALSE FALSE

UNKNOWN UNKNOWN FALSE UNKNOWN

Tabla de verdad para OR

La tabla siguiente es una tabla de verdad para OR.

Tabla 40. Tabla de verdad para OR

OR TRUE FALSE UNKNOWN

TRUE TRUE TRUE TRUE

FALSE TRUE FALSE UNKNOWN

UNKNOWN TRUE UNKNOWN UNKNOWN


Tabla de verdad para IS

La tabla siguiente es una tabla de verdad para IS.

Tabla 41. Tabla de verdad para IS

IS TRUE FALSE UNKNOWN

TRUE TRUE FALSE FALSE

FALSE FALSE TRUE FALSE

UNKNOWN FALSE FALSE TRUE

En las comparaciones, TRUE es mayor que FALSE.



Capítulo 10. Flujos de datos

Las tablas de flujos de datos reciben eventos. Los eventos son datos producidospor aplicaciones empresariales externas que registran transacciones, identificancambios en un estado de negocio y sintetizan los detalles de las actividadesempresariales.

IBM Cognos Real-time Monitoring recibe eventos en tablas de flujos de datos. Loseventos guían el procesamiento interno de Cognos Real-time Monitoring.

Se crean vistas en las tablas de flujos de datos, y después se agrega la informaciónde evento y guían las reglas que buscan condiciones de negocio excepcionales.

Para obtener más información, consulte: Capítulo 36, “Vistas”, en la página 361 yCapítulo 28, “Reglas”, en la página 317.

En esta sección se describe cómo funcionan las tablas de flujos de datos, losorígenes externos que soportan, sus propiedades, y cómo crear y editar tablas deflujos de datos.

Funcionamiento de los flujos de datosLos eventos proceden de aplicaciones empresariales, bases de datos y archivos detexto.

Normalmente, los agentes reciben o recuperan automáticamente los datos deeventos y los cargan en una tabla de flujos de datos. También puede cargarautomáticamente los datos de los archivos de texto con IBM Cognos Real-timeMonitoring Workbench. Los eventos se procesan según van llegando y los datos delos eventos se pasan a las vistas empresariales. A continuación, las vistas agreganlos datos y recuperan los datos de las tablas de consulta relacionados con elevento.

Flujo datosTabla de consulta

EmpresarialEmpresarial

Cargar evento

DBM

Sin formato

Agente

Agente

Agente

Los flujos de datos pasan a las tablas de consulta desdeaplicaciones empresariales, bases de datos o archivos de texto. A continuación, los eventos pasan a las vistas empresariales.

Figura 9. Funcionamiento de los flujos de datos


Los eventos se procesan en el orden en que los recibe el sistema. Cuando unagente recibe una gran cantidad de eventos, los eventos nuevos que reciban otrosagentes se pondrán en cola tras el primer conjunto, y no se procesarán hasta que elprimer conjunto se haya procesado.

Orígenes de eventos externos para flujos de datosLos agentes pueden acceder a varios orígenes de eventos externos para flujos dedatos.

Para obtener más información acerca de cómo IBM Cognos Real-time Monitoringproporciona agentes para recuperar y recibir datos de eventos, consulte: Capítulo 4,“Agentes”, en la página 23.

Algunos eventos, cuando se producen, entran (o se insertan) en las tablas de flujosde datos. Otros eventos se cargan o se incorporan en las tablas de flujos de datoscomo resultado de una consulta, como por ejemplo desde una base de datos o unarchivo de texto. La siguiente tabla resume los orígenes de eventos disponibles eidentifica el agente de origen al que soportan, y si los datos se extraen o seinsertan en la tabla de flujos de datos.

Tabla 42. Orígenes de eventos

Origen externo AgenteInserción o extracción deflujos de datos

Common EventInfrastructure

Ninguno. (Consulte:Capítulo 7, “Common EventInfrastructure”, en la página57)

Inserción

Java Messaging Service (JMS) Java Messaging Service (JMS)(consulte: Capítulo 17, “JavaMessaging Service”, en lapágina 219)

Inserción

Archivo te texto (XML o sinformato)

Archivos sin formato(consulte: Capítulo 13,“Archivos sin formato”, en lapágina 103)

Extracción

TIBCO Rendezvous (RV) TIBCO Rendezvous(consulte: Capítulo 33,“TIBCO Rendezvous”, en lapágina 345)

Inserción

Acción HTTP Post HTTP Post (consulte:Capítulo 16, “HTTP Post”, enla página 213)

Inserción

Salesforce Salesforce (consulte:Capítulo 29, “Salesforce”, enla página 323)

Extracción

Servicio web Ninguno. (Consulte:“Flujosde datos del servicio web”en la página 375.)

Inserción


Atributos de flujo de datosCada tabla de flujos de datos tiene un nombre, una descripción y un atributo deestado, y la mayoría de ellas tienen un agente.

En la tabla siguiente se describen los atributos:

Tabla 43. Atributos de flujo de datos


Nombre Identifica la tabla y es el nombre al que acceden las vistasempresariales que dependen de esta tabla.

El nombre debe ser exclusivo entre todos los objetos de lamisma carpeta (incluidos los objetos del panel de control ylos paneles de control). La carpeta raíz también contieneobjetos globales como usuarios y roles, y actividadesempresariales. Para obtener más información, consulte:“Espacio de nombres de objeto” en la página 277.

Guardar en Especifica la carpeta en la que se va a almacenar la tablade flujos de datos. Para seleccionar o crear una carpeta,pulse el botón Seleccionar carpeta. Si no especificaninguna carpeta, el valor predeterminado es Carpetapública.

Descripción Descripción opcional que puede contener cualquiercarácter de texto.

Estado Especifica si el objeto está habilitado (preparado pararecibir datos) o inhabilitado (no preparado para recibirdatos).

Agente Agente que recibe o recupera la información de flujos dedatos, y transfiere los datos a la tabla de flujos de datos.Para obtener información sobre los tipos de agente,consulte: Capítulo 4, “Agentes”, en la página 23.

Habilitar recuperación Cuando está habilitado, registra los datos de un eventoque se reciben después de que se inicie el punto decomprobación. Este registro de recuperación se utiliza pararestaurar el estado del sistema después de un cierreanómalo de los servidores. Para obtener más detalles,consulte la información sobre el punto de comprobación yla recuperación en la publicación IBM CognosReal-timeMonitoring Workbench Guía del usuario.

Procesar datos según ordende llegada

Seleccione esta opción cuando los eventos debanprocesarse en el orden en el que se reciben. De otro modo,si los eventos se pueden procesar en otro orden, inhabiliteeste atributo. Para unir los eventos en una vista, loseventos se deben procesar por orden. Deje esta opciónhabilitada para unir los eventos.

Creación de tablas de flujos de datosPuede crear una tabla de flujos de datos para la recepción de los eventos.

Consejo:

Utilice la opción Tratar todas las filas del conjunto de resultados como un soloevento sólo si no hay ninguna otra opción disponible. Si bien activar esta opción

Capítulo 10. Flujos de datos 87

puede dar lugar a que se procese un número mayor de filas por segundo, tambiénpuede degradar la respuesta del usuario, es decir, el tiempo necesario para renovarla interfaz de usuario. Asimismo, habilitar esta opción puede suponer un mayoruso de memoria transitoria, por lo que, si se alcanza el límite de memoria física, elnúmero de filas procesadas por segundo también se reduce.

La finalidad de la opción Borrar siempre estado para datos nuevos es borrar elestado en una hora específica cada día o mes. No obstante, cuando se utiliza encombinación con la opción Tratar todas las filas del conjunto de resultados comoun solo evento (que no aprovecha las capacidades de flujo de datos de CognosReal-time Monitoring), muchas filas de datos se lean y procesan varias veces. Estotiene un efecto negativo sobre el rendimiento y debe evitarse.

Al especificar un tipo de origen para un flujo de datos, observe que cada tipo tieneatributos específicos. Si desea ver más información, consulte los temas siguientes:v Capítulo 13, “Archivos sin formato”, en la página 103v Capítulo 16, “HTTP Post”, en la página 213v Capítulo 17, “Java Messaging Service”, en la página 219v Capítulo 18, “Java Database Connectivity”, en la página 225v Capítulo 29, “Salesforce”, en la página 323v Capítulo 33, “TIBCO Rendezvous”, en la página 345v Capítulo 37, “servicios web”, en la página 375

Antes de empezar

Antes de crear una tabla de flujos de datos, debe disponer de permiso de creaciónpara tablas y de permiso de acceso de sólo lectura para el agente que proporcionadatos a la tabla.

Para obtener información acerca del permiso de creación, consulte: “Cómo otorgarpermiso para crear objetos” en la página 294.

Procedimiento1. En IBM Cognos Real-time Monitoring Workbench, pulse la pestaña Workbench.2. Pulse Actividades.3. Seleccione Crear nuevo.4. Seleccione Flujo de datos.5. Seleccione el tipo de origen.6. Complete los campos del formulario del flujo de datos nuevo.7. Guarde el objeto como habilitado.

Inmediatamente, el objeto estará preparado para recibir datos.

Edición de tablas de flujos de datosPuede editar los atributos de las tablas de flujos de datos.

Atención: La edición de los atributos de una tabla de flujos de datos da lugar aque el objeto pierda el estado, y podría invalidar las vistas dependientes. Porejemplo, si elimina una columna, cualquier vista o regla que haga referencia a esacolumna dejará de ser válida. Sin embargo, si vuelve a definir la columna en latabla, las vistas dependientes volverán a validarse automáticamente.


Cada tipo de flujo de datos tiene atributos específicos propios. Para obtenerinformación, consulte las secciones siguientes:v Capítulo 13, “Archivos sin formato”, en la página 103v Capítulo 16, “HTTP Post”, en la página 213v Capítulo 17, “Java Messaging Service”, en la página 219v Capítulo 18, “Java Database Connectivity”, en la página 225v Capítulo 29, “Salesforce”, en la página 323v Capítulo 33, “TIBCO Rendezvous”, en la página 345v Capítulo 37, “servicios web”, en la página 375

Antes de empezar

Antes de editar una tabla de flujos de datos, debe disponer de permisos de lecturay escritura para tablas y de permiso de acceso de sólo lectura para el agente queproporciona datos a la tabla. Para obtener más información, consulte: “Permisos deacceso” en la página 291.

Procedimiento1. En IBM Cognos Real-time Monitoring Workbench, pulse la pestaña Workbench.2. Seleccione Flujos de datos.3. En Nombre de objeto, seleccione el flujo de datos que desea editar.4. En el menú Actividades, pulse en Editar.5. Cambie las definiciones según proceda.6. Guarde el objeto como habilitado.

Inmediatamente, el objeto estará preparado para recibir datos.

Capítulo 10. Flujos de datos 89


Capítulo 11. Dimensiones

Las dimensiones son órdenes de clasificaciones de datos relacionados y se utilizanen los cubos para clasificar las mediciones.

Una dimensión es un orden de clasificaciones que, del nivel más alto al nivel másbajo, describen conjuntos cada vez menores de datos relacionados. En la siguientetabla se presentan algunos ejemplos de dimensiones en los que el nivel superior decada lista contiene el conjunto de elementos relacionados más grande y el nivelinferior contiene el conjunto más pequeño.

Tabla 44. Ejemplos de dimensiones

Hora Geografía Inventario Seguridad Taxonomía

año

trimestre

mes

semana

día

hora

minuto

continente

país o región

región

estado

condado

ciudad

distrito

clasificación

tipo

fabricante

modelo

configuración

tipo

clasificación

empresa

CUSIP

reino

grupo

clase

orden

familia

género

especie

Los cubos categorizan mediciones por dimensiones, y dentro de las dimensiones,por niveles y valores. Por ejemplo, una dimensión de ubicación puede filtrar losresultados para mostrar las mediciones para todas las ciudades de un estado. En lailustración siguiente se muestran diversas ubicaciones filtradas por nombre deestado, que limita las mediciones a tres ciudades.

Figura 10. Ubicaciones filtradas por nombre de estado


Las dimensiones toman sus valores de las tablas de consulta, donde cada nivel dedimensión es una columna de la tabla, y cada fila es un elemento exclusivo dedimensión. En el ejemplo mostrado en la ilustración anterior, los nombres deregión están en una columna, los estados en otra, y las ciudades en la terceracolumna. Cuando se crea una dimensión, se identifica la tabla de consulta deorigen existente y las columnas que se deben incluir, y se organizan las columnasen la jerarquía de niveles.

Jerarquía de nivelesLa jerarquía de niveles es la que permite replegar y detallar más en los cubos.Cuando un usuario está viendo datos de un nivel, puede replegar para ver unnivel superior de mediciones, o bien detallar más para ver los datos categorizadosen el siguiente nivel inferior.

Por ejemplo, si se están consultando los resultados de un estado, el usuario puededecidir replegar para ver la medición de todos los estados de la región. Tambiénpuede pulsar en los resultados para ver los resultados por cada ciudad del estado.La jerarquía de niveles define los niveles de la dimensión.

La siguiente ilustración muestra cuatro columnas en el archivo de origen, pero sólotres de ellas contienen datos sobre el nivel de dimensión. Estas tres se seleccionany se organizan en la jerarquía que las contiene del nivel más alto al más específico.

Si selecciona Utilizar esto para los gráficos geográficos, aparecerá la columnaCategorías geográficas. Para obtener más información sobre las categoríasgeográficas, consulte: “Categorías geográficas”.

Nombres de alias en cubosTras identificar las columnas, puede asignar opcionalmente nombres de alias quelos usuarios ven cuando trabajen con el cubo.

Campo de la columna Order ByEn IBM Cognos Real-time Monitoring Dashboard, los valores de dimensión sepresentan por orden de clasificación tal como los proporciona el servidor.

Por ejemplo, aparece una lista de nombres de mes por orden alfabético,empezando por abril y terminando por septiembre, en vez de en el orden en queaparecen en el año. Para especificar otro orden, utilice el campo de columna OrderBy. Este campo identifica otra columna que contiene los valores que se van autilizar para la ordenación. Por ejemplo, en vez de utilizar la columna de nombrede mes, utilice la columna de número de mes.

Asimismo, si el campo de columna Order By contiene varios valores quecorresponden a un único valor en la dimensión, se utiliza el valor mínimo de lacolumna Order By para el orden de clasificación. En esos casos, debe prestaratención al seleccionar la columna que se va a utilizar para los ordenar los valores.Por ejemplo, si se utilizan los nombres de mes como orden de clasificación para lostrimestres, se producirían resultados imprevisibles porque los meses se ordenaríande forma alfabética en vez de por orden numérico.

Categorías geográficasLas categorías geográficas permiten usar la información geográfica en cubos.


Un valor de categoría geográfica especifica el nivel de precisión IBM CognosReal-time Monitoring Dashboard utiliza para la columna. Por ejemplo, si unacolumna contiene los nombres de estados o provincias, la categoría geográfica quese le asignará será Estado o provincia.

Las categorías disponibles son:v No utilizadov País o regiónv Estado o provinciav Ciudadv Callev Código postal

Utilice la categoría No utilizado para la columna que no desee correlacionar en ungráfico geográfico o que no coincida con ninguna categoría disponible. Porejemplo, una columna REGION_NAME que contiene datos como Norte, Sur, Este yOeste no puede correlacionarse con una ubicación geográfica, por lo que estacolumna se asignaría a la categoría geográfica No utilizado.

Columnas de clavesPara utilizar la tabla de consulta como una dimensión, los datos de evento debenidentificar el elemento único (fila) de la dimensión a la que pertenece.

En los datos de la tabla de consulta de ubicaciones, el valor único de cadaelemento es el nombre de la ciudad; sin embargo, aunque ese nombre se podríautilizar con fines de identificación, es mejor utilizar un número por motivos derendimiento.

Los datos de la tabla de consulta de ubicaciones deben tener un entero como ID,tal como se indica a continuación:region_id region_name region_state region_city

--------- ----------- ------------ ------------

1 West Nevada Reno

2 South Texas Austin

3 East New York Rochester

4 Central Ohio Toledo

5 West California Pasadena

...

La tabla de hechos que proporciona el valor del cubo que se debe medir tambiénincluye el valor de clave para identificar la dimensión asociada. Por ejemplo, esteregistro de órdenes está asociado con Ojai (California), en la región West:order_id region_id total_sales...

-------- --------- -----------

102341 7 120000...

El tipo de datos para la clave de la tabla de hechos debe ser el mismo que para laclave de la dimensión (tabla de consulta). No puede, por ejemplo, mezclar enterosy decimales; los dos deben ser o enteros o decimales.

Cuando defina la dimensión, identifique uno o varios campos de clave que puedanutilizarse para identificar el nivel específico. Puede seleccionar cualquier columna

Capítulo 11. Dimensiones 93

que todavía no sea un nivel de dimensión, porque automáticamente se presuponeque los niveles son claves potenciales. La siguiente ilustración muestra unacolumna, REGION_ID, porque todo el resto de las columnas de la dimensión estánasignadas a niveles. Posteriormente, cuando defina el cubo, identifique la columnade claves de la dimensión que se correlacione con la clave en la tabla de hechos.

Para obtener información sobre cómo definir cubos, consulte: “Creación de cubos”en la página 65.

Creación de dimensionesPuede crear dimensiones para utilizarlas en los cubos.

Consejo: Active el almacenamiento en la memoria caché para la tabla de consultapara obtener un rendimiento óptimo. Cuando el almacenamiento en la memoriacaché está desactivado, el rendimiento de los cubos podría experimentar unaralentización importante. Para obtener más información, consulte:“Almacenamiento de consultas de tabla de consulta en la memoria caché” en lapágina 265.

Antes de empezar

Antes de crear una dimensión, debe disponer de permiso de creación para vistas,cubos y dimensiones y disponer de, como mínimo, acceso de sólo lectura para latabla de consulta que proporciona los elementos de dimensión.

Para obtener más información, consulte: Capítulo 20, “Tablas de consulta”, en lapágina 261.

Después de haber creado una dimensión, puede utilizar ésta inmediatamente enlos cubos. Para obtener más información, consulte: Capítulo 8, “Cubos”, en lapágina 63.


Workbench.2. Pulse Actividades.3. Seleccione Crear nuevo > Dimensión.4. Especifique un nombre para la dimensión en el campo Nombre y,

opcionalmente, proporcione una descripción de la dimensión.5. Pulse en Examinar para seleccionar la tabla de consulta que contiene los

elementos de dimensión.6. En la ventana Seleccionar objeto, seleccione el objeto que ha de utilizarse para

la Tabla de hechos.7. Pulse Aceptar.8. Seleccione Utilizar esto para los gráficos geográficos si ha planificado

implementar mapas geográficos. Esto añade una columna Categoríasgeográficas a la lista Campos seleccionados.

9. Defina los niveles de la jerarquía:v Añada campos a la jerarquía desde la lista Campos disponibles.v Ordene los niveles, desde el conjunto más grande (parte superior) hasta el

más pequeño (parte inferior).v Identifique la columna o columnas de claves que han de incluirse.


v Opcionalmente, asigne nombres de alias a los niveles.v Opcionalmente, asigne categorías geográficas a cada nivel, si ha

seleccionado la casilla de verificación Utilizar esto para los gráficosgeográficos. Las categorías posibles son No utilizado, País o región, Estadoo provincia, Ciudad, Calle y Código postal.

10. Guarde la dimensión.

Capítulo 11. Dimensiones 95


Capítulo 12. Sistema de archivos de Cognos Real-timeMonitoring

Sistema de archivos que se utiliza para cargar datos de un archivo sin formato enuna tabla de consulta.

Si utiliza archivos sin formato para datos de tabla de consulta, también puederecuperar datos de un archivo y almacenarlos en una base de datos local a travésde la opción Almacenamiento de JDBC.

Para obtener más información, consulte: “Tablas de consulta de archivos sinformato”.

Tablas de consulta de archivos sin formatoEl agente de sistema de archivos carga datos de un archivo sin formato en unatabla de consulta a través de un procesamiento de modo de proceso por lotes.

Basándose en una planificación de invalidación, el agente de sistema de archivoslee periódicamente el archivo sin formato. Cuando se lee el archivo, el agenterecupera los datos y los pasa a la tabla de consulta para que se procesen.

Las tablas de consulta creadas a partir de archivos sin formato reciben datoscargando datos de un archivo sin formato en IBM Cognos Real-time MonitoringWorkbench. Los dos formatos de archivo sin formato para datos de tabla deconsulta son:v Archivos delimitadosv Archivos de anchura fija

Para obtener más información sobre estos tipos de archivo, consulte: Capítulo 13,“Archivos sin formato”, en la página 103.

Para poder crear una tabla de consulta a partir de los datos de un archivo sinformato, debe tener permisos de creación para tablas y permiso de acceso de sólolectura en el agente que proporciona datos a la tabla.

Para los archivos de anchura fija y los archivos delimitados, es interesante tener unarchivo de ejemplo que contenga datos con el mismo formato que los datos realespara la tabla de consulta. Utilice el ejemplo al crear la tabla de consulta paragarantizar que los campos se correlacionen correctamente en la tabla. El uso de un

El agente de sistema de archivosrecupera y procesa un archivo sinformato y pasa el contenido a una tabla de consulta.

Tabla de consulta

Pasa contenidos dearchivo a tabla de consulta

Agente de sistema dearchivos

busca archivo

Recupera el archivoencontrado y tratacon el archivo

Figura 11. Flujo de trabajo para archivos sin formato


archivo de ejemplo es opcional. Se puede crear la tabla de consulta sin un origen,pero tener uno supone una gran ayuda en el proceso de creación.

En la tabla siguiente se describen los atributos básicos para las tablas de consulta apartir de archivos sin formato. Estos atributos son parecidos a los atributos de lastablas de flujos de datos que se utilizan con archivos sin formato. Para obtener másinformación sobre los archivos sin formato, consulte: Capítulo 13, “Archivos sinformato”, en la página 103.

Tabla 45. Atributos de tablas de consulta a partir de archivos planos


NombreIdentifica la tabla de consulta.

Especifica si el objeto está habilitado (preparado para recibirdatos) o inhabilitado (no preparado para recibir datos).


Guardar en Especifica la carpeta en la que se almacenará la tabla deconsulta. Para seleccionar o crear una carpeta, pulse el botónSeleccionar carpeta. Si no especifica ninguna carpeta, el valorpredeterminado es Carpeta pública.

Descripción Descripción opcional que puede contener cualquier carácterde texto.

Agente de sistema dearchivos

Agente de sistema de archivos existente que recupera flujosde datos y datos de tabla de consulta de un archivo de texto.Cree un agente con Cognos Real-time MonitoringWorkbench. Para obtener más información, consulte:“Agentes de sistema de archivos” en la página 32.

Ruta de raíz La ruta raíz especificada al crear el agente de sistema dearchivos.

Ruta relativa Ruta relativa a la ruta raíz del archivo de texto que debeleerse para buscar datos de tabla.

Iniciar importación en lafila

Para archivos delimitados y de anchura fija, identifica la filade texto en el archivo de origen que contiene los primerosdatos que se deben importar. El valor predeterminado es 1, laprimera fila. Utilice esta opción si el texto contieneinformación de introducción o cabecera innecesaria.

Deshabilitar tabla deconsulta después de estenúmero de erroresconsecutivos

Número de errores consecutivos recibidos del sistema antesde que se inhabilite la tabla de consulta. Una vezinhabilitadas, las tablas de consulta deben volver a habilitarsemanualmente. El valor predeterminado es 5.

Utilizar esta fila para losnombres de columna

Al utilizar un archivo de ejemplo para archivos de anchurafija y delimitados, esta opción identifica una fila en elejemplo que incluye los nombres de columna. Estos nombresidentifican cada columna de la pestaña Información decampo. Cuando esta opción no está seleccionada, los nombrespredeterminados son Campo1, Campo2, etcétera.

Omitir filas que utilicen laexpresión regular siguiente

Para archivos de anchura fija y delimitados identifica las filasque se ignorarán en el archivo de origen antes de importardatos de flujo de datos. Por ejemplo, si el archivo tiene unafila que contiene ???, el origen puede empezar en la tercerafila del archivo. En ese caso, se especificaría ??? y se omitiríanlas filas con esa expresión regular.


Tabla 45. Atributos de tablas de consulta a partir de archivos planos (continuación)


Permitir filas cortas Sólo para archivos delimitados. Para obtener informaciónacerca de los archivos delimitados, consulte: “Archivosdelimitados” en la página 109.

Delimitador Sólo para archivos delimitados. Para obtener informaciónacerca de los archivos delimitados, consulte: “Archivosdelimitados” en la página 109.

Carácter de escape Sólo para archivos delimitados. Para obtener informaciónacerca de los archivos delimitados, consulte: “Archivosdelimitados” en la página 109.

Calificador de texto Sólo para archivos delimitados. Para obtener informaciónacerca de los archivos delimitados, consulte: “Archivosdelimitados” en la página 109.

Formatos de número Especificaciones de formato de número. De formapredeterminada, se utiliza la coma (,) como separador demillares, y el punto (.) como separador decimal.

Pestaña Información de campoPara archivos delimitados y de anchura fija, utilice esta pestaña para especificar lainformación sobre cada columna de la tabla, como por ejemplo el nombre, el tipode datos y el formateo aplicable al tipo.

Tabla 46. Atributos de las columnas de tabla

Atributos Descripción

Nombre de la columna Utilice este campo para cambiar el nombrepredeterminado de la columna (Campo1, Campo2,etc.) por otro nombre, o si desea corregir o cambiarel nombre de archivo importado desde un archivode ejemplo.

Índice Cuando se selecciona, se crea un índice para elcampo. Es fundamental seleccionar el índicecorrecto para conseguir un buen rendimientocuando está activado el almacenamiento de JDBCpara el almacenamiento en la memoria caché.Seleccione Índice para las columnas que utilice enlas condiciones de unión.

Tipo de datos Especifica el tipo de datos para la columna. El tipode datos para la columna seleccionada debecoincidir con el tipo de datos de la otra columnautilizada para la unión.

Formateo Especifica el formateo para el tipo de datos. Esteformateo sólo se aplica a los tipos de datosDECIMAL, TIMESTAMP y VARCHAR. Paracambiar el formato, seleccione <Cambiarformateo> en la lista desplegable.

La pestaña Almacenamiento de datos en memoria cachéPuede utilizar esta pestaña para especificar las opciones de almacenamiento dedatos en memoria caché.

Capítulo 12. Sistema de archivos de Cognos Real-time Monitoring 99

Los valores para el almacenamiento de datos en la memoria caché son: Tipo dememoria caché, Recuperar y almacenar al reiniciar, Retirada al origen externo,Número de conjuntos de resultados a guardar en memoria caché y Planificación deinvalidación.

Tipo de memoria cachéPuede utilizar almacenamiento en memoria o almacenamiento JDBC parael almacenamiento de datos en memoria caché.v En la memoria

Cuando se habilita el almacenamiento en caché en memoria, se almacenaen la memoria caché toda la tabla de consulta externa del origen dedatos externo, convirtiéndose en una alternativa al origen de consultasexterno. Habilitar el almacenamiento en la memoria caché es lo mismoque seleccionar el almacenamiento de datos en caché conprerrecuperación para los orígenes de tabla de consulta de agentes deservicio JDBC y web, como se describe en “Almacenamiento de datos encaché con prerrecuperación” en la página 266.Si selecciona esta opción, Almacenamiento de JDBC no está disponible,y el campo Agente JDBC aparece inhabilitado.

v Almacenamiento de JDBC

Cuando selecciona Almacenamiento de JDBC, los datos de la tabla deconsulta se envían a una base de datos local, tal como lo hayaespecificado el Agente JDBC.La lista desplegable Agente JDBC muestra los agentes disponibles.Seleccione el agente que debe utilizarse para la base de datos local.

Recuperar y almacenar al reiniciarEsta opción especifica que al reiniciar IBM Cognos Real-time Monitoring, elsistema siempre recupera los datos del origen de consultas externo y losalmacenará en la base de datos local. De lo contrario, si existe un almacénlocal previamente rellenado, éste se utiliza hasta la siguiente planificaciónde invalidación. Si no existe ningún almacén local previamente relleno, serealiza una consulta al origen externo inmediatamente después del reinicio.

Retirada al origen externoEsta opción especifica que si el sistema no puede acceder a la base dedatos local, utilizará los datos de la base de datos externa. Esta opción noestá disponible al configurar una tabla de consulta basada en un agente desistema de archivos.

Número de conjuntos de resultados a guardar en memoria cachéEsta opción especifica el recuento de conjuntos de resultados que se debenalmacenar en la memoria caché. Cada conjunto de resultados puedecontener una o varias filas de datos de tabla de consulta relacionadas conel flujo de datos. Por ejemplo, si se realizan tres consultas y cada conjuntode resultados contiene cinco filas, se almacenarán 15 filas en la memoriacaché.

Planificación de invalidaciónIdentifica cuándo se debe invalidar la memoria caché y descartar toda lainformación que hay actualmente en la memoria caché, por ejemplo a las06:00 de cada lunes.

Borrado de la memoria cachéPuede añadir una planificación para indicar cuándo se debe borrar la memoriacaché.


Procedimiento1. En la pestaña Almacenamiento de datos en memoria caché, pulse Agregar

planificación.2. Seleccione la hora u horas en que desea que se borre la memoria caché.

Creación de una tabla de consulta a partir de un archivo sinformato

Puede utilizar un archivo sin formato como tipo de origen para una tabla deconsulta.

Acerca de esta tarea

La creación de una tabla de consulta a partir de un archivo sin formato es similaral procedimiento para crear orígenes de flujo de datos a partir de archivos sinformato. Para obtener información detallada acerca del tipo de origen, consulte:v “Archivos delimitados” en la página 109.v “Archivos de anchura fija” en la página 110.


Workbench y, a continuación, pulse el botón Actividades.2. Seleccione Crear nuevo y seleccione Tabla de consulta.3. Seleccione Sistema de archivos como origen de la tabla de consulta.4. (Opcional para archivos de anchura fija y delimitados.) Identifique un archivo

de ejemplo como ayuda para correlacionar las columnas. Este archivo es unejemplo del archivo de datos real. Los datos de este archivo aparecerán en elsiguiente paso para ayudarle a medida que correlaciona los datos de tabla deconsulta en la tabla.

5. Para los archivos de anchura fija, defina las posiciones de las columnas dedatos con la ventana Establecer anchuras de campo.

6. Defina la información de campo específica del formato: delimitado o anchurafija.

7. Pulse en la pestaña Almacenamiento de datos en memoria caché.8. Seleccione el Tipo de memoria caché.

v La habilitación de En la memoria como el tipo de almacenamiento de datosen memoria caché que ha de utilizarse es lo mismo que seleccionar Habilitarprerrecuperación para los orígenes de datos JDBC y de servicio web. Paraobtener información acerca del almacenamiento de datos en caché conprerrecuperación, consulte: “Almacenamiento de datos en caché conprerrecuperación” en la página 266.

v La habilitación de Almacenamiento de JDBC como tipo de almacenamientode datos en memoria caché especifica que ha de utilizarse el mecanismo derecuperación y almacenamiento para el almacenamiento de datos enmemoria caché. Para obtener más información sobre la recuperación y elalmacenamiento, consulte: “Almacenamiento en memoria caché de almacénJava Database Connectivity” en la página 267.

9. Guarde el origen de archivo como habilitado.

Capítulo 12. Sistema de archivos de Cognos Real-time Monitoring 101


Capítulo 13. Archivos sin formato

Un archivo sin formato es un archivo de texto que contiene la información sobreuno o varios eventos o datos de tabla de consulta.

Con los archivos sin formato para flujos de datos, cada línea del archivo suele serun registro de evento (una fila en la tabla de flujos de datos) y los datos de la filase correlacionan con las columnas de la tabla de flujos de datos. Las filas puedentener un formato de archivo de anchura fija, delimitado o XML. Los archivos deanchura fija o delimitados pueden contener varias filas para los mismos eventos.Para obtener más información, consulte: “Eventos de varias filas” en la página 107.

Para datos de archivos sin formato para tablas de consulta, cada línea del archivoes una fila (o un registro). Los datos de la fila se correlacionan con las columnas dela tabla de consulta. Las filas pueden tener un formato de archivo de anchura fija,delimitado o XML.

Datos de archivos sin formatoPuede utilizar datos de archivos sin formato para cargar datos de eventos de unarchivo de texto en una tabla de flujos de datos de archivo sin formato. En estasección se describe cómo funcionan los datos de archivos sin formato y cómo crearuna tabla de flujos de datos a partir de un origen de archivos sin formato.

Funcionamiento de los datos de archivos sin formatoLos eventos de archivos sin formato se cargan en modo de proceso por lotesdentro de la tabla de flujos de datos de archivos sin formato, aunque los eventos seprocesan individualmente a medida que se cargan en la tabla.

Existen dos formas de cargar archivos sin formato en tablas de flujos de datos:v Automáticamente

El agente de archivos sin formato (consulte: la sección “Agente de archivos sinformato” en la página 28) busca periódicamente si el archivo asociado existe.Cuando encuentra el archivo, el agente lo recupera y lo pasa al objeto de flujode datos para el procesamiento de flujos de datos.

v ManualmenteEl botón Cargar archivo de datos de la página de detalles para cargar el archivosin formato en la tabla de flujos de datos carga un archivo seleccionadomanualmente. Para obtener más detalles, consulte la publicación IBMCognosReal-time Monitoring Workbench Guía del usuario.


Tablas de flujos de datos de los archivos sin formatoLas tablas de flujos de datos para archivos sin formato reciben archivos de datosde los agentes de archivos sin formato o cargando un archivo de datos en IBMCognos Real-time Monitoring Workbench.

Los tres formatos de archivo sin formato se describen del siguiente modo:v “Archivos delimitados” en la página 109.v “Archivos de anchura fija” en la página 110.v “Soporte de archivos XML” en la página 111.

Antes de crear datos a partir de un archivo sin formato para una tabla de flujos dedatos, debe cumplir los siguientes requisitos previos:v Permisos

Cree permisos (consulte: Capítulo 23, “Permisos”, en la página 291) para lastablas (consulte: “Cómo otorgar permiso para crear objetos” en la página 294), yacceso de sólo lectura para el agente que rellena la tabla.

v Archivos de anchura fija y delimitados de ejemplo (Opcional)Archivo de ejemplo que contiene datos en el formato de los eventos reales.Utilice el ejemplo al crear el objeto de flujo de datos para garantizar que loscampos se correlacionen correctamente con la tabla de flujos de datos. Esopcional. Se puede crear el objeto de flujos de datos sin origen, pero tenerloayuda en gran medida a la hora de crear un objeto de flujo de datos.

v Esquema de los archivos XML para cargarEn concreto, es necesario conocer los nombres de los atributos que contienen lainformación de columna del evento, y la ruta XML al elemento que contiene lascolumnas para cada evento. Para obtener información, consulte: “UbicaciónXPath de columnas y filas en archivos XML” en la página 111. La siguiente tabladescribe los atributos.

El agente de archivos sin formato puede cargar automáticamente secuenciasde datos a partir de archivos sin formato, o bien el usuario puede cargarlosmanualmente con el botón para cargar un archivo de secuencias de datos.

Botón CargarArchivo de datos

Agente de archivosin formato

Tabla de flujo de datosArchivo para buscar

Pasa contenidos de archivoa tabla de evento

Pasa contenidos de archivo a tabla de flujo de datos

Busca archivo

Recupera archivoencontrado y gestionael archivo

Busca archivo

Recupera los contenidosde archivo encontrado ydeja el archivo

Tabla de flujo de datos

Figura 12. Carga de datos en una tabla de flujos de datos


Tabla 47. Atributos de información sobre columnas


NombreIdentifica el objeto de flujo de datos.



Guardar en Especifica la carpeta en la que se almacenará el objeto de flujode datos. Para seleccionar o crear una carpeta, pulse el botónSeleccionar carpeta. Si no especifica ninguna carpeta, el valorpredeterminado es Carpeta pública.

Descripción Descripción opcional que puede contener cualquier carácter detexto.

Habilitar recuperaciónCuando está habilitado, registra los datos de un evento que sereciben después de que se inicie el punto de comprobación.Este registro de recuperación se utiliza para restaurar el estadodel sistema después de un cierre anómalo de los servidores.Para obtener más detalles, consulte la información sobre elpunto de comprobación y la recuperación en la publicaciónIBM CognosReal-time Monitoring Workbench Guía del usuario.

Para aumentar el rendimiento de entrada/salida, dirija eldirectorio para el archivo de registro de recuperación a undisco distinto del que proporciona información a este agente.

Procesar datos segúnorden de llegada

Seleccione esta opción cuando los eventos deban procesarse enel orden en el que se reciben. De otro modo, si los eventos sepueden procesar en otro orden, inhabilite esta opción. Paraunir los eventos en una vista, los eventos se deben procesarpor orden. Deje esta opción habilitada para unir los eventos.

Agente de archivo Agente de archivo existente que recupera eventos y datos detabla de consulta de un archivo de texto. Crear un agentemediante la pestaña Workbench. Para obtener másinformación, consulte: “Agente de archivos sin formato” en lapágina 28.

Iniciar importación en lafila

Para archivos delimitados y de anchura fija, identifica la fila detexto en el archivo de origen que contiene los primeros datosque se deben importar. El valor predeterminado es 1, laprimera fila. Utilice esta opción si el texto contiene informaciónde introducción o cabecera innecesaria.


Inhabilita el flujo de datos cuando se produce un recuentoconsecutivo de errores. Por ejemplo, si se establece en 5,inhabilita el flujo de datos después de 5 errores consecutivos.Sin embargo, si se producen 4 errores y después no se produceningún error hasta que se producen 2 errores, el flujo de datospermanece habilitado. Está desactivado de formapredeterminada: No inhabilitar.

Capítulo 13. Archivos sin formato 105

Tabla 47. Atributos de información sobre columnas (continuación)


Utilizar esta fila para losnombres de columna

Al utilizar un ejemplo para archivos de anchura fija ydelimitados, esta opción identifica una fila en el ejemplo queincluye los nombres de columna. Estos nombres identificancada columna en los datos de Información de la columna.Cuando esta opción no está especificada, los nombrespredeterminados son Campo1, Campo2, etcétera.

Omitir filas Para archivos de anchura fija y delimitados identifica las filasque se ignorarán en el archivo de origen antes de importardatos de eventos. Por ejemplo, si el archivo contiene algunainformación de título y cabecera, el origen puede empezar enla tercera fila del archivo. En ese caso, se especificaría "2" comoel recuento de filas que se deben omitir.

Permitir filas cortas Sólo para archivos delimitados. Para obtener información,consulte: “Archivos delimitados” en la página 109.

Tratar todas las filas delconjunto de resultadoscomo un solo evento

Todas las filas devueltas en el conjunto de resultados seconsideran un evento. De lo contrario, cada fila devuelta de latabla se considera un evento por separado.

Delimitador Sólo para archivos delimitados. Para obtener más informaciónsobre los archivos delimitados, consulte: “Archivosdelimitados” en la página 109.

Carácter de escape Sólo para archivos delimitados. Para obtener más informaciónsobre los archivos delimitados, consulte: “Archivosdelimitados” en la página 109.

Calificador de texto Sólo para archivos delimitados. Para obtener más informaciónsobre los archivos delimitados, consulte: “Archivosdelimitados” en la página 109.

Formatos de número Especificaciones de formato de número. De formapredeterminada, se utiliza la coma (,) como separador demillares, y el punto (.) como separador decimal.

Información de lacolumna Para archivos de anchura fija y delimitados, Información de la

columna especifica la información sobre cada columna de latabla, como por ejemplo el nombre, el tipo de datos y elformateo aplicable al tipo. Para obtener más información,consulte: “Archivos delimitados” en la página 109 y “Archivosde anchura fija” en la página 110.

Para archivos XML, Información de la columna identifica loselementos de origen y cómo se correlacionan con las columnasde la tabla de flujos de datos. Para obtener más información,consulte: “Información de campo XML” en la página 112.

Clave de evento Para archivos delimitados y de anchura fija, identifica lascolumnas de campos de claves para eventos de varias filas.Para obtener información sobre los eventos de varias filas,consulte: “Eventos de varias filas” en la página 107.


Esta pestaña contiene varias opciones para borrar datos deeventos persistentes.

Para obtener más información sobre la pestaña Borrar intervalode estados, consulte: “Intervalo de borrado de estados” en lapágina 60.


Creación de un flujo de datos a partir de un archivo sin formatoUn flujo de datos es un objeto que representa un evento. Puede utilizar un archivosin formato para crear un flujo de datos.


Workbench y pulse el botón Actividades.2. Seleccione Crear nuevo y seleccione Flujo de datos.3. Seleccione Archivo si formato como tipo de origen.4. Seleccione Flujo de datos único.5. Opcionalmente, para archivos de anchura fija y delimitados, identifique un

archivo de ejemplo como ayuda para correlacionar las columnas. Este archivoes un ejemplo del archivo de datos real. Los datos de este archivo apareceránen el siguiente paso para ayudarle a medida que correlaciona los datos deeventos en la tabla.

6. Para los archivos de anchura fija, defina las posiciones de las columnas dedatos con la ventana Establecer anchuras de campo.

7. Identifique los atributos de flujo de datos.8. En la pestaña Información de la columna, defina la información de columna

específica del formato. Para obtener información detallada acerca del tipo deorigen, consulte:v “Archivos delimitados” en la página 109.v “Archivos de anchura fija” en la página 110.v “Soporte de archivos XML” en la página 111.

9. Guarde el flujo de datos como habilitado si desea que el flujo de datos aceptedatos inmediatamente.

Eventos de varias filasUn archivo delimitado o de anchura fija puede contener varias filas del mismoevento.

Por ejemplo, un evento de orden de compra puede contener una fila para cadaelemento de línea de la orden. Cuando este evento se carga en la tabla de flujos dedatos, cada fila se trata como parte del mismo evento. El sistema no trata cada filacomo un evento nuevo.

Para identificar las filas que contienen datos del mismo evento, cada fila debe tenerciertos datos identificativos que sean exclusivos de ese evento. Por ejemplo, lossiguientes datos de ejemplo contienen elementos de línea de tres órdenes decompra, donde cada orden se identifica por la columna POID. La primera ordentiene tres elementos, la segunda tiene uno y la tercera tiene dos.POID,ITEM_NO,ITEM_NAME,ITEM_QTY,ITEM_COST,ITEM_TOTAL

0697,1,Smoke Shifter,100,5.00,500.00

0697,2,Nano Webber,50,6.00,300.00

0697,3,Locking Rail Key,25,7.50,187.50

0698,1,Nano Webber,50,6.00,300.00

0699,1,Tall Bar Stool,100,60.00,6000.00

0699,2,Can of Levers,250,1.50,375.00

Al definir la información de columna para este evento, se debe identificar lacolumna POID como el campo de clave seleccionando Clave de evento. Cadaevento puede tener uno o varios campos de clave.


En el archivo, las filas de cada evento deben aparecer juntas, y los datos de loscampos de clave de evento deben ser exclusivos para ese evento. En cuanto losdatos de uno de los campos no coincidan con los de la fila anterior, el campo deesa fila será un evento nuevo. Por ejemplo, el caso siguiente se trata como treseventos por separado, aunque la última fila tiene el mismo valor de clave deevento que las dos primeras filas.POID,ITEM_NO,ITEM_NAME,ITEM_QTY,ITEM_COST,ITEM_TOTAL

0697,1,Smoke Shifter,100,5.00,500.00

0697,2,Nano Webber,50,6.00,300.00

0100,1,Tall Bar Stool,100,60.00,6000.00

0697,3,Locking Rail Key,25,7.50,187.50

Si alguna de las filas contiene datos no válidos, esa fila se descarta y no afecta a lasfilas posteriores. Por ejemplo, la tercera fila del siguiente caso contiene un carácter(‘X’) donde se espera que haya un entero. En este ejemplo, la tercera fila sedescarta, y la cuarta se incluye como la tercera fila del evento.POID,ITEM_NO,ITEM_NAME,ITEM_QTY,ITEM_COST,ITEM_TOTAL

0697,1,Smoke Shifter,100,5.00,500.00

0697,2,Nano Webber,50,6.00,300.00

0697,X,Tall Bar Stool,100,60.00,6000.00

0697,4,Locking Rail Key,25,7.50,187.50

Husos horarios de los archivos sin formatoPara los datos de los archivos delimitados y sin formato, puede especificar unformato de fecha para un campo de indicación de fecha y hora.

Además el formato de fecha, también se puede especificar un huso horario paraespecificar cómo interpreta el servidor el valor de indicación de fecha y hora delcampo. Es decir, cabe suponer que el valor de indicación de fecha y hora estará enel mismo huso horario que el servidor de aplicaciones u otro huso horarioespecífico. Resulta útil cuando el servidor de aplicaciones está en un huso horariodistinto del huso horario en el cual se producen los eventos, y se desea que laindicación de fecha y hora se muestre en una vista para ese huso horario. El valorpredeterminado es el huso horario en el que se encuentra el servidor.

La siguiente tabla muestra ejemplos de una indicación de fecha y hora condistintos formatos y husos horarios. Cuando el huso horario se establece enGMT+5:30 y GMT+13:00, el resultado de vista para la indicación de fecha y horamuestra la fecha como 2006-10-25 en lugar del valor de campo.

Tabla 48. Ejemplos de indicación de fecha y hora

Valor de campo en archivosin formato

Formato de indicación defecha y hora Resultado de vista

2006-10-26 09:49:12.976yyyy-MM-dd HH:mm:ss.S;Huso horario del servidor

2006-10-26 09:49:12.976

2006-10-26 09:49:12.976yyy-MM-dd HH:mm:ss.S;(GMT+5:30) Chennai,Kolkata, Mumbai...

2006-10-25 21:19:12.976

2006-10-26 09:49:12yyyy-MM-dd HH:mm:ss;(GMT+13:00)Nuku'alofa

2006-10-25 13:49:12.0


Configuración de un formato de fecha y huso horariopersonalizadosLos datos de los archivos sin formato delimitados y fijos pueden configurarse conun formato de fecha y huso horario personalizados para especificar cómo ha deinterpretar el servidor el valor de indicación de fecha y hora del campo.

Procedimiento1. Pulse en Editar este flujo de datos para el flujo de datos.2. En la pestaña Información de la columna, busque el campo que tiene el tipo

de datos TIMESTAMP y seleccione Cambiar formateo en Formateo.3. Seleccione un formato en Formato de fecha/hora o cree un formato

personalizado.4. Seleccione un huso horario en Huso horario.5. Pulse Aceptar.

El formato de indicación de fecha y hora y el huso horario se visualizarán en lacolumna Formateo del campo de indicación de fecha y hora.

Creación de un formato de hora personalizadoLos datos de los archivos sin formato delimitados y fijos pueden configurarse conun formato de hora personalizado para especificar cómo ha de interpretar elservidor el valor de indicación de fecha y hora del campo.

Procedimiento1. Abra la ventana Personalizar formato de fecha.2. Seleccione Personalizar formato en Formato de fecha/hora.3. Cree el formato personalizado en el campo Personalizar formato especificando

letras de componente de fecha/hora.Utilice la lista que se visualiza en el listado de formatos de fecha para conocerlas definiciones disponibles. En el campo Ejemplo se visualiza un ejemplo delformato deseado a medida que lo crea. Por ejemplo, si especifica el formatopersonalizado E MMM/dd/yyy G h:m:s.S a ’UTC’, en el campo del ejemplo semuestra:Fri June/14/2010 AD 10:49::6.144 AM UTC

4. Pulse Aceptar.

Archivos delimitadosEn un archivo delimitado, cada campo (columna) está separada por un carácter,como una coma.

Por ejemplo:0703,00001,Assigned,13,2003-03-05 14:23:00,Sridar

0706,00004,Open,13,2003-03-05 19:50:00,

0706,00004,Resolved,13,2003-03-05 19:50:00,Niku

Los archivos delimitados también se denominan archivos de valores separados porcomas (CSV).

El carácter de separador de campos, el carácter de escape y el calificador de textoson personalizables.v carácter de separador

Separa cada campo de la fila, y suele ser una coma (,).


v Carácter de escapePrecede a los caracteres que no se van a utilizar como separador, y suele ser unabarra invertida (\). Por ejemplo, si el carácter separador es una coma y el textocontiene una coma real, se evita que esta última se utilice como separadormediante la barra invertida que la precede. Por ejemplo, la coma después deAltadena no es un separador de campos:123 Buena Loma Dr,Altadena\, CA,91001

v calificador de textoLas cadenas de texto están limitadas por este carácter, que suelen ser comillasdobles ("). Utilice esta opción cuando se desee que las cadenas de texto seandistintas de otros tipos de datos. Por ejemplo, este evento tiene campos de textoque contienen números, pero uno de los campos (valor de datos 13) esnumérico."0706","00004","Open",13,2010-03-0519:50:00,""

Las filas de origen que no contienen datos suficientes para llenar la fila generan unerror. Para permitir los datos sin que se genere un error, active Permitir filascortas. Por ejemplo, este texto genera un error cuando se importa la tercera fila amenos que se permitan las filas cortas:1,2,3,4,5,6

1,,,,,

1

Cuando la opción Utilizar esta fila para los nombres de columna estáseleccionada, los nombres de esa fila aparecen como los nombres de columna. Delo contrario, asigne los nombres manualmente. Además, para cada columna, asigneun tipo de datos y, opcionalmente, declare un formato de datos.

Archivos de anchura fijaEn archivos de anchura fija, cada campo (columna) tiene la misma anchurapredefinida en cada fila del archivo, de forma similar a una tabla de una hoja decálculo.

Por ejemplo:070300001Assigned13 2010-03-05 14:23:00Sridar

070600004Open 13 2010-03-05 19:50:00

070600004Resolved13 2010-03-05 19:50:00Niku

Para importar un archivo de anchura fija, debe utilizar Establecer anchuras decampo para identificar las posiciones de columna que inician cada campo de datos.Cuando proporciona un ejemplo, se muestran los datos de ejemplo y el usuariopulsa en las columnas para indicar el inicio de un campo.

Si no dispone de un ejemplo, debe identificar la posición inicial de cada columnaen el texto. Recuerde que el primer campo empieza en la posición cero (0).

Una vez definidas las posiciones de columna, puede asignar nombres y declararlos tipos de datos y los formatos.

Cuando la opción Utilizar esta fila para los nombres de columna estáseleccionada, los nombres de esa fila aparecen como los nombres de columna. De


lo contrario, asigne los nombres manualmente. Además, para cada columna, asigneun tipo de datos y, opcionalmente, declare un formato de datos.

Soporte de archivos XMLIBM Cognos Real-time Monitoring soporta la generación de un evento a partir delos orígenes de datos en formato XML.

Sin embargo, las vistas y tablas de flujos de datos de Cognos Real-time Monitoringtienen formato de tabla (es decir, filas y columnas), mientras que los datos XML sepresentan de forma jerárquica. Esto requiere el aplanado del archivo XML en latabla de flujos de datos, donde los datos jerárquicos se correlacionan con los datostabulares. El proceso para aplanar el formato XML se describe en la sección “Cómose aplanan los archivos XML” en la página 114.

Para definir un objeto de flujo de datos basado en XML en Cognos Real-timeMonitoring, el diseñador de aplicaciones debe especificar las columnas que semostrarán en la tabla de flujos de datos. Cada columna de la tabla de flujos dedatos tiene un nombre, un tipo y un origen. Cada columna tiene un origenespecificado como expresión XPath, lo que significa que la columna se rellenarábuscando elementos que coincidan con el XPath concreto y utilizando el valor delelemento de la entrada XML que se debe utilizar como valor de la columna en unafila de salida. Cada XPath de columna debe especificar un elemento o un atributo.Normalmente, un XPath de columna que especifica un elemento sólo coincide conlos elementos atómicos del documento de entrada; es decir, los elementos que sólocontienen texto y ningún otro elemento. Para obtener más información, consulte:“Cómo se evalúan los elementos” en la página 122.

Para correlacionar datos XML jerárquicos con una tabla, el origen de cada columnade la tabla se debe especificar como una expresión XPath. Las columnas de la tablase rellenan buscando elementos que coincidan con el XPath concreto, tomando elvalor de los elementos de la entrada XML y utilizando el valor de la columna deuna fila de salida. Cada XPath de columna especifica un elemento atómico o unatributo. Para obtener más información acerca de cómo se utilizan los XPath paralocalizar filas y columnas, consulte: “Ubicación XPath de columnas y filas enarchivos XML”.

Ubicación XPath de columnas y filas en archivos XMLLos XPath se pueden utilizar para localizar las columnas y filas en el archivo XML.

Al definir la Información de campo para un objeto de flujo de datos, los XPathlocalizan las columnas y filas en el archivo XML de la siguiente forma:v El XPath de esquema identifica el XPath absoluto del elemento del documento

bajo el que residen todos los demás datos XML definidos por los XPath relativos.Éste puede ser una barra inclinada (/) que hace referencia al nodo raíz deldocumento XML, o puede ser un XPath más complejo. Si un documento XMLcontiene varios elementos que se ajustan al XPath de esquema, se genera unatabla para cada uno de esos elementos y la salida del documento se define comola unión de la salida de los elementos que coincidan con el XPath de esquema.Un XPath de esquema es una ruta absoluta al elemento de la estructura XML ysiempre empieza por una barra inclinada (/), seguida del elemento raíz y ruta alelemento de columna; por ejemplo, "/problem_tickets/ticket/ticket_id" es unXPath de esquema con estas características.

v El XPath relativo identifica un elemento o atributo de columna relativo alelemento de fila. Cuando la columna es un elemento hijo del elemento de fila, el


XPath es o bien sólo el nombre de elemento o bien empieza por "child::". Porejemplo, éstos son XPath relativos válidos del ejemplo anterior:

ticket_id

child::status

customer/customer_name

child::customer/customer_name

Para localizar un atributo, inserte un símbolo de arroba (@) antes del nombre delatributo:

customer/@cust_id

El estándar XPath para las ubicaciones define correlaciones de nodos XMLadicionales no soportadas por las tablas de flujos de datos de IBM CognosReal-time Monitoring.

Información de campo XMLCada columna de la tabla de flujos de datos está definida como campo en el editorde flujos de datos XML.

Cada campo tiene los atributos que se indican en la tabla siguiente:

Tabla 49. Atributos de campo XML


Esquema XPath La expresión de esquema XPath seleccionauna lista de nodos en la que cada nodoresume una fila en el conjunto de datosresultante. Para obtener más informaciónsobre los esquemas XPath, consulte:“Ubicación XPath de columnas y filas enarchivos XML” en la página 111.

Nombre de campo Nombre de la columna en la tabla de flujosde datos.

XPATH relativo Elemento del archivo XML que contiene losdatos sobre este archivo. Para obtener másinformación sobre XPath, consulte:“Ubicación XPath de columnas y filas enarchivos XML” en la página 111.

Tipo de datos XML Tipo de datos del elemento XML. Paraobtener más información sobre los tipos dedatos XML, consulte: “Tipos de datos XML”.

Tipo de datos Tipo de datos de IBM Cognos Real-timeMonitoring de la columna de la tabla deflujos de datos. Para obtener másinformación, consulte: Capítulo 9, “Tipos dedatos”, en la página 69.

Formateo Formateo del valor decimal, de cadena o defecha y hora.

Tipos de datos XMLLos tipos de datos XML se correlacionan con los tipos de datos de IBM CognosReal-time Monitoring.

La siguiente tabla muestra la correlación.


Tabla 50. Tabla de correlaciones

XSD Tipo de datos

anyURI Varchar

base64Binary Varchar

Boolean Boolean

byte Integer

date Time stamp (parte correspondiente a la horaestablecida en cero)

dateTime Time stamp (la parte fraccionaria de un segundosoporta hasta 9 dígitos significativos)

decimalDecimal si la escala no es igual a 0. Si la escala esigual a 0, el tipo de datos viene determinado por laprecisión del siguiente modo:

Integer si la precisión está entre 1 y 9.

Long si la precisión está entre 10 y 18.

Decimal si la precisión es mayor que 18.

double Double

duration Varchar (como cadena)

ENTITIES Varchar

ENTITY Varchar

float Double

gDay Varchar (como cadena) define el día (DD)

gMonth Varchar (como cadena) define la parte del mes(MM) de la fecha

gMonthDay Varchar (como cadena) define la parte del mes y eldía (MM-DD) de la fecha

gYear Varchar (como cadena) define la parte del año(CCYY) de la fecha

gYearMonth Varchar (como cadena) define la parte del año y elmes (CCYY-MM) de la fecha

hexBinary Varchar

ID Varchar

IDREF Varchar

IDREFS Varchar

int Integer

integer Integer

language Varchar

long Long

Name Varchar

NCName Varchar

negativeInteger Integer

NMTOKEN Varchar

NMTOKENS Varchar (como cadena única)


Tabla 50. Tabla de correlaciones (continuación)

XSD Tipo de datos

nonNegativeInteger Integer

nonPositiveInteger Integer

normalizedString Varchar

NOTATION Varchar

positiveInteger Integer

QName Varchar

QName Varchar

short Integer

string Varchar

time Varchar

token Varchar

unsignedByte Integer

unsignedInt Decimal

unsignedLong Decimal

unsignedShort Integer

Cómo se aplanan los archivos XMLPara correlacionar datos XML jerárquicos con una tabla, el origen de cada columnade la tabla se debe especificar como una expresión XPath.

Los ejemplos de esta sección siempre proporcionan el XPath absoluto de unacolumna. Sin embargo, cuando se configura un objeto de flujo de datos XML, sedebe utilizar un XPath de esquema absoluto y los eventos de las columnas son losXPath relativos al XPath de ese esquema.

Las columnas de la tabla se rellenan buscando elementos que coincidan con elXPath concreto, tomando el valor de los elementos en la entrada XML, y utilizandoel valor de la columna de una fila de salida. Por ejemplo, el siguiente documentoXML tiene los XPath: a/b, a/c, a/d:<a>1

<b>0</b>

<c>1</c>

<d>2</d>

</a>

La tabla resultante tiene una fila:

0, 1, 2

En el siguiente ejemplo, el documento es alto más complicado y tiene los XPath:a/b, a/c/d, a/c/e/f.<a>

<b>0</b>

<c>

<d>1<d>


<e>

<f>2</f>

</e>

<d>

</c>

</a>

La tabla resultante también tiene una fila:

0,1,2

En estos ejemplos, ambos documentos XML generan como resultado una tabla conuna fila porque cada expresión XPath coincide exactamente con un elemento. Latabla resultante tiene una fila, donde cada columna se rellena con el valor delelemento coincidente con el XPath que define el origen de una columna.

En algunos casos, puede que más de un elemento coincida con una expresiónXPath del origen de una columna. En el ejemplo siguiente, los XPath son a/b ya/c, que coinciden con más de una columna.<a>

<b>0</b>

<b>1</b>

<c>2</c>

<d>3</d>

</a>

Aparentemente, la tabla resultante debería ser:0,2

0,3

Sin embargo, la tabla resultante realmente es:0,2

0,3

1,2

1,3

Los cuatro elementos son hijos de un mismo elemento padre <a> y el origen de lascolumnas de cada fila se especifica por los XPath a/b y a/c. Esto significa que 0,2es igual de correcto que 0,3 y ambas filas deberían estar en la tabla. En este caso, latabla resultante se crea a partir de un producto cruzado de los elementos.

Para asegurarse de que una vez aplanado el XML se produce el resultado correctopara todos los casos, IBM Cognos Real-time Monitoring lleva a cabo las tareassiguientes:v Quita todos los elementos ajenos del XML de entrada para que los valores no se

dupliquen cuando la duplicación no es necesaria, lo que generaría comoresultado filas duplicadas en la salida.

v Racionaliza el documento al que se le quitan los elementos ajenos.

Para realizar la última tarea, el documento se distribuye entre una serie de tablasintermedias, donde cada tabla tiene una clave principal (pk), una clave foráneapadre (parent_fk) y un valor. La tabla resultante final se crea uniendo las claves de


todas estas tablas intermedias. Por ejemplo, el siguiente documento XML puederacionalizarse en ocho tablas intermedias a, a/b, a/b/c, a/b/d, a/b/b/d/e,a/b/d/f, a/b/d/f/g y a/h.<a>

<b>

<c>0</c>

<d>

<e>1</e>

<e>2</e>

<f>

<g>3</g>

</f>

</d>

</b>

<b>

<c>4</c>

<d>

<e>5</e>

<f>

<g>6</g>

<g>7</g>

<f/>

</d>

</b>

<h>8</h>

<h>9</h>

</a>

A continuación, se asignan las claves principales (pk) a cada elemento en el primerrecorrido en profundidad del documento.<a pk='0’>

<b pk='1’>

<c pk='2’>0</c>

<d pk='3’>

<e pk='4’>1</e>

<e pk='5’>2</e>

<f pk='6’>

<g pk='7’>3</g>

</f>

</d>

</b>

<b pk='8’>

<c pk='9’> 4 </c>

<d pk='10’>

<e pk='11’> 5 </e>

<f pk='12’>

<g pk='13’>6</g>

<g pk='14’>7</g>

<f/>


</d>

</b>

<h pk='15’>8</h>

<h pk='16’>9</h>

</a>

Ahora, las tablas están unidas por las claves principales que se han asignado acada elemento. La sentencia SELECT siguiente define la tabla de salida final parala tabla de flujos de datos:SELECT a/b/c.value, a/b/d/e.value, a/b/d/f/g.value, a/h.value

FROM ((((((a/

FULL OUTER JOIN /a/b on /a/b.parent_fk = /a.pk)

FULL OUTER JOIN /a/b/c on /a/b/c.parent_fk = /a/b.pk)

FULL OUTER JOIN /a/b/d on /a/b/d.parent_fk = /a/b.pk)

FULL OUTER JOIN /a/b/d/e on /a/b/d/e.parent_fk =/a/b/d.pk)

FULL OUTER JOIN /a/b/d/f on /a/b/d/f.parent_fk =/a/b/d.pk)

FULL OUTER JOIN /a/b/d/f/g on /a/b/d/f/g.parent_fk= /a/b/d/f.pk)

FULL OUTER JOIN /a/h on /a/h.parent_fk = a.pk

También se puede realizar la misma unión utilizando la clave principal de cadatabla:SELECT /a.pk, /a/b.pk, /a/b/c.pk, /a/b/d.pk, /a/b/d/e.pk,/a/b/d/f.pk, /a/b/d/f/g.pk, /a/h.pk

FROM ((((((/a


FULL OUTER JOIN /a/b/c/ on /a/b/c.parent_fk = /a/b.pk)

FULL OUTER JOIN /a/b/d on /a/b/d.parent_fk = /a/b.pk)

FULL OUTER JOIN /a/b/d/e on /a/b/d/e.parent_fk =/a/b/d.pk)

FULL OUTER JOIN /a/b/d/f on /a/b/d/f.parent_fk =/a/b/d.pk)

FULL OUTER JOIN /a/b/d/f/g on /a/b/d/f/g.parent_fk= /a/b/d/f.pk)

FULL OUTER JOIN /a/h on /a/h.parent_fk = a.pk

La tabla resultante es:0,1,3,8

0,2,3,8

4,5,6,8

4,5,7,8

0,1,3,9

0,2,3,9

4,5,6,9

4,5,7,9

Manejo de los elementos que faltanEn los casos en que los elementos no tienen los mismos elementos hijo, se utilizauna unión externa completa para generar la tabla, porque definir la salida con unaunión interna no generaría los resultados que desee.


Por ejemplo, el documento siguiente no tiene ningún elemento hijo <d> en elprimer elemento <b>, y el segundo elemento <b> tiene un elemento <d> pero notiene ningún elemento <c>:<a>

<b>

<c>0</c>

</b>

<b>

<d>1</d>

</b>

</a>

El documento anotado es:<a pk=’0’>

<b pk=’1’>

<c pk=’2’>0</c>

</b>

<b>

<d pk=’3’>1</d>

</b>

</a>

La sentencia SELECT es:SELECT /a/b/c.value, /a/b/d.value

FROM ((/a



FULL OUTER JOIN /a/b/d on /a/b/d.parent_fk = /a/b.pk

La sentencia SELECT con la proyección de la clave principal es:SELECT /a.pk, /a/b.pk, /a/b/c.pk, /a/b/d.pk

FROM ((/a



FULL OUTER JOIN /a/b/d on /a/b/d.parent_fk = /a/b.pk

El resultado final es:0,null

null,1

Manejo de los atributosCuando los elementos de un documento contienen atributos, estos se representancomo columnas en la tabla intermedia.

Por ejemplo, en el siguiente documento, los XPath de columnas son: a/@b, a/c/@dy a/c.<a b='0'>

<c d='1'>2</c>

<c d='3'>4</c>

</a>


Las claves principales se asignan a los elementos de la forma siguiente:<a pk='0' b='0'>

<c pk='1' d='1'> 2</c>

<c pk='2' d='3'> 4 </c>

</a>

La sentencia de selección es:SELECT /a/@b, /a/c.d, /a/c.value

FROM /a FULL OUTER JOIN /a/c on /a/c.parent_fk = /a.pk

La sentencia de selección con las claves principales es:SELECT /a/@b, /a/c.d, /a/c.pk

FROM /a FULL OUTER JOIN /a/c on /a/c.parent_fk = /a.pk

La tabla resultante es:0,1,2

0,3,4

Cuando un elemento XML tiene dos hijos con el mismo nombre de etiqueta, unaexpresión XPath simple sin predicado devolverá un conjunto de nodos. Porejemplo, en el documento siguiente, la expresión XPath /a/b devuelve dos filas:<a>

<b>0</b>

<b>1</b>

</a>

Las filas que se devuelven son:0

1

En las expresiones XPath, puede utilizar predicados de índice para buscar un nodoo un valor específico de un nodo. Por ejemplo, la expresión /a/b[1] devuelve 0, yla expresión /a/b[2] devuelve 1. Es decir, que cada XPath devuelve una fila. Laexpresión /a/b[3] no devuelve nada porque no hay ningún tercer hijo en elelemento <a>. En el ejemplo siguiente, el XPath /a/b/c[1] devuelve dos filas.<a>

<b>

<c>0</c>

<c>1</c>

</b>

<b>

<c>2</c>

<c>3</c>

</b>

</a>

Las filas que se devuelven son:0

2


Esto se produce porque el XPath /a/b/c[1] especifica el primer hijo en el elemento<b>, y hay dos elementos hijo <b> en el elemento padre <a>.

Elementos omitidosLos elementos de un documento que no coinciden con ningún XPath de columna oque no tienen hijos que coincidan con un XPath de columna se omiten.

Por ejemplo, con el siguiente documento y el XPath /a/b/c, sólo se devolverá unafila.<a>

<b>

<c>0</c>

<d>

<e>1</e>

<e>2</e>

</d>

</b>

<a>

Sólo se devuelve una fila porque el elemento /a/b/d no coincide con el XPath decolumna /a/b/c, y no tiene hijos que coincidan. Por lo tanto, después de laprimera pasada el documento pasa a ser:<a>

<b>

<c>0</c>

</b>

<a>

El siguiente documento también crea una fila.<a>

<b>

<c>0</c>

</b>

<b>

<d>1</d>

</b>

</a>

El documento anterior crea sólo una fila porque el segundo elemento /ab coincidecon el XPath de columna. Sin embargo, no tiene hijos que coincidan. Por lo tanto,después de la primera pasada, este documento también pasa a ser lo siguiente:<a>

<b>

<c>0</c>

</b>

<a>

Este proceso también se produce con los atributos. A partir del XPath /a/b/@id, elsiguiente documento sólo crea una fila después de la primera pasada porque elsegundo elemento <b> no tiene atributo de ID.<a>


<b id=’0’ name=’oracle’/>

<b name=’ibm’/>

</a>

Por lo tanto, después de la primera pasada, el documento pasa a ser:<a>

<b id=’0’ name=’oracle’/>

</a>

Predicados de índiceLos predicados de índice permiten superar un problema concreto, en que se debedevolver una fila pero el código XML contiene dos etiquetas hijo con el mismonombre pero con valores distintos.

Por ejemplo, el siguiente documento contiene dos apariciones de la etiqueta<palabra clave>:<sales>

<sale>

<id>0</id>

<amount>$125</amount>

<keyword>Salesforce </keyword>

<keyword>SAP</keyword>

</sale>

</sales>

Para el esquema XPath/ventas, los XPath de columna son:sale/id

sale/amount

sale/keyword

Esto devuelve dos filas:0, $125, Salesforce

0, $124, SAP

Sin embargo, sólo había una venta, por lo que sólo debería haberse devuelto unafila: 0, $125, Salesforce. En resumen, quería crear una vista por encima del eventoSELECT SUM (importe) FROM ventas, y sólo necesitaba una palabra clave. En estecaso, podría proporcionar los siguientes XPath:sale/id

sale/amount

sale/keyword[1]

Esto devolverá la fila: 0, $124, Salesforce. Sin embargo, si necesita las dos palabrasclave, deberá utilizar un método distinto de los predicados de índice.

Los predicados de índice pueden encontrarse en cualquier nivel de una expresiónXPath, no sólo en el último nivel. Por ejemplo, la expresión /a/b[2]/c devuelvedos filas a partir del siguiente documento:<a>

<b>

<c>0</c>

<c>1</c>


</b>

<b>

<c>2</c>

<c>3</c>

</b>

</a>

Las dos filas que se devuelven son:2

3

Cómo se evalúan los elementosEn determinados casos, los elementos devuelven un valor nulo cuando los evalúaIBM Cognos Real-time Monitoring.

Estos casos son los siguientes:v El elemento está vacío. Por ejemplo, hay un elemento /a/b en el siguiente

documento, que Cognos Real-time Monitoring define como nulo:<a>

<b></b>

</a>

v El elemento tiene hijos, pero no texto. Por ejemplo, el siguiente documentocontiene un elemento <c>, que tiene un elemento hijo <d> pero que no contienetexto.<a>

<b>0</b>

<c>

<d>1</d>

</c>

<c>2</c>

</a>

La salida de este documento dados los XPath /a/b, a/b/c y /a/b/c/d, sería lasiguiente:0, null, 1

0, 2, null

Si un elemento no es un elemento atómico y contiene un elemento hijo,devolverá el texto del elemento así como el hijo. Por ejemplo, el siguientedocumento contiene el elemento <b>, que no es atómico, y un elemento hijo<c>:<a>

<b>hello

<c>world</c>

com</b>

</a>

Los XPath de columna /a/b y /a/b/c devolverían las siguientes filas:hello

, com, world

Problemas al aplanar archivos XMLHay ciertas cuestiones que se deberían tener en cuenta al aplanar archivos XML.


No está permitido mezclar predicados. Por ejemplo, los conjuntos de XPath/a/b[2], /a/b no están permitidos. Esto se debe a que la semántica que utiliza IBMCognos Real-time Monitoring para aplanar XML indica que tan pronto como seutilicen predicados de índice con un prefijo XPath concreto, todos los elementosque coincidan con ese prefijo se deben reescribir de forma implícita añadiendo elíndice. Cada elemento debe escribirse con el predicado de índice o sin él. Alescribir un prefijo XPatch concreto en una columna con un predicado de índice yen otra columna si un predicado de índice, todos los elementos que correspondana ese prefijo se vuelven ambiguos.

Con los datos de un archivo sin formato, cada coincidencia con el XPath deesquema define un nuevo evento, que puede definir cualquier número de filas. Porejemplo, un evento de un archivo sin formato que tiene el XPath de esquema /a/by el XPath de columna c genera dos eventos a partir del documento siguiente,ambos con una fila.<a>

<b>

<c>0</c>

</b>

<b>

<c>1</>

</b>

</a>

Sin embargo, para un documento XML que llega a través de JMS, un documentosiempre genera un evento. Raramente esto supondrá alguna diferencia.

El espacio en blanco no está permitido en una expresión XPath. No puede guardarun evento con espacios en blanco en los XPath. Los XPath siguientes no estánpermitidos:v b/ cv b/c [1]

Si especifica más de una columna con el mismo XPath, siempre obtendrá el mismovalor en ambas columnas. Por ejemplo, el documento siguiente devuelve elresultado 0,1,1 para el esquema /a y las columnas b, c, c.<a>

<b>0</b>

<c>1</b>

<a>

La consulta semántica es:SELECT /a/b.value, /a/c.value, /a/c.value

FROM

(/a FULL OUTER JOIN /a/b ON /a/b.parent_fk = /a.pk)

FULL OUTER JOIN /a/c ON /a/c.parent_fk = /a.pk



Capítulo 14. Fórmulas

Todas las fórmulas de IBM Cognos Real-time Monitoring son expresiones enlenguaje C-SQL, un derivado de ANSI SQL.

Algunas de las fórmulas son expresiones simples, como expresiones de campo quedefinen los valores de las columnas de vista empresarial. Otras expresiones sonmás complejas y representan componentes enteros de una sentencia de consultaC-SQL (SELECT), como las cláusulas WHERE, WINDOW y JOIN.

Todas las fórmulas de IBM Cognos Real-time Monitoring aceptan operadores yconstantes (consulte: Capítulo 22, “Operadores y constantes”, en la página 287) quepueden manipular los valores, y pueden aceptar la mayoría de las funcionesC-SQL (consulte: Capítulo 15, “Funciones C-SQL”, en la página 133) para seguirprocesando los resultados.

Para obtener descripciones detalladas sobre la sentencia SELECT de C-SQL, susoperadores y funciones, consulte: Capítulo 32, “Sentencias SELECT”, en la página333.

FuncionesLas funciones devuelven valores que son información del sistema, como la fechaactual; manipulaciones de datos, como la conversión de una cadena de caracteres amayúsculas; o evaluaciones de conjuntos de datos, como el total de los precios deun conjunto de órdenes de compra.

Las funciones C-SQL pueden utilizarse en la mayoría de las fórmulas de IBMCognos Real-time Monitoring. Sin embargo, algunas están limitadas por lasoperaciones que se permiten en el contexto de la fórmula. La sección siguiente,"“Tipos de funciones”", describe los tipos de funciones e indica dónde se permiten.

Si busca una función para una tarea específica, consulte: “Categorías de funciones”en la página 128 para ver las tareas que pueden realizar las funciones.

Para obtener una descripción detallada de cada función, consulte: Capítulo 15,“Funciones C-SQL”, en la página 133.

Tipos de funcionesC-SQL tiene cinco tipos de funciones: escalar, conjunto, clasificación, conjuntomóvil y conjunto en movimiento. Las diferencias entre los tipos determinan dóndese puede incluir la función en una fórmula.

Funciones escalaresLas funciones escalares funcionan en un elemento único y proporcionan unresultado único.

Por ejemplo, la función ABS (consulte: “ABS” en la página 151) devuelve el valorabsoluto de un número (único). Las funciones escalares pueden aparecer encualquier expresión C-SQL.


Las funciones escalares se describen en las siguientes secciones:v “ABS” en la página 151v “CAST” en la página 142v “CEIL” en la página 152v “CHAR_LENGTH” en la página 166v “CONCAT” en la página 167v “CURRENT_TIMESTAMP” en la página 143v “CURRENT_USER” en la página 166v “DATE_ADD” en la página 144v “DATE_DIFF” en la página 145v “DISPLAY_MONEY” en la página 152v “EXP” en la página 154v “FLOOR” en la página 155v “GREATEST” en la página 146v “IS_RAISED” en la página 164v “LAST_DAY” en la página 146v “LEAST” en la página 147v “LOG” en la página 157v “LOWER” en la página 169v “LPAD” en la página 170v “LTRIM” en la página 170v “MOD” en la página 157v “POSITION” en la página 171v “POWER” en la página 158v “PRIOR_VALUE” en la página 148v “ROUND” en la página 160v “RPAD” en la página 173v “RTRIM” en la página 174v “SIGN” en la página 162v “SQRT” en la página 162v “SUBSTRING” en la página 174v “TIMESTAMP_DIFF” en la página 149v “TO_CHAR” en la página 150v “TO_DATE” en la página 150v “TRUNC” en la página 162

Funciones de conjuntoLas funciones de conjunto realizan agregaciones en conjuntos de filas de vistaempresarial y producen un solo resultado para el conjunto.

Por ejemplo, SUM () proporciona el total de todas las filas de una columna en unavista. Una función de conjunto sólo se puede utilizar en la lista de selección de unasentencia SELECT: las definiciones de los campos de una vista.


Una función de conjunto puede hacer referencia a otra función de conjunto, perolos resultados son los mismos que si se hubiera expresado sólo la funciónreferenciada (interna). Por ejemplo, SUM(AVG(Order_Total)) genera el mismoresultado que AVG(Order_Total).

Las funciones de conjunto se describen en las secciones siguientes:v “AVG” en la página 176v “COUNT” en la página 178v “CURRENT” en la página 178v “MAX” en la página 179v “MIN” en la página 180v “PREV” en la página 186v “SUM” en la página 187v “STD_DEVIATION” en la página 201v “VARIANCE” en la página 205

NULL se omite al calcular una función de conjunto, una función de conjunto móvily valores de función de clasificación. Por ejemplo, el promedio de (3, NULL, 3) es3, no NULL, y no es 2.

Funciones de clasificaciónLas funciones de clasificación calculan el resultado escalar para una columna encada fila de un conjunto, con respecto al conjunto entero.

Una función de clasificación sólo puede utilizarse en la lista de selección de unasentencia SELECT.

Las funciones de clasificación se describen en las siguientes secciones:v “NTILE” en la página 197v “RANK” en la página 199v “RATIO_TO_REPORT” en la página 200

Funciones de conjunto móvilLas funciones de conjunto móvil realizan cálculos en un conjunto de las filas másrecientes de una vista.

El conjunto de filas que se deben incluir se determina sólo cuando llega un nuevoevento. En ese momento, sólo las últimas filas que cumplen los criterios delconjunto se incluyen en el cálculo.

Las funciones de conjunto móvil se definen aplicando "MOV_" a una función deconjunto existente. Por ejemplo, para calcular un promedio móvil, utiliceMOV_AVG(). Un conjunto móvil puede venir determinado por un recuento deeventos o como una duración de tiempo. En el siguiente ejemplo se calcula lamedia de Order_Total para las 12 últimas horas. A medida que se insertan nuevasórdenes en la vista, se incluyen en el cálculo; sin embargo, las órdenes anteriores alas últimas 12 horas se excluyen.SELECT MOV_AVG(Order_Total, HOUR, 12) FROM Purchase_Orders

Las funciones de conjunto móvil son formas Abreviadas de expresar una ventanade consulta simple. Para obtener una descripción completa, consulte:“MOV_function” en la página 136.

Capítulo 14. Fórmulas 127

Las funciones de conjunto móvil se describen en las siguientes secciones:v “MOV_AVG” en la página 180v “MOV_COUNT” en la página 181v “MOV_MAX” en la página 183v “MOV_MIN” en la página 184v “MOV_SUM” en la página 185v “MOV_STD_DEVIATION” en la página 195v “MOV_VARIANCE” en la página 196

Funciones de conjunto en movimientoLas funciones de conjunto en movimiento realizan cálculos en un conjunto deventanas de las filas de una vista.

El conjunto de filas que se deben incluir se determina cuando llega un nuevoevento, y el conjunto se vacía cuando está lleno. Las funciones de conjunto enmovimiento son un método breve para expresar una consulta de ventana enmovimiento.

Para obtener más información, consulte: “Ventanas en movimiento” en la página404.

Las funciones de conjunto en movimiento se describen en las siguientes secciones:v “TUMBLE_AVG” en la página 188v “TUMBLE_COUNT” en la página 189v “TUMBLE_MAX” en la página 190v “TUMBLE_MIN” en la página 192v “TUMBLE_SUM” en la página 193v “TUMBLE_STD_DEVIATION” en la página 203v “TUMBLE_VARIANCE” en la página 204

Categorías de funcionesEsta sección muestra las categorías de las funciones C-SQL.

Función de alertasv “IS_RAISED” en la página 164

Funciones de conversiónv “CAST” en la página 142v “DISPLAY_MONEY” en la página 152v “TO_CHAR” en la página 150v “TO_DATE” en la página 150

Funciones de fecha y horav “CURRENT_TIMESTAMP” en la página 143v “DATE_ADD” en la página 144v “DATE_DIFF” en la página 145v “GREATEST” en la página 146v “TIMESTAMP_DIFF” en la página 149


v “LEAST” en la página 147v “LAST_DAY” en la página 146v “TO_CHAR” en la página 150v “TO_DATE” en la página 150

Funciones matemáticasv “ABS” en la página 151v “CAST” en la página 142v “CEIL” en la página 152v “EXP” en la página 154v “FLOOR” en la página 155v “LOG” en la página 157v “MOD” en la página 157v “POWER” en la página 158v “ROUND” en la página 160v “SIGN” en la página 162v “SQRT” en la página 162v “SUM” en la página 187v “TRUNC” en la página 162

Funciones matemáticasEn esta sección se muestran las funciones matemáticas C-SQL.v “ABS” en la página 151v “CAST” en la página 142v “CEIL” en la página 152v “EXP” en la página 154v “FLOOR” en la página 155v “LOG” en la página 157v “MOD” en la página 157v “POWER” en la página 158v “ROUND” en la página 160v “SIGN” en la página 162v “SQRT” en la página 162v “SUM” en la página 187v “TRUNC” en la página 162

Funciones de clasificaciónEn esta sección se muestran las funciones C-SQL de clasificación.v “NTILE” en la página 197v “RANK” en la página 199v “RATIO_TO_REPORT” en la página 200

Funciones de reglasEn esta sección se muestran las funciones de reglas C-SQL.v “IS_RAISED” en la página 164v “CURRENT_USER” en la página 166


Funciones estadísticasEn esta sección se muestran las funciones C-SQL estadísticas.v “AVG” en la página 176v “COUNT” en la página 178v “GREATEST” en la página 146v “LEAST” en la página 147v “MAX” en la página 179v “MIN” en la página 180v “MOV_AVG” en la página 180v “MOV_COUNT” en la página 181v “MOV_MAX” en la página 183v “MOV_MIN” en la página 184v “MOV_SUM” en la página 185v “MOV_STD_DEVIATION” en la página 195v “MOV_VARIANCE” en la página 196v “NTILE” en la página 197v “RANK” en la página 199v “RATIO_TO_REPORT” en la página 200v “STD_DEVIATION” en la página 201v “TUMBLE_AVG” en la página 188v “TUMBLE_COUNT” en la página 189v “TUMBLE_MAX” en la página 190v “TUMBLE_MIN” en la página 192v “TUMBLE_SUM” en la página 193v “TUMBLE_STD_DEVIATION” en la página 203v “TUMBLE_VARIANCE” en la página 204v “VARIANCE” en la página 205

Funciones de texto y de cadenaEn esta sección se muestran las funciones C-SQL de texto y de cadena.v “CAST” en la página 142v “CHAR_LENGTH” en la página 166v “CONCAT” en la página 167v “DISPLAY_MONEY” en la página 152v “GREATEST” en la página 146v “LEAST” en la página 147v “LOWER” en la página 169v “LTRIM” en la página 170v “LPAD” en la página 170v “POSITION” en la página 171v “RPAD” en la página 173v “RTRIM” en la página 174v “SUBSTRING” en la página 174v “TO_CHAR” en la página 150v “TO_DATE” en la página 150


v “UPPER” en la página 175

Funciones de serie de tiempo y de agregaciónEn esta sección se muestran las funciones C-SQL de serie de tiempo y deagregación.v “AVG” en la página 176v “COUNT” en la página 178v “MIN” en la página 180v “MAX” en la página 179v “MOV_function” en la página 136v “MOV_AVG” en la página 180v “MOV_COUNT” en la página 181v “MOV_MAX” en la página 183v “MOV_MIN” en la página 184v “MOV_SUM” en la página 185v “MOV_STD_DEVIATION” en la página 195v “MOV_VARIANCE” en la página 196v “VARIANCE” en la página 205

Funciones de vistasEn esta sección se muestran las funciones C-SQL de vistas.v “CURRENT” en la página 178v “IS_RAISED” en la página 164v “PREV” en la página 186v “PRIOR_VALUE” en la página 148



Capítulo 15. Funciones C-SQL

Estas tablas proporcionan una vista previa de las funciones C-SQL. Puede utilizarlos enlaces para obtener una descripción completa.

Las funciones C-SQL pueden aparecer en comandos y en fórmulas de reglas dondese aceptan expresiones.

Para obtener una descripción general de las funciones y una lista de las categoríasde función, consulte: “Categorías de funciones” en la página 128 y Capítulo 14,“Fórmulas”, en la página 125.

Las tablas siguientes proporcionan una descripción breve de cada función C-SQL yun enlace con la sección que proporciona más información.

Tabla 51. Funciones C-SQL A - I

Función C-SQL y enlace Breve descripción

“ABS” en la página 151 Devuelve el valor absoluto de un número

“AVG” en la página 176 Devuelve el valor medio (media aritmética)de un conjunto de valores numéricos

“CASE” en la página 141 Devuelve resultado de una expresión quecorresponde a una condición verdaderacoincidente

“CAST” en la página 142 Convierte un valor de un tipo de CognosReal-time Monitoring a otro tipo de CognosReal-time Monitoring

“CEIL” en la página 152 Devuelve el entero menor, redondeado alalza de cero, mayor o igual que un número

“CHAR_LENGTH” en la página 166 Devuelve la longitud de una cadena

“CONCAT” en la página 167 Devuelve una cadena que es laconcatenación de dos caracteres o cadenas

“concatList” en la página 206 Devuelve una cadena que es laconcatenación de una lista de caracteres ocadenas

“concatSet” en la página 207 Devuelve un conjunto de cadenas ordenadasalfabéticamente

“COUNT” en la página 178 Devuelve el recuento de filas en una vista oun conjunto

“CURRENT” en la página 178 Devuelve un valor de la fila más reciente ode la última fila de un conjunto

“CURRENT_TIMESTAMP” en la página 143 Devuelve la fecha y hora actuales de la zonahoraria del servidor

“CURRENT_USER” en la página 166 Devuelve el nombre de inicio de sesión delusuario actual

“DATE_ADD” en la página 144 Agrega una duración de tiempo a un valorde fecha y hora

“DATE_DIFF” en la página 145 Resta una duración de un valor defecha-hora


Tabla 51. Funciones C-SQL A - I (continuación)

Función C-SQL y enlace Breve descripción

“DISPLAY_MONEY” en la página 152 Formatea un número como valor de moneda

“EXP” en la página 154 Devuelve e elevado a una potenciaespecífica

“FLOOR” en la página 155 Devuelve el entero más grande que seamenor o igual que una expresión

“gammaDist” en la página 208 Devuelve la distribución gamma de un valor

“GREATEST” en la página 146 Devuelve el resultado más alto de una listade expresiones

“IS_ACKED” en la página 164 Devuelve verdadero cuando se haconfirmado la alerta especificada

“IS_RAISED” en la página 164 Devuelve verdadero cuando se ha producidola alerta especificada

Tabla 52. Funciones C-SQL L - N

Función C-SQL y enlace Descripción

“LAST_DAY” en la página 146 Devuelve la fecha del último día del mesque contiene una fecha especificada

“LEAST” en la página 147 Devuelve el valor más bajo de una lista deexpresiones

“LOG” en la página 157 Devuelve el logaritmo de un número de unabase específica

“logNormDist” en la página 209 Devuelve la distribución logarítmico-normalacumulada de un valor

“LOWER” en la página 169 Convierte todos los caracteres enmayúsculas de una cadena a minúsculas

“LPAD” en la página 170 Inserta una o varias instancias de unacadena en el principio de otra cadena

“LTRIM” en la página 170 Elimina caracteres del principio de unacadena

“MAX” en la página 179 Devuelve el valor máximo de un conjunto

“median” en la página 209 Devuelve el número medio (valor central) deun conjunto

“MIN” en la página 180 Devuelve el valor mínimo de un conjunto

“MOD” en la página 157 Devuelve el módulo (resto) de una división

“mode” en la página 211 Devuelve el número que aparece con másfrecuencia en un conjunto

“MOV_function” en la página 136 Limita las filas que se usan en el cálculo deuna función de conjunto a un conjunto delas últimas filas de la vista

“MOV_AVG” en la página 180 Devuelve el valor medio (media aritmética)móvil de un conjunto de ventanas móvilesde valores numéricos

“MOV_COUNT” en la página 181 Devuelve el recuento de filas en un conjuntode ventanas móviles

“MOV_MAX” en la página 183 Devuelve el valor máximo de un conjuntode ventanas móviles


Tabla 52. Funciones C-SQL L - N (continuación)


“MOV_MIN” en la página 184 Devuelve el valor mínimo de un conjunto deventanas móviles

“MOV_SUM” en la página 185 Devuelve la suma de un conjunto deventanas móviles de valores numéricos

“MOV_STD_DEVIATION” en la página 195 Devuelve la desviación estándar de unamuestra de un conjunto de ventanas móvilesde números

“MOV_VARIANCE” en la página 196 Devuelve el cuadrado de un ejemplo dedesviación estándar de un conjunto deventanas móviles de números

“NTILE” en la página 197 Determina la clasificación de nivel de cadavalor en un conjunto con respecto alconjunto total

Tabla 53. Funciones C-SQL P - Z


“POSITION” en la página 171 Devuelve la posición de un carácter o unacadena dentro de una cadena

“POWER” en la página 158 Devuelve un valor elevado a una potenciaespecífica

“PREV” en la página 186 Devuelve un valor de la penúltima fila deun conjunto

“PRIOR_VALUE” en la página 148 Devuelve el valor anterior de una columna,un alias o una expresión.

“RANK” en la página 199 Determina la clasificación de cada valor deun conjunto con respecto a la totalidad delconjunto

“RATIO_TO_REPORT” en la página 200 Calcula la proporción de un valor para lasuma de valores de un conjunto completo

“ROUND” en la página 160 Devuelve un número redondeado a unacantidad especificada de decimales

“RPAD” en la página 173 Inserta una o varias instancias de unacadena al final de otra cadena

“RTRIM” en la página 174 Elimina caracteres del final de una cadena

“SAFE_DIVIDE” en la página 161 Devuelve un cociente de dos valores, amenos que el cociente sea 0, en cuyo casodevolverá un valor de cociente alternativo

“SIGN” en la página 162 Identifica el signo aritmético de un número

“SQRT” en la página 162 Devuelve la raíz cuadrada de un número

“STD_DEVIATION” en la página 201 Devuelve un ejemplo de desviación estándarde un conjunto de números

“SUBSTRING” en la página 174 Devuelve la parte de una cadenaidentificada por su posición y longitud

“SUM” en la página 187 Devuelve la suma de un conjunto de valoresnuméricos

Capítulo 15. Funciones C-SQL 135

Tabla 53. Funciones C-SQL P - Z (continuación)


“SUM_OVER_GROUPS” en la página 202 Devuelve una suma continua de los valoresnuméricos ordenados por la columnaespecificada en los argumentos

“TIMESTAMP_DIFF” en la página 149 Devuelve el intervalo de tiempo entre dosindicaciones de fecha y hora

“TO_CHAR” en la página 150 Convierte una fecha-hora en una cadena decaracteres

“TO_DATE” en la página 150 Convierte una cadena de caracteres a unvalor de fecha y hora

“TRUNC” en la página 162 Trunca un número a una cantidad específicade decimales

“TUMBLE_AVG” en la página 188 Devuelve el valor medio (media aritmética)de un conjunto de un conjunto de ventanasen movimiento

“TUMBLE_COUNT” en la página 189 Devuelve el recuento de filas en un conjuntode ventanas en movimiento

“TUMBLE_MAX” en la página 190 Devuelve el valor máximo de un conjuntode ventanas en movimiento

“TUMBLE_MIN” en la página 192 Devuelve el valor mínimo de un conjunto deventanas en movimiento

“TUMBLE_SUM” en la página 193 Devuelve la suma de un conjunto de valoresnuméricos de una ventana en movimiento

“TUMBLE_STD_DEVIATION” en la página203

Devuelve un ejemplo de desviación estándarde un conjunto de ventanas en movimientode números

“TUMBLE_VARIANCE” en la página 204 Devuelve el cuadrado de la desviaciónestándar de una muestra de un conjunto deventanas móviles de números

“UPPER” en la página 175 Convierte en mayúsculas todos loscaracteres en minúsculas de una cadena

“VARIANCE” en la página 205 Devuelve el cuadrado de la desviaciónestándar de una muestra de un conjunto denúmeros

“yield” en la página 212 Computa el rendimiento a partir de unconjunto de resultados de prueba y calculael rendimiento

MOV_functionLas funciones con la forma MOV_function son funciones escalares que limitan lasfilas utilizadas en el cálculo de una función de conjunto a un conjunto de lasúltimas filas de una vista.

La siguiente tabla enumera las secciones que proporcionan información sobre lasfunciones de conjunto de ventanas móviles.


Tabla 54. Funciones de conjunto de ventana móvil

Argumento Descripción

“MOV_AVG” en la página 180 Devuelve el valor medio (media aritmética)móvil de un conjunto de ventanas móvilesde valores numéricos.

“MOV_COUNT” en la página 181 Devuelve el recuento de filas en un conjuntode ventanas móviles.

“MOV_MAX” en la página 183 Devuelve el valor máximo de un conjuntode ventanas móviles.

“MOV_MIN” en la página 184 Devuelve el valor mínimo de un conjunto deventanas móviles.

“MOV_SUM” en la página 185 Devuelve la suma de un conjunto deventanas móviles de valores numéricos.

“MOV_STD_DEVIATION” en la página 195 Devuelve la desviación estándar de unamuestra de un conjunto de ventanas móvilesde números.

“MOV_VARIANCE” en la página 196 Devuelve el cuadrado de una desviaciónestándar de una muestra de un conjunto deventanas móviles de números.

Las funciones de conjunto móvil son formas abreviadas de expresar ventanas deconsulta simples. Para obtener una explicación completa, consulte: Capítulo 38,“Ventanas de consulta”, en la página 389.

Sintaxis de las funciones MOV_functionTodas las funciones de conjunto móvil tienen la misma sintaxis:mov_function(numeric, window, size [,timestampColumn])

En el ejemplo, mov_function es una función de conjunto existente. El tipo dedevolución de la función móvil es igual que el del tipo de retorno de la funcióndenominada. El argumento numérico suele ser una columna de la vista, peropuede contener otras funciones y operadores, aunque no puede hacer referencia auna función de clasificación.

Los argumentos de ventana y de tamaño especifican qué filas se incluyen en elconjunto. El argumento de ventana determina si el tamaño es el recuento de lasfilas del conjunto (EVENT), o una duración de tiempo (SECOND, MINUTE,HOUR, DAY, MONTH o YEAR). Por ejemplo, un conjunto de los seis últimoseventos limita el conjunto a seis eventos como máximo por grupo cuando se utilizala cláusula GROUP BY. Para obtener más información, consulte: “cláusula GROUPBY” en la página 340. Algunos eventos generan varias filas.

En la ilustración siguiente se muestra una función de conjunto móvil que devuelvela suma de los seis últimos precios, donde la función de conjunto móvil se definecomo MOV_SUM(Price, EVENT, 6). Inicialmente, en la ventana sólo hay cincoprecios, por lo que la función devuelve la suma de cinco precios. A medida que laventana aumenta, la suma cambia porque los precios anteriores no se incluyen enla suma, según se muestra en las dos últimas ventanas de la ilustración. Laexpresión MOV_SUM(Price, EVENT, 6) es equivalente a la expresión de ventanacompleta SUM (Price) OVER (EVENT, ’5’ PRECEDING REFERENCE FRAME).


Cuando se utiliza un intervalo de serie de tiempo (en lugar de un intervalo deeventos), el tamaño del conjunto varía según el momento en que se hayanregistrado los eventos en la vista. Por ejemplo, cuando se utiliza una serie detiempo de una hora, sólo se utilizarán en el cálculo las filas que hayan entrado enla vista durante la última hora.

En la ilustración siguiente se muestra una función de conjunto móvil que devuelvela suma de los precios registrados en la última hora, donde la función de conjuntomóvil se define como MOV_SUM(PRICE, HOUR, 1). Inicialmente, en la ventana haycinco precios, por lo que la función devuelve la suma de esos cinco precios, ya quehan entrado en la página durante la última hora. A medida que la ventanaaumenta, sólo se incluyen en la suma los precios que hayan entrado en la vistadurante la última hora. Como se muestra en la ilustración, una suma posterior sóloincluye dos precios porque los precios anteriores no han entrado en la vistadurante la última hora. La expresión MOV_SUM(PRICE, HOUR, 1) es equivalente a laexpresión de ventana completa SUM(Price) OVER (RANGE ’1’ HOUR PRECEDINGREFERENCE OPERATOR).

Atención: Es posible que un evento llegue a tiempo para ser incluido en una vista,pero que deba descartarse porque, en el momento en que llega a la vista, ya no seencuentra en el intervalo de tiempo de la misma. Por ejemplo, si el evento entra enla tabla de flujos de datos tan sólo unos milisegundos antes de que se le excluyade una vista derivada, se podrá incluir o excluir, en función del tiempo que setarde en procesar y propagar el evento en las vistas base.

El argumento opcional timestampColumn indica al sistema que utilice el valor deun campo de la vista como punto de referencia para iniciar el intervalo de serie detiempo. Cuando se omite esta opción, el sistema calcula la serie de tiempo según el

Time Price03:22 12.3403:47 33.5003:49 10.8703:53 20.0004:06 14.66

Hora Precio03:22 12,3403:47 33,5003:49 10,8703:53 20,0004:06 14,66

Time Price03:22 12.3403:47 33.5003:49 10.8703:53 20.0004:06 14.66

Hora Precio03:22 12,3403:47 33,5003:49 10,8703:53 20,0004:06 14,6604:26 32,42

Time Price03:22 12.3403:47 33.5003:49 10.8703:53 20.0004:06 14.66

Hora Precio03:22 12,3403:47 33,5003:49 10,8703:53 20,0004:06 14,6604:26 32,4204:56 15,95

04:26 32.4204:06 14.6604:26 32,42

Time Price03:22 12.3403:47 33.5003:49 10.8703:53 20.0004:06 14.66

Hora Precio03:22 12,3403:47 33,5003:49 10,8703:53 20,0004:06 14,66

04:26 32.4204:06 14.6604:56 15,9505:30 14,22

91,37123,79

127,40 108,12

Nota: Solo 5 flujos de datos en conjunto

Expresión de ventana completa:

MOV_SUM (Price, EVENT, 6)

SUM (Price) OVER (EVENT '5' PRECEDING REFERENCE FRAME)

Figura 13. Función de conjunto móvil que devuelve la suma de los últimos seis precios

Time Price03:22 12.3403:47 33.5003:49 10.8703:53 20.0004:06 14.66

Hora Precio03:22 12,3403:47 33,5003:49 10,8703:53 20,0004:06 14,66

Time Price03:22 12.3403:47 33.5003:49 10.8703:53 20.0004:06 14.66

Hora Precio03:22 12,3403:47 33,5003:49 10,8703:53 20,0004:06 14,6604:26 32,42

Time Price03:22 12.3403:47 33.5003:49 10.8703:53 20.0004:06 14.66

Hora Precio03:22 12,3403:47 33,5003:49 10,8703:53 20,0004:06 14,6604:26 32,4204:56 15,95

04:26 32.4204:06 14.6604:26 32,42

Time Price03:22 12.3403:47 33.5003:49 10.8703:53 20.0004:06 14.66

Hora Precio03:22 12,3403:47 33,5003:49 10,8703:53 20,0004:06 14,66

04:26 32.4204:06 14.6604:56 15,9505:30 14,22

91,3711,45

82,95

30,17


MOV_SUM (Price, HOUR, 1)

SUM (Price) OVER (RANGE '1' HOUR PRECEDING REFERENCE OPERATOR)

Figura 14. Función de conjunto móvil que devuelve la suma de los precios registrados en laúltima hora


reloj del sistema, como la última hora desde este momento. Si, en su lugar, se daun nombre a la columna timestamp, el cálculo se basa en un intervalo de tiempo apartir del valor más reciente de la columna desde cualquier fila de la vista.

En la siguiente ilustración, en la que la función de conjunto móvil está definidacomo MOV_SUM(Price, HOUR, 1, Time), sólo se utilizan dos precios de seis parala suma, ya que los precios seleccionados se basan en el valor de la columna Time,no en el orden en que han entrado en la vista. La expresión MOV_SUM(Price,HOUR, 1, Time) equivale a la expresión de ventana completa SUM (Price) OVER(ORDER BY Time RANGE '1' HOUR PRECEDING REFERENCE OPERATOR).

Intervalos de serie de tiempoLos cálculos de intervalo de tiempo utilizan el calendario gregoriano y se calculanhasta el segundo en que se registró el evento en la columna vc_timestamp.

Por ejemplo, si el intervalo es de un día y un evento llega justo antes demedianoche, se excluye la mayoría de los eventos del día anterior. Sin embargo, siun evento llega justo después de medianoche, se incluyen casi todos los eventosdel día anterior. A continuación se exponen más consideraciones:

En entornos locales en los que se tiene en cuenta el horario de verano, lasduraciones de los días, meses y años se ajustan consecuentemente. Mientras que 1día tiene normalmente 24 horas, puede tener 23 o 25, según la época del año.

El cálculo de los meses se basa en el día del mes: un intervalo de un mes calculadoel 5 de abril incluye todas las fechas posteriores al 5 de marzo. Cuando el día delmes no se encuentra al principio del intervalo, se utiliza el final del mes. Porejemplo, un intervalo de un mes calculado el 31 de mayo empieza después del 30de abril.

De forma similar, el cálculo de los años se basa en el día del año y se realizan losajustes necesarios en los años bisiestos.

Para la ejecución paralela, puede decidir no procesar los eventos en el orden enque se registra su fecha y hora. En este caso, el orden de los datos dentro de un


MOV_SUM (Price, HOUR, 1, Time)

SUM (Price) OVER (ORDER BY Time RANGE '1' HOUR PRECEDING REFERENCE OPERATOR)

Se utilizan dos precios de seis enla suma. Los precios seleccionadosse basan en el valor de la columnaTime, no en el orden en el que hanentrado en la vista.

04:26 32.4204:06 14.6604:26 32,42

Time Price03:22 12.3403:47 33.5003:49 10.8703:53 20.0004:06 14.66

Hora Precio03:47 33,5003:22 12,3404:06 14,6603:53 20,0005:30 14.22

04:26 32.4204:06 14.6604:56 15,9503:49 10,87

30,1705:30 14,22

Figura 15. Función de conjunto móvil en la que los precios seleccionados se basan en elvalor de la columna Time


grupo es arbitrario y sólo produce valores de conjunto móvil aproximados quepueden no ser reproducibles para los mismos eventos de entrada durante unaevaluación posterior del mismo conjunto.

El conjunto de eventos incluidos en una vista de ventana móvil se determinacuando entra un evento nuevo en la vista. Los eventos que se descartan de unavista antes de entrar en ella, como cuando son excluidos por una cláusula WHERE,no afectan a la vista y no provocan su actualización.

Aviso sobre vistasNo utilice una función de conjunto móvil en una vista derivada para realizar uncálculo en un resultado de función de conjunto móvil en la vista base, porque lafunción derivada siempre devuelve el valor actual de la vista base,independientemente del intervalo de la ventana.

Si necesita esa agregación, coloque las funciones en la misma vista. Para obtenermás detalles, consulte el ejemplo de “AVG” en la página 176.

Interacciones GROUP BYEl uso de una función de conjunto móvil en una vista definida con una cláusulaGROUP BY rellena los grupos.

Para obtener más información, consulte: “cláusula GROUP BY” en la página 340.

Intervalos de serie de tiempo

Los intervalos de serie de tiempo se aplican a todos los eventos de todos losgrupos. Sólo se incluyen en los grupos los eventos que se encuentran dentro delintervalo de tiempo. Los eventos que no se ajustan a la definición de intervalo detiempo se excluyen. Cuando se eliminan todos los flujos de datos de un conjuntode grupos, el grupo está vacío. Si ninguna otra columna retiene el grupo, seelimina de la vista. Observe este ejemplo en el que se realiza un seguimiento de losprecios promedio en grupos por producto para la última hora. Cuando unproducto no tiene flujos de datos durante la última hora, el grupo para dichoproducto se elimina.

SELECT MOV_AVG(Price,HOUR,1) AS Av_pr

FROM ...

GROUP BY Product

Sin embargo, en esta variación la presencia de la función SUM() hace que la vistaconserve todos los grupos de flujo de datos, pero el precio promedio para ungrupo de la última hora puede estar vacío. Si se consulta un grupo vacío devuelveNULL.

SELECT MOV_AVG(Price,HOUR,1) AS Av_pr,

SUM(Price) AS Total

FROM ...

GROUP BY Product

Intervalos de flujo de datos

Los intervalos de flujo de datos aplican su tamaño a cada grupo de la vista. Cadagrupo realiza el seguimiento de un recuento de los flujos de datos determinadopor el tamaño del intervalo. Los grupos nunca se eliminan de la vista, y los flujosde datos se eliminan de los conjuntos sólo cuando los desplaza un flujo de datos


más reciente. Observe la vista del siguiente ejemplo, donde MOV_AVG() realiza elseguimiento de tres flujos de datos por grupo. Cuando se inserta el cuarto flujo dedatos, cuyo valor Ix es 100, el primer flujo de datos se elimina del cálculo depromedio móvil del grupo Ix=100. Sin embargo, en este ejemplo, una vez que secrea el grupo 200, el conjunto permanece constante con el primer flujo de datos.

Para intervalos de flujo de datos que tienen flujos de datos con múltiples filas en lavista, todo el flujo de datos se trata como un elemento en el conjunto según laindicación de fecha y hora (vc_timestamp) y el ID del flujo de datos ID(vc_event_id).

Todos los columnNames a los que haga referencia directamente una función declasificación o escalar deben aparecer en el conjunto de columnas de la listaGROUP BY.

Sentencia CaseLa sentencia Case evalúa una lista de condiciones y devuelve los resultados de unade las expresiones posibles.

La sentencia Case consta de las funciones descritas en los temas siguientes:v “CASE”v “ELSE” en la página 142v “END” en la página 142v “THEN” en la página 142v “WHEN” en la página 142

CASEUna expresión CASE devuelve el resultado de una expresión que corresponde auna condición verdadera coincidente.

Opcionalmente, en lugar de ello cada condición puede devolver NULL. Si no seencuentra ninguna condición que sea verdadera, la expresión devuelve el resultadode la condición ELSE o bien NULL cuando se omite ELSE.

Para obtener información detallada y ejemplos, consulte: “Expresión CASE” en lapágina 335.

Ix Av_pr Ct100 12.00 1

Ix Av_pr Ct100 11.00 2200 33.50 1

Ix Av_pr Ct100 10.67 3200 33.50 1

Ix Av_pr Ct100 10.00 3200 33.50 1

Ix Precio100 12,00200 33,50100 10,00100 10,00100 10,00

Flujos de datosSolo primer flujo de datos

Incluye Ix=200

Has 3 Ix=100

Primer flujo de datos eliminado

SELECT IX, MOV_AVG(Price,EVENT,3) AS Av_pr, COUNT(*) AS Ct FROM ... GROUP BY Ix

Figura 16. Un promedio móvil realiza el seguimiento de hasta tres flujos de datos por grupo


ELSEELSE es la expresión devuelta si ninguna operación de comparación da TRUEcomo resultado.

Si este argumento se omite y ninguna operación de comparación da TRUE comoresultado, la sentencia Case devuelve NULL.


ENDEND finaliza una sentencia Case.


THENTHEN es la expresión que se devuelve si una expresión de entrada es igual a unaexpresión WHEN y da TRUE como resultado, o una expresión booleana da TRUEcomo resultado.

La expresión de resultado es cualquier expresión C-SQL válida.


WHENWHEN es una expresión simple con la que se compara una expresión de entrada sise utiliza el formato simple CASE, o bien WHEN es la expresión booleana que seda como resultado si se utiliza el formato buscado CASE.


ConversiónLas funciones de conversión convierten un tipo de datos en otro tipo de datos.

CASTConvierte un valor de un tipo de IBM Cognos Real-time Monitoring a otro tipo deCognos Real-time Monitoring.

SintaxisCAST( value AS vcDataType )

Parámetrosv value

Valor para convertir.v vcDataType

Uno de los tipos de datos C-SQL para convertir (consulte: Capítulo 9, “Tipos dedatos”, en la página 69).– INTEGER


– DECIMAL– DOUBLE PRECISION– VARCHAR– TIMESTAMP– BOOLEAN– LONG

Tipo de devolución

Igual que el argumento vcDataType.

Comentarios

Los tipos se convierten según la tabla “Orden de prioridad” en la página 70 de“Conversión de tipo de datos” en la página 69. CAST() devuelve un error si no sepuede convertir un tipo tal como se especifica en una expresión. Por ejemplo, losiguiente es un error porque C-SQL intenta convertir ‘4,5' en un INTEGER, pero eldecimal es un carácter no permitido para los tipos INTEGER:3 < CAST( ’4.5’ AS INTEGER )

Al convertir de una columna de decimal con formato a una cadena, se añadenceros en los decimales del resultado para que coincida con la escala, igual que alconvertir de una cadena a un decimal. Por ejemplo,CAST( ’1.1’ AS DECIMAL(5,4) ) --> 1.1000

CAST( CAST( ’1.1’ AS DECIMAL(5,4) ) AS VARCHAR ) -->’1.1000’

Ejemplo

Conversión de una cadena de fecha a una indicación de fecha y hora:SELECT CAST(’1997-10-22’AS TIMESTAMP )

FROM Cambrian;

Consulte también

“Conversión de tipo de datos” en la página 69 proporciona detalles sobre laconversión de tipos.

“TO_CHAR” en la página 150 convierte la indicación de fecha y hora en unacadena de caracteres de un formato especificado.

“TO_DATE” en la página 150 convierte una cadena de caracteres a una fecha.

Fecha y horaLas funciones de fecha y hora sirven para gestionar datos relacionados con lasfechas, la hora y las indicaciones de fecha y hora.

CURRENT_TIMESTAMPEsta función escalar devuelve la fecha y hora actuales de la zona horaria delservidor.


SintaxisCURRENT_TIMESTAMP()

Tipo de devolución

Fecha y hora.

Ejemplo

LAST_DAY( CURRENT_TIMESTAMP() ) devuelve la fecha del último día del mesactual.

Consulte también

“TO_CHAR” en la página 150 convierte una indicación de fecha y hora a unacadena de caracteres.

“LAST_DAY” en la página 146 devuelve la fecha del último día de un mes.

“DATE_ADD” suma una duración a un valor de fecha y hora.

“DATE_DIFF” en la página 145 resta una duración a un valor de fecha y hora.

“TIMESTAMP_DIFF” en la página 149 devuelve un intervalo de tiempo entre dosindicaciones de fecha y hora.

DATE_ADDEsta función escalar suma una duración de tiempo a un valor de fecha y hora.

SintaxisDATE_ADD( timestamp, [ durationType, ] duration )

Parámetrosv timestamp

La fecha y hora para ajustar.v durationType

Tipo de valor de duración; uno de estos literales:– SECOND– MINUTE– HOUR– DAY (valor predeterminado)– MONTH– YEAR

Tipo de devolución

Fecha y hora.

Comentarios

Sigue las reglas del calendario gregoriano.


Ejemplo

DATE_ADD( CURRENT_TIMESTAMP(), 2) devuelve una fecha y hora dos días despuésdel momento actual.

DATE_ADD( timestamp, DAY, 14 ) devuelve un valor 2 semanas después de lafecha.

Consulte también

“DATE_DIFF” resta una duración a un valor de fecha y hora.

“CURRENT_TIMESTAMP” en la página 143 devuelve la fecha y hora actuales.


DATE_DIFFEsta función escalar resta una duración de un valor de fecha y hora.

SintaxisDATE_DIFF( timestamp, [ durationType, ] duration )

Parámetrosv timestamp

Valor de fecha y hora del que restar alguna duración de tiempo.v durationType

Tipo de valor de duración; uno de estos literales:– SECOND– MINUTE– HOUR– DAY (valor predeterminado)– MONTH– YEAR

Tipo de devolución

Fecha y hora.

Comentarios

Sigue las reglas de resta del calendario gregoriano.

Las duraciones que abarcan días y segundos de un año bisiesto normalmentepasan por alto el valor de año bisiesto. Por ejemplo, si se resta un año del 3 demarzo de 1976 da como resultado el 3 de marzo de 1975, sin que le afecte el día deaño bisiesto 29 de febrero de 1976. Sin embargo, restar un año del 29 de febrero dacomo resultado una fecha de 28 de febrero.

Ejemplos

DATE_DIFF( CURRENT_TIMESTAMP(), 2) devuelve una fecha y hora dos díasantes del momento actual.


Consulte también

“DATE_ADD” en la página 144 suma una duración a un valor de fecha y hora.



GREATESTEsta función escalar devuelve el valor más alto de una lista de resultados deexpresiones.

SintaxisGREATEST( value, value [, value ... ] )

Parámetrosv value

Valor que se utilizará para la comparación. Todos los valores después delprimero se convierten al tipo de datos del primero.

Tipo de devolución

Mismo tipo de datos que el argumento.

Ejemplo

Selecciona la cadena con el valor más alto:SELECT Greatest(

’SCHOLAR’,

’SKYLER’,

’SHUELLER’)

FROM Students;

Greatest

--------

SKYLER

Consulte también

“LEAST” en la página 147 determina el valor más bajo de una lista.

“MAX” en la página 179 devuelve el valor máximo de un conjunto.

“Tipos de funciones” en la página 125 trata sobre los conjuntos móviles.

LAST_DAYEsta función escalar devuelve la fecha del último día del mes que contiene unafecha específica.

SintaxisLAST_DAY( dateTime )


Parámetrosv dateTime

Una fecha válida (TIMESTAMP).

Tipo de devolución

Fecha y hora.

Ejemplo

LAST_DAY( CURRENT_TIMESTAMP() ) devuelve la fecha del último día del mesactual.

Consulte también


LEASTEsta función escalar devuelve el valor más bajo de una lista de expresiones.

SintaxisLEAST( value, value [, value ... ] )

Parámetrosv value


Tipo de devolución

El mismo tipo de datos que el argumento.

EjemploSELECT Least(

’SCHOLAR’,

’SKYLER’,

’SHUELLER’)

FROM Students;

Least

------

SCHOLAR

Consulte también

“GREATEST” en la página 146 determina el valor más alto de una lista.

“MIN” en la página 180 devuelve el valor mínimo de un conjunto.



PRIOR_VALUEEsta función escalar devuelve el valor anterior de una columna, un alias o unaexpresión.

SintaxisPRIOR_VALUE( columnName )

Parámetrosv columnName

Columna o alias de cualquier tipo de datos por evaluar.

Tipo de devolución


Comentarios

Devuelve NULL si no hay valor anterior, la primera vez que se invoca la funciónen el nombre de columna.

Utiliza PRIOR_VALUE() cuando los datos (flujos de datos) entran en el sistemaagrupados y ordenados.

Esta función no se puede ejecutar en la cláusula WHERE (consulte: “CláusulaWHERE” en la página 339) de una definición de vista.

Ejemplo

En esta consulta se identifica el tiempo que tardó una tarea en completarse (comoun porcentaje de una hora) en minutos desde que se completó la tarea anterior:SELECT Task, CAST(

(TIMESTAMP_DIFF(PRIOR_VALUE(Completed),Completed,MINUTE ) /60

, DECIMAL(5,4)

) AS Hours

FROM Tasks_Completed

Task Hours

--------------- ------

Startup

Initialize 0.0887

Begin job 0.1012

Finish job 4.3243

Clean up 0.2500

Shut down 0.1285

Have milk shake 0.6667

Consulte también

“PREV” en la página 186 devuelve un valor de la penúltima fila de un conjunto.


TIMESTAMP_DIFFEsta función escalar devuelve, como valor absoluto, el intervalo de tiempo entredos indicaciones de fecha y hora.

SintaxisTIMESTAMP_DIFF( startTime, endTime, unit )

Parámetrosv startTime

Fecha y hora de inicio.v endTime

Fecha y hora de final.v unit

Tipo de intervalo de tiempo que se devolverá; uno de estos literales:– SECOND– MINUTE– HOUR– DAY MONTH (30 días) YEAR (12 meses o 360 días)

Tipo de devolución

INTEGER.

Comentarios

Utiliza la diferencia de tiempo absoluta redondeada al siguiente valor entero másalto; no utiliza la aritmética del calendario gregoriano.

Redondea el resultado al entero más cercano. Por ejemplo, la diferencia entre 10:00y 10:29 en la unidad HOUR es cero (0), pero para 10:00 y 10:30 se devuelve uno(1).

Devuelve NULL si alguna de las indicaciones de fecha y hora es NULL.

Ejemplo

Devuelve el recuento de días desde el momento actual hasta el final del mes.TIMESTAMP_DIFF( CURRENT_TIMESTAMP(),

LAST_DAY( CURRENT_TIMESTAMP() ), DAY)

Devuelve True cuando un tíquet de problema lleva más de 30 minutos abierto:TIMESTAMP_DIFF( ticket_opened, CURRENT_TIMESTAMP(), MINUTE)> 30

Devuelve el número de días entre dos fechas como un número positivo, sinimportar qué fecha es la más antigua:ABS( TIMESTAMP_DIFF( father_birthdate, mother_birthdate,DAY) )


Consulte también

“DATE_ADD” en la página 144 suma una duración a un valor de fecha y hora.

“DATE_DIFF” en la página 145 resta una duración a un valor de fecha y hora.


TO_CHAREsta función escalar convierte una fecha y hora a una cadena de caracteres.

SintaxisTO_CHAR( date, [ format ] )

Parámetrosv date

Valor de fecha y hora (consulte: “Fecha y hora” en la página 76) por convertir.v format

Modelo de fecha de cadena idéntico al utilizado por la clase JavaSimpleDateFormat, que utiliza estas letras en los modelos, como se describe en“Formato de fecha y hora” en la página 80. Omita esta opción para realizar laconversión con el formato predeterminado, que es "yyyy-MM-ddHH:mm:ss.SSSSSSSSS".

Tipo de devolución

VARCHAR.

Comentarios

Para más información sobre la conversión, consulte: “Conversión entre valores defecha-hora y cadenas” en la página 76.

Ejemplos

TO_CHAR(CURRENT_TIMESTAMP(), 'd MMMM yy') devuelve '5 Marzo 03'.

Consulte también

“CAST” en la página 142 convierte un tipo de datos a otro.

“TO_DATE” convierte una cadena de caracteres a una fecha.


TO_DATEEsta función escalar convierte una cadena de caracteres a un valor de fecha y hora.

SintaxisTO_DATE( string, [ format ] )


Parámetrosv string

Cadena de fecha (VARCHAR) o literal por convertir.v format

Modelo de fecha de cadena idéntico al utilizado por la clase JavaSimpleDateFormat, que utiliza estas letras en los modelos, como se describe en“Formato de fecha y hora” en la página 80. Omita esta opción para realizar laconversión con el formato predeterminado, que es "yyyy-MM-ddHH:mm:ss.SSSSSSSSS".

Tipo de devolución

Fecha y hora.

Comentarios

Si omite los valores de hora del modelo, la parte de TIMESTAMP que provoca quela hora se establezca en media noche se llena con un cero (0).

Ejemplos

TO_DATE('2003-02-18') es idéntico a TO_DATE('2003-02-18', "yyyy-MM-dd").

TO_DATE('2003-02-18 12:00:00', 'yyyy-MM-dd HH:mm:ss') asigna el mediodíacomo hora.

Para quitar la parte de hora de una indicación de fecha y hora (TIMESTAMP),conviértala en una cadena de caracteres y vuelva a convertirla en fecha:TO_DATE( TO_CHAR( a_timestamp, ’yyyy-MM-dd’ ) )

Consulte también

“CAST” en la página 142 convierte un tipo de datos a otro.

“TO_CHAR” en la página 150 convierte una fecha a una cadena de caracteres.


NúmerosLas funciones de número se utilizan para realizar operaciones con datosnuméricos.

ABSEsta función escalar devuelve el valor absoluto de un número.

SintaxisABS( numeric )

Parámetrosv numeric

Expresión que da un valor numérico como resultado.


Tipo de devolución

Numérico, mismo tipo de datos que el argumento numeric.

Ejemplo

Devuelve la diferencia de edad entre dos personas, independientemente de cuálsea mayor.SELECT ABS( father_age - mother_age ) AS "Differenceof parents ages"

FROM Family

Consulte también

“SIGN” en la página 162 devuelve el signo aritmético de un número.

CEILEsta función escalar devuelve el entero menor, redondeado al alza de cero, mayoro igual que un número.

SintaxisCEIL( numeric )


Número para redondear.

Tipo de devolución

Mismo tipo de datos que el de numeric.

Ejemplo

CEIL(1234,56) devuelve 1235,00.

CEIL(-2,75) devuelve -2,00.

Consulte también

“FLOOR” en la página 155 devuelve el valor más grande que sea menor o igualque un número.

DISPLAY_MONEYEsta función escalar formatea un número como valor de moneda.

SintaxisDISPLAY_MONEY( number [, languageCode, countryCode ])

Parámetrosv number

Número que se va a formatear.v languageCode


Código de idioma ISO 639 de dos letras. Ayuda a determinar el símbolo demoneda que se debe visualizar.

v countryCodeCódigo de país o región ISO 3166 de dos letras. Especifica el separador demillares, el separador decimal y el número de dígitos decimales que sevisualizarán en función de lo que sea adecuado para el país o región.

Tipo de devolución

VARCHAR.

Comentarios

Devuelve el número formateado como cadena de moneda.

Si se omiten languageCode y countryCode, se utiliza el símbolo y el formatoadecuados para el país o región que el sistema tiene configurado para utilizar deforma predeterminada.

Algunos símbolos de moneda requieren que el navegador esté configurado para lapágina de códigos correcta correspondiente al idioma.

Códigos comunes

En la siguiente tabla se indican algunos de los códigos comunes de idioma ISO 639de dos letras:

Tabla 55. Códigos de país o región comunes

Idioma Código Idioma Código Idioma Código

Afrikáans af Fiyi fj Neerlandés nl

Árabe ar Feroés fo Noruego no

Catalán ca Francés fr Punjabí pa

Corso co Hebreo he Polaco pl

Checo cs Hindú hi Portugués pt

Danés da Croata hr Ruso ru

Alemán de Italiano it Serbo-Croata sh

Griego el Inuktitut iu Sueco sv

Inglés en Japonés ja Turco tr

Español es Coreano ko Urdu ur

Persa fa Mongol mn Yoruba yo

Finés fi Nepalí ne Chino zh

En la siguiente tabla se indican algunos de los códigos comunes de país o regiónISO 3166 de dos letras.

Tabla 56. Códigos de país o región de dos letras ISO 3166 comunes

País o región Código País o región Código

AUSTRALIA AU NEPAL NP

AUSTRIA AT PAÍSES BAJOS NL


Tabla 56. Códigos de país o región de dos letras ISO 3166 comunes (continuación)

País o región Código País o región Código

BRASIL BR NUEVA ZELANDA NZ

CANADÁ CA NORUEGA NO

CHINA CN OMÁN OM

CROACIA (nombrelocal: Hrvatska)

HR PAKISTÁN PK

DINAMARCA DK PITCAIRN PN

FIYI FJ POLONIA PL

FINLANDIA FI PORTUGAL PT

FRANCIA FR ARABIA SAUDÍ SA

ALEMANIA DE SUDÁFRICA ZA

GRECIA GR ESPAÑA ES

INDIA IN SUIZA CH

IRÁN (RepúblicaIslámica de)

IR TAILANDIA TH

ISRAEL IL TURQUÍA TR

ITALIA IT EMIRATOS ÁRABESUNIDOS

AE

JAPÓN JP REINO UNIDO GB

COREA (RepúblicaPopular de)

KP ESTADOS UNIDOS US

MÉXICO MX -- --

Ejemplos

A continuación se ofrecen algunos ejemplos que formatean el número 12345,678:

Tabla 57. Ejemplos que formatean el número 12345.678

Idioma/país oregión Fórmula Resultado

Inglés/EE. UU. DISPLAY_MONEY(12345,678,'en','us') $12,345.68

Sueco/Suecia DISPLAY_MONEY(12345,678,'sv','se') 12 345,68 kr

Alemán/Alemania

DISPLAY_MONEY(12345,678,'de','de') 12.345,68 dm

EXPEsta función escalar devuelve e elevado a una potencia específica.

SintaxisEXP( power )

Parámetrosv power

La potencia (DOUBLE) a la que se eleva e.


Tipo de devolución

DOUBLE PRECISION.

Comentarios

Devuelve e elevado a la potencia nth, donde e = 2,71828183...

Ejemplo

EXP(4) eleva e a la 4.a potencia y devuelve 54,59815.

Consulte también

“LOG” en la página 157 devuelve el logaritmo de un número de una baseespecífica.

“POWER” en la página 158 eleva un número a una potencia específica.

FLOOREsta función escalar devuelve el entero más grande que sea menor o igual que unaexpresión.

SintaxisFLOOR( numeric )


Número que se debe redondear a la baja.

Tipo de devolución


Ejemplo

FLOOR('1234,56') devuelve el entero 1234,00, después de convertir implícitamenteel literal de cadena a DECIMAL.

FLOOR(-2,75) devuelve -3,00.

El comportamiento de esta función es el mismo que el de la función INT() deMicrosoft Excel INT().

Consulte también

“CEIL” en la página 152 devuelve el entero más pequeño redondeado al alza.




Parámetrosv value


Tipo de devolución


Ejemplo


’SCHOLAR’,

’SKYLER’,

’SHUELLER’)

FROM Students;

Greatest

--------

SKYLER

Consulte también






Parámetrosv value


Tipo de devolución



’SCHOLAR’,

’SKYLER’,

’SHUELLER’)

FROM Students;

Least

------


SCHOLAR

Consulte también




LOGEsta función escalar devuelve el logaritmo de un número de una base específica.

SintaxisLOG( numeric [, base ] )


Número (DOUBLE) del que se recupera el logaritmo; debe ser mayor que 1.v base

Base (DOUBLE) del logaritmo; debe ser mayor que cero (0). Omita esta opciónpara utilizar el logaritmo natural de "numeric".

Tipo de devolución

DOUBLE PRECISION.

Comentarios

Se puede expresar matemáticamente como .

Ejemplo

LOG(8,64) devuelve 2,0.

LOG(2) devuelve 0,301029...

Consulte también

“EXP” en la página 154 para elevar a una potencia específica.

“POWER” en la página 158 para elevar un valor a una potencia específica.

MODEsta función escalar devuelve el módulo (resto) de una división.

SintaxisMOD( dividend, divisor )

Parámetrosv dividend

Numérico que se va a dividir.v divisor


Numérico por el que se va a dividir.

Tipo de devolución

INTEGER.

Comentarios

Cuando divisor es cero (0), se devuelve dividend.

Cuando dividend es negativo, el comportamiento de esta función es distinto del dela función de módulo matemático clásica. El módulo clásico se puede expresar conesta fórmula:dividend - divisor * FLOOR(dividend/divisor)

La función siguiente utiliza la fórmula actualizada:SIGN(dividend) *

(ABS(dividend) - ABS(divisor * FLOOR(ABS(dividend/divisor))))

Esta tabla muestra la diferencia entre la función MOD y la fórmula de móduloclásica:

Tabla 58. Diferencia entre la función MOD y la fórmula de módulo clásica

Dividendo DivisorMOD(dividend,divisor) Módulo clásico

11 4 3 3

11 -4 3 -1

-11 4 -3 1

-11 -4 -3 -3

La mayoría de los sistemas de gestión de bases de datos utilizan la misma fórmulaque IBM Cognos Real-time Monitoring, mientras que las aplicaciones de hoja decálculo como Microsoft Excel utilizan el módulo clásico.

Ejemplo

Devolver el resto del dividendo dividido por el divisor:SELECT MOD(11,4) "Modulus" FROM Census;

Modulus

-------

3

POWEREsta función escalar devuelve un valor elevado a una potencia específica.

SintaxisPOWER( numeric, power )


Número por elevar.


v powerPotencia a la que se elevará el número. Si el número es negativo, debe ser unentero.

Tipo de devolución

El mismo tipo de datos que el argumento numeric.

Comentarios

Se puede expresar matemáticamente como una potencia numérica.

Ejemplo

POWER(3,5) devuelve 243.

Consulte también

“EXP” en la página 154 eleva e a una potencia concreta.

“LOG” en la página 157 devuelve el logaritmo de un número de una baseespecífica.





Tipo de devolución


Comentarios



Esta función no se puede ejecutar en la “Cláusula WHERE” en la página 339 deuna definición de vista.

Ejemplo




, DECIMAL(5,4)

) AS Hours


Task Hours

--------------- ------

Startup

Initialize 0.0887

Begin job 0.1012

Finish job 4.3243

Clean up 0.2500

Shut down 0.1285


Consulte también


ROUNDEsta función escalar devuelve un número redondeado a un recuento especificadode decimales.

SintaxisROUND( number, [ places ] )

Parámetrosv number

La expresión numérica por redondearv places

Recuento de posiciones decimales al que se redondeará. Un entero negativofuerza el redondeo a dígitos de número entero. El valor predeterminado es cero(0), que elimina los componentes fraccionarios.

Tipo de devolución

Numeric, el mismo tipo de datos que el argumento number.

Ejemplos

ROUND(1294,5078) devuelve 1294.

ROUND(1294,5078, 0) devuelve 1294.

ROUND(1294,5078, 1) devuelve 1294,5.

ROUND(1294,5078, 2) devuelve 1294,51.

ROUND(1294,5078, -2) devuelve 1300.

Consulte también

“TRUNC” en la página 162 elimina dígitos de un número.


SAFE_DIVIDEEsta función escalar devuelve un cociente determinado por un dividendo, undivisor y un cociente de división por cero alternativo.

Si el divisor es distinto de cero, esta función devuelve el cociente del dividendodividido por el divisor. Si el divisor es cero, o si se produce otro error de datos detiempo de ejecución mientras se calcula el cociente, por ejemplo que un DECIMALquede fuera de rango, se devuelve el cociente alternativo.

Normalmente se utilizan decimales para los valores del dividendo y del divisor.

SintaxisSAFE_DIVIDE(numberDividend,numberDivisor,numberAlternateQuotient)

Parámetrosv numberDividend

El valor numérico que se dividirá.El tipo de datos viene determinado por la forma en la que se entra el valor. Si elvalor se entra sin ningún decimal, por ejemplo 19, el valor se convierte como sise tratara de un entero. Si el valor se entra con un decimal, por ejemplo 19,00, elvalor se convierte como si se tratara de un decimal.

v numberDivisorEl valor numérico por el que se divide el dividendo.Este valor se convierte automáticamente como el mismo tipo de datos quenumberDividend.

v numberAlternateQuotientPuede devolverse un valor numérico si el cociente resultante es 0 o si se producealgún otro error de datos de ejecución al calcular el cociente.

Tipo de devolución

Numeric, el mismo tipo de datos que el argumento number.

Ejemplos

SAFE_DIVIDE (100,20,4321) devuelve 5.

SAFE_DIVIDE (100.19.5,4321) devuelve 5. 19,5 se convierte como un entero con elvalor de 19.

SAFE_DIVIDE (100.00,19.5,4321) devuelve 5,12. Al cociente se le asigna el mismonúmero de comas decimales que numberDividend, en este caso dos comasdecimales.

SAFE_DIVIDE (SAFE_DIVIDE(100.000,19.5,4321) devuelve 5,128. Al cociente se leasigna el mismo número de comas decimales que numberDividend, en este casotres comas decimales.

SAFE_DIVIDE (100.0,4321) devuelve 4321. Dado que el cociente denumberDividend y numberDivisor tiene el valor 0, se devuelve el valor denumberAlternateQuotient.


SIGNEsta función escalar identifica el signo aritmético de un número.

SintaxisSIGN( number )

Parámetrosv number

El valor numérico por evaluar.

Tipo de devolución

INTEGER.

Comentarios

Devuelve 1 si el número es positivo, 0 si el número es cero y -1 si el número esnegativo.

Estas expresiones devuelven resultados idénticos:(number * SIGN(number) )

ABS(number)

Consulte también

“ABS” en la página 151 devuelve el valor absoluto de un número.

SQRTEsta función escalar devuelve la raíz cuadrada de un número.

SintaxisSQRT( number )

Parámetrosv number

El número (DOUBLE) por evaluar. Debe ser mayor que cero (0).

Tipo de devolución

DOUBLE PRECISION.

Ejemplo

SQRT(42) devuelve 6,480...

TRUNCEsta función escalar trunca un número decimal según un recuento específico deposiciones decimales.

En las indicaciones de fecha y hora, esta función devuelve cero en los campos cuyovalor es inferior a la precisión especificada.


SintaxisTRUNC( decimalNumber [, places ] )

TRUNC( timestamp [, ’D’ | ’h’ | ’m’ | ’s’ ] )

Parámetrosv decimalNumber

Número que se va a truncar.v timestamp

Indicación de fecha y hora que se va a truncar.v places

Recuento de posiciones decimales al que se truncará. Si se omite, se truncantodos los decimales y se devuelve un entero. Si es negativo, convierte los dígitosa cero.

v 'D'Devuelve únicamente la información de día en la indicación de fecha y hora. Lashoras, los minutos y los segundos se devuelven como cero.

v 'h'Devuelve únicamente la información de día y hora en la indicación de fecha yhora. Los minutos y los segundos se devuelven como cero.

v 'm'Devuelve únicamente la información de día, hora y minuto en la indicación defecha y hora. Los segundos se devuelven como cero.

v 's'Devuelve únicamente la información de día, hora y segundo en la indicación defecha y hora, pero no muestra los milisegundos.

Tipo de devolución

Numeric, el mismo tipo de datos que el argumento decimalNumber.

Ejemplos

TRUNC(1234,567) devuelve 1234.

TRUNC(1234,567, 1) devuelve 12345,6.

TRUNC(1234,567, -2) devuelve 1200.

TRUNC(2007-06-27 11:01:414,213, 'D') devuelve 2007-06-27 0:0:0.0

TRUNC(2007-06-27 11:01:414,213, 'D 'h') devuelve 2007-06-27 11:0:0.0

TRUNC(2007-06-27 11:01:414,213, 'D 'h' 'm') devuelve 2007-06-27 11:01:0.0

TRUNC(2007-06-27 11:01:414,213, 'D 'h' 'm' 's') devuelve 2007-06-27 11:01:213,0

Consulte también

“ROUND” en la página 160 redondea un número al alza hasta un recuentoespecificado de posiciones decimales.


IS_ACKEDEsta función escalar devuelve true cuando la alerta especificada tiene un estadoconfirmado.

SintaxisIS_ACKED(’alertName’)

Parámetrosv alertName

Nombre completo de una alerta (consulte: Capítulo 5, “Alertas”, en la página41). El nombre debe incluir el nombre de la actividad empresarial que locontiene y del escenario, por ejemplo 'activityName.scenarioName.alertName'.

Tipo de devolución

Booleano.

Comentarios

Devuelve True si la alerta existe y su estado es confirmado. En caso contrario, si laalerta no se confirma o no existe, devuelve False.

Como esta función devuelve False cuando la alerta no existe, no hay ningunaprueba que garantice que el nombre especificado sea una alerta válida en elsistema. Por tanto, si se escribe mal el nombre, la función siempre devuelve False.

Utilice esta función en una condición de regla para probar el estado de una alertay para generar una alerta nueva cuando la alerta probada no se ha confirmadodurante un determinado periodo de tiempo.

Cuando se utiliza en una definición de vista, esta última no puede tener unafunción de conjunto.

IS_RAISEDEsta función escalar devuelve true cuando la alerta especificada se ha emitido.

SintaxisIS_RAISED(’alertName’)

Parámetrosv alertName

Nombre completo de una alerta (consulte: Capítulo 5, “Alertas”, en la página41). El nombre debe incluir el nombre de la actividad empresarial y el nombrede escenario que la contiene, como por ejemplo,'activityName.scenarioName.alertName'.

Tipo de devolución

Booleano.


Comentarios

Devuelve True si la alerta existe y se ha emitido. En caso contrario, si la alerta seha cancelado o no existe, devuelve False.

Como esta función devuelve False cuando la alerta no existe, no hay ningunaprueba que garantice que el nombre especificado sea una alerta válida en elsistema. Por tanto, si se escribe mal el nombre, la función siempre devuelve False.

Utilice esta función en una condición de regla para probar el estado de una alertay para generar una alerta nueva cuando la alerta probada permanezca canceladadurante un determinado periodo de tiempo.

Cuando se utiliza en una definición de vista, esta última no puede tener unafunción de conjunto.

Para obtener más información, consulte: “Reglas que supervisan alertas” en lapágina 321.





Tipo de devolución


Comentarios




Ejemplo



, DECIMAL(5,4)

) AS Hours



Task Hours

--------------- ------

Startup

Initialize 0.0887

Begin job 0.1012

Finish job 4.3243

Clean up 0.2500

Shut down 0.1285


Consulte también


SistemaLa función de esta categoría se utiliza para devolver un nombre de inicio desesión.

CURRENT_USEREsta función escalar devuelve el nombre de inicio de sesión del usuario actual.

SintaxisCURRENT_USER()

Tipo de devolución

VARCHAR.

Comentarios

Devuelve el nombre de inicio de sesión del usuario tal como se define en IBMCognos Real-time Monitoring, con las mismas mayúsculas y minúsculas, y talcomo aparece en Cognos Real-time Monitoring Workbench. Cuando se utiliza enuna comparación, asegúrese de reproducir exactamente las mismas mayúsculas yminúsculas de los caracteres.

Esta función es principalmente para su uso en filtros de acceso. Para obtenerejemplos y usos, consulte: Capítulo 2, “Filtros de acceso”, en la página 3, sobretodo la sección “Tablas de consulta de usuarios en filtros de acceso” en la página 4.

Otros

Estas funciones se pueden utilizar con alertas.

TextoLas funciones de texto se utilizan para realizar operaciones en las cadenas.

CHAR_LENGTHEsta función escalar devuelve la longitud de una cadena.


SintaxisCHARACTER_LENGTH( string )

Parámetrosv string

Resultado de cadena o expresión VARCHAR cuya longitud se va a evaluar.

Tipo de devolución

INTEGER.

Comentarios

Una escritura alternativa es:CHAR_LENGTH( string )

Devuelve un entero que es la longitud de la cadena. Devuelve NULL si la cadenaes NULL.

La longitud de la cadena viene determinada por sus caracteres visualizables, y nonecesariamente por la longitud de almacenamiento de la cadena. Por ejemplo, uncarácter Unicode necesita 16 bits de almacenamiento [lo cual se puede considerarcomo dos caracteres de almacenamiento en algunos sistemas], pero la longitud decarácter real es 1.

CONCATEsta función escalar devuelve una cadena que es la concatenación de dos caractereso cadenas.

SintaxisCONCAT( string1, string2 )

Parámetrosv string

Valor de cadena de caracteres o resultado de una expresión VARCHAR.

Tipo de devolución

VARCHAR.

Comentarios

Devuelve cadena2 sufijada al final de la cadena1. Devuelve NULL si alguna cadenaes NULL.

El operador || (“Operadores de cadena” en la página 287) es idéntico a estafunción.

Ejemplos

CONCAT('a', 'b') devuelve 'ab'.

'a'||'b' devuelve 'ab'.


Consulte también

“concatList” en la página 206 devuelve una cadena que es la concatenación de unalista de caracteres o cadenas.

“concatSet” en la página 207 devuelve un conjunto de cadenas ordenadasalfabéticamente.

“Operadores de cadena” en la página 287 describe el operador ||.



Parámetrosv value


Tipo de devolución


Ejemplo


’SCHOLAR’,

’SKYLER’,

’SHUELLER’)

FROM Students;

Greatest

--------

SKYLER

Consulte también







Parámetrosv value


Tipo de devolución



’SCHOLAR’,

’SKYLER’,

’SHUELLER’)

FROM Students;

Least

------

SCHOLAR

Consulte también




LOWEREsta función escalar convierte todos los caracteres en mayúsculas de una cadena aminúsculas.

SintaxisLOWER( string )

Parámetrosv string

Cadena por convertir.

Tipo de devolución

VARCHAR.

Ejemplo

LOWER('Stage Right') devuelve ‘stage right'.

Consulte también

“UPPER” en la página 175 convierte a todo mayúsculas.


LPADEsta función escalar inserta una o varias instancias de una cadena en el principiode otra cadena.

SintaxisLPAD( string, length, [ padChar ] )

Parámetrosv string

Carácter o cadena por modificar.v length

La longitud de visualización de la cadena devuelta. Debe ser cero (0) o mayor. Sise utilizan caracteres de varios bytes, la longitud es el recuento de caracteres quese visualizan o imprimen, en lugar del recuento de varios bytes.

v padCharCarácter o cadena por insertar. El valor predeterminado es un único espacio oun carácter en blanco (' ').

Tipo de devolución

VARCHAR.

Comentarios

Devuelve una cadena con el mismo tipo de caracteres que el parámetro string.

Cuando el valor de longitud es menor que la longitud de la cadena, devuelve lacadena truncada según esa longitud.

Ejemplos

LPAD('ABC',6,'x') devuelve 'xxxABC'.

LPAD('ABC',6,'xo') devuelve 'xoxABC'.

LPAD('ABC',4) devuelve ' ABC'.

LPAD('ABC', 2, 'x') devuelve 'AB'.

Consulte también

“RPAD” en la página 173 añade caracteres al final de una cadena.

LTRIMEsta función escalar elimina caracteres del principio de una cadena.

SintaxisLTRIM( wholeString [, setString ] )

Parámetrosv wholeString

Cadena por recortar.


v setStringCaracteres por eliminar; el valor predeterminado es un único espacio en blanco ('').

Tipo de devolución

VARCHAR.

Comentarios

Suprime repetidamente todas las instancias de setString desde el principio dewholeString hasta que wholeString ya no comienza por setString, y devuelve elresultado.

Ejemplos

LTRIM(' ZZZ') devuelve 'ZZZ'.

LTRIM('aaaZZZ','a') devuelve 'ZZZ'.

LTRIM('ababaZZZ','ab') devuelve 'aZZZ'.

LTRIM('abcabaZZZ','abc') devuelve 'abaZZZ'.

Consulte también

“RTRIM” en la página 174 elimina caracteres del final de una cadena.

POSITIONEsta función escalar devuelve la posición de un carácter o una cadena dentro deuna cadena.

SintaxisPOSITION( sourceForString , searchInString )

Formato alternativo: POSITION( sourceForString IN searchInString )

Parámetrosv sourceForString

Cadena por buscar.v sourceInString

Resultado de expresión de cadena en la que se realizará la búsqueda.

Tipo de devolución

INTEGER.

Comentarios

Devuelve la posición, empezando en 1, de la primera instancia de sourceForStringen el resultado de sourceInString. CuandoCHARACTER_LENGTH(sourceForString) es cero (0), devuelve 1. Devuelve NULLcuando alguno de los argumentos es NULL.


Ejemplos

POSITION( 'a' IN 'banana') devuelve 2.

POSITION( 'ana' IN 'banana') devuelve 2.

POSITION( 'A' IN 'banana') devuelve 0.

POSITION( 'M' IN 'banana') devuelve 0.

POSITION( '' IN 'banana') devuelve 1.

POSITION( NULL IN 'banana') devuelve NULL.

Consulte también

“SUBSTRING” en la página 174 extrae un carácter o una subcadena de una cadena.





Tipo de devolución


Comentarios




Ejemplo



, DECIMAL(5,4)

) AS Hours



Task Hours

--------------- ------

Startup

Initialize 0.0887

Begin job 0.1012

Finish job 4.3243

Clean up 0.2500

Shut down 0.1285


Consulte también


RPADEsta función escalar añade una o varias instancias de una cadena en el final de otracadena.

SintaxisRPAD( string, length, [ padChar ] )

Parámetrosv string

Carácter o cadena por modificar.v length

La longitud de visualización de la cadena devuelta. Si se utilizan caracteres devarios bytes, la longitud es el recuento de caracteres que se visualizan oimprimen, en lugar del recuento de varios bytes.

v padCharCarácter o cadena por sufijar. El valor predeterminado es un único espacio o uncarácter en blanco (' ').

Tipo de devolución

VARCHAR.

Comentarios

Cuando el valor de longitud es menor que la longitud de la cadena, devuelve lacadena truncada según esa longitud.

Ejemplos

RPAD('ABC', 6, 'x') devuelve 'ABCxxx'.

RPAD('ABC', 6, 'xo') devuelve 'ABCxox'.

RPAD('ABC', 4) devuelve 'ABC '.

RPAD('ABC', 2, 'x') devuelve 'AB'.


Consulte también

“LPAD” en la página 170 inserta caracteres al principio de una cadena.

RTRIMEsta función escalar elimina caracteres del final de una cadena.

SintaxisRTRIM( sourceString [, setString ] )

Parámetrosv sourceString

Cadena por recortar.v setString

Caracteres por eliminar; el valor predeterminado es un único espacio en blanco ('').

Tipo de devolución

VARCHAR.

Comentarios

Suprime repetidamente todas las instancias de setString desde el final desourceString hasta que sourceString ya no termina por set, y devuelve el resultado.

Ejemplos

RTRIM(' ZZZ') devuelve 'ZZZ'.

RTRIM('ZZZaaa','a') devuelve 'ZZZ'.

RTRIM('ZZZababab','ab') devuelve 'ZZZ'.

RTRIM('ZZZababc','abc') devuelve 'ZZZab'.

Consulte también

“LTRIM” en la página 170 elimina caracteres del principio de una cadena.

SUBSTRINGEsta función escalar devuelve una subcadena de una cadena especificada.

SintaxisSUBSTRING( string, position, [ length ] ).

Formas alternativas:SUBSTR( string, position, [ length ] )

SUBSTRING( string FROM position [ FOR length ] )


Parámetrosv string

Cadena de caracteres en la que se buscará.v position

Posición inicial de la subcadena, donde 1 es el primer carácter del principio dela cadena y -1 es el último carácter. Los valores negativos se cuentan hacia atrásempezando por el final de la cadena. Si se utiliza (0) se obtiene el mismoresultado que si se utiliza 1. Una posición que no se encuentra dentro de unacadena devuelve una cadena vacía.

v lengthLongitud de la subcadena por extraer. Si no se establece una longitud sedevuelven todos los caracteres desde la posición indicada hasta el final de lacadena. Si se especifica un valor mayor que el número de caracteres de lacadena restantes, se devuelven todos los caracteres desde la posición indicadahasta el final de la cadena y se rellena la diferencia con caracteres de espaciopara alcanzar la longitud especificada. Un valor negativo o de cero (0) devuelveuna cadena vacía.

Tipo de devolución

VARCHAR.

Ejemplos

SUBSTR(’breakfast’, 1) devuelve 'breakfast'.

SUBSTR(’breakfast’, 0) devuelve 'breakfast'.

SUBSTR(’breakfast’, 30) devuelve '' (cadena vacía).

SUBSTR(’breakfast’, 1, 2) devuelve 'br'.

SUBSTR(’breakfast’, CHARACTER_LENGTH(’breakfast’), 2) devuelve 't'.

SUBSTR(’breakfast’, 3, 4) devuelve 'eakf'.

SUBSTR(’breakfast’, 3, 8) devuelve 'breakfast'.

SUBSTR(’breakfast’, -5, 4) devuelve 'kfas'.

SUBSTR(’breakfast’, 1, -1) devuelve '' (cadena vacía).

Consulte también

“CHAR_LENGTH” en la página 166 devuelve la longitud de una cadena decaracteres.

“POSITION” en la página 171 localiza un carácter dentro de una cadena.

UPPEREsta función escalar convierte todos los caracteres en minúsculas de una cadena amayúsculas.


SintaxisUPPER( string )

Parámetrosv string

Cadena de caracteres (VARCHAR) por convertir.

Tipo de devolución

VARCHAR.

Ejemplo

UPPER('Volta') devuelve 'VOLTA'.

Consulte también

“LOWER” en la página 169 convierte a todo minúsculas.

Serie temporal y conjunto de agregadosLas funciones de serie temporal y conjunto de agregados se utilizan para lasoperaciones que implican conjuntos de ventanas móviles y conjuntos de números.

Consulte también: “MOV_function” en la página 136.

AVGEsta función de conjunto devuelve el valor medio (media aritmética) de unconjunto de valores numéricos.

SintaxisAVG( numeric )


Una expresión que da un número como resultado y que no puede hacerreferencia a una función de clasificación. Típicamente el argumento es unacolumna en una vista.

Tipo de devolución


Comentarios

Calcula el valor numérico medio en todas las filas de la vista referenciada. Alutilizar una cláusula GROUP BY (consulte: “cláusula GROUP BY” en la página340), el promedio se aplica al valor numérico de cada grupo.SELECT AVG( pr_price ) "Average price" FROM Products

Average price

-------------

49.96


Ejemplo

El siguiente ejemplo utiliza promedios móviles para producir resultados similares aun indicador de convergencia/divergencia de promedio móvil (MACD). (Esteejemplo no es un verdadero MACD porque no utiliza un promedio móvilexponencial). En el comercio de valores, la regla básica MACD de comercio esvender cuando el MACD cae por debajo de su promedio de nueve días y comprarcuando el MACD sube por encima de su promedio de nueve días. Esto se puedelograr definiendo reglas parecidas a las de este ejemplo:v Emitir SELL cuando MACD > Nine_Day_MA Inferior SELL cuando MACD <

Nine_Day_MAv Emitir BUY cuando MACD < Nine_Day_MA Inferior BUY cuando MACD >

Nine_Day_MA

Para obtener estos valores, se necesitan dos vistas:v MACD_Base_View realiza el seguimiento de los promedios móviles para cada

símbolo de valor en el flujo de datos. La fórmula Nine_Day_MA repite lasfórmulas para los otros dos promedios, porque no es posible hacer referencia aun alias de otra columna de la misma vista.

SELECT

StockQuotes.SYMBOL AS Symbol,

MOV_AVG(StockQuotes_DataStream.CLOSE, Day, 26, StockQuotes.DATE)

AS Twentysix_Day_MA,

MOV_AVG(StockQuotes_DataStream.CLOSE, Day, 12, StockQuotes.DATE)

AS Twelve_Day_MA,

MOV_AVG((MOV_AVG(StockQuotes.CLOSE, Day, 12, StockQuotes.DATE)-

MOV_AVG(StockQuotes.CLOSE, Day, 26, StockQuotes.DATE)),

Day, 9, StockQuotes.DATE ) AS Nine_Day_MA

FROM StockQuotes

GROUP BY StockQuotes.SYMBOL

v MACD_View contiene los últimos valores MACD para cada valor almacenadoen la vista base:

SELECT MACD_Base_View.Symbol AS Symbol,

MACD_Base_View.Nine_Day_MA AS Nine_Day_MA,

(MACD_Base_View.Twentysix_Day_MA -

MACD_Base_View.Twelve_Day_MA

) AS MACD

FROM MACD_Base_View

Consulte también

“median” en la página 209 devuelve el número medio (valor central) de unconjunto.

“mode” en la página 211 devuelve el número que aparece con más frecuencia enun conjunto.

“MOV_AVG” en la página 180 devuelve el promedio móvil de un conjunto.

“TUMBLE_AVG” en la página 188 devuelve el promedio en movimiento de unconjunto.


COUNTEsta función de conjunto devuelve el recuento de filas en una vista o conjunto.

SintaxisCOUNT( * )

Tipo de devolución

INTEGER

Comentarios

Devuelve cero (0) si la vista o el conjunto está vacío.

También se conoce como función count asterisco.

Se cuentan las filas que incluyen NULL.

CURRENTEsta función de conjunto devuelve un valor de la fila más reciente o de la últimafila de un conjunto.

SintaxisCURRENT( columnName )


Columna o alias para recuperar.

Tipo de devolución


Comentarios

Devuelve un valor de la fila más reciente del conjunto según la indicación de fechay hora del flujo de datos. Cuando todas las filas del conjunto tienen la mismaindicación de fecha y hora, la función CURRENT devuelve el valor de la últimafila del conjunto.

Semántica del conjunto móvil

No se puede utilizar con un conjunto móvil o en movimiento.

Ejemplo

Recopile todas las pujas de pienso para ganado (stock feed) y agrúpelas porsímbolo de ganado (stock). La fila "actual" siempre es la última que se recibe y,como tal, contiene el precio de licitación actual:SELECT symbol, CURRENT(bid) AS Bid,MAX(bid)ASHigh, MIN(bid) AS LOW

FROM Stock_feed GROUP BY symbol

symbol Bid High Low


------- ------ ------ -----

K 31.25 31.28 30.72

IBM 80.79 80.04 82.55

VCLR 22.60 24.42 22.00

Consulte también

“PREV” en la página 186 devuelve un valor de la fila anterior a la actual.

MAXEsta función de conjunto devuelve el valor máximo de un conjunto.

SintaxisMAX( expression )

Parámetrosv expression

Una expresión da cualquier tipo de datos como resultado y que no puede hacerreferencia a una función de clasificación. Típicamente el argumento es unacolumna en una vista.

Tipo de devolución

El mismo tipo de datos que el argumento expression.

Comentarios

Para Boolean, True es mayor que False.

Para String, 'z' es mayor que ‘A'.


Cuando se utiliza como una función MOV (consulte: “MOV_function” en la página136) devuelve el valor máximo de un conjunto móvil.MOV_MAX( numeric, window, size [,timestampColumn] )

Ejemplo

Devuelve el precio máximo de todas las filas de Sales:SELECT MAX( price ) FROM Sales;

PRICE

---------

770.00

Consulte también

“MOV_MAX” en la página 183 devuelve el valor máximo de un conjunto deventanas móviles.

“TUMBLE_MAX” en la página 190 devuelve el valor máximo de un conjunto deventanas en movimiento.



“GREATEST” en la página 146 devuelve el valor máximo de una lista.

MINEsta función de conjunto devuelve el valor mínimo de un conjunto.

SintaxisMIN( expression )


Una expresión da cualquier tipo de datos como resultado y que no puede hacerreferencia a una función de clasificación. Típicamente el argumento es unacolumna en una vista.

Tipo de devolución


Comentarios


Para String, 'z' es mayor que 'A'.


Si se utiliza como una “MOV_function” en la página 136, devuelve el valormínimo del conjunto móvil.MOV_MIN( numeric, window, size [,timestampColumn] )

Ejemplo

Devuelve el precio mínimo de todas las filas del conjunto Sales:SELECT MIN( price ) FROM Sales;

PRICE

---------

100.00

Consulte también

“MOV_MIN” en la página 184 devuelve el valor mínimo de un conjunto deventanas móviles.

“TUMBLE_MIN” en la página 192 devuelve el valor mínimo de un conjunto deventanas en movimiento.


“LEAST” en la página 147 devuelve el valor más pequeño de una lista.

MOV_AVGEsta función de conjunto móvil devuelve el valor medio (media aritmética) móvilde un conjunto de ventanas móviles de valores numéricos.


SintaxisMOV_AVG( numeric, window, size [,timestampColumn] )


Una expresión que da un número como resultado y que no puede hacerreferencia a una función de clasificación. Típicamente el argumento es unacolumna en una vista. Consulte las descripciones de funciones individuales paraconocer las restricciones adicionales.

v windowDetermina si el tamaño es el recuento de los flujos de datos en el conjunto(EVENT), o una duración de tiempo (SECOND, MINUTE, HOUR, DAY,MONTH, o YEAR).

v sizeDuración o recuento de la ventana que se utilizará para determinar el tamaño deun conjunto. Debe ser un entero mayor que cero (0).

v timestampColumn(Opcional) Utilice el valor del campo como punto de inicio para el intervalo deserie de tiempo. El cálculo se basa en un intervalo de tiempo desde el valor másreciente de la columna de cualquier fila de la vista. Omita esta opción si quiereutilizar el reloj del sistema como base para la hora.

Tipo de devolución


Comentarios

Devuelve NULL si el grupo está vacío.

Ejemplo

Devuelve el precio promedio de todos los flujos de datos que llegan en unintervalo de siete días:MOV_AVG(price, DAY, 7, trade_time) AS Avg_7_day_price

Consulte también

“Tipos de funciones” en la página 125 muestra una explicación de los conjuntosmóviles.

“AVG” en la página 176 devuelve la media de un conjunto.

“TUMBLE_AVG” en la página 188 devuelve el promedio en movimiento de unconjunto.

MOV_COUNTEsta función de conjunto móvil devuelve el recuento de filas de un conjunto deventanas móviles.

SintaxisMOV_COUNT( *, window, size [,timestampColumn] )


Parámetrosv window

Determina si el tamaño es el recuento de los flujos de datos en el conjunto(EVENT), o una duración de tiempo (SECOND, MINUTE, HOUR, DAY,MONTH, o YEAR).



Tipo de devolución

INTEGER.

Comentarios

Devuelve cero (0) si el conjunto está vacío.


Cuando se utiliza con un GROUP BY, devuelve el recuento de filas del conjunto degrupos. Para obtener más información, consulte: “Interacciones GROUP BY” en lapágina 140.

Ejemplo

Devuelve el recuento de todos los flujos de datos que llegan en el intervalo de 8horas actual:MOV_COUNT(*, HOUR, 8, trade_time) AS Total

La función anterior es la forma abreviada de esta expresión de ventana en línea:COUNT(*) AS Total OVER (ORDER BY trade_time ’8’ HOUR)

Esta expresión equivale a lo siguiente tras especificar todos los valorespredeterminados:COUNT(*) AS Total OVER ( ORDER BY trade_time

RANGE INTERVAL ’8’ HOUR PRECEDING

REFERENCE OPERATOR)

La ventana de ocho horas comienza cuando llega el primer flujo de datos a lavista. Para iniciar la ventana al principio de la hora, incluya INITIALIZE'2003-03-05 00:00:00,000'.

Consulte también


“COUNT” en la página 178 devuelve el recuento de una vista o un conjunto.


“TUMBLE_COUNT” en la página 189 devuelve el recuento de un conjunto deventanas en movimiento.

MOV_MAXEsta función de conjunto móvil devuelve el valor máximo de un conjunto deventanas móviles.

SintaxisMOV_MAX( numeric, window, size [,timestampColumn] )






Tipo de devolución


Comentarios



Ejemplo

Devuelve el precio máximo de todos los flujos de datos que llegan en un intervalode siete días:MOV_MAX(price, DAY, 7, trade_time) AS Max_7_day_price

Consulte también

“MAX” en la página 179 devuelve el valor máximo de un conjunto de ventanasmóviles.

“TUMBLE_MAX” en la página 190 devuelve el valor máximo de un conjunto deventanas en movimiento.




“Tipos de funciones” en la página 125 muestra una explicación de los conjuntosmóviles.

MOV_MINEsta función de conjunto móvil devuelve el valor mínimo de un conjunto deventanas móviles.

SintaxisMOV_MIN( numeric, window, size [,timestampColumn] )






Tipo de devolución


Comentarios



Ejemplo

Devuelve el precio mínimo de todos los flujos de datos que llegan en un intervalode siete días:MOV_MIN(price, DAY, 7, trade_time) AS Min_7_day_price

Consulte también

“MIN” en la página 180 devuelve el valor mínimo de una vista o un conjunto.


“TUMBLE_MIN” en la página 192 devuelve el valor mínimo de un conjunto deventanas en movimiento.




MOV_SUMEsta función de conjunto móvil devuelve la suma de un conjunto de ventanasmóviles de valores numéricos.

SintaxisMOV_SUM( numeric, window, size [,timestampColumn] )






Tipo de devolución

“Tipos de datos C-SQL para valores numéricos” en la página 71, mismo tipo dedatos que el argumento numeric. Devuelve NULL si el conjunto está vacío.

Ejemplo

Calcule el precio total de todos los flujos de datos que llegan en la hora actual:MOV_SUM(Price, HOUR, 1)

Esto es la función anterior es la forma abreviada de esta expresión de ventana enlínea:SUM(Price) OVER (RANGE ’1’ HOUR PRECEDING

REFERENCE OPERATOR)

Consulte también

“SUM” en la página 187 devuelve la suma de una vista o un conjunto.


“TUMBLE_SUM” en la página 193 devuelve la suma de un conjunto de ventanasen movimiento.


PREVEsta función de conjunto devuelve un valor de la penúltima fila de un conjunto.

SintaxisPREV( columnName )



Tipo de devolución


Comentarios

Devuelve valores de la fila anterior a la fila actual de un conjunto, donde la filaactual es la última fila del conjunto según la indicación de fecha y hora del flujo dedatos o, si todas tienen la misma indicación de fecha y hora, la última fila delconjunto.


No se puede utilizar con un conjunto móvil o en movimiento.

Ejemplo

Recopile todos los precios de cierre de pienso para ganado (stock feed) y agrúpelospor símbolo de ganado (stock). La fila "actual" siempre es la última que se recibe y,como tal, contiene el precio de cierre actual. La fila anterior es el cierre del díaanterior.SELECT symbol, CURRENT(close) AS "Last Trade",

PREV(close) AS "PrevCls",

(CURRENT(close) - PREV(close))AS Change

FROM Stock_feedGROUP BY symbol

symbol Last Trade Prev Cls Change

------- ---------- -------- ------

K 31.25 31.28 -0.03

IBM 80.79 80.04 0.75

VCLR 24.42 22.60 1.82

Consulte también

“CURRENT” en la página 178 devuelve el valor de la fila más reciente o de laúltima fila de un conjunto.


“PRIOR_VALUE” en la página 148 devuelve el valor anterior de una columna, unalias o una expresión.


SUMEsta función de conjunto devuelve la suma de un conjunto de valores numéricos.

SintaxisSUM( numeric )



Tipo de devolución

Numérico, mismo tipo de datos que el argumento numeric. Devuelve NULL si elconjunto está vacío.


Cuando se utiliza como una función_MOV (consulte: “MOV_function” en lapágina 136), devuelve la suma móvil del conjunto móvil.MOV_SUM( numeric, windowwindow, size [,timestampColumn])

Último valor del conjunto

Cuando el tamaño del conjunto móvil es un flujo de datos único, MOV_SUM()mantiene la suma de los precios del último pedido de cada cliente, para todos losclientes que realizaron un pedido desde la fecha de inicio del sistema.SELECT os.os_cust_id, MOV_SUM(os.os_price,EVENT, 1)

FROM order_status os

GROUP BY os.os_cust_id

Ejemplo

Calcule el total de la columna invOnHand para todas las filas de la tabla stock:SELECT SUM(invOnHand) "Total on hand"

FROM stock;

Total on hand

-------------

2

Consulte también

“MOV_SUM” en la página 185 devuelve la suma de un conjunto de ventanasmóviles.


“TUMBLE_SUM” en la página 193 devuelve la suma de un conjunto de ventanasen movimiento.

TUMBLE_AVGEsta función de conjunto en movimiento devuelve el valor medio (mediaaritmética) de un conjunto de ventanas en movimiento.

SintaxisTUMBLE_AVG( numeric, window, size [,timestampColumn])



v windowDetermina si el tamaño es el recuento de los flujos de datos en el conjunto(EVENT) o una duración de tiempo (SECOND, MINUTE, HOUR, DAY,MONTH, o YEAR).

v sizeDuración o recuento de la ventana que se utilizará para determinar el tamaño deun conjunto. Debe ser un entero positivo.


Tipo de devolución


Comentarios

Devuelve NULL si el grupo está vacío.

Ejemplo

Devuelve el precio promedio de todos los flujos de datos que llegan en unintervalo de siete días:TUMBLE_AVG(price, DAY, 7, trade_time) AS Avg_7_day_price

La función anterior es la forma abreviada de esta expresión de ventana en línea:AVG(price) AS Avg_7_day_price OVER (

ORDER BY trade_time RANGE INTERVAL ’7’ DAY PRECEDINGSLIDE)

Para determinar el precio promedio de los siete días anteriores, sin incluir elactual, utilice una ventana en lugar de TUMBLE_AVG(), de por ejemplo:AVG(price) AS Avg_prev_7_day_price OVER (

ORDER BY trade_time


RANGE BETWEEN INTERVAL ’8’ DAY PRECEDING

AND INTERVAL ’1’ DAY PRECEDING

SLIDE INTERVAL ’7’ DAY

INITIALIZE TIMESTAMP ’1963-02-18 00:00:00.000’

REFERENCE OPERATOR)

Consulte también

“AVG” en la página 176 devuelve la media de un conjunto.

“MOV_AVG” en la página 180 devuelve el promedio de un conjunto de ventanasmóviles.

“Ventanas en movimiento” en la página 404 trata sobre los conjuntos de ventanasen movimiento.

TUMBLE_COUNTEsta función de conjunto en movimiento devuelve el recuento de filas de unconjunto de ventanas en movimiento.

SintaxisTUMBLE_COUNT( *, window, size [,timestampColumn] )

Parámetrosv window

Determina si el tamaño es el recuento de los flujos de datos en el conjunto(EVENT) o una duración de tiempo (SECOND, MINUTE, HOUR, DAY,MONTH, o YEAR).



Tipo de devolución

INTEGER.

Comentarios

Devuelve cero (0) si el conjunto está vacío.

Si se utiliza una ventana EVENT, esta función devuelve un entero inferior o igualal valor de la ventana.


Cuando se utiliza con un GROUP BY, devuelve el recuento de filas del conjunto degrupos.


Ejemplo

Devuelve el recuento de todos los flujos de datos que llegan en un intervalo de 8horas:TUMBLE_COUNT(*, HOUR, 8, trade_time) AS Total

La función anterior es la forma abreviada de esta expresión de ventana en línea:COUNT(*) AS Total OVER (ORDER BY trade_time

RANGE INTERVAL ’8’ HOUR PRECEDING SLIDE)

Esto, a su vez, equivale a lo siguiente tras especificar todos los valorespredeterminados:COUNT(*) AS Total OVER ( ORDER BY trade_time


SLIDE INTERVAL ’8’ HOUR

REFERENCE OPERATOR)

La ventana de ocho horas comienza cuando llega el primer flujo de datos a lavista. Para iniciar la ventana al principio de la hora, incluya INITIALIZE'2003-03-05 00:00:00,000'.

Consulte también

“COUNT” en la página 178 devuelve el recuento de una vista o un conjunto.

“MOV_COUNT” en la página 181 devuelve el recuento de un conjunto deventanas en movimiento.

TUMBLE_MAXEsta función de conjunto en movimiento devuelve el valor máximo de un conjuntode ventanas en movimiento.

SintaxisTUMBLE_MAX( numeric, window, size [,timestampColumn])





v timestampColumn(Opcional) Utilice el valor del campo como punto de inicio para el intervalo deserie de tiempo. El cálculo se basa en un intervalo de tiempo desde el valor más


reciente de la columna de cualquier fila de la vista. Omita esta opción si quiereutilizar el reloj del sistema como base para la hora.

Tipo de devolución


Comentarios



Ejemplo

Devuelve el precio máximo de todos los flujos de datos que llegan en un intervalode 1 hora:TUMBLE_MAX(price, HOUR, 1, trade_time) AS Max_price

La función anterior es la forma abreviada de esta expresión de ventana en línea:MAX(price) AS Max_price OVER (ORDER BY trade_time


Esto, a su vez, equivale a lo siguiente tras especificar todos los valorespredeterminados:MAX(price) AS Max_price OVER ( ORDER BY trade_time



REFERENCE OPERATOR)

La ventana de una hora comienza cuando llega el primer flujo de datos a la vista.Para iniciar la ventana al principio de la hora, incluya INITIALIZE TIMESTAMP'2003-03-05 00:00:00,000'.

La función TUMBLE_MAX(price, EVENT, 5) es la forma abreviada de esta ventanacompleta:MAX(price) OVER ( ORDER BY trade_time

EVENTS BETWEEN 4 PRECEDING AND CURRENT EVENT

SLIDE 5

REFERENCE OPERATOR)

Consulte también

“MAX” en la página 179 devuelve el valor máximo de un conjunto de ventanasmóviles.

“MOV_MAX” en la página 183 devuelve el valor máximo de un conjunto deventanas en movimiento.





TUMBLE_MINEsta función de conjunto en movimiento devuelve el valor mínimo de un conjuntode ventanas en movimiento.

SintaxisTUMBLE_MIN( numeric, window, size [,timestampColumn])






Tipo de devolución


Comentarios



Ejemplo

Devuelve el precio mínimo de todos los flujos de datos que llegan en un intervalode 1 hora:TUMBLE_MIN(price, HOUR, 1, trade_time) AS Min_price

La función anterior es la forma abreviada de esta expresión de ventana en línea:MIN(price) AS Min_price OVER (ORDER BY trade_time


Esto, a su vez, equivale a lo siguiente tras especificar todos los valorespredeterminados:MIN(price) AS Min_price OVER ( ORDER BY trade_time




REFERENCE OPERATOR)


La función TUMBLE_MIN(price, EVENT, 5) es la forma abreviada de esta ventanacompleta:MIN(price) OVER ( ORDER BY trade_time


SLIDE 5

REFERENCE OPERATOR)

Consulte también

“MIN” en la página 180 devuelve el valor mínimo de un conjunto de ventanasmóviles.

“MOV_MIN” en la página 184 devuelve el valor mínimo de un conjunto deventanas en movimiento.




TUMBLE_SUMEsta función de conjunto en movimiento devuelve la suma de un conjunto deventanas movimiento de valores numéricos.

SintaxisTUMBLE_SUM( numeric, window, size [,timestampColumn])





v timestampColumn


(Opcional) Utilice el valor del campo como punto de inicio para el intervalo deserie de tiempo. El cálculo se basa en un intervalo de tiempo desde el valor másreciente de la columna de cualquier fila de la vista. Omita esta opción si quiereutilizar como base el primer flujo de datos de la vista.

Tipo de devolución

Numérico, mismo tipo de datos que el argumento numeric. Devuelve NULL si elconjunto está vacío.

Ejemplo

Esta expresión de suma en movimiento suma todos los flujos de datos que lleganen un intervalo de 1 hora:TUMBLE_SUM(price, HOUR, 1, trade_time) AS Total

La función anterior es la forma abreviada de esta expresión de ventana en línea:SUM(price) AS Total OVER (ORDER BY trade_time


Esto, a su vez, equivale a lo siguiente tras especificar todos los valorespredeterminados:SUM(price) AS Total OVER ( ORDER BY trade_time



REFERENCE OPERATOR)


La función TUMBLE_SUM(price, EVENT, 5) es la forma abreviada para estaventana completa:SUM(price) OVER ( ORDER BY trade_time


SLIDE 5

REFERENCE OPERATOR)

Consulte también

“SUM” en la página 187 devuelve la suma de una vista o un conjunto.

“MOV_SUM” en la página 185 devuelve la suma de un conjunto de ventanasmóviles.


Serie temporal y estadísticaLas funciones de serie temporal y estadística se utilizan para las operaciones queimplican estadísticas y conjuntos de ventanas móviles de números.

Consulte también: “MOV_function” en la página 136.


MOV_STD_DEVIATIONEsta función de conjunto móvil devuelve la desviación estándar de una muestra deun conjunto de ventanas móviles de números.

SintaxisMOV_STD_DEVIATION( numeric, window, size [,timestampColumn])






Tipo de devolución

DOUBLE PRECISION.

Comentarios

Devuelve 0 cuando sólo hay una fila de entrada. Devuelve NULL si el conjuntoestá vacío.

El resultado se calcula con la fórmula , donde n es el número deelementos de la muestra y X es la media de la muestra.

Ejemplo

Devuelve la desviación estándar de los salarios correspondiente al valor de losflujos de datos del último año:SELECT MOV_STD_DEVIATION(salary, YEAR, 1) AS "Dev. forthe last year"

FROM employees;

Esto, a su vez, equivale a lo siguiente tras especificar todos los valorespredeterminados:SELECT STD_DEVIATION(salary) AS "Dev. for the last year"OVER (


RANGE INTERVAL ’1’ YEAR PRECEDING

REFERENCE OPERATOR)

Consulte también

“STD_DEVIATION” en la página 201 devuelve la desviación estándar de una vistao un conjunto.

“TUMBLE_STD_DEVIATION” en la página 203 devuelve la desviación estándar deun conjunto de ventanas en movimiento.

“VARIANCE” en la página 205 devuelve el cuadrado de la desviación estándar.


MOV_VARIANCEEsta función de conjunto móvil devuelve el cuadrado de la desviación estándar deuna muestra de un conjunto de ventanas móviles de números.

SintaxisMOV_STD_DEVIATION( numeric, window, size [,timestampColumn])






Tipo de devolución

DOUBLE PRECISION.

Comentarios

Devuelve cero (0) cuando el conjunto de expresiones solamente contiene unelemento. Devuelve NULL si el conjunto está vacío.



Ejemplo

Devuelve la variación de los salarios para cada año natural:SELECT MOV_STD_DEVIATION(salary, YEAR, 1) AS "Variationfor last year"

FROM employees;

Esto, a su vez, equivale a lo siguiente tras especificar todos los valorespredeterminados:SELECT VARIATION(salary) AS "Variation for the last year"OVER (


REFERENCE OPERATOR)

Consulte también

“VARIANCE” en la página 205 devuelve la varianza de una vista o un conjunto.

“STD_DEVIATION” en la página 201 devuelve una desviación estándar.

“TUMBLE_VARIANCE” en la página 204 devuelve la varianza de un conjunto deventanas en movimiento.


NTILEEsta función de clasificación determina la clasificación de nivel de cada valor de unconjunto con respecto a la totalidad del conjunto.

SintaxisNTILE( toRank, tiers )

Parámetrosv toRank

Una expresión de cualquier tipo de datos y que normalmente hace referencia auna columna de valores por clasificar.

v tiersRecuento de niveles en los que se particionarán los resultados; un entero mayorque cero (0). Cuando este valor es mayor que el recuento de elementos porclasificar, se asigna la misma clasificación a todos los elementos.

Tipo de devolución

INTEGER.


Comentarios

Devuelve un entero para cada fila del conjunto que representa el nivel al quepertenece la fila, donde uno (1) es el nivel más alto que retiene el valor más alto.Cuando toRank da NULL como resultado, el resultado se asigna a la clasificaciónmás baja.

Esta función no se puede utilizar como argumento en una función de conjunto,una función de conjunto móvil o una función de clasificación. Por ejemplo,SUM(NTILE()) no está permitido.

Una función ntile clasifica las filas intentando distribuirlas de forma uniforme entreun conjunto de niveles fijo. Por ejemplo, para un conjunto de seis resultados deexpresión {D, B, E, C, A y B} que se quiere clasificar en dos niveles, NTILE() asignaa cada resultado la clasificación de 1 (para C, D y E) o 2 (para A, B y B). Losresultados que tienen el mismo valor siempre se colocan en el mismo nivel.

Cuando un conjunto de valores no es divisible entre los niveles, la funcióndistribuye de forma uniforme las filas restantes entre los grupos de mayor nivel.Por ejemplo, la tabla siguiente demuestra cómo se distribuyen los elementos deletra entre distintos recuentos de niveles:

Tabla 59. Distribución de los elementos de letra entre distintos recuentos de niveles

niveles: 1 2 3 4 5 6 7

A 1 2 3 3 4 5 1

B 1 2 2 2 3 4 1

B 1 2 2 2 3 4 1

C 1 1 2 1 2 3 1

D 1 1 1 1 1 2 1

E 1 1 1 1 1 1 1

Ejemplo

La consulta siguiente clasifica las ventas de productos de café y té en seis nivelessegún sus clasificaciones de ventas. La clasificación se realiza en sextos, por lo quecada nombre de producto recibe un valor entre 1 y 6. Para este ejemplo sólo hayuna entrada para cada producto:SELECT prod_name, NTILE( dollars, 6) AS sales_rank

FROM (lineitem INNER JOIN product

ON lineitem.item_id=product.productid)

WHERE product.classkey IN (1, 2, 4, 5);

PROD_NAME SALES_RANK

Demitasse M 1

Xalapa Lapa 1

Cafe Au Lait 2

Aroma Roma 2

Veracruzano 3

Colombiano 3

Darjeeling Special 4

Irish Breakfast 4

English Breakfast 5


Earl Grey 5

Gold Tips 6

Consulte también

“RANK” clasifica las filas dentro de la totalidad del conjunto.


RANKEsta función de clasificación determina la clasificación de cada valor de unconjunto con respecto a la totalidad del conjunto.

SintaxisRANK( expression )


Expresión de cualquier tipo de datos que normalmente hace referencia a unacolumna.

Tipo de devolución

INTEGER.

Comentarios

Devuelve un entero para cada fila del conjunto que es la clasificación de la filadentro de la totalidad del conjunto, teniendo en cuenta que el valor más alto seclasifica como 1. Cuando la expresión da un resultado NULL, se clasifica en laúltima posición de la lista de resultados. Por ejemplo, la clasificación de (10,NULL, 20) clasifica el 10 como 2, el 20 como 1 y NULL como 3.

Cuando los valores por clasificar son iguales, se les asigna la misma clasificación yse omite la clasificación siguiente. Por ejemplo, a los valores 4.5, 4.5, 1.0 se lesasignan los valores de clasificación 1, 1 y 3.

Esta función no se puede utilizar como argumento en una "función de conjunto",una "función de clasificación" o una "función de conjunto móvil". Por ejemplo,SUM(RANK(...)) no está permitido. RANK() tampoco se puede utilizar en una"vista sin estado".

Cuando el conjunto solamente contiene una fila, RANK() devuelve 1. Por ejemplo,RANK(SUM(sales)) = 1.

Ejemplos

Clasifique las ventas de productos por región:SELECT RANK( SUM( sales ) ) AS R, SUM(sales) AS S, region

FROM product_orders

GROUP BY region

R S region

1 100000 north

2 50000 south


Clasifique las ventas de productos por producto:SELECT prod_name, SUM(dollars) AS prod_sales,

RANK( SUM(dollars) ) AS prod_rank

FROM product, lineitem

WHERE lineitem.classkey = product.classkey

AND lineitem.prodkey = product.prodkey

GROUP BY prod_name;

PROD_NAME PROD_SALES PROD_RANK

Demitasse Ms 656401.50 1

Xalapa Lapa 577450.00 2

Aroma Roma 479330.25 5

Verona 467234.00 6

NA Lite 557655.00 3

Lotta Latte 533454.50 4

Consulte también

“NTILE” en la página 197 clasifica las filas y las coloca en un conjunto de nivelesfinito.


RATIO_TO_REPORTEsta función de clasificación calcula la razón de un valor con respecto a la suma delos valores de todo el conjunto.

SintaxisRATIO_TO_REPORT( numeric )


Cualquier expresión de tipo de datos numérico, generalmente una referencia auna columna numérica.

Tipo de devolución

DOUBLE PRECISION.

Comentarios

Devuelve un número para cada fila de un conjunto que es la razón de la fila conrespecto a la suma de todo el conjunto. Cuando la expresión da NULL comoresultado, la función devuelve NULL. Cuando la suma del conjunto es cero (0), larazón también es cero.

Esta función no se puede utilizar como argumento en una función de conjunto,una función de conjunto móvil o una función de clasificación. Por ejemplo,SUM(RATIO_TO_REPORT(...)) no está permitido.

Ejemplo

Determine qué porcentaje supone cada venta de productos con respecto a la ventatotal de todos los productos de las últimas 20 semanas:


SELECT prod_description DESC,

SUM(dollars) as sales,

RATIO_TO_REPORT( SUM(li_amount )) * 100 AS ratio_dollars

FROM lineitem, product

WHERE lineitem.li_prod_id = product.prod_id

GROUP BY prod_description;

DESC SALES RATIO_DOLLARS

Widget 896931.15 12.88

Basket 514830.00 7.39

Football 507022.35 7.28

Oil Drum 503493.10 7.23

Computer 437863.00 6.29

Chair 429637.75 6.17

Desk 424215.00 6.09

Mesh Bag 421205.75 6.05

Shoelace 417261.00 5.99

Powder 397102.50 5.70

Telephone 394086.50 5.66

Cord 392377.75 5.64

Mouse 389378.25 5.59

Monitor 305859.75 4.39

Case 294982.75 4.24

Cup 236772.75 3.40

STD_DEVIATIONEsta función de conjunto devuelve una desviación estándar de una muestra de unconjunto de números.

SintaxisSTD_DEVIATION( number )

Parámetrosv number


Tipo de devolución

DOUBLE PRECISION.

Comentarios




EjemploSELECT STD_DEVIATION(salary) "Deviation"

FROM employees;

Deviation

----------

3909.36575

Consulte también

“MOV_STD_DEVIATION” en la página 195 devuelve la desviación estándar de unconjunto de ventanas móviles.

“TUMBLE_STD_DEVIATION” en la página 203 devuelve la desviación estándar deun conjunto de ventanas en movimiento.


SUM_OVER_GROUPSFunción de clasificación que pasa dos parámetros. Los dos parámetros son: unvalor numérico y un parámetro de ordenación. Cuando los grupos se ordenansegún el parámetro de ordenación, la función devuelve una suma continua de losvalores numéricos.

SintaxisSUM_OVER_GROUPS([numeric value],[ordering parameter])

Parámetrosv numeric value

Los valores por sumar.v ordering parameter

El orden de los valores.

Tipo de devolución

Suma continua de los valores numéricos proporcionados en los argumentos.

Ejemplo

Por ejemplo, en el conjunto de datos siguiente:grp data

----------

1 1

2 3

3 10

4 200

Si se emitiera lo siguiente:SELECT grp, SUM_OVER_GROUPS(data, grp) as running_sumGROUP BY grp

El resultado sería:grp running_sum


----------

1 1

2 4

3 14

4 214

TUMBLE_STD_DEVIATIONEsta función de conjunto en movimiento devuelve la desviación estándar de unamuestra de un conjunto de ventanas en movimiento de números.

SintaxisTUMBLE_STD_DEVIATION( numeric, window, size [,timestampColumn])






Tipo de devolución

DOUBLE PRECISION.

Comentarios



Ejemplo

Devuelve la desviación estándar de los salarios para cada año natural:SELECT TUMBLE_STD_DEVIATION(salary, YEAR, 1) AS "Deviationper year"


FROM employees;

Esto, a su vez, equivale a lo siguiente tras especificar todos los valorespredeterminados:SELECT STD_DEVIATION(salary) AS "Deviation per year"OVER (


SLIDE INTERVAL ’1’ YEAR

REFERENCE OPERATOR)

Puede utilizar INITIALIZE para declarar un año fiscal. Además, podría resultarconveniente usar PARTITION BY para obtener las desviaciones de diversos nivelessalariales. Por ejemplo:SELECT STD_DEVIATION(salary) AS "Deviation per year"OVER (

PARTITION BY pay_grade



INITIALIZE ’1963-07-01 00:00:00.000’

REFERENCE OPERATOR)

Consulte también

“STD_DEVIATION” en la página 201 devuelve la desviación estándar de una vistao un conjunto.

“MOV_STD_DEVIATION” en la página 195 devuelve la desviación estándar de unconjunto de ventanas en movimiento.



TUMBLE_VARIANCEEsta función de conjunto en movimiento devuelve el cuadrado de la desviaciónestándar de una muestra de un conjunto de ventanas en movimiento de números.

SintaxisTUMBLE_VARIANCE( numeric, window, size [,timestampColumn])




v size


Duración o recuento de la ventana que se utilizará para determinar el tamaño deun conjunto. Debe ser un entero mayor que cero (0).


Tipo de devolución

DOUBLE PRECISION.

Comentarios



Ejemplos

Devuelve la variación de los salarios para cada año natural:SELECT TUMBLE_VARIATION(salary, YEAR, 1)

AS "Variation for last year"

FROM employees;

Esto, a su vez, equivale a lo siguiente tras especificar todos los valorespredeterminados:SELECT VARIANCE(price) AS "Variation for last year"

OVER ( ORDER BY trade_time



REFERENCE OPERATOR)

FROM employees;

Consulte también

“MOV_VARIANCE” en la página 196 devuelve la varianza de un conjunto deventanas móviles.


“VARIANCE” devuelve la varianza de una vista o un conjunto.

“Ventanas en movimiento” en la página 404 trata sobre los conjuntos móviles.

VARIANCEEsta función de conjunto devuelve el cuadrado de la desviación estándar de unamuestra de un conjunto de números.


SintaxisVARIANCE( numeric )



Tipo de devolución

DOUBLE PRECISION.

Comentarios



EjemploSELECT VARIANCE(salary) "Variance"

FROM employees;

Variance

----------

15283140.5

Consulte también

“MOV_VARIANCE” en la página 196 devuelve la varianza de un conjunto deventanas móviles.


“TUMBLE_VARIANCE” en la página 204 devuelve la varianza de un conjunto deventanas en movimiento.

Funciones proporcionadas como UDF de ejemploEstas funciones se proporcionan como UDF de ejemplo.

Para utilizar una de estas funciones, debe cargar la función desde el directoriomanifest de la ubicación del programa Cognos Real-time Monitoring. La ruta esparecida a realtime\webcontent\sdk\udf\jar\com\cognos\obi\manifest. Paraobtener más información, consulte: Capítulo 35, “Funciones definidas por elusuario”, en la página 357.

concatListEsta función escalar devuelve una cadena que es la concatenación de una lista decaracteres o cadenas.


SintaxisconcatList( string1, string2 [, ... stringN ] )

Parámetrosv string

Expresión que da un valor VARCHAR

Tipo de devolución

VARCHAR.

Comentarios

Devuelve cadena2 sufijada al final de la cadena1, cadena3 sufijada a la cadena2,etcétera.

Pasa por alto los valores NULL a menos que todos los valores sean NULL, en cuyocaso devuelve una cadena vacía.

Ejemplos

concatList('a','b','c') devuelve 'abc'.

Consulte también

“CONCAT” en la página 167 devuelve una cadena que es la concatenación de doscaracteres o cadenas.

“concatSet” devuelve un conjunto de cadenas ordenadas alfabéticamente.


concatSetDevuelve un conjunto de cadenas ordenadas alfabéticamente.

SintaxisconcatSet( stringExp )

Parámetrosv stringExp

Expresión que da un valor VARCHAR. Típicamente el argumento es unacolumna en una vista.

Tipo de devolución

VARCHAR.

Comentarios

Devuelve una cadena que es el conjunto ordenado de todas las cadenas pasadas ala función.


Pasa por alto los valores NULL a menos que todos los valores sean NULL, en cuyocaso devuelve una cadena vacía.

Ejemplos

Observe esta sentencia:SELECT concatSet(item) AS item_list FROM GroceryList

Si los elementos de GroceryList se presentan del siguiente modo por este orden:’banana’

’egg’

’apple’

’donut’

NULL

’carrot’

El orden de la item_list en la nueva vista es:’apple,banana,carrot,donut,egg’

Por consiguiente, si se añade ‘bagel' a GroceryList, el nuevo orden en la nuevavista es:’apple,bagel,banana,carrot,donut,egg’

Consulte también

“CONCAT” en la página 167 devuelve una cadena que es la concatenación de doscaracteres o cadenas.

“concatList” en la página 206 devuelve una cadena que es la concatenación de unalista de caracteres o cadenas.


gammaDistEsta función escalar devuelve la distribución gamma de un valor.

SintaxisgammaDist( number, alphaNumber, betaNumber, isCumulative)

Parámetrov number Número positivo por evaluar; puede ser cero (0).v alphaNumber Parámetro Alfa (número positivo, puede ser cero) para la ecuación

de distribución gamma.v betaNumber Parámetro Beta (número positivo, puede ser cero) para la ecuación

de distribución gamma.v isCumulative Booleano que determina el formato de la función de número según

alphaNumber y betaNumber:– TRUE utiliza la función de distribución acumulativa.– FALSE utiliza la función de masa de probabilidad.


Tipo de devolución

DOUBLE PRECISION.

Comentarios

Cuando alphaNumber es uno (1), devuelve una distribución exponencial.

Cuando alphaNumber es un entero positivo, el resultado es una distribuciónErlang.

Ejemplo

Rellenar una vista con la masa de probabilidad para una distribución gamma dealpha=9 y beta=2:SELECT TimeToFail,

gammaDist(TimeToFail, 9, 2, FALSE) AS GammaDist

FROM UnitTests

ORDER BY TimeToFail

Consulte también

“logNormDist” devuelve la distribución logarítmico-normal acumulada de unvalor.

logNormDistEsta función escalar devuelve la distribución logarítmico-normal acumulativa deun valor.

SintaxislogNormDist( number, meanNumber, stdNumber )

Parámetrosv number

Valor por evaluar.v meanNumber

Media de ln(número).v stdNumber

Desviación estándar de ln(número).

Tipo de devolución

DOUBLE PRECISION.

Comentarios

Devuelve la distribución logarítmico-normal acumulativa de un valor, dondeln(número) se distribuye normalmente con la desviación media y estándar.

medianEsta función de conjunto devuelve el número mediana (centro) de un conjunto.


Sintaxismedian( numericExp )

Parámetrosv numericExp

Una expresión da un número como resultado y que no puede hacer referencia auna función de clasificación. Típicamente el argumento es una columna en unavista.

Tipo de devolución

INTEGER cuando todos los resultados de numericExp son enteros; en casocontrario, DOUBLE PRECISION cuando alguno de los resultados es decimal.

Comentarios

Esta función ordena los valores de conjunto y devuelve la mediana del conjuntoordenado.

Cuando el recuento de valores es impar, la mediana es el número central delconjunto. Por ejemplo, la mediana de 2,1,5 es 2: el valor central del conjuntoordenado.

En caso contrario, cuando el recuento es par, la mediana es el valor promedio delos dos números centrales del conjunto. Por ejemplo, la mediana de 2,1,5,4 es 3: lamedia de 2 y 4. Además, cuando el resultado del promedio es un valor decimal, elresultado se redondea a la baja: la mediana de 2 y 3 es 2, que es floor(2,5).

Ignora los valores NULL.

Ejemplos

Observe esta sentencia:SELECT median(Value) AS MedianV FROM NumberList

El resultado es 1,5 (el promedio de 1 y 2 tras ignorar los NULL) cuando loselementos de NumberList se presentan en este orden:3.0

NULL

0.0

2.0

1.0

NULL

NULL

El resultado es 1 si el conjunto es1

2

Dado que los valores son enteros, el resultado también debe ser un entero. Elpromedio, que es 1,5, se redondea a la baja a 1.


Consulte también

“AVG” en la página 176 devuelve el valor de la media de un conjunto.

“mode” devuelve el número que aparece con más frecuencia en un conjunto.

modeEsta función de conjunto devuelve el número que aparece con más frecuencia enun conjunto.

Sintaxismode( numericExp )

Parámetrosv numericExp

Una expresión da un número como resultado y que no puede hacer referencia auna función de clasificación. Típicamente el argumento es una columna en unavista.

Tipo de devolución

El mismo tipo que el resultado de numericExp.

Comentarios

Cuando hay varios valores distintos con la misma frecuencia, mode() devuelve elprimero que ha encontrado. Consulte el ejemplo.

Ignora los valores NULL.

Ejemplos

En el conjunto de números siguiente, entrados en mode() en este orden:1

3

4

1

3

La función mode() devuelve 1 ya que es el número que aparece con más frecuenciay por delante de 3, que tiene el mismo número de apariciones. Si el conjunto se haentrado en mode() en el orden contrario, devuelve 3.

Para este conjunto de números, mode devuelve 1,0:1

3

NULL

2.0

NULL

NULL

1


Se ignoran los NULL y el 2,0 hace que mode() devuelva un valor DOUBLEPRECISION.

Consulte también

“AVG” en la página 176 devuelve el número de la media de un conjunto.

“median” en la página 209 devuelve la mediana (valor central) de un conjunto.

yieldEsta función calcula el rendimiento a partir de un conjunto de resultados deprueba (fail=0, pass=1) y calcula el rendimiento. Es decir, las unidadestotales/superadas totales. Se omiten los valores nulos.

Sintaxisyield(pass, unit)

Parámetrosv pass

Indica si se calculará el rendimiento basándose en el número de unidades "pass"o en el número de unidades "fail". Especifique pass para utilizar el número deunidades que superan la prueba de cálculo de rendimiento. Especifique fail parautilizar el número de unidades que no superan la prueba de cálculo derendimiento.

v unitEspecifica el número total de unidades que se probarán.

Tipo de devolución

Devuelve NULL si el rendimiento es menor que cero; en caso contrario, DOUBLEPRECISION.

Ejemplo

Si se pasa SELECT YIELD(pass, 4) FROM E con los valores siguientes:

0, 1 1, 0 0, 1 NULL, NULL

El resultado es 0,5 porque la prueba 1 y la prueba 3 son "pass" pero la prueba 2 es"fail". La prueba 4 se omite.

Si se pasa SELECT YIELD(fail, 4) FROM E con los mismos valores, el resultado es0,25 porque sólo es "pass" una de las cuatro pruebas.


Capítulo 16. HTTP Post

Las tablas de flujos de datos de HTTP Post reciben eventos de una acción de HTTPPost, bien como resultado de un formulario HTML enviado desde un navegador, obien a partir de datos codificados en un URL que se conecta a la tabla.

Funcionamiento de HTTP PostLos datos de eventos para HTTP Post llegan como parte de un formulario enviadopor HTTP. El agente interno extrae los campos del formulario y envía cada Post ala tabla de flujos de datos.

HTTP Post puede producirse como resultado de que un usuario envíe unformulario HTML con campos <INPUT>, o bien puede crearlo una aplicación queutilice HTTP como protocolo de comunicación.

Tablas de flujos de datos para HTTP PostUna tabla de flujos de datos para HTTP Post recibe eventos nuevos de una acciónde HTTP Post, lo que a menudo se produce como resultado de un formularioHTML enviado desde un navegador.

En un formulario HTML, cada elemento <INPUT> se correlaciona con unacolumna de la tabla de flujos de datos. Los datos de evento también puedenpublicarse en el URL que pasa los campos al sistema. Para obtener ejemplos,consulte: “Publicación en una tabla de flujos de datos desde HTTP Post” en lapágina 217.

Antes de crear una tabla de flujos de datos para HTTP Post, debe tener permiso decreación de tablas. Para obtener más información sobre los permisos, consulte:“Cómo otorgar permiso para crear objetos” en la página 294. En la siguiente tablase enumeran los atributos de una tabla de flujos de datos para HTTP Post.

Una tabla de flujos de datos para unHTTP Post ha recibido datos incluidosen un URL de un formulario HTML.Forma HTML

http:// .../datastreamname=DataStream&name=MyName...Tabla de flujo de datos

Nombre:Send

MyName

Figura 17. Una tabla de flujos de datos recibe datos


Tabla 60. Atributos de tabla de flujos de datos para HTTP Post


Nombre Nombre de la tabla de flujos de datos.

El nombre debe ser exclusivo entre todos los objetosde la misma carpeta (incluidos los objetos del panelde control y los paneles de control). La carpeta raíztambién contiene objetos globales como usuarios yroles, y actividades empresariales. Para obtener másinformación, consulte: “Espacio de nombres deobjeto” en la página 277.

Estado Especifica si el objeto está habilitado (preparado pararecibir datos) o inhabilitado (no preparado pararecibir datos).

Descripción Descripción opcional que puede contener cualquiercarácter de texto.

Guardar en Especifica la carpeta en la que se va a almacenar latabla de flujos de datos. Para seleccionar o crear unacarpeta, pulse el botón Seleccionar carpeta. Si noespecifica ninguna carpeta, el valor predeterminadoes Carpeta pública.

Habilitar recuperación Cuando está habilitado, registra los datos de unevento que se reciben después de que se inicie elpunto de comprobación. Este registro derecuperación se utiliza para restaurar el estado delsistema después de un cierre anómalo de losservidores. Para obtener más detalles, consulte lainformación sobre el punto de comprobación y larecuperación en la publicación IBM CognosReal-timeMonitoring Workbench Guía del usuario.

Publicar en URL URL al que se debe enviar la información publicada.Para obtener ejemplos, consulte: “Publicación en unatabla de flujos de datos desde HTTP Post” en lapágina 217.

Procesar datos según orden dellegada

Seleccione esta opción cuando los eventos debanprocesarse en el orden en el que se reciben. De otromodo, si los eventos se pueden procesar en otroorden, inhabilite este atributo. Para unir los eventosen una vista, los eventos se deben procesar pororden. Deje esta opción habilitada para unir loseventos.

Deshabilitar flujo de datosdespués de este número de erroresconsecutivos

Inhabilita el flujo de datos cuando se produce unrecuento consecutivo de errores. Por ejemplo, si seestablece en 5, el flujo de datos se inhabilita despuésde 5 errores consecutivos. Sin embargo, si seproducen 4 errores y después no se produce ningúnerror hasta que se producen 2 errores, el flujo dedatos permanece habilitado. Está desactivado deforma predeterminada: No inhabilitar.

Información de la columna La pestaña Información de la columna define cómose correlacionan los campos de HTTP Post concolumnas de la tabla de flujos de datos. Hay unacolumna por cada campo en la tabla de flujos dedatos. Para obtener más información, consulte:“Información de la columna de HTTP Post” en lapágina 215.


Tabla 60. Atributos de tabla de flujos de datos para HTTP Post (continuación)


Borrar intervalo de estados Esta pestaña contiene varias opciones para borrardatos de eventos persistentes. Para obtener másinformación, consulte: “Intervalo de borrado deestados” en la página 60.

Creación de una tabla de flujos de datos para HTTP PostPuede crear una tabla de flujos de datos desde HTTP Post.

Procedimiento1. En IBM Cognos Real-time Monitoring Workbench, pulse la pestaña Workbench.2. Pulse Actividades.3. Pulse Crear nuevo > Flujo de datos.4. En la ventana Nuevo flujo de datos, seleccione Flujo de datos único.5. Seleccione HTTP Post como tipo de origen para la tabla de flujos de datos.6. Asigne un nombre y defina las columnas de la tabla de flujos de datos en la

pestaña Información de la columna.7. Guarde la tabla de HTTP Post como habilitada.

Información de la columna de HTTP PostLa pestaña Información de la columna define cómo correlacionar los campos delmensaje de HTTP Post con las columnas de la tabla de flujos de datos.

Hay un campo para cada columna de la tabla de flujos de datos, y cada unocontiene los atributos descritos en la siguiente tabla:

Tabla 61. Información de la columna de HTTP Post



Nombre de mensaje Nombre del campo en el mensaje. En unformulario HTML, es el atributo NAME quese asigna a cada elemento de formulario.Para obtener ejemplos, consulte:“Publicación en una tabla de flujos de datosdesde HTTP Post” en la página 217. Alcorrelacionar un campo Archivo sin formato,el nombre de cada campo incluido es Nodisponible y no es editable.

Tipo de datos Tipo de datos de la columna de la tabla deflujos de datos.

Formato (Opcional) Formato de la columna de latabla de flujos de datos para valoresVARCHAR (cadena) y DECIMAL.

Cada campo del mensaje puede ser un campo simple que se correlacionedirectamente con una columna de una tabla de flujos de datos, o puede ser uncampo complejo (un campo de archivo sin formato) que contenga varios camposque se correlacionen de forma individual con las columnas de la tabla. Los campos

Capítulo 16. HTTP Post 215

complejos se tratan como archivos sin formato en formatos delimitados (CSV), deanchura fija o XML. Para obtener más información, consulte: Capítulo 13,“Archivos sin formato”, en la página 103.

Los campos de mensaje pueden contener más de una fila de datos. No obstante,cada fila forma parte del mismo evento, a diferencia de las importaciones dearchivos sin formato, que tratan cada fila del archivo como un evento exclusivo.

Adición de un campo de mensajePuede añadir un campo de mensaje para proporcionar más información.

Para obtener más información acerca de los tipos de orígenes, consulte:v “Archivos de anchura fija” en la página 110v “Archivos delimitados” en la página 109v “Soporte de archivos XML” en la página 111

Para obtener más información sobre cómo enviar datos a campos de archivo sinformato, consulte: “Varios eventos de entrada” en la página 218.

Para obtener más información sobre los atributos de los archivos sin formato,consulte: “Tablas de flujos de datos de los archivos sin formato” en la página 104.

Procedimiento1. En la pestaña Información de la columna, pulse Agregar campo de archivo sin

formato.2. Seleccione el tipo de archivo sin formato del campo de mensaje.

Para archivos de anchura fija y delimitados, tiene la opción de identificar unarchivo de ejemplo a partir de un archivo de datos real como ayuda paracorrelacionar las columnas. Los datos de este archivo aparecerán en el siguientepaso para ayudarle a medida que correlaciona los datos de eventos en la tabla.

3. Para los archivos de anchura fija, defina las posiciones de las columnas dedatos con el cuadro Establecer anchuras de campo.

4. Identifique los atributos de archivo sin formato.5. Defina la información de columna específica del formato.6. Pulse Guardar flujo de datos.

Edición de la definición de un campo de mensajePuede editar la definición de un campo de mensaje.

Procedimiento1. Abra una corriente de datos existente.2. Pulse Editar.3. En la pestaña Información de la columna, cambie el valor de Formateo por

<Cambiar formateo>.Al editar un campo de mensaje, la opción del archivo de ejemplo para los tiposde archivos delimitados y de anchura fija no está disponible.


Publicación en una tabla de flujos de datos desde HTTP PostLa mayoría de eventos de HTTP Post se generan a partir de un formulario HTML.Al definir el evento, se define una columna para cada elemento llamado <INPUT>.

Por ejemplo, observe este formulario HTML:<FORM action="http://.../now/postservlet?eventname=Example"

method="post">

<P>

<LABEL for="name">Name: </LABEL>

<INPUT type="text" name="name"><BR>

<LABEL for="name">Date (yyyy-mm-dd): </LABEL>

<INPUT type="text" name="date"><BR>

<LABEL for="amt">Amount: </LABEL>

<INPUT type="text" name="amt"><BR>

<LABEL for="switch">Switch: </LABEL>

<INPUT type="radio" name="switch" value="FALSE"checked >Off

<INPUT type="radio" name="switch" value="TRUE">On<BR>

<INPUT type="submit" value="Send">

<INPUT type="reset">

</P>

</FORM>

Los cuatro campos de formulario se correlacionan con las cuatro columnas de latabla de flujos de datos que se muestra en la siguiente ilustración:

El campo de fecha se correlaciona con VARCHAR, no con TIMESTAMP. En lasvistas que derivan de este flujo de datos, se realiza una conversión de los valores afecha y hora, como se muestra en el siguiente ejemplo:CAST(httpDataStream."Date" AS TIMESTAMP)

Publicación en campos de mensajePara pasar datos a un campo de mensaje, se puede incluir la información en elURL o utilizar un elemento HTML <TEXTAREA> y escribir los datos de archivosin formato en ese campo.

Por ejemplo, el formulario HTML puede tener la siguiente declaración:

Figura 18. Los cuatro campos de formulario que se correlacionan con las cuatro columnasde la tabla de flujos de datos

Capítulo 16. HTTP Post 217

<LABEL for="flatfile">Flat file text: </LABEL>

<TEXTAREA name="MessageField" rows="20" cols="80"></TEXTAREA>

En el navegador, se pueden entrar los datos manualmente o copiar los datos de unarchivo sin formato y pegarlos en el campo. Recuerde que los datos deben estar enel formato del campo Archivo sin formato declarado, como delimitado.

Para obtener información sobre cómo incluir información en el URL, consulte:“Valores contabilizados en el URL”.

Atención:

v Cuando la tabla de flujos de datos contiene más elementos aparte de la columnade campo de mensaje, se puede escribir sólo el valor de una fila de datos en elcampo <TEXTAREA>. Si el campo de mensaje es la única columna, se puedenescribir los valores de varias filas de datos del evento.

v Varias filas que pasan a través de un elemento <TEXTAREA> se consideranparte del mismo evento, a diferencia del archivo de texto, donde cada fila es unevento único.

Valores contabilizados en el URLAl pasar los valores de campo directamente al URL, nombre y asigne un valor acada uno, separándolos con ampersands (&).

Por ejemplo:...?eventname=Example&name="Skyler"&date=2003-03-05&amt=9.21&switch=TRUE

Sin embargo, si se pasan los valores a un campo de archivo sin formatodelimitado, nombre el campo y separe los valores con el carácter de separador(normalmente una coma). Por ejemplo:...?eventname=Example&msgFile="Skyler",2003-03-05,9.21,TRUE

Varios eventos de entradaPara enviar varios eventos a un campo de archivo sin formato, puede separarloscon %0D%0A (la transmisión MIME para un final de línea: "CR LF").

Por ejemplo:...="Skyler",2003-03-05,9.21,TRUE%0D%0A"Mike",1963-02-18,9.01,FALSE

Si tiene previsto enviar varias líneas, el campo Archivo sin formato debe ser elúnico campo de la lista de la columna de la tabla de flujos de datos. Cuando estalista incluye otras columnas, sólo se permite una línea de entrada.


Capítulo 17. Java Messaging Service

Java Messaging Service (JMS) proporciona acceso a los mensajes creados poraplicaciones Java.

La aplicación que produce los mensajes los publica en temas o en destinos de colaa los que se suscribe el agente de IBM Cognos Real-time Monitoring. Cada temanuevo o mensaje de cola que se publica se correlaciona con un evento nuevo en latabla de flujos de datos asociada.

Los agentes JMS de IBM Cognos Real-time Monitoring se comunican con lasfábricas de conexiones de temas JMS o con las fábricas de conexiones de colasgestionadas por servidores de aplicaciones web. Cuando se define el agente, se leindica cómo debe conectarse a la fábrica. Cuando se define una tabla de flujos dedatos JMS, se le indica que se suscriba a un tema o una cola JMS gestionados porla fábrica con la que se conecta el agente. A continuación, cuando el tema publicaun nuevo mensaje, o cuando la cola recibe un mensaje nuevo, el agente lo recibe ylo pasa a la tabla de flujos de datos.

Los agentes JMS de Cognos Real-time Monitoring soportan los tipos de cuerpoJMS MapMessage y TextMessage para los mensajes de tema y de cola. El tipo demensaje de correlación JMS MapMessage está formado por pares de nombre-valor,donde los nombres son cadenas y los valores son wrappers para los tipos Java.Para obtener más información, consulte: “Tipos de datos de Java MessagingService” en la página 222.

Flujos de datos JMSLos flujos de datos JMS reciben nuevos datos de eventos de una aplicación Javaque publica mensajes en el tema o envía mensajes a la cola a la que está suscrita latabla. Cada nuevo tema o mensaje de cola es un evento nuevo de la tabla.

Si el mensaje contiene una cadena compleja de texto CSV (delimitado) o deanchura fija, resulta útil disponer de un archivo de ejemplo que contenga datos enel formato de la cadena de eventos real. Puede utilizarse este ejemplo al crear elflujo de datos para garantizar que los campos se correlacionen correctamente conla tabla de flujos de datos viendo cómo se alinean los datos en las columnas.

La siguiente tabla describe los atributos de un flujo de datos JMS.

Ejemplo: los proveedores de mensajes JMS publican temaso envían mensajes a las colas, que son eventos.

Tabla de consulta

Nuevo evento sobreun tema o cola

Agente JMS

Nuevo mensaje sobreun tema o cola

Productor demensajes JMS

Figura 19. Cómo funciona JMS



NombreIdentifica la tabla de flujos de datos.

El nombre debe ser exclusivo entre todos losobjetos de la misma carpeta (incluidos losobjetos del panel de control y los paneles decontrol). La carpeta raíz también contieneobjetos globales como usuarios y roles, yactividades empresariales. Para obtener másinformación, consulte: “Espacio de nombresde objeto” en la página 277.

Guardar en Especifica la carpeta en la que se almacenaráel objeto de flujo de datos. Para seleccionar ocrear una carpeta, pulse el botón Seleccionarcarpeta. Si no especifica ninguna carpeta, elvalor predeterminado es Carpeta pública.

EstadoEspecifica si el objeto está habilitado(preparado para recibir datos) o inhabilitado(no preparado para recibir datos).

Descripción Descripción opcional que puede contenercualquier carácter de texto.

Habilitar recuperaciónCuando está habilitado, registra los datos deun evento que se reciben después de que seinicie el punto de comprobación. Esteregistro de recuperación se utiliza pararestaurar el estado del sistema después deun cierre anómalo de los servidores. Paraobtener más detalles, consulte la informaciónsobre el punto de comprobación y larecuperación en la publicación IBMCognosReal-time Monitoring Workbench Guíadel usuario.

Procesar datos según orden de llegada Seleccione esta opción cuando los eventosdeban procesarse en el orden en el que sereciben. De otro modo, si los eventos sepueden procesar en otro orden, inhabiliteesta opción. Para unir los eventos en unavista, los eventos se deben procesar pororden. Deje esta opción habilitada para unirlos eventos.

Agente JMS Agente JMS existente que conecta con lasecuencia de mensajes de JMS. Cree unagente de cola JMS o de tema JMS con elbotón Actividades de Workbench. Paraobtener más información, consulte: “Agentesde colas Java Messaging Service” en lapágina 33 o “Agentes de tema JMS” en lapágina 35.

Tema o cola Identifica el tema o la cola con los que seestá enviando el mensaje, definido por eleditor del mensaje. Se trata de una direcciónJNDI parecida a com.obi.myjmstopic enOracle WebLogic y a topic/com.obi.myjmstopic en JBoss.



Selector de mensajes Expresión booleana que pone una condiciónde filtro en los mensajes que envía el editor.La sintaxis de la condición es la misma quela de la cláusula WHERE del comandoSELECT (consulte: “Cláusula WHERE” en lapágina 339). Por ejemplo, este filtro sóloacepta mensajes donde la propiedadProveedor contenga uno de estos tresvalores:

Supplier IN ('Xyz, Corp', 'Ink, Inc', 'Gizmos')

Información de la columna Los campos de Información de la columnadefinen cómo correlacionar los campos delmensaje de JMS con las columnas de la tablade flujos de datos. Hay una columna porcada campo en la tabla de flujos de datos.Para obtener más información, consulte:“Información sobre las columnas JavaMessaging Service” en la página 222.

Borrar intervalo de estados Esta pestaña contiene varias opciones paraborrar datos de eventos persistentes. Paraobtener más información, consulte:“Intervalo de borrado de estados” en lapágina 60.

Nota: El agente JMS únicamente soporta los tipos de cuerpo JMS MapMessage yTextMessage. MapMessage está formado por pares de nombre-valor, donde losnombres son cadenas y los valores son wrappers para los tipos Java. TextMessageestá formado por una sola cadena de texto sin nombre, que puede interpretarsecomo un archivo delimitado o de anchura fija, o bien como un archivo XML. Paraobtener más información, consulte: “Tipos de datos de Java Messaging Service” enla página 222.

Creación de una tabla de flujos de datos a partir de unaconexión Java Messaging Service

Puede crear una tabla de flujos de datos desde una conexión JMS.

Antes de empezar

Antes de crear un flujo de datos desde un agente JMS, debe disponer de permisode creación para tablas de consulta y flujos de datos y permiso de acceso de sólolectura en el agente que proporciona datos a la tabla. También debe obtener accesoa la cola o el tema JMS indicado mediante la ubicación JNDI de la fabrica dedirecciones.

Para obtener más información, consulte: “Cómo otorgar permiso para crearobjetos” en la página 294.

Procedimiento1. Abra la pestaña Workbench.2. Pulse Actividades.3. Pulse Crear nuevo > Flujo de datos.4. Seleccione JMS como tipo de origen.

Capítulo 17. Java Messaging Service 221

5. Defina los valores de atributo de la tabla de flujos de datos.6. Abra la pestaña Información de la columna y define las columnas de la tabla

de flujos de datos.7. Guarde el flujo de datos JMS como habilitado.

Información sobre las columnas Java Messaging ServiceLos campos de información de la columna definen cómo correlacionar los camposdel mensaje de JMS con las columnas de la tabla de flujos de datos. Hay un campopor cada columna en la tabla de flujos de datos.

Cada campo del mensaje puede ser un campo simple que se correlacionedirectamente con una columna de evento, o puede ser un campo complejo (uncampo de archivo sin formato) que contenga varios campos que se correlacionende forma individual con las columnas de la tabla. Los campos complejos se tratancomo archivos sin formato en formatos delimitados, de anchura fija o XML. Paraobtener descripciones detalladas de estos tipos de archivos, consulte: Capítulo 13,“Archivos sin formato”, en la página 103.


Tabla 62. Atributos de columna



Nombre de mensaje Nombre del campo en el mensaje. Alcorrelacionar un campo de mensaje, elnombre de cada campo incluido es Nodisponible y no es editable.

Si se especifica un nombre de mensaje, estoindica que el mensaje es un mensaje decorrelación, y que el nombre es el nombredel mensaje.

Si no especifica ningún nombre de mensaje,al guardar se le solicita que confirme quedicho mensaje es contenido de mensaje detexto JMS.

Tipo de datos Tipo de datos de la columna. Para obtenermás información, consulte: “Tipos de datosde Java Messaging Service”.

Formato Formato de la columna para valoresVARCHAR (cadena) y DECIMAL. Elatributo Formato es opcional.

Tipos de datos de Java Messaging ServiceLos tipos de datos de mensajes correlacionados JMS se correlacionan con IBMCognos Real-time Monitoring.

El siguiente ejemplo muestra los tipos de datos de mensajes correlacionados JMSque se correlacionan con los tipos de datos de Cognos Real-time Monitoring. Paraobtener más información, consulte: Capítulo 9, “Tipos de datos”, en la página 69.


Tabla 63. Correlaciones de tipos de datos de mensaje

Tipo de datos deJava

Tipos de datos deCognos Real-timeMonitoring

Tipo de datos deJava

Tipos de datos deCognos Real-timeMonitoring

boolean Boolean long Long

byte Integer float Double

short Integer double Double

char Varchar String Varchar

int Integer byte[] No soportado

Capítulo 17. Java Messaging Service 223


Capítulo 18. Java Database Connectivity

JDBC (Java Database Connectivity) es una interfaz Java para la programación deaplicaciones que permite acceder a bases de datos SQL estándar desde programasJava.

IBM Cognos Real-time Monitoring utiliza JDBC para llevar a cabo las siguientesacciones:v Recuperar datos de tablas de consulta desde una base de datos relacional

(DBMS), tal como se describe en “Tablas Java Database Connectivity” y en“Agentes Java Database Connectivity” en la página 236.

v Acceder a la base de datos de metadatos que utiliza Cognos Real-timeMonitoring para almacenar definiciones de objetos y estados.

v Permitir que otras aplicaciones Java accedan a los datos de vistas empresarialesen la memoria. Para obtener más información, consulte: Capítulo 19, “AccesoJava Database Connectivity a los datos de vista y cubo”, en la página 241.

Tablas Java Database ConnectivityLas tablas de consulta y de flujos de datos JDBC reciben los datos de sistemas debases de datos relacionales externos (DBMS). Los datos se recuperan realizandouna consulta en la base de datos o llamando a un procedimiento almacenado en elDBMS.

Tablas de consultaPara las tablas de consulta, sólo se recuperan datos nuevos cuando un eventonuevo lo requiere. A continuación el agente pasa los datos de consulta al DBMS,que devuelve el resultado del DBMS.

Tablas de consulta

DBMS DBMS de metadatos

Metadatos delsistema

Vistas empresariales

Aplicaciónexterna

Interfaces JDBC

Agente DBC

Entorno del servidor de aplicaciones

Figura 20. Interfaces JDBC


Para obtener más información acerca de las tablas de consulta, consulte:Capítulo 20, “Tablas de consulta”, en la página 261.

Ejemplo de una tabla de consulta

En el siguiente ejemplo se muestra una vista que une una tabla de flujos de datoscon una tabla de consulta:SELECT DataStream.ID, Lookup.Name, Lookup.BDate AS Birth_Date

FROM DataStream, Lookup WHERE DataStream.ID = Lookup.ID

La salida de la tabla de consulta utilizada por esta vista puede ser similar a lasiguiente.Field Name JDBC Data Type Data Type

------------ -------------- ---------

Name STRING Varchar

BDate DATE Timestamp

Creación de un origen Java Database Connectivity para unatabla de flujos de datos

Puede crear un origen JDBC para una tabla de flujos de datos.

Procedimiento1. En IBM Cognos Real-time Monitoring Workbench, pulse la pestaña Workbench.2. Pulse Actividades.3. Pulse Crear nuevo > Flujo de datos.4. Seleccione Flujo de datos único o Flujo de datos consolidado.5. Seleccione JDBC como tipo de origen para el flujo de datos.6. Seleccione el origen Consulta o el origen Procedimiento almacenado.

v Un origen de procedimiento almacenado llama a un procedimientoalmacenado en el DBMS para localizar los datos.

v Un origen de consulta realiza una consulta SELECT de SQL en la base dedatos en el lenguaje nativo de la base de datos. Especifique la sentencia

Las entradas se pasan al DBMS como unaconsulta cuyos resultados se le proporcionana las columnas de salida de la tabla de consulta para que la vista las utilice.

Cuando una vista necesita datos de consulta, identifica los datos solicitados en las columnas de entrada de la tabla de consulta.

DBMSAgente JDBCTabla deconsulta

Vista empresarial

Columnas de entrada

Columnasde salida

Datos para consulta

Datos solicitados

Figura 21. Tabla de consulta


SELECT en el campo de la consulta. Cuando pulse en Continuar, Workbenchemitirá la consulta para validar ésta y para determinar las columnas que hande devolverse.

7. Guarde el origen JDBC como habilitado.

Creación de un origen Java Database Connectivity para unatabla de consulta

Puede crear un origen JDBC para una tabla de consulta.

Procedimiento1. En IBM Cognos Real-time Monitoring Workbench, pulse la pestaña Workbench.2. Pulse Actividades.3. Pulse Crear nuevo > Tabla de consulta.4. Seleccione JDBC como tipo de origen para la tabla de consulta.5. Pulse en Examinar para seleccionar la conexión JDBC.6. Seleccione Consulta o Procedimiento almacenado como origen.

v Un origen de procedimiento almacenado llama a un procedimientoalmacenado en el DBMS para localizar los datos.

v Un origen de consulta realiza una consulta SELECT de SQL en la base dedatos en el lenguaje nativo de la base de datos. Especifique la sentenciaSELECT en el campo de la consulta. Cuando pulse en Continuar, Workbenchemitirá la consulta para validar ésta y para determinar las columnas que hande devolverse.

7. Guarde el origen JDBC como habilitado.

Tablas de flujos de datosPara las tablas de flujos de datos, el agente sondea periódicamente el DBMS paraver si hay nuevos eventos disponibles y, a continuación, los recupera paraincluirlos en la tabla de flujos de datos. Cada evento devuelto se procesaindividualmente, independientemente del recuento de eventos que se devuelvancomo resultado de la consulta de sondeo.

Antes de crear un flujo de datos para una tabla de origen de JDBC, se necesita:v Un agente

Un agente JDBC existente definido con suficientes derechos de acceso paraconsultar la base de datos, o para llamar al procedimiento almacenado. Cree unagente pulsando el botón Actividades, seleccione Crear nuevo y después Flujode datos en las listas desplegables. Para obtener más información, consulte:“Agentes Java Database Connectivity” en la página 236.

v Para consultas

Se encuentran nuevos eventos sondeando el DBMSbuscando datos nuevos

Vista empresarialTabla de flujo de datos

DBMSAgente JDBC

Sondea paraeventos nuevos

Eventos nuevos encontrados

Figura 22. Un agente JDBC sondea un DBMS para buscar nuevos flujos de datos

Capítulo 18. Java Database Connectivity 227

Los esquemas de las tablas que se van a consultar.v Para flujos de datos de consulta

Una columna de la tabla de origen debe ser un valor incremental que identificacuándo hay disponibles nuevos eventos. Para obtener más información, consulte:“Sondeo del origen Java Database Connectivity” en la página 231.

v Para procedimientos almacenadosPara definir el procedimiento en el RDBMS y proporcionar una lista de loscampos de entrada y de salida (conjunto de resultados), así como sus tipos dedatos. Para obtener más información, consulte: “Origen de procedimientosalmacenados” en la página 233.

v PermisosCree permisos (consulte: Capítulo 23, “Permisos”, en la página 291) para tablas(consulte: “Cómo otorgar permiso para crear objetos” en la página 294) ypermiso de sólo lectura al agente que proporciona datos a la tabla.

En la siguiente tabla se describen los atributos de una tabla JDBC:

Tabla 64.


Nombre Identifica la tabla.



Estado Especifica si el objeto está habilitado(preparado para recibir datos) o inhabilitado(no preparado para recibir datos).

Habilitar recuperación Cuando está habilitado, registra los datos deun evento que se reciben después de que seinicie el punto de comprobación. Esteregistro de recuperación se utiliza pararestaurar el estado del sistema después deun cierre anómalo de los servidores. Paraobtener más detalles, consulte la informaciónsobre el punto de comprobación y larecuperación en la publicación IBMCognosReal-time Monitoring Workbench Guíadel usuario.

Procesar datos según orden de llegada (sóloflujos de datos consolidados)

Seleccione esta opción cuando los eventosdeban procesarse en el orden en el que sereciben. De otro modo, si los eventos sepueden procesar en otro orden, inhabiliteeste atributo. Para unir los eventos en unavista, los eventos se deben procesar pororden. Deje esta opción habilitada para unirlos eventos.


Tabla 64. (continuación)


Agente JDBC Un agente de origen de JDBC existente queaccede a un RDBMS. Cree un agentepulsando el botón Actividades, seleccioneCrear nuevo y después Flujo de datos en laslistas desplegables. Para obtener másinformación sobre los agentes, consulte:“Agentes Java Database Connectivity” en lapágina 236.

Consulta de JDBC Sentencia SELECT realizada en la base dedatos en el lenguaje nativo de la base dedatos. Si cambia la consulta, pulse Reenviarconsulta para validarla. No puede guardarcon una consulta no válida.

Para obtener más información sobre elcomando SELECT, consulte ladocumentación de referencia del DBMS.

Deshabilitar tabla de consulta después deeste número de errores consecutivos

Recuento de los errores consecutivos que sedeben recibir para que el sistema inhabilitela tabla de consulta. Una vez inhabilitadas,las tablas de consulta deben volver ahabilitarse manualmente.

Tratar todas las filas del conjunto deresultados como un solo evento

Todas las filas devueltas en el conjunto deresultados se consideran un solo evento. Delo contrario, cada fila devuelta de la tabla seconsidera un evento por separado.

Información de campo Columnas que se deben rellenar en la tablade consulta o de flujos de datos. Losnombres de campo se derivan del resultadode la consulta de JDBC. Cuando el sistemavalida la consulta, rellena esta lista decampos e identifica el tipo de datos JDBC decada valor de retorno. Puede especificar eltipo de datos asociado de la columna en latabla y el formato para el tipo de datos(cuando proceda). Los nombres de camposon los mismos que se han definido en elesquema DBMS, a menos que les asigne unalias con el operador AS en la lista deselección de la sentencia SELECT.

Clave de evento (sólo flujos de datos) Para archivos delimitados y de anchura fija,identifica las columnas de campos de clavespara eventos de varias filas. Para obtenermás información, consulte: “Eventos devarias filas” en la página 107.


Tabla 64. (continuación)


Índice (sólo tablas de consulta) Cuando se activa, crea un índice para lacolumna. Es fundamental seleccionar elíndice correcto para conseguir un buenrendimiento cuando está activado elalmacenamiento de prerrecuperación para elalmacenamiento en la memoria caché encondiciones de unión o en campos de claveen dimensiones. Seleccione Índice para lascolumnas que utilice en las condiciones deunión. Si no utiliza el almacenamiento dedatos en caché con prerrecuperación,seleccionar Índice no tiene ningún efecto.

Almacenamiento de datos en memoriacaché (sólo tablas de consulta)

Almacena los resultados de consultas en lamemoria y las solicitudes que se realizanposteriormente recuperan los datos de lamemoria, con lo que se reduce el número deconsultas al DBMS. Para obtener másinformación, consulte: “Almacenamiento deconsultas de tabla de consulta en la memoriacaché” en la página 265.

Sondeo (sólo flujos de datos) Frecuencia con la que se debe llamar alprocedimiento almacenado o con la que sedebe consultar el DBMS para nuevoseventos. Para obtener más información,consulte: “Sondeo del origen Java DatabaseConnectivity” en la página 231.

Borrar intervalo de estados Opciones para borrar datos de eventospersistentes. Para obtener más información,consulte: “Intervalo de borrado de estados”en la página 60.

Upsert (sólo flujos de datos) Opciones para habilitar la funcionalidadupsert para flujos de datos JDBC. Upsertcombina las acciones de actualizar, insertar ysuprimir datos de las tablas de flujos dedatos. Para obtener más información,consulte: “Upsert” en la página 232.

Origen de consultaUn origen de consulta realiza una consulta SELECT en la base de datos en elorigen DBMS.

Las consultas se utilizan tanto para tablas de consulta como para tablas de flujosde datos, y están en la sintaxis nativa utilizada por el DBMS. Para obtenerinformación específica de sintaxis, consulte la documentación de DBMS.

Limitaciones de SybaseAl realizar una consulta a la base de datos Sybase, tenga en cuenta estaslimitaciones.v Todos los nombres, incluidos los de tablas y columnas, distinguen entre

mayúsculas y minúsculas.v Todas las consultas deben tener el formato de tabla SELECT * FROM; no es

posible incluir ninguna cláusula SELECT. Para filtrar los resultados, cárguelos enuna vista empresarial y luego filtre esa vista.


Ejemplo de una tabla de flujos de datos que utiliza unaconsulta de sondeo

En este tema se proporciona un ejemplo de una tabla de flujos de datos que utilizauna consulta de sondeo.

Observe la siguiente consulta para una tabla de flujos de datos.SELECT * FROM sales

La información de campo resultante es similar al siguiente ejemplo:Field Name JDBC Data Type Data Type

------------ -------------- ---------

Sales_ID INT Integer

Product_ID INT Integer

Customer_ID STRING Varchar

El campo de aumento de sondeo seguramente es "Sales_ID." Para obtener másinformación, consulte: “Sondeo del origen Java Database Connectivity”.

Sondeo del origen Java Database ConnectivityEl sondeo indica al objeto la frecuencia con la que se debe llamar al procedimientoalmacenado o con la que se debe consultar el DBMS para nuevos eventos.

En la siguiente tabla se describen los parámetros de sondeo:

Tabla 65. Parámetros de sondeo de orígenes JDBC


Intervalo de sondeo Frecuencia con la que se debe llamar alprocedimiento o emitir la consulta.

Deshabilitar flujo de datos después de estenúmero de errores consecutivos

Inhabilita el objeto (detiene el sondeo) trasuna serie de errores consecutivos. De formapredeterminada, el sondeo se detiene trascinco errores consecutivos. Para volver ahabilitar el objeto, cambie el estado delobjeto (consulte: “Estados de objetos” en lapágina 269) a habilitado. Establezca estaopción en cero (0) para evitar que seinhabilite el objeto automáticamente.

Campo de aumento (sólo consultas de flujosde datos)

Identifica la columna de la tabla de origenque contiene un valor que se incrementa concada evento. Por ejemplo, si la tabla que seconsulta contiene valores de ID exclusivos yascendentes, la consulta utiliza ese campomediante la lógica en que el ID es mayorque el ID máximo de la última consulta.


Tabla 65. Parámetros de sondeo de orígenes JDBC (continuación)


Valor inicial (sólo consultas de flujos dedatos)

Valores de inicio asignados al campo deaumento; sin embargo, este valor inicial nose incluye en el resultado. El primer valorincluido en el resultado es el siguiente valormás pequeño mayor que el valor inicial. Porejemplo, si especifica 500 como valor inicialde ID, el primer valor incluido es 501. Paralas consultas posteriores, los valores sonmayores que el valor de campo de aumentomás grande devuelto por la última consulta.Si utiliza un SQLServer 2005 para la base dedatos de la tabla de consulta y uncontrolador 2005 Microsoft, los valores defecha inicial deben tener el formatoaaaa-mm-dd. De lo contrario, puedegenerarse un error.

UpsertLa funcionalidad upsert combina las acciones de actualizar, insertar y suprimirdatos de las tablas de flujos de datos. Puede habilitar esta característica para losflujos de datos JDBC, los flujos de archivos sin formato y los flujos JMS, entreotros.

La funcionalidad upsert actualiza de forma dinámica la base de datos. A medidaque se añaden nuevos eventos a las tablas de la base de datos, los eventos antiguosse van sustituyendo o suprimiendo, con lo cual la base de datos siempre contieneúnicamente los datos necesarios.

Para habilitar la funcionalidad upsert, es necesario un agente JDBC específicamentepara upsert. Este agente gestiona los datos necesarios para la funcionalidad upsert.Puede crear el agente JDBC de upsert al crear el flujo de datos o con anterioridad.De forma predeterminada, upsert utiliza el mismo agente JDBC que se haespecificado para la creación de un flujo de datos JDBC.

La funcionalidad upsert se habilita cuando se crea el flujo de datos JDBC. Nohabilite esta funcionalidad cuando el flujo de datos utilice la clave de evento.

Los parámetros siguientes están asociados a esta funcionalidad:

Tabla 66. Parámetros Upsert


Habilitar actualizaciones/inserciones/supresiones (upsert)

Habilita la funcionalidad upsert para unflujo de datos JDBC.

Agente JDBC Especifica el agente JDBC.

Puede aceptar el agente predeterminado queha seleccionado para el flujo de datos opuede pulsar Examinar y especificar unagente distinto.


Tabla 66. Parámetros Upsert (continuación)


Nombre de tabla para el almacenamientode datos upsert

Especifica el nombre de la tabla quealmacena los datos necesarios para lafuncionalidad upsert.

Esta tabla se crea en la base de datosasociada al agente JDBC. Suprima esta tablasi suprime o inhabilita la secuencia deupsert.

Antigüedad máxima de los datos upsert Especifica el periodo en el que se soportaráupsert.

La acción de actualización o supresión no esválida para un evento más antiguo que esteperiodo.

Columna de claves Especifica la columna que se utiliza paraidentificar los eventos que deben suprimirseo actualizarse.

Columna de acción Especifica la columna que contiene losdistintivos "I/D/U" para las acciones deinserción, supresión y actualización.

Se pueden seleccionar varias columnas. Sinembargo, no debe seleccionar la columnaque ya se ha seleccionado como Columnade acción.

Origen de procedimientos almacenadosEl origen de los procedimientos almacenados JDBC requiere atributos específicos.

Estos atributos se describen en la tabla siguiente:

Tabla 67. Atributos de origen de procedimiento almacenado JDBC


Nombre del procedimiento Nombre del procedimiento almacenado en elDBMS. Los flujos de datos JDBC nosoportan conjuntos de varios resultados niparámetros de salida de procedimientosalmacenados. Para Oracle, esto significa quesólo se soportan las funciones de Oracleporque son las únicas que devuelven un soloresultado.

Salidas Columnas de la tabla de consulta o de flujosde datos, sus tipos de datos y formateoopcional. El procedimiento devuelve unconjunto de resultados cuyos valores secorrelacionan con las columnas en el ordenen que aparecen en esta lista. El tipo dedatos identifica el tipo de la columna de latabla, y se convierte automáticamente apartir del tipo JDBC según se define en“Correlación de tipos de datos Java DatabaseConnectivity” en la página 235.


Tabla 67. Atributos de origen de procedimiento almacenado JDBC (continuación)


EntradasOpcional para flujos de datos. Parámetrospasados al procedimiento almacenado y sustipos de datos. Los parámetros contienenvalores para buscar en la tabla DBMS. Lasentradas se pasan como argumentos alprocedimiento en el orden en el queaparecen en la lista.

El tipo de datos identifica el tipo de datosde IBM Cognos Real-time Monitoring delvalor que se pasa al procedimiento. Paraobtener más información, consulte:“Correlación de tipos de datos Java DatabaseConnectivity” en la página 235.

Además, para los flujos de datos, elprocedimiento suele consultar el DBMSbuscando eventos insertados desde la últimavez que se llamó el procedimiento. Para ello,deben identificarse los campos de la tablaque contienen valores de aumento oincrementales. Por ejemplo, si la tabla que seconsulta contiene valores de ID exclusivos yascendentes, el procedimiento utiliza esecampo mediante la lógica en que el ID esmayor que el ID máximo de la últimaconsulta.

Para flujos de datos, el valor de sondeoinicial (Initial Polling Value) especifica elvalor que se debe utilizar la primera vez queel procedimiento consulta el DBMS sobreeventos. Por ejemplo, puede especificarvalores de ID a partir de 500. Para lasconsultas posteriores, el valor de sondeoposterior Subsequent Polling Valueidentifica un campo que contiene el valormáximo de la última consulta. Este valor esun campo de salida (Output) del resultadoanterior.

Sondeo Frecuencia con la que se debe llamar alprocedimiento almacenado. Para obtenermás información, consulte: “Sondeo delorigen Java Database Connectivity” en lapágina 231.

Al realizar una consulta a una base de datos Sybase, tenga en cuenta que losnombres, incluidos los de tablas y columnas, distinguen entre mayúsculas yminúsculas.

Ejemplo de recepción de datos de tabla de consulta con unprocedimiento almacenado

Puede ver un ejemplo de una vista que une a una tabla de flujos de datos con unatabla de consulta.


Considere el siguiente ejemplo:SELECT DataStream.ID, Lookup.Name

FROM DataStream, Lookup

WHERE DataStream.ID = Lookup.ID

La salida de la tabla de consulta para esta vista es la columna Name, y la entradapara el procedimiento es la columna ID.Output Field Name Data Type

----------------- ---------

Name Varchar

Input Field Name Data Type

----------------- ---------

ID Integer

Ejemplo de recepción de un evento con un procedimientoalmacenado

Aquí se ofrece un ejemplo de recepción de un evento con un procedimientoalmacenado.

Imagine un evento con los campos siguientes. Event_Timestamp es el campo con elvalor exclusivo incremental. Cada registro de eventos tiene una indicación de fechay hora asignada por el DBMS.Output Field Name Data Type

----------------- ---------

Ticket_ID Varchar

Cust_ID Varchar

Status Varchar

Topic Integer

When_Opened Timestamp

Assigned_To Varchar

Event_Timestamp Timestamp

La entrada de flujo de datos identifica un parámetro que pasa el valor a laconsulta. El nombre de la entrada debe ser exclusivo en la lista, pero por lo demásno es significativo. En el ejemplo siguiente, el nombre del campo "IN1".Input Field Name Initial Polling Value Subsequent Polling Value

---------------- --------------------- ------------------------

IN1 2003-03-05 19:45:00 DataStream_Timestamp

La primera vez que el procedimiento almacenado consulta el DBMS, emite unaconsulta semánticamente similar a la del ejemplo siguiente:SELECT * FROM datastreams

WHERE datastream_time >= "2003-03-05 19:45:00"

Las consultas posteriores utilizan los resultados de la consulta anterior como puntode partida para los nuevos eventos.

Correlación de tipos de datos Java Database ConnectivityLos tipos de datos de las columnas DBMS se muestran como tipos de datos JDBCy se correlacionan con los tipos de datos de IBM Cognos Real-time Monitoring.


Para obtener más información, consulte: Capítulo 9, “Tipos de datos”, en la página69.

La siguiente tabla muestra esta correlación.

Tabla 68. Correlación de tipos de datos JDBC

Tipo dedatos JDBC Carácter Entero Doble Decimal

Indicaciónde fecha yhora Booleano Largo

CHAR sí comoliteral

VARCHAR sí comoliteral

LONGVARCHARsí comoliteral

NUMERIC sí sí sí sí sí

DECIMAL sí sí sí sí sí

BIT sí sí sí sí sí

TINYINT sí sí sí sí sí

SMALLINT sí sí sí sí sí

INTEGER sí sí sí sí sí

BIGINT sí sí sí sí sí

REAL sí sí sí sí sí

FLOAT sí sí sí sí sí

DOUBLE sí sí sí sí sí

BINARY

VARBINARY

DATE sí

TIME sí

TIMESTAMP sí

No utilice los tipos de datos booleano de Cognos Real-time Monitoring en unpredicado WHERE pasado al origen JDBC. Los valores booleanos pueden incluirseen la lista de selección.

Agentes Java Database ConnectivityUn agente de conectividad de base de datos Java se comunica con una base dedatos relacional (DBMS) realizando una consulta en la base de datos, o bienllamando a un procedimiento almacenado en el DBMS. A continuación, el DBMSdevuelve una o varias filas de datos, que el agente pasa a la tabla de consulta o deflujos de datos que los ha solicitado.

Los agentes JDBC son síncronos, recuperan mensajes de eventos y datos de tablade consulta como resultado de una solicitud específica, tal como se resume en latabla siguiente. Para las tablas de consulta, los agentes acceden al DBMS cuandoun nuevo evento requiere datos de la tabla de consulta. Para las tablas de flujos dedatos, el agente sondea periódicamente el DBMS para ver si hay nuevos eventosdisponibles y, a continuación, los recupera para incluirlos en la tabla de flujos de


datos. Cada evento devuelto se procesa individualmente, independientemente delrecuento de eventos que se devuelvan como resultado de la consulta de sondeo.

Tabla 69. Recuperación de datos de agentes JDBC



No Sí Sí

Creación de un agente JDBCPuede crear un agente JDBC.

Los agentes JDBC tienen los atributos siguientes:

Tabla 70. Atributos de agente JDBC


Nombre Identifica el agente.


Guardar en Especifica la carpeta en la que se guardará elagente. La predeterminada es Carpetaspúblicas. Para seleccionar una carpeta, pulseel botón Seleccionar carpeta.

Estado Especifica si el objeto está habilitado(preparado para recibir datos) o inhabilitado(no preparado para recibir datos).


Tipo de base de datos Identifica el proveedor de DBMS como DB2,Oracle, SQL Server, Sybase, MySQL,PostgresSQL o Teradata.

Nombre de usuario Especifica el nombre de usuario que ha deutilizarse para conectarse con el DBMS. Esteusuario debe disponer de derechos de accesode consulta.

Contraseña Establece la contraseña para el nombre deusuario. Si omite esta opción, el agenteutilizará la contraseña que se ha especificadoen la definición de configuración del origenJDBC en el servidor de aplicaciones.

Máximo de filas por consulta Especifica el número máximo de filas quehan de devolverse como el resultado de laconsulta. Es útil para que los usuarios noreciban resultados excepcionalmente grandesque podrían afectar al DBMS.


Tabla 70. Atributos de agente JDBC (continuación)


Tipo de conexión JDBC Define cómo ha de establecerse la conexióncon el JDBC en el servidor de aplicaciones.La conexión puede tener una de estasfuentes:

Basada en origen de datos, que estableceuna conexión con una agrupación de basesde datos JDBC mediante una conexión JNDI.

Basada en URL, que establece una conexióncon un origen JDBC mediante una direcciónURL.

Nombre JNDI para el origen JDBC (sólobasada en origen de datos)

Identifica el nombre del origen de datos queha de utilizarse como conexión con la basede datos. El nombre se especifica en formatoJNDI, comocom.cognos.obi.products.ProductSource. Unorigen obtiene su conexión desde unaagrupación de conexiones que el servidor deaplicaciones mantiene. Ese servidormantiene las conexiones abiertas parareducir retardos al establecer una conexión.

La agrupación de conexiones debeconfigurarse como una agrupación notransaccional; no TxT en WebLogic.

URL JDBC (sólo Basado en URL) Indica la dirección URL que se correlacionacon la conexión JDBC que se ha configuradoen el servidor de aplicaciones en el que seejecuta IBM Cognos Real-time Monitoring.Por ejemplo, una dirección URL podría tenerun aspecto similar al siguiente:jdbc:oracle:thin:some_context/context@v480:1521:symbols

Clase de controlador JDBC (sólo Basado enURL)

Especifica el controlador JDBC que ha deutilizarse. Este controlador debe residir en laruta de clase de la aplicación que ejecutaCognos Real-time Monitoring. Incluya elnombre de clase completo, comooracle.jdbc.driver.OracleDriver, en la ruta declase.


Tabla 70. Atributos de agente JDBC (continuación)


Propiedades de JNDI (sólo basado enorigen de datos)

Especifica las propiedades de Java Namingand Directory Interface (JNDI) opcionales yadicionales necesarias para crear o mantenerel agente en el origen de JDBC. Puedeutilizar esos pares de nombre-valor paraespecificar propiedades JDBC. Los nombrespueden ser uno de los atajos que se indicana continuación o una propiedad de JNDIreconocida. El agente reconoce los siguientesnombres como atajos a propiedades deJNDI:

factory se correlaciona conINITIAL_CONTEXT_FACTORY.

provider se correlaciona conPROVIDER_URL.

security_credentials se correlaciona conSECURITY_CREDENTIALS.

security_principal se correlaciona conSECURITY_PRINCIPAL.

Propiedades de la conexión (sólo Basado enURL)

Especifica las propiedades de conexiónopcionales y adicionales necesarias paracrear o mantener el agente en el origenJDBC. Puede utilizar esos paresnombre-valor para especificar laspropiedades de la conexión JDBC.

Antes de empezar

Antes de crear un agente JDBC:v Debe disponer de permiso de creación para agentes.v Debe disponer de un origen de datos JDBC definido y gestionado por el

servidor de aplicaciones, preferentemente un servidor de aplicaciones queagrupe conexiones. Configure la agrupación de conexiones tal como se explicaen la documentación del servidor de aplicaciones. Asimismo, en la definición dela agrupación:– Establezca el número máximo de conexiones abiertas con la base de datos en,

como mínimo, 200.– Establezca una frecuencia de renovación mayor que 0, preferentemente de 1 ó

2 minutos, de modo que la base de datos pueda desactivarse y volver aactivase sin perder la conexión de la agrupación. Además, puede establecer laagrupación para que compruebe si existe una tabla física en la base de datos.

Procedimiento1. En IBM Cognos Real-time Monitoring Workbench, pulse la pestaña Workbench.2. Pulse Actividades.3. Seleccione Crear nuevo > Agente.4. En la ventana Crear agente, seleccione JDBC como tipo de origen.5. Especifique los atributos necesarios.


6. Guarde el agente como habilitado.


Capítulo 19. Acceso Java Database Connectivity a los datosde vista y cubo

IBM Cognos Real-time Monitoring ofrece una interfaz de programación deaplicaciones (API) que permite a las aplicaciones JDBC 2.0 recuperar datos de unavista o un cubo y recuperar los metadatos que describen las vistas o los cubos enla instalación.v Puede ver datos de la vista reciente. Si la vista contiene una ventana de conjunto

móvil, se devuelven los datos de la ventana.v Con valores de propiedades especiales en el URL de JDBC, también puede ver

las siguientes columnas:– Identificador de evento (VC_EVENT_ID), que identifica el evento que ha

producido la fila más reciente incluida en la vista.– Identificador de evento más reciente (VC_LATEST_EVENT_ID), que identifica

el último evento que provocó la actualización de la vista, aunque los datos deese evento no estén incluidos en la vista.

– Indicación de fecha y hora de evento (VC_TIMESTAMP), que identificacuándo se incluyó el último evento en la vista.

Para obtener más información, consulte: “URL Java Database Connectivity”.

Ruta de claseLa ruta de clase al controlador JDBC (cqjdbcclient.jar) y commons-logging-1.1.jar deIBM Cognos Real-time Monitoring debe añadirse en la aplicación JDBC cliente.

La ruta de clase es:java -classpath .;commons-logging_1.1.jar;

cqjdbcclient.jar JDBCAccessor

Puede obtener commons-logging-1.1.jar en Apache.org.

El archivo cqjdbcclient.jar se encuentra en el directorio<directorio_instalación_cognos>/realtime/sdk/java/lib.

URL Java Database ConnectivityEl URL de JDBC tiene un formato específico.jdbc:cognos:obi://<host>:<port>[;<property>=<value>][;<property>=<value>]...

El número de puerto predeterminado es 2669. Puede configurar el puerto JDBCmediante los ajustes de Control del sistema en Valores del sistema de la Consolade administración.

Las propiedades y los valores predeterminados son los siguientes:


Tabla 71. Propiedades y valores predeterminados para los URL de JDBC

PropiedadesValorespredeterminados Descripción

implicitColumns false Especifica si se devuelven columnasimplícitas además de los datos de revisiónnormales. Si es true, las columnasVC_EVENT_ID, VC_LATEST_EVENT_ID yVC_TIMESTAMP se incluyen en el conjuntode resultados.

C8passport Si IBM Cognos 8 autentica un usuario, éstepuede utilizar el controlador JDBC pasandoel C8passport al controlador.

Nombre de usuario El usuario de la base de datos en cuyonombre se realiza la conexión.

password La contraseña del usuario.

Los valores de las propiedades tienen los siguientes efectos:v Si la propiedad C8passport está establecida, las propiedades de nombre de

usuario y contraseña se omiten.v La propiedad Password se omite y el usuario inicia sesión como Anónimo si se

cumplen las siguientes condiciones:– La propiedad C8passport no está establecida.– El acceso como Anónimo está habilitado.– La propiedad Username está establecida como Anónimo o no se proporciona.

v Si la propiedad C8passport no está establecida y el usuario Anónimo no estáhabilitado, se utilizan los valores proporcionados para las propiedades denombre de usuario y contraseña.

Si el valor de implicitColumns es true, los datos de Vista de la vista reciente, elidentificador de evento, el identificador del último evento y la indicación de fechay hora del evento son la misma información que se escribe en una base de datos alpersistir vistas. Para obtener más información, consulte: “Persistencia de vistaspara una base de datos” en la página 370.

Interfaces de vista de Java Database ConnectivityJDBC 2.0 define interfaces para acceder a los datos.

IBM Cognos Real-time Monitoring implementa las interfaces para acceder a losdatos.

Para obtener más detalles sobre las interfaces, consulte la documentación de JDBCen http://java.sun.com/j2se/1.4.2/docs/api/java/sql/package-summary.html.

El controlador JDBC de Cognos Real-time Monitoring no proporciona soporte totalpara la API estándar de JDBC. Para obtener información acerca de laimplementación de Real-time Monitoring de la API de JDBC, consulte: Apéndice A,“Métodos Java Database Connectivity”, en la página 421.

Para obtener una lista de las clases de controladores JDBC de Cognos Real-timeMonitoring (Driver, Connections, Statement, DatabaseMetaData, ResultSet yResultSetMetaData) y sus métodos proporcionados por el controlador JDBC de


Cognos Real-time Monitoring, consulte: Capítulo 19, “Acceso Java DatabaseConnectivity a los datos de vista y cubo”, en la página 241.

Correlaciones de tipo de datosLas funciones get de esta clase devuelven valores de las columnas de IBM CognosReal-time Monitoring.

Esta matriz indica qué funciones se utilizan para los distintos tipos de datos deReal-time Monitoring.

Tabla 72. Correlación de tipos de datos

Tipo dedatos getBooleangetInt getLong

getDouble getBigDecimalgetString getTimestamp

Booleano Sí No No disp. No No No No disponible

Entero No Sí No No Nodisponible

No disponible

Largo No disp. No Sí No No No No disponible

Doble No No Sí Nodisponible

Nodisponible

No disponible

Decimal No No No Sí No No disponible

Varchar No No No No Sí No

Indicaciónde fecha yhora

No disp. Nodisp.

Nodisp.

Nodisponible

No Sí

Sí indica que la función devuelve un valor compatible con el tipo de datos deReal-time Monitoring.

No indica tipos de datos que podrían ser compatibles, pero que no esrecomendable convertirlos.

etiqueta de resumen getColumns()Resumen de la documentación Java para DatabaseMetaData.getColumns().

Consulte la documentación de Java para obtener una lista completa.

Tabla 73. etiqueta de resumen getColumns()

Columna Tipo Descripción

TABLE_CAT Cadena Catálogo de tabla (puede ser nulo).

TABLE_SCHEM Cadena Esquema de tabla (puede ser nulo).

TABLE_NAME Cadena Nombre de tabla.

COLUMN_NAME Cadena Nombre de columna.

DATA_TYPE int Tipo de SQL de java.sql.Types.Consulte la sección “Valores deretorno DATA_TYPE” en la página245 para obtener un resumen.

TYPE_NAME Cadena Nombre de tipo dependiente delorigen de datos; para un tipodefinido por el usuario el nombrede tipo está totalmente cualificado.

Capítulo 19. Acceso Java Database Connectivity a los datos de vista y cubo 243

Tabla 73. etiqueta de resumen getColumns() (continuación)


COLUMN_SIZE int Tamaño de columna. Para los tiposde carácter o fecha, indica elnúmero máximo de caracteres.Para los tipos numéricos odecimales, indica la precisión.

BUFFER_LENGTH Cadena No utilizado.

DECIMAL_DIGITS int Recuento de dígitos fraccionarios.

NUM_PREC_RADIX int Radix (normalmente 10 ó 2).

NULLABLE int Con NULL admitido.

columnNoNulls indica que esposible que permita valores NULL.

columnNullable implica que esseguro que admite valores NULL.

columnNullableUnknown implicanulabilidad desconocida.

REMARKS Cadena Comentario que describe lacolumna (puede ser nulo).

COLUMN_DEF Cadena Valor predeterminado (puede sernulo).

SQL_DATA_TYPE int No utilizado.

SQL_DATETIME_SUB int No utilizado.

CHAR_OCTET_LENGTH int Para tipos de char, el númeromáximo de bytes en la columna.

ORDINAL_POSITION int Índice de columna en la tabla(inicio en 1).

IS_NULLABLE Cadena "NO" indica que la columna seguroque no admite valores NULL;"YES" indica que la columnapodría admitir valores NULL. Si lacadena está vacía, indica que no sesabe.

Resumen de la columna getTables()Resumen de la documentación de Java para DatabaseMetaData.getTables().

Consulte la documentación de Java para obtener una lista completa.

Tabla 74. Resumen de la columna getTables()


TABLE_CAT Cadena Catálogo de tabla (puede ser nulo).

TABLE_SCHEM Cadena Esquema de tabla (puede ser nulo).

TABLE_NAME Cadena Nombre de tabla.

TABLE_TYPE Cadena Tipo de tabla. Los tipos habituales son"TABLE", "VIEW", "SYSTEM TABLE","GLOBAL TEMPORARY", "LOCALTEMPORARY", "ALIAS", "SYNONYM".


Tabla 74. Resumen de la columna getTables() (continuación)


REMARKS Cadena Utilizada por IBM Cognos Real-timeMonitoring para modificar la indicación defecha y hora de una columna.

TYPE_CAT Cadena Catálogo de tipos (puede ser nulo).

TYPE_SHEM Cadena Esquema de tipos (puede ser nulo).

TYPE_NAME Cadena Nombre de tipo (puede ser nulo).

SELF_REFERENCING_COL_NAME

Cadena Nombre de la columna "identificadora"designada de una tabla con tipos (puede sernulo).

REF_GENERATION Cadena Especifica cómo se crean los valores deSELF_REFERENCING_COL_NAME. Losvalores son "SYSTEM", "USER" y "DERIVED"(puede ser nulo).

Valores de retorno DATA_TYPELa columna DATA_TYPE devuelve un valor int que identifica el tipo de datos Java.

Para obtener información, consulte el archivo java.sql.Types. La siguiente tablaresume esos valores.

Tabla 75. Valores de retorno DATA_TYPE

Tipo Valor

BIT -7

TINYINT -6

BIGINT -5

LONGVARBINARY -4

VARBINARY -3

BINARY -2

LONGVARCHAR -1

NULL 0

CHAR 1

NUMERIC 2

DECIMAL 3

INTEGER 4

SMALLINT 5

FLOAT 6

REAL 7

DOUBLE 8

VARCHAR 12

DATE 91

TIME 92

TIMESTAMP 93

OTHER 1111


Tabla 75. Valores de retorno DATA_TYPE (continuación)

Tipo Valor

JAVA_OBJECT 2000

DISTINCT 2001

STRUCT 2002

ARRAY 2003

BLOB 2004

CLOB 2005

REF 2006

Ejemplos de descriptores de acceso JDBCEstos ejemplos demuestran cómo conectarse a los servidores IBM Cognos Real-timeMonitoring y cómo consultar datos de vista y metadatos sobre las vistas ycolumnas definidas en la instalación.

JavaEl acceso al controlador JDBC depende de las clases de java.sql.*.

Asegúrese de incluir la siguiente importación en sus aplicaciones:import java.sql.*;

Ejemplo completoPara compilar la aplicación, utilice este comando.javac -classpath . JDBCAccessor.java

Para ejecutar el programa, cárguelo en el servidor de aplicaciones.

Los resultados de los ejemplos aparecen en la salida estándar, y los errores seconsideran errores estándar.

Ejemplo: establecer una conexión con los servidores IBMCognos Real-time Monitoring

En este ejemplo se muestra cómo establecer una conexión con el controlador JDBCde los servidores IBM Cognos Real-time Monitoring.

Establezca la conexión creando un objeto Connection, similar al siguiente ejemplo:Connection connection = null;

connection = DriverManager.getConnection(url, userName,password);

Los parámetros de nombre de usuario y contraseña identifican una cuenta deCognos Real-time Monitoring. Al consultar un objeto específico (como una vista),la cuenta de usuario debe tener como mínimo permiso de acceso de sólo lectura.De lo contrario, si la cuenta no tiene acceso a la vista, la consulta falla como si lavista no existiera.

A continuación se muestra un ejemplo más detallado. Sin embargo, para ver lalista completa, revise el miembro JDBCAccessor.main().// Common connection properties

String userName = "RTMadmin";


String password = "manager";

String url = "jdbc:cognos:obi://localhost:2669";

// Verify the JDBC driver in the application

try {

Class.forName("com.cognos.obi.jdbc.driver.Driver");

} catch (ClassNotFoundException e) {

handleError("Could not find the JDBC driver class.",e);

return;

}

// Establish the connection to the JDBC driver

Connection connection = null;

try {

connection = DriverManager.getConnection(url, userName,password);

} catch (SQLException e) {

handleError("Could not connect to the JDBC driver.",e);

return;

}

Ejemplo: consultar el contenido de una vistaEste fragmento de código muestra cómo consultar todo el contenido de una vista.

La llamada executeQuery() pasa la consulta al controlador, que devuelve elcontenido de la vista en un objeto a ResultSet. En esta lista se incluyen todas lascolumnas del resultado de consulta. Si implicitColumns se ha establecido comoverdadero, se incluyen tres columnas adicionales. Si desea obtener másinformación, consulte el apartado “URL Java Database Connectivity” en la página241. Además, se recuperan los metadatos sobre la vista en un objetoResultSetMetaData para determinar el recuento de columnas de la vista.

Consulte el ejemplo JDBCAccessor.PrintViewContents() para ver un listadocompleto de código./* Query all contents of a view.

* Connection has already been established, and the viewname defined.

*/

String queryString = "SELECT * FROM " + VIEW_NAME ;

ResultSet rs; // Table to hold the queryresults.

ResultSetMetaData rmd; // Metadata about the resultset.

// Query the view, and get its data and metadata.

Statement stmt = connection.createStatement();

rs = stmt.executeQuery( queryString );

rmd = rs.getMetaData();

// Print the contents of the entire view, row by row.

int columnCount = rmd.getColumnCount();

boolean isEmpty = true;

while (rs.next()) {


isEmpty = false;

System.out.print(" Row: ");

for (int i=0;i<columnCount;i++) {

// Show the column value, or "NULL"

String ts = rs.getString(i+1);

System.out.print( (rs.wasNull() ? "NULL " : ts +" "));

}

System.out.println(); // Line break

}

if (isEmpty) {

System.out.println("\n *** The view is empty ***");

}

El resultado puede ser similar al siguiente si implicitColumns se ha establecidocomo falso:Contents of view [OrderProductTotals]:Row: Hardware Lag bolts 16400.00 41 65000.00 30000.00 100000.0030000.00 100000.00Row: Hardware Nuts 337875.00 159 280000.00 240000.00 320000.00240000.00 320000.00Row: Lumber Plywood 304800.00 127 250000.00 200000.00 300000.00200000.00 300000.00Row: Hardware Washers 122400.00 72 170000.00 120000.00 220000.00120000.00 220000.00Row: Hardware Hinges 132300.00 49 130000.00 90000.00 170000.0090000.00 170000.00Row: Hardware Nails 129600.00 48 150000.00 100000.00 200000.00100000.00 200000.00Row: Lumber Chip board 277200.00 126 250000.00 200000.00 300000.00200000.00 300000.00Row: Hardware Screws 60000.00 30 80000.00 60000.00 100000.00 60000.00 100000.00

El resultado puede ser similar al siguiente si implicitColumns se ha establecidocomo verdadero:Contents of view [OrderProductTotals]:Row: Hardware Lag bolts 16400.00 41 65000.00 30000.00 100000.0030000.00 100000.00 20 2007-11-01 15:58:09.794 27Row: Hardware Nuts 337875.00 159 280000.00 240000.00 320000.00240000.00 320000.00 26 2007-11-01 15:58:09.794 27Row: Lumber Plywood 304800.00 127 250000.00 200000.00 300000.00200000.00 300000.00 9 2007-11-01 15:58:09.794 27Row: Hardware Washers 122400.00 72 170000.00 120000.00 220000.00120000.00 220000.00 22 2007-11-01 15:58:09.794 27Row: Hardware Hinges 132300.00 49 130000.00 90000.00 170000.0090000.00 170000.00 27 2007-11-01 15:58:09.794 27Row: Hardware Nails 129600.00 48 150000.00 100000.00 200000.00100000.00 200000.00 25 2007-11-01 15:58:09.794 27Row: Lumber Chip board 277200.00 126 250000.00 200000.00 300000.00200000.00 300000.00 17 2007-11-01 15:58:09.794 27Row: Hardware Screws 60000.00 30 80000.00 60000.00 100000.00 60000.00 100000.0019 2007-11-01 15:58:09.794 27

Ejemplo: consultar las especificaciones de columna de unavista

Este fragmento de código muestra cómo consultar las especificaciones definidaspor el usuario acerca de las columnas de una vista.


En primer lugar muestra todos los metadatos disponibles para las especificacionesde columna, y a continuación muestra las especificaciones para cada columna de lavista, incluidas las columnas del sistema internas. Los resultados aparecen en elorden en que aparecen las columnas en la vista, seguidos por las columnasinternas.

Consulte el ejemplo JDBCAccessor.PrintColumns() para ver un listado completo decódigo./* Query a view’s column specifications.

* Connection has already been established, and the viewname defined.

*/

// Query the table to identify the columns to reporton. Because the

// view contents are irrelevant here, omit them by declaring

// ’WHERE false’ as the query condition.

String queryString = "SELECT * FROM " + VIEW_NAME +" WHEREfalse";

ResultSet rs; // Table to hold the queryresults.

ResultSetMetaData rmd; // Metadata about the resultset.

// Query the view, and then get its metadata.


rs = stmt.executeQuery( queryString);


// Print the metadata about the columns inthe view.

System.out.println("Column details for view [" +

rmd.getTableName(1) +"]:");

// Walk through and show the interestingmetadata available for

// each column in the view. Include labels to identifywhat we see

// in the result.

for (int i=0;i<rmd.getColumnCount();i++){

System.out.println(

" " + Integer.toString(i+1) +

". Name [" + rmd.getColumnName(i+1) +

"] Type [" + Integer.toString(rmd.getColumnType(i+1))+

"] Precision [" + Integer.toString(rmd.getPrecision(i+1))+

"] Scale [" + Integer.toString(rmd.getScale(i+1))+"]");

}

Los resultados pueden ser parecidos a los del ejemplo siguiente:Column details for view [ORDERPRODUCTTOTALS]:

1. Name [FAMILY] Type [12] Precision [20] Scale [0]

2. Name [PRODUCT] Type [12] Precision [50] Scale [0]

4. Name [QTY] Type [4] Precision [10] Scale [0]

3. Name [SALES] Type [3] Precision [25] Scale [2]

6. Name [TARGET MIN] Type [3] Precision [15] Scale [2]

5. Name [TARGET] Type [3] Precision [15] Scale [2]


7. Name [TARGET MAX] Type [3] Precision [15] Scale [2]

8. Name [TARGETMIN] Type [3] Precision [15] Scale [2]

9. Name [TARGETMAX] Type [3] Precision [15] Scale [2]

Ejemplo: consultar metadatos de columnaEstos fragmentos de código muestran cómo recuperar metadatos sobre lascolumnas de una vista.

En cambio, para recuperar las especificaciones de columna, consulte: “Ejemplo:consultar las especificaciones de columna de una vista” en la página 248.

Consulte el ejemplo JDBCAccessor.PrintColumnMeta() para ver un listadocompleto de código./* Retrieve the metadata about the columnsof a defined view.

*/

// NOTE: Specify ’null’ instead of ’VIEW_NAME’ to getthe metadata

// for ALL columns in the installation.

rs = meta.getColumns(null,null,VIEW_NAME,null);


// Show the metadata available for view columns.

int columnCount = rmd.getColumnCount();


System.out.print(rmd.getColumnName(i+1) +

((i+1)==columnCount ? "" : ","));

}

En los resultados, primero se indican los nombres de columna de metadatos (paraver una descripción de las columnas, consulte: “etiqueta de resumengetColumns()” en la página 243):TABLE_CAT,TABLE_SCHEM,TABLE_NAME,COLUMN_NAME,DATA_TYPE,TYPE_NAME,COLUMN_SIZE,BUFFER_LENGTH,DECIMAL_DIGITS,NUM_PREC_RADIX,NULL ABLE,REMARKS,COLUMN_DEF,SQL_DATA_TYPE,SQL_DATETIME_SUB,CHAR_OCTET_LENGTH,ORDINAL_POSITION,IS_NULLABLE,SCOPE_CATLOG,SCOPE_SCHEMA,SCOPE_TABLE,SOURCE_DATA_TYPE

A continuación se muestran todos los metadatos sobre las columnas de una vistaespecífica. Las columnas no aparecen en el mismo orden que en la vista.// Show the metadata values for the columnsin the view.


while (rs.next()) {

isEmpty = false;


String ts = rs.getString(i+1); // Metadata value

if (rs.wasNull())

System.out.print(",");

else

System.out.print(ts +

((i+1)==columnCount ? "" : ","));

}

System.out.println();


}

if (isEmpty) {

System.out.println("\n *** Either there are no columnsdefined "+

"for this view (unlikely), or the view is not "+ "defined(probably).");

}

A continuación se ofrece un listado de ejemplo de los metadatos para la vistaOrderProductTotals. Para obtener una correlación de los tipos de datos de Java,consulte: “Correlaciones de tipo de datos” en la página 243. Como se ha indicadoanteriormente, las columnas no aparecen en ningún orden específico.IBM Cognos RTM,IBM CognosRTM,OrderProductTotals,Family,12,VCVarchar,20,129,0,10,1,,,,,,1,YES,,,,,

IBM Cognos RTM,IBM CognosRTM,OrderProductTotals,TargetMin,3,VCDecimal,15,129,2,10,1,,,,,,2,YES,,,,,

IBM Cognos RTM,IBM CognosRTM,OrderProductTotals,TargetMax,3,VCDecimal,15,129,2,10,1,,,,,,3,YES,,,,,

IBM Cognos RTM,IBM CognosRTM,OrderProductTotals,Target,3,VCDecimal,15,129,2,10,1,,,,,,4,YES,,,,,

IBM Cognos RTM,IBM CognosRTM,OrderProductTotals,Sales,3,VCDecimal,25,129,2,10,1,,,,,,5,YES,,,,,

IBM Cognos RTM,IBM CognosRTM,OrderProductTotals,PRODUCT,12,VCVarchar,50,129,0,10,1,,,,,,6,YES,,,,,

IBM Cognos RTM,IBM CognosRTM,OrderProductTotals,Target max,3,VCDecimal,15,129,2,10,1,,,,,,10,YES,,,,,

IBM Cognos RTM,IBM CognosRTM,OrderProductTotals,Qty,4,VCInteger,10,129,0,10,1,,,,,,11,YES,,,,,

IBM Cognos RTM,IBM CognosRTM,OrderProductTotals,Target min,3,VCDecimal,15,129,2,10,1,,,,,,14,YES,,,,,

Ejemplo: consultar metadatos de vistaEstos fragmentos de código muestran cómo consultar metadatos de vista.

En primer lugar se muestran los metadatos disponibles para las vistas, y acontinuación se muestra cómo buscar todas las vistas definidas en el sistema.

Consulte el ejemplo JDBCAccessor.PrintAllViewsMeta() para ver un listadocompleto de código./* Retrieve metadata about views.

*/

ResultSet rs;

ResultSetMetaData rmd;

// Uses ’null’ for the 3rd parameter to retrieve informationabout

//the entire system, not just a view.

DatabaseMetaData meta = connection.getMetaData();

meta = meta.getConnection().getMetaData();

rs = meta.getTables(null,null,null,new String[]{"VIEWS"});


for (int i=0;i<rmd.getColumnCount();i++) {

System.out.println(" ["+ rmd.getColumnName(i+1) +



"] Precision [" + Integer.toString(rmd.getPrecision(i+1))+ }


}

El resultado primero describe los metadatos disponibles:[TABLE_CAT] Type [12] Precision [255] Scale [0][TABLE_SCHEM] Type [12] Precision [255] Scale [0][TABLE_NAME] Type [12] Precision [255] Scale [0][TABLE_TYPE] Type [12] Precision [255] Scale [0][REMARKS] Type [12] Precision [255] Scale [0]

A continuación lista las vistas (nombres y tipos de tabla) definidas en el sistema:// Use the metadata to list all of the views in the system.

final int GT_TABLE_NAME = 3; // View name

final int GT_TABLE_TYPE = 4; // ’VIEWS’ or ’CUBES’


while (rs.next()) {

isEmpty = false;

System.out.println(" " + rs.getString(GT_TABLE_NAME)+ ", " +

rs.getString(GT_TABLE_TYPE));}

if (isEmpty) {

System.out.println(" *** No views are defined.***");

}

}

Los resultados serán similares al siguiente ejemplo:"30DAYORDERS", VIEWS"8WEEKORDERS", VIEWS"8WEEKORDERSAVG", VIEWSINVENTORYCHANGEDETAILS, VIEWSORDERCHANGEDETAILS, VIEWSORDERPRODUCTTOTALS, VIEWSORDERQTYDEMAND_DRILLBACK_VIEW, VIEWSORDERSALESGRANDTOTAL, VIEWSORDERTOTALS, VIEWSSUPPLIERALTERNATES, VIEWSVC_SYSTEM_VIEW, VIEWSVC_TASK_VIEW, VIEWS

Interfaces de cubo de Java Database ConnectivityLa API para cubos se basa en el borrador de la especificación olap4j versión 0.5.

La especificación olap4j no estaba totalmente desarrollada en el momento de laimplementación de esta interfaz, y esta interfaz no se adapta estrictamente laespecificación olap4j.

En las secciones siguientes se describe la API para acceder a los cubos. Para vertoda la API, consulte la documentación HTML de Javadoc para el paquetecom.cognos.obi.jdbc.api.


IOlapStatementEl IOlapStatement utiliza miembros de la interfaz para ejecutar consultas.

Éstos son:v executeOlapQuery

Ejecuta una consulta MDX.v executeOlapQueries

Ejecuta consultas MDX. Los conjuntos de resultados devueltos son coherentescon el evento; es decir, reflejan una instantánea hasta el mismo evento.

v executeCubeQuery

Ejecuta la consulta de cubo en el formato XML patentado del servidor IBMCognos Real-time Monitoring.

IOlapDatabaseMetadataProporciona información sobre las definiciones de cubos que se detallan en lainstalación de IBM Cognos Real-time Monitoring.

La interfaz IOlatDatabaseMetadata tiene los siguientes miembros:v getCubes

Recupera la descripción de un cubo.v getDimensions

Recupera un conjunto de resultados que describen las dimensiones dentro de uncubo concreto.

v getHierarchies

Recupera un conjunto de resultados que describen cada jerarquía dentro de unadimensión concreta.

v getLevels

Recupera un conjunto de resultados que describen cada nivel dentro de unajerarquía concreta.

v getMembers

Recupera un conjunto de resultados que describen los miembros dentro de unnivel concreto.

v getMemberChildren

Recupera un conjunto de resultados que describen los miembros hijo de unmiembro.

v getMeasures

Recupera un conjunto de resultados que describen cada medición dentro de uncubo concreto.

Ejemplo: consultar todos los cubosEstos fragmentos de código muestran cómo consultar metadatos de cubo.

En primer lugar se muestran los metadatos disponibles para los cubos, y acontinuación se muestra cómo buscar todos los cubos definidos en el sistema.

Consulte el ejemplo JDBCAccessor.PrintAllCubesMeta() para ver un listadocompleto de código.IOlapDatabaseMetaData meta = (IOlapDatabaseMetaData) connection.getMetaData();

rs = meta.getCubes(null, null, null);



for (int i=0;i<rmd.getColumnCount();i++) {

System.out.println(

" ["+ rmd.getColumnName(i+1) +


"] Precision [" + Integer.toString(rmd.getPrecision(i+1))+


}

El resultado primero describe los metadatos disponibles:TABLE_CAT] Type [12] Precision [255] Scale [0][TABLE_SCHEM] Type [12] Precision [255] Scale [0][TABLE_NAME] Type [12] Precision [255] Scale [0][TABLE_TYPE] Type [12] Precision [255] Scale [0][REMARKS] Type [12] Precision [255] Scale [0]

A continuación lista los cubos (nombres de tabla, tipos de tabla y hora de últimamodificación) definidos en el sistema:// Use the metadata to list all of the views in the system.

final int GT_TABLE_NAME = 3; // View name

final int GT_TABLE_TYPE = 4; // ’VIEWS’ or ’CUBES’

final int GT_REMARKS = 5; // If type is ’CUBES’,

// Remarks is the Lastmodification

// timestamp of the cube.

//Otherwise, it is empty.


while (rs.next()) {

isEmpty = false;

System.out.println(" " + rs.getString(GT_TABLE_NAME)+

", " + rs.getString(GT_TABLE_TYPE)

);

}

if (isEmpty) {

System.out.println(" *** No views are defined. ***");

}

Los resultados serán similares al siguiente ejemplo:ORDERCUBE, CUBES, 2007-11-07 13:00:07.107ORDERQTYDEMAND_DRILLBACK_CUBE, CUBES, 2007-11-07 13:00:11.2

Ejemplo: consultar los metadatos de un cuboEn este ejemplo se muestra cómo recuperar las dimensiones, jerarquías dedimensión, niveles de jerarquía, miembros de nivel y medidas de un cubo.ResultSet rs;

IOlapDatabaseMetaData meta = (IOlapDatabaseMetaData)connection.getMetaData();

rs = meta.getDimensions(CUBE_NAME);


System.out.println("*" + rs.getMetaData().getColumnName(1)+ ":");



while (rs.next()) {

isEmpty = false;

String ts = rs.getString(1);

System.out.print(" " + ts);


ResultSet hierarchies = meta.getHierarchies(rs.getString(1));

System.out.println(" *" +

hierarchies.getMetaData().getColumnName(1) + ":");

while (hierarchies.next()){

System.out.print(" ");

String hierarchy = hierarchies.getString(1);

System.out.print(hierarchy);


ResultSet levels = meta.getLevels(rs.getString(1),

hierarchies.getString(1));


levels.getMetaData().getColumnName(1) + ":");

while (levels.next()){


String level = levels.getString(1);

System.out.print(level);


ResultSet members = meta.getMembers(rs.getString(1),

hierarchies.getString(1),levels.getString(1));


members.getMetaData().getColumnName(1) +":");

while (members.next()){


String member = members.getString(1);

System.out.print(member);


}

}

}

}

rs = meta.getMeasures(CUBE_NAME);

System.out.println("*" + rs.getMetaData().getColumnName(1)+ ":");

while (rs.next()) {

isEmpty = false;

String ts = rs.getString(1);

System.out.print(" " + ts);


}

if (isEmpty) {

System.out.println("\n *** The cube was not found.");

}


Los resultados serán similares al siguiente ejemplo:*DIMENSION_NAME:

DateTime Dimensions

*HIERARCHY_NAME:

DEFAULT HIERARCHY

*LEVEL_NAME:

All DateTime Dimensions level

*MEMBER_NAME:

All DateTime Dimensions

Year

*MEMBER_NAME:

2003

2004

2005

Quarter

*MEMBER_NAME:

Q1

Q2

Q3

Q4

Month

*MEMBER_NAME:

January

February

...

November

December

Week Number

*MEMBER_NAME:

1

2

...

52

53

Day

*MEMBER_NAME:

Monday

Tuesday

...

Saturday

Sunday

Location Dimensions

*HIERARCHY_NAME:

"DEFAULT HIERARCHY"

*LEVEL_NAME:

All Location Dimensions level

*MEMBER_NAME:

All Location Dimensions


Region

*MEMBER_NAME:

All

Central

East

South

West

State

*MEMBER_NAME:

California

Florida

...

Rhode Island

Texas

City

*MEMBER_NAME:

Austin

Lodi

..

Tug Hollow

Wallaby Ranch

Product Dimensions

*HIERARCHY_NAME:

DEFAULT HIERARCHY

*LEVEL_NAME:

All Product Dimensions

level

*MEMBER_NAME:

All Product Dimensions

Family

*MEMBER_NAME:

Hardware

Lumber

Tape

Product

*MEMBER_NAME:

Chip board

Duct tape

...

Studs

Washers

*MEASURE_NAME:

AverageOrderSales

TotalOrderSales


Ejemplo: recuperar los miembros hijo de un miembro de nivelen un cubo

Estos fragmentos de código muestran cómo recuperar los miembros hijo de unmiembro de nivel en un cubo.

En este ejemplo, el miembro de nivel se especifica con sintaxis de MDX.

Consulte el ejemplo JDBCAccessor.testGetMemberChildren() para ver un listadocompleto de código.ResultSet rs;

IOlapDatabaseMetaData meta = (IOlapDatabaseMetaData)connection.getMetaData();

String member = "[store_dimension].[All_store_dimension_level].[All_store_dimension].[USA]";//amember name specified in MDX syntax.

rs = meta.getMemberChildren(member);

int columnCount = rs.getMetaData().getColumnCount();


System.out.print(rs.getMetaData().getColumnName(i+1));

System.out.print(’ ’);

}


while (rs.next()) {





System.out.print( (rs.wasNull() ? "NULL" : ts + " "));

}


}

Los resultados serán similares al siguiente ejemplo:MEMBER_CHILDRENRow: Hinges

Row: Lag bolts

Row: Nails

Row: Nuts

Row: Screws

Row: Washers

Ejemplo: consultar datos de cubo utilizando XML de consultade cubo

Estos fragmentos de código muestran cómo recuperar los datos del cubo utilizandoXML de consulta de cubo, que es un formato propietario para el servidor IBMCognos Real-time Monitoring.

Consulte el ejemplo JDBCAccessor.testCubeQuery() para ver un listado completode código.ResultSet rs; // Table to hold the query results.



String s = "<queryCube xsi:schemaLocation=\"http://obi.cognos.com/ ../xsd/queryCube.xsd\"xmlns=\"http://obi.cognos.com/4\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\">"+

"<cube xml:space=\"preserve\">OrderCube</cube>"+

"<measures>" +

"<list>" +

"<name xml:space=\"preserve\">TotalOrderSales</name>"+

"</list>" +

"<list>" +

"<name xml:space=\"preserve\">AverageOrderSales</name>"+

"</list>" +

"</measures>" +

"<dimensionLevels>" +

"<selectedLevelsAndFilters>" +

"<selectedLevels>" +

"<list>" +

"<dimensionName xml:space=\"preserve\">\"Location Dimensions\"</dimensionName>"+

"<memberName xml:space=\"preserve\">Region</memberName>"+

"<selected xml:space=\"preserve\">true</selected>"+

"</list>" +

"</selectedLevels>" +

"</selectedLevelsAndFilters>" +

"</dimensionLevels>" +

"</queryCube>";

rs = (ResultSet)((IOlapStatement)stmt).executeCubeQuery(s);




System.out.print(’ ’);

}


while (rs.next()) {





System.out.print( (rs.wasNull() ? "NULL ":ts + " "));

}


}

}

Los resultados serán similares a lo siguiente:"LOCATION DIMENSIONS".REGION ORDERCUBE.TOTALORDERSALES ORDERCUBE.AVERAGEORDERSALES


Row: Central 286425.00 40917.85

Row: East 107700.00 53850.00

Row: West 986450.00 54802.77

Ejemplo: recuperación de datos de un cubo medianteconsultas MDX

Estos fragmentos de código muestran cómo recuperar los datos de cubo medianteconsultas MDX.

Consulte el ejemplo JDBCAccessor.testMDXQuery() para ver un listado completode código.ResultSet rs; // Table to hold the queryresults.


String s = "SELECT Measures.[TotalOrderSales] ON ROWS,[Location Dimensions].[Region].[West] ON COLUMNS FROM [OrderCube]where [Product Dimensions].[Family].[Hardware]";

String s2 = "SELECT Measures.[TotalOrderSales] ON ROWS,[Location Dimensions].[Region].[West].children ON COLUMNS FROM [OrderCube]where [Product Dimensions].[Family].[Hardware]";

IOlapResultSet[] rss = ((IOlapStatement)stmt).executeOlapQueries(newString[]{s,s2});

for (int j = 0; j < 2; j++)

{

System.out.println("mdx" + j + ":");

rs = rss[j];





}


while (rs.next()){





System.out.print( (rs.wasNull() ? "NULL " :ts + " "));

}


}

}

Los resultados serán similares al siguiente ejemplo:mdx0:"LOCATION DIMENSIONS".REGION ORDERCUBE.TOTALORDERSALESRow: West 610650.00mdx1:"LOCATION DIMENSIONS".REGION "LOCATION DIMENSIONS".STATE ORDERCUBE.TOTALORDERSALESRow: West California 428750.00Row: West Nevada 181900.00


Capítulo 20. Tablas de consulta

Las tablas de consulta aumentan el procesamiento de información de orígenes deinformación proporcionando información adicional sobre el evento.

Las tablas de consulta incluyen la información empresarial almacenada en las basesde datos, los almacenes de datos, o la que proporcionan los servicios web. Paraobtener más información, consulte: Capítulo 37, “servicios web”, en la página 375.Las tablas de consulta reciben datos de agentes que se comunican con orígenes dela información. Para obtener más información, consulte: Capítulo 4, “Agentes”, enla página 23. Cuando define una tabla de consulta, también indica al agente cómoidentificar la información del origen.

Funcionamiento de las tablas de consultaCuando una vista empresarial requiere información de tabla de consulta, recuperadicha información en función de los datos que ya existen en la vista.

Por ejemplo, una vista que está procesando una orden de compra puede recibir unnúmero de identificación de producto junto con los datos del evento. Si la vistatambién requiere los proveedores de ese producto, recuperará los nombres de losproveedores de una tabla de consulta que contenga los nombres que coinciden conel ID. En la definición de la vista, una cláusula WHERE podría unir la tabla deconsulta con el evento, como se muestra en el siguiente ejemplo:WHERE event.product_id = lookuptable.suppliers_of_product_id

Cuando la vista realiza esta unión, pasa el ID del evento a la tabla de consulta. Silos datos del proveedor coincidente ya están en la memoria caché de la tabla deconsulta, la tabla utiliza estos datos y los pasa a la vista empresarial. Si los datosaún no están en la memoria, el ID se pasa a un agente (ya sea como consulta SQLo como valor para un procedimiento almacenado), que envía los datos al servicioDBMS o web para su procesamiento. A continuación, el resultado de la consulta secarga en la tabla de consulta y, posteriormente, en la vista empresarial.

El origen de la información pueden ser bases de datos a las que se accedemediante un JDBC (consulte: Capítulo 18, “Java Database Connectivity”, en lapágina 225

AgenteFlujo de datos

Tabla de consulta

Vista empresarial Datos paraconsulta

Resultado

Caché de la table de consulta Consulta para la tabla de consulta

La tabla de consulta contiene datos que coinciden conalgún ID de la vista. Los datos provienen de una memoriacaché, que procede originalmente de algún origen externo,como un DMS.

Origen de lainformación

Figura 23. Funcionamiento de las tablas de consulta


página 225) o aplicaciones empresariales a las que se accede mediante serviciosweb (consulte: Capítulo 37, “servicios web”, en la página 375). Un archivo de textotambién puede ser un origen de información. Para obtener detalles sobre estostipos de orígenes, consulte: “Tablas Java Database Connectivity” en la página 225,“Tablas de consulta para servicios web” en la página 379, o Capítulo 13, “Archivossin formato”, en la página 103.

Creación de tablas de consultaCada tabla de consulta tiene un nombre, una descripción, un atributo de estado yun agente.

Consejo:

Especifique índices para las tablas de consulta en las columnas de unión utilizadaspor las vistas o dimensiones. Si no especifica índices, para buscar el valor correctopara la unión debe realizar una búsqueda en todas las filas de la tabla de consulta.La indexación aumenta la velocidad con la que se localiza la fila que contiene elvalor correcto.

Utilice el almacenamiento de datos en caché con prerrecuperación para las tablasde consulta JDBC de modo que el servidor no tenga que conectarse a la base dedatos cuando se produzca cada evento. EN lugar de ello, los datos se buscan enmasa a intervalos periódicos. No obstante, debe tener en cuenta que el uso delalmacenamiento de datos en caché con prerrecuperación puede suponer un mayoruso de memoria.

Estos atributos se definen en la tabla siguiente.

Tabla 76. Atributos de la tabla de consulta


Nombre Identifica la tabla y es el nombre al que acceden lasvistas empresariales que dependen de esta tabla(consulte: Capítulo 36, “Vistas”, en la página 361).

El nombre debe ser exclusivo entre todos los objetosde la misma carpeta (incluidos los objetos del panelde control y los paneles de control). La carpeta raíztambién contiene objetos globales como usuarios yroles, y actividades empresariales. Para obtener másinformación, consulte: “Espacio de nombres deobjeto” en la página 277.

Descripción (Opcional) Descripción de la tabla.

Estado Si el objeto está habilitado (es capaz de recibir y pasardatos) o inhabilitado (no recibe ni pasa datos).

Guardar en La carpeta en la que ha de almacenarse la tabla deconsulta. La carpeta predeterminada es Carpetaspúblicas. Para seleccionar una carpeta, pulse el botónSeleccionar carpeta.

Agente El agente que recibe la información para la tabla deconsulta y que pasa los datos al objeto de tabla deconsulta o de flujos de datos. Para obtenerinformación acerca de los tipos de agentes, consulte:Capítulo 4, “Agentes”, en la página 23.


Tabla 76. Atributos de la tabla de consulta (continuación)


Deshabilitar tabla de consultadespués de este número de erroresconsecutivos

Número de errores consecutivos recibidos del sistemaantes de que se inhabilite la tabla de consulta. Unavez inhabilitadas, las tablas de consulta deben volvera habilitarse manualmente. El valor predeterminadoes 5.

Para obtener más información acerca de los tipos de orígenes, consulte el ejemplosiguiente:v Capítulo 18, “Java Database Connectivity”, en la página 225v Capítulo 37, “servicios web”, en la página 375v Capítulo 29, “Salesforce”, en la página 323v Capítulo 12, “Sistema de archivos de Cognos Real-time Monitoring”, en la

página 97

Antes de empezar

Antes de crear una tabla de consulta, debe disponer de permisos de creación paratablas (consulte: Capítulo 23, “Permisos”, en la página 291 y “Cómo otorgarpermiso para crear objetos” en la página 294) y de permiso de acceso de sólolectura para el agente que recupera la información para la tabla de consulta.

Procedimiento1. En IBM Cognos Real-time Monitoring Workbench, pulse la pestaña Workbench.2. Pulse Actividades.3. Pulse Crear nuevo > Tabla de consulta.4. Seleccione el tipo de origen.5. Cumplimente los campos de la ventana Nueva tabla de consulta.6. Guarde la tabla como habilitada.

Edición de tablas de consultaLa edición de los atributos de una tabla de consulta da lugar a que el objeto pierdael estado, y posiblemente invalida vistas dependientes.

Por ejemplo, si elimina una columna, cualquier vista o regla que haga referencia aesa columna dejará de ser válida. (Sin embargo, si vuelve a definir la columna enla tabla, las vistas dependientes volverán a validarse automáticamente.)

Antes de editar una tabla de consulta, debe disponer de Capítulo 23, “Permisos”,en la página 291 de lectura y escritura para las tablas (consulte: “Permisos deacceso” en la página 291) y de permiso de acceso de sólo lectura para el agenteque proporciona información para la tabla.

Procedimiento1. En IBM Cognos Real-time Monitoring Workbench, pulse la pestaña Workbench.2. Seleccione la tabla de consulta en el panel Objetos de Workbench o en el panel

de detalles.

Capítulo 20. Tablas de consulta 263

3. Si ha seleccionado la tabla de consulta en el panel de detalles, pulseActividades y seleccione Editar en el menú desplegable. Si ha seleccionado latabla de consulta en el panel Objetos de Workbench, pulse en el botón Editar.

4. Cambie las definiciones en el formulario Configurar tabla de consulta. Cadatipo tiene atributos específicos propios. Si desea ver más información, consultelos temas siguientes:v Capítulo 18, “Java Database Connectivity”, en la página 225v Capítulo 37, “servicios web”, en la página 375v Capítulo 13, “Archivos sin formato”, en la página 103

5. Guarde la tabla como habilitada.

Limitaciones de columna en consultas de tablas de consultaLos datos de una tabla de consulta se pueden recuperar sin limitaciones de unorigen de consulta de JDBC. Sin embargo, se aplican algunas limitaciones cuandose recuperan datos de una tabla de consulta de un origen de procedimientosalmacenados de JDBC o de servicio web.

Estas limitaciones incluyen:v Cuando se haga referencia a la columna de la tabla de consulta como parte de

una consulta, en algún lugar de la cláusula WHERE o FROM deberá apareceruna expresión de igualdad y, a continuación, aparecer sólo como un predicadoatómico (sin más operadores en el mismo lado del signo igual). Por ejemplo, sepermite lo siguiente:WHERE lookup_column =10*event_column

Pero no se permite lo siguiente, porque el predicado del lado izquierdo, quecontiene la columna de la tabla de consulta, es una expresión que incluye unoperador (/):WHERE lookup_column/10 = event_column

v La referencia atómica necesaria no puede aparecer en una expresión disyuntiva(OR). La siguiente expresión es incorrecta:WHERE (lookup_column= event_column OR A > B)

Sin embargo, puede aparecer en una expresión conjuntiva (AND):WHERE (lookup_column = event_column AND A > B)

v Cuando la consulta contenga al menos una referencia de igualdad, podrá utilizarla columna con cualquier otro formato. Por ejemplo, se permiten las dosconsultas siguientes:WHERE (lookup_column =event_column AND

lookup_column/10 = other_event_column)

WHERE ((lookup_column = event_column AND

lookup_column >= other_event_column) OR

(A > B))

Sin embargo, la siguiente expresión es incorrecta porque la consulta no contieneninguna referencia de igualdad:WHERE lookup_column >= event_column

v La expresión de igualdad necesaria no puede hacer referencia a otra columna decontexto de la misma tabla. Por ejemplo:t1.lookup_column= t1.other_lookup_column


v Sin embargo, la expresión de igualdad puede hacer referencia a una columna decontexto de otra tabla. Por ejemplo:t1.lookup_column= t2.other_lookup_column

Limitaciones de Sybase

Al realizar una consulta a la base de datos Sybase, tenga en cuenta estaslimitaciones:v Todos los nombres, incluidos los de tablas y columnas, distinguen entre

mayúsculas y minúsculas.v Las consultas sólo pueden tener el formato de tabla SELECT * FROM. No puede

incluir ninguna cláusula SELECT. Para filtrar los resultados, cárguelos en unavista empresarial y, a continuación, filtre la vista.

Almacenamiento de consultas de tabla de consulta en la memoriacaché

El almacenamiento en memoria caché permite almacenar en la memoria losresultados de consultas de tabla de consulta.

Las solicitudes posteriores que se realicen de la misma información se recuperaránde la memoria, sin que haya que realizar una consulta redundante que afectaría alrendimiento del DBMS. Cuando el almacenamiento de datos esté activo y una vistasolicite datos de una tabla de consulta, se buscará primero en la memoria caché. Silos datos que desea no se encuentran en la memoria caché, IBM Cognos Real-timeMonitoring emite una consulta para la base de datos si el almacenamiento en lamemoria caché por solicitud está habilitado. Sin embargo, si el almacenamiento dedatos en memoria caché de prerrecuperación está habilitado, Real-time Monitoringemite una consulta para la memoria caché de prerrecuperación.

Para obtener más información sobre los métodos de almacenamiento de datos enmemoria caché, consulte: “Almacenamiento de datos en caché por solicitud” en lapágina 266 y “Almacenamiento de datos en caché con prerrecuperación” en lapágina 266.

La memoria caché de tabla de consulta tiene estos parámetros:v Datos en memoria caché para esta tabla de consulta

Especifica si se deben guardar o no en la memoria caché de consultas recienteslos resultados de la consulta en la tabla de consulta. Este parámetro debe estarestablecido para que se puedan habilitar el resto de los parámetros. Cuandoselecciona este parámetro también debe añadir al menos una planificación deinvalidación.

v Habilitar prerrecuperación

Habilita o inhabilita la prerrecuperación de datos de la tabla de consulta. Estaopción almacena en la memoria caché toda la tabla de consulta externa delorigen de datos externo, convirtiéndose en una alternativa al origen de consultasexterno.

v Número de conjuntos de resultados para guardar en memoria caché

Número de resultados de la consulta que se van a almacenar en la memoriacaché. Cada conjunto de resultados puede contener una o varias filas de datosde tabla de consulta relacionadas con el evento.

v Planificación de invalidación


Identifica cuándo se debe invalidar la memoria caché y descartar toda lainformación que hay actualmente en la memoria caché, por ejemplo a las 06:00de cada lunes.

Si selecciona alguna opción de almacenamiento de datos en memoria caché, elalmacenamiento en memoria caché por solicitud está activo. Por ejemplo, siselecciona En la memoria o Habilitar prerrecuperación, dispone dealmacenamiento en memoria caché por solicitud y de almacenamiento de datos encaché con prerrecuperación.

Almacenamiento de datos en caché por solicitudCon el almacenamiento de datos en caché por solicitud, se crea una memoria cachéde consultas recientes que mantiene los resultados según el criterio de menosutilizados recientemente.

Esta memoria caché realiza un seguimiento de cuándo se solicitó por última vezcada conjunto de resultados. Cuando la memoria caché está llena, registra las filasa las que se ha accedido más recientemente y descarta las que no han presentadoaccesos en un periodo más largo de tiempo. Si se solicitan datos que no seencuentran en la memoria caché de consultas recientes, los datos se recuperan delorigen de datos externo.

El almacenamiento de datos en caché por solicitud se produce cuando se seleccionala opción Datos de memoria caché para esta tabla de consulta en la pestañaAlmacenamiento de datos en memoria caché y no se selecciona la opciónHabilitar prerrecuperación para orígenes JDBC o de servicios web.

Las filas que contengan datos solicitados frecuentemente se conservan en lamemoria caché de consultas recientes el mayor tiempo posible con el fin de reducirel impacto en la base de datos. Sin embargo, si la información puede cambiar amenudo, defina una planificación de invalidación para aplicar los cambios einvalidar la memoria caché.

Cuando se produce una invalidación planificada, la memoria caché de consultasrecientes se borra y actualiza en consultas posteriores. Si los datos de la tabla deconsulta no cambian con frecuencia, resultará más útil invalidar la memoria cachéde consultas recientes con menos frecuencia. Por ejemplo, si la tabla de consulta esbastante estática, es posible que desee invalidar la memoria caché de formasemanal o mensual. Sin embargo, si la base de datos de la tabla de consulta seactualiza por las noches, puede que desee invalidar la memoria caché de consultasrecientes también por las noches para asegurarse de que cuenta con los datos másactuales.

Con el uso del almacenamiento en memoria caché por solicitud se obtiene unmayor rendimiento que si no se utiliza ningún tipo de almacenamiento enmemoria caché. Sin embargo, puede que consiga aumentar aún más el rendimientoutilizando el almacenamiento de datos en memoria caché con prerrecuperación.

Almacenamiento de datos en caché con prerrecuperaciónCuando se habilita la memoria caché de prerrecuperación, se almacena en lamemoria caché toda la tabla de consulta externa del origen de datos externo y seconvierte en una alternativa al origen de consultas externo, que se conocehabitualmente como almacenamiento de datos en memoria caché por solicitud.


Sin embargo, si se solicitan datos que no se encuentran en la memoria caché porsolicitud, los datos se recuperan de la memoria caché de prerrecuperación en vezde del origen de datos externo.

Cuando se produce una invalidación, según la planificación de invalidaciónespecificada, la memoria caché por solicitud se borra, y se envía una consulta alorigen de datos externo para que actualice la copia en memoria de la tabla deconsulta. La memoria caché por solicitud se actualiza a partir de la memoria cachéde prerrecuperación en las consultas posteriores.

Para obtener información acerca de las funciones de la memoria caché derecuperación, consulte: “Almacenamiento de datos en caché por solicitud” en lapágina 266.

Al habilitar la memoria caché de datos con prerrecuperación, tenga en cuenta lossiguientes efectos:v Se utiliza más memoria porque la información del origen de datos externo se

guarda en la memoria, y se crea un índice para cada columna.v La memoria caché de prerrecuperación sólo se actualiza durante las

invalidaciones planificadas. Si los datos no se encuentran en la memoria cachéde prerrecuperación, no se devuelven datos. Las actualizaciones que se realicenen el origen de datos externo no se reflejarán en la memoria caché deprerrecuperación hasta que se produzca la siguiente invalidación planificada.

La memoria caché de prerrecuperación realizará hasta cinco intentos de renovacióndurante la planificación de invalidación. Si no puede renovarse con el origen dedatos externo, se utilizará la memoria caché de consultas recientes hasta que seproduzca la siguiente renovación planificada.

Almacenamiento en memoria caché de almacén JavaDatabase Connectivity

Puede especificar que los datos del archivo sin formato se lean y se almacenen enla memoria caché mediante el agente JDBC.

El mecanismo de recuperación y almacenamiento utiliza dos tablas para almacenarlos datos.

El mecanismo de recuperación y almacenamiento utiliza sólo una de las dos tablascada vez para las consultas. La tabla a la que no accede el sistema se purga y sevuelve a cargar según la planificación de invalidación. Una vez que este archivo seha cargado de nuevo con datos del archivo sin formato, las consultas se redirigen ala tabla que acaba de actualizarse, y la tabla anterior se purga y se actualiza en lasiguiente invalidación de la planificación. Por ejemplo, la tabla A se está utilizandoactualmente para las consultas, y la invalidación está prevista para las 12 delmediodía. La tabla B se purga y se vuelve a cargar las 12 del mediodía, y tras estolas consultas se redirigen a la tabla B. En la siguiente invalidación programada, latabla A se purga y se vuelve a cargar, y las consultas se redirigen a ella. La tabla Bespera a la siguiente invalidación planificada.

Especifique que el agente JDBC lea los datos del archivo sin formato y losalmacene en la memoria caché, seleccionando Almacenamiento de JDBC comotipo de almacenamiento de datos en memoria caché.



Capítulo 21. Objetos en Cognos Real-time MonitoringWorkbench

Cada objeto tiene un nombre, una descripción opcional y un estado que determinasi puede funcionar con datos específicos. Cada objeto también tiene propiedadesque definen el comportamiento del objeto.

Estados de objetosCada objeto posee uno de los cuatro estados posibles, que determina su capacidadde funcionamiento.

Los estados se describen en la tabla siguiente:

Tabla 77. Estados de objeto

Icono Descripción

Habilitado

El objeto está aceptando y procesando datos nuevos. Sólo puede habilitarobjetos válidos que no dependan de objetos inhabilitados. Cuando se habilitaun objeto, se puede habilitar únicamente ese objeto, o bien ese objeto y todoslos que dependan de él. Cuando se habilita un objeto y sus dependientes, losobjetos dependientes deben ser válidos. Si alguno de los objetos dependientesno es válido, no se habilita ningún objeto.

Inhabilitado

El objeto no acepta datos nuevos. Inhabilitar un objeto no afecta a ladefinición o a la existencia de este objeto. En lugar de ello, simplemente evitaque los datos nuevos lleguen al objeto y a todos los que dependan de él. Porejemplo, inhabilitar una vista también inhabilita todas las reglas quesupervisan la vista, y también inhabilita todos los reportlets y las alertasasociados.

Dependencias inhabilitadas

El objeto no acepta datos nuevos porque un objeto del que depende estáinhabilitado. Si se habilita el objeto al que hace referencia, también se habilitaeste objeto.

No válido

El objeto tiene una referencia que no es válida. Por ejemplo, una vista hacereferencia a una columna de otra vista, pero esta columna ya no existe en lavista a la que se hace referencia. Un objeto puede ser no válido porque unobjeto al que hace referencia no existe, o porque un atributo del objeto nocoincide con los requisitos del dependiente. Por ejemplo, puede que un tipode datos no coincida o que falte un nombre de columna. Un objeto no válidotambién invalida todos los objetos que dependen del mismo. Esto ocurrecuando se suprime un objeto que tiene dependencias o se cambia ladefinición de un objeto.

Cuando se visualiza una lista de objetos, se puede ver el estado de validez y elestado de habilitación de cada objeto. Puede seleccionar un objeto de la lista yhabilitarlo mediante el menú Actividades.


Nombres de objetoTodos los nombres de objeto deben ser identificadores regulares o identificadoresdelimitados.

Un identificador regular debe empezar por una letra de a-z o A-Z, y todos loscaracteres subsiguientes pueden ser el carácter de subrayado (_) o cualquiercarácter de a-z, A-Z o 0-9. Un identificador regular no puede ser una palabrareservada.

Un identificador delimitado debe empezar y terminar con unas comillas dobles (").El cuerpo de un identificador delimitado no puede estar vacío y puede contenercualquier carácter de lenguaje SQL: caracteres de identificador regular; guión bajo(_); espacio ( ), porcentaje (%); ampersand (&); comillas simples (’); paréntesisizquierdo ((); paréntesis derecho ()); asterisco (*); signo más (+); coma (,); signomenos (-), barra inclinada (/); dos puntos (:); punto y coma (;); operador "es iguala" (=); signo de interrogación (?); barra vertical (|); o comillas dobles ("")(escapadas con otras comillas dobles).

Los nombres de los cubos no pueden contener puntos (.).

Todos los nombres deben ser exclusivos entre todos los objetos de la mismacarpeta (incluidos los objetos del panel de control y los paneles de control). Lacarpeta raíz también contiene objetos globales, como usuarios, roles y actividadesempresariales. Para obtener más información, consulte: “Espacio de nombres deobjeto” en la página 277. Los nombres no pueden ser idénticos a las palabrasreservadas. Por ejemplo, no se puede tener una vista llamada "select" por elidentificador regular, pero sí se puede tener una vista delimitada llamada "select".

Palabras reservadasTodos los identificadores que comienzan por VC_ son nombres reservados delsistema y no se pueden utilizar. Asimismo, todas las palabras reservadas delSQL-99 estándar están reservadas en C-SQL.

En la siguiente tabla se enumeran las palabras reservadas de IBM CognosReal-time Monitoring.

Tabla 78. Palabras reservadas

Palabra reservada

abs

absolute

acked

action

add

all

allocate

alter

and

any

are

as


Tabla 78. Palabras reservadas (continuación)

Palabra reservada

asc

assertion

at

authorization

avg

begin

between

bit

bit_length

boolean

both

by

cascade

cascaded

case

cast

catalog

ceil

char

char_length

character

character_length

check

close

coalesce

collate

collation

column

commit

concat

connect

connection

constraint

constraints

continue

convert

corresponding

count

create

cross

Capítulo 21. Objetos en Cognos Real-time Monitoring Workbench 271


Palabra reservada

current

current_date

current_time

current_timestamp

current_user

cursor

date

date_add

date_diff

day

deallocate

dec

decimal

declare

default

deferrable

deferred

delete

desc

describe

descriptor

diagnostics

disconnect

distinct

domain

double

drop

else

end

end-exec

escape

event

except

exception

exec

execute

exists

exp

external

extract



Palabra reservada

false

fetch

first

float

floor

for

foreign

found

from

full

get

global

go

goto

grant

greatest

group

having

hour

identity

immediate

in

indicator

initially

inner

input

insensitive

insert

int

integer

intersect

interval

into

is

is_raised

isolation

join

key

language

last



Palabra reservada

last_day

leading

least

left

level

like

local

log

lower

lowered

lpad

ltrim

match

max

min

minute

mod

module

month

mov_avg

mov_count

mov_max

mov_min

mov_ntile

mov_rank

mov_ratio_to_report

mov_std_deviation

mov_sum

mov_variance

names

national

natural

nchar

next

no

not

ntile

null

nullif

numeric



Palabra reservada

octet_length

of

on

only

open

option

or

order

outer

output

overlaps

pad

partial

position

power

precision

prepare

preserve

prev

primary

prior

prior_value

privileges

procedure

public

raised

rank

ratio_to_report

read

real

references

relative

restrict

revoke

right

rollback

round

rows

rpad

rtrim



Palabra reservada

schema

scroll

second

section

select

session

session_user

set

sign

size

smallint

some

space

sql

sqlcode

sqlerror

sqlstate

sqrt

std_deviation

substr

substring

sum

system_user

table

temporary

then

time

timestamp

timestamp_diff

timezone_hour

timezone_minute

to

to_char

to_date

trailing

transaction

translate

translation

trim

true



Palabra reservada

trunc

union

unique

unknown

update

upper

usage

user

using

value

values

varchar

variance

varying

view

when

whenever

where

with

work

write

year

zone

Espacio de nombres de objetoEl espacio de nombres controla cómo se llaman los objetos.

Generalmente, los nombres de objeto deben ser exclusivos entre los demás objetosdel mismo tiempo dentro del mismo contenedor. Sin embargo, a continuación seincluyen algunas excepciones:v Alertas, reglas y reportlets pueden compartir nombres dentro del escenario que

los contiene. Se puede usar el mismo nombre para una alerta, una regla y unreportlet dentro de un escenario. Además, cada objeto dentro de un escenariopuede compartir el mismo nombre que un objeto del mismo tipo en otroescenario.

v Los perfiles deben ser exclusivos dentro de un único usuario. Los nombres deperfil pueden ser compartidos por varios usuarios.

v Las vistas, los flujos de datos, las tablas de consulta y otros objetos similares nopueden compartir el mismo nombre. Sus nombres deben ser exclusivos dentrode la clase de tablas. Consulte el siguiente esquema para obtener más detalles.

v Los agentes deben ser exclusivos dentro de la clase de agentes.v Los usuarios y las actividades empresariales no pueden compartir el mismo

nombre. Sus nombres deben ser exclusivos dentro de la clase de contenedores.


Asimismo, los usuarios y las carpetas no pueden compartir el mismo nombreporque existen dentro del mismo espacio de nombres. El siguiente esquemaresume las restricciones del espacio de nombres./containers

/Business activities Unique among /containers

/Scenarios

/Alerts

/Rules

/Reportlets

/Users and Roles Unique among /containers

/E-mail profiles Unique within a user

/RTD (Excel) profiles Unique within a user

/tables

/Data streams Unique among /tables

/Lookup tables Unique among /tables

/Consolidated data streams Unique among /tables

/Cube Unique among /tables

/Dimensions Unique among /tables

/Views Unique among /tables

/agents

/Flat (text) files Unique among /agents

/SOAP (Web services) Unique among /agents

/JMS Unique among /agents

/JDBC Unique among /agents

/Rendezvous (TIBCO) Unique among /agents

/External actions (processes)

/Join relationships

Exportación selectiva de objetosPuede exportar objetos seleccionados. Este método resulta útil cuando se exportanobjetos de un entorno de desarrollo a un entorno de producción.

Puede exportar un único objeto, un objeto y sus dependencias, un objeto y susrequisitos o un objeto y sus requisitos y dependencias. Las dependencias de unobjeto son otros objetos que dependen del objeto seleccionado para ser válidos. Losrequisitos de un objeto son los objetos que el objeto que ha seleccionado necesitaque sean válidos.

En el diagrama siguiente se muestran las relaciones entre tres paneles de control,varios objetos de panel de control, tres vistas, dos cubos, una dimensión, tres tablasde consulta, tres flujos de datos y tres agentes. En el diagrama, las dependenciasde la Vista 1 son Panel de control 1, Objeto de panel de control 1, Cubo 1 y Objetode panel de control 2. Los requisitos para la Vista 1 son Flujo de datos 1 y Agente1. Las flechas entre objetos indican la dirección de la dependencia.


En esta sección se describen los siguientes aspectos de la exportación selectiva:v “Ejemplo: exportar objetos con dependencias”v “Ejemplo: exportar objetos con requisitos” en la página 281v “Ejemplo: exportar objetos con requisitos y dependencias” en la página 282v “Exportación de objetos seleccionados” en la página 284

Para obtener información sobre la exportación e importación de metadatos deCognos Real-time Monitoring, consulte la publicación IBM Cognos Real-timeMonitoring Workbench Guía del usuario.

Ejemplo: exportar objetos con dependenciasPuede exportar un objeto con sus dependencias. En algunos casos, es posible quelos objetos incluidos en este tipo de exportación dejen de ser válidos una vez quelos ha importado debido a que la exportación no incluía los requisitos de lasdependencias.

El diagrama siguiente muestra dos escenarios de exportación con dependencias.

Agente 1

Objeto panel de control 1

Flujo de datos 1

Dimensión1

Cubo 2

Tabla deconsulta 1

Vista 1


Vista 2

Agente 2

Flujo de datos 2

Flujo de datos 3

Agente 3

Cubo 1


Vista 3




Panel de control 3Panel de control 1 Panel de control 2

Tabla deconsulta 3

Tabla deconsulta 2

Figura 24. Relación entre varios objetos


Escenario 1

Exporta el Flujo de datos 1 con sus dependencias. Se incluyen o se excluyen de laexportación los siguientes objetos:v Se exportan la Vista 1, Objeto del panel de control 1, Cubo 1 y Objeto del panel

de control 2.v No se exportan la Dimensión 1, la Tabla de consulta 1 ni el Agente 1.

Estos objetos son requisitos para el Cubo 1. El sistema sólo atraviesa las rutas deestos objetos. A consecuencia de esto, el Cubo 1 no es válido después de laimportación, porque no se han incluido sus requisitos.

v Se exportan el Objeto del panel de control 1 y el Objeto del panel de control 2.v El Panel de control 1 no se exporta, aunque contenga el Objeto del panel de

control 1.

Escenario 2

Exporta el Agente 2 con sus dependencias. Se incluyen o se excluyen de laexportación los siguientes objetos:v Se exportan los objetos del panel de control del Panel de control 2 y Panel de

control 3, pero no los paneles de control.v Se exportan la Vista 2 y la Vista 3.

Agente 1

Objeto pe al nedpe controd 1

Fdujo pepl tos 1

Dimensión1

Cubo 2

Tl bdl peconsudtl 1

Vistl 1


Vistl 2

Agente 2

Fdujo pepl tos 2

Fdujo pepl tos 3

Agente 3

Cubo 1


Vistl 3




Pl ned pe controd 3Pl ned pe controd 1 Pl ned pe controd 2

Tl bdl peconsudtl 3

Tl bdl peconsudtl 2

Figura 25. Dos escenarios de exportación con dependencias


v No se exportan el Flujo de datos 2 ni el Agente 1, que son requisitos para laVista 2.Con ello, la Vista 2 deja de ser válida después de la importación.

v No se exportan el Agente 3 ni la Tabla de consulta 3, que son requisitos para laVista 3.Con ello, la Vista 3 deja de ser válida después de la importación.

Ejemplo: exportar objetos con requisitosPuede exportar un objeto con sus requisitos.

En el siguiente diagrama se muestran algunos ejemplos de este tipo deexportación.

Al exportar la Vista 1 con sus requisitos, también se exportan el Flujo de datos 1 yel Agente 1.

Al exportar el Cubo 2 con sus requisitos, también se exportan: Dimensión, Tabla deconsulta 1, Agente 1, Vista 2, Flujo de datos 2, Tabla de consulta 2 y Agente 2.

Al exportar el Panel de control 3 con sus requisitos, también se exportan el Objetodel panel de control 4, el Objeto del panel de control 5 y el Objeto del panel de

Agente 1


Fdujo pepl tos 1

Dimensión1

Cubo 2

Tl bdl peconsudtl 1

Vistl 1


Vistl 2

Agente 2

Fdujo pepl tos 2

Fdujo pepl tos 3

Agente 3

Cubo 1


Vistl 3





Tl bdl peconsudtl 3

Tl bdl peconsudtl 2

Figura 26. Ejemplos de objetos exportados con requisitos


control 6. Además, se exportan los requisitos de los tres objetos del panel decontrol, Vista 3, Flujo de datos 3, Tabla de consulta 3, Agente 2 y Agente 3.

Ejemplo: exportar objetos con requisitos y dependenciasEn algunos casos, puede que desee exportar tanto las dependencias como losrequisitos de un objeto.

En los escenarios siguientes se explican las implicaciones de este tipo deexportación.

Escenario 1

Desea exportar la Dimensión 1 con sus dependencias y requisitos, como se muestraen el siguiente diagrama.

Se incluyen o se excluyen de la exportación los siguientes objetos:v Se exportan el Objeto del panel de control 2, Objeto del panel de control 3, Cubo

1 y Cubo 2.Son las dependencias de la Dimensión 1.

v Se exportan la Tabla de consulta 1 y el Agente 1.Son los requisitos de la Dimensión 1.

v No se exportan la Vista 1 ni la Vista 2.

Agente 1


Fdujo pepl tos 1

Dimensión1

Cubo 2

Tl bdl peconsudtl 1

Vistl 1


Vistl 2

Agente 2

Fdujo pepl tos 2

Fdujo pepl tos 3

Agente 3

Cubo 1


Vistl 3





Tl bdl peconsudtl 3

Tl bdl peconsudtl 2


Son los requisitos del Cubo 1 y el Cubo 2. Al no incluir estos objetos, el Cubo 1y el Cubo 2 pasan a ser no válidos tras la importación. Sólo se exporta uno delos requisitos de Cubo 1 y Cubo 2, Dimensión 1.

Escenario 2

Desea exportar la Dimensión 1 con sus dependencias y los requisitos de estasdependencias, como se muestra en el siguiente diagrama.

Sugerencia: Para hacerlo, utilice la opción Exportar subproyecto.

Se incluyen o se excluyen de la exportación los siguientes objetos:v Se exportan el Objeto del panel de control 2, Objeto del panel de control 3, Cubo

1 y Cubo 2.Son todas las dependencias de la Dimensión 1.

v Se exportan la Tabla de consulta 1 y el Agente 1.Son los requisitos de la Dimensión 1.

v Se exportan la Vista 1, Vista 2, Flujo de datos 1, Flujo de datos 2, Tabla deconsulta 2 y Agente 2.Son los requisitos necesarios para que el Cubo 1 y el Cubo 2 sean válidos.

v No se exportan las dependencias de la Vista 1 y Agente 2.

Agente 1


Fdujo pepl tos 1

Dimensión1

Cubo 2

Tl bdl peconsudtl 1

Vistl 1


Vistl 2

Agente 2

Fdujo pepl tos 2

Fdujo pepl tos 3

Agente 3

Cubo 1


Vistl 3





Tl bdl peconsudtl 3

Tl bdl peconsudtl 2


Escenario 3

Desea exportar la Dimensión 1 con todas sus dependencias y requisitos, así comolas dependencias y requisitos para todos los objetos relacionados, tal como semuestra en el siguiente diagrama.

Sugerencia: Para hacerlo, utilice la opción Exportar proyecto completo.

En este escenario, todos los objetos son válidos después de importarlos.

Se exportan todos los objetos del Proyecto Uno. Los objetos del Proyecto Dos no seexportan porque ninguno de los objetos del Proyecto Uno está conectado conninguno de los objetos del Proyecto Dos.

Exportación de objetos seleccionadosPuede exportar objetos seleccionados.

La acción de exportación escribe la información del objeto en uno de los siguientestipos de archivo:v Archivos XML en un directorio del servidor.v Un único archivo JAR comprimido en el servidor o en el sistema cliente local.

Agente 1

Objeto de panelde control 1

Flujo de datos 1

Dimensión1

Cubo 2

Tabla deconsulta 1

Vista1


Vista 2

Agente 2

Flujo de datos 2

Flujo de datos 3

Agente 3

Cubo 1


Vista 3




Panel de control 3Panel de control 1 Panel de control 2

Agente 3

Proyecto Uno Proyecto Dos

Tabla deconsulta 2

Tabla deconsulta 3


Para obtener información sobre la exportación e importación de metadatos de IBMCognos Real-time Monitoring, consulte la publicación IBM Cognos Real-timeMonitoring Workbench Guía del usuario.

Antes de empezar

Antes de exportar los objetos, asegúrese de que entiende las dependencias y losrequisitos de los objetos.

Procedimiento1. En IBM Cognos Real-time Monitoring Workbench, pulse la pestaña Workbench.2. Pulse en Biblioteca de objetos.3. Seleccione un objeto.4. Pulse en Actividades > Exportar objetos.5. En la ventana Exportación selectiva, en el menú Operación, seleccione uno de

los siguientes tipos de exportación.v Exportar metadatos a un directorio del servidor

La selección de esta opción exporta los metadatos al directorio que especificaen el campo Ubicación del servidor. Escriba la ruta completa del directorioal que desea exportar los metadatos. El directorio debe existir; el usuariodebe tener permiso para grabar en él. Además, se crean dos directorios en eldirectorio especificado. Uno de los subdirectorios recibe el nombre "último".El otro es la indicación de fecha y hora de la exportación. Si los directoriosya existen, se reutilizan.

v Exportar metadatos a un archivo JAR del servidor

Al seleccionar esta opción se exportan los metadatos a un archivo JAR en eldirectorio que especifique en el campo Ubicación del servidor. Escriba laruta completa del directorio al que desea exportar los metadatos. Eldirectorio debe existir; el usuario debe tener permiso para grabar en él.El nombre de archivo en el servidor es _export.jar. Si _export.jar existe, sesobrescribe.

v Exportar metadatos a un archivo JAR (descargar)

Al seleccionar esta opción se exportan los metadatos a un archivo JAR en elcliente. Utilice el cuadro de descargas del navegador para identificar laubicación (y opcionalmente cambiar el nombre de archivo) en la máquinalocal.

6. En el menú Opciones de exportación, especifique una de las opcionessiguientes:v Exportar proyecto completo

Exporta los objetos seleccionados y las dependencias y requisitos de todos losobjetos relacionados.

v Exportar subproyecto

Exporta los objetos seleccionados con sus requisitos y dependencias, y losrequisitos de esas dependencias.

v Exportar con requisitos

Exporta los objetos seleccionados y sus requisitos.v Exportar con dependencias

Exporta los objetos seleccionados y sus dependencias. Los requisitos de lasdependencias no se exportan.

v Exportar con requisitos y dependencias


Exporta los objetos seleccionados con sus dependencias y requisitos. Losrequisitos de las dependencias no se exportan.

v Exportar sólo los objetos seleccionados

Exporta sólo los objetos que selecciona. Las dependencias y requisitos deesos objetos no se exportan.

7. Opcionalmente, seleccione Incluir permisos para estos objetos.Esta opción es útil cuando se desea eludir la reasignación de los permisos paralos objetos tras haberlos importado.

8. Pulse Vista previa de lista de exportación para asegurarse de que haseleccionado las opciones de exportación adecuadas.

9. Pulse Aceptar.


Capítulo 22. Operadores y constantes

IBM Cognos Real-time Monitoring y C-SQL soportan estos operadores y estasconstantes en las expresiones y los argumentos.

Operadores numéricosHay dos clases de operadores numéricos: prefijo e infijo.

Operadores de prefijo

Los operadores de prefijo controlan el signo aritmético de los valores numéricos:

Tabla 79. Operadores de prefijo

Operador de prefijo Descripción

+ Unario más

- Unario menos

Operadores de infijo

Los operadores numéricos realizan operaciones aritméticas con valores numéricos:

Tabla 80. Operadores de infijo

Operador numérico Descripción Ejemplo

+ Suma 11 + 3 devuelve 14

- Resta 11 - 3 devuelve 8

* Multiplicación 11 * 3 devuelve 33

/ División 11 / 3 devuelve 3

Para realizar operaciones aritméticas con valores de fecha y hora, utiliceDATE_ADD y DATE_DIFF. Para obtener más información, consulte: “DATE_ADD”en la página 144 y “DATE_DIFF” en la página 145.

Operadores de cadenaLa concatenación (|| fn_|| ) es el único operador de cadena. Añade la cadena dela parte derecha al final de la cadena de la parte izquierda. Por ejemplo, 'a'||'b'devuelve 'ab'.

El comportamiento es idéntico al de la función CONCAT. Para obtener másinformación, consulte: “CONCAT” en la página 167.


Operadores de comparaciónLos operadores de comparación permiten comparar dos o más valores del mismotipo de datos y devolver un valor booleano.

Tabla 81. Operadores de comparación

Operador Descripción

= Igual que

Ejemplo:

1=1 devuelve TRUE

<> No igual que

Ejemplo:

'A'<>'a' devuelve TRUE

> Mayor que

Ejemplo:

CURRENT_DATE()>TO_DATE('02/28/1963') devuelve TRUE

< Menor que

Ejemplo:

Edad<21 devuelve UNKNOWN cuando Edad es NULL

>= Mayor o igual que

Ejemplo:

TRUE>=FALSE devuelve TRUE

<= Menor o igual que

Ejemplo:

NULL<=NULL devuelve NULL

IN Es miembro de una lista.

Ejemplo:

Símbolo IN ('IBM', 'MSFT', 'VCLR') o recuento NOT IN (5, 10, 15, 20)

BETWEEN/AND Está dentro de un intervalo.

Ejemplo:

PrecioVenta BETWEEN 50,0 AND (90,0) o NOT BETWEEN 'M' AND 'O'

LIKE Coincidencia de patrones

Ejemplo:

Título LIKE 'MR_'

Operador LIKEEl operador LIKE coincide con un modelo de caracteres. El signo de porcentaje (%)del modelo es un comodín de cero o más caracteres, y un guión bajo (_) es uncomodín para exactamente un carácter.


WHERE Title LIKE ’MR_’

WHERE E_Mail NOT LIKE ’%.edu’

Para incluir un signo de porcentaje (%) o un carácter de subrayado (_) en la cadenade búsqueda, utilice la palabra clave ESCAPE para designar un carácter de escape.Un carácter % o _ después de un carácter de escape se trata como literal. Elcarácter de escape no puede utilizarse en ningún otro lugar de la cadena debúsqueda. El siguiente ejemplo busca 10% en Descuento:WHERE Discount LIKE ’%10$%’ ESCAPE ’$’

Un carácter de escape como prefijo de cualquier otro carácter distinto de un escapeo un carácter especial se omitirá.

Tenga cuidado si va utilizar LIKE para compararlo con tipos numéricos. LIKE esun operador de cadena, y al buscar un valor numérico primero realiza unaconversión implícita del valor numérico a una cadena. Para obtener másinformación, consulte: “Conversión implícita” en la página 69. Al convertir losvalores numéricos en cadenas, debe tener en cuenta lo siguiente:v Para números decimales (DECIMAL), la conversión a cadena añade ceros a los

valores decimales para que coincidan con la precisión y la escala definidas parala columna. Por ejemplo, si se define una columna con precisión 5 y escala 4, unvalor de 1,1 en la columna se convierte a '1,1000', por lo que las búsquedas pordecimales de un solo dígito deben realizarse como LIKE '_,_000'.

v Para números de precisión doble (DOUBLE PRECISION), 'e' se convierte amayúsculas. Por ejemplo, +1e11 se convierte a '1,0E11'.

Operadores lógicosLos operadores lógicos comparan valores booleanos, como el resultado de unaoperación de comparación.

Tabla 82. Operadores lógicos

Operador lógico Descripción

AND Ambos son verdaderos

Ejemplo:

(PrecioVenta>500) AND (EnVenta)

OR Uno debe ser verdadero

Ejemplo:

(CódigoPostal = '90210') OR (Ciudad = 'Lodi')

NOT Inverso

Ejemplo:

NOT EnVenta

IS Prueba del booleano Boolean fn_is not

Ejemplo:

IS EnVenta o IS NOT EnVenta

La tabla de verdad del operador de signo igual (=) es equivalente a IS. Paraobtener más información, consulte: “Operadores booleanos” en la página 82.

Capítulo 22. Operadores y constantes 289

ConstantesLas constantes booleanas de C-SQL son TRUE, FALSE y UNKNOWN.

Para obtener más información, consulte: “Operadores booleanos” en la página 82.

Tabla 83. Constantes

Constantes Descripción

TRUE Verdadero.

FALSE No verdadero.

NULL Sin datos.

UNKNOWN Prueba el valor booleano que es NULL, o cuando no se puededeterminar una comparación, por ejemplo al comparar un valor nulo conotro valor nulo.

NULL se omite al calcular una función de conjunto, una función de conjunto móvily valores de función de clasificación. Por ejemplo, el promedio de (3, NULL, 3) es3, no NULL, y no es 2.

NULL es un valor nulo. Cualquier columna que no sea booleana y no tenganinguna entrada se considera NULL. Para obtener más información, consulte:“Operadores booleanos” en la página 82.WHERE SalesPrice = NULL Returns TRUE

WHERE SalesPrice = UNKNOWN Error,cannot cast Numeric to Boolean

No obstante, si se prueba una columna booleana, se devuelve UNKNOWN cuandola columna está vacía. Para obtener más información, consulte: “Operadoresbooleanos” en la página 82.WHERE OnSale = NULL Returns UNKNOWN (null = null)

WHERE OnSale = UNKNOWN Returns UNKNOWN (null = unknown)

WHERE OnSale IS NULL Returns TRUE

WHERE OnSale IS UNKNOWN Returns TRUE


Capítulo 23. Permisos

Los permisos controlan qué usuarios pueden ver, crear y editar objetos y cuentasde usuario.

Los permisos se pueden establecer en tres lugares:v Desde la pestaña Permisos de acceso en la ventana Editar usuario. Se accede a

esta ventana desde la pestaña Consola de administración seleccionandoUsuarios y efectuando una doble pulsación en el nombre de objeto. En lapestaña Permisos de acceso, puede ver y asignar los permisos de nivel de tipopara el usuario seleccionado. Al asignar un permiso de nivel de tipo, es elmínimo permiso que tiene el usuario a todos los objetos de este tipo.

v Desde la pestaña Permisos de acceso en la ventana Editar rol. Se pueden asignarpermisos de nivel de tipo a un rol efectuando una doble pulsación en el rol yasignando el permiso. Si se asignan permisos a un rol, todos los usuariosasociados a ese rol tienen implícitamente esos permisos.

v Desde la ventana Permisos. Se puede acceder a esta ventana pulsando enPermisos en la vista de detalles de un objeto.

Cuando un usuario pertenece a uno o más roles, el nivel más alto de acceso entrelos roles y los permisos asignados al usuario es el permiso efectivo para eseusuario. Para obtener más información, consulte: Capítulo 27, “Roles”, en la página313. En la ventana Permisos, sólo se muestran permisos asignados explícitamente.

De forma predeterminada, cada nuevo usuario posee permisos de Sin acceso(excepto cuando poseen permisos de Sólo lectura en las propiedades: usuario,roles y propiedades de sistemas globales). Sin embargo, con este conjunto mínimode permisos, un usuario puede recibir y visualizar notificaciones de alerta yreportlets generados como resultado de suscripciones obligatorias.

El usuario rtmadmin siempre posee permisos totales para cada objeto de lainstalación. Para obtener información sobre el usuario rtmadmin, consulte:Capítulo 34, “Usuarios”, en la página 353.

Permisos de accesoLos permisos de acceso especifican el nivel de acceso que un usuario tiene sobreun objeto. Los permisos pueden asignarse a una clase de tipos de objeto o a unobjeto específico.

Los permisos de acceso son:

Tabla 84. Permisos de acceso

Permiso Tipo de objeto Objeto

Sin acceso No puede ver ningún objetode estos tipos a menos quese otorgue permiso delectura sobre objetosespecíficos.

No aplicable


Tabla 84. Permisos de acceso (continuación)

Permiso Tipo de objeto Objeto

Filtrado/Sólo lectura No aplicable Limita las filas de una vistao cubo que el usuario puedever en función de un filtrode acceso. Para obtener másinformación, consulte:Capítulo 2, “Filtros deacceso”, en la página 3.

Sólo lectura Puede ver todos los objetosde estos tipos.

Puede ver el objeto.

Lectura/Escritura Puede ver y editar todos losobjetos de estos tipos.

Puede ver y editar el objeto.

No puede asignar un permiso a un objeto mayor que el suyo para ese mismoobjeto.

Permisos de acceso de nivel de tipoTodos los permisos de nivel de tipo se asignan a un usuario o rol. Para ver ocambiar un permiso de nivel de tipo, primero debe editar la definición de cuenta orol del usuario.

Al visualizar una lista de usuarios o roles, no utilice el botón Permisos. Ese botóndefine qué usuarios y roles pueden acceder a las definiciones de cuentas o roles deusuario específicas de la lista. Para obtener más información, consulte: “Permisosde acceso a objetos específicos” en la página 293.

Modificación de los permisos de usuario de una clase de objetosPuede cambiar los permisos de usuario de una clase de objetos.

Para obtener más información, consulte: “Pestaña Permisos de acceso” en la página355.

Procedimiento1. En la pestaña Consola de administración, pulse Usuarios.2. Efectúe una doble pulsación en la cuenta del usuario de la lista.3. En la ventana Editar usuario, pulse la pestaña Permisos de acceso.

Esta pestaña muestra los permisos efectivos, incluidos los permisos asignados alos roles a los que pertenece el usuario.

4. Pulse Editar junto al permiso que quiere cambiar. La ventana del permiso tienetres campos:v Permisos otorgados por rol muestra los permisos asignados por los roles de

los que el usuario es miembro. Cuando el usuario pertenece a varios roles, seaplica el nivel de acceso más alto de todos ellos.

v Permisos específicos de usuario adicionales hace referencia al permiso quese está asignando al usuario para la clase. Aunque se pueden asignar denivel inferior a los permisos de rol, esta acción no rebaja el permiso para elusuario.

v Permisos efectivos es el nivel de permiso más alto asignado por los otrosdos campos, y es el permiso asignado al usuario para esta clase de tipos deobjeto.

5. Guarde los cambios para que se apliquen inmediatamente al usuario.


Cambio de los permisos de rol de una clase de objetosPuede cambiar los permisos de rol de una clase de objetos.

Procedimiento1. En la pestaña Consola de administración, pulse Roles.2. Efectúe una doble pulsación en la cuenta del usuario de la lista.3. En la pestaña Permisos de acceso, pulse Editar junto al permiso que quiere

cambiar. Establezca el permiso en la clase de este rol.4. Guarde los cambios.

Modificación de los permisos de usuario para la creación deinformesPuede cambiar los permisos de usuario para la creación de informes.

Procedimiento1. En la pestaña Consola de administración, pulse Usuarios.2. Efectúe una doble pulsación en la cuenta del usuario de la lista.3. En la ventana Editar usuario, pulse la pestaña Permisos de acceso.4. Pulse Editar junto a Crear informes. Se muestra la ventana Permitido para crear

informes. En esta ventana, puede establecer el acceso para la creación de unInforme y un Informe avanzado. Con el permiso Acceso, los usuarios puedencrear un informe. Con el permiso Acceso con otorgamiento, los usuariospueden crear un informe y otorgar permiso a otro usuario para crear uninforme.

5. Pulse Aceptar.

Permisos de acceso a objetos específicosPara acceder a los permisos de objetos específicos, seleccione el objeto en la lista deobjetos y pulse el botón Permisos.

Esto se aplica a las listas de usuarios, así como a las de roles. Puede asignarpermisos de acceso a cuentas de usuario y roles específicos, de la misma maneraque asigna acceso a vistas o agentes específicos.

Visualización de los permisos de usuario para uno o variosobjetos específicosPuede ver los permisos de usuario para uno o varios objetos específicos.

Procedimiento1. Seleccione uno o varios objetos, como una vista específica o vistas en una lista.2. Pulse Actividades.3. Seleccione Permisos. La ventana Permisos proporciona la información siguiente:

v Sus permisos

Los permisos efectivos que, como usuario que actualmente ha iniciado lasesión en IBM Cognos Real-time Monitoring Workbench, tiene para esteobjeto. Los permisos efectivos son una combinación de los permisos que se leasignan explícita o implícitamente mediante los roles a los que pertenecepara este objeto y este tipo del objeto.

v Nombre

Capítulo 23. Permisos 293

Los nombres de los usuarios y roles que tienen permisos para este objeto oeste tipo del objeto. Para los usuarios, sólo se indican los nombres que tienenasignados permisos explícitamente.

v Tipo

El tipo indica si el Nombre se asocia a un Rol o a un Usuario.v Permisos

Los permisos explícitamente asignados al Rol o al Usuario para este objeto.Pulse el botón Cambiar permisos para establecer los Permisos para unUsuario o Rol.

v Permisos de niveles de tipos

Los permisos para este tipo del objeto explícitamente asignados al Usuario oRol.

Modificación de los permisos de usuario para uno o variosobjetos específicosPuede cambiar los permisos de usuario para uno o varios objetos específicos.

Procedimiento1. Seleccione uno o varios objetos y, a continuación, seleccione Permisos en la lista

desplegable Actividades. El permiso Filtrado / Sólo lectura solamente se puedeasignar a una vista o un cubo cada vez.Si se trata de un solo objeto, también puede pulsar el botón Permisos de lavista de detalles de ese objeto.

2. Seleccione los usuarios cuyos permisos de acceso quiere cambiar y pulseCambiar permisos.No puede cambiar los permisos de los usuarios que no cumplen los criteriosenumerados en: “Restricciones de permisos” en la página 296. Junto a losnombres de los usuarios cuyos permisos no puede cambiar se muestra elsímbolo "No".

3. Establezca los permisos en la pestaña Básico. Cuando se asignan permisos auna vista o un cubo, existe la opción de seleccionar el permiso Filtrado / Sólolectura. Para obtener más información sobre este permiso, consulte: Capítulo 2,“Filtros de acceso”, en la página 3.Guarde los permisos y se aplicarán inmediatamente a los objetos.

Adición de un usuario o un rol a los permisos de uno o variosobjetosPuede añadir un usuario o un rol a los permisos de uno o varios objetos.

Procedimiento1. Seleccione uno o varios objetos y, a continuación, seleccione Permisos en la lista

desplegable Actividades.Si se trata de un solo objeto, puede pulsar el botón Permisos de la vista dedetalles de ese objeto.

2. En el cuadro Permisos, pulse el botón Agregar usuario para añadir un usuarioo pulse Agregar rol para añadir un rol.

3. Active la casilla de verificación situada junto al nombre que quiere añadir a lospermisos.

Cómo otorgar permiso para crear objetosLos Permisos de creación especifican qué clases de objetos puede crear un usuario.


Cuando crea un objeto, dispone de permiso de lectura y escritura, así como depermiso para otorgar acceso para ese objeto. Esto le permite otorgar a cualquierotro usuario, para ese objeto, permiso de acceso o permiso para otorgar.

Después de haber creado un objeto, cualquier otro usuario que, para el objeto,disponga de permisos para otorgar podrá reasignar permisos, reemplazando lospermisos que había asignado.

Cuando crea un usuario, el usuario no dispone de ningún acceso. Puede asignarpermisos a ese usuario para toda una clase de objetos en la pestaña Permisos deacceso del usuario. Para obtener más información, consulte: “Pestaña Permisos deacceso” en la página 355.

Visualización de los tipos de objetos que puede crearPuede ver qué tipos de objetos puede crear.

Procedimiento

Pulse en Valores de cuenta y visualice la pestaña Permisos de acceso para sucuenta.Se mostrarán los permisos efectivos que obtendrá explícita o implícitamentemediante los roles a los que pertenece. Para obtener más información, consulte:“Pestaña Permisos de acceso” en la página 355.

Otorgar permisosLos permisos para otorgar le permiten asignar permisos a otros usuarios.

Los permisos para otorgar son:

Tabla 85. Otorgar permisos

Permiso Descripción

Sin capacidad para otorgar No pueden otorgarse permisos.

Capacidad para otorgar permisos de sólolectura

Puede otorgar el permiso de sólo lectura.

Capacidad para otorgar concesiones deacceso de lectura

Puede otorgar la capacidad de otorgar elpermiso de sólo lectura.

Capacidad para otorgar permiso de lecturay escritura

Puede otorgar el permiso delectura/escritura.

Capacidad para otorgar concesiones deacceso de lectura y escritura

Puede otorgar la capacidad de otorgar elpermiso de lectura/escritura.

El usuario rtmadmin es el único usuario que siempre tiene garantizados todos lospermisos para todos los objetos.

Procedimiento1. Seleccione los objetos y pulse en Permisos.2. Seleccione los usuarios que desea modificar y pulse en Cambiar permisos y, a

continuación, seleccione el permiso para otorgar en la pestaña Avanzado.


Restricciones de permisosSe deben conocer ciertas restricciones a la hora de conceder permisos.

Estas restricciones son las siguientes:v Un usuario no puede reducir los permisos sobre un objeto a otro usuario que

tenga un nivel de permisos más alto.v Un usuario no puede aumentar los permisos de otro usuario para un objeto a un

nivel más alto si sus propios permisos para ese objeto son más bajos. Se sueleexperimentar esta restricción al intentar asignar permisos para varios objetos a lavez, cuando los permisos para uno de los objetos es mejor que los permisos paralos demás objetos.

Herencia de permisos y dependenciasLos objetos que realizan un seguimiento de los permisos controlan el acceso alobjeto y a los objetos que pueden contener. Otros objetos heredan los permisos delobjeto en el que están contenidos.

Los objetos que controlan los permisos son:v Agentesv Actividades empresariales (que controlan el acceso a los escenarios, las reglas,

las alertas y los reportlets contenidos)v Rolesv Tablas, incluidos flujos de datos, tablas de consulta y flujos de datos

consolidadosv Usuarios (controla el acceso a cuentas de usuario).v Vistas, cubos y dimensionesv Paneles de controlv Objetos del panel de controlv Procesos externosv Crear informes

Independientemente de qué permisos tienen los usuarios para una alerta o unreportlet, siempre pueden ver la información en notificaciones de alertas yreportlets que reciben.

DependenciasCuando crea o edita objetos, está limitado por los permisos de los objetosdependientes y por los permisos de los objetos que contiene.

A continuación se indican los objetos que tienen requisitos dependientes para lacreación o edición:

Tabla Debe tener permiso de lectura para el agente que proporciona datos a latabla.

Vista Debe tener permiso de lectura para la tabla de flujos de datos o vista basey cualquier tabla de consulta que proporciona información a la vista.

Cubos Debe tener permiso de lectura para la tabla de flujos de datos o vista basey cualquier dimensión que proporciona información a la vista.

Actividad empresarialPara ver las definiciones de los objetos contenidos en una actividad


empresarial, necesita permiso de lectura para esa actividad empresarial.Para ver las definiciones de los escenarios, reglas, alertas y reportletscontenidos, necesita permiso de lectura para la vista subyacente. Para crearun objeto contenido, necesita permiso de lectura y escritura para laactividad empresarial, así como permiso de lectura para la vistasubyacente.

Los permisos para un objeto pueden afectar al acceso del usuario a otro objeto,especialmente para restricciones en las vistas. Por ejemplo, es posible que puedaeditar una alerta pero no el reportlet para la alerta cuando la vista para el reportletsea Sin acceso, pero la vista para la alerta sea Sólo lectura.



Capítulo 24. Integración de servidor de portal

Puede integrar servidores de IBM Cognos Real-time Monitoring con uno de losservidores de portal soportados, según la especificación JSR-168.

Requisitos previos para integración de servidor de portalSe deben cumplir varios requisitos previos antes de iniciar el procedimiento para laintegración de servidor de portal.

Estos requisitos previos incluyen:v Los servidores de IBM Cognos Real-time Monitoring deben estar iniciados y

ejecutándose en cualquiera de las implementaciones de servidor de aplicacionessoportadas.

v Uno de los siguientes servidores de portal soportados debe estar instalado yejecutándose:

Servidor deportal Descripción

BEA WebLogicPortal Server

Versión agrupada con WebLogic Application Server v 8.1 SP5.

Asegúrese de instalar también el WebLogic Workshop agrupado porqueserá necesario para completar varios pasos de la implementación.

IBM WebSpherePortal Server

Versión 5.1.0.1. Este producto se agrupa con el servidor de aplicacionesWebSphere versión 5.1.13.

(sólo DB2). Si utiliza el servidor de aplicaciones de WebSphere con unabase de datos de DB2, también necesitará DB2 Universal V 8.1 ó 8.2fixpack 10.

JBoss PortalServer

Versión 2.2.1 SP3. Este producto se agrupa con el servidor deaplicaciones JBoss 4.0.3 SP1.

Integración con BEA WebLogic Portal ServerEn esta sección se describe cómo convertir el archivo lavaJSR168.war y desplegarloen un WebLogic Portal Server.

Conversión del archivo lavaJSR168.warPara realizar la integración con WebLogic Portal Server, primero debe convertir elarchivo lavaJSR168.war en la especificación de WebLogic Portal mediante elprograma de utilidad Portlet Preparer Tool disponible en BEA.

Procedimiento1. Desde el programa de utilidad Portlet Preparer Tool, extraiga

portletConverter.jar a un directorio temporal, esto es,$CONVERTER_ROOT$.

2. Copie el archivo lavaJSR168.war en el mismo directorio.3. En el programa de utilidad Portlet Preparer Tool, establezca

WEBLOGIC_HOME de env.sh o env.bat (en función de la plataforma) en elmismo directorio temporal.


4. Ejecute el comando siguiente:run ant -Dwar.file=lavaJSR168.war

De esta forma se crea un subdirectorio denominado tempDir.5. Mediante WebLogic Workshop, importe tempDir como un proyecto web de

portal.

Despliegue del archivo lavaJSR168.war en WebLogic PortalServer

Puede desplegar el archivo lavaJSR168.war una vez que lo haya convertido.

Procedimiento1. Instale WebLogic Portal Server, si todavía no se ha instalado.2. Cree una nueva instancia de dominio de portal e inicie el nuevo servidor de

dominio de portal.3. Mediante WebLogic Workshop, cree una nueva aplicación de portal.4. En la nueva aplicación de portal, importe el proyecto web de portal tempDir

que ha creado en la sección anterior.Antes de continuar, asegúrese de que el archivo lavaJSR168.war está visiblebajo el directorio WEB-INF/lib del proyecto web y de que el archivocqjsr168.jar está visible bajo la sección del portlet.

5. Lance la consola de administración del portal e inicie la sesión.Antes de continuar, asegúrese de que se ha seleccionado la aplicación webcorrecta en la consola. Asegúrese también de que el panel de control sevisualiza bajo los portlets en el nodo de módulos.

6. Cree una nueva página y añada el panel de control.7. Cree un nuevo portal.8. Bajo el nuevo portal, cree un nuevo escritorio.9. Bajo el nuevo escritorio, cree un nuevo libro en blanco y añada la página que

ha creado anteriormente.10. Visualice el escritorio para lanzar la aplicación de portal.11. En el portlet de panel de control, diríjase al modo de edición e inicie la sesión

en los servidores IBM Cognos Real-time Monitoring que están en ejecución.Esta acción visualiza las métricas disponibles.

12. Seleccione las métricas que desea visualizar en la página del portal.13. Pulse Aceptar.

Esta acción visualiza los objetos de panel de control que están disponiblespara el portlet.

Integración con IBM WebSphere Portal ServerPuede integrar IBM Cognos Real-time Monitoring con IBM WebSphere PortalServer.

Para realizar el siguiente procedimiento, revise la documentación de WebSpherePortal.

Procedimiento1. Instale WebSphere Portal Server, si todavía no se ha instalado.2. Inicie la sesión en la consola de administración del portal.


3. En Gestión del portal > Módulos web, despliegue el archivo lavaJSR168.war.4. Cree un nuevo servidor de portal virtual con un nombre adecuado.5. En el servidor de portal virtual que acaba de crearse, cree una nueva página.6. Al configurar el diseño de página:

v Seleccione un diseño de dos columnas.v Añada el portlet de panel de control.

7. Cuando haya terminado, el portal visualizará el nombre de la página en formade enlace en la columna de la izquierda. Cuando pulse el enlace de página, lacolumna de la derecha visualizará el portlet de panel de control.

8. Pulse el enlace de página y diríjase al modo de edición del portlet de panel decontrol.

9. Acceda a los servidores IBM Cognos Real-time Monitoring especificando elnombre de usuario, la contraseña y la dirección URL de la instancia que estáen ejecución.Esta acción visualiza las métricas disponibles.

10. Seleccione las métricas que desea visualizar en la página del portal.11. Pulse en Aceptar.

Esta acción visualiza los objetos de panel de control que están disponiblespara el portlet.

Integración con JBoss Portal ServerPuede integrar IBM Cognos Real-time Monitoring con JBoss Portal Server.

Procedimiento1. Instale JBoss Portal Server si no está instalado.2. Concluya el servidor de aplicaciones JBoss, si está en ejecución.3. Copie el archivo lavaJSR168.war en el directorio de despliegue de la instalación

del servidor de aplicaciones JBoss.4. Reinicie el servidor de aplicaciones JBoss:

...\$JBOSS_HOME$\bin\run.bat (Windows)

.../$JBOSS_HOME$/bin/run.sh (UNIX)5. Inicie la página Vista en un navegador.

Por ejemplo, el URL puede ser http://[host]:[puerto/portal/portal/default/[nombre_página].El valor de nombre de página puede personalizarse modificando el elemento<page-name> del archivo celequest-objects.xml del paquete WAR. El valorpredeterminado es celequestpage.

6. Vaya al modo de edición del portlet de panel de control.7. Acceda a los servidores IBM Cognos Real-time Monitoring especificando el

nombre de usuario, la contraseña y la dirección URL de la instancia que está enejecución.Esta acción visualiza las métricas disponibles.

8. Seleccione las métricas que desea visualizar en la página del portal.9. Pulse en Aceptar.

Esta acción visualiza los objetos de panel de control que están disponibles parael portlet.

Capítulo 24. Integración de servidor de portal 301

Múltiples instancias de portlet en un JBoss Portal ServerPuede crear varias instancias de portlet de panel de control en JBoss Portal Server.Puede crear varias páginas de portal y visualizar en ellas distintos conjuntos depaneles de control.

Crear varias instancias de CelequestDashboardPortletInstancePuede crear instancias de portlet de panel de control en JBoss Portal Server.

Procedimiento1. Inicie la sesión en el portal JBoss con el nombre de usuario admin y la

contraseña admin.2. En la pestaña, seleccione la página Admin Portal.3. Pulse el enlace Manage Instances.4. Seleccione LavaDashboardPortletInstance.5. Especifique un nuevo nombre para la instancia y pulse Create New Instance.6. Repita los pasos 4 y 5 para crear varias instancias de

LavaDashboardPortletInstance.

Creación de varias páginas en JBoss Portal Server:

Puede crear varias páginas de portal en JBoss Portal Server.

Procedimiento

1. Pulse el enlace Manage Portal.2. Pulse la carpeta raíz del árbol.3. Pulse la página predeterminada en el árbol raíz.4. Cree una página nueva (por ejemplo, celPage1) en el marco de la izquierda y, a

continuación, pulse en dicha página.5. Ahora, asocie la nueva página a una instancia LavaDashboardPortletInstance en

la parte central de la página.6. Pulse el enlace de vista previa para la página del paso 5 y edite el portlet de

panel de control de IBM Cognos Real-time Monitoring. Por ejemplo, puedeañadir objetos de panel de control a la página.

7. Repita los pasos 4, 5 y 6 para crear portlets de panel de control de CognosReal-time Monitoring para cada instancia LavaDashboardPortletInstance.


Capítulo 25. Procesos

Un proceso es el conjunto de pasos que conlleva realizar una tarea. Unatransacción real dentro de un proceso es una instancia de proceso.

El siguiente ejemplo muestra un proceso de cuatro pasos para realizar unasolicitud de aprobación. Se realiza la solicitud, se revisa y, a continuación, seaprueba o se rechaza. Una transacción real, como una solicitud de aprobaciónespecífica, es una instancia de proceso.

Los sistemas de gestión de procesos de negocio (BPM) crean y gestionan procesos einstancias de negocio. Cuando una BPM gestiona una instancia de proceso, envíadetalles sobre cada paso de la transacción a IBM Cognos Real-time Monitoring, elcual, a continuación, desarrolla estadísticas sobre todo el proceso. Por ejemplo, elsistema puede determinar cuánto se tarda de promedio en completar el procesoentero, si el proceso es cada vez más rápido, qué porcentaje de solicitudes serechazan, o cuánto tardan los pasos de revisión.

Funcionamiento de los procesosLos detalles de una instancia de proceso llegan a IBM Cognos Real-timeMonitoring como eventos. El servidor Cognos Real-time Monitoring agrega losdetalles en vistas o cubos para generar las estadísticas. A continuación, CognosReal-time Monitoring Dashboard presenta el proceso como un diagrama, e incluyelas estadísticas en una tabla. Otros objetos pueden mostrar otras métricas, comográficos que presentan una estadística a lo largo del tiempo.

Cognos Real-time Monitoring Dashboard también proporciona una consultaopcional a la BPM para obtener detalles sobre una instancia de proceso específica,como el punto en el que se encuentra dentro del proceso. Cuando un usuariorealiza esta solicitud, Cognos Real-time Monitoring Dashboard realiza una consultaen una tabla de consulta de los servidores Cognos Real-time Monitoring; esta tabla,a su vez, consulta en la BPM para obtener los detalles de la instancia concreta. Losresultados se devuelven a Cognos Real-time Monitoring Dashboard para su

Realizarsolicitud

Revisarsolicitud

Aprobarsolicitud

Rechazarsolicitud

Figura 27. Proceso de cuatro pasos

Sistema degestión deprocesos(procesos)

Servidores de IBM Cognos RTM

(vistas y cubos)

Panel de control deIBM Cognos RTM(gráficos y tablas)Detalles de

instanciasEstadística

Figura 28. Un sistema de gestión de procesos envía detalles de instancias a IBM Cognos Real-time Monitoring


visualización.

El sistema de gestión de procesos genera un archivo de definición de proceso quedescribe el proceso en XML. A continuación, una definición de proceso de IBMCognos Real-time Monitoring Workbench asocia este archivo de definición con unavista o un cubo agregado y, de forma opcional, con una tabla de consulta debúsquedas. Cognos Real-time Monitoring Dashboard utiliza este objeto comoorigen de un gráfico de proceso y para identificar la vista o el cubo agregado y latabla de consulta de búsquedas asociados.

Creación y utilización de procesosPara crear y utilizar procesos, el sistema de procesos empresariales externos deberealizar varias tareas.

Estas tareas incluyen:v Generar un archivo de definición de proceso en un formato XML reconocido por

IBM Cognos Real-time Monitoring.v Publicar estadísticas de paso de proceso como datos de eventos en los servidores

Cognos Real-time Monitoring.v Proporcionar una interfaz para las consultas de instancia de proceso desde las

tablas de consulta de Cognos Real-time Monitoring. Esta tarea es opcional.

Procedimiento1. Crear un agente (si es necesario) y una tabla de flujos de datos para la

recepción de los eventos de proceso de la BPM.2. Crear una vista o cubo para cada proceso.

Sistemade gestiónde procesos

IBM Cognos RTM

Búsqueda detalladade tabla de consulta

Panel de control deIBM Cognos RTM

Consulta de instanciay resultados

Consulta

Detalles

Figura 29. El panel de control consulta una tabla de consulta e IBM Cognos Real-time Monitoring consulta el sistemade gestión de procesos.

Sistemade gestiónde procesos

Panel de control deIBM Cognos RTM

IBM Cognos Real-time Monitoring

Definición del proceso

Vista o cuboagregado

Búsqueda detalladade tabla de consulta

Diagramas deproceso

Archivo de definición del proceso

Figura 30. El sistema de gestión de procesos envía el archivo de definición del proceso a IBM Cognos Real-timeMonitoring.


3. (Opcional) Crear una tabla de consulta para consultar la BPM.4. Crear un objeto de definición de proceso.5. Crear un diagrama de proceso.

Tablas de flujos de datosLas tablas de flujos de datos reciben y agregan las estadísticas de la instancia delproceso. Los datos de eventos se reciben en una tabla de flujos de datos,habitualmente a través de un agente. Las vistas agregadas se basan en la tabla deflujos de datos.

Para obtener más información acerca de estos componentes, consulte los temassiguientes:v Capítulo 4, “Agentes”, en la página 23v Capítulo 10, “Flujos de datos”, en la página 85v Capítulo 36, “Vistas”, en la página 361v Capítulo 8, “Cubos”, en la página 63

También se aplican los siguientes requisitos:v Sólo debe haber un agente y tabla de flujos de datos para cada BPM.v Sólo debe haber una vista o cubo para cada proceso. Utilice una cláusula

WHERE para distinguir los eventos de proceso de otros procesos en la tabla deflujos de datos, como "Process Name"='Request Approval'. Para obtener másinformación, consulte las definiciones de proceso en la publicación IBM CognosReal-time Monitoring Workbench Guía del usuario.

Búsqueda de tabla de consultaLa tabla de consulta genera una consulta a la BPM siempre que un usuario de IBMCognos Real-time Monitoring Dashboard realice una consulta ad hoc acerca de unainstancia de procesos específica.

Para obtener más información, consulte: Capítulo 20, “Tablas de consulta”, en lapágina 261.

Cuando la tabla de consulta recibe una consulta de Cognos Real-time MonitoringDashboard, primero busca los detalles en la memoria caché de tabla de consulta. Sila instancia no se encuentra en la memoria caché, la tabla consulta a la BPM paraobtener más información. Asegúrese de definir una planificación de invalidaciónrazonable para su empresa, o bien inhabilite la memoria caché si las consultasdeben devolver la información más actualizada sobre la instancia de proceso.

Archivos de definición de procesoPara crear una definición de proceso, necesita un archivo de definición de procesoque describa su Modelo de proceso de negocio (BPM). Este archivo de definiciónde proceso debe ser compatible con el lenguaje de definición de procesos XML(XPDL) 2.0.

IBM Cognos Real-time Monitoring soporta lo siguiente:v Varios elementos workflowProcess dentro de un documento XPDLv Iconos predeterminados para todos los tipos de evento y pasarela.

Todos los documentos XPDL deben especificar 2.0 en el elementoPackage.PackageHeader.XPDLVersion.

Capítulo 25. Procesos 305

A continuación se indican las excepciones al estándar XPDL 2.0 en larepresentación de diagramas de proceso por parte de Cognos Real-timeMonitoring.v Los elementos ActivitySet y las actividades y transiciones definidas en un

elemento ActivitySet se representan encima de todos los demás objetos de unconjunto de trabajo. (Los conjuntos de actividades se representan en la partesuperior de otros objetos porque se espera que representen un subprocesoencima del proceso actual). Otros objetos se representan de acuerdo con suubicación en el archivo XPDL; cuanto más tarde se especifique un objeto en ladefinición XPDL, más probable es que se represente encima de los demásobjetos. El orden actual de arriba abajo es el siguiente:– Transiciones– Actividades– Artefactos– Asociaciones– Mensajes– Departamentos– Agrupaciones

v Según el estándar XPDL 2.0, el elemento NodeInfoGraphicsInfo es opcional paracada nodo. Sin embargo, Cognos Real-time Monitoring necesita un elementoNodeInfoGraphicsInfo para cada nodo del diagrama de proceso. Si hay más deun elemento NodeInfoGraphicsInfo asociado a un único nodo, sólo se lee elelemento con la propiedad ToolID establecida en "Cognos Real-time Monitoring".Asimismo, se espera un elemento Coordenada con cada elementoNodeGraphicsInfo. Las coordenadas X e Y deben corresponder a la esquinasuperior izquierda del cuadro delimitador del nodo. Asimismo, debe especificarla altura y la anchura.

v Según el estándar XPDL 2.0 standard, el elemento ConnectorGraphicsInfo no esnecesaria para cada elemento de tipo conector. No obstante, si no especificaelementos ConnectorGraphicsInfo, se utiliza una ruta recta de un nodo a otro.Las transiciones que especifican un tipo de condición de CONDITIONrepresentan un rombo condicional en el punto de partida de la transición. Unacondición de tipo OTHERWISE representa una barra invertida (\) al inicio de latransición. Si especifica un elemento ConnectorGraphicsInfo, debe especificarcoordenadas del inicio al fin y no al revés.

v Los eventos sólo se representan según lo especificado por el estándar XPLD 2.0.Cognos Real-time Monitoring no soporta los atributos obsoletos que marcan unproceso de inicio o de fin.

v Los conectores o nodos que contienen un atributo de nombre se representan conel texto del atributo Name como etiqueta.

v Al especificar URL para iconos personalizados, el URL se puede especificar enun atributo de forma de un elemento NodeGraphicsInfo o en el subelementoIcon de un elemento Activity. Se puede utilizar un URL completo o un URLrelativo para el URL de Cognos Real-time Monitoring Dashboard. Los iconospersonalizados no están sesgados para coincidir con la anchura y la alturaespecificadas en el elemento NodeGraphicsInfo. Los iconos personalizadosconservan su proporción de aspecto.

Creación de definiciones de procesosPuede crear definiciones de proceso.


Para obtener detalles sobre esta tarea, consulte las definiciones de proceso en lapublicación IBM CognosReal-time Monitoring Workbench Guía del usuario.

Antes de empezar

Antes de crear una definición de proceso, debe tener:v Un archivo de definición de proceso. Este archivo debe ser compatible con el

lenguaje de definición de procesos XML (XPDL) 2.0.v Permiso de acceso de sólo lectura para la vista o cubo que agrega los eventos de

proceso.v Una vista o un cubo que agregue los datos de instancia de proceso, donde una

columna especifica los pasos del proceso.

Es opcional tener permiso de acceso de sólo lectura para la tabla de búsqueda parala tabla de consulta.

Procedimiento1. En IBM Cognos Real-time Monitoring Workbench, pulse la pestaña Workbench.2. Pulse Actividades.3. Pulse Crear nuevo > Definición de proceso.4. Indique el nombre de la definición de proceso, especifique una carpeta y

proporcione una descripción. La carpeta predeterminada es Carpetas públicas.La descripción es opcional.

5. Pulse Cargar archivo de definición de proceso para cargar el archivo dedefinición de proceso generado por la BPM.Cuando haya cargado el archivo, el nombre del proceso del archivo dedefinición aparecerá en el campo Nombre de proceso. Para obtener másinformación, consulte: “Archivos de definición de proceso” en la página 305.

6. Pulse Seleccionar origen de datos para seleccionar la vista o el cubo agregado.7. Utilice la lista Columna de pasos para seleccionar la columna de pasos. Por

ejemplo, cada paso del proceso puede identificarse con un nombre o unnúmero de ID.

8. Para crear una búsqueda detallada, pulse Seleccionar origen de datos yseleccione en la lista Columna de búsqueda la columna en la que desearealizar la búsqueda. Puede especificar texto en el campo Nombre descriptivo.Este nombre aparece en IBM Cognos Real-time Monitoring Dashboard.

9. Pulse Guardar.Ahora puede crear diagramas de proceso basados en esta definición.

Creación de diagramas de procesoPuede crear diagramas de proceso en IBM Cognos Real-time MonitoringDashboard utilizando las definiciones de proceso que ha creado en IBM CognosReal-time Monitoring Workbench.

Para obtener información detallada sobre esta tarea, consulte la publicación IBMCognos Real-time Monitoring Dashboard Guía del usuario.

Antes de empezar

Antes de crear un diagrama de proceso, las definiciones de proceso deben estardefinidas en IBM Cognos Real-time Monitoring Workbench. Asimismo, debe tener

Capítulo 25. Procesos 307

permiso de acceso de sólo lectura en la vista agregada o en el cubo queproporciona las estadísticas.

Procedimiento1. En IBM Cognos Real-time Monitoring Workbench, abra el gestor Diagramas de

proceso.2. Pulse Crear diagrama.3. Seleccione la definición de proceso tal como se ha definido en IBM Cognos

Real-time Monitoring Workbench.4. Seleccione las columnas de origen que han de presentarse como estadísticas.5. Especifique un nombre para el diagrama de proceso y guárdelo.

IBM Cognos Real-time Monitoring Dashboard presentará inmediatamente eldiagrama de proceso. Las estadísticas se actualizarán a medida que llegueneventos para el proceso específico.


Capítulo 26. Reportlets

Los reportlets describen el contenido de una vista y presentan esa información enun informe que está asociado a un mensaje de alerta o es presentado por unsistema externo.

Por ejemplo, cuando quedan pocas existencias de un producto en el inventario y elenvío de reposición ha vencido, una alerta puede avisar a los encargados decompras de ese problema; además, en el reportlet asociado a la alerta se puedenincluir los proveedores alternativos para ese producto. Los reportlets se adjuntan atodos los suscriptores de la alerta asociada. Para obtener más información,consulte: Capítulo 5, “Alertas”, en la página 41.

Hay dos tipos de reportlets:v Los reportlets internos son la representación visual de la información de una

vista cuando la alerta genera el reportlet. La presentación se realiza en una tablacon formato de texto o HTML que contiene toda la información incluida en lavista.

v Los sistemas de creación de informes externos producen reportlets externos (deterceros). Los reportlets externos presentan un informe basado en los datos devista que reciben cuando el usuario pulsa en un enlace al sistema externo. Esesistema es responsable de generar y presentar el informe.

Creación de reportletsPuede crear reportlets para proporcionar información sobre un evento.

Para obtener información acerca de los atributos de reportlet, consulte: “Atributosde reportlets” en la página 310 o “Atributos de reportlets externos” en la página310.

Antes de empezar

Debe tener permisos específicos para crear un reportlet:v Permiso de creación. Para obtener más información, consulte: Capítulo 23,

“Permisos”, en la página 291 y “Cómo otorgar permiso para crear objetos” en lapágina 294.

v Permiso de lectura y escritura para la actividad empresarial que contiene elreportlet. Para obtener más información, consulte: Capítulo 23, “Permisos”, en lapágina 291.

v Permiso de sólo lectura para la vista que proporciona datos al reportlet.


Modelador de escenarios.2. En Actividades empresariales, pulse el escenario que debe contener el

reportlet.3. Pulse la pestaña Reportlets.4. Pulse Nuevo reportlet.5. Seleccione el tipo de reportlet que ha de crearse.


Los reportlets se formatean como tablas HTML.Los sistemas de creación de informes externos definen y producen reportletsexternos (de terceros) basándose en los datos que reciben.La opción de los reportlets externos sólo está disponible cuando se handefinido enlaces externos. Para obtener más información, consulte lapublicación IBM Cognos Real-time Monitoring Workbench Guía del usuario.

6. Complete los campos de atributo en la ventana Crear reportlet.7. Guarde el reportlet como habilitado.

También puede crear un reportlet al crear o editar una alerta. Con ello elreportlet se adjuntará automáticamente a la alerta. Para obtener másinformación, consulte: Capítulo 5, “Alertas”, en la página 41.

Atributos de reportletsLos reportlets están formateados como tablas HTML que poseen atributosconcretos.

Tabla 86. Atributos de reportlets


Nombre Identifica el reportlet. El nombre puede contener sólo letras y números. Estenombre debe ser exclusivo entre reportlets dentro del mismo escenario. Paraobtener información, consulte: “Espacio de nombres de objeto” en la página277.

Descripción Descripción opcional que puede contener cualquier carácter de texto.

Estado Indica si el reportlet está habilitado o inhabilitado. Cuando el escenario quelo contiene está inhabilitado, no se puede habilitar el reportlet. El escenariodebe habilitarse antes de poder habilitar el reportlet.

Vista Vista empresarial desde la que el informe obtiene los datos. Para obtenermás información, consulte: Capítulo 36, “Vistas”, en la página 361.

Atributos de reportlets externosLos reportlets externos presentan informes según los datos de vista que recibencuando el usuario pulsa un enlace al sistema de creación de informes externo (deterceros).

Ese sistema es responsable de generar y presentar el informe. La definición dereportlets externos identifica el enlace externo y la información de vista que sedebe pasar al sistema externo que emplea la información para identificar elinforme que se debe presentar. Por ejemplo, un informe externo puede presentarun archivo PDF que contiene la descripción completa de un producto identificadoen una alerta.

Tabla 87. Atributos de reportlets externos


Nombre delreportlet

Identifica el reportlet. El nombre puede contener sólo letras y números.Este nombre debe ser exclusivo entre reportlets dentro del mismoescenario. Para obtener información, consulte: “Espacio de nombres deobjeto” en la página 277.

Estado Indica si el reportlet está habilitado o inhabilitado. Cuando el escenarioque lo contiene está inhabilitado, no se puede habilitar el reportlet. Elescenario debe habilitarse antes de poder habilitar el reportlet.


Tabla 87. Atributos de reportlets externos (continuación)


Descripción Descripción opcional que puede contener cualquier carácter de texto.

Datos de la vista Vista empresarial desde la que el informe obtiene los datos. Contiene lainformación de columna que se debe enviar al informe externo. Paraobtener más información, consulte: Capítulo 36, “Vistas”, en la página361.

Nombre deinforme

Nombre del informe en el sistema externo. Este es el elementoDocName del URL que se comunica con el sistema de informe externo:

http://localhost.com?DocName=<ReportName>

Parámetros deinforme

Parámetros que se deben pasar al sistema externo. Cada parámetrocorresponde a una columna de la vista. El reportlet sustituye al valor decada columna denominada en el URL. Por ejemplo, el URL se define dela forma siguiente:

...?DocName=<ReportName>&Parameter1=PROD_ID&...

Tiene un aspecto similar a este cuando se envía al sistema externo:

...?DocName=<Report Name>&product="product_id"&...

Argumentos deinforme Este panel especifica valores de argumento que pueden asignarse a

argumentos en el URL especificado en el enlace externo. Por ejemplo,supongamos que el enlace externo define un URL base para un informede IBM Cognos, y el URL base necesita los siguientes argumentos:

ui.tool=CognosViewer&ui.object=content/folder[@name='DemoReport']/report[@name='Inventory Levels by Retailers']ui.action=run&run.outputFormat=PDF

El URL base es http://server_name/ibmcognos/cgi-bin/cognos.cgi?b_action=xts.run&m=portal/launch.xts&

Cuando se llama al informe asociado desde el objeto del panel decontrol con los valores especificados para los argumentos del panel deargumentos de informe, la solicitud de URL real se construye de lamanera siguiente:

http://server-name/ibmcognos/cgi-bin/cognos.cgi?b_action=xts.run&m=portal/launch.xts&ui.tool=CognosViewer& ui.object=content/folder[@name='Demo Report']/report[@name='Inventory Levels byRetailers']&ui.action=run&run.outputFormat=PDF

Mostrar enlace Muestra el URL completo y cualificado que aparecerá en el mensaje dealerta y funciona como enlace al sistema de informe externo.

Los URL utilizados para comunicarse con el sistema de informe externo comienzanpor la cadena definida para el informe en la lista Enlaces externos de la pestañaWorkbench de Cognos Real-time Monitoring Workbench. Para obtener másinformación, consulte la publicación IBM Cognos Real-time Monitoring WorkbenchGuía del usuario.

Vistas de reportletLos reportlets recuperan su información de la vista empresarial en la que se basa laalerta o de cualquier vista derivada del mismo flujo de datos.

Capítulo 26. Reportlets 311

Por ejemplo, supongamos que existe una regla que generó la alerta del clientebasándose en la vista InventoryLow. Otra vista, AvailableSuppliers, añade contextoindicando proveedores alternativos. El reportlet asociado a la alerta puederecuperar información de cualquiera de estas vistas. Puesto que ShippingNotices sederiva del mismo flujo de datos, también se puede recuperar información de allí.Sin embargo, no se puede recuperar información de OrderDetails porque está enun flujo de datos distinto.

Para obtener más información acerca de los datos que aparecen en la vista dereportlet, consulte:“Filtro de reportlet” en la página 49.

La vista de reportlet no puede ser una unión sincronizada. Para obtener másinformación, consulte: “Uniones sincronizadas” en la página 364.

Figura 31. Vistas de reportlet


Capítulo 27. Roles

Los roles definen los conjuntos mínimos de permisos asociados a los usuarios.

Con el uso de roles puede asignar rápidamente los mismos permisos a objetos oconjuntos de objetos. Por ejemplo, un rol de operador puede proporcionarpermisos totales a los agentes, pero no a los flujos de datos o actividadesempresariales, mientras que un rol de desarrollador de aplicaciones puede tenerpermisos totales en todos los objetos, excepto los agentes.

Los usuarios pueden pertenecer a un rol, a varios o a ninguno. Para ver a quéroles pertenece un usuario, edite la cuenta de usuario y consulte la pestañaDetalles del usuario. Para ver a qué roles pertenece usted, pulse Valores de cuentay consulte la pestaña. Para obtener más información, consulte: “Pestaña Detallesdel usuario” en la página 353.

Los permisos asociados a una operación determinada dependen de los permisosasociados a los roles de ese usuario y los permisos individuales asignados alusuario. Suponga un usuario con dos roles: un rol con acceso de sólo lectura a laclase Vistas, y el otro rol con acceso de lectura y escritura a la misma clase Vistas.El usuario tiene permisos de lectura y escritura para la clase Vistas y puede editarcualquier vista de esta clase.

De forma similar, si un usuario es miembro de un rol y ese rol tiene permisos desólo lectura para todas las vistas, pero tiene permisos de lectura y escritura parauna vista determinada, el usuario podrá editar sólo esa vista concreta.

Los roles, como todos los objetos de IBM Cognos Real-time Monitoring, estánprotegidos por permisos. Sólo los usuarios con permisos específicos sobre los rolespueden modificarlos o suprimirlos. Por ejemplo, para añadir usuarios a un rol, esnecesario tener permisos de lectura y escritura para ese rol.

La lista Roles de la Consola de administración muestra los roles actuales delsistema.

Para obtener más información sobre los niveles de acceso específicos para los roles,consulte: Capítulo 23, “Permisos”, en la página 291.

Creación de rolesPuede crear roles para definir los conjuntos mínimos de permisos que han deasociarse a los usuarios.

Antes de empezar

Para crear un rol, necesita permisos de creación para roles. Para cada clase deobjeto puede asignar hasta el grado de permiso más alto de que dispone para esaclase.

Por ejemplo, si tiene permisos de creación para una clase, puede asignar cualquierade los permisos siguientes:v Sin acceso


v Sólo lecturav Lectura y escriturav Crear

Procedimiento1. En la pestaña Consola de administración, pulse en Roles para ver la lista de

todos los roles actualmente definidos.2. Pulse en Nuevo rol.3. Especifique los atributos del rol, asigne permisos de acceso, identifique los

miembros del rol y guarde el nuevo rol.

Atributos de rolCada objeto de rol tiene atributos.

Tabla 88. Atributos de rol


Nombre Especifica el nombre del rol. El nombre debe ser exclusivo entre todoslos objetos de la carpeta raíz, como actividades empresariales,usuarios, roles, objetos del panel de control, etcétera.

Descripción Proporciona una descripción opcional que puede contener cualquiercarácter de texto.

Permisos de acceso Especifica los permisos de acceso para cada clase de objetos asignadosa este rol. Son los permisos mínimos. Un usuario puede tener máspermisos asignados individualmente a un objeto o a una clase deobjetos.

Miembros Especifica los usuarios asociados con este rol.

Pestaña de permisos de accesoLos permisos de acceso son los permisos globales que puede tener un usuario o rolpara un objeto o una clase de objetos.

En esta pestaña puede especificar permisos para:v Actividades empresarialesv Vistas, cubos y dimensionesv Tablas de consulta y flujos de datosv Usuariosv Rolesv Agentesv Propiedades de sistemas globalesv Paneles de controlv Objetos del panel de controlv Procesos externos

Los nuevos usuarios y roles no tienen ningún permiso de acceso para ningúnobjeto. Por ello, los usuarios y roles reciben y ven alertas y reportlets sóloautorizados mediante suscripciones obligatorias.


Para obtener más información sobre la asignación de permisos, consulte:Capítulo 23, “Permisos”, en la página 291.

Capítulo 27. Roles 315


Capítulo 28. Reglas

Las reglas supervisan las actividades empresariales mediante el análisis de lasvistas empresariales, buscando métricas que cumplan condiciones específicas.

Las condiciones de regla son fórmulas similares a una hoja de cálculo que evalúanlas métricas empresariales que cambian, buscando condiciones excepcionales.Cuando se produce una condición, se envía una alerta al personal clave.

Puede crear reglas que envíen alertas cada vez que se produzca (dispare) lacondición, reglas que envíen alertas una sola vez e ignoren los eventos posterioreshasta que se resuelva (emita) la condición inicial, o reglas que restablezcan(cancelen) las reglas emitidas previamente.

En versiones anteriores del producto, la regla sólo podía supervisar las vistasderivadas de la vista predeterminada de escenario. Esta restricción ya no se aplica.

Creación de reglasPuede crear una nueva regla.

Antes de empezar

Debe disponer de permiso de creación para actividades empresariales, y depermiso de lectura y escritura para la actividad empresarial que contiene la regla,así como permiso de sólo lectura para la vista que proporciona información para laregla.

Para obtener más información sobre los permisos, consulte: “Cómo otorgarpermiso para crear objetos” en la página 294.


Modelador de escenarios.2. En Actividades empresariales, pulse el escenario que va a contener la regla.3. Abra un escenario existente.4. En la pestaña Reglas, pulse Nueva regla.

¿Es el estado = 'Open'?

2. Cuando la expresión es verdadera, se ejecuta una acción

1. Las reglas supervisan vistasevaluando las expresiones.

WHEN [ Status = 'Open ] FIRE [

Figura 32. Una regla supervisa una vista


5. Seleccione el origen de datos que la regla supervisará.6. Especifique los atributos re regla en la ventana Crear regla. Asimismo:

v Si el escenario tiene una vista predeterminada, dicha vista apareceseleccionada. Puede seleccionar otro origen para su supervisión pulsando enSeleccionar origen de datos.

v Para una vista, seleccione la vista.v Para un cubo, seleccione el nivel de dimensión en un cubo. También puede

aplicar un filtro que restrinja aún más los datos que la regla va a supervisar.Si el origen contiene datos, dichos datos proporcionan un ejemplo de lo que sepuede esperar. Cuando el origen está vacío, la ventana sólo muestra losnombres e columna y el mensaje No hay datos disponibles.Para identificar la alerta que se debe activar cuando se cumple la condición dela regla, seleccione una alerta existente pulsando esta alerta en el campo deefecto de la regla o pulse Siguiente para acceder a la ventana Definición dealerta.

7. Guarde la regla como habilitada.

Clonación de reglasPuede clonar y modificar reglas existentes.

Antes de empezar

Debe disponer de permiso de creación para actividades empresariales, y depermiso de lectura y escritura para la actividad empresarial que contiene la regla,así como permiso de sólo lectura para la vista que proporciona información para laregla.

Para obtener más información sobre los permisos, consulte: “Cómo otorgarpermiso para crear objetos” en la página 294.

Procedimiento1. Edite la regla que desea clonar.2. Cambie el nombre de la regla, y cambie los atributos que sean distintos a los de

la regla original.3. Pulse Guardar como regla nueva.

Atributos de reglaTodas las reglas tienen atributos.

Tabla 89. Atributos de regla


Origen de datos actual Identifica la vista o el cubo que la regla supervisa. Pulse elbotón Seleccionar origen de datos para cambiar el origen dedatos para la regla.

Nombre de la regla Identifica el objeto de regla. El nombre puede contener sóloletras y números. Este nombre debe ser exclusivo entre reglasdentro del mismo escenario. Para obtener más información,consulte: “Espacio de nombres de objeto” en la página 277.


Tabla 89. Atributos de regla (continuación)


Estado Especifica si la regla está habilitada (recibiendo informaciónnueva) o inhabilitada. Cuando el escenario que la contieneestá inhabilitado, no se puede habilitar la regla. El escenariodebe habilitarse antes de poder habilitar la regla.


CondiciónFórmula de verdadero o falso, similar a una hoja de cálculo,que se evalúa con respecto a la vista empresarial asociada.Cuando la fórmula se evalúa como verdadera, la condiciónexiste y el sistema envía la alerta. Para obtener másinformación, consulte: “Condiciones de regla”.

Cuando la condición existe, se realiza una acción. Las reglaspueden enviar alertas cada vez que se produzca (dispare) lacondición, enviar alertas una sola vez e ignorar los eventosposteriores hasta que se resuelva (emita) la condición inicial, orestablecer (cancelar) otras reglas emitidas previamente. Paraobtener más información sobre las acciones que se llevan acabo cuando se cumple una condición, consulte: “Acciones deregla” en la página 320.

Corresponde a Envía la alerta únicamente cuando la condición es verdaderadurante un intervalo de tiempo especificado. No se enviaráninguna alerta si la condición es falsa en cualquier momentodurante la espera. Si se omite la duración, el sistema envía laalerta en cuanto se produce la condición. Puede especificar unvalor con uno de los métodos siguientes:

v Especifique un número para indicar el tiempo de espera.

v Especifique el nombre de una columna de la vista quecontenga el número. Cuando se utiliza esta opción, la reglatoma el valor del evento de la vista.

En entornos locales en los que se tiene en cuenta el horario deverano, las duraciones de los días, meses y años se ajustanconsecuentemente. Mientras que 1 día tiene normalmente 24horas, puede tener 23 o 25 según la época del año.

Básico Utilice la pestaña Básico para especificar la alerta que se debeenviar cuando se cumple la condición de la regla.

Avanzado Utilice la pestaña Avanzado para seleccionar varias opcionesde alerta para la regla. Además de seleccionar la alerta que sedebe utilizar, puede especificar el tipo de acción que serealizará cuando se cumpla la condición, mantener estados dealerta para una columna específica de una vista, o consolidarvarios mensajes para un solo evento.

Condiciones de reglaUna condición de regla es una fórmula que prueba la fila en la vista empresarialasociada y busca una condición específica.

Cuando la condición existe, la acción de regla activa una alerta. Las fórmulaspueden ser pruebas sencillas para un valor en una columna de la vista, comoStatus='Resolved', o pueden ser complejas expresiones booleanas con funciones,

Capítulo 28. Reglas 319

operadores y agrupaciones de paréntesis, como (Status='Resolved' ORStatus='Assigned') AND UPPER(cust_tier)='HIGH'.

Una fórmula de condición de regla contiene cualquier número de referencias decolumna, operadores y funciones. Sin embargo, la fórmula debe cumplir losrequisitos siguientes:v El resultado de la fórmula debe ser booleano y devolver true o false.v Todas las referencias de columna deben estar presentes en las vistas

empresariales asociadas.v Sólo pueden utilizarse funciones escalares (funciones que se aplican a una sola

fila de una vista). Para ver qué funciones están disponibles, pulse Másfunciones al especificar la condición de regla. Para obtener más información,consulte: Capítulo 15, “Funciones C-SQL”, en la página 133.

Acciones de reglaLas reglas pueden tener uno de estos tres efectos. Pueden enviar alertas cada vezque existe una condición, enviar alertas una vez e ignorar los eventos posterioreshasta que se resuelva la condición, o restablecer las reglas emitidas previamentepara permitir que la regla envíe alertas.v Enviar alertas siempre que se produzca (dispare) la condición. Una acción de

disparo envía una alerta siempre que una regla identifica una condiciónexcepcional. Supongamos, por ejemplo, un centro de soporte al cliente querealiza el seguimiento de problemas de clientes como eventos de tíquet: sepodría generar una alerta cada vez que se abriera un nuevo tíquet.

v Enviar alertas una vez e ignorar los siguientes eventos hasta que se resuelva(emita) la condición inicial. Una acción de emisión envía un mensaje de alertacuando se aplica la condición de la regla, pero ignora los eventos posterioreshasta que se haya resuelto la condición inicial. Una acción de emisión resulta útilsi no desea varias alertas para situaciones en las que la condición de la regla seaverdadera para varios eventos relacionados. Por ejemplo, si se edita un tíquet deproblema de cliente abierto, no desea que se active otra alerta para el evento deedición, aunque el segundo evento todavía tenga el estado abierto.Puede enviar alertas una sola vez por cada aparición específica de la columnadesignada. Por ejemplo, para enviar una alerta cada vez que se abre un nuevotíquet de problema, puede identificar Ticket como la columna de apariciónespecífica. De esta forma, se envía una alerta para el evento de apertura de cadatíquet, pero se ignora la alerta para todos los eventos posteriores a ese tíquetmientras su estado se mantenga abierto.

v Restablecer (cancelar) reglas previamente emitidas para permitirles enviaralertas.

Ejemplos de reglasCuando una regla de emisión activa una alerta, la alerta no se vuelve a activar. Lasreglas de emisión de la alerta posteriores se ignoran hasta que una regla decancelación la restablece por primera vez.

Cuando la condición de una regla es Status=Open, el primer evento del siguienteejemplo activa la alerta, pero los eventos subsiguientes se ignoran a menos que elestado de la alerta se reduzca. Por ejemplo:Ticket Status

------ ------

0703 Open << Raise


0706 Open << Ignore

0704 Open << Ignore

0705 Open << Ignore

En este ejemplo, es más probable que le interese una alerta para cada evento Open.Puede utilizar una condición específica, que activa una instancia de la alerta paracada aparición exclusiva de los valores de las columnas especificadas:Raise someAlert when Status = ’Open’ for unique occurrencesof Ticket.

Al identificar Ticket como la columna específica, se activa una instancia de alerta yse envía un mensaje por cada evento Open que no tenga ya una instancia para elnúmero de tíquet específico. De forma similar, puede restablecer cada instancia dealerta individualmente con reglas de cancelación específicas.Lower someAlert when Status = ’Open’ for unique occurrencesof Ticket.

Si ignora los campos específicos de la regla de cancelación, la regla restablece todaslas instancias de la alerta que se emiten.

Reglas que supervisan alertasLas reglas suelen analizar las vistas empresariales para buscar métricas quecumplan condiciones específicas.

Sin embargo, las reglas también pueden supervisar alertas generadas para buscarcondiciones que requieran una mayor atención con la función IS_RAISED ().

Para obtener más información sobre la función IS_RAISED, consulte: “IS_RAISED”en la página 164.

Por ejemplo, si se envió una alerta hace 4 horas y permanece creada, otra reglapuede detectarlo y generar una nueva alerta escalada. Observe estas descripcionesde reglas, en las que EscalateAlert sólo se crea cuando OpenAlert permanececreada durante 4 horas como mínimo:Raise OpenAlert when Status= ’Open’

Reset OpenAlert when Status<> ’Open’

Raise EscalateAlert when IS_RAISED(’OpenAlert’)holds for 4 HOUR.

Reset EscalateAlert when NOTIS_RAISED(’OpenAlert’)

Alertas específicasCuando se genera una alerta para apariciones únicas de campos, el sistema realizael seguimiento de cada alerta mediante los valores de esos campos.

Supervisar una alerta y enviar una segunda cuandola primera permanece creada

Primera regla Primera alerta

Segunda Segunda

Figura 33. Se cumple la primera condición de regla

Capítulo 28. Reglas 321

Por ejemplo, la regla siguiente emite alertas y realiza el seguimiento de las queestán abiertas mediante los valores únicos del campo Ticket:Raise OpenAlert when Status = ’Open’ forunique occurrences of Ticket

Para realizar un seguimiento correcto de esta alerta, la regla con la funciónIS_RAISED() necesita la misma condición específica:Raise EscalateAlert when IS_RAISED(’OpenAlert’) holdsfor 4 HOURfor unique occurrences of Ticket

Si omite la condición específica de campo, se crea EscalateAlert sólo para laprimera alerta OpenAlert. Del mismo modo, debe restablecer las alertas concondiciones de regla específicas para los mismos campos; de lo contrario,restablecerá todas las alertas emitidas.Reset OpenAlert when Status<> ’Open’ for unique occurrences of Ticket

Reset EscalateAlert when NOTIS_RAISED(’OpenAlert’)for unique occurrences of Ticket

Registro del sistemaPuede crear una regla que supervise los mensajes del registro del sistema buscandocondiciones de error de alta prioridad y los notifique a los principalesadministradores.

Para ello, siga los pasos para supervisar registros, que se detallan en ladocumentación de IBM Cognos Real-time Monitoring Workbench.

Cognos Real-time Monitoring genera mensajes que facilitan el servicio y elmantenimiento de software, ya que crea informes adecuados para el análisis porparte de los usuarios, los administradores del sistema, los ingenieros de soporte ylos equipos de desarrollo de software. Para obtener detalles sobre el sistema deregistro, consulte la documentación de Cognos Real-time Monitoring Workbench.


Capítulo 29. Salesforce

Puede acceder e importar tablas desde un sistema de gestión de relaciones con losclientes (CRM) Salesforce.

Es un proceso que consta de dos pasos. El primer paso es la creación de un agenteSalesforce que se conecta a las tablas de Salesforce. El segundo paso es lautilización de un asistente separado de extracción para importar tablas de consultay flujos de datos de Salesforce.

Los objetos Salesforce importados se pueden utilizar como orígenes de datos paralos objetos del panel de control, como las vistas empresariales y los cubos.

Creación de un agente SalesforceUn agente Salesforce importa tablas de Salesforce para que se puedan utilizar enlas tablas de consulta y de flujos de datos.

Procedimiento1. En IBM Cognos Real-time Monitoring Workbench, pulse la pestaña Workbench.2. Pulse Actividades.3. Seleccione Crear nuevo > Agente.4. Seleccione Salesforce como tipo de agente.5. Entre un valor en Nombre y establezca Estado en habilitado.6. Entre un Nombre de usuario y un Contraseña.7. Pulse Aceptar.

Ahora, puede utilizar un asistente para importar tablas de consulta y de flujosde datos de Salesforce a IBM Cognos Real-time Monitoring Workbench.

Importación de flujos de datos y tabla de consulta desde SalesforcePuede utilizar el asistente para importar el objeto SalesForce.

Procedimiento1. En IBM Cognos Real-time Monitoring Workbench, pulse la pestaña Consola de

administración.2. En Administración, pulse Asistentes.3. En la pestaña Asistentes, pulse Asistente para importar el objeto Salesforce.4. Seleccione un agente Salesforce.5. Seleccione los usuarios que han de importarse en Lista de usuarios.6. Seleccione las tablas que se deben importar en Lista de tablas para las tablas

de flujo de datos y de consulta y pulse Añadir.Cuando añade una tabla, ésta se elimina de la Lista de tablas y se coloca en lalista de Tablas seleccionadas. Para devolverla a su posición original, pulseQuitar.

7. Pulse Aceptar.Las tablas de flujo de datos y de consulta se crean a partir de las tablasseleccionadas y se añade _events (flujo de datos) y _context (tabla de consulta)


al nombre de la tabla en Tablas y vistas. Por ejemplo, si importa una tabladenominada Account de Salesforce a una tabla de flujos de datos, el nombre deflujo de datos de ésta es Account_event.Si una tabla de la lista Tablas seleccionadas está utilizándose para un flujo dedatos o tabla de consulta, no puede eliminar ésta de Tablas seleccionadas.Primero deberá suprimir la tabla de consulta o de flujos de datos.

Función de aplanado de SalesforceExiste una función que se puede utilizar con los agentes Salesforce para aplanaruna tabla de Salesforce al crear una tabla de consulta desde un origen deSalesforce.

No obstante, la tabla solamente se puede aplanar si representa una estructura enárbol, con el nivel superior como elemento raíz del árbol. Una vez aplanada latabla, cada fila de la tabla nueva representa un nodo hoja del árbol original.

Por ejemplo, la tabla siguiente:

Tabla 90. Tabla de nodos

NodeName NodeID NodeParentId

A 1 NULL

B 2 1

C 3 1

D 4 2

E 5 2

F 6 5

G 7 5

Esta tabla puede representarse mediante el árbol siguiente. El árbol cuenta concuatro niveles, donde Level 0 tiene el elemento raíz A.

Después del aplanado, las filas de la tabla nueva representan los nodos hoja C, D,F y G.

Tabla 91. Filas de tabla que representan nodos hoja

Level0 Level1 Level2 Level3

A B D NULL

A B E F

A B E G


Tabla 91. Filas de tabla que representan nodos hoja (continuación)

Level0 Level1 Level2 Level3

A C NULL NULL

Sintaxis

La función de aplanado tiene la sintaxis siguiente:FLATTEN( tableName, idColumnName, parentIdColumnName,nameColumn, prefixForLevelColumns )

Parámetros

Los parámetros de la función se definen de la forma siguiente:v tableName

El nombre de la tabla que se aplanará.v idColumnName

La columna de identificadores de la tabla (es decir, la columna a la que se uneparentIdColumnName). Por ejemplo, en la descripción anterior, idColumnName esNodeID.

v parentIdColumnNameLa columna que contiene los ID de nodo de los nodos padre de cada fila. Porejemplo, en la descripción anterior, el nodo A tiene el ID de 1 y es el padre delnodo B. Por consiguiente, el ID padre de la columna NodeParentID para el nodoB es 1. De igual manera, el nodo padre del nodo D es el nodo B. Porconsiguiente, el NodeParentID de D es 2 porque el ID de nodo del nodo B es 2.

v nameColumnLa columna que representa los datos que se mostrarán en la tabla aplanada.

v prefixForLevelColumnsEl prefijo de cadena que se añade a la columna. En la descripción anterior, elprefijo es Level.

Comentarios

Para que la función de aplanado se ejecute correctamente, debe tener habilitado elalmacenamiento de datos en memoria caché con prerrecuperación en la tabla deconsulta. Si desea obtener más información sobre cómo habilitar el almacenamientoen memoria caché, consulte: “Almacenamiento de consultas de tabla de consulta enla memoria caché” en la página 265.

Capítulo 29. Salesforce 325

Ejemplo

El ejemplo siguiente muestra la tabla antes de ser aplanada.

El siguiente ejemplo muestra la tabla una vez que ha sido aplanada con la función:

flatten(USERROLE, ID, ParentRoleID, Name, cq_)

Función de lista de selección de SalesforceAdemás de la función de aplanado, existe también una función de lista deselección que se puede utilizar con los agentes Salesforce. Esta función de lista deselección devuelve un conjunto de datos con una sola columna que incluye losvalores posibles para una columna con tipo de lista de selección en Salesforce.

Sintaxis

La función de lista de selección tiene la sintaxis siguiente:PICKLIST( tableName,pickListColumn )

Parámetros

Los parámetros de la función se definen de la forma siguiente:v tableName

El nombre de la tabla desde la que se devuelve el conjunto de datos de una solacolumna.

v pickListColumnLa columna de la tabla especificada por tableName que se devolverá.

Comentarios

Para que la función de lista de selección se ejecute correctamente, debe tenerhabilitado el almacenamiento de datos en memoria caché con prerrecuperación enla tabla de consulta. Para obtener información detallada sobre cómo habilitar el


almacenamiento en la memoria caché, consulte: “Almacenamiento de consultas detabla de consulta en la memoria caché” en la página 265.

La columna que se devuelve debe ser una columna con tipo de lista de selección.

Ejemplo

La función de lista de selección siguiente devuelve el conjunto de datos de losvalores posibles de la columna LeadSource en la tabla Opportunity.picklist(opportunity,leadsource)

La ilustración siguiente muestra la tabla Opportunity:

La función de lista de selección recupera la columna LeadSource.

Consola de administración de SalesforcePara obtener una cuenta Salesforce.com, debe tener acceso a la consola deadministración de IBM Cognos Real-time Monitoring for AppExchange.

Para acceder a la consola, especifique la siguiente dirección en el navegador:http://[hostLocal]:[puerto]/[ubicaciónInstalación]/jsp/salesforceadmin.jsp

En la página que aparece, especifique la información solicitada.

Figura 34. Tabla Opportunity

Figura 35. Columna recuperada por la función de lista de selección

Capítulo 29. Salesforce 327

Al pulsar Enviar, recibirá un mensaje de correo electrónico en el que se confirmaque la solicitud se ha enviado correctamente. También se le informa de que unrepresentante se pondrá en contacto con usted para confirmar el envío yproporcionarle información sobre los pasos siguientes para completar el proceso deconfiguración.


Capítulo 30. Conectividad SAP

Puede acceder a tablas de hechos e importarlas en forma de objetos y cubos ODSdesde un sistema SAP.

Este proceso consta de tres pasos. El primer paso es la creación de un agente JDBCestándar que se conecta a la base de datos SAP. El segundo es la creación de unagente ERP que utiliza un agente JDBC de metadatos de SAP para acceder alsistema SAP como tipo de origen. El tercer paso es la utilización de un asistenteseparado de extracción para importar objetos ODS o cubos OLAP.

Los cubos y objetos ODS importados se pueden utilizar como orígenes de datospara los objetos del panel de control, como las vistas empresariales y los cubos.

Creación de un agente SAPUn agente SAP es un agente ERP (Enterprise Resource Planning) que utiliza unagente JDBC para acceder a la base de datos del sistema SAP.

Procedimiento1. En IBM Cognos Real-time Monitoring Workbench, pulse la pestaña Workbench.2. Pulse Actividades.3. Seleccione Crear nuevo > > Agente.4. Seleccione ERP como tipo de agente.

Una vez seleccionado el tipo de agente, se vuelven a mostrar los valoressiguientes para indicar la configuración adecuada para ese tipo.

5. Entre un valor en Nombre y establezca Estado en Habilitado.6. En Tipo de origen ERP, seleccione SAP-BW.7. En Agente de datos, seleccione Capa de aplicación SAP. También puede utilizar

un agente JDBC para conectar con la base de datos SAP. Para obtenerinstrucciones para crear un agente JDBC, consulte: “Agentes Java DatabaseConnectivity” en la página 236.

8. Complete los Valores de conectividad según sea necesario, cumplimentandolos campos siguientes:v Nombre de usuariov Contraseñav Idiomav ASHostv Clientev Número de sistemav Host de la pasarelav Servidor de la pasarela

9. Pulse Aceptar.Ahora puede utilizar un asistente para importar objetos ODS (consulte:“Importación de objetos de almacén de datos operativos” en la página 330) ycubos OLAP (consulte: “Importación de cubos OLAP” en la página 330).


Importación de objetos de almacén de datos operativosPuede importar objetos de almacén de datos operativos (ODS) como secuencia dedatos o una tabla de consulta.

Para obtener más información, consulte: Capítulo 10, “Flujos de datos”, en lapágina 85 y Capítulo 20, “Tablas de consulta”, en la página 261.

Procedimiento1. Abra la Consola de administración de Workbench.2. En Administración, pulse Asistentes.3. En la pestaña Asistentes, pulse Asistente para importar objetos ODS.4. Seleccione un agente ERP existente.5. Seleccione el Grupo de información que contiene el objeto ODS de su interés.6. En la lista desplegable Tabla para importar, seleccione la tabla de hechos de su

interés.7. Elija si desea importar el objeto ODS como tabla de flujo de datos o de

consulta.8. Pulse Aceptar.

Importación de cubos OLAPPuede utilizar el Asistente para importar cubos ERP.

Procedimiento1. Abra la Consola de administración de Workbench.2. En Administración, pulse Asistentes.3. En la pestaña Asistentes, pulse Asistente para importar cubos ERP.4. Seleccione un agente ERP.5. Seleccione el cubo que desea importar.6. En el campo Importar como, acepte el valor predeterminado automático (los

mismos nombres que en SAP) o especifique un nuevo nombre, que se utilizarápara identificar el cubo importado en Workbench.

7. Pulse Aceptar.


Capítulo 31. Escenarios

Un escenario es una colección de reglas, alertas y reportlets que identificancondiciones empresariales excepcionales.

Las reglas del escenario son las pruebas que determinan cuándo existe la condiciónexcepcional o cuándo deja de existir.

La supresión o inhabilitación de un escenario suprime o inhabilita las reglas,alertas y reportlets que contiene.

Cada escenario presenta determinados atributos.

Tabla 92. Atributos de escenario


Estado de la carpeta Especifica si la regla está habilitada (recibiendo datos nuevos) oinhabilitada. Cuando un escenario está inhabilitado, todas susreglas, alertas y reportlets también están inhabilitados. Cuando laactividad empresarial que lo contiene está inhabilitada, no sepuede habilitar el escenario. Se debe habilitar la actividadempresarial del escenario antes de habilitar el escenario.

Nombre del escenario Identifica el objeto de escenario. El nombre puede contener sóloletras y números. Este nombre debe ser exclusivo entre escenarios.Para obtener información, consulte: “Espacio de nombres deobjeto” en la página 277.

Descripción Descripción opcional del escenario que puede contener cualquiercarácter de texto.

Vista predeterminada Identifica la vista predeterminada (consulte: Capítulo 36, “Vistas”,en la página 361) que supervisan las reglas de este escenario, y losreportlets que aparecerán. Si se selecciona No hay vistapredeterminada, es obligatorio escoger una vista para las reglas ylos reportlets cuando se crean. Si se selecciona el botón Vistaexistente se podrá seleccionar una vista existente en IBM CognosReal-time Monitoring Workbench.

Actividad empresarial

Escenario

Escenario

Las actividades empresarialesson colecciones de escenariosposibles

Los escenarios identificancondiciones excepcionales dentrode una activiada empresarial

ReglaReglaReglaAlertaReportlet

ReglaAlerta

Figura 36. Actividad empresarial con dos escenarios


Tabla 92. Atributos de escenario (continuación)


Nombre de vista Nombre de la vista que se utilizará para el escenario. Este atributosólo está disponible si se selecciona Vista existente. PulseExaminar para seleccionar la vista.

Creación de escenariosPuede crear un escenario.

También puede suprimir escenarios.

Atención: Al suprimir un escenario se suprimen las reglas, las alertas y losreportlets que contiene el escenario. Una vez finalizada la supresión, las reglas, lasalertas y los reportlets no pueden restaurarse.

Antes de empezar

Para crear un escenario, debe disponer de los siguientes permisos:v Permisos de creación (consulte: Capítulo 23, “Permisos”, en la página 291) para

actividades empresariales (consulte: “Cómo otorgar permiso para crear objetos”en la página 294 para obtener información detallada)

v Permisos de lectura y escritura (consulte: Capítulo 23, “Permisos”, en la página291) para la actividad empresarial que contendrá el escenario

v (Opcional) Permiso de sólo lectura para la vista predeterminada para elescenario.

Procedimiento1. Abra el Modelador de escenarios.2. Seleccione una de las Actividades empresariales, que contendrá el escenario.3. Pulse en Nuevo escenario.4. Complete los campos de la ventana Crear escenario. Para suprimir un

escenario, seleccione el escenario que se deba suprimir y pulse Eliminarescenarios.


Capítulo 32. Sentencias SELECT

Las sentencias C-SQL SELECT definen las vistas que gestionan la información enIBM Cognos Real-time Monitoring.

IBM Cognos Real-time Monitoring Workbench construye sentencias SELECTbasadas en las vistas definidas en la interfaz gráfica de usuario, y luego lastransfiere al servidor o servidores Real-time Monitoring para la instanciación.

Para ver la sentencia SELECT completa que define una vista en Cognos Real-timeMonitoring Workbench, pulse la opción Mostrar expresión SQL al crear o editaruna vista.

Algunas de las características avanzadas del comando SELECT no puedenexpresarse mediante las opciones de Real-time Monitoring Workbench. Porejemplo, las condiciones de unión complejas, las ventanas de consulta y lasexpresiones de tabla deben especificarse en la interfaz de usuario.

En esta sección se describe detalladamente la sintaxis y las características delcomando C-SQL SELECT.

El comando C-SQL SELECT es un subconjunto y extensión de ANSI SQL-99, unestándar de lenguaje de consulta. La implementación de C-SQL soporta unionesexternas mediante la sintaxis de unión externa ANSI (unión externa izquierda yunión externa derecha) y funciones de agregación en la cláusula SELECT. Cadasentencia individual se considera una transacción y se confirma tan pronto como seejecuta.

SintaxisLa especificación SELECT se define mediante varios operadores.

Estos operadores son:SELECT selectList

FROM joinClauses

[ WHERE searchCondition ]

[ GROUP BY groupClause ]

[ WINDOW windowClause ]

[ ORDER BY orderClause ]

Los operadores se aplican en el orden siguiente:1. La “Cláusula FROM” en la página 336 especifica las tablas o vistas base que

proporcionan datos a esta vista.2. La “Cláusula WHERE” en la página 339 (opcional) filtra la entrada para que

coincida con los criterios especificados.3. La “cláusula GROUP BY” en la página 340 (opcional) agrupa la tabla

resultante en una o varias columnas.4. La “Lista de selección” en la página 334 define las columnas que deben

aparecer en la tabla resultante.


5. Las Capítulo 38, “Ventanas de consulta”, en la página 389 (opcionales) definenlas ventanas utilizadas por las funciones de agregado en la lista de selección.

6. La “Semántica de vista completa” en la página 342 ORDER BY (opcional)ordena la tabla resultante.

Lista de selecciónLa sentencia de lista de selección define las columnas que aparecen en las tablasvirtuales resultantes.

La lista de selección aparece inmediatamente después de la palabra clave SELECTy tiene dos formas:v Un asterisco (*) para elegir todas las columnas que forman parte de la tabla de

origen.SELECT * ...

La vista resultante contiene las columnas de cada una de las tablas o vistas deentrada, en el orden en que aparecen en el origen, y en el orden indicado en lacláusula FROM (consulte: “Cláusula FROM” en la página 336). En el caso de lasuniones externas (consulte: “Uniones externas” en la página 337), se asignanvalores NULL a las columnas resultantes que no existen en ambas referencias.

v Una lista de nombres de columna exclusivos o columnas derivadas.SELECTcolumnNameList

Donde cada nombre de columna (columnName) está separado por una coma (,)y se define comocolumnName[[AS] aliasName [ OVER (windowClause) ] ]

La opción AS asigna un nombre nuevo a la columna asociada. La opción "AS"literal es opcional.La opción OVER define una ventana en línea. Para obtener más información,consulte: Capítulo 38, “Ventanas de consulta”, en la página 389.Donde cada nombre de columna (columnName) tiene uno de estos orígenes:– referencia de columna simple (nombre de la columna).

current_rental_price

– referencia de columna cualificada (precedida por el nombre de tabla).

movie_titles.current_rental_price

Para seleccionar todas las columnas de una tabla mientras se seleccionanalgunas columnas de otras tablas, utilice una referencia de columnacualificada y especifique un asterisco (*) para el nombre de columna. Porejemplo, con el código siguiente se seleccionan todas las columnasmovie_titles y dos columnas de la tabla media:

movie_titles.*, media.media_type, media.name

– columna derivada (una expresión, posiblemente una expresión CASE). Paraobtener más detalles, consulte: “Expresión CASE” en la página 335:MAX((movie_titles.current_rental_price/2))AS Half_Price

Para columnas derivadas, el valor de aliasName es necesario.


Expresión CASEUna expresión CASE devuelve el resultado de una expresión que corresponde auna condición verdadera coincidente. Opcionalmente, en lugar de ello cadacondición puede devolver NULL.

Si no se encuentra ninguna condición que sea verdadera, la expresión devuelve elresultado de la condición ELSE o bien NULL cuando se omite ELSE.

Hay dos tipos de expresión CASE:v Condición simple

Evalúa la caseExpression y la compara con el resultado de cadaequalsExpression hasta que encuentra uno que coincide y, a continuación,devuelve el resultado correspondiente de resultExpression. CadaequalsExpression debe ser de un tipo comparable con caseExpression.CASEcaseExpression

[ { WHEN equalsExpression THEN { resultExpression| NULL }}...]

[ ELSE { resultExpression | NULL } ]

END

v Condición de búsquedaEvalúa cada searchCondition hasta que se encuentra una que sea verdadera ydevuelve el resultado correspondiente de resultExpression.CASE WHENsearchExpression THEN { resultExpression | NULL }

[ { WHEN searchExpression THEN { resultExpression| NULL }}...]

[ ELSE { resultExpression | NULL } ]

END

Estas expresiones CASE tienen el mismo resultado:SELECT Tier AS

CASE WHEN Tier = ’High’ THEN ’Priority customer’

...

SELECT Tier AS

CASE Tier WHEN ’High’ THEN ’Priority customer’

...

El código siguiente es un ejemplo que genera totales acumulados para cadaestado de tíquet en cada nivel:CREATE VIEW VTotal_Tickets AS

SELECT Tier,

SUM(CASE Status WHEN Open THEN 1 ELSE 0 END)AS Opens,

SUM(CASE Status WHEN Reopen THEN 1 ELSE 0 END)AS Reopens,

SUM(CASE Status WHEN Resolved THEN 1 ELSE 0 END)AS Closes,

( Opens+Reopens-Closes) AS Pending

FROM VCustomerTickets

GROUP BY Tier

La tabla siguiente muestra los resultados posibles:

Capítulo 32. Sentencias SELECT 335

Tabla 93. Resultados de la expresión CASE

Nivel Opens Reopens Closes Pending

Alto 2 0 0 2

Medio 1 2 3 0

Bajo 1 1 1 1

Cláusula FROMLa cláusula FROM especifica las tablas y las vistas a partir de las que se crea lavista nueva.FROM reference [[ AS ] aliasName ]

[, reference [[ AS ] aliasName ] ... ]

Cuando una referencia es:v Referencia simple:

tableOrView

v Operación de unión (para obtener información, consulte: “Operaciones deunión”):( reference [ {LEFT | RIGHT} [ OUTER] | INNER ]

JOIN reference ON searchCondition )

v Expresión de tabla (para obtener información, consulte: “Expresiones de tabla”en la página 338):(SELECT selectList FROM joinClauses [ WHEREsearchCondition ]

[ GROUP BY groupClause ] [ WINDOW windowClause ])

Al especificar una única referencia simple, se crea una vista que es una instantáneade la tabla de origen o de la vista de origen. Si se incluye más de una referencia, seespecifica una operación de unión.

Restricciones de vistaLas vistas tienen restricciones de los orígenes de la cláusula FROM.

Estas restricciones incluyen:v Una vista se puede derivar de una tabla de flujos de datos u otra vista.v Una vista puede unir una vista o tabla de flujos de datos, y una o varias tablas

de consulta.v Una vista no puede unir dos o más vistas o tablas de flujos de datos basadas en

tablas de flujos de datos diferentes. Un flujo de datos consolidado es un casoespecial de unión de tablas de flujos de datos.

v Una vista no se puede derivar sólo de tablas de consulta.

Operaciones de uniónC-SQL SELECT soporta varias operaciones de unión.

Estas operaciones de unión incluyen:v “Uniones cruzadas” en la página 337v “Uniones internas” en la página 337


v “Uniones externas”v “Uniones anidadas” en la página 338

Si se incluye más de una referencia, se genera una operación de unión. La vistaresultante es una unión cruzada, a menos que utilice el operador JOIN paraespecificar una condición de unión de otro tipo o bien incluya una cláusulaWHERE (consulte: “Cláusula WHERE” en la página 339) que especifique unacondición de unión.

Uniones cruzadasSi omite el operador JOIN, define una vista que es una unión cruzada de las vistasde entrada (también denominado producto cartesiano).

En el ejemplo siguiente se muestra una unión de las vistas Product yManufacturer:FROM Product AS P, Manufacturer AS M

No cree una unión cruzada si no está totalmente seguro. Una unión cruzada creauna vista cuyo recuento de filas es igual al recuento de filas de la primera vistamultiplicado por el recuento de la segunda vista (filas unión = filas vista1 * filasvista2). Esto afecta en gran medida al sistema, y habitualmente no produce la vistaque desea.

En lugar de crear una unión cruzada, especifique otro tipo de unión con lacláusula JOIN:reference [ joinType ] JOIN reference ON searchCondition

Uniones internasLa cláusula JOIN realiza una unión interna a menos que especifique una variablede tipo joinType. En una unión interna, las filas de la tabla de resultados son lasfilas de la primera tabla que cumplen los criterios especificados, junto con las filascorrespondientes de la segunda tabla que cumplen los criterios especificados.FROM (Product AS P INNER JOIN ManufacturerAS M

ON P.productName = M.ProductName)

Las uniones internas en ocasiones se denominan uniones equivalentes.

Uniones externasUna unión externa es una unión donde las filas de una tabla de resultados son lasfilas que se generan a partir de una unión interna, más las filas de la primera tabla(LEFT OUTER JOIN) o la segunda tabla (RIGHT OUTER JOIN) que no teníancoincidencias en la otra tabla.

Por ejemplo:FROM (Product AS P LEFT OUTER JOIN ManufacturerAS M

ON P.productName = M.ProductName

La primera tabla de una LEFT OUTER JOIN y la segunda tabla de la RIGHTOUTER JOIN debe ser una tabla de flujos de datos o una vista. La primera tablano puede ser una tabla de consulta.


A las columnas resultantes que no existen en ambas referencias se les asignanvalores NULL.

Uniones anidadasLas uniones se pueden anidar. No existe ningún nivel máximo con respecto alnivel máximo de anidación.

Por ejemplo:FROM (Product AS P LEFT OUTER JOIN Manufacturer AS M

ON P.productName = M.ProductName)

AS Temp, inventoryContext AS INVvt

Expresiones de tablaUna expresión de tabla, también denominada vista en línea, es una subconsultaque crea una vista a la que puede hacer referencia la consulta contenedor.Básicamente es una sentencia SELECT, limitada por paréntesis, que aparece en lacláusula FROM.

Por ejemplo, el código siguiente es una expresión de tabla contenida en unaconsulta:SELECT *

FROM Warehouse AS wh,

(SELECT *

FROM WarehouseQtyChange AS wqc,

Product AS pr

WHERE wqc.wprod_id = pr.pprod_id)AS sv,

WHERE sv.warehouse_id = wh.wh_region_id

El ejemplo anterior tiene el mismo resultado que WHRegionView en este ejemplo:SummaryView:

SELECT *

FROM WarehouseQtyChange AS wqc,

Product AS pr

WHERE wqc.wprod_id = pr.pprod_id

WHRegionView:

SELECT *

FROM Warehouse AS wh,

SummaryView AS sv

WHERE sv.warehouse_id = wh.wh_region_id

SintaxisUna expresión de tabla es una sentencia SELECT limitada, encerrada entreparéntesis y con restricciones.( SELECT selectList FROM joinClauses

[ WHERE searchCondition ]

[ GROUP BY groupClause ]

[ WINDOW windowClause ] ) AS aliasName


RestriccionesLas vistas en línea tienen las mismas restricciones semánticas que las vistasestándar.

Por ejemplo, una columna derivada en una vista en línea no puede tener el mismonombre alias que una columna de la lista selectList que la contiene. También tienenrestricciones y limitaciones.

Las restricciones y limitaciones incluyen:v Debe estar encerrada entre paréntesis.v Debe tener la misma tabla de flujos de datos base que las demás vistas y tablas

de la consulta que la contiene.v Se debe definir sólo en la cláusula FROM.

Ejemplo de cláusula HAVINGAlgunas implementaciones de SQL incluyen una cláusula HAVING que puedeutilizarse para filtrar los resultados agregados de una vista. C-SQL no incluyecláusulas HAVING. Sin embargo, puede construir una cláusula HAVINGutilizando una cláusula WHERE.

Una cláusula WHERE (consulte: “Cláusula WHERE”) filtra los resultados de unavista en línea. Básicamente:SELECT * FROM (inlineView) WHERE filterCondition

Por ejemplo, para crear una vista que filtre el resultado de una agregación, primerose debe realizar la agregación en una vista en línea, y a continuación se debenfiltrar los resultados con la vista que los contiene. La vista en línea siguiente sumael total de ventas de cada línea de producto y, a continuación, la vista que locontiene muestra en orden descendente sólo los resultados que sean superiores a1.000.000 $.SELECT FamilyTotals.family AS "Product Line",

FamilyTotals.sales_for_family AS "Total Sales"

FROM (SELECT family,

SUM(total_price) AS sales_for_family

FROM OrdQtyDemand

GROUP BY Family

) AS FamilyTotals

WHERE "Total Sales" > 1000000

ORDER BY "Total Sales" DESC;

En el ejemplo anterior, a medida que entran eventos nuevos en la vistaOrdQtyDemand, se actualizan los totales y puede cambiar el orden de las familiasde productos. En la vista pueden entrar nuevas familias, ya que sus totales deventas son superiores a un millón.

Cláusula WHEREUna cláusula WHERE examina cada fila de la entrada y acepta sólo las quecoincidan con la condición especificada.

La sintaxis es:WHERE searchCondition


Una searchCondition es una combinación de predicados booleanos que juntosforman una prueba. Sólo las filas de entrada que superan la prueba se insertan enla nueva vista. Las filas que no cumplen la condición se descartan, no se les realizaningún seguimiento y no se incluyen en los cálculos de una función de conjunto,función de conjunto móvil o función de clasificación.

Todas las vistas dependientes se actualizan y sus funciones se vuelven a calcular,independientemente de si la entrada ha cumplido la condición. Para obtener másinformación, consulte: “Actualización de vistas mediante la propagación deeventos” en la página 368.

PredicadosUn predicado es una expresión booleana que afirma un hecho acerca de losvalores. Cada expresión puede definirse sola o en comparación con uno de losvalores booleanos de prueba.

Por ejemplo, estas expresiones son equivalentes:WHERE (Age >= 21)

WHERE (Age >= 21) IS TRUE

Los predicados que soporta la cláusula WHERE se incluyen en Capítulo 22,“Operadores y constantes”, en la página 287.

Los predicados pueden incluir funciones, pero las funciones que hacen referencia alas columnas pueden hacer referencia sólo a columnas de eventos.

AliasC-SQL amplía el estándar ANSI para permitir referencias de alias en la cláusulaWHERE.

Por ejemplo:SELECT user_age AS Age

FROM user_list

WHERE (Age >= 21)

cláusula GROUP BYLa cláusula GROUP BY agrupa la tabla virtual resultante como una o variascolumnas.

La sintaxis es:GROUP BY [tableName.]columnName[ , [tableName.]columnName... ]

Donde tableName es una tabla o vista de origen. Todas las columnName de la listade selección a los que no haga referencia directamente una función de clasificacióno escalar deben aparecer en la lista GROUP BY.

Otra forma más útil de agrupar datos es mediante la cláusula PARTITION deventanas. Para obtener información, consulte: “Particiones de ventana” en lapágina 399.


La opción GROUP BY genera información de resumen para grupos de filas quepresentan los mismos valores en los campos seleccionados. Observe este conjuntode datos:Name Quantity

------------ --------

Nano Webber 10

Fizzy Lifter 700

Nano Webber 50

Nano Webber 20

Nano Webber 15

Smoke Shifter 310

Si crea una vista que agrupe por nombre y determine la suma de la cantidad paracada grupo, se parecería a ésta:SELECT product.name AS Name, SUM(product.quantity) ASQsum

FROM product

GROUP BY product.name

Name Qsum

------------ ----

Nano Webber 95

Fizzy Lifter 700

Smoke Shifter 310

También puede agrupar por varios campos. Por ejemplo:SELECT product.name AS Name, product.location AS Locale,

SUM(product.quantity) AS Qsum

FROM product

GROUP BY product.name, product.location

Name Location Qsum

------------ -------- ----

Nano Webber West 10

Fizzy Lifter East 700

Nano Webber East 85

Smoke Shifter West 310

Cuando la lista de selección incluye una función de conjunto móvil, cada grupocontiene un resultado para el conjunto móvil.

AliasC-SQL amplía el estándar ANSI para permitir referencias de alias en la cláusulaGROUP BY.

Por ejemplo:SELECT product.name AS Name,product.locationAS Locale,

SUM(product.quantity) AS Qsum

FROM product

GROUP BY Name, Locale


Vistas derivadasCuando se define una vista con una cláusula GROUP BY, ninguna vista derivadade esa vista tiene una cláusula GROUP BY implícita. Esto se conoce comocombinación de vistas o expansión de vistas.

Por ejemplo, en la siguiente ilustración, aunque la sentencia SELECT para View2no incluya una cláusula GROUP BY, el resultado incluye los mismos grupos queView1.

En la ilustración, las tablas Data_Stream y Lookup_Table se utilizan en la siguientesentencia SELECT para crear View1.SELECT Name,Qty, Cost FROM Data_Stream, Prices GROUPBY Name WHERE Data_Stream.Name=Lookup_Table.Name

View2 se crea a partir de View1 con la siguiente sentencia:SELECT Name,(Qty*Cost)AS Total from View1

Semántica de vista completaCuando una vista contiene una cláusula GROUP BY, se denomina vista completa.Mantiene la información de eventos anteriores, no sólo la del evento más reciente.

En “Vistas derivadas”, la vista View2 es completa aunque su definición SELECT nocontenga una función de conjunto ni una cláusula GROUP BY explícita; escompleta porque se deriva de una vista completa.

Para obtener más información, consulte: “Vistas completas y sin estado” en lapágina 368.

Cláusula ORDER BYLa cláusula ORDER BY ordena (clasifica) la vista resultante en base a los nombresde las columnas o los resultados de las expresiones.

La sintaxis es:ORDER BY columnName [{ASC|DESC}] [ , [columnName [{ASC|DESC}]] ...

Sin esta cláusula, no existe ninguna garantía de que la misma consulta produzcafilas en el mismo orden en consultas posteriores.

Cualquier tecla de ordenación mencionada en la cláusula ORDER BY debe referirsea un nombre de columna de la lista de selección.

Figura 37. Ejemplo de una vista derivada


De forma predeterminada, la vista se ordena de forma ascendente (ASC). Paraordenar de forma descendente, especifique la opción DESC.

El código siguiente es un ejemplo que ordena la vista primero por nombre deproveedor en orden ascendente y, a continuación, por precio en orden descendentedentro de cada proveedor:SELECT Product.prod_id AS ProductID,

orderStatusDataStream.OS_PRICE AS Price,

Supplier.supp_name AS SupplierName

FROM orderStatusDataStream, Product, Supplier

WHERE orderStatusDataStream.OS_PROD_ID = Product.prod_idAND

Product.prod_supp_id = Supplier.supp_id

ORDER BY Supplier.supp_nameASC, orderStatusDataStream.OS_PRICE DESC



Capítulo 33. TIBCO Rendezvous

TIBCO Rendezvous es un sistema de mensajería para aplicaciones empresariales.

Las aplicaciones empresariales publican mensajes en la secuencia gestionada porlos servidores de transporte de TIBCO Rendezvous. Cada mensaje tiene un nombreque identifica el asunto del mensaje.

Otras aplicaciones supervisan la secuencia que busca los mensajes que, cuando seencuentran, se proporcionan a otras aplicaciones, como los agentes de TIBCORendezvous de IBM Cognos Real-time Monitoring (consulte: “Agentes TIBCORendezvous” en la página 37).

Funcionamiento de TIBCO RendezvousLas tablas de flujos de datos de IBM Cognos Real-time Monitoring reciben losmensajes de TIBCO Rendezvous como eventos. Cada tabla de flujos de datoscorresponde al asunto de un solo mensaje. Las tablas identifican los asuntos de losmensajes para una aplicación daemon de escucha a través del agente. Cuando eldaemon encuentra un mensaje nuevo con el asunto solicitado, pasa el mensaje a latabla a través del agente. A continuación, la definición de tabla correlaciona elmensaje dentro de la tabla como un evento nuevo.

Tablas de TIBCO RendezvousUna tabla de flujos de datos para TIBCO Rendezvous recibe mensajes de unaaplicación empresarial a través de un flujo de mensajes de TIBCO Rendezvous.

Cada mensaje está identificado por un asunto, y cada nuevo mensaje para unasunto es un nuevo evento. Cuando la tabla recibe un nuevo mensaje, primerocorrelaciona los datos del mensaje con los tipos de datos de la tabla de flujos dedatos.

LimitacionesTodos los mensajes con el asunto de un evento deben tener la misma forma: cadamensaje debe tener los mismos campos, aunque algunos campos pueden estarvacíos.

Las aplicaciones publicanmensajes a través de TIBCO Rendezvous por asuntos, cadauno de los cuales se correlacionacon eventos nuevos

Tabla de consulta

Nuevo evento sobreAsuntoX

Agente

Nuevo mensaje sobreAsuntoX

Productor deTIBCO Rendezvous

A la escucha de AsuntoX A la escucha de AsuntoX

Figura 38. Funcionamiento de TIBCO Rendezvous


Algunos tipos de datos de TIBCO Rendezvous no se soportan y no se puedencorrelacionar en una tabla de flujos de datos.

Para obtener más información, consulte: “Tipos de datos de TIBCO Rendezvous”en la página 350.

Creación de una tabla de flujos de datos para TIBCO RendezvousEn esta sección se describe cómo crear una tabla de flujos de datos para TIBCORendezvous.

Para obtener más información, consulte: “Información de la columna de TIBCO” enla página 348.

Antes de empezar

Antes de crear un flujo de datos de TIBCO Rendezvous, debe tener los requisitosprevios siguientes:v Permiso

Cree permisos (consulte: Capítulo 23, “Permisos”, en la página 291) para tablas(consulte: “Cómo otorgar permiso para crear objetos” en la página 294) ypermiso de sólo lectura al agente que proporciona datos a la tabla.

v Un agenteUn agente TIBCO Rendezvous existente que conecte con la secuencia demensajes de TIBCO Rendezvous. Crear un agente mediante la pestañaWorkbench Administration. Para obtener información, consulte: “Agentes TIBCORendezvous” en la página 37.

v Nombre del asuntoCada mensaje de TIBCO Rendezvous contiene un nombre de asunto queidentifica el origen de eventos. El usuario identifica el nombre del asunto y elagente supervisa la secuencia de mensajes buscando los mensajes. Cuando elagente encuentra un mensaje con ese asunto, el agente transfiere la informacióndel mensaje a la tabla de flujos de datos. Los nombres de asunto constan de unoo más elementos separados por caracteres de punto, por ejemplo:SUPPORT.TICKETS.

v Formato del mensajeCada mensaje de TIBCO Rendezvous contiene campos de información. Estainformación puede contener mensajes anidados, un asunto y cabeceras de tipo"responder a". Para obtener más información, consulte: “Información de lacolumna de TIBCO” en la página 348.

v Un archivo de ejemplo (opcional)Si el mensaje tibco_complex_string contiene una cadena compleja, resulta útildisponer de un archivo de ejemplo que contenga datos en el formato de lacadena de eventos real. Puede utilizarse este ejemplo al crear el flujo de datospara garantizar que los campos se correlacionen correctamente con la tabla deflujos de datos viendo cómo se alinean los datos en las columnas.

Para obtener información sobre el nombre del asunto y el formato del mensaje,consulte al especialista en IT encargado de mantener el sistema TIBCORendezvous. En la siguiente tabla se describen los atributos de una tabla de flujosde datos TIBCO Rendezvous:


Tabla 94. Atributos de tabla de flujos de datos TIBCO Rendezvous


NombreIdentifica el objeto de flujo de datos.



Guardar en Especifica la carpeta en la que se almacenará el objeto de flujode datos. Para seleccionar o crear una carpeta, pulse el botónSeleccionar carpeta. Si no especifica ninguna carpeta, el valorpredeterminado es Carpeta pública.


Habilitar recuperaciónCuando está habilitado, registra los datos de un evento que sereciben después de que se inicie el punto de comprobación.Este registro de recuperación se utiliza para restaurar elestado del sistema después de un cierre anómalo de losservidores. Para obtener más detalles, consulte la informaciónsobre el punto de comprobación y la recuperación en lapublicación IBM CognosReal-time Monitoring Workbench Guíadel usuario.


Seleccione esta opción cuando los eventos deban procesarseen el orden en el que se reciben. De otro modo, si los eventosse pueden procesar en otro orden, inhabilite este atributo.

Para unir los eventos en una vista, los eventos se debenprocesar por orden. Deje esta opción habilitada para unir loseventos.

Agente TIBCORendezvous

Agente existente que conecta con la secuencia de mensajes deTIBCO Rendezvous. Crear un agente mediante la pestañaWorkbench Administration. Para obtener información,consulte: “Agentes TIBCO Rendezvous” en la página 37.

Subscripción Identifica el asunto con el que se está enviando el mensaje,definido por el editor del mensaje. Normalmente, esta cadenatiene un aspecto parecido a ésta: com.cognos.obi.mytibcotopic.


Los campos de Información de la columna definen cómocorrelacionar los campos del mensaje de TIBCO Rendezvouscon las columnas de la tabla de flujos de datos. Hay unacolumna por cada campo en la tabla de flujos de datos. Paraobtener más información, consulte: “Información de lacolumna de TIBCO” en la página 348.

Borrar intervalo de estados Esta pestaña contiene varias opciones para borrar datos deeventos persistentes. Para obtener más información, consulte:“Intervalo de borrado de estados” en la página 60.

Capítulo 33. TIBCO Rendezvous 347

Procedimiento1. En IBM Cognos Real-time Monitoring Workbench, pulse la pestaña Workbench.2. Pulse Actividades.3. Pulse Crear nuevo > Flujo de datos.4. Seleccione TIBCO RV como tipo de flujo de datos.5. Identifique el asunto de los eventos de mensaje que han de recopilarse.6. Seleccione un agente TIBCO Rendezvous existente.7. Identifique los campos en el mensaje y cómo han de correlacionarse con los

tipos de datos de IBM Cognos Real-time Monitoring.8. Opcionalmente, establezca el intervalo de borrado de estado en la pestaña

Borrar intervalo de estados.9. Guarde la tabla TIBCO Rendezvous.

Información de la columna de TIBCOLos campos de Información de la columna definen cómo correlacionar los camposdel mensaje de TIBCO Rendezvous con las columnas de la tabla de flujos de datos.

Hay una columna por cada campo en la tabla de flujos de datos.

Cada campo del mensaje puede ser un campo simple que se correlacionedirectamente con una columna de una tabla de flujos de datos, o puede ser uncampo complejo (un campo de archivo sin formato) que contenga varios camposque se correlacionen de forma individual con las columnas de la tabla. Los camposcomplejos se tratan como archivos sin formato en formatos delimitados (CSV), deanchura fija o XML. Para obtener una descripción detallada de estos tipos dearchivo, consulte: Capítulo 13, “Archivos sin formato”, en la página 103.


Tabla 95. Atributos de columna TIBCO Rendezvous


Nombre de campo Nombre de la columna en la tabla de flujos de datos.

Nombre de mensaje Nombre del campo en el mensaje. Al correlacionar un campo demensaje, el nombre de cada campo incluido es No disponible yno es editable.

Tipo de datos Tipo de datos de la columna. Para obtener más información,consulte: “Tipos de datos de TIBCO Rendezvous” en la página350.

Formato (Opcional) Formato de la columna de eventos para valoresVARCHAR (cadena) y DECIMAL.

Se añaden columnas pulsando Agregar campo o Agregar campo de archivo sinformato.

Se pueden añadir columnas para el asunto del mensaje y la respuesta. Paracorrelacionar el asunto con una columna de la tabla de flujos de datos, especifique<tibcosubject> como nombre de campo. Para las respuestas, especifique<tibcoreply>.


En los casos en los que hay un campo contenido en un mensaje incluido, se puedeespecificar el campo que se va a correlacionar con la columna de la tabla de flujosde datos sin notación por puntos. Por ejemplo, para correlacionar el campo ddentro del mensaje c que está incluido dentro del mensaje a, que a su vez estáincluido en el mensaje b, especificaría el nombre de campo como <a.b.c.d.

Añadir un campo de mensajeCada campo del mensaje puede ser un campo simple que se correlacionedirectamente con una columna de una tabla de flujos de datos, o puede ser uncampo complejo (un campo de archivo sin formato) que contenga varios camposque se correlacionen de forma individual con las columnas de la tabla.

Los campos complejos se tratan como archivos sin formato en formatosdelimitados (CSV), de anchura fija o XML. Para obtener una descripción detalladade estos tipos de archivo, consulte: Capítulo 13, “Archivos sin formato”, en lapágina 103.

Procedimiento1. Pulse en Agregar campo de archivo sin formato.

Un campo de archivo sin formato crea un campo de mensaje de camposincluidos, cada uno de los cuales se correlaciona con una columna de la tablade flujos de datos.

2. Seleccione el tipo de archivo sin formato del campo de mensaje.Identifique un archivo de ejemplo como ayuda para correlacionar las columnas.Este archivo es un ejemplo del archivo de datos real. Los datos de este archivoaparecerán en el siguiente paso para ayudarle a medida que correlaciona losdatos de flujo de datos en la tabla. Es opcional para archivos de anchura fija ydelimitados.

3. Para los archivos de anchura fija, defina las posiciones de las columnas dedatos en la ventana Establecer anchuras de campo.

4. Identifique los atributos de archivo sin formato. Para obtener información,consulte: “Tablas de flujos de datos de los archivos sin formato” en la página104.

5. Defina la información de columna específica del formato. Para obtenerinformación detallada acerca del tipo de origen, consulte estos temas:v “Archivos de anchura fija” en la página 110v “Archivos delimitados” en la página 109v “Soporte de archivos XML” en la página 111

6. Pulse en Guardar flujo de datos para guardar la definición de campo demensaje.

Editar la definición de un campo de mensajeCada campo del mensaje puede ser un campo simple que se correlacionedirectamente con una columna de una tabla de flujos de datos, o puede ser uncampo complejo (un campo de archivo sin formato) que contenga varios camposque se correlacionen de forma individual con las columnas de la tabla.

Los campos complejos se tratan como archivos sin formato en formatosdelimitados (CSV), de anchura fija o XML. Para obtener una descripción detalladade estos tipos de archivo, consulte: Capítulo 13, “Archivos sin formato”, en lapágina 103.


Procedimiento

En la columna Formato del campo, cambie el valor de Archivo sin formato: tipode archivo a <Cambiar formateo>.Al editar un campo de mensaje, la opción del archivo de ejemplo para los tipos dearchivos delimitados y de anchura fija no está disponible.

Tipos de datos de TIBCO RendezvousCada mensaje es un conjunto de campos donde cada uno contiene un elemento dedatos de u n tipo de datos específico. Puede identificar cada campo mediante unnombre definido y especificar el tipo de datos asociado del campo.

Los tipos de datos de TIBCO Rendezvous se correlacionan con los tipos de datosde Cognos Real-time Monitoring (consulte: Capítulo 9, “Tipos de datos”, en lapágina 69) tal como se muestra en la siguiente tabla:

Tabla 96. Correlación de tipos de datos de TIBCO Rendezvous

Tipo TIBCO Rendezvous Tipo de Cognos Real-time Monitoring

Tipos de datos personalizados No soportado

BOOL Booleano

DATETIME Indicación de fecha y hora

F32 Doble

F32ARRAY No soportado

F64 Doble

F64ARRAY No soportado

I16 Entero

I16ARRAY No soportado

I32 Entero


I64 Largo


I8 Entero


IPADDR32 No soportado

IPPORT16 No soportado

MSG No soportado

OPAQUE No soportado

STRING Varchar

U16 Entero

U16ARRAY No soportado

U32 Largo


U64 Decimal


U8 Entero



Tabla 96. Correlación de tipos de datos de TIBCO Rendezvous (continuación)

Tipo TIBCO Rendezvous Tipo de Cognos Real-time Monitoring

XML Varchar



Capítulo 34. Usuarios

Cada usuario que interactúa con IBM Cognos Real-time Monitoring se identifica enel sistema por su información de cuenta de usuario.

Cuando los administradores crean o editan cuentas de usuario o cuando losusuarios ven sus valores de cuenta, acceden a información específica de la cuenta apartir de las pestañas.

Usuario rtmadmin

Todas las instalaciones tienen un usuario predeterminado denominado rtmadmin.Este usuario tiene todos los permisos. El usuario rtmadmin crea otros usuarios yasigna permisos. Entre los permisos que puede otorgar el usuario rtmadmin seencuentra la posibilidad de crear usuarios. Póngase en contacto con suadministrador para saber cuál es la contraseña predeterminada del usuariortmadmin para su instalación.

Editar la información de su propia cuentaPuede editar la información de su propia cuenta.

Procedimiento

Pulse en Valores de cuenta en cualquier momento.

Crear, suprimir o editar una cuenta de usuarioPuede crear, suprimir o editar una cuenta de usuario.

No puede suprimir el usuario del sistema ni a sí mismo.

Procedimiento1. Abra la Consola de administración.2. Pulse en Usuarios para ver una lista de todos los usuarios actualmente

definidos en el sistema. Desde esta página, puede llevar a cabo las accionessiguientes:v Editar la información de la cuenta de un usuario existente efectuando una

doble pulsación en el nombre en la lista.

Pestaña Detalles del usuarioLa pestaña Detalles del usuario lista los atributos de usuario.

Tabla 97. Atributos de la pestaña Detalles del usuario


Nombre deusuario

Especifica el nombre de inicio de sesión del usuario. El nombre debe serexclusivo entre todos los objetos de la carpeta raíz, como actividadesempresariales, usuarios, roles, objetos del panel de control, etcétera.

Contraseña Especifica la contraseña del usuario. la contraseña puede contenercualquier combinación de letras, números y caracteres.


Tabla 97. Atributos de la pestaña Detalles del usuario (continuación)


Roles Especifica los roles a los que pertenece el usuario.

Pestaña Perfiles de entregaLos perfiles de entrega especifican dónde y cómo entregar alertas y feeds de datosal usuario.

Los usuarios pueden tener varios perfiles. En el Gestor de alertas de IBM CognosReal-time Monitoring Dashboard, los usuarios pueden identificar qué perfilesreciben qué alertas. Además, cada usuario tiene como mínimo un perfil: el perfildel panel de control. El perfil del panel de control envía notificaciones al gestorde alertas en Real-time Monitoring Dashboard.

Como mínimo uno de los perfiles debe estar designado como el que se debeutilizar al suscribirse a una alerta. Todo perfil marcado como Automático se añadeautomáticamente a nuevas suscripciones a alertas.

Los tipos de perfil son los mecanismos de entrega posibles que están disponiblesdurante la instalación, e incluyen:v Perfil del panel de control

El gestor de alertas en el panel de control. Este perfil no se puede suprimir.v Correo electrónico

Se trata de una cuenta de correo electrónico donde se recibirá el mensaje dealerta generado.

v Servicio web

Método de servicio web que recibe la notificación de alerta y cualquier reportletadjunto como datos XML. Para obtener más información, consulte: Capítulo 37,“servicios web”, en la página 375.

Correo electrónicoEl correo electrónico es una dirección en la que el usuario recibe mensajes decorreo electrónico.

Tiene los siguientes atributos:

Tabla 98. Atributos de correo electrónico


Nombre delperfil

Especifica el nombre que identifica al perfil. El nombre puede contenersólo letras y números.

Dirección decorreoelectrónico

Especifica la dirección de correo electrónico del usuario.

Servicio webEl servicio web recibe notificaciones de alerta y cualquier reportlet adjunto comodatos XML.

Este servicio publica un mensaje de estilo documento SOAP (Protocolo de acceso aobjetos simple), no un mensaje de estilo RPC (Llamada a procedimiento remoto).


El servicio web tiene los siguientes atributos:

Tabla 99. Atributos de servicio web


URL de servicioweb

Especifica la ubicación HTTP de la aplicación que proporciona el servicioDOC (SOAP). No se da soporte a los mensajes de estilo RPC.

Método Especifica el método del servicio web que se usará.

Nombre deusuario

Especifica el nombre de cuenta de usuario al conectarse al servicio. Esteatributo es opcional.

Contraseña Especifica la contraseña de la cuenta. Este atributo es opcional.

UDF Especifica la función definida por el usuario (UDF) utilizada para lanzarel servicio web. Si no se especifica ninguna UDF, se utiliza el WSDLpredeterminado para invocar el servicio web.

Para obtener más información, consulte la sección Capítulo 35,“Funciones definidas por el usuario”, en la página 357 y las seccionessobre cómo trabajar con UDF y archivos JAR en la publicación IBMCognos Real-time Monitoring Workbench Guía del usuario.

Este atributo es opcional.

Para utilizar un servicio web, el administrador debe hacer referencia al archivoAlertMessage.xsd, y al archivo AlertService.wsdl, que describe el servicio desuscripción, los datos que proporciona y cómo intercambiar datos con el servicio.

El administrador puede localizar el archivo en este directorio:

ubicación instalación/realtime/sdk/api/wsalert/api/wsalert

Para obtener más información sobre el servicio web, consulte: Capítulo 37,“servicios web”, en la página 375.

Pestaña Permisos de accesoLos permisos de acceso son los permisos globales que puede tener un usuario o rolpara un objeto o una clase de objetos.

En la pestaña Permisos de acceso, puede especificar permisos para:v Actividades empresarialesv Vistas, cubos y dimensionesv Tablas de consulta y flujos de datosv Usuariosv Rolesv Agentesv Propiedades de sistemas globalesv Panel de controlv Objetos del panel de controlv Procesos externos

Los nuevos usuarios y roles no tienen ningún permiso de acceso para ningúnobjeto. Por ello, los usuarios y roles reciben y ven alertas y reportlets sóloautorizados mediante suscripciones obligatorias.

Capítulo 34. Usuarios 355

Para obtener más información sobre la asignación de permisos, consulte:Capítulo 23, “Permisos”, en la página 291.


Capítulo 35. Funciones definidas por el usuario

Puede utilizar funciones definidas por el usuario (UDF) para ampliar C-SQLdefiniendo sus propias funciones para utilizarlas en consultas, vistas y reglas.

Con esta característica, puede definir una función escalar o una función deconjunto implementando las interfaces Java pertinentes de IBM Cognos Real-timeMonitoring.

Las UDF son programas Java que adoptan argumentos y devuelven un valor, deforma similar a las funciones internas de Cognos Real-time Monitoring. Porejemplo, puede tener una UDF que tome un conjunto de valores y los concatenealfabéticamente, y que ignore los valores NULL. Utilizaría esa UDF en unaexpresión como la del siguiente ejemplo:ConcatSet(Product.Name)

Una vez compilado el programa Java, se despliega (carga) en Cognos Real-timeMonitoring, donde pasa a estar disponible para todos los usuarios que puedancrear o editar consultas, vistas y reglas.

Para obtener información acerca de la creación de funciones definidas por elusuario, consulte: “Creación y uso de una función diseñada por el usuario” en lapágina 358. Para obtener más información sobre estas interfaces, consultecom.cognos.obi.api.function en la documentación de Javadoc.

Restricciones de las funciones definidas por el usuarioLas funciones definidas por el usuario tienen varias restricciones.

Estas restricciones son las siguientes:v Sólo funciones escalares y de conjunto; sin funciones de clasificación.

Las UDF pueden definir funciones escalares implementando la interfazIUDScalarFunction; las funciones de conjunto lo hacen implementando lasinterfaces IUDAggregateFunction e IUDAggregateState. Para obtener másdetalles, consulte "com.cognos.obi.api.function" en la documentación del Javadoc.

v Las UDF no son visibles en IBM Cognos Real-time Monitoring Workbench.El editor de fórmulas no reconoce las UDF. El usuario es el responsable derealizar el seguimiento de las UDF que se registran con el sistema.

v Los usuarios tienen acceso a todas las UDF.No se pueden aplicar permisos de acceso a una UDF. Asimismo, varios usuariospueden definir UDF distintas con el mismo nombre. En tal caso, el sistemautilizará la primera que encuentre.

v Las funciones de conjunto deben implementar la serialización de objetos ymantener la compatibilidad con las versiones anteriores.Si no se implementan rutinas de serialización y deserialización significativas,puede producirse un comportamiento imprevisible en muchas áreas, incluido elpunto de comprobación y recuperación, y la ejecución paralela.

v Las UDF nunca se envían como predicados a un origen remoto.


Básicamente, las UDF nunca se envían a un DBMS para su evaluación. Paraobtener más detalles, consulte: “Limitaciones de columna en consultas de tablasde consulta” en la página 264.

Creación y uso de una función diseñada por el usuarioEn estas instrucciones se utiliza la UDF de ejemplo ConcatSet.

El ejemplo se encuentra en esta ubicación: \realtime\webcontent\sdk\udf. Paraobtener más información sobre el ejemplo, consulte el archivo README.txt en estedirectorio.

Procedimiento1. Cree la UDF implementando las interfaces com.cognos.obi.api.function

adecuadas.Consulte la documentación del Javadoc para obtener información detalladaacerca de las interfaces.

2. Compile la implementación.Cuando compile la implementación de la UDF, incluya el archivocognosAPI.jar. El archivo se encuentra en esta ubicación: \realtime\webcontent\sdk\udf. Para obtener más información sobre el ejemplo, consulte elarchivo README.txt en este directorio.

3. Cree un archivo de manifiesto para el archivo JAR de la UDF.Un archivo de manifiesto es un archivo XML en el que se describe el archivoJAR de la UDF para Cognos Real-time Monitoring. Para obtener unadescripción del archivo y un listado de ejemplos, consulte: “Archivos demanifiesto” en la página 359.

4. Cree un archivo JAR que contenga las clases (como ConcatSet.class) y elmanifiesto (manifest.xml). El archivo de manifiesto debe aparecer debajo decom/cognos/obi/manifest en el archivo JAR. Por ejemplo:jar -cvf udf.jar samples/* com/cognos/obi/manifest/manifest.xml

5. Añada la UDF a la lista de UDF disponibles.v En IBM Cognos Real-time Monitoring Workbench, pulse la pestaña

Workbench.v Pulse la carpeta Funciones definidas por el usuario y elija Nueva función

definida por el usuario.v Especifique o cargue el archivo JAR que contiene la función y pulse en

Continuar.v Seleccione las funciones que han de añadirse y, opcionalmente, asigne nuevos

nombres a éstas.v Pulse en Terminar para añadir las UDF a la lista.Una vez que se ha desplegado la UDF, puede utilizarla en fórmulas, como porejemplo:ConcatSet(Product.Name)

Modificación de una función diseñada por el usuarioPuede modificar una UDF existente.


Procedimiento1. Cambie la implementación y cree un archivo JAR actualizado.2. Cargue el archivo JAR sobrescribiendo el ya existente.3. Vuelva a añadir las UDF a la lista de funciones definidas por el usuario.

Archivos de manifiestoUn manifiesto es un archivo XML que describe el contenido del JAR de la UDF aIBM Cognos Real-time Monitoring.

Defina los elementos <UDF> y <name> para cada función del archivo JAR. Defina unelemento <UDFDescriptor> para cada tipo de datos que la función pueda devolver.Si varias llamadas a la misma función y con el mismo argumento pueden devolvervalores distintos, establezca el elemento <isVariant> en true. Por ejemplo, lafunción interna CURRENT_TIMESTAMP (consulte: “CURRENT_TIMESTAMP” enla página 143) no toma ningún argumento pero devuelve un resultado distintocada vez que se le llama. Esta función es "variante".

El siguiente ejemplo es un manifiesto para la función ConcatSet(). Este listado seha adaptado del archivo del directorio de ejemplos /samples/udf/jar/com/cognos/obi/manifest.xml.

Archivo manifest.xml de ejemplo<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<jarManifest xsi:schemaLocation="http://obi.cognos.com/4jarManifest.xsd"

xmlns="http://obi.cognos.com/4"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<jarManifestXSDVersion>1</jarManifestXSDVersion>

<author>by Martin Handwerker <[email protected]></author>

<UserDefinedFunctions>

<UDF>

<name>ConcatSet</name>

<description>Concatenate a set of values alphabeticallyinto a large string. Ignores nulls.</description>

<implementor>com.udfobi.concatset.ConcatSet</implementor>

<UDFDescriptors>

<UDFDescriptor>

<result>VARCHAR</result>

<argument>

<type>ANY</type>

</argument>

</UDFDescriptor>

</UDFDescriptors>

<isVariant>false</isVariant>

</UDF>

</UserDefinedFunctions>

</jarManifest>

Capítulo 35. Funciones definidas por el usuario 359


Capítulo 36. Vistas

Las vistas empresariales son modelos de datos que proporcionan una imagen entiempo real de una actividad empresarial.

Los registros de cambios y transacciones de la empresa entran en IBM CognosReal-time Monitoring como eventos. Cada nuevo evento ejecuta una actualizacióninmediata de las vistas (modelos empresariales) derivadas de dicho evento, yproporciona una imagen en tiempo real de las métricas empresariales. Una vezactualizada una vista, el sistema evalúa las reglas asociadas a la vista y buscacondiciones empresariales excepcionales a las que se deba prestar atención.

Una vista empresarial es una tabla virtual que reside en la memoria. El contenidodel a vista procede de los orígenes definidos por una sentencia de consultaSELECT de C-SQL. Las vistas se definen en IBM Cognos Real-time MonitoringWorkbench. Ese sistema construye entonces una sentencia SELECT bien formadaantes de pasarla a los servidores Cognos Real-time Monitoring para su ejecución ymantenimiento. Para obtener más información sobre la sentencia SELECT y susintaxis y uso, consulte: Capítulo 32, “Sentencias SELECT”, en la página 333.

Puede limitar las filas que un usuario ve; para ello, asocie un filtro de acceso a lavista y aplique el filtro a los usuarios o roles que vean la vista. Para obtenerinformación más detallada, consulte: Capítulo 2, “Filtros de acceso”, en la página 3.

Los datos contenidos en las vistas de las tablas de consulta son estáticos o cambiande forma lenta. Los cambios que tienen lugar en las tablas de consulta no hacenque el motor de consulta actualice la vista. No obstante, los cambios en la tabla deconsulta se reflejan en la vista cuando dicha tabla se une con la siguiente fila de latabla de flujos de datos.

Creación de vistasPuede crear vistas que se actualizan con los cambios y las transcripciones de laempresa.

Consejo:

Siempre que sea posible, intente utilizar vistas sin estado. Las vistas sin estadoutilizan mucha menos memoria que las vistas con estado, porque sólo se guarda enmemoria el último evento. Utilice vistas sin estado para proporcionar datos paracubos y vistas con estado.

Utilice el menor número de grupos necesario. La agrupación por claves de eventopuede dar lugar a demasiados grupos, por lo que se recomienda agrupar porregión, por minuto, etc. No agrupe por cliente o indicación de fecha y hora, amenos que primero reduzca la precisión.

Realce los cálculos complejos sólo una vez. En lugar de realizar varias veces untruncamiento de indicación de fecha y hora, cree una columna en la vista en la queel cálculo se realice una vez y luego utilice dicho valor en las vistas hijo.

TO_DATE() y otras funciones de indicación de fecha y hora hacen un uso intensivodel procesador. Limite su uso al mínimo.


Diseñe sus ventanas correctamente. Trunque las indicaciones de fecha y hora a lagranularidad de minuto u hora, según como vaya a analizar los datos. Asimismo,utilice las definiciones de ventana apropiadas. Por ejemplo, el formato más largode SUM(columnName) OVER (ORDER BY TruncatedTimeStampColumn RANGE INTERVAL’24’ HOUR PRECEDING SLIDE INTERVAL ’1’ HOUR REFERENCE OPERATOR) es preferiblea la sintaxis simplificada MOV_SUM(NumericColumn).

Persista los datos sin estado. No intente conservar todas las filas en la memoria.Habilite Persistencia de la vista para almacenar la vista de modo que puedaconsultarla de nuevo más tarde mediante la opción Obtención de detalles.

Antes de empezar

Debe tener el permiso de creación para vistas y el permiso de acceso de sólolectura en la tabla de flujos de datos que proporciona datos a la nueva vista.

Para obtener más información, consulte: “Cómo otorgar permiso para crearobjetos” en la página 294.

Procedimiento1. En IBM Cognos Real-time Monitoring Workbench, pulse la pestaña Workbench.2. Pulse Actividades.3. Pulse Crear nuevo > Vista.4. En la ventana Nueva vista, seleccione el flujo de datos o la vista derivativa en

que desea basar la vista nueva. Utilice Examinar para seleccionar flujos dedatos o vistas existentes de otras carpetas.

5. Pulse Aceptar.6. En la ventana Configurar vista, especifique los atributos que desee.

Copia de una vistaPuede copiar la definición de una vista existente en una vista alerta.

Procedimiento1. Edite la vista que desea copiar.2. Cambie el nombre de la vista y los atributos que sean distintos a los de la vista

original.3. Pulse Guardar como vista nueva.

Atributos de vistaPuede configurar una vista para especificar los atributos que necesita.

Tabla 100. Atributos de una vista


Nombre Identifica el objeto de vista. El nombre puede contenersólo letras y números. Este nombre debe ser exclusivoentre vistas, flujos de datos, tablas de consulta y flujosde datos consolidados. Para obtener más información,consulte: “Espacio de nombres de objeto” en la página277.


Tabla 100. Atributos de una vista (continuación)


Estado Especifica si la vista está habilitada (lista para recibirdatos) o inhabilitada. Cuando una vista está inhabilitada,todos los objetos que dependen de ella también estáninhabilitados, incluidas reglas, alertas y reportlets.

Guardar en Especifica la carpeta en la que se va a almacenar la tablade flujos de datos. Pulse Seleccionar carpeta paraseleccionar o crear una carpeta. Si no especifica ningunacarpeta, el valor predeterminado es Carpeta pública.

Descripción de vista Descripción opcional que puede contener cualquiercarácter de texto.

Conjunto de trabajo Tablas y vistas de flujo de datos de las que se deriva lavista.

Arrastrar campos del conjuntode trabajo

Los campos seleccionados en la hoja de trabajo son lascolumnas que se incluirán en la vista, incluidas lascolumnas cuyos valores derivan de las fórmulas. Estascolumnas componen la lista de selección en la sentenciaSELECT subyacente.

La opción Agrupar por identifica las columnas en lasque se agruparán los resultados. Es la cláusula GROUPBY en la sentencia SELECT subyacente.

Mantener en la vista Permite el seguimiento de la información de flujos dedatos anteriores para las vistas sin estado. Para obtenermás información, consulte: “Mantenimiento de eventosen vistas sin estado” en la página 369.

Cláusula From Cómo unir la información de varias tablas y vistas en elconjunto de trabajo. Estos datos forman la cláusulaFROM en la sentencia SELECT subyacente.

Cláusula Where Identifica qué información de origen se va a incluir en lavista nueva. Los flujos de datos que no cumplen laespecificación no están incluidas en la vista. Estos datosforman la cláusula WHERE en la sentencia SELECTsubyacente. Si bien la información de un flujo de datospuede descartarse, las vistas derivadas se actualizan,pero éstas tampoco contienen la información del flujo dedatos. Para obtener más información, consulte:“Cláusula WHERE” en la página 339 y “Actualizaciónde vistas mediante la propagación de eventos” en lapágina 368.

Cláusula Window Define ventanas para agregar conjuntos de filas en lavista. Para obtener más información, consulte:Capítulo 38, “Ventanas de consulta”, en la página 389.

Cláusula Order by Ordena la vista resultante según los nombres de lascolumnas o los resultados de las expresiones. Estos datosforman la cláusula ORDER BY en la sentencia SELECTsubyacente.

Capítulo 36. Vistas 363

Tabla 100. Atributos de una vista (continuación)


Avanzado Utilice la pestaña Avanzado para especificar las opcionessiguientes:

v Persistencia de la vista

Guarda los datos de la vista en una base de datospara su análisis posterior. Para obtener másinformación, consulte: “Persistencia de vistas para unabase de datos” en la página 370.

v Obtención de detalles

Permite al usuario ver la información acerca de losdatos presentados por un objeto del panel de control.Para obtener más información, consulte: “Habilitaciónde la obtención de detalles” en la página 372.

Restricciones de vistaLas vistas de IBM Cognos Real-time Monitoring tienen restricciones.

Estas restricciones son:v Una vista se puede derivar de una tabla de flujos de datos u otra vista.v Una vista no puede unir tablas de flujos de datos diferentes. (Un flujo de datos

consolidados es una unión de dos tablas de flujo de datos idénticas. Paraobtener más información, consulte: “Flujos de datos consolidados” en la página367.)

v Una vista puede unir dos vistas de la misma tabla de flujos de datos. (Unaunión sincronizada es una vista derivada de varias vistas que se basan en lamisma tabla de flujos de datos. Para obtener más información, consulte:“Uniones sincronizadas”.)

v Una vista puede unir una tabla de flujos de datos y una o varias tablas deconsulta.

v Una vista puede unir una vista y una o varias tablas de consulta.v Una vista no se puede derivar sólo de tablas de consulta.

Uniones sincronizadasUna unión sincronizada es una vista derivada de dos vistas que se basan en lamisma tabla de flujos de datos de origen.

En una unión sincronizada, la vista resultante contiene filas que son lacombinación de las mismas tablas de flujos de datos de las vistas de origen.


Las uniones sincronizadas siempre se basan en el ID interno de una tabla de flujosde datos. Hay una condición de unión implícita en la columna de la tabla de flujosde datos interna. Sin embargo, debe definir una cláusula WHERE o una condiciónde unión en la cláusula FROM para evitar un posible resultado de unión cruzada.Para obtener más información, consulte: “Uniones cruzadas” en la página 337.

Una secuencia de unión sincronizada siempre genera una vista sin estado.

RestricciónUna unión sincronizada requiere que los eventos se procesen en el orden en quellegan.

El objeto de flujo de datos de origen debe tener la opción Procesar datos segúnorden de llegada habilitada.

Ejemplo de una unión sincronizadaSe muestra una unión sincronizada que determina la relación de ventas totales porregión.

Una vista (SalesTotal) determina el total de ventas para todos los eventos, mientrasque la otra vista(SalesByRegion) determina los totales para cada región. Finalmente,la unión sincronizada (SalesRatiosByRegion) determina el porcentaje de cada regiónuniendo las dos vistas de totales y dividiendo los totales de región por el totalglobal.

Una vista que es una unión sincronizada combina filas del mismo flujo de datos de origen.

Sincronizadas

Vista

Vista Vista

Flujo de datos Tabla de consulta

Figura 39. Vista de unión sincronizada


La unión sincronizada anterior es una unión cruzada, que en este caso esaceptable. No obstante, observe el ejemplo siguiente que determina cada relaciónde representantes de ventas respecto al total de ventas:

La vista SalesRatioByRegion determina la relación de ventas que representa cada región.

SELECT SUM (SalesEvents.Amount) AS TotalSales FROM SalesEvents

SELECT SalesByRegion.Region AS Region, (SalesByRegion.TotslForRegion/ SalesTotal.TotalSales) AS RatioOfTotal FROM SalesByRegion, SalesTotal

SELECT SalesEvents.Region AS Region, SUM (SalesEvents.Amount) AS TotalForRegion FROM SalesEvents GROUP BY Region

SalesTotal

SalesEvents SalesRatiosByRegion

SalesByRegion

Figura 40. Ejemplo de una unión sincronizada

La vista SalesRatioPerRepRegion determina las ventas de los representantes como relación del total.

SELECT SalesEvents.Region AS Region, SalesEvents.Rep AS Rep, SUM (SalesEvents.Amount) AS Amount FROM SalesEvents GROUP BY Region, Rep

SELECT SalesTotalsByRepRegion.Rep AS Rep, SalesByRegion.Region AS Region. SalesTotalsByRepRegion.Amount / SalesByRegion.TotalForRegion AS RatioPerRep FROM SalesTotalsyRepRegion INNER Join SalesByRegion ON SalesByRegion.Region = SalesTotalsByRepRegion.Region

SELECT SalesEvents.Region AS Region, SUM (SalesEvents.Amount) AS TotalForRegion FROM SalesEvents GROUP BY Region

SalesTotalsByRepRegion

SalesEvents SalesRatiosPerRepRegion

SalesByRegion

Figura 41. Otro ejemplo de una unión sincronizada


En la ilustración anterior, no desea una unión cruzada, porque crea una fila paracada representante de marketing en cada región, incluidas las regiones a las que nopertenecen los representantes. En cambio, la vista SalesRatiosPerRepRegion declarauna unión interna para limitar los resultados por región.

Flujos de datos consolidadosLos flujos de datos consolidados son vistas que aceptan eventos de dos orígenes deeventos distintos.

Para obtener más información, consulte la publicación IBM Cognos Real-timeMonitoring Workbench Guía del usuario.

Vistas agregadasUna característica clave de las vistas empresariales es la posibilidad de agregarinformación de flujos de datos y tablas de consulta para detectar, analizar ycombinar la información en métricas empresariales significativas. Las vistasagregadas tienen al menos una definición de campo que incluye una agregación ocláusula GROUP BY.

Por ejemplo, observe esta vista sencilla que realiza el seguimiento del recuentototal de eventos que han llegado durante la última hora. Cada vez que llega unnuevo evento, la función MOV_COUNT() recalcula el recuento de todos loseventos de la vista y proporciona métricas en tiempo real sobre el evento:SELECT MOV_COUNT( *, HOUR, 1) AS "Data Streams in thelast hour"

FROM Events

Puede añadir complejidad al ejemplo anterior limitando los eventos que ve la vista.Por ejemplo, para contar sólo los eventos cuyo valor de Estado sea Abierto:SELECT MOV_COUNT( *, HOUR, 1) AS "Opens in the last hour"

FROM Events

WHERE Status=’Open’

Al combinar la información agregada con otras tablas de consulta, puede generarmétricas más significativas. Por ejemplo, esta vista indica el recuento de eventoscuyo valor Estado es Abierto, y los agrupa por Característica:SELECT Context.Topic AS Topic,

MOV_COUNT( *, HOUR, 3) AS "Opens in 3 hours"

FROM Events INNER JOIN Context ON Event.Feature =Context.Feature

WHERE (Status=’Open’)

GROUP BY Feature

Feature Opens in 3 hours

-------------- ----------------

Configuration 12

Install 3

Servers 6

Para obtener más información sobre las funciones de agregar y de conjunto móvil,consulte: “Tipos de funciones” en la página 125.


Actualización de vistas mediante la propagación de eventosCuando una vista recibe un evento nuevo, intenta actualizarse con la nuevainformación. Si la actualización tiene lugar, la vista notifica a todas las vistasdependientes que también deben actualizarse.

Sin embargo, las excepciones siguientes pueden evitar que la vista se actualice:v Si una vista está vacía cuando recibe un evento y permanece vacía después de

procesarlo, no notificará nunca a las vistas dependientes.v Si una vista completa se vacía como resultado de una supresión, como cuando

se descarta un evento existente de una función de conjunto móvil, se notifica atodas las vistas dependientes que también se actualicen.

v Una actualización puede hacer que una vista sin estado se quede vacía; entonceslas vistas dependientes también se quedan vacías. Si un evento posteriortambién da lugar a una ventana vacía, perece que la vista no se actualice,aunque en realidad no es así.

v Si el evento nuevo se descarta porque no cumple algún criterio, la vistacompleta no se actualizará. Sin embargo, sí que publicará una instantánea de símismo en todas las vistas dependientes, lo cual puede provocar que lasfunciones de conjunto móvil dependientes actualicen sus vistas.

Si se produce un error al procesar un evento mientras se actualiza una vista, sedescartan todas las filas relacionadas con el evento completo y la vista sigue siendoválida y permanece habilitada.

Vistas completas y sin estadoLas vistas de IBM Cognos Real-time Monitoring pueden ser completas o sinestado.

Las vistas completas contienen los resultados de las agregaciones derivadas deeventos pasados en una sola fila. Una vista es completa si:v contiene una función de conjunto o una función de conjunto móvil en la cláusula

SELECT, ov contiene una cláusula GROUP BY (en cuyo caso cada grupo contiene sólo una

fila), ov se deriva de una vista completa.

Las vistas sin estado son todas las que no son completas.

Generalmente, una vista sin estado muestra la información sobre un solo evento,como una orden de compra. Una vista completa, en cambio, muestra lainformación agregada sobre varios eventos, como el promedio de precio de varioseventos de orden de compra.

Inicialización de vistasCada vista mantiene dos instantáneas de los datos que contiene.

Las dos instantáneas son:v Vista actual


Datos presentes en la vista. En el caso de una vista completa, la instantáneamuestra todas las filas de la vista. En una vista sin estado, muestra todas lasfilas que corresponden al último evento, que tras la agregación podría ser unconjunto vacío.

v Vista recienteInstantánea de la última vista actual no vacía. Cuando la vista tiene una ventanade conjunto móvil, la vista reciente contiene las últimas filas no vacías de laventana. Por ejemplo, si la ventana es de dos días, la vista reciente contiene elúltimo conjunto de 2 días que no era un evento vacío, si la vista actual estávacía. Una vista reciente es lo que aparece en IBM Cognos Real-time MonitoringWorkbench al editar un objeto que visualiza resultados de vistas, y lo queutilizan las vistas derivadas durante la inicialización de vistas.

Cuando se crea o se habilita una vista, se inicializa a un estado basado en los datosde la vista base, como se indica a continuación:v Vista completa

La nueva vista se inicializa con los datos de la instantánea de vista actual de lavista base. Por ejemplo, supongamos una vista base completa que realice elseguimiento de las ventas por región:SELECTregion, SUM(sales) AS region_sales GROUP BY region

Cuando se deriva una nueva vista de sales_by_region, la nueva vista se rellenainmediatamente con los datos de la vista actual de sales_by_region.SELECT SUM(region_sales) AS total_sales FROM sales_by_region

v Vista sin estadoLa nueva vista se inicializa con los datos de la instantánea de vista de la vistabase. Por ejemplo, supongamos esta vista sin estado. La instantánea actual deesta vista está vacía cuando no hay ninguna venta superior a 1.000.000.SELECT region,sales WHEREsales > 1000000

Sin embargo, una vista derivada de esta vista se inicializará con los datos de lainstantánea de vista reciente de la vista.

v Tabla de flujos de datosLa nueva vista está vacía. Las tablas de flujos de datos no mantieneninstantáneas.

Mantenimiento de eventos en vistas sin estadoDe forma predeterminada, una vista sin estado sólo contiene las filas querepresentan el último evento que ha cumplido la condición de la vista; las filas delos eventos anteriores se descartan.

Si el evento no cumple la condición, la vista está vacía. Puede utilizar Mantener enla vista para especificar un conjunto que contenga información de evento no vacíoreciente que se deba mantener en la vista.

Utilice esta opción para incluir los eventos recientes en las situaciones siguientes:v Cuando se visualiza el contenido de la vista en la pestaña Resultados. Esta

pestaña visualiza las filas actuales en la vista.v Cuando se utilizan aplicaciones externas que reciben la vista como feed de datos

en tiempo real. Si se habilita esta opción, la aplicación externa puede realizar unanálisis histórico y de tendencias.


Procedimiento1. Edite la vista que desea que persista.2. En la ventana Configurar vista, seleccione Mantener en la vista.3. Especifique el recuento de eventos o el intervalo de tiempo que han de

retenerse los eventos.v Un recuento de eventos es el número máximo de eventos no vacíos que han

de mantenerse. La vista descarta las filas de eventos más antiguas que no seajustan al tamaño especificado.

v Un intervalo de tiempo define un conjunto de los eventos más recientes. Elrecuento de eventos de la vista varía en función del número de eventos delintervalo cuando se actualiza la vista. Por ejemplo, si ha llegado un eventoque no cumple los criterios de la vista, éste se excluye de la vista, pero lavista vuelve a calcular el intervalo para ese tiempo.

El conjunto de eventos se determina cuando se inserta el último evento, no enel momento actual. Por ejemplo, un intervalo de una hora muestra todos loseventos que han llegado a la vista durante la hora anterior a la últimaactualización. Si no se han insertado eventos durante el último día, la vistapuede seguir mostrando un valor de una hora de los eventos del día anterior.Sin embargo, cuando llega un nuevo evento a la vista, todos esos eventos sedescartan.Para obtener más información sobre cómo realizar agregaciones en conjuntos deeventos recientes, consulte: “Funciones de conjunto móvil” en la página 127.

Persistencia de vistas para una base de datosIBM Cognos Real-time Monitoring puede establecer como persistentes los datos devista en un RDBMS externo para la posterior creación de informes que se realizamediante herramientas de terceros.

La información de la tabla es suficiente para que las herramientas de creación deinformes puedan volver a crear una instantánea completa de la vista. Al aplicar lapersistencia, la información de la vista se escribe en una tabla en el DBMS, a unavelocidad que dependerá de la política que defina.

Cognos Real-time Monitoring puede crear la tabla automáticamente; también tienela opción de predefinir la tabla en el DBMS. Para obtener más información,consulte: “Vista de atributos de persistencia” en la página 371.

Antes de empezar

Un especialista en aplicaciones debe definir primero un agente JDBC para elRDBMS que almacena los datos de vista. Para obtener más información, consulte:“Agentes Java Database Connectivity” en la página 236.

Procedimiento1. Edite la vista que desea que persista.2. En la ventana Configurar vista, pulse la pestaña Avanzado.3. En Persistencia de vista, pulse Definir.4. Complete los campos de la ventana Definir la persistencia de la vista. Para

obtener más información, consulte: “Vista de atributos de persistencia” en lapágina 371.La vista empezará a aplicar la persistencia de datos en cuanto se habilite.


Vista de atributos de persistenciaPuede especificar estos atributos al definir la persistencia de los datos de la vistaempresarial en un DBMS externo.

Tabla 101. Vista de atributos de persistencia


Agente JDBC Agente para el RDBMS definido en la tarea.

Tabla Tabla de destino en el RDBMS para recibir los datos persistentes. Siomite este nombre, la tabla tiene el mismo nombre que la vistaempresarial. Las columnas de la tabla de destino deben tener losmismos nombres que las columnas de la vista, aparecer en elmismo orden que en la vista y tener una anchura igual o superiora la de las columnas de la vista. Cuando la anchura de unacolumna del destino es menor, el RDBMS trunca los datos paraajustarse o genera un error. Asimismo, las longitudes de filasoportadas por la tabla de destino deben ser iguales o superiores alas longitudes de fila de la vista empresarial.

Crear esta tabla si noexiste

Indica que el especialista en aplicaciones o el administrador debase de datos aún no ha creado la tabla con ese nombre. Si se haseleccionado esta opción, IBM Cognos Real-time Monitoringintenta crear la tabla de destino mediante un comando CREATETABLE en el espacio de tabla predeterminado del usuario JDBC.

Política depersistencia

La persistencia depende de si la vista es con estados o sin estados.Las vistas con estados se escriben como instantáneas que persistensegún el intervalo especificado, y sólo las instantáneas persisten.Las vistas sin estado se escriben también como instantáneas, perose registran de modo que la condición entre instantáneas tambiénse capture.

Número de eventos Especifica el número de eventos para escribir en la base de datos.Por ejemplo, si el número de eventos está establecido en 10, los 10eventos deben producirse antes de que se escriban en la base dedatos. Si se establece el número de eventos en 1, se escribe concada evento. Un evento es una fila en una base de datos. Loseventos se representan mediante objetos de secuencia de datos enCognos Real-time Monitoring.

Intervalo de tiempo Especifica el intervalo para escribir en la base de datos.

Inhabilitar tras estenúmero de erroresconsecutivos

Especifica cuántos errores consecutivos se escribirán en el registrode errores antes de inhabilitar la persistencia. Esta opción evita queel servidor repita el mismo error.

Vista de columnas persistentesLa base de datos recibe todas las filas y columnas que hay en ese momento en lavista.

Además, cada fila contiene estas columnas internas adicionales:

Tabla 102. Columnas internas

Columna Descripción

VC_EVENT_ID Identificador de evento que identifica el evento que produjo lafila más reciente incluida en la vista.

VC_LATEST_EVENT_ID Identificador de evento más reciente que identifica el últimoevento que provocó la actualización de la vista, aunque losdatos de ese evento no estén incluidos en la vista.


Tabla 102. Columnas internas (continuación)

Columna Descripción

VC_TIMESTAMP Indicación de fecha y hora de evento que identifica cuándo seincluyó el último evento en la vista.

Habilitación de la obtención de detallesPuede crear vistas que hagan posible la obtención de detalles en un gráfico.

Los usuarios pueden utilizar esta opción para ver detalles sobre los datospresentados por un objeto del panel de control. La Obtención de detalles tiene losrequisitos siguientes:v El origen de datos del objeto de panel de control debe ser un cubo.v La vista en la que se basa el cubo no debe tener estado. Para obtener más

información, consulte: “Mantenimiento de eventos en vistas sin estado” en lapágina 369.

v Las dimensiones del cubo deben proceder de una única base de datos externa, yla base de datos debe ser la misma que la de las mediciones para el cubo.

v Si existe más de una tabla en una vista, puede utilizar una tabla persistente parala tabla de obtención de detalles. Para obtener más información, consulte:“Persistencia de vistas para una base de datos” en la página 370.

La Obtención de detalles tiene las limitaciones siguientes:v No puede utilizar espacios ni caracteres especiales en los nombres de las tablas o

columnas de las vistas que se utilizan para la obtención de detalles conpersistencia de vista.

v Los nombres de las columnas para las vistas deben especificarse en letrasmayúsculas, como práctica recomendada, al utilizar la obtención de detalles. Deotro modo, puede que la obtención de detalles no funcione.

v La obtención de detalles con un filtro en una columna de dimensión de tipoTIMESTAMP no funcionará si el contexto de dimensión se almacena en una basede datos de Oracle.

v Si el usuario que crea el cubo dispone de acceso filtrado a la vista de hechos, elcubo no está habilitado para la obtención de detalles.

v La obtención de detalles sólo recibe soporte en los cubos que se basan en unavista sin estado.

Antes de empezar

Un especialista en aplicaciones debe definir primero un agente JDBC para elRDBMS que tiene acceso a los datos de la vista. Para obtener más información,consulte: “Agentes Java Database Connectivity” en la página 236.

Procedimiento1. Abra el editor de vista en una vista cuya Obtención de detalles desea habilitar.

v En una vista existente, seleccione Editar esta vista.v Para crear una nueva vista, seleccione Nueva vista.

2. Pulse en la pestaña Avanzado y, en Obtención de detalles, pulse Definir.3. En el campo Agente JDBC, seleccione el agente para el RDBMS.


4. En el campo Tabla, especifique la tabla en el RDBMS que ha de utilizarse parala obtención de detalles. Puede ser una tabla de hechos o la misma tabla que laque se ha especificado para Persistencia de la vista.

5. Pulse Aceptar.6. Guarde la vista.

Datos de IBM Cognos Real-time Monitoring en IBM Cognos BusinessIntelligence

Puede utilizar un cubo o vista de IBM Cognos Real-time Monitoring como origende datos en IBM Cognos Business Intelligence.

Puede utilizar datos de Cognos Real-time Monitoring en Business Intelligence. Porejemplo, puede ver los datos de Real-time Monitoring en Query Studio o puededesarrollar y publicar un paquete de informes en Framework Manager y ver losinformes en Cognos Connection.

Visualización de datos de IBM Cognos Real-time Monitoringen IBM Cognos Business Intelligence

Puede ver datos de IBM Cognos Real-time Monitoring en IBM Cognos BusinessIntelligence.

Puede ver los tipos de datos siguientes:v Cubos de Cognos Real-time Monitoring.v Vistas de Cognos Real-time Monitoring.

Antes de empezar

Antes de llevar a cabo este procedimiento, lleve a cabo estas acciones:v Verifique que el servidor Cognos Real-time Monitoring esté en ejecución.

Consejo: Si puede abrir Cognos Real-time Monitoring en un navegador web, elservidor Cognos Real-time Monitoring está en ejecución.

v Verifique que el servidor Cognos Business Intelligence esté en ejecución.

Consejo: Utilice Cognos Configuration para verificar que el servidor CognosBusiness Intelligence está en ejecución. Para obtener más información, consultela ayuda en línea en Cognos Configuration.

v Configure el inicio de sesión único entre Cognos Real-time Monitoring y CognosBusiness Intelligence. Para obtener más información, consulte la ayuda en líneaen IBM Cognos Real-time Monitoring Workbench.

Procedimiento1. En IBM Cognos Administration, cree una conexión de origen de datos con un

cubo de Real-time Monitoring. Para obtener más información acerca de cómohacerlo, consulte la ayuda en línea en la consola de IBM CognosAdministration.

2. En Framework Manager, cree un nuevo proyecto. Para obtener informaciónacerca de cómo crear un proyecto en Framework Manager, consulte la ayuda enlínea en Framework Manager.

3. En el Asistente de metadatos de Framework Manager, asegúrese de queselecciona el origen de datos para el que ha creado una conexión en el paso 1.


4. En el Asistente de publicación de Framework Manager, cree y publique elpaquete para el servidor de Business Intelligence.

5. Ahora puede ver los datos en Business Intelligence. Por ejemplo, puede vermetadatos en Query Studio o crear informes en Framework Manager y veréstos en Cognos Connection.


Capítulo 37. servicios web

Un servicio web es una interfaz a una aplicación que se ejecuta en un servidor deaplicaciones web. El servicio puede ser un script de búsqueda simple para unabase de datos o un producto complejo para la integración de aplicacionesempresariales (EAI), como los productos proporcionados por Siebel o SAP.

IBM Cognos Real-time Monitoring puede conectarse a servicios web para realizarlas siguientes tareas:v Recibir datos como XML. Para obtener más información, consulte: “Flujos de

datos del servicio web”.v Recuperar tablas de consulta. Para obtener más información, consulte: “Tablas de

consulta para servicios web” en la página 379.v Publicar mensajes de alerta:

– En el perfil de entrega de un suscriptor. Para obtener más información,consulte: “Pestaña Perfiles de entrega” en la página 354.

– De forma individualizada, como lo puede iniciar un usuario que ve elmensaje en IBM Cognos Real-time Monitoring Dashboard. Para obtener másinformación, consulte: “Procesos externos del servicio web” en la página 384.

Flujos de datos del servicio webUn servicio web publica los datos como XML a través de HTTP directamente enlos servidores IBM Cognos Real-time Monitoring. Todos los editores de servicioweb utilizan el mismo URL. El nombre del flujo de datos que recibirá los datosestá codificado en XML, así como el nombre de usuario y la contraseña de CognosReal-time Monitoring que tienen acceso a la tabla de flujos de datos. Cuando losservidores reciben los datos, analizan el XML, descodifican los datos y los insertanen la tabla de flujos de datos identificada.

Al configurar un flujo de datos para un servicio web, puede seleccionar uno de losdos tipos de flujos de datos siguientes: servicio web o servicio web de sondeo.Para obtener más información, consulte: “Atributos de flujo de datos para serviciosweb” en la página 376 o “Atributos de flujo de datos para servicios web desondeo” en la página 377. Los dos tipos de flujos de datos son diferentes. Siselecciona Servicio web, los datos se envían a Cognos Real-time Monitoring desdeel servicio web. Si selecciona Servicio web de sondeo, los datos se obtienen deforma periódica del servicio web especificado.

La tabla de flujos de datos paraun servicio web correlacionalos datos del XML en la tabla.

Los servicios web publican datos deeventos como XML mediante HTTPen IBM Cognos Real-time Monitoring.

Aplicación deservicio web

IBM CognosReal-time Monitoring

Tabla de flujos de datos

http:// .../lava/webservice/datastream

Datos de eventos como XML

Figura 42. Flujos de datos del servicio web


Atributos de flujo de datos para servicios webCada tabla de flujos de datos para un servicio web tiene varios atributos.

Estos atributos se describen en la tabla siguiente.


NombreIdentifica la tabla y es el nombre al que acceden las vistasempresariales que dependen de esta tabla.

El nombre debe ser exclusivo entre todos los objetos de la mismacarpeta (incluidos los objetos del panel de control y los panelesde control). La carpeta raíz también contiene objetos globalescomo usuarios y roles, y actividades empresariales. Para obtenermás información, consulte: “Espacio de nombres de objeto” en lapágina 277.


DescripciónDescripción opcional que puede contener cualquier carácter detexto.


Habilitar recuperaciónCuando está habilitado, registra los datos de un evento que sereciben después de que se inicie el punto de comprobación. Esteregistro de recuperación se utiliza para restaurar el estado delsistema después de un cierre anómalo de los servidores. Paraobtener más detalles, consulte la información sobre el punto decomprobación y la recuperación en la publicación IBMCognosReal-time Monitoring Workbench Guía del usuario.


Seleccione esta opción cuando los eventos deban procesarse en elorden en el que se reciben. De otro modo, si los eventos sepueden procesar en otro orden, inhabilite esta opción. Para unirlos eventos en una vista, los eventos se deben procesar pororden. Deje esta opción habilitada para unir los eventos.


Inhabilita el flujo de datos cuando se produce un recuentoconsecutivo de errores. Por ejemplo, si se establece en 5,inhabilita el flujo de datos después de 5 errores consecutivos. Sinembargo, si se producen 4 errores y después no se produceningún error hasta que se producen 2 errores, el flujo de datospermanece habilitado. Está desactivado de formapredeterminada: No inhabilitar.


Los campos Información de la columna definen las columnas enla tabla de flujos de datos y tienen el mismo nombre que loscampos en el mensaje XML, tal como se describe en el WSDLpara el flujo de datos.




Atributos de flujo de datos para servicios web de sondeoCada tabla de flujos de datos para un servicio web de sondeo tiene variosatributos.


Atención: Al establecer planificaciones, la hora se basa en la hora del servidor, nola hora local.

Tabla 103. Atributos de flujo de datos para servicios web de sondeo


Nombre Identifica la tabla y es el nombre al que acceden las vistasempresariales que dependen de esta tabla. Este nombre debe serexclusivo entre vistas, flujos de datos, tablas de consulta y flujosde datos consolidados. Para obtener más información, consulte:“Espacio de nombres de objeto” en la página 277.

Estado Si el objeto está habilitado (es capaz de recibir y pasar datos)) oinhabilitado (no recibe ni pasa datos).

Descripción Descripción opcional de la tabla.

Guardar en Especifica la carpeta en la que se guardará el agente. Lapredeterminada es Carpetas públicas. Pulse Seleccionar carpetapara seleccionar una carpeta.

Agente de servicio web Agente que utiliza este flujo de datos. Pulse Cambiar paraseleccionar el agente de servicio web.

Tipo de puerto Opcionalmente, especifica el tipo de puerto necesario paraeliminar la ambigüedad entre operadores con el mismo nombre.La necesidad de proporcionar un tipo de puerto se basa en elWSDL que se utiliza.

Método Método del servicio web que se usará. Cuando el servicioproporciona varios métodos, debe escoger cuál utilizar.

Habilitar recuperación Cuando está habilitado, registra los datos de un evento que sereciben después de que se inicie el punto de comprobación. Esteregistro de recuperación se utiliza para restaurar el estado delsistema después de un cierre anómalo de los servidores. Paraobtener más detalles, consulte la información sobre el punto decomprobación y la recuperación en la publicación IBMCognosReal-time Monitoring Workbench Guía del usuario.


Seleccione esta opción cuando los eventos deban procesarse enel orden en el que se reciben. De otro modo, si los eventos sepueden procesar en otro orden, inhabilite esta opción. Para unirlos eventos en una vista, los eventos se deben procesar pororden. Deje esta opción habilitada para unir los eventos.


Inhabilita el flujo de datos cuando se produce un recuentoconsecutivo de errores. Por ejemplo, si se establece en 5,inhabilita el flujo de datos después de 5 errores consecutivos.Sin embargo, si se producen 4 errores y después no se produceningún error hasta que se producen 2 errores, el flujo de datospermanece habilitado. Está desactivado de formapredeterminada: No inhabilitar.

Tratar todas las filas delconjunto de resultadoscomo un solo evento

Todas las filas devueltas en el conjunto de resultados seconsideran un solo evento. De lo contrario, cada fila devuelta dela tabla se considera un evento por separado.

Raíz XPath Identifica la raíz XPath de los elementos de repetición de lasalida que resume una fila de datos.

Capítulo 37. servicios web 377

Tabla 103. Atributos de flujo de datos para servicios web de sondeo (continuación)



Los campos Información de la columna definen las columnasen la tabla de flujos de datos. Estos nombres son los mismosque los campos en el mensaje XML, que se describen en elWSDL para el flujo de datos.

Argumentos de entrada Los campos Argumentos de entrada son los valoresproporcionados en la entrada para el método, si el métodonecesita valores de entrada. Si el valor no tiene ningúnargumento de entrada, no es necesario especificar ningún campode argumento de entrada.



Sondeo Esta tabla contiene opciones para establecer la frecuencia delsondeo de datos en el servicio web. Las opciones son:

v Sondear un intervalo

Establezcamos el intervalo entre sondeos. El valorpredeterminado es de 600 segundos.

v Sondear una planificación

Seleccione la opción para sondear el servicio web en unaplanificación. Al seleccionar esta opción, se activa lacaracterística de planificación.

Deshabilitar flujo dedatos después de estenúmero de errores desondeo consecutivos

Inhabilita el flujo de datos cuando se produce un recuentoconsecutivo de errores de sondeo. Por ejemplo, si se establece en5, inhabilita el flujo de datos se inhabilita después de 5 erroresde sondeo consecutivos. Sin embargo, si se producen 4 errores ydespués no se produce ningún error hasta que se producen 2errores, el flujo de datos permanece habilitado.

Creación de un flujo de datos para un servicio webAntes de crear una tabla de flujos de datos para un servicio web, debe crearpermisos para las tablas.

Para obtener más información, consulte: Capítulo 23, “Permisos”, en la página 291y “Cómo otorgar permiso para crear objetos” en la página 294.

Procedimiento1. Cree un flujo de datos para un servicio web en IBM Cognos Real-time

Monitoring Workbench.2. Opcionalmente, cree una cuenta de usuario de IBM Cognos Real-time

Monitoring para el servicio web con el fin de utilizar ésta al publicar el evento.La cuenta debe disponer de, como mínimo, permiso de lectura y escritura parala tabla de flujos de datos con el fin de poder publicar en la tabla de flujos dedatos.

3. Recupere la definición WSDL del evento mediante HTTP.http://<host:port>/cognos/realtime/wsdl/eventstream.wsdl

En el archivo eventstream.wsdl se describen todos los objetos de flujo de datosdefinidos para los servicios web en Cognos Real-time Monitoring. Para obtenermás información, consulte la documentación de WSDL para obtener lasdescripciones de los elementos XML y los atributos.


4. Cree el cliente de servicio web de acuerdo con la información para WSDL a laque se hace referencia en el 3.El ejemplo XML lleva datos al flujo de datos OrderWSEvent y especifica lacuenta utilizada para acceder al flujo de datos (WSInputAccount).Existen cuatro columnas de datos definidas en el elemento<OrderWSEventData>.<?xml version="1.0" encoding="UTF-8"?>

<soapenv:Envelope

xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:xsd="http://www.w3.org/2001/XMLSchema"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<soapenv:Body>

<OrderWSEvent_input xmlns="http://cognos.obi.com">

<cqesi>

<eventname>OrderWSEvent</eventname>

<username>WSInputAccount</username>

<password>wspwd</password>

</cqesi>

<OrderWSEventData>

<ProdName>Plywood</ProdName>

<OrderQuantity>150</OrderQuantity>

<OrderTotal>987.34</OrderTotal>

<IsBackordered>true</IsBackordered>

</OrderWSEventData>

</OrderWSEvent_input>

</soapenv:Body>

</soapenv:Envelope>

5. Publique flujos de datos en la dirección URL identificada en el archivoeventstream.wsdl, de forma similar a la indicada en el siguiente ejemplo:http://<host:port>/cognos/realtime/webservice/eventstream.wsdl

Si posteriormente cambia la máquina que aloja los servidores de CognosReal-time Monitoring, asegúrese de volver a consultar el archivo WSDL paradeterminar la dirección URL correcta.

Tablas de consulta para servicios webLas vistas empresariales solicitan filas de una tabla de consulta que coinciden conuno o más valores de entrada, como una lista de proveedores que suministran unelemento, donde el ID de elemento es la entrada. Esa entrada se transmite entoncesa la aplicación de servicio web a través del agente como XML. A continuación, laaplicación devuelve una o más filas de datos como XML, las cuales secorrelacionan con la tabla de consulta. La tabla transmite los datos solicitados a lavista empresarial solicitante.


Los agentes de servicio web de IBM Cognos Real-time Monitoring son síncronos:recuperan datos de tabla de consulta como resultado de una solicitud específica. Alsolicitar datos, el agente utiliza enlace de Protocolo de acceso a objetos simple(SOAP) para comunicarse con la aplicación a través de una conexión HTTP. Acontinuación, la aplicación devuelve una o más filas de datos en XML, siguiendo elformato de tipo documento del lenguaje de definición de servicio web (WSDL). Nose da soporte al estilo RPC de WSDL.

Para obtener más información sobre los agentes de tablas de consulta, consulte:“Agentes de servicio web” en la página 39.

Antes de crear una tabla de consulta para datos de un servicio web, debe tener losiguiente:v Permisos de creación para tablas. Para obtener más información, consulte:

Capítulo 23, “Permisos”, en la página 291 y “Cómo otorgar permiso para crearobjetos” en la página 294.

v Un agente de servicio web que proporcione datos a la tabla. Para obtener másinformación, consulte: “Agentes de servicio web” en la página 39.

v Permiso de acceso de sólo lectura para el agente.

Una tabla de consulta para servicios web tiene los siguientes atributos:

Tabla 104. Atributos de tabla de consulta para servicios web


Nombre Nombre de tabla de consulta.

El nombre debe ser exclusivo entre todos los objetos de la mismacarpeta (incluidos los objetos del panel de control y los panelesde control). La carpeta raíz también contiene objetos globalescomo usuarios y roles, y actividades empresariales. Para obtenermás información, consulte: “Espacio de nombres de objeto” en lapágina 277.

Estado Especifica si el objeto está habilitado (preparado para recibirdatos) o inhabilitado (no preparado para recibir datos).

Descripción Descripción opcional que puede contener cualquier carácter detexto.

Los servicios web proporcionan datos de tabla de consulta en respuesta a una solicitud de una tabla de consulta.

Negocio

Tabla deconsulta

Salida

Entrada

Web Web

Datos para

Solicitados

Figura 43. Tablas de consulta para servicios web


Tabla 104. Atributos de tabla de consulta para servicios web (continuación)



Agente de servicio web Agente de servicio web existente que conecta con una aplicaciónde servicio web. Crear un agente mediante la pestañaWorkbench Administration. Para obtener más información,consulte: “Agentes de servicio web” en la página 39. Este valorno se puede cambiar.

Método Método del servicio web que se usará. Cuando el servicioproporciona varios métodos, se debe escoger cuál utilizar. Estevalor no se puede cambiar en este en esta versión.

Deshabilitar tabla deconsulta después deeste número de erroresconsecutivos

Número de errores consecutivos recibidos del sistema antes deque se inhabilite la tabla de consulta. Una vez inhabilitadas, lastablas de consulta deben volver a habilitarse manualmente. Elvalor predeterminado es 5.

Raíz XPath Identifica la raíz XPath de los elementos de repetición de lasalida, normalmente /Envelope/Body. Esta ruta se antepone atodas las rutas de la lista Nombre de campo de salida.

Salidas Columnas que reciben la información del servicio web. Paraobtener más información sobre las columnas de salida, consulte:“Columnas de salida” en la página 382.

Entradas Columnas que contienen los datos que identifican qué buscar enla consulta. Para obtener más información sobre las columnas deentrada, consulte: “Columnas de entrada” en la página 382.

Almacenamiento dedatos en memoria caché

Para obtener información sobre el almacenamiento en memoriacaché, consulte: “Almacenamiento de consultas de tabla deconsulta en la memoria caché” en la página 265.

Creación de una tabla de consulta para datos de un servicioweb

Utilice el procedimiento siguiente para crear una tabla de consulta para datos deun servicio web.

Procedimiento1. En IBM Cognos Real-time Monitoring Workbench, pulse la pestaña Workbench.2. Pulse Actividades.3. Pulse Crear nuevo > Tabla de consulta.4. En la ventana Nueva tabla de consulta, seleccione Servicio web como tipo de

origen.5. Seleccione un agente de Servicio web existente.6. Seleccione el método de servicio que ha de utilizarse. Cada servicio web

proporciona uno o varios métodos para acceder a los datos que proporcionasegún su definición de archivo WSDL (cuya ubicación URL ha especificado alcrear el agente de servicio web). Seleccione el método que realiza la consultaque sus tablas de consulta necesitan.

7. Defina las columnas que recibirán información del servicio web, es decir, lascolumnas de la salida. De forma predeterminada, el editor define una columna


para cada elemento que el método devuelve. Para obtener más informaciónsobre cómo definir estas columnas, consulte: “Columnas de salida”.

8. Defina las columnas que contendrán los datos que identificarán qué ha debuscarse en la consulta, es decir, las columnas de entrada. De formapredeterminada, el editor define una columna para cada elemento que elmétodo devuelve. Para obtener más información sobre las columnas de entrada,consulte: “Columnas de entrada”.

9. Especifique cuántos resultados han de almacenarse en la memoria caché, siprocede. Para obtener más información sobre el almacenamiento en memoriacaché, consulte: “Almacenamiento de consultas de tabla de consulta en lamemoria caché” en la página 265.Guarde la tabla de servicios web como habilitada.

Columnas de salidaLas columnas de salida reciben la información del servicio web y definen la tablapara recibir los datos. El editor define automáticamente una columna para cadaelemento devuelto por el método.

Cada columna tiene los siguientes atributos:

Tabla 105. Atributos de la columna de salida


Nombre de la columna Nombre de la columna de tabla que contiene el resultadodevuelto por el servicio web. De forma predeterminada, elnombre es el mismo que el elemento de Nombre de campo desalida. Puede asignar cualquier nombre válido.

Nombre de campo desalida

Identifica el elemento del XML devuelto por el servicio. Sepuede visualizar la ruta entera al elemento abriendo el cuadroOcultar/Mostrar. Este atributo no se puede cambiar.

Tipo de datos XSD Identifica el tipo de datos del elemento del XML. Sólo sesoportan los tipos de datos básicos: números, cadenas, fechas ybooleanos. No se soportan tipos complejos como ANY yARRAY, ni tipos MIME. Este atributo no se puede cambiar.

Tipo de datos Tipo de datos de IBM Cognos Real-time Monitoring de lacolumna de la tabla. Escoja un tipo de datos apropiado para losdatos devueltos.

Formateo Formatea el valor String, Date-Time o DECIMAL devuelto. Estaopción no está disponible para otros tipos de datos. Paraobtener más información sobre tipos de datos, consulte:Capítulo 9, “Tipos de datos”, en la página 69.

Para excluir columnas del resultado, abra el cuadro Ocultar/Mostrar y anule laselección de los campos que se deben excluir.

Columnas de entradaLas columnas de entrada transmiten información al servicio web para identificar lainformación para devolver (las salidas). El editor define automáticamente unacolumna para cada elemento identificado por el método. Cada columna tiene lossiguientes atributos:


Tabla 106. Atributos de la columna de entrada


Nombre de la columna Nombre de la columna que contiene la información transmitidaa la consulta del servicio web. Por ejemplo, puede contener unID que identifica un producto para buscar. Esta columna serellena con la vista empresarial que requiere la información dela tabla de consulta. De forma predeterminada, el nombre es elmismo que el elemento de Nombre de campo de entrada.Puede asignar cualquier nombre válido.

Nombre de campo deentrada

Identifica el elemento del XML que se pasa al servicio. Sepuede visualizar la ruta entera al elemento abriendo el cuadroOcultar/Mostrar. Este atributo no se puede cambiar.

Plantilla de sustituciónde cadenas

Cadena para transmitir al servicio, que contiene valoresinsertados por la vista empresarial que solicita la información.Para obtener más información, consulte: “Plantillas desustitución de cadenas”.

Tipo de datos XSD Identifica el tipo de datos del elemento del XML. Sólo sesoportan los tipos de datos básicos: números, cadenas, fechas ybooleanos. No se soportan tipos complejos como ANY yARRAY, ni tipos MIME. Este atributo no se puede cambiar.

Tipo de datos Tipo de datos de IBM Cognos Real-time Monitoring delatributo Nombre de la columna. Escoja un tipo de datosapropiado para los datos para transmitir.

Formateo Formatea el valor String, Date-Time o DECIMAL devuelto. Estaopción no está disponible para otros tipos de datos. Paraobtener más información, consulte: Capítulo 9, “Tipos dedatos”, en la página 69.

Para excluir las columnas innecesarias de la consulta, abra el cuadroOcultar/Mostrar y anule la selección de los campos para excluir.

Plantillas de sustitución de cadenasLa sustitución de cadenas se utiliza cuando un servicio web necesita datos para unparámetro en el que los datos para ese parámetro se proporcionan como más de unúnico parámetro en el flujo de datos.

La Plantilla de sustitución de cadenas le permite unir parámetros del flujo dedatos para que éstos puedan pasarse al servicio web como un único campo.

Las sustituciones de cadenas son opcionales. Sólo debe utilizarlas según seanecesario para el servicio web.

Procedimiento1. Pulse ... para abrir el editor de plantillas.2. Escriba la expresión de plantilla seguida de un signo igual (=) y de un signo de

interrogación (?) para el nombre de columna que desea sustituir. Para combinarnombres de columnas, especifique un ampersand (&) entre cada expresión.

3. En Campos de sustitución, especifique el nombre que desea utilizar para cadacampo de sustitución.

4. Guarde la plantilla para actualizar los campos Nombre de la columna enEntradas. Los nombres especificados para los campos de sustitución sustituyena los nombres de columna.


Procesos externos del servicio webLos procesos externos del servicio web son métodos que reciben documentos XMLque describen el mensaje de alerta o el objeto del panel de control que está viendoun usuario de IBM Cognos Real-time Monitoring Dashboard y que el usuario haenviado al servicio. El documento XML describe todos los datos del elemento queestaba viendo el usuario.

Publicar un elemento en un servicio web externoPuede publicar un elemento en un servicio web externo.

Procedimiento1. Defina el proceso externo que ha de recibir el mensaje en IBM Cognos

Real-time Monitoring Workbench. Para obtener más información, consulte:“Creación de un proceso externo”.

2. Envíe el elemento desde Cognos Real-time Monitoring Dashboard. Al visualizarun mensaje de alerta, una tarea, o un objeto de panel de control, seleccioneLlevar a cabo una acción > Iniciar proceso y seleccione el proceso. El servicioexterno recibirá el elemento en forma de documento XML y lo procesará. Paraobtener más información, consulte: “Implementación del servicio externo” en lapágina 385.

Atributos de proceso externoCada proceso externo presenta varios atributos.


Tabla 107. Atributos de proceso externo


Nombre Nombre de proceso externo para que aparezca en el cuadroIniciar proceso en IBM Cognos Real-time MonitoringDashboard. Este nombre debe ser exclusivo entre procesosexternos. Para obtener más información, consulte: “Espacio denombres de objeto” en la página 277.

Descripción Descripción opcional que puede contener cualquier carácter detexto. Esta descripción aparece en el cuadro Iniciar proceso enReal-time Monitoring Dashboard.

Estado Si el proceso está habilitado (enviando documentos XML) oinhabilitado (no enviando documentos).

URL de servicio web Ubicación HTTP de la aplicación que proporciona el servicioRPC (enlace SOAP). los mensajes de estilo DOC no sonsoportados.

Método Método del servicio web que se usará.

Nombre de usuario Cuenta que se deba utilizar al establecer conexión con elservicio. Este atributo es opcional.

Contraseña Contraseña para la cuenta. Este atributo es opcional.

Creación de un proceso externoPuede definir un proceso externo desde la pestaña Consola de administración deIBM Cognos Real-time Monitoring Workbench.


Antes de empezar

Antes de crear un proceso externo de servicios web, necesita lo siguiente:v Un método de servicio web externo definido para recibir el método publicado.

Debe conocer el URL para conectarse al servicio, el nombre del método querecibe el mensaje y el usuario o el nombre de cuenta y la contraseña necesariospara el servicio. Para obtener más información, consulte: “Implementación delservicio externo”.

v Utilice Crear para crear permisos para los procesos externos. Para obtener másinformación, consulte: “Cómo otorgar permiso para crear objetos” en la página294.

Procedimiento1. En IBM Cognos Real-time Monitoring Workbench, pulse Consola de

administración.2. Pulse Procesos externos.3. Pulse Nuevo proceso.4. Defina los atributos para el proceso.5. Guarde el proceso.

Para utilizar el proceso, en IBM Cognos Real-time Monitoring Dashboard,seleccione Llevar a cabo una acción > Iniciar proceso y seleccione el proceso.Para ver y utilizar un proceso de Cognos Real-time Monitoring Dashboard, losusuarios deben tener permiso de lectura para dicho proceso. Puede asignarpermisos para el nuevo objeto pulsando en Permisos en la lista Procesosexternos o bien un administrador puede otorgar acceso de lectura a la clase deprocesos externos para los usuarios. Para obtener más información, consulte:“Permisos de acceso” en la página 291.

Implementación del servicio externoPuede implementar el servicio web externo.

Para implementar el servicio web externo, realice los pasos siguientes:

Procedimiento1. Defina el servicio web para que se reciba un mensaje de enlace SOAP con los

campos en el XSD de acción externa.2. Cree un WSDL (archivo de definición) que siga los requisitos de destino e

importación de IBM Cognos Real-time Monitoring.

Campos de mensajeLos campos de mensaje XML se definen en el archivo de definicióninvokeExternalAction.xsd.

Puede ver este archivo (y todos los archivos XSD) en la siguiente ubicación:realtime\sdk\api\metadata.

Para obtener más información sobre los archivos XML y XSD en Cognos Real-timeMonitoring, consulte: Capítulo 39, “Archivos XML y XSD utilizados por IBMCognos Real-time Monitoring”, en la página 409.

Debe tener el archivo common.xsd en el mismo directorio.


Cada mensaje contiene estos campos:v description

Descripción del proceso externo tal como se ha definido en IBM CognosReal-time Monitoring Workbench

v actionNameNombre del proceso externo definido en Workbench.

v severityGravedad del mensaje de alerta original o gravedad seleccionada por el usuarioque inicia el mensaje.

Pueden incluirse otros campos según sea necesario, en función del objeto que elusuario visualiza en Cognos Real-time Monitoring Dashboard cuando inicia laacción, como el asunto de un mensaje de alerta, o el conjunto de filas de los datosde la vista sobre los que se presenta el diagrama. Para obtener información,consulte el archivo XSD.

WSDL de servicio webAl implementar el servicio web, defínalo para recibir un mensaje SOAP yestablecer sus atributos.

El servicio web puede tener los atributos descritos en la tabla siguiente:

Tabla 108. Atributos de WSDL

Atributo Valor Comentario

Estilo RPC No utilizar "documento".

Espacio denombres dedestino (tns)

http://cognos.obi.com

—

Codificación(soap:body)

Codificado No utilizar "literal".

Importar espaciode nombres

http://cognos.obi.com/2

Define los tipos de datos de IBM CognosReal-time Monitoring. Otra posibilidad esdefinir los tipos de datos en el WSDL. Ladefinición de tipo queda fuera del ámbito deeste documento.

Importar ubicación Específico de lainstalación

Ubicación de invokeExternalAction.xsd en lainstalación.

El siguiente es un WSDL de ejemplo que controla el mensaje invokeExternalActionen una máquina y puerto llamado host:80. Importa el archivo de definicióninvokeExternalAction.xsd.<?xml version="1.0" encoding="utf-8" ?>

<definitions

xmlns:http="http://schemas.xmlsoap.org/wsdl/http/"

xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"

xmlns:xsd="http://www.w3.org/2001/XMLSchema"

xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"

xmlns:tm="http://microsoft.com/wsdl/mime/textMatching/"

xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/"

xmlns:impl="http://cognos.obi.com/5"


xmlns:tns="http://cognos.obi.com"

targetNamespace="http://cognos.obi.com"

xmlns="http://schemas.xmlsoap.org/wsdl/">

<import namespace="http://cognos.obi.com/5"

location="/cognos/obi/api/metadata/invokeExternalAction.xsd"/>

<message name="invokeExternalActionRequest">

<part name="request" element="impl:invokeExternalAction"/>

</message>

<portType name="invokeExternalActionPortType">

<operation name="invokeExternalActionOperation">

<documentation>Receives a IBM Cognos Real-timeMonitoring external action.

</documentation>

<input message="tns:invokeExternalActionRequest"/>

</operation>

</portType>

<binding name="invokeExternalActionBinding"

type="tns:invokeExternalActionPortType">

<soap:binding transport="http://schemas.xmlsoap.org/soap/http"

style="rpc" />

<operation name="invokeExternalActionOperation">

<soap:operation soapAction=""/>

<input>

<soap:body

encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"

namespace="http://cognos.obi.com" use="encoded"/>

</input>

</operation>

</binding>

<service name="invokeExternalActionService">

<port name="invokeExternalActionService"

binding="tns:invokeExternalActionBinding">

<soap:address

location="http://host:80/axis/services/invokeExternalActionService"/>

</port>

</service>

</definitions>



Capítulo 38. Ventanas de consulta

Una ventana de consulta especifica un conjunto de filas que se utilizan en cálculoscon respecto a la fila actual en proceso de examen en una sentencia C-SQLSELECT.

Para obtener más información sobre las sentencias C-SQL SELECT, consulte:Capítulo 32, “Sentencias SELECT”, en la página 333.

Las vistas empresariales y los cubos creados en IBM Cognos Real-time MonitoringWorkbench crean sentencias C-SQL internamente que se transmiten a losservidores. El término evento especifica una fila o un conjunto de filas que llegan alsistema al mismo tiempo. El origen de esta fila o filas es un flujo de datos.

Visión general de las ventanas de consultaEl cálculo usando una ventana puede ser para calcular una función de conjuntomóvil, una unión o las filas que caducan de una vista.

Todos los cálculos de este tipo utilizan una ventana. En los casos predeterminadospara estas operaciones, no es necesario definir la semántica de la ventana. Porejemplo, en C-SQL, las funciones de conjunto realizan cálculos en conjuntos defilas en una vista. El conjunto de filas predeterminado para cada función son todoslos eventos porque la vista se ha iniciado (un conjunto "sin límites"). Observe elsiguiente ejemplo que calcula el valor total de una columna llamada Cant. paratodos los eventos que se han incluido alguna vez en la vista:SELECT SUM(Qty) AS Total_QtyFROM Orders

Otra forma de expresar la SUM() a fin de obtener el mismo resultado es lasiguiente, que indica sumar el conjunto de todos los eventos anteriores:SELECT SUM(Qty)OVER(EVENTS UNBOUNDED PRECEDING) AS Total_Qty

FROM Orders

La cláusula OVER define una ventana que identifica el conjunto de filas paraincluir. Con una ventana, se puede limitar el conjunto a un recuento específico defilas de eventos o a los eventos que se produjeron dentro de un intervalo detiempo específico. Para sumar el evento actual y los últimos cinco eventos, definauna ventana como en el siguiente ejemplo:SUM(Qty) OVER (EVENTS 5 PRECEDING)ASTotal_Qty

Si desea sumar los eventos del mes actual, utilice una ventana de serie de tiempo,como en el siguiente ejemplo:SUM(Qty) (RANGE INTERVAL ’1’ MONTH PRECEDING)ASTotal_Qty OVER

Tipos de ventanaTodas las ventanas están identificadas por la cláusula EVENTS o RANGE eincluyen una definición de extensión que define el tamaño de la ventana.


{ RANGE | EVENTS }<window frame extent >

La sintaxis de extensión es exclusiva del tipo de ventana y se describedetalladamente en “Ventanas de serie de eventos” en la página 392 y “Ventanas deserie de tiempo” en la página 394. Otras cláusulas (no se muestran) controlan cómose comporta la ventana a medida que entran nuevos eventos en ella, qué elementosdeben incluirse y cómo y cuándo se actualiza la ventana para incluir nuevoseventos y descartar los antiguos.

Declaraciones y referencias de ventanasExisten dos formas de definir ventanas y asociarlas a funciones.

En líneaEn línea define los parámetros de ventana inmediatamente después de la referenciade función.

Por ejemplo:SELECT PartName, SUM(Qty) OVER (EVENTS 4PRECEDING) AS Total_Qty,

FROM Orders

GROUP BY PartName

Este formato es útil cuando sólo tiene una ventana por consulta, aunque tambiénpuede utilizarse con varias ventanas. No puede compartir estas definiciones deventanas entre funciones de una misma consulta.

Referencia por nombreReferencia por nombre para utilizar una ventana definida con la cláusulaWINDOW.

Por ejemplo:SELECT PartName,

SUM(Qty) OVER Previous4 ASTotal_Qty,

AVG(Qty) OVER Previous4 ASAverage_Qty

FROM Orders

GROUP BY PartName

WINDOW Previous4 AS (EVENTS 4 PRECEDING)

Este formato es útil cuando se tienen varias definiciones de ventana simplesporque se pueden definirlas en un lugar: en la misma definición de cláusulaWINDOW. Este formulario también permite compartir la definición entre variasfunciones de la misma consulta (como se ha mostrado con anterioridad) y permiteutilizar ventanas que amplían la definición a otra ventana. Para obtener másinformación, consulte: “Ampliación de una definición de ventana con otra” en lapágina 391.

Las funciones de la lista de selección asociadas con una ventana deben tenernombres de alias definidos con el operador AS, como AS Total_Qty en los ejemplosanteriores.


Varias ventanas por consultaLa cláusula WINDOW define las ventanas que pueden compartirse dentro de laconsulta y que pueden ser ampliadas por otras ventanas.

En el siguiente ejemplo se definen dos ventanas, cada una de ellas utilizada poruna función distinta de la consulta:SELECT PartName,

SUM(Qty) OVER Previous4 ASTotal_Qty_4,

AVG(Qty) OVER Previous10 ASAverage_Qty_10

FROM Orders

GROUP BY PartName

WINDOW Previous4 AS (EVENTS 4 PRECEDING),

Previous10 AS (EVENTS 10 PRECEDING)

Ampliación de una definición de ventana con otraCuando hay ventanas que comparten características comunes, puede definir dichascaracterísticas en una definición de ventana y luego ampliar (heredar) dichadefinición con otros aspectos exclusivos en otras ventanas.

Por ejemplo, la definición siguiente define una ventana llamada Common con lacláusula PARTITION BY, y luego define ventanas adicionales que amplían lascaracterísticas comunes con el rango necesario para las ventanas exclusivas.SELECT PartName,

SUM(Qty) OVER Events4 ASTotal_Of_Qty_4,

AVG(Qty) OVER Events10 ASAverage_Of_Qty_10

FROM Orders

WINDOW Common AS (PARTITIONBY PartName),

Events4 AS (Common EVENTS4 PRECEDING),

Events10 AS (Common EVENTS10 PRECEDING)

La definición de WINDOW anterior es la misma que:Events4 AS (PARTITION BY PartName EVENTS 4 PRECEDING),

Events10 AS (PARTITION BY PartName EVENTS 10 PRECEDING)

RestriccionesLas definiciones de extensión de ventana no pueden incluir las propiedadesdefinidas en la ventana base.

Por ejemplo, no puede definir ORDER BY tanto en la ventana base como en la deextensión. Además:v La cláusula PARTITION BY sólo puede aparecer en la definición de ventana

base; no puede aparecer en las extensiones.v Estas cláusulas sólo pueden aparecer en las definiciones de extensión; no pueden

aparecer en la ventana base:BETWEEN/AND

Capítulo 38. Ventanas de consulta 391

CURRENT EVENT

EVENTS

INITIALIZE

RANGE

REFERENCE

SLIDE

UNBOUNDED

< window start integer > without an EVENTS or RANGEclause

v Una ventana sólo puede ampliar a otra ventana definida en la misma consulta;una ventana en una vista derivada no puede ampliar a una ventana en una vistabase.

Ventanas de serie de eventosLas ventanas de serie de eventos contienen un conjunto máximo fijo de eventos.

Inicialmente la ventana está vacía, pero se llena con nuevos eventos hasta quealcanza su capacidad definida. A partir de este momento, los eventos más antiguosse descartan a medida que se incluyen los eventos más nuevos.

Cláusula EVENTSLas ventanas de serie de eventos se identifican mediante la cláusula EVENTS.

Existen dos formas de expresar lapsos de eventos. El primer método es utilizar lascláusulas BETWEEN y AND, que especifican los límites superior e inferior de laventana. El segundo método es utilizar la expresión PRECEDING, que especificasólo el límite inferior de la ventana. El límite superior es el evento actual en elsegundo caso. La expresión PRECEDING indica que las filas de evento preceden alevento actual.([PARTITION BY < column >]

EVENTS { BETWEEN {< oldestEvent>| UNBOUNDED} PRECEDING

AND { < newestEvent> PRECEDING | CURRENTEVENT }

|{< oldestEvent > | UNBOUNDED} PRECEDING

}

[SLIDE < distance >]

[REFERENCE {FRAME | OPERATOR} ]

Esta ventana contienetres eventos

Eventos descartados

Eventos futuros

Los eventos más antiguos se descartancuando la ventana estállena y se añaden nuevoseventos.

Figura 44. Ventanas de serie de eventos


}

PARTITION BY crea un marco de ventana para cada <columna> de eventos,similar a una ventana GROUP BY. Para obtener información, consulte: “Particionesde ventana” en la página 399.

SLIDE identifica cómo avanzar la ventana cuando llegan nuevos eventos en lavista. Para obtener una descripción detallada de esta opción, consulte: “Avance delas ventanas” en la página 403.

REFERENCE indica a la ventana cuándo debe determinar si han caducado filas delconjunto de ventanas. Para obtener más información sobre esta opción, consulte:“Referencia de actualización de ventana” en la página 406.

Ejemplo de cláusula EventsEsta ventana contiene filas limitadas por un recuento de eventos consecutivos en lavista, como los últimos cinco eventos:SUM(Qty) OVER (EVENTS 4 PRECEDING)ASTotal_Qty

O los 10 eventos empezando por los 12 eventos anteriores:SUM(Qty) OVER (EVENTS BETWEEN 11 PRECEDINGAND 2 PRECEDING)

AS Total_Qty

Tenga en cuenta que el tamaño del marco de ventana es (<eventomásantiguo>-<eventomásreciente>+1), donde <eventomásantiguo> es el evento más antiguo, y<eventomásreciente> es el evento más nuevo. Por ejemplo, el marco anteriorcontiene 10 eventos (11-2+1).

Para incluir todos los eventos anteriores, incluido el actual, con la opciónUNBOUNDED, como en el ejemplo siguiente:SUM(Qty) OVER (EVENTS UNBOUNDED PRECEDING)ASTotal_Qty

Este comportamiento es el mismo que si no se hubiera definido ninguna ventana:SUM(Qty) AS Total_Qty

Evento actualEl recuento está basado en cero. El evento cero (0) es el evento actual.

En los ejemplos incluidos en “Ejemplo de cláusula Events”, observe que el númerodel evento inicial es el evento inicial que se desea menos 1.

Otra forma de expresar los cinco últimos eventos es:OVER (EVENTS BETWEEN 4 PRECEDING AND 0 PRECEDING)

6 5 4 3 2 1 0

Ventana de 5 eventos, incluyendoel evento actual.

Hace siete eventos Evento actual

Figura 45. Cómo se calculan los eventos


Y otra manera de expresar el rango de eventos consiste en utilizar el literalCURRENT EVENT de la siguiente manera:OVER (EVENTS BETWEEN 4 PRECEDING AND CURRENT EVENT )

Ventanas de serie de tiempoLas ventanas de serie de tiempo crecen para albergar todos los eventos que seproducen dentro de un intervalo de tiempo.

Por ejemplo, la ventana de 1 día que se muestra en la siguiente ilustración crece amedida que llegan nuevos eventos durante el día.

De forma similar, una ventana de 3 días incluye todos los eventos que seencuentran dentro de la ventana actual de 3 días.

Cláusula RANGELas ventanas de serie de tiempo son identificadas por la cláusula RANGE.

Estas ventanas contienen filas que están limitadas a un rango de tiempo encombinaciones de años, meses, días, horas, minutos o segundos. Existen dosformas de expresar lapsos de eventos. El primer método es utilizar las cláusulasBETWEEN y AND, que especifican los límites superior e inferior de la ventana. (Ellímite superior es inclusivo y el límite inferior es exclusivo). El segundo método esutilizar la expresión PRECEDING, que especifica sólo el límite inferior de laventana. El límite superior es el último indicación de fecha y hora en el segundocaso.([PARTITION BY < column >]

[ORDER BY {< date-time column > | < integer column>}[ ASC | DESC ] ]

RANGE {BETWEEN

{INTERVAL < oldestTime > | < oldestInt>| UNBOUNDED} PRECEDING

AND {INTERVAL < newestTime > | < oldestInt>}PRECEDING

1 día 1 día 1 día 1 día

Último evento

Último evento

Figura 46. Ventana de un día

Durante el tercer día Durante el cuarto día Durante el quinto día

Figura 47. Ventana de tres días


|{INTERVAL < oldestTime > | < oldestInt> | UNBOUNDED} PRECEDING

}

[SLIDE [INTERVAL < distance >]]

[REFERENCE {FRAME | OPERATOR} ]

[INITIALIZE < initTimestamp >]

)

Al utilizar una cláusula RANGE, tenga en cuenta lo siguiente:v Las columnas order-by, "oldest" y "newest" normalmente son tipos de datos de

fecha y hora. Sin embargo, también puede utilizar un número entero querepresente una serie de tiempo. Para obtener más información, consulte: “Seriesde tiempo en enteros” en la página 398.

v PARTITION crea una ventana para cada < columna > de eventos, similar a unaventana GROUP BY. Para obtener más información, consulte: “Particiones deventana” en la página 399.

v ORDER BY identifica la columna utilizada para calcular la hora del evento. Paraobtener más información, consulte: “Cláusula ORDER BY” en la página 396.

v SLIDE identifica cómo avanzar la ventana cuando llegan nuevos eventos en lavista. Para obtener más información, consulte: “Avance de las ventanas” en lapágina 403.

v INITIALIZE especifica un conjunto fecha y hora habitual para el cual seinicializarán todas las ventanas asociadas en una vista. Cuando se utiliza unaventana de serie de tiempo, es mejor inicializar la hora de inicio para que seamedianoche para las ventanas de día, mes y año; al primer día del mes para lasventanas de mes y año; y al primer día del rango deseado para las ventanas deaño. Para obtener más información, consulte: “Inicialización de ventanas” en lapágina 407.

v REFERENCE indica a la ventana cuándo debe determinar si han caducado filasdel conjunto de ventanas. Para obtener más información, consulte: “Referenciade actualización de ventana” en la página 406.

v ASC especifica que las filas están ordenadas según sus indicaciones de fecha yhora, de la más antigua a la más reciente. Para más información sobre el orden,consulte: “Descendente” en la página 397.

v DESC especifica que las filas están ordenadas según sus indicaciones de fecha yhora, de la más reciente a la más antigua. Para más información sobre el orden,consulte: “Descendente” en la página 397.

Ejemplos de cláusula RANGEEste ejemplo genera el total de la columna Qty para los eventos del mes en curso.SUM(Qty) OVER (RANGE INTERVAL ’1’ MONTH PRECEDING)ASTotal_Qty

También puede identificar rangos específicos, como el siguiente, que empieza 18horas y 15 minutos antes y termina 45 segundos antes. Para obtener másinformación sobre las especificaciones de fecha-hora, consulte: “Fecha y hora” en lapágina 76.OVER (RANGE BETWEEN INTERVAL ’18:15’ HOUR TO MINUTE PRECEDING

AND INTERVAL ’45’ SECOND PRECEDING

)


¿Qué eventos se incluyen?Los eventos que se incluyen en una ventana de serie de tiempo se determinancuando entra un nuevo evento en la ventana o vista.

Para obtener más información, consulte: “Referencia de actualización de ventana”en la página 406.

El intervalo incluye todos los eventos cuyo tamaño es el intervalo de rango delevento actual. Supongamos, por ejemplo, una ventana con un intervalo de un día:SUM(order_qty) OVER ( RANGE INTERVAL ’1’ DAY PRECEDINGAS TotalQty

Cuando dos eventos tienen un día entre ellos, ambos se incluyen en la ventana.Observe el valor de TotalQty después de los dos eventos:order_qty TotalQty Event Time

--------- -------- ---------------------

1 1 2003-12-01 09:00:00.0

1 2 2003-12-0209:00:00.0

Al utilizar la cláusula BETWEEN, <oldestTime> se excluye y <newestTime> seincluye. Por ejemplo, utilice estas definiciones para tener dos ventanas, una para lasemana actual y una para la semana anterior a ésta:ThisWeek: RANGE INTERVAL ’7’DAY PRECEDING

LastWeek: RANGE BETWEEN INTERVAL ’14’ DAY PRECEDING

AND INTERVAL ’7’DAY PRECEDING

Observe que los dos rangos utilizan '7' como valor delimitador. La semana actualincluye todo desde ahora hasta siete días atrás inclusive, mientras que la semanaanterior incluye los siete días anteriores a hace siete días. Otra forma de definir lasventanas anteriores es utilizar '0' como hora actual; por ejemplo:ThisWeek: RANGE BETWEEN INTERVAL ’7’ DAY PRECEDING

AND INTERVAL ’0’DAY PRECEDING

LastWeek: RANGE BETWEEN INTERVAL ’14’ DAY PRECEDING


La fila de hace exactamente siete días no se incluiría en esta semana, sino que seincluiría en la última semana.

Cláusula ORDER BYA menos que se defina de otro modo, todas las horas se calculan en base a laindicación de fecha y hora interna de cada evento para la llegada del evento.

Por ejemplo, esta ventana contiene los eventos de la última hora en el orden enque llegaron al sistema.OVER (RANGE INTERVAL ’1’ HOUR PRECEDING)

Se puede designar cualquier columna de fecha y hora en el evento como clave. Porejemplo, puede que se desee utilizar la hora en la que se realizó el pedido:OVER (ORDER BY order.order_timestamp RANGE’4’ DAY PRECEDING)


El argumento ORDER BY es una referencia de nombre de columna única; no sepueden utilizar enteros para representar la posición ordinal de la columna en lalista SELECT. Además, el orden de clasificación predeterminado es ascendente(ASC), aunque también está disponible el orden descendente (DESC). Para obtenerinformación, consulte: “Descendente”. La cláusula ORDER BY presenta la sintaxissiguiente:ORDER BY < columnNameReference > [ ASC | DESC ]

Llegada en otro ordenCuando los eventos no están en el orden esperado, el motor de consulta intentainsertar el evento en otro orden en su ubicación correcta en el marco de ventana, yactualiza todas las agregaciones en consecuencia.

El motor de consulta siempre utiliza la hora más reciente de todos los eventosrecibidos antes del evento que se encuentra en un orden incorrecto paradeterminar si debe incluirse. Si el evento no se encuentra dentro de la ventana deconsulta más reciente, se omite.

Por ejemplo, supongamos que existe una ventana de 1 hora que recibe lossiguientes eventos en el orden indicado. En el ejemplo, el segundo evento es elúltimo, y sólo los eventos recibidos después de las 08:10 (09:10 menos 1 hora) seincluyen en la ventana. Por lo tanto, el cuarto evento es rechazado porque suindicación de fecha y hora es 08:04.OVER (ORDER BY Time RANGE INTERVAL’1’ HOUR PRECEDING)

Arrival

Sequence Time Amount

-------- ----- ------

1 08:45 242.69

2 09:10 103.76 << Latest timestamp setsthe window

3 08:50 90.20 << Out-of-order, accepted

4 08:04 188.88 << Out-of-order, rejected

Una vez procesados los cuatro eventos anteriores, la vista que los contiene essimilar al siguiente ejemplo:Arrival


-------- ----- ------

1 08:45 242.69

3 08:50 90.20 << Reordered

2 09:10 103.76

DescendenteDe forma predeterminada, se presupone que el orden es ascendente: los eventosmás antiguos se procesan primero.

Sin embargo, puede especificar DESC para la ordenación descendente. Cuandollegan eventos y todavía no están en orden descendente, se procesan igual que lodescrito en “Llegada en otro orden”.OVER (ORDER BY Time DESC RANGEINTERVAL ’1’ HOUR PRECEDING)

Arrival



-------- ----- ------

1 08:45 242.69

2 09:10 103.76 << Out-of-order, accepted,expires after fourth event

3 08:50 90.20 << Out-of-order, accepted

4 08:04 188.88

Una vez procesados los cuatro eventos anteriores, la vista que los contiene essimilar al siguiente ejemplo:Arrival


-------- ----- ------

4 08:04 188.88

1 08:45 242.69

3 08:50 90.20

Indicaciones de fecha y hora de valor NULLCuando la columna de referencia contiene un valor NULL para la indicación defecha y hora, el evento es rechazado a menos que rango sea UNBOUNDED.

Cuando el marco de ventana no tiene límites, se incluyen todos los eventos,incluidas las indicaciones de fecha y hora NULL, aunque los valores NULL secolocan los últimos del conjunto, en el orden en que llegaron. Por ejemplo:Arrival


-------- ----- ------

1 08:04 188.88

2 08:45 242.69

3 103.76 << First NULL time

4 08:50 90.20

5 157.11 << Second NULL time

Cuando se procesan los eventos anteriores en orden ascendente por columna detiempo, la vista resultante es parecida al ejemplo siguiente:Arrival


-------- ----- ------

1 08:04 188.88

2 08:45 242.69

4 08:50 90.20

5 157.11 << Second NULL time

3 103.76 << First NULL time

Series de tiempo en enterosUn rango de series de tiempo se expresa como un rango de valores de fecha y horao de intervalo de fechas.

Sin embargo, también puede utilizar un número entero que represente una serie detiempo. Por ejemplo, vea esta serie de valores de fecha y hora y sus valorescorrespondientes en enteros:


Date_time_value Date_time_int

------------------- -------------

2003-12-01 09:00:00 3795637500

2003-12-01 13:00:00 3795654167

2003-12-02 09:00:00 3795737500

2003-12-03 09:01:00 3795837569

2003-12-04 09:00:00 3795937500

La hora que representan estos enteros es totalmente arbitraria, y no es un factor delmodo en que IBM Cognos Real-time Monitoring procesa los valores. Debecomprender el significado de los valores. Por ejemplo, en la serie anterior, 100.000representa un día. Por tanto, una ventana de los dos días anteriores a estos datosse define como:ORDER BY Date_time_int

RANGE 200000 PRECEDING

O bien, ver únicamente el día anterior:ORDER BY Date_time_int

RANGE BETWEEN 200000 PRECEDING AND 100000 PRECEDING

Cuando se utilice una serie de tiempo en enteros, siempre se debe utilizar lacláusula ORDER BY e identificar la columna de enteros como el orden de la serie.

Particiones de ventanaTodos los eventos de una vista se incluyen en un solo conjunto (ventana), salvoque se defina de otra manera con la cláusula GROUP BY o PARTITION BY.

Estas cláusulas ordenan los eventos en ventanas según un valor de clave, como unnombre o ID común. Las ventanas particionadas se utilizan para agregar loseventos específicos de la ventana. Por ejemplo, para recopilar el volumen total detodas las transacciones por seguridad, la definición de vista podría ser como en elsiguiente ejemplo:SELECT Trades.symbol, SUM(Trades.volume) OVER SymbolsAS Total_volume

FROM Trades

WINDOW Symbols AS ( PARTITION BY Trades.symbol )

Esto es similar a una vista definida con la cláusula GROUP BY de la siguienteforma:SELECT Trades.symbol, SUM(Trades.volume) AS Total_volume

FROM Trades

GROUP BY Trades.symbol

Realizar consultas en las dos vistas anteriores genera resultados diferentes. La vistaagrupada devuelve una fila por cada grupo, mientras que la vista particionada, deforma predeterminada, devuelve sólo una fila que contiene el resultado del últimoevento que ha entrado en la vista (aunque la información de cada partición semantiene internamente). Para ver más filas de una vista dividida, establezca elvalor Mantener en la vista de la vista en un tamaño superior a 1. Para obtenerinformación, consulte: “Resultados históricos de vistas divididas” en la página 402.


Cláusula PARTITION BYLa cláusula PARTITION BY define una o más columnas que contienen los valoresque identifican una ventana de partición.PARTITION BY < column > [, < column > ... ]

Donde <column> es el nombre de una columna en la lista SELECT o es un enteroordinal que representa la posición de una columna incluida en la lista de columnasSELECT (la primera referencia es 1). Al declarar una lista de columnas, se crea unapartición para cada valor único del conjunto. Por ejemplo, esta declaración creaparticiones para individuos basándose en combinaciones exclusivas deapellido+nombre:PARTITION BY last_name,first_name

Observe las ilustraciones de las siguientes secciones que muestran qué ocurrecuando llega un nuevo evento que es más nuevo que el evento más reciente queya se encuentra en la lista.

Actualización de vista para una cláusula GROUP BY simpleCuando un evento llega a una vista con una cláusula GROUP BY simple, el nuevoevento se aplica al grupo asociado.

En este caso, el nuevo evento se aplica al promedio de todos los eventos AAA quehan llegado a recibirse.

Actualización de vista para una partición con referenciaFRAME

Consideremos ahora el mismo evento que entra en una vista particionada pornombre, donde el marco de ventana de la partición es el único que identifica lasactualizaciones de evento.

En este ejemplo, el evento AAA es 2 horas más reciente que el último evento AAA.Todos los valores anteriores de la partición caducan y se descartan, y sólo se utilizael nuevo evento. Observe que la otra partición no se ve afectada.

AAA se actualiza basándose en todos los flujos de datos AAA quehan llegado a recibirse; SRK no cambia; los grupos nunca caducan.

Nombre ValorAAA 20.00

Nombre ValorAAA 10.00SRK 24.00


SELECT NAME, AVG(Value) AS AvVAL GROUP BY Name

Figura 48. Actualización de vista para una cláusula GROUP BY simple


Actualización de vista para una partición con referenciaOPERATOR

Por último, consideremos el mismo evento que entra en una vista particionada quese actualiza basándose en la referencia OPERATOR.

La referencia indica a todas las particiones que se actualicen cuando un eventonuevo entra en la ventana. En esta ilustración, todas las particiones existentescaducan y se crea una nueva para el nuevo evento, porque ninguno de los eventosa los que realizan el seguimiento las particiones existentes se encuentra dentro delrango de la última hora.

La consulta siguiente es similar a la que se muestra en la ilustración anterior, salvoque en la ilustración anterior sólo se muestra en el resultado la fila correspondienteal último evento que ha entrado en la vista:SELECT Name, MOV_AVG(Value,HOUR,1)GROUP BYName

Ventaja de las particiones respecto a los gruposLa ventaja principal de las particiones es que puede tener varias particionesbasadas en diferentes columnas de la misma vista, mientras que GROUP BY seaplica únicamente a toda la vista.

El promedio para la fila AAA essólo el último evento (los eventos anteriores han caducado). SRK no cambia. Los grupos nunca se vacían.



Llega un nuevo evento que es dos horas más reciente que el último evento que está en la partición.


SELECT Name, AVG(Value) OVER w AS AvVal WINDOW w as (PARTITION BY Name RANGE INTERVAL '1' HOUR PRECEDING REFERENCE FRAME)

Figura 49. Actualización de vista para una partición con referencia FRAME

Todos los eventos anteriores caducan y la partición SRK se vacía; el promedio para AAA es sólo el último evento.




Llega un nuevo evento que es dos horas más reciente que el último evento que está en la partición.

SELECT Name, AVG(Value) OVER w AS AvVal WINDOW w AS (PARTITION BY Name RANGE INTERVAL '1' HOUR PRECEDING REFERENCE OPERATOR

Figura 50. Actualización de vista para una partición con referencia OPERATOR


Uso de las ventanas para hacer caducar GROUP BYCon GROUP BY, puede ver los resultados de todos los grupos en IBM CognosReal-time Monitoring Dashboard o en la pestaña Resultados del entorno detrabajo.

Esto representa una ventaja respecto a las particiones, que no se pueden utilizarpara consultar la vista para ver el contenido de las particiones.

GROUP BY mantiene los resultados de cada grupo mientras existan datos en elgrupo. En la ilustración anterior, si utiliza la vista creada por la expresión GROUPBY en lugar de PARTITION, puede ver el contenido, y los grupos caducan si nohan tenido eventos durante la última hora.

Resultados históricos de vistas divididasDe forma predeterminada, cuando se consulta una vista dividida, el resultado esuna vista con una fila que contiene el resultado del último evento que entró en lavista (aunque la información de cada división se mantiene internamente).

Por ejemplo, si se realiza el seguimiento del precio promedio de valores, divididopor símbolo, consultar SELECT * en la vista devolverá un resultado parecido alsiguiente:SELECT * FROM AveragePricesView

Symbol AvgPrice Date

------ -------- ----------

JMH 164.35 2003-07-14

En los resultados anteriores, el último evento que recibió la vistaAveragePricesView tuvo el símbolo JMH.

Para ver más filas en la vista dividida, establezca el valor Mantener en la vista aun número superior a 1. Si tiene muchos eventos agregados, establezca el valor aun número más alto, como 500. De este modo, al consultar la vista se devuelvehasta ese número de filas, como se indica en el siguiente ejemplo:Symbol AvgPrice Date

------ -------- ----------

AAA 24.35 2003-03-05

SRKH 102.07 2003-03-05

JMH 90.22 2003-03-05

SRKH 106.88 2003-03-06

AAA 25.66 2003-03-06

JMH 94.11 2003-03-06

...

Los resultados aparecen en el orden en que la vista los ofrece: el orden de loseventos que entraron en último lugar en cada división.

Para obtener resultados históricos significativos, ordene la nueva vista, como porejemplo por Símbolo y Fecha, como se indica en el siguiente ejemplo:SELECT * FROM AveragePricesView ORDER BY Symbol,"Date"

Symbol AvgPrice Date

------ -------- ----------

AAA 24.35 2003-03-05


AAA 25.66 2003-03-06

AAA 25.25 2003-03-07

AAA 24.92 2003-03-08

...

Avance de las ventanasCuando entra un nuevo evento en una ventana, la ventana determina qué eventosse deben mantener y cuáles se deben descartar cuando la ventana esté completa.

Un marco de ventana está completo si la siguiente fila hace que una fila existentedel marco caduque y salga de la ventana. Cuando se ve en el contexto de eventosfuturos y pasados en la secuencia de información, puede observarse que la ventanaavanza o se desliza por la secuencia de información a medida que añade ydescarta eventos.

Cláusula SLIDELa cláusula de avance de ventana (SLIDE) especifica la distancia que se debeavanzar cuando la ventana está completa.

De forma predeterminada, cuando se omite SLIDE, las ventanas de serie deeventos se deslizan un evento en la secuencia de información por cada eventonuevo, mientras que las ventanas de serie de tiempo avanzan para incluir el últimoevento y los eventos incluidos en el intervalo definido en la cláusula RANGE no semueven. Los demás eventos se descartan.

Al incluir una cláusula SLIDE se avanza la ventana por el tamaño total de laventana (cuando se omite el argumento) o se avanza la distancia del evento o elintervalo de tiempo especificado por el argumento.SLIDE [ < interval > | < distance > ]

Por ejemplo, supongamos una ventana de serie de eventos cuyo tamaño es de treseventos. Al declarar SLIDE sin argumentos se genera el mismo efecto que si sedeclara SLIDE 3.

Las ventanas avanzan por lasecuencia de información a medida que llegan nuevos flujos de datos

Flujos de datosdescartados

Flujos de datos futuros

Los flujos de datos más antiguos se descartan cuando la ventana está completa y se añaden nuevos flujos de datos.

Figura 51. Avance de las ventanas


Cuando una ventana avanza más de un evento, está en movimiento. Las funcionesTUMBLE_ son la abreviatura de expresiones de ventana completas que utilizaneste comportamiento de deslizamiento. Para obtener más información, consulte:“Funciones TUMBLE” en la página 405.

No es necesario que el argumento SLIDE sea el mismo que el tamaño de ventana,pero debe ser inferior o igual al tamaño de ventana.

Ventanas en movimientoUna ventana en movimiento vacía su contenido cuando avanza para incluir elevento más reciente.

Por ejemplo, una ventana de serie de tiempo en movimiento continúa creciendohasta que entra un nuevo evento que hace que se descarten los eventos másantiguos. Cuando el intervalo de deslizamiento es el mismo que el tamaño de laventana, la ventana vuelca todos los eventos existentes cuando llega uno nuevo yla ventana está llena.

Esta funcionalidad resulta útil para realizar el seguimiento del valor de eventos deun intervalo completo durante dicho intervalo. Por ejemplo, si inicia un intervaloen domingo y declara un intervalo de deslizamiento de siete días, la ventana sevacía y avanza cada domingo. Utilice la cláusula INITIALIZE para establecer lahora de inicio de forma adecuada. Para obtener más información, consulte:“Inicialización de ventanas” en la página 407.

Ventanas finales en movimientoUna ventana final en movimiento se vacía y vuelve a llenarse después dedesplazarse.

Después de avanzar, la ventana contiene sólo el nuevo flujo de datos. Se añaden flujos de datos futuros hasta que la ventana vuelve a estar completa.

Esta ventana se desliza tres flujos de datos cuando avanza después de estar completa.

EVENTS '2' PRECEDINGSLIDE 3

Figura 52. Ventana de serie de eventos cuyo tamaño es de tres eventos

El primer flujo de datos del tercer día se desliza.

El primer flujo de datos del tercer día se desliza.

Esta ventana de dos días también se desliza dos días después de quedarse llena.

RANGE '2' DAY PRECEDINGSLIDE 2

Figura 53. Ventanas en movimiento


Sin embargo, es importante saber que los elementos que entran en la vista debenestar comprendidos en la ventana, según se identifica en el último evento. Porejemplo, supongamos una ventana de siete días que incluye valores de la semanaanterior y se vacía cada siete días:RANGE BETWEEN INTERVAL ’14’ DAY PRECEDING


SLIDE INTERVAL ’7’ DAY

Esta ventana sólo acepta valores con una antigüedad superior a siete días, conanterioridad al último evento. Aun cuando puede haber eventos para toda unasemana, la ventana sólo contiene los eventos cuya antigüedad des de siete días enrelación con el último evento. Por ejemplo, cuando estos eventos entran en laventana, sólo se incluye el primer evento, porque tiene una antigüedad superior asiete días respecto al último evento:Data_Stream_Time

-------------------

2003-12-01 09:00:00 << Only event includedin the window

2003-12-01 10:00:00

2003-12-02 08:45:00

2003-12-08 09:10:00 << Last event

Cada uno de los tres primeros eventos se incluye únicamente después de recibir unevento después de las 08:45 el día 12-09.

Funciones TUMBLELa mayoría de las funciones de conjunto tienen asociadas funciones tumble_, queson formas abreviadas de expresiones de ventana deslizante completas.

Por ejemplo, supongamos esta expresión TUMBLE_SUM() que suma todos loseventos que llegan en un intervalo de 1 hora:TUMBLE_SUM(price, HOUR, 1, trade_time) AS T_Sum

La función anterior es la forma abreviada de la siguiente expresión de ventana enlínea:SUM(price) OVER (ORDER BY trade_time

RANGE INTERVAL ’1’ HOUR PRECEDING SLIDE) AS T_Sum

Esto, a su vez, equivale a lo siguiente, tras especificar todos los valorespredeterminados:SUM(price) OVER ( ORDER BY trade_time



REFERENCE OPERATOR) AS T_Sum

La función TUMBLE_SUM(price, EVENT, 5) es la forma abreviada para estaventana completa:SUM(price) OVER (


SLIDE 5

REFERENCE FRAME) AS T_Sum


Consulte las descripciones de las funciones TUMBLE individuales para obtenerdetalles acerca de su comportamiento.

Referencia de actualización de ventanaCuando una vista recibe un nuevo evento, una o varias de las ventanas de la vistapueden actualizarse para reflejar la nueva información.

Según la referencia y definición de cada ventana, es posible que todos sus eventoscaduquen y se eliminen o que no se vean afectados por la actualización.

Los eventos que se descartan por el filtro antes de entrar en la vista, como cuandoson excluidos por una cláusula WHERE, no afectan a las ventanas de la vista y nohacen que se actualicen las ventanas, sea cual sea el punto de referencia.

Para obtener más información sobre la cláusula WHERE, consulte: “CláusulaWHERE” en la página 339.

Cláusula REFERENCEUna referencia determina cuándo evaluar el conjunto de eventos incluidos en unaventana.

Las referencias son:v OPERATOR

La ventana se actualiza siempre que un nuevo evento entra en la vista, estéincluido o no el evento en la ventana. Por ejemplo, si una vista realiza unseguimiento de los valores negociados en la última hora, y particiona cada valoren su propia ventana, cada ventana evalúa su conjunto siempre que una nuevaoperación entra en la vista. Si no se ha negociado ninguna seguridad en laúltima hora, esta ventana se queda vacía. Todas las demás ventanas incluyensólo los valores negociados en la última hora; las operaciones anteriores seeliminan de sus ventanas.SELECTTrades.symbol,

AVG(Trades.price)

OVER (RANGE INTERVAL ’1’ HOUR PRECEDING REFERENCEOPERATOR)

AS av_price_last_hour

GROUP BY symbol

FROM Trades

Este modo es el aconsejable y es el valor predeterminado cuando se utilizanagregaciones de series temporales y se desea que todas las ventanas incluyaneventos con referencia de la misma hora; es decir, la hora del último evento quellegó a la vista. Este modo también resulta útil para vistas en las que se deseaque caduquen las ventanas de serie de eventos y que se reduzca el consumo dememoria por parte de la vista.

v FRAMELa ventana se actualiza sólo cuando un nuevo evento entra en la ventana. Porejemplo, si la vista realiza un seguimiento de las últimas 10 operaciones paracada valor, sólo se actualiza la ventana que recibe la nueva operación. Todas lasdemás ventanas (de valores) conservan el valor de eventos de sus 10 eventos.SELECT Trades.symbol,


AVG(Trades.price) OVER (EVENTS 9 PRECEDING REFERENCEFRAME)

AS av_price_last_10_trades

GROUP BY symbol

FROM Trades

Este modo es recomendable cuando se desea que las ventanas conserven unconjunto de eventos, independientemente de cuándo llegaron, por ejemplo paraagregados en movimiento basados en eventos. Este modo es el predeterminadopara eventos basados en ventanas.La referencia FRAME también resulta útil para recuperar memoria de servidor.

Inicialización de ventanasAl utilizar una ventana de serie de tiempo, la hora de inicio para el marco deventana la establece el primer evento que llega a la ventana.

Cuando una vista tiene varios marcos de grupo o partición, cada uno podría teneruna hora de inicio diferente. Observemos estos dos eventos, que son los primerosen llegar a la vista:Symbol Time

IBM 09:00:00.875

CQST 09:23:02.111

Si la vista que recibe estos eventos los coloca en marcos GROUP BY distintos, cadavista se inicia a la hora de cada evento y se continúa restableciendo en base adicha hora de inicialización, como se muestra en el ejemplo siguiente:SELECT Trades.Symbol, Trades.Time,

AVG(Trades.Price) OVER An_Hour AS Avg_Price_One_Hour_Tumble

GROUP BY Trades.Symbol, Trades.Time

FROM Trades

WINDOW An_Hour AS (ORDER BY Trades.Time

RANGE INTERVAL ’1’ HOUR PRECEDINGSLIDE)

Con esta definición de vista, un evento que llega a las 09:10 hace que el eventoIBM inicial caduque, pero el evento CQST permanece en su ventana durante almenos otros 13:02 minutos: el tiempo que queda desde que entró en la vista.

Cláusula INITIALIZEPara que todas las ventanas comiencen al mismo tiempo, se debe utilizar lacláusula INITIALIZE.

Esta cláusula define el momento de inicialización de todos los marcos según ladefinición de la ventana. Por ejemplo, para que todas las ventanas comiencen almismo tiempo, inicialícelas en una fecha y hora anteriores al primer evento queprobablemente llegue a la vista.

WINDOW An_Hour AS (ORDER BY Trades.Time

RANGE INTERVAL ’1’ HOUR PRECEDINGSLIDE

INITIALIZE TIMESTAMP ’2003-03-05 00:00:00.000’)

Con esta definición, todas las ventanas se inicializan a la misma hora: amedianoche. Cada marco caduca al principio de la hora (cuando los minutos son


00:00,000). Como la ventana incluye la cláusula SLIDE, todas las operacionescomerciales anteriores se descartan cuando el marco caduca, y sólo se aceptan loseventos nuevos que llegan durante la hora actual.

Esta cláusula actúa como un filtro, ya que excluye todos los eventos antes delmomento de la inicialización.

La hora de inicialización es un valor literal de fecha y hora. Para obtener másinformación, consulte: “Literal TIMESTAMP” en la página 78. Además, el valor deinicialización es estático, pues no podrá cambiar una vez creada la vista.

Ejemplo de la cláusula INITIALIZEEsta definición de inicialización establece el año fiscal actual, que empieza el 1 dejulio del año natural.(RANGE INTERVAL ’1’ YEAR PRECEDING SLIDE

INITIALIZE TIMESTAMP ’1963-07-01 00:00:00’)


Capítulo 39. Archivos XML y XSD utilizados por IBM CognosReal-time Monitoring

Todos los objetos de IBM Cognos Real-time Monitoring y muchas operaciones delsistema se pueden expresar en formato XML y cargar en el sistema.

El código XML debe tener el formato correcto, tal como definen los archivos deesquema XML (XSD). Para obtener una lista completa de los objetos definidos y lasoperaciones que puede llevar a cabo, consulte: “Archivos XSD de Cognos Real-timeMonitoring” en la página 416.

Los detalles acerca de XML y XSD no se incluyen en el ámbito de estadocumentación. Para obtener información acerca de XML y XSD, consulte:http://www.xml.org.

Archivos XML y XSD en Cognos Real-time MonitoringTodos los archivos XML tienen archivos de esquema que definen la estructura delcódigo XML.

Los archivos XSD y los archivos XML de ejemplo están disponibles en estaubicación: ubicación_instalación/realtime/sdk/api/metadata/, dondeubicación_instalación especifica la ubicación de instalación de IBM CognosBusiness Intelligence.

Además de los ejemplos, otra forma de ver archivos XML definidos correctamenteconsiste en crear primero objetos en Cognos Real-time Monitoring Workbench oCognos Real-time Monitoring Dashboard y, a continuación, utilizar la consola deadministración para exportar todo el conjunto. Todos los objetos exportados seescriben como archivos XML en el directorio de exportación del servidor. Paraobtener más información acerca de este procedimiento consulte la sección acerca dela importación y la exportación de metadatos en la publicación IBM CognosReal-time Monitoring Workbench Guía del usuario.

DependenciasLa mayoría de los objetos del sistema dependen de otros objetos.

Cuando define un objeto nuevo, primero deben definirse todas sus dependencias.Para ello, defina y cargue objetos base en el orden de dependencia, o biendefínalos en lotes como se describe en “Definición de varios objetos con XML” enla página 413.

Espacio en blancoCuando el valor de un elemento XML contiene varios caracteres de espacio enblanco contiguos que se deben conservar, indique al sistema que mantenga losespacios con xml:space="preserve".

De lo contrario, la especificación XML indica que se deben eliminar los espaciosadicionales. Por ejemplo, sin la directiva de conservación, en la siguientedescripción se eliminarían los espacios finales y sólo habría un espacio entre laspalabras:


http://www.xml.org

<description xml:space="preserve">Anote </description>

Caracteres de escapeLos caracteres "<" y "&" no son válidos en XML.

Algunos otros caracteres son válidos pero pueden resultar confusos por su aspecto.Para estos caracteres, utilice en su lugar estas entidades XML de escape.

Tabla 109. Entidades de escape XML

Secuencia Carácter Resultado

< < Menor que

> > Mayor que

& & Ampersand

' ' Apóstrofo

" " Comillas

Por ejemplo, al expresar una consulta que contiene un símbolo de menor que,utilice < en vez del símbolo de menor que, tal como se muestra en el siguienteejemplo:<query>SELECT c1, c2 FROM event1 WHERE c3<=100AND c2='CQST'</query>

Datos de caracteresEn lugar de utilizar caracteres de escape, otra forma de expresar caracteresespeciales es utilizar una etiqueta CDATA.

Esta etiqueta indica al analizador que ignore todos los caracteres especiales y lostrate como literales.<query><![CDATA[SELECTc1, c2 FROM event1

WHERE c3<=100 AND c2=’CQST’]></query>

Carga de archivos XMLPuede cargar archivos XML en IBM Cognos Real-time Monitoring.

Existen dos formas:v Cargar archivos XML desde una línea de comandos con el programa de utilidad

cqupload.jar. Para obtener más información, consulte: “Carga de archivos XMLde una línea de comandos” en la página 411.

v Cargar archivos XML desde un navegador web con el script fileupload.jsp. Paraobtener más información, consulte: “Carga de archivos XML desde unnavegador web” en la página 411.

Ambos métodos requieren que el servidor Cognos Real-time Monitoring esté enejecución. Además, cada método utiliza una cuenta de usuario de CognosReal-time Monitoring para iniciar sesión en el servidor y ejecutar la acción. Encada caso, la cuenta debe tener derechos de creación para la clase de objetos que sedebe crear, o derechos de administración para las operaciones que deben ejecutar.Para obtener más información sobre las cuentas de usuario, consulte: Capítulo 34,“Usuarios”, en la página 353.


Carga de archivos XML de una línea de comandosEn una línea de comandos, utilice el programa de utilidad cqupload.jar para cargarlos archivos.

El programa de utilidad se encuentra en la siguiente ubicación:realtime\sdk\java\lib.

Este programa de utilidad ofrece tres opciones:

Tabla 110. Opciones del programa de utilidad de carga

Opción Descripción

-s applicationURL URL que localiza Cognos Real-time Monitoring.

-u userName Cuenta de usuario que se debe utilizar. Omita esta opción parautilizar la cuenta de administrador del sistema predeterminada.

-p password Contraseña para la cuenta de usuario. Necesaria si se incluye-u.

Por ejemplo, para cargar un archivo XML utilizando la cuenta de administradordel sistema predeterminada, debe utilizar lo siguiente:java -jar /CognosLava/CQupload/cquload.jar

java -jar <CD-ROM>/LavaActivitySuite/CQUpload/cqupload.jar-s http://applicationServer >/now createUserSkyler.xml

Para incluir un nombre de usuario o contraseña, debe utilizar el siguiente ejemplo:java -jar cqupload.jar -u skyler -p roo -s...

Si la operación se realiza correctamente, no se emite ningún aviso; en cambio, si laoperación falla, el programa de utilidad devuelve un mensaje de error a la ventanade comandos. Revise el mensaje de error para identificar el problema. Por ejemplo,este mensaje indica un error en el XML:Error uploading file: createUserSkyler.xml

--------------------------------------------------------------------

java.io.IOException: Error parsing an XML document. Ensurethat the

XML conforms exactly to the XML schema definition. TheXML that

cannot be parsed is:

Más abajo en el mensaje se puede ver la causa real: un elemento no válidoCaused by:

javax.xml.bind.UnmarshalException: Unexpected element

{http://cognos.obi.com/5}:nome

Carga de archivos XML desde un navegador webEl script fileupload.jsp presenta un formulario en el que puede identificar elarchivo XML que ha de cargarse.

El archivo fileupload.jsp incluye un selector de archivo, donde puede identificarel archivo XML que ha de cargarse, y visualiza un mensaje con los resultados de lacarga.

Capítulo 39. Archivos XML y XSD utilizados por IBM Cognos Real-time Monitoring 411

Procedimiento1. Ejecute el script fileupload.jsp. Utilice una dirección similar a la dirección URL

siguiente. Utilice el localhost sólo si ejecuta el navegador en el mismo host quelos servidores IBM Cognos Real-time Monitoring. Si no, utilice la mismaubicación que la que utiliza para ejecutar Cognos Real-time MonitoringWorkbench.http://localhost/now/jsp/fileupload.jsp

2. Identifique el nombre de usuario y la contraseña que han de utilizarse.3. Identifique el archivo XML que ha de cargarse.4. Seleccione Cargar.

En la página de resultados se visualizan el nombre del archivo XML cargado ysus resultados. Si el Estado es Error, revise la excepción para determinar quéerror se ha producido y para corregir el problema. Por ejemplo, este mensajeindica que la operación no se ha ejecutado correctamente porque el objeto deusuario Rolf no existe.Exception Encountered

com.cognos.obi.exception.VCException: Cannot alter the[User]

named [Rolf] because that object does not exist.

Definición de un objeto con XMLEn esta sección se describe cómo definir y cargar una única definición XML.

Para cargar varios archivos XML, en especial objetos con dependencias, siga lasinstrucciones de “Definición de varios objetos con XML” en la página 413.

Procedimiento1. Cree una definición XML. Utilice el archivo XSD asociado para determinar los

elementos válidos del archivo XML. Para ver un ejemplo de un archivo XMLcompleto, consulte: “Ejemplo: crear usuario”.

2. Asegúrese de que Cognos Real-time Monitoring está en ejecución.3. Cargue el archivo XML.

Utilice cualquiera de los dos métodos que se describen en la sección “Carga dearchivos XML” en la página 410.Para cargar el archivo desde la línea de comandos con el programa de utilidadcqupload.jar, utilice este ejemplo:java -jar /CognosNow/CQUpload/cqupload.jar

Ejemplo: crear usuarioEn este ejemplo se muestra una definición XML que crea un usuario.<?xml version="1.0" encoding="UTF-8"?>

<createUser

xsi:schemaLocation="http://cognos.obi.com/5

../../api/metadata/createUser.xsd"

xmlns="http://cognos.obi.com/2 "


>

<name>Skyler</name>

<description xml:space="preserve">A power user</description>

<Password>roo</Password>


</createUser>

Definición de varios objetos con XMLPara definir varios objetos, en especial objetos con dependencias, utilice el objetode definición XML de modo de proceso por lotes commandBatch.xsd.

Cuando utilice el modo de proceso por lotes, incluya todo el XML en un únicoarchivo y, a continuación, cargue ese archivo. Todas las operaciones deben serválidas, o no se aceptará ninguna de ellas. Para definir y cargar un único objetoXML, siga las instrucciones de la sección “Definición de un objeto con XML” en lapágina 412.

Procedimiento1. Cree un archivo de proceso por lotes XML. Utilice commandBatch.xsd como

definición. Dentro del archivo, anide cada definición dentro de un elemento de<comando> y coloque todas éstas en un único elemento de <comandos> en elorden en el que deben definirse los objetos.Para obtener más información sobre un listado que define varios objetosdependientes, consulte: “Ejemplo: comando por lotes”.

2. Asegúrese de que Cognos Real-time Monitoring esté en ejecución.3. Cargue el archivo de proceso por lotes XML.

Utilice el programa de utilidad cqupload.jar para cargar el archivo XML en elservidor de aplicaciones en el que se ejecuta Real-time Monitoring. Por ejemplo,lo siguiente carga el archivo de proceso por lotes de ejemplo:java -jar /CognosNow/CQUpload/cqupload.jar-s http://<applicationServer>/now commandBatchSkyler.xml

Ejemplo: comando por lotesEste comando por lotes define una cuenta de usuario, dos perfiles de entrega parael usuario, una preferencia de usuario, y asigna un permiso al usuario.<?xml version="1.0" encoding="UTF-8"?>

<commandBatch

xsi:schemaLocation="http://cognos.obi.com/5

../../api/metadata/commandBatch.xsd"

xmlns="http://cognos.obi.com/5"


>

<commands>

<command>

<createUser>

<name>Skyler</name>

<description xml:space="preserve">A poweruser</description>

<Password>roo</Password>

</createUser>

</command>

<command>

<createUserProfile>

<name xml:space="preserve">Work e-mail</name>

<UserName>Skyler</UserName>


<isDefault>true</isDefault>

<EmailProfile><typeName/>

<emailAddress>[email protected]</emailAddress>

</EmailProfile>

</createUserProfile>

</command>

<command>

<createUserProfile>

<name xml:space="preserve">Second profile</name>

<UserName>Skyler</UserName>

<isDefault>false</isDefault>

<EmailProfile><typeName/>

<emailAddress>[email protected]</emailAddress>

</EmailProfile>

</createUserProfile>

</command>

<command>

<setUserPreferences>

<userName>Skyler</userName>

<userPreference>

<operation>set</operation>

<name>polling_interval</name>

<value>5</value>

</userPreference>

</setUserPreferences>

</command>

<command>

<setPrivilege>

<operation>GRANT</operation>

<privilegeTuple>

<objectType>VIEW</objectType>

<privilege>UPDATE</privilege>

<accessorType>USER</accessorType>

<accessorName>Skyler</accessorName>

</privilegeTuple>

<withGrant>false</withGrant>

</setPrivilege>

</command>

</commands>

</commandBatch>

Modificación de un objeto existente con XMLPara modificar la definición de un objeto existente, utilice el mismo XML yesquema que al crear el objeto, pero incluya un elemento <alterInformation> paraidentificar la operación de modificación.


(El elemento <alterInformation> se define en common.xsd.) Por ejemplo, estadefinición cambia el nombre de una vista de OldName a NewName; observe queutiliza el esquema createView.xsd:<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<createView xsi:schemaLocation="http://cognos.obi.com/5

/api/metadata/createView.xsd"

xmlns="http://cognos.obi.com/5" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

>

<alterInformation>

<previousName> OldName</previousName>

</alterInformation>

<name>newName</name>

<description>My test view</description>

<query>SELECT c1, c2 FROM event1 WHERE c3<=100</query>

</createView>

Independientemente del cambio que implemente, debe utilizar <previousName>.Si no cambia el nombre del objeto, utilice el mismo nombre para ambos elementos<previousName> y <name>, como se muestra en este ejemplo:

...

<alterInformation>

<previousName>OldName</previousName>

</alterInformation>

<name>OldName</name>

<description> New description </description>

<query>SELECT c1, c2 FROM event1 WHERE c3<555 </query>

...

De forma predeterminada, una operación de modificación falla si el objetoexistente no existe. No obstante, puede forzar que se cree el objetoindependientemente de la existencia del objeto existente mediante la inclusión deun elemento <createIfNotFound>, como se muestra en el ejemplo siguiente:

...

<alterInformation>

<previousName>OldName</previousName>

<createIfNotFound>true</createIfNotFound>

</alterInformation>

...

DependenciasCuando modifica un objeto existente, todos los demás objetos que dependen de élse evalúan y se consideran no válidos si su definición se invalida como resultadodel cambio.

Para volver a habilitar los objetos no válidos, primero debe modificarlos y corregirsus definiciones.


Emisión de comandos con XMLMuchas operaciones del sistema se pueden realizar con comandos XML.

La siguiente tabla incluye algunas de las operaciones comunes.

Tabla 111. Operaciones XML comunes

Operación Esquema

Habilitar un objeto enableObject.xsd

Inhabilitar un objeto disableObject.xsd

Eliminar (suprimir) un objeto dropObject.xsd

Establecer una propiedad del sistema setProperty.xsd

Importar o exportar metadatos del sistema performImportExport.xsd

Crear un punto de comprobación systemCommand.xsd

A continuación se incluye una operación de ejemplo.

Ejemplo: habilitar un objeto y sus dependenciasPara habilitar un objeto y todas sus dependencias, utilice el esquemaenableObject.xsd.

Debe identificar el nombre del objeto y su tipo de objeto. Los valores <type>válidos se definen en common.xsd mediante el elemento <VCEnableObjectType>.<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<enableObject xsi:schemaLocation="http://cognos.obi.com/5

/api/metadata/enableObject.xsd"

xmlns="http://cognos.obi.com/5" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

>

<name>MyView</name>

<type>VIEW</type>

<cascade>true</cascade>

</enableObject>

En este ejemplo se habilitan todos los objetos dependientes porque <cascade> estáestablecido en True. Omita este elemento o establézcalo en False para habilitar sóloel objeto indicado.

Archivos XSD de Cognos Real-time MonitoringIBM Cognos Los archivos de esquema XML de Real-time Monitoring se puedenordenar por categorías.

Las categorías son:v Usuarios, perfiles y rolesv Panel de controlv Reglas, alertas y reportletsv Flujos de datos, tablas de consulta, cubos y vistasv Escenarios y actividades empresarialesv Agentes


v Administración del sistemav Gestión de objetosv Archivos varios

Los archivos se encuentran en la siguiente ubicación: realtime\sdk\api\metadata.

Usuarios, perfiles y roles

La tabla siguiente incluye una descripción de archivos de esquema para usuarios,perfiles y roles.

Tabla 112. Archivos de esquema para usuarios, perfiles y roles

Esquema Descripción

addMembersToRole.xsd Añade uno o más usuarios existentes a un rol actual.

addMemberToRole.xsd Añade un usuario existente a un rol actual.

createRole.xsd Crea un objeto de rol de usuario.

createSecurityFilter.xsd Crea un filtro de acceso.

createUser.xsd Crea un objeto de usuario.

createUserProfile.xsd Crea un objeto de perfil de entrega de usuario.

setPrivilege.xsd Establece el permiso de un usuario o rol en un objeto o unaclase de objetos.

setUserPreferences.xsd Establecer las preferencias de un usuario.

Panel de control

La tabla siguiente incluye una descripción de archivos de esquema para paneles decontrol.

Tabla 113. Archivos de esquema para paneles de control


createBookmarks.xsd Crea un marcador de panel de control.

createDashboard.xsd Crea un panel de control.

createPlan.xsd Crea referencias y umbrales de panel de control.

createPortlet.xsd Crea un objeto de panel de control.

createTask.xsd Crea una tarea de panel de control.

createTaskMessage.xsd Crea un mensaje de tarea de panel de control.

Reglas, alertas y reportlets

La tabla siguiente incluye una descripción de archivos de esquema para reglas,alertas y reportlets.

Tabla 114. Archivos de esquema para reglas, alertas y reportlets


alertCommon.xsd Definiciones XSD de alerta comunes.

alertMessage.xsd Mensaje de alerta para entregar a un servicio web.

alterAlertState.xsd Alerta del estado de una alerta existente.

alterRule.xsd Alerta de un objeto de regla existente.


Tabla 114. Archivos de esquema para reglas, alertas y reportlets (continuación)


createAlert.xsd Crea un objeto de alerta.

createReportlet.xsd Crea un objeto de reportlet.

createRule.xsd Crea un objeto de regla.

createRuleBundle.xsd Especifica los valores asociados a los parámetros en unaplantilla de regla, y genera las reglas, las alertas y losreportlets basados en la definición de plantilla.

createRuleTemplate.xsd Crea una plantilla de definiciones parametrizadas de unconjunto de reglas, la alerta utilizada por las reglas y losreportlets asociados a la alerta.

ruleCommon.xsd Contiene definiciones XSD de regla comunes.

Flujos de datos, tablas de consulta, cubos y vistas

La tabla siguiente incluye una descripción de archivos de esquema para secuenciasde datos, tablas de consulta, cubos y vistas.

Tabla 115. Archivos de esquema para flujos de datos, tablas de consulta, cubos y vistas


createConsolidatedEventView.xsd

Crea una vista de flujo de datos consolidada basada en unflujo de datos existente y uno o más flujos de datos o vistasadicionales.

createContext.xsd Crea un objeto de tabla de consulta basado en un origenexistente.

createCube.xsd Crea un objeto de cubo.

createDimension.xsd Crea una dimensión de cubo.

createEventStream.xsd Crea un objeto de flujo de datos basado en un origenexistente.

createView.xsd Crea un objeto de vista basado en una tabla de origenexistente (flujo de datos) y otras tablas opcionales unidas(tabla de consulta o de flujos de datos).

createViewPersistence.xsd Crea una definición de persistencia de vista.

ffsourceType.xsd Objeto de flujo de datos de archivo sin formato.

jdbcSource.xsd Objeto de tabla de consulta JDBC.

messageSource.xsd Objeto de mensaje transmitido de un agente a una tabla deconsulta o de flujos de datos, utilizado por JMS, TIBCO RV,log4j y HTTP.

queryCube.xsd Emite una consulta en un cubo contra las medidas de lasdimensiones.

queryInformation.xsd Contiene los elementos de una consulta (sentencia SELECT).

sourceDefinition.xsd Tipos de origen (tipos de agente) soportados por el sistema.

sourceDefinition.xsd Contiene definiciones de origen comunes para definicionesXSD de objeto de flujo de datos y tabla de consulta.

tableDefinition.xsd Soporta la definición de un origen de eventos.

webServiceSource.xsd Objeto de flujo de datos de servicio web.

Escenarios y actividades empresariales


La tabla siguiente incluye una descripción de archivos de esquema para escenariosy actividades empresariales.

Tabla 116. Archivos de esquema para escenarios y actividades empresariales


createBusinessActivity.xsd Crea un objeto de actividad de empresarial.

createScenario.xsd Crea un objeto de escenario en una vista empresarial existentey se enlaza con una vista existente.

Agentes

La tabla siguiente incluye una descripción de archivos de esquema para agentes.

Tabla 117. Archivos de esquema para agentes


FFConnection.xsd Agente de archivos sin formato.

jdbcConnection.xsd Agente JDBC.

JMSTopicConnection.xsd Agente JMS.

log4jConnection.xsd Agente de mensajes log4j (utilizados internamente para elregistro).

procSource.xsd Definiciones de procedimiento almacenadas.

RVConnection.xsd Agente TIBCO RV.

SOAPConnection.xsd Conexión de servicio web.

xmlBuffer.xsd Búfer XML que contiene una parte del mensaje.

Administración del sistema

La tabla siguiente incluye una descripción de archivos de esquema para laadministración del sistema.

Tabla 118. Archivos de esquema para la administración del sistema


propertyTypeDefinition.xsd Describe una propiedad del sistema.

setLogLevel.xsd Establece el nivel de registro para un registrador del sistema(módulo de registro).

setProperty.xsd Comando para establecer una propiedad del sistema.

systemCommand.xsd Realiza un punto de comprobación.

Gestión de objetos

La tabla siguiente incluye una descripción de archivos de esquema la gestión deobjetos.

Tabla 119. Archivos de esquema para la gestión de objetos


createKeyRelationship.xsd Crea una relación entre dos objetos.

disableObject.xsd Inhabilita un objeto.

dropObject.xsd Suprime un objeto.


Tabla 119. Archivos de esquema para la gestión de objetos (continuación)


enableObject.xsd Habilita un objeto.

setObjectRelation.xsd Relaciona dos objetos.

Archivos varios

La tabla siguiente incluye una descripción de archivos de esquema varios.

Tabla 120. Archivos de esquema varios


commandBatch.xsd Define varios objetos para cargar (definidos) por lote. Todaslas definiciones deben ser válidas o no se define ningúnobjeto.

common.xsd Contiene definiciones XSD comunes utilizadas por la mayoríade los esquemas.

createJar.xsd Crea un objeto JAR.

createUDF.xsd Crea un objeto UDF.

invokeExternalAction.xsd Describe un mensaje de acción externa enviado a un servicioweb. Para obtener más información sobre este archivo,consulte: “Procesos externos del servicio web” en la página384.

jarManifest.xsd Define el manifiesto en un JAR.

performImportExport.xsd Comando para que el sistema realice una importación oexportación.

schedule.xsd Contiene definiciones de planificación e intervalo deplanificación utilizadas por definiciones XSD.


Apéndice A. Métodos Java Database Connectivity

Este apéndice enumera las clases y los métodos del controlador de IBM CognosReal-time Monitoring para su uso con JDBC. La descripción de cada método indicasi cumple con la API estándar de JDBC o si devuelve datos distintos de los delJDBC 2.0 estándar.

ControladorEl controlador de base de datos JDBC SQL.

El nombre de clase es com.cognos.obi.jdbc.driver.Driver

boolean acceptsURL(String url)

Devuelve true si el url empieza por "jdbc:cognos:obi:".

Connection connect(String url, Properties info)

int getMajorVersion()

int getMinorVersion()

DriverPropertyInfo[] getPropertyInfo(Stringurl,Properties info)

Devuelve null.

boolean jdbcCompliant()

Devuelve false.

ConnectionConexión a una base de datos específica.

void clearWarnings()

No realiza ninguna acción.

void close()

Cumple la API de JDBC estándar.

void commit()

No realiza ninguna acción. El controlador JDBC de IBM Cognos Real-timeMonitoring es de sólo lectura. El concepto de commit no se aplica.

Statement createStatement()



StatementcreateStatement(int resultSetType,intresultSetConcurrency)

Cumple la API de JDBC estándar cuando resultSetType esResultSet.TYPE_FORWARD_ONLY y resultSetConcurrency esResultSet.CONCUR_READ_ONLY; en caso contrario, emite SQLException para indicarque el método no está implementado.

Statement createStatement(int resultSetType,intresultSetConcurrency, int resultSetHoldability)

No implementado. Emite SQLException.

boolean getAutoCommit()

Devuelve false. El controlador JDBC de IBM Cognos Real-time Monitoring es desólo lectura. El concepto de commit no se aplica.

String getCatalog()

Devuelve "IBM Cognos Real-time Monitoring"

int getHoldability()

Devuelve ResultSet.HOLD_CURSORS_OVER_COMMIT.

Atención: El método commit() no es operativo en el controlador de Real-timeMonitoring. Por consiguiente, un ResultSet no se cierra cuando se llama aConnection.commit().

DatabaseMetaData getMetaData()

Cumple con la API estándar de JDBC. El objeto DatabaseMetadata devuelto poreste método también es una instancia de IOlapMetadataData

int getTransactionIsolation()

Devuelve TRANSACTION_NONE.

Map getTypeMap()


SQLWarning getWarnings()

Devuelve null.

ConnectionConexión a una base de datos específica.




void close()


void commit()

No realiza ninguna acción. El controlador de IBM Cognos Real-time MonitoringJDBC es de sólo lectura. El concepto de commit no se aplica.

Statement createStatement()


StatementcreateStatement(int resultSetType, intresultSetConcurrency)

Cumple la API de JDBC estándar cuando resultSetType esResultSet.TYPE_FORWARD_ONLY y resultSetConcurrency esResultSet.CONCUR_READ_ONLY, si no emite SQLException para indicar que el métodono está implementado.

Statement createStatement(int resultSetType, intresultSetConcurrency, int resultSetHoldability)


boolean getAutoCommit()

Devuelve false. El controlador de IBM Cognos Real-time Monitoring JDBC es desólo lectura. El concepto de commit no se aplica.

String getCatalog()


int getHoldability()


Atención: El método commit() no es operativo en el controlador de CognosReal-time Monitoring; por lo tanto, el ResultSet no se cierra cuando se llamaConnection.commit().

DatabaseMetaData getMetaData()

Cumple con la API estándar de JDBC. El objeto DatabaseMetadata devuelto poreste método también es una instancia de IOlapMetadataData

int getTransactionIsolation()

Devuelve TRANSACTION_NONE.

Map getTypeMap()


Apéndice A. Métodos Java Database Connectivity 423


Devuelve null.

boolean isClosed()

Cumple con la API estándar de JDBC.

boolean isReadOnly()

Devuelve true.

String nativeSQL(String sql)


CallableStatement prepareCall(String sql)


CallableStatement prepareCall(String sql, int resultSetType,int resultSetConcurrency)


PreparedStatement prepareStatement(String sql)


PreparedStatement prepareStatement(String sql, int[]columnIndexes)

El argumento autoGeneratedKeys se omite.

PreparedStatement prepareStatement(String sql, intresultSetType, int resultSetConcurrency)

Los argumentos resultSetType y resultSetConcurrency se omiten.

PreparedStatement prepareStatement(String sql, intresultSetType, int resultSetConcurrency, intresultSetHoldability)

Los argumentos resultSetType, resultSetConcurrency y resultSetHoldability seomiten.

PreparedStatement prepareStatement(String sql, String[]columnNames)

El argumento columnNames se ignora.

releaseSavepoint(Savepoint savepoint)



void rollback()


void rollback(Savepoint savepoint)


void setAutoCommit(boolean autoCommit)


setCatalog(String catalog)


void setHoldability(int holdability)


void setReadOnly(boolean readOnly)


Savepoint setSavepoint(String name)


Savepoint setSavepoint(String name)


void setTransactionIsolation(int level)


void setTypeMap(Map map)


SentenciaUna sentencia SQL que se pasará a la base de datos.

void addBatch(String sql)

No lo utilice. Reservado para uso interno.

void cancel()


void clearBatch()




No realiza ninguna operación.

void close()


boolean execute(String sql)


boolean execute(String sql, int autoGeneratedKeys)


boolean execute(String sql, int[] columnIndexes)


boolean execute(String sql, int[] columnNames)


int[] executeBatch()


ResultSet executeQuery(String sql)


int executeUpdate(String sql)


int executeUpdate(String sql, int autoGeneratedKeys)


int executeUpdate(String sql, int[] columnIndexes)


int executeUpdate(String sql, int[] columnNames)


Connection getConnection()


int getFetchDirection()



int getFetchSize()


ResultSet getGeneratedKeys()


getMaxFieldSize()

Returns 0.

int getMaxRows()


boolean getMoreResults()

Va al siguiente resultado del objeto Statement y devuelve true si se trata de unobjeto ResultSet.

Atención: Cuando se utiliza con IBM Cognos Real-time Monitoring, la API deJDBC no cierra de forma implícita ningún objeto ResultSet actual obtenido con elmétodo getResultSet.

boolean getMoreResults(int current)

Va al siguiente resultado del objeto Statement y devuelve true si se trata de unobjeto ResultSet. El valor de current se ignora.

Atención: Cuando se utiliza con IBM Cognos Real-time Monitoring, la API deJDBC no cierra de forma implícita ningún objeto ResultSet actual obtenido con elmétodo getResultSet.

int getQueryTimeout()


ResultSet getResultSet()


int getResultSetConcurrency()


int getResultSetHoldability()


int getResultSetType()



int getUpdateCount()

Devuelve -1.


Devuelve null si Statement no se ha cerrado.

void setCursorName(String name)


void setEscapeProcessing(boolean enable)


void setFetchDirection(int direction)


void setFetchSize(int rows)


void setMaxFieldSize(int max)


void setMaxRows(int max)


void setQueryTimeout(int seconds)


DatabaseMetaDataProporciona información sobre las definiciones de vista contenidas en la instalaciónde IBM Cognos Real-time Monitoring.

boolean allProceduresAreCallable()

Devuelve false.

boolean allTablesAreSelectable()

Devuelve true.

boolean dataDefinitionCausesTransactionCommit()

Devuelve false.

Nota: El controlador JDBC de Real-time Monitoring no soporta la definición dedatos.


boolean dataDefinitionIgnoredInTransactions()

Devuelve true.

Nota: El controlador JDBC de IBM Cognos Real-time Monitoring no soporta ladefinición de datos.

boolean deletesAreDetected(int type)

Devuelve false.

boolean doesMaxRowSizeIncludeBlobs()

Devuelve false.

ResultSet getAttributes(String catalog,String schemaPattern,String typeNamePattern, String attributeNamePattern)

Devuelve un objeto ResultSet vacío.

ResultSet getBestRowIdentifier(String catalog, String schema,String table, int scope, boolean nullable)


ResultSet getCatalogs()


String getCatalogSeparator()


String getCatalogTerm()


ResultSet getColumnPrivileges(String catalog, String schema,String table, String columnNamePattern)


ResultSet getColumns(String catalog,String schemaPattern,String tableNamePattern, String columnNamePattern)

Recupera la descripción de columnas de tabla disponibles en la tabla. La API deJDBC de Real-time Monitoring no trata los argumentos schemaPattern,tableNamePattern ni columnNamePattern como modelos. Para cualquiera de estostres valores, si el valor es nulo o "%", se establecen correspondencias con todos losnombres. En caso contrario, el argumento se trata como un nombre exacto en lugarde como un modelo.

Connection getConnection()



ResultSet getCrossReference(String primaryCatalog, StringprimarySchema, String primaryTable, String foreignCatalog,String foreignSchema, String foreignTable)


int getDatabaseMajorVersion()


int getDatabaseMajorVersion()


String getDatabaseMinorVersion()


String getDatabaseProductName()


String getDatabaseProductVersion()


int getDefaultTransactionIsolation()

Devuelve Connection.TRANSACTION_NONE.

int getDriverMajorVersion()


int getDriverMinorVersion()


String getDriverName()


String getDriverVersion()


ResultSet getExportedKeys(String catalog, String schema, Stringtable)


String getExtraNameCharacters()

Devuelve una cadena vacía.


String getIdentifierQuoteString()


ResultSet getImportedKeys(String catalog, String schema, Stringtable)


ResultSet getIndexInfo(String catalog, String schema, Stringtable, boolean unique, boolean approximate)


int getJDBCMajorVersion()


int getJDBCMinorVersion()


int getMaxBinaryLiteralLength()

Devuelve 0.

int getMaxCatalogNameLength()

Devuelve 32.

int getMaxCharLiteralLength()

Devuelve 0.

int getMaxColumnNameLength()

Devuelve 128.

int getMaxColumnsInGroupBy()

Devuelve 0.

int getMaxColumnsInIndex()

Devuelve 0.

int getMaxColumnsInOrderBy()

Devuelve 0.

int getMaxColumnsInSelect()

Devuelve 0.


int getMaxColumnsInTable()

Devuelve 0.

int getMaxConnections()

Devuelve 0.

int getMaxCursorNameLength()

Devuelve 0.

int getMaxIndexLength()

Devuelve 0.

int getMaxProcedureNameLength()

Devuelve 0.

int getMaxRowSize()

Devuelve 0.

int getMaxSchemaNameLength()

Devuelve 0.

int getMaxStatementLength()

Devuelve 0.

int getMaxStatements()

Devuelve 0.

int getMaxTableNameLength()

Devuelve 128.

int getMaxTablesInSelect()

Devuelve 0.

int getMaxUserNameLength()

Devuelve 128.

String getNumericFunctions()

Devuelve "avg, sum, count, max, min".

ResultSet getPrimaryKeys(String catalog, String schema, Stringtable)



ResultSet getProcedureColumns(String catalog, StringschemaPattern, String procedureNamePattern, StringcolumnNamePattern)


ResultSet getProcedures(String catalog, String schemaPattern,String procedureNamePattern)


String getProcedureTerm()

Devuelve "Procedure".

int getResultSetHoldability()


ResultSet getSchemas()


String getSchemaTerm()

Devuelve "schema".

String getSearchStringEscape()

Devuelve null.

String getSQLKeywords()

Devuelve una String vacía.

int getSQLStateType()

Devuelve 0.

String getStringFunctions()


ResultSet getSuperTables(String catalog, String schemaPattern,String tableNamePattern)


ResultSet getSuperTypes(String catalog, String schemaPattern,String typeNamePattern)


String getSystemFunctions()



ResultSet getTablePrivileges(String catalog, StringschemaPattern, String tableNamePattern)


ResultSet getTables(String catalog,String schemaPattern, StringtableNamePattern, String[] types)

Los argumentos schemaPattern y tableNamePattern como modelos no se tratancomo modelos. Para cualquiera de estos dos argumentos, si el valor es null o "%",se establecen correspondencias con todos los nombres. En caso contrario, elargumento se trata como un nombre exacto en lugar de como un modelo.

ResultSet getTableTypes()


String getTimeDateFunctions()


ResultSet getTypeInfo()


ResultSet getUDTs(String catalog, String schemaPattern, StringtypeNamePattern, int[] types)


String getURL()

Devuelve null.

String getUserName()


ResultSet getVersionColumns(String catalog, String schema,String table)


boolean insertsAreDetected(int type)


boolean isCatalogAtStart()


boolean isReadOnly()



boolean locatorsUpdateCopy()

Devuelve true.

boolean nullPlusNonNullIsNull()


boolean nullsAreSortedAtEnd()


boolean nullsAreSortedAtStart()


boolean nullsAreSortedHigh()


boolean nullsAreSortedLow()


boolean othersDeletesAreVisible(int type)


boolean othersInsertsAreVisible(int type)


boolean othersUpdatesAreVisible(int type)


boolean ownDeletesAreVisible(int type)


boolean ownInsertsAreVisible(int type)


boolean ownUpdatesAreVisible(int type)


boolean storesLowerCaseIdentifiers()

boolean storesLowerCaseQuotedIdentifiers()



boolean storesMixedCaseIdentifiers()


boolean storesMixedCaseQuotedIdentifiers()


boolean storesUpperCaseIdentifiers()


boolean storesUpperCaseQuotedIdentifiers()


boolean supportsAlterTableWithAddColumn()

Devuelve false.

boolean supportsAlterTableWithDropColumn()

Devuelve false.

boolean supportsANSI92EntryLevelSQL()

Devuelve false.

boolean supportsANSI92FullSQL()

Devuelve false.

boolean supportsANSI92IntermediateSQL()

Devuelve false.

boolean supportsBatchUpdates()

Devuelve false.

boolean supportsCatalogsInDataManipulation()

Devuelve true.

boolean supportsCatalogsInIndexDefinitions()

Devuelve false.

boolean supportsCatalogsInPrivilegeDefinitions()

Devuelve false.

boolean supportsCatalogsInProcedureCalls()

Devuelve false.


boolean supportsCatalogsInTableDefinitions()

Devuelve true.

boolean supportsColumnAliasing()

Recupera si esta base de datos soporta la asignación de alias de columnas.

boolean supportsConvert(int fromType, int toType)

Devuelve false.

supportsConvert(int fromType, int toType)

Devuelve false.

boolean supportsCoreSQLGrammar()

Devuelve false.

boolean supportsCorrelatedSubqueries()

Devuelve false.

boolean supportsDataDefinitionAndDataManipulationTransactions()

Devuelve false.

boolean supportsDataManipulationTransactionsOnly()

Devuelve false.

boolean supportsDifferentTableCorrelationNames()

Devuelve false.

boolean supportsExpressionsInOrderBy()

Devuelve false.

boolean supportsExtendedSQLGrammar()

Devuelve false.

boolean supportsFullOuterJoins()

Devuelve false.

boolean supportsGetGeneratedKeys()

Devuelve false.

boolean supportsGroupBy()

Devuelve true.


boolean supportsGroupByBeyondSelect()

Devuelve true.

boolean supportsGroupByUnrelated()

Devuelve true.

boolean supportsIntegrityEnhancementFacility()

Devuelve false.

boolean supportsLikeEscapeClause()

Devuelve true.

boolean supportsLimitedOuterJoins()

Devuelve true.

boolean supportsMinimumSQLGrammar()

Devuelve false.

boolean supportsMixedCaseIdentifiers()

Devuelve false.

boolean supportsMixedCaseQuotedIdentifiers()

Devuelve false.

boolean supportsMultipleOpenResults()

Devuelve false.

boolean supportsMultipleResultSets()

Devuelve false.

boolean supportsMultipleTransactions()

Devuelve false.

boolean supportsNamedParameters()

Devuelve false.

boolean supportsNonNullableColumns()

Devuelve false.

boolean supportsOpenStatementsAcrossCommit()

Devuelve true.


boolean supportsOpenStatementsAcrossRollback()

Devuelve true.

boolean supportsOpenStatementsAcrossCommit()

Devuelve true.

boolean supportsOpenStatementsAcrossRollback()

Devuelve false.

boolean supportsOrderByUnrelated()

Devuelve false.

boolean supportsOuterJoins()

Devuelve true.

boolean supportsPositionedDelete()

Devuelve false.

boolean supportsPositionedUpdate()

Devuelve false.

boolean supportsResultSetConcurrency(int type, int concurrency)

Devuelve false.

boolean supportsResultSetHoldability(int holdability)

Devuelve true si holdability es ResultSet.HOLD_CURSORS_OVER_COMMIT.

boolean supportsResultSetType(int type)

Devuelve true si type es ResultSet.TYPE_FORWARD_ONLY.

boolean supportsSavepoints()

Devuelve false.

boolean supportsSchemasInDataManipulation()

Devuelve false.

boolean supportsSchemasInIndexDefinitions()

Devuelve false.

boolean supportsSchemasInPrivilegeDefinitions()

Devuelve false.


boolean supportsSchemasInProcedureCalls()

Devuelve false.

boolean supportsSchemasInTableDefinitions()

Devuelve false.

boolean supportsSelectForUpdate()

Devuelve false.

boolean supportsStatementPooling()

Devuelve false.

boolean supportsStoredProcedures()

Devuelve false.

boolean supportsSubqueriesInComparisons()

Devuelve false.

boolean supportsSubqueriesInExists()

Devuelve false.

boolean supportsSubqueriesInIns()

Devuelve false.

boolean supportsSubqueriesInQuantifieds()

Devuelve false.

boolean supportsTableCorrelationNames()

Devuelve true.

boolean supportsTransactionIsolationLevel(int level)

Devuelve true si level es Connection.TRANSACTION_NONE.

boolean supportsTransactions()

Devuelve false.

boolean supportsUnion()

Devuelve false.

boolean supportsUnionAll()

Devuelve false.


boolean updatesAreDetected(int type)

Devuelve false.

boolean usesLocalFilePerTable()

Devuelve false.

boolean usesLocalFiles()

Devuelve false.

ResultSetSe trata de una tabla de datos que representa un conjunto de resultados de base dedatos y que se genera mediante la ejecución de una sentencia que consulta la basede datos.

boolean absolute(int row)


void afterLast()


void beforeFirst()


void cancelRowUpdates()




void close()


void deleteRow()


int findColumn(String columnName)


boolean first()



Array getArray(int i)


Array getArray(String colName)


InputStream getAsciiStream(int columnIndex)


InputStream getAsciiStream(int columnNAME)


BigDecimal getBigDecimal(int columnIndex)


BigDecimal getBigDecimal(int columnIndex, int scale)


getBigDecimal(String columnName)


InputStream getBinaryStream(int columnIndex)


InputStream getBinaryStream(String columnName)


Blob getBlob(int i)


Blob getBlob(String colName)


boolean getBoolean(String columnIndex)


boolean getBoolean(String columnName)


byte getByte(int columnIndex)



byte getByte(String columnName)


byte[] getBytes(int columnIndex)


byte[] getBytes(String columnName)


Reader getCharacterStream(int columnIndex)


Reader getCharacterStream(int columnName)


Clob getClob(int i)


Clob getClob(String colName)


int getConcurrency()


String getCursorName()


Date getDate(int columnIndex)


Date getDate(int columnName)

Date getDate(int columnIndex, Calendar cal)


double getDouble(int columnIndex)


double getDouble(String columnName)



int getFetchDirection()


int getFetchSize()


float getFloat(int columnIndex)


float getFloat(String columnName)


int getInt(int columnIndex)


int getInt(String columnName)


long getLong(int columnIndex)


ResultSetMetaData getMetaData()


Object getObject(int columnIndex)


Object getObject(int i, Map map)


Object getObject(String columnName)


Object getObject(String colName, Map map)


Ref getRef(int i)


int getRow()



short getShort(int columnIndex)


short getStatement()


String getString(int columnIndex)


String getString(String columnName)


Time getTime(int columnIndex)


Time getTime(int columnName)


Time getTime(int columnIndex, Calendar cal)


Timestamp getTimestamp(int columnIndex)


Timestamp getTimestamp(int columnIndex, Calendar cal)


Timestamp getTimestamp(String columnName)


Timestamp getTimestamp(String columnName, Calendar cal)


int getType()


InputStream getUnicodeStream(int columnIndex)


InputStream getUnicodeStream(int columnName)



URL getURL(int columnIndex)


URL getURL(String columnName)




void insertRow()


boolean isAfterLast()


boolean isBeforeFirst()


boolean isFirst()


boolean isLast()


boolean last()


void moveToCurrentRow()


void moveToInsertRow()


boolean next()


boolean previous()


void refreshRow()



boolean relative(int rows)


boolean rowDeleted()


boolean rowInserted()


boolean rowUpdated()


void setFetchDirection(int direction)


void setFetchSize(int rows)


void updateArray(int columnIndex, Array x)


void updateArray(String columnName, Array x)


void updateAsciiStream(int columnIndex, InputStream x, intlength)


void updateAsciiStream(String columnName, InputStream x, intlength)


void updateBigDecimal(int columnIndex, BigDecimal x)


void updateBigDecimal(String columnName, BigDecimal x)


void updateBinaryStream(int columnIndex, InputStream x, intlength)



void updateBinaryStream(int columnIndex, InputStream x, intlength)


void updateBlob(int columnIndex, Blob x)


void updateBlob(String columnName, Blob x)


void updateBoolean(int columnIndex, boolean x)


void updateByte(int columnIndex, byte x)


void updateByte(String columnName, byte x)


void updateBytes(int columnIndex, byte[] x)


void updateBytes(String columnName, byte[] x)


void updateCharacterStream(int columnIndex,Reader x, intlength)


void updateCharacterStream(String columnName, Reader reader,int length)


void updateClob(int columnIndex,Clob x)


void updateClob(String columnName, Clob x)


void updateDate(int columnIndex, Date x)



void updateDate(String columnName, Date x)


void updateDouble(int columnIndex, double x)


void updateFloat(int columnIndex, float x)


void updateInt(int columnIndex, int x)


void updateInt(String columnName, int x)


void updateLong(int columnIndex, long x)


void updateLong(String columnName,long x)


void updateNull(int columnIndex)


void updateNull(String columnName)


void updateObject(int columnIndex, Object x)


void updateObject(int columnIndex, Object x, int scale)


void updateObject(String columnName, Object x)


void updateObject(String columnName, Object x, int scale)


void updateRef(int columnIndex, Ref x)



void updateRow()


void updateShort(int columnIndex,short x)


void updateShort(String columnName, short x)


void updateString(int columnIndex, String x)


void updateString(String columnName, String x)


void updateTime(int columnIndex,Time x)


void updateTimestamp(int columnIndex,Timestamp x)


void updateTimestamp(String columnName,Timestamp x)


boolean wasNull()


ResultSetMetaDataProporciona información sobre los tipos y las propiedades de las columnas de unobjeto ResultSet.

String getCatalogName(int column)


String getColumnClassName(int column)

Devuelve null.

int getColumnCount()


int getColumnDisplaySize(int column)



String getColumnLabel(int column)


String getColumnName(int column)


int getColumnType(int column)


String getColumnTypeName(int column)


int getPrecision(int column)


int getScale(int column)


String getSchemaName(int column)

Devuelve "IBM Cognos Real-time Monitoring".

String getTableName(int column)


boolean isAutoIncrement(int column)

Devuelve false.

boolean isCaseSensitive(int column)

Devuelve false.

boolean isCurrency(int column)

Devuelve false.

boolean isDefinitelyWritable(int column)

Devuelve false.

boolean isDefinitelyWritable(int column)

Devuelve false.

int isNullable(int column)

Devuelve columnNullable.


isReadOnly(int column)

Devuelve true.

isSearchable(int column)


boolean isSigned(int column)

Devuelve true.

boolean isWritable(int column)

Devuelve false.


Apéndice B. API UM-SSO

IBM Cognos Real-time Monitoring proporciona una API para crear conectores degestión de usuarios e inicio de sesión único (UM-SSO) que proporcionanprestaciones de gestión de usuarios e inicio de sesión único a una aplicaciónexterna una vez que ésta ha autenticado a los usuarios. La API se compone de trespaquetes.

Los paquetes se describen en la tabla siguiente.

Paquete Descripción

com.obi.ibm.um Este paquete contiene la interfaz UMAPI (consulte: “UMAPI” en lapágina 458) que proporciona los métodos para implementar unconector UM-SSO.

com.ibm.obi.um.exception

Este paquete define la excepción que los métodos UM-SSO puedenenviar si se produce una excepción.

com.ibm.obi.um.vo Este paquete contiene las clases para crear los objetos necesariospara los métodos UMAPI, como Credential y User.

Cómo funciona UM-SSOIBM Cognos Real-time Monitoring puede utilizar la misma lógica de autenticaciónque cualquier otra aplicación web externa utilizando la infraestructura del conectorUM-SSO. Las tareas que son específicas de la aplicación externa se implementan enel conector, mientras que la infraestructura se asegura de que todos los accesosprotegidos utilicen el conector para la autenticación.

Las acciones del conector UM-SSO pueden tener cuatro escenarios básicos:v Inicio de sesión inicial en Cognos Real-time Monitoring.v Inicio de sesión en Cognos Real-time Monitoring y navegación a la aplicación

externa.v Inicio de sesión en la aplicación externa y luego navegación a Cognos Real-time

Monitoring.v Sincronización de usuarios.

Primer inicio de sesión en IBM Cognos Real-time MonitoringCuando un usuario inicia sesión en IBM Cognos Real-time Monitoring, laaplicación externa llama al método doAuthenticate con una credencial que contieneel nombre de usuario y la contraseña para el usuario. Si las credenciales sonválidas, el método doAuthenticate(Credential, HttpRequest, HttpResponse)devuelve un objeto SessionInfo que Cognos Real-time Monitoring utiliza paramantener la sesión para el usuario.

Para obtener más información, consulte: “doAuthenticate” en la página 458,“Credential” en la página 462 y “SessionInfo” en la página 465.


Inicio de sesión en IBM Cognos Real-time Monitoring ynavegación a la aplicación externa

En este escenario, el inicio de sesión actúa de la misma forma que el primer iniciode sesión. Sin embargo, el método doAuthenticate(Credential, HttpRequest,HttpResponse) también debe establecer cookies o parámetros de HTTP, o ambos,para que la aplicación externa pueda utilizarlos para validar la sesión actual.

Inicio de sesión en la aplicación externa y navegaciónposterior a IBM Cognos Real-time Monitoring

En este escenario, el inicio de sesión en la aplicación externa debe añadir unacookie o parámetro de HTTP que permita que la aplicación valide sus propiassesiones. Cuando el usuario navega a IBM Cognos Real-time Monitoring, estascookies y parámetros permanecen en la solicitud y pasan a estar disponibles parael método doAuthenticate(HttpRequest, HttpResponse) del conector.

Aquí el conector autentica la sesión utilizando la misma lógica que la utilizada porla aplicación externa. Si previamente se ha creado un objeto SessionInfo (consulte:“SessionInfo” en la página 465) para esta sesión, deberá devolverse el mismoobjeto. De este modo se garantiza que se mantengan los datos de Cognos Real-timeMonitoring que se habían asociado a la sesión. Este escenario se gestiona de lamisma forma que el escenario en el que el usuario inicia sesión en CognosReal-time Monitoring y luego navega a otra página de Cognos Real-timeMonitoring. Si el método doAuthenticate no puede autenticar al usuario, lanza unaexcepción con tipos. Por ejemplo, lanza SessionTimedOutException porque lasesión agota el tiempo de espera. Para obtener más información, consulte:“SessionTimedOutException” en la página 468.

Sincronización de usuariosIBM Cognos Real-time Monitoring planifica la sincronización de usuarios aintervalos regulares. Durante la sincronización, Cognos Real-time Monitoring llamaa los métodos fetchRoles y fetchAllUsers en el conector, que se espera quedevuelva todos los roles y los usuarios que tienen permitido el acceso a CognosReal-time Monitoring. El método fetchRoles(User) se llama cuando un usuario seautentica pero no se sincroniza con Cognos Real-time Monitoring. El usuario sesincroniza y se permite un inicio de dicho usuario.

Instalación de un conector UM-SSOUna vez que haya creado el conector UM-SSO mediante la interfaz UMAP, puedeinstalar el conector.

Procedimiento1. Cree un archivo JAR que contenga la implementación. Este archivo JAR debe

contener un archivo de manifiesto similar al manifiesto necesario para lasfunciones definidas por el usuario (UDF).A continuación se muestra un ejemplo del manifiesto que debe incluir en elarchivo JAR.<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

- <jarManifest xsi:schemaLocation="http://obi.cognos.com/4 jarManifest.xsd"xmlns="http://obi.cognos.com/5" xmlns:xsi="http://www.w3.org/2001/XMLSchemainstance">

<jarManifestXSDVersion>1</jarManifestXSDVersion>


<author>IBM Cognos Realtime Monitoring</author>

<UmssoPlugin>

<name>DummyPlugin</name><description>Example plug-in</description>

<implementor>com.ibm.umsso.example.ExamplePlugin</implementor>

</UmssoPlugin>

</jarManifest>

Para obtener más información sobre los manifiestos, consulte: “Archivos demanifiesto” en la página 359.El elemento implementor especifica el nombre del paquete que contiene elconector.

2. En IBM Cognos Real-time Monitoring Workbench, pulse Workbench.3. En Objetos de Workbench, pulse Funciones definidas por el usuario.4. Pulse Nueva función definida por el usuario.5. En la ventana Seleccionar un archivo JAR, seleccione Cargar un archivo JAR.6. Especifique el Nombre, Descripción y Ruta del archivo JAR.7. Pulse en Continuar.8. Seleccione Terminar para cargar el archivo JAR.

XML setPropertyDetailsUn conector UM-SSO puede especificar los detalles de propiedades que puedenañadir valores adicionales a los valores del sistema en la Consola deadministración de IBM Cognos Real-time Monitoring Workbench.

Los detalles de las propiedades se especifican en el XML que el método getSettings(consulte: “getSettings” en la página 462) proporciona a IBM Cognos Real-timeMonitoring Workbench. Al implementar el método getSettings en un conector, debeproporcionar el XML que este método devuelve en forma de cadena. El formato deeste XML se describe en las secciones siguientes.

Elementos del XML setPropertyDetailsEl elemento del nivel superior del XML Property Details es setPropertyDetails.setPropertyDetails contiene dos subelementos: Group y Property.

Elemento GroupEl elemento Group define la página que añade el conector UM-SSO a los valoresdel sistema de la Consola de administración de IBM Cognos Real-time MonitoringWorkbench. Un elemento setPropertyDetails puede contener cualquier número deelementos Group, y todos los elementos Group deben aparecer al principio deldocumento XML. El elemento Group contiene dos subelementos: name y nameKey.

name

El elemento name especifica el nombre de propertygroup de Group. Todos loselementos Property que utilizan este nombre están relacionados con Group. Porejemplo, si un elemento Group especifica un elemento name con el valor "Xyz",todos los elementos Property que especifican "Xyz" como valor de su subelementopropertyGroup son miembros del grupo Xyz.

Apéndice B. API UM-SSO 455

nameKey

nameKey es la clave del nombre de propertygroup que se corresponde con unacadena localizada mantenida en un paquete de recursos devuelto por el métodogetResourceBundle (consulte: “getResourceBundle” en la página 461) de la interfazUMAPI (consulte: “UMAPI” en la página 458). La cadena del paquete de recursosque coincide con keyName es el nombre del valor que el usuario visualiza enValores del sistema.

Elemento PropertyEl elemento Property define los controles que se muestran en la página de losvalores del sistema. Todos los elementos Property deben ir detrás de los elementosGroup definidos en el XML. Sin embargo, varios elementos Property pueden hacerreferencia al mismo Group.

Un elemento Property contiene los subelementos siguientes:v namev nameKeyv descriptionKeyv uiProperty

name

Un implementador de un conector UM-SSO puede utilizar el nombre del elementoproperty para buscar la propiedad.

nameKey

nameKey es la clave de la propiedad que se corresponde con una cadenalocalizada mantenida en un paquete de recursos. El paquete de recursos sedevuelve a través del método “getResourceBundle” en la página 461 de la interfaz“UMAPI” en la página 458. La cadena del paquete de recursos que coincide conkeyName es el nombre de la etiqueta que se visualiza en Valores del sistema paraesta propiedad.

descriptionKey

descriptionKey es la clave que se corresponde con una cadena localizadamantenida en el paquete de recursos como descripción de la propiedad. El paquetede recursos se devuelve a través del método “getResourceBundle” en la página 461de “UMAPI” en la página 458. El texto de la descripción se muestra en la ayudacontextual que aparece cuando un usuario pasa el puntero por encima de lapropiedad en la página Valores del sistema.

uiProperty

El elemento uiProperty asocia el elemento Property a un elemento Group,especifica el orden en el que se muestra la propiedad en la página Valores delsistema si hay más de una Property asociada al Group y determina si Propertytiene carácter obligatorio.

El elemento uiProperty tiene los subelementos siguientes:v propertyGroup


El nombre del Group al que pertenece el elemento Property. Por ejemplo, si elelemento propertyGroup tiene el valor de "Xyz", IBM Cognos Real-timeMonitoring asocia el elemento Property al elemento Group cuyo nombre es"Xyz".

v listOrderSi hay más de un elemento Property asociado el elemento Group, listOrderespecifica el orden en el que se muestran las propiedades en la página Valoresdel sistema.

v isMandatoryEste elemento es booleano. El valor se establece en false. Al establecer el valordel elemento isMandatory en true se indica que la propiedad se debe definir laprimera vez que se abre IBM Cognos Real-time Monitoring Workbench.

v defaultValueEspecifica el valor predeterminado de la propiedad. Si se establece esteelemento, no se puede especificar un elemento defaultVariable.

v defaultVariableEspecifica la variable predeterminada de la propiedad. Si se establece esteelemento, no se puede especificar un elemento defaultValue.

propertyTypeDefinition

El elemento propertyTypeDefinition especifica el control relacionado con lapropiedad que se muestra en la página Valores del sistema. El control puede serun campo de texto o un cuadro de texto, un campo para números enteros, unbotón de selección, una casilla de verificación o un panel de planificación.

Puede definir cualquiera de los subelementos siguientes en unapropertyTypeDefinition para especificar el tipo de control que se mostrará:v string

Crea un campo de texto en el que el usuario puede entrar una cadena. Esteelemento tiene los atributos opcionales siguientes:– maxlength

El atributo maxLength especifica la longitud máxima que puede entrar elusuario para la cadena.

– isPasswordEspecifica que el campo de texto se utiliza para entrar una contraseña. Paralas contraseñas se utiliza un algoritmo de texto simple.

v multiStringCrea un cuadro de texto en el que el usuario puede entrar varias cadenas.

v intEspecifica un campo en el que el usuario puede entrar un entero. Este elementotiene dos atributos opcionales:– min

Especifica el valor entero mínimo que puede entrar el usuario. Si no seespecifica el atributo min, el valor mínimo es -2147483648.

– maxEspecifica el valor entero máximo que puede entrar el usuario. Si no seespecifica el atributo max, el valor máximo es 2147483647.

v enum


Crea una lista desplegable que se muestra en la página Valores del sistema.Puede especificar varios elementos enum. El elemento enum tiene dos atributos:– choiceKey

Una clave que se corresponde con una cadena localizada mantenida en unpaquete de recursos. La cadena se utiliza para la etiqueta asociada al botón deselección. El paquete de recursos se devuelve a través del métodogetResourceBundle (consulte: “getResourceBundle” en la página 461) de lainterfaz UMAPI (consulte: “UMAPI”).

– choiceValueEspecifica el valor que se devuelve cuando el usuario selecciona el botón deselección.

v BooleanCrea una casilla de verificación.

v ScheduleAñade una interfaz de planificación a la página para permitir al usuarioseleccionar el intervalo con el que se planificará un evento, por ejemplo unasincronización.

UMAPIUMAPI es una interfaz Java que contiene los métodos implementados en unconector UM-SSO. La interfaz se encuentra en el paquete com.obu.ibm.um.

doAuthenticateAutentica a un usuario según una solicitud HTTP y una respuesta HTTP.

En el método se incluye un objeto de credencial (consulte: “Credential” en lapágina 462) junto con la solicitud y la respuesta la primera vez que un usuarioinicia sesión o cuando la sesión del usuario ha caducado. Se llama a este métodocuando IBM Cognos Real-time Monitoring desea realizar un inicio de sesióncuando se encuentra en modo SSO. El método crea una sesión con la aplicaciónexterna.

SintaxisSessionInfo doAuthenticate(Credential credential, javax.servlet.http.HttpServletRequestrequest, javax.servlet.http.HttpServletResponse response)

SessionInfo doAuthenticate(javax.servlet.http.HttpServletRequestrequest,javax.servlet.http.HttpServletResponseresponse)

Parámetros

credential

Objeto de credencial que contiene el nombre de usuario y la contraseña para elusuario que se va a autenticar.

request

Objeto HttpServletRequest que contiene la información para una solicitud HTTP,como autenticación, cabeceras y cookies.

response


Objeto HttpServletResponse que contiene la información para la respuesta HTTPcorrespondiente a la solicitud HTTP.

Devuelve

Información de sesión para la sesión actual. El objeto SessionInfo contiene unobjeto User y los atributos asociados.

Emite

ApplicationNotAvailableException

Si la aplicación externa no está disponible debido a un error de conexión de red,mantenimiento del sistema, etcétera.

InvalidCredentialException

Si la aplicación externa ha proporcionado una credencial no válida cuando elusuario ha intentado iniciar sesión.

doLogoutCierra la sesión con la aplicación externa del usuario actual. Este método destruyela sesión actual.

Sintaxisvoid doLogout(SessionInfo sessionInfo, javax.servlet.http.HttpServletRequestrequest, javax.servlet.http.HttpServletResponse response)

Parámetros

sessionInfo

Propiedades específicas de la sesión junto con el usuario para el que se mantiene lasesión.

request

Objeto HttpServletRequest que contiene la información para la solicitud HTTP,como autenticación, cabeceras y cookies.

response

Objeto HttpServletResponse que contiene la información para la respuestacorrespondiente a la solicitud.

Emite



InvalidCredentialException


Si la aplicación externa ha proporcionado una credencial no válida cuando elusuario ha intentado iniciar sesión.

SessionTimedOutException

Si ha caducado la sesión con la aplicación externa.

fetchAllUsersRecupera todos los usuarios relevantes que tienen permiso para interactuar conIBM Cognos Real-time Monitoring.

Sintaxisjava.util.Iterator fetchAllUsers(int batchSize)

Parámetros

batchSize

Número de usuarios relevantes que se deben recuperar.

Devuelve

Un iterador con objetos de tipo User (consulte: “User” en la página 466). Elnúmero de objetos User devueltos depende de batchSize.

Emite





fetchRolesRecupera todos los roles relevantes que tienen derechos para interactuar con IBMCognos Real-time Monitoring.

Sintaxispublic java.util.Iterator fetchRoles(int batchSize)

Parámetro

batchSize

Número máximo de roles que se deben devolver.

Devuelve

Un iterador con objetos de tipo Rol (consulte: “Role” en la página 463). El númeromáximo de objetos de rol devueltos depende de batchSize.


Emite





getResourceBundleObtiene las cadenas localizadas para los atributos o claves utilizados por elconector. Las cadenas se devuelven con el formato de un objeto ResourceBundle.

Sintaxisjava.util.ResourceBundle getResourceBundle(java.util.Localelocale)

Parámetro

locale

Número de roles relevantes que se deben recuperar.

Devuelve

Un objeto ResourceBundle que contiene las cadenas localizadas para los atributos oclaves utilizados en el conector.

Emite





getRolesObtiene todos los roles asignados para el usuario especificado en la aplicaciónexterna.

Sintaxispublic java.util.Iterator getRoles(User user)

Parámetro

user

Usuario cuyos roles recupera el método.


Devuelve

Un iterador con objetos de tipo Rol (consulte: “Role” en la página 463).

Emite





getSettingsObtiene los valores de configuración como cadena con formato XML. Los valoresayudan a IBM Cognos Real-time Monitoring a registrar el conector UM-SSO. Laimplementación del método getSettings determina cómo se recupera el XML. Porejemplo, el método puede recuperar el XML de un archivo de texto gestionadospor la aplicación externa o contener el XML no modificable en el método.

Sintaxispublic java.lang.String getSettings()

Devuelve

Devuelve un documento XML que especifica los valores de configuración.

onPropertyChangeEl método onPropertyChange es un método de devolución de llamada que sellama desde IBM Cognos Real-time Monitoring para informar al conector sobrecualquier propiedad de los valores de administración que ha modificado el usuarioy que es pertinente para el conector. Para recuperar el valor de propiedad, elconector puede llamar a VCSystem.getVCProperty().getProperty(propertyName) oVCSystem.getVCProperty().isPropertySet(propertyName). Por ejemplo, si semodifica una propiedad de una planificación durante una sincronización, estemétodo detendría el proceso de sincronización.

Sintaxispublic void onPropertyChange(java.lang.String propertyName)

Parámetro

propertyName

El nombre de la propiedad cambia en Cognos Real-time Monitoring.

CredentialLa clase Credential sirve para crear objetos de valor Credential que contienen lascredenciales de inicio de sesión para la autenticación: nombre de usuario ycontraseña.


Un objeto de valor Credential se utiliza en el método doAuthenticate (consulte:“doAuthenticate” en la página 458) cuando la aplicación externa necesita iniciarsesión de un usuario por primera vez o restablecer la sesión para un usuario.

getPasswordObtiene la contraseña contenida en la credencial asociada con el nombre de usuarioen la credencial.

Sintaxispublic java.lang.String getPassword()

Devuelve

Una contraseña en forma de cadena.

getUserNameObtiene el nombre de usuario contenido en la credencial.

Sintaxispublic java.lang.String getUserName()

Devuelve

Un nombre de usuario en forma de cadena.

setPasswordEstablece la cadena de contraseña en la credencial.

Sintaxispublic void setPassword(java.lang.String password)

Parámetros

password

La contraseña asociada al nombre de usuario especificado en la credencial.

setUserNameEstablece el nombre de usuario en la credencial.

Sintaxispublic void setUserNmae(java.lang.String userName)

Parámetros

password

El nombre de usuario que se incluirá en la credencial.

RoleLa clase Role se utiliza para crear objetos de valor Role que contienen los atributosasociados al rol, junto con los usuarios que pertenecen a ese rol.


getAttributesObtiene los atributos especificados en el rol.

Sintaxispublic java.util.Map getAttributes()

Devuelve

Los atributos para el rol como pares de clave-valor contenidos en un objeto demapa.

getRoleDescriptionObtiene la descripción para el rol.

Sintaxispublic java.lang.String getRoleDescription()

Devuelve

Una cadena que contiene la descripción del rol.

getRoleNameObtiene el nombre del rol.

Sintaxispublic java.lang.String getRoleName()

Devuelve

Devuelve una cadena que contiene el nombre del rol.

getUsersObtiene los usuarios asociados con el rol.

Sintaxispublic java.util.Iterator getUsers()

Devuelve

Un iterador con objetos de tipo User (consulte: “User” en la página 466).

setAttributesEstablece los atributos asociados al rol.

Sintaxispublic void setAttributes(java.util.Map attributes)

Parámetros

attributes

Los atributos asociados al rol.


setRoleDescriptionEstablece la descripción del rol

Sintaxispublic void setRoleDescription(java.lang.StringroleDescription)

Parámetros

roleDescription

La descripción del rol.

setRoleNameEstablece el nombre del rol

Sintaxispublic void setRoleName(java.lang.String roleName)

Parámetros

roleName

El nombre del rol.

setUsersEstablece los usuarios asociados al rol.

Sintaxispublic void setUsers(java.util.Iterator userIterator)

Parámetros

userIternator

Un iterador con objetos de tipo User (consulte: “User” en la página 466).

SessionInfoLa clase SessionInfo se utiliza para crear objetos de valor SessionInfo que contienenlas propiedades específicas de la sesión junto con el usuario para el que semantiene la sesión. Una aplicación externa puede utilizar objetos SessionInfo pararealizar el seguimiento de la sesión actual.

getAttributesObtiene los atributos de la sesión.


Devuelve

Devuelve un objeto de mapa que contiene los atributos de la sesión.


getUserDevuelve el usuario asociado a la sesión.

Sintaxispublic User getUser()

Devuelve

Devuelve un objeto “User”.

setAttributesEstablece los atributos en el objeto SessionInfo.


Parámetros

attributes

Un objeto de mapa que contiene los atributos de la sesión como pares declave-valor.

setUserEstablece el usuario en el objeto SessionInfo.

Sintaxispublic void setUser(User user)

Parámetro

user

El “User” que se asociará a la sesión.

UserLa clase User se utiliza para crear un objeto de valor User que contiene losatributos asociados a un usuario.

getAttributesObtiene los atributos del usuario.


Devuelve

Un objeto de mapa que contiene los atributos del usuario como pares declave-valor.

getUserDescriptionObtiene la descripción del usuario.


Sintaxispublic java.lang.String getUserDescription()

Devuelve

Devuelve la descripción del usuario como una cadena.

getUserIdObtiene el ID del usuario.

Sintaxispublic java.lang.String getUserId()

Devuelve

El ID del usuario como una cadena.

setAttributesEstablece los atributos del usuario.


Parámetros

attributes

Un objeto de mapa que contiene los atributos del usuario como pares declave-valor.

setUserDescriptionEstablece la descripción del usuario.

Sintaxispublic void setUserDescription(java.lang.StringuserDescription)

Parámetros

userDescription

La descripción del usuario.

setUserIdEstablece el ID de usuario del usuario.

Sintaxispublic void setUserId(java.lang.String userId)


Parámetros

userId

El ID de usuario del usuario.

ExcepcionesLa API UM-SSO define las tres excepciones que puede lanzar un conector.v ApplicationNotAvailableExceptionv InvalidCredentialExceptionv SessionTimedOutException

Estas excepciones se definen en el paquete com.ibm.obi.um.exception.

ApplicationNotAvailableExceptionEl conector UM-SSO envía esta excepción si la aplicación externa no estádisponible por cualquier motivo, como por un error en la conexión de red o por elmantenimiento del sistema.

InvalidCredentialExceptionEl conector UM-SSO envía esta excepción si la aplicación externa envía unacredencial no válida.

SessionTimedOutExceptionEl conector UM-SSO envía esta excepción si caduca la sesión con la aplicaciónexterna.


Avisos

Esta información se ha desarrollado para productos y servicios que se ofrecen entodo el mundo.

Puede que IBM tenga disponible este material en otros idiomas. Sin embargo, esposible que tenga obligación de tener una copia del producto o de la versión delproducto en dicho idioma para acceder a él.

Puede que IBM no ofrezca en algunos países los productos, servicios ocaracterísticas que se explican en este documento. Póngase en contacto con elrepresentante local de IBM para obtener información sobre los productos yservicios disponibles actualmente en su zona. Cualquier referencia hecha a unproducto, programa o servicio de IBM no implica ni pretende indicar que sólopueda utilizarse ese producto, programa o servicio de IBM. En su lugar, podráutilizarse cualquier producto, programa o servicio con características equivalentesque no infrinja ningún derecho de propiedad intelectual de IBM. Sin embargo, seráresponsabilidad del usuario evaluar y verificar el funcionamiento de cualquierprograma, producto o servicio que no sea de IBM. Este documento puede incluirdescripciones de productos, servicios o características que no forman parte de latitularidad de licencia o programa que ha adquirido.

Puede que IBM tenga patentes o solicitudes de patentes pendientes relacionadascon los temas principales que se tratan en este documento. La posesión de estedocumento no le otorga ninguna licencia sobre estas patentes. Puede enviar susconsultas sobre licencias, por escrito, a la dirección siguiente:

IBM Director of LicensingIBM CorporationNorth Castle DriveArmonk, NY 10504-1785EE. UU.

Para realizar consultas sobre licencias relacionadas con la información de doblebyte (DBCS), póngase en contacto con el Departamento de propiedad intelectual deIBM de su país o envíe sus consultas, por escrito, a la dirección:

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

El párrafo siguiente no es aplicable al Reino Unido ni a ningún otro país dondetales disposiciones sean incompatibles con la legislación local: INTERNATIONALBUSINESS MACHINES CORPORATION PROPORCIONA ESTA PUBLICACIÓN"TAL CUAL", SIN GARANTÍA DE NINGUNA CLASE, YA SEA EXPRESA OIMPLÍCITA, INCLUIDAS, PERO SIN LIMITARSE A ELLAS, LAS GARANTÍASIMPLÍCITAS DE NO VULNERACIÓN DE DERECHOS, COMERCIABILIDAD OADECUACIÓN PARA UN FIN DETERMINADO. En algunos estados no estápermitida la renuncia de las garantías expresas o implícitas en determinadastransacciones, 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; talescambios se incorporarán en nuevas ediciones de la publicación. IBM puedeefectuar, en cualquier momento y sin previo aviso, mejoras y cambios en losproductos y programas descritos en esta publicación.

Cualquier referencia hecha en esta información a sitios web que no son de IBMsólo se proporciona para su comodidad y bajo ninguna circunstancia ha deinterpretarse que IBM representa o se hace responsable del contenido de esos sitiosweb. Los materiales de esos sitios web no forman parte de los materiales de esteproducto de IBM y la utilización de esos sitios web será responsabilidad delusuario.

IBM podría utilizar o distribuir la información que se le envía de la forma queconsidere más oportuna sin incurrir por ello en ninguna obligación con elremitente de la información.

Los tenedores de licencias de este programa que deseen obtener información acercade éste con el fin de permitir: (i) el intercambio de información entre programascreados independientemente y otros programas (incluido el presente) y (ii) lautilización mutua de la información que se ha intercambiado, deben ponerse encontacto con:

IBM Software GroupAttention: Licensing3755 Riverside Dr.Ottawa, ON K1V 1B7Canadá

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

El programa bajo licencia que se describe en este documento y todo el materialbajo licencia disponible para éste los proporciona IBM en función de lo dispuestoen el IBM Customer Agreement, el Acuerdo Internacional de Licencia de Programade IBM o cualquier otro acuerdo equivalente celebrado entre ambas partes.

Los datos de rendimiento contenidos en este documento se obtuvieron en unentorno controlado. Por lo tanto, los resultados obtenidos en otros entornosoperativos podrían variar significativamente. Puede que algunas mediciones sehayan obtenido en sistemas de desarrollo y no existe ninguna garantía que permitaafirmar que puedan obtenerse las mismas mediciones en sistemas dedisponibilidad general. Es más, puede que algunas mediciones sean estimacionesobtenidas por extrapolación. Los resultados reales podrían variar. Los usuarios deeste documento deben verificar los datos que se aplican a su entorno específico.

La información referente a productos que no son de IBM se ha obtenido de losproveedores de esos productos, de sus anuncios publicados o de otras fuentesdisponibles públicamente. IBM no ha probado esos productos y no puedeconfirmar la precisión de la información relacionada con el rendimiento, lacompatibilidad ni ningún otro aspecto relacionado con productos que no son deIBM. Las preguntas relacionadas con las prestaciones de los productos que no sonde IBM deben dirigirse a los proveedores de esos productos.


Todas las declaraciones relacionadas con futuras directrices o intenciones de IBMestán sujetas a cambios o a su retirada sin previo aviso y sólo representanobjetivos.

Esta información contiene ejemplos de datos e informes que se utilizan enoperaciones empresariales de uso habitual. Para ilustrarlos de la forma máscompleta posible, los ejemplos incluyen nombres de personas, empresas, marcas yproductos. Todos estos nombres son ficticios y cualquier similitud que pudieradarse 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 eilustraciones a color no aparezcan.

En función de las configuraciones desplegadas, esta Oferta de software puedeutilizar cookies persistentes y de sesión que recopilan los datos siguientes de cadausuario:v Nombrev Nombre de usuariov Contraseña

para lo siguientev Gestión de sesionesv Autenticaciónv Capacidad de uso mejoradav Configuración de inicio de sesión únicov Rastreo del uso o finalidades funcionales aparte de la gestión de sesiones, la

autenticación, la capacidad de uso mejorada y la configuración de inicio desesión único

Estas cookies no se pueden inhabilitar.

Si las configuraciones que se despliegan para esta Oferta de software leproporcionan como cliente la posibilidad de recopilar información de identificaciónpersonal de los usuarios finales a través de cookies u otras tecnologías, debebuscar su propio asesoramiento legal sobre las leyes aplicables a la recopilación dedichos datos, incluidos los requisitos de aviso y consentimiento.

Para obtener más información acerca del uso de diversas tecnologías, incluidas lascookies, para estas finalidades, consulte la política de privacidad de IBM enhttp://www.ibm.com/privacy y la declaración de privacidad en línea de IBM enhttp://www.ibm.com/privacy/details en la sección titulada "Cookies, balizas weby otras tecnologías" e "IBM Software Products and Software-as-a-Service PrivacyStatement" en http://www.ibm.com/software/info/product-privacy.

Marcas registradas

IBM, el logotipo de IBM e ibm.com son marcas registradas de InternationalBusiness Machines Corp., registradas en varias jurisdicciones de todo el mundo.Otros nombres de productos y servicios pueden ser marcas registradas de IBM ode otras compañías. Hay disponible una lista actual de marcas registradas de IBMen la sección “Copyright and trademark information” de la webwww.ibm.com/legal/copytrade.shtml.

Avisos 471

http://www.ibm.com/privacy

http://www.ibm.com/privacy/details

http://www.ibm.com/software/info/product-privacy

http://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 otrospaíses.

v Microsoft, Windows, Windows NT y el logotipo de Windows son marcasregistradas 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 enotros países.

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


Glosario

Este glosario incluye los términos y lasdefiniciones de IBM Cognos Real-timeMonitoring.

Se utilizan las siguientes referencias cruzadas eneste glosario:v Consulte le remite de un término a un

sinónimo preferido, o de un acrónimo oabreviatura al término definido en su formatocompleto.

v Consulte también le remite a un términorelacionado u opuesto.

Para consultar los glosarios de otros productos deIBM, visite www.ibm.com/software/globalization/terminology (se abre en unaventana nueva).

“C” “E” “F” “H” en la página 474 “I” en lapágina 474 “M” en la página 474 “N” en lapágina 474 “P” en la página 474 “T” en la página474 “U” en la página 474 “V” en la página 474

Ccascada

Operación que propaga exactamente lamisma operación a todos los objetosdependientes.

Eescenario

Secuencia de eventos que prueba modelosde datos empresariales para verresultados esperados o posibles. Losmodelos identifican condicionesempresariales excepcionales.

eventoFila o filas de datos.

expresión escalarExpresión sin una función de conjunto.

Fflujo de datos

Objeto que representa un evento.

flujo de datos consolidadosTabla de flujos de datos que captura flujos

de datos de diversos orígenes de flujo dedatos similares y los combina en un únicoflujo de datos.

función de clasificaciónFunción que calcula el resultado escalarpara cada valor de un conjunto conrespecto al conjunto entero. Una funciónde clasificación puede utilizarse sólo en lalista de selección de una sentenciaSELECT.

función de clasificación terminalFunción de clasificación que sólo tieneargumentos escalares.

función de conjuntoFunción que realiza cálculos en unacolumna de un conjunto de filas de unavista, como el valor promedio del coste dealgunos pedidos de producto similares.Una función de conjunto puede utilizarsesólo en la lista de selección de unasentencia SELECT.

función de conjunto en movimientoFunción que realiza cálculos en unaventana de conjunto de las filas de unavista. El conjunto de filas que se debenincluir se determina cuando llega unnuevo flujo de datos, y el conjunto sevacía cuando está lleno.

función de conjunto móvilFunción que realiza cálculos en unconjunto de las últimas filas de una vista.El conjunto de filas que se deben incluirse determina sólo cuando llega un nuevoflujo de datos.

función de conjunto terminalFunción de conjunto que sólo tieneargumentos escalares.

función definida por el usuario (UDF)Función que define el usuario y queproporciona un mecanismo para ampliarC-SQL para utilizarlo en fórmulas,incluidas las consultas, expresiones decampo y reglas.

función escalarFunción SQL que opcionalmente aceptaargumentos y devuelve un único valorescalar cada vez que se le invoca. Se


http://www-306.ibm.com/software/globalization/terminology/

http://www-306.ibm.com/software/globalization/terminology/

puede hacer referencia a una funciónescalar en una sentencia SQL siempre queuna expresión sea válida.

Hhabilitado

Relativo a un objeto que acepta datosnuevos y los procesa. Cuando se crea unobjeto, está habilitado.

Iinhabilitado

Relativo a un objeto que no acepta datosnuevos. Inhabilitar un objeto no afecta ala definición o a la existencia de esteobjeto. En lugar de ello, simplementeevita que los datos nuevos lleguen alobjeto y a todos los que dependan de él.

Mmodelado de datos empresariales

Técnica para describir los flujos de datos,tablas de consulta, vistas y reglas queexplican cómo funciona su negocio.

Nno válido

Relativo a un objeto que hace referencia aotro objeto pero que no puede cumplirse.Una referencia puede no ser válidaporque un objeto no existe, o porque unatributo del objeto no coincide con losrequisitos del dependiente (como unadiscrepancia en los tipos de datos), perono porque el dependiente estéinhabilitado. Todos los objetos quedependen de un objeto no válido tampocoson válidos.

Pperfil de entrega

Perfil que especifica dónde y cómoentregar alertas y feeds de datos alusuario.

Ttabla virtual

Tabla o vista en que las filas se derivan amedida que se requieren en la memoria.

UUDF Consulte: función definida por el usuario.

unión externaUnión cuyo resultado consta de las filaspara las que se establecencorrespondencias de las dos tablas unidasy las filas para las que no se establecencorrespondencias de una o las dos tablas.Consulte también: unión interna.

unión internaResultado de una operación de unión queincluye sólo las filas para las que seestablecen correspondencias de las dostablas que se unen. Consulte también:unión externa.

Vventana de consulta

Ventana que especifica un conjunto defilas que se utilizan en cálculos conrespecto a la fila actual en proceso deexamen. El cálculo puede ser paracalcular una función de conjunto móvil,una unión o las filas que caducan de unavista.

ventana en movimientoVentana que vacía su contenido cuandoavanza para incluir el evento másreciente.

vista completaVista que contiene los resultados de lasagregaciones derivadas de flujos de datospasados en una sola fila. Una vista escompleta si contiene una función deconjunto o función de conjunto móvil enla cláusula SELECT, si contiene unacláusula GROUP BY (en cuyo caso hayuna fila para cada grupo), o si deriva deotra vista completa.

vista de instantáneaVista que es una réplica de una vista en elmomento de ejecutarse la consulta.

vista recienteInstantánea de la última vista actual novacía. Una vista reciente es lo que apareceen el entorno de trabajo al editar unobjeto que visualiza resultados de vistas.

vista sin estadoVista que contiene sólo las filas querepresentan el efecto del último evento.


Glosario 475

Documents

IBM Cognos Real-time MonitoringWorkbench Versión 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/es/1… · Tipos de datos de terceros que se correlacionan con el