IBM CognosTM1 Versión 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/es/1… ·...

IBM Cognos TM1Versión 10.2.2

Guía de referencia

��

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

Información sobre el producto

Este documento se aplica a IBM Cognos TM1 Versión 10.2.2 y puede aplicarse también a los releases subsiguientes.

Licensed Materials - Property of IBM

© Copyright IBM Corporation 2007, 2014.

Contenido

Introducción . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii

Capítulo 1. Novedades . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Características nuevas de la versión 10.2.2 . . . . . . . . . . . . . . . . . . . . . . . . . 1Características nuevas en la versión 10.2.0 . . . . . . . . . . . . . . . . . . . . . . . . . 1

Capítulo 2. Cuadros de diálogo y ventanas . . . . . . . . . . . . . . . . . . . . 3Cuadro de diálogo Propiedades del botón de acción . . . . . . . . . . . . . . . . . . . . . . 3

Pestaña Proceso . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Pestaña Hoja de trabajo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Pestaña Apariencia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Cuadro de diálogo Opciones avanzadas . . . . . . . . . . . . . . . . . . . . . . . . . . 7Cuadrícula Correlación avanzada . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Editor de atributos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Menú Archivo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Menú Editar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Opciones de formato . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Ventana Registro de auditoría . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13Panel Consulta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13Panel Resultados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Ventana Detalles del registro de auditoría . . . . . . . . . . . . . . . . . . . . . . . . . 17Barra de herramientas Detalles . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18Cuadrícula Detalles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Asistente para la configuración de tareas . . . . . . . . . . . . . . . . . . . . . . . . . 19Pantalla 1 (paso 1) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19Pantalla 2 (paso 2) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Ventana Clientes/Grupos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20Menú Seguridad. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20Menú Clientes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20Menú Grupos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21Cuadrícula Clientes/Grupos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Cuadro de diálogo Centro de mensajes de clientes . . . . . . . . . . . . . . . . . . . . . . 22Cuadro de diálogo Crear una dimensión . . . . . . . . . . . . . . . . . . . . . . . . . 22Cuadro de diálogo Crear objeto de réplica de servidor . . . . . . . . . . . . . . . . . . . . . 23Cuadro de diálogo Creación de cubos . . . . . . . . . . . . . . . . . . . . . . . . . . 23Cuadro de diálogo Optimizador del cubo . . . . . . . . . . . . . . . . . . . . . . . . . 24Cuadro de diálogo Propiedades del cubo . . . . . . . . . . . . . . . . . . . . . . . . . 25Cube Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Menú Archivo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26Menú Editar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27Menú Ver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27Menú Opciones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Cuadro de diálogo Borrar subconjuntos con nombre . . . . . . . . . . . . . . . . . . . . . . 28Cuadro de diálogo Borrar vistas con nombre . . . . . . . . . . . . . . . . . . . . . . . . 29Editor de dimensiones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Menú Dimensión . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Menú Editar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Menú Ver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Cuadro de diálogo Insertar elementos de dimensiones . . . . . . . . . . . . . . . . . . . . . 33Cuadro de diálogo Ordenar elementos de dimensiones . . . . . . . . . . . . . . . . . . . . . 33Cuadro de diálogo Propiedades de elementos de dimensiones . . . . . . . . . . . . . . . . . . 34Ver los detalles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Cuadro de diálogo Editar fórmula . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Cuadro de diálogo Editar referencia al cubo . . . . . . . . . . . . . . . . . . . . . . . . 36Cuadro de diálogo Filtrar elementos por atributo . . . . . . . . . . . . . . . . . . . . . . . 37

© Copyright IBM Corp. 2007, 2014 iii

Cuadro de diálogo Filtrar elementos por nivel . . . . . . . . . . . . . . . . . . . . . . . . 37Cuadro de diálogo Filtrar subconjunto . . . . . . . . . . . . . . . . . . . . . . . . . . 37Cuadro de diálogo Filtrar vista . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Cuadro de diálogo Obtener vista (Navegador de hojas de cálculo) . . . . . . . . . . . . . . . . . 41Menú Navegador de hojas de cálculo. . . . . . . . . . . . . . . . . . . . . . . . . . . 41Ventana Registro de mensajes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

Menú Archivo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42Menú Editar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43Menú Ayuda . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

Cuadro de diálogo Nuevo atributo . . . . . . . . . . . . . . . . . . . . . . . . . . . 43Cuadro de diálogo Abrir subconjunto . . . . . . . . . . . . . . . . . . . . . . . . . . 43Cuadro de diálogo Abrir vista . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43Asistente de informes de impresión . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Todas las pantallas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44Pantalla 1 de 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44Pantalla 2 de 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45Pantalla 3 de 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Cuadro de diálogo Opciones de proceso . . . . . . . . . . . . . . . . . . . . . . . . . . 48Cuadro de diálogo Replicar cubo . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Información del cubo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49Información de reglas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49Información de dimensiones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Editor de reglas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51Menú Archivo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51Menú Editar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52Menú Ver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53Menú Insertar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54Menú Herramientas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

Cuadro de diálogo Guardar subconjunto . . . . . . . . . . . . . . . . . . . . . . . . . 54Cuadro de diálogo Guardar vista . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55Cuadro de diálogo Guardar vista (Navegador de hojas de cálculo) . . . . . . . . . . . . . . . . . 55Cuadro de diálogo Asignaciones de seguridad. . . . . . . . . . . . . . . . . . . . . . . . 55

Cuadrícula Asignaciones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55Privilegios de acceso . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55Seleccionar dimensión . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

Cuadro de diálogo Seleccionar cubo . . . . . . . . . . . . . . . . . . . . . . . . . . . 60Cuadro de diálogo Seleccionar cubo para reglas . . . . . . . . . . . . . . . . . . . . . . . 60Cuadro de diálogo Seleccionar dimensión . . . . . . . . . . . . . . . . . . . . . . . . . 60Cuadro de diálogo Seleccionar hoja de trabajo de dimensiones . . . . . . . . . . . . . . . . . . 60Cuadro de diálogo Seleccionar elemento. . . . . . . . . . . . . . . . . . . . . . . . . . 60Cuadro de diálogo Seleccionar hoja de trabajo de reglas . . . . . . . . . . . . . . . . . . . . 61Server Explorer (ventana principal) . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

Menú Archivo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61Menú dinámico . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61Menú Editar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73Menú Ver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

Editor de subconjuntos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74Menú Subconjunto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75Menú Editar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75Menú Ver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78Menú Herramientas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

Cuadro de diálogo Alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79Cuadro de diálogo Opciones de TM1 . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

Parámetros de inicio de sesión . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79Servidor local. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80Secure Socket Layer del servidor de administración . . . . . . . . . . . . . . . . . . . . . 80

Cuadro de diálogo Consulta del registro de transacciones . . . . . . . . . . . . . . . . . . . . 81Cuadro de diálogo Resultados de la consulta del registro de transacciones . . . . . . . . . . . . . . 82Editor de TurboIntegrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

Menú Archivo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83Menú Editar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

iv IBM Cognos TM1 Versión 10.2.2: Guía de referencia

Pestaña Origen de datos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84Vista previa de cuadrícula . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99Pestaña Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100Pestaña Correlaciones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101Pestaña Avanzado . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106Pestaña Planificación . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108

Ventana Extracción de vistas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108Cuadro de diálogo Estilos de vista . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

Capítulo 3. Funciones de reglas . . . . . . . . . . . . . . . . . . . . . . . . 111Operadores aritméticos de las reglas TM1 . . . . . . . . . . . . . . . . . . . . . . . . . 111Operadores de comparación de las reglas TM1 . . . . . . . . . . . . . . . . . . . . . . . 111Operadores lógicos de las reglas TM1 . . . . . . . . . . . . . . . . . . . . . . . . . . 112Función de reglas de cálculo de consolidación . . . . . . . . . . . . . . . . . . . . . . . 112

ConsolidatedMin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112ConsolidatedMax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113ConsolidatedAvg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114ConsolidatedCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115ConsolidatedCountUnique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116

Funciones de reglas de atributos . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117ATTRN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117ATTRS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118CubeATTRN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118CubeATTRS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119DimensionATTRN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119DimensionATTRS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120

Funciones de reglas de datos de cubo . . . . . . . . . . . . . . . . . . . . . . . . . . 120DB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120ISLEAF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121ISUNDEFINEDCELLVALUE . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121UNDEF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122UNDEFINEDCELLVALUE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122UNDEFVALS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

Funciones de reglas de fecha y hora . . . . . . . . . . . . . . . . . . . . . . . . . . . 124DATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124DATES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125DAY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126DAYNO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126MONTH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127NOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127TIME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127TIMST. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128TIMVL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130TODAY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132YEAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133

Funciones de reglas de información de dimensiones . . . . . . . . . . . . . . . . . . . . . 134ConsolidateChildren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134DIMNM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136DIMSIZ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137DNEXT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137DNLEV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138TABDIM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

Funciones de reglas de información de elementos . . . . . . . . . . . . . . . . . . . . . . 139DIMIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139DTYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140ELCOMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140ELCOMPN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141ELISANC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141ELISCOMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142ELISPAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142ELLEV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143

Contenido v

ELPAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144ELPARN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144ELWEIGHT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145

Funciones de reglas financieras . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145FV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145PAYMT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146PV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147

Funciones de reglas lógicas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147CONTINUE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147IF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148STET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148

Funciones de reglas matemáticas . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149ABS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149ACOS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149ASIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149ATAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150COS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150EXP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151INT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151ISUND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151LN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152LOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152MAX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153MIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153MOD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153RAND. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154ROUND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154ROUNDP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155SIGN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156SIN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156SQRT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156TAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157

Funciones de reglas de texto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157CAPIT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157CHAR. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158CODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158DELET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158FILL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159INSRT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159LONG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160LOWER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160NUMBR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161SCAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161STR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162SUBST. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162TRIM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163UPPER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163

Otras funciones de reglas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163FEEDERS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163FEEDSTRINGS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164SKIPCHECK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164EvalJavaN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165EvalJavaS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165

Capítulo 4. Funciones de macro . . . . . . . . . . . . . . . . . . . . . . . . 167Acceso a las funciones de macros. . . . . . . . . . . . . . . . . . . . . . . . . . . . 167

Acceso a funciones de macros de las versiones 5 y 7 de Excel . . . . . . . . . . . . . . . . . 167Acceso a funciones de macros de la versión 8 y posteriores de Excel . . . . . . . . . . . . . . . 167Acceso a las funciones de macros desde módulos VBA . . . . . . . . . . . . . . . . . . . 168D_PICK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168DBProportionalSpread . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168

vi IBM Cognos TM1 Versión 10.2.2: Guía de referencia

D_FSAVE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169D_SAVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170E_PICK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171I_EXPORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172I_NAMES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173I_PROCESS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173M_CLEAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174N_CONNECT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174OPTGET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175N_DISCONNECT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176OPTSET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176PublishSubset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177PublishView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178QUDEFINE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178QUDEFINEEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181QUEXPORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183QULOOP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184QUSUBSET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185R_SAVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186SUBDEFINE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186SUBPICK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187T_CLEAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188T_CREATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188T_CREATE16 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189T_PICK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190T_SAVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190TM1RECALC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190TM1RECALC1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191VUSLICE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191W_DBSENABLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192

Capítulo 5. Funciones de hoja de trabajo . . . . . . . . . . . . . . . . . . . . 193Descripción general de las funciones de las hojas de trabajo . . . . . . . . . . . . . . . . . . . 193

DBR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193DBRA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194DBRW. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195DBS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196DBSA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196DBSS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197DBSW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198DFRST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199DIMIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199DIMNM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200DIMSIZ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201DNEXT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201DNLEV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202DTYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202ELCOMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203ELCOMPN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203ELISCOMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204ELISPAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205ELLEV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205ELPAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206ELPARN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207ELSLEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207ELWEIGHT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208SUBNM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209SUBSIZ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210TABDIM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210TM1RptElIsConsolidated . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211TM1RptElIsExpanded . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211

Contenido vii

TM1RptElLev . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212TM1RptFilter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212TM1RptRow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213TM1RptTitle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215TM1RptView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215TM1User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216VIEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217

Capítulo 6. Funciones de TM1 TurboIntegrator . . . . . . . . . . . . . . . . . . 219Funciones de TurboIntegrator de texto y ASCII . . . . . . . . . . . . . . . . . . . . . . . 219

ASCIIDelete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219ASCIIOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220SetInputCharacterSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221SetOutputCharacterSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223SetOutputEscapeDoubleQuote . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224TextOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225

Funciones de TurboIntegrator de manipulación de atributos . . . . . . . . . . . . . . . . . . . 226ATTRNL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226ATTRSL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227AttrDelete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228AttrInsert. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229AttrPutN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230AttrPutS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230CubeAttrDelete. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231CubeAttrInsert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231CubeAttrPutN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232CubeAttrPutS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233CubeATTRN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234CubeATTRNL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234CubeATTRS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235CubeATTRSL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236DimensionAttrDelete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237DimensionAttrInsert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238DimensionAttrPutN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238DimensionAttrPutS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239DimensionATTRN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240DimensionATTRNL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240DimensionATTRS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241DimensionATTRSL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242

Funciones de TurboIntegrator de gestión de tareas . . . . . . . . . . . . . . . . . . . . . . 243ChoreQuit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243SetChoreVerboseMessages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244

Funciones de TurboIntegrator de manipulación de cubos . . . . . . . . . . . . . . . . . . . . 244AddCubeDependency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244CellGetN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245CellGetS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246CellIncrementN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247CellIsUpdateable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248CellPutN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248CellPutProportionalSpread . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249CellPutS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250CubeClearData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251CubeCreate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251CubeDestroy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252CubeExists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252CubeGetLogChanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253CubeSaveData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253CubeSetConnParams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255CubeSetLogChanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255CubeUnload. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256

Funciones de TurboIntegrator de reserva de datos . . . . . . . . . . . . . . . . . . . . . . 256

viii IBM Cognos TM1 Versión 10.2.2: Guía de referencia

CubeDataReservationAcquire . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256CubeDataReservationRelease . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257CubeDataReservationReleaseAll . . . . . . . . . . . . . . . . . . . . . . . . . . . 258CubeDataReservationGet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259CubeDataReservationGetConflicts . . . . . . . . . . . . . . . . . . . . . . . . . . 261

Funciones de TurboIntegrator de fecha y hora . . . . . . . . . . . . . . . . . . . . . . . 262FormatDate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262NewDateFormatter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263ParseDate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264

Funciones de TurboIntegrator de manipulación de dimensiones . . . . . . . . . . . . . . . . . 264DimensionCreate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264DimensionDeleteAllElements . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265DimensionDestroy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265DimensionElementComponentAdd . . . . . . . . . . . . . . . . . . . . . . . . . . 266DimensionElementComponentAddDirect . . . . . . . . . . . . . . . . . . . . . . . . 266DimensionElementComponentDelete . . . . . . . . . . . . . . . . . . . . . . . . . 267DimensionElementComponentDeleteDirect . . . . . . . . . . . . . . . . . . . . . . . 268DimensionElementDelete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269DimensionElementDeleteDirect . . . . . . . . . . . . . . . . . . . . . . . . . . . 269DimensionElementInsert. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270DimensionElementInsertDirect. . . . . . . . . . . . . . . . . . . . . . . . . . . . 271DimensionElementPrincipalName . . . . . . . . . . . . . . . . . . . . . . . . . . 272DimensionExists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273DimensionSortOrder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274DimensionUpdateDirect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275DimensionTopElementInsert . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276DimensionTopElementInsertDirect . . . . . . . . . . . . . . . . . . . . . . . . . . 276

Funciones de TurboIntegrator de ODBC . . . . . . . . . . . . . . . . . . . . . . . . . 277ODBCClose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278ODBCOpen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278ODBCOPENEx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278ODBCOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279SetODBCUnicodeInterface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280

Funciones de TurboIntegrator de control de procesos . . . . . . . . . . . . . . . . . . . . . 280ProcessError . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281ExecuteCommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281ExecuteProcess . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282GetProcessErrorFileDirectory . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283GetProcessErrorFilename . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283GetProcessName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284If . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284ItemReject . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285ItemSkip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286ProcessBreak . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286ProcessError . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286ProcessQuit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286While . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287Synchronized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287

Funciones de TurboIntegrator de gestión de reglas . . . . . . . . . . . . . . . . . . . . . . 289CubeProcessFeeders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289CubeRuleAppend . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290CubeRuleDestroy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291DeleteAllPersistentFeeders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291ForceSkipCheck . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292RuleLoadFromFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292

Funciones de recintos de pruebas. . . . . . . . . . . . . . . . . . . . . . . . . . . . 293GetUseActiveSandboxProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . 293ServerSandboxesDelete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294ServerActiveSandboxGet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298ServerActiveSandboxSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298SetUseActiveSandboxProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299

Contenido ix

ServerSandboxExists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300ServerSandboxGet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300ServerSandboxListCountGet . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301

Funciones de TurboIntegrator de seguridad . . . . . . . . . . . . . . . . . . . . . . . . 302AddClient . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302AddGroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302AssignClientToGroup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303AssignClientPassword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303AssociateCAMIDToGroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304CellSecurityCubeCreate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304CellSecurityCubeDestroy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305DeleteClient . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305DeleteGroup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306ElementSecurityGet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306ElementSecurityPut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307RemoveCAMIDAssociation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308RemoveCAMIDAssociationFromGroup . . . . . . . . . . . . . . . . . . . . . . . . . 308RemoveClientFromGroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308SecurityOverlayCreateGlobalDefault . . . . . . . . . . . . . . . . . . . . . . . . . . 309SecurityOverlayDestroyGlobalDefault . . . . . . . . . . . . . . . . . . . . . . . . . 310SecurityOverlayGlobalLockNode . . . . . . . . . . . . . . . . . . . . . . . . . . . 310SecurityRefresh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311

Funciones de TurboIntegrator de manipulación de servidores . . . . . . . . . . . . . . . . . . 311BatchUpdateFinish . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312BatchUpdateFinishWait . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313BatchUpdateStart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314CubeSaveData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314DisableBulkLoadMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315EnableBulkLoadMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315SaveDataAll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316ServerShutdown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318

Funciones de TurboIntegrator de manipulación de subconjuntos . . . . . . . . . . . . . . . . . 318SubsetAliasSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318SubsetCreate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319SubsetCreateByMDX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319SubsetDeleteAllElements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320SubsetDestroy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320SubsetElementDelete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321SubsetElementInsert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321SubsetExists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322SubsetExpandAboveSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322SubsetFormatStyleSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323SubsetGetElementName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324SubsetGetSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324SubsetIsAllSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325

Funciones de TurboIntegrator de manipulación de vistas . . . . . . . . . . . . . . . . . . . . 325PublishView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325ViewColumnDimensionSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326ViewColumnSuppressZeroesSet . . . . . . . . . . . . . . . . . . . . . . . . . . . 327ViewConstruct . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328ViewCreate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328ViewDestroy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329ViewExists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329ViewExtractSkipCalcsSet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330ViewExtractSkipRuleValuesSet. . . . . . . . . . . . . . . . . . . . . . . . . . . . 330ViewExtractSkipZeroesSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331ViewRowDimensionSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332ViewRowSuppressZeroesSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333ViewSubsetAssign . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334ViewSuppressZeroesSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334ViewTitleDimensionSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335

x IBM Cognos TM1 Versión 10.2.2: Guía de referencia

ViewTitleElementSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335ViewZeroOut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336

Otras funciones de TurboIntegrator . . . . . . . . . . . . . . . . . . . . . . . . . . . 336AddInfoCubeRestriction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337DataSourceSAPUsingRoleAuths . . . . . . . . . . . . . . . . . . . . . . . . . . . 338DataSourceSAPUsingTexts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338ExecuteJavaN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338ExecuteJavaS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339Expand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340FileExists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341NumberToString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342NumberToStringEx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342RefreshMdxHierarchy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343StringToNumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343StringToNumberEx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344Archivo TM1ProcessError.log . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344TM1User() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345WildcardFileSearch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345

Capítulo 7. Variables de TM1 TurboIntegrator. . . . . . . . . . . . . . . . . . . 347Variables locales de TurboIntegrator . . . . . . . . . . . . . . . . . . . . . . . . . . . 347

DatasourceNameForServer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347DatasourceNameForClient . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347DatasourceType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348DatasourceUsername . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348DatasourcePassword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348DatasourceQuery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348DatasourceCubeview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349DatasourceDimensionSubset . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349DatasourceASCIIDelimiter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349DatasourceASCIIDecimalSeparator . . . . . . . . . . . . . . . . . . . . . . . . . . 350DatasourceASCIIThousandSeparator. . . . . . . . . . . . . . . . . . . . . . . . . . 350DatasourceASCIIQuoteCharacter . . . . . . . . . . . . . . . . . . . . . . . . . . . 350DatasourceASCIIHeaderRecords . . . . . . . . . . . . . . . . . . . . . . . . . . . 351Value_Is_String . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351NValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351SValue. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352OnMinorErrorDoItemSkip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352MinorErrorLogMax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353DataSourceODBOCatalog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353DataSourceODBOConnectionString . . . . . . . . . . . . . . . . . . . . . . . . . . 354DataSourceODBOCubeName . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354DataSourceODBOHierarchyName . . . . . . . . . . . . . . . . . . . . . . . . . . 354DataSourceODBOLocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354DataSourceODBOProvider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355DataSourceODBOSAPClientID. . . . . . . . . . . . . . . . . . . . . . . . . . . . 355DataSourceODBOSAPClientLanguage . . . . . . . . . . . . . . . . . . . . . . . . . 356

Variables globales de TurboIntegrator . . . . . . . . . . . . . . . . . . . . . . . . . . 356NumericGlobalVariable("VariableName"); . . . . . . . . . . . . . . . . . . . . . . . . 356StringGlobalVariable("VariableName"); . . . . . . . . . . . . . . . . . . . . . . . . . 357

Variables globales implícitas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357DataMinorErrorCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357MetadataMinorErrorCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357ProcessReturnCode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358PrologMinorErrorCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358

Variables de usuario de TurboIntegrator . . . . . . . . . . . . . . . . . . . . . . . . . 359

Capítulo 8. Soporte para funciones MDX. . . . . . . . . . . . . . . . . . . . . 361Soporte para funciones y expresiones MDX definidas por Microsoft . . . . . . . . . . . . . . . . 361

Lista de expresiones de elementos soportadas . . . . . . . . . . . . . . . . . . . . . . 361

Contenido xi

Lista de funciones de elementos soportadas . . . . . . . . . . . . . . . . . . . . . . . 361Lista de funciones numéricas soportadas . . . . . . . . . . . . . . . . . . . . . . . . 361Lista de expresiones de conjuntos soportadas. . . . . . . . . . . . . . . . . . . . . . . 362Lista de funciones de conjuntos soportadas . . . . . . . . . . . . . . . . . . . . . . . 362Lista de expresiones de tupla soportadas . . . . . . . . . . . . . . . . . . . . . . . . 363

Funciones MDX específicas de TM1 . . . . . . . . . . . . . . . . . . . . . . . . . . . 363TM1FILTERBYPATTERN( <conjunto>, <cad_modelo> ) . . . . . . . . . . . . . . . . . . . 363TM1FILTERBYLEVEL( <conjunto>, <número_nivel>) . . . . . . . . . . . . . . . . . . . . 363TM1DRILLDOWNMEMBER( <conjunto1>, <conjunto2>|ALL [,RECURSIVE] ) . . . . . . . . . . . 363TM1Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363TM1SORT( <conjunto>, ASC|DESC ) . . . . . . . . . . . . . . . . . . . . . . . . . 364TM1SORTBYINDEX( <conjunto>, ASC|DESC ) . . . . . . . . . . . . . . . . . . . . . . 364TM1SUBSETALL( <nombredim>). . . . . . . . . . . . . . . . . . . . . . . . . . . 364TM1SubsetToSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364TM1TupleSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365Expresiones MDX específicas de TM1 . . . . . . . . . . . . . . . . . . . . . . . . . 366<dimensión>.<nombresubconjunto> . . . . . . . . . . . . . . . . . . . . . . . . . . 366<elemento>.ANCESTORS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366

Avisos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367

Índice. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371

xii IBM Cognos TM1 Versión 10.2.2: Guía de referencia

Introducción

Este documento está destinado a utilizarse con IBM® Cognos TM1.

Este documento es una recopilación de material de referencia para funciones,variables y otros elementos de programación del software IBM Cognos TM1Business Analytics.

Business Analytics proporciona soluciones de software para la gestión y lasupervisión continuas del rendimiento financiero, operativo, de clientes yorganizativo de toda la empresa.

Búsqueda de información

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

Declaración de limitación de responsabilidad de los ejemplos

La compañía Ejemplo Viaje de Aventuras, la compañía Viaje de aventuras, Ventasde VA, las variaciones del nombre Viaje de Aventuras y Ejemplo Viaje deAventuras y Ejemplo de planificación representan operaciones empresarialesficticias con datos de ejemplo utilizados para desarrollar aplicaciones de ejemplopara IBM y clientes de IBM. Estos registros ficticios incluyen datos de muestra paratransacciones comerciales, distribución de productos, finanzas y recursos humanos.Cualquier parecido con nombres, direcciones, números de contacto o valores detransacción reales es una mera coincidencia. Otros archivos de ejemplo puedencontener datos ficticios generados manual o informáticamente, datos relativos ahechos procedentes de orígenes públicos o académicos, o datos utilizados con elpermiso del poseedor del copyright, para utilizarlos como datos de ejemplo paradesarrollar las aplicaciones de ejemplo. Los nombres de producto a los que se hacereferencia pueden ser marcas registradas de sus respectivos propietarios. Quedaprohibida la duplicación no autorizada.

Características de accesibilidad

Las características de accesibilidad ayudan a los usuarios que tienen algunadiscapacidad física, por ejemplo movilidad restringida o visión limitada, a utilizarproductos de tecnología de la información.

Este producto no soporta actualmente características de accesibilidad que ayuden alos usuarios con discapacidad física, como movilidad o visión limitada, a utilizareste producto.

Proyecciones futuras

En esta documentación se describe la funcionalidad actual del producto. Puede quese incluyan referencias a elementos que actualmente no están disponibles. Sinembargo, no deberá deducirse su futura disponibilidad real. Estas referencias noconstituyen un compromiso, promesa ni obligación legal que implique la entregade ningún tipo de material, código o funcionalidad. El desarrollo, la entrega y la

© Copyright IBM Corp. 2007, 2014 xiii

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

comercialización de las características o la funcionalidad son aspectos que quedana la entera discreción de IBM.

xiv IBM Cognos TM1 Versión 10.2.2: Guía de referencia

Capítulo 1. Novedades

Esta sección contiene una lista de características nuevas, modificadas y eliminadaspara esta versión.

Para ver toda la documentación de TM1 disponible actualmente, vaya a la páginade bienvenida de TM1 (http://www.ibm.com/support/knowledgecenter/SS9RXT/welcome).

Características nuevas de la versión 10.2.2A continuación se listan las funciones nuevas añadidas a la documentación de IBMCognos TM1 desde el último release.

Las siguientes funciones nuevas se han modificado o añadido a la documentaciónde funciones de de TurboIntegrator para soportar la nueva característica de objetoslocalizables:v se ha añadido un parámetro nuevo a “AttrPutS” en la página 230v “DimensionAttrInsert” en la página 238v “DimensionAttrDelete” en la página 237v “DimensionAttrPutN” en la página 238v “DimensionAttrPutS” en la página 239v “CubeAttrInsert” en la página 231v “CubeAttrDelete” en la página 231v “CubeAttrPutN” en la página 232v “CubeAttrPutS” en la página 233

Las funciones de TurboIntegrator siguientes se han añadido como parte de lacaracterística de preformato de seguridad:v “SecurityOverlayDestroyGlobalDefault” en la página 310v SecurityOverlayCreateGlobalDefaultv “SecurityOverlayGlobalLockNode” en la página 310

Características nuevas en la versión 10.2.0A continuación se indican las nuevas funciones añadidas a la documentación deIBM Cognos TM1 desde la última versión.

Se han añadido las siguientes funcione nuevas a la documentación de las funcionesde TurboIntegrator:v “ServerSandboxGet” en la página 300v “ServerSandboxExists” en la página 300v “ServerSandboxListCountGet” en la página 301v “AssociateCAMIDToGroup” en la página 304v “RemoveCAMIDAssociation” en la página 308v “RemoveCAMIDAssociationFromGroup” en la página 308v “CellSecurityCubeCreate” en la página 304v “CellSecurityCubeDestroy” en la página 305

© Copyright IBM Corp. 2007, 2014 1

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

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

2 IBM Cognos TM1 Versión 10.2.2: Guía de referencia

Capítulo 2. Cuadros de diálogo y ventanas

Esta sección describe todas las ventanas y todos los cuadros de diálogoimportantes de IBM Cognos TM1 .

Cuadro de diálogo Propiedades del botón de acciónUtilice el cuadro de diálogo Propiedades del botón de acción para añadir botonesde acción TM1 a una hoja de trabajo. Puede configurar el botón para ejecutar unproceso y/o desplazarse a otra hoja de trabajo.

Para obtener ejemplos y conocer los pasos sobre cómo utilizar los botones deacción en hojas de trabajo, consulte la publicación IBM Cognos Developer Guide enIBM Knowledge Center (http://www.ibm.com/support/knowledgecenter/SS9RXT/welcome).

Servidor

Esta lista incluye los nombres de todos los servidores TM1 Server que estándisponibles actualmente en la red.

Seleccione el servidor en el que está ubicada la hoja de trabajo de procesos ode destino del botón de acción.

Conectar

Este botón está disponible sólo cuando no está conectado al servidor que estáactualmente seleccionado en el cuadro de lista de servidores.

Pulse este botón para conectarse al servidor que seleccionó en el cuadro delista de servidores.

Desconectar

Este botón está disponible sólo cuando está conectado al servidor que estáactualmente seleccionado en el cuadro de lista de servidores.

Pulse este botón para desconectarse del servidor que seleccionó en el cuadroServidor.

Acción

Seleccione la acción que desea que realice el botón de acción al pulsar elmismo.v Ejecutar un proceso TurboIntegrator

Seleccione esta opción para configurar un botón de acción que ejecute unproceso. Al seleccionar esta opción, se activará la pestaña Proceso.

v Ir a otra hoja de trabajoSeleccione esta opción para configurar un botón de acción que se desplace aotra hoja de trabajo. Al seleccionar esta opción, se activará la pestaña Hojade trabajo.

v Ejecutar un proceso y, a continuación, ir a una hoja de trabajoSeleccione esta opción para configurar un botón de acción que ejecute unproceso y después se desplace a otra hoja de trabajo. Al seleccionar estaopción, se activarán las pestañas Proceso y Hoja de trabajo.

v Solo calcular/volver a crear


http://www-01.ibm.com/support/knowledgecenter/SS9RXT/welcome

Seleccione esta opción para realizar una operación de recálculo o de volver acrear sin ejecutar un proceso de TI o desplazarse a una nueva hoja detrabajo. Esto puede resultar útil si desea actualizar solamente la hoja actual orecargar la versión original de un formulario activo.También puede utilizar la pestaña Calcular para seleccionar la operación decálculo que desea que TM1 realice antes de ejecutar un proceso de TI odesplazarse a otra hoja de trabajo.

Aceptar

Cierra el cuadro de diálogo Propiedades del botón de acción e inserta un botónde acción en la hoja de trabajo.

Cancelar

Cierra el cuadro de diálogo Propiedades del botón de acción sin insertarningún botón de acción.

Pestaña ProcesoUtilice la pestaña Proceso para configurar un botón de acción para ejecutar unproceso.

Proceso

Utilice esta lista para seleccionar el proceso que desee ejecutar de una de lassiguientes formas:v Para ejecutar un proceso que esté disponible en el servidor actual, seleccione

el nombre de proceso de la lista.v Para recuperar el nombre de proceso y los valores de parámetros de la hoja

de trabajo actual, seleccione Obtener información del proceso de la hoja detrabajo.

Opciones

Abre el cuadro de diálogo Opciones de proceso, en el que puede controlar elcomportamiento del botón de acción antes y después de la ejecución del proceso.

Para obtener más información, consulte la sección “Cuadro de diálogoOpciones de proceso” en la página 48.

Nombre de proceso

Esta opción aparecerá sólo cuando seleccione la opción Obtener informacióndel proceso de la hoja de trabajo en la lista Proceso.

Introduzca una referencia de Excel que incluya el nombre del proceso que seva a ejecutar de una de las siguientes formas.v Para hacer referencia a una única celda, utilice el siguiente formato:

=ColumnNameRowName. Por ejemplo: =A1.v Para hacer referencia a un rango con nombre en Excel, utilice el siguiente

formato: =NameOfRangev Para seleccionar la celda en la hoja de trabajo actual, pulse el botón

Referencia de Excel que aparece junto al cuadro Nombre de proceso.

Parámetros

Introduzca los valores de los parámetros del proceso, según la forma en quehaya seleccionado el nombre de proceso en la lista Proceso.v Si ha seleccionado un proceso en la lista Proceso, la cuadrícula Parámetros

aparecerá con una lista de los parámetros del proceso seleccionado. Puede


introducir valores de cada parámetro directamente en la cuadrícula o utilizaruna referencia de Excel que recupere de forma dinámica un valor delparámetro de la hoja de trabajo actual.

v Si ha seleccionado la opción Obtener información del proceso de la hoja detrabajo en la lista Proceso, debe utilizar una referencia de Excel pararecuperar los valores de los parámetros de la hoja de trabajo actual. Puedeintroducir una referencia en una única celda, un rango de celdas o un rangocon nombre. Las referencias deben indicar el número de celdas adecuado,según el número de parámetros que espere el proceso.

Pulse el botón Referencia de Excel para seleccionar directamente la celdao el rango de celdas de la hoja de trabajo.

Para ver ejemplos, consulte la publicación IBM CognosTM1 Guía deldesarrollador.

Referencia de Excel

Crea una referencia de Excel que recupera de forma dinámica el nombre deproceso o los valores de los parámetros de la hoja de trabajo actual al pulsar elbotón Acción.

Pestaña Hoja de trabajoUtilice la pestaña Hoja de trabajo para configurar un botón de acción y desplazarsea otra hoja de trabajo de Excel.

Buscar en

Utilice uno de los siguientes métodos para seleccionar una hoja de trabajo:v Aplicaciones TM1 : seleccione esta opción si desea elegir una hoja de trabajo

del árbol Aplicaciones TM1 .v Archivos: seleccione esta opción si desea elegir una hoja de trabajo del

sistema.

Examinar

Pulse este botón para seleccionar la hoja de trabajo a la que desea desplazarse.v Si seleccionó la opción Aplicaciones TM1 , se abrirá un cuadro de diálogo en

el que podrá seleccionar una hoja de trabajo del árbol Aplicaciones TM1 .v Si ha seleccionado la opción Archivos, aparecerá el cuadro de diálogo Abrir,

en el que podrá examinar y seleccionar un archivo del sistema.

Libro de trabajo

Contiene la ruta y el nombre del libro de trabajo de Excel al que deseadesplazarse. Puede introducir este valor de una de las siguientes formas:v Pulse el botón Examinar que aparece junto a la opción Buscar en para

seleccionar un libro de trabajo en el árbol Aplicaciones TM1 o en losarchivos del sistema.

v Pulse el botón Referencia de Excel para seleccionar una celda que evalúe laruta y el nombre de un libro de trabajo.

v Introduzca manualmente la ruta y el nombre de un libro de trabajo.v Introduzca manualmente una referencia de Excel que evalúe el nombre y la

ruta de un libro de trabajo.

La ruta de un libro de trabajo del árbol Aplicaciones TM1 utiliza el formato:

<Nombrecarpeta>\<Nombrecarpeta>\<Nombrelibrotrabajo>

Capítulo 2. Cuadros de diálogo y ventanas 5

Por ejemplo:

Planning Sample\Bottom Up Input\Budget Input

La ruta de un archivo de red utiliza el formato:

\\<Nombresistema>\<Nombrecarpeta>\<Nombrelibrotrabajo>

Por ejemplo:

\\boston\reports\2007_summary.xls

Para obtener información detallada y ver ejemplos, consulte la guía deldesarrollador de IBM Cognos TM1 .

Hoja

Contiene el nombre de la hoja de trabajo a la que desea desplazarse. Puedeintroducir este valor de una de las siguientes formas:v Pulse el botón Examinar para seleccionar un libro de trabajo y, a

continuación, seleccione una hoja de trabajo en la lista Hoja.v Introduzca manualmente el nombre de una hoja de trabajo.v Introduzca manualmente una referencia de Excel que evalúe el nombre de

una hoja de trabajo.v Pulse el botón Referencia de Excel para seleccionar una celda que evalúe el

nombre de una hoja de trabajo.


Hacer coincidir elementos de título

Esta opción hace coincidir y establece automáticamente dimensiones de títuloentre hojas de trabajo de origen y destino cuando un usuario pulsa el botónAcción para desplazarse hasta la hoja de trabajo de destino.


Sustituir libro de trabajo actual

Esta opción determina la forma de abrir la hoja de trabajo de destino.v Si no se selecciona esta opción (configuración predeterminada), la hoja de

trabajo de destino se abrirá en una nueva ventana en Excel o en una nuevapestaña en TM1 Web .

v Si selecciona esta opción, la hoja de trabajo de destino se abrirá en la mismaventana o pestaña, sustituyendo a la hoja de trabajo de origen.

PRECAUCIÓN:Si activa esta opción, no olvide guardar el libro de trabajo antes de probar elnuevo botón. Podría perder los cambios si pulsa el botón y cierra el libro detrabajo actual.

Opciones avanzadas

Pulse este botón para abrir el cuadro de diálogo Opciones avanzadas, en el quepodrá correlacionar manualmente campos entre las hojas de trabajo de origen ydestino con un botón de acción que se desplaza de una hoja de trabajo a otra.

Para obtener más detalles, consulte: “Cuadro de diálogo Opciones avanzadas”en la página 7.


Pestaña AparienciaUtilice la pestaña Apariencia para configurar la apariencia visual del botón deacción.

TítuloEstablece el texto del título que aparece en el botón de acción.

FuentePulse este botón para mostrar el cuadro de diálogo Fuente, en el que podráestablecer el tamaño y el estilo de fuente del texto del botón.

Mostrar imagen de fondo

Le permite seleccionar un archivo de imagen (formato bmp, gif o jpg) que seestirará para ajustarse al botón de acción.

Seleccione esta opción y, a continuación, pulse Examinar para ubicar yseleccionar el archivo de imagen que desee utilizar.

Mostrar como hiperenlace

Muestra el botón de acción como hiperenlace con texto azul subrayado enlugar de como un botón estándar.

Esta opción no está disponible al seleccionar la opción Mostrar imagen defondo.

Vista previaEsta área muestra una vista previa del título del texto, el estilo de fuente, elcolor de fuente y el color de fondo del botón.

Colores

Le permite establecer los colores de texto y fondo del botón de acción.

Pulse la muestra de colores de texto o fondo para mostrar el cuadro de diálogoColor, en el que puede seleccionar un color estándar o definir un colorpersonalizado.

Esta opción no está disponible al seleccionar la opción Mostrar comohiperenlace.

Cuadro de diálogo Opciones avanzadasUtilice el cuadro de diálogo Opciones avanzadas para correlacionar manualmentecampos entre las hojas de trabajo de origen y destino al insertar un botón deacción que se desplace de una hoja de trabajo a otra. Esta herramienta le ayuda acorrelacionar dimensiones, celdas y valores de la hoja de trabajo de origen con lahoja de trabajo de destino.

Nota: La opción de correlación avanzada se aplica después de haberse realizadocualquier correlación automática mediante la opción Hacer coincidir elementos detítulo.

Campo Descripción

Añadir Añade una nueva fila a la cuadrículaCorrelación avanzada.

Borrar Borra la fila seleccionada de la cuadrículaCorrelación avanzada.


Campo Descripción

Aceptar Cierra el cuadro de diálogo Opcionesavanzadas y guarda los valores.

Cancelar Cierra el cuadro de diálogo Opcionesavanzadas sin guardar los valores.

Para obtener ejemplos sobre cómo utilizar el recuadro de diálogo Opcionesavanzadas, consulte la publicación IBM Cognos TM1 Developer Guide en IBMKnowledge Center (http://www.ibm.com/support/knowledgecenter/SS9RXT/welcome).

Cuadrícula Correlación avanzadaUtilice la cuadrícula Correlación avanzada para definir la correlación de loscampos entre las hojas de trabajo de origen y destino. Puede utilizar la cuadrículapara especificar cómo los elementos de las hojas de trabajo de origen y destinocoinciden cuando se abre la hoja de destino. Cada fila de la cuadrícula define unaconfiguración de correlación.

Campo Descripción

Tipo de origen Este campo representa el tipo de objeto delvalor que desea correlacionar.

Seleccione el Tipo de origen de la siguientemanera:

v SUBNM: indica que está correlacionandoa partir de una celda que contiene unadimensión de título en la hoja de trabajode origen.

v DBRW seleccionado: indica que estácorrelacionando a partir de una celda quecontiene una fórmula DBRW en la hoja detrabajo de origen.

v Valor: indica que introducirá un valornumérico o una cadena que se enviará aldestino.




Campo Descripción

Objeto de origen Este campo toma un valor según loseleccionado en el campo Tipo de origen.

Introduzca el Objeto de origen de lasiguiente manera:

v Si la opción Tipo de origen estáestablecida en SUBNM, deberá especificarel nombre de la dimensión de título queexista en la hoja de trabajo de origen.

v Si la opción Tipo de origen estáestablecida en la DBRW seleccionada,deberá especificar el nombre de unadimensión de título de columna o fila queexista en la hoja de trabajo de origen.

v Si la opción Tipo de origen estáestablecida en Valor, deberá introduciruna cadena o un valor numérico que seenviará a la hoja de trabajo de destino.

También puede recuperar estos valores de lahoja de trabajo de origen utilizando elsímbolo = para crear una referencia de Excel.

Tipo de destino Este campo es el tipo de celda de la hoja detrabajo de destino en la que se insertará elvalor del campo Objeto de origen.

Seleccione el Tipo de destino de la siguientemanera:

v SUBNM: indica que el destino es unadimensión de título de la hoja de trabajode destino.

v Rango con nombre: indica que el destinoes un rango con nombre de la hoja detrabajo de destino.

v Rango: indica que el destino es una celdade la hoja de trabajo de destino.

PRECAUCIÓN:Si establece el Tipo de destino en un rangoo un rango con nombre, las fórmulas o losdatos que existían previamente en la celdade destino se sustituirán cuando sedesplace con el botón de acción. Si la celdade destino contiene una función DBRWTM1 , la función se perderá y la celda nopodrá conectarse a, leerse desde oescribirse en el servidor.


Campo Descripción

Objeto de destino Este campo representa la ubicación de lahoja de trabajo de destino en la que seinsertará el valor de Objeto de origen.

Introduzca el objeto de destino de lasiguiente manera, según la selección del tipode destino:

v Si la opción Tipo de destino se definecomo SUBNM, debe especificar el nombrede la dimensión de título en la hoja detrabajo de destino.

v Si la opción Tipo de destino se definecomo Rango con nombre, debe especificarel nombre del rango en la hoja de trabajode destino.

v Si la opción Tipo de destino se definecomo Rango, debe especificar la ubicaciónde celda en la hoja de trabajo de destino.

También puede utilizar una referencia deExcel para recuperar el valor del campoObjeto de destino.

Para ver un ejemplo detallado, consulte laguía del desarrollador de IBM Cognos TM1 .

Subconjunto Introduzca un valor en el campoSubconjunto cuando el campo Tipo dedestino esté definido como SUBNM.

Alias Introduzca un valor en el campo Aliascuando el campo Tipo de destino estédefinido como SUBNM.

Editor de atributosUtilice el Editor de atributos para crear y editar atributos de cubos, dimensiones,elementos y réplicas.

Tenga en cuenta que todos los elementos incluyen un atributo Formato, que definecómo aparecen los valores de elemento en Cube Viewer. El valor predeterminadodel atributo Formato es Sin estilo.

Menú Archivo

Elemento de menú Descripción

Cerrar Cierra el Editor de atributos.


Menú Editar


Deshacer celda Deshace la última acción de celda. Estaopción se aplica sólo a celdas individuales.No puede deshacer acciones que se apliquena un rango de celdas.

Cortar Corta el contenido de las celdasseleccionadas y lo coloca en el portapapeles.

Copiar Copia el contenido de las celdasseleccionadas y lo coloca en el portapapeles.

Pegar Pega el contenido del portapapeles en lasceldas seleccionadas.

Añadir nuevo atributo Abre el cuadro de diálogo Nuevo atributo,en el que puede crear un nuevo atributopara los elementos de la dimensión.

Borrar atributo seleccionado Borra un atributo seleccionado. Debeeliminar atributos de forma individual; nopuede eliminar varios atributos a la vez.

Borrar Borra el contenido de las celdasseleccionadas.

Editar formato de elementos Abre el cuadro de diálogo Formatonumérico, en el que puede asignar valores alatributo Formato.

Opciones de formatoLa opción Formato está disponible solo al seleccionar celdas en la intersección delas filas de elementos y la columna Formato. Pulse el botón Formato para mostrarel cuadro de diálogo Formato de número.

Seleccione una opción en el cuadro de lista Categoría para especificar un formatode visualización para las celdas seleccionadas.

Están disponibles los siguientes formatos de número:

Categoría de formato Descripción

General Este formato muestra números sin puntosseparando los dígitos que están a laizquierda del punto decimal. Los valoresnegativos van precedidos de un signo menos(-).

Utilice la opción Precisión para especificar elnúmero de dígitos que siguen al puntodecimal. Tenga en cuenta que los valoresderivados de reglas devuelven enterosúnicamente cuando tienen formato General.



Fijo Este formato muestra números sin puntosseparando los dígitos que están a laizquierda del punto decimal. Los valoresnegativos van precedidos de un signo menos(-); los usuarios cuentan con la opción deutilizar paréntesis para los negativos si loprefieren.

Utilice la opción Precisión para especificar elnúmero de dígitos que siguen al puntodecimal.

Moneda Este formato muestra números con elsímbolo de moneda que se especifica en lasPropiedades de configuración regional deWindows, y utiliza puntos para separar losdígitos de tres en tres a la izquierda delpunto decimal. Los valores negativos vanprecedidos de un signo menos (-).


Fecha Muestra una lista de formatos de fechapredefinidos.

Hora Muestra una lista de formatos de horapredefinidos.

Porcentaje Este formato multiplica los números por 100y muestra un signo de porcentaje (%) detrásde ellos. Los dígitos que están a la izquierdadel punto decimal no utilizan comas, y losvalores negativos van precedidos de unsigno menos (-).


Científico Este formato muestra números en notacióncientífica. Los valores negativos vanprecedidos de un signo menos (-).


Personalizar Puede definir una expresión de formatopersonalizada según sea necesario.



Precisión Esta opción determina el número de cifrasdecimales que van a aparecer en un formatoseleccionado. Si un valor tiene más cifrasdecimales que las indicadas en la precisión,se redondeará únicamente para fines devisualización; el valor completo sealmacenará en la base de datos TM1 .

Ventana Registro de auditoríaUtilice la ventana Registro de auditoría para consultar y ver registros incluidos enel registro de auditoría TM1 .

La ventana Registro de auditoría contiene dos paneles principales; el panelConsulta y el panel Resultados. Utilice estos paneles para buscar el registro deauditoría y ver los registros recuperados en su búsqueda.

Panel ConsultaUtilice el panel Consulta para crear consultas que busquen el registro de auditoríaTM1 .

La barra de herramientas del panel Consulta contiene un botón Ejecutar consulta

para consultar el registro de auditoría tras establecer las opciones de consulta.

Las opciones de consulta se organizan en los siguientes grupos:v Fecha y horav Propietario de eventosv Tipo de evento

Opciones de fecha y hora

Las opciones de fecha y hora incluyen el establecimiento del periodo de tiempoque desee consultar.

Opción Descripción

Periodo de tiempo Contiene una lista de periodos de tiempopredefinidos para la consulta.

Seleccione un periodo de tiempo predefinidoo seleccione Periodo de tiempopersonalizado para activar las opcionesHora de inicio y Hora de finalización.



Hora de inicio La fecha/hora de inicio de la consulta.

Esta opción sólo se activa al seleccionarPeriodo de tiempo personalizado en laopción Periodo de tiempo.

TM1 realiza consultas en todos los registrosescritos en el registro de auditoría en dichafecha/hora o después de ellas.

Pulse para abrir la herramienta decalendario, en la que puede seleccionar unafecha y una hora.

Hora de finalización La fecha y hora de finalización de laconsulta.

Esta opción sólo se activa al seleccionarPeriodo de tiempo personalizado en laopción Periodo de tiempo.

TM1 realiza consultas en todos los registrosde auditoría hasta la hora de finalizaciónque especifique.

Pulse el icono Calendario para abrir laherramienta de calendario, en la que puedeseleccionar una fecha y una hora.

La hora de finalización predeterminadacorresponde a la fecha y hora actuales.

Opciones de Propietario del evento

Las opciones de Propietario del evento responden a la pregunta "¿Quién haprovocado este evento?". El propietario del evento puede ser una tarea planificadao un usuario TM1 real.

Las opciones de Propietario del evento incluyen los siguientes parámetros:


Todo Establece que la consulta busque eventos deauditoría causados por cualquier tareaplanificada o usuario TM1 real.



Cliente Establece que la consulta busque eventos deauditoría causados únicamente por usuariosTM1 .

Para buscar eventos causados por unusuario de TM1 específico, pulse el botón

Seleccionar clientes . Puedeseleccionar un único cliente o varios clientes.

De forma predeterminada, se seleccionantodos los clientes.

Tarea planificada Establece que la consulta busque eventos deauditoría causados únicamente por tareasplanificadas.

Para buscar eventos causados por una tareaplanificada específica, pulse el botón

Seleccionar tarea planificada . Puedeseleccionar una única tarea planificada ovarias tareas planificadas.

De forma predeterminada, se seleccionantodas las tareas planificadas.

Opciones de Tipo de eventoLas opciones de Tipo de evento le permiten seleccionar el tipo de objeto o eventoen el que desea realizar la búsqueda. Por ejemplo, puede utilizar estas opciones debúsqueda para "buscar intentos de inicio de sesión fallidos" o "buscar eventos enlos que se eliminó una dimensión".


Todo Establece que la consulta busque ambostipos de eventos de auditoría; eventosrelacionados con objetos y en todo elsistema.

En todo el sistema Establece que la consulta busque únicamenteeventos de auditoría en todo el sistema.

Para buscar un evento específico en todo elsistema, seleccione el evento de la lista.

El valor predeterminado busca todos loseventos en todo el sistema.



Objeto Establece que la consulta busque únicamenteeventos de auditoría de tipo objeto.

Para buscar un evento de objeto específico,utilice las opciones de la siguiente manera:

v Tipo de objeto: limita la consulta a unsolo tipo de objeto TM1 específico. Porejemplo, eventos relacionados únicamentecon dimensiones.

v Nombre de objeto: le permite seleccionarun nombre de objeto específico.

Pulse para mostrar un cuadro dediálogo en el que puede seleccionarobjetos por nombre.Nota: Al definir la opción Tipo de objetocomo Elemento, se desactivará el botónSelección del nombre de objeto debido aque puede que la lista de elementos seademasiado larga para mostrarse. Parabuscar eventos relacionados con unelemento específico, debe introducirmanualmente un nombre de elementoutilizando el siguiente formato:DimensionName:ElementName. Porejemplo: region:italy

v Tipo de evento: limita la consulta a unsolo tipo específico de evento de objeto. Elvalor predeterminado busca todos loseventos de tipo objeto.

Panel ResultadosUtilice el panel Resultados para ver y desplazarse por los registros recuperados enla búsqueda.

Barra de herramientas del panel ResultadosLa barra de herramientas Resultados tiene los siguientes botones:

Acción Botón Descripción

Copiar Copia el valor de la celdaactualmente seleccionada enel portapapeles de Windows.

Buscar Abre el cuadro de diálogoBuscar, en el que puedebuscar texto en los registrosde eventos.


Acción Botón Descripción

Exportar Abre el cuadro de diálogoGuardar como, en el quepuede guardar los registrosde eventos en un archivo enuno de los siguientesformatos:

v XML

v Delimitado por comas

v Delimitado portabuladores

Cuadrícula ResultadosEl panel Resultados incluye una cuadrícula que muestra los registros del archivode registro de auditoría recuperados por la consulta. Los registros recuperados seorganizan en las siguientes columnas:

Columna Descripción

Fecha Fecha y hora del evento.

Usuario Tarea planificada o cliente TM1 (usuario)responsable del evento.

Descripción/tipo de evento Breve descripción del evento.

Tipo de objeto Tipo de objeto TM1 relacionado con elevento.

Nombre de objeto Nombre del objeto TM1 relacionado con elevento.

Detalles Muestra un icono para indicar que existeinformación detallada sobre el eventoespecífico.

Si un evento tiene detalles, puede verlos

pulsando el icono Detalles de dichoregistro.

Puede clasificar los registros de la cuadrícula de cualquier columna en ordenascendente o descendente pulsando el título de la columna.

Ventana Detalles del registro de auditoríaLa ventana Detalles del registro de auditoría muestra los eventos secundarios deun evento de registro de auditoría que aparecieron en los resultados de la consultade la ventana principal Registro de auditoría.


Barra de herramientas DetallesLa barra de herramientas Detalles tiene los siguientes botones:

Botón Descripción

Copiar Copia el valor de la celda actualmenteseleccionada en el portapapeles deWindows.

Buscar Abre el cuadro de diálogo Buscar, en el quepuede buscar texto en los registros deeventos.

Exportar Abre el cuadro de diálogo Guardar como, enel que puede guardar los registros deeventos en un archivo en uno de lossiguientes formatos:

v XML

v separado por comas

v separado por tabuladores

Cuadrícula DetallesLa cuadrícula Detalles muestra los registros de detalles de los eventos secundariosque pertenecen al evento padre.

Los registros de detalles se organizan en las siguientes columnas:


Fecha Fecha y hora del evento.

Usuario Tarea planificada o cliente TM1 (usuario)responsable del evento.

Descripción/tipo de evento Breve descripción del evento.

Tipo de objeto Tipo de objeto TM1 relacionado con elevento.

Nombre de objeto Nombre del objeto TM1 relacionado con elevento.

Puede clasificar los registros de la cuadrícula de cualquier columna en ordenascendente o descendente pulsando el título de la columna.


Asistente para la configuración de tareasUtilice el Asistente para la configuración de tareas para planificar una réplica,proceso de sincronización o ejecución a intervalos regulares.

El Asistente consta de dos pantallas:v Pantalla 1: seleccione las réplicas y procesos que se van a incluir en la tarea.v Pantalla 2: especifique la hora de inicio de la ejecución inicial de la tarea y el

intervalo posterior con el que debe ejecutarse la tarea.

Pantalla 1 (paso 1)

Campo Descripción

Lista Disponibles Enumera todas las réplicas y procesosdisponibles para planificar como tareas.

Lista Seleccionados Enumera las réplicas o los procesosseleccionados para ser incluidos en la tareaactual.

AñadirPulse este botón para mover las réplicas olos procesos seleccionados de la listaDisponibles a la lista Seleccionados

Añadir todoPulse este botón para mover todas lasréplicas o todos los procesos de la listaDisponibles a la lista Seleccionados.

EliminarPulse este botón para mover las réplicas olos procesos seleccionados de la listaSeleccionados a la lista Disponibles.

Eliminar todoPulse este botón para mover todas lasréplicas o todos los procesos de la listaSeleccionados a la lista Disponibles.

Especificar valores de parámetros Pulse el botón del ratón para abrir el cuadrode diálogo Valores de parámetros, en el quepuede especificar los valores de cualquierparámetro relacionado con el procesoseleccionado.

Pantalla 2 (paso 2)

Campo Descripción

Fecha y hora de inicio de la tarea Seleccione una fecha de inicio en elcalendario y especifique una hora de inicioen el campo Hora.

Frecuencia de ejecución de tareas Rellene los campos adecuados paraestablecer el intervalo con el que debeejecutarse la tarea.

La planificación de la tarea está activa Rellene este cuadro para activar la tarea quese va a ejecutar con el intervalo y la hora deinicio especificados. Borre este cuadro paraactivar la tarea más tarde.


Ventana Clientes/GruposLa ventana Clientes/Grupos le permite crear y modificar clientes y grupos deusuarios en un servidor.

Cuadrícula Clientes/Grupos

La cuadrícula Clientes/Grupos muestra nombres de clientes como cabeceras de filay grupos de usuarios como cabeceras de columna. Una "X" en la intersección de unnombre de cliente y un grupo de usuarios indica el grupo al que pertenece elusuario. Los usuarios pueden pertenecer a varios grupos.

La cuadrícula también incluye varias columnas que muestran propiedades declientes en el servidor.v La celda de la intersección de un nombre de cliente y la columna Contraseña

contiene la contraseña del cliente.v La celda de la intersección de un nombre de cliente y la columna Días para la

caducidad contiene el número de días durante los cuales la contraseña es válidapara el cliente. Después de que transcurra este número de días, el cliente ya nopodrá iniciar sesión en el servidor con la contraseña asignada. Un cliente cuyacontraseña caduque pronto comenzará a recibir avisos de la caducidad cincodías antes de la fecha de caducidad.

v La celda de la intersección del nombre de cliente y la columna Estado indica siel cliente está activo en el servidor.

v La celda de la intersección del nombre de cliente y la columna Número máximode conexiones indica el número máximo de conexiones que se puede estableceren el servidor con la contraseña y el nombre de cliente asociados.

Menú Seguridad


Cerrar Cierra el cuadro de diálogoClientes/Grupos.

Menú Clientes


Añadir nuevo cliente Abre el cuadro de diálogo Creando nuevocliente, en el que podrá crear un nuevocliente en el servidor.

Borrar cliente Borra el cliente seleccionado actualmente delservidor.

Desconectar cliente Desconecta al cliente seleccionadoactualmente del servidor.

Configurar contraseña Establece la contraseña del clienteseleccionado actualmente.

Borrar contraseña Borra la contraseña del cliente seleccionadoactualmente.


Menú Grupos


Añadir nuevo grupo Abre el cuadro de diálogo Creando nuevogrupo, en el que podrá crear un nuevogrupo de usuarios en el servidor.

Borrar grupo Borra el grupo de usuarios seleccionadoactualmente del servidor.

Cuadrícula Clientes/GruposPuede introducir datos de clientes directamente en la cuadrícula Clientes/Grupos.

La cuadrícula incluye varias columnas, tal y como se describe en la siguiente tabla.


Nombre de usuario Muestra los nombres de usuario de todos losclientes del servidor.

Contraseña Identifica si una contraseña está definidapara un cliente determinado.

Puede pulsar una celda en la intersección dela columna Contraseña y una fila de clientey, a continuación, introducir una contraseñapara asignar una contraseña al cliente.

Tras introducir la contraseña, TM1 lesolicitará que vuelva a introducir lacontraseña para confirmarla.

Días para la caducidad Indica el número de días de validez de lacontraseña de un cliente determinado.

Para asignar la caducidad de la contraseñade un cliente, pulse la celda en laintersección de la columna Días para lacaducidad y la fila de cliente y, acontinuación, introduzca un valor decaducidad.

Conexiones máximas Identifica el número máximo de conexionesque se pueden realizar en el servidor através de un cliente determinado.

Para asignar un número máximo deconexiones a un cliente, pulse la celda de laintersección de la columna Número máximode conexiones y la fila de cliente y, acontinuación, introduzca el número máximode conexiones del cliente.

Estado Indica el estado de conexión actual de uncliente determinado.



Grupos de usuarios Existe una columna para cada grupo deusuarios del servidor.

Para asignar un cliente a un grupo deusuarios, seleccione la casilla de verificaciónde la intersección de la columna del grupode usuarios y el nombre del cliente.

Los clientes pueden pertenecer a variosgrupos de usuarios.

Cuadro de diálogo Centro de mensajes de clientesEl cuadro de diálogo Centro de mensajes de clientes le permite administrar lasconexiones de clientes a un servidor. También puede utilizar este cuadro dediálogo para apagar de forma remota un servidor. Debe ser un miembro del grupoADMIN de un servidor para acceder a este cuadro de diálogo.

Seleccione un servidor en el panel de la izquierda de Server Explorer y, acontinuación, seleccione Servidor, Gestor de servidor para abrir el cuadro dediálogo Centro de mensajes de clientes.

Campo Descripción

Apagar servidor Seleccione esta opción para apagar elservidor y, a continuación, especifique unintervalo en minutos.

Desconectar clientes Seleccione esta opción para desconectarclientes del servidor y, a continuación,especifique un intervalo en minutos.

Debe pulsar Seleccionar clientes para crear oseleccionar el subconjunto de clientes que seva a desconectar.

Difundir mensaje a los clientes seleccionados Seleccione esta opción para difundir unmensaje de texto a los clientes conectados alservidor.

Introduzca el mensaje en el cuadro de textoy, a continuación, pulse Seleccionar clientespara crear o seleccionar un subconjunto declientes que recibirán el mensaje.

Cuadro de diálogo Crear una dimensiónIntroduzca el nombre de la dimensión que desee crear en el campo que aparece enla parte superior del cuadro de diálogo y, a continuación, pulse Aceptar.

Para crear una dimensión en su servidor local, introduzca únicamente el nombrede la dimensión.

Para crear una dimensión en un servidor remoto, introduzca el nombre de ladimensión precedido del nombre del servidor y dos puntos. Por ejemplo,introduzca Sales:Product para crear la dimensión Product en el servidor Sales.


Cuadro de diálogo Crear objeto de réplica de servidorUtilice el cuadro de diálogo Crear objeto de réplica de servidor para establecer unanueva conexión de réplica o para modificar una conexión existente.

Campo Descripción

En el servidor Seleccione un servidor de origen de la lista.La lista incluye los nombres de todos losservidores que están disponibles actualmenteen la red.

Como usuario Introduzca su nombre de usuario en elservidor de origen seleccionado.

Con contraseña Introduzca la contraseña del servidor deorigen seleccionado.

Con espacio de nombres Si el objeto utiliza seguridad de pasaporteCAM, especifique el ID de espacio denombres de IBM Cognos. No escriba aquí elnombre descriptivo.

Utilizar el inicio de sesión integrado Seleccione este cuadro para utilizar laautenticación Inicio de sesión integrado enlugar de la seguridad de TM1 estándar.

Cuadro de diálogo Creación de cubosUtilice las siguientes opciones del cuadro de diálogo Creación de cubos para crearun nuevo cubo a partir de dimensiones definidas previamente.

Campo Descripción

Nombre de cubo Introduzca el nombre del cubo que estácreando en este campo.

Dimensiones disponibles Una lista de todas las dimensionesdisponibles en el servidor en el que estácreando el cubo.

Dimensiones del nuevo cubo La lista de dimensiones del cubo que estácreando.

Añadir Pulse este botón para mover las dimensionesseleccionadas de la lista Dimensionesdisponibles a la lista Dimensiones del nuevocubo

Eliminar Pulse este botón para mover las dimensionesseleccionadas de la lista Dimensiones delnuevo cubo a la lista Dimensionesdisponibles.

Subir Pulse este botón para subir las dimensionesseleccionadas en la lista Dimensiones delnuevo cubo. Con cada pulsación del botón,las dimensiones seleccionadas subirán unaposición.


Campo Descripción

Bajar Pulse este botón para bajar las dimensionesseleccionadas en la lista Dimensiones delnuevo cubo. Con cada pulsación del botón,las dimensiones seleccionadas bajarán unaposición.

Cancelar Pulse el botón del ratón para cancelar lacreación del cubo y salir del cuadro dediálogo Creación de cubos.

Restablecer Pulse el botón del ratón para restablecer lalista Dimensiones disponibles y borrar lalista Dimensiones del nuevo cubo.

Actualizar Pulse el botón del ratón para actualizar lalista Dimensiones disponibles. Esta opciónsondea el servidor en busca de nuevasdimensiones y añade las dimensionesnuevas a la lista Dimensiones disponibles.

Propiedades Pulse este botón para asignar propiedades alcubo.

Puede asignar propiedades que definen unadimensión de medidas, una dimensión detiempo y el estado de carga a petición delcubo.

Aceptar Pulse el botón del ratón para aceptar laconfiguración del cuadro de diálogo y crearel cubo.

Cuadro de diálogo Optimizador del cuboSi no está extremadamente familiarizado con sus datos empresariales, es posibleespecificar un orden de dimensiones durante la creación del cubo que dé comoresultado un rendimiento no óptimo. De igual forma, es posible que la distribuciónde los datos de un cubo cambie con el paso del tiempo, lo que provoca que elorden de las dimensiones especificado durante la creación del cubo no sea elidóneo. Para hacer frente a estos problemas, TM1 incluye una característica que lepermite optimizar el orden de las dimensiones de un cubo, que se traducirá en unamenor utilización de memoria y en una mejora del rendimiento.

Cuando optimiza el orden de las dimensiones de un cubo, TM1 no cambia el ordenreal de las dimensiones en la estructura de cubo. TM1 cambia la forma en que estánordenadas las dimensiones internamente en el servidor, pero dado que laestructura de cubo no cambia, las reglas, funciones o aplicaciones que hacenreferencia al cubo permanecen válidas.

Al cambiar el orden de las dimensiones, puede ver de forma instantánea uninforme que detalla el impacto que tienen sus cambios en el consumo de memoriadel cubo.

Por las siguientes razones, debería optimizar el orden de las dimensiones de uncubo sólo en un entorno de desarrollo mientras intenta determinar la configuraciónóptima del cubo:v El servidor requiere importantes recursos de memoria para volver a configurar

el orden de las dimensiones de un cubo. Durante el proceso de reorganización,


la memoria RAM temporal del servidor se multiplica por dos en el cubo queestá reordenando. Por ejemplo, un cubo de 50 MB requiere 100 MB de RAMpara volver a configurarse.

v La reordenación coloca un bloqueo de lectura en el servidor, bloqueando todaslas solicitudes de los usuarios durante el proceso de reordenación.

Nota: Debe ser miembro del grupo ADMIN para poder optimizar el orden de lasdimensiones de los cubos. La opción de optimización sólo está disponible para loscubos de los servidores remotos; no podrá optimizar el orden de las dimensionesen los cubos de un servidor local. De igual forma, al optimizar el orden de lasdimensiones de un cubo, no debería mover las dimensiones de cadena desde laúltima posición, ni mover las dimensiones de cadena a la última posición.

Procedimiento1. En el panel de árbol de Server Explorer, seleccione el cubo que desee optimizar.2. Pulse Cubo, Reordenar dimensiones.

Se abrirá el cuadro de diálogo Optimizador del cubo.3. Seleccione una dimensión en el cuadro de lista Nuevo orden de las

dimensiones.4. Pulse las flechas que indican hacia arriba o hacia abajo para cambiar el orden

de la dimensión del cubo.5. Pulse Probar.

Tenga en cuenta el valor que aparece junto a la etiqueta Cambio en elporcentaje. Si este valor es negativo, el nuevo orden de las dimensiones utilizamenos memoria y, por lo tanto, es más eficaz.

6. Repita los pasos 3 a 5 hasta que logre el orden de las dimensiones más eficaz.7. Pulse Aceptar.

Cuadro de diálogo Propiedades del cuboUtilice el cuadro de diálogo Propiedades del cubo para establecer las propiedadesde los cubos individuales.

Campo Descripción

Dimensión de medidas Seleccione una dimensión de medidas de lalista.

Dimensión de tiempo Seleccione una dimensión de tiempo de lalista.

Cargar a petición Seleccione la casilla para cargar el cubo en lamemoria del servidor únicamente cuando uncliente solicite los datos del cubo. Desactivela casilla para cargar el cubo de formaautomática cuando se inicie el servidor.

Cube Viewer

Dimensiones de título

Las dimensiones de título aparecen directamente junto a la barra de herramientasen la parte superior de la ventana Cube Viewer. Cada dimensión aparecerá en uncuadro de lista.


Dimensiones de fila

Las dimensiones de fila aparecerán en la parte superior del eje de filas de CubeViewer. Los elementos de dimensiones actuales aparecerán como cabeceras de filaen Cube Viewer.

Dimensiones de columna

Las dimensiones de columna aparecerán en la parte izquierda del eje de columnasde Cube Viewer. Los elementos de dimensiones actuales aparecerán comocabeceras de columna en Cube Viewer.

Menú ArchivoLas siguientes opciones están disponibles en el menú Archivo de Cube Viewer.


Abrir Abre el cuadro de diálogo Abrir Vista deTM1 , en el que podrá abrir otras vistasrelacionadas con el cubo actual.

Recargar Vuelve a cargar la definición de vista actual.

Calcular Calcula la vista actual.

Guardar Guarda la configuración de vista actual.

Guardar como Guarda la configuración de vista actual conun nuevo nombre.

Borrar vistas Abre el cuadro de diálogo Borrar vistas connombre, en el que puede borrar vistasguardadas.

Sección Exporta la vista actual a una hoja de trabajode Excel. La hoja de trabajo de Excel se llenade fórmulas que recuperan y escribenvalores en el servidor en el que se origina lavista.

Formulario activo Lanza la opción Insertar formulario activopara que pueda añadir una conexión deFormulario activo a los datos de la celdaactual de la hoja de trabajo.

Instantánea Exporta la vista actual a una hoja de trabajode Excel como valores simples. La hoja detrabajo no mantiene ninguna conexión con elservidor en el que se origina la vista.

Cerrar Cierra la ventana Cube Viewer.


Menú EditarLas siguientes opciones están disponibles en el menú Editar de Cube Viewer.


Deshacer acción Deshace la última acción de celda. Guardaro Cerrar finalizan la colección de accionesque pueden deshacerse o volver a realizarse.

Rehacer restaura la última acción de celda.

Cortar Corta el contenido de las celdasseleccionadas y lo coloca en el portapapeles.

Copiar Copia el contenido de las celdasseleccionadas, con el formato actual, en elportapapeles.

Copiar valor sin formato Copia el contenido sin formato de las celdasseleccionadas en el portapapeles.

Pegar Pega el contenido del portapapeles en lasceldas seleccionadas.

Borrar Borra los valores de celda seleccionados.

Editar atributos de cubo Abre la ventana Editor de atributos, en laque puede asignar y editar atributos detodos los cubos en el servidor actual.

Menú VerLas siguientes opciones están disponibles en el menú Ver de Cube Viewer.


Barra de herramientas Oculta o muestra la barra de herramientasen la parte superior de Cube Viewer. Unamarca de selección indica que se muestra labarra de herramientas.

Barra de estado Oculta o muestra la barra de estado en laparte inferior de Cube Viewer. Una marca deselección indica que se muestra la barra deestado.

De derecha a izquierda Este botón de alternar cambia la posición delas dimensiones de columna de CubeViewer.

Una flecha hacia la derecha indica que lascolumnas están distribuidas de derecha aizquierda. Una flecha hacia la izquierdaindica que las columnas están distribuidasde izquierda a derecha.


Menú OpcionesLas siguientes opciones están disponibles en el menú Opciones de Cube Viewer


Suprimir ceros Esta opción suprime o muestra todas lasfilas y columnas que contienen sólo valorescero en la vista del cubo. Una marca deselección indica que las filas y columnas quecontienen sólo ceros se suprimen de la vistaactual.

Suprimir ceros en las filas Esta opción suprime o muestra todas lasfilas que contienen sólo valores cero en lavista del cubo. Una marca de selecciónindica que las filas que contienen sólo cerosse suprimen de la vista actual.

Suprimir ceros en las columnas Esta opción suprime o muestra todas lascolumnas que contienen sólo valores cero enla vista del cubo. Una marca de selecciónindica que las columnas que contienen sóloceros se suprimen de la vista actual.

Recalcular automáticamente Esta opción activa o desactiva la acción devolver a calcular automáticamente tras lareconfiguración de la vista. Una marca deselección indica que la vista se recalculaautomáticamente cuando cambia laconfiguración de la vista.

Formato Abre el cuadro de diálogo Formatonumérico, en el que puede definir el formatonumérico de los valores de la vista actual.Tenga en cuenta que el formato queseleccione se aplicará únicamente a losvalores en los que no se especifique elatributo Formato.

Anchura de columna Abre el cuadro de diálogo Ancho decolumna, que le permite establecer unaanchura mínima y máximo para lascolumnas de Cube Viewer.

Sección en un nuevo libro de trabajo Esta opción determina cómo se crean lassecciones.

Una marca de selección indica que lassecciones se insertan en un nuevo libro detrabajo al seleccionar Archivo, Sección.

Si no activa esta opción, las secciones seinsertarán en una nueva hoja del libro detrabajo actual.

Cuadro de diálogo Borrar subconjuntos con nombreEste cuadro de diálogo muestra los subconjuntos relacionados con la dimensiónactual. Para eliminar un subconjunto, seleccione el subconjunto y pulse Aceptar.

Para seleccionar varios subconjuntos adyacentes, pulse y arrastre los subconjuntos.Para seleccionar varios subconjuntos no adyacentes, pulse la tecla CTRL y pulsecada subconjunto.


Cuadro de diálogo Borrar vistas con nombreEste cuadro de diálogo muestra las vistas relacionadas con el cubo actual. Paraeliminar una vista, seleccione la vista y pulse Aceptar.

Para seleccionar varias vistas adyacentes, pulse y arrastre las vistas. Paraseleccionar varias vistas no adyacentes, pulse la tecla CTRL y pulse cada vista.

Editor de dimensiones

Panel Elementos

Muestra los elementos de la dimensión que está visualizando actualmente.

Panel Propiedades

Al seleccionar un elemento consolidado en el panel Elementos, el panelPropiedades mostrará las propiedades de los hijos inmediatos del elementoconsolidado.

Al seleccionar un elemento de hoja, el panel Propiedades mostrará las propiedadesdel elemento de hoja.

Nota: Al visualizar un conjunto de dimensiones excepcionalmente grande en elEditor de dimensiones con el panel Propiedades activado, es posible que tengaproblemas de rendimiento. Esto puede ocurrir cuando selecciona una consolidaciónen el panel Elementos y TM1 debe mostrar toda la lista de propiedades yelementos relacionados en el panel Propiedades.

Si trabaja con conjuntos de dimensiones grandes, es posible que desee desactivar elpanel Propiedades. Para desactivar el panel Propiedades, pulse la opción Ventanade propiedades en el menú Ver para eliminar la marca de selección situada junto ala opción.

Menú Dimensión


Guardar Guarda la estructura de dimensiones actual.

Guardar como Guarda la estructura de dimensiones actualcon un nuevo nombre.

Cerrar Cierra el Editor de dimensiones.

Menú Editar


Cortar Corta los elementos seleccionados y loscoloca en el portapapeles.

Copiar Copia los elementos seleccionados en elportapapeles.



Pegar Pega el contenido del portapapeles como unnuevo elemento.

v Cuando no seleccione ningún elemento enel Editor de dimensiones, esta opcióninsertará un nuevo elemento encima delprimer elemento seleccionado en el panelElementos.

v Al seleccionar un elemento en el panelElementos, esta opción mostrará un menúsecundario con las opciones Pegar porencima, Pegar como hijo y Pegar pordebajo.

Pegar por encima Pega el contenido del portapapeles encimade un elemento seleccionado.

Pegar por debajo Pega el contenido del portapapeles debajode un elemento seleccionado.

Pegar como hijo Pega el contenido del portapapeles comohijo de un elemento seleccionado.

Insertar hijo Abre el cuadro de diálogo Insertar elementosde dimensiones, en el que puede insertar unhijo o varios hijos de un elementoseleccionado.

Insertar elemento Abre el cuadro de diálogo Insertar elementosde dimensiones, en el que puede insertarelementos de hoja (simples) en la dimensión.

Seleccionar todo Selecciona todos los elementos del panelElementos.

Filtro por, nivel Abre el cuadro de diálogo Filtro por nivel,en el que puede seleccionar elementos pornivel jerárquico.

Esta opción afecta únicamente a lavisualización de los elementos, no afecta a laestructura de dimensiones. Al utilizar estaopción, el panel Elementos mostraráúnicamente los elementos del nivel que hayaespecificado.

Filtro por, atributo Abre el cuadro de diálogo Filtro poratributo, en el que puede seleccionarelementos por valor de atributo.

Esta opción afecta únicamente a lavisualización de los elementos, no afecta a laestructura de dimensiones. Al utilizar estaopción, el panel Elementos mostraráúnicamente los elementos con el valor deatributo que haya especificado.



Filtro por, comodín Le permite seleccionar elementos quecoincidan con una expresión de búsquedadefinida por el usuario.

Esta opción afecta únicamente a lavisualización de los elementos, no afecta a laestructura de dimensiones. Al utilizar estaopción, el panel Elementos mostraráúnicamente los elementos que coincidan conla expresión de búsqueda que hayaespecificado.

Seleccionar alias Abre el cuadro de diálogo Alias de TM1 , enel que puede seleccionar un alias para queaparezca en el Editor de dimensiones.

Orden, ascendente Clasifica todos los elementos del panelElementos en orden alfabético ascendente.

Esta opción afecta únicamente a lavisualización de los elementos, no afecta a laestructura de dimensiones.

Orden, descendente Clasifica todos los elementos del panelElementos en orden alfabético descendente.


Orden, Jerarquía Ordena todos los elementos del panelElementos en orden jerárquico, para quepueda ver la relación padre/hijo de loselementos.


Orden, Índice ascendente Ordena todos los elementos del panelElementos en orden ascendente según elvalor de índice del elemento.


Orden, Índice descendente Ordena todos los elementos del panelElementos en orden descendente según elvalor de índice del elemento.




Mantener Modifica el panel Elementos para que sóloaparezcan los elementos seleccionadosactualmente.


Ocultar Modifica el panel Elementos para que seoculten los elementos seleccionadosactualmente.


Borrar elemento Borra todas las instancias de un elementoseleccionado en la dimensión.

Borrar desde la consolidación Borra la instancia de un elementoseleccionado en la consolidación actual.

Editar formatos de elementos Abre la hoja de trabajo Editar formatos deelementos, en la que puede definir estilos devisualización de elementos. Estos estilos devisualización se aplican a seccionesdinámicas y a hojas web de TM1 Web .

Desplegar elemento Muestra todos los hijos de un elementoseleccionado.

Contraer elemento Oculta todos los hijos de un elementoseleccionado.

Propiedades Abre el cuadro de diálogo Propiedades deelementos de dimensiones, en el que puedeasignar el tipo de elemento y el peso de unelemento seleccionado.

Menú Ver


Barras de herramientas Oculta o muestra las distintas barras deherramientas en la parte superior de laventana Editor de dimensiones. Una marcade selección indica que se muestra una barrade herramientas.

Barra de estado Oculta o muestra la barra de estado en laparte inferior de la ventana Editor dedimensiones. Una marca de selección indicaque se muestra la barra de estado.



Ventana Propiedades Oculta o muestra el panel Propiedades. Unamarca de selección indica que se muestra elpanel Propiedades.

Actualizar Actualiza la visualización del panelElementos.

Cuadro de diálogo Insertar elementos de dimensionesUtilice este cuadro de diálogo para añadir elementos simples, de cadena oconsolidados a una dimensión. El cuadro de diálogo contiene las siguientesopciones.


Nombre de dimensión Nombre de la dimensión a la que añade loselementos. No es una opción editable.

Nombre de padre Nombre del elemento padre al que añade loselementos. No es una opción editable.

Si seleccionó un elemento en el Editor dedimensiones al abrir el cuadro de diálogoInsertar elementos de dimensiones, dichoelemento aparecerá como Nombre de padre.Si no seleccionó ningún elemento, el nombrede padre es Root.

Insertar nombre del elemento Introduzca un nombre para el nuevoelemento en este cuadro.

Tipo de elementos Realice una selección adecuada del elementoque desee insertar.

Peso del elemento Si el tipo de elemento es Simple y el nombrede padre es cualquier otro que no sea Root,introduzca un peso en este cuadro. El pesoes un factor de multiplicación que se aplicaa un elemento durante la consolidación.

Un peso relacionado con un elemento deuna consolidación no modifica el valor delelemento en ninguna otra parte de ladimensión.

Añadir Pulse Añadir cada vez que especifique unnuevo elemento, tipo y peso.

Aceptar Pulse este botón cuando termine de añadirlos elementos para asignar los nuevoselementos a la dimensión.

Cuadro de diálogo Ordenar elementos de dimensionesUtilice este cuadro de diálogo para establecer el orden de los elementos de unadimensión.

El orden de los elementos de una dimensión determina el valor de índice de todoslos elementos de la dimensión. El primer elemento de una dimensión tiene unvalor de índice de 1, el segundo elemento tiene un valor de índice de 2, etc. El


orden de los elementos de una dimensión es importante, ya que muchas funcionesde TM1 (hoja de trabajo, reglas y TurboIntegrator) hacen referencia a valores deíndice de los elementos.

Nota: Si cambia el orden de los elementos de una dimensión, las funciones quehagan referencia a valores de índice de elementos devolverán nuevos valoresposiblemente inesperados.

Siga estos pasos para establecer el orden de los elementos.

Procedimiento1. Seleccione un tipo de ordenación.

Tipo Descripción

Automático Activa las opciones de ordenaciónautomática por nombre, nivel y jerarquía.

Manual Ordena los elementos de la forma en queaparecen actualmente en la estructura dedimensiones y establece la propiedad deordenación de la dimensión en manual.

2. Si ha seleccionado el tipo de ordenación manual, siga con el paso 5.3. Seleccione una opción de Ordenar automáticamente por.

Tipo Descripción

Nombre Clasifica los elementos en orden alfabético

Nivel Clasifica los elementos por orden jerárquico.

Jerarquía Ordena los elementos según la jerarquía dela dimensión.

4. Si es necesario, seleccione una Dirección del orden.5. Pulse Aceptar.

Ya ha establecido el orden de los elementos de la dimensión. Al abrir ladimensión, verá los elementos en orden según la clasificación por opción queespecificó en el paso 3.

Resultados

Ya ha establecido el orden de los elementos de la dimensión. Al abrir la dimensión,verá los elementos en orden según la clasificación por opción que especificó en elpaso 3.

Cuadro de diálogo Propiedades de elementos de dimensionesMuestra el nombre, tipo y peso del elemento actual.


Panel Propiedades

Opciones Descripción

Tipo de elementos Para cambiar el tipo de elemento actual,seleccione un nuevo tipo en la lista. Existentres tipos de elementos posibles: simples,consolidados y de cadena.

Peso del elemento Para cambiar el peso del elemento actual,efectúe una doble pulsación en el campoPeso del elemento e introduzca un nuevovalor de peso.

Ver los detallesEl menú Ver los detalles enumera las opciones que se utilizan para crear ygestionar un proceso de obtención de detalles y una asignación de detalles. Losprocesos de obtención de detalles y las asignaciones de detalles se utilizan paracrear enlaces entre las celdas del cubo y los datos detallados relacionados.

Opciones Descripción

Crear/editar/eliminar reglas de asignaciónde detalles

Seleccione estas opciones para crear, editar oeliminar asignaciones de detalles. La opciónCrear abre el editor de reglas para quepueda diseñar la regla.

Crear/editar proceso de obtención dedetalles

Un proceso de obtención de detalles es unproceso de TurboIntegrator que define losdatos detallados, que se abren en una nuevaventana. Estas opciones editan una regla deasignación de detalles existente o lepermiten crear una nueva. Las opcionesCrear muestran los parámetros y los valoresque se utilizarán y los detalles del origen dedatos. Si cambia el origen de datos de unproceso de obtención de detalles,TurboIntegrator no actualiza la función conel nuevo origen de datos dado que lafunción está fuera del área Sentenciasgeneradas. Debe editar el origen de datos dela vista del cubo en la funciónReturnViewHandle del proceso de obtenciónde detalles.

Cuadro de diálogo Editar fórmulaEl cuadro de diálogo Editar fórmula le guía a través del proceso de creación de lasfunciones DBR, DBRW y DBS. También puede utilizar el cuadro de diálogo Editarfórmula para editar cualquier función TM1 en una hoja de trabajo.

Para mostrar el cuadro de diálogo Editar fórmula, pulse una celda de una hoja detrabajo y seleccione TM1 , Editar fórmula. Si la celda contiene una función TM1 ,la función aparecerá en el campo de entrada del cuadro de diálogo.


Campo Descripción

DB Ref Pulse este botón para insertar una funciónDBR en la celda actual. TM1 le guía a travésde varios cuadros de diálogo que leayudarán a crear la función.

DBRW Pulse este botón para insertar una funciónDBRW en la celda actual. TM1 le guía através de varios cuadros de diálogo que leayudarán a crear la función.

DB Send Pulse este botón para insertar una funciónDBS en la celda actual. TM1 le guía a travésde varios cuadros de diálogo que leayudarán a crear la función.

Ref. de celda Pulse este botón para insertar una referenciade celda en una función. TM1 le solicitaráque seleccione la celda a la que deseereferirse, y le solicitará un tipo de referencia.

Nombres Pulse este botón para insertar un nombre decubo, dimensión o elemento en una función

El editor de fórmulas puede utilizarse para crear funciones que hagan referencia acubos de hasta 29 dimensiones.

Cuadro de diálogo Editar referencia al cuboEste cuadro de diálogo le permite establecer las referencias de elementos que seutilizan en las funciones de las hojas de trabajo TM1 , tales como DBRW y DBSW.

El cuadro de diálogo contiene botones y campos que corresponden a cadadimensión del cubo al que hace referencia la función de hoja de trabajo TM1 . Porejemplo, la siguiente imagen muestra el cuadro de diálogo Editar referencia al cubode una función DBRW que hace referencia al cubo SalesCube de la base de datosde muestra TM1 . El cuadro de diálogo incluye botones de todas las dimensionesdel cubo SalesCube.

Al insertar una función TM1 en una hoja de trabajo, TM1 intentará determinar siexiste alguna referencia de elemento relevante en la hoja de trabajo. Si es el caso,dichas referencias se insertan automáticamente en los campos adecuados en elcuadro de diálogo Editar referencia al cubo. Si las referencias de elementosrelevantes no se pueden determinar, TM1 insertará "Undef" en los campos.

Puede establecer referencias en este cuadro de diálogo de uno de los siguientesmodos:v pulsando un botón de dimensión y seleccionando un elemento. En este caso, la

referencia se inserta como una cadena en el campo adecuado.v introduciendo una referencia de celda directamente en un campo. Puede utilizar

referencias de celda relativas a filas, relativas a columnas o absolutas.


Si el cubo en el que está creando una referencia contiene más de 16 dimensiones,pulse Anterior para volver a las páginas de las 16 dimensiones anteriores, o pulseSiguiente para ir a las páginas de las 16 dimensiones siguientes.

Cuadro de diálogo Filtrar elementos por atributoUtilice este cuadro de diálogo para seleccionar sólo los elementos de subconjuntosque tengan un valor de atributo específico.

Seleccione el atributo deseado en la lista Seleccionar un atributo.

Seleccione un valor correspondiente en la lista Seleccionar un valor.

Cuadro de diálogo Filtrar elementos por nivelEl cuadro de lista muestra los niveles jerárquicos disponibles en el subconjuntoactual. Para ver sólo los elementos de un nivel determinado, seleccione el nivel ypulse Aceptar.

Para seleccionar varios niveles adyacentes, pulse y arrastre los niveles. Paraseleccionar varios niveles no adyacentes, pulse la tecla CTRL y pulse cada nivel.

Cuadro de diálogo Filtrar subconjuntoEl cuadro de diálogo Filtrar subconjunto le permite crear un subconjunto dinámicosegún los valores de un cubo específico. Por ejemplo, puede crear un subconjuntode la dimensión Region que devuelve los 10 elementos con los mayores valores deventas reales anuales de 1.8L Sedan en el cubo Sales.

El cuadro de diálogo contiene las siguientes opciones.


CubeName El cubo en el que desea filtrar los valores.



Filtro El tipo de filtro que desea aplicar a la vistaactual.

TopCount

Filtra el subconjunto para devolversólo los n elementos mayores,donde n es un número especificadoen la opción Valor.

BottomCount

Filtra el subconjunto para devolversólo los n elementos menores,donde n es un número especificadoen la opción Valor.

TopSum

Filtra el subconjunto para devolversólo los elementos mayores cuyasuma sea mayor o igual que n,donde n es un número especificadoen la opción Valor.

BottomSum

Filtra el subconjunto para devolversólo los elementos menores cuyasuma sea mayor o igual que n,donde n es un número especificadoen la opción Valor.

TopPercent

Filtra el subconjunto para devolversólo los elementos mayores cuyasuma sea mayor o igual que n,donde n es un porcentaje del totalde una dimensión especificado enla opción Valor.

BottomPercent

Filtra el subconjunto para devolversólo los elementos menores cuyasuma sea mayor o igual que n,donde n es un porcentaje del totalde una dimensión especificado enla opción Valor.

Ninguno

No se aplica al filtrado desubconjuntos.

Valor Un valor para el tipo de Filtro.

Seleccionar elemento de columna Los elementos de columna a los que seaplica el filtro o la ordenación. Pulse losbotones de dimensión para seleccionar unúnico elemento para cada dimensión decolumna.



Ordenar El orden de clasificación que desea aplicar alos elementos de columna seleccionados.

Ascendente

Ordena los valores de los elementosde columna especificados de menora mayor.

Descendente

Ordena los valores de los elementosde columna especificados de mayora menor.

Ninguno

Sin orden de clasificación.

Seleccionar elementos de columna Debe seleccionar un único elemento en cadadimensión de cubo restante. Por ejemplo, sifiltra la dimensión Region en la base dedatos de muestra en los valores del cuboSales, debe especificar un único elemento encada dimensión Model, Month, ActVsBud yAccount1.

En cada dimensión, pulse el botón adecuadoy seleccione un único elemento.

Si el cubo contiene más de 16 dimensiones,

pulse para retroceder las páginasnecesarias hasta las 16 dimensiones

anteriores, o pulse para adelantar laspáginas hasta las 16 dimensiones siguientes.

Cuadro de diálogo Filtrar vistaEl cuadro de diálogo Filtrar vista le permite filtrar y ordenar columnas en CubeViewer o el Navegador de hojas de cálculo.

El cuadro de diálogo contiene las siguientes opciones.

Opción Filtro/Descripción

CubeName El cubo en el que desea filtrar u ordenar losvalores. Esta opción siempre se establece enel cubo relacionado con la vista actual. Nose puede editar.

Filtro El tipo de filtro que desea aplicar a la vistaactual.

TopCount

Filtra la vista para mostrar sólo los nelementos mayores, donde n es un númeroespecificado en la opción Valor.


Opción Filtro/Descripción

BottomCount

Filtra la vista para mostrar sólo los nelementos menores, donde n es un númeroespecificado en la opción Valor.

TopSum

Filtra la vista para mostrar sólo loselementos más grandes cuya suma seamayor o igual que n, donde n es un númeroespecificado en la opción Valor.

BottomSum

Filtra la vista para mostrar sólo loselementos más pequeños cuya suma seamayor o igual que n, cuando n es unnúmero especificado en la opción Valor.

TopPercent

Filtra la vista para mostrar sólo loselementos más grandes cuya suma seamayor o igual que n, cuando n es unporcentaje del total de una dimensiónespecificado en la opción Valor.

BottomPercent

Filtra la vista para mostrar sólo loselementos más pequeños cuya suma seamayor o igual que n, cuando n es unporcentaje del total de una dimensiónespecificado en la opción Valor.

Ninguno

Sin filtro. Seleccione esta opción si deseaordenar los valores sin filtrarlos.

Valor Un valor para el tipo de Filtro.

Seleccionar elemento de columna Los elementos de columna a los que seaplica el filtro o la ordenación. Pulse losbotones de dimensión para seleccionar unúnico elemento para cada dimensión decolumna.

Ordenar El orden de clasificación que desea aplicar alos elementos de columna seleccionados.

Ascendente

Ordena los valores de los elementos decolumna especificados de menor a mayor.

Descendente

Ordena los valores de los elementos decolumna especificados de mayor a menor.

Ninguno

Sin orden de clasificación.


Cuadro de diálogo Obtener vista (Navegador de hojas de cálculo)El cuadro de diálogo Obtener vista le permite abrir una vista en el servidor local oen cualquier servidor disponible en la red.

Campo Descripción

Servidor La lista Servidor muestra todos losservidores disponibles en la red. Seleccioneel servidor en el que está ubicada la vistaque desee abrir.

Si no ha iniciado sesión en el servidor quecontiene la vista que desea abrir, pulseConectar para abrir el cuadro de diálogoConectar servidor e inicie la sesión en elservidor. Pulse Iniciar el servidor local parainiciar el servidor local.

Cubo La lista Cubos muestra todos los cubosdisponibles en el servidor seleccionado.Seleccione el cubo relacionado con la vistaque desee abrir.

Vista La lista Vista mostrará todas las vistasdisponibles en el cubo seleccionado.Seleccione la vista que desee abrir.

Menú Navegador de hojas de cálculoEl menú Navegador de hojas de cálculo está disponible al pulsar con el botónderecho del ratón en Control de vista TM1 . El menú le permite abrir, actualizar,dar formato, dividir y guardar una vista. También incluye varias opciones quecontrolan el comportamiento del Navegador de hojas de cálculo.


Actualizar vista Actualiza la vista actual enviando los valores editados a la base dedatos TM1 y recuperando los valores actuales de la base de datos.

Obtener vista Abre el cuadro de diálogo Obtener vista, en el que puede abrir unavista en cualquier servidor disponible.

Estilos Abre el cuadro de diálogo Estilos de vista, que le permite dar formatoa una vista.

Guardar Abre el cuadro de diálogo Guardar vista, que le permite guardar unavista TM1 .

Borrar pantalla Borra todos los datos relacionados con una vista, incluidas lasetiquetas de columna, fila y título.

Borrar Borra el Control de vista TM1 . Tenga en cuenta que todos los datosrelacionados con la vista, incluidos los valores y las etiquetas,permanecerán en la hoja de cálculo.

Cortar Corta el Control de vista TM1 y lo coloca en el portapapeles.



Copiar Corta el Control de vista TM1 y lo coloca en el portapapeles.

Sección Secciona la vista actual en una nueva hoja de cálculo de Excel.

Suprimir ceros Este botón de alternar suprime o muestra valores cero en la vista delcubo. Una marca de selección indica que los ceros se suprimen en lavista actual.

Mostrarautomáticamente

Este botón de alternar activa o desactiva la actualización automáticade la vista tras la reconfiguración de la vista. Una marca de selecciónindica que la vista se actualiza automáticamente cuando cambia laconfiguración de la vista.

Actualizar vista derecálculo

Este botón de alternar activa o desactiva la actualización automáticade la vista tras volver a calcular la hoja de cálculo (F9). Una marca deselección indica que la vista se actualiza cuando se vuelve a calcularla hoja de cálculo.

Ayuda Abra la ayuda del Navegador de hojas de cálculo.

Ventana Registro de mensajesLa ventana Registro de mensajes TM1 muestra los mensajes de estado sobre laactividad del servidor. Estos mensajes se guardan en el registro de mensajes delservidor y contienen información sobre actividades, como por ejemplo procesosejecutados, tareas, dimensiones y cubos cargados y réplica sincronizada.

Para obtener más información sobre el registro de mensajes del servidor, consultela publicación IBM Cognos TM1 Guía de operaciones.

Panel Registro de mensajes

Este panel muestra mensajes de estado que se incluyen en el registro de mensajesdel servidor.

Cada fila del panel representa un único mensaje. Si un mensaje del registromuestra un estado de error en una réplica o proceso ejecutado, puede efectuar unadoble pulsación en el mensaje para ver la información acerca de por qué laactividad generó el error.

Para obtener más información sobre los campos del panel Registro de mensajes,consulte la guía de operaciones de IBM Cognos TM1 .

Menú Archivo


Salir Cierra la ventana Registro de mensajes.


Menú Editar


Copiar Copia el texto seleccionado del panelRegistro de mensajes en el portapapeles.

Buscar Abre el cuadro de diálogo Buscar, en el quepuede buscar texto en el panel Registro demensajes.

Menú Ayuda


Ayuda del registro de mensajes Abre la ayuda del registro de mensajes.

Contenido e índice Abre la Biblioteca de documentación TM1completa.

Cuadro de diálogo Nuevo atributo

Campo Descripción

Nombre del nuevo atributo Introduzca un nombre para el nuevoatributo en este campo.

Numérico Seleccione esta opción si los valores deatributo son números.

Cadena Seleccione esta opción si los valores deatributo son cadenas de caracteres.

Alias Seleccione esta opción si los valores deatributo son nombres alternativos a losnombres de elemento, dimensión, cubo oservidor actuales.

Cuadro de diálogo Abrir subconjuntoUtilice el cuadro de diálogo Abrir subconjunto para abrir un subconjunto dedimensiones existente.

Para abrir el subconjunto predeterminado público, seleccione el cuadroPredeterminado y pulse Abrir.

Cuadro de diálogo Abrir vistaUtilice el cuadro de diálogo Abrir vista para abrir una vista de cubo existente.

Para abrir la vista predeterminada pública, seleccione el cuadro Predeterminado ypulse Abrir.


Asistente de informes de impresiónUtilice el Asistente de informes de impresión para crear informes al estilo "libro dereferencia" a partir de secciones TM1 .

El Asistente consta de tres pantallas.v Pantalla 1: seleccione las hojas que se van a incluir en el informev Pantalla 2: seleccione las dimensiones de título que va a utilizar en el informe,

establezca el orden en el que aparecen en el informe y las opciones de impresióndel libro de trabajo

v Pantalla 3: seleccione un destino de impresión para el informe (impresora,archivo de Excel o archivo PDF)

El Asistente de informes de impresión también le permite guardar los valores delinforme.

Todas las pantallas

Botón Descripción

Cargar Pulse este botón para cargar un trabajo deimpresión TM1 existente.

Guardar Pulse este botón para guardar los valoresactuales del informe como trabajo deimpresión TM1 .

Guardar como Pulse este botón para guardar los valoresactuales del informe como trabajo deimpresión TM1 con un nuevo nombre.

Siguiente Pulse este botón para avanzar hasta lasiguiente pantalla del Asistente.

Cancelar Pulse este botón para cerrar la ventanaAsistente sin crear ningún informe.

Pantalla 1 de 3

Elemento Descripción

Incluya estas hojas en la lista de informes Enumera las hojas de trabajo disponibles dellibro de trabajo de Excel que puede incluiren el informe.

Para incluir una hoja de trabajo en elinforme, seleccione la casilla de verificaciónque aparece junto al nombre de la hoja.

Seleccionar todo Pulse este botón para incluir todas las hojasen el informe.

Borrar todo Pulse este botón para excluir todas las hojasdel informe.


Pantalla 2 de 3


Lista Dimensiones de título disponibles Enumera las dimensiones de títulodisponibles que puede utilizar en el informe.

En cada dimensión, esta lista muestra elnombre del subconjunto (si procede), elnúmero de elementos de la dimensión o delsubconjunto y la dirección de celda de ladimensión de título de la hoja de trabajo.

Lista Dimensiones de título seleccionadas Enumera las dimensiones de título que va aincluir en el informe.

El orden de esta lista se utiliza cuando TM1crea el informe.

Añadir Pulse este botón para mover las dimensionesseleccionadas de la lista Dimensiones detítulo disponibles a la lista Dimensiones detítulo seleccionadas.

Añadir todo Pulse este botón para mover todas lasdimensiones de la lista Dimensiones detítulo disponibles a la lista Dimensiones detítulo seleccionadas.

Eliminar Pulse este botón para mover las dimensionesseleccionadas de la lista Dimensiones detítulo seleccionadas a la lista Dimensiones detítulo disponibles.

Eliminar todo Pulse este botón para mover todas lasdimensiones de la lista Dimensiones detítulo seleccionadas a la lista Dimensiones detítulo disponibles.

Subir Pulse este botón para subir la dimensión enla lista Dimensiones de título seleccionadas.El orden de esta lista se utiliza cuando TM1crea el informe.

Bajar Pulse este botón para bajar la dimensión enla lista Dimensiones de título seleccionadas.El orden de esta lista se utiliza cuando TM1crea el informe.

Editor de subconjuntos Pulse este botón para abrir el Editor desubconjuntos si desea seleccionar unsubconjunto de elementos de la dimensiónseleccionada actualmente en la listaDimensiones de título seleccionadas.



Imprimir un solo libro de trabajo Seleccione esta opción para crear un informeorganizado en un grupo completo de hojasde trabajo.

Cada hoja del informe se imprime una solavez, incluidas las hojas que no contienendatos de sección TM1 .

Imprimir varios libros de trabajo Seleccione esta opción para crear un informeorganizado en varios grupos según loselementos de dimensiones.

Esta opción crea un informe con un mayornúmero de hojas, ya que se imprime unacopia de cada hoja para cada elemento detítulo.

Número total de libros de trabajo de Excelque se van a crear

Muestra el número total de hojas de Excelque TM1 creará en el informe actual.

Pantalla 3 de 3

Campo Descripción

Imprimir en impresora Seleccione esta opción si desea imprimir elinforme en una impresora.

Guardar como archivos Excel Seleccione esta opción si desea crear elinforme como archivo de Excel.

Guardar como archivos PDF Seleccione esta opción si desea crear elinforme como archivo PDF.

Vista previa Este botón está disponible al seleccionar laopción Imprimir en impresora.

Pulse este botón para previsualizar elinforme antes de imprimirlo.

Nombre de impresora Esta opción está disponible al seleccionar laopción Imprimir en impresora.

Utilice esta opción para especificar laimpresora en la que TM1 imprime elinforme.

Número de copias Esta opción está disponible al seleccionar laopción Imprimir en impresora.

Utilice esta opción para especificar elnúmero de copias del informe que se van aimprimir.


Campo Descripción

Imprimir en archivo Esta opción está disponible al seleccionar laopción Imprimir en impresora.

Seleccione esta opción para guardar elinforme como archivo listo para imprimir.

Nombre de archivo Esta opción está disponible al seleccionar lasopciones Imprimir en impresora e Imprimiren archivo.

Introduzca una ruta completa y un nombrede archivo en el que desee guardar elinforme. También debe especificar un tipode archivo. Por ejemplo, si imprime unarchivo utilizando una impresora PostScript,debe añadir el tipo de archivo .ps al nombredel archivo.

Examinar Este botón está disponible al seleccionar laopción imprimir o guardar el informe en unarchivo.

Pulse este botón para seleccionar eldirectorio en el que desea guardar elinforme.

Intercalar Esta opción está disponible al seleccionar laopción Imprimir en impresora.

Seleccione esta opción para agrupar páginasal imprimir varias copias del informe.

Crear nuevo libro de trabajo para cada título Esta opción está disponible al elegir guardarel informe como archivo de Excel o PDF.

Seleccione esta opción si desea crear unarchivo independiente en cada dimensión detítulo del informe.

Nombre de directorio Esta opción está disponible al guardar uninforme como archivo de Excel o PDF yseleccionar la opción Crear nuevo libro detrabajo para cada título.

Introduzca un directorio en el que deseeguardar los archivos del informe. Paraseleccionar una ubicación de directorio,pulse el botón Examinar.

Crear instantánea Esta opción está disponible al seleccionar laopción Guardar como archivos Excel.

Seleccione esta opción cuando desee guardarel informe como archivo de Excel quecontiene valores reales y no funciones TM1que recuperan valores.


Campo Descripción

Retroceder Pulse este botón para retroceder hasta laanterior pantalla del Asistente.

Finalizar Pulse este botón para crear el informe segúnlas opciones que haya seleccionado.

Cuadro de diálogo Opciones de procesoUtilice el cuadro de diálogo Opciones de proceso para controlar el comportamientodel botón de acción antes y después de la ejecución del proceso.

Puede utilizar uno de los siguientes métodos para establecer el texto deconfirmación y los mensajes de estado que aparecerán al pulsar el botón de Acción:v Introduzca el texto del mensaje directamente en el cuadro de texto.v Utilice una referencia de Excel para recuperar dinámicamente el texto de un

mensaje de la hoja de trabajo.

Por ejemplo, para recuperar el texto de un mensaje del contenido de la celda A1,introduzca =A1 en el cuadro de texto de dicho mensaje. Para hacer referencia a unrango con nombre, utilice el formato: =Named Range.

Para obtener más información acerca de cómo utilizar el cuadro de diálogoOpciones de proceso, consulte la guía del desarrollador de IBM Cognos TM1 .

Campo Descripción

Recalcular hoja de forma automática Seleccione esta opción para que TM1recalcule de forma automática la hoja detrabajo tras la ejecución del proceso.

Mostrar mensaje de confirmación Seleccione esta opción para mostrar unmensaje después de que el proceso se hayaejecutado correctamente.

Introduzca el texto del mensaje en el cuadrotal y como se describe anteriormente.

Mostrar mensaje de error Seleccione esta opción para mostrar unmensaje si el proceso no se ejecutacorrectamente.


Mostrar cuadro de diálogo de confirmación Seleccione esta opción para mostrar elcuadro de mensaje de confirmación Sí/Noantes de que se inicie el proceso. El usuariopuede pulsar Sí para ejecutar el proceso oNo para cancelarlo.



Campo Descripción

Aceptar Pulse este botón para guardar los valores ycerrar el cuadro de diálogo.

Cancelar Pulse este botón para cerrar el cuadro dediálogo sin guardar los valores.

Cuadro de diálogo Replicar cuboUtilice el cuadro de diálogo Replicar cubo para replicar un cubo de un servidor deorigen en un servidor de destino.

Información del cubo


Nombre Nombre del cubo duplicado del servidor dedestino.

De forma predeterminada, TM1 nombra elcubo duplicado concatenando el nombre delservidor de origen con el nombre del cubode origen.

No cambie el nombre predeterminado si estáreplicando reglas en dicho cubo.

Copiar datos y configurar para sincronizar Seleccione esta opción para copiar datoscuando la réplica se establezca y parasincronizar datos cuando la sincronizacióntenga lugar entre los servidores de origen yde destino.

Copiar datos, pero no configurar parasincronizar

Seleccione esta opción para copiar datoscuando la réplica se establezca, y paradesactivar la sincronización de los datos mástarde.

Replicar vistas Seleccione esta opción para replicar todas lasvistas asociadas al cubo de origen.

Información de reglas


Copiar regla Seleccione esta opción para copiar las reglasdel cubo de origen en el cubo duplicado.



Establecer la regla para sincronizar Rellene este cuadro para sincronizar reglascuando la sincronización tenga lugar entrelos servidores de origen y destino.

Desactive este cuadro para desactivar lasincronización de la regla.

No copiar regla Si selecciona esta opción, TM1 no copia laregla del cubo de origen en el cuboduplicado.

Información de dimensiones


Cuadro Información de dimensiones Este cuadro muestra información acerca delas dimensiones del cubo duplicado.

Si el cubo de origen no contiene reglas, TM1volverá a nombrar las dimensiones deduplicado concatenando los nombres delservidor de origen con los nombres de ladimensión de origen.

Si el cubo de origen contiene reglas, TM1 nocambiará los nombres de las dimensionesdel cubo duplicado.

El cuadro Información de dimensionestambién muestra el nombre de la dimensiónde origen, el servidor de origen y el estadode réplica de cada dimensión del cubo.

Seleccionar dimensión local Para utilizar una dimensión local en lugarde una dimensión de origen, pulse ladimensión de origen del cuadro Informaciónde dimensiones y pulse Seleccionardimensión local. Seleccione la dimensiónlocal que desee utilizar y pulse Aceptar.

Restablecer la selección actual con losparámetros predeterminados

Si cambia alguna de las opciones deInformación de dimensiones para unadimensión en un cubo replicado, podrárestaurar los valores predeterminados detodas las opciones seleccionando ladimensión en el cuadro Información dedimensiones y pulsando este botón.

Sobrescribir dimensión Esta opción está disponible al seleccionaruna dimensión local.

Seleccione esta opción para sobrescribir ladimensión local con la definición de ladimensión de origen.



Establecer la dimensión para sincronizar Rellene este cuadro para sincronizar loscambios entre la dimensión de origen y deespejo cuando la sincronización tenga lugarentre los servidores de origen y de destino.

Elimine la selección de este cuadro paradesactivar la sincronización de la dimensión.

No sobrescribir dimensión Esta opción está disponible al seleccionaruna dimensión local.

Seleccione esta opción para utilizar ladimensión local tal cual.

Replicar subconjuntos Seleccione esta opción para replicar todos lossubconjuntos asociados a la dimensión deorigen.

Editor de reglasEl Editor de reglas tiene un completo conjunto de menús para crear, editar ygestionar reglas TM1 . Existen atajos del teclado para las opciones de menú másutilizadas.

Menú ArchivoLa siguiente tabla describe las opciones del menú Archivo.

Nombre Descripción

Importar Abre un cuadro de diálogo de exploraciónde archivos para que pueda seleccionar elarchivo de texto que desea importar. El textoimportado sustituirá la regla actual, si existealguna.

Guardar Guarda la regla actual en el servidor.

Guardar como Guarda la regla actual en un archivo .ruxexterno de reglas TM1 .

Comprobar sintaxis Comprueba la regla actual en busca deerrores de sintaxis.

imprimir Abre el cuadro de diálogo Imprimir paraque pueda imprimir la regla actual.

Imprimir vista previa Abre la ventana Imprimir vista previa, en laque puede ver una versión impresa demuestra de la regla antes de enviarla a unaimpresora.

Salir Cierra el Editor de reglas.


Menú EditarLa siguiente tabla describe las opciones del menú Editar.

Nombre Descripción

Deshacer Deshace la última edición.

Se soportan distintos niveles en "deshacer".

Rehacer Invierte el último comando deshacer.

Cortar Elimina el texto seleccionado y lo coloca enel portapapeles.

Copiar Copia el texto seleccionado en elportapapeles.

Pegar Pega el contenido del portapapeles en elEditor de reglas.

Seleccionar todo Selecciona todo el contenido del Editor dereglas.

Buscar Abre el cuadro de diálogo Buscar, en el quepuede buscar texto en la regla.

Buscar/Sustituir... Abre el cuadro de diálogo Buscar/Sustituirpara buscar y sustituir texto.

Buscar siguiente Localiza la siguiente aparición del texto queestá buscando.

Alternar marcador Activa o desactiva un marcador para la líneade código actual.

Siguiente marcador Mueve el cursor al siguiente marcadordisponible.

Marcador anterior Mueve el cursor al anterior marcadordisponible.

Borrar todos los marcadores Elimina todos los marcadores.

Selección de comentarios Añade un símbolo de comentario # delantede todas las líneas en el texto actualmenteseleccionado para excluir las líneas de laregla compilada.Nota: La longitud del comentario estálimitada a 255 bytes. En los juegos decaracteres occidentales, como por ejemplo elinglés, un único carácter se representa conun único byte, lo que le permite introducircomentarios con 255 caracteres. Sin embargo,los juegos de caracteres grandes, como porejemplo el chino, japonés y coreano, utilizanvarios bytes para representar un carácter. Eneste caso, puede sobrepasarse el límite de255 bytes con anterioridad y no permitirrealmente la introducción de 255 caracteres.

Anular comentarios de la selección Elimina el símbolo de comentario # que estádelante de todas las líneas en el textoactualmente seleccionado para incluir laslíneas en la regla.

Sangría Aplica sangría en las líneas actualmenteseleccionadas.


Nombre Descripción

No aplicar sangría Elimina la sangría de las líneas actualmenteseleccionadas.

Ir a la línea... Muestra el cuadro de diálogo Ir a la líneapara que pueda introducir un número delínea específico en el Editor de reglas ydesplazarse a dicha línea.

Menú VerLa siguiente tabla describe las opciones del menú Ver.

Nota: Cualquier cambio que realice en los valores del menú Ver se guardarácuando salga del Editor de reglas y se volverá a aplicar automáticamente lapróxima vez que abra el Editor de reglas.

Nombre Descripción

Ajuste de línea Activa o desactiva la característica de ajustede línea para que las líneas de texto seextiendan hacia la derecha o se ajustencuando se muestran en el panel Editar.

Números de línea Activa o desactiva los números de línea.

Ayudas contextuales de funciones Activa o desactiva la visualización de lasayudas contextuales de funciones.

Autocompletar Activa o desactiva la característicaautocompletar al escribir en el panel Editar.

Barra de herramientas Activa o desactiva la visualización de labarra de herramientas principal.

Barra de estado Activa o desactiva la visualización de labarra de estado en la parte inferior delEditor de reglas.

Objetos de control Activa o desactiva la visualización de losobjetos de control de TM1 al seleccionarcubos.

Desplegar todas las regiones Despliega todas las regiones definidas por elusuario en la regla actual para mostrar todaslas líneas.

Contraer todas las regiones Contrae todas las regiones definidas por elusuario en la regla actual para ocultar todaslas líneas que están incluidas en una región.


Menú InsertarLa siguiente tabla describe las opciones del menú Insertar.

Nombre Descripción

Función Muestra el cuadro de diálogo Insertar unafunción para introducir una nueva funciónen la regla actual.

Referencia del cubo Muestra el cuadro de diálogo Insertarreferencia del cubo para que pueda insertaruna función DB.

Menú HerramientasLa siguiente tabla describe las opciones del menú Herramientas.

Nombre Descripción

Preferencias... Muestra el cuadro de diálogo Preferencias,en el que puede establecer atributos defuente como el tipo, el tamaño y el color defuente que se va a utilizar en el panel Editar.

Opciones... Muestra el cuadro de diálogo Opciones decontrol, en el que puede ajustar los valoresglobales del Editor de reglas.

Cuadro de diálogo Guardar subconjunto

Campo Descripción

Seleccionar o introducir nombre desubconjunto

Introduzca un nombre para el subconjuntoguardado o seleccione un nombre en la lista.

Privado Active esta opción para guardar elsubconjunto como objeto privado. Desactiveesta opción para guardar el subconjuntocomo objeto público.

Valor predeterminado Active esta opción para guardar elsubconjunto como subconjuntopredeterminado.

Guardar expresión Si el subconjunto es dinámico, active estaopción para guardar la expresión MDX conel subconjunto.

Si el subconjunto es dinámico y no activaesta opción, la expresión MDX no seguardará y el subconjunto que aparece comoresultado será estático, y contendrá loselementos que estén presentes al guardarlo.


Cuadro de diálogo Guardar vista

Campo Descripción

Seleccionar o introducir una vista connombre

Introduzca un nombre para la vistaguardada o seleccione un nombre en la lista.

Privado Active esta opción para guardar la vistacomo objeto privado. Desactive esta opciónpara guardar la vista como objeto público.

Valor predeterminado Active esta opción para guardar la vistacomo vista predeterminada.

Cuadro de diálogo Guardar vista (Navegador de hojas de cálculo)

Campo Descripción

Nombre de vista Introduzca un nombre para la vista en estecampo.

Privado Active esta opción para guardar la vistacomo objeto privado. Desactive esta opciónpara guardar la vista como objeto público.

Valor predeterminado Active esta opción para guardar la vistacomo vista predeterminada.

Cuadro de diálogo Asignaciones de seguridadEl cuadro de diálogo Asignaciones de seguridad le permite asignar privilegios deacceso a cubos, dimensiones, elementos individuales, procesos y tareas. Losprivilegios de acceso se asignan por grupo de usuarios.

Cuadrícula AsignacionesLa cuadrícula Asignaciones muestra nombres de objeto como cabeceras de fila ygrupos de usuarios como cabeceras de columna. Los privilegios de acceso aparecencomo valores de celda en la intersección de un objeto determinado y un grupo deusuarios.

Al acceder al cuadro de diálogo Asignación de seguridad en el grupo Cubes, lacuadrícula incluirá la columna Conexión. Esta columna incluirá una casilla deverificación para cada cubo. Para activar la conexión a un cubo, active la casilla deverificación de la intersección del nombre del cubo y la columna Conexión. Paradesactivar el registro, desactive la casilla de verificación. El valor predeterminadoes Activado.

Privilegios de accesoPulse una de las siguientes opciones para asignar privilegios de acceso a una celdaseleccionada de la cuadrícula Asignaciones:

Ningún privilegioLa tabla siguiente describe la capacidad de los grupos de usuarios TM1 paraacceder a varios objetos TM1 cuando no se asigna ningún privilegio a un objeto.


Objeto Descripción

Cubo Los miembros del grupo no pueden ver elcubo en Server Explorer y, por lo tanto, nopueden examinarlo.

Elemento Los miembros del grupo no pueden ver elelemento en el Editor de subconjuntos ni enel Editor de dimensiones, ni tampoco lasceldas identificadas por el elemento alexaminar un cubo.

Dimensión Los miembros del grupo no pueden ver ladimensión en Server Explorer ni puedenexaminar ningún cubo que contenga ladimensión.

Proceso Los miembros del grupo no pueden ver elproceso en Server Explorer.Nota: Los privilegios asignados a losprocesos se pasan por alto cuando unproceso se ejecuta desde una tarea.

Tarea Los miembros del grupo no pueden ver latarea en Server Explorer.

Aplicación Los miembros del grupo no pueden ver laaplicación ni su contenido en ServerExplorer.

Referencia Los miembros del grupo no pueden ver lareferencia en Server Explorer.

Privilegio de lecturaLa tabla siguiente describe la capacidad de los grupos de usuarios TM1 paraacceder a varios objetos TM1 cuando se les asigna privilegios de lectura respecto aun objeto

Objeto Descripción

Cubo Los miembros del grupo pueden ver losdatos del cubo, pero no pueden editarlos.

Elemento Los miembros del grupo pueden ver losdatos identificados por el elemento, pero nopueden editarlos.

Dimensión Los miembros del grupo pueden ver loselementos de una dimensión, pero nopueden editar la estructura de dimensiones.


Objeto Descripción

Proceso Los miembros del grupo pueden ver elproceso en Server Explorer y puedenejecutar el proceso, pero no pueden editarlo.Nota: Los privilegios asignados a losprocesos se pasan por alto cuando unproceso se ejecuta desde una tarea.

Tarea Los miembros del grupo pueden ver la tareaen Server Explorer y pueden ejecutarmanualmente la tarea, pero no puedeneditarla ni cambiar el estado de activación.

Aplicación Los miembros del grupo pueden ver laaplicación y utilizar todas las referencias queestén dentro de la aplicación para las quetenga, al menos, privilegios de lectura.Puede crear referencias privadas en laaplicación, y también puede crearsubaplicaciones privadas

Referencia Los miembros del grupo pueden abrir lareferencia y utilizarla, pero no puedenactualizar la referencia en la aplicaciónpadre. Sin embargo, sí puede realizar laoperación "guardar como" para guardar unanueva versión privada de la referencia enaplicaciones en las que tenga, como mínimo,privilegios de lectura.

Privilegio de escrituraLa tabla siguiente describe la capacidad de los grupos de usuarios TM1 paraacceder a varios objetos TM1 cuando se les asigna privilegios de escritura respectoa un objeto.

Objeto Descripción

Cubo Los miembros del grupo pueden ver y editarlos datos del cubo, y pueden crear vistasprivadas del cubo.

El acceso de escritura no le permite editarlos datos identificados a través de elementosconsolidados o derivados de reglas. Pordefinición, los valores derivados deconsolidaciones o de reglas no puedeneditarse.

Elemento Los miembros del grupo pueden ver y editarlos datos identificados a través del elemento.


Objeto Descripción

Dimensión Los miembros del grupo pueden editaratributos de elemento, editar formatos deelemento y crear subconjuntos privados enla dimensión. Los miembros del grupotambién pueden editar atributos de la propiadimensión.

Privilegio de reservaLa tabla siguiente describe la capacidad de los grupos de usuarios TM1 paraacceder a varios objetos TM1 cuando se les asigna privilegios de reserva respecto aun objeto.

Tenga en cuenta que al reservar un objeto, dicha reserva caducará cuando elservidor que contiene el objeto se apague.

Objeto Descripción

Cubo Los miembros del grupo pueden ver y editarlos datos del cubo, y pueden reservar elcubo para impedir que otros clientes editenlos datos del cubo. Puede liberar un cuboque haya reservado.

Elemento Los miembros del grupo pueden ver y editarlos datos identificados a través del elemento,y pueden reservar el elemento para impedirque otros usuarios editen los datos. Puedeliberar un elemento que haya reservado.

Dimensión Los miembros del grupo pueden añadir,borrar y reordenar elementos de ladimensión, y pueden reservar la dimensiónpara impedir que otros usuarios editen laestructura de dimensiones. Puede liberaruna dimensión que haya reservado.

Privilegio de bloqueoLa tabla siguiente describe la capacidad de los grupos de usuarios TM1 paraacceder a varios objetos TM1 cuando se les asigna privilegios de bloqueo respectoa un objeto.

Tenga en cuenta que no existen privilegios de desbloqueo, y que únicamente losusuarios que tengan privilegios administrativos de un objeto podrán desbloqueardicho objeto.


Objeto Descripción

Cubo Los miembros del grupo pueden ver y editarlos datos del cubo, y pueden bloquearlo.

Cuando un cubo está bloqueado, nadiepuede actualizar sus datos.

Elemento Los miembros del grupo pueden ver y editarlos datos identificados a través del elemento,y pueden bloquear el elemento.

Cuando se bloquea un elemento, nadiepuede actualizar los datos identificados através del elemento.

Dimensión Los miembros del grupo pueden añadir,borrar y reordenar elementos de ladimensión, y pueden bloquear la dimensiónpara impedir que otros usuarios editen laestructura de dimensiones.

Cuando una dimensión está bloqueada,nadie puede editar la estructura dedimensiones.

Privilegio administrativoLa tabla siguiente describe la capacidad de los grupos de usuarios TM1 paraacceder a varios objetos TM1 cuando se les asigna privilegios administrativosrespecto a un objeto.

Objeto Descripción

Cubo Los miembros del grupo pueden leer,escribir, reservar, liberar, bloquear,desbloquear y borrar el cubo. Tambiénpueden otorgar privilegios de acceso de estecubo a otros usuarios.

Elemento Los miembros del grupo pueden ver,actualizar y borrar celdas identificadas através del elemento. Pueden reservar, liberar,bloquear y desbloquear el elemento.También pueden otorgar privilegios deacceso de este elemento a otros usuarios.

Dimensión Los miembros del grupo pueden añadir,borrar y reordenar los elementos de ladimensión. Pueden reservar, liberar,bloquear y desbloquear la dimensión.También pueden crear subconjuntos públicosde la dimensión y otorgar privilegios deacceso de la dimensión a otros usuarios.


Objeto Descripción

Aplicación Los miembros del grupo pueden ver laaplicación, utilizar referencias dentro de laaplicación y crear referencias públicas yprivadas en la aplicación. También puedencrear subaplicaciones públicas y privadas.

Cuando un grupo cuenta con un privilegioadministrativo con respecto a una aplicación,los miembros del grupo pueden establecerprivilegios de seguridad en todas lasreferencias y subaplicaciones de la aplicaciónen otros grupos, pero no en el suyo propio.

Referencia Los miembros del grupo pueden utilizar lareferencia, así como actualizar o borrar lareferencia. Pueden publicar referenciasprivadas y privatizar referencias públicas.

Seleccionar dimensiónAl acceder al cuadro de diálogo Asignación de seguridad desde una dimensiónindividual, estará disponible la opción Seleccionar dimensión. Esta opción lepermite asignar privilegios de acceso a elementos de varias dimensiones.

Tras asignar privilegios de acceso a una dimensión, pulse Guardar y, acontinuación, seleccione una nueva dimensión en la lista Seleccionar dimensión. Alfinalizar la asignación de privilegios de todas las dimensiones deseadas, pulseAceptar para cerrar el cuadro de diálogo.

Cuadro de diálogo Seleccionar cuboSeleccione el nombre de cubo que desee insertar en la hoja de trabajo o fórmula ypulse Aceptar.

Cuadro de diálogo Seleccionar cubo para reglasSeleccione el cubo para el que desee crear una nueva regla y pulse Aceptar.

Cuadro de diálogo Seleccionar dimensiónSeleccione el nombre de dimensión que desee insertar en la hoja de trabajo ofórmula y pulse Aceptar.

Cuadro de diálogo Seleccionar hoja de trabajo de dimensionesSeleccione la hoja de trabajo de dimensiones que desee abrir y pulse Aceptar.

Cuadro de diálogo Seleccionar elementoSeleccione el nombre de elemento que desee insertar en la hoja de trabajo ofórmula y pulse Aceptar.


Cuadro de diálogo Seleccionar hoja de trabajo de reglasSeleccione la hoja de trabajo de reglas que desee abrir y pulse Aceptar.

Server Explorer (ventana principal)

Panel de la izquierda (panel de árbol)

Muestra una representación jerárquica de todos los objetos de los servidores a losque está actualmente conectado.

Panel de la derecha (Panel Propiedades)

Muestra las propiedades del objeto seleccionado en el panel de la izquierda deServer Explorer. Las propiedades varían en función del objeto seleccionado.

Menú ArchivoLas siguientes opciones están disponibles en el menú Archivo en Server Explorer.


Opciones Abre el cuadro de diálogo Opciones de TM1.

Apagar servidor local Apaga el servidor local y le solicita queguarde los cambios en los datos. Esta opciónestá disponible únicamente cuando elservidor local se está ejecutando.

Iniciar servidor local Inicia el servidor local. Esta opción estádisponible únicamente cuando el servidorlocal no se está ejecutando.

Actualizar servidores disponibles Actualiza la visualización de los servidoresdisponibles en el panel de la izquierda deServer Explorer.

Salir Cierra Server Explorer y las demás ventanasrelacionadas con TM1 Perspectives/TM1Architect.

Menú dinámicoLas opciones disponibles en el segundo menú de Server Explorer varían en funcióndel tipo de objeto actualmente seleccionado.

Grupo de servidoresLas siguientes opciones están disponibles en el menú TM1 al seleccionar el grupode servidores en Server Explorer.



Guardar todos los datos Guarda los datos de todos los servidores alos que está actualmente conectado.

ServidorLas siguientes opciones están disponibles en el menú Servidor al seleccionar unservidor individual en Server Explorer.


Guardar datos Guarda todas las ediciones de los datos en elservidor seleccionado.

Reiniciar (borrar memoria para el servidorlocal)

Apaga y reinicia el servidor local. Alseleccionar esta opción, puede reciclar yguardar los datos en el servidor local oreciclar y abandonar los cambios en elservidor local.

Apagar Apaga el servidor local. Esta opción estádisponible únicamente cuando se seleccionael servidor local.

Seguridad, Clientes/Grupos Abre el Editor de clientes/grupos delservidor seleccionado. Debe tener privilegiosadministrativos del servidor para acceder alEditor de clientes/grupos.

Seguridad, Cambiar contraseña Abre el cuadro de diálogo Cambiarcontraseña, en el que puede cambiar lacontraseña del servidor seleccionado.

Seguridad, Actualizar seguridad Actualizar todas las asignaciones/estructurasde seguridad del servidor seleccionado.



Asignación de funciones Permite al administrador establecer permisospara características específicas por grupo deusuarios. En la intersección del grupo deusuarios y la función, los administradorespueden establecer Otorgar o Denegar (aligual que En blanco) para activar odesactivar dicha función. Algunos valores dela función pueden ignorarse en función delos valores de configuración establecidos enel servidor.

Las siguientes funciones pueden establecersepor grupo de usuario:

v Bloquear acceso a Server Explorer

Para evitar que se lance Server Explorer,pulse la intersección de esta función y elgrupo de usuario y seleccione Otorgar. Enblanco o Denegar significa que ServerExplorer está siendo utilizado por estegrupo de usuarios.

v Modo de reescritura de Espacio detrabajo personal

Para activar la utilización de espacios detrabajo personales por parte de un grupode usuarios, pulse la intersección delgrupo de usuarios y esta función yseleccione Otorgar. En blanco o Denegarsignifica que este grupo de usuarios noutiliza espacios de trabajo personales.

Si DisableSandboxing está establecidocomo T, se ignora esta asignación defunciones.

v Recinto de pruebas

Para activar la utilización de recintos depruebas por parte de un grupo deusuarios para crear varios escenariosposibles, pulse la intersección del grupode usuarios y esta función y seleccioneOtorgar. En blanco o Denegar significaque este grupo de usuarios no puedeutilizar varios recintos de pruebas.

Si DisableSandboxing está establecidocomo T, se ignora esta asignación defunciones.

Consulte la guía de operaciones y la guíadel usuario de IBM Cognos TM1 paraobtener más información.

Ver registro de transacciones Abre el cuadro de diálogo Consulta delregistro de transacciones, en el que puedever un registro de transacciones del servidorseleccionado.



Ver registro de mensajes Abre el cuadro de diálogo Registro demensajes, que muestra mensajes registradosen el servidor seleccionado.

Iniciar supervisión de rendimiento Inicia la supervisión de rendimiento.Cuando el control de rendimiento estáejecutándose, TM1 llena varios cubos decontrol que le permiten supervisar lasestadísticas de los cubos, de los clientes ydel servidor.

Detener supervisión de rendimiento Detiene la supervisión de rendimiento.

Actualizaciones diferidas, Iniciaractualizaciones por lotes

Inicia las actualizaciones por lotes que sevan a enviar al servidor seleccionado.

Actualizaciones diferidas, Finalizaractualizaciones por lotes

Finaliza las actualizaciones por lotes y envíatodas las ediciones al servidor seleccionado.

Gestor de servidor Abre el cuadro de diálogo Centro demensajes de clientes, en el que puede apagarel servidor seleccionado, desconectar clientesy difundir mensajes.

Cancelar apagado Cancela el apagado de un servidor ejecutadopreviamente.

Desconectarse a sí mismo Desconecta su cliente del servidorseleccionado.

¿Quién soy? Devuelve un mensaje que indica su nombrede usuario en el servidor.

AplicacionesLas siguientes opciones están disponibles en el menú Aplicaciones al seleccionar elgrupo Aplicaciones o una aplicación individual en Server Explorer.


Abrir Despliega la aplicación seleccionada o elgrupo Aplicaciones para mostrar lasreferencias y las subaplicaciones.

Cerrar Contrae la aplicación seleccionada o elgrupo Aplicaciones para ocultar lasreferencias y las subaplicaciones.



Borrar Borra la aplicación seleccionada. Al borraruna aplicación, todas las subaplicaciones yreferencias de la aplicación se borraránautomáticamente. Esta opción no estádisponible cuando se selecciona el grupoAplicaciones.

Renombrar Establece el nombre de aplicaciónseleccionado en el modo de edición, por loque puede introducir un nuevo nombre parala aplicación. Esta opción no está disponiblecuando se selecciona el grupo Aplicaciones.

Seguridad, Asignaciones de seguridad Abre la ventana Asignaciones de seguridadTM1 , en la que puede asignar privilegios deseguridad a las referencias y subaplicacionesinmediatas incluidas en la aplicaciónseleccionada o en el grupo Aplicaciones.

Seguridad, Publicar Seleccione esta opción para publicar unaaplicación privada. Al publicar unaaplicación, todas las subaplicaciones yreferencias privadas a objetos públicos de laaplicación también se publicanautomáticamente. Esta opción no estádisponible cuando se selecciona el grupoAplicaciones.

Seguridad, Privatizar Seleccione esta opción para privatizar unaaplicación pública. Al privatizar unaaplicación, todas las subaplicaciones yreferencias públicas de la aplicación tambiénse privatizarán automáticamente. Estaopción no está disponible cuando seselecciona el grupo Aplicaciones.

CubosLas siguientes opciones están disponibles en el menú Cubos al seleccionar ungrupo de cubos en Server Explorer.


Crear nuevo cubo Abre el cuadro de diálogo Creación decubos.

Editar atributos Abre el Editor de atributos del cuboseleccionado.



Asignaciones de seguridad Abre el cuadro de diálogo Asignaciones deseguridad TM1 de los cubos del grupo decubos seleccionado. Debe ser miembro delgrupo Admin del servidor que contenga elgrupo de cubos para acceder a este cuadrode diálogo.

CuboLas siguientes opciones están disponibles en el menú Cubo al seleccionar un cuboen Server Explorer.


Examinar Abre el cubo que se va a examinar en laventana Cube Viewer.

Examinar en Excel Abre el cubo que se va a examinar en laventana Navegador de hojas de cálculo.

Elegir Copia el nombre del cubo en elportapapeles.

Crear nuevo cubo Abre el cuadro de diálogo Creación decubos.

Descargar cubo Descarga el cubo seleccionado de lamemoria del servidor.

Borrar cubo Borra el cubo seleccionado y todos los datosasociados. Debe tener privilegiosadministrativos para borrar un cubo

Reordenar dimensiones Abre la ventana Optimizador del cubo, en laque puede optimizar el orden de lasdimensiones del cubo seleccionado.

Crear regla Abre el Editor de reglas, en el que puedecrear una regla para el cubo seleccionado.

Borrar regla Borra la regla asociada al cubo seleccionado.Debe tener privilegios administrativos de uncubo para poder borrar la regla asociada.

Exportar como datos ASCII Exporta los datos contenidos en el cuboseleccionado a un archivo ASCII delimitadopor comas (.cma).

Sincronizar datos Sincroniza los datos del cubo seleccionadocon datos del servidor de réplica asociado.



Seguridad, Reservar Reserva de forma temporal el cuboseleccionado para que otros clientes nopuedan editar los datos del cubo. Debe tenerprivilegios de reserva para reservar un cubo.

Seguridad, Liberar Libera un cubo que ha reservado para queotros clientes puedan editar los datos delcubo. Debe tener privilegios de reserva paraliberar un cubo.

Seguridad, Bloquear Bloquea de forma permanente el cuboseleccionado para que otros clientes nopuedan editar los datos del cubo. El clientecon el que ha iniciado la sesión tambiénquedará bloqueado para estos elementos.Debe tener privilegios de bloqueo parabloquear un cubo.

Seguridad, Desbloquear Desbloquea el cubo seleccionado para queotros clientes no puedan editar los datos.Debe tener privilegios administrativos paradesbloquear un cubo.

Propiedades Abre el cuadro de diálogo Propiedades delcubo, en el que puede establecer lasdimensiones de medidas y tiempo.

DimensionesLas siguientes opciones están disponibles en el menú Dimensiones al seleccionarun grupo de dimensiones en Server Explorer.


Crear nueva dimensión Abre la ventana Editor de dimensiones, enla que puede crear una nueva dimensión.

Editar atributos Abre la ventana Editor de atributos, en laque puede asignar y editar atributos paratodas las dimensiones del gruposeleccionado.

Asignaciones de seguridad Abre el cuadro de diálogo Asignaciones deseguridad TM1 , en el que puede asignarprivilegios de seguridad para cadadimensión del grupo. Debe ser miembro delgrupo Admin para utilizar esta opción.

DimensiónLas siguientes opciones están disponibles en el menú Dimensión al seleccionar unadimensión en Server Explorer.



Insertar nuevo subconjunto Abre la ventana Editor de subconjuntos dela dimensión.

Elegir Copia el nombre de la dimensión en elportapapeles.

Editar estructura de dimensiones Abre la dimensión seleccionada que se va aeditar en la ventana Editor de dimensiones.Debe tener privilegios de escritura para ladimensión seleccionada para poder utilizaresta opción.

Crear nueva dimensión Abre una ventana Editor de dimensionesvacía, en la que puede crear una nuevadimensión. Debe ser miembro del grupoAdmin para poder crear una nuevadimensión.

Exportar dimensión Exporta las dimensiones seleccionadas comoun archivo delimitado por comas (.cma).

Eliminar dimensión Elimina la dimensión seleccionada. Debe sermiembro del grupo Admin para podereliminar una dimensión.

Establecer el orden de los elementos Abre el cuadro de diálogo Ordenarelementos de dimensiones, en el que puedeestablecer el orden de los elementos de ladimensión seleccionada.

Editar atributos de elemento Abre la ventana Editor de atributos, en laque puede asignar y editar atributos paratodos los elementos de la dimensiónseleccionada.

Sincronizar datos Sincroniza los datos de la dimensiónseleccionada con datos asociados decualquier servidor replicado.

Seguridad, Reservar Reserva de forma temporal la dimensiónseleccionada para que los demás clientes nopuedan editar la estructura de dimensiones.Debe tener privilegios de reserva parareservar una dimensión. Tenga en cuentaque esta opción reserva sólo la estructura dedimensiones. No reserva los datosidentificados a través de los elementos de ladimensión seleccionada.



Seguridad, Liberar Libera una dimensión reservada para queotros clientes puedan editar la estructura dedimensiones. Debe tener privilegios dereserva para liberar una dimensión. Tengaen cuenta que esta opción libera sólo laestructura de dimensiones. No libera losdatos identificados a través de los elementosde la dimensión seleccionada.

Seguridad, Bloquear Bloquea de forma permanente la dimensiónseleccionada para que otros clientes nopuedan editar la estructura de dimensiones.Debe tener privilegios de bloqueo parabloquear una dimensión. Tenga en cuentaque esta opción bloquea sólo la estructurade dimensiones. No bloquea los datosidentificados a través de los elementos de ladimensión seleccionada.

Seguridad, Desbloquear Desbloquea la dimensión seleccionada paraque otros clientes puedan editar laestructura de dimensiones. Debe tenerprivilegios administrativos para desbloquearuna dimensión. Tenga en cuenta que estaopción desbloquea sólo la estructura dedimensiones. No desbloquea los datosidentificados a través de los elementos de ladimensión seleccionada.

Seguridad, Asignaciones de seguridad deelementos

Abre el cuadro de diálogo Asignaciones deseguridad TM1 , en el que puede asignarprivilegios de seguridad para cada elementode la dimensión. Debe tener privilegios deescritura para la dimensión seleccionadapara poder utilizar esta opción.

CubeViewsLas siguientes opciones están disponibles en el menú CubeViews al seleccionar ungrupo de vistas en Server Explorer.


Crear vista nueva Abre la ventana Cube Viewer, en la quepuede configurar una nueva vista.

CubeViewLas siguientes opciones están disponibles en el menú CubeView al seleccionar unavista en Server Explorer.


Examinar Abre la vista en la ventana Cube Viewer.

Examinar en Excel Abre la vista en el Navegador de hojas decálculo.



Exportar como datos de texto Abre la ventana Extracción de vistas, desdela que puede exportar la vista como archivodelimitado por comas (.cma).

Publicar Esta opción está disponible al seleccionaruna vista privada. Seleccione esta opciónpara convertir una vista privada en pública.Las vistas públicas están disponibles paratodos los clientes con privilegios de lecturadel cubo que contiene la vista.

Borrar vista Borra la vista seleccionada. Tenga en cuentaque esta opción sólo borra la configuraciónde la vista, no los datos que contiene lavista.

SubconjuntosLas siguientes opciones están disponibles en el menú Subconjuntos al seleccionarun grupo de subconjuntos en Server Explorer.


Insertar nuevo subconjunto Abre la ventana Editor de subconjuntos, enla que puede definir un nuevo subconjunto.

SubconjuntoLas siguientes opciones están disponibles en el menú Subconjunto al seleccionar unsubconjunto en Server Explorer.


Abrir Abre el subconjunto seleccionado en laventana Editor de subconjunto.

Crear nuevo subconjunto Abre la ventana Editor de subconjuntos dela dimensión a la que pertenece elsubconjunto seleccionado. Puede definir unnuevo subconjunto en esta ventana

Publicar Esta opción está disponible al seleccionar unsubconjunto privado. Seleccione esta opciónpara convertir un subconjunto privado enpúblico. Los subconjuntos públicos estándisponibles para todos los clientes conprivilegios de lectura de la dimensión quecontiene el subconjunto.

Borrar subconjunto Borra el subconjunto seleccionado. Tenga encuenta que esta opción sólo borra laconfiguración del subconjunto, y no borralos elementos contenidos en el subconjuntode la dimensión padre.

RéplicasLas siguientes opciones están disponibles en el menú Réplicas al seleccionar ungrupo de réplicas en Server Explorer.



Insertar nueva réplica Abre el cuadro de diálogo Crear objeto deréplica de servidor, en el que puedeestablecer una nueva conexión de réplica.

RéplicaLas siguientes opciones están disponibles en el menú Réplica al seleccionar unaréplica en Server Explorer.


Sincronizar datos Sincroniza datos entre los servidores dedestino y de origen.

Modificar parámetros de réplica Abre el cuadro de diálogo Crear objeto deréplica de servidor, en el que puedemodificar los parámetros de la conexión deréplica seleccionada.

Borrar réplica Borra la conexión de réplica seleccionada.

Mostrar tareas involucradas Abre el cuadro de diálogo Seleccionar tareaspara modificar. Puede utilizar este cuadro dediálogo para eliminar la réplica seleccionadade cualquier tarea asociada.

Cubo replicadoLas siguientes opciones están disponibles en el menú Cubo al seleccionar un cuboreplicado en Server Explorer.


Replicar Abre el cuadro de diálogo Replicar cubo delcubo seleccionado, en el que puede definirlos parámetros de réplica y replicar el cubo.

Sincronizar datos Sincroniza datos entre el cubo replicado y elservidor de origen.

ProcesosLas siguientes opciones están disponibles en el menú Procesos al seleccionar ungrupo de procesos en Server Explorer.


Crear nuevo proceso Abre TurboIntegrator, donde puede crear unnuevo proceso.

Asignaciones de seguridad Abre el cuadro de diálogo Asignaciones deseguridad TM1 , en el que puede establecerprivilegios de seguridad de procesos en elservidor actual.


ProcesoLas siguientes opciones están disponibles en el menú Proceso al seleccionar unproceso en Server Explorer.


Mostrar tareas involucradas Abre el cuadro de diálogo Seleccionar tareaspara modificar. Puede utilizar este cuadro dediálogo para eliminar el procesoseleccionado de cualquier tarea asociada.

Editar proceso Abre el proceso seleccionado en la ventanaTurboIntegrator.

Ejecutar proceso Ejecuta el proceso seleccionado.

Vista Permite visualizar un proceso en el modo desólo lectura. Permite a los miembros de losgrupos DataAdmin y SecurityAdminvisualizar un proceso en el modo sololectura, cuando la opción Acceso aseguridad está habilitada para el proceso.

Acceso a seguridad Controla si un proceso está capacitado paramodificar los datos de seguridad en lasecuencia de comandos del proceso. Sólo losmiembros de los grupos ADMIN ySecurityAdmin pueden establecer estaopción. Esta opción puede definirla deforma independiente para cada proceso.

Borrar proceso Borra el proceso seleccionado.

Utilizar el recinto de pruebas activo Configura el proceso para que utilice losdatos del recinto de pruebas activo actual, alejecutar en proceso, en lugar de los datosbásicos. El recinto de pruebas activo estádeterminado por el recinto de pruebasactualmente seleccionado en Cube Viewer.

TareasLas siguientes opciones están disponibles en el menú Tareas al seleccionar ungrupo de tareas en Server Explorer.


Crear nueva tarea Abre el Asistente para la configuración detareas, en el que puede planificar una nuevatarea.

Asignaciones de seguridad Abre el cuadro de diálogo Asignaciones deseguridad TM1 , en el que puede establecerprivilegios de seguridad de tareas en elservidor actual.


TareaLas siguientes opciones están disponibles en el menú Tarea al seleccionar una tareaindividual en Server Explorer.


Activar planificación Esta opción alterna el estado de ejecución delas tareas. Seleccione esta opción para activarla tarea seleccionada que se va a ejecutar.Cuando se active una tarea, aparecerá unamarca de selección junto a esta opción.

Seleccione esta opción de nuevo paradesactivar la tarea seleccionada.

Editar Abre la tarea para editarla en el Asistentepara la configuración de tareas.

Debe desactivar una tarea antes de editarla.

Ejecutar Ejecuta la tarea seleccionada.

Borrar Borra la tarea seleccionada.

Debe desactivar una tarea antes de borrarla.

Menú EditarLas siguientes opciones están disponibles en el menú Editar en Server Explorer.


Copiar Copia la etiqueta del objeto seleccionado enel portapapeles.

Borrar Borra el objeto seleccionado del servidor.

Menú VerLas siguientes opciones están disponibles en el menú Ver en Server Explorer.


Barra de estado Oculta o muestra la barra de estado en laparte inferior de la ventana Server Explorer.Una marca de selección indica que semuestra la barra de estado.

Barra de herramientas Oculta o muestra la barra de herramientasen la parte superior de la ventana ServerExplorer. Una marca de selección indica quese muestra la barra de herramientas.

Ventana Propiedades Oculta o muestra el panel Propiedades deServer Explorer. Una marca de selecciónindica que se muestra el panel Propiedades.



Objetos:

Aplicaciones

Cubos

Dimensiones

Réplicas

Procesos

Tareas

Oculta o muestra cualquiera de los objetosen el panel de la izquierda (panel de árbol)de Server Explorer.

Una marca de selección indica que semuestra el objeto seleccionado.

Contraer todos los hijos Contrae el árbol del panel de la izquierda deServer Explorer para ocultar todos los hijosde un objeto seleccionado.

Desplegar todos los hijos Despliega el árbol del panel de la izquierdade Server Explorer para mostrar todos loshijos de un objeto seleccionado.

Mostrar objetos de control Oculta o muestra las dimensiones y loscubos de control en el panel de la izquierdade la ventana Server Explorer. Una marca deselección indica que se muestran los objetosde control.

Actualizar Actualiza la visualización jerárquica actualde los objetos en el panel de la izquierda deServer Explorer.

Editor de subconjuntos

Panel Elementos

Muestra una representación jerárquica de todos los elementos del subconjunto queestá visualizando actualmente.

Panel Propiedades

Muestra las propiedades de los elementos seleccionados en el panel Elementos delEditor de subconjuntos. Al seleccionar un elemento consolidado, este panelmuestra los nombres, tipos y pesos de todos los hijos del elemento consolidado.

Nota: Al visualizar un conjunto de dimensiones excepcionalmente grande en elEditor de subconjuntos con el panel Propiedades activado, es posible que tengaproblemas de rendimiento. Esto puede ocurrir cuando selecciona una consolidaciónen el panel Elementos y TM1 debe mostrar toda la lista de propiedades yelementos relacionados en el panel Propiedades.

Si trabaja con conjuntos de dimensiones grandes, es posible que desee desactivar elpanel Propiedades. Para desactivar el panel Propiedades, pulse la opción Ventanade propiedades en el menú Ver para eliminar la marca de selección situada junto ala opción.


Menú Subconjunto


Abrir Abre el cuadro de diálogo Guardarsubconjunto TM1 . Seleccione unsubconjunto en la lista y pulse Aceptar paraabrir el subconjunto.

Recargar Vuelve a cargar la definición del subconjuntoactual.

Guardar Guarda la definición del subconjunto actual.

Guardar como Guarda la definición del subconjunto actualcon un nuevo nombre.

Cerrar Cierra el Editor de subconjuntos.

Menú Editar


Deshacer Deshace la última acción.

Rehacer Restaura la última acción de "deshacer".

Cortar Corta los elementos seleccionados y loscoloca en el portapapeles.

Copiar Copia los elementos seleccionados en elportapapeles.

Copiar nombre exclusivo Copia el nombre de elemento, comoexpresión MDX, en el portapapeles. Elnombre de elemento copiado se puede pegaren la ventana Expresión del Editor desubconjuntos.

Pegar Pega el contenido del portapapeles en elpunto de inserción actual.

Pegar por encima Pega el contenido del portapapeles encimadel elemento seleccionado actualmente.

Pegar por debajo Pega el contenido del portapapeles debajodel elemento seleccionado actualmente.

Insertar subconjunto Abre una nueva instancia del Editor desubconjuntos para que pueda añadir unaconsolidación definida por el usuario alsubconjunto actual.



Mantener Mantiene únicamente los elementosactualmente seleccionados en el panelElementos del Editor de subconjuntos, yelimina los demás elementos.

Borrar Borra los elementos seleccionados de ladefinición del subconjunto actual.

Elegir elementos, Horizontal Copia los elementos seleccionados en elportapapeles con orientación horizontal, porlo que pueden pegarse en una fila de unahoja de trabajo.

Elegir elementos, Vertical Copia los elementos seleccionados en elportapapeles con orientación vertical, por loque pueden pegarse en una columna de unahoja de trabajo.

Orden, descendente Clasifica todos los elementos del panelElementos en orden alfabético descendente.

Orden, ascendente Clasifica todos los elementos del panelElementos en orden alfabético ascendente.

Orden, Jerarquía Ordena todos los elementos del panelElementos en orden jerárquico, para quepueda ver la relación padre/hijo de loselementos.

Orden, Índice ascendente Ordena todos los elementos del panelElementos en orden ascendente según elvalor de índice del elemento.

Orden, Índice descendente Ordena todos los elementos del panelElementos en orden descendente según elvalor de índice del elemento.

Detallar más Muestra los hijos inmediatos de loselementos seleccionados.

Distribuir Muestra los padres inmediatos de loselementos seleccionados.

Desplegar elemento Muestra todos los hijos de los elementosseleccionados.

Contraer elemento Contrae las consolidaciones seleccionadaspara que no se muestren los hijos.

Filtro por, niveles Abre el cuadro de diálogo Filtro por nivel,en el que puede seleccionar elementos pornivel jerárquico.



Filtro por, atributo Abre el cuadro de diálogo Filtro poratributo, en el que puede seleccionarelementos por valor de atributo.

Filtro por, Extracción de vistas Le permite seleccionar únicamente loselementos que se ajusten a una consultadefinida por el usuario.

Esta opción está disponible únicamente alabrir el Editor de subconjuntos pulsandouna etiqueta de dimensión en la ventanaCube Viewer.

Filtro por, comodín Le permite seleccionar elementos quecoincidan con una cadena de búsquedadefinida por el usuario.

Seleccionar alias Abre el cuadro de diálogo Alias TM1 , en elque puede seleccionar un alias definidopreviamente con el que podrá mostrarnombres de elemento.

Seguridad, Reservar Reserva de forma temporal el elementoseleccionado para que otros clientes nopuedan editar los datos identificados através del elemento. Debe tener privilegiosde reserva para reservar un elemento.

Seguridad, Liberar Libera un elemento reservado para que otrosclientes puedan editar los datos identificadosa través del elemento. Debe tener privilegiosde reserva para liberar un elemento.

Seguridad, Bloquear Bloquea de forma permanente el elementoseleccionado para que otros clientes nopuedan editar los datos identificados através del elemento. Debe tener privilegiosde bloqueo para bloquear un elemento.

Seguridad, Desbloquear Desbloquea el elemento seleccionado paraque otros clientes puedan editar los datosidentificados a través del elemento. Debetener privilegios administrativos paradesbloquear una dimensión.

Editar formatos de elementos Abre la hoja de trabajo Editar formatos deelementos, en la que puede definir estilos devisualización de secciones dinámicas y hojasweb TM1 .


Menú Ver


Barras de herramientas Abre un submenú que le permite activar odesactivar la visualización de todas lasbarras de herramientas del Editor desubconjuntos.

Una marca de selección indica que semuestra una barra de herramientas.

Barra de estado Oculta o muestra la barra de estado en laparte inferior de la ventana Editor desubconjuntos.

Una marca de selección indica que semuestra la barra de estado.

Ventana Propiedades Oculta o muestra el panel Propiedades.

Una marca de selección indica que semuestra el panel Propiedades.

Ventana Expresión Oculta o muestra la ventana Expresión en laparte inferior del Editor de subconjuntos.Una marca de selección indica que semuestra la ventana Expresión.

Desplegar por encima Esta opción determina cómo se expanden yse contraen las consolidaciones al detallarmás.

Al activar esta opción, los hijos de unaconsolidación se expanden por encima de laconsolidación al detallar más.

Al desactivar esta opción, los hijos de unaconsolidación se expanden por debajo de laconsolidación al detallar más.

Al activar la opción Desplegar por encimaen un subconjunto, al detallar más en unaconsolidación en Cube Viewer, el Navegadorde hojas de cálculo o en la sección, elcomportamiento será el siguiente:

Si la opción está activada en un subconjuntode filas, al detallar más en una consolidaciónaparecerán los hijos por encima de laconsolidación.

Si la opción está activada en un subconjuntode columnas, al detallar más en unaconsolidación aparecerán los hijos a laizquierda de la consolidación.

Actualizar Actualiza la visualización del panelElementos.


Menú Herramientas


Registrar expresión Inicia el registro de las acciones en el Editorde subconjuntos.

Detener registro Detiene el registro de las acciones en elEditor de subconjuntos.

Al detener el registro, TM1 genera unaexpresión MDX que se puede guardar paracrear un subconjunto dinámico.

Borrar expresión Borra el contenido de la ventana Expresión.

Filtro Abre el cuadro de diálogo Filtrarsubconjunto, que le permite crear unsubconjunto dinámico basado en los valoresdel cubo.

Cuadro de diálogo AliasPara ver los elementos del subconjunto actual en función de los alias asignados,seleccione un nombre de alias en la lista y pulse Aceptar.

Cuadro de diálogo Opciones de TM1Las siguientes opciones pueden establecerse en el cuadro de diálogo Opciones deTM1 .

Parámetros de inicio de sesión


Host de administración Introduzca el nombre del sistema del hostde administración. El host de administraciónes el sistema en el que se ejecuta el servidorde administración.

Inicio de sesión integrado Active esta opción para utilizar el inicio desesión integrado.

Desactive esta opción para utilizar laseguridad de inicio de sesión TM1 estándar.

El valor predeterminado es Desactivado.


Servidor local


Directorio de datos del servidor local Introduzca la ruta completa del directorio dedatos del servidor local, o pulse el botónadjunto Examinar para desplazarse hasta eldirectorio. También puede pulsar la flechahacia abajo para realizar una selección enuna lista de directorios a los que se haaccedido recientemente.

Conectar al servidor local durante el inicio Desactive esta opción para iniciar TM1Perspectives/TM1 Architect sin lanzar elservidor local.

El valor predeterminado es Activado.

Nota: El servidor local solo se admite en las versiones de 32 bits de TM1. Eldirectorio de datos predeterminado del servidor local es Pdata. Si ejecuta unaversión de 64 bits de TM1, el servidor de ejemplo Sdata, que se instala de formapredeterminada con el servidor de TM1, incluye los mismos objetos y datos que enPdata.

Secure Socket Layer del servidor de administración


Entidad emisora de certificados La ruta completa del archivo de la entidademisora de certificados que emitió elcertificado del Servidor de administración.

Lista de revocación de certificados La ruta completa del archivo de revocaciónde certificados emitido por la entidademisora de certificados que emitió elcertificado del Servidor de administración.Sólo existirá un archivo de revocación decertificados, en el caso de que se hayarevocado uno.

ID de certificado El nombre del principal al que se emite elcertificado del Servidor de administración.

Utilizar almacén de certificados Seleccione esta opción si desea que seexporte el certificado de entidad emisora decertificados que en un principio emitió elcertificado del Servidor de administracióndesde el almacén de certificados deWindows en tiempo de ejecución.

Cuando se selecciona esta opción, debetambién establecer un valor para ID decertificado de exportación en el cuadro dediálogo Opciones de TM1 .



ID de certificado de exportación La clave de identidad empleada paraexportar el certificado de entidad emisora decertificados que en un principio emitió elcertificado del Servidor de administración,desde el almacén de certificados.

Este parámetro sólo es necesario si activa laopción Utilizar almacén de certificados.

Cuadro de diálogo Consulta del registro de transaccionesEl cuadro de diálogo Consulta del registro de transacciones le permite consultar yver registros en el registro de transacciones TM1 (Tm1s.log). El cuadro de diálogocontiene campos para cuatro parámetros que debe especificar para ejecutar unaconsulta.


Hora de inicio La fecha/hora de inicio de la consulta.

TM1 realiza consultas en todos los registrosescritos en el registro de transacciones endicha fecha/hora o después de ella. Debeutilizar el formato MM/DD/AAAAHH:MM:SS para especificar una hora deinicio.

La fecha/hora de inicio predeterminada sonlas 00:01:00 GMT de la fecha en la que selanzó la consulta.

Hora de finalización La fecha/hora de finalización de la consulta.

De forma predeterminada es __/__/______:__:__, que es una fecha/hora definalización abierta. Si acepta el valorpredeterminado, TM1 consulta todos losregistros hasta la hora en la que se lanzó laconsulta.

Cliente(s) Los clientes a los que se aplica la consulta.Puede realizar consultas sobre un solocliente o sobre todos los clientes. De formapredeterminada es sobre todos los clientes(*).

Cubo(s) Los cubos a los que se aplica la consulta.Puede realizar consultas sobre un solo cuboo sobre todos los cubos. De formapredeterminada es sobre todos los cubos (*).

Para establecer cualquiera de los parámetros anteriores, pulse la flecha que aparecejunto al campo adecuado.


Cuadro de diálogo Resultados de la consulta del registro detransacciones

El cuadro de diálogo Resultados de la consulta del registro de transaccionespresenta el resultado de una consulta del registro de transacciones en formato detabla. La tabla contiene las siguientes columnas en cada registro que devuelva laconsulta:


LOGTIME La hora a la que se editó un valor.

REPLICATIONTIME La hora a la que se replicó un valor.

CLIENT El nombre del cliente que escribió el valor.

OLDVALUE El valor de los datos antes de la edición.

NEWVALUE EL valor de los datos después de la edición.

CUBENAME El cubo en el que se escribió el valor.

KEY N Existen varias columnas Key N en la tabla, ycada columna representa los elementos queidentifican el valor.

El cuadro de diálogo Resultados de la consulta del registro de transaccionesincluye tres menús.

El menú Archivo contiene un único elemento: Salir.

El menú Ayuda contiene un único elemento para abrir la ayuda del cuadro dediálogo.

El menú Editar contiene los siguientes elementos:


Copiar Copia una única celda seleccionada en elportapapeles.

Ocultar Suprime la visualización de los registrosseleccionados en la tabla.

Puede pulsar Actualizar para restaurar lavisualización de los registros ocultos.

Ordenar Abre un submenú en el que puedeseleccionar las columnas que se van aordenar o el orden de clasificación que se vaa aplicar.



Buscar Abre el cuadro de diálogo Buscar/Sustituir,que le permite buscar la tabla actual.

Seleccionar Selecciona los registros resaltados

Anular selección Anula la selección de los registrosresaltados.

Seleccionar todo Selecciona todos los registros de la tabla.

Deseleccionar todo Anula la selección de todos los registros dela tabla.

Detener Detiene los registros seleccionados. Aldetener un registro, el valor OLDVALUE delregistro sustituye al valor NEWVALUE delregistro.

Al seleccionar varios registros de una únicaubicación del cubo, los registros se detienenen el valor OLDVALUE del primerLOGTIME.

Editor de TurboIntegratorEl Editor de TurboIntegrator le permite definir procesos para importar datos ometadatos de varias fuentes posibles. El editor se compone de cinco pestañas, delas que varias son dinámicas o contienen subpestañas. Puede definir un procesocompletando cada pestaña en orden secuencial.

Menú Archivo


Guardar Guarda la definición de proceso actual.

Guardar como Guarda la definición de proceso actual conun nuevo nombre.

Ejecutar Ejecuta el proceso actual.

Salir Cierra el Editor de TurboIntegrator.

Menú Editar


Deshacer Deshace la última acción de escritura que serealizó en la subpestaña de procedimientoPrólogo, Metadatos, Datos o Epílogo.

Cortar Corta el texto seleccionado y lo coloca en elportapapeles.

Copiar Copia el texto seleccionado en elportapapeles.



Pegar Pega el contenido del portapapeles en lacelda o el campo actual.

Pestaña Origen de datosUtilice la pestaña Origen de datos para identificar y acceder al origen del quedesee importar los datos.

Nota: Al definir un proceso desde un cliente TM1 , la ruta de un origen de datosASCII o ODBC puede diferir de la ruta que utiliza el servidor. Si esto ocurre, elproceso no se realizará correctamente. Para asegurarse de que los procesos serealizan correctamente:v Defina los procesos relacionados con los orígenes de datos ODBC en el servidor

real en el que va a estar ubicado el proceso. No utilice un cliente remoto paradefinir dicho proceso.

v Utilice Entorno de red en Windows para definir la ruta de los orígenes de datosASCII. Esto asegura que la ruta no es ambigua ni para los clientes ni para losservidores.

Los campos y opciones disponibles en la pestaña Origen de datos varían enfunción del tipo de origen de datos que seleccione. La siguiente tabla describe lasopciones y campos necesarios para cada fuente.

ODBCDefinir un origen de datos ODBC:

Campos Descripción

Nombre de origen de datos La ruta completa al origen de datos ODBC.

UserName Su nombre de usuario en la fuente.

Contraseña Su contraseña.

Consulta Una consulta SQL para extraer datos de lafuente.

Utilizar Unicode Marque esta opción para utilizar Unicode enesta fuente.

Vista previa Muestra los 10 primeros registros.

TextoDefinir un origen de datos ASCII o de texto:

Campos Descripción

Nombre de origen de datos La ruta completa al archivo de texto de lafuente. Para asegurarse de que esta ruta seareconocible tanto para el cliente como parael servidor, pulse el botón Examinar y utiliceel Entorno de red para definir la ruta.


Campos Descripción

Nombre del origen de datos del servidor Al crear un nuevo proceso, TurboIntegratorpresupone que el nombre del origen dedatos del servidor es idéntico al nombre delorigen de datos utilizado para crear elproceso.

Si el nombre del origen de datos delservidor difiere del origen de datos localutilizado para crear el proceso, introduzca laruta completa del archivo de origen de datosdel servidor.

Tipo de delimitador Si la fuente utiliza un carácter para definirlas columnas, seleccione Delimitado y, acontinuación, seleccione el carácter en elcuadro Delimitador.

Anchura fija Si la fuente utiliza una anchura fija,seleccione Ancho fijo y, a continuación,utilice el botón Establecer anchos de campopara abrir el cuadro de diálogo Vista previapara establecer anchos de columna.

Comillas Especifique las comillas utilizadas en losdatos de origen.

Número de registros de títulos Si los registros de títulos abarcan más deuna fila, introduzca aquí el número de filas.De lo contrario, deje este campo en blanco.

Delimitadores de números Introduzca el carácter que desea utilizar enel Separador decimal y el Separador demillares de la fuente.

ODBODefina un origen de datos ODBC establecido para una base de datos relacional quepueda crearse utilizando el panel de control Orígenes de datos de MicrosoftWindows:

Cubo o dimensión:

Seleccionar el tipo de importación que se va a realizar:

Campos Descripción

Proveedor de ODBO Para importar un cubo ODBO, utilice elmenú desplegable para seleccionar la basede datos OLE para origen de datos OLAP,incluidos los servicios de Microsoft AnalysisServices que desee utilizar.

Ubicación de ODBO Introduzca la ubicación del archivo de esteproveedor.

Al importar una dimensión, deje este campoen blanco.


Campos Descripción

Origen de datos ODBO Introduzca el nombre que asigna suadministrador a un conjunto de catálogos deuna ubicación determinada. En MicrosoftAnalysis Services, éste es el nombre de unservidor registrado.

Catálogo ODBO Es el nombre asignado por su administradora una colección determinada de bases dedatos (cubos, dimensiones y otros objetos).Para MAS, este es el nombre de la base dedatos.

ID de usuario de ODBO Un nombre de usuario válido para la basede datos.

Contraseña de ODBO Una contraseña válida de este origen dedatos.

Parámetros adicionales de conexión Introduzca aquí los parámetros adicionalesque necesita la fuente ODBO. Delimite losparámetros con un punto y coma.

Al importar una dimensión, deje este campoen blanco.

Consulta MDX:

Definir una consulta basada en MDX:

Campos Descripción

Pestaña Conexión Introduzca la información de conexiónnecesaria. Los parámetros de conexión sonespecíficos de cada proveedor.

Pulse Conectar. Si se conecta correctamente,estará disponible la pestaña Consulta MDX.

Pestaña Consulta MDX Introduzca la consulta MDX en esta pestañao pegue una consulta MDX que esté enfuncionamiento de otra aplicación.

SAPDefine el origen de datos RFC SAP:

Pestaña Campo Descripción

Conexión Sistema Nombre del sistema SAP alque desea conectarse.

Si el nombre del sistemaincluye espacios, ponga elnombre entre comillasdobles.


Pestaña Campo Descripción

Cliente Un número que correspondea la versión de interfaz deusuario del servidor SAP. Porejemplo, 498.

Usuario Su nombre de usuario en elsistema SAP.

Contraseña Su contraseña en el sistemaSAP.

Idioma Idioma que desea utilizarpara iniciar sesión en elsistema SAP.

Todas las descripcionestextuales se cambian alidioma especificado si estádisponible.

El parámetro de idioma esuna abreviatura de dosletras, por ejemplo,EN=English.

Parámetros adicionales deconexión

Introduzca otros parámetrosy valores para utilizarlos alconectarse a su sistema BWSAP.

Tamaño de paquete Valor que limita el númerode filas de cada paquete quese envía de SAP a TM1 . Untamaño de paquete reducidodaría como resultado unaumento del tráfico de redcon paquetes pequeños,mientras que un tamañomayor resulta en unadisminución del tráfico dered pero con paquetes másgrandes por transmisión.

El tamaño de paquetepredeterminado, que esademás el tamaño mínimo,es 50.000.


Cubo de información

Área Campo Descripción

Cubo de informaciónMostrar nombres técnicosSAP

Para utilizar nombrestécnicos, seleccione estacasilla de verificación. Dejeesta casilla sin marcar paramostrarlos según su nombredescriptivo.

Seleccionar InfoCube paracargar desde

Utilice esta opción paraindicar el InfoCube desde elque desea importar los datos.

Seleccionar cubo TM1 paracargar en

Para importar el InfoCubeSAP a un cubo TM1existente, pulse esta opción yseleccione el cubo querecibirá los datos delInfoCube SAP.


Para crear un nuevo cuboTM1 cuando importe elInfoCube, introduzca elnombre del nuevo cubo TM1en el campo En.

Acción de cubo TM1 Crear Importa datos y metadatosdesde el InfoCube SAP ycrea un nuevo cubo en TM1 .Utilice esta opciónúnicamente cuando no existaen el servidor ninguno de loscubos ni dimensiones queestá importando.

Recrear Destruye un cubo TM1existente y lo vuelve a crearutilizando los datos ymetadatos del InfoCube SAP.Utilice esta opción solocuando existan lasdimensiones y el cubo TM1 ydesee sustituirlos por nuevasestructuras y datos delInfoCube SAP.

Actualizar Importa datos de unInfoCube SAP existente y losinserta en un cubo TM1existente. Esta opción nocambia la estructura de loscubos ni las dimensiones enel servidor.



Los procesos que especificanNinguna acción no afectan alos datos o metadatos de loscubos TM1 .

Utilice esta opción paraprobar y depurar procesos opara definir sus propiasoperaciones personalizadas.

Acción de datos Almacenar valores Esta opción escribe valoresde celda del InfoCube SAPen el cubo TM1 .

Si elige esta opción cuandoestá seleccionada la opciónActualizar cubo, sesobrescriben los valoresexistentes del cubo TM1 conlos valores importados delInfoCube.

Acumular valores La opción Acumular valoresle permite agregar valores decubo TM1 existentes convalores importados de unInfoCube SAP.

Porción de puesta a cero delcubo de destino

Esta opción se habilitacuando selecciona la acciónActualizar cubo.

Seleccione esta opción sidesea establecer todos lospuntos de datos en una vistade cubo específica como cero.

Para definir la vista de cubocomo cero, puede:

v Pulsar la lista de Vistapara seleccionar una vistaexistente y ponerla a cero.

v Pulsar el botón Más juntoa la lista opciones de Vistapara definir una nuevavista para poner a cero.



Activar conexión de cubos Para registrar los cambios enlos datos del cubo mientrasimporta desde un InfoCubeSAP, seleccione esta opción.

Para desactivar el registrodurante la importación,desactive esta opción.Nota: Inhabilitar el registroacelera la carga y laactualización de los datos,pero imposibilita larecuperación de cualquieractualización si se produceun error del sistema.

Pestaña Características

Campo Descripción

Seleccionar jerarquías Identifique las jerarquías del origen de datos.

Fecha de evaluación Fecha en la que todos los atributos SAP que dependen deltiempo se importarán a TM1 tal y como se encontraban enla fecha específica. Los atributos que no son temporales seimportan como se encuentran en el momento de laejecución del proceso.

Si se borra esta fecha, todos los atributos SAP se importarántal y como se encuentren en la fecha en la que se ejecute elproceso TM1 .

No importe jerarquías con intervalos.

Dimensión TM1 Seleccione la dimensión TM1 existente que se correlacionecon esta característica.

Deje este campo en blanco si no desea importar lacaracterística al cubo TM1 .

Acción de dimensión TM1 Crear Crear una nueva dimensiónTM1 desde la característicaSAP.

Recrear Recrear completamente unadimensión TM1 existente conelementos importados desdela característica SAP.

Actualizar Actualizar una estructura dedimensiones existenteañadiendo nuevos elementosimportados desde lacaracterística SAP.


Campo Descripción

AsIs Procesar la característica através de TurboIntegratorpero sin utilizar lacaracterística para crear omodificar ninguna de lasdimensiones TM1 .

Utilice esta opción paraprobar y depurar losprocesos, o para manipularla característica en la pestañaAvanzado deTurboIntegrator.

No cargar No importar la característicaSAP a TM1 . La característicase excluye completamentecuando se procesa elInfoCube SAP a través deTurboIntegrator.

Seleccionar atributos Atributos de característica Defina los atributos para esteorigen de datos.

Texto Identifica atributos con unvalor de cadena.

Numérico Identifica atributos con unvalor numérico.

Alias Identifica atributos que sonnombres alternativos para lasdimensiones a las que estánasociados. Un alias dedimensión debe ser exclusivocon respecto al resto de aliasde dimensión o nombres dedimensión reales

Seleccionar cifras clave Seleccione cada cifra clave que desee importar a TM1 .

Si las cifras clave se correlacionan con una dimensión TM1existente, pulse la columna Dimensión TM1 y seleccione ladimensión que corresponda a las cifras clave.

Restricciones Añadir restricciones Cree una nueva restricciónpara esta característica.

Característica SAP Seleccione la característica enla que desee establecer unarestricción.


Campo Descripción

Signo Indica si la restricción esinclusiva o exclusiva.

Elija Incluir si desea que elproceso TurboIntegratorimporte solo aquellos valoresque queden dentro de ladefinición de la restricción.

Elija Excluir si desea que elproceso TurboIntegratorimporte solo aquellos valoresque queden fuera de ladefinición de la restricción.

Opción El Operador utilizado para larestricción.

Puede elegir entre ochooperadores, como se describeen la tabla siguiente.

Opción Operadores de restricción

Operador Descripción

= La restricción identifica solo característicasiguales al Valor bajo especificado.

< > La restricción identifica únicamentecaracterísticas inferiores o superiores al Valorbajo especificado.

< La restricción identifica únicamentecaracterísticas inferiores al Valor bajoespecificado.

> La restricción identifica únicamentecaracterísticas superiores al Valor bajoespecificado.

< = La restricción identifica únicamentecaracterísticas inferiores o iguales al Valorbajo especificado.

> = La restricción identifica únicamentecaracterísticas superiores o iguales al Valorbajo especificado.

[ ] La restricción identifica únicamentecaracterísticas que quedan entre el Valor bajoy el Valor alto, ambos incluidos.


Operador Descripción

] [ La restricción identifica únicamentecaracterísticas que quedan fuera del Valorbajo y el Valor alto, ambos incluidos.

Puede elegir entre ocho operadores, como se describe en la tabla siguiente.

Introduzca un valor bajo para la restricción en la columna Valor bajo.

Introduzca un valor elevado para la restricción, si es necesario, en la columnaValor elevado.

Nota: Las restricciones no se validan a través de TurboIntegrator. Debe asegurarsede que las restricciones que introduce son precisas y válidas para sus datos SAP.

Seguridad

Campo Descripción

Importar seguridad Indica que deben importarse lasasignaciones de seguridad de estacaracterística.

Consolidación superior Crea una consolidación de nivel superiorpara la dimensión de TM1 que se ha creadoutilizando el nombre que se introdujo aquí.


Campo Descripción

Convertir los textos en exclusivos Para crear alias exclusivos para todos loselementos que se crean a partir de lacaracterística SAP, seleccione esta opción.Cuando importa una característica SAP aTM1 , los valores de característica seconvierten en elementos de dimensión TM1mientras que las descripciones de valoresSAP se convierten en alias de elementos deTM1 . En TM1 , todos los alias de elementode una dimensión deben ser exclusivos. Siun proceso TurboIntegrator intenta asignarel mismo alias a varios elementos, el procesogenerará errores y fallará la creación delalias.

Cuando la opción Convertir los textos enexclusivos está seleccionada, TM1 examinalas descripciones SAP que se han importadoy convertido en alias TM1 . Si TM1 detectaque varios valores utilizan descripcionesidénticas, TM1 anexa el nombre del valor ala descripción para generar alias exclusivos.

En TM1 versión 9.5.2 la variable V2 nocontiene ningún valor, por lo que la únicaforma de importar el atributo Alias esutilizar la opción Convertir los textos enexclusivos.

Si no se selecciona la opción Convertir lostextos en exclusivos, no se obtiene ningúndato SAP_Text.

Cuando no está seleccionada la opciónConvertir los textos en exclusivos, puedeañadir DataSourceSAPUsingTexts=1; en elprólogo para importar los valores deatributo de alias.

Consulte la función AttrPutS para conseguirel mismo comportamiento utilizando unscript TI.

Fecha de evaluación Todos los valores de característica existentesentre la fecha seleccionada y la fecha deejecución del proceso se importarán a TM1 .Si no se ha especificado ninguna fecha deevaluación, la fecha predeterminada será lafecha en la que se ejecuta el procesoTurboIntegrator.


Tabla SAP

Campo Descripción

Tabla SAP Indica que el origen de datos es unaconsulta de tabla SAP.

Nombre de tabla Nombre de la tabla SAP que se va a utilizar.

Cadena de filtros Una cadena de filtros SQL que se utilizaráen la cláusula WHERE cuando la sentenciade SQL SELECT que ha generadoTurboIntegrator se ejecute sobre la tabla SAP.

Tabla ODS

Campo Descripción

Tabla ODS Se utiliza para exportar datos de TM1 enuna tabla ODS que a continuación puedeutilizarse para importar datos a través de unInfoCube SAP.

Configuración de ODS Defina los detalles de la tabla ODS.

Examinar Seleccione la vista de TM1 que desee utilizarcomo origen de datos.

Mostrar nombres técnicos Para utilizar nombres técnicos, seleccioneesta casilla de verificación. Deje esta casillasin marcar para mostrarlos según su nombredescriptivo.

Seleccionar tabla ODS Seleccione la tabla ODS a la que deseeexportar.


Campo Descripción

Columnas Las columnas pueden ser características SAPo cifras clave. Debe conocer la estructura delas tablas ODS para saber qué columnas soncaracterísticas y cuáles son cifras clave;TurboIntegrator no distingue entre los tiposde columna de la tabla ODS.

Debe tener en cuenta los siguientes detallesal correlacionar dimensiones con lascaracterísticas:

v No tiene que correlacionar una dimensióncon cada columna de la característica dela tabla ODS. Puede que algunascolumnas no tengan una dimensión TM1correspondiente cuando termine con lacorrelación. En ese caso, cualquiercolumna de la característica que no estécorrelacionada se vaciará al finalizar laexportación.

v No debería correlacionar una únicadimensión TM1 con varias columnas de latabla de características de ODS. Lainterfaz de usuario de TurboIntegrator nole impide hacerlo, pero tal correlacióndará como resultado valores de columnaredundantes en la tabla ODS.

v Cuando correlaciona una dimensión detítulo de vista TM1 con una característicay la dimensión de título no utiliza unsubconjunto con nombre, solo seexportará a la tabla ODS el últimoelemento del actual subconjunto de títulosin nombre. Si la dimensión de título síutiliza un subconjunto con nombre, todoslos elementos del subconjunto se exportana la tabla ODS.

Seleccionar medida Se presupone que la última dimensión de lavista del cubo de origen es la dimensión demedidas. Cuando correlaciona unadimensión de medidas con una columna dela tabla ODS, se habilita el botón Seleccionarmedida.

Seleccione el único elemento que secorrelaciona directamente con la columna decifras clave de la tabla ODS

Si su tabla ODS incluye una única columnade cifras clave, también puede utilizar lacifra clave alternativa.


Campo Descripción

Dimensión TM1 Si su tabla ODS incluye una única columnade cifras clave, puede utilizar la opción_TM1CellValue_ para correlacionar valoresde cubo TM1 con la tabla ODS. No puedeutilizar la opción _TM1CellValue_ si su tablaODS contiene varias columnas de cifrasclave.

Para utilizar esta opción, no correlacione ladimensión de medidas de TM1 con lacolumna de cifras clave. En su lugar, pulsela columna Dimensión TM1 y seleccione_TM1CellValue_.

Cuando utiliza este método alternativo paracorrelacionar valores del cubo TM1 , ladimensión de medidas de TM1 no deberíacorrelacionarse con ninguna columna ODS.

Moneda

Campo Descripción

Moneda de SAP Se utiliza para importar datos de moneda aun cubo tridimensional nuevo o existente desu servidor.

Mostrar nombres técnicos SAP Para utilizar nombres técnicos, seleccioneesta casilla de verificación. Deje esta casillasin marcar para mostrarlos según su nombredescriptivo.

Introducir nombre del cubo Introduzca un cubo tridimensional existenteo introduzca un nuevo nombre para el cubo.

Moneda DESDE Seleccione la moneda inicial que deseeimportar desde SAP.

La lista de monedas disponibles refleja lasmonedas definidas en su sistema SAP.

Dimensión de destino Especifique la dimensión TM1 que recibiránlas cadenas de moneda de SAP.

Moneda A Seleccione la segunda moneda que deseeimportar desde SAP.

Tipo de conversión Seleccione el método de conversión queutilizará para convertir la moneda inicial enla segunda moneda.


Cognos TM1Utiliza una dimensión o un cubo IBM Cognos TM1 como origen de datos.

Campo Descripción

Vista de cubo

Subconjunto de dimensiones

Utilice el botón Examinar para seleccionaruna dimensión o una vista TM1 disponibleque desee utilizar como origen de datos.Pulse el botón Vista previa. A continuación,complete los campos de las demás pestañas.

IBM Cognos Package ConnectorIndica que el origen de datos es un paquete de IBM Cognos publicado creado apartir de una consulta SAP.

Paquete

Campo Descripción

Conexión Defina la conexión con este origen de datos.

Espacio de nombres deautenticación

Muestra todos los espaciosde nombres de IBM Cognoscreados que se encuentrandisponibles actualmente.

ID de usuario Contraseña

Paquete Seleccionar paquete Pulse el botón Examinar paraseleccionar un paquetepublicado disponible.


Si está importando los datosdirectamente en un cuboTM1 existente, introduzcaaquí el nombre del cubo outilice el menú desplegable.

Acción de datos, Acción decubo, Activar registro decubos

Consulte las descripciones deestos campos en el cubo deinformación de SAP anterior.

Dimensión

Campo Descripción

Dimensión Paquete Identifique el paquete quedesea utilizar para estadimensión.

Dimensión para cargar desde Identifique la dimensión quedesee utilizar.


Campo Descripción

Dimensión para cargar en Identifique la dimensión enla que desee importar.

Acción de dimensión TM1 Consulte la descripción de lapestaña Características paraobtener más información.

Recuperar los valores deseguridad

Utilice la seguridad de ladimensión.

Consolidación superior Nombre de unaconsolidación de nivelsuperior de la dimensiónTM1 con todos los elementosimportados como hijos de laconsolidación.

Seleccionar jerarquías Seleccione y correlacione lasjerarquías que desea utilizaren esta importación y definael modo en el que deseacorrelacionarlas con la nuevadimensión TM1 . Consulte laguía de IBM Cognos TM1TurboIntegrator Guide paraobtener informacióndetallada.

Seleccionar atributos Seleccione los atributos quedesee utilizar y defina lacorrelación. Consulte la guíade IBM Cognos TM1TurboIntegrator Guide paraobtener informacióndetallada.

NingunaSe utiliza para añadir un prólogo definido por el usuario a un proceso.

Si el origen de datos del proceso es Ninguna, TurboIntegrator ejecutarinmediatamente el procedimiento de Epílogo tras finalizar el procesamiento delPrólogo.

Nota: cuando el origen de datos de un proceso es Ninguna, se ignoran losprocedimientos de Metadatos y Datos. En este caso, todos los scripts para elproceso deben crearse en los procedimientos de Prólogo o Epílogo.

Vista previa de cuadrículaLa vista previa de cuadrícula muestra los primeros diez registros de su origen dedatos. Utilice esta cuadrícula para confirmar que la fuente es correcta y paraayudar a determinar la estructura de los registros.


Si cambia su origen de datos, pulse de nuevo en Vista previa para actualizar lavisualización de la cuadrícula.

Pestaña VariablesLa pestaña Variables incluye una cuadrícula y dos botones.

Cuadrícula

Utilice la cuadrícula Variables para asignar variables e identificar el contenido decada columna en su origen de datos. La cuadrícula Variables incluye las siguientescolumnas.


ID de columna Enumera cada columna o campo exclusivoidentificado en su origen de datos. Lasceldas de esta columna no pueden editarse.

Nombre de variable Contiene una variable creadaautomáticamente para cada columna de suorigen de datos. Todas las variables creadasse denominan Vn, donde n es 0 en laprimera columna y se incrementa en 1 encada columna posterior de la fuente.

Para asignar una variable diferente, pulse lacelda adecuada e introduzca la nuevavariable.

Tipo de variable Contiene una lista para cada columna de suorigen de datos. Utilice la lista paraespecificar si una variable es de cadena onumérica.

Valor de muestra Contiene valores de muestra del primerregistro de su fuente. Estos valores demuestra le ayudan a identificar el contenidode cada columna de su fuente. Las celdas dela columna Valor de muestra no puedeneditarse.

Contenido Contiene una lista para cada columna de suorigen de datos. Utilice la lista paraespecificar el tipo de valor contenido encada columna de su fuente.

Fórmula Esta columna está atenuada en todos loscampos de su fuente, y está disponible sóloal crear una nueva variable.

Al crear una nueva variable, efectúe unadoble pulsación en la celda Fórmulaasociada para abrir el cuadro de diálogoFórmula de variables del proceso, en el quepuede definir una fórmula para la variable.

Botones

Botón Descripción

Nueva variable Pulse el botón del ratón para crear unanueva variable.


Botón Descripción

Borrar Pulse el botón del ratón para borrar unavariable creada por el usuario.

Fórmula de variables del procesoEl cuadro de diálogo Fórmula de variables del proceso muestra las fórmulasutilizadas en un proceso de TurboIntegrator y permite su edición. Si existe unafórmula y pulsa Fórmula en la pestaña Variables, la fórmula establecidaactualmente se muestra en la ventana Fórmula. Pulse Nueva variable para definiruna fórmula nueva.


Fórmula La fórmula entrada actualmente se muestraen esta ventana. Esta ventana se actualiza amedida que se especifica texto de fórmula.

Destino Elija la ubicación de esta fórmula en funciónde las necesidades de programación paraeste proceso. Seleccione Datos para colocaresta fórmula en la sección Datos del procesode TurboIntegrator. Seleccione Metadatospara colocar la fórmula en la secciónMetadatos. Si se seleccionan ambas opciones,la fórmula se coloca en las dos ubicaciones.

Evaluar Pulse aquí para validar la fórmula.

Valor de muestra Cuando la fórmula se evalúa, aquí semuestra información sobre la fórmula. Porejemplo, Línea 1: Error de sintaxis antes odespués: \n (final de línea) falta el punto ycoma.

Mostrar automáticamente cada vez quecambie el nombre de la variable

Pulse aquí para mostrar este cuadro dediálogo si se cambia el nombre de lavariable. Si el cuadro no está marcado, debesolicitarlo manualmente pulsando el cuadroFórmula de la pestaña Variables.

Pestaña CorrelacionesUtilice la pestaña Correlaciones para especificar cómo se correlacionan los datos deorigen con cubos, dimensiones, datos, consolidaciones y atributos de la base dedatos TM1 .

La pestaña Correlaciones se compone de una serie de subpestañas, cada una de lascuales contiene opciones que le permiten correlacionar variables de los datos deorigen con estructuras de metadatos TM1 existentes. Las subpestañas disponiblesvarían en función del tipo de valores contenidos en los datos de origen, tal y comose especifica en la columna Contenido de la pestaña Variables.

La pestaña Correlaciones contiene las siguientes subpestañas.

Cubo

Utilice la subpestaña Cubo para especificar cómo correlaciona TurboIntegratordatos importados a cubos TM1 . La subpestaña Cubo incluye las siguientesopciones.



Acción de cubo Seleccione una opción para crear, actualizar,volver a crear o no aplicar ninguna acción aun cubo.

Nombre de cubo Especifique el cubo al que se aplica laacción.

Si crea un nuevo cubo, introduzca el nombredel cubo en el campo de entrada. De locontrario, seleccione un cubo existente en lalista.

Porción puesta a cero Esta opción se habilita cuando selecciona laacción Actualizar cubo. Seleccione estecuadro si desea que todos los puntos dedatos de una vista de cubo sean cero.

Nombre de vista Esta opción se habilita al seleccionar lasopcionesActualizar cubo y Porción depuesta a cero.

Seleccione o defina la vista que englobe lospuntos de datos que desee poner a cero.

Acción de datos Seleccione una opción que determine cómose almacenarán en el cubo los datosprocesados.

La opción Almacenar valores sustituye losvalores del cubo existentes por valoresimportados a través del proceso.

La opción Acumular valores añade valoresimportados por el proceso a los valores delcubo existentes.

Activar conexión de cubos Marque esta casilla de verificación paraescribir los cambios realizados en los cubosen el archivo Tm1s.log. Desmarque estacasilla para procesar los cubos sin registrarlos cambios en Tm1s.log.

Dimensiones

Utilice la subpestaña Dimensiones para correlacionar variables de elementos conelementos de dimensiones.

La subpestaña incluye una cuadrícula que puede utilizar para correlacionarvariables individuales con dimensiones de la base de datos TM1 . La cuadrículaincluye las siguientes columnas.



Variable de elemento Contiene el nombre de cada variable para laque especificó un valor Contenido deElemento. El valor Contenido se especificaen la pestaña Variables.

Esta columna también contiene la etiqueta(Variables de datos) de las variables con unvalor Contenido de Datos.

Valor de muestra Un valor de muestra del primer registro desu origen de datos. Utilice este valor paraayudar a identificar la dimensión con la quese va a correlacionar la variable de elemento.

Dimensión Enumera todas las dimensiones disponiblesen el servidor. Seleccione la dimensión conla que se va a correlacionar la variable deelemento.

Para correlacionar la variable de elementocon una nueva dimensión, introduzca elnuevo nombre de dimensión en el campo deentrada.

Orden en el cubo Esta opción se habilita cuando la acción delcubo es Crear.

Especifique el orden de cada dimensión delcubo que está creando.

Acción Enumera las acciones de las dimensionesdisponibles. Seleccione una acción.

Para crear una nueva dimensión, debeespecificar una acción de Crear.

Tipo de elementos Seleccione un tipo de elemento para lavariable, ya sea Numérico o De cadena.

Orden de elementos Seleccione una opción para clasificar loselementos de cualquier dimensión que estécreando o actualizando. Existen cuatroórdenes de clasificación:

Entrada: clasifica los elementos en el ordenen que se crearon en la dimensión.

Nombre: clasifica los elementos en ordenalfabético, ya sea ascendente o descendente.

Nivel: clasifica los elementos por ordenjerárquico, ya sea ascendente o descendente.

Jerarquía: ordena los elementos tal y comoaparecen en la jerarquía de dimensión.


Datos

Utilice la subpestaña Datos para correlacionar variables de datos con elementosespecíficos.

La subpestaña incluye una cuadrícula que puede utilizar para correlacionarvariables individuales con elementos de la base de datos TM1 . La cuadrículaincluye las siguientes columnas.


Variable de datos Contiene el nombre de cada variable en laque especificó un valor Contenido de Datos.El valor Contenido se especifica en lapestaña Variables.

Elemento Pulse el botón de flecha hacia la derechapara abrir el Editor de subconjuntos, en elque puede seleccionar el elemento con elque se va a correlacionar la variable.

Para correlacionar la variable con un nuevoelemento, introduzca el nombre de elementoen el campo de entrada.

Tipo de elementos Seleccione un tipo de elemento aquí.

Valor de muestra Un valor de muestra del primer registro desu origen de datos. Utilice este valor paraayudar a identificar el elemento con el quese va a correlacionar la variable de datos.

Consolidaciones

Utilice la subpestaña Consolidaciones para correlacionar hijos con elementosconsolidados.



Variable cons. Contiene el nombre de cada variable en laque especificó un valor Contenido deConsolidación. El valor Contenido seespecifica en la pestaña Variables.

Dimensión Lista de dimensiones con las que puedecorrelacionarse la consolidación.

Variable de hijo Enumera las variables en las que puedeseleccionar el hijo inmediato de laconsolidación.



Peso Asigna un peso a la variable de hijoespecificada.

Valor de muestra Un valor de muestra del primer registro desu origen de datos. Utilice este valor paraayudar a identificar el elemento con el quese va a correlacionar la consolidación.

Orden de elementos Seleccione una opción para clasificar loselementos de cualquier consolidación queesté creando o actualizando. Existen cuatroórdenes de clasificación:

Entrada: clasifica los elementos en el ordenen que se crearon en la dimensión.

Nombre: clasifica los elementos en ordenalfabético, ya sea ascendente o descendente.

Nivel: clasifica los elementos por ordenjerárquico, ya sea ascendente o descendente.

Jerarquía: ordena los elementos tal y comoaparecen en la jerarquía de dimensión.

Atributos

Utilice la subpestaña Atributos para correlacionar variables de atributos conatributos específicos.



Variable de atributo Contiene el nombre de cada variable en laque especificó un valor Contenido deAtributo. El valor Contenido se especifica enla pestaña Variables.

Valor de muestra Muestra un valor de muestra del origen dedatos. Utilice esta muestra para ayudar acorrelacionar el atributo.

Dimensión Enumera todas las dimensiones disponiblesen el servidor. Seleccione la dimensión a laque se va a aplicar el atributo.

Variable de elemento Enumera las variables de elementos.Seleccione la variable del elemento a la quese va a aplicar la variable de atributo.



Atributo Enumera los atributos con los que puedecorrelacionarse la variable. Seleccione elatributo adecuado en esta lista.

Acción Seleccione Crear un nuevo atributo oActualizar uno existente.

Tipo de atributo Identifica el tipo de atributo seleccionado enla columna Atributo.

Pestaña AvanzadoLa pestaña Avanzado contiene varias subpestañas que muestran sentencias creadaspor TM1 en función de las opciones que seleccione en el Editor de TurboIntegrator.La pestaña Avanzado también incluye una subpestaña en la que puede definirparámetros del proceso.

Parámetros


Insertar Pulse el botón del ratón para insertar unnuevo parámetro.

Borrar Pulse el botón del ratón para borrar unparámetro seleccionado.

Parámetros Introduzca un nombre para cada nuevoparámetro.

Tipo Para cada parámetro, seleccione un tipoaquí.

Valor predeterminado Especifique un valor para utilizarlo comovalor predeterminado para este parámetrocuando se ejecute el proceso deTurboIntegrator.

Realizar pregunta Especifique una solicitud para utilizarla coneste parámetro cuando se ejecute el procesode TurboIntegrator.


Prólogo


Cuadro de texto Sentencia Muestra las sentencias creadas que definenuna serie de acciones que se ejecutarán antesde procesar el origen de datos.

Puede mejorar un proceso creandosentencias adicionales con reglas o funcionesTurboIntegrator.

Botón Ir a la línea Pulse este botón, introduzca la línea a la quedesea ir y, a continuación, pulse Aceptarpara ir directamente a una línea de códigoen el cuadro de texto sentencias.

Metadatos


Cuadro de texto Sentencia Muestra las sentencias creadas que definenuna serie de acciones que se ejecutarán enlos metadatos TM1 antes de procesar elorigen de datos.



Datos


Cuadro de texto Sentencia Muestra las sentencias creadas que definenuna serie de acciones que se ejecutarán alprocesar el origen de datos.




Epílogo


Cuadro de texto Sentencia Muestra las sentencias creadas que definenuna serie de acciones que se ejecutarán trasprocesar el origen de datos.



Pestaña PlanificaciónUtilice esta pestaña para planificar un proceso que se va a ejecutar a intervalosregulares.


Planificar este proceso como tarea connombre

Marque esta opción para ejecutar esteproceso como tarea a intervalos regulares.De forma predeterminada, la tarea lleva elmismo nombre que el proceso. Si deseaasignar a la tarea un nombre diferente,escríbalo en el campo de entrada.

Fecha y hora de inicio de la tarea Seleccione una fecha de inicio en elcalendario y especifique una hora de inicioen el campo Hora.

Frecuencia de ejecución de tareas Rellene los campos adecuados paraestablecer el intervalo con el que debeejecutarse la tarea.

Ventana Extracción de vistasUtilice la ventana Extracción de vistas para crear una vista que incluya únicamenteaquellos valores que cumplan los criterios definidos por el usuario, o bien paradefinir una vista para exportar.

Omitir parámetros

Parámetro Descripción

Omitir valores consolidados Active esta opción para ignorar los valoresderivados de la consolidación al extraer lavista. Desactive esta opción para incluir losvalores derivados de la consolidación alextraer la vista. El valor predeterminado esDesactivado.



Omitir valores calculados según reglas Active esta opción para ignorar los valoresderivados de reglas al extraer la vista.Desactive esta opción para incluir los valoresderivados de reglas al extraer la vista. Elvalor predeterminado es Desactivado.

Omitir valores cero/en blanco Active esta opción para ignorar los valorescero o en blanco al extraer la vista. Desactiveesta opción para incluir los valores cero o enblanco al extraer la vista. El valorpredeterminado es Activado.

Parámetros de rango


Operador Seleccione un operador que defina losvalores que desee extraer.

Límites numéricos Introduzca un valor numérico para lasvariables del Operador.

Límites de texto Introduzca un valor de cadena para lasvariables del Operador.

Selección de elementos de dimensión

En cada dimensión, pulse el botón Subconjunto y seleccione los elementos oel subconjunto que definan los parámetros de la extracción de vistas.

Si la vista contiene más de 16 dimensiones, pulse para retroceder las páginas

necesarias hasta las 16 dimensiones anteriores, o pulse para adelantar laspáginas hasta las 16 dimensiones siguientes.

Cuadro de diálogo Estilos de vistaEl cuadro de diálogo Estilos de vista le permite aplicar estilos de Excel a una vistadel cubo TM1 en el Navegador de hojas de cálculo. El cuadro de diálogo contienevarias listas que le permiten aplicar un estilo de Excel existente a un rango deceldas, así como botones que le permiten editar o crear estilos.


Fondo Seleccione un estilo de esta lista para aplicaral fondo del Navegador de hojas de cálculo.

Celdas de datos Seleccione un estilo en esta lista para aplicara celdas de datos.

El estilo Celdas de datos tiene prioridadsobre el estilo Fondo.



Celdas de la cabecera de fila Seleccione un estilo en esta lista para aplicara celdas de la cabecera de fila.

El estilo Celdas de la cabecera de fila tieneprioridad sobre el estilo Fondo.

Celdas de la cabecera de columna Seleccione un estilo en esta lista para aplicara celdas de la cabecera de columna.

El estilo Celdas de la cabecera de columnatiene prioridad sobre el estilo Fondo.

Botones Editar estilo Pulse el botón Editar estilo adecuado paraeditar o crear estilos para el rango asociadodel Navegador de hojas de cálculo.

Inmovilizar paneles Active o desactive esta opción parainmovilizar y liberar los paneles delNavegador de hojas de cálculo.

Al activar esta opción, los nombres deelementos de fila permanecerán visiblescuando se desplace horizontalmente a travésde una vista, y los nombres de elementos decolumna permanecerán visibles cuando sedesplace verticalmente.

Al desactivar esta opción, los nombres deelementos de fila y columna se moveránjunto con los valores del cubo cuando sedesplace a través de una vista.


Capítulo 3. Funciones de reglas

Esta sección contiene una lista completa de todas las funciones de reglas de IBMCognos TM1 . Puede utilizar cualquiera de estas funciones al escribir las reglasTM1 .

Puede también incorporar todas las funciones de reglas, a excepción de lasfunciones STET e ISLEAF, en los procesos de TurboIntegrator.

Operadores aritméticos de las reglas TM1Los siguientes operadores matemáticos pueden utilizarse en la construcción dereglas TM1 .

Operador Significado

+ (signo más) Suma

- (signo menos) Resta

* (asterisco) Multiplicación

/ (barra diagonal) La división por cero utilizando esteoperador devuelve un valor no definido.

\ (barra invertida) La división por cero utilizando esteoperador devuelve cero.

^ (signo de intercalación/acento circunflejo) Exponenciación

Operadores de comparación de las reglas TM1Los operadores de comparación comparan valores de la parte de la fórmula de unasentencia de cálculo de reglas.

Operador Significado

> Mayor que

< Menor que

>= Mayor o igual a

<= Menor o igual a

= Igual a

<> No igual a


Para comparar dos valores de cadena, inserte el símbolo @ antes del operador decomparación, tal y como se muestra en el siguiente ejemplo:

IF ('A' @= 'B',0,1) produce el número 1.

Operadores lógicos de las reglas TM1Puede combinar expresiones en una sentencia de cálculo de reglas utilizandooperadores lógicos.

Operador Significado Ejemplo

& (signo ampersand) AND (Value1 > 5) & (Value1 < 10)Devuelve TRUE si el valor esmayor que 5 y menor que 10.

% (signo de porcentaje) OR (Value1 > 10) % (Value1 < 5)Devuelve TRUE si el valor esmayor que 10 o menor que 5.

~ (virgulilla) NOT ~(Value1 > 5) Equivalente a(Value1 <= 5)

Función de reglas de cálculo de consolidaciónLas funciones ConsolidatedMax; ConsolidatedMin; ConsolidatedAvg;ConsolidatedCount; y Consolidated CountUnique realizan cálculos matemáticossobre las consolidaciones.

ConsolidatedMinConsolidatedMin calcula el valor mínimo en una consolidación y devuelve unvalor único.

Se trata de una función de TM1 Rules, válida en los procesos de RulesTurboIntegrator.

SintaxisConsolidatedMin(flag-value, cube-name, element_1, element_2,... );

Argumentos

flag-value

El valor de distintivo es la suma de los valores siguientes:

1 - Utilizar ponderación de consolidación al calcular este valor. Si no se activa,se utilizará el valor sin formato del elemento consolidado. �

2 - Pasar por alto valores cero. Si se establece, los valores cero no se utilizaránpor parte de estas funciones.

Nota: Si se especifica cero como la ponderación de algunos elementosconsolidados, el parámetro de configuración: ZeroWeightOptimization=F debeestablecerse para estos elementos a fin de factorizarse en el cálculo de estasfunciones. Sin este parámetro de configuración, los elementos para los que la


ponderación es cero se eliminan de la lista de consolidaciones y, por lo tanto,no se procesan cuando el descubrimiento alinea el valor mínimo o máximo.

cube-name

Nombre del cubo en el que residen los valores.

Si la función se está ejecutando como parte de una regla de cubo y no comoparte de un proceso de Turbo Integrator, el argumento cube-name puedeespecificarse como una cadena vacía para indicar el cubo actual. Esto significaque puede escribir una regla como la siguiente: [’Apr’]=ConsolidatedMin( 1,’’, !actvsbud, ’1 Quarter’ );

element_1, element_2, ...

Los nombres de elementos de dimensiones que definen la intersección del cuboque incluye el valor que desea recuperar.

Los argumentos de element_1 a element_n distinguen secuencias. element_1debe ser un elemento de la primera dimensión del cubo, element_2 debe serun elemento de la segunda dimensión, etc. Estos argumentos pueden sertambién los nombres de alias de elementos de dimensiones o variables deTurboIntegrator.

ConsolidatedMaxConsolidatedMax calcula el valor máximo en una consolidación y devuelve unvalor único.


SintaxisConsolidatedMax(flag-value, cube-name, element_1, element_2,... );

Argumentos

flag-value




Nota: Si se especifica cero como la ponderación de algunos elementosconsolidados, el parámetro de configuración: ZeroWeightOptimization=F debeestablecerse para estos elementos a fin de factorizarse en el cálculo de estasfunciones. Sin este parámetro de configuración, los elementos para los que laponderación es cero se eliminan de la lista de consolidaciones y, por lo tanto,no se procesan cuando el descubrimiento alinea el valor mínimo o máximo.

cube-name


Si la función se está ejecutando como parte de una regla de cubo y no comoparte de un proceso de Turbo Integrator, el argumento cube-name puedeespecificarse como una cadena vacía para indicar el cubo actual. Esto significaque puede escribir una regla como la siguiente: [’Apr’]=ConsolidatedMax( 1,’’, !actvsbud, ’1 Quarter’ );

Capítulo 3. Funciones de reglas 113




Ejemplo

Supongamos que tiene un cubo denominado Declaración de ingresos con tresdimensiones, "Área", "Tiempo" y "Declaración de ingresos". La dimensiónDeclaración de ingresos contiene un elemento "Ingresos por ventas brutos" para elnúmero global de ventas.

Para calcular el máximo de ventas en todas regiones en el año 2010, utilice:ConsolidatedMax( 1, ’Income Statement’, ’All Regions’, ’2010’, ’Gross Sales’ );

ConsolidatedAvgConsolidatedAvg calcula el valor promedio en una consolidación y devuelve unvalor único.


SintaxisConsolidatedAvg(flag-value, cube-name, element_1, element_2,... );

Argumentos

flag-value





cube-name


Si la función se está ejecutando como parte de una regla de cubo y no comoparte de un proceso de Turbo Integrator, el argumento cube-name puedeespecificarse como una cadena vacía para indicar el cubo actual. Esto significaque puede escribir una regla como la siguiente: [’Apr’]=ConsolidatedAvg( 0,’’, !actvsbud, ’1 Quarter’ );





Ejemplo

En un cubo denominado Declaración de ingresos con tres dimensiones, Regiones,Tiempo y Declaración de ingresos, la dimensión Declaración de ingresos contieneun elemento denominado Ingresos por ventas brutos para el número global deventas.

Para calcular el promedio de ventas en todas regiones en el año 2010, escriba:ConsolidatedAvg( 1, ’Income Statement’, ’All Regions’, ’2010’, ’Gross Sales’ );

ConsolidatedCountConsolidatedCount cuenta el valor en una consolidación y devuelve un valorúnico.


SintaxisConsolidatedCount(flag-value, cube-name, element_1, element_2,... );

Argumentos

flag-value





cube-name


Si la función se está ejecutando como parte de una regla de cubo y no comoparte de un proceso de Turbo Integrator, el argumento cube-name puedeespecificarse como una cadena vacía para indicar el cubo actual. Esto significaque puede escribir una regla como la siguiente: [’Apr’]=ConsolidatedCount(1, ’’, !actvsbud, ’1 Quarter’ );





ConsolidatedCountUniqueConsolidatedCountUnique cuenta el número de elementos exclusivos para los queexisten realmente puntos de datos para la consolidación especificada.


Los elementos exclusivos se cuentan en una dimensión de la celda consolidada.

SintaxisConsolidatedCountUnique( 0, unique-along-dimension-name, cube-name,elem_1, elem_2, . . . );

Argumentos

flag wordActualmente especifique cero.


unique-along-dimension-nameDimensión en la que deben encontrarse entradas de elementos exclusivos paralos que existen datos reales.

cube-name


Si la función se está ejecutando como parte de una regla de cubo y no comoparte de un proceso de Turbo Integrator, el argumento cube-name puedeespecificarse como una cadena vacía para indicar el cubo actual.


Nombres de elementos de dimensiones que definen la intersección del cubopara el que se debe procesar el valor consolidado.



Ejemplo

En un cubo denominado Declaración de ingresos con tres dimensiones, Regiones,Tiempo y Declaración de ingresos, la dimensión Declaración de ingresos contieneun elemento denominado Ingresos por ventas brutos para el número global deventas. Para contar cuántas regiones han tenido unos determinados ingresos porventas brutos en el año 2010, escriba:ConsolidatedCountUnique( 0, ’Regions’, ’Income Statement’,’All Regions’, ’2010’, ’Gross Sales’ );

Funciones de reglas de atributosFunciones de regla que funcionan con atributos.

ATTRNATTRN devuelve un atributo numérico para un elemento especificado de unadimensión.

Esta función es válida en los procesos de reglas de TM1 y TurboIntegrator.

SintaxisATTRN(dimension, element, attribute)

Argumento Descripción

dimension Un nombre de dimensión válido.

element Un elemento de la dimensión.

attribute El atributo para el que desea recuperar unvalor. Este argumento debe ser un atributoválido del elemento.Nota: Al utilizar esta función en unasentencia condicional (IF), la sentencia es laparte que contiene la condición, no todo elbloque condicional. Después de un errorleve, la ejecución continúa con la siguientesentencia. El procesamiento de TI no sabeque se encontraba en una sentenciacondicional una vez procesado el error leve,por lo que la siguiente sentencia es lasiguiente línea, no la línea posterior a endif.

Para evitar esta situación, utilice variables enlas operaciones que pudiesen producir unerror leve y, a continuación, utilice lasvariables en la sentencia condicional. Porejemplo:

V1 = CELLGETN(’PNLCube’, ’fred’,’argentina’,’Sales’,’Jan’);IF(V1 = 454);ASCIIOUTPUT(’bug.txt’, ’if logic not workingproperly’);

ENDIF;


Ejemplo

ATTRN('Model', 'L Series 1.8L Sedan', 'Engine Size')

En este ejemplo, la función devuelve el valor numérico del atributo Engine Size delelemento L Series 1.8L Sedan de la dimensión Model.

ATTRSATTRS devuelve un atributo de cadena para un elemento especificado de unadimensión.


SintaxisATTRS(dimension, element, attribute)




attribute El atributo para el que desea recuperar unvalor. Este argumento debe ser un atributoválido del elemento.

Ejemplo

ATTRS('plan_business_unit', '10100', 'Currency')

En este ejemplo, la función devuelve el valor de cadena del atributo Currency delelemento 10100 de la dimensión plan_business_unit.

CubeATTRNCubeATTRN devuelve un atributo numérico para un cubo especificado.


SintaxisCubeATTRN(CubeName, AttrName);


CubeName Un nombre de cubo válido.

AttrName El atributo para el que desea recuperar unvalor. Este argumento debe ser un atributoválido del cubo.

Ejemplo

CubeATTRN(’Product’, ’Accounting_Code’);


En este ejemplo, la función devuelve el valor numérico del atributoAccounting_Code del cubo Product.

CubeATTRSCubeATTRS devuelve un atributo de cadena para un cubo especificado.


SintaxisCubeATTRS(CubeName, AttrName);




Ejemplo

CubeATTRS(’Product’, ’Owner’);

En este ejemplo, la función devuelve el valor de cadena del atributo Owner delcubo Product.

DimensionATTRNDimensionATTRN devuelve un atributo numérico para una dimensiónespecificada.


SintaxisDimensionATTRN(DimName, AttrName);


DimName Un nombre de dimensión válido.

AttrName El atributo para el que desea recuperar unvalor. Este argumento debe ser un atributoválido de la dimensión.

Ejemplo

DimensionATTRN(’Plan_Business_Unit’, ’Accounting_Code’);

En este ejemplo, la función devuelve el valor numérico del atributoAccounting_Code de la dimensión Plan_Business_Unit.


DimensionATTRSDimensionATTRS devuelve un atributo de cadena para una dimensiónespecificada.


SintaxisDimensionATTRS(DimName, AttrName);




Ejemplo

DimensionATTRS(’Plan_Business_Unit’, ’Manager’);

En este ejemplo, la función devuelve el valor de cadena del atributo Manager de ladimensión Plan_Business_Unit.

Funciones de reglas de datos de cuboFunciones de regla que funcionan con datos de cubo.

DBDB devuelve un valor de un cubo de una base de datos TM1 . DB devuelve unvalor numérico si se utiliza en una expresión numérica y un valor de cadena si seutiliza en una expresión de cadena.

Se trata de una función de reglas TM1 , válida únicamente en reglas TM1 . El usode esta función en un proceso TurboIntegrator provocará un error.

SintaxisDB(cube, e1, e2, [...e256])

Parámetros

cube

El nombre del cubo del que se va a recuperar el valor.

e1,...en

Nombres de elementos de dimensiones que definen la intersección que incluyeel valor que desea recuperar.

Los argumentos de e1 a en distinguen secuencias. e1 debe ser un elemento dela primera dimensión del cubo, e2 debe ser un elemento de la segundadimensión, etc.


EjemploDB(’Budget’, ’California’, ’15" Flat Panel Monitors’, ’Net Sales’, ’January’)

En este ejemplo, Budget es el nombre del cubo, y la función devuelve el valor de laintersección de California, 15" Flat Panel Monitors, Net Sales y January.

ISLEAFISLEAF devuelve 1 si una celda especificada es una celda de hoja (identificadaúnicamente por elementos de hoja/simples). Si la celda especificada estáidentificada por cualquier elemento consolidado, la función devolverá 0.

Se trata de una función de reglas TM1 , válida sólo en reglas TM1 .

La función ISLEAF no puede utilizarse en procesos de TurboIntegrator. Lapresencia de esta función en un proceso impedirá la compilación del mismo.

SintaxisISLEAF

Argumentos

Ninguno.

Ejemplo

Puede utilizar ISLEAF en una sentencia IF para probar si una celda actual es unacelda de hoja. Por ejemplo:[]=IF((ISLEAF=1),TrueStatement, FalseStatement);

Ejecuta TrueStatement si la celda actual es una celda de hoja; de lo contrario,ejecuta FalseStatement.

ISUNDEFINEDCELLVALUEISUNDEFINEDCELLVALUE compara el valor transferido del valor de cubonumérico, que se ve influido por la presencia de la declaración UNDEFVALS en laregla de ese cubo.La función devuelve 1 si el valor transferido equivale al valorpredeterminado del cubo; de lo contrario, la función devuelve 0.

Se trata de una función de reglas de TM1, válida tanto en reglas de TM1 como enprocesos de TurboIntegrator.

Sintaxis

ISUNDEFINEDCELLVALUE(TestValue, <Cube>)

Argumentos


TestValue El valor numérico para comparar con el valor predeterminado delcubo.



Cubo Un argumento de cadena opcional que especifica el cubo cuyo valorpredeterminado se debe comparar.

Cuando se utiliza ISUNDEFINEDCELLVALUE en una regla, se asumeque el cubo es el cubo objeto salvo que se especifique otra cosa.

Cuando se utiliza en un TI, es necesario especificar un cubo.

Si el cubo se omite en un TI, o no es válido al especificarse, seutilizará 0 para la comparación.

Ejemplo

ISUNDEFINEDCELLVALUE(TestValue) devuelve 1 cuando TestValue es el valor sindefinir especial y se utiliza en la regla de un cubo con UNDEFVALS declarado.

UNDEFUNDEF devuelve el valor no definido. Esta función puede utilizarse para impedirque los datos se almacenen en un cubo según una prueba lógica.

Se trata de una función de reglas TM1 , válida tanto en reglas TM1 como enprocesos de TurboIntegrator.

SintaxisUNDEF

Argumentos

Ninguno.

Ejemplo

UNDEF devuelve el valor no definido.

UNDEFINEDCELLVALUEUNDEFINEDCELLVALUE devuelve el valor de cubo numérico, que se ve influidopor la presencia de la declaración UNDEFVALS en la regla de ese cubo.

Se trata de una función de reglas de TM1, válida tanto en reglas de TM1 como enprocesos de TurboIntegrator.

Sintaxis

UNDEFINEDCELLVALUE(<Cube>)


Argumentos


Cube Un argumento de cadena opcional que especifica el cubo cuyo valorpredeterminado se debe devolver.

Cuando se utiliza UNDEFINEDCELLVALUE en una regla, se asumeque el cubo es el cubo objeto salvo que se especifique otra cosa.

Cuando se utiliza en un proceso de TI, es necesario especificar uncubo.

Si el cubo se omite en un proceso de TI, o no es válido alespecificarse, se devolverá 0.

Ejemplo

UNDEFINEDCELLVALUE devuelve 0 cuando se utiliza en la regla de un cubos sinUNDEFVALS declarado, o cuando se utiliza en un proceso de TI.

UNDEFINEDCELLVALUE devuelve el valor sin definir especial cuando se utilizaen la regla de un cubo con UNDEFVALS declarado.

UNDEFINEDCELLVALUE(’ExampleCube’) devuelve el valor predeterminado'ExampleCube' o 0 si 'ExampleCube' no existe.

UNDEFVALSLa inclusión de UNDEFVALS en las reglas para un cubo cambia el valorpredeterminado del cubo, que es cero, por un valor no definido especial.

Se trata de una función de reglas TM1 , válida tanto en reglas TM1 como enprocesos TM1 TurboIntegrator.

Esto tiene ramificaciones que afectan al modo en que los datos se almacenan en elcubo y al modo en que se recuperan.v Almacenamiento de datos

En el caso de un cubo sin UNDEFVALS en las reglas, el valor predeterminado escero. Si se intenta almacenar un cero en una celda del cubo, esa solicitud dealmacenamiento se pasará por alto, ya que se está intentando almacenar el valorpredeterminado, y eso consumiría espacio de memoria de forma innecesaria.Si el cubo tiene UNDEFVALS definido en las reglas, el valor predeterminado seconvierte en un valor no definido especial. Ahora, cuando se almacena un cero enla celda de un cubo, se almacena realmente, como ocurriría con cualquier valordistinto de cero.

v Recuperación de datosEn el caso de un cubo sin UNDEFVALS en las reglas, el valor predeterminado escero. Cuando se recupera una celda y no hay ningún valor almacenadoactualmente para ese valor en el cubo, se devuelve el valor cero (como valorpredeterminado).Si el cubo tiene UNDEFVALS definido en las reglas, el valor predeterminado seconvierte en un valor no definido especial. Ahora, cuando se recupera una celdano existente, el valor recuperado será este valor no definido especial. Esto se puedeutilizar para distinguir una celda que no existe (valor no definido) de una celdaque sí existe pero cuyo valor es cero (se devuelve cero).


Nota: Actualmente no es posible probar en Turbo Integrator este valor nodefinido especial directamente. Este valor no definido especial no es el valordevuelto por la función UNDEF() de Turbo Integrator. El valor devuelto porUNDEF() es un valor no definido utilizado para acciones tales como el intentode dividir entre cero, calcular el logaritmo de un número no permitido, etc.

Puede probar de forma indirecta este valor no definido especial como se indica acontinuación:vv = CellGetN( ’cube-name’, elements-list);if ( vv >0 );

# ’special undefined’ value is greater than zero# convert the value to a stringvv_str = str(vv,20,16);# convert the string back to a numberconverted_vv = NUMBR( vv_str );if ( converted_vv = 0 );

#converted number is now zero, but original was non-zero#this is the ’special undefined’ value

Else#normal non-zero cell value

Endif;Endif;

SintaxisUNDEFVALS

Argumentos

Ninguno.

Funciones de reglas de fecha y horaFunciones de regla que funcionan con fechas y horas.

DATEDATE devuelve la cadena de fecha en formato aa-mm-dd o aaaa-mm-dd para undeterminado número de serie.


SintaxisDATE(SerialNumber, ReturnFourDigitYear)


SerialNumber Una fecha expresada en formato de serie.



ReturnFourDigitYear Un argumento booleano opcional que determina si lafunción DATE devuelve una cadena que utilice unanotación de dos o cuatro dígitos para el año.

Si ReturnFourDigitYear es true, la función devuelve unafecha que queda dentro del rango Jan. 1, 1960 - Dec. 31,9999, utilizando una notación de cuatro dígitos para elaño. La fecha de serie 0 corresponde a Jan. 1, 1960 y lafecha de serie 2936549 corresponde a Dec. 31, 9999.

Si ReturnFourDigitYear es false, o si este argumentoopcional se omite de la función DATE, la funcióndevuelve una fecha que queda dentro del rango Jan. 1,1960 - Dec. 31, 2059, utilizando una notación de dosdígitos para el año. La fecha de serie 0 corresponde a Jan1, 1960 y la fecha de serie 36524 corresponde a Dec. 31,2059.

Si ReturnFourDigitYear es falso o se omite y especificauna fecha de serie mayor que 36524, la fecha de serieutilizada por la función se determina mediante lafórmula n - 36525. Por ejemplo, si especifica una fechade serie de 36530, entonces 36530 - 36525 = 5. En estecaso, DATE utiliza 5 como la fecha de serie y devuelve lafecha Jan. 6, 1960.

Ejemplo

DATE(13947) devuelve 98-03-09.

DATE(13947, 1) devuelve 1998-03-09.

DATESDATES devuelve una cadena de fecha en formato "aa-mm-dd" o "aaaa-mm-dd",que corresponde a un determinado año, mes y día.


SintaxisDATES(year, month, day)


year Un año, expresado en formato aa o aaaa.

month Un mes, expresado en formato mm.

day Un día, expresado en formato dd.


Ejemplo

DATES(98, 2, 10) devuelve "10.02.98".

DATES(1998, 2, 10) devuelve "1998-02-10".

DAYDAY devuelve un valor numérico para el día en una determinada cadena de fecha.


SintaxisDAY(DateString)


DateString Una cadena de fecha en formatoAA-MM-DD o AAAA-MM-DD.

Ejemplo

DAY('02-05-25') devuelve 25.

DAYNODAYNO devuelve el número de fecha de serie que corresponde a una determinadacadena de fecha.


Nota: DAYNO puede devolver fechas de serie a partir del 1 de enero de 1960(cadena de fecha 1960-01-01 o 60-01-01). En lo que respecta a las fechas a partir del31 de diciembre de 2059, utilice un año de cuatro dígitos en la cadena de fecha.Por ejemplo, la cadena de fecha correspondiente al 5 de enero de 2061 sería2061-01-05.

SintaxisDAYNO(’DateString’)


DateString Una cadena de fecha en formatoAA-MM-DD o AAAA-MM-DD.

Ejemplo

DAYNO('98-03-09') devuelve 13947.


MONTHMONTH devuelve un valor numérico para el mes en una determinada cadena defecha.


SintaxisMONTH(date)


date Una cadena de fecha en formatoAA-MM-DD o AAAA-MM-DD.

Ejemplo

MONTH('02-05-25') devuelve 5.

NOWNOW devuelve el valor actual de fecha/hora en formato de número de serie.


SintaxisNOW

Argumentos

Ninguno.

Ejemplo

NOW devuelve el valor actual de fecha/hora en formato de número de serie.

TIMETIME devuelve una cadena, en formato HH:MM, que representa la hora delsistema del servidor TM1 .


SintaxisTIME

Argumentos

Ninguno.


Ejemplo

Si se proporciona una hora del sistema de 9:33 AM, TIME devuelve la cadena"09:33".

Si se proporciona una hora del sistema de 9:33 PM, TIME devuelve la cadena"21:33".

TIMSTTIMST devuelve una cadena de fecha/hora con formato.


SintaxisTIMST(datetime, format, ExtendedYears)

Argumento

Modificador/

Descripción

datetime Un número de serie de fecha/hora.

La parte entera del número especifica lafecha y la parte decimal especifica la horadel día. El número de día 0 corresponde a"60-01-01". Los números negativoscorresponden a años anteriores. Los años delsiglo XXI, hasta 2059, se representan poraños de 00 a 59. Una hora es laveinticuatroava parte de un día, un minutoes la sesentava parte de una hora y unsegundo es la sesentava parte de un minuto.

format Una cadena que da formato al resultado dela función. Todos los caracteres delargumento de formato aparecen en elresultado, a excepción de los siguientescaracteres, que devuelven valores decomponentes de fecha/hora:

\y

los últimos dos dígitos del año (97, 98, etc.)

\Y

los cuatro dígitos del año (1997, 1998, etc.)

\m

los dos dígitos del mes (de 01 a 12)

\M

la abreviatura del mes (JAN, FEB, etc.)


Argumento

Modificador/

Descripción

\d

los dos dígitos del día (de 01 a 31)

\D

el dígito del día (de 1 a 31)

\h

la hora en tiempo militar (de 00 a 23)

\H

la hora estándar (de 1 a 12)

\i

el minuto (de 00 a 59)

\s

el segundo (de 00 a 59)

\p

a.m. o p.m.


Argumento

Modificador/

Descripción

ExtendedYears Este parámetro booleano opcional especificasi la función devuelve una fecha que quedadentro del rango 1960 -2059 o 1960 - 9999.

Si ExtendedYears es true, la funcióndevuelve una fecha que queda dentro delrango Jan. 1, 1960 - Dec. 31, 9999. La fechade serie 0 corresponde a Jan. 1, 1960 y lafecha de serie 2936549 corresponde a Dec.31, 9999.

Si ExtendedYears es false, o si esteargumento opcional se omite de la funciónTIMST, la función devuelve una fecha quequeda dentro del rango Jan. 1, 1960 - Dec.31, 2059. La fecha de serie 0 corresponde aJan 1, 1960 y la fecha de serie 36524corresponde a Dec. 31, 2059.

Si ExtendedYears es falso o se omite yespecifica una fecha de serie mayor que36524, la fecha de serie utilizada por lafunción se determina mediante la fórmula n- 36525. Por ejemplo, si especifica una fechade serie de 36530, entonces 36530 - 36525 =5. En este caso, TIMST utiliza 5 como lafecha de serie y devuelve la fecha Jan. 6,1960.

Ejemplo

TIMST(366.0000, '\M \D, \Y') devuelve "JAN 1, 1961".

TIMST(366.5000, '\H\p \imin\ssec') devuelve "12p.m. 00min00sec".

TIMST(366.1000, 'On \M \D, \Y at \H\p \imin\ssec') devuelve "On JAN 1, 1961at 2a.m. 24min00sec".

TIMST(11111.1100, 'On \M \D, \Y at \H\p \imin\ssec') devuelve 'On JUN 3,1990at 2a.m. 38min24sec'.

TIMVLTIMVL devuelve el valor numérico de un componente (año, mes, etc.) de un valorde fecha/hora.



SintaxisTIMVL(datetime, type, ExtendedYears)

Argumento

Modificador y

Descripción

datetime Número de serie de fecha y hora.

La parte entera del número especifica lafecha y la parte decimal especifica la horadel día. El número de día 0 corresponde a"60-01-01". Los números negativoscorresponden a años anteriores. Los años delsiglo XXI, hasta 2059, se representan poraños de 00 a 59. Una hora es laveinticuatroava parte de un día, un minutoes la sesentava parte de una hora y unsegundo es la sesentava parte de un minuto.

type Un carácter que especifica el tipo decomponente que debe extraerse. Acontinuación, se indican argumentos typeválidos:

Y

valor year (1997, 1998, etc.)

M

valor month (de 1 a 12)

D

valor day (de 1 a 31)

H

valor hour (de 0 a 23)

C

valor minute (de 00 a 59)

S

valor second (de 00 a 59)


Argumento

Modificador y

Descripción

ExtendedYears Este parámetro booleano opcional especificasi la función devuelve una fecha que quedadentro del rango 1960 -2059 o 1960 - 9999.

Si ExtendedYears es true, la funcióndevuelve una fecha que queda dentro delrango Jan. 1, 1960 - Dec. 31, 9999. La fechade serie 0 corresponde a Jan. 1, 1960 y lafecha de serie 2936549 corresponde a Dec.31, 9999.

Si ExtendedYears es false, o si esteargumento opcional se omite de la funciónTIMVL, la función devuelve una fecha quequeda dentro del rango Jan. 1, 1960 - Dec.31, 2059. La fecha de serie 0 corresponde aJan 1, 1960 y la fecha de serie 36524corresponde a Dec. 31, 2059.

Si ExtendedYears es falso o se omite yespecifica una fecha de serie mayor que36524, la fecha de serie utilizada por lafunción se determina mediante la fórmula n- 36525. Por ejemplo, si especifica una fechade serie de 36530, entonces 36530 - 36525 =5. En este caso, TIMVL utiliza 5 como lafecha de serie y devuelve la fecha Jan. 6,1960.

Ejemplo

TIMVL(11111.1100, 'Y') devuelve 1990.

TIMVL(11111.1100, 'H') devuelve 2.

TODAYTODAY devuelve la fecha actual en formato aa-mm-dd.



SintaxisTODAY(<ReturnFourDigitYear>)


ReturnFourDigitYear Un argumento booleano opcional quedetermina si la función TODAY devuelveuna cadena que utiliza una notación de doso cuatro dígitos para el año.

Si ReturnFourDigitYear es true, la funcióndevuelve una fecha que queda dentro delrango Jan. 1, 1960 - Dec. 31, 9999, utilizandouna notación de cuatro dígitos para el año.La fecha de serie 0 corresponde a Jan. 1,1960 y la fecha de serie 2936549 correspondea Dec. 31, 9999.

Si ReturnFourDigitYear es false, o si esteargumento opcional se omite de la funciónTODAY, la función devuelve una fecha quequeda dentro del rango Jan. 1, 1960 - Dec.31, 2059, utilizando una notación de dosdígitos para el año. La fecha de serie 0corresponde a Jan 1, 1960 y la fecha de serie36524 corresponde a Dec. 31, 2059.

Si ReturnFourDigitYear es falso o se omite yespecifica una fecha de serie mayor que36524, la fecha de serie utilizada por lafunción se determina mediante la fórmula n- 36525. Por ejemplo, si especifica una fechade serie de 36530, entonces 36530 - 36525 =5. En este caso, TODAY utiliza 5 como lafecha de serie y devuelve la fecha Jan. 6,1960.

Ejemplo

P1=TODAY(1) devuelve una cadena de fecha en formato AAAA-MM-DD como2009-06-05.

P1=TODAY(0) devuelve una cadena de fecha en formato AA-MM-DD como09-06-05

YEARYEAR devuelve un valor numérico para el año en una determinada cadena defecha.



SintaxisYEAR(date)


date Una cadena de fecha en formatoAA-MM-DD.

Ejemplo

YEAR('02-05-25') devuelve 2.

Funciones de reglas de información de dimensionesFunciones de regla que gestionan la información de dimensiones.

ConsolidateChildrenConsolidateChildren obliga a calcular los valores consolidados sumando los hijosinmediatos de una dimensión especificada.


ConsolidateChildren resulta útil si se calculan consolidaciones intermediasmediante reglas y desea calcular una consolidación padre sumando lasconsolidaciones intermedias en lugar de sumar los valores de hoja subyacentes.

SintaxisConsolidateChildren(DimName1, DimName2, ...)


DimName1, DimName2, ... Nombres de las dimensiones cuyasconsolidaciones se realizarán.

La función requiere al menos un argumentoDimName, y puede aceptar tantosargumentos DimName como dimensionesexistan en el cubo para el que se escribe laregla.

Ejemplo

Supongamos que tenemos un cubo denominado Sales compuesto por lasdimensiones ActVsBud, Region, Model, Account1 y Month.

En este ejemplo, la dimensión Month se define tal y como se indica a continuación:


Si no existe ninguna regla para este cubo, el valor de la consolidación Year secalculará sumando todos los valores de hoja subyacentes, en este caso de Jan aDec. La figura que aparece a continuación ilustra esta consolidación.

Ahora, supongamos que crea la siguiente regla para este cubo, que indica quetodos los valores trimestrales deben ser 1:[{’1 Quarter’, ’2 Quarter’, ’3 Quarter’, ’4 Quarter’}]=1;

El resultado es el siguiente:

En la figura, puede ver que es verdad que los valores trimestrales se calculan porla regla, pero la consolidación Year sigue calculándose sumando todos los valoresde hoja subyacentes. Si no es la ruta de cálculo que desea, puede utilizar la funciónConsolidateChildren para obligar a TM1 a calcular la consolidación Year sumandosus hijos inmediatos, concretamente 1 Quarter, 2 Quarter, 3 Quarter y 4 Quarter.[’Year’]=ConsolidateChildren(’Month’);[{’1 Quarter’, ’2 Quarter’, ’3 Quarter’, ’4 Quarter’}]=1;

En la regla, la sentencia [’Year’]=ConsolidateChildren(’Month’) indica que laconsolidación Year debe calcularse sumando los hijos inmediatos de Year en ladimensión Month.


La siguiente figura muestra el resultado de la sentencia[’Year’]=ConsolidateChildren(’Month’):

Tenga en cuenta que la consolidación Year ahora se calcula sumando sus hijosinmediatos.

Es importante recordar que para una consolidación dada, la funciónConsolidateChildren únicamente se aplica a los hijos inmediatos de la consolidación.

La función ConsolidateChildren también puede utilizarse para especificar cómo secalculan las consolidaciones en varias dimensiones, tal y como se muestra en elsiguiente ejemplo:


['World','Year']=ConsolidateChildren('Region','Month')

Esta sentencia aplica la funciónConsolidateChildren a las consolidacionesWorld y Year. En este caso, World se calculasumando todos sus hijos inmediatos en ladimensión Region, mientras que Year secalcula sumando sus hijos inmediatos en ladimensión Month.

DIMNMDIMNM devuelve el elemento de una dimensión que corresponde al argumento deíndice.


SintaxisDIMNM(server_name:dimension, index)


dimension Nombre de dimensión válido calificado conel nombre del servidor.

index Un valor menor o igual que el número deelementos de la dimensión.

Si este argumento es menor que 1 o mayorque el número de elementos de ladimensión, la función devuelve 0.


Ejemplo

DIMNM(planning_sample:'Region',2)

Este ejemplo devuelve "Belgium", que es el elemento de la dimensión Region conun valor de índice de 2.

DIMSIZDIMSIZ devuelve el número de elementos de una dimensión especificada.


SintaxisDIMSIZ(dimension)



En algunas instalaciones es necesariocalificar el nombre de la dimensión con elnombre del servidor, como enserver_name:dimension.

Ejemplo

DIMSIZ('Accounts')

Si la dimensión Accounts incluye 19 elementos, el ejemplo devuelve el valor 19.

DNEXTDNEXT devuelve el nombre de elemento que sigue al elemento especificado comoargumento de la función.


SintaxisDNEXT(dimension, element)






element El nombre de un elemento de la dimensión.Este argumento puede ser también elnombre de un alias de un elemento de ladimensión.

Ejemplo

DNEXT("Location","Oregon")

Si la dimensión Location contiene los elementos ordenados California, Oregon yWashington, el ejemplo devuelve Washington.

DNLEVDNLEV devuelve los niveles de número de una dimensión.


SintaxisDNLEV(dimension)




EjemploDNLEV(’Region’)

En la dimensión Region, las diversas naciones (nivel 0) se agregan formandoregiones (nivel 1). Las regiones se agregan formando superregiones (nivel 2), que asu vez se agregan formando el mundo (nivel 3).

Existen cuatro niveles en la dimensión Region, de modo que el ejemplo devuelveel valor 4.


TABDIMTABDIM devuelve el nombre de dimensión que corresponde al argumento deíndice.


SintaxisTABDIM(cube, index)


cube Un nombre de cubo válido.

index Un valor positivo menor o igual que elnúmero total de dimensiones del cubo.

Ejemplo

TABDIM('SalesCube',3)

El cubo SalesCube contiene cinco dimensiones: account1, actvsbud, model, monthy region. El ejemplo devuelve model, la tercera dimensión de SalesCube.

Funciones de reglas de información de elementosFunciones de regla que gestionan la información de elementos.

DIMIXDIMIX devuelve el número de índice de un elemento de una dimensión.


SintaxisDIMIX(server_name:dimension, element)


dimension Nombre de dimensión válido calificado conel nombre del servidor.

element El nombre de un elemento de la dimensión.

Si el elemento no es un elemento de ladimensión especificada, la función devuelve0.

Ejemplo

DIMIX(planning_sample:'Region','Brazil')


Brazil tiene un valor de índice de tres en la dimensión Region. El ejemplo devuelve3.

DTYPEDTYPE devuelve información sobre el tipo de elemento de un elementoespecificado.


DTYPE devuelve N si el elemento es un elemento numérico, S si el elemento es unelemento de cadena y C si el elemento es un elemento consolidado.

SintaxisDTYPE(dimension, element)




Ejemplo

DTYPE('Region','Europe')

El elemento Europe es un elemento consolidado de la dimensión Region, de modoque el ejemplo devuelve C.

ELCOMPELCOMP devuelve el nombre de un hijo de un elemento consolidado de unadimensión especificada.


Si el argumento element no es un elemento consolidado, la función devuelve 0.

SintaxisELCOMP(dimension, element, position)



element El nombre de un elemento consolidado de ladimensión.

position Un valor positivo menor o igual que elnúmero total de hijos del elementoespecificado.


Ejemplo

ELCOMP('Region','Central Europe',2)

En la dimensión Region, el elemento consolidado Central Europe es unaconsolidación de los hijos France y Germany. Germany se encuentra en la segundaposición de esta consolidación. De esta manera, el ejemplo devuelve Germany.

ELCOMPNELCOMPN devuelve el número de componentes de un elemento especificado.



SintaxisELCOMPN(dimension, element)



element El nombre de un elemento consolidado de ladimensión.

Ejemplo

ELCOMPN('Region','Scandanavia')

En la dimensión Region, el elemento Scandanavia es una consolidación de treselementos. El ejemplo devuelve 3.

ELISANCELISANC determina si element1 es un ancestro de element2 en la dimensiónespecificada.


La función devuelve 1 si element1 es un ancestro de element2; de lo contrario, lafunción devuelve 0.

SintaxisELISANC(dimension, element1, element2)



element1 El nombre de un elemento de la dimensión.




Ejemplo

ELISANC('Region', 'Europe', 'Germany')

En la dimensión Region, el elemento Europe es un ancestro de Germany. Elejemplo devuelve 1.

ELISCOMPELISCOMP determina si element1 es un hijo de element2 en la dimensiónespecificada.


La función devuelve 1 si element1 es un hijo de element2; de lo contrario, lafunción devuelve 0.

SintaxisELISCOMP(dimension, element1, element2)





Ejemplo

ELISCOMP('Region','Germany','Central Europe')

En la dimensión Region, el elemento Central Europe es una consolidación de doselementos, Germany y France. El ejemplo devuelve 1.

Nota: Esta función devuelve 1 únicamente para hijos inmediatos. En el ejemploanterior, Germany es un hijo de Central Europe. Además, Central Europe es unhijo de Europe. Sin embargo, dado que la función devuelve 1 únicamente parahijos inmediatos, el siguiente ejemplo devuelve 0:

ELISCOMP('Region','Germany','Europe')

ELISPARELISPAR determina si element1 es un padre de element2 en la dimensiónespecificada.



La función devuelve 1 si element1 es un padre de element2; de lo contrario, lafunción devuelve 0.

SintaxisELISPAR(dimension, element1, element2)





Ejemplo

ELISPAR('Region','Central Europe','Germany')

En la dimensión Region, el elemento consolidado Central Europe es el padre tantode Germany como de France. De esta manera, el ejemplo devuelve 1.

Nota: Esta función devuelve 1 únicamente para padres inmediatos. En el ejemploanterior, Europe es un padre de Central Europe. Además, Central Europe es unpadre de Germany. Sin embargo, dado que Europe no es un padre inmediato deGermany, el siguiente ejemplo devuelve 0:

Nota: ELISPAR('Region','Europe','Germany')

ELLEVELLEV devuelve el nivel de un elemento de una dimensión.


SintaxisELLEV(dimension, element)




EjemploELLEV(’Region’,’Europe’)

En la dimensión Region, las naciones individuales (nivel 0) se agregan formandoregiones (nivel 1). Las regiones se agregan formando superregiones (nivel 2), que asu vez se agregan formando el mundo (nivel 3). El ejemplo devuelve 2, dado que


Europe es un elemento de nivel 2.

ELPARELPAR devuelve el padre de un elemento en una dimensión especificada


SintaxisELPAR(dimension, element, index)




index Un valor positivo menor o igual que elnúmero total de elementos consolidados(padres) que utilizan el argumento elementcomo hijo.

Ejemplo

ELPAR('Model','Wagon 4WD',2)

En la dimensión Model, el elemento Wagon 4WD es un hijo tanto de Total Wagonscomo de Total 4WD. Por lo tanto, tanto Total Wagons como Total 4 WD son padresde Wagon 4WD. En la estructura de la dimensión Model, Total Wagons se defineen primer lugar y Total 4WD se define en segundo lugar.

El ejemplo devuelve Total 4WD, ya que es la segunda instancia de un padre deWagon 4WD en la dimensión Model.

ELPARNELPARN devuelve el número de padres de un elemento de una dimensiónespecificada.



SintaxisELPARN(dimension, element)




Ejemplo

ELPARN('Model','Wagon 4WD')

En la dimensión Model, el elemento Wagon 4WD es un hijo tanto de Total Wagonscomo de Total 4WD. Por lo tanto, tanto Total Wagons como Total 4 WD son padresde Wagon 4WD. La función devuelve 2.

ELWEIGHTELWEIGHT devuelve el peso de un hijo de un elemento consolidado.


SintaxisELWEIGHT(dimension, element1, element2)



element1 El nombre de un elemento consolidado de ladimensión.

element2 El nombre de un hijo del elementoconsolidado.

Ejemplo

ELWEIGHT('Account1','Gross margin','Variable Costs')

El elemento Variable Costs, que es un hijo de Gross margin, tiene un peso de -1.

El ejemplo devuelve -1.

Funciones de reglas financierasFunciones de regla utilizadas para gestionar información financiera.

FVFV devuelve el valor de una anualidad en el momento del último pago.



Una anualidad es una serie de pagos realizados a intervalos iguales de tiempo. Sepresupone que los pagos se realizarán al final de cada periodo.

SintaxisFV(payment, interest, periods)


payment La cantidad del pago realizado por periodo.

interest El tipo de interés pagado por periodo.

periods El número de periodos de la anualidad.

Ejemplo

FV(1000, .14, 5)

Este ejemplo devuelve el valor de una anualidad transcurridos 5 años, con pagosde 1.000 dólares estadounidenses al año con un interés del 14%.

PAYMTPAYMT devuelve la cantidad de pago de una anualidad basada en un determinadovalor inicial o capital, un tipo de interés y un número de periodos. Una anualidades una serie de pagos realizados a intervalos iguales de tiempo.


SintaxisPAYMT(principal, interest, periods)


principal El valor actual o la cantidad total que valeahora una serie de pagos futuros.


periods El número de periodos de la anualidad. Sepresupone que los pagos se realizarán alfinal de cada periodo.

Ejemplo

PAYMT(100000, .14, 5)


Este ejemplo devuelve el pago de una anualidad de 5 años que se pagaanualmente, con un capital de 100.000 dólares estadounidenses y un tipo de interésdel 14%.

PVPV devuelve el valor inicial o principal de una anualidad.


SintaxisPV(payment, interest, periods)


payment La cantidad del pago realizado.


periods El número de periodos de la anualidad. Sepresupone que los pagos se realizarán alfinal de cada periodo.

Ejemplo

PV(1000, .14, 5)

Este ejemplo devuelve el valor principal de una anualidad con 5 pagos anuales de1.000 dólares estadounidenses y un tipo de interés del 14%.

Funciones de reglas lógicasOperadores lógicos para utilizar en reglas.

CONTINUESi se incluye como parte de una expresión de reglas, CONTINUE permite unaregla posterior con la misma definición de área para ejecutarse.


Normalmente, TM1 únicamente ejecuta la primera regla encontrada para unadeterminada área.

SintaxisCONTINUE

Argumentos

Ninguno.


Ejemplo

['Jan']= if(!region @= 'Argentina',10,CONTINUE);

['Jan']=20;

En este ejemplo, a todas las celdas identificadas por January y Argentina se lesasigna un valor de 10. A las celdas identificadas por Jan y cualquier otro elementoRegion se les asigna un valor de 20.

IFIF devuelve un valor si la expresión lógica que especifica es TRUE y otro valor sies FALSE.

Se trata de una función de reglas TM1 , válida sólo en reglas TM1 .(TurboIntegrator utiliza su propia función IF, que es capaz de evaluar variasexpresiones lógicas.)

SintaxisIF(expression, true_value, false_value)


expression Cualquier valor o expresión que puedeevaluarse como TRUE o FALSE.

true_value El valor que se devuelve si la expresión esTRUE.

false_value El valor que se devuelve si la expresión esFALSE.

Ejemplo

IF(1<2, 4, 5) devuelve 4.

IF(1>2, 'ABC', 'DEF') devuelve 'DEF'.

STETLa función STET cancela el efecto de una regla para un elemento en concreto.

Se trata de una función de reglas TM1 , válida sólo en reglas TM1 . Esta funciónno puede utilizarse en procesos de TurboIntegrator.

SintaxisSTET

Argumentos

Ninguno.


Ejemplo

['Sales'] = IF(!Region @= 'France',STET, 100);

En este ejemplo, la regla dicta que el valor de Sales es siempre 100, excepto para laintersección de Sales y el elemento France de la dimensión Region.

Funciones de reglas matemáticasOperadores matemáticos para utilizar en reglas.

ABSABS devuelve el valor absoluto de un número.


SintaxisABS(x)


x El número cuyo valor absoluto deseaaveriguar.

Ejemplo

ABS(-1.2) devuelve 1.2

ACOSACOS devuelve el ángulo, en radianes, cuyo coseno es x.


SintaxisACOS(x)


x El coseno del ángulo que desea encontrar. xdebe estar entre -1 y 1; de lo contrario, lafunción devuelve un error.

Ejemplo

ACOS(0) devuelve 1.5708.

ASINASIN devuelve el ángulo, en radianes, cuyo seno es x.



SintaxisASIN(x)


x El seno del ángulo que desea encontrar. xdebe estar entre -1 y 1; de lo contrario, lafunción devuelve un error.

Ejemplo

ASIN(1) devuelve 1.5708.

ATANATAN devuelve el ángulo, en radianes, cuya tangente es x. El resultado seencuentra entre -pi/2 y +pi/2.


SintaxisATAN(x)


x La tangente del ángulo que desea averiguar.

Ejemplo

ATAN(1) devuelve .7854.

COSCOS devuelve el coseno de un ángulo expresado en radianes.


SintaxisCOS(x)


x Un ángulo, expresado en radianes, cuyocoseno desea averiguar.


Ejemplo

COS(0) devuelve 1.

EXPEXP devuelve el antilogaritmo natural de un número.


SintaxisEXP(x)


x Un número cuyo antilogaritmo natural deseaaveriguar.

Ejemplo

EXP(1) devuelve 2.71828.

INTINT devuelve el mayor entero que es menor o igual que un valor especificado.


SintaxisINT(x)


x Un valor numérico.

Ejemplo

INT(5.6) devuelve 5.

INT(-5.6) devuelve -6.

ISUNDISUND devuelve 1 si un valor especificado no se ha definido; de lo contrario,devuelve 0.



SintaxisISUND(x)


x Un número o expresión.

Ejemplo

ISUND(5.2) devuelve 0.

ISUND(1/0) devuelve 1.

LNLN devuelve el logaritmo natural (base e) de un número.


SintaxisLN(x)


x Un número positivo. La función devuelveun error si x es negativo o cero.

Ejemplo

LN(10) devuelve 2.302585093.

LOGLOG devuelve el logaritmo en base 10 de un número positivo.


SintaxisLOG(x)


x Un número positivo. La función devuelveun error si x es negativo o cero.

Ejemplo

LOG(10) devuelve 1.


MAXMAX devuelve el número mayor de un par de valores.


SintaxisMAX(num1, num2)


num1 El primero de un par de valores.

num2 El segundo de un par de valores.

Ejemplo

MAX(10, 3) devuelve 10.

MINMIN devuelve el número menor de un par de valores.


SintaxisMIN(num1, num2)


num1 El primero de un par de valores.

num2 El segundo de un par de valores.

Ejemplo

MIN(10, 3) devuelve 3.

MODMOD devuelve el resto de dividir un número entre un divisor.


SintaxisMOD(number, divisor)


number El número cuyo resto desea averiguar.



divisor El valor entre el que se divide el argumentonumber.

Ejemplo

MOD(10, 3) devuelve 1.

RANDRAND genera un número aleatorio que se distribuye uniformemente entre 0 y 1.


El generador de números aleatorios se inicia al cargarse TM1 .

SintaxisRAND.

Argumentos

Ninguno.

Ejemplo

RAND genera un número aleatorio que se distribuye uniformemente entre 0 y 1.

ROUNDROUND redondea un determinado número hasta el entero más próximo. Elredondeo se puede realizar de diversas formas, todas ellas válidas.


La forma más básica de redondeo es sustituir un número arbitrario por un entero.Hay varias formas de redondear un número y como un entero q.

Las más habituales son:v Redondear al número más cercano

q es el entero más cercano a y (consulte "Redondear en dirección contraria a"para ver las reglas que se aplican en caso de que sea igual).

v Redondear hacia cero (o truncar)q es la parte entera de y, sin los dígitos de fracción.

v Redondear hacia abajo (suelo; "floor" en inglés)q es el entero más alto que no es mayor que y.

v Redondear hacia arriba (techo; "ceiling" en inglés)q es el entero más bajo que no es menor que y.

v Redondear en dirección contraria a cero


Si y es un entero, q es y; en caso contrario, q es el entero más cercano a 0 y tieneun valor tal que y está entre 0 y q.

TurboIntegrator básicamente utiliza el método de redondeo hacia abajo de floor(x+ 0,5). Microsoft Excel utiliza el método de redondeo al número más cercano. Estopuede dar como resultado enteros diferentes en función de si utiliza un procesoTurboIntegrator o de si trabaja con Excel.

SintaxisROUND(number)


number El número que desea redondear.

Ejemplo

ROUND(1.46) devuelve 1.

ROUNDPROUNDP redondea un determinado número con una precisión decimalespecificada.


SintaxisROUNDP(number, decimal)


number El número que desea redondear.

decimal La precisión decimal con la que deseaaplicar el redondeo. Si este argumento espositivo, la función redondea el númeroespecificado de dígitos a la derecha delpunto decimal. Si este argumento esnegativo, la función redondea el númeroespecificado de dígitos a la izquierda delpunto decimal.

El argumento decimal debe encontrarseentre -15 y 15, ambos inclusive.

Ejemplo

ROUNDP(1.46, 1) devuelve 1.5.


ROUNDP(234.56, -1) devuelve 230.00.



SIGNSIGN determina si un número es positivo, negativo o cero.


La función devuelve 1 si el número es positivo, -1 si el número es negativo y 0 siel número es cero.

SintaxisSIGN(number)


number Un número.

Ejemplo

SIGN(-2.5) devuelve -1.

SINSIN devuelve el seno de un ángulo determinado.


SintaxisSIN(x)


x Un valor, expresado en radianes, cuyo senodesea conocer.

Ejemplo

SIN(1.5708) devuelve 1.

SQRTSQRT devuelve la raíz cuadrada de un determinado valor.



SintaxisSQRT(x)


x Cualquier valor positivo. SQRT devuelve unerror si x es negativo.

Ejemplo

SQRT(16) devuelve 4.

TANTAN devuelve la tangente de un ángulo determinado.


SintaxisTAN(x)


x Un valor, expresado en radianes, cuyatangente desea conocer.

Ejemplo

TAN(0) devuelve 0.

TAN(.7854) devuelve 1.

Funciones de reglas de textoReglas para gestionar el texto en las reglas.

CAPITCAPIT aplica mayúsculas iniciales a todas las palabras de una cadena.


SintaxisCAPIT(string)


string Una cadena de texto.


Ejemplo

CAPIT('first quarter sales') devuelve "First Quarter Sales".

CHARCHAR devuelve el carácter identificado por un determinado código numéricoASCII.


SintaxisCHAR(number)


number Un número de código ASCII. Este númerodebe encontrarse entre 1 y 255, ambosinclusive.

Ejemplo

CHAR(100) devuelve "d".

CODECODE devuelve el código numérico ASCII para un carácter especificado de unacadena.


SintaxisCODE(string, location)



location Un número que especifica el carácter de lacadena cuyo valor de código ASCII deseaaveriguar.

Ejemplo

CODE('321', 2) devuelve 50.

CODE('End', 3) devuelve 100.

DELETDELET devuelve el resultado de eliminar un número especificado de caracteresdesde un punto de inicio especificado en una cadena.



SintaxisDELET(string, start, number)



start El carácter en el que comienza laeliminación.

number El número de caracteres que se eliminarán.

Ejemplo

DELET('payment', 3, 3) devuelve "pant".

FILLFILL repite una determinada cadena según sea necesario para devolver una cadenade una determinada longitud.


SintaxisFILL(string, length)


string Una cadena de texto. Esta cadena se repitesegún sea necesario para alcanzar lalongitud especificada.

length La longitud de la cadena que desea quedevuelva la función.

Ejemplo

FILL('-', 5) devuelve "-----".

FILL('ab', 5) devuelve "ababa".

INSRTINSRT inserta una cadena en otra cadena en un punto de inserción especificado.



SintaxisINSRT(string1, string2, location)


string1 Una cadena de texto.

string2 Una cadena de texto.

location El carácter de string2 en el que deseainsertar string1. La función inserta string1 enstring2 inmediatamente antes del carácterque especifique.

Ejemplo

INSRT('ABC', 'DEF', 2) devuelve "DABCEF".

LONGLONG devuelve la longitud de una cadena.


SintaxisLONG(string)



Ejemplo

LONG('Sales') devuelve 5.

LOWERLOWER convierte todos los caracteres en mayúsculas en una cadena enminúsculas.


SintaxisLOWER(string)




Ejemplo

LOWER('First Quarter Sales') devuelve "first quarter sales".

NUMBRNUMBR convierte una cadena en un número.


La cadena pasada a la función NUMBR debe utilizar. (punto) como separadordecimal y , (coma) como separador de millares. Cualquier otro separadordecimal/de millares provocará resultados incorrectos.

SintaxisNUMBR(string)


string La cadena que desea convertir en unnúmero. Todos los caracteres distintos de '0'a '9', '+', '-', '.' y 'E' se ignoran.

Ejemplo

NUMBR('-5.6') devuelve -5.6.

NUMBR('-5A. B6C') devuelve -5.6.

SCANSCAN devuelve un número que indica la ubicación del inicio de la primeraaparición de una subcadena especificada en una determinada cadena.


Si la subcadena no aparece en la cadena indicada, la función devuelve cero.

SintaxisSCAN(substring, string)


substring La subcadena que está tratando de localizar.

string La cadena en la que está buscando lasubcadena.

Ejemplo

SCAN('scribe', 'described') devuelve 3.


STRSTR convierte un número en una cadena.


El número pasado a la función STR debe utilizar. (punto) como separador decimaly , (coma) como separador de millares. Cualquier otro separador decimal/demillares provocará resultados incorrectos.

SintaxisSTR(number, length, decimal)


number El número que se convierte en una cadena.

length La longitud de la cadena. Si es necesario, lafunción inserta espacios en blanco delantepara conseguir esta longitud.

decimal El número de posiciones decimales que seincluirán en el resultado de la función.

Ejemplo

STR(3.14159, 6, 2) devuelve ' 3.14'.

STR(-3.14159, 6, 0) devuelve " -3".

SUBSTSUBST devuelve una subcadena de una determinada cadena.


SintaxisSUBST(string, beginning, length)


string La cadena de la que desea extraer lasubcadena.

beginning El carácter en el que comienza la subcadena.

length La longitud de la subcadena.

Ejemplo

SUBST('Retirement', 3, 4) devuelve "tire".


TRIMTRIM devuelve el resultado de eliminar los espacios en blanco que están delante ydetrás de una cadena.


SintaxisTRIM(string)



Ejemplo

TRIM(' First Quarter ') devuelve "First Quarter".

UPPERUPPER convierte una cadena de texto en una cadena en mayúsculas.


SintaxisUPPER(string)



Ejemplo

UPPER('First Quarter Results') devuelve FIRST QUARTER RESULTS.

Otras funciones de reglasFunciones de reglas no encontradas en otras categorías.

FEEDERSCuando utiliza una declaración SKIPCHECK para restaurar la consolidación difusade una regla TM1 , también debe asegurarse de que las sentencias de feederidentifiquen todas las celdas derivadas de reglas. Para ello, inserte una declaraciónFEEDERS inmediatamente después de todas las sentencias de reglas:FEEDERS;

Inmediatamente después de la declaración de FEEDERS debe crear sentencias defeeder que identifiquen las celdas derivadas de reglas del cubo.


Para obtener toda la información sobre reglas TM1 , incluidas la consolidacióndifusa y la creación de feeders, consulte la publicación IBM Cognos TM1 RulesGuide.

FEEDSTRINGSLos valores de cadena generados por reglas no se muestran cuando en una vista sesuprimen los ceros, a no ser que la cadena esté ubicada en una celda que seinserta. Para activar el feeding de celdas de cadena, inserte la declaraciónFEEDSTRINGS como primera línea de su regla.FEEDSTRINGS;

Una vez colocada esta declaración, puede configurar feeders para las celdas decadena en una vista de cubo, y confiar en que la cadena estará disponible para lasdemás reglas, aunque la vista tenga suprimidos los ceros. Las sentencias quedefinen feeders para las celdas de cadena deben crearse bajo la declaraciónFEEDERS de su regla.

Al igual que en los feeders numéricos, un feed a una celda consolidada provoca elfeeding de todos los componentes de la consolidación. Dado que puede almacenarcadenas en celdas consolidadas, debe prestar especial atención si dichas celdas seutilizan para ser insertadas en otras celdas. El uso excesivo de feeders de cadenapuede provocar explosiones de cálculos y un bajo rendimiento de la aplicación.

Para obtener toda la información sobre reglas TM1 , incluida la creación de feeders,consulte la publicación IBM Cognos TM1 Rules Guide.

SKIPCHECKPuede restaurar la consolidación difusa y aumentar el rendimiento insertando unadeclaración SKIPCHECK al comienzo de una regla TM1 .

Durante las consolidaciones, TM1 utiliza un algoritmo de consolidación difusa paraomitir celdas que contengan ceros o estén vacías. Este algoritmo agiliza los cálculosde consolidaciones en cubos muy difusos. Un cubo difuso es un cubo en el que elnúmero de celdas completas como porcentaje de las celdas totales es bajo.

Al consolidar datos de cubos que cuentan con reglas definidas, TM1 desactiva estealgoritmo de consolidación difusa porque de hecho una o más celdas vacíaspueden calcularse con una regla. (La omisión de celdas calculadas mediante reglasprovocará que los totales consolidados sean incorrectos). Cuando se desactiva elalgoritmo de consolidación difusa, se comprueba cada celda en busca de un valordurante la consolidación. Esto puede ralentizar los cálculos de los cubos muygrandes y difusos.SKIPCHECK;

Si su regla utiliza una sentencia FEEDSTRINGS, la sentencia SKIPCHECK debe serla segunda sentencia de su regla. Si su regla no utiliza una sentenciaFEEDSTRINGS, la sentencia SKIPCHECK debe ser la primera sentencia de suregla.

Cuando utilice SKIPCHECK para restaurar la consolidación difusa, también debeasegurarse de que su regla incluya una declaración FEEDERS y de que lassentencias de feeder identifiquen las celdas derivadas de reglas.


Para obtener toda la información sobre reglas TM1 , incluidas la consolidacióndifusa y la creación de feeders, consulte la publicación IBM Cognos TM1 RulesGuide.

EvalJavaNEvalJavaN ejecuta un proceso Java™ de TurboIntegrator que devuelve un número.Si desea ejecutar un proceso Java de TurboIntegrator que devuelva una cadena,utilice EvalJavaS.

Se trata de una función de reglas TM1, sólo válida en las reglas TM1.

La función ExecuteJavaN de TurboIntegrator proporciona una funcionalidadanáloga en los procesos de TurboIntegrator.

SintaxisEvalJavaN(’JavaTIClass’, [’OptionalParameter1’, ’OptionalParameter2’, ...] )


JavaTIClass Nombre completo de la clase Java deTurboIntegrator que desea ejecutar.

OptionalParameters Parámetros opcionales que se pasan alpropio proceso Java de TurboIntegrator.Puede pasar tantos parámetros como seannecesarios, incluido ninguno.

Sólo puede pasar cadenas como parámetros,no puede pasar números. Puede utilizar lafunción de reglas “STR” en la página 162para pasar números a los scripts Java deTurboIntegrator.

Una clase Java de TurboIntegrator que devuelve un número y se puede llamardesde EvalJavaN debe utilizar el patrón siguiente.package com.example;

importcom.ibm.cognos.tm1.javati.JavaTI;

@JavaTIpublic class MyTestTI {public static double MyTestTI (String [] args) [...return ...;}}

Ejemplo

EvalJavaN(’com.example.MyTestTI’, ’First’, ’Second’, ’Third’);

EvalJavaSEvalJavaS ejecuta un proceso Java de TurboIntegrator que devuelve una cadena. Sidesea ejecutar un proceso Java de TurboIntegrator que devuelva un número, utiliceEvalJavaN.


Se trata de una función de reglas TM1, sólo válida en las reglas TM1.

La función ExecuteJavaS de TurboIntegrator proporciona una funcionalidadanáloga en los procesos de TurboIntegrator.

SintaxisEvalJavaS(’JavaTIClass’, [’OptionalParameter1’, ’OptionalParameter2’, ...] )




Sólo puede pasar cadenas como parámetros,no puede pasar números. Puede utilizar lafunción de reglas “STR” en la página 162para pasar números a los scripts Java deTurboIntegrator.

Una clase Java de TurboIntegrator que devuelve una cadena y se puede llamardesde EvalJavaS debe utilizar el patrón siguiente.package com.example;


@JavaTIpublic class MyTestTI {public static String MyTestTI (String [] args) [...return ...;}}

Ejemplo

EvalJavaS(’com.example.MyTestTI’, ’First’, ’Second’, ’Third’);


Capítulo 4. Funciones de macro

IBM Cognos TM1 incluye un conjunto de funciones de macros que puedeincorporar en macros de Excel. Puede utilizar funciones de macros para acceder aservidores, estructuras y datos de cubo y opciones de TM1 .

Nota: Antes de ejecutar estas macros, debe cargar el complemento TM1(Tm1p.xla).

En esta sección se describen las siguientes funciones de macros:

Acceso a las funciones de macrosEl producto que está utilizando determina la forma de acceso a las funciones demacros de TM1 .

Acceso a funciones de macros de las versiones 5 y 7 deExcel

Acceda a funciones de macros de las versiones 5 y 7 de Microsoft Excel.

Procedimiento1. Seleccione Insertar, Macro, Macro de MS Excel 4.0.2. Seleccione Insertar, Función.3. Seleccione TM1 en el cuadro de diálogo Categoría de funciones.4. Efectúe una doble pulsación en la función que desee insertar en el cuadro de

lista Nombre de función.5. Escriba los argumentos adecuados en el cuadro de diálogo Asistente de

funciones.6. Pulse Finalizar para copiar la función completa en la celda actual de la hoja de

macros.

Acceso a funciones de macros de la versión 8 y posterioresde Excel

Acceda a funciones de macros de las versiones 8 y posteriores de Microsoft Excel.

Procedimiento1. Pulse con el botón derecho del ratón en la pestaña hoja de la hoja de trabajo

activa.2. En el menú de atajo, pulse Insertar.3. Efectúe una doble pulsación en Macro de MS Excel 4.0.4. Seleccione Insertar, Función.5. Seleccione TM1 en el cuadro de diálogo Categoría de funciones.6. Efectúe una doble pulsación en la función que desee insertar del cuadro de

diálogo Nombre de función.7. Escriba los argumentos adecuados en la Paleta de fórmulas.8. Pulse Aceptar para copiar la función completa en la celda actual de la hoja de

macros.


Acceso a las funciones de macros desde módulos VBAPara acceder a funciones de macros desde módulos VBA, utilice el métodoEjecutar.Run ("macro_function", arg1, ...)

EjemploSub Elemlist( )

Worksheets("Sheet1").Select

Cells(3,5).Select

ActiveCell.Value = Run ("E_PICK", "local:Region")

End Sub

Este procedimiento llama a la función de macro E_PICK, que accede a una lista deelementos de la dimensión Region. El elemento seleccionado llena una celda de lahoja de trabajo Sheet1.

D_PICKD_PICK llama a un cuadro de diálogo que muestra todas las dimensionesdisponibles en el directorio de datos local y en los servidores conectados de formaremota.

Se trata de una función de macro de TM1 , válida únicamente en las macros deExcel y los módulos VBA.

La dimensión que seleccione en el cuadro de diálogo se convertirá en el valor de lafunción D_PICK.

SintaxisD_PICK

Argumentos

Ninguno.

DBProportionalSpreadDBProportionalSpread distribuye un valor especificado a las hojas de unaconsolidación que es proporcional a los valores de celda existentes.


Esta función es análoga al método de dispersión de datos Dispersión proporcional,que se describe detalladamente en la guía del usuario de IBM Cognos TM1 .

SintaxisDBProportionalSpread( value, server:cube, e1, e2, e3...,e16 )


value El valor que desea distribuir.



server:cube El nombre del cubo en el que deseadistribuir el valor, con el nombre delservidor adecuado como prefijo.

Por ejemplo, para distribuir valores en elcubo Sales en el servidor Accounting, debeespecificar Accounting:Sales.

e1...e16 Los nombres de los elementos queidentifican la consolidación cuyas hojasaceptarán el valor distribuido.

Ejemplo

DBProportionalSpread( 2000, "Accounting:Sales", "Actual", "Argentina", "S Series1.8L Sedan", "Sales", "1 Quarter" )

Este ejemplo distribuye el valor 2000 a los hijos de la consolidación identificadospor los elementos Actual, Argentina, S Series 1.8L Sedan, Sales y 1 Quarter.Distribuye valores en el cubo Sales en el servidor Accounting.

D_FSAVED_FSAVE permite crear o actualizar dimensiones muy grandes cuyas hojas detrabajo de dimensiones superarían el límite de filas de una hoja de trabajo deExcel.


Para utilizar la función D_FSAVE, cree un archivo ASCII delimitado denominadodim.dit, donde dim es el nombre de la dimensión que desea crear o actualizar. Estearchivo debe estar ubicado en su directorio de datos del servidor local.

La estructura del archivo ASCII debe coincidir con una hoja de trabajo dedimensiones, tal y como se indica a continuación:v Incluya tres campos por línea.v En el primer campo, especifique el tipo de elemento (C para consolidado; N

para elemento numérico; S para elemento de cadena; en blanco para elcomponente de consolidación).

v En el segundo campo, especifique el nombre del elemento.v En el tercer campo, especifique el peso, si fuera necesario. El peso

predeterminado es 1,0.

Separe los campos utilizando el delimitador definido en su sistema operativo. EnWindows, este delimitador está definido por la entrada Separador de listas delcuadro de diálogo Propiedades de configuración regional.

Si hay errores en la estructura del archivo ASCII, como elementos no definidos ocolocados incorrectamente, aparecerá un mensaje de error.

Por ejemplo

Capítulo 4. Funciones de macro 169

SintaxisD_FSAVE(file)


file El nombre de un archivo ASCII delimitadoque tiene la extensión de archivo .dit. Noincluya la extensión de archivo. Este archivodebe estar ubicado en el directorio de datosde TM1 local.

Ejemplo

=D_FSAVE("Region")

Este ejemplo lee un archivo ASCII denominado Region.dit y crea o actualiza ladimensión Region.

Nota: D_FSAVE puede utilizarse para crear o actualizar dimensiones en servidoresremotos. Sin embargo, la función siempre busca el archivo .dit en el directorio dedatos local (tal y como se ha definido en Tm1p.ini). Debe asegurarse de que elarchivo .dit de la dimensión que desee crear o actualizar esté ubicado en sudirectorio de datos local y, a continuación, especificar el servidor en el que deseacrear o actualizar la dimensión introduciendo en el archivo .dit el nombre delservidor como prefijo.

=D_FSAVE("TM1Serv:Region")

busca un archivo denominado Region.dit en el directorio de datos del servidorlocal, pero escribe la dimensión Region en el directorio de datos del servidorTM1Serv.

D_SAVED_SAVE guarda la hoja de trabajo activa como un archivo de hoja de trabajo dedimensiones (dim.xdi).


El nombre del libro de trabajo se utiliza como nombre de archivo. A continuación,TM1 crea o actualiza la dimensión especificada por el nombre del libro de trabajo.

Si la hoja de trabajo activa no se ajusta a un formato de hoja de trabajo dedimensiones o no cuenta con toda la información, aparecerá un mensaje de error.Por ejemplo, debe definir todos los elementos utilizados en una consolidación denivel 1 como elementos numéricos (N).

SintaxisD_SAVE

Argumentos

Ninguno.


E_PICKE_PICK llama al Editor de subconjuntos, mostrando todos los elementos de ladimensión especificada.


El nombre del elemento que seleccione en el Editor de subconjuntos se convertiráen el valor que devuelva la función E_PICK.

SintaxisE_PICK(Dimension, Alias, Subset, Element)


Dimensión Un nombre de dimensión válido. Ladimensión puede estar ubicada en eldirectorio de datos local o en un servidorremoto al que esté conectado.

Utilice un prefijo de nombre de servidorpara indicar la ubicación del servidor. Parael servidor local, especifique local:dim. Paraun servidor remoto, especifiqueservername:dim.

Alias El nombre de un alias que exista para elsubconjunto. Cuando este parámetro estéestablecido, se aplicará el alias al abrir elsubconjunto en el Editor de subconjuntos yla función devolverá el alias del elementoque seleccione.

Si decide no establecer un parámetro Aliasdebe pasar una cadena vacía a la función.

Subconjunto El nombre del subconjunto que se abrirá enel Editor de subconjuntos al llamar aE_PICK. Debe facilitarse el parámetro Aliaspara utilizar este parámetro. El parámetroAlias puede definirse como una cadenavacía ("").

Si decide no establecer un parámetro Subsetdebe pasar una cadena vacía a la función.

ElementNameOrIndex El nombre o número de índice del elementoque se preseleccionará cuando se abra elEditor de subconjuntos.

Si decide no establecer un parámetroElementNameOrIndex debe pasar unacadena vacía a la función.


Ejemplo 1

=E_PICK("TM1SERV:Region"," "," "," ")

Este ejemplo abre la dimensión Region en el Editor de subconjuntos.

=E_PICK ("TM1SERV:Region","Deutsch","Europe","Argentina")

Este ejemplo abre el subconjunto Europe en el Editor de subconjuntos. Se aplicaráel alias Deutsche y se preseleccionará el elemento Argentina cuando se abra elEditor de subconjuntos.

=E_PICK ("TM1SERV:Region"," "," ",14)

Este ejemplo abre la dimensión Region en el Editor de subconjuntos, con el 14.ºelemento de la definición de la dimensión preseleccionado.

I_EXPORTI_EXPORT exporta datos del cubo especificado a un archivo ASCII delimitado, quese crea en el directorio 'Mis documentos' actual del usuario. En la mayoría de loscasos, el directorio 'Mis documentos' es C:\Users\<nombre_usuario>\Documents.


Nota: I_EXPORT aplica un bloqueo al servidor, lo que impide que otros usuariosaccedan al servidor durante la ejecución de la función. Si utiliza esta función paraexportar un cubo grande, es posible que no pueda accederse al servidor duranteun tiempo considerable.

SintaxisI_EXPORT(cube, file, zero, calcs)


cube Un nombre de cubo válido. El cubo puedeestar ubicado en su directorio de datos localo en un servidor remoto al que estéconectado. Utilice un prefijo de nombre deservidor para indicar la ubicación delservidor. Para el servidor local, especifiquelocal:cube. Para un servidor remoto,especifique servername:cube.

file El nombre del archivo ASCII delimitadopara crear. Se utiliza la extensión de archivo.cma; no la especifique.

zero Especifica si se incluyen los valores iguales acero. Especifique TRUE para incluirlos,FALSE para excluirlos.

calcs Especifica si se incluyen los valorescalculados. Especifique TRUE paraincluirlos, FALSE para excluirlos.


Ejemplo

=I_EXPORT("local:92act4d","Download",FALSE,TRUE)

Este ejemplo exporta datos del cubo 92act4d al archivo Download.cma. Los valorescero se excluyen y los valores calculados se incluyen.

I_NAMESPuede utilizar I_NAMES para crear una lista de nombres de elementos.


Esta función lee un archivo ASCII delimitado y escribe todos los nombresexclusivos de la columna especificada en la correspondiente columna de la hoja detrabajo activa.

SintaxisI_NAMES(file, column)


file El nombre de un archivo ASCII delimitado,cuya extensión de archivo es .cma. Noincluya la extensión de archivo.

column Un número que especifica el campo delarchivo ASCII en el que se leerán losnombres y la columna de la hoja de trabajoactiva en la que se escribirán dichosnombres.

Ejemplo

=I_NAMES("98Sales",3)

Este ejemplo inspecciona el archivo 98sales.cma. Todos los nombres exclusivos dela tercera columna se escriben en la columna C de la hoja de trabajo activa.

I_PROCESSI_PROCESS lee en los registros de un archivo ASCII, uno por uno, para la primerafila de la hoja de trabajo activa.


Cada campo llena una celda distinta. La hoja de trabajo se recalcula tras leer cadaregistro.


SintaxisI_PROCESS(file)


file El nombre de un archivo ASCII delimitado,cuya extensión de archivo es .cma. Noincluya la extensión de archivo.

Ejemplo

=I_PROCESS("98Sales ")

Este ejemplo lee cada registro del archivo 98sales.cma para la primera fila de lahoja de trabajo activa.

M_CLEARM_CLEAR borra y vuelve a cargar todas las dimensiones de la memoria. No borracubos ni reinicia el servidor.


SintaxisM_CLEAR

Argumentos

Ninguno.

N_CONNECTN_CONNECT establece una conexión a un servidor remoto.


Si se establece correctamente la conexión, N_CONNECT no devuelve ningún valor.Si no se puede establecer una conexión, de devuelven mensajes de error delservidor.

Nota: La función N_CONNECT no se soporta cuando un servidor está utilizandoseguridad de inicio de sesión integrado o de IBM Cognos 8 para la autenticación.Esta función solo se puede conectar a un servidor configurado para utilizar laautenticación TM1 estándar.


SintaxisN_CONNECT(server, client, password)


server El nombre de un servidor remoto. Esteservidor debe registrarse en el Servidor deadministración al que hace referencia sucliente.

client El nombre de usuario que se conecta alservidor especificado.

password La contraseña del cliente especificado.

Ejemplo

=N_CONNECT("Sales","USR2","Swordfish")

Este ejemplo establece una conexión con el servidor remoto denominado Sales,utilizando el nombre de cliente USR2 y la contraseña Swordfish.

OPTGETOPTGET devuelve el valor actual de una opción en el archivo Tm1p.ini.


SintaxisOPTGET(option)


option Un nombre de opción de TM1 válido.

Valores de opciones válidos Descripción

AdminHost Devuelve el nombre o la dirección del Hostde administración al que hace referencia sucliente.

AnsiFiles Devuelve T si actualmente se utiliza el juegode caracteres ANSI para importar datos dearchivos ASCII delimitados. Devuelve F siactualmente se utiliza el juego de caracteresASCII.

DataBaseDirectory Devuelve la ruta completa del directorio dedatos del servidor local.



GenDBRW Devuelve F si la hoja de trabajo de seccióncontiene fórmulas DBR. Devuelve T si lahoja de trabajo de sección contiene fórmulasDBRW.

NoChangeMessage Devuelve T si se ha configurado esta opciónpara que devuelva el mensaje NO CHANGEcuando una fórmula DBSn seleccione unacelda de nivel C. Devuelve F si se haconfigurado esta opción como F.

Ejemplo

=OPTGET("DataBaseDirectory")

Este ejemplo devuelve la ruta completa del directorio de datos del servidor local.

N_DISCONNECTN_DISCONNECT le desconecta de todos los servidores remotos a los que estéconectados. Esta función no le desconecta de su servidor local.


N_DISCONNECT devuelve TRUE si se desconecta correctamente de todos losservidores a los que esté conectado. Devuelve FALSE si no puede desconectarse delos servidores remotos.

SintaxisN_DISCONNECT

Argumentos

Ninguno.

OPTSETOPTSET establece una valor de una opción de TM1 especificada.


SintaxisOPTSET(option, value)


option Un nombre de opción de TM1 válido.

value Un valor válido para la opción especificada.



AdminHost Especifique el nombre del Host deadministración en el que se esté ejecutandoun Servidor de administración.

AnsiFiles Especifique un valor que establezca el juegode caracteres utilizado durante lasimportaciones de datos. Especifique T parautilizar el juego de caracteres ANSI.Especifique F para utilizar el juego decaracteres ASCII.

DataBaseDirectory Especifique un valor que establezca la rutacompleta del directorio de datos del servidorlocal.

GenDBRW Especifique un valor que determine lafórmula que TM1 utilizará para enlazarvalores de hojas de trabajo de sección concubos. Especifique T para generar fórmulasDBRW cuando se creen hojas de trabajo desección. Especifique F para generar fórmulasDBR.

NoChangeMessage Especifique un valor que determine si TM1mostrará el mensaje NO CHANGE cuandouna fórmula DBSn seleccione una celda denivel C. Especifique T para mostrar elmensaje. Especifique F para mostrarúnicamente el valor.

Ejemplo

=OPSET("DataBaseDirectory","c:\Tm1data")

Este ejemplo establece el directorio de datos local en c:\Tm1data.

PublishSubsetPublishSubset publica un subconjunto privado con nombre en un servidor.


Si trata de publicar un subconjunto privado para el que exista un subconjuntopúblico con el mismo nombre, se le pedirá que sobrescriba el subconjunto públicoexistente.


SintaxisPublishSubset(dimension, subset)


dimension El nombre con el prefijo del servidor de ladimensión que contiene el subconjuntoprivado que desea publicar. Por ejemplo,para publicar un subconjunto de ladimensión Region del servidor Finance,pasaría "Finance:Region" como argumentode la dimensión.

subset El nombre del subconjunto privado quedesea publicar.

PublishViewPublishView publica una vista privada con nombre en un servidor.


Esta función no puede publicar una vista privada que utilice subconjuntosprivados. Todos los subconjuntos privados de una vista privada deben publicarseprimero con la función de macro PublishSubset.

Si trata de publicar una vista privada para la que exista una vista pública con elmismo nombre, se le pedirá que sobrescriba la vista pública existente.

SintaxisPublishView(cube, view)


cube El nombre con el prefijo del servidor delcubo que contiene la vista privada que deseapublicar. Por ejemplo, para publicar unavista del cubo Projections en el servidorFinance, pasaría "Finance:Projections" comoargumento del cubo.

view El nombre de la vista privada que deseapublicar.

QUDEFINEQUDEFINE establece y guarda parámetros para conjuntos de consultas de TM1 .


QUDEFINE es el equivalente de crear un conjunto de consultas utilizando elcuadro de diálogo Extracción de vistas.


Puede ejecutar consultas creadas con esta función utilizando el cuadro de diálogoExtracción de vistas.

También puede utilizar el conjunto de consultas como un argumento para lasfunciones de macro QUEXPORT, QULOOP y QUSUBSET.

Nota: QUDEFINE aplica un bloqueo al servidor, lo que impide que otros usuariosaccedan al servidor durante la ejecución de la función. Si utiliza esta función paracrear una consulta que englobe una gran sección de un cubo, es posible que nopueda accederse al servidor durante un tiempo considerable.

SintaxisQUDEFINE(cube, query, range, LowLim, HiLim, SkpZeroes,SkpCons)


cube El nombre del cubo al que se le realizaráuna consulta.

Utilice un prefijo de nombre de servidorpara indicar la ubicación del servidor. Parael servidor local, especifique local:cube. Paraun servidor remoto, especifiqueservername:cube.

query El nombre del conjunto de consultas que seguardará para utilizarlo en el futuro.



range Un rango de celdas de la hoja de trabajo queincluye una columna para cada dimensióndel cubo. Cuando ejecute la consulta, TM1únicamente examinará las celdas del cuboidentificadas por los elementos que seespecifican en el rango o a los que se hacereferencia en el rango.

El rango debe contener una columna paracada dimensión del cubo. El orden de lascolumnas debe ser el mismo que lasdimensiones del cubo.

En cada columna, debe especificar o hacerreferencia a los elementos que se incluirán.Para incluir un subconjunto de elementos,indique los nombres de los elementos oespecifique un nombre de un subconjunto.Escriba el nombre del subconjunto precedidopor el carácter de barra inclinada invertida(\). Por ejemplo, \trimestre especifica elsubconjunto trimestre. Para incluir todos loselementos en una dimensión (el subconjuntoALL), deje la columna en blanco.

Puede utilizar las funciones DBR para llenarlas celdas del rango. Si las funcionesdevuelven valores en blanco para cualquiercolumna del rango, QUDEFINE utiliza elsubconjunto ALL para la dimensión asociadaa dicha columna.

LowLim El valor de celda más bajo que se tendrá encuenta para la exportación.

HighLim El valor de celda más alto que se tendrá encuenta para la exportación.

SkpZeroes Especifica si se omiten las celdas quecontengan ceros. Especifique TRUE paraexcluirlas, FALSE para incluirlas.

SkpCons Especifica si se omiten las celdas quecontengan valores consolidados. EspecifiqueTRUE para excluirlas, FALSE para incluirlas.

Ejemplo

=QUDEFINE("local:98sales", "Topsell", Sheet1!B3:F5, 3000, 5000, TRUE, TRUE)

Este ejemplo crea un conjunto de consultas que contiene elementos mostrados en laSheet1, en el rango de celdas B3:F5. Cuando ejecuta esta consulta, TM1 únicamenteinspeccionará las celdas del cubo identificadas por estos elementos y exportarávalores no consolidados del rango 3000 a 5000.


Nota: Si lowlim o highlim es una cadena compuesta por caracteres numéricos,Excel requerirá que la cadena aparezca entre cuatro comillas dobles y signos &sencillos, tal y como se indica a continuación:""""&"0123"&""""

QUDEFINEEXQUDEFINEEX establece y guarda parámetros para conjuntos de consultas de TM1.


Es el equivalente de crear un conjunto de consultas utilizando el cuadro de diálogoExtracción de vistas. Esta función es idéntica a la macro QUDEFINE, con laexcepción de que QUDEFINEEX incluye un argumento que le permite excluirvalores derivados de reglas de la consulta.

Puede ejecutar consultas creadas con esta función utilizando el cuadro de diálogoExtracción de vistas.

También puede utilizar el conjunto de consultas como un argumento para lasfunciones de macro QUEXPORT, QULOOP y QUSUBSET.

Nota: QUDEFINEEX aplica un bloqueo al servidor, lo que impide que otrosusuarios accedan al servidor durante la ejecución de la función. Si utiliza estafunción para crear una consulta que englobe una gran sección de un cubo, esposible que no pueda accederse al servidor durante un tiempo considerable.

SintaxisQUDEFINEEX(cube, query, range, lowlim, hilim, skpZeroes,skpCons, skpRuleVals)




query El nombre del conjunto de consultas que seguardará para utilizarlo en el futuro.



range Un rango de celdas de la hoja de trabajo queincluye una columna para cada dimensióndel cubo. Cuando ejecute la consulta, TM1únicamente examinará las celdas del cuboidentificadas por los elementos que seespecifican en el rango o a los que se hacereferencia en el rango.

El rango debe contener una columna paracada dimensión del cubo. El orden de lascolumnas debe ser el mismo que lasdimensiones del cubo.

En cada columna, debe especificar o hacerreferencia a los elementos que se incluirán.Para incluir un subconjunto de elementos,indique los nombres de los elementos oespecifique un nombre de un subconjunto.Escriba el nombre del subconjunto precedidopor el carácter de barra inclinada invertida(\). Por ejemplo, \trimestre especifica elsubconjunto trimestre. Para incluir todos loselementos en una dimensión (el subconjuntoALL), deje la columna en blanco.

Puede utilizar las funciones DBR para llenarlas celdas del rango. Si las funcionesdevuelven valores en blanco para cualquiercolumna del rango, QUDEFINEEX utilizaráel subconjunto ALL para la dimensiónasociada a dicha columna.

lowlim El valor de celda más bajo que se tendrá encuenta para la exportación.

highlim El valor de celda más alto que se tendrá encuenta para la exportación.

skpZeroes Especifica si se omiten las celdas quecontengan ceros. Especifique TRUE paraexcluirlas, FALSE para incluirlas.

skpCons Especifica si se omiten las celdas quecontengan valores consolidados. EspecifiqueTRUE para excluirlas, FALSE para incluirlas.

skpRuleVals Especifica si se omiten las celdas quecontengan valores derivados de reglas.Especifique TRUE para excluirlas, FALSEpara incluirlas.

Ejemplo

=QUDEFINEEX("local:SalesCube", "Topsell", Sheet1!B3:F5, 3000, 5000, TRUE, TRUE,FALSE)


Este ejemplo crea un conjunto de consultas que contiene elementos mostrados enSheet1, en el rango de celdas B3:F5. Cuando ejecute esta consulta, TM1 únicamenteinspeccionará las celdas del cubo identificadas por estos elementos y exportarávalores no consolidados en el rango 3000 a 5000, incluyendo los derivados a travésde reglas.

Nota: Si lowlim o highlim es una cadena compuesta por caracteres numéricos,Excel requerirá que la cadena aparezca entre cuatro comillas dobles y signos &sencillos, tal y como se indica a continuación:""""&"0123"&""""

QUEXPORTQUEXPORT exporta valores de celdas del cubo especificado a un archivo ASCIIdelimitado.


Para crear el conjunto de consultas, utilice la función QUDEFINE.

Los registros de salida tienen el siguiente formato:v El nombre del cubo que contiene los valores exportadosv Nombres de elementos que identifican la ubicación de celda de un único valor

exportadov El valor exportado

Para un cubo de cinco dimensiones, TM1 crea registros que contienen sietecampos:

"cube name", "elem1", "elem2", "elem3", "elem4", "elem5", valor

Nota: QUEXPORT aplica un bloqueo al servidor, lo que impide que otros usuariosaccedan al servidor durante la ejecución de la función. Si utiliza esta función paraexportar valores de un conjunto grande de consultas, es posible que no puedaaccederse al servidor durante un tiempo considerable.

SintaxisQUEXPORT(cube, query, file)




query El nombre de un conjunto de consultasexistente.



file El nombre del archivo ASCII delimitado(.cma) que contendrá los datos del cuboexportado. No incluya la extensión dearchivo. El archivo se crea en el directorio dedatos local.

Ejemplo

=QUEXPORT("sales:98sales", "Sedans", "Sedans")

Este ejemplo exporta datos del cubo 98sales utilizando el conjunto de consultasSedans. Los registros se escriben en el archivo Sedans.cma.

QULOOPQULOOP exporta datos del cubo especificado que cumplen con los criterios delconjunto de consultas.


TM1 lee cada registro de salida, uno por uno, para la primera fila de la hoja detrabajo activa. Cada campo llena una celda distinta. La hoja de trabajo se recalculatras leer cada registro.

Los registros de salida tienen el siguiente formato:v El nombre del cubo que contiene los valores exportadosv Los nombres de elementos que identifican la ubicación de celda de un único

valor exportadov El valor exportado

Para un cubo de cinco dimensiones, TM1 crea registros que contienen sietecampos:

"cube name", "elem1", "elem2", "elem3", "elem4", "elem5", valor

Utilice QULOOP conjuntamente con una fórmula DBSn para llenar celdas de uncubo.

Nota: QULOOP aplica un bloqueo al servidor, lo que impide que otros usuariosaccedan al servidor durante la ejecución de la función. Si utiliza esta función paraexportar valores de un conjunto grande de consultas, es posible que no puedaaccederse al servidor durante un tiempo considerable.


SintaxisQULOOP(cube, query)


cube El nombre del cubo al que se le realizaráuna consulta. Utilice un prefijo de nombrede servidor para indicar la ubicación delservidor. Para el servidor local, especifiquelocal:cube. Para un servidor remoto,especifique servername:cube.

query El nombre de un conjunto de consultasexistente.

Ejemplo

=QULOOP("sales:98sales", "Sedans")

Este ejemplo exporta datos del cubo 98sales utilizando el conjunto de consultasSedans.

QUSUBSETQUSUBSET es el equivalente de ejecutar una consulta desde el cuadro de diálogoExtracción de vistas cuando se le llama desde el Editor de subconjuntos.


Nota: QUSUBSET aplica un bloqueo al servidor, lo que impide que otros usuariosaccedan al servidor durante la ejecución de la función. Si utiliza esta función paraejecutar una consulta que devuelva un gran número de elementos, es posible queno pueda accederse al servidor durante un tiempo considerable.

SintaxisQUSUBSET(cube, query, dimension, subset)


cube El nombre del cubo al que se le realizaráuna consulta. Utilice un prefijo de nombrede servidor para indicar la ubicación delservidor. Para el servidor local, especifiquelocal:cube. Para un servidor remoto,especifique servername:cube.

query El nombre de una consulta existente.

dimension El nombre de una dimensión para la queexiste la consulta.



subset El nombre del subconjunto de dimensionesque se creará, que incluirá la lista deelementos que cumplen con los criterios delsubconjunto. Por ejemplo, un subconjuntopuede devolver la lista de regiones en lasque las ventas de coches superan unadeterminada cantidad.

Ejemplo

=QUSUBSET("sales:98sales", "Top", "Region", "Topsales")

Este ejemplo crea el subconjunto Topsales de la dimensión Region según loscriterios de la consulta Top.

R_SAVER_SAVE guarda la hoja de trabajo activa como una hoja de trabajo de reglas y lacompila en un archivo .rux.


El libro de trabajo debe tener el mismo nombre que el cubo para el que se estáncompilando las reglas.

Las sentencias de reglas que evitan que se compilen las reglas se escriben en elarchivo tm1erlog.cma, del directorio de datos local.

SintaxisRSAVE

Argumentos

Ninguno.

SUBDEFINESUBDEFINE crea un subconjunto de dimensiones formado por nombres deelementos encontrados en la hoja de trabajo activa.


Cuando SUBDEFINE crea el subconjunto, éste se creará como subconjunto privado.

Si el subconjunto con nombre ya existe como subconjunto privado cuando seejecuta la función, sobrescribirá el subconjunto privado con ese nombre.

Si el subconjunto con nombre ya existe como subconjunto público, SUBDEFINEcreará el subconjunto como privado. Si desea sobrescribir el subconjunto públicocon nombre existente, deberá publicar el subconjunto privado creado por lafunción SUBDEFINE para sobrescribir el subconjunto público existente.


Nota: SUBDEFINE aplica un bloqueo al servidor, lo que impide que otros usuariosaccedan al servidor durante la ejecución de la función. Si utiliza esta función paracrear un subconjunto con un gran número de elementos, es posible que no puedaaccederse al servidor durante un tiempo considerable.

SintaxisSUBDEFINE(dimension, subset, range)


dimension El nombre de la dimensión para la quedesea crear un subconjunto. Utilice unprefijo de nombre de servidor para indicarla ubicación del servidor. Para el servidorlocal, especifique local:dim. Para un servidorremoto, especifique servername:dim.

subset El nombre del subconjunto de dimensiones.

range El rango de las celdas de la hoja de trabajoque contienen los nombres de los elementosde la dimensión. Se ignorarán los valores decelda del rango que no sean elementosválidos.

Ejemplo

=SUBDEFINE("local:Model", "Smith", B7:M7)

Este ejemplo crea un subconjunto denominado Smith para la dimensión Model. Elsubconjunto contiene elementos encontrados en el rango de celdas B7:M7.

SUBPICKSUBPICK llama a un cuadro de diálogo que muestra todos los elementos delsubconjunto especificado.


Los elementos que seleccione se insertarán en la hoja de trabajo activa,comenzando en la posición de celda actual.

SintaxisSUBPICK(dimension, subset, vertical)


dimension El nombre de la dimensión que contienesubconjuntos. Utilice un prefijo de nombrede servidor para indicar la ubicación delservidor. Para el servidor local, especifiquelocal:dim. Para un servidor remoto,especifique servername:dim.



subset El nombre del subconjunto cuyos elementosdesea seleccionar.

vertical Especifique TRUE para insertar los nombresde los elementos de forma vertical, desde lacelda actual hacia abajo. Especifique FALSEpara insertar los nombres de los elementosde forma horizontal, desde la celda actualhacia la derecha.

Ejemplo

=SUBPICK("local:Model", "Smith", TRUE, )

Este ejemplo inserta elementos seleccionados del subconjunto Smith en la hoja detrabajo activa. Los elementos se organizan de forma vertical, comenzando desde lacelda actual hacia abajo.

T_CLEART_CLEAR borra todos los cambios o adiciones realizados en los datos del cubodesde la memoria.


Nota: T_CLEAR no le pregunta si desea guardar en disco algún dato del cubo dela RAM. Los datos que no se hayan guardado se eliminarán sin guardarse en eldisco. Por lo tanto, si desea guardar los datos del cubo que estén actualmente en laRAM, llame en primer lugar a la función T_SAVE.

SintaxisT_CLEAR

Argumentos

Ninguno.

T_CREATET_CREATE crea un cubo que cuenta con un máximo de ocho dimensiones, que esel límite en las versiones antiguas de TM1 .


Nota: Si utiliza T_CREATE para crear un cubo con el nombre de un cubo yaexistente, TM1 sustituirá el cubo existente y eliminará todos sus datos.


SintaxisT_CREATE(cube,d1,d2[,d3,d4,d5,d6,d7,d8])


cube El nombre del cubo que se creará.


d1...d8 Nombres de ocho dimensiones existentescomo máximo, en el orden en el que deseealmacenarlas en el cubo. Debe especificar almenos dos dimensiones.

Ejemplo

=T_CREATE("local:Sales","Region","Products","Month")

Este ejemplo crea un cubo denominado Sales. Este nuevo cubo tiene tresdimensiones, que aparecen en el siguiente orden: Region, Products y Month.

T_CREATE16T_CREATE16 crea un cubo que cuenta con un máximo de dieciséis dimensiones.


Nota: Si el primer argumento de esta función es un nombre de cubo existente,TM1 sustituirá el cubo existente y eliminará todos sus datos.

SintaxisT_CREATE16(cube,d1,d2[,d3,...,d16])


cube El nombre del cubo que se creará.


d1...d16 Nombres de dieciséis dimensiones existentescomo máximo, en el orden en el que deseealmacenarlas en el cubo. Debe especificar almenos dos dimensiones.


Ejemplo

=T_CREATE("Sales","Region","Products","Month")

Este ejemplo crea un cubo denominado Sales. Este nuevo cubo tiene tresdimensiones, que aparecen en el siguiente orden: Region, Products y Month.

T_PICKT_PICK llama a un cuadro de diálogo que muestra todos los cubos disponibles enlos servidores locales y remotos de TM1 .


El nombre del cubo que selecciona en el cuadro de diálogo se convierte en el valorde la función T_PICK. Su macro inserta el nombre del cubo en la primera celda dela hoja de trabajo activa.

SintaxisT_PICK

Argumentos

Ninguno.

T_SAVET_SAVE guarda en disco todos los datos del cubo que están actualmente en laRAM.


T_SAVE solamente puede utilizarse para guardar datos en un servidor local; lafunción no puede utilizarse con servidores remotos. T_SAVE no le pregunta sidesea guardar datos de cubos individuales.

SintaxisT_SAVE

Argumentos

Ninguno.

TM1RECALCTM1RECALC obliga a volver a calcular todas las hojas de trabajo abiertas. Es elequivalente de pulsar F9 en Excel.


Una función de macro similar, TM1RECALC1, obliga a volver a calcularúnicamente la hoja de trabajo activa.


SintaxisTM1RECALC

Argumentos

Ninguno.

TM1RECALC1TM1RECALC1 fuerza un recálculo de la hoja de trabajo activa. Es el equivalente depulsar MAYÚSCULAS-F9 en Excel.


Una función de macro similar, TM1RECALC, obliga a volver a calcular todas lashojas de trabajo abiertas.

SintaxisTM1RECALC1

Argumentos

Ninguno.

VUSLICEVUSLICE crea una hoja de trabajo de sección desde la vista de cubos especificada.


La sección se inserta comenzando en la celda superior izquierda (A1 o R1C1) de lahoja de trabajo activa.

SintaxisVUSLICE(cube, view)


cube El nombre de un cubo existente.


view El nombre de una vista asociada al cubo.

Ejemplo

=VUSLICE("local:98sales","Quarterly")

Este ejemplo copia datos de la vista Quarterly del cubo 98sales en la hoja detrabajo activa.


W_DBSENABLEW_DBSENABLE activa (o desactiva) la acción de volver a calcularautomáticamente las funciones DBS en una hoja de trabajo.


Por lo general, si se inserta una función DBS en una hoja de trabajo, la función nose ejecutará hasta que la hoja vuelva a calcularse con las teclas F9 oMAYÚSCULAS+F9. Puede utilizar la función W_DBSENABLE para ejecutarinmediatamente funciones DBS a medida que se crean en una hoja de trabajo.

Nota: Las funciones DBS no se ejecutarán en los módulos VBA a no ser queW_DBSENABLE se configure como TRUE.

Sintaxis=W_DBSENABLE(LogicalFlag)


LogicalFlag Si es TRUE, las funciones DBS se ejecutaráninmediatamente cuando se inserten en unahoja de trabajo o se llamen desde ella.

Si es FALSE, las funciones DBS únicamentese ejecutarán cuando la hoja de trabajovuelva a calcularse de forma explícita.


Capítulo 5. Funciones de hoja de trabajo

Este capítulo describe las funciones que se pueden utilizar en una hoja de trabajo.

Descripción general de las funciones de las hojas de trabajoLas funciones de hoja de trabajo de IBM Cognos TM1 devuelven un valor decadena o numérico, y se pueden utilizar en cualquier lugar de la hoja de trabajo deExcel.

Para acceder a estas funciones de Excel, seleccione Insert, Función en la barra demenú de Excel o pulse en la barra de herramientas de Excel.

Si una función de hoja de trabajo hace referencia a un objeto de un servidorremoto, debe colocar un prefijo delante del objeto, que incluya el nombre delservidor y dos puntos. Por ejemplo, para hacer referencia al cubo 2k2sales en elservidor accounting, utilice accounting:2k2sales. Debe estar conectado al servidor alque se hace referencia a través de la función para recibir valores precisos en la hojade trabajo. Si no está conectado al servidor, las funciones de hoja de trabajo TM1devolverán *KEY_ERR.

Debe ajustarse a las convenciones de formato de las funciones del programa dehojas de cálculo a la hora de utilizar las funciones TM1 .

Las funciones de hojas de trabajo TM1 aceptan cadenas, valores o referencias decelda como argumentos. Las cadenas deben colocarse entre comillas, y lasreferencias de celda deben hacer referencia a argumentos válidos de una funcióndeterminada. Puede utilizar convenciones estándar de referencias de celdaabsolutas y relativas en las funciones de hoja de trabajo.

Si registra una macro de hoja de trabajo en Excel que incluya la funcionalidad TM1, la macro que aparece como resultado puede incluir funciones de hoja de trabajoTM1 no documentadas. Sin embargo, podemos modificar o suspender estasfunciones no documentadas en futuras versiones sin previo aviso.

Las funciones de hoja de trabajo no pueden utilizarse en reglas TM1 ni enprocesos de TurboIntegrator.

DBRDBR recupera un valor de un cubo de TM1 especificado.

Se trata de una función de hoja de trabajo TM1 , únicamente válida en las hojas detrabajo.

Cuando todos los argumentos de elemento (e1, e2, etc.) para la función sonelementos de hoja, la función DBR también se puede utilizar para grabar valoresen el cubo especificado, a condición de que el usuario tenga los privilegios deacceso adecuados al cubo, las dimensiones, los elementos y/o las celdaspertinentes. Al introducir un valor en una celda que contiene dicha función DBR,el valor se envía al servidor.


SintaxisDBR(cube, e1, e2,[...en])


cube El nombre del cubo del que se va a recuperar el valor.

e1,...en Los nombres de elementos de dimensiones que definen laintersección del cubo que incluye el valor que desea recuperar.

Los argumentos de e1 a en distinguen secuencias. e1 debe ser unelemento de la primera dimensión del cubo, e2 debe ser unelemento de la segunda dimensión, etc. Estos argumentos tambiénpueden ser nombres de alias de elementos de dimensiones.

Los nombres de elemento numéricos deben colocarse entrecomillas dobles. Por ejemplo ""14357"".

EjemploDBR("92act4d", "California", "3.5 Diskettes", "Net Sales","January")

En este ejemplo, 92act4d es el nombre del cubo y la función devuelve el valor en laintersección de California, 3.5 Diskettes, Net Sales y January.

DBRADBRA recupera el valor de un atributo de elemento especificado.


El valor devuelto puede ser de cadena o numérico, en función del tipo de atributo.

La función DBRA también se puede utilizar para escribir valores de atributos deelementos en el servidor. Al introducir un valor, ya sea numérico o de cadena, enuna celda que contenga una función DBRA, el atributo de elementocorrespondiente se actualizará en el servidor.

SintaxisDBRA(server:dimension, element, attribute)


server:dimension Un nombre de dimensión válido debe llevar delante el nombredel servidor adecuado y dos puntos; por ejemplo, "SData:Region"hace referencia a la dimensión Region del servidor SData.

Si la dimensión no va precedida del nombre de un servidor, lafunción DBRA intentará ejecutar el servidor local.


attribute El atributo para el que desea recuperar un valor. Este argumentodebe ser un atributo válido del elemento.


EjemploDBRA("SData:Model", "L Series 1.8L Sedan", "ManufactureCode")

En este ejemplo, la función devuelve el valor del atributo Manufacture Code delelemento L Series 1.8L Sedan de la dimensión Model en el servidor SData.

DBRWDBRW recupera un valor de un cubo de TM1 especificado.


Cuando todos los argumentos de elemento (e1, e2, etc.) para la función sonelementos de hoja, la función DBRW también se puede utilizar para grabar valoresen el cubo especificado, a condición de que el usuario tenga los privilegios deacceso adecuados al cubo, las dimensiones, los elementos y/o las celdaspertinentes.

Esta función es similar a la función DBR, aunque con una gran diferencia; DBRWreduce el tráfico de red y puede mejorar el rendimiento en redes de área amplia.

En las hojas de trabajo con un gran número de funciones TM1 , DBRW obliga aTM1 a ejecutar funciones en "paquetes" en lugar de individualmente. Las funcionesDBR habituales se ejecutan individualmente durante el recálculo de hojas detrabajo. Las funciones DBRW obligan a TM1 a ejecutar dos pasadas en la hoja detrabajo. En la primera pasada, todos los valores modificados en las celdas quecontienen funciones DBRW se envían en un único paquete al cubo. En la segundapasada, los valores del cubo se envían en un único paquete de vuelta a la hoja detrabajo. En consecuencia, la hoja de trabajo se recalcula dos veces cuando seejecutan las funciones DBRW.

La creación de paquetes DBRW tiene lugar cuando la función se utiliza en unacelda independiente. Cuando las funciones DBRW se utilizan en cálculoscomplejos, la función actúa como una función DBR, por lo que no se producenacumulaciones de rendimiento.

SintaxisDBRW(cube, e1, e2[,...en])


cube El nombre del cubo de la base de datos en el que se va arecuperar el valor.

e1,...en Los nombres de elementos de dimensiones que definen laintersección del cubo que incluye el valor que desea recuperar.

Los argumentos de e1 a en distinguen secuencias. e1 debe ser unelemento de la primera dimensión del cubo, e2 debe ser unelemento de la segunda dimensión, etc. Estos argumentostambién pueden ser nombres de alias de elementos dedimensiones.

Los nombres de elemento numéricos deben colocarse entrecomillas.

Capítulo 5. Funciones de hoja de trabajo 195

EjemploDBRW("92act4d", "California", "3.5 Diskettes", "NetSales", "January")

En este ejemplo, la función devuelve el valor que se encuentra en la intersección deCalifornia, 3.5 Diskettes, Net Sales y January del cubo 92act4d.

DBSDBS envía un valor numérico a un cubo TM1 .


Esta función no puede enviar una cadena a un cubo. Para enviar cadenas, utilice lafunción DBSS.

Al crear una función DBS con la opción Editar fórmula de TM1, el cuadro dediálogo Editar fórmula le guiará a través de una serie de pasos para crear cadaargumento de función en la secuencia correcta.

Si el cubo no existe o alguno de los argumentos no es válido, la función devolveráKEY ERROR.

SintaxisDBS(value, cube, e1, e2[,...en])


value El valor que se está enviando.

cube El cubo al que se envía el valor.

e1, ...en Los nombres de elementos que definen la intersección del cuboal que se envía el valor.

Los argumentos de e1 a en distinguen secuencias. e1 debe serun elemento de la primera dimensión del cubo, e2 debe ser unelemento de la segunda dimensión del cubo, etc. Estosargumentos también pueden ser nombres de alias de elementosde dimensiones.

Los nombres de elemento numéricos deben colocarse entrecomillas.

EjemploDBS(5342,"92act4d","California","3.5 Diskettes", "NetSales", "January")

En este ejemplo, la función envía el valor 5342 al cubo 92act4d en la intersecciónde California, 3.5 Diskettes, Net Sales y January.

DBSADBSA envía un valor a un atributo de elemento especificado.



El valor enviado puede ser de cadena o numérico, en función del tipo de atributo.

SintaxisDBSA(att_value, dimension, element, att_name)


att_value El valor que desea enviar.

dimension Un nombre de dimensión válido. El nombrede la dimensión debe llevar delante elnombre del servidor adecuado y dos puntos;por ejemplo, "SData:Region" hace referenciaa la dimensión Region del servidor SData.

Si la dimensión no va precedida del nombrede un servidor, la función DBSA intentaráejecutar el servidor local.


att_name El atributo al que desea enviar un valor.att_name debe ser un atributo válido delelemento especificado por elem_name.

EjemploDBSA(’’LS-1.8-M7398", "SData:Model", "L Series 1.8LSedan", "Manufacture Code")

DBSSDBSS envía una cadena a un cubo de cualquier número de dimensiones.


Esta función no puede enviar un valor numérico a un cubo. Utilice la función DBSpara enviar valores numéricos.

Al crear una función DBSS con la opción Editar fórmula de TM1, el cuadro dediálogo Editar fórmula le guiará a través de una serie de pasos para crear cadaargumento de función en la secuencia correcta.

Si el cubo no existe o alguno de los argumentos no es válido, la función devolveráKEY ERROR.

SintaxisDBSn(string, cube, e1, e2,...en)


string La cadena que se está enviando.

cube El cubo al que se envía la cadena.



e1, ...en Los nombres de elementos que definen laintersección del cubo al que se envía lacadena.

Los argumentos de e1 a en distinguensecuencias. e1 debe ser un elemento de laprimera dimensión del cubo, e2 debe ser unelemento de la segunda dimensión del cubo,etc. Estos argumentos también pueden sernombres de alias de elementos dedimensiones.

EjemploDBSS("Smith","Info","California","Last Name")

En este ejemplo, la fórmula envía la cadena Smith al cubo Info en la intersecciónde California y Last Name.

DBSWDBSW envía un valor numérico a un cubo TM1 .


Esta función no puede enviar una cadena a un cubo. Para enviar cadenas, utilice lafunción DBSS.

Esta función es similar a la función DBS, aunque con una gran diferencia; DBSWreduce el tráfico de red y puede mejorar el rendimiento en redes de área amplia.

En las hojas de trabajo con un gran número de referencias de cubos, DBSW obligaa TM1 a enviar valores en paquetes en lugar de individualmente. Las funcionesDBS habituales se actualizan individualmente durante el recálculo. Las referenciasDBSW obligan a TM1 a enviar todos los valores modificados en una hoja detrabajo en un único paquete.

En dichas circunstancias, puede utilizar de forma segura una función DBS/DBRcomo argumento en una función DBS.

Nota: Si utiliza VBA para calcular una hoja de trabajo que contenga funcionesDBSW, debe llamar a la función de macro de TM1 para calcular la hoja de trabajo.No utilice el método Calcular VB para calcular una hoja de trabajo que contengafunciones DBSW; si lo hace, cada función DBSW se ejecutará individualmente,rechazando el propósito de la función y dando como resultado un menorrendimiento.


SintaxisDBSW(value, cube, e1, e2[,...en])


value El valor que se está enviando.

cube El cubo al que se envía el valor.

e1, ...en Los nombres de elementos que definen laintersección del cubo al que se envía elvalor.

Los argumentos de e1 a en distinguensecuencias. e1 debe ser un elemento de laprimera dimensión del cubo, e2 debe ser unelemento de la segunda dimensión del cubo,etc. Estos argumentos también pueden sernombres de alias de elementos dedimensiones.

Los nombres de elemento numéricos debencolocarse entre comillas.

EjemploDBSW(5342,"92act4d","California","3.5 Diskettes", "NetSales", "January")

DFRSTDFRST devuelve el primer elemento de una dimensión especificada.


SintaxisDFRST(server_name:dimension)



EjemploDFRST("planning_sample:Location")

Si la dimensión Location incluye los elementos ordenados California, Oregon yWashington, el ejemplo devuelve California.

DIMIXSe trata de una función de hoja de trabajo TM1 , únicamente válida en las hojas detrabajo.

DIMIX devuelve el número de índice de un elemento de una dimensión.


SintaxisDIMIX(server_name:dimension, element)




Si el elemento no es un elemento de ladimensión especificada, la función devuelve0. Este argumento puede ser también elnombre de un alias de un elemento de ladimensión.

EjemploDIMIX("planning_sample: Location","Washington")

Si la dimensión Location contiene los elementos ordenados California, Oregon yWashington, el ejemplo devolverá el valor 3, ya que Washington es el tercerelemento de la dimensión.

DIMNMDIMNM devuelve el elemento de una dimensión que corresponde al argumento deíndice.


Si incluye el parámetro Alias opcional en esta función, la función devolverá el aliasdel elemento seleccionado

Al efectuar una doble pulsación en una celda que contiene una función DIMNM,se abrirá el cuadro de diálogo Dimensión. A continuación, puede seleccionar unnuevo elemento para colocarlo en la hoja de trabajo. La función DIMNM actualizaautomáticamente el argumento de índice para reflejar el nuevo elemento.

SintaxisDIMNM(server_name:Dimension, Index, [Alias])


Dimensión Un nombre de dimensión válido.

Index Un valor menor o igual que el número deelementos de la dimensión.

Alias El nombre de un alias que existe en ladimensión. Éste es un argumento opcional.SI lo utiliza, la función devolverá el alias delelemento especificado.


Ejemplo

Si la dimensión Location incluye los elementos ordenados California, Oregon yWashington, el ejemplo devuelve Oregon.

DIMSIZDIMSIZ devuelve el número de elementos de una dimensión especificada.


SintaxisDIMSIZ(dimension)



EjemploDIMSIZ("Accounts")

Si la dimensión Accounts incluye 19 elementos, el ejemplo devuelve el valor 19.

DNEXTDNEXT devuelve el nombre de elemento que sigue al elemento especificado comoargumento de la función.


SintaxisDNEXT(server:dimension, element)


server:dimension Un nombre de dimensión válido debe llevardelante el nombre del servidor adecuado ydos puntos; por ejemplo, "SData:Region"hace referencia a la dimensión Region delservidor SData.

Si la dimensión no lleva delante un nombrede servidor, la función DNEXT intentaráejecutarse frente al servidor local.


EjemploDNEXT("Production:Location","Oregon")


Si la dimensión Location del servidor Production contiene los elementos ordenadosCalifornia, Oregon y Washington, el ejemplo devuelve Washington.

DNLEVDNLEV devuelve el número de niveles jerárquicos de una dimensión.


SintaxisDNLEV(dimension)



EjemploDNLEV("Region")

En la dimensión Region, las diversas naciones (nivel 0) se agregan formandoregiones (nivel 1). Las regiones se agregan formando superregiones (nivel 2), que asu vez se agregan formando el mundo (nivel 3).

En la dimensión Region existen cuatro niveles jerárquicos (0, 1, 2 y 3). Por lo tanto,el ejemplo devolverá el valor 4.

DTYPEDTYPE devuelve información sobre el tipo de elemento del elemento especificado.Devuelve "N" si el elemento es un elemento numérico, "S" si el elemento es unelemento de cadena.


SintaxisDTYPE(dimension, element)






EjemploDTYPE("Region","Europe")

El elemento Europe de la dimensión Region es un elemento consolidado, de modoque el ejemplo devuelve "C".

ELCOMPELCOMP devuelve el nombre de un hijo de un elemento consolidado de unadimensión especificada.



SintaxisELCOMP(dimension, element, index)



element El nombre de un elemento consolidado de ladimensión. Este argumento puede sertambién el nombre de un alias de unelemento de la dimensión.

index Un valor positivo menor o igual que elnúmero total de hijos del elementoespecificado.

EjemploELCOMP("Region","Central Europe",2)

En la dimensión Region, el elemento consolidado Central Europe es unaconsolidación de los hijos Germany y France. De esta manera, el ejemplo devuelveFrance.

ELCOMPNELCOMPN devuelve el número de componentes de un elemento especificado.




SintaxisELCOMPN(dimension, element)



element El nombre de un elemento consolidado de ladimensión. Este argumento puede sertambién el nombre de un alias de unelemento de la dimensión.

Ejemplo

En la dimensión Region, el elemento Scandanavia es una consolidación de treselementos. El ejemplo devuelve 3.

ELISCOMPELISCOMP determina si element1 es un hijo de element2 en la dimensiónespecificada.


La función devuelve TRUE si element1 es un hijo de element2, de lo contrario lafunción devuelve FALSE.

SintaxisELISCOMP(dimension, element1, element2)



element1 El nombre de un elemento de la dimensión.Este argumento puede ser también elnombre de un alias de un elemento de ladimensión.


EjemploELISCOMP("Region","Germany","Central Europe")

En la dimensión Region, el elemento Central Europe es una consolidación de doselementos, Germany y France. El ejemplo devuelve TRUE.


Tenga en cuenta que esta función devuelve TRUE únicamente en los hijosinmediatos. En el ejemplo anterior, Germany es un hijo de Central Europe.Además, Central Europe es un hijo de Europe. Sin embargo, dado que la funcióndevuelve TRUE únicamente en hijos inmediatos, el siguiente ejemplo devuelveFalse:

ELISCOMP("Region","Germany","Europe")

ELISPARELISPAR determina si element1 es un padre de element2 en la dimensiónespecificada.


La función devuelve TRUE si element1 es un padre de element2, de lo contrario lafunción devuelve FALSE.

SintaxisELISPAR(dimension, element1, element2)





EjemploELISPAR("Region","Central Europe","Germany")

En la dimensión Region, el elemento consolidado Central Europe es el padre tantode Germany como de France. De esta manera, el ejemplo devuelve TRUE

Tenga en cuenta que esta función devuelve TRUE únicamente en los padresinmediatos. En el ejemplo anterior, Europe es un padre de Central Europe.Además, Central Europe es un padre de Germany. Sin embargo, dado que Europeno es un padre inmediato de Germany, el siguiente ejemplo devuelve FALSE:ELISPAR("Region","Europe","Germany")

ELLEVELLEV devuelve el nivel de un elemento de una dimensión.



SintaxisELLEV(dimension, element)



element El nombre de un elemento de la dimensión. Este argumentopuede ser también el nombre de un alias de un elemento de ladimensión.

Ejemplo

ELLEV("Region","Europe")

En la dimensión Region, las naciones individuales (nivel 0) se agregan formandoregiones (nivel 1). Las regiones se agregan formando superregiones (nivel 2), que asu vez se agregan formando el mundo (nivel 3).

El ejemplo devuelve 2, dado que Europe es un elemento de nivel 2.

ELPARELPAR devuelve el padre de un elemento en una dimensión especificada


SintaxisELPAR(dimension, element, index)




index Un valor positivo menor o igual que elnúmero total de elementos consolidados(padres) que utilizan el argumento elementcomo hijo.


Ejemplo

ELPAR("Model","Wagon 4WD",2)

En la dimensión Model, el elemento Wagon 4WD es un hijo tanto de Total Wagonscomo de Total 4WD. Por lo tanto, tanto Total Wagons como Total 4 WD son padresde Wagon 4WD. En la estructura de la dimensión Model, Total Wagons se defineen primer lugar y Total 4WD se define en segundo lugar.

El ejemplo devuelve Total 4WD, ya que es la segunda instancia de un padre deWagon 4WD en la dimensión Model.

ELPARNELPARN devuelve el número de padres de un elemento de una dimensiónespecificada.


SintaxisELPARN(dimension, element)




Ejemplo

ELPARN("Model","Wagon 4WD")

En la dimensión Model, el elemento Wagon 4WD es un hijo tanto de Total Wagonscomo de Total 4WD. Por lo tanto, tanto Total Wagons como Total 4 WD son padresde Wagon 4WD. La función devuelve 2.

ELSLENELSLEN devuelve la longitud de un elemento de cadena de una dimensión.


Si el elemento especificado no es un elemento de la dimensión especificada, o noes un elemento de cadena, la función devuelve 0.


SintaxisELSLEN(dimension, element)



element El nombre de un elemento de cadena de ladimensión. Este argumento puede sertambién el nombre de un alias de unelemento de la dimensión.

Ejemplo

ELSLEN("Region","Washington")

El elemento Washington es un elemento de cadena con 10 caracteres de longitud.El ejemplo devuelve 10.

ELWEIGHTELWEIGHT devuelve el peso de un hijo de un elemento consolidado.


SintaxisELWEIGHT(dimension, element1, element2)



element1 El nombre de un elemento consolidado de ladimensión. Este argumento puede sertambién el nombre de un alias de unelemento de la dimensión.

element2 El nombre de un hijo del elementoconsolidado. Este argumento puede sertambién el nombre de un alias de unelemento de la dimensión.

Ejemplo

ELWEIGHT("Account1","Gross margin","Variable costs")

Tal y como muestra la siguiente figura, el elemento Variable costs, que es un hijode Gross margin, tiene un peso de -1.


El ejemplo devuelve -1.

SUBNMSUBNM devuelve el elemento de un subconjunto de dimensiones correspondienteal argumento IndexOrName.


Al efectuar una doble pulsación en una celda que contiene una función SUBNM, seabrirá el Editor de subconjuntos. A continuación, puede seleccionar un nuevoelemento para colocarlo en la hoja de trabajo. El elemento seleccionado seconvertirá en el valor devuelto de la función SUBNM, y la función actualizará deforma automática el argumento IndexOrName para reflejar el nuevo elemento.

Si incluye el parámetro Alias opcional en esta función, la función devolverá el aliasdel elemento seleccionado

SintaxisSUBNM(Dimension, Subset, IndexOrName, [Alias])


Dimensión Un nombre de dimensión válido.

Subconjunto El nombre de un subconjunto de ladimensión.

IndexOrName Índice del subconjunto o nombre de unelemento del subconjunto.

Si se trata de un índice, un entero positivomenor o igual al número total de elementosdel subconjunto especificado. Si se trata deun nombre, una cadena que representa elnombre de un elemento del subconjunto.

Alias El nombre de un alias que exista para elsubconjunto. Éste es un argumento opcional.Si se utiliza, el alias especificado se aplicacuando el Editor de subconjuntos se abre yla función devuelve el alias del elementoseleccionado.

Ejemplo

SUBNM("Region","Top Producers",2)


El subconjunto Top Producers de la dimensión Region contiene los elementosordenados United States, Germany, Great Britain y Mexico. Dado que el argumentode índice apunta al segundo elemento del subconjunto, el ejemplo devuelveGermany.

SUBNM("Region","Top Producers","Germany","Deutsch")

Este ejemplo devuelve el alias Deutsch del elemento Germany (Deutschland) desdeel subconjunto Top Producers de la dimensión Region.

SUBSIZSUBSIZ devuelve el número de elementos de un subconjunto de dimensiones.


SintaxisSUBSIZ(dimension, subset)



subset El nombre de un subconjunto de ladimensión.

Ejemplo

SUBSIZ("Region","Top Producers")

El subconjunto Top Producers de la dimensión Region contiene cuatro elementos:United States, Germany, Great Britain y Mexico.

El ejemplo devuelve 4.

TABDIMTABDIM devuelve el nombre de dimensión que corresponde a un argumento deíndice determinado.


La función siempre devuelve una dimensión en función del orden de dimensionesoriginal del cubo especificado, incluso si el orden de las dimensiones del cubo hacambiado a través del Optimizador del cubo TM1 .

SintaxisTABDIM(cube, index)


cube Un nombre de cubo válido.



index Un valor positivo menor o igual que elnúmero total de dimensiones del cubo.

Ejemplo

TABDIM("98sales",3)

El cubo 98sales contiene cinco dimensiones: account1, actvsbud, model, month yregion. El ejemplo devuelve model, la tercera dimensión de 98sales.

TM1RptElIsConsolidatedTM1RptElIsConsolidated devuelve un valor booleano para indicar si se haconsolidado un elemento en un Formulario activo.

Se trata de una función de hoja de trabajo TM1 , que se utiliza para crearFormularios activos.

SintaxisTM1RptElIsConsolidated(RptRowFormula, Element)


RptRowFormula Referencia absoluta a una celda que contieneuna fórmula TM1RptRow.

Element Referencia relativa a una celda que contieneun elemento de la fórmula TM1RptRow.

TM1RptElIsExpandedTM1RptElIsExpanded devuelve un valor booleano para indicar si un elemento seexpande en un subconjunto de filas de un Formulario activo.


SintaxisTM1RptElIsExpanded(RptRowFormula, Element)


RptRowFormula Referencia absoluta a una celda que contieneuna fórmula TM1RptRow.



TM1RptElLevTM1RptElLev devuelve un valor entero de un nivel de elemento relativo a la raízdel subconjunto.


Esta función es diferente a la función de hoja de trabajo EILev.

SintaxisTM1RptElLev(RptRowFormula, Element)


RptRowFormula Referencia absoluta a una celda de lafórmula TM1RptRow.


TM1RptFilterTM1RptFilter define el filtro que se ha aplicado a la dimensión de columna de unFormulario activo.


SintaxisTM1RptFilter(ReportView,Tuple,FilterFunction,FilterValue,SortOrder)


ReportView Referencia de celda a una celda que contieneuna fórmula TM1RptView. El filtro se aplicaa la vista especificada por la fórmulaTM1RptView.

Tuple Cadena de tupla que especifica el elementode la dimensión de columna al que se aplicael filtro. Por ejemplo, [month].[Feb].

FilterFunction Uno de los siguientes nombres de funcionesde filtro:

TOPCOUNT

BOTTOMCOUNT

TOPPERCENT

BOTTOMPERCENT

TOPSUM

BOTTOMSUM



FilterValue Valor de filtro.

SortOrder Uno de los siguientes dos órdenes declasificación:

asc

desc

Ejemplo

=TM1RptFilter($B$4,"[month].[Jan]","TOPCOUNT",5,"asc")

TM1RptRowTM1RptRow establece la definición de fila maestra de formulario activo.


La definición de fila maestra rige el comportamiento de todas las filas delFormulario activo.

SintaxisTM1RptRow(ReportView, Dimension, Subset, SubsetElements,Alias, ExpandAbove,MDXStatement, Indentations, ConsolidationDrilling)


ReportView Referencia a una celda que contiene unafórmula TM1RptView.

Dimensión Una dimensión, que se especifica utilizandoel formato TM1_server_name:dimension_name.

Subconjunto Subconjunto con nombre. Si este argumentoestá vacío, se utilizarán todos los elementosde la dimensión.

SubsetElements Referencia de rango de celdas que especificauna lista de elementos para constituir unsubconjunto.

Al suministrar este argumento, se ignora elsubconjunto con nombre especificadomediante el argumento Subset.

Si este argumento está vacío, se utilizaránlos elementos del subconjunto especificadomediante el argumento Subset.



Alias Cadena que define el alias que se utiliza enel subconjunto.

Al suministrar este argumento, reemplazarála propiedad Alias predeterminada definidapor el subconjunto que especificó elargumento Subset.

Si este argumento está vacío, se utilizará elalias del subconjunto especificado medianteel argumento Subset.

ExpandAbove Distintivo booleano para activar o desactivarla propiedad Expand Above delsubconjunto. Al suministrar este argumento,reemplazará la propiedad Expand Abovepredeterminada definida por el subconjuntoque especificó el argumento Subset.

Si el valor del argumento es 1, los elementosconsolidados se expandirán hacia arriba a lahora de ver los detalles.

Si el valor del argumento es 0, los elementosconsolidados se expandirán hacia abajo a lahora de ver los detalles.

Si este argumento está vacío, se utilizará lapropiedad Expand Above del subconjuntoespecificado mediante el argumento Subset.

MDXStatement Sentencia MDX que se aplica al subconjuntoespecificado por el argumento Subset.

Al suministrar este argumento, reemplazaráel filtro MDX predeterminado definido porel subconjunto que especificó el argumentoSubset.

Si este argumento está vacío o se omite, seutilizarán los elementos del subconjuntoespecificado mediante el argumento Subset.

Indentations Valor entero para indicar cuántas sangrías seaplican a cada nivel a la hora de detallarmás un elemento consolidado. Si el valor delargumento es 0, no se realizará la sangríaautomática.

Éste es un argumento opcional. Cuando elvalor no está disponible, se aplica unasangría a cada nivel al detallar más en unelemento consolidado.



ConsolidationDrilling Distintivo booleano para activar o desactivarel acceso a los detalles en los elementosconsolidados.

Cuando el valor de este argumento es 1, losusuarios pueden detallar más en loselementos consolidados del Formularioactivo.

Cuando este valor del argumento es 0, losusuarios no pueden detallar más en loselementos consolidados del Formularioactivo.

Éste es un argumento opcional. Cuando elargumento no está disponible, elcomportamiento predeterminado es permitirver los detalles en los elementosconsolidados.

Ejemplo

=TM1RptRow($B$9,"sdata:region","",'{AR}01'!$B$17:$B$18,"",1,"",5, 0)

TM1RptTitleTM1RptTitle define una dimensión de título de formulario activo.


SintaxisTM1RptTitle(Dimension,Element)


Dimensión Una dimensión, que se especifica utilizandoel formato TM1 _name:dimension_name.

Elemento Referencia de celda a una celda que contieneuna función SUBNM que devuelve unnombre de elemento.

Ejemplo

TM1RptTitle("SData:model",$C$7)

TM1RptViewTM1RptView define la vista que aparece en un Formulario activo.



SintaxisTM1RptView(ViewID,ZeroSuppression,TM1RptTitle,...)


ViewID Nombre de la vista que utiliza el formatoTM1 _name:cube_name:unique_id.

ZeroSuppressio Distintivo booleano para activar o desactivarla propiedad de supresión de ceros de lavista. 1 = activado, 0 = desactivado

TM1RptTitle En cada dimensión de título del Formularioactivo, incluya una función TM1RptTitlecomo argumento de TM1RptView.

FormatRange El rango de formateo del Formulario activo.

Al crear un Formulario activo, se crea unrango con nombre denominadoTM1RPTFMTRNG para incluir todas lasceldas del rango de formateo. Puede utilizareste rango con nombre como argumento.

IDColumn Columna que contiene las ID de formato delFormulario activo.

Al crear un formulario activo, se crea unrango con nombre denominadoTM1RPTFMTIDCOL para incluir todas lasceldas del rango de formateo. Puede utilizareste rango con nombre como argumento.

Ejemplo

=TM1RPTVIEW("SData:SalesCube:6", 0, TM1RPTTITLE("SData:actvsbud",$C$6),TM1RPTTITLE("SData:model",$C$7), TM1RPTTITLE("SData:account1",$C$8),TM1RPTFMTRNG,TM1RPTFMTIDCOL)

TM1UserTM1User devuelve el nombre de usuario del usuario TM1 .


Si el usuario TM1 actual no está conectado a un servidor, o si el servidorespecificado no se está ejecutando, TM1User devuelve una cadena vacía.

Si TM1User se ejecuta con un servidor que está configurado para utilizar laautenticación CAM, la función devolverá el nombre de usuario interno/CAMID,no el nombre de visualización.


SintaxisTM1User("ServerName")


ServerName Nombre del servidor al que el usuario TM1está conectado.

Ejemplo

TM1User("SData")

Si un usuario denominado BrianT ha iniciado sesión en el servidor SData, y eseusuario ejecuta la función TM1User, el ejemplo anterior devolverá BrianT.

VIEWVIEW crea una vista optimizada del cubo especificado por el argumento del cubo.


Se crea una única función VIEW al dividir una vista desde el explorador de cubos.

Todas las fórmulas DBR y DBRW que hacen referencia a la función VIEW puedenacceder a esta vista optimizada. De esta forma, los resultados se devuelven de unaforma mucho más rápida.

Varias funciones VIEW pueden residir en la misma hoja de cálculo si cuenta conbloques de fórmulas DBR que hacen referencia a vistas y/o cubos TM1 diferentes.

SintaxisVIEW(cube, e1,e2[,...en])


cube El nombre del cubo desde el que se van arecuperar los datos.

e1,...en Cualquiera de los elementos específicos dela porción que se deben utilizar como títuloo la cadena "!". La cadena "!" indica que ladimensión correspondientes es una fila ocolumna de la vista. Estos argumentostambién pueden ser nombres de alias deelementos de dimensiones.

Ejemplo

VIEW("93sales",$B$2,$B$3,$B$4,"!","!")


Capítulo 6. Funciones de TM1 TurboIntegrator

TM1 TurboIntegrator le permite manipular metadatos y datos de TM1 cuandodefine un proceso.

Esto se logra mediante el uso de funciones de las subpestañas Prólogo, Metadatos,Datos y Epílogo de la pestaña Avanzado de la ventana TurboIntegrator. Estassubpestañas incluyen sentencias generadas que se basan en valores y opciones queselecciona al definir un proceso TurboIntegrator. Las funciones que cree debenaparecer tras las sentencias generadas. Para obtener más información sobre lacreación de procesos con TurboIntegrator, consulte la guía de TurboIntegratordeIBM CognosTM1 .

Las funciones de TurboIntegrator de esta sección están ordenadas por categoría.

No existe ninguna interfaz que sirva de ayuda en la creación de funciones deTurboIntegrator. Especifique funciones de forma manual directamente en lacorrespondiente subpestaña de la pestaña Avanzado. Los argumentos de cadenapara funciones de TurboIntegrator deben aparecer entre comillas simples. Paraindicar el fin de cada función, debe incluirse un punto y coma (;) en la ventana deTurboIntegrator.

Además de estas funciones de TurboIntegrator, también puede incorporar todas lasfunciones de reglas TM1 estándar en una definición de proceso, excepto la funciónSTET.

Todos los argumentos de las funciones de TurboIntegrator están limitados a 256bytes. Una función de TurboIntegrator puede aceptar varios argumentos, y todoslos argumentos están limitados a 256 bytes.

Funciones de TurboIntegrator de texto y ASCIIEstas funciones pertenecen a ASCII y texto.

ASCIIDeleteASCIIDelete elimina un archivo ASCII.

Se trata de una función de TM1 TurboIntegrator, válida únicamente en los procesosde TurboIntegrator.

SintaxisASCIIDelete(FileName);

FileName

El nombre del archivo ASCII que desea eliminar. Si no se especifica una rutacompleta, TM1 busca el archivo en el directorio de datos del servidor.

Argumento

EjemploASCIIDelete(’C:\exported_data\2002Q1Results.cma’);


Este ejemplo elimina el archivo ASCII denominado 2002Q1Results.cma deldirectorio C:\exported_data.

ASCIIOutputASCIIOutput escribe un registro separado por comas en un archivo ASCII.


El archivo ASCII se abre cuando se escribe el primer registro y se cierra cuando elprocedimiento de TurboIntegrator (Prólogo, Metadatos, Datos o Epílogo) quecontiene la función ASCIIIOutput termina de procesarse.

Los registros de salida generados por ASCIIOutput están limitados a 8000 bytes. Siun registro de salida supera los 8000 bytes, el registro se trunca y aparece un avisoen el archivo TM1ProcessError.log.

Cuando ASCIIOutput encuentra un argumento String que exige que el registro desalida supere el límite de 8000 bytes, ignora ese argumento y los argumentosposteriores. Por ejemplo, si existen 10 argumentos String y la salida de losprimeros siete argumentos es de 7950 bytes en total, y la salida del octavoargumento es de 51 bytes, únicamente se escribirá en el registro la salida de losprimeros siete argumentos. Si existen diez argumentos String y el primerargumento supera los 8000 bytes, no se escribirá ninguna salida en el registro.

Si utiliza la función ASCIIOutput para escribir en el mismo archivo en variosprocedimientos (pestañas) de un proceso TurboIntegrator, el archivo sesobrescribirá cada vez que se abra para un nuevo procedimiento.

La función ASCIIOutput genera un error leve si se produce un error al escribir elarchivo ASCII. Además, la función devuelve un valor tras la ejecución: 1 si lafunción escribe correctamente el archivo ASCII y 0 si se produce un error.

Tenga en cuenta que únicamente se generará el error y se devolverá el valor siASCIIOutput está escribiendo en un disco que no sea el disco en el que se estáejecutando el servidor. Por ejemplo, si el servidor se está ejecutando en la unidadC:, y ASCIIOutput está escribiendo en la unidad F: y esta última se queda sinespacio, se capturará el error y el servidor permanecerá activo. Si el servidor seestá ejecutando en la unidad C: mientras que ASCIIOutput también estáescribiendo en dicha unidad y ésta se queda sin espacio, el servidor finalizará(como se esperaba).

Nota: La función ASCIIOutput coloca el carácter hexadecimal 0x1A al final detodos los archivos generados. Sin embargo, TM1 Web no puede abrir una hoja webque contenga el carácter hexadecimal 0x1A.

Si utiliza ASCIIOutput para exportar datos TM1 a un archivo ASCII y, acontinuación, intenta abrir el archivo en una hoja web de TM1 , encontrará elsiguiente error.

Se produjo un error al convertir el libro de trabajo de MS Excel a formato XML; elvalor hexadecimal 0x1A no es un carácter válido.

Si elimina el carácter hexadecimal 0x1A de la hoja web, el archivo se abrirá en TM1Web.


SintaxisASCIIOutput(FileName, String1, String2, ...Stringn);


FileName Una ruta completa del archivo ASCII en elque desea escribir el registro. La ruta debeincluir una extensión de archivo.

String1...Stringn Una cadena que corresponde a cada campoque desee crear en el archivo ASCII. Esteargumento puede ser una cadena o unavariable de TurboIntegrator de una cadena.

EjemploASCIIOutput(’NewCube.cma’, V1, V2, V3, V4, V5 );

Este ejemplo escribe un registro en el archivo ASCII NewCube.cma. Cada campodel registro corresponde a una variable asignada por TurboIntegrator a unacolumna de su origen de datos.

SetInputCharacterSetLa función SetInputCharacterSet le permite especificar el juego de caracteres de unorigen de datos TurboIntegrator.


Cuando un proceso TurboIntegrator lee un archivo externo como entrada, necesitaconocer el juego de caracteres en el que se escribió dicho archivo externo. Si elarchivo contiene una marca de orden de bytes válida, las funciones de TM1 seconvertirán correctamente a UTF-8, si es necesario.

Para aquellos formatos que carezcan de una marca de orden de bytes válida, loscaracteres se deben convertir de cualquier otra codificación a UTF-8. Si losconversores adecuados están disponibles en la máquina que aloja al servidor, elarchivo de entrada se convertirá al juego de caracteres Unicode que requiere TM1 .

SintaxisSetInputCharacterSet (CharacterSet);


CharacterSet La codificación de caracteres del archivo deentrada que utilizará el procesoTurboIntegrator.

Si el argumento CharacterSet no es un tipode carácter conocido, se establece el tipopredeterminado en el entorno local delsistema.

Capítulo 6. Funciones de TM1 TurboIntegrator 221

Codificación de caracteres Entorno local del sistema

TM1CS_ISO_8859_1 ISO-8859-1 Latín 1, Europa occidental

TM1CS_ISO_8859_2 ISO-8859-2 Latín 2, Europa central

TM1CS_ISO_8859_3 ISO-8859-3 Latín 3, Europa meridional

TM1CS_ISO_8859_4 ISO-8859-4 Latín 4, Europa septentrional

TM1CS_ISO_8859_5 ISO-8859-5 Latín/Cirílico

TM1CS_ISO_8859_6 ISO-8859-6 Latín/Árabe

TM1CS_ISO_8859_7 ISO-8859-7 Latín/Griego

TM1CS_ISO_8859_8 ISO-8859-8 Latín/Hebreo

TM1CS_ISO_8859_9 ISO-8859-9 Latín 5, Turco

TM1CS_ISO_8859_10 ISO-8859-10 Latín 6, Nórdico,

TM1CS_ISO_8859_11 ISO-8859-11 Latín/Tailandés

TM1CS_ISO_8859_13 ISO-8859-13 Latín 7, Ribera del Báltico

TM1CS_ISO_8859_14 ISO-8859-14 Latín 8, Celta

TM1CS_ISO_8859_15 ISO-8859-15 Latín 9, sustituye a ISO-8859-1

TM1CS_ISO_8859_16 ISO-8859-16 Latín 10, Europa suroriental

TM1CS_WCP1250 Microsoft Windows Europa Central

TM1CS_WCP1251 Windows cirílico

TM1CS_WCP1252 Windows latín 1 multilingüe

TM1CS_WCP1253 Windows griego

TM1CS_WCP1254 Windows turco

TM1CS_WCP1255 Windows hebreo

TM1CS_WCP1256 Windows árabe

TM1CS_WCP1257 Windows báltico

TM1CS_WCP1258 Windows vietnamita

TM1CS_WCP874 Windows tailandés


Codificación de caracteres Entorno local del sistema

TM1CS_WCP932 Windows japonés

TM1CS_WCP936 Windows chino simplificado

TM1CS_WCP949 Windows coreano

TM1CS_WCP950 Windows chino tradicional

TM1CS_KOI8R Ruso y cirílico (KOI8-R)

TM1CS_GB18030 UNICODE versión PRC

TM1CS_BIG5 Chino tradicional

TM1CS_SHIFTJIS JIS 0201 + JIS 0208, ligeramente diferente deCP932

TM1CS_SJIS0213 JIS 0213-2004, no necesita BMP.

TM1CS_EUC_JP EUC japonés

TM1CS_EUC_CN EUC chino simplificado

TM1CS_EUC_KR EUC coreano

TM1CS_UTF8 UTF-8

TM1CS_UTF16 UTF-16 Little Endian

TM1CS_UTF16ESC Notación UNICODE

TM1CS_UTF32 UTF-32 Little Endian

TM1CS_OS_DEFAULT sistema operativo predeterminado

TM1CS_LOCALPATH codificación local pero notación UNICODEen modo no nativo.

EjemploSetInputCharacterSet (’TM1CS_ISO_8859_11’);

Este ejemplo especifica que el juego de caracteres de entrada del origen de datosde TurboIntegrator es ISO-8859-11 Latín/Tailandés.

SetOutputCharacterSetSetOutputCharacterSet le permite especificar el juego de caracteres que se utilizaráal escribir en un archivo de texto utilizando TextOutput en un proceso deTurboIntegrator.



La función con la función TextOutput.

Se utiliza con TextOutputs.

SintaxisSetOutputCharacterSet( FileName, CharacterSet );


FileName Una ruta completa del archivo de texto parael que desea especificar un juego decaracteres. La ruta debe incluir unaextensión de archivo.

Este argumento debe ser idéntico alargumento FileName de la funciónTextOutput.

CharacterSet La codificación de caracteres que se utilizaráal escribir en el archivo de salida.

Para obtener más información sobre los valores válidos de CharacterSet, consulte:“SetInputCharacterSet” en la página 221.

SetOutputEscapeDoubleQuoteSetOutputEscapeDoubleQuote permite utilizar caracteres de escape con las comillasdobles que aparecen en los nombres de elemento o en los valores de datos a lahora de exportar una vista de cubo a un archivo .csv.


Cuando se incluye SetOutputEscapeDoubleQuote en el script TurboIntegrator y seestablece en 1, el archivo exportado conserva las posiciones de las comillas doblestal como aparecen en la vista de cubo de origen utilizando en cada una de lascomillas dobles otro par de comillas dobles como caracteres de escape. Porejemplo, si un elemento de la vista de origen se llama "Región", el elemento seexporta como """Región""" en el archivo de salida .csv.

Cuando SetOutputEscapeDoubleQuote no se incluye en el script TurboIntegrator ose establece en 0, el archivo exportado no utiliza caracteres de escape para lascomillas dobles que aparecen en el cubo de origen.

SetOutputEscapeDoubleQuote se utiliza junto con la función ASCIIOutput, que esla función que en realidad escribe en el archivo de salida.SetOutputEscapeDoubleQuote debe preceder a ASCIIOutput en el scriptTurboIntegrator, y ambas funciones deben utilizar el mismo valor de parámetroFileName.


SintaxisSetOutputEscapeDoubleQuote(FileName, Num);


FileName Una ruta completa al archivo en el quedesea escribir la vista del cubo. La ruta debeincluir una extensión de archivo.

Num Distintivo que determina si las comillasdobles aparecen con caracteres de escape enel archivo de salida.

1 indica que las comillas dobles aparecencon caracteres de escape en el archivo desalida.

0 indica que las comillas dobles no aparecencon caracteres de escape en el archivo desalida.

EjemploSetOutputEscapeDoubleQuote(’C:\temp\cube1.csv’, 1);

En este ejemplo, se utilizan caracteres de escape con todas las comillas dobles quese encuentren en la vista de cubo de origen a la hora de escribir la salida en elarchivo C:\temp\cube1.csv.

TextOutputTextOutput escribe un registro separado por comas en un archivo de texto.


De forma predeterminada, TextOutput escribe caracteres en el juego de caracteresdel entorno local del servidor. Para crear un archivo en un juego de caracteresdistinto, llame a la función SetOutputCharacterSet antes de invocar TextOutput.

El archivo de texto se abre cuando se escribe el primer registro, y se cierra cuandoel procedimiento de TurboIntegrator (Prólogo, Metadatos, Datos o Epílogo) quecontiene la función TextOutput termina de procesarse.

Si utiliza la función TextOutput para escribir en el mismo archivo en variosprocedimientos (pestañas) de un proceso TurboIntegrator, el archivo sesobrescribirá cada vez que se abra para un nuevo procedimiento.

Los registros de salida generados por TextOutput están limitados a 8000 bytes. Siun registro de salida supera los 8000 bytes, el registro se trunca y aparece un avisoen el archivo TM1ProcessError.log.

Cuando TextOutput encuentra un argumento String que exige que el registro desalida supere el límite de 8000 bytes, ignora ese argumento y los argumentosposteriores. Por ejemplo, si existen 10 argumentos String y la salida de losprimeros siete argumentos es de 7950 bytes en total, y la salida del octavoargumento es de 51 bytes, únicamente se escribirá en el registro la salida de los


primeros siete argumentos. Si existen diez argumentos String y el primerargumento supera los 8000 bytes, no se escribirá ninguna salida en el registro.

La función TextOutput genera un error leve si se produce un error al escribir elarchivo de texto. Además, la función devuelve un valor tras la ejecución: 1 si lafunción escribe correctamente el archivo de texto y 0 si se produce un error.

Únicamente se generará el error y se devolverá el valor si TextOutput estáescribiendo en un disco que no sea el disco en el que se está ejecutando el servidor.Por ejemplo, si el servidor se está ejecutando en la unidad C:, y TextOutput estáescribiendo en la unidad F: y esta última se queda sin espacio, se capturará el errory el servidor permanecerá activo. Si el servidor se está ejecutando en la unidad C:mientras que TextOutput también está escribiendo en dicha unidad y ésta se quedasin espacio, el servidor finalizará (como se esperaba).

SintaxisTextOutput(FileName, String1, String2, ...Stringn);


FileName Una ruta completa del archivo de texto en elque desea escribir el registro. La ruta debeincluir una extensión de archivo.

String1...Stringn Una cadena que corresponde a cada campoque desee crear en el archivo de texto. Esteargumento puede ser una cadena o unavariable de TurboIntegrator de una cadena.

EjemploTextOutput(’NewCube.cma’, V1, V2, V3, V4, V5 );

Este ejemplo escribe un registro en el archivo NewCube.cma. Cada campo delregistro corresponde a una variable asignada por TurboIntegrator a una columnade su origen de datos.

Funciones de TurboIntegrator de manipulación de atributosEstas funciones facilitan la manipulación de atributos.

ATTRNLATTRNL devuelve un atributo numérico para un elemento especificado de unadimensión.

Esta función es válida en los procesos de TM1 TurboIntegrator.

SintaxisATTRNL(DimName, ElName, AttrName, [LangLocaleCode]);





ElName Un elemento de la dimensión.

AttrName El atributo para el que desea recuperar unvalor. Este argumento debe ser un atributoválido del elemento.

LangLocaleCode Este parámetro opcional especifica el códigode entorno local de idioma para el que deseaque se devuelva un valor.

Los valores de LangLocaleCode válidoscorresponden a los códigos de idiomainternacionales listados en la dimensión decontrol de contextos culturales (}Cultures).

Cuando no se especifica o se omiteLangLocaleCode, el entorno local actual delusuario se utiliza como argumento deLangLocaleCode.

Si no existe ningún valor de atributo paraLangLocaleCode, se devuelve el valor de unLangLocaleCode padre asociado. Si no existeningún valor de atributo para unLangLocaleCode padre asociado, sedevuelve el valor de atributo base.

Por ejemplo, si LangLocaleCode es fr-CA, lafunción devuelve el valor de atributo delentorno local fr-CA si está disponible. Si elvalor de atributo de fr-CA no estádisponible, la función intenta devolver elvalor de atributo del entorno local fr padre.Si el valor de atributo de fr no estádisponible, se devuelve el valor de atributobase.

Ejemplo

ATTRNL(’Model’, ’L Series 1.8L Sedan’, ’Engine Size’, ’fr’);

En este ejemplo, la función devuelve el valor numérico del atributo Engine Size delelemento L Series 1.8L Sedan de la dimensión Model del entorno local francés.

ATTRSLATTRSL devuelve un atributo de cadena para un elemento especificado de unadimensión.



SintaxisATTRSL(DimName, ElName, AttrName, [LangLocaleCode]);



ElName Un elemento de la dimensión.

AttrName El atributo para el que desea recuperar unvalor. Este argumento debe ser un atributoválido del elemento.





Por ejemplo, si LangLocaleCode es fr-CA, lafunción devuelve el valor de atributo delentorno local fr-CA si está disponible. Si elvalor de atributo de fr-CA no estádisponible, la función intenta devolver elvalor de atributo del entorno local fr padre.Si el valor de atributo de fr no estádisponible, se devuelve el valor de atributobase.

Ejemplo

ATTRS(’Plan_Business_Unit’, ’10100’, ’Currency’, ’fr’);

En este ejemplo, la función devuelve el valor de cadena del atributo Currency delelemento 10100 de la dimensión Plan_Business_Unit del entorno local francés.

AttrDeleteAttrDelete suprime un atributo de elemento de la base de datos de TM1.



SintaxisAttrDelete(DimName, AttrName);


DimName La dimensión de la que desea eliminar unatributo de elemento.

AttrName El nombre del atributo que desea eliminar.

EjemploAttrDelete(’Model’, ’InteriorColor’);

Este ejemplo elimina el atributo de elemento Colorinterior de la dimensiónModelo.

AttrInsertAttrInsert crea un atributo de elemento para una dimensión. Esta función puedecrear un atributo de alias, numérico o de cadena.


SintaxisAttrInsert(DimName, PrevAttr, AttrName, Type);


DimName La dimensión para la que desea crear unatributo de elemento.

PrevAttr El atributo que precede al atributo que estácreando.

AttrName El nombre que desea asignar al nuevoatributo.

Tipo El tipo de atributo. Existen tres posiblesvalores para el argumento Type:

v N: crea un atributo numérico.

v S: crea un atributo de cadena.

v A: crea un atributo de alias.

EjemploAttrInsert(’Model’, ’Transmission’, ’InteriorColor’,’S’);

Este ejemplo crea el atributo de cadena Colorinterior de la dimensión Modelo. Esteatributo se inserta después del atributo Transmisión.


AttrPutNAttrPutN asigna un valor a un atributo de elemento numérico.


SintaxisAttrPutN( Value, DimName, ElName, AttrName, [LangLocaleCode] );


Value El valor numérico que desea asignar a unatributo de elemento.

DimName La dimensión padre del elemento al quedesea asignar un valor de atributo.

ElName El elemento al que desea asignar un valor deatributo.

AttrName El atributo cuyo valor desea asignar.

LangLocaleCode Este parámetro opcional especifica el códigode entorno local de idioma al que se aplicaNumericValue.

Los valores de LangLocaleCode válidoscorresponden a los códigos de idiomainternacionales ISO 639-1 listados en ladimensión control de contextos culturales(}Cultures).

Cuando no se especifica o se omiteLangLocaleCode, se actualiza el valor deatributo base.

EjemploAttrPutN(2257993, ’Model’, ’ S Series 1.8L Sedan ’,’ProdCode’);

Este ejemplo asigna el valor 2257993 al atributo Códprod de S Series 1.8L Sedan dela dimensión Modelo.

AttrPutSAttrPutS asigna un valor a un atributo de elemento de cadena.


SintaxisAttrPutS(Value, DimName, ElName, AttrName, [LangLocaleCode] );


Value El valor que desea asignar a un atributo deelemento.



DimName La dimensión padre del elemento al quedesea asignar un valor de atributo.

ElName El elemento al que desea asignar un valor deatributo.


LangLocaleCode Este parámetro opcional especifica el códigode entorno local de idioma al que se aplicael valor.



EjemploAttrPutS(’Beige’, ’Model’, ’S Series 1.8L Sedan’, ’InteriorColor’);

Este ejemplo asigna la cadena Beige al atributo Colorinterior de S Series 1.8L Sedande la dimensión Modelo.

CubeAttrDeleteCubeAttrDelete suprime un atributo de cubo de la base de datos TM1.


SintaxisCubeAttrDelete(AttrName);


AttrName El nombre del atributo de cubo que deseasuprimir.

EjemploCubeAttrDelete(’Description’);

Este ejemplo suprime el atributo de descripción para cubos en el servidor TM1.

CubeAttrInsertCubeAttrInsert crea un atributo nuevo para cubos en el servidor TM1. Esta funciónpuede crear un atributo de alias, numérico o de cadena.



SintaxisCubeAttrInsert( PrevAttrName, NewAttrName, AttrType);


PrevAttrName El atributo que precede al atributo que estácreando. Si no hay ningún atributo anterioro desea que el nuevo atributo sea el primeratributo para los cubos, deje este argumentovacío.

NewAttrName El nombre que desea asignar al nuevoatributo de cubo.

AttrType El tipo de atributo. Hay tres valores posiblespara el argumento AttrType:




EjemploCubeAttrInsert(’Owner’, ’Description’, ’S’);

Este ejemplo crea el atributo de cadena de descripción para cubos. Este atributo seinserta después del atributo de propietario.

CubeAttrPutNCubeAttrPutN asigna un valor a un atributo de cubo numérico.


SintaxisCubeAttrPutN(NumericValue, CubeName, AttrName, [LangLocaleCode] );


NumericValue El valor que desea asignar a un atributo decubo.

CubeName El cubo para el que desea asignar un valorde atributo.







EjemploCubeAttrPutN(07161994, ’Sales’, ’AccountingCode’,’fr’);

Este ejemplo asigna el valor 07161994 al atributo AccountingCode del cubo Ventaspara el código de entorno local del idioma francés.

CubeAttrPutSCubeAttrPutS asigna un valor a un atributo de cubo de cadena.


SintaxisCubeAttrPutS(String, CubeName, AttrName, [LangLocaleCode] );


String La cadena que desea asignar a un atributode cubo.

CubeName El cubo para el que desea asignar un valorde atributo.






EjemploCubeAttrPutS(’Prototype’, ’Sales’, ’Description’,’fr’);

Este ejemplo asigna el valor de cadena Prototype al atributo Description del cuboVentas para el código de entorno local del idioma francés.

CubeATTRNCubeATTRN devuelve un atributo numérico para un cubo especificado.


SintaxisCubeATTRN(CubeName, AttrName);




Ejemplo

CubeATTRN(’Product’, ’Accounting_Code’);

En este ejemplo, la función devuelve el valor numérico del atributoAccounting_Code del cubo Product.

CubeATTRNLCubeATTRNL devuelve un valor de atributo numérico para un cubo especificadorespecto a un entorno local dado.


SintaxisCubeATTRNL(CubeName, AttrName, [LangLocaleCode]);










Por ejemplo, si LangLocaleCode es fr-CA, lafunción devuelve el valor de atributo delentorno local fr-CA (francés de Canadá) siestá disponible. Si el valor de atributo defr-CA no está disponible, la función intentadevolver el valor de atributo del entornolocal fr (francés) padre. Si el valor deatributo de fr no está disponible, sedevuelve el valor de atributo base.

Ejemplo

CubeATTRNL(’Product’, ’Accounting_Code’, ’fr’);

En este ejemplo, la función devuelve el valor numérico del atributoAccounting_Code del cubo Product para el entorno local francés.

CubeATTRSCubeATTRS devuelve un atributo de cadena para un cubo especificado.


SintaxisCubeATTRS(CubeName, AttrName);






Ejemplo

CubeATTRS(’Product’, ’Owner’);

En este ejemplo, la función devuelve el valor de cadena del atributo Owner delcubo Product.

CubeATTRSLCubeATTRSL devuelve un valor de atributo numérico para un cubo especificadorespecto a un entorno local dado.


SintaxisCubeATTRSL(CubeName, AttrName, [LangLocaleCode]);











Ejemplo

CubeATTRSL(’Product’, ’Owner’, ’fr’);

En este ejemplo, la función devuelve el valor de cadena del atributo Owner delcubo Product para el entorno local francés.

DimensionAttrDeleteDimensionAttrDelete suprime un atributo de dimensión de la base de datos TM1.


SintaxisDimensionAttrDelete(AttrName);


AttrName El nombre del atributo de dimensión quedesea suprimir.


EjemploDimensionAttrDelete(’Description’);

Este ejemplo suprime el atributo de descripción para dimensiones en el servidorTM1.

DimensionAttrInsertDimensionAttrInsert crea un atributo nuevo para dimensiones en el servidor TM1.Esta función puede crear un atributo de alias, numérico o de cadena.


SintaxisDimensionAttrInsert( PrevAttrName, NewAttrName, AttrType);


PrevAttrName El atributo que precede al atributo que estácreando. Si no hay ningún atributo anterioro desea que el nuevo atributo sea el primeratributo para las dimensiones, deje esteargumento vacío.

NewAttrName El nombre que desea asignar al nuevoatributo de dimensión.

AttrType El tipo de atributo. Hay tres valores posiblespara el argumento AttrType:




EjemploDimensionAttrInsert(’’, ’Description’, ’S’);

Este ejemplo crea el atributo de cadena descripción para dimensiones. Dado queno hay ningún parámetro PrevAttrName, este atributo se inserta como el primeratributo para dimensiones en el servidor TM1.

DimensionAttrPutNDimensionAttrPutN asigna un valor a un atributo de dimensión numérica.


SintaxisDimensionAttrPutN(NumericValue, DimensionName, AttrName, [LocalLangCode] );


NumericValue El valor que desea asignar a un atributo dedimensión.



DimensionName La dimensión para la que desea asignar unvalor de atributo.





EjemploDimensionAttrPutN(07161994, ’Models’, ’AccountingCode’,’fr’);

Este ejemplo asigna el valor 07161994 a un atributo AccountingCode de ladimensión de modelos para el código de entorno local del idioma francés.

DimensionAttrPutSDimensionAttrPutS asigna un valor a un atributo de dimensión de cadena.


SintaxisDimensionAttrPutS(String, DimensionName, AttrName, [LangLocaleCode] );


String La cadena que desea asignar a un atributode dimensión.

DimensionName La dimensión para la que desea asignar unvalor de atributo.







EjemploDimensionAttrPutS(’Prototype’, ’Model’, ’Description’,’fr’);

Este ejemplo asigna el valor de cadena Prototype al atributo Description de ladimensión de modelo para el código de entorno local del idioma francés.

DimensionATTRNDimensionATTRN devuelve un atributo numérico para una dimensiónespecificada.


SintaxisDimensionATTRN(DimName, AttrName);




Ejemplo

DimensionATTRN(’Plan_Business_Unit’, ’Accounting_Code’);

En este ejemplo, la función devuelve el valor numérico del atributoAccounting_Code de la dimensión Plan_Business_Unit.

DimensionATTRNLDimensionATTRNL devuelve un valor de atributo numérico para una dimensiónespecificada respecto a un entorno local dado.



SintaxisDimensionATTRNL(DimName, AttrName, [LangLocaleCode]);









Ejemplo

DimensionATTRNL(’Plan_Business_Unit’, ’Accounting_Code’, ’fr’);

En este ejemplo, la función devuelve el valor numérico del atributoAccounting_Code de la dimensión Plan_Business_Unit para el entorno localfrancés.

DimensionATTRSDimensionATTRS devuelve un atributo de cadena para una dimensiónespecificada.



SintaxisDimensionATTRS(DimName, AttrName);




Ejemplo

DimensionATTRS(’Plan_Business_Unit’, ’Manager’);

En este ejemplo, la función devuelve el valor de cadena del atributo Manager de ladimensión Plan_Business_Unit.

DimensionATTRSLDimensionATTRSL devuelve un valor de atributo de cadena para una dimensiónespecificada respecto a un entorno local dado.


SintaxisDimensionATTRSL(DimName, AttrName, [LangLocaleCode]);











Ejemplo

DimensionATTRSL(’Plan_Business_Unit’, ’Manager’, ’fr’);

En este ejemplo, la función devuelve el valor de cadena del atributo Manager de ladimensión Plan_Business_Unit para el entorno local francés.

Funciones de TurboIntegrator de gestión de tareasEstas funciones pertenecen a la gestión de tareas.

ChoreQuitChoreQuit causa la terminación inmediata de la tarea. Puede llamarse desdecualquier proceso de una tarea.


Si un proceso encuentra la función ChoreQuit, la tarea actual finalizará con unestado de error y se escribirá un mensaje en el archivo de registro del servidorindicando que se llamó a ChoreQuit para finalizar la tarea.


SintaxisChoreQuit;

Argumentos

Ninguno.

SetChoreVerboseMessagesUtilice SetChoreVerboseMessages para activar (o desactivar) el envío de mensajescon informes más detallados al archivo Tm1s.log.


Esta función es especialmente útil en las tareas de depuración en las que variosprocesos se llaman entre sí mediante el uso de la función ExecuteProcess.

Pasar un valor cero desactiva la salida de estos mensajes; pasar un valor distintode cero permite la salida de mensajes más detallados. De forma predeterminada,este distintivo está desactivado.

Sintaxis

Utilice esta función para activar (o desactivar) el envío de mensajes con informesmás detallados al archivo Tm1s.log. Esta función es especialmente útil en las tareasde depuración en las que varios procesos se llaman entre sí mediante el uso de lafunción ExecuteProcess.

Pasar un valor cero desactiva la salida de estos mensajes; pasar un valor distintode cero permite la salida de mensajes más detallados. De forma predeterminada,este distintivo está desactivado.SetChoreVerboseMessages(Flag);


Flag Seleccione un valor que no sea cero paraactivar mensajes más detallados. Seleccionecero (valor predeterminado) para desactivarlos mensajes detallados.

Funciones de TurboIntegrator de manipulación de cubosEstas funciones pertenecen a la manipulación de cubos.

AddCubeDependencyAddCubeDependency permite predefinir dependencias entre cubos para evitarproblemas de bloqueo durante el uso normal del sistema.


Durante el funcionamiento normal, las dependencias entre cubos se establecencuando se recuperan los datos que traspasan los límites del cubo (tales como los


datos que proceden de una regla que hace referencia a un cubo externo). Para crearla información de dependencia, el servidor debe bloquear los cubos mientras seestablece la dependencia, manteniendo el bloqueo probablemente durante unproceso de cálculo de vistas de larga duración. Dado que es un bloqueo de'escritura', los demás usuarios no podrán acceder a los cubos. La funciónAddCubeDependency permite establecer la dependencia al iniciarse el servidor,evitando así que deban establecerse posteriormente nuevos bloqueos.

SintaxisAddCubeDependency(BaseCube, DependentCube);


BaseCube El nombre de un cubo que depende de otrocubo para los datos. Con mayor frecuencia,se tratará de un cubo que utiliza reglas paraextraer datos de un cubo externo.

DependentCube El nombre del cubo del que dependeBaseCube.

Ejemplo

AddCubeDependency(’A1’, ’A2’);

Supongamos que tenemos dos cubos, A1 y A2. El cubo A1 tiene esta regla para el 3de enero que extrae datos del cubo A2: [’Jan-03’]=DB(’A2’, elem_1, elem_2 ,...);

En este caso, A1 depende de A2. Para establecer la dependencia enTurboIntegrator, incluiría el ejemplo mostrado anteriormente.

CellGetNEsta función recupera un valor de una celda de cubos numérica.


SintaxisCellGetN(Cube, e1, e2 [,...en]);


Cube El nombre del cubo del que desea recuperarun valor.



e1,...en Los nombres de elementos de dimensionesque definen la intersección del cubo queincluye el valor que desea recuperar.

Los argumentos de e1 a en distinguensecuencias. e1 debe ser un elemento de laprimera dimensión del cubo, e2 debe ser unelemento de la segunda dimensión, etc.Estos argumentos pueden ser también losnombres de alias de elementos dedimensiones o variables de TurboIntegrator.Nota: Al utilizar esta función en unasentencia condicional (IF), la sentencia es laparte que contiene la condición, no todo elbloque condicional. Después de un errorleve, la ejecución continúa con la siguientesentencia. El procesamiento de TI no sabeque se encontraba en una sentenciacondicional una vez procesado el error leve,por lo que la siguiente sentencia es lasiguiente línea, no la línea posterior a endif.

Para evitar esta situación, utilice variables enlas operaciones que pudiesen producir unerror leve y, a continuación, utilice lasvariables en la sentencia condicional. Porejemplo:

V1 = CELLGETN(’PNLCube’, ’fred’,’argentina’,’Sales’,’Jan’);IF(V1 = 454);ASCIIOUTPUT(’bug.txt’, ’if logic not working properly’);ENDIF;

EjemploCellGetN (’y2ksales’, ’Actual’, ’Argentina’, ’S Series1.8L Sedan’, ’Sales’, ’Jan’);

Este ejemplo recupera el valor numérico de la intersección de los elementos Real,Argentina, S Series 1.8L Sedan, Ventas y Ene del cubo ventasa2000.

CellGetSEsta función recupera un valor de una celda de cubo de cadena.


SintaxisCellGetS(Cube, e1, e2 [,...en]);


Cubo El nombre del cubo del que desea recuperarun valor.



e1,...en Los nombres de elementos de dimensionesque definen la intersección del cubo queincluye el valor que desea recuperar.

Los argumentos de e1 a en distinguensecuencias. e1 debe ser un elemento de laprimera dimensión del cubo, e2 debe ser unelemento de la segunda dimensión, etc.Estos argumentos pueden ser también losnombres de alias de elementos dedimensiones o variables de TurboIntegrator.

Consulte la nota en “CellGetN” en la página245relativa a la lógica de IF con esta función.

EjemploCellGetS(’Personnel’, ’Rep’, ’Europe’, ’Product’);

Este ejemplo recupera el valor de cadena de la intersección de los elementos Rep,Europa y Producto del cubo Personal.

CellIncrementNEsta función incrementa el valor de celda numérico actual por el valorespecificado.


SintaxisCellIncrementN(x, Cube, e1, e2 [,...en]);


x Valor numérico que desea añadir a un valorde celda actual.

Cubo El nombre del cubo al que desea enviar elvalor.

e1,...en Los nombres de elementos de dimensionesque definen la intersección del cubo querecibirá el valor.



EjemploCellIncrementN(1000, ’y2ksales’, ’Actual’, ’Argentina’, ’S Series 1.8L Sedan’, ’Sales’, ’Jan’);

Este ejemplo incrementa por 1000 el valor de la intersección de los elementos Real,Argentina, S Series 1.8L Sedan, Ventas y Ene del cubo ventasa2000.

CellIsUpdateableEsta función le permite determinar si se puede escribir en una celda de cubo. Lafunción devuelve 1 si se puede escribir en la celda; de lo contrario, devuelve 0.


SintaxisCellIsUpdateable(Cube, e1, e2 [,...en]);


Cubo El nombre del cubo en el que desea escribirun valor.

e1,...en Los nombres de elementos de dimensionesque definen la celda en la que desea escribirun valor.


EjemploCellIsUpdateable (’y2ksales’, ’Actual’, ’Argentina’,’S Series 1.8L Sedan’, ’Sales’, ’Jan’);

Este ejemplo determina si se puede escribir en la celda definida por los elementosReal, Argentina, S Series 1.8L Sedan, Ventas y Ene del cubo ventasa2000. Si la celdapuede recibir un valor, la función devuelve 1; de lo contrario, devuelve 0.

CellPutNEsta función envía un valor numérico a una celda de cubo.


SintaxisCellPutN(x, Cube, e1, e2 [,...en]);


x Un valor numérico.



Cubo El nombre del cubo al que desea enviar elvalor.

e1,...en Los nombres de elementos de dimensionesque definen la intersección del cubo querecibirá el valor.


EjemploCellPutN(12345, ’y2ksales’, ’Actual’, ’Argentina’, ’S Series 1.8L Sedan’, ’Sales’, ’Jan’);

Este ejemplo envía el valor 12345 a la intersección de los elementos Real,Argentina, S Series 1.8L Sedan, Ventas y Ene del cubo ventasa2000.

CellPutProportionalSpreadEsta función distribuye un valor especificado a las hojas de una consolidación quees proporcional a los valores de celda existentes.


CellPutProportionalSpread sustituye valores de celda existentes; no puedeutilizarse para añadirse o restarse de los valores de celda existentes.

Esta función es análoga al método de dispersión de datos Dispersión proporcional,que se describe detalladamente en la guía del usuario de IBM Cognos TM1 . Sidebe añadirse o restarse de valores de celda existentes, utilice el métodoProportional Spread, que puede ejecutarse a través de la interfaz de usuario o através de la sintaxis de dispersión de datos.

Nota: Al utilizar CellPutProportionalSpread para distribuir un valor a las hojas deuna consolidación, únicamente se modifican aquellas hojas que ya contienenvalores que no son cero. Esto sucede porque los valores cero no puedenaumentarse ni disminuirse de forma proporcional; cualquier proporción de cerosigue siendo cero.

SintaxisCellPutProportionalSpread( value, cube, e1, e2, e3...,en );


value El valor que desea distribuir.



cube El nombre del cubo en el que deseadistribuir el valor.

e1...en Los nombres de los elementos queidentifican la consolidación cuyas hojasaceptarán el valor distribuido.


EjemploCellPutProportionalSpread(7000,’SalesCube’, ’Actual’,’North America’,’S Series 1.8L Sedan’, ’Sales’, ’Jan’)

Este ejemplo distribuye el valor 7000 a los hijos de la consolidación de SalesCubeidentificada por los elementos Actual, North America, S Series 1.8L Sedan, Sales yJan.

CellPutSEsta función envía un valor de cadena a una celda de cubo.


SintaxisCellPutS(String, Cube, e1, e2 [,...en]);


Cadena Una cadena.

Cubo El nombre del cubo al que desea enviar lacadena.

e1,...en Los nombres de elementos de dimensionesque definen la intersección del cubo querecibirá la cadena.



EjemploCellPutS(’jones’, ’Personnel’, ’Rep’, ’Europe’, ’Product’);

Este ejemplo envía la cadena "jones" a la intersección de los elementos Rep, Europay Producto del cubo personal.

CubeClearDataEsta función borra todos los datos de un cubo.


Esta función es mucho más rápida que realizar una operación como crear una vistapara cubrir el cubo entero y, a continuación, un ViewZeroOut() para ponerlo acero.

Cuando utilice CubeClearData para borrar los datos de un cubo, se borrarántambién todas las celdas alimentadas con los feeders. Deberá volver a guardar laregla que establece los alimentadores o utilizar la función CubeProcessFeeders pararestaurar las celdas feed.

Nota: Esta acción simplemente borra los datos del cubo, no borra y vuelve a crearel cubo en sí. Esto tiene consecuencias al utilizar recinto de pruebas. Si se borra yse vuelve a crear un cubo, se descartarán todos los recintos de pruebas que puedatener un usuario, puesto que se ha borrado el cubo contra el que se crearon(aunque se pueda haber vuelto a crear un cubo con el mismo nombre). Si por elcontrario se utiliza la acción CubeClearData(), los datos del recinto de pruebas seconsiderarán válidos, puesto que el cubo contra el que se creó el recinto depruebas aún existe.

SintaxisCubeClearData( name-of-cube-as-string );

Argumento

El nombre del cubo que se desea borrar, como una cadena.

EjemploCubeClearData( ’expense’ );

CubeCreateEsta función crea un cubo a partir de unas dimensiones concretas. El orden de lasdimensiones especificadas en la función será el orden de las dimensiones en ladefinición del cubo.


Tras ejecutarse, CubeCreate guarda automáticamente el archivo .cub resultante enel disco.


SintaxisCubeCreate(Cube, d1, d2 [,...dn]);


Cube El nombre que desea asignar al cubo.

d1,...dn Los nombres de las dimensiones que formanel cubo. Debe especificar al menos dosdimensiones, pero no más de 256.

EjemploCubeCreate(’y2ksales’, ’Actvsbud’, ’Region’, ’Model’,’Account1’, ’Month’);

Este ejemplo crea un cubo denominado ventasa2000 utilizando las dimensionesActvsbud, Región, Modelo, Cuenta1 y Mes.

CubeDestroyEsta función elimina un cubo TM1 especificado.


SintaxisCubeDestroy(Cube);


Cube El nombre del cubo que desea eliminar.

EjemploCubeDestroy(’y2ksales’);

Este ejemplo elimina el cubo denominado ventasa2000.

CubeExistsUtilice CubeExists para determinar si un cubo específico existe en el servidor desdeel que se ejecuta un proceso TurboIntegrator.


La función devuelve 1 si el cubo existe en el servidor; de lo contrario, devuelve 0.


SintaxisCubeExists(CubeName);


CubeName El nombre del cubo cuya existencia deseaconfirmar.

EjemploCubeExists(’Inventory’);

Este ejemplo determina si el cubo Inventario existe en el servidor.

CubeGetLogChangesEsta función devuelve el valor booleano de la propiedad Logging de un cuboespecificado.


La propiedad Logging se configura en el cuadro de diálogo Asignaciones deseguridad TM1 y se almacena en el cubo de control }CubeProperties. Si se activaLogging para un cubo, la función devuelve 1. Si Logging está desactivado, lafunción devuelve 0.

SintaxisCubeGetLogChanges(CubeName);


CubeName El cubo al que desea devolver el valor de lapropiedad Logging.

EjemploCubeGetLogChanges(’2002sales’);

Si el registro se encuentra activado para el cubo ventas2002, la función devuelve 1.

CubeSaveDataCubeSaveData() serializa un cubo.

Sintaxis


Para mejorar el rendimiento, se puede inhabilitar el registro de transaccionesdurante la carga de datos. Para proteger los datos cargados recientemente en elcaso improbable de que se produzca un bloqueo del servidor, se pueden serializarlos cambios en disco. SaveDataAll se ha utilizado para serializar datos en disco ypara truncar el registro de transacciones. Cuando se procesa un comando


SaveDataAll, el servidor adquiere un bloqueo de lectura en cada cubo y unbloqueo IX en cada cubo modificado. Esto puede generar una contenciónimportante de la actividad de usuario, si se ejecuta SaveDataAll durante periodosde actividad del usuario.

Generalmente, no es necesario que se serialicen todos los cubos afectados porSaveDataAll ya que normalmente se cargan con datos nuevos. CubeSaveData seutiliza para serializar un cubo individual en disco. CubeSaveData serializa losdatos del cubo que se han confirmado en la memoria, incluidas las modificacionesrealizadas en el mismo durante el proceso TurboIntegrator actual que todavía no sehan confirmado.CubeSaveData(Cube);


Cubo El nombre del cubo que desea serializar.

EjemploCubeSaveData (’SalesCube’);

Tenga en cuenta el siguiente código de proceso de TurboIntegrator:CellPutN(500, ’y2ksales’, ’Actual’, ’Argentina’, ’S Series 1.8 L Wagon’, ’Sales’, ’Jan’);

CubeSaveData(’y2ksales’);

CellPutN(1000, ’y2ksales’, ’Actual’, ’Argentina’, ’S Series 1.8 L Wagon’, ’Sales’, ’Jan’);

Cuando se procesa el comando CubeSaveData, el valor de 500 para la celda deventas de enero se incluirá en la serialización del cubo en disco, aunque todavía nose haya confirmado. La actualización de la celda de ventas de Enero a 1000 noformará parte de la serialización.

Registro de transacciones

Cuando se ejecuta CubeSaveData aparece una entrada nueva en el registro detransacciones. Cuando se procesa un archivo de registro de transacciones durantela recuperación, todas las actualizaciones de un cubo que se hayan aplicado hastael momento se descartarán cuando se encuentre una directiva CubeSaveData parael cubo, puesto que todas las actualizaciones ya se habrán serializado en el cubo.

Recuperación de bloqueos del servidor

El comando SaveDataAll se beneficia del hecho que durante su procesamientotodos los cubos estén bloqueados y trunca el registro de transacciones sabiendoque todas las actualizaciones realizadas antes de la serialización se han guardadocorrectamente en el disco. Este no es el caso de CubeSaveData, por lo tanto, debemodificar el modo en que se realiza la recuperación de datos cuando se haserializado un cubo.

El archivo de registro de transacciones puede contener registros que representancambios más antiguos que los datos más recientes del cubo y no se debe aplicarcuando se están recuperando los datos.


CubeSetConnParamsEsta función se utiliza para cifrar la contraseña de un cubo virtual en el cubo}CubeProperties.


SintaxisCubeSetConnParams(cubeName, providerName, dataSourceLocation,dataSourceName,dataSourceCatalog, userID, password, sapClientID, sapClientLang, providerString);


cubeName El nombre del cubo para el que deseaestablecer la contraseña.

providerName

dataSourceLocation Nombre que asigna su administrador a unconjunto de catálogos de una ubicacióndeterminada. En Microsoft Analysis Services,éste es el nombre de un servidor registrado.

dataSourceName

dataSource catalog Es el nombre asignado por su administradora una colección determinada de bases dedatos (cubos, dimensiones y otros objetos).Para MAS, este es el nombre de la base dedatos.

UserID Un nombre de usuario válido para la basede datos.

Password La contraseña que se utilizará en este origende datos.

sapClientID ID de cliente SAP

sapClientLang Configuración de idioma de SAP.

providerString

EjemploCubeSetConnParams(sc, TM1OLAP, tm1server, , sdata, admin, apple, , , );

CubeSetLogChangesEsta función establece la propiedad LOGGING para un cubo.



SintaxisCubeSetLogChanges(Cube, LogChanges);


Cube El nombre del cubo para el que deseaestablecer la propiedad LOGGING.

LogChanges El valor booleano que desea asignar a lapropiedad. 1= LOGGING activado, 0 =LOGGING desactivado.

CubeUnloadEsta función descarga un cubo especificado de la memoria junto con toda las vistasde cubo asociadas.


SintaxisCubeUnload(CubeName);


CubeName El cubo que desea descargar de la memoria.

EjemploCubeUnload(’ManufacturingBudget’);

Este ejemplo descarga el cubo Presupuestofabricación y las vistas asociadas de lamemoria del servidor.

Funciones de TurboIntegrator de reserva de datosUtilice las funciones de TurboIntegrator siguientes para obtener, liberar yadministrar mediante programación las reservas de datos.

Para obtener más información sobre la utilización de la característica de reserva dedatos, consulte el tema correspondiente en la guía del desarrollador de IBMCognos TM1 .

CubeDataReservationAcquireCubeDataReservationAcquire Adquiere una reserva de datos para el cubo, usuarioy tupla especificados.

Se trata de una función de TurboIntegrator, válida únicamente en los procesos deTurboIntegrator.


Sintaxis

CubeDataReservationAcquire(Cube, User, bForce, Address, [AddressDelimiter])


Cube Nombre del cubo.

User Nombre del propietario de la reserva nueva.

El nombre de usuario proporcionado se validará para garantizarque se trata de un usuario existente.

bForce Valor booleano que determina el comportamiento si la reservasolicitada entra en conflicto con una reserva existente.

Si se establece en 0 (falso), la solicitud se rechaza si entra enconflicto con una reserva existente.

Si se establece en 1 (verdadero) y el usuario que está ejecutando elproceso de TurboIntegrator tiene la funciónDataReservationOverride, las reservas conflictivas se liberan y seotorga la solicitada.

Address Secuencia de cadenas con señales de nombres de elementos quedefinen la tupla. El orden debe coincidir con el orden original delas dimensiones del cubo.

Todas las celdas del cubo contenidas en la tupla forman la regiónque se reserva. Puede elegir un elemento de cada dimensión outilizar una cadena vacía entre los delimitadores para seleccionaruna dimensión completa. En función del lugar que el elementoocupe en la jerarquía, la solicitud reserva una sola celda, unasección o el cubo entero.

AddressDelimiter Cadena de caracteres opcional que se utiliza para separar losnombres de los elementos en el parámetro Address.

El valor predeterminado es '|'.

Valor de retorno

Booleano: Devuelve verdadero si la adquisición se realiza correctamente.

EjemploCubeDataReservationAcquire(’DRTestCube’,’User1’,0,’ElemX|ElemY|ElemZ’);

En el ejemplo siguiente se establece el parámetro bForce en 1 para forzar lasolicitud de DR si existe algún conflicto y se utiliza un carácter delimitador distintopara el parámetro AddressDelimiter.CubeDataReservationAcquire(’DRTestCube’,’User2’,1,’ElemX*ElemY*ElemZ’,’*’);

CubeDataReservationReleaseCubeDataReservationRelease libera la reserva de datos especificada.



Si el usuario especificado no coincide con el propietario de la reserva, la liberaciónsolamente se realizará si el usuario especificado tiene la funciónDataReservationOverride habilitada.

SintaxisCubeDataReservationRelease(Cube, User, Address,[AddressDelimiter])



User Nombre del propietario de la reserva.

El nombre de usuario proporcionado se validará para garantizarque se trata de un usuario existente.




Valor de retorno

Booleano: Devuelve verdadero si la liberación se realiza correctamente.

EjemploCubeDataReservationRelease(’DRTestCube’,’User1’,’ElemX|ElemY|ElemZ’);

En el ejemplo siguiente se utiliza un carácter distinto para el parámetroAddressDelimiter.CubeDataReservationRelease(’DRTestCube’,’User2’,’ElemX*ElemY*ElemZ’,’*’);

CubeDataReservationReleaseAllCubeDataReservationReleaseAll libera varias reservas de datos existentes.


Se liberarán todas las reservas contenidas totalmente en la dirección especificadaque se correspondan con el filtro de usuarios. Si el filtro de usuarios está enblanco, significa todos los usuarios.

Si el usuario especificado en el filtro no coincide con el usuario que está ejecutandoel proceso de TurboIntegrator, debe tener habilitada la funciónDataReservationOverride.


Si se utiliza un filtro de usuarios en blanco y sólo comodines en el campo dedirección, se liberan todas las reservas.

SintaxisCubeDataReservationReleaseAll(Cube, UserFilter, Address, [AddressDelimiter])



UserFilter Filtro de nombres de usuario que se utilizará en la comparacióncon las reservas existentes.




Valor de retorno

Booleano: Devuelve verdadero si no hay errores.

EjemploCubeDataReservationReleaseAll(’DRTestCube’,’User1’,’ElemX|ElemY|ElemZ’);

En el ejemplo siguiente se liberan todas las reservas en el cubo especificado paratodos los usuarios.CubeDataReservationReleaseAll(’DRTestCube’,’’,’||’);

CubeDataReservationGetCubeDataReservationGet busca las reservas existentes en un cubo específico paraun usuario o para todos.


Sintaxis

CubeDataReservationGet(Index, Cube, User, [AddressDelimiter]) returnsAddress;


Index Índice de bucle basado en uno que se utilizará para la iteración porlas reservas en el cubo especificado.

Cube Nombre del cubo en el que se buscará.



User Nombre del propietario de la reserva que se utilizará como filtro.

Si se deja en blanco, la función devuelve las reservas de todos lospropietarios.

Si se proporciona un nombre, la función filtra los resultados para elpropietario especificado únicamente.

AddressDelimiter Cadena de caracteres opcional que se utiliza para separar losnombres de los elementos en el parámetro Address devuelto.


Valor de retorno

Address: Hora de creación de la reserva, nombre del propietario de la reserva yelemento de dirección de la reserva. En primer lugar aparece la hora de creación,seguida del delimitador, el ID de usuario, el delimitador y los ID de elementosseparados por el delimitador según el orden de las dimensiones del cubo (ordenoriginal).

Se devuelve una cadena vacía si no hay ninguna entrada para el índiceespecificado.

El formato del valor de retorno es:

[creation time][delimiter][ownername][delimiter][element1][delimiter][element2][delimiter]...[elementN]

Por ejemplo:

"20100622211601|Fred Bloggs|Elemento1|Elemento2|Elemento3"

Nota: Las reservas pueden cambiar mientras se realiza una iteración por la lista dereservas, por lo que el uso del índice no garantiza que se obtenga una listacompleta de las reservas. Se pueden añadir o eliminar reservas en cualquierposición de la lista, por lo que se pueden omitir o repetir reservas al pasar por losvalores del índice.

Si se especifica el filtro de propietarios, el índice se aplica solamente a losmiembros de la lista filtrada. Si la lista de reservas tiene los propietarios User1,User1 y User2 y en la solicitud se especifica User2 como propietario, un índice de 1recuperará el tercer miembro de la lista.

EjemploCubeDataReservationGet(1,’DRTestCube’,’User1’,’*’);

CubeDataReservationGet(1,’DRTestCube’,’’);

El ejemplo siguiente localizaría todas las reservas propiedad del usuario FredBloggs en el cubo Expense Input y realizaría alguna operación de utilidad conellas:


vIndex = 1;vCube = ’Expense Input’;vUserFilter = ’Fred Bloggs’;vDelim = ’|’;vAddress = CubeDataReservationGet( vIndex, vCube, vUserFilter,vDelim);WHILE (vAddress @<> ’’);

vSep1 = SCAN( vDelim, vAddress);vDRUser = SUBST( vAddress, 1, vSep1 - 1);vDRAddress = SUBST( vAddress, vSep1 + 1, LONG(vDRAddress) - vSep1);

# do something meaningful with theuser and reservation address here

vIndex = vIndex + 1;vAddress = CubeDataReservationGet( vIndex, vCube, vUserFilter,vDelim);

END;

CubeDataReservationGetConflictsCubeDataReservationGetConflicts busca las reservas existentes en un cuboespecífico que entrarían en conflicto con el usuario, la dirección y la tupla que sehan especificado.


SintaxisCubeDataReservationGetConflicts(Index, Cube, User,Address, [AddressDelimiter])returns ConflictAddress;


Index Índice de bucle basado en uno que se utilizará para la iteraciónpor los conflictos que se corresponden con esta consulta.

Cube Nombre del cubo en el que se buscará.

User La consulta buscará las reservas que entrarían en conflicto coneste usuario.




Valor de retorno

ConflictAddress: Hora de creación de la reserva, nombre del propietario de lareserva y elemento de dirección de la reserva. En primer lugar aparece la hora decreación, seguida del delimitador, el ID de usuario, el delimitador y los ID deelementos separados por el delimitador según el orden de las dimensiones delcubo (orden original).

Se devuelve una cadena vacía si no hay ninguna entrada para el índiceespecificado.


El formato del valor de retorno es:[creation time][delimiter][owner name][delimiter][element1][delimiter]

[element2][delimiter]...[elementN]

Por ejemplo:

"20100622211601|Fred Bloggs|Elemento1|Elemento2|Elemento3"

Nota: Las reservas pueden cambiar mientras se realiza una iteración por la lista dereservas conflictivas, por lo que el uso del índice no garantiza que se obtenga unalista completa de las reservas. Se pueden añadir o eliminar reservas en cualquierposición de la lista, por lo que se pueden omitir o repetir reservas al pasar por losvalores del índice.

Funciones de TurboIntegrator de fecha y horaEstas funciones dan formato y analizan fechas y horas en una amplia gama deformatos y configuraciones regionales.

FormatDateLa función FormatDate da formato a una cadena de fecha según un formateadordefinido con la función NewDateFormatter.


Sintaxis

FormatDate(Date, <Pattern>, <Index>)

Argumentos


Fecha Un valor de fecha.

El tipo de valor, de serie o UNIX, debe corresponderse con elformateador utilizado.

Patrón Patrón utilizado para dar formato a las fechas.

Visite http://userguide.icu-project.org/formatparse/datetime paraobtener una lista completa de sintaxis de formatos.

Si se pasa una cadena vacía, el formato se determina por laconfiguración regional en función de los parámetros FormatterStyle yFormatterType que se han utilizado con la función NewDateFormatter.

Index El índice devuelto por una llamada a la función NewDateFormatter.

El valor predeterminado es 0.

Si no existe ningún formateador en el índice, se utilizará unformateador predeterminado como si se hubiera creado con lasiguiente llamada:

NewDateFormatter(’’, ’Etc/UTC’, ’serial’, ’medium’, ’date’)


Ejemplo

sDate = FormatDate(18000);

NewDateFormatterLa función NewDateFormatter define un formateador de fecha. Devuelve un índicepara utilizar con las funciones ParseDate y FormatDate. El índice empieza en 0 yaumenta en uno con cada llamada a NewDateFormat. Los formateadores de fechason válidos durante la ejecución del proceso.


Sintaxis

NewDateFormatter(Locale, <TimeZone>, <UseUNIXTime>, <FormatterStyle>,<FormatterType>, <TimeType>)

Argumentos


Entorno local Configuración regional para análisis o formato de fechas.

Si se pasa una cadena vacía, se utiliza la configuración regional. Lasconfiguraciones regionales se especifican con el formato de lenguaje[_territory][.variant]. Por ejemplo, cs_CK representa el idioma checo y laRepública checa.

Huso horario Huso horario para análisis o formato de fechas.

Consulte http://en.wikipedia.org/wiki/List_of_tz_database_time_zonespara obtener una lista completa de husos horarios.

Si no se especifica, la zona horaria utilizada es UTC (’Etc/UTC’).

UseUNIXTime Si se especifica ’unix’, las horas se tratan como milisegundos desde el 1de enero de 1970. De lo contrario, se tratan con el formato de serie deTM1.

Tenga en cuenta que solo se pueden procesar las fechas posteriores al 1de enero de 1970 aunque se utilice el formato de serie de TM1.

FormatterStyle Controla el formato de fecha que se utiliza cuando se especifica unpatrón vacío en las funciones FormatDate o ParseDate.

Los valores válidos son ’full’, ’long’, ’medium’ o ’short’.

El valor predeterminado es ’medium’.

FormatterType Controla el tipo de formato que se utiliza cuando se especifica unpatrón vacío en las funciones FormatDate o ParseDate.

Los valores válidos son ’time’, ’date’ o ’datetime’.

El valor predeterminado es ’date’.

Ejemplo

dfUNIX = NewDateFormatter(’’, ’Etc/UTC’, ’unix’);


dfStyleFullDateTime = NewDateFormatter(’en_us’, ’America/Toronto’,’serial’, ’full’, ’datetime’);

ParseDateLa función ParseDate analiza una cadena de fecha según un formateador definidocon la función NewDateFormatter.

Se devuelve un valor de fecha, de serie o UNIX, en función del formateadorespecificado. Si la fecha no se puede analizar, se devuelve un valor sin definir. Estevalor se puede probar con la función ISUND.


Sintaxis

ParseDate (DateString, <Pattern>, <Index>)

Argumentos


DateString Una cadena de fecha.

Patrón Patrón utilizado para analizar fechas.

Visite http://userguide.icu-project.org/formatparse/datetime paraobtener una lista completa de sintaxis de formatos.

Si se pasa una cadena vacía, el formato se determina por laconfiguración regional en función de los parámetros FormatterStyle yFormatterType que se han utilizado con la funciónNewDateFormatter.

Index El índice devuelto por una llamada a la función NewDateFormatter.El valor predeterminado es 0. Si no existe ningún formateador en elíndice, se utilizará un formateador predeterminado como si sehubiera creado con la siguiente llamada:

NewDateFormatter(’’, ’Etc/UTC’, ’serial’, ’medium’, ’date’)

Ejemplo

nDate = ParseDate(’2011/11/24’, ’yyyy/MM/dd’);

Funciones de TurboIntegrator de manipulación de dimensionesEstas funciones facilitan la manipulación de dimensiones.

DimensionCreateDimensionCreate crea una nueva dimensión.



SintaxisDimensionCreate(DimName);


DimName El nombre que desea asignar a la dimensión.

EjemploDimensionCreate(’Product’);

Este ejemplo crea la dimensión Producto.

DimensionDeleteAllElementsEsta función elimina todos los elementos de una dimensión.


Nota: Al borrar un elemento se borran todos los datos del cubo identificados pordicho elemento. Sin embargo, si utiliza DimensionDeleteAllElements para eliminarelementos y vuelve a crear dichos elementos con los mismos nombres en lapestaña Metadatos, tras volver a crear la dimensión se conservarán todos lospuntos de datos de un cubo identificado por los elementos.

Esta función resulta útil para volver a crear jerarquías de dimensión.

SintaxisDimensionDeleteAllElements(DimName);


DimName El nombre de la dimensión de la que deseaeliminar todos los elementos.

EjemploDimensionDeleteAllElements(’Model’);

Este ejemplo elimina todos los elementos de la dimensión Modelo.

DimensionDestroyEsta función elimina una dimensión de la base de datos TM1 .



SintaxisDimensionDestroy(DimName);


DimName El nombre de la dimensión que deseaeliminar.

EjemploDimensionDestroy(’Product’);

Este ejemplo elimina la dimensión Producto de la base de datos TM1 .

DimensionElementComponentAddAñade un componente (hijo) a un elemento consolidado. Tenga en cuenta que nopodrá utilizar esta función en el procedimiento de Epílogo de un procesoTurboIntegrator.


SintaxisDimensionElementComponentAdd(DimName, ConsolidatedElName,ElName, ElWeight);


DimName La dimensión padre del elementoconsolidado al que desea añadir un hijo.

ConsolidatedElName El elemento al que desea añadir un hijo.

ElName El nombre del elemento hijo.

ElWeight El peso del elemento hijo.

Ejemplo

DimensionElementComponentAdd(’Measures’, ’Net Sales’, ’Expenses’, -1);

Este ejemplo añade el hijo Gastos a la consolidación Ventas netas de la dimensiónMedidas. El hijo tiene un peso de -1 en la consolidación.

DimensionElementComponentAddDirectDimensionElementComponentAddDirect añade un componente (hijo) a unelemento consolidado editando directamente una dimensión.


El método predeterminado de editar una dimensión en Cognos TM1 es utilizar unpatrón de edición de copia completa. En dicho patrón, se crea una copia de edición


de la dimensión, las ediciones se aplican a la copia de edición, y finalmente vuelvea escribirse la dimensión real utilizando la copia de edición como plantilla.TurboIntegrator admite la edición automática de la copia completa siempre que seutilicen funciones de TurboIntegrator para la edición de dimensiones (comoDimensionElementComponentAdd) en el procedimiento de metadatos del proceso.TurboIntegrator crea automáticamente la copia de edición y le aplica lasoperaciones de edición; a continuación vuelve a escribir la dimensión real al finaldel procedimiento de metadatos.

Las ediciones directas son diferentes en tanto que no hay copia de edición. En sulugar, las operaciones se llevan a cabo directamente en la dimensión real. Existendos casos de uso especializado y diferente para los que está indicado este tipo deedición directa:v Cuando el propósito del proceso TurboIntegrator es realizar un pequeño cambio

en una dimensión grande. En este caso, la edición directa será más eficaz porqueevita la copia y la reescritura completa de la dimensión grande.

v Cuando el propósito del proceso TurboIntegrator es cargar grandes volúmenesde datos en un cubo. En este caso, el procedimiento de Metadatos del proceso semantiene deliberadamente vacío, y la modificación de cualquier elementonecesario para dar soporte a la carga de datos se realiza utilizando llamadasdirectas en el procedimiento de Datos. Cuando el procedimiento de Metadatosestá vacío, el proceso se salta una repetición completa sobre el origen de datosexterno, gracias a lo cual las cargas de datos pueden ser más rápidas.

SintaxisDimensionElementComponentAddDirect(DimName, ConsolidatedElName,ElName, ElWeight);


DimName La dimensión padre del elementoconsolidado al que desea añadir un hijo.

ConsolidatedElName El elemento consolidado al que desea añadirun hijo.

ElName El nombre del elemento hijo.

ElWeight El peso del elemento hijo.

Ejemplo

DimensionElementComponentAddDirect(’Measures’, ’Net Sales’, ’Expenses’,-1);

Este ejemplo añade el hijo Gastos a la consolidación Ventas netas de la dimensiónMedidas. El hijo tiene un peso de -1 en la consolidación.

DimensionElementComponentDeleteEsta función elimina un componente (hijo) de un elemento consolidado.



SintaxisDimensionElementComponentDelete(DimName, ConsolidatedElName,ElName);


DimName La dimensión padre del elementoconsolidado del que desea eliminar un hijo.

ConsolidatedElName El elemento consolidado del que deseaeliminar un hijo.

ElName El nombre del elemento hijo que deseaeliminar.

EjemploDimensionElementComponentDelete(’Region’, ’Benelux’,’Belgium’);

Este ejemplo elimina el hijo Bélgica de la consolidación Benelux de la dimensiónRegión.

DimensionElementComponentDeleteDirectEsta función suprime un componente (hijo) de un elemento consolidado editandodirectamente la dimensión.


El método predeterminado de editar una dimensión en Cognos TM1 es utilizar unpatrón de edición de copia completa. En dicho patrón, se crea una copia de ediciónde la dimensión, las ediciones se aplican a la copia de edición, y finalmente vuelvea escribirse la dimensión real utilizando la copia de edición como plantilla.TurboIntegrator admite la edición automática de la copia completa siempre que seutilicen funciones de TurboIntegrator para la edición de dimensiones (comoDimensionElementComponentDelete) en el procedimiento de metadatos delproceso. TurboIntegrator crea automáticamente la copia de edición y le aplica lasoperaciones de edición; a continuación vuelve a escribir la dimensión real al finaldel procedimiento de metadatos.





SintaxisDimensionElementComponentDeleteDirect(DimName, ConsolidatedElName,ElName);


DimName La dimensión padre del elementoconsolidado del que desea eliminar un hijo.

ConsolidatedElName El elemento consolidado del que deseaeliminar un hijo.

ElName El nombre del elemento hijo que deseaeliminar.

EjemploDimensionElementComponentDeleteDirect(’Region’, ’Benelux’,’Belgium’);

Este ejemplo elimina el hijo Bélgica de la consolidación Benelux de la dimensiónRegión.

DimensionElementDeleteEsta función elimina un elemento de una dimensión.


Nota: Al borrar un elemento se borran todos los datos del cubo identificados pordicho elemento.

SintaxisDimensionElementDelete(DimName, ElName);


DimName La dimensión que incluye el elemento quedesea eliminar.

ElName El elemento que desea eliminar.

EjemploDimensionElementDelete(’Region’, ’Belgium’);

Este ejemplo elimina el elemento Bélgica de la dimensión Región.

DimensionElementDeleteDirectEsta función suprime un elemento de una dimensión editando directamente ladimensión.



Nota: Al borrar un elemento se borran todos los datos del cubo identificados pordicho elemento.

El método predeterminado de editar una dimensión en Cognos TM1 es utilizar unpatrón de edición de copia completa. En dicho patrón, se crea una copia de ediciónde la dimensión, las ediciones se aplican a la copia de edición, y finalmente vuelvea escribirse la dimensión real utilizando la copia de edición como plantilla.TurboIntegrator admite la edición automática de la copia completa siempre que seutilicen funciones de TurboIntegrator para la edición de dimensiones (comoDimensionElementDelete) en el procedimiento de metadatos del proceso.TurboIntegrator crea automáticamente la copia de edición y le aplica lasoperaciones de edición; a continuación vuelve a escribir la dimensión real al finaldel procedimiento de metadatos.




SintaxisDimensionElementDeleteDirect(DimName, ElName);


DimName La dimensión que incluye el elemento quedesea eliminar.

ElName El elemento que desea eliminar.

EjemploDimensionElementDeleteDirect(’Region’, ’Belgium’);

Este ejemplo elimina el elemento Bélgica de la dimensión Región.

DimensionElementInsertEsta función añade un elemento a una dimensión.

Se trata de una función de TM1 TurboIntegrator, válida únicamente en los procesosde TurboIntegrator. Puede utilizar esta función para añadir elementosconsolidados, numéricos o de cadena. Tenga en cuenta que no podrá utilizar estafunción en el procedimiento de Datos o Epílogo de un proceso TurboIntegrator.


SintaxisDimensionElementInsert(DimName, InsertionPoint, ElName,ElType);


DimName La dimensión a la que desea añadir unelemento nuevo.

InsertionPoint Un elemento de dimensión existente. Elelemento que se añade a la dimensión seinsertará inmediatamente antes de esteelemento existente. Si este parámetro estávacío, el nuevo elemento se añade al final dela dimensión.

ElName El nombre que desea asignar al nuevoelemento.

ElType El tipo de elemento. Hay tres posiblesvalores de ElType:

N: equivale a un elemento numérico.

S: equivale a un elemento de cadena.

C: equivale a un elemento consolidado.

EjemploDimensionElementInsert(’Region’, ’Belgium’, ’Netherlands’,’N’);

Este ejemplo añade el elemento numérico Países Bajos a la dimensión Región.Países Bajos aparece inmediatamente antes de Bélgica en la definición dedimensión.

DimensionElementInsertDirectEsta función añade un elemento a una dimensión editando directamente ladimensión.

Se trata de una función de TM1 TurboIntegrator, válida únicamente en los procesosde TurboIntegrator. Puede utilizar esta función para añadir elementosconsolidados, numéricos o de cadena.

El método predeterminado de editar una dimensión en TM1 es utilizar un patrónde edición de copia completa. En dicho patrón, se crea una copia de edición de ladimensión, las ediciones se aplican a la copia de edición, y finalmente vuelve aescribirse la dimensión real utilizando la copia de edición como plantilla.TurboIntegrator admite la edición automática de la copia completa siempre que seutilicen funciones de TurboIntegrator para la edición de dimensiones (comoDimensionElementInsert) en la pestaña de metadatos del proceso. TurboIntegratorcrea automáticamente la copia de edición y le aplica las operaciones de edición; acontinuación vuelve a escribir la dimensión real al final del procedimiento demetadatos.




v Cuando el propósito del proceso TurboIntegrator es cargar grandes volúmenesde datos en un cubo. En este caso, el procedimiento de Metadatos del proceso semantiene deliberadamente vacío, y la inserción de cualquier elemento necesariopara dar soporte a la carga de datos se realiza utilizando llamadas directas en elprocedimiento de Datos. Cuando el procedimiento de Metadatos está vacío, elproceso se salta una repetición completa sobre el origen de datos externo, graciasa lo cual las cargas de datos pueden ser más rápidas.

SintaxisDimensionElementInsertDirect(DimName, InsertionPoint, ElName,ElType);


DimName La dimensión a la que desea añadir unelemento nuevo.

InsertionPoint Un elemento de dimensión existente. Elelemento que se añade a la dimensión seinsertará inmediatamente antes de esteelemento existente. Si este parámetro estávacío, el nuevo elemento se añade al final dela dimensión.

Observe que esta función está optimizadapara los casos en que se pasa InsertionPointcomo cadena vacía.

ElName El nombre que desea asignar al nuevoelemento.

ElType El tipo de elemento. Hay tres posiblesvalores de ElType:

N: equivale a un elemento numérico.

S: equivale a un elemento de cadena.

C: equivale a un elemento consolidado.

EjemploDimensionElementInsertDirect(’Region’, ’Belgium’, ’Netherlands’,’N’);

Este ejemplo añade el elemento numérico Países Bajos a la dimensión Región.Países Bajos aparece justo delante de Bélgica en la definición de dimensión.

DimensionElementPrincipalNameEsta función devuelve el nombre principal de un elemento o alias de elemento.



TurboIntegrator debe utilizar nombres de elementos principales al actualizardimensiones; no pueden utilizarse alias de elementos. Por tanto, esta función esútil para determinar nombres de elementos principales al tratar de actualizar unadimensión cuando solamente los alias de elementos están disponibles en el procesoTurboIntegrator.

SintaxisDimensionElementPrincipalName( DimName, ElName )


DimName El nombre de la dimensión de la que desearecuperar un nombre de elemento principal.

ElName Un nombre de elemento. ElName puede serun alias de elemento o un nombre deelemento principal.

Ejemplo

Si ElName no se encuentra actualmente en la versión guardada de DimName, lafunción devuelve EIName.

Si ElName se encuentra en DimName, ya sea como alias de elemento o comonombre de elemento principal, devuelve el nombre principal del elemento.

DimensionExistsUtilice DimensionExists para determinar si existe una dimensión específica en elservidor desde el que se ejecuta un proceso TurboIntegrator.

Se trata de una función de TM1 TurboIntegrator, válida únicamente en los procesosde TurboIntegrator. La función devuelve 1 si la dimensión existe en el servidor; delo contrario, devuelve 0.

SintaxisDimensionExists(DimName);


DimName El nombre de la dimensión cuya existenciadesea confirmar.

EjemploDimensionExists(’Region’);

Este ejemplo determina si existe la dimensión Región en el servidor.


DimensionSortOrderEsta función establece un sentido y un tipo de ordenación de los elementos de ladimensión y de los componentes de los elementos consolidados de una dimensión.

Se trata de una función de TM1 TurboIntegrator, válida únicamente en los procesosde TurboIntegrator. El orden de clasificación definido por DimensionSortOrderdetermina cómo aparecerá el subconjunto Todo en el Editor de subconjuntos.

DimensionSortOrder establece propiedades de una dimensión; la dimensión no seordena realmente hasta que se guarda en el servidor.

SintaxisDimensionSortOrder(DimName, CompSortType, CompSortSense,ElSortType , ElSortSense);


DimName El nombre de la dimensión para la quedesea establecer un orden de clasificación.

CompSortType Define el modo en que los componentes delos elementos consolidados aparecen en ladimensión. Existen dos valores deCompSortType:

ByInput: conserva el orden en que loscomponentes se insertaron originalmente enlas consolidaciones.

ByName: ordena los componentes de lasconsolidaciones por el nombre.

CompSortSense Define el sentido de la ordenación de loscomponentes de las consolidaciones. Se tratade un argumento necesario, pero únicamentese aplica cuando CompSortType es ByName.Hay dos posibles valores de CompSortSense:

Ascending: ordena los componentes de lasconsolidaciones en orden alfabéticoascendente.

Descending: ordena los componentes de lasconsolidaciones en orden alfabéticodescendente.



ElSortType Define un orden de clasificación para loselementos de la dimensión. Hay cuatroposibles valores de ElSortType:

ByInput: conserva al orden en que loselementos se insertaron originalmente en ladimensión.

ByName: ordena los elementos de ladimensión por el nombre.

ByLevel: ordena los elementos de ladimensión por el nivel.

ByHierarchy: ordena los elementos de ladimensión por la jerarquía.

ElSortSense Define el sentido de la ordenación de loselementos de la dimensión. Se trata de unargumento necesario, pero se aplicaúnicamente cuando ElSortType es ByName oByLevel. Hay dos posibles valores deElSortSense:

Ascending: ordena los elementos de ladimensión en orden ascendente, ya seaalfabéticamente o por el nivel.

Descending: ordena los elementos de ladimensión en orden descendente, ya seaalfabéticamente o por el nivel.

EjemploDimensionSortOrder (’Region’, ’ByName’, ’Descending’,’ByLevel’, ’Ascending’);

Este ejemplo establece un orden de clasificación para la dimensión Región. Todoslos elementos de la dimensión se clasifican en orden ascendente por el nivel, y loscomponentes de las consolidaciones se clasifican en orden alfabético descendente.

DimensionUpdateDirectEsta función conlleva una reescritura completa de la dimensión que ha sido objetode la edición directa en un proceso TurboIntegrator, principalmente compactandola ocupación de memoria de la dimensión.


Una dimensión que experimenta una serie de ediciones directas únicamente(eliminación de elementos, en particular) al final utilizará más memoria que sucontraparte completamente reescrita. Esta función puede utilizarse opcionalmentedespués de editar directamente una dimensión con DimensionElementInsertDirect,DimensionElementDeleteDirect, DimensionElementComponentAddDirect,DimensionElementComponentDeleteDirect y/o DimensionTopElementInsertDirect.La llamada a DimensionUpdateDirect supone un coste inicial de memoria de copia


completa, pero se puede utilizar para garantizar que la dimensión está en suocupación de memoria más bajo posible una vez finalizado el procesamiento.

SintaxisDimensionUpdateDirect(DimName);


DimName El nombre de la dimensión que deseareescribir.

EjemploDimensionUpdateDirect(’Region’);

Este ejemplo reescribe la dimensión Región.

DimensionTopElementInsertEsta función crea un elemento raíz en una dimensión.

Se trata de una función de TM1 TurboIntegrator, válida únicamente en los procesosde TurboIntegrator. Si la dimensión ya tiene una sola raíz, este elemento no secreará.

SintaxisDimensionTopElementInsert(DimName, InsertionPoint, ElName);


DimName La dimensión para la que desea crear unelemento raíz.

InsertionPoint Un elemento de dimensión existente. Elelemento raíz que se añade a la dimensiónse insertará inmediatamente antes de esteelemento existente.

ElName El nombre que desea asignar al nuevoelemento raíz.

EjemploDimensionTopElementInsert(’Region’, ’Netherlands’, ’World’);

Este ejemplo añade el elemento raíz Mundo a la dimensión Región. Mundoaparece inmediatamente antes de Países Bajos en la definición de dimensión.

DimensionTopElementInsertDirectEsta función crea un elemento raíz en una dimensión editando directamente ladimensión.

Se trata de una función de TM1 TurboIntegrator, válida únicamente en los procesosde TurboIntegrator. Si la dimensión ya tiene una sola raíz, este elemento no secreará.


El método predeterminado de editar una dimensión en Cognos TM1 es utilizar unpatrón de edición de copia completa. En dicho patrón, se crea una copia de ediciónde la dimensión, las ediciones se aplican a la copia de edición, y finalmente vuelvea escribirse la dimensión real utilizando la copia de edición como plantilla.TurboIntegrator admite la edición automática de la copia completa siempre que seutilicen funciones de TurboIntegrator para la edición de dimensiones (comoDimensionTopElementInsert) en el procedimiento de metadatos del proceso.TurboIntegrator crea automáticamente la copia de edición y le aplica lasoperaciones de edición; a continuación vuelve a escribir la dimensión real al finaldel procedimiento de metadatos.




SintaxisDimensionTopElementInsertDirect(DimName, InsertionPoint, ElName);


DimName La dimensión para la que desea crear unelemento raíz.

InsertionPoint Un elemento de dimensión existente. Elelemento raíz que se añade a la dimensiónse insertará inmediatamente antes de esteelemento existente.

ElName El nombre que desea asignar al nuevoelemento raíz.

EjemploDimensionTopElementInsertDirect(’Region’, ’Netherlands’, ’World’);

Este ejemplo añade el elemento raíz Mundo a la dimensión Región. Mundoaparece inmediatamente antes de Países Bajos en la definición de dimensión.

Funciones de TurboIntegrator de ODBCEstas funciones facilitan la manipulación de ODBC.


ODBCCloseEsta función cierra una conexión a un origen de datos ODBC.


SintaxisODBCClose(Source);


Source El nombre de un origen de datos ODBCabierta.

EjemploODBCClose(’Accounting’);

Este ejemplo cierra la conexión al origen ODBC Contabilidad.

ODBCOpenEsta función abre un origen de datos ODBC para la salida.


SintaxisODBCOpen(Source, ClientName, Password);


Source Un nombre de origen de datos ODBC.

ClientName Un cliente válido en el origen de datos.

Password Una contraseña para ClientName.

EjemploODBCOpen(’Accounting’, ’Jdoe’, ’Bstone’);

Este ejemplo abre el origen de datos ODBC Contabilidad para el cliente Jdoemediante la contraseña Bstone.

ODBCOPENExEsta función abre un origen de datos ODBC de salida especificando que laconexión debe abrirse como conexión Unicode.


El formato es: ODBCOPENEx (nombre del conjunto de datos, nombre del clientedel conjunto de datos, contraseña del cliente, (distintivo de interfaz Unicode))


SintaxisODBCOpenEx(Source, ClientName, Password, UseUnicodeODBC);


Source Un nombre de origen de datos ODBC.

ClientName Un cliente válido en el origen de datos.

Contraseña Una contraseña para ClientName.

UseUnicodeODBC Define el tipo de conexión Unicode que seva a utilizar.

EjemploODBCOpenEx( TestTable, sa, , 1 );

chinese= ;chinese = CHARW( 37123 );fieldval = chinese | SomeNewText;sql= Update TestTable set ForeName = N | fieldval | WHERE CustomerId= 1ODBCOUTPUT( Unicode, sql );

La sentencia SQL que aparece como resultado es:Update TestTable set ForeName = N?SomeNewText WHERECustomerId = 1

ODBCOutputEsta función ejecuta una consulta de actualización SQL a un origen de datos ODBCabierto.

Se trata de una función de TM1 TurboIntegrator, válida únicamente en los procesosde TurboIntegrator. Debe utilizar la función ODBCOpen para abrir el origen dedatos antes de llamar a ODBCOutput, y utilizar ODBCClose para cerrar el origende datos antes de salir del proceso.

SintaxisODBCOutput(Source, SQLQuery, [SQLQuery2, SQLQuery3, ...]);


Source El origen de datos ODBC en el que desearealizar una consulta.



SQLQuery Una sentencia de consulta SQL.

Aunque ODBCOutput se desarrolló paraactualizar tablas, puede utilizarse paraejecutar cualquier consulta SQL en el origende datos.

En circunstancias en las que la sentencia deconsulta SQL supera los 255 caracteres, debedividir la consulta en varios argumentosSQLQuery (SQLQuery2, SQLQuery3, etc.).Esto le permite crear sentencias de consultaque superan el límite de 255 caracteres delos argumentos TurboIntegrator. Cuando seejecuta la función ODBCOutput, seconcatenan todos los argumentos SQLQueryy se realiza la consulta de forma correcta.

EjemploODBCOutput(’Accounting’, ’INSERT [CategoryID], [CategoryName]FROM Categories;’);

Este ejemplo ejecuta la consulta especificada con el origen de datos Contabilidad.

SetODBCUnicodeInterfaceEsta función establece si la interfaz ODBC debe utilizar las funciones "comodín"Unicode o las funciones de caracteres de un solo byte habituales.


Si establece esta función en 1, utilizará la interfaz ODBC de caracteres "comodín".

Algunos controladores ODBC soportan la interfaz de un solo byte más antigua, asícomo una interfaz de 'caracteres comodín' de estilo Unicode, donde los caracterespasan y se recuperan como cantidades de 16 bits. Si el controlador seleccionado nosoporta uno u otro estilo, se proporcionará un distintivo para obligar aTurboIntegrator a utilizar un estilo de interfaz particular.

SintaxisSetODBCUnicodeInterface=1


1 Utilice la interfaz ODBC de caracteres"comodín".

0 Utilice la interfaz de un solo byte.

Funciones de TurboIntegrator de control de procesosEstas funciones pertenecen al control de procesos.


ProcessErrorEsta función provoca la finalización inmediata de un proceso.


Los procesos finalizados con esta función se marcan con un estado de error.

SintaxisProcessError;

Argumentos

Ninguno.

ExecuteCommandEsta función ejecuta una línea de comandos durante un proceso. Puede utilizarExecuteCommand para ejecutar una aplicación de escritorio, pero no un servicio.


Si utiliza ExecuteCommand para ejecutar un ejecutable, se aplican las siguientescondiciones:v Si el argumento CommandLine únicamente especifica el nombre de un archivo

que se ejecutará, un servidor Windows buscará el archivo tanto en el directoriode bases de datos del servidor como en el directorio en el que está ubicadoTm1s.exe. Un servidor UNIX busca el archivo únicamente en el directorio debases de datos del servidor.

v Si el argumento CommandLine utiliza un prefijo de ruta relativo, tanto elservidor Windows como el servidor UNIX tratan de localizar el archivoúnicamente en el directorio de bases de datos del servidor.

v En el servidor Microsoft Windows o UNIX puede pasar una ruta absoluta alargumento CommandLine para ejecutar un archivo en cualquier ubicación.

SintaxisExecuteCommand(CommandLine, Wait);


CommandLine La línea de comandos que desea ejecutar.

Wait Indica si el proceso debe esperar a que elcomando finalice la ejecución antes decontinuar con la siguiente sentencia delproceso. Un valor de argumento de 0 haceque el proceso realice la siguiente sentenciasin esperar a que se ejecute la línea decomandos. Un valor de argumento de 1 haceque el proceso espere a que la línea decomandos se ejecute de forma correcta antesde continuar con la siguiente sentencia.


ExecuteProcessEsta función le permite ejecutar un proceso TurboIntegrator desde otro proceso.


SintaxisExecuteProcess(ProcessName, [ParamName1, ParamValue1,ParamName2, ParamValue2]);


ProcessName El nombre del proceso que se ejecutará. Este proceso debeestar ubicado en el mismo servidor que el proceso desde elque se llama a ExecuteProcess.

Si no es posible encontrar el proceso denominado por esteargumento en el tiempo de ejecución, el proceso de llamadafinalizará inmediatamente. (TurboIntegrator no comprueba siProcessName es válido durante la compilación.)

ParamName El nombre de un parámetro existente del proceso que seejecutará. Este argumento únicamente es necesario si elproceso que se ejecutará utiliza parámetros.

ParamValue Un valor válido para el parámetro ParamName. Si especificaun argumento ParamName, debe especificar elcorrespondiente ParamValue.

Los argumentos ParamName y ParamValue deben ser paresordenados, con el nombre del parámetro seguido del valor.Debe especificar un ParamName y el correspondienteParamValue de cada parámetro del proceso que se ejecutará.

Los nombres de parámetros pasados en la función ExecuteProcess se comparandurante el tiempo de ejecución con los nombres de parámetros especificados en elproceso que se ejecutará. Si los nombres pasados no se pueden encontrar en la listade parámetros del proceso que se ejecutará, se producirá un error grave, queprovocará la finalización inmediata del proceso desde el que se llame aExecuteProcess.

Valores de retorno

ExecuteProcess devuelve un valor real que puede probarse con una de lassiguientes funciones de valor de retorno:

Función Descripción

ProcessExitByChoreQuit() indica que salió del proceso debido a la ejecución de lafunción ChoreQuit

ProcessExitNormal() indica que el proceso se ejecutó con normalidad

ProcessExitMinorError() indica que el proceso se ejecutó correctamente, pero seencontraron errores leves


Función Descripción

ProcessExitByQuit() indica que salió del proceso debido a un comando explícitode "salida"

ProcessExitWithMessage() indica que el proceso finalizó con normalidad, con unmensaje escrito en tm1server.log

ProcessExitSeriousError() indica que salió del proceso debido a un error grave

ProcessExitOnInit() indica que el proceso se interrumpió durante la inicialización

ProcessExitByBreak() indica que salió del proceso porque se encontró una funciónProcessBreak

Ejemplo

Para registrar cuándo falla un proceso llamado por ExecuteProcess debido a unerror grave, debería utilizar un código similar al que se indica a continuación:return_value = ExecuteProcess(’create_sales_cube’);ASCIIOutput(’C:\temp\process_return_value.txt’, ’Process exitedwith serious errors at’, TIME, ’on’, TODAY);if(return_value = ProcessExitSeriousError() )endif;

GetProcessErrorFileDirectoryEsta función devuelve el nombre de ruta completo, con barra final, del directoriodonde se escriben los archivos de error del proceso TurboIntegrator.

Se trata de una función de TM1 TurboIntegrator, válida únicamente en los procesosde TurboIntegrator. De forma predeterminada, todos los archivos de registro deerrores del proceso se escriben en el directorio de datos del servidor en el que estáubicado el proceso.

SintaxisGetProcessErrorFileDirectory;

Argumentos

Ninguno.

GetProcessErrorFilenameEsta función devuelve el nombre del archivo de registro de errores del procesoTurboIntegrator asociado con un proceso.

Se trata de una función de TM1 TurboIntegrator, válida únicamente en los procesosde TurboIntegrator. Si el proceso no ha generado aún un archivo de registro deerrores, la función devuelve una cadena vacía (nula).

Importante: no se genera un archivo de registro de errores del proceso hasta quese hayan ejecutado todas las sentencias de una determinada pestaña de un proceso(Prólogo, Metadatos, Datos o Epílogo). De esta manera, puede utilizarGetProcessErrorFilename para comprobar si alguna pestaña anterior ha generado


un archivo de registro de errores, pero no puede utilizar la función paradeterminar si la pestaña actual del proceso hará que los errores se escriban en unarchivo de registro.

Por ejemplo, al determinar que GetProcessErrorFilename devuelva una cadena nonula en la pestaña Epílogo, puede indicar que los errores se generaron en laspestañas Prólogo, Metadatos o Datos. Sin embargo, no puede utilizarGetProcessErrorFilename en la pestaña Datos para determinar si la pestaña Datosgenera errores.

SintaxisGetProcessErrorFilename;

Argumentos

Ninguno.

GetProcessNameEsta función devuelve el nombre del proceso actual como una cadena.


SintaxisGetProcessName()

Argumentos

Ninguno.Name = GetProcessName();

IfLa sentencia If permite que un proceso ejecute una sentencia o un conjunto desentencias cuando una determinada expresión sea true.

Se trata de una función de TM1 TurboIntegrator, válida únicamente en los procesosde TurboIntegrator. Puede utilizar operadores aritméticos, operadores lógicos yoperadores de comparación para crear una expresión.

La sentencia If de TurboIntegrator difiere de la función IF de Rules en que lasentencia de TurboIntegrator puede aceptar varias sentencias ElseIf o Else paraevaluar diversas expresiones, mientras que la función IF de Rules puede evaluarúnicamente una expresión.

Puede anidar un máximo de 20 sentencias If/ElseIf/Else en un procesoTurboIntegrator. Si supera 20 sentencias If/ElseIf/Else anidadas, recibirá un erroral tratar de guardar el proceso.

SintaxisIf(expression);statement1;ElseIf(expression);statement2;ElseIf(expression);


statement3;Else;statement4;EndIf;

Argumentos

Ninguno.

EjemplosIf (x=5);ASCIIOutput(’c:\temp\if.txt’,’x equals five’);ElseIf (x=1);ASCIIOutput (’c:\temp\if.txt’, ’x equals one’);ElseIf (x=2);ASCIIOutput (’c:\temp\if.txt’, ’x equals two’);ElseIf (x=3);ASCIIOutput (’c:\temp\if.txt’, ’x equals three’);ElseIf (x=4);ASCIIOutput (’c:\temp\if.txt’, ’x equals four’);Else;ASCIIOutput (’c:\temp\if.txt’, ’x falls outside expected range’);EndIf;

Este ejemplo evalúa el valor de X. Si X=5, se ejecuta la función ASCIIOutput paraescribir la cadena "x equivale a cinco" en c:\temp\if.txt. Si X no equivale a 5, seevalúa la primera sentencia ElseIf. Si X=1, se ejecuta la función ASCIIOutput paraescribir la cadena "x equivale a uno" en c:\temp\if.txt. Este procesamientocontinúa hasta que se ejecuta EndIf.

También se pueden construir sentencias If sin el uso de ElseIf, como en esteejemplo:IF(expression);statement1;ELSE;statement2;ENDIF;

ItemRejectEsta función rechaza un registro de fuente y lo coloca en el registro de errores,junto con un mensaje de error especificado.


SintaxisItemReject(ErrorString);


ErrorString El mensaje de error que desea escribir en elregistro de errores cuando se rechaza unregistro.

EjemploItemReject(’ Value outside of acceptable range.’);


Este ejemplo coloca un registro de origen en el registro de errores, junto con elmensaje de error "Valor fuera del rango aceptable" cuando el registro de origencontiene un valor que está más allá de un rango definido.

ItemSkipEsto obliga a que un proceso omita el elemento de origen de datos actual.


SintaxisItemSkip;

Argumentos

Ninguno.

ProcessBreakEsta función detiene el procesamiento de los datos de origen y avanza hasta laparte Epílogo de un proceso.


SintaxisProcessBreak;

Argumentos

Ninguno.

ProcessErrorEsta función provoca la finalización inmediata de un proceso.


Los procesos finalizados con esta función se marcan con un estado de error.

SintaxisProcessError;

Argumentos

Ninguno.

ProcessQuitEsta función finaliza un proceso TurboIntegrator.



SintaxisProcessQuit;

Argumentos

Ninguno.

WhileLa sentencia While de TurboIntegrator permite que un proceso repita una serie desentencias mientras una determinada condición sea true.


Las sentencias While se pueden anidar.

SintaxisWHILE(logical expression);

statement1;

statement2;

...

statement n;

END;

Nota: Todas las sentencias WHILE deben concluir con una sentencia END.

Argumentos

Ninguno.

SynchronizedSynchronized() se puede utilizar en un script de TurboIntegrator para forzar laejecución en serie de un conjunto designado de procesos de TurboIntegrator.

La función synchronized() utiliza la sintaxis siguiente.synchronized(string)

Parámetros

synchronized() toma un solo parámetro necesario que es un nombre definido porel usuario para un objeto de bloqueo. Este nombre de objeto de bloqueo se puedeutilizar en varios procesos de TurboIntegrator para serializar su ejecución comogrupo.


Parámetro

Descripción

Valor/Obligatorio/Valor predeterminado

lockName El nombre definido por el usuario de unobjeto de bloqueo en el que sincronizar. Losnombres no distinguen entre mayúsculas yminúsculas y se ignoran los espaciosintercalados. La longitud de los nombres nopuede superar los 1023 caracteres.

Cadena/Sí/Ninguno

Semántica

Un proceso de TurboIntegrator puede realizar cualquier número de llamadas asynchronized(), con cualquier número de objetos de bloqueo. La serialización esefectiva desde el momento en que se llama a synchronized(), hasta que se completala transacción que la contiene.

Por ejemplo, si se llama a synchronized() desde un subproceso (Ps) del procesomaestro (Pm) o tarea maestra (Cm), el objeto bloqueado se "libera" cuando secompleta el proceso Pm o la tarea Cm. La excepción es que un SaveDataAll (SDA)"finaliza" de forma prematura la ejecución de una transacción a mitad del proceso,esto se aplica también a los objetos de bloqueo.

La llamada a synchronized() se puede colocar en cualquier lugar dentro de unscript TurboIntegrator, pero la serialización se aplica a todo el proceso deTurboIntegrator cuando se encuentra.

Presuponga que existe un proceso de TurboIntegrator con una llamada asynchronized() en algún lugar a mitad de su script y que una operación O1precede a dicha llamada. Es posible que dos instancias de este proceso deTurboIntegrator se inicien al mismo tiempo. Es posible que una instancia se ejecutehasta su finalización, incluida su llamada a synchronized(), antes de que lasegunda instancia alcance su llamada synchronized(). En este caso, al usuario leparece que los dos procesos se han ejecutado de forma simultánea. Si, en su lugar,el segundo proceso alcanza su llamada synchronized() antes de que finalice elprimero, deshará cualquier trabajo que haya realizado (O1) y esperará a que secomplete el primero. En este caso, para el usuario los dos procesos se hanserializado.

Para evitar esta confusión, y para optimizar el uso de synchronized(), serecomienda (sin que sea obligatorio) que las llamadas synchronized() sean lasprimeras sentencias de un proceso de TurboIntegrator.

Ejemplo

Presuponga que el proceso P de TurboIntegrator necesita actualizar dos cubos,Cube_1 y Cube_2.

Es posible que otros procesos de TurboIntegrator también tengan que actualizarCube_1 o Cube_2.

Para que todos los procesos de TurboIntegrator que actualizarán Cube_1 o Cube_2se ejecuten uno tras otro, el proceso P puede llamar a synchronized() de este modo:


sCube_1=’Cube_1’;sCube_2=’Cube_2’;sE1=’Elm1’;sE2=’Elm2’;sE4=’Units’;sE5=’Price’;

Synchronized( sCube_1 );Synchronized( sCube_2 );

CellPutn( 111, sCube_1, sE1, sE2 );CellPutn( 9.99, sCube_2, sE4, sE5 );

# ...

Otros procesos de TurboIntegrator que actualizarán Cube_1 o Cube_2 tambiéndeben llamar a synchronized( sCube_1 ) y/o a synchronized( sCube_2 ) de unmodo similar.

En este ejemplo, los dos nombres de objetos de bloqueo se han elegido para quesean los mismos que los nombres de los cubos. Pero un nombre de objeto debloqueo no tiene que ser el mismo que el de los otros objetos Cognos TM1 (cubos,dimensiones, subconjuntos, etc).

Funciones de TurboIntegrator de gestión de reglasEstas funciones facilitan la gestión de reglas.

CubeProcessFeedersEsta función vuelve a procesar todos los feeders de las reglas de un cuboespecificado.


Esta función vuelve a procesar todos los feeders de las reglas de un cuboespecificado. Normalmente los feeders se vuelven a procesar de forma automáticaal guardar la edición de un archivo de regla, sin embargo, si los datos cambian, ydichos cambios en los datos modificarán algunos feeders condicionales, estafunción deberá llamarse para volver a evaluar dichos feeders condicionales.

SintaxisCubeProcessFeeders(CubeName);


CubeName El cubo cuyos feeders desea volver aprocesar.

EjemploCubeProcessFeeders(’2003sales’);

Este ejemplo vuelve a procesar todos los feeders de las reglas del cubo ventas2003.


CubeRuleAppendEsta función añade una sola línea de texto de regla a una regla de cubo de TM1 .


Básicamente, esta función añade una sola línea de texto a un archivo de reglas(.rux). La línea de texto suele ser una sentencia de regla, pero también puede serun comentario. Si no hay ninguna regla asociada al cubo en el momento en que seejecuta la función, se creará una regla nueva que sólo contiene la línea que se hapasado.

SintaxisCubeRuleAppend(CubeName, RuleText, IsCalculationRule);


CubeName El nombre del cubo asociado a la regla en laque desea añadir una línea de texto.

RuleText La línea única de texto que desea añadir a laregla.

La línea completa de texto que añada deberáir entre comillas simples y debe cumplir conlas convenciones sintácticas de las reglas.

Si la línea de texto incluye referencias aelementos, en los nombres de elementodeberán utilizarse dobles comillas simplescomo caracteres de escape de las comillassimples que suelen englobar a los nombresde elemento. Por ejemplo, una referencia aun elemento llamado CL3 se especificaríacomo [’’CL3’’].

A continuación se indican una serie deejemplos de líneas válidas de texto quepuede añadir a una regla:

’[’’CL3’’] = [’’CL4’’] + [’’Trial’’];’

’skipcheck;’

’[’’Trial’’] => [’’CL3’’];’



IsCalculationRule El parámetro IsCalculationRule declara si lalínea debe insertarse justo encima de unasección de feeder que pudiera existir en laregla del cubo. Si se omite el parámetroIsCalculationRule, o se pasa como 0.0, lanueva línea simplemente se añadirá al finalde la regla.

Puesto que los archivos de reglas (.rux)constan de una sección de cálculo seguidade una sección feeder opcional, las líneasque se hayan añadido y que sean sentenciasde reglas de cálculo (o sus comentarioscorrespondientes) deben utilizar un 1.0 paraeste argumento para asegurarse de que lanueva línea se inserta en la ubicaciónapropiada del archivo de reglas.

EjemplosCubeRuleAppend( ’MyCube’, ’[’’CL3’’] = [’’CL4’’] + [’’Trial’’];’, 1.0 );

En este ejemplo se inserta la sentencia de cálculo [’CL3’] = [’CL4’] + [’Trial’];al final de la sección de cálculo de la regla correspondiente al cubo MyCube.CubeRuleAppend( ’MyCube’, ’[’’Trial’’] => [’’CL3’’];’, 0.0 );

En este ejemplo se inserta la sentencia feeder [’Trial’] => [’CL3’]; al final de laregla correspondiente al cubo MyCube.

CubeRuleDestroyEsta función suprime las reglas existentes que corresponden a un cuboespecificado.


SintaxisCubeRuleDestroy(CubeName);


CubeName El nombre del cubo asociado a la regla quedesea suprimir

EjemploCubeRuleDestroy(’SalesProjections’);

En este ejemplo se suprime la regla de SalesProjectionscube.

DeleteAllPersistentFeedersBorra los archivos .feeder que permanezcan.


Al utilizar esta función, todos los cubos se marcarán como "no guardar feeders",por lo que al utilizar posteriormente la función "SaveData", los feeders nopermanecerán, lo que significa que todos los feeders volverán a calcularse alreiniciar el servidor.

SintaxisDeleteAllPersistentFeeders;


ninguno No existen argumentos para esta función.

ForceSkipCheckHace que el comportamiento de la consulta sea el mismo que si el cubo tuvieraSKIPCHECK en las reglas.

Esto significa que la consulta solamente procesará los valores que están realmenteen el cubo, en contraposición a los casos (sin SKIPCHECK) en los que seenumeraría cada celda posible al buscar valores.Esta función establece el estado dela consulta de vista de modo que se seleccionen solamente valores en el cubo. Lafunción debe añadirse a la sección Prólogo del proceso de Turbo Integrator. Alcolocar ForceSkipCheck() en el prólogo se ve afectada toda la consulta de vista deelementos de datos que haya después.

SintaxisForceSkipCheck()


ninguno No existen argumentos para esta función.

RuleLoadFromFileEsta función crea una regla TM1 para un determinado cubo de un archivo de texto.


El archivo de texto debe formatearse según las convenciones de reglas TM1 . Cadasentencia de regla debe concluir con un punto y coma (;) y a los comentarios se lesdebe anteponer el carácter #.

Si ya existe una regla para el cubo especificado, la regla existente es sustituida porla regla creada por RuleLoadFromFile.

SintaxisRuleLoadFromFile(Cube, TextFile);


Cube El nombre del cubo para el que desea crearuna regla.



TextFile El nombre del archivo de texto desde el quedesea crear una regla.

Puede especificar la ruta completa de estearchivo, incluyendo la extensión y el nombrede archivo. (Ejemplo 1 a continuación.)

Si únicamente especifica la extensión y elnombre de archivo, TurboIntegrator busca elarchivo en el directorio de datos delservidor.

Si no especifica una extensión de archivo,TurboIntegrator asumirá la extensión .rux deforma predeterminada. (Ejemplo 2 acontinuación.)

Si deja en blanco el argumento TextFile, TurboIntegrator buscará un archivo deorigen con el mismo nombre que el cubo (pero con una extensión .rux) en eldirectorio de datos del servidor. (Ejemplo 3 a continuación.)

EjemploRuleLoadFromFile(’Sales’, ’C:\temp\cuberule.txt’);

Este ejemplo utiliza el contenido del archivo cuberule.txt del directorio C:\temppara crear una regla para el cubo Ventas.RuleLoadFromFile(’Sales’, ’cuberule’);

Este ejemplo crea una regla para el cubo Ventas utilizando el archivo denominadoreglacubo.rux del directorio de datos del servidor.RuleLoadFromFile(’Sales’, ’ ’);

Este ejemplo crea una regla para el cubo Ventas utilizando el archivo denominadoSales.rux del directorio de datos del servidor.

Funciones de recintos de pruebasEstas funciones se utilizan con los recintos de pruebas.

GetUseActiveSandboxPropertyEsta función devuelve un valor booleano que indica si un proceso lee y escribedatos en los datos básicos o en el recinto de pruebas activo del usuario.


El valor predeterminado se reserva para procesos que lean y escriban en los datosbásicos.v Si el valor devuelto es 0, el proceso está leyendo y escribiendo en los datos

básicos.v Si el valor devuelto es 1, el proceso está leyendo y escribiendo en el recinto de

pruebas activo.


Nota: Esta función devolverá el valor permanente de esta propiedad tal y como seestablece en la interfaz de usuario de Architect/Server Explorer, a menos que hayautilizado la función SetUseActiveSandboxProperty en el proceso. En dicho caso, elvalor de esta propiedad se determina mediante el valor que se estableció porúltima vez con la función SetUseActiveSandboxProperty.

SintaxisGetUseActiveSandboxProperty()

Argumentos

Ninguno.

Ejemploreturn_value = GetUseActiveSandboxProperty();

Este ejemplo devolverá un valor booleano que indicará si el proceso está leyendo oescribiendo datos del cubo en el recinto de pruebas activo o en los datos básicos.

ServerSandboxesDeleteServerSandboxesDelete permite a los administradores descartar los recintos depruebas que cumplen un criterio determinado.

Se trata de una función de TM1 TurboIntegrator, válida en los procesos deTurboIntegrator.

Los recintos de pruebas son espacios de trabajos privados en los que un usuariopuede especificar y almacenar valores de datos separados de los datos básicos deIBM Cognos TM1 . Los recintos de pruebas se almacenan en disco y, cuando seutilizan, en la memoria. Esta funcionalidad se lleva a cabo en el lado del servidor yestá disponible a través de TurboIntegrator y de la función de la APIServerSandboxesDelete. Si se utiliza esta característica en un proceso deTurboIntegrator, los administradores pueden planificar el mantenimiento mediantetareas automatizadas.

Descripción

Esta función utiliza un predicado para describir el recinto de pruebas que se va asuprimir. Una lectura de un predicado podría ser: "Suprimir recintos de pruebascuyo atributo sea condición valor."

Por ejemplo: "suprimir recintos de pruebas cuyo tamaño sea mayor que 10 MB". Eneste ejemplo, el atributo es el "tamaño" del recinto de pruebas, la condición es"mayor que" y el valor es "10 MB".

Existen dos parámetros de caracteres delimitadores opcionales para la función deTurboIntegrator. Dado que un recinto de pruebas no tiene restricciones en cuanto alos caracteres que se pueden utilizar en su nombre, los administradores puedensuministrar su propio delimitador seguro, cuando sea necesario.

Por ejemplo, ServerSandboxesDelete( ’client:=:Admin, name:=:best casescenario’ );"


En el ejemplo siguiente, el carácter de dos puntos se utiliza en el nombre delrecinto de pruebas ("best::case::scenario"), de modo que se necesita otrodelimitador:ServerSandboxesDelete( ’client|=|Admin# name|=|best::case::scenario’, ’|’, ’#’ );"

Nota: La sintaxis exacta de un predicado difiere entre los formatos deTurboIntegrator y de la API de esta función.

SintaxisServerSandboxesDelete(string,string,string)

Argumentos

Predicados

Obligatorios

Cadena

Sin valor predeterminado

Una lista de predicados de longitud arbitraria. Cada predicado es una cadenaque contiene tres señales. La primera señal indica un atributo del recinto depruebas. La segunda indica una condición, por ejemplo, ">" o "=". La terceraseñal es un valor posible del atributo según el cual se deben filtrarcondicionalmente los recintos de pruebas. La longitud de toda la cadena nodebe superar los 10.000 caracteres.

Delimitador de predicado

Opcional

Cadena

El valor predeterminado es el signo de dos puntos (:)

Carácter delimitador opcional.

La longitud de la cadena no debe superar 1 carácter.

Delimitador de lista de predicados

Opcional

Cadena

El valor predeterminado es la coma (,)

Carácter delimitador opcional.

La longitud de la cadena no debe superar 1 carácter.

Atributos de filtro

Los atributos de filtro son propiedades de un recinto de pruebas que se puedenutilizar para comprobar si el recinto de pruebas cumple determinadas condiciones.Los nombres de atributos y sus condiciones válidas correspondientes no distinguenentre mayúsculas y minúsculas e ignoran los espacios en blanco intercalados. Porejemplo, las dos llamadas siguientes son válidas:

ServerSandboxesDelete( ’client:=:Admin’ );

ServerSandboxesDelete( ’C L I E N T : = :Admin’ );


Tabla 1. Atributos de filtro

Atributo DescripciónCondicionesválidas Tipo de valor

UpdateDate Indicación de fecha yhora de la últimaacción de escriturarealizada en el recintode pruebas.

<, =, >. Indicación de fecha y hora enformato estándar internacional, esdecir, AAAA-MM-DD. Los días sonlas unidades más pequeñas.

AccessDate Indicación de fecha yhora de la últimadescarga de un recintode pruebas.


CreationDate Indicación de fecha yhora de la creación deun recinto de pruebas.


Size Tamaño de un recintode pruebas en lamemoria.

<, =, >. Tamaño basado en las reglas deconversión de log4cxx (vea elparámetro de configuraciónAuditLogMaxTemp FileSize). Porejemplo, 10 MB. Los kilobytes sonlas unidades más pequeñas.

Name Nombre de un recintode pruebas.

=,containing.

Cadena.

Client Cliente propietario deun recinto de pruebas.

=. Cadena.

Group Un grupo del que esmiembro el clientepropietario de unrecinto de pruebas.

=. Cadena.

Registro y valores devueltos

La supresión de un recinto de pruebas se registra utilizando la funcionalidad deregistro de auditoría ya existente. Adicionalmente, se incluye un informe másdetallado de los efectos de la administración del recinto de pruebas en el registrode depuración (tm1server.log) en el nivel INFO. Este informe incluirá la lista derecintos de pruebas afectados y también algunos de sus atributos y los erroresencontrados.

ServerSandboxesDelete solamente devuelve un estado de correcto o de error.

Semántica

Lista de predicados

Cuando se pasan varios predicados en una sola llamada aServerSandboxesDelete, éstos son conjuntivos. En otras palabras, para queun recinto de pruebas coincida con el criterio que se ha pasado, todos lospredicados tienen que ser verdaderos. Se pueden utilizar varias llamadas aServerSandboxesDelete para obtener un comportamiento disyuntivo.Solamente se puede pasar un atributo de cada tipo en cada llamada aServerSandboxesDelete. Por ejemplo, no es válido pasar dos veces el clienteya que un recinto de pruebas solamente tiene un cliente propietario.Cuando se detecta que un atributo aparece varias veces, se muestra un


aviso en el informe detallado, no obstante, la operación no se interrumpirácon un error. En este caso, se prueban los predicados como en cualquierotra consulta pero el conjunto de resultados siempre está vacío.

Bloqueos

Para evitar problemas de bloqueos masivos, ServerSandboxesDeleteobserva los recintos de pruebas de un cliente como una instantáneapuntual y, a continuación, cuando es posible libera los bloqueos quegarantizan una transacción serializable. Debido a este comportamiento,cuando se "pasa" un cliente en la iteración de todos los clientes, se puedeañadir a dicho cliente un recinto de pruebas que coincida con el criterio defiltro antes de que se complete la transacción de mantenimiento. Estecomportamiento es similar al que se da cuando se añade un recinto depruebas para el cliente inmediatamente después de que se completa latransacción.

Ámbito

Los miembros del grupo ADMIN (superusuario) y DataAdmin tendránacceso a todos los recintos de pruebas de todos los clientes. Debenespecificar explícitamente el atributo de cliente para limitar el ámbito de sullamada a ServerSandboxesDelete únicamente a sus propios recintos depruebas. Todos los demás usuarios solamente tienen acceso a sus propiosrecintos de pruebas. Si especifican un cliente diferente, o un grupo al queno pertenecen, la función terminará anormalmente en error y se devolveráun error de privilegio.

Recintos de pruebas en uso

Cuando un recinto de pruebas cumple el criterio de supresión, pero está enuso, dicho recinto de pruebas no se suprime. Aparecerá una entrada en elinforme de nivel de información del registro de depuración indicándolo.

Fechas de acceso y actualización

Los atributos de fecha pueden ser coincidencias como mucho con lagranularidad de días. Debido a esta restricción, el registro de estosatributos es en consecuencia granular. En las escrituras de celdasindividuales no se actualiza la fecha de última actualización. En lugar deello, el sistema registra la fecha de descarga de un recinto de pruebas en elque se ha realizado una operación de escritura mientras se cargaba en lamemoria. Para estos recintos de pruebas, la fecha de último acceso y lafecha de última actualización serán iguales. Únicamente se actualiza lafecha de último acceso cuando se descarga un recinto de pruebas de lamemoria. Asimismo, debido a que los recintos de pruebas en memoria noestán sujetos a ServerSandboxesDelete, no se actualiza la fecha de últimoacceso cuando se carga un recinto de pruebas en la memoria.

Por ejemplo, presuponga el siguiente escenario de uso:

Tabla 2. Ejemplo de Día de último acceso

Día Hora Acción

1 1 Cargar recinto de pruebas S

1 2 Escribir 1

2 3 Leer 1

2 4 Descargar recinto de pruebas

Un usuario trabaja con un recinto de pruebas durante dos días (quizás


durante un periodo más corto que abarque el cambio de día). A la hora 4,cuando se descarga el recinto de pruebas, la fecha de última actualizaciónse establece en 2, y no en 1, que es cuando se ha producido realmente laúltima actualización. En este caso, la fecha de último acceso también seestablece en 2 a la hora 4. Si la acción de Escribir 1 fuera una acción delectura, únicamente la fecha de último acceso se establecería en 2, mientrasque la fecha de última actualización no se modificaría.

EjemploServerSandboxesDelete( ’client:=:Admin, name:=:best case scenario’ );

ServerActiveSandboxGetEsta función devuelve el nombre del recinto de pruebas activo del usuario querealiza la acción.


Si el usuario no tiene ningún recinto de pruebas activo, devolverá una cadenavacía. Dado que las tareas se ejecutan en el contexto de un usuario deadministración especial y pueden no tener ningún recinto de pruebas activo, estafunción siempre devolverá una cadena vacía cuando se ejecute a través de unatarea.

SintaxisServerActiveSandboxGet()

Argumentos

Ninguno.

Ejemploreturn_value = ServerActiveSandboxGet();

Este ejemplo devolverá el recinto de pruebas activo del usuario que ejecuta elproceso de TI en el que se realice la llamada de la función.

ServerActiveSandboxSetEsta función establece el recinto de pruebas activo del usuario que realiza laacción.


Se utiliza una cadena vacía para eliminar el recinto de pruebas activo del usuarioque realiza la acción. Esta función producirá un error si el usuario que realiza laacción no cuenta con un recinto de pruebas con el nombre pasado. Dado que lastareas se ejecutan en el contexto de un usuario de administración especial ypueden no tener ningún recinto de pruebas activo, esta función siempre produciráun error cuando se ejecute a través de una tarea.

Nota: para que un proceso de TurboIntegrator lea y escriba valores en el contextodel recinto de pruebas activo del usuario que realiza la acción, debe establecerse lapropiedad UseActiveSandbox. Consulte los apartados


“GetUseActiveSandboxProperty” en la página 293 y“SetUseActiveSandboxProperty”.

SintaxisServerActiveSandboxSet(SandboxName)


SandboxName Valor de cadena. Nombre de un recinto depruebas que pertenece al usuario que realizala acción.

EjemploServerActiveSandboxSet(’Best case’);

Este ejemplo establecerá el recinto de pruebas activo del usuario que realiza laacción en "Mejor caso".ServerActiveSandboxSet(’’);

Este ejemplo eliminará el recinto de pruebas activo del usuario que realiza laacción (volverá a establecer el contexto en los datos básicos).

SetUseActiveSandboxPropertyEsta función controla si un proceso lee y escribe datos del cubo en los datosbásicos o en el recinto de pruebas activo del usuario.

Se trata de una función de TM1 TurboIntegrator, válida únicamente en los procesosde TurboIntegrator. El valor predeterminado se reserva para procesos que lean yescriban en los datos básicos.

El ámbito de esta función se aplica únicamente al proceso que se está ejecutandoactualmente y sustituye temporalmente al valor permanente de esta propiedad queestá establecido en la interfaz de usuario de Architect/Server Explorer.

SintaxisSetUseActiveSandboxProperty(PropertyValue)


PropertyValue Valor booleano que indica si el procesodebería utilizar el contexto del recinto depruebas activo al leer o escribir datos delcubo.

Si PropertyValue = 0, el proceso ignorará elcontexto del recinto de pruebas activo y lalectura/escritura en los datos básicos.

Si PropertyValue = 1, el procesoleerá/escribirá datos del cubo en el recintode pruebas activo.

EjemploSetUseActiveSandboxProperty(1);


Este ejemplo provocará que el proceso lea/escriba datos del cubo en el recinto depruebas activo para el resto de la ejecución.

ServerSandboxExistsEsta función comprueba la existencia del recinto de pruebas transferido. 1 es elvalor que se devuelve cuando existe el recinto de pruebas transferido y 0 en casocontrario.


SintaxisServerSandboxExists( sandboxname )

oServerSandboxExists( sandboxname , username )

Argumentos

El nombre del recinto de pruebas cuya existencia se está comprobando.ServerSandboxExists adopta un parámetro de serie opcional, el nombre del clientepropietario. El cliente que llama puede utilizar el parámetro opcional paraespecificar un cliente que no sea él mismo si cuenta con los privilegios adecuados.Se producirá un error de privilegio si el cliente especificado no es el clienteejecutor y el cliente ejecutor no pertenece a los grupos DataAdmin o ADMIN. Si nose utiliza el parámetro opcional, el sujeto serán los recintos de prueba del clienteactivo.

Ejemplo

El siguiente fragmento de código muestra cómo se pueden utilizar las funcionesServerSandboxExists, ServerSandboxGet y ServerSandboxListCountGet para iterarlos recintos de prueba del usuario denominado User1 y la salida de esos recintosde prueba en un archivo de texto. El proceso TurboIntegrator se ejecutaría deforma correcto para los miembros de los grupos Admin o Data Admin y para elusuario llamado User1. El proceso TurboIntegrator fallaría con un error deprivilegio para los demás usuarios.SandboxIndex = 1;NumSandboxes = ServerSandboxListCountGet( ’User1’ );

WHILE( SandboxIndex <= NumSandboxes );

SandboxName = ServerSandboxGet( SandboxIndex, ’User1’ );

IF( ServerSandboxExists( SandboxName, ’User1’ ) = 1 );

ASCIIOUTPUT( ’C:\User1Sandboxes.txt’, SandboxName );

ENDIF;

SandboxIndex = SandboxIndex + 1;

END;

ServerSandboxGetEsta función devuelve el nombre del recinto de pruebas identificado por el númeroN, donde N es el parámetro introducido.



SintaxisServerSandboxGet( index )

oServerSandboxGet( index, username)

Argumentos

El índice del recinto de pruebas solicitado de la colección de recintos de prueba delusuario. El espacio de índice será contiguo, por lo que se puede utilizar la primeraaparición de una devolución de cadena vacía para romper la iteración. Asimismo,la eliminación de un recinto de pruebas alterará los índices de cualquier recinto depruebas detrás de ese recinto en la lista.

ServerSandboxGet adopta un parámetro de serie opcional, el nombre del clientepropietario. El cliente que llama puede utilizar el parámetro opcional paraespecificar un cliente que no sea él mismo si cuenta con los privilegios adecuados.Se producirá un error de privilegio si el cliente especificado no es el clienteejecutor y el cliente ejecutor no pertenece a los grupos DataAdmin o ADMIN. Si nose utiliza el parámetro opcional, el sujeto serán los recintos de prueba del clienteactivo.

Ejemplo

Consulte “Ejemplo” en la página 300

ServerSandboxListCountGetLa función devuelve el recuento de recintos de pruebas como un número.


SintaxisServerSandboxListCountGet()

oServerSandboxListCountGet( username )

Argumentos

ServerSandboxListCountGet adopta un parámetro de serie opcional, el nombre delcliente propietario. El cliente que llama puede utilizar el parámetro opcional paraespecificar un cliente que no sea él mismo si cuenta con los privilegios adecuados.Se producirá un error de privilegio si el cliente especificado no es el clienteejecutor y el cliente ejecutor no pertenece a los grupos DataAdmin o ADMIN. Si nose utiliza el parámetro opcional, el sujeto serán los recintos de prueba del clienteactivo.

Ejemplo

Consulte “Ejemplo” en la página 300


Funciones de TurboIntegrator de seguridadEstas funciones pertenecen al ámbito de la seguridad.

AddClientEsta función crea un nuevo cliente en el servidor.


Los cambios aplicados mediante las funciones AddClient no tendrán efecto hastaque finalice el procedimiento de Metadatos de un proceso.

Esta función, al igual que todas las funciones que actualizan metadatos, no debeutilizarse en las pestañas Datos y Epílogo de un proceso

SintaxisAddClient(ClientName);


ClientName El nombre del cliente que desea añadir alservidor.

El nombre del cliente está limitado a 255caracteres/bytes.

EjemploAddClient(’Brian’);

Este ejemplo añade el cliente Brian al servidor.

AddGroupEsta función crea un nuevo grupo de usuarios en el servidor.


Los cambios aplicados mediante la función AddGroup no tendrán efecto hasta quefinalice el procedimiento de Metadatos de un proceso.


SintaxisAddGroup(GroupName);


GroupName El nombre del grupo que desea crear.


EjemploAddGroup(’Finance’);

Esta función añade el grupo de usuarios Finanza al servidor.

AssignClientToGroupEsta función asigna un cliente existente en un servidor a un grupo de usuariosexistente.

Se trata de una función de TurboIntegrator de TM1 , válida únicamente en losprocesos de TurboIntegrator. Esta función asigna un cliente existente en unservidor a un grupo de usuarios existentes.

SintaxisAssignClientToGroup(ClientName, GroupName);


ClientName El nombre del cliente que desea asignar a ungrupo.

GroupName El grupo al que desea asignar el cliente.

EjemploAssignClientToGroup(’Brian’, ’Finance’);

Este ejemplo asigna el cliente existente Brian al grupo de usuarios existenteFinanza.

AssignClientPasswordEsta función asigna una contraseña a un cliente existente de un servidor.

Se trata de una función de TM1 TurboIntegrator, válida únicamente en los procesosde TurboIntegrator. AssignClientPassword devuelve 1 si la asignación decontraseña es correcta y devuelve 0 si se produce un error en la asignación.

SintaxisAssignClientPassword (ClientName, Password);


ClientName El nombre del cliente al que desea asignaruna contraseña.

Contraseña La contraseña que desea asignar al cliente.Cuando asigne una contraseña, utilice textosin formato. TM1 cifrará la contraseña en elservidor.

Las contraseñas deben incluir cincocaracteres como mínimo.


EjemploAssignClientPassword (’Brian’, ’flyfisher’);

Este ejemplo asigna la contraseña "flyfisher" al cliente denominado Brian.

AssociateCAMIDToGroupEsta función crea una asociación entre un grupo de usuarios de TM1 y un CAMID.


SintaxisAssociateCAMIDToGroup(GroupName, CAMID, CAMIDDisplayValue);


GroupName El nombre del grupo de TM1 que deseaasociar con el CAMID.

CAMID El nombre del grupo CAMID. Si el CAMIDno existe, se creará en el cubo de controle}ClientCAMAssociatedGroups.

CAMIDDefDisplayValue El alias del grupo CAMID.

CellSecurityCubeCreateEsta función crea un cubo de seguridad a partir de un cubo existente utilizando unconjunto de dimensiones reducido.



SintaxisCellSecurityCubeCreate ('DataCube', '0:0:1:0');


Cubo Nombre del cubo de datos.

DimensionMap Cadena que especifica si la dimensión decada posición debe utilizarse en el cubo deseguridad. El orden de las dimensiones es elorden del cubo original. Un 1 para cadadimensión incluida y un 0 para unaexcluida. Cada valor está separado por dospuntos.

Devolución de booleano Verdadero si la operación ha sido correcta.Un error importante en caso contrario.



Información adicional La propiedad GrantSecurityAccess debeestablecer para este proceso TurboIntegratorpara que sea satisfactoria. Crea el cubo deseguridad de celda.

EjemploCellSecurityCubeCreate ('DataCube', '0:0:1:0');

Este ejemplo crea un cubo RDCLS a partir del cubo llamado Cubo de datos.

CellSecurityCubeDestroyEsta función destruye un cubo de seguridad que se ha creado a partir de un cuboexistente.



SintaxisCellSecurityCubeCreate ('DataCube', '0:0:1:0');


Cubo Nombre del cubo de datos.


Información adicional La propiedad GrantSecurityAccess debeestablecer para este proceso TurboIntegratorpara que sea satisfactoria. Destruye el cubode seguridad de celda.

EjemploCellSecurityCubeDestroy ('DataCube');

DeleteClientEsta función elimina un cliente del servidor.


Los cambios aplicados mediante la función DeleteClient no tendrán efecto hastaque finalice el procedimiento de Metadatos de un proceso.



SintaxisDeleteClient(ClientName);


ClientName Nombre del cliente que desea eliminar delservidor.

EjemploDeleteClient(’Brian’);

Este ejemplo elimina el cliente Brian del servidor.

DeleteGroupEsta función elimina un grupo de usuarios del servidor.


Los cambios aplicados mediante la función DeleteGroup no tendrán efecto hastaque finalice el procedimiento de Metadatos de un proceso.


SintaxisDeleteGroup(GroupName);


GroupName El grupo que desea eliminar.

EjemploDeleteGroup(’Finance’);

Este ejemplo elimina el grupo de usuarios Finanza del servidor.

ElementSecurityGetEsta función recupera el nivel de seguridad asignado a un grupo especificado deun elemento de dimensión.



SintaxisElementSecurityGet(DimName, ElName, Group);


DimName La dimensión padre del elemento para elque está recuperando un nivel de seguridad.

ElName El elemento para el que está recuperando unnivel de seguridad.

Group El grupo de usuarios del que estárecuperando un nivel de seguridad.

EjemploElementSecurityGet(’Region’. ’Germany’, ’Budgeting’);

Este ejemplo devuelve el nivel de seguridad asignado al grupo de usuariosPresupuesto para el elemento Alemania de la dimensión Región.

ElementSecurityPutEsta función asigna un nivel de seguridad a un grupo especificado para unelemento de dimensión.


SintaxisElementSecurityPut(Level, DimName, ElName, Group);


Level El nivel de seguridad que está asignando.Hay seis posibles valores de Level:

v None

v Read

v Write

v Reserve

v Lock

v Admin

DimName La dimensión padre del elemento para elque está asignando un nivel de seguridad.

ElName El elemento al que está asignando un nivelde seguridad.

Group El grupo de usuarios al que está asignandoun nivel de seguridad.


EjemploElementSecurityPut(’Reserve’, ’Region’, ’Germany’, ’Budgeting’);

Este ejemplo asigna seguridad Reserva al grupo Presupuesto para el elementoAlemania de la dimensión Región.

RemoveCAMIDAssociationEsta función elimina todas las asociaciones entre grupos de usuarios de TM1 y unCAMID especificado.


SintaxisRemoveCAMIDAssociation(CAMID, RemoveCAMID);


CAMID El nombre del grupo CAMID cuyasasociaciones de seguridad desea eliminar.

RemoveCAMID Determina si el CAMID especificado seeliminará del cubo de control}ClientCAMAssociatedGroups.

0 mantiene el CAMID en el cubo de control}ClientCAMAssociatedGroups.

1 elimina el CAMID del cubo de control}ClientCAMAssociatedGroups.

RemoveCAMIDAssociationFromGroupEsta función elimina una asociación entre un grupo de usuarios de TM1 y unCAMID.


SintaxisRemoveCAMIDAssociationFromGroup(GroupName, CAMID);


GroupName El nombre del grupo de usuarios de TM1para el que desea eliminar la asociación.

CAMID El nombre del grupo CAMID para el quedesea eliminar la asociación.

RemoveClientFromGroupEsta función elimina un cliente especificado de un grupo de usuarios.



SintaxisRemoveClientFromGroup(ClientName, GroupName);


ClientName El cliente que desea eliminar.

GroupName El grupo de usuarios del que desea eliminarel cliente.

EjemploRemoveClientFromGroup(’Brian’, ’Finance’);

Este ejemplo elimina el cliente Brian del grupo de usuarios Finanzas.

SecurityOverlayCreateGlobalDefaultEsta función se utiliza para crear o destruir un cubo de preformato de seguridad ypara establecer el preformato de un área determinada de un cubo de datos.

Tenga en cuenta que la creación de un cubo de datos con un nombre quecorresponda a un cubo de preformato hará que el cubo de datos se convierta en unpreformato si el servidor se reinicia. Cuando el cubo esté cargado, se configurarácomo preformato si se encuentra un cubo de datos coincidente.


SintaxisSecurityOverlayCreateGlobalDefault (Cube,

DimensionMap)



DimensionMap Cadena que especifica si la dimensión decada posición debe utilizarse en elpreformato. El orden de las dimensiones esel orden del cubo original. Un 1 para cadadimensión incluida y un 0 para unaexcluida. Cada valor está separado por dospuntos.


Información adicional La propiedad GrantSecurityAccess debeestablecer para este proceso TurboIntegratorpara que sea satisfactoria. Crea el cubo depreformato de seguridad globalpredeterminado. Los preformatos globales seaplican a todos los usuarios.


EjemploSecurityOverlayCreateGlobalDefault('DataCube',

'0:0:1:0');

SecurityOverlayDestroyGlobalDefaultEsta función se utiliza para destruir un cubo de preformato de seguridad y paraestablecer el preformato de un área determinada de un cubo de datos.

Tenga en cuenta que la creación de un cubo de datos con un nombre quecorresponda a un cubo de preformato hará que el cubo de datos se convierta en unpreformato si el servidor se reinicia. Cuando el cubo esté cargado, se configurarácomo preformato si se encuentra un cubo de datos coincidente.


SintaxisSecurityOverlayDestroyGlobalDefault (Cube)





EjemploSecurityOverlayDestroyGlobalDefault('DataCube');

SecurityOverlayGlobalLockNodeEsta función se utiliza para restringir los derechos de acceso de un nodo a sólolectura mediante el bloqueo. Utiliza el preformato global para incluir a todos losusuarios. El cubo de preformato debe crearse antes de utilizar este comando. Loselementos proporcionados en la dirección deben ser solamente para lasdimensiones utilizadas en el preformato.


SintaxisSecurityOverlayGlobalLockNode(bLock, Cube, Address, [AddressDelimiter]))


bLockSi es 1, se bloquea. Con 0 se desbloquea.



CubeNombre del cubo.

AddressSecuencia de cadenas con señales denombres de elementos de preformato quedefinen la tupla. El orden debe coincidir conel orden original de las dimensiones delcubo.

Devolución de direcciónCadena de caracteres opcional utilizada paraseparar los nombres de elementos en

el parámetro Address. El valorpredeterminado es ‘|’.



EjemplosSecurityOverlayGlobalLockNode(1,'Sales','MA');

SecurityOverlayGlobalLockNode(0,'Products','MA | 2011');SecurityOverlayGlobalLockNode(0,'Products', 'MA : 2011', ':');

En el primer ejemplo solamente hay una dimensión que se utilice para elpreformato. En los otros dos ejemplos se utilizan dos dimensiones.

SecurityRefreshEsta función lee todos los cubos de control de seguridad y vuelve a generar lasestructuras internas en el servidor que utilizan las funciones API de TM1 .


SintaxisSecurityRefresh;

Argumentos

Ninguno.

Funciones de TurboIntegrator de manipulación de servidoresEstas funciones facilitan la manipulación de servidores.


BatchUpdateFinishEsta función ordena al servidor que salga del modo de actualización por lotes.


Cuando se ejecutan varios procesos en el modo de actualización por lotes y aplicancambios en un único cubo, el esquema de bloqueo de TM1 puede impedir que unode los procesos actualice el cubo. Esto se realiza de forma predeterminada; cuandoun proceso obtiene un bloqueo para escribir cambios en un cubo, se impedirá queotros procesos escriban en dicho cubo para conservar la integridad de los datos.

Este esquema de bloqueo puede ilustrarse utilizando un ejemplo de dos procesos,Proceso1 y Proceso 2, que actualizan un único cubo.v Ambos procesos se inician y llaman a la función BatchUpdateStart para iniciar

actualizaciones por lotes.v Cada proceso funciona en un único origen de datos.v Proceso 1 finaliza el procesamiento de datos y llama a la función

BatchUpdateFinish. El proceso obtiene un bloqueo de escritura en el cubo yrealiza cambios.

v Mientras que Proceso 1 aún retiene un bloqueo de escritura en el cubo, Proceso 2finaliza el procesamiento de datos y llama a la función BatchUpdateFinish. Sinembargo, dado que Proceso 1 retiene el bloqueo, Proceso 2 no puede obtener unbloqueo para el cubo. Todos los cambios de datos aplicados en Proceso 2 sedeshacen y se reinicia Proceso 2. Esto garantiza la integridad de los datos.

Sintaxis


En función del tamaño del origen de datos de Proceso 2, la acción de retrotraerdatos y volver a ejecutar el proceso puede provocar una importante reducción delrendimiento. Para hacer frente a este problema de rendimiento, puede utilizar lafunción BatchUpdateFinishWait en vez de BatchUpdateFinish.BatchUpdateFinish(SaveChanges);


SaveChanges Un distintivo que ordena al servidor queguarde o descarte cambios realizados en elmodo de actualización por lotes.

Especifique 0 para guardar los cambios, 1para descartar los cambios.

EjemploBatchUpdateFinish(0);

Este ejemplo ordena al servidor que guarde los cambios de los datos TM1 y salgadel modo de actualización por lotes.

BatchUpdateFinishWaitSi un proceso llama a BatchUpdateFinishWait, pero es incapaz de proteger unbloqueo de escritura de un cubo para realizar cambios, el proceso esperará hastaque el bloqueo esté disponible y, a continuación, realizará los cambios.


Esta función de TurboIntegrator es idéntica a la función BatchUpdateFinish con lasiguiente excepción: el proceso esperará hasta que el bloqueo esté disponible y, acontinuación, realizará los cambios.

No se deshacen los cambios de los datos aplicados en el proceso ni se vuelve aejecutar el proceso.

Nota: mientras está a la espera del bloqueo de escritura del cubo, el proceso liberalos bloqueos de lectura que adquirió para otros objetos durante la ejecución delproceso. Dado que estos bloqueos de lectura se liberan antes de que el procesopueda realizar cambios en el cubo, los objetos para los que se liberan los bloqueosde lectura pueden modificarse antes de que se actualice el cubo. Esto puedeoriginar inconsistencia en los datos al utilizar BatchUpdateFinishWait.

Le recomendamos que utilice BatchUpdateFinishWait solamente en situacionescontroladas en las que sabe que otros procesos no están modificando datos nimetadatos relacionados con el proceso que llama a BatchUpdateFinishWait.


SintaxisBatchUpdateFinishWait(SaveChanges);


SaveChanges Un distintivo que ordena al servidor queguarde o descarte cambios realizados en elmodo de actualización por lotes. Especifique0 para guardar los cambios, 1 para descartarlos cambios.

EjemploBatchUpdateFinishWait(0);

Este ejemplo ordena al servidor que guarde los cambios de los datos TM1 y salgadel modo de actualización por lotes.

BatchUpdateStartEsta función permite actualizaciones por lotes.


SintaxisBatchUpdateStart;

Argumentos

Ninguno.

CubeSaveDataCubeSaveData() serializa un cubo.

Sintaxis


Para mejorar el rendimiento, se puede inhabilitar el registro de transaccionesdurante la carga de datos. Para proteger los datos cargados recientemente en elcaso improbable de que se produzca un bloqueo del servidor, se pueden serializarlos cambios en disco. SaveDataAll se ha utilizado para serializar datos en disco ypara truncar el registro de transacciones. Cuando se procesa un comandoSaveDataAll, el servidor adquiere un bloqueo de lectura en cada cubo y unbloqueo IX en cada cubo modificado. Esto puede generar una contenciónimportante de la actividad de usuario, si se ejecuta SaveDataAll durante periodosde actividad del usuario.

Generalmente, no es necesario que se serialicen todos los cubos afectados porSaveDataAll ya que normalmente se cargan con datos nuevos. CubeSaveData seutiliza para serializar un cubo individual en disco. CubeSaveData serializa los


datos del cubo que se han confirmado en la memoria, incluidas las modificacionesrealizadas en el mismo durante el proceso TurboIntegrator actual que todavía no sehan confirmado.CubeSaveData(Cube);


Cubo El nombre del cubo que desea serializar.

EjemploCubeSaveData (’SalesCube’);

Tenga en cuenta el siguiente código de proceso de TurboIntegrator:CellPutN(500, ’y2ksales’, ’Actual’, ’Argentina’, ’S Series 1.8 L Wagon’, ’Sales’, ’Jan’);

CubeSaveData(’y2ksales’);

CellPutN(1000, ’y2ksales’, ’Actual’, ’Argentina’, ’S Series 1.8 L Wagon’, ’Sales’, ’Jan’);

Cuando se procesa el comando CubeSaveData, el valor de 500 para la celda deventas de enero se incluirá en la serialización del cubo en disco, aunque todavía nose haya confirmado. La actualización de la celda de ventas de Enero a 1000 noformará parte de la serialización.

Registro de transacciones

Cuando se ejecuta CubeSaveData aparece una entrada nueva en el registro detransacciones. Cuando se procesa un archivo de registro de transacciones durantela recuperación, todas las actualizaciones de un cubo que se hayan aplicado hastael momento se descartarán cuando se encuentre una directiva CubeSaveData parael cubo, puesto que todas las actualizaciones ya se habrán serializado en el cubo.

Recuperación de bloqueos del servidor

El comando SaveDataAll se beneficia del hecho que durante su procesamientotodos los cubos estén bloqueados y trunca el registro de transacciones sabiendoque todas las actualizaciones realizadas antes de la serialización se han guardadocorrectamente en el disco. Este no es el caso de CubeSaveData, por lo tanto, debemodificar el modo en que se realiza la recuperación de datos cuando se haserializado un cubo.

El archivo de registro de transacciones puede contener registros que representancambios más antiguos que los datos más recientes del cubo y no se debe aplicarcuando se están recuperando los datos.

DisableBulkLoadModeSe utiliza para inhabilitar el procesamiento de carga de gran volumen.

Se trata de una función de TM1 TurboIntegrator, válida únicamente en los procesosde TurboIntegrator. Para obtener más información, consulte“EnableBulkLoadMode”.

EnableBulkLoadModeHabilita el modo de carga de gran volumen para un proceso de TurboIntegrator.



Puede habilitar el modo de carga de gran volumen en las secciones Prólogo oEpílogo de un proceso de TurboIntegrator. Para una mayor eficacia, habilite elmodo de carga de gran volumen en la primera sentencia, o muy cerca de ella, dela sección Prólogo del proceso.

Tras habilitar el modo de carga de gran volumen en un proceso, solo se podráinhabilitar en la última línea de la sección Epílogo. Si trata de deshabilitar el modode carga de gran volumen en cualquier otro punto del proceso, éste no compilará.

Si se habilita el modo de carga de gran volumen en un proceso de TurboIntegrator,continuará habilitado hasta que se desactive explícitamente o hasta que la tareafinalice. Esto significa que puede habilitar el modo en un proceso de una tarea y, acontinuación, ejecutar una serie de procesos de TurboIntegrator antes deinhabilitarlo. También puede entrar y salir del modo de carga de gran volumenrepetidas veces, utilizándolo solo para determinados puntos importantes de unatarea.

Utilice los siguientes comandos TurboIntegrator para habilitar y deshabilitar elmodo de carga de gran volumen en un proceso de TurboIntegrator.

EnableBulkLoadMode()

DisableBulkLoadMode(): esta función solo se puede utilizar en la última línea de lasección Epílogo del proceso de TI al utilizar el modo de carga de gran volumen.

SaveDataAllEsta función guarda todos los datos TM1 de la memoria del servidor en el disco yreinicia el archivo de registro.


Utilización de SaveDataAll en una tarea

SaveDataAll realiza todos los cambios que una tarea establece antes de llamar a lafunción SaveDataAll.

Mientras se ejecuta una tarea, acumula bloqueos en los objetos a los que accede. Laoperación iniciada por la función SaveDataAll libera temporalmente todos estosbloqueos. Una vez que se realiza esta operación, SaveDataAll vuelve a adquirirtodos los bloqueos con los que contaba para poder seguir accediendo a los objetoscon los que estaba trabajando.

Durante esta operación aparece una breve ventana en la que se liberan losbloqueos y otro usuario o proceso TurboIntegrator puede eliminar objetos que latarea original estaba utilizando. Cuando la tarea original trate de volver a adquirirlos bloqueos de estos objetos, los objetos no estarán disponibles y la tareainterrumpirá el procesamiento. En este caso, se escribe un error similar al queaparece a continuación en el archivo Tm1s.log:844 WARN 2008-04-01 16:40:09,734 TM1.Server TM1ServerImpl::FileSavecouldnot reacquire lock on object with index 0x200002ca


Contención de bloqueo y utilización de SaveDataAll al finalizarprocesos de TurboIntegrator

Utilizar SaveDataAll como último comando en un proceso de TurboIntegratorpuede aumentar la contención de bloqueo en procesos de TM1 TurboIntegrator.

En versiones de IBM Cognos TM1 , SaveDataAll se añadía a menudo al final de unproceso de TurboIntegrator que cargaba datos con el registro inhabilitado.SaveDataAll proporcionaba un modo de escribir datos de la memoria al discodirectamente tras una importación satisfactoria, de modo que los datos reciénimportados no se perdieran en caso de percances, como la terminación anormal deun servidor.

Sin embargo, añadir SaveDataAll como último comando puede provocarnumerosos procesos de importación de TurboIntegrator, cada uno con SaveDataAllcomo último comando. Esta técnica funcionaba en TM1 Versión 9.0 y anterioresdebido al modelo de bloqueo anterior, que utilizaba únicamente el bloqueo deescritura global. En un momento dado en las versiones anteriores, sólo unaoperación de escritura podría tener lugar. Por tanto, las operaciones SaveDataAllsimultáneas nunca resultaban de varias operaciones de escritura simultáneas.

En la versión 9.1 y posteriores se presentó un modelo de bloqueo por objeto másdetallado que permite operaciones de escritura simultáneas, siempre que estasoperaciones de escritura no compitan por los mismos recursos. Si compiten por losmismos recursos, se impone una contención de bloqueo, que obliga a que uno delos procesos se retrotraiga. Así, ahora dos procesos de importación deTurboIntegrator pueden ejecutarse simultáneamente si no comparten objetos; porejemplo, si realizan una importación en dos cubos diferentes.

La función SaveDataAll de TurboIntegrator depende del archivo de registro detransacciones tm1s.log e implica a todos los objetos del modelo de datos. Por tanto,dos procesos de importación de TurboIntegrator que utilicen por igual la funciónSaveDataAll, no pueden ejecutarse en paralelo: uno se ejecutará, mientras que seobligará a retrotraer al otro (y su proceso de TurboIntegrator). Lo mismo se aplicasi los procesos de TurboIntegrator forman parte de tareas: sólo una tarea podráejecutar la función SaveDataAll de TurboIntegrator, mientras que la otra tarea severá obligada a retrotraerse.

Una retrotracción no es deseable desde el punto de vista del rendimiento, puestoque aumenta el tiempo total de ejecución de un proceso o una tarea deTurboIntegrator. Las operaciones simultáneas de SaveDataAll que compitan entreellas siempre provocarán un bloqueo de contención y una retrotracción.

Existen dos posibles soluciones para evitar operaciones simultáneas de SaveDataAllque compitan entre ellas:v No utilizar la función SaveDataAll de TurboIntegrator. En su lugar, habilite el

registro de cubos para los cubos de importación.v Si por motivos de rendimiento no se puede habilitar el registro de cubos para

los cubos de importación, en la aplicación TM1 sólo debería haber un procesoque llamara a la función SaveDataAll de TurboIntegrator. Utilice una tareaautónoma, única y diferenciada para ejecutar la operación SaveDataAll.

SintaxisSaveDataAll;


Argumentos

Ninguno.

ServerShutdownEsta función apaga un servidor que se ejecuta como una aplicación.ServerShutdown no puede utilizarse para apagar un servidor que se ejecuta comoun servicio de Windows.


SintaxisServerShutDown(SaveData);


SaveData Un valor booleano que indica si el servidordebe guardar los cambios en el disco antesde apagarse.

Si SaveData = 0, el servidor se apaga singuardar los cambios.

Si SaveData = 1, el servidor guarda loscambios de la memoria en el disco antes deapagarse.

EjemploServerShutdown(1);

Este ejemplo apaga el servidor y guarda los datos en disco.

Funciones de TurboIntegrator de manipulación de subconjuntosEstas funciones facilitan la manipulación de subconjuntos.

SubsetAliasSetEsta función establece el atributo de alias que se utilizará en un subconjunto.


SubsetAliasSet devuelve 1 si es correcto; de lo contrario, devuelve 0.

SintaxisSubsetAliasSet( DimName, SubName, AliasName );


DimName La dimensión padre del subconjunto para elque desea establecer el alias.



SubName El subconjunto para el que desea establecerel alias.

Aliasname El alias que desea utilizar en el subconjunto.

SubsetCreateEsta función crea un subconjunto público vacío de una determinada dimensión.


SintaxisSubsetCreate(DimName, SubName);


DimName La dimensión padre del subconjunto queestá creando.

SubName El nombre que desea asignar al subconjunto.

EjemploSubsetCreate(’Region’, ’Northern Europe’);

Este ejemplo crea el subconjunto vacío Europa del Norte de la dimensión Región.Puede utilizar SubsetElementInsert para añadir elementos al subconjunto.

SubsetCreateByMDXEsta función crea un subconjunto público basado en una expresión MDX pasada.


SintaxisSubsetCreatebyMDX(SubName, MDX_Expression);


SubName El nombre que desea asignar al subconjunto.

MDX_Expression Una expresión MDX que devuelve unsubconjunto.

EjemploSubsetCreatebyMDX(’0-level months’, ’{TM1SORT( {TM1FILTERBYLEVEL( {TM1SUBSETALL([month] )}, 0)}, ASC)} ’ );


Este ejemplo crea un subconjunto público denominado "meses de nivel 0" basadoen una expresión MDX que devuelve un subconjunto formado por todos loselementos de nivel 0 de la dimensión Mes, clasificados en orden alfabéticoascendente.

SubsetDeleteAllElementsEsta función elimina todos los elementos de un subconjunto público.


SintaxisSubsetDeleteAllElements(DimName, SubsetName);


DimName La dimensión padre del subconjunto del quedesea eliminar elementos.

SubsetName El subconjunto del que desea eliminarelementos. Debe ser un subconjunto público.TurboIntegrator no puede acceder a objetosprivados.

EjemploSubsetDeleteAllElements(’Region’, ’Central Europe’);

Este ejemplo elimina todos los elementos del subconjunto Europa Central de ladimensión Región.

SubsetDestroyEsta función elimina un subconjunto de la base de datos TM1 .


SintaxisSubsetDestroy(DimName, SubName);


DimName La dimensión padre del subconjunto queestá eliminando.

SubName El nombre del subconjunto que deseaeliminar.

EjemploSubsetDestroy(’Region’, ’Northern Europe’);

Este ejemplo elimina el subconjunto Europa del Norte de la dimensión Región.


SubsetElementDeleteEsta función elimina un elemento de un subconjunto.


SintaxisSubsetElementDelete(DimName, SubName, Index);


DimName La dimensión padre del subconjunto del quedesea eliminar un elemento.

SubName El subconjunto del que desea eliminar unelemento.

Index El número de índice del elemento que deseaeliminar del subconjunto.

EjemploSubsetElementDelete(’Region’, ’Northern Europe’, 3);

Este ejemplo suprime el tercer elemento del subconjunto Northern Europe de ladimensión Region.

SubsetElementInsertEsta función añade un elemento a un subconjunto existente.


SintaxisSubsetElementInsert(DimName, SubName, ElName, Position);


DimName La dimensión padre del subconjunto al quedesea añadir un elemento.

SubName El nombre del subconjunto al que estáañadiendo un elemento.

ElName El nombre del elemento que desea añadir alsubconjunto. El elemento debe existir en labase de datos TM1 .

Position Un valor que indica la posición de índice delelemento dentro del subconjunto.

EjemploSubsetElementInsert(’Region’, ’Northern Europe’, ’Finland’,3);


Este ejemplo añade el elemento Finlandia al subconjunto Europa del Norte de ladimensión Región. Finlandia es el tercer elemento de la definición de subconjunto.

SubsetExistsUtilice SubsetExists para determinar si un subconjunto público específico existe enel servidor desde el que se ejecuta un proceso TurboIntegrator.


La función devuelve 1 si el subconjunto existe en el servidor; de lo contrario,devuelve 0. Tenga en cuenta que esta función no se puede utilizar para determinarla existencia de subconjuntos privados.

SintaxisSubsetExists(DimName, SubsetName);


DimName El nombre de la dimensión que es el padredel subconjunto cuya existencia deseaconfirmar.

SubsetName El nombre del subconjunto público cuyaexistencia desea confirmar

EjemploSubsetExists(’Region’, ’Northern Europe’);

Este ejemplo determina si el subconjunto Europa del Norte del cubo Región existeen el servidor.

SubsetExpandAboveSetEsta función configura la propiedad Expand Above de un subconjunto.


Cuando esta propiedad está configurada como TRUE, los hijos de unaconsolidación aparecen encima de la consolidación cuando la consolidación apareceen una fila, y a la izquierda de la consolidación cuando la consolidación aparece enuna columna.

La función devuelve 1 si es correcta; de lo contrario, devuelve 0.

SintaxisSubsetExpandAboveSet( DimName, SubsetName, ExpandAboveFlag);



DimName La dimensión padre del subconjunto para elque desea configurar la propiedad ExpandAbove.

SubsetName El subconjunto para el que desea configurarla propiedad Expand Above.

ExpandAboveFlag Defina ExpandAboveFlag como 1 paraconfigurar la propiedad Expand Abovecomo TRUE. Cuando esta propiedad esTRUE; las consolidaciones se despliegan porencima de las filas y a la izquierda de lascolumnas.

Defina ExpandAboveFlag como 0 paraconfigurar la propiedad Expand Abovecomo FALSE. Cuando esta propiedad esFALSE, las consolidaciones se desplieganpor debajo de las filas y a la derecha de lascolumnas.

EjemploSubsetExpandAboveSet(’Region’, ’Europe’, 1 );

Este ejemplo configura la propiedad Expand Above como TRUE para elsubconjunto Europa de la dimensión Región.

SubsetFormatStyleSetEsta función aplica un estilo de visualización existente a un subconjunto connombre.


Los estilos de visualización se definen para elementos específicos. Si aplica unestilo de visualización existente a un subconjunto que incluye elementos que no seincluyen en el estilo de visualización, no se aplicará formateo a dichos elementos.

SintaxisSubsetFormatStyleSet( DimName, SubsetName, FormatName);


DimName La dimensión padre del subconjunto al quedesea aplicar un estilo de visualización.

SubsetName El nombre del subconjunto al que estáaplicando un estilo de visualización.

FormatName El nombre del estilo de visualizaciónexistente que desea aplicar al subconjunto.


EjemploSubsetFormatStyleSet (’Region’, ’Northern Europe’, ’BoldCurrencyLeftJustified’);

Este ejemplo aplica el estilo de visualización BoldCurrencyLeftJustified alsubconjunto Europa del Norte de la dimensión Región.

SubsetGetElementNameEsta función devuelve el nombre del elemento en una ubicación de índiceespecificada dentro de un determinado subconjunto.


SintaxisSubsetGetElementName(DimName, SubsetName, ElementIndex);


DimName El padre del subconjunto del que desearecuperar un nombre de elemento.

SubsetName El subconjunto del que desea recuperar unnombre de elemento.

ElementIndex Un número que representa la posicióndentro del subconjunto del elemento quedesea recuperar.

EjemploSubsetGetElementName(’Region’, ’Americas’, 4);

Este ejemplo devuelve el nombre del cuarto elemento del subconjunto América dela dimensión Región.

SubsetGetSizeEsta función devuelve el número de elementos de un subconjunto.


SintaxisSubsetGetSize(DimName, SubsetName);


DimName La dimensión padre del subconjunto cuyotamaño desea determinar.

SubsetName El subconjunto cuyo tamaño deseadeterminar.


EjemploSubsetGetSize(’Region’, ’EurAsia’);

Esta función devuelve el número de elementos del subconjunto EurAsia de ladimensión Región.

SubsetIsAllSetEsta función establece un subconjunto para utilizar todos los elementos de ladimensión padre.


Equivale a pulsar en el Editor de subconjuntos. SubsetIsAllSet devuelve 1 si escorrecto; de lo contrario, devuelve 0.

SintaxisSubsetIsAllSet( DimName, SubName, Flag );


DimName La dimensión padre del subconjunto del quedesea utilizar todos los elementos.

SubName El subconjunto del que desea utilizar todoslos elementos de la dimensión.

Flag Cualquier valor que no sea cero especificaque el subconjunto utiliza todos loselementos actuales de la dimensión padre yque se actualizará dinámicamente parautilizar todos los elementos de la dimensiónpadre siempre que se llame al subconjunto.

La especificación de un valor ceroinmoviliza los elementos del subconjuntocomo conjunto actual de todos los elementosde la dimensión padre. El subconjunto no seactualizará dinámicamente para utilizartodos los elementos de la dimensión en elfuturo.

Funciones de TurboIntegrator de manipulación de vistasEstas funciones pertenecen a la manipulación de vistas.

PublishViewEsta función publica una vista privada con nombre en el servidor.



SintaxisPublishView(Cube, View, PublishPrivateSubsets, OverwriteExistingView);


Cube El nombre del cubo que contiene la vistaprivada que se publicará.

View El nombre de la vista privada que sepublicará.

PublishPrivateSubsets Este argumento booleano (1 o 0) determinasi también debe publicarse algúnsubconjunto privado presente en la vista.

Si PublishPrivateSubsets es true (1), todoslos subconjuntos privados utilizados en lavista se publican junto con la vista.

Si este argumento es false (0), lossubconjuntos privados no se publican. Unavista pública no puede contenersubconjuntos privados, de modo que la vistano se publicará y se escribirá un error en elarchivo de registro de TurboIntegrator.Nota: Si un subconjunto privado contieneotro subconjunto privado comoconsolidación definida por el usuario, elsubconjunto nunca podrá publicarseutilizando la función PublishView,independientemente del valor del argumentoPublishPrivateSubsets.

OverwriteExistingView Este argumento booleano (1 o 0) determinasi debe sobrescribirse alguna vista públicaexistente con el mismo nombre cuando sepublique la vista privada.

Si OverwriteExistingView es true (1),cualquier vista pública existente con elmismo nombre se sobrescribirá cuando sepublique la vista privada.

Si este argumento es false (0), la vistapública no se sobrescribirá, la vista privadano se publicará y se escribirá un error en elarchivo de registro de TurboIntegrator.

ViewColumnDimensionSetEsta función establece una dimensión de columna de una vista TM1 .



SintaxisViewColumnDimensionSet(CubeName, ViewName, DimName, StackPosition);


CubeName El cubo padre de la vista para la que estáestableciendo la dimensión de columnas.

ViewName La vista para la que está estableciendo ladimensión de columna.

DimName La dimensión que desea establecer comodimensión de columna para la vista.

StackPosition Un número que indica la posición de pila dela dimensión en la vista. Se trata de unnúmero basado en 1. 1 indica la posición depila más alta. 2 indica una posición inferiora 1, etc.

EjemploViewColumnDimensionSet(’98sales’, ’Quarter1’, ’Month’,1);

Este ejemplo establece Mes como una dimensión de columna para la vistaTrimestre1 del cubo ventas98. En el caso de que aparezcan dimensiones decolumnas apiladas, Mes se coloca en la posición más alta.

ViewColumnSuppressZeroesSetEsta función suprime o permite la visualización de columnas que contienenúnicamente valores cero en una vista de cubos TM1 .


SintaxisViewColumnSuppressZeroesSet(Cube, ViewName, Flag);


Cubo El cubo padre de la vista para la que deseasuprimir o permitir la visualización devalores cero.

ViewName La vista para la que desea permitir osuprimir la visualización de ceros.

Flag Un valor binario que permite o suprimeceros. Especifique 1 para suprimir lavisualización de columnas que contenganúnicamente ceros en la vista. Especifique 0para permitir la visualización de columnasque contengan únicamente ceros.


EjemploViewColumnSuppressZeroesSet(’99sales’, ’1st QuarterActuals’, 1);

Este ejemplo suprime la visualización de las columnas que contengan únicamenteceros en la vista Valores reales 1er trimestre del cubo ventas99.

ViewConstructEsta función construye, calcula previamente y almacena una vista Stargate en lamemoria de un servidor.


Esta función resulta útil para el cálculo previo y el almacenamiento de vistasgrandes, de modo que se pueda acceder a ellas rápidamente tras una actualizacióno carga de datos.

SintaxisViewConstruct(CubeName, ViewName);


CubeName El cubo desde el que desea construir la vista.

ViewName La vista que desea construir. Esta vista debeser una vista pública existente en el servidor.

EjemploViewconstruct(’99sales’, ’1st Quarter Actuals’)

Este ejemplo suprime el tercer elemento del subconjunto Northern Europe de ladimensión Region.

ViewCreateEsta función crea una vista vacía de un cubo especificado.


Nota: Si desea realizar una operación de réplica o sincronización después deutilizar la función ViewCreate en un proceso de TI, utilice la función SaveDataAlldel procedimiento Epílogo del proceso para asegurarse de que la vistarecientemente creada está disponible para la réplica. Estos pasos se aplicanúnicamente al utilizar la función ViewCreate antes de una operación de réplica osincronización.

SintaxisViewCreate(Cube, ViewName);


Cube El cubo padre de la vista que está creando.



ViewName El nombre que desea asignar a la vista.

EjemploViewCreate(’99sales’, ’1st Quarter Actuals’);

ViewDestroyEsta función elimina una vista de la base de datos TM1 .


SintaxisViewDestroy(Cube, ViewName);


Cube El cubo padre de la vista que estáeliminando.

ViewName El nombre de la vista que desea eliminar.

EjemploViewDestroy(’99sales’, ’1st Quarter Actuals’);

Este ejemplo elimina la vista Valores reales 1er trimestre del cubo ventas99.

ViewExistsUtilice ViewExists para determinar si una vista pública específica existe en elservidor desde el que se ejecuta un proceso TurboIntegrator.


La función devuelve 1 si la vista existe en el servidor; de lo contrario, devuelve 0.Tenga en cuenta que esta función no se puede utilizar para determinar la existenciade vistas privadas.

SintaxisViewExists(CubeName, ViewName);


CubeName El nombre del cubo que es el padre de lavista cuya existencia desea confirmar.

ViewName El nombre de la vista pública cuya existenciadesea confirmar


EjemploViewExists(’Inventory’, ’FebClosing’);

Este ejemplo determina si la vista Cierrefeb del cubo Inventario existe en elservidor.

ViewExtractSkipCalcsSetEsta función establece una opción para incluir/excluir valores consolidados en unavista y cualquier extracción de vista asociada.


Una extracción de vistas es una vista de TM1 exportada como un archivo ASCIIseparado por comas (.cma).

Nota: Esta función afecta a las vistas según existen en el servidor. El ámbito deesta función no se limita a extractos generados a partir de una vista.

ViewExtractSkipCalcsSet equivale a la opción Omitir valores consolidados delcuadro de diálogo Extracción de vistas.

SintaxisViewExtractSkipCalcsSet (Cube, ViewName, Flag);


Cube El cubo padre de la vista para la que estáestableciendo la opción.

ViewName La vista para la que está estableciendo laopción.

Flag Un valor binario que activa o desactiva laopción. Especifique 1 para excluir valoresconsolidados de la extracción de vistas.Especifique 0 para incluir valoresconsolidados.

EjemploViewExtractSkipCalcsSet (’99sales’, ’1st Quarter Actuals’,1);

Este ejemplo activa la opción Omitir valores consolidados de la vista Valores reales1er trimestre. La extracción de vistas no incluirá valores consolidados.

ViewExtractSkipRuleValuesSetEsta función establece una opción para incluir/excluir valores calculados medianteregla en una vista y cualquier extracción de vista asociada.





ViewExtractSkipRuleValuesSet equivale a la opción Omitir valores calculadossegún reglas del cuadro de diálogo Extracción de vistas.

SintaxisViewExtractSkipRuleValuesSet (Cube, ViewName, Flag);


Cube El cubo padre de la vista para la que estáestableciendo la opción.

ViewName La vista para la que está estableciendo laopción.

Flag Un valor binario que activa o desactiva laopción. Especifique 1 para excluir valorescalculados según reglas de la extracción.Especifique 0 para incluir valores calculadossegún reglas.

EjemploViewExtractSkipRuleValuesSet (’99sales’, ’1st QuarterActuals’, 1);

Este ejemplo activa la opción Omitir valores calculados según reglas para laextracción creada a partir de la vista Valores reales 1er trimestre. La extracción noincluirá valores calculados según reglas.

ViewExtractSkipZeroesSetEsta función establece una opción para incluir/excluir valores cero en una vista ycualquier extracción de vista asociada.




ViewExtractSkipZeroesSet equivale a la opción Omitir valores cero/en blanco delcuadro de diálogo Extracción de vistas.


SintaxisViewExtractSkipZeroesSet (Cube, ViewName, Flag);


Cube El cubo padre de la vista para la que estáestableciendo la opción Omitir ceros.

ViewName La vista para la que está estableciendo laopción Omitir ceros.

Flag Un valor binario que activa o desactiva laopción. Especifique 1 para excluir ceros de laextracción. Especifique 0 para incluir ceros.

EjemploViewExtractSkipZeroesSet (’99sales’, ’1st Quarter Actuals’,1);

Este ejemplo activa la opción Omitir ceros para la extracción creada a partir de lavista Valores reales 1er trimestre. La extracción no incluirá valores en blanco niceros.

ViewRowDimensionSetEsta función establece una dimensión de fila de una vista TM1 .


SintaxisViewRowDimensionSet(CubeName, ViewName, DimName, StackPosition);


CubeName El cubo padre de la vista para la que estáestableciendo la dimensión de fila.

ViewName La vista para la que está estableciendo ladimensión de fila.

DimName La dimensión que desea establecer comodimensión de fila para la vista.



StackPosition Un número que indica la posición de pila dela dimensión en la vista. Se trata de unnúmero basado en 1. 1 indica la posición depila más a la izquierda. 2 indica unaposición a la derecha de 1, etc.Nota: Un cliente TM1 puede establecer unparámetro Tm1p.ini(BrowseDisplayReadsRightToLeft=T) queinvierta la orientación de los datos en CubeViewer. Cuando se invierte la orientación delos datos, se invierten también las posicionesde la pila. 1 indica la posición de pila más ala derecha. 2 indica una posición a laizquierda de 1, etc.

EjemploViewRowDimensionSet(’98sales’, ’Quarter1’, ’Month’,1)

Este ejemplo establece Mes como dimensión de fila para la vista Trimestre1 delcubo ventas98. En el caso de que aparezcan dimensiones de filas apiladas, Monthse coloca en la posición más a la izquierda.

ViewRowSuppressZeroesSetEsta función suprime o permite la visualización de filas que contienen únicamentevalores cero en una vista de cubos TM1 .


SintaxisViewRowSuppressZeroesSet(Cube, ViewName, Flag);


Cubo El cubo padre de la vista para la que deseasuprimir o permitir la visualización devalores cero.


Flag Un valor binario que permite o suprimeceros. Especifique 1 para suprimir lavisualización de filas que contienenúnicamente ceros en la vista. Especifique 0para permitir la visualización de filas quecontienen únicamente ceros.

EjemploViewRowSuppressZeroesSet(’99sales’, ’1st Quarter Actuals’,1);


Este ejemplo suprime la visualización de las filas que contengan únicamente cerosen la vista Valores reales 1er trimestre del cubo ventas99.

ViewSubsetAssignEsta función asigna un subconjunto con nombre a una vista de cubos.


SintaxisViewSubsetAssign(Cube, ViewName, DimName, SubName);


Cube El cubo padre de la vista a la que estáasignando un subconjunto.

ViewName La vista a la que está asignando unsubconjunto.

DimName La dimensión padre del subconjunto queestá asignando a la vista.

SubName El nombre del subconjunto que deseaasignar a la vista.

EjemploViewSubsetAssign(’99sales’, ’1st Quarter Actuals’, ’Month’,’Q1’);

Este ejemplo asigna el subconjunto T1 de la dimensión Mes a la vista 1er trimestre.

ViewSuppressZeroesSetEsta función suprime o permite la visualización de todas las filas y columnas quecontienen únicamente valores cero en una vista de cubos TM1 .


SintaxisViewSuppressZeroesSet(Cube, ViewName, Flag);


Cube El cubo padre de la vista para la que deseasuprimir o permitir la visualización devalores cero.




Flag Un valor binario que permite o suprimeceros. Especifique 1 para suprimir lavisualización de filas o columnas quecontengan únicamente ceros en la vista.Especifique 0 para permitir la visualizaciónde filas y columnas que contenganúnicamente ceros.

EjemploViewSuppressZeroesSet(’99sales’, ’1st Quarter Actuals’,1);

Este ejemplo suprime la visualización de las filas o columnas que contenganúnicamente ceros en la vista Valores reales 1er trimestre del cubo ventas99.

ViewTitleDimensionSetEsta función establece una dimensión de título de una vista TM1 .


SintaxisViewTitleDimensionSet(CubeName, ViewName, DimName);


CubeName El cubo padre de la vista para la que estáestableciendo la dimensión de título.

ViewName La vista para la que está estableciendo ladimensión de título.

DimName La dimensión que desea establecer comodimensión de título para la vista.

EjemploViewTitleDimensionSet(’98sales’, ’Quarter1’, ’Month’);

Este ejemplo establece Mes como dimensión de título para la vista Trimestre1 delcubo ventas98.

ViewTitleElementSetEsta función establece un elemento de título de una vista TM1 .


ViewTitleElementSet se utiliza de forma conjunta con la funciónViewTitleDimensionSet.


SintaxisViewTitleElementSet(CubeName, ViewName, DimName, Index);


CubeName El cubo padre de la vista para la que estáestableciendo el elemento de título.

ViewName La vista para la que está estableciendo elelemento de título.

DimName La dimensión padre del elemento de título.

Index Un índice en la dimensión especificada queindica el elemento que se establecerá comoelemento de título.

EjemploViewTitleElementSet(’98sales’, ’Quarter1’, ’Model’,3);

Este ejemplo establece el tercer elemento de la dimensión Modelo como elementode título de la vista Trimestre1 del cubo ventas98.

ViewZeroOutEsta función define como cero todos los puntos de datos de una vista.


SintaxisViewZeroOut(Cube, ViewName);


Cube El cubo padre de la vista que desea poner acero.

ViewName La vista que desea poner a cero.

EjemploViewZeroOut(’99sales’, ’1st Quarter Actuals’);

Este ejemplo establece todos los puntos de datos de Valores reales 1er trimestre encero.

Otras funciones de TurboIntegratorEstas funciones facilitan otras tareas.


AddInfoCubeRestrictionEsta función de TurboIntegrator filtra los datos del InfoCube a medida que seintroducen en TM1 .

Utilice esta función para limitar los valores que se importan para una característicaespecífica. Esta función debe colocarse en el Prólogo. La función puede llamarsevarias veces para filtrar más de una característica en un único proceso.

SintaxisAddInfoCubeRestriction(STRING CharactName, STRING sign,STRING compOperator,STRING lowValue, STRING highValue)


STRING CharactName Contiene el nombre técnico de lacaracterística que se va a limitar. El tipo dedatos debe ser una cadena de caracteres conuna longitud igual o inferior a 30.

STRING sign Contiene I (= inclusivo) o E (= exclusivo).Exclusivo es la función NOT lógica de larestricción que especifica esta fila. El tipo dedatos debe ser un carácter con una longitudde 1.

STRING compOperator Contiene el operador comparativo relacional.El tipo de datos debe ser una cadena decaracteres con una longitud de 2. Losoperadores comparativos válidos son:

'EQ' = igual

'NE' = no igual

'LT' = inferior a

'GT' = superior a

'LE' = inferior o igual

'GE' = superior o igual

'BT' = entre

'NB' = no entre

STRING lowValue Contiene el valor bajo del operadorespecificado en la fila anterior. El tipo dedatos debe ser una cadena de caracteres conuna longitud igual o inferior a 60.

STRING highValue Contiene el valor alto del operadorespecificado en las dos filas anteriores. Eltipo de datos debe ser una cadena decaracteres con una longitud igual o inferior a60. Solo es necesario para los operadores BTy NB, de lo contrario, se ignorará, y en estecaso se colocará aquí una cadena vacía.


EjemploAddInfoCubeRestriction(’0CALYEAR’,’E’,’BT’,’1997’,’2000’);

devuelve todos los valores de características entre 1997 y 2000.AddInfoCubeRestriction(’0CALYEAR’,’I’,’NB’,’1997’, ’2000’) ;

devuelve todos los valores de características que no estén entre 1997 y 2000.AddInfoCubeRestriction(’0DOC_CURRCY’, ’I’, ’NE’, ’USD’,’’) ;

devuelve todos los valores de características que no sean iguales a USD.

DataSourceSAPUsingRoleAuthsEsta función de TurboIntegrator ordena al proceso TurboIntegrator que ignore lainformación de seguridad al procesar un origen de datos SAP. Esta variable debecolocarse en Prólogo.

SintaxisDataSourceSAPUsingRoleAuths=’0’


0 La información de seguridad se ignora alprocesar un origen de datos SAP.

1 La información de seguridad se lee alprocesar un origen de datos SAP.

DataSourceSAPUsingTextsEsta variable local de TurboIntegrator ordena al proceso TurboIntegrator ignorardescripciones de características al procesar un origen de datos SAP, lo que da comoresultado un menor consumo de memoria y un mayor rendimiento. Esta variabledebe colocarse en Prólogo.

SintaxisDataSourceSAPUsingTexts=’0’


0 Las descripciones de características seignoran al procesar un origen de datos SAP.El nombre técnico de la característica seimporta a TM1 como nombre de elemento ycomo alias.

1 Las descripciones de características se leen alprocesar un origen de datos SAP.

ExecuteJavaNExecuteJavaN ejecuta un proceso Java de TurboIntegrator que devuelve unnúmero. Si desea ejecutar un proceso Java de TurboIntegrator que devuelva unacadena, utilice ExecuteJavaS.


Se trata de una función TM1 de TurboIntegrator, sólo válida en TM1TurboIntegrator.

La función de reglas EvalJavaN proporciona una funcionalidad análoga en lasreglas TM1.

SintaxisExecuteJavaN(’JavaTIClass’, [’OptionalParameter1’, ’OptionalParameter2’, ...] )




Sólo puede pasar cadenas como parámetros,no puede pasar números. Puede utilizar lafunción “StringToNumber” en la página 343de TurboIntegrator para pasar números a losscripts Java de TurboIntegrator.

Una clase Java de TurboIntegrator que devuelve un número y se puede llamardesde ExecuteJavaN debe utilizar el patrón siguiente.package com.example;


@JavaTIpublic class MyTestTI {public static double MyTestTI (String [] args) [...return ...;}}

Ejemplo

ExecuteJavaN(’com.example.MyTestTI’, ’First’, ’Second’, ’Third’);

ExecuteJavaSExecuteJavaS ejecuta un proceso Java de TurboIntegrator que devuelve una cadena.Si desea ejecutar un proceso Java de TurboIntegrator que devuelva un número,utilice EvalJavaN.

Se trata de una función TM1 de TurboIntegrator, sólo válida en procesos TM1 deTurboIntegrator.

La función de reglas EvalJavaS proporciona una funcionalidad análogo en lasreglas TM1.


SintaxisExecuteJavaS(’JavaTIClass’, [’OptionalParameter1’, ’OptionalParameter2’, ...] )




Sólo puede pasar cadenas como parámetros,no puede pasar números. Puede utilizar lafunción “StringToNumber” en la página 343de TurboIntegrator para pasar números a losscripts Java de TurboIntegrator.

Una clase Java de TurboIntegrator que devuelve una cadena y se puede llamardesde ExecuteJavaS debe utilizar el patrón siguiente.package com.example;


@JavaTIpublic class MyTestTI {public static String MyTestTI (String [] args) [...return ...;}}

Ejemplo

ExecuteJavaS(’com.example.MyTestTI’, ’First’, ’Second’, ’Third’);

ExpandEsta función "despliega" los nombres de variables de TurboIntegrator, que aparecenentre signos de %, para que aparezcan sus valores en el tiempo de ejecución.


Si el nombre de la variable representa una variable de cadena, la expresión devariable completa debe aparecer entre comillas. Por ejemplo, "%V1%".

Un uso común de la función Expand es pasar el valor de variables deTurboIntegrator a la función ODBCOutput. Para obtener más información, consulteel ejemplo que aparece a continuación.

Si a Expand se le proporciona un valor numérico, se realiza una conversión de tipoimplícita y el valor numérico se convierte en una cadena.

Esa cadena tiene una longitud mínima fija de 10 caracteres. Si el númeroconvertido es demasiado bajo para ocupar los 10 caracteres, se rellena con espacios


iniciales. Solamente se convierten los tres primeros caracteres decimales. Porejemplo, un valor numérico de 0,123456789 se convertiría en la cadena "0,123".

SintaxisExpand(String);


String Cualquier cadena que incluya nombres devariables de TurboIntegrator entre signos de%.

EjemploODBCOutPut( ’TransData’, Expand( ’INSERT INTO SALES( MONTH, PRODUCT, SALES )VALUES ( "%V0%", "%V1%",%V2% )’ ) );

Este ejemplo ilustra el uso de la función Expand dentro de la funciónODBCOutput. Este ejemplo inserta registros en una tabla relacional denominadaSales que está formada por tres columnas: Month, Product y Sales.

La función Expand convierte las variables V0, V1 y V2 en sus valores reales dentrode la vista. Suponiendo que el primer valor de la vista sea 123.456, y esté definidopor los elementos Jan y WidgetExpand( ’INSERT INTO SALES ( MONTH, PRODUCT, SALES ) VALUES ("%V0%", "%V1%",%V2% )’ )

pasa a ser’INSERTINTO SALES ( MONTH, PRODUCT, SALES ) VALUES ( Jan, Widget,123.456 )’

en el tiempo de ejecución.

FileExistsEsta función determina si existe un archivo especificado. La función devuelve 1 siel archivo existe, 0 si no existe.


SintaxisFileExists(File);


File El nombre de un archivo. Si no se especificauna ruta completa, TM1 busca el archivo enel directorio de datos del servidor.

EjemploFileExists(’C:\tm1s7\pdata\model.dim’);

Este ejemplo determina si el archivo model.dim existe.


NumberToStringEsta función convierte un número en una cadena, utilizando el separador decimalpara el entorno local del usuario actual.


En Microsoft Windows, el separador decimal es un valor de Opciones regionales.

La salida de esta función es similar al formato de número "general"; no utilizaseparadores de millares y utiliza el signo menos (-) para indicar númerosnegativos.

SintaxisNumberToString(Value);


Value El valor real que desea convertir en unacadena.

EjemplonRET = NumberToString(1234.5);

NumberToStringExEsta función convierte un número en una cadena, utilizando el formato de cadenapasada, el separador decimal y el separador de millares.


SintaxisNumberToStringEx(Value, NumericFormat, DecimalSep, ThousandsSep);


Valor El valor real que desea convertir en unacadena.

FormatString Una cadena de formato numérico de TM1que define el formato de la salida defunciones. Los formatos numéricos sedescriben en la guía del usuario de IBMCognos TM1 .

DecimalSep El separador decimal que se utilizará en lacadena de salida.

ThousandsSep El separador de millares que se utilizará enla cadena de salida.


EjemplosRet=NUMBERTOSTRINGEX(7895.23,’#,0.#########’, ’,’,’.’);

ASCIIOUTPUT(’number_to_string.txt’,sRet);

Devolverá en el archivo ascii;

7.895,23

RefreshMdxHierarchyEsta función actualiza las jerarquías MDX de un servidor sin necesidad de quereinicie el servidor.


Sintaxis

Utilice esta función después de configurar o editar los niveles de jerarquía connombre personalizados de una dimensión del cubo de control}HierarchyProperties.

Para obtener más detalles sobre cómo utilizar niveles con nombre con dimensiones,consulte la sección relacionada en la guía del desarrollador de IBM Cognos TM1 .RefreshMdxHierarchy(dimensionName)


dimensionName Parámetro de cadena opcional paraespecificar una dimensión específica paraactualizar.

Deje este parámetro en blanco paraactualizar todas las dimensiones.

Ejemplo

Actualizar todas las dimensiones:RefreshMdxHierarchy(’’);

Para actualizar únicamente la dimensión de clientes:RefreshMdxHierarchy(’customers’);

StringToNumberEsta función convierte una cadena en un número, utilizando el separador decimalpara el entorno local del usuario actual.


En Microsoft Windows, el separador decimal es un valor de Opciones regionales.

Si la cadena de entrada no es una cadena de número válida, el valor devuelto seráun valor de coma flotante no válido.


SintaxisStringToNumber(String);


String La cadena que desea convertir en unnúmero.

EjemplonRET = StringToNumber(’123.45’);

StringToNumberExEsta función convierte una cadena en un número, utilizando el separador decimaly el separador de millares pasados.


Si la cadena de entrada no es una cadena de número válida, el valor devuelto seráun valor de coma flotante no válido.

SintaxisStringToNumberEx(String, DecimalSep, ThousandsSep);


String La cadena que desea convertir en unnúmero.

DecimalSep El separador decimal que se utilizará en elnúmero de salida.

ThousandsSep El separador de millares que se utilizará enel número de salida.

EjemplonRET = StringToNumberEx(’12453.45’, ’ . ’, ’ , ’);

Archivo TM1ProcessError.logCuando un proceso TurboIntegrator se encuentra con un error, genera un archivoTM1ProcessError.log. Este archivo de registro se guarda en el directorio de datosdel servidor en el que está ubicado el proceso.

Un archivo TM1ProcessError.log contiene una lista de errores encontrados por elproceso. Por cada error que encuentre, el archivo de registro registra la pestaña y lalínea que provocaron el error, junto con una breve descripción del error.

Cuando se genera un archivo de registro de errores de procesos, TM1 asigna unnombre exclusivo que le permite identificar fácilmente los procesos TurboIntegratorque generaron el archivo de error y la hora en que se creó el archivo. Se asignannombres de archivo mediante la convención


TM1ProcessError_<indicación de fecha y hora>_<nombre del proceso>.log. En estaconvención, <indicación de fecha y hora> es la hora (expresada enaaaammddhhmmss GMT) en que se generó el archivo y <nombre del proceso> es elnombre del proceso TurboIntegrator que provocó los errores.

Por ejemplo, un archivo de error denominado TM1ProcessError_20040224203148_CreateSalesCube.log indica que el archivo de error se generó a las 20:31:48 GMTdel 24 de febrero de 2004 y que contiene errores provocados por el procesoCreateSalesCube.

TM1User()Esta función devuelve una cadena que informa del cliente TM1 actual.

Cuando se ejecute en un proceso que el usuario esté ejecutando directamente,devolverá el nombre del cliente TM1 del usuario. Cuando se ejecute en una tareaque el usuario ejecuta directamente, también devolverá el nombre del cliente TM1del usuario.

Si la ejecución se realiza desde una tarea planificada, devolverá un nombre con laforma R*<nombre de tarea>; por ejemplo, R*UpdateRegionDimension.

SintaxisTM1User()

WildcardFileSearchEsta función le permite utilizar caracteres comodín para buscar archivos en undirectorio especificado.


Los resultados de la función WildCardFileSearch pueden variar en función delsistema operativo utilizado. Los archivos de un directorio de Windows se ordenanalfabéticamente y los archivos de un directorio UNIX se ordenan de formaaleatoria. Dado que el orden de clasificación varía entre los sistemas operativos, lamisma función WildCardFileSearch ejecutada en directorios idénticos, uno deWindows y el otro de UNIX, devolverá resultados diferentes.

SintaxisWildcardFileSearch( Pathname, PriorFilename);


Pathname Un nombre de ruta de los archivos quedesea buscar. El nombre de ruta debeterminar en un nombre de archivo, quepuede contener una secuencia de comodínutilizando los caracteres * y/o ?.

El carácter comodín ? coincide con cualquiercarácter.

El carácter comodín * coincide con cero omás caracteres.



PriorFilename El nombre de un archivo existente en eldirectorio especificado. Este nombre dearchivo no puede contener caracterescomodín. La búsqueda comodín especificadapor el argumento Pathname comenzaráDESPUÉS de este archivo.

Si pasa una cadena vacía como argumentoPriorFilename, la función WildcardFileSearchdevolverá el primer archivo que coincidacon la secuencia comodín especificada por elargumento Pathname.

Ejemplo

El siguiente ejemplo muestra el uso de la función WildcardFileSearch paradeterminar el primer archivo de registro del servidor generado en 2004:file = WildcardFileSearch( ’C:\Program Files\Cognos\TM1\Custom\TM1Data\SData\tm1s2004*.log’, ’ ’);

Este ejemplo devuelve el primer archivo que coincida con la secuencia comodín'tm1s2004*.log' del directorio C:\Archivos de programa\Cognos\TM1\Custom\TM1Data\SData\.

Dado que los archivos de registro del servidor reciben su nombre y se guardan conindicaciones de fecha y hora secuenciales, y dado que el segundo parámetro deWildcardFileSearch está vacío, la función devolverá el primer archivo de registrodel servidor que comience por los caracteres "tm1s2004". Debería ser el primerarchivo de registro del servidor generado en el año 2004.

El siguiente ejemplo muestra el uso de la función WildcardFileSearch paradevolver el primer archivo de registro del servidor generado después de habersegenerado tm1s20040211153827.log:file = WildcardFileSearch( ’C:\Program Files\Cognos\TM1\Custom\TM1Data\SData\tm1s*.log’, ’tm1s20040211153827.log’);

Este ejemplo comienza buscando en el directorio C:\Archivos deprograma\Cognos\TM1\Custom\TM1Data\SData\ inmediatamente después delarchivo tm1s20040211153827.log, y devuelve el primer archivo posterior quecoincida con la secuencia comodín 'tm1s*.log'.

tm1s20040220175522.log es el primer archivo que aparece trastm1s20040211153827.log y coincide con la secuencia comodín. De esta manera, elejemplo devuelve tm1s20040220175522.log.


Capítulo 7. Variables de TM1 TurboIntegrator

A continuación, aparecen las variables de IBM Cognos TM1 TurboIntegratororganizadas por categorías.

Variables locales de TurboIntegratorAl ejecutar un proceso TurboIntegrator, se crea un conjunto de variables localesimplícitas. Las variables locales sólo existen en el contexto del proceso en el que seutilizan y no están disponibles fuera del proceso. Las variables locales se destruyenal salir de un proceso. Estas variables, que se enumeran a continuación, puedensobrescribirse para manipular un proceso.

DatasourceNameForServerEsta variable local de TurboIntegrator establece el nombre del origen de datos(archivo .cma, nombre del cubo, origen ODBC) que utiliza el servidor al ejecutar elproceso.

SintaxisDatasourceNameForServer=’Name’;


Nombre En un origen de datos .cma, la ruta completadel archivo .cma.

En los cubos, el nombre del cubo precedidopor la cadena "local:".

En un origen ODBC, el nombre del origen.

DatasourceNameForClientEsta variable local de TurboIntegrator establece el nombre del origen de datos(archivo .cma, nombre del cubo, origen ODBC) que utiliza el cliente al crear oeditar el proceso.

SintaxisDatasourceNameForClient=’Name’;


Nombre En un origen de datos .cma, la ruta completadel archivo .cma.

En los cubos, el nombre del cubo precedidopor la cadena "local:".

En un origen ODBC, el nombre del origen.


DatasourceTypeEsta variable local de TurboIntegrator establece el tipo del origen de datos.

SintaxisDataSourceType=’Type’;


Tipo Entre los tipos válidos se incluyen:

'CHARACTERDELIMITED','POSITIONDELIMITED', 'VIEW', 'SUBSET',ODBC' y 'OLEDBOLAP','SAPCHARACTERISTICTEXTS'

DatasourceUsernameEsta variable local de TurboIntegrator establece el nombre utilizado para conectarseal origen de datos.

SintaxisDatasourceUserName=’Name’;


Nombre El nombre utilizado para conectarse alorigen de datos establecida conDatasourceNameForServer.

DatasourcePasswordEsta variable local de TurboIntegrator establece la contraseña utilizada paraconectarse al origen de datos.

SintaxisDatasourcePassword=’Password’;


Contraseña La contraseña utilizada para conectarse alorigen de datos establecida conDatasourceNameForServer.

DatasourceQueryEsta variable local de TurboIntegrator establece la cadena de consulta con el origende datos.


SintaxisDatasourceQuery=’Query’;


Consulta La cadena de consulta que se va a utilizarcon el origen de datos y que se estableciócon DatasourceNameForServer.

DatasourceCubeviewEsta variable local de TurboIntegrator establece la vista que se va a procesar siDatasourceType es "VIEW".

SintaxisDatasourceCubeview=’ViewName’;


ViewName El nombre de la vista que se va a procesar.Debe ser una vista existente del cuboespecificada por la variableDataSourceNameForServer.

DatasourceDimensionSubsetEsta variable local de TurboIntegrator establece el subconjunto que se va a procesarsi DatasourceType es "SUBSET".

DatasourceNameForServer=nombre de la dimensión también es necesario junto conDATASOURCEDIMENSIONSUBSET para que TM1 pueda identificar la ubicacióndel subconjunto.

SintaxisDatasourceDimensionSubset=’SubsetName’;


SubsetName El nombre del subconjunto que se va aprocesar.

DatasourceASCIIDelimiterEsta variable local de TurboIntegrator establece el carácter ASCII que se va autilizar como delimitador de campo cuando DatasourceType sea"CHARACTERDELIMITED".

Capítulo 7. Variables de TM1 TurboIntegrator 349

SintaxisDatasourceASCIIDelimiter=’Character’;


Character El carácter ASCII que se va a utilizar comodelimitador.

DatasourceASCIIDecimalSeparatorEsta variable local de TurboIntegrator establece el separador decimal que se va autilizar en cualquier conversión de una cadena en un número o de un número enuna cadena. Si establece esta variable también debe establecer la variableDatasourceASCIIThousandSeparator.

SintaxisDatasourceASCIIDecimalSeparator=’Character’;


Character El carácter ASCII que se va a utilizar comoseparador.

DatasourceASCIIThousandSeparatorEsta variable local de TurboIntegrator establece el separador de millares que se vaa utilizar en cualquier conversión de una cadena en un número o de un número enuna cadena.

Si establece esta variable también debe establecer la variableDatasourceASCIIDecimalSeparator.

SintaxisDatasourceASCIIThousandSeparator=’Character’;


Character El carácter ASCII que se va a utilizar comoseparador.

DatasourceASCIIQuoteCharacterEsta variable local de TurboIntegrator establece el carácter ASCII que se va autilizar para encerrar los campos del archivo de origen cuando DatasourceType sea"CHARACTERDELIMITED".


SintaxisDatasourceASCIIQuoteCharacter=’Character’;


Character El carácter ASCII que encierra los campos enel origen de datos.

DatasourceASCIIHeaderRecordsEsta variable local de TurboIntegrator indica el número de registros que se van aomitir antes de procesar el origen de datos.

SintaxisDatasourceASCIIHeaderRecords=N;


N El número de registros que se van a omitirantes de procesar el origen de datos.

Value_Is_StringCuando DatasourceType es "VIEW", esta variable local de TurboIntegratordetermina si la celda actual debe tratarse como valor numérico o de cadena.

SintaxisValue_Is_String=N;


N Valor que indica si la celda actual es unvalor numérico o de cadena.

0 dicta que la celda es un número; cualquierotro valor indica que la celda se trata comouna cadena.

NValueCuando DatasourceType es "VIEW", esta variable local de Turbointegratordetermina el valor de la celda actual si Value_Is_String es 0. (Es decir, cuando lacelda actual es numérica).

SintaxisNvalue=N;


N El valor de la celda actual.


SValueCuando DatasourceType es "VIEW", esta variable local de Turbointegratordetermina el valor de la celda actual si Value_Is_String no es 0. (Es decir, cuando lacelda actual contiene una cadena).

SintaxisSvalue=’String’;


Cadena El valor de la celda actual.

OnMinorErrorDoItemSkipEsta variable local de TurboIntegrator ordena a TurboIntegrator que pase alsiguiente registro cuando encuentre un error leve durante el procesamiento de unregistro.

Esta variable resulta útil en escenarios en los que un único valor/campo erróneode un registro provoque varios errores leves.

Por ejemplo, si tiene 100 funciones CELLPUTN en un proceso y uno de los camposde un registro determinado es "erróneo" o no válido, el recuento de errores leves seincrementa en 100. (1 por cada función CELLPUTN que encuentre el error). Estos100 errores leves hacen que se acerque al límite de errores leves definido porMinorErrorLogMax. Un proceso TurboIntegrator no se realizará correctamentecuando supere el número de errores leves definido por MinorErrorLogMax.

Si OnMinorErrorDoItemSkip=1; se incluye en la pestaña Prólogo del proceso, elproceso salta inmediatamente al siguiente registro cuando se encuentra un campo"erróneo" o no válido en un registro de origen. Utilizando el ejemplo anterior, elrecuento de errores leves se incrementará sólo en 1, en lugar de en 100.

SintaxisOnMinorErrorDoItemSkip=N;


N Valor que indica si el elemento debe omitirsecuando se encuentre un error leve.

1 (o cualquier valor que no sea cero) dictaque el proceso debe saltar al siguienteregistro cuando se encuentre un error leve.

0 indica que TurboIntegrator debe continuarprocesando el registro actual cuando seencuentre un error leve.


MinorErrorLogMaxEsta variable local de TurboIntegrator define el número de errores leves que seescribirán en el archivo TM1ProcessError.log durante la ejecución del proceso. Siesta variable no se define en el proceso, el número de errores leves predeterminadoescrito en el archivo de registro será 1000.

SintaxisMinorErrorLogMax=N;


N Valor que indica el número de errores quedeben escribirse en el archivo de registro.

Especifique un entero mayor que cero paraestablecer el número máximo de errores quese escribirán en el archivo de registro.

Especifique un valor de 0 para no registrarerrores durante la ejecución del proceso.

Especifique un valor de -1 para permitir quese escriba un número ilimitado de erroresleves en el archivo de registro.

The following table provides an example error log messageand the corresponding result.

Ejemplo Resultado

MinorErrorLogMax=750; El archivo de registro aceptará hasta 750errores.

MinorErrorLogMax=0; No se escribirán errores en el archivo deregistro.

MinorErrorLogMax=-1; No existe ningún límite en el número deerrores que se escribirán en el archivo deregistro.

DataSourceODBOCatalogEsta variable local de TurboIntegrator establece el nombre de la recopilación debases de datos que contiene los cubos, las dimensiones u otros objetos a los quedesee conectarse. Para Microsoft Analysis Services, éste es el nombre de la base dedatos.

SintaxisDataSourceODBOCatalog=’Catalog’;


Catalog El nombre de la recopilación de bases dedatos a las que desee conectarse.


DataSourceODBOConnectionStringEsta variable local de TurboIntegrator establece los parámetros de conexiónadicionales que pueden ser necesarios para conectarse al servidor OLAP.

SintaxisDataSourceODBOConnectionString=’String’;


Cadena El valor que se utiliza para definirparámetros de conexión adicionales.

Asigne estos parámetros a esta variable,delimitada por puntos y coma.

DataSourceODBOCubeNameEsta variable local de TurboIntegrator establece el nombre del cubo del servidorOLAP que desea utilizar como origen de datos.

SintaxisDataSourceODBOCubeName=’Name’;


Nombre El nombre del cubo que se va a utilizar.

DataSourceODBOHierarchyNameEsta variable local de TurboIntegrator establece el nombre de la jerarquía de ladimensión específica que está utilizando como origen de datos. Puede utilizar estavariable en otros productos OLAP, tales como SAP BW, en los que una jerarquía esun objeto independiente.

Esta variable no se utiliza con orígenes de datos TM1 .

SintaxisDataSourceODBOHierarchyName=’Name’;


Nombre El nombre de la jerarquía de una dimensiónespecífica.

DataSourceODBOLocationEsta variable local de TurboIntegrator establece el nombre de la ubicación (sistema)en la que se está ejecutando el servidor OLAP.

TM1 utiliza esta variable, a diferencia de otros servidores OLAP. En TM1 , ésta esla ubicación en la que se ejecuta el host de administración.


SintaxisDataSourceODBOLocation=’Location’;


Location El nombre de la ubicación (sistema) delservidor OLAP.

DataSourceODBOProviderEsta variable local de TurboIntegrator para IBM Cognos TM1 establece el nombredel cubo del servidor ODBO que desea utilizar como origen de datos. Éste es elnombre completo asignado por el fabricante del proveedor ODBO para identificarsu servidor de bases de datos multidimensional.

Debe utilizar el nombre de un proveedor ODBO que esté instalado en su servidor.

SintaxisDataSourceODBOProvider=’Provider’;


Provider El nombre del proveedor ODBO que se va autilizar como origen de datos.

Entre los nombres de proveedorescomúnmente utilizados se incluyen:

Proveedor MD de base de datos OLE deTM1

Proveedor de base de datos OLE Microsoftpara OLAP Services 8.0

Proveedor de OLE DB de SAP BW

DataSourceODBOSAPClientIDEsta variable local de TurboIntegrator establece el número de cliente quecorresponda a la versión de la interfaz de usuario del servidor SAP al que deseeconectarse.

SintaxisDataSourceODBOSAPClientID=’ID’;


ID Un número que corresponde a la versión deinterfaz de usuario del servidor SAP.

Por ejemplo, 498.


DataSourceODBOSAPClientLanguageEsta variable local de TurboIntegrator establece la especificación del idioma delidioma del sistema SAP al que desee conectarse.

SintaxisDataSourceODBOSAPClientLanguage=’Language’;


Language La especificación del idioma del sistemaSAP.

Para inglés estadounidense, utilice EN.

Para alemán, utilice DE.

Para los demás idiomas, consulte ladocumentación de SAP.

Variables globales de TurboIntegratorEste tipo de variable de TurboIntegrator se asocia a una tarea TM1 individual o aun proceso individual y cualquier subproceso que conlleve. Existen dos tipos devariables globales: implícitas y definidas por el usuario. Las variables globalesimplícitas se describen aquí. Las variables globales definidas por el usuario sedescriben a continuación.

Las variables globales se pueden utilizar de dos formas:v Las variables globales pueden declararse dentro de un proceso que forme parte

de una tarea determinada. Una vez declaradas, las variables globales estarándisponibles para el resto de procesos que formen parte de la tarea. Las variablespermanecerán mientras se ejecute la tarea y durante el tiempo que dure la sesiónde servidor actual. Las variables globales se destruirán cuando se apague elservidor

v Las variables globales pueden declararse en un proceso y pueden estardisponibles para cualquier proceso posterior llamado por la funciónExecuteProcess( ). Estos subprocesos deben utilizar las mismas sentencias dedeclaración de variables locales (descritas a continuación) para poder acceder alas variables globales.

En el caso de que el nombre de una variable global sea idéntico al nombre de unavariable local, la definición de la variable local tendrá prioridad y reemplazará a lavariable global.

Las variables globales se declaran en un proceso TurboIntegrator utilizando una delas siguientes dos funciones:v NumericGlobalVariable('VariableName');.v StringGlobalVariable('VariableName');.

NumericGlobalVariable("VariableName");Utilice esta función para declarar una variable global numérica.


StringGlobalVariable("VariableName");Utilice esta función para definir una variable global de cadena.

Variables globales implícitasAl ejecutar un proceso TurboIntegrator, se crea un conjunto de variables globalesimplícitas. Si el proceso que crea las variables forma parte de una tarea, dichasvariables globales estarán disponibles y podrán compartirse con los demásprocesos de la tarea. Además, todas las variables globales implícitas de un procesoestarán disponibles y podrán compartirse con cualquier proceso posterior llamadopor la función ExecuteProcess( ).

Aunque las variables implícitas se crean a través del proceso TurboIntegrator, debedeclarar una variable antes de que pueda utilizarse en un proceso

Las variables globales implícitas se declaran en un proceso TurboIntegratorutilizando NumericGlobalVariable('VariableName');:

Pulse uno de los siguientes enlaces para obtener más información sobre lasvariables globales implícitas específicas.v DataMinorErrorCount.v MetadataMinorErrorCount.v ProcessReturnCode.v PrologMinorErrorCount.

Por ejemplo, para utilizar la variable global implícita PrologMinorErrorCount enun proceso, debe declarar en primer lugar la variable de la siguiente manera:NumericGlobalVariable(’PrologMinorErrorCount’);

DataMinorErrorCountEsta variable global de TurboIntegrator cuenta los errores leves que tienen lugar enla parte Datos de un proceso TurboIntegrator. Por cada error leve que encuentre, elvalor de la variable se incrementará en 1.

SintaxisDataMinorErrorCount=N;


N El número de errores leves encontrados en laparte Datos del proceso.

MetadataMinorErrorCountEsta variable global de TurboIntegrator cuenta los errores leves que tienen lugar enla parte Metadatos de un proceso TurboIntegrator. Por cada error leve queencuentre, el valor de la variable se incrementará en 1.


SintaxisMetadataMinorErrorCount=N;


N El número de errores leves encontrados en laparte Metadatos del proceso.

ProcessReturnCodeEsta variable global de TurboIntegrator almacena el estado de salida del procesoTurboIntegrator ejecutado más recientemente.

SintaxisProcessReturnCode=StatusCode;

Código de estado Descripción

ProcessExitByChoreQuit() indica que el proceso finalizó debido a laejecución de la función ChoreQuit

ProcessExitNormal() indica que el proceso se ejecutó connormalidad

ProcessExitMinorError() indica que el proceso se ejecutócorrectamente, pero se encontraron erroresleves

ProcessExitByQuit() indica que salió del proceso debido a uncomando explícito de "salida"

ProcessExitWithMessage() indica que salió del proceso con normalidad,con un mensaje escrito en tm1server.log.

ProcessExitSeriousError() indica que salió del proceso debido a unerror grave

ProcessExitOnInit() indica que el proceso se interrumpió durantela inicialización

ProcessExitByBreak() indica que salió del proceso porque seencontró una función ProcessBreak

PrologMinorErrorCountEsta variable global de TurboIntegrator cuenta los errores leves que tienen lugar enla parte Prólogo de un proceso TurboIntegrator. Por cada error leve que encuentre,el valor de la variable se incrementará en 1.


SintaxisPrologMinorErrorCount=N;


N El número de errores leves encontrados en elPrólogo.

Variables de usuario de TurboIntegratorEste tipo de variable se asocia a un usuario TM1 individual, no a un proceso otarea particular. Las variables de usuario pueden manipularse desde cualquierproceso o tarea de TurboIntegrator mientras el usuario con el que la variable estáasociada tenga una sesión iniciada en el servidor.

Las variables de usuario deben declararse explícitamente. Una vez declaradas, lasvariables de usuario permanecerán durante toda la sesión TM1 del usuario (hastaque el usuario cierre la sesión del servidor).

Las variables de usuario se declaran en un proceso TurboIntegrator utilizando unade las dos funciones siguientes:v NumericSessionVariable("VariableName");v StringSessionVariable("VariableName");

Las variables de usuario se crean la primera vez que se encuentra dichadeclaración en cualquier proceso TurboIntegrator en ejecución.

Una vez creada, puede hacerse referencia al nombre de la variable, así comoutilizarse simplemente como cualquier variable local o global, y el valor de lavariable persistirá en los procesos y en las tareas únicamente mientras el usuarioque creó la variable tenga una sesión iniciada en el servidor.

NumericSessionVariable("VariableName");Utilice esta función para declarar una variable de usuario numérica.

StringSessionVariable("VariableName");Utilice esta función para definir una variable de usuario de cadena.


Capítulo 8. Soporte para funciones MDX

Todas las funciones específicas de TM1 y definidas por Microsoft soportadas paraTM1 aparecen en esta sección.

Soporte para funciones y expresiones MDX definidas por MicrosoftTM1 soporta las siguientes funciones y expresiones MDX definidas por Microsoft.

La implementación por parte de TM1 de estas funciones y expresiones se basa enlas definiciones de la biblioteca MSDN de Microsoft, que está disponible en el sitioweb MSDN de Microsoft.

Lista de expresiones de elementos soportadasSe admiten las siguientes expresiones de miembro MDX.v <dimensión>.CURRENTMEMBERv <elemento>.FIRSTCHILDv <elemento>.FIRSTSIBLINGv <elemento>.LAGv <elemento>.LASTCHILDv <elemento>.LASTSIBLINGv <elemento>.LEADv <elemento>.NEXTMEMBERv <elemento>.PARENTv <elemento>.PREVMEMBER

Lista de funciones de elementos soportadasSe admiten las siguientes funciones de miembro MDX.v ANCESTOR(...)v COUSIN(...)v OPENINGPERIOD(...)v PARALLELPERIOD(...)

Lista de funciones numéricas soportadasSe admiten las siguientes funciones numéricas MDX.v AGGREGATE(...)v AVG(...)v CORRELATION(...)v COUNT(...)v COVARIANCE(...)v LINREGINTERCEPT(...)v LINREGPOINT(...)v LINREGR2(...)v LINREGSLOPE(...)v LINREGVARIANCE(...)


v MAX(...)v MEDIAN(...)v MIN(...)v RANK(...)v STDDEV(...)v SUM(...)v VAR(...)

Lista de expresiones de conjuntos soportadasSe admiten las siguientes expresiones de conjunto MDX.v <dimensión>.MEMBERSv <nivel>.MEMBERSv <elemento>. CHILDRENv <elemento>.SIBLINGS

Lista de funciones de conjuntos soportadasSe admiten las siguientes funciones de conjunto de MDX.v ADDCALCULATEDMEMBERS(...)v BOTTOMCOUNT(...)v BOTTOMPERCENT(...)v BOTTOMSUM(...)v CROSSJOIN(...)v DESCENDANTS(...)v DISTINCT(...)v DRILLDOWNLEVEL(...)v DRILLDOWNLEVELBOTTOM(...)v DRILLDOWNLEVELTOP(...)v DRILLDOWNMEMBER(...)v DRILLDOWNMEMBERBOTTOM(...)v DRILLDOWNMEMBERTOP(...)v DRILLUPMEMBER(...)v DRILLUPLEVEL(...)v EXCEPT(...)v EXTRACT(...)v FILTER(...)v GENERATE(...)v HEAD(...)v HIERARCHIZE(...)v INTERSECT(...)v LASTPERIODS(...)v ORDER(...)v PERIODSTODATE(...)v TOPCOUNT(...)v TOGGLEDRILLSTATE(...)v TOPPERCENT(...)


v TOPSUM(...)v SUBSET(...)v UNION(...)

Lista de expresiones de tupla soportadasSe admiten las siguientes expresiones tupla MDX.v <conjunto>.CURRENTMEMBERv <conjunto>[.ITEM](...)

Funciones MDX específicas de TM1TM1 admite varias expresiones MDX específicas de TM1 . Puede aplicar estasexpresiones al desarrollar aplicaciones MDX para que se ejecuten en el servidor oal crear o editar subconjuntos dinámicos en la ventana Expresión del Editor desubconjuntos.

TM1FILTERBYPATTERN( <conjunto>, <cad_modelo> )Esta función MDX específica de TM1 devuelve todos los elementos de <conjunto>con nombres que coinciden con el modelo <cad_modelo>.

La sintaxis de <cad_modelo> es la misma que la utilizada por la opción Seleccionarpor expresión regular en el Editor de subconjuntos.

TM1FILTERBYLEVEL( <conjunto>, <número_nivel>)Esta función MDX específica de TM1 devuelve todos los elementos de <conjunto>del <número_nivel> especificado.

<número_nivel> es un número que especifica el número de nivel de TM1 , no elnúmero de nivel de MDX.

TM1DRILLDOWNMEMBER( <conjunto1>, <conjunto2>|ALL[,RECURSIVE] )

Esta función MDX específica de TM1 es similar a la funciónDRILLDOWNMEMBER de Microsoft, pero se ha ajustado para que coincida con lafuncionalidad del botón Expandir {bmct expand_button.bmp} del Editor desubconjuntos.

ALL equivale a detallar más en todos los elementos de <conjunto1>.

RECURSIVE significa que cuando se detalla más en un elemento de <conjunto1>,también se detallará más en los detalles de los elementos consolidados queresultan de dicha expansión de forma recursiva hasta que se alcance el nivel 0(TM1 nivel 0 ).

TM1MemberEsta función devuelve un elemento de una tupla especificada.

Si se da alguna de las siguientes condiciones, se devolverá una referencia deelemento nula:v Un parámetro de tupla nulov Un parámetro de índice numérico fuera de rango

Capítulo 8. Soporte para funciones MDX 363

v No se encontró un parámetro de dimensión o jerarquía en la tupla pasada.

SintaxisTM1Member(Tuple, MemberSpecifier);


Tuple Una expresión que resuelve una tupla.

MemberSpecifier Este parámetro puede ser un índicenumérico en la tupla basado en 0 o elnombre de una dimensión o jerarquíaasociada a la tupla. A continuaciónencontrará ejemplos de ambos tipos deparámetros.

Ejemplo

TM1Member ( [model].Members.Item(23) ,0 ) ] Este ejemplo utiliza un índicenumérico en la tupla como argumento MemberSpecifier.

TM1Member( [model].Members.Item(23), [Model] ) ] Este ejemplo utiliza el nombrede una dimensión asociada a la tupla como argumento MemberSpecifier.

TM1SORT( <conjunto>, ASC|DESC )Esta función MDX específica de TM1 ordena el <conjunto> alfabéticamente.

ASC ordena de la A a la Z

DESC ordena de la Z a la A

TM1SORTBYINDEX( <conjunto>, ASC|DESC )Esta función MDX específica de TM1 ordena el <conjunto> por el valor del índicede los elementos.

ASC ordena por valor de índice ascendente.

DESC ordena por valor de índice descendente.

TM1SUBSETALL( <nombredim>)Esta función MDX específica de TM1 devuelve el subconjunto Todo de TM1de<nombredim>.

TM1SubsetToSetEsta función devuelve los elementos de un subconjunto de TM1 .

TM1SubsetToSet es equivalente a la expresión <dimensión>.<nombresubconjunto>,pero no requiere series literales. En cambio, TM1SubsetToSet le permite utilizarexpresiones que resuelven el subconjunto y dimensión adecuados.

Si se encuentran dimensiones con nombres idénticos en dos cubos distintos,especifique un nombre completo, como [cubo].[dimensión].


SintaxisTM1SubsetToSet(Cube.Dimension_exp, Subset_exp);


Dimension_exp Una expresión que resuelve un nombre dedimensión de TM1 válido.

Utilice el formato completo de[cubo].[dimensión] para identificar lasdimensiones si hay dimensiones con nombreidénticos en los cubos.

Subset_exp Una expresión que resuelve un subconjuntoválido de la dimensión devuelta porDimension_exp.

Al resolver una expresión de unsubconjunto, el servidor busca en primerlugar en la lista privada de subconjuntos y, acontinuación, en la lista pública.

Ejemplo

Código de ejemplo MDX con el nombre de dimensión [Corp Planning Hry] en laúltima línea:{INTERSECT(EXCEPT(DESCENDANTS([Corp Planning Hry].[Fixed Assets]),TM1FILTERBYLEVEL(DESCENDANTS([Corp Planning Hry].[Fixed Assets]),0)),{TM1SubsetToSet([Corp Planning Hry],"elist")}),[Corp Planning Hry].[FixedAssets]}

Código de ejemplo MDX con el nombre de dimensión completo [Corp PlanningHry].[Corp Planning Hry] y [Corp Planning Hry].[FixedAssets] en la últimalínea:{INTERSECT(EXCEPT(DESCENDANTS([Corp Planning Hry].[Fixed Assets]),TM1FILTERBYLEVEL(DESCENDANTS([Corp Planning Hry].[Fixed Assets]),0)),{TM1SubsetToSet([Corp Planning Hry].[Corp Planning Hry],"elist")}),[Corp Planning Hry].[FixedAssets]}

TM1TupleSizeEsta función devuelve el número de elementos de una tupla.

SintaxisTM1TupleSize(Tuple);


Tuple Una expresión que resuelve una tupla.

La función devuelve 0 si el argumento Tupleno resuelve una tupla válida o si la tupla esnula o está vacía.

Capítulo 8. Soporte para funciones MDX 365

Expresiones MDX específicas de TM1TM1 admite varias expresiones MDX específicas de TM1 . Puede aplicar estasexpresiones al desarrollar aplicaciones MDX para que se ejecuten en el servidor oal crear o editar subconjuntos dinámicos en la ventana Expresión del Editor desubconjuntos.

<dimensión>.<nombresubconjunto>Esta expresión MDX específica de TM1 devuelve elementos de<nombresubconjunto> de <dimensión>.

Dado que se utiliza la misma sintaxis (<dimensión>.IDENTIFIER) para elementos yniveles, nunca se creará una instancia de un subconjunto con el mismo nombre queun elemento o un nivel.

Al buscar un subconjunto, el servidor busca en primer lugar en la lista privada desubconjuntos y, a continuación, en la lista pública.

<elemento>.ANCESTORSEsta expresión MDX específica de TM1 devuelve los ancestros de <elemento>.

Por ejemplo, si se presupone la siguiente jerarquía de la dimensión Month:v Year

– 1 Quarter– Jan– Feb– Mar

la expresión

month.jan.ANCESTORS

devolverá el conjunto

{ 1Quarter, Year }.

Si el elemento cuenta con más de un padre inmediato, la expresión devolverá elconjunto que incluya el primer padre de la jerarquía predeterminada. Piense enuna jerarquía de una dimensión Region, en la que el elemento Belgium cuente conmás de un padre inmediato, que son Benelux y Europe. En este caso, la expresión

region.belgium.ANCESTORS

devolverá el conjunto

{ Benelux, Europe }.


Avisos

Esta información se ha desarrollado para productos y servicios que se ofrecen entodo el mundo.

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 de IBM de su localidad para obtener información acerca de losproductos y servicios que actualmente están disponibles en su zona. Cualquierreferencia hecha a un producto, programa o servicio de IBM no implica ni pretendeindicar que sólo pueda utilizarse ese producto, programa o servicio de IBM. En sulugar, podrá utilizarse cualquier producto, programa o servicio con característicasequivalentes que no infrinja ningún derecho de propiedad intelectual de IBM. Sinembargo, será responsabilidad del usuario evaluar y verificar el funcionamiento decualquier programa, producto o servicio que no sea de IBM. Este documentopuede incluir descripciones de productos, servicios o características que no formanparte de la titularidad 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-kuTokio 103-8510, Japón

El párrafo siguiente no tiene aplicación en el Reino Unido ni en ningún otro paísen el que tales provisiones sean incoherentes con la legislación local:INTERNATIONAL BUSINESS MACHINES CORPORATION PROPORCIONAESTA PUBLICACIÓN "TAL CUAL", SIN GARANTÍAS DE NINGÚN TIPO, YASEAN EXPRESAS O IMPLÍCITAS, INCLUIDAS, PERO SIN LIMITARSE A, LASGARANTÍAS IMPLÍCITAS DE NO INFRACCIÓN, COMERCIALIZACIÓN OIDONEIDAD PARA UNA FINALIDAD DETERMINADA. En algunos estados noestá 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 podría realizar


mejoras y/o cambios en el producto o productos y/o programa o programas quese describen en esta publicación en cualquier momento y sin previo aviso.

Cualquier referencia hecha en esta información a sitios web que no son de 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, ONK1V 1B7Canadá

Esta información podría estar disponible, de acuerdo con los términos ycondiciones aplicables, incluyendo 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, IBM International Program License Agreement ocualquier otro acuerdo equivalente celebrado entre ambas partes.

Los datos relacionados con el rendimiento que pudiera contener este documento sehan determinado en un entorno controlado. Por lo tanto, los resultados obtenidosen otros entornos operativos podrían variar significativamente. Puede que algunasmediciones se hayan obtenido en sistemas de desarrollo y no existe ningunagarantía que permita afirmar que puedan obtenerse las mismas mediciones ensistemas de disponibilidad general. Es más, puede que algunas mediciones seanestimaciones obtenidas por extrapolación. Los resultados reales podrían variar. Losusuarios de este documento deben verificar los datos que se aplican a su entornoespecífico.

La información relacionada con productos que no son de IBM se ha obtenido delos proveedores de esos productos, los anuncios que han publicado u otras fuentesde disponibilidad pública. 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 ilustrarlas de la forma máscompleta posible, los ejemplos incluyen nombres de personas, compañías, 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.

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

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 web en “Copyright and trademark information” en www.ibm.com/legal/copytrade.shtml.

Los términos siguientes son marcas registradas de otras compañías:v Microsoft, Windows, Windows NT y el logotipo de Windows son marcas

registradas de Microsoft Corporation en los Estados Unidos o en otros países.v UNIX es una marca registrada de The Open Group en los Estados Unidos o en

otros países.

Avisos 369

http://www.ibm.com/legal/copytrade.shtml

Índice

AABS 149acceso

funciones de macro 167privilegios Asignaciones de seguridad 55

ACOS 149AddClient 302AddCubeDependency 245AddGroup 302AddInfoCubeRestriction 337Admin

Asignaciones de seguridad 59Secure Socket Layer del servidor, opciones de TM1 80

ajuste de línea 53Alias TM1, cuadro de diálogo 79anular comentarios 52aplicación

Server Explorer 64ASCII

y texto, funciones de TurboIntegrator 219ASCIIDelete 219ASCIIOutput 221asignar

ClientPassword 303ClientToGroup 303cuadrícula Asignaciones de seguridad 55

ASIN 150asistente de informes de impresión 44AssociateCAMIDToGroup 304ATAN 150atributo

editor 10Editor de TurboIntegrator 101funciones de TurboIntegrator de manipulación 226

AttrDelete 229AttrInsert 229ATTRN 117ATTRNL 226AttrPutN 230AttrPutS 230ATTRS 118ATTRSL 227autocompletar 53avanzada

cuadrícula de correlación 7avanzadas

opciones 7avanzado

pestaña del Editor de TurboIntegrator 106ayuda contextual 53

Bbarra de estado 53barra de herramientas 53BatchUpdateFinish 253, 312, 314BatchUpdateFinishWait 314BatchUpdateStart 314bloqueo

asignaciones de seguridad 58

botón de acciónpropiedades 3

botón de acción de apariencia 7botones

Editor de TurboIntegrator 100buscar 52

CCAPIT 157características nuevas 1CellGetN 245CellGetS 246CellIncrementN 247CellIsUpdateable 248CellPutN 248CellPutProportionalSpread 249CellPutS 250CellSecurityCubeCreate 304CellSecurityCubeDestroy 305CHAR 158chino 52clientes

/grupo, ventana 20/grupos, cuadrícula 20, 21cuadro de diálogo Centro de mensajes de 22menú Clientes/Grupos 20

CODE 158comentarios 52comparación 111comprobar sintaxis 51conectar servidor 41consolidación

Editor de TurboIntegrator 101ConsolidatedAvg 114ConsolidatedCount 115ConsolidatedCountUnique 116ConsolidatedMax 113ConsolidatedMin 112consulta del registro de transacciones

cuadro de diálogo 81cuadro de diálogo de resultados 82

contención de bloqueo 316CONTINUE 147control

objetos 53opciones 54

coreano 52correlación automática 7COS 150crear

cubo, cuadro de diálogo 23dimensión, cuadro de diálogo 22objeto de réplica de servidor 23

cuadrículaEditor de TurboIntegrator 100

cuadro de diálogo Abrir subconjunto 43cuadro de diálogo Abrir vista 43Cuadro de diálogo Borrar subconjuntos con nombre 28Cuadro de diálogo Borrar vistas con nombre 29


Cuadro de diálogo Obtener vista (Navegador de hojas decálculo) 41

cuadro de diálogo Opciones de proceso 48cuadro de diálogo Opciones de TM1 79cuadros de diálogo 3CubeAttrDelete 231CubeAttrInsert 232CubeATTRN 118, 234CubeATTRNL 234CubeAttrPutN 232CubeAttrPutS 233CubeATTRS 119, 235CubeATTRSL 236CubeClearData 251CubeCreate 252CubeDataReservationAcquire 256CubeDataReservationGet 259CubeDataReservationGetConflicts 261CubeDataReservationRelease 258CubeDataReservationReleaseAll 258CubeDestroy 252CubeExists 253CubeGetLogChanges 253CubeProcessFeeders 289CubeRuleAppend 290CubeRuleDestroy 291CubeSetConnParams 255CubeSetLogChanges 256CubeUnload 256CubeView

Server Explorer 69cubo

cuadro de diálogo Propiedades del 25editor de subconjuntos de información 49Editor de TurboIntegrator 101funciones de manipulación de TurboIntegrator 244optimizar 25Server Explorer 65, 66visor 25

DD_FSAVE 170D_PICK 168D_SAVE 170DataMinorErrorCount 357DatasourceASCIIDecimalSeparator 350DatasourceASCIIDelimiter 350DatasourceASCIIHeaderRecords 351DatasourceASCIIQuoteCharacter 351DatasourceASCIIThousandSeparator 350DatasourceCubeview 349DatasourceDimensionSubset 349DatasourceNameForClient 347DatasourceNameForServer 347DataSourceODBOCatalog 353DataSourceODBOConnectionString 354DataSourceODBOCubeName 354DataSourceODBOHierarchyName 354DataSourceODBOLocation 355DataSourceODBOProvider 355DataSourceODBOSAPClientID 355DataSourceODBOSAPClientLanguage 356DatasourcePassword 348DatasourceQuery 349DataSourceSAPUsingRoleAuths 338DataSourceSAPUsingTexts 338

DatasourceType 348DatasourceUsername 348DATE 124DATES 125datos

Editor de TurboIntegrator 101, 106origen, pestaña del editor de TurboIntegrator 84

DAY 126DAYNO 126DBProportionalSpread 168DBR 194DBRA 194DBRW 195DBS 196DBSA 197DBSS 197DBSW 199DELET 159DeleteAllPersistentFeeders 292DeleteClient 306DeleteGroup 306DFRST 199dimensión

cuadro de diálogo Insertar elementos 33cuadro de diálogo Ordenar elementos de 34cuadro de diálogo Propiedades de elementos 35editor de subconjuntos de información 50Editor de TurboIntegrator 101funciones de reglas de información 134funciones de TurboIntegrator de manipulación 264menú Editor de dimensiones 29nombre de subconjunto 366Server Explorer 68

DimensionAttrDelete 237DimensionAttrInsert 238DimensionATTRN 119, 240DimensionATTRNL 240DimensionAttrPutN 238DimensionAttrPutS 239DimensionATTRS 120, 241DimensionATTRSL 242DimensionCreate 265DimensionDeleteAllElements 265DimensionDestroy 266DimensionElementComponentAdd 266DimensionElementComponentAddDirect 267DimensionElementComponentDelete 268DimensionElementComponentDeleteDirect 269DimensionElementDelete 269DimensionElementDeleteDirect 270DimensionElementInsert 271DimensionElementInsertDirect 272, 277DimensionElementPrincipalName 273dimensiones de columna

Cube Viewer 25dimensiones de título

Cube Viewer 25DimensionExists 273, 276DimensionSortOrder 274DimensionTopElementInsert 276DIMIX 139, 200DIMNM 136, 200DIMSIZ 137, 201DisableBulkLoadMode 315DNEXT 137, 201DNLEV 138, 202DTYPE 140, 202


EE_PICK 171editar

fórmula, cuadro de diálogo 35referencia al cubo, cuadro de diálogo 36

Editor 83ELCOMP 140, 203ELCOMPN 141, 204elemento

funciones de reglas de información 139panel Editor de dimensiones 29panel Editor de subconjuntos 74

ElementSecurityGet 307ElementSecurityPut 307ELISANC 141ELISCOMP 142, 204ELISPAR 143, 205ELLEV 143, 206ELPAR 144, 206ELPARN 144, 207ELSEN 208ELWEIGHT 145, 208EnableBulkLoadMode 316epílogo

Editor de TurboIntegrator 106escritura

asignaciones de seguridad 57EvalJavaN 165EvalJavas 166Excel

funciones de macros de la versión 8 y posteriores 167funciones de macros de las versiones 5 y 7 167

ExecuteCommand 281ExecuteJavaN 339ExecuteJavaS 339ExecuteProcess 282, 356EXP 151Expand 341exponenciación 111expresiones MDX específicas de TM1 366

Ffecha y hora

funciones de TurboIntegrator 262FEEDERS 163FEEDSTRINGS 164fila

Cube Viewer 25FileExists 341FILL 159filtrar

elementos por atributo, cuadro de diálogo 37elementos por nivel, cuadro de diálogo 37subconjunto, cuadro de diálogo 37vista, cuadro de diálogo 39

ForceSkipCheck 292FormatDate 262Fórmula de variables del proceso 101funciones

hoja de trabajo 193MDX 361reglas 111, 167TurboIntegrator 219

Funciones de cálculo 112

funciones de conjuntosMDX 362

funciones de macroacceder 167lista 167

funciones de recintos de pruebas 293funciones de reglas de texto 157funciones de reglas financieras 145funciones de reglas matemáticas 149Funciones de TurboIntegrator de ODBC 278funciones de TurboIntegrator de reserva de datos

CubeDataReservationAcquire 256CubeDataReservationGet 259CubeDataReservationGetConflicts 261CubeDataReservationRelease 258CubeDataReservationReleaseAll 258

funciones MDX específicas de TM1 363FV 146

GGetProcessErrorFileDirectory 283GetProcessErrorFilename 284GetProcessName 284GetUseActiveSandboxProperty 294Grupo de servidores

Server Explorer 62guardar

cuadro de diálogo de vista del navegador de hojas decálculo 55

subconjunto, cuadro de diálogo 54vista, cuadro de diálogo 55

Hhoja de trabajo

botón de acción 5funciones 193

II_EXPORT 172I_NAMES 173I_PROCESS 174If 284IF 148importar 51imprimir 51insertar referencia de cubo 54INSRT 159INT 151ISUND 151ISUNDEFINEDCELLVALUE 121ItemReject 285ItemSkip 286

Jjaponés 52juego de caracteres 221juegos de caracteres grandes 52

KKEY_ERR 193

Índice 373

Llectura

asignaciones de seguridad 56LN 152LOG 152lógicas

funciones de reglas 147lógicos

operadores 112LONG 160LOWER 160

MM_CLEAR 174marcadores 52MAX 153MDX

expresiones específicas de TM1 366funciones 361funciones específicas de TM1 363

menú Archivoatributos 10Cube Viewer 26Editor de TurboIntegrator 83Server Explorer 61ventana Registro de mensajes 42

menú Ayudaventana Registro de mensajes 43

menú dinámicoServer Explorer 61

menú Editaratributos 11Cube Viewer 27Editor de dimensiones 29Editor de subconjuntos 75Editor de TurboIntegrator 83resultados de la consulta del registro de transacciones 82Server Explorer 73ventana Registro de mensajes 43

menú Gruposclientes/grupos 21

menú HerramientasEditor de subconjuntos 79

Menú Navegador de hojas de cálculo 41menú Ver

Cube Viewer 27Editor de dimensiones 32Editor de subconjuntos 78Server Explorer 73

MetadataMinorErrorCount 358metadatos

Editor de TurboIntegrator 106método Ejecutar 168miembro

ANCESTORS 366expresiones MDX 361funciones MDX 361

MIN 153MinorErrorLogMax 353MOD 153módulos VBA

funciones de macro 168MONTH 127

NN_CONNECT 175N_DISCONNECT 176NewDateFormatter 263ninguno

Asignaciones de seguridad 56no aplicar sangría 52NOW 127nuevo atributo, cuadro de diálogo 43NumberToString 342NumberToStringEx 342NUMBR 161NumericGlobalVariable(VariableName) 357numérico

funciones MDX 361NumericSessionVariable(VariableName) 359números de línea 53NValue 351

OODBCClose 278ODBCOpen 278ODBCOPENEx 279ODBCOutput 279omitir parámetros

extracción de vistas 108OnMinorErrorDoItemSkip 352opciones

atributos 11menú Cube Viewer 28propiedades de elementos de dimensiones 35

operadores aritméticos 111OPTGET 175optimizar cubos 25OPTSET 176

Ppanel de la derecha (panel Propiedades)

Server Explorer 61panel de la izquierda (panel de árbol)

Server Explorer 61parámetros

Editor de TurboIntegrator 106parámetros de inicio de sesión

opciones de TM1 79parámetros de rango

extracción de vistas 108ParseDate 264PAYMT 146pestaña Correlaciones del Editor de TurboIntegrator 101pestaña Planificación

Editor de TurboIntegrator 108pestañas

Editor de TurboIntegrator 84preferencias 54proceso

botón de acción 4funciones de TurboIntegrator de control 281Server Explorer 72

ProcessBreak 286ProcessError 281, 286ProcessQuit 287ProcessReturnCode 358PrologMinorErrorCount 359


prólogoEditor de TurboIntegrator 106

propiedadesconfiguración regional 11de elementos de dimensiones, panel 35panel Editor de dimensiones 29panel Editor de subconjuntos 74

propiedades de configuración regional 11PublishSubset 178PublishView 178, 326PV 147

QQUDEFINE 179QUDEFINEEX 181QUEXPORT 183QULOOP 185QUSUBSET 185

RR_SAVE 186RAND 154RefreshMdxHierarchy, función 343regiones definidas por el usuario 53registro de auditoría

ventana 13ventana de detalles 18

registro de mensajesventana 42

reglafunciones 111funciones de macro 167funciones de TurboIntegrator de gestión 289información del Editor de subconjuntos 49

RemoveCAMIDAssociation 308RemoveCAMIDAssociationFromGroup 308RemoveClientFromGroup 309replicar

Server Explorer 71replicar cubo

cuadro de diálogo 49Server Explorer 71

reservaasignaciones de seguridad 58

ROUND 154ROUNDP 155RuleLoadFromFile 292

Ssangría 52SAPCharacteristicTexts 348SaveDataAll 316SCAN 161SecurityOverlayCreateGlobalDefault 309SecurityOverlayDestroyGlobalDefault 310SecurityRefresh 311seguridad

Asignaciones de, cuadro de diálogo 55funciones de TurboIntegrator 302menú de Clientes/Grupos 20

seleccionar cubocuadro de diálogo 60para reglas, cuadro de diálogo 60

seleccionar dimensiónasignaciones de seguridad 60cuadro de diálogo 60cuadro de diálogo de hoja de trabajo 60

seleccionar elementocuadro de diálogo 61extracción de vistas 108

seleccionar reglacuadro de diálogo de hoja de trabajo 61

ServerActiveSandboxGet 298ServerActiveSandboxSet 299ServerSandboxesDelete 294ServerSandboxExists 300ServerSandboxGet 301ServerSandboxListCountGets 301ServerShutdown 318servidor

Explorer (ventana principal) 61funciones de manipulación de TurboIntegrator 312Server Explorer 62

servidor localopciones de TM1 80

SetChoreVerboseMessages 244SetInputCharacterSet 221SetODBCUnicodeInterface 280SetOutputEscapeDoubleQuote 225SetUseActiveSandboxProperty 299SIGN 156SIN 156sintaxis 287SQRT 156STET 148, 219STR 162StringGlobalVariable(VariableName) 357StringSessionVariable(VariableName) 359StringToNumber 344StringToNumberEx 344subconjunto

editor 74funciones de manipulación de TurboIntegrator 318menú Editor de subconjuntos 75Server Explorer 70

SUBDEFINE 187SUBNM 209SUBPICK 187SubsetAliasSet 318SubsetCreate 319SubsetCreateByMDX 319SubsetDeleteAllElements 320SubsetDestroy 320SubsetElementDelete 321SubsetElementInsert 321SubsetExists 322SubsetExpandAboveSet 322SubsetFormatStyleSet 323SubsetGetElementName 324SubsetGetSize 324SubsetIsAllSet 325SUBSIZ 210SUBST 162SValue 352synchronized() 287

TT_CLEAR 188T_CREATE 189

Índice 375

T_CREATE16 189T_PICK 190T_SAVE 190TABDIM 139, 210TAN 157tarea 356

abandonar 244asistente para la configuración 19funciones de TurboIntegrator de gestión 243Server Explorer 72, 73

TextOutput 226TIME 127TIMST 128TIMVL 130TM1DRILLDOWNMEMBER 363TM1FILTERBYLEVEL 363TM1FILTERBYPATTERN 363TM1Member 364Tm1p.xla 167TM1ProcessError.log 344TM1RECALC 191TM1RECALC1 191TM1RptElIsConsolidated 211TM1RPTELISCONSOLIDATED 217TM1RptElIsExpanded 211TM1RptElLev 212TM1RPTELLSEXPANDED 217TM1RptFilter 212TM1RptRow 213TM1RptTitle 215TM1RptView 216TM1SORTBYINDEX 364TM1SUBSETALL 364TM1SubsetToSet 365TM1TupleSize 365TM1User 217, 345todas las pantallas

asistente de informes de impresión 44TODAY 132TRIM 163TurboIntegrator 83, 316

funciones 219límites 219variables de usuario 359variables globales 356

UUNDEFINEDCELLVALUE 122UPPER 163UTF-8 221

VValue_Is_String 351

variablesde usuario de TurboIntegrator 359global 356globales implícitas 357pestaña del editor de TurboIntegrator 100

variables globales 356variables globales implícitas 357variables locales 347varios

funciones de reglas 163funciones de TurboIntegrator 337

ventana Detalles del registro de auditoría 18ventana Registro de auditoría 13ventana Registro de mensajes 42ventanas y cuadros de diálogo 3VIEW 217ViewColumnDimensionSet 327ViewColumnSuppressZeroesSet 327ViewConstruct 328ViewCreate 328ViewDestroy 329ViewExists 329ViewExtractSkipCalcsSet 330ViewExtractSkipRuleValuesSet 331ViewExtractSkipZeroesSet 332ViewRowDimensionSet 332ViewRowSuppressZeroesSet 333ViewSubsetAssign 334ViewSuppressZeroesSet 334ViewTitleDimensionSet 335ViewTitleElementSet 336ViewZeroOut 336vista

cuadro de diálogo de estilos 109funciones de manipulación de TurboIntegrator 325ventana de extracción 108

vista previa de cuadrículaeditor de TurboIntegrator 100

VUSLICE 191

WW_DBSENABLE 192While 287WildcardFileSearch 345

YYEAR 133


IBM CognosTM1 Versión 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/es/1… ·...

Documents

Transcript of IBM CognosTM1 Versión 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/es/1… ·...