Guia Turbo Integrator

IBM Cognos TM1
Versin 9.5.1
Gua de TurboIntegrator
Informacin sobre el producto

Este documento se aplica a IBM Cognos TM1 Versin 9.5.1 y puede tambin aplicarse a las siguientes releases. Para comprobar las versiones nuevas de este documento, visite los IBM Cognos Information Centers (http://publib.boulder.ibm.com/infocenter/cogic/v1r0m0/index.jsp).
Copyright
Materiales bajo Licencia - Propiedad de IBM Copyright IBM Corp. 2007, 2010. US Government Users Restricted Rights El uso, la duplicacin o la revelacin estn restringidos por el Contrato GSA ADP Schedule con IBM Corp. IBM, el logotipo de IBM, ibm.com, TM1, y Cognos son marcas registradas o marcas comerciales registradas de International Business Machines Corp. en muchas jurisdicciones de todo el mundo. Otros nombres de productos y servicios pueden ser marcas registradas de IBM o de otras empresas. Hay disponible una lista de marcas registradas de IBM en la web en www.ibm.com/legal/copytrade.shtml. Microsoft, Windows, Windows NT y el logotipo de Windows son marcas registradas de Microsoft Corporation en los Estados Unidos o en otros pases. UNIX es una marca registrada de The Open Group en los Estados Unidos o en otros pases.
ndice
Introduccin
7 9
Captulo 1: Informacin bsica de TurboIntegrator
Fuentes de datos disponibles con TurboIntegrator 9 Lmite de longitud de cadena en TurboIntegrator 9 Importacin de opciones 10 Funciones de TurboIntegrator 10 Procesos y tareas 10 Orden de operaciones en un proceso TurboIntegrator 11 Apuntes sobre los procesos TurboIntegrator 12 Conexiones simultneas al mismo Servidor TM1. 12 Alias en funciones de TurboIntegrator 13 Utilizacin de espacios de trabajo personales y modos de prueba con procesos TurboIntegrator 13 Ejecucin manual de un proceso TurboIntegrator con un espacio de trabajo personal o un modo de prueba 13 Utilizacin de las funciones de TurboIntegrator con modos de prueba 14 Captulo 2: Importacin de un archivo de texto
15
Creacin de una dimensin desde un archivo de texto 15 Definicin de una fuente datos 15 Identificacin de variables en la fuente de datos 17 Asignacin de variables 20 Guardar y ejecutar el proceso TurboIntegrator 22 Creacin de un cubo desde un archivo de texto 23 Definicin de la fuente de datos del cubo 23 Definicin de variables de cubo 24 Asignacin de variables de cubo 24 Asignacin de variables de elemento de cubo a dimensiones 25 Asignacin de variables de datos de cubo 25 Asignacin de variables de consolidacin 25 Guardar y ejecutar el proceso de cubo 26 Captulo 3: Importacin desde una fuente ODBC
27
Unicode y DSN 27 Definicin de una fuente de datos ODBC 27 Generacin de un proceso TurboIntegrator a partir de una instruccin MDX 28 Construccin del proceso MDX de TurboIntegrator 28 Captulo 4: Importacin desde un subconjunto o vista TM1
31
Utilizacin de una vista de cubo TM1 como fuente de datos 31 Crear un proceso de cubo 31 Utilizacin de un subconjunto TM1 como fuente de datos 32 Definir subconjunto de dimensin como fuente de datos 32 Definir variables de dimensin 32 Licensed Materials Property of IBM Copyright IBM Corp. 2007, 2010.
ndice Asignacin de variables de dimensin 33 Guardar y ejecutar la dimensin 34 Captulo 5: Importacin desde MSAS
35
Base de datos OLE para fuentes de datos OLAP 35 Nombre del proveedor ODBO 35 Ubicacin de ODBO 35 Fuente de datos ODBO 35 Catlogo ODBC 35 Cadenas de conexin: MSAS frente a TM1 36 Conexin a una base de datos OLE para fuente de datos OLAP cuando utiliza autenticacin CAM 37 Importacin de un cubo MAS 37 Conexin a Analysis Services con TurboIntegrator 38 Especificar el cubo con la pestaa Cargar cubo ODBC 39 Uso de la pestaa Dimensiones de cubo 40 Guardar y ejecutar el proceso MAS 40 Importacin de una dimensin MAS 41 Definicin de parmetros de conexin MAS 42 Uso de la pestaa Cargar dimensin de ODBO 43 Guardar y ejecutar el proceso MAS de la dimensin 44 Registro de mensajes de TM1 44 Captulo 6: Importacin de datos utilizando TM1 Connector for SAP Business Warehouse Objetos SAP y terminologa 45 Objetos anlogos en SAP y TM1 45 Jerarqua de objeto SAP 46 Requisitos previos del software TM1 Connector for BW SAP 46 El archivo Saprfc.ini y las libreras RFC 46 Microsoft Windows (x86) 46 Microsoft Windows (x86, x64) 47 UNIX (Sun Solaris, IBM AIX) 47 Instalacin de la interfaz de TM1 en BW SAP 48 Importacin de un InfoCube desde SAP 48 Establecimiento de una conexin con BW SAP 49 Asignacin de un InfoCube SAP a un cubo TM1 50 Asignacin de caractersticas SAP a dimensiones TM1 52 Establecimiento de restricciones de caractersticas 55 Seleccin de parmetros de caractersticas 57 Guardar y ejecutar el proceso SAP TurboIntegrator 58 Ver los resultados 58 Importacin de una caracterstica desde SAP 59 Asignacin de una caracterstica SAP a una dimensin TM1 60 Importacin de seguridad desde SAP 62 Seleccin de las definiciones de seguridad SAP que desea importar 63 Importacin y conversin de datos de divisa desde SAP 64 Asignacin de divisas de SAP a cubos y dimensiones de TM1 64 Importacin de una tabla SAP 67 Creacin de una consulta de tabla SAP 67 Identificacin y asignacin de variables 68 4 IBM Cognos TM1
45
ndice Escritura de datos TM1 en SAP 68 Asignacin de dimensiones y valores de una vista TM1 a una tabla ODS 69 Captulo 7: Importacin de datos a travs de IBM Cognos TM1 Package Connector
73
Establecimiento de una conexin al servidor Cognos BI 73 Conexin a paquetes publicados 74 Importacin de una nica dimensin 79 Guardar y ejecutar el proceso TurboIntegrator 80 Ver los resultados 80 Directrices para trabajar con datos BW SAP 81 Cmo trabajar con datos BW SAP utilizando un paquete de Framework Manager 81 Especificacin de una solicitud de segmentacin para una consulta BW SAP 89 Realizacin de consultas paralelas con una solicitud de segmentador 89 Captulo 8: Edicin de tareas y procedimientos avanzados
91
Utilizacin del modo de carga de gran volumen 91 Aspectos que debe tener en cuanta al utilizar el modo de carga de gran volumen 91 Comandos del proceso TurboIntegrador para el modo de carga de gran volumen 92 Funciones API C de TM1 para el modo de carga de gran volumen 93 Edicin de procedimientos 93 Ejecucin de un proceso a peticin 94 Programacin de un proceso para la ejecucin automtica con tareas 94 Nota importante sobre las horas de inicio de las tareas 96 Edicin de una tarea 97 Activacin de una tarea 97 Desactivacin de una tarea 97 Borrar una tarea 97 Ejecucin de una tarea a peticin 97 Apndice A: TurboIntegrator Tutorial
99
Configuracin del directorio de datos del tutorial 99 Descripcin general de TurboIntegrator 99 Creacin de un proceso TurboIntegrator 100 Creacin de dimensiones utilizando TurboIntegrator 101 Creacin de un cubo y procesar datos 109 Scripts avanzados 116 Edicin de los procedimientos de Prlogo, Metadatos, Datos y Eplogo 116 Creacin de subconjuntos 125 Creacin de atributos 126 Apndice B: Palabras reservadas de TurboIntegrator Nombres de funciones de regla 129 Nombres de funciones de proceso 132 Nombres de variables implcitas 137 Palabras clave de TurboIntegrator 138 ndice
129
139
Gua de TurboIntegrator 5
ndice
6 IBM Cognos TM1
Introduccin
Este documento se ha concebido para utilizarse con IBM Cognos TM1 Este manual describe cmo utilizar TurboIntegrator IBM Cognos TM1 de Cognos para importar datos y metadatos a TM1 desde varias fuentes. Business Performance Management realiza la gestin y supervisin continua del rendimiento financiero, operacional, de clientes y organizativo de toda la empresa. Las soluciones de Business Performance Management cuentan con las siguientes funciones para facilitar la gestin proactiva de los negocios: Amplia implementacin Toma de decisiones colaborativa Revisin y mejoras continuas y a tiempo real Control de los indicadores de rendimiento clave
IBM Cognos TM1 integra planificacin del negocio, medida del rendimiento y datos operacionales para permitir que las empresas puedan optimizar la efectividad de sus negocios y la interaccin con los clientes, independientemente de su geografa o estructura. TM1 proporciona visibilidad inmediata de los datos, responsabilidad dentro de un proceso de colaboracin y una visin de la informacin coherente, permitiendo a los gerentes estabilizar rpidamente fluctuaciones operativas y aprovechar las nuevas oportunidades.
Audiencia
La Gua de TurboIntegrator IBM Cognos TM1 est pensaba para los usuarios de TM1 con conocimientos bsicos sobre cmo estn estructurados los datos para importar a TM1.
Bsqueda de informacin
Para buscar la documentacin de producto ms actual, incluida toda la documentacin traducida, acceda a uno de los centros de informacin de IBM Cognos en http://publib.boulder.ibm.com/ infocenter/cogic/v1r0m0/index.jsp. Asimismo, puede consultar las versiones PDF de las notas de la versin y las guas de instalacin de los productos directamente en los discos de los productos IBM Cognos.
Declaracin de limitacin de responsabilidad de los ejemplos

Viaje de aventuras, Ventas de VA, cualquier variante del nombre de Viaje de aventuras, y Ejemplo de planificacin, representan operaciones de negocio ficticias con datos de ejemplo utilizadas para desarrollar aplicaciones de ejemplo para IBM y los clientes de IBM. Estos registros ficticios incluyen datos de muestra para transacciones comerciales, distribucin de productos, finanzas y recursos humanos. Cualquier parecido con nombres, direcciones, nmeros de contacto o valores de transaccin reales es una mera coincidencia. Otros archivos de ejemplo pueden contener datos ficticios generados manual o informticamente, datos relativos a hechos procedentes de orgenes pblicos o acadmicos, Licensed Materials Property of IBM Copyright IBM Corp. 2007, 2010.
Introduccin o datos utilizados con el permiso del poseedor del copyright, para utilizarlos como datos de ejemplo para desarrollar las aplicaciones de ejemplo. Los nombres de los productos a los que se hace referencia pueden ser marcas comerciales de sus respectivos propietarios. Queda prohibida la duplicacin no autorizada.
Funciones de accesibilidad
Este producto no admite actualmente funciones de accesibilidad que ayuden a los usuarios con discapacidad fsica, como movilidad o visin limitada, a utilizar este producto.
8 IBM Cognos TM1
Captulo 1: Informacin bsica de TurboIntegrator

Esta seccin describe informacin bsica sobre cmo importar datos a un cubo IBM Cognos TM1 utilizando TurboIntegrator. TurboIntegrator le permite disear un proceso que reconozca la estructura de datos de la fuente y la transforme en la estructura apropiada que necesita TM1. Una vez diseado el proceso TI, puede volver a ejecutarlo o programarlo para que se utiliza cuando importe datos desde una fuente dinmica. Las secciones siguientes describen los pasos a seguir para importar datos desde tipos especficos de fuentes. Antes de empezar a utilizar TurboIntegrator, asegrese de comprender esta informacin, que se aplica a todos los tipos de fuentes: "Fuentes de datos disponibles con TurboIntegrator" (p. 9). "Lmite de longitud de cadena en TurboIntegrator" (p. 9). "Importacin de opciones" (p. 10). "Funciones de TurboIntegrator" (p. 10). "Procesos y tareas" (p. 10). "Orden de operaciones en un proceso TurboIntegrator" (p. 11). "Apuntes sobre los procesos TurboIntegrator" (p. 12).
Fuentes de datos disponibles con TurboIntegrator

Utilizando TurboIntegrator TM1, puede importar datos de estas fuentes de datos: Archivos de texto delimitados por comas que incluyen archivos ASCII. Tablas de bases de datos relacionales a las que se puede acceder a travs de una fuente de datos ODBC. Otras vistas y cubos TM1. Microsoft Analysis Services. SAP mediante RFC.
Consulte las otras secciones de este manual para obtener informacin acerca de estos tipos de fuentes.
Lmite de longitud de cadena en TurboIntegrator

TurboIntegrator es capaz de tratar datos de cadena de un tamao de hasta 8000 caracteres de un byte de forma simultnea. Se aplica este lmite cuando su proceso informtico est realizando
Licensed Materials Property of IBM Copyright IBM Corp. 2007, 2010.
Captulo 1: Informacin bsica de TurboIntegrator acciones como por ejemplo asignar un valor a una variable o importar registros de datos. Cualquier valor o registro superior a los 8000 caracteres de un byte se trunca. Por ejemplo, si est importando lneas de datos desde un archivo de texto, cada lnea de texto no puede superar los 8000 caracteres de longitud. Si est importando datos desde un archivo separado por comas, cada registro del archivo no puede superar los 8000 caracteres de longitud.
Importacin de opciones
Cuando importa datos a TM1 utilizando TurboIntegrator, tiene las siguientes opciones: Crear un cubo y completarlo con datos importados de la fuente. Recrear un cubo. Destruye un cubo existente y vuelve a crearlo, permitindole cambiar los datos y los metadatos durante la importacin. Actualizar un cubo existente manteniendo su estructura. Le permite importar datos a una estructura de cubo existente. Crear una dimensin en TM1 a partir de datos importados de una fuente. Actualizar una dimensin en TM1 a partir de datos importados.
Puede utilizar TurboIntegrator para realizar cualquier combinacin de estas acciones.
Funciones de TurboIntegrator
TurboIntegrator incluye una serie de funciones que le permiten manipular cubos, vistas, dimensiones, elementos y otros objetos TM1 mientras importa datos. Adems de estas funciones de TurboIntegrator, puede incorporar todas las funciones de reglas TM1 estndar en un proceso TurboIntegrator, excepto la funcin STET. Las funciones de TurboIntegrator se describen en Funciones de TurboIntegrator TM1 en la Gua de referencia de IBM Cognos TM1.
Procesos y tareas
Importe datos con TurboIntegrator definiendo un proceso. Un proceso es un objeto TM1 que consta de: Una descripcin de una fuente de datos. Un conjunto de variables correspondientes a cada columna de la fuente de datos. Un conjunto de asignaciones que define la relacin entre variables y estructuras de datos en la base de datos de TM1. Un procedimiento de Prlogo, que consiste en una serie de acciones que se deben ejecutar antes de procesar la fuente de datos.
10 IBM Cognos TM1
Captulo 1: Informacin bsica de TurboIntegrator Un procedimiento de Metadatos, que consiste en una serie de acciones que actualizan o crean cubos, dimensiones y otras estructuras de metadatos. Un procedimiento de Datos, que consiste en una serie de acciones que actualizan o transforman los datos de su base de datos TM1. Un procedimiento de Eplogo que se ejecutar tras procesar la fuente de datos. Un conjunto de parmetros que se pueden utilizar para generalizar un proceso, de manera que se pueda utilizar en mltiples situaciones.
Las Tareas son un objeto contendor para un conjunto de procesos de TM1. Las tareas le permiten ejecutar procesos en un orden concreto, y programar procesos para que se ejecuten a una hora determinada. Para obtener ms informacin, consulte Edicin de tareas y procedimientos avanzados.
Orden de operaciones en un proceso TurboIntegrator

Un proceso TurboIntegrator incluye varios procedimientos: Prlogo, Metadatos, Datos y Eplogo. Estos procedimientos se pueden ver como subpestaas de la pestaa Avanzado en el editor de TurboIntegrator. Cuando define una fuente de datos, establece variables y especifica acciones de datos para un proceso, TM1 genera scripts que se ejecutan al iniciar el proceso TurboIntegrator. Estos scripts se encuentran en la subpestaa de procedimiento correspondiente en el editor de TurboIntegrator. Tambin puede crear sus propios scripts en cualquiera de las subpestaas de procedimientos, utilizando las reglas y funciones de TurboIntegrator. Cuando inicia un proceso TurboIntegrator, los procedimientos se ejecutan en la siguiente secuencia: 1. El procedimiento de Prlogo se ejecuta antes de que se abra la fuente de datos para el proceso TurboIntegrator. 2. Si la fuente de datos del proceso es Ninguna, TurboIntegrator ejecutar inmediatamente el procedimiento de Eplogo tras finalizar el proceso de Prlogo. Nota: cuando la fuente de datos de un proceso es Ninguna, se ignoran los procedimientos de Metadatos y Datos. En este caso, todos los scripts para el proceso deben crearse en los procedimientos de Prlogo o Eplogo. 3. Si la fuente de datos es distinta de Ninguno, TurboIntegrator abre la fuente de datos del proceso. 4. Todas las lneas del procedimiento Metadatos se ejecutan de forma secuencial segn el primer registro de la fuente de datos. Todas las lneas se ejecutan de forma secuencial segn el segundo registro de la fuente de datos y as sucesivamente hasta que se han procesado todos los registros. 5. Todas las lneas del procedimiento de Datos se ejecutan de forma secuencial segn el primer registro de la fuente de datos. Todas las lneas se ejecutan de forma secuencial segn el segundo registro de la fuente de datos y as sucesivamente hasta que se han procesado todos los registros. 6. TurboIntegrator cierra la fuente de datos tras finalizar el procedimiento de Datos. 7. Se ejecuta el procedimiento de Eplogo. Gua de TurboIntegrator 11
Captulo 1: Informacin bsica de TurboIntegrator 8. TM1 cierra el proceso TurboIntegrator.
Apuntes sobre los procesos TurboIntegrator

Tenga en cuenta los siguientes elementos al crear y editar procesos TurboIntegrator. TurboIntegrator compila una dimensin nueva o alterada slo al finalizar un procedimiento en el que se crea o altera la dimensin. En el caso de una dimensin nueva, significa que no puede acceder a la nueva dimensin (a travs de TurboIntegrator o de otro modo) hasta que el procedimiento en el que se ha creado la dimensin haya terminado de procesar todos los registros de la fuente de datos. En el caso de una dimensin alterada, significa que no puede acceder a ningn elemento nuevo de la dimensin hasta que el procedimiento en el que se ha alterado la dimensin haya terminado de procesarse. La funciones de reglas y TurboIntegrator (a excepcin de STET) se pueden utilizar en cualquier procedimiento de un proceso. Adems, no hay restricciones respecto a qu funciones se pueden utilizar en un procedimiento concreto, todas las funciones son vlidas en cualquier procedimiento de TurboIntegrator. Consulte "Frmulas" en el captulo Introduccin a las reglas de IBM Cognos TM1 Rules Guide para obtener ms informacin sobre cmo utilizar diferentes tipos de operadores, como por ejemplo, operadores lgicos y aritmticos de reglas y procesos TI.
Sin embargo, debe crear una secuencia lgica de funciones para asegurar que el proceso cumple su objetivo. Por ejemplo, si desea construir un proceso que aada nuevos elementos a una dimensin y actualice los valores de datos de los nuevos elementos, debe asegurarse de que el proceso aade los nuevos elementos y compila la dimensin antes de intentar actualizar los valores de datos de los elementos nuevos. En la mayora de los casos, aadir los elementos nuevos en el procedimiento de Metadatos utilizando la funcin DimensionElementInsert, y a continuacin actualizar los valores en el procedimiento Datos utilizando la funcin CellPutN. Utilizando el ejemplo anterior, si intenta construir un proceso en el que los dos elementos nuevos se aadan y que los valores de datos correspondientes se actualicen en el procedimiento de Datos, fallar el proceso. El fallo se produce porque, como se indica anteriormente, las dimensiones alteradas se compilan slo al finalizar el procedimiento. Hasta que se haya compilado la dimensin, no existen los elementos nuevos. TurboIntegrator no puede actualizar los valores de datos de elementos que no existen, y por lo tanto, el proceso falla.
Conexiones simultneas al mismo Servidor TM1.

No lleve a cabo operaciones en un proceso TurboIntegrator que cree una nueva conexin al mismo servidor TM1 en el que se est ejecutando el proceso. Este tipo de entorno puede provocar una situacin de bloqueo entre dos conexiones o subprocesos y, en consecuencia, que el servidor TM1 no responda o se bloquee. Por ejemplo, evite los siguientes entornos:
12 IBM Cognos TM1
Captulo 1: Informacin bsica de TurboIntegrator No utilice un proceso TI para enviar una consulta ODBO MDX (a travs del proveedor MD de base de datos OLE de TM1 Applix) al mismo servidor TM1. Este entorno puede provocar que tanto el proceso como la consulta estn a la espera de que el otro termine. No utilice la funcin TI, ExecuteCommand, para solicitar que se ejecute el proceso TI y espere (argumento Wait establecido en 1) a que un programa externo vuelva a conectarse al mismo servidor TM1. Esto incluye cualquier aplicacin personalizada o cualquier aplicacin de IBM Cognos, como por ejemplo la utilidad ETLDAP de TM1, que podra volver a conectarse al mismo servidor TM1. Tenga en cuenta que al utilizar la funcin ExecuteCommand con el argumento Wait establecido en 1, corre el riesgo de que el servidor TM1 no responda incluso si el programa externo no se vuelve a conectar al mismo servidor. Si el mismo programa externo encuentra problemas y no responde, el proceso TI bsicamente no responde a la espera de que se termine de ejecutar el programa externo.
Alias en funciones de TurboIntegrator

En reglas o en funciones de TurboIntegrator es posible utilizar un nombre de alias en lugar del nombre principal del elemento correspondiente.
Utilizacin de espacios de trabajo personales y modos de prueba con procesos TurboIntegrator

Esta seccin describe cmo utilizar espacios de trabajo personales y modos de prueba con funciones y procesos TurboIntegrator.
Ejecucin manual de un proceso TurboIntegrator con un espacio de trabajo personal o un modo de prueba
Seleccionando la propiedad Utilizar el modo de prueba activo para dicho proceso puede ejecutar manualmente un proceso con el modo de prueba actualmente activo en Server Explorer. El modo de prueba activo est determinado por el modo de prueba actualmente seleccionado en el Visor de cubos. En los espacios de trabajo personales, el nico modo de prueba disponible es [Por defecto]. Nota: las tareas y los procesos que contienen no se pueden ejecutar en un espacio de trabajo personal ni en un modo de prueba. Cuando un proceso se ejecuta como parte de una tarea, solo puede ejecutarse sobre datos bsicos.
Pasos
1. En Server Explorer, abra una vista en el Visor de cubos. 2. Haga clic en el modo de prueba en la lista de modos de prueba disponibles para seleccionar el modo de pruebas que desea utilizar con el proceso. 3. En el panel de rbol, haga clic con el botn derecho del ratn en el proceso, y haga clic en Utilizar el modo de prueba activo para habilitar esta opcin. 4. Haga clic con el botn derecho del ratn en el proceso y seleccione Ejecutar.
Captulo 1: Informacin bsica de TurboIntegrator Se ejecutar el proceso utilizando el modo de prueba activo actual.
Utilizacin de las funciones de TurboIntegrator con modos de prueba

Las siguientes funciones de TurboIntegrator permiten a los procesos TurboIntegrator interactuar con espacios de trabajo personales y modos de prueba. GetUseActiveSandboxProperty SetUseActiveSandboxProperty ServerActiveSandboxGet ServerActiveSandboxSet
Estas funciones son similares a la propiedad Utilizar el modo de prueba activo disponible en la interfaz de Server Explorer. Para obtener ms informacin, consulte la seccin que trata sobre las funciones del modo de prueba de TurboIntegrator en la Gua de referencia de IBM Cognos TM1.
14 IBM Cognos TM1
Captulo 2: Importacin de un archivo de texto

Esta seccin describe cmo importar datos de texto delimitado por comas, como por ejemplo ASCII, con IBM Cognos TM1 TurboIntegrator. A pesar de que cada proceso TM1 es nico y la importacin desde otros tipos de datos vara levemente, esta seccin describe los pasos comunes a la mayora de los procesos. Los procedimientos y ejemplos utilizan el archivo NewEngland.cma, que se instala como parte de los datos de muestra incluidos en TM1.
Creacin de una dimensin desde un archivo de texto

Puede utilizar TurboIntegrator para crear una dimensin a partir de una lista de nombres de elementos de una fuente de datos. sta es la forma ms rpida de crear una dimensin que contenga cientos o miles de elementos. Al crear una dimensin con TurboIntegrator, se define un proceso que se guarda como un objeto en su servidor TM1. A este proceso pueden acceder otros usuarios, y se puede ejecutar a peticin o en un intervalo programado. Para crear una dimensin con TurboIntegrator: Defina la fuente de datos para TM1. Consulte "Definicin de una fuente datos" (p. 15). Identifique las variables que TM1 encontrar. Consulte "Identificacin de variables en la fuente de datos" (p. 17). Asigne las variables a sus tipos de datos. Consulte "Asignacin de variables" (p. 20). Guarde el proceso y ejectelo. Consulte "Guardar y ejecutar el proceso TurboIntegrator" (p. 22).
Definicin de una fuente datos

Siempre que utilice TurboIntegrator, el primer paso requiere que defina la fuente de datos desde la que leer los datos. Este ejemplo define el archivo ASCII llamado NewEngland.cma como la fuente de datos para este proceso TurboIntegrator.
Pasos
1. Haga clic con el botn derecho del ratn en Procesos en el panel izquierdo de Server Explorer y seleccione Procesos, Crear nuevo proceso. 2. Haga clic en Texto en la pestaa Fuente de datos. Se abrir la ventana TurboIntegrator. 3. Haga clic en Examinar. Se abrir el cuadro de dilogo Seleccionar archivo de entrada. 4. Desplcese hasta NewEngland.cma, seleccinelo y haga clic en Abrir.
15
Captulo 2: Importacin de un archivo de texto NewEngland.cma est disponible en el directorio de datos de muestra PData o SData. Si acept el directorio de instalacin predeterminado para TM1, la ruta completa hasta el archivo es
C:\Program Files\Cognos\TM1\Custom\TM1Data\SData\NewEngland.cma
o bien,
C:\Program Files\Cognos\TM1\Custom\TM1Data\PData\NewEngland.cma.
Puede que reciba un mensaje que le indique que debera utilizar la Convencin de nomenclatura universal (UNC) para especificar la ubicacin del archivo. Si va a ejecutar sistemticamente el proceso con un archivo ASCII debera utilizar UNC y asegurarse de lo siguiente: Si trabaja con un servidor TM1 de Windows, el archivo ASCII debera encontrarse en un directorio de Windows compartido, de modo que el servidor TM1 pueda acceder a l. Si trabaja con un servidor TM1 UNIX, el archivo debera encontrarse en un directorio compartido de red, que pueda ver tanto el cliente TM1 Windows como el servidor TM1 UNIX.
Nota: si est ejecutando un servidor TM1 UNIX, el nombre del archivo origen de entrada no puede contener caracteres en maysculas ni espacios. 5. Haga clic en Aceptar en el cuadro de advertencia. 6. Complete el cuadro de dilogo TI de la forma siguiente: NewEngland.cma es una fuente delimitada que utiliza comas como delimitador; comillas dobles como carcter de comillas; sin registros de ttulo; la coma como separador decimal y el punto como separador de millares. Para definir esta fuente introduzca la configuracin siguiente: En Tipo de delimitador, seleccione Delimitado. Seleccione Coma como el Delimitador. Introduzca " en Carcter de comillas. Deje en blanco el campo Nmero de registros de ttulos. Introduzca . en Separador decimal. Introduzca , como Separador de millar.
7. Haga clic en Vista previa. TurboIntegrator muestra un ejemplo de sus datos de origen en la parte inferior de la ventana.
16 IBM Cognos TM1
Uso de registros de longitud fija

TurboIntegrator tambin puede importar datos de archivos de texto que utilicen campos de ancho fijo. Para especificar que la fuente de datos cuenta con campos de ancho fijo, y tras especificar la ubicacin de su archivo de fuente de datos, seleccione el Tipo de delimitador de Ancho fijo y, a continuacin, haga clic en Establecer el ancho de campo. El cuadro de dilogo Previsualizacin de datos muestra los tres primeros registros de sus datos de origen. Para establecer anchos de campo segn el contenido de los registros de su fuente de datos:
Pasos
1. Haga clic en el encabezado de columna 1. Se muestra un salto de lnea en el encabezado de la columna y se extiende a los tres registros. 2. Haga clic en el salto de lnea y arrstrelo a la posicin que separa la primera columna de la segunda. Se muestra un nuevo encabezado de columna (2). 3. Haga clic en el encabezado de columna 2 y arrastre el nuevo salto de lnea a la posicin que separa la segunda columna de la tercera. 4. Establezca saltos de lnea para el resto de columnas de la fuente de texto. 5. Haga clic en Aceptar para volver a la ventana TurboIntegrator.
Identificacin de variables en la fuente de datos

Tras definir una fuente de datos, TurboIntegrator asigna una variable a cada una de las columnas de la fuente. Debe identificar estas variables por tipo y contenido. Gua de TurboIntegrator 17
Captulo 2: Importacin de un archivo de texto Para ilustrar este proceso, tenga en cuenta los siguientes datos de texto: New England, Massachusetts, Boston, Supermart, Feb, 2000000 New England, Massachusetts, Springfield, Supermart, Feb, 1400000 New England, Massachusetts, Worcester, Supermart, Feb, 2200000 New England, Connecticut, Hartford, Supermart, Feb, 1240000 New England, Connecticut, New Haven, Supermart, Feb, 2700000 New England, Connecticut, Greenwich, Supermart, Feb, 1700000 Las 3 primeras columnas forman una jerarqua para la dimensin Location, que construir a partir del archivo de texto fuente. La nueva consolidacin New England se encuentra en la parte ms alta de la jerarqua. Los estados de Massachusetts y Connecticut se encuentran un nivel por debajo de New England. La tercera columna, que contiene nombres de ciudades como Boston y Hartford, proporciona elementos sencillos en el nivel ms bajo de la jerarqua. Las columnas restantes no se utilizan para la creacin de la dimensin Location.
Aqu se incluye la pestaa Variables en la ventana TurboIntegrator para esta estructura de datos:
TurboIntegrator asigna un nombre de variable a cada columna y asigna un tipo de variable basado en el valor de muestra de cada columna. Los nombres de variable por defecto, como V1 y Massachusetts se pueden cambiar. Una prctica recomendada es asignar a las variables un nombre significativo. Los nombres significativos facilitan la lectura y la resolucin de problemas de los scripts de TurboIntegrator. Para editar el nombre de una variable, haga clic sobre el nombre en la columna Nombre de la variable y escriba uno nuevo. Para este ejercicio, los nombres de las tres primeras variable se editaron de la forma siguiente:
Valor de ejemplo
New England Massachusetts
Nombre de la variable
Regin Estado
18 IBM Cognos TM1
Valor de ejemplo
Boston
Ciudad
Los nombres de variable deben empezar con una letra y pueden contener nicamente estos caracteres:
Carcter
Letras en mayscula Letras en minscula Dgitos Period Subrayado Smbolo de dlar
Descripcin
De la A a la Z De la a a la z De 0 a 9 . _ $
El campo Tipo de variable identifica el contenido de la columna. Por ejemplo, la primera columna de estos datos contiene la cadena New England. TurboIntegrator identifica correctamente el tipo de variable como Cadena. Nota: los campos de Tipo de variable normalmente se establecen con precisin para datos ASCII, pero no para datos extrados de una fuente de datos ODBC. El campo Contenido puede definirse con uno de estos parmetros:
Opcin
Ignorar Elemento Consolidacin Datos
Descripcin
Ignorar el contenido de la columna al procesar la fuente de datos. La columna contiene elementos simples para la dimensin que desea crear. La columna contiene elementos consolidados para la dimensin que desea crear. La columna contiene valores de datos. Para este ejemplo debera ignorar la columna que contiene los valores de datos. Las columnas que contienen valores de datos no se importan al crear una dimensin.
Atributo Otros
La columna contiene atributos de elemento para la dimensin que desea crear. La columna contiene datos que no se incluyen en ninguna de las cuatro categoras anteriores. Habitualmente, se utiliza esta configuracin para las columnas que contienen datos que se procesarn mediante frmulas y variables personalizadas.
Captulo 2: Importacin de un archivo de texto Los datos de texto de este ejemplo contienen elementos y consolidaciones para una dimensin Location.: No contiene ningn atributo. Contiene valores de datos pero no son relevantes para la creacin de la dimensin Location, ya que son elementos de otras dimensiones.
Para definir las variables de la dimensin Location:
Pasos
1. Haga clic en la pestaa Variables de la ventana TurboIntegrator. 2. Establezca el campo Contenido para las variables Region, State y City tal y como se especifica aqu:
Variable
Regin Estado Ciudad
Contenido
Consolidacin Consolidacin Elemento
La variable Region se ha identificado ahora como una consolidacin La variable State se ha identificado tambin como una consolidacin La variable Ciudad se ha identificado como elemento a nivel de hoja (no consolidado).
Asignacin de variables
Tras identificar las variables de su fuente de datos, deber asignarlas a elementos y consolidaciones. Para comenzar a asignar variables, haga clic en la pestaa Asignaciones de la ventana TurboIntegrator. La pestaa Asignaciones contiene varias pestaas adicionales. La pestaa Cubo siempre est disponible. El resto de pestaas se habilitan segn el contenido de la columna que defini en la pestaa Variables. Por ejemplo, si identifica una columna como que contiene elementos, estar disponible la pestaa Dimensin. Si identifica una columna como que contiene consolidaciones, se habilitar la pestaa Consolidaciones y as sucesivamente.
Desactivar la asignacin de cubo

No debera realizar acciones de cubo al crear una dimensin. Para evitar la asignacin de cubos:
Pasos
1. Haga clic en la pestaa Cubo. 2. Seleccione Ninguna accin en el cuadro Accin de cubo.
20 IBM Cognos TM1
Asignacin de dimensiones
Si identifica todas las columnas de su fuente de datos como que contienen elementos, deber asignar tales elementos a la dimensin que est creando:
Pasos
1. Haga clic en la pestaa Dimensiones. 2. Escriba Ubicacin en el campo Dimensin. Si se asignan varios elementos a la misma dimensin, escriba el nombre de la dimensin para cada elemento. Cuando introduce un nuevo nombre de dimensin en la columna Dimensin, la columna Accin aparecer por defecto como Crear. Si introduce el nombre de una dimensin existente, tendr la opcin de volver a crear o actualizar la dimensin. Si selecciona la accin Recrear, se borrarn los elementos de la dimensin existente y se sustituirn por los datos de la fuente de datos. Si selecciona la accin Actualizar, se actualizar la dimensin con todos los elementos nuevos que contenga la fuente de datos. 3. Seleccione un tipo para cada elemento de la lista Tipo de elemento. El tipo de elemento indica el tipo de datos que identifica la variable elemento. En TM1 este parmetro es casi siempre Numrico. 4. Seleccione una opcin de Orden de elementos. El orden de elementos determina cmo se aadirn los elementos a la dimensin durante el proceso. Los datos de este ejemplo contienen un solo elemento numrico que se asigna a una nueva dimensin Location. Se muestra la pestaa Dimensiones completada, como se indica a continuacin.
Desactivar la asignacin de datos

No debera realizar ninguna asignacin de datos al crear una dimensin. Dado que se especific Ninguna accin en la pestaa Asignacin de cubo ("Desactivar la asignacin de cubo" (p. 20)), esta pestaa Datos pasa a ser no disponible.
Asignacin de consolidaciones
Si identifica todas las columnas de su fuente de datos como que contienen consolidaciones, deber asignar tales rutas de consolidacin a la dimensin que est creando:
Pasos
1. Haga clic en la pestaa Consolidaciones. La pestaa muestra las variables definidas como consolidaciones, Region y State. Puede definir la jerarqua de consolidacin de la dimensin especificando la variable de hijo de cada variable de consolidacin.
Captulo 2: Importacin de un archivo de texto 2. El hijo inmediato de la variable de consolidacin Regin es Estado. Haga clic en el botn de parntesis angular derecho del campo Variable de hijo para obtener la consolidacin de
Region, seleccione Estado y haga clic en Aceptar. 3. El hijo inmediato de la variable de consolidacin Estado es Ciudad. Haga clic en el botn de parntesis angular derecho del campo Variable de hijo para obtener la consolidacin de
State, seleccione Ciudad y haga clic en Aceptar. 4. Para cada consolidacin, haga clic en el botn Orden de componentes. Se abrir el cuadro de dilogo Ordenacin de elementos del componente. 5. Haga clic en Automtico, Nombre y Ascendente. Nota: al configurar varias consolidaciones dentro de la misma dimensin, debe establecer todas las consolidaciones con los mismos parmetros de Ordenacin de elementos del componente. Si estableci dos consolidaciones en la misma dimensin con diferentes parmetros de Ordenacin de elementos del componente, TurboIntegrator produce un error de Discordancia de informacin de ordenacin cuando intenta guardar y ejecutar el proceso.
Guardar y ejecutar el proceso TurboIntegrator

Tras definir una fuente de datos y configurar las variables, se compila y se guarda el proceso TurboIntegrator. Para crear la dimensin, ejecute el proceso completado.
Pasos
1. Haga clic en Archivo, Guardar en la barra de men de TurboIntegrator. Se abrir el cuadro de dilogo Guardar proceso como. 2. Introduzca un nombre para el proceso y haga clic en Guardar. Si TM1 encuentra un error durante la compilacin y el almacenamiento, un mensaje de error indicar la naturaleza del mismo. La ventana TurboIntegrator permanece activa para que pueda corregir los errores inmediatamente. TM1 guarda el proceso como un objeto de servidor en Procesos, en Server Explorer. El proceso est ahora disponible para su ejecucin o modificacin. Para ejecutar el proceso y crear la dimensin, haga clic en Archivo, Ejecutar en la barra de men de TurboIntegrator. Tambin puede ejecutar un proceso directamente desde Server Explorer seleccionando el proceso y haciendo clic en Proceso, Ejecutar proceso. Si se ejecuta el proceso correctamente, TM1 enva un mensaje de confirmacin. Si TM1 no puede ejecutar el proceso, un cuadro de dilogo detallar los errores que se han encontrado durante la ejecucin. Al procesar NewEngland.cma, se crea una nueva dimensin Location.
22 IBM Cognos TM1
Creacin de un cubo desde un archivo de texto

TurboIntegrator tambin puede crear un cubo completo a partir de un archivo de texto. Este procedimiento construye tambin algunas dimensiones y elementos y realiza alguna manipulacin de datos. El procedimiento para construir un cubo es similar al proceso de creacin de una dimensin: Defina la fuente de datos para TM1. Consulte "Definicin de la fuente de datos del cubo" (p. 23). Identifique las variables que TM1 encontrar. Consulte "Definicin de variables de cubo" (p. 24). Asigne las diferentes variables a sus tipos de datos en el cubo resultante. Consulte "Asignacin de variables de cubo" (p. 24), "Asignacin de variables de elemento de cubo a dimensiones" (p. 25). "Asignacin de variables de datos de cubo" (p. 25) y "Asignacin de variables de consolidacin" (p. 25). Guarde el proceso y ejectelo. Consulte "Guardar y ejecutar el proceso de cubo" (p. 26).
TM1 incluye un directorio de datos de muestra llamado TI_data. TI_data contiene un archivo llamado import_cube.csv. Este ejemplo describe cmo construir un cubo TM1 a partir de import_cube.csv.
Definicin de la fuente de datos del cubo

El primer paso para crear un cubo a partir de un archivo de texto es definir la fuente de datos.
Pasos
1. En el panel izquierdo de Server Explorer, haga clic con el botn derecho del ratn en el icono Procesos y seleccione Crear nuevo proceso. 2. Haga clic en la pestaa Fuente de datos de la ventana TurboIntegrator. 3. Seleccione Texto como el Tipo de fuente de datos. 4. Haga clic en el botn Examinar junto al campo Nombre de la fuente de datos y seleccione el archivo import_cube.csv de su directorio TI_data. Si acept el directorio de instalacin predeterminado, la ruta completa hasta el directorio TI_data es
C:\Program Files\Cognos\TM1\Custom\TM1Data\TI_Data.
5. Defina el Tipo de delimitador como Delimitado y elija Coma como Delimitador. Ignore los campos Comillas y Nmero de registros de ttulo para este ejemplo. 6. Asegrese de que el Separador decimal es el punto (.) y el Separador de millares es la coma (,). 7. Haga clic en Vista previa para ver los primeros registros de la fuente de datos. Cada registro de import_cube.csv contiene 6 campos. Los cinco primeros campos contienen informacin que se importar a TM1 como nombres de elemento. La sexta columna contiene datos del cubo.
Definicin de variables de cubo

Tras identificar los datos de origen en TurboIntegrator, debe identificar el contenido de cada campo de la fuente.
Pasos
1. Haga clic en la pestaa Variables. TurboIntegrator establece valores por defecto para cada variable. 2. Para cada variable, seleccione un tipo del men Tipo de variable asociada. En este ejemplo, no es necesario modificar los campos de Tipo de variable. TM1 identifica correctamente el tipo de cada variable. 3. Para cada variable, seleccione un tipo del men Contenido asociado. En este ejemplo, todas las variables excepto la V6 deberan identificarse como Elemento. V6 debera identificarse como Datos.
Asignacin de variables de cubo

Ha identificado variables para datos, elementos y consolidaciones. Ahora tiene que asignar las variables y proporcionar instrucciones para crear un nuevo cubo.
Pasos
1. Haga clic en la pestaa Mapas. 2. Haga clic en la pestaa Cubo. 3. SeleccioneCrear para la Accin de cubo. 4. Escriba import_cube en el campo Nombre de cubo. 5. Seleccione Almacenar valores para la Accin de datos. 6. No habilite la opcin Activar el registro de cubos. Cuando habilita el registro de cubos, TM1 registra los cambios en los datos del cubo durante el proceso. Est creando un nuevo cubo, por tanto, no necesita registrar los cambios.
24 IBM Cognos TM1
Asignacin de variables de elemento de cubo a dimensiones

Asignar todas las variables que identific que contienen un tipo de Elemento para las dimensiones apropiadas.
Pasos
1. Haga clic en la pestaa Dimensiones. 2. Defina valores en la pestaa Dimensiones segn la tabla siguiente.
Variable de elemento
Real Argentina V3 Unidades En
Valor de ejemplo
Real Argentina S Series 1.8 L Sedan Unidades En
Dimensin
actvsbud2 region2 model2 measures month2
Orden en el cubo
1 2 3 4 5
3. Para todas las variables de elemento, defina la Accin como Crear y el Tipo de elemento como Numrico
Asignacin de variables de datos de cubo

Para este ejemplo, existe solo una variable de datos: V6. No necesita asignar esta variable de datos. TurboIntegrator lo hace automticamente. La pestaa de datos ni siquiera est habilitada en este ejemplo. TurboIntegrator aade los datos al cubo en la interseccin de las dimensiones creadas. Si hubiera 2 o ms variables definidas como datos en la pestaa Variables, tendra que especificar informacin de dnde se deberan aadir en el cubo. Para obtener un ejemplo ms detallado de asignacin de valores de datos en un cubo, consulte el TurboIntegrator Tutorial.
Asignacin de variables de consolidacin

Ninguna variable de este ejemplo est definida como consolidacin en la pestaa Variables. La pestaa Consolidacin no est habilitada en este ejemplo. Para obtener un ejemplo ms detallado de asignacin de consolidaciones en un cubo, consulte el TurboIntegrator Tutorial.
Guardar y ejecutar el proceso de cubo

Para guardar y ejecutar el proceso:
Pasos
1. Haga clic en el botn Ejecutar. TM1 le solicitar que asigne un nombre al proceso y que lo guarde. 2. Guarde el proceso como create_newcube. Tras unos segundos, debera aparecer un mensaje confirmando que el proceso se ha ejecutado con xito. 3. Abra Server Explorer. Debera comprobar si se ha creado y llenado el cubo import_cube y si se hayan creado todas las dimensiones necesarias.
26 IBM Cognos TM1
Captulo 3: Importacin desde una fuente ODBC

A travs de TurboIntegrator puede crear cubos y dimensiones a partir de datos de tablas de bases de datos relacionales. Para ello, debe disponer en su equipo del siguiente software: El software de cliente de su base de datos relacional, instalado en el mismo equipo en el que se est ejecutando TurboIntegrator. Una fuente de datos ODBC establecida para su base de datos relacional. Puede construir fuentes de datos mediante el panel de control Fuentes de datos de Windows.
Una vez que ha definido la fuente de datos ODBC, los pasos para crear un cubo o una dimensin a partir de datos relacionales son los mismos que para crear un cubo o una dimensin a partir de un archivo de texto. Para obtener un tutorial detallado por pasos sobre cmo crear objetos en TurboIntegrator utilizando una fuente ODBC, consulte TurboIntegrator Tutorial.
Unicode y DSN
Al configurar el DSN para importar datos Unicode de una base de datos Oracle a travs del cliente versin 11g o el controlador ODBC, asegrese de especificar la opcin Activar cierre de cursores en la ficha Aplicacin. Los procesos de TI pueden producir un error si no se especifica esta opcin. El controlador ODBC 11g de Oracle no admite la opcin SQL_CLOSE de SqlFreeStmt.
Definicin de una fuente de datos ODBC

Para definir una fuente de datos ODBC:
Pasos
1. Abra Server Explorer. 2. Haga clic con el botn derecho del ratn en el icono Procesos Se abrir la ventana TurboIntegrator. 3. Seleccione el ODBC superior en el cuadro Tipo de fuente de datos. TurboIntegrator muestra los campos requeridos para definir una fuente ODBC. 4. Haga clic en Examinar y elija un nombre de fuente de datos ODBC. Solo podr acceder a las fuentes de datos que se hayan definido en el equipo en el que se ejecuta el servidor TM1. 5. Si se necesita utilizar esta fuente, introduzca un nombre de usuario y contrasea vlidos para la base de datos de destino en los campos UserName y Contrasea. 6. En el cuadro Consulta, introduzca una consulta SQL para extraer datos de la fuente. La sintaxis y el formato de la consulta SQL dependen del tipo de base de datos que est utilizando. Por Licensed Materials Property of IBM Copyright IBM Corp. 2007, 2010. que se encuentra bajo el servidor
en el que desea crear el proceso y seleccione Crear nuevo proceso.
27
Captulo 3: Importacin desde una fuente ODBC ejemplo, si est utilizando una base de datos de Microsoft Access, puede ejecutar Microsoft Access, abrir la base de datos, utilizar la vista SQL, a continuacin, copiar la instruccin SQL en esta ventana de Consulta. Nota: si la consulta hace referencia a un nombre de tabla que contenga espacios, debe poner el nombre entre comillas dobles. 7. Haga clic en Vista previa. Si la consulta era vlida y la conexin se defini correctamente, aparecern los diez primeros registros de la base de datos de destino en la ventana de TurboIntegrator. Consulte Identificacin de variables en la fuente de datos para ver los pasos utilizados para definir variables ODBC. Consulte Asignacin de variables para obtener instrucciones sobre las instrucciones de asignacin ODBC. Consulte Guardar y ejecutar el proceso TurboIntegrator para obtener ms detalles sobre guardar y ejecutar un proceso TurboIntegrator.
Generacin de un proceso TurboIntegrator a partir de una instruccin MDX

Esta seccin describe cmo extraer datos de una fuente de datos ODBO utilizando una instruccin MDX e importar los datos a TM1. Se recomienda generar una instruccin MDX utilizando otra utilidad, para posteriormente utilizar la instruccin MDX que est en funcionamiento como la base para su importacin de datos a TM1. Cuando importa datos a TM1, es importante empezar con una instruccin MDX que tenga un nmero limitado de columnas. Algunas instrucciones MDX generan un gran nmero de columnas. Este tipo de consultas no son prcticas como punto de partida para una importacin. Un mtodo para limitar el nmero de columnas es colocar en las columnas slo las medidas que le interesan.
Construccin del proceso MDX de TurboIntegrator

Una vez que tenga una instruccin MDX que devuelva datos tiles, puede construir su proceso TurboIntegrator. Para comenzar, realice estos pasos:
Pasos
1. En Server Explorer, haga clic con el botn derecho del ratn en Procesos y seleccione Crear nuevo proceso. Se abrir la ventana TurboIntegrator. 2. En el cuado Tipo de fuente de datos, haga clic en ODBO y seleccione Consulta MDX. 3. Introduzca los parmetros de conexin necesarios en la pestaa de Conexin de la ventana TurboIntegrator. Los parmetros de conexin son especficos de cada proveedor.
28 IBM Cognos TM1
Captulo 3: Importacin desde una fuente ODBC 4. Haga clic en Conectar. Si se conecta correctamente, el botn de conexin se vuelve de color gris y puede acceder a la pestaa Consulta MDX. 5. Haga clic en la pestaa Consulta MDX. 6. Escriba su consulta MDX en esta pestaa. Tambin puede cortar una consulta MDX que est en funcionamiento desde otra aplicacin y pegarla en esta pestaa. 7. Haga clic en la pestaa Variables. Para cada columna generada por la instruccin MDX, TurboIntegrator genera una variable. Las columnas que contienen encabezados de fila se asignan normalmente como elementos de dimensin. Las columnas que contienen elementos de datos se asignan como datos. 8. Consulte Asignacin de variables para asignar las variables a estructuras TM1. Una vez que se haya conectado a la fuente de datos ODBO y definido la instruccin MDX, el proceso para completar el proceso TurboIntegrator es idntico al de una importacin de datos ODBC.
Captulo 3: Importacin desde una fuente ODBC
30 IBM Cognos TM1
Captulo 4: Importacin desde un subconjunto o vista TM1

IBM Cognos TM1 TurboIntegrator le permite extraer datos desde una vista de cubo TM1 y crear nuevos objetos TM1 con esos datos. Estos pasos para construir un proceso, con el objeto de utilizar una vista TM1, son similares a los utilizados para definir cualquier otra fuente de datos, excepto que se construye primero una vista de sus datos que est especficamente diseada para su importacin. No todas las vistas de cubo TM1 se pueden importar correctamente. Al construir una vista con ciertos parmetros desde dentro de TurboIntegrator, su importacin siempre funcionar correctamente.
Utilizacin de una vista de cubo TM1 como fuente de datos

Para definir una vista de cubo TM1 como fuente de datos, consulte "Crear un proceso de cubo" (p. 31) para definir la fuente de datos y, a continuacin, siga los procedimientos descritos en "Importacin de un archivo de texto".
Crear un proceso de cubo

Para crear un proceso que utilice una vista de cubo como fuente de datos:
Pasos
1. Haga clic con el botn derecho del ratn en Procesos en Server Explorer y seleccione Crear nuevo proceso. 2. Haga clic en TM1 y seleccione Vista del cubo en el cuadro Tipo de fuente de datos. TurboIntegrator muestra el campo Nombre de fuente de datos. 3. Haga clic en Examinar para seleccionar entre una lista de vistas disponibles. Se abrir el cuadro de dilogo Examinar las vistas de cubos del servidor. 4. Seleccione el cubo que contiene los datos que desea importar. 5. Si ya existe una de las vistas que desea utilizar como una fuente de datos, seleccinela. Si esa vista no existe, haga clic en Crear vista para abrir la ventana Extraccin de vistas y cree la vista. Tras crear la vista, seleccinela en el cuadro de dilogo Examinar las vistas de cubos del servidor. 6. Haga clic en Aceptar. La vista seleccionada se muestra ahora como una fuente de datos para su proceso TurboIntegrator.
31
Captulo 4: Importacin desde un subconjunto o vista TM1 Contine con los pasos descritos en "Importacin de un archivo de texto" para completar la importacin a su vista TM1..
Utilizacin de un subconjunto TM1 como fuente de datos

TurboIntegrator le permite extraer datos de un subconjunto de una dimensin TM1 y mover esa informacin a otro objeto TM1. En el siguiente ejemplo, la consolidacin Europe de la dimensin Region se extrae y se utiliza para formar una nueva dimensin llamada Region_Europe. Cuando est extrayendo informacin de un subconjunto de dimensin, el objeto de destino es normalmente otra dimensin. No puede construir un cubo a partir de informacin extrada de un subconjunto de dimensin. El procedimiento para extraer datos utilizando un Subconjunto TM1 es similar a otro proceso TurboIntegrator. Consulte "Definir subconjunto de dimensin como fuente de datos" (p. 32) para comenzar.
Definir subconjunto de dimensin como fuente de datos

Siga estos pasos para crear un proceso que utilice un subconjunto de dimensin como fuente de datos:
Pasos
1. Haga clic con el botn derecho del ratn en Procesos en Server Explorer y seleccione Crear nuevo proceso. 2. Haga clic en TM1 y seleccione Subconjunto de dimensin en el cuadro Tipo de fuente de datos. TurboIntegrator muestra el nico campo necesario para definir una fuente de vista de cubo. 3. Haga clic en Examinar para seleccionar de una lista los subconjuntos disponibles. Se abrir el cuadro de dilogo Examinar subconjuntos del servidor. 4. Seleccione la dimensin que contiene los elementos que desea importar. 5. Seleccione el subconjunto que desea utilizar como una fuente de datos y haga clic en Aceptar. 6. Haga clic en Vista previa. Los elementos del subconjunto de dimensin seleccionado aparecen en el panel de previsualizacin.
Definir variables de dimensin

Consulte "Definicin de variables de cubo" para obtener detalles sobre cmo identificar y definir variables en TurboIntegrator. La siguiente imagen muestra la pestaa Variables con la variable de regin identificada como elemento.
32 IBM Cognos TM1
En este ejemplo, los elementos extrados de la fuente de datos del subconjunto se aadirn como hijos de una consolidacin de nivel superior llamada All Europe. Para construir una nueva consolidacin siga estos pasos:
Pasos
1. Haga clic en Nueva variable. Se muestra la variable V2 en la pestaa Variables. 2. Haga clic en Frmula. Se abrir el cuadro de dilogo Frmula de variables del proceso. 3. Modifique la frmula de la siguiente manera:
V2='All Europe';
4. Haga clic en Aceptar. 5. Cambie el Tipo de variable de V2 a Cadena. 6. Cambie el parmetro Contenido de V2 a Consolidacin. En la siguiente seccin, los elementos importados de la fuente de datos de subconjunto se aaden a la consolidacin All Europe.
Asignacin de variables de dimensin

Consulte "Asignacin de variables" para obtener detalles del procedimiento para asignar datos importados a objetos TM1. En este ejemplo, debe configurar las pestaas Cubo, Dimensiones y Consolidaciones para crear una nueva dimensin llamada Europe. Europe tiene una sola consolidacin llamada All Europe.
Configuracin de la pestaa Cubo

Configure las siguientes opciones en la pestaa Cubo:
Tipo de accin
Accin de cubo Accin de datos
Opcin
Ninguna accin Almacenar valores
Configuracin de la pestaa Dimensiones

La ficha Dimensiones le permite asignar los datos entrantes a dimensiones TM1. En este ejemplo solo se crea una dimensin llamada Europe. Configure las siguientes opciones en la pestaa Dimensiones: Gua de TurboIntegrator 33
Nombre de opcin
Variable de elemento Dimensin Accin Tipo de elemento
Opcin
Europe Regin Crear Numrico
Configuracin de la pestaa Consolidaciones

La variable All Europe que aadi anteriormente debera aparecer en la pestaa Consolidaciones. Tenga en cuenta que el Valor de ejemplo tiene el valor que estableci en la frmula. Como el proceso contiene solo dos variables, TM1 identifica correctamente la variable de regin como hijo de la variable V2. No es necesario modificar los parmetros de la pestaa de Consolidaciones.
Guardar y ejecutar la dimensin

Consulte "Guardar y ejecutar el proceso TurboIntegrator" para obtener detalles sobre cmo guardar y ejecutar un proceso TurboIntegrator. Tras guardar y ejecutar el proceso, TM1 crea una nueva dimensin llamada Europe con una nica consolidacin llamada All Europe, que contiene elementos de hoja para todos los pases europeos.
34 IBM Cognos TM1
Captulo 5: Importacin desde MSAS

IBM Cognos TM1 TurboIntegrator le permite importar datos desde cualquier base de datos OLE para fuente de datos OLAP (ODBO), incluyendo Microsoft Analysis Services. Esta seccin muestra cmo utilizar TurboIntegrator para importar cubos y dimensiones desde Microsoft Analysis Services.
Base de datos OLE para fuentes de datos OLAP

Una base de datos OLE para fuente de datos OLAP se identifica mediante los siguientes parmetros: Nombre del proveedor ODBO Ubicacin de ODBO Fuente de datos ODBO Catlogo ODBO
Nombre del proveedor ODBO

ste es el nombre asignado por el proveedor ODBO que identifica su servidor de base de datos multidimensional. Por ejemplo, TM1 utiliza "Proveedor MD de base de datos OLE de TM1" y Microsoft Analysis Services utiliza "Proveedor de base de datos OLE Microsoft para OLAP Services 8.0". TurboIntegrator enumera nicamente los proveedores de ODBO que tenga instalados en su servidor.
Ubicacin de ODBO
El campo de ubicacin es el nombre la ubicacin donde un administrador asigna una instancia determinada del servicio proveedor de ODBO. La interpretacin exacta de este campo es especfica del vendedor.
Fuente de datos ODBO

ste es el nombre que asigna su administrador a un conjunto de catlogos de una ubicacin determinada. En Microsoft Analysis Services, ste es el nombre de un servidor registrado.
Catlogo ODBC
ste es el nombre asignado por su administrador a una coleccin determinada de bases de datos (cubos, dimensiones y otros objetos). Para Microsoft Analysis Services, ste es el nombre de la base de datos.
35
Cadenas de conexin: MSAS frente a TM1

La base de datos OLE de TM1 para el proveedor OLAP ha sido modificada para proporcionar ms flexibilidad a la hora de que los programadores construyan cadenas de conexin. Esto se hizo para hacer compatibles las cadenas de conexin TM1 con cadenas de conexin MSAS. En versiones anteriores de TM1, la conexin a travs de proveedor de bases de datos OLE de TM1 requera los siguientes campos:
Campo
Location El nombre del equipo del host del Servidor de administracin TM1. Fuente de datos El nombre del servidor TM1. userID El nombre de usuario de TM1. password La contrasea para el usuario de TM1.
Configuracin de ejemplo
MyServer
Sdata
Admin
Apple
Puede utilizar los parmetros que se describen anteriormente, o puede conectarse a TM1 utilizando los parmetros de la tabla siguiente. Estos parmetros se utilizan tambin para conectarse a Microsoft Analysis Services desde TurboIntegrator.
Campo
Fuente de datos El nombre del equipo del host del Servidor de administracin TM1. Catalog El nombre del servidor TM1. userID El nombre de usuario de TM1. password La contrasea para el usuario de TM1.
Configuracin de ejemplo
MyServer
Sdata
Admin
Apple
36 IBM Cognos TM1
Conexin a una base de datos OLE para fuente de datos OLAP cuando utiliza autenticacin CAM
Si su servidor TM1 est configurado para utilizar autenticacin de Cognos Access Manager (CAM), debe especificar el ID de espacio de nombres CAM utilizado por el servidor TM1 cuando establece una conexin a una fuente de datos ODBO. Si trabaja con una versin de 32 bits del servidor TM1, puede especificar el espacio de nombres CAM en la seccin de Parmetros de conexin adicionales de la pestaa Conexin de TurboIntegrator. El ID del espacio de nombres CAM debe especificarse utilizando el siguiente formato:
Provider String="CAMNamespace=<CAM Namespace ID"
<ID del espacio de nombres CAM> debe ser el ID de espacio de nombres CAM interno, no el nombre descriptivo del espacio de nombres. Si trabaja con una versin de 64 bits del servidor TM1, debe especificar el ID de espacio de nombres CAM mediante una cadena de conexin, utilizando el mismo formato que se indica anteriormente. Por ejemplo, la siguiente cadena de conexin especifica un ID de espacio de nombres CAM llamado NTLM_NAMESPACE:
Provider=TM1OLAP.1;Location=localhost;Data Source=empty;UserID=tm1user; Password="abc123"; Provider String="CAMNamespace=NTLM_NAMESPACE"; InitialCatalog=empty
No puede utilizar la interfaz de usuario de TurboIntegrator para especificar el espacio de nombres CAM cuando trabaja con un servidor TM1 de 64 bits; debe utilizar una cadena de conexin.
Importacin de un cubo MAS

Este procedimiento describe cmo importar un cubo de datos simple de Microsoft Analysis Services a TM1. Por ejemplo, la siguiente tabla es una representacin de un cubo, tal y como se ve en Analysis Services:
Explorador de cubos: ventas

store2 time All store2 All time MeasuresLevel + Pas Store Sales 120.160.84 9.628.88 48,622.07 61,909.89 Store Cost 48,101.77 3,851.54 19,488.73 24,761.49
All customer + + + Canad Mxico EE.UU.
Captulo 5: Importacin desde MSAS Este cubo tiene cuatro dimensiones: time, store2, customer y measures. Para importar un cubo a TM1 desde Microsoft Analysis Services: Establezca la conexin a la fuente de datos MAS. Consulte "Conexin a Analysis Services con TurboIntegrator" (p. 38). Especifique qu cubo va a importar. Consulte "Especificar el cubo con la pestaa Cargar cubo ODBC" (p. 39). Defina las dimensiones. Consulte "Uso de la pestaa Dimensiones de cubo" (p. 40). Guarde el proceso y ejectelo. Consulte "Guardar y ejecutar el proceso MAS" (p. 40).
Conexin a Analysis Services con TurboIntegrator

Utilice TurboIntegrator para crear un proceso que se conecta a Microsoft Analysis Services.
Pasos
1. Ejecute TM1 Architect y conctese utilizando un nombre de usuario y contrasea vlidos. 2. Haga clic con el botn derecho del ratn en Procesos y seleccione Crear nuevo proceso. Se abrir el cuadro de dilogo TurboIntegrator. 3. Haga clic en la opcin ODBO y, a continuacin, seleccione Cubo. El cuadro de dilogo muestra las opciones que le permiten crear una cadena de conexin ODBO. 4. Introduzca parmetros de conexin en el cuadro de dilogo de la siguiente manera:
Campo
Proveedor de ODBO Ubicacin de ODBO Fuente de datos ODBO Catlogo ODBO
Valor
Elija Proveedor de base de datos Microsoft OLE de OLAP Services. Deje este parmetro en blanco. Introduzca el nombre del equipo del servidor que alberga Analysis Services. Introduzca un nombre de base de datos de Analysis Services. Por ejemplo, para importar datos de la base de datos de muestra de Microsoft, introduzca FoodMart 2000 en este campo.
ID de usuario de ODBO
Introduzca un nombre de usuario vlido para la base de datos de Analysis Services.
Contrasea de ODBO Introduzca una contrasea vlida para este nombre de usuario para la base de datos de Analysis Services.
38 IBM Cognos TM1
Campo
Parmetros de conexin adicionales
Valor
Algunos servidores de ODBO podran requerir parmetros adicionales para conectarse correctamente. Introduzca esos parmetros en este campo, separados por punto y coma.
5. Haga clic en Conectar. Si se conecta correctamente, el botn Conectar se vuelve de color gris y puede acceder a la pestaa Cargar cubo ODBO.
Especificar el cubo con la pestaa Cargar cubo ODBC

La pestaa Cargar cubo ODBO le permite especificar qu cubo va a importar desde Analysis Services, adems de otra informacin. Siga los siguientes pasos para completar esta pestaa.
Pasos
1. Haga clic en la pestaa Cargar cubo ODBO. 2. Elija una accin de cubo. Estas opciones se describen en la tabla siguiente:
Opcin
Crear cubo
Descripcin
Copia datos y metadatos desde la fuente de datos ODBC y crea un nuevo cubo en TM1. Utilice esta opcin nicamente cuando no exista en el servidor TM1 ninguno de los cubos y dimensiones que est importando.
Recrear cubo
Destruye un cubo TM1 existente y lo reconstruye utilizando datos y metadatos de la fuente de datos ODBO. Utilice esta opcin solo cuando existan las dimensiones y cubos TM1 y desee sustituirlos por datos y estructuras nuevas.
Actualizar cubo Copia datos de un cubo ODBO existente y los inserta en un cubo TM1 existente. Esta opcin no cambia la estructura de los cubos y dimensiones en el servidor TM1. Ninguna accin El valor por defecto para la pantalla. Los procesos que especifican Ninguna accin no afectan a los datos o metadatos del cubo. Utilice est opcin para probar y depurar procesos, o para definir sus propias operaciones personalizadas. Para este ejemplo, elija Crear cubo. 3. Haga clic en Seleccionar Cubo ODBO desde y elija un cubo de Analysis Services para importarlo a TM1. 4. Haga clic en el campo Seleccionar cubo TM1 para cargar en. Introduzca un nombre exclusivo para su cubo TM1.
Captulo 5: Importacin desde MSAS 5. El en panel Accin de datos, elija Almacenar valores. Esta opcin escribe valores de celda del cubo ODBO en el cubo TM1. La opcin Acumular valores le permite agregar valores segn se van importando.
Uso de la pestaa Dimensiones de cubo

La pestaa Dimensiones de cubo le permite manipular dimensiones importadas a medida que se importan a TM1. Por defecto, se importan todas las dimensiones del cubo ODBO. Se crean en TM1 como name_. Por ejemplo, cuando se importa la dimensin [customer] de Analysis Services, la dimensin correspondiente de TM1 se llama Customer_. Este cuadro de dilogo presenta las opciones siguientes: Puede elegir asignar una dimensin ODBO a una dimensin existente en TM1. Para hacerlo, haga clic en cualquier dimensin de la columna Dimensin TM1 y elija otra dimensin TM1. Tambin puede importar los elementos de la dimensin ODBO a una dimensin TM1 totalmente nueva. Haga clic en la celda correspondiente bajo la columna Dimensin TM1, a continuacin escriba el nombre de la nueva dimensin. Por ejemplo, sustituya la dimensin customer_ por una dimensin llamada MyCustomerDim. Para cada dimensin importada debe elegir una Accin de dimensin TM1. Seleccione una de las siguientes opciones:
Opcin
Crear
Descripcin
Importa datos de la dimensin desde el cubo ODBO y crea una nueva dimensin en TM1 con el conjunto completo de elementos de la dimensin. sta es la accin predeterminada. Importa datos de la dimensin desde el cubo ODBO y crea una nueva dimensin en TM1 con un conjunto limitado de elementos. No importar esta dimensin desde la fuente de datos ODBO.
Solo filtro: MDX Ninguna accin
Guardar y ejecutar el proceso MAS

Una vez que haya finalizado sus cambios en la pestaa Dimensiones de cubo, haga clic en guardar y ejecutar el proceso. Se abrir el cuadro de dilogo Guardar proceso como. Introduzca el nombre del nuevo proceso. Asigne al proceso un nombre relacionado con los datos que est importando. Para este ejemplo, introduzca ODBO_Sales_Import. TM1 debera importar sus datos y crear el nuevo cubo. Aparecer un cuadro de dilogo para mostrar el progreso de la importacin. para
40 IBM Cognos TM1
Importacin de una dimensin MAS

Esta seccin describe cmo importar una dimensin de Microsoft Analysis Services a TM1. La siguiente tabla es una representacin de la dimensin, tal y como se ve en Analysis Services.
Miembros de dimensin
O + All store2 O O + + + + + + O + + + Canad Mxico O O O O O O EE.UU. O O O CA O WA DF Guerrero Jalisco Veracruz Yucatn Zacatecas
TM1 requiere que todos los elementos de una dimensin tengan nombre exclusivos. TM1 tambin requiere que todos los alias de los elementos tengan nombres exclusivos. Para asegurarse de que los nombres de elemento sean exclusivos, TM1 nombra a cada consolidacin y elemento de una dimensin importada con los nombres de todos sus padres entre corchetes, separados por puntos. La siguiente imagen muestra la dimensin de almacn despus de haberla importado a TM1.
Tras la importacin, los alias de subconjunto se completan con los nombres de elemento de Analysis Services. El procedimiento para importar datos MAS es similar a otros procesos de importacin.
Definicin de parmetros de conexin MAS

El primer paso para importar una dimensin de Analysis Services a TM1 es conectarse a Analysis Services y elegir la opcin Dimensin ODBO. Siga estos pasos:
Pasos
1. Ejecute TM1 Architect y conctese utilizando un nombre de usuario y contrasea vlidos. 2. Haga clic con el botn derecho del ratn en Procesos y seleccione Crear nuevo proceso. Se abrir el cuadro de dilogo TurboIntegrator. 3. Haga clic en la opcin ODBO y, a continuacin, seleccione Dimensin. 4. Introduzca parmetros de conexin en el cuadro de dilogo de la siguiente manera:
Campo
Proveedor de ODBO Ubicacin de ODBO
Valor
Elija Proveedor de base de datos Microsoft OLE de OLAP Services. Deje este parmetro en blanco.
Fuente de datos ODBO Introduzca el nombre del equipo del servidor que alberga Analysis Services. Catlogo ODBO Introduzca un nombre de base de datos de Analysis Services. Por ejemplo, para importar datos de la base de datos de muestra de Microsoft, introduzca FoodMart 2000. ID de usuario de ODBO Introduzca un nombre de usuario vlido para la base de datos de Analysis Services.
42 IBM Cognos TM1
Campo
Contrasea de ODBO
Valor
Introduzca una contrasea vlida para este usuario para la base de datos de Analysis Services.
Parmetros de conexin Deje este campo en blanco. adicionales
5. Haga clic en Conectar. El botn de conexin debera volverse gris, indicando as que se ha conectado correctamente.
Uso de la pestaa Cargar dimensin de ODBO

Una vez que se ha conectado correctamente a Analysis Services, debera especificar informacin sobre las dimensiones fuente y de destino para el proceso de carga de su dimensin. Siga estos pasos:
Pasos
1. Haga clic en la pestaa Cargar dimensin de ODBO. 2. Elija una Accin de dimensin TM1. Seleccione una de las siguientes opciones:
Opcin
Descripcin
Crear dimen- Copia una dimensin de la fuente de datos ODBO y crea una nueva dimensin sin en TM1. Recrear dimensin Actualizar dimensin Destruye una dimensin TM1 existente y la reconstruye utilizando datos de la fuente de datos ODBO. Actualizar dimensin asume que TM1 ya tiene una dimensin en la que desea insertar o borrar elementos. Si los elementos existen en la fuente de datos ODBO pero no en TM1, se aaden los elementos a la dimensin TM1. Si los elementos existen en TM1 pero no en la fuente de datos ODBO, la importacin no afectar a esos elementos. No se realizan cambios en los elementos de la dimensin local. Si los elementos existen en la fuente de datos ODBO y en la dimensin local, se importan los elementos de la fuente de datos ODBO, y se crean en la dimensin local como <element_name>_1. Tenga en cuenta que as aumentar el tamao de la dimensin.
Ninguna accin
El valor por defecto para la pantalla. Este proceso no afecta a la dimensin TM1.
Captulo 5: Importacin desde MSAS 3. Haga clic en la lista Cubo ODBO que incluye la dimensin y elija el cubo que contiene la dimensin que desea importar desde Analysis Services. 4. Haga clic en la lista Dimensiones del cubo y elija la dimensin que desea importar. 5. Si est actualizando o recreando una dimensin, haga clic en la lista TM1 Dimensin para cargar y seleccione una dimensin de la lista. Si est creando una dimensin nueva, escriba el nombre de su nueva dimensin en el campo TM1 Dimensin para cargar.
Guardar y ejecutar el proceso MAS de la dimensin

Una vez que haya finalizado sus cambios en la pestaa Cargar dimensin ODBO, haga clic en para guardar y ejecutar el proceso. Se abrir el cuadro de dilogo Guardar proceso como. Indique el nombre del nuevo proceso y, a continuacin, haga clic en Guardar. Comienza la importacin y TM1 muestra un cuadro de dilogo que indica el estado de la importacin.
Registro de mensajes de TM1

Cuando finaliza el proceso, los errores leves podran escribirse en el registro de mensajes de TM1. Si es as, TM1 mostrar un mensaje para informarle. Para comprobar el registro de mensajes del servidor TM1, haga clic con el botn derecho del ratn en el servidor TM1 en Server Explorer, y elija Ver registro de mensajes. Para ver los detalles de un error, haga doble clic en el error en el registro de mensajes de TM1.
44 IBM Cognos TM1
Captulo 6: Importacin de datos utilizando TM1 Connector for SAP Business Warehouse
IBM Cognos TM1 TurboIntegrator le permite importar datos desde BW SAP utilizando Llamadas de funcin remota (RFC). Esta seccin describe los objetos SAP que puede importar a TM1 a travs de TM1 Connector for SAP, y los procedimientos para importarlos. Tambin describe cmo volver a escribir datos TM1 en SAP a travs de tablas ODS. Nota: el acceso de TurboIntegrator a datos SAP se debe utilizar en conformidad con su licencia SAP.
Objetos SAP y terminologa

Antes de empezar a importar datos y metadatos desde BW SAP a TM1, debe tener un conocimiento considerable de las estructuras de datos tanto en sistemas SAP como TM1. Esta seccin explica la informacin que necesita saber antes de importar datos desde BW SAP.
Objetos anlogos en SAP y TM1

La siguiente tabla enumera la jerarqua de objetos SAP que tienen un objeto correspondiente en TM1.
SAP
caractersticas
TM1
dimensiones TM1. La dimensin de medidas en un cubo TM1, que define las unidades que estn midiendo los datos en el cubo, es directamente anloga a una caracterstica cifras clave de un cubo de informacin de SAP.
valores de caracters- Importados como elementos de dimensin tica cubos de consulta jerarquas Importados a TM1 como cubos Las caractersticas de SAP pueden contener una o varias jerarquas. Las jerarquas se proporcionan a TM1 a travs del proveedor ODBO SAP como dimensiones. Puede elegir entre las jerarquas de una caracterstica cuando importe la caracterstica a TM1. Sin objeto correspondiente en TM1. Por ejemplo, SAP implementa objetos llamados dimensiones. Las dimensiones de SAP son colecciones de caractersticas. TM1 no tiene objeto anlogo a las dimensiones SAP. Puede importar caractersticas individuales a TM1, pero no puede importar dimensiones SAP. Licensed Materials Property of IBM Copyright IBM Corp. 2007, 2010.
dimensiones
45
Jerarqua de objeto SAP

La siguiente tabla muestra la jerarqua de objeto SAP y los objetos anlogos en TM1.
Objetos SAP
Cubos de informacin Cubos de consulta Dimensiones Caractersticas y cifras clave Jerarquas Valor de caracterstica Atributo que se muestra: nombre que se muestra Atributo que se muestra: nombre exclusivo
Objetos TM1
Cubos Cubos Cubos Dimensiones Dimensiones Elementos de dimensiones Alias de elementos Nombre del elemento
Requisitos previos del software TM1 Connector for BW SAP

Los siguientes requisitos previos de software deben cumplirse antes de que pueda ejecutar TurboIntegrator e importar datos de BW SAP. Debe instalar las bibliotecas SAP especficas de la plataforma y el sistema operativo en el que est ejecutando SAP. Puede descargar las bibliotecas SAP ms recientes de SAP Service Marketplace. El archivo Saprfc.ini debe estar disponible en el equipo donde se est ejecutando el servidor TM1. Debe instalar la interfaz TM1 en BW SAP, tal y como se describe en "Instalacin de la interfaz de TM1 en BW SAP" (p. 48).
El archivo Saprfc.ini y las libreras RFC

El mtodo que se utiliza para habilitar el archivo Saprfc.ini y las libreras RFC vara segn la plataforma, como se describe en las siguientes secciones. Para obtener ms informacin sobre el archivo Saprfc.ini, consulte el sitio web de ayuda de SAP.
Microsoft Windows (x86)

Las plataformas Windows requieren una biblioteca de vnculos dinmicos (Librfc32.dll) y el archivo Saprfc.ini de SDK RFC SAP especfico de la plataforma, disponible desde SAP.
46 IBM Cognos TM1
Captulo 6: Importacin de datos utilizando TM1 Connector for SAP Business Warehouse La biblioteca de vnculos dinmicos se puede ubicar en cualquier directorio del equipo, siempre que el directorio se aada a la variable PATH del sistema. El archivo Saprfc.ini puede estar ubicado en cualquier lugar del equipo donde se est ejecutando el servidor TM1. Debe crear una variable de sistema llamada RFC_INI, que contendr la ruta completa al archivo Saprfc.ini. Por ejemplo:
RFC_INI = C:\Program Files\SAP_RFC_SDK\text\Saprfc.ini
Si ejecuta el servidor TM1 en el sistema operativo Microsoft Windows x86 e instala el cliente de escritorio SAP GUI en dicho sistema, se instalarn automticamente todos los archivos RFC SAP necesarios. A continuacin, puede utilizar SAP GUI para configurar las conexiones.
Microsoft Windows (x86, x64)

Las plataformas de Microsoft Windows x86 y x64 requieren los siguientes archivos incluidos en SDK RFC SAP (kit de desarrollo de software) especfico de la versin y de la plataforma disponible desde SAP. Todos los archivos (.dll) de la biblioteca de vnculos dinmicos incluidos en las subcarpetas de SDK RFC SAP. El archivo Saprfc.ini proporcionado por SDK RFC SAP
Archivos de la biblioteca de vnculos dinmicos

La lista exacta de archivos SAP de la biblioteca de vnculos dinmicos vara, dependiendo de la versin de SDK RFC SAP que utilice. Puede ubicar los archivos de la biblioteca de vnculos dinmicos en cualquier directorio del equipo, siempre que el directorio se aada a la variable PATH del sistema.
El archivo Saprfc.ini
El archivo Saprfc.ini puede estar ubicado en cualquier lugar del equipo donde se est ejecutando el servidor TM1. Debe crear una variable de sistema llamada RFC_INI, que contendr la ruta completa al archivo Saprfc.ini. Por ejemplo:
RFC_INI = C:\Program Files\SAP_RFC_SDK\text\Saprfc.ini
UNIX (Sun Solaris, IBM AIX)

Las plataformas UNIX requieren bibliotecas especficas de la marca o plataforma y el archivo Saprfc.ini de SDK RFC SAP especfico de la plataforma, disponible desde SAP. Las bibliotecas y el archivo Saprfc.ini pueden colocarse en cualquier lugar del equipo donde se est ejecutando el servidor TM1. Debe modificar una de las siguientes variables de sistema para incluir la ubicacin de la biblioteca RFC SAP, dependiendo del sistema operativo especfico.
LD_LIBRARY_PATH (Sun Solaris) LIBPATH (IBM AIX)
Tambin debe actualizar la variable RFC_INI, de forma que indique la ruta completa del archivo Saprfc.ini.
Ejemplo de Sun Solaris

Edite las variables LD_LIBRARY_PATH y RFC_INI tal y como se indica a continuacin:
LIBPATH=${LIBPATH}:$tm1_path:/usr/lib:/lib LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:$tm1_path:/usr/openwin/lib:/usr/lib://lib:/ home/software/sap_rfc_sdk/lib SHLIB_PATH={SHLIB_PATH}:$tm1_path:/usr/lib:/lib RFC_INI=/home/software/sap_rfc_sdk/text/saprfc.ini export SHLIB_PATH export LD_LIBRARY_PATH export LIBPATH export TM1_PATH export RFC_INI
Ejemplo de IBM AIX

Edite las variables LIBPATH y RFC_INI tal y como se indica a continuacin:
LIBPATH=${LIBPATH}:$tm1_path:/usr/lib:/lib:/home/software/sap_rfc_sdk/lib LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:$tm1_path:/usr/openwin/lib:/usr/lib://lib SHLIB_PATH={SHLIB_PATH}:$tm1_path:/usr/lib:/lib RFC_INI=/home/software/sap_rfc_sdk/text/saprfc.ini export SHLIB_PATH export LD_LIBRARY_PATH export LIBPATH export TM1_PATH export RFC_INI
Instalacin de la interfaz de TM1 en BW SAP

Para instalar la interfaz, siga las instrucciones que se describen en una de las siguientes publicaciones, en funcin de su versin. Estos archivos se incluyen con el software TM1 Connector para BW SAP: Installation_Guide_SyskoTM1_Release_70A_SP02.pdf (para BI 7.0) Installation_Guide_SyskoTM1_Release_10A_SP12.pdf (para BW 3.5)
Importacin de un InfoCube desde SAP

Cuando importa un InfoCube SAP a TM1, las caractersticas del InfoCube se convierten a dimensiones TM1. Estas nuevas dimensiones se utilizan posteriormente para crear un nuevo cubo TM1. Para importar un InfoCube de SAP a TM1: Establezca la conexin a su fuente de datos MAS. Consulte "Establecimiento de una conexin con BW SAP" (p. 49). Asigne las caractersticas de los datos SAP a las estructuras de datos TM1. Consulte:
48 IBM Cognos TM1
Captulo 6: Importacin de datos utilizando TM1 Connector for SAP Business Warehouse "Asignacin de un InfoCube SAP a un cubo TM1" (p. 50). "Asignacin de caractersticas SAP a dimensiones TM1" (p. 52). "Establecimiento de restricciones de caractersticas" (p. 55). "Seleccin de parmetros de caractersticas" (p. 57).
Guarde el proceso y ejectelo. Consulte "Guardar y ejecutar el proceso SAP TurboIntegrator" (p. 58). Verifique la salida. Consulte "Ver los resultados" (p. 58).
Establecimiento de una conexin con BW SAP

Antes de que pueda importar datos de SAP o escribir datos en una tabla ODS, debe establecer primero una conexin con SAP siguiendo los siguientes pasos.
Pasos
1. En el panel de la izquierda de Server Explorer de TM1, haga clic con el botn derecho del ratn en el grupo Procesos y seleccione Crear nuevo proceso. Se abrir la ventana TurboIntegrator. 2. Haga clic en la opcin SAP en el cuadro Tipo de fuente de datos. 3. Introduzca valores de parmetros de conexin en la pestaa Conexin. Su administrador SAP puede proporcionarle los valores de parmetros correctos. Nota: cuando un valor de parmetro de conexin SAP contiene espacios, debe ponerse entre comillas dobles cuando se conecte a SAP desde TurboIntegrator.
Por ejemplo, Belfast BW System es un nombre de sistema SAP vlido, pero si intenta conectarse a este sistema desde TurboIntegrator sin poner el nombre del sistema entre comillas, fallar la conexin.
Valor del parmetro

System
Descripcin
Nombre del sistema SAP al que desea conectarse. Si el nombre del sistema incluye espacios, ponga el nombre entre comillas dobles.
Cliente
Un nmero que corresponde a la versin de interfaz de usuario del servidor SAP. Por ejemplo, 498. Su nombre de usuario en el sistema SAP. Su contrasea en el sistema SAP. Idioma que desea utilizar para conectarse al sistema SAP. Todas las descripciones textuales se cambian al idioma especificado si est disponible. El parmetro de idioma es una abreviatura de dos letras, por ejemplo, EN=English.
Usuario Contrasea Language
Parmetros de conexin adicio- Introduzca otros parmetros y valores para utilizarlos al nales conectarse a su sistema BW SAP. Tamao de paquete Valor que limita el nmero de filas de cada paquete que se enva de SAP a TM1. Un tamao de paquete reducido dara como resultado un aumento del trfico de red con paquetes pequeos, mientras que un tamao mayor resulta en una disminucin del trfico de red pero con paquetes ms grandes por transmisin. El tamao de paquete por defecto, que es adems el tamao mnimo, es 50.000.
4. Haga clic en Conectar.
Asignacin de un InfoCube SAP a un cubo TM1

Para asignar un InfoCube SAP a un cubo TM1:
Pasos
1. Seleccione InfoCube en la lista de fuentes SAP. 2. Haga clic en la pestaa InfoCube. 3. Decida si desea ver los objetos SAP por nombre tcnico o nombre descriptivo en TurboIntegrator Para ver los objetos SAP por nombre tcnico, seleccione la opcin Mostrar nombres tcnicos SAP. 50 IBM Cognos TM1
Captulo 6: Importacin de datos utilizando TM1 Connector for SAP Business Warehouse Para ver los objetos SAP por nombre descriptivo, desactive la opcin Mostrar nombres tcnicos SAP. 4. Haga clic en la opcin Seleccionar InfoCube para cargar desde y seleccione el InfoCube SAP que desea importar a TM1. Si selecciona Mostrar nombres tcnicos SAP, los InfoCubes se muestran y ordenan por nombre tcnico en la primera columna con los nombres descriptivos correspondientes estn visibles en la segunda columna para ayudarle a identificarlos. Cuando no se selecciona Mostrar nombres tcnicos SAP, InfoCubes ordena por nombres descriptivos con los nombres tcnicos visibles en la segunda columna. 5. Si desea importar el InfoCube SAP a un cubo TM1 existente, haga clic en la opcin Seleccionar cubo TM1 para cargar y seleccione el cubo TM1 que recibir los datos del InfoCube SAP. Si desea crear un nuevo cubo TM1 cuando importe el InfoCube, introduzca el nombre del nuevo cubo TM1 en el campo Seleccionar cubo TM1 para cargar en. 6. Seleccione una Accin de cubo TM1.
Accin de cubo TM1

Crear cubo
Descripcin
Importa datos y metadatos desde el InfoCube SAP y crea un nuevo cubo en TM1. Utilice esta opcin nicamente cuando no exista en el servidor TM1 ninguno de los cubos y dimensiones que est importando. Destruye un cubo TM1 existente y lo reconstruye utilizando los datos y metadatos del InfoCube SAP. Utilice esta opcin solo cuando existan las dimensiones y el cubo TM1 y desee sustituirlos por nuevas estructuras y datos del InfoCube SAP.
Recrear cubo
Actualizar cubo Importa datos de un cubo SAP existente y los inserta en un cubo TM1 existente. Esta opcin no cambia la estructura de los cubos y dimensiones en el servidor TM1. Ninguna accin Los procesos que especifican Ninguna accin no afectan a los datos o metadatos de los cubos TM1. Utilice esta opcin para probar y depurar procesos o para definir sus propias operaciones personalizadas.
7. Seleccione una Accin de datos.
Accin de datos Descripcin

Almacenar valores Esta opcin escribe valores de celda del InfoCube SAP en el cubo TM1. Si elige esta opcin cuando est seleccionada la opcin Actualizar cubo, se sobrescriben los valores existentes del cubo TM1 con los valores importados del InfoCube. Acumular valores La opcin Acumular valores le permite agregar valores de cubo TM1 existentes con valores importados de un InfoCube SAP. Porcin de puesta Esta opcin se habilita cuando selecciona la accin Actualizar cubo. a cero del cubo de Seleccione esta opcin si desea establecer todos los puntos de datos en destino una vista de cubo especfica como cero. Para definir la vista de cubo como cero, puede: Hacer clic en la lista de Vista para seleccionar una vista existente y ponerla a cero. Hacer clic en el botn Ms junto a la lista opciones de Vista para definir una nueva vista para poner a cero.
8. Para registrar los cambios en los datos del cubo mientras importa un InfoCube SAP, seleccione la opcin Activar registro de cubos. Para deshabilitar la el registro durante la importacin, desactive la opcin Activar registro de cubos. Nota: deshabilitar el registro acelera la carga y la actualizacin de los datos, pero imposibilita la recuperacin de cualquier actualizacin si se produce un fallo del sistema.
Asignacin de caractersticas SAP a dimensiones TM1

Para asignar caractersticas SAP a dimensiones TM1:
Pasos
1. Haga clic en la pestaa Caractersticas. Para cada caracterstica SAP que aparezca en la pestaa Caracterstica, realice los pasos descritos en "Asignacin de un InfoCube SAP a un cubo TM1" (p. 50). A continuacin, contine con Seleccionar jerarquas. 2. Haga clic en el botn Seleccionar jerarquas. Se abre el cuadro de dilogo Seleccionar jerarquas. 3. Haga clic en la lista Fecha de evaluacin y seleccione una fecha de evaluacin. La fecha seleccionada aparece con una casilla de verificacin en la opcin de Fecha de evaluacin.
52 IBM Cognos TM1
Captulo 6: Importacin de datos utilizando TM1 Connector for SAP Business Warehouse Las jerarquas temporales se importan a TM1 tal como se encontraban en la fecha seleccionada. Las jerarquas que no son temporales se importan tal y como se encuentran en el momento de la ejecucin del proceso. Si no selecciona una fecha de evaluacin o si elimina la casilla de verificacin de la opcin Fecha de evaluacin, todas las jerarquas se importarn tal y como se encuentren en la fecha en que se ejecuta el proceso TM1. 4. Seleccione las jerarquas que desea importar a TM1 y haga clic en Aceptar. Si la caracterstica SAP no contiene jerarquas, puede hacer clic en Cancelar para descartar el cuadro de dilogo Seleccionar jerarquas. Importante: una jerarqua con intervalos no se puede importar a TM1. El intento de importar una jerarqua de ese tipo provoca el fallo del proceso TurboIntegrator. Debe estar familiarizado con las caractersticas de su SAP y asegurarse de que no intenta importar una jerarqua que contenga intervalos. 5. Si la caracterstica se asigna a una dimensin TM1 existente, haga clic en la columna TM1 Dimensin y seleccione la dimensin que corresponda a la caracterstica. Si desea crear una nueva dimensin TM1 a partir de la caracterstica, introduzca un nombre para la dimensin en la columna TM1 Dimensin. Si no desea importar la caracterstica a su cubo TM1, deje vaca la columna TM1 Dimensin. 6. Seleccione una Accin de dimensin TM1.
Accin de dimensin
Crear Recrear
Descripcin
Crear una nueva dimensin TM1 desde la caracterstica SAP. Recrear completamente una dimensin TM1 existente con elementos importados desde la caracterstica SAP. Actualizar una estructura de dimensin existente aadiendo nuevos elementos importados desde la caracterstica SAP. Procesar la caracterstica a travs de TurboIntegrator pero sin utilizar la caracterstica para crear o modificar ninguna de las dimensiones TM1. Utilice esta opcin para probar y depurar los procesos, o para manipular la caracterstica en la pestaa Avanzado de TurboIntegrator.
Actualizar
Tal cual
No cargar
No importar la caracterstica SAP a TM1. La caracterstica se excluye completamente cuando se procesa el InfoCube SAP a travs de TurboIntegrator.
7. Haga clic en el botn Seleccionar atributos. Se abrir el cuadro de dilogo Atributos de caracterstica.
Captulo 6: Importacin de datos utilizando TM1 Connector for SAP Business Warehouse 8. Haga clic en la lista Fecha de evaluacin y seleccione una fecha de evaluacin para los atributos. Cuando se selecciona una fecha de evaluacin, aparece la fecha con una casilla de verificacin en la opcin Fecha de evaluacin, y todos los atributos SAP que dependen del tiempo se importarn a TM1 tal y como se encontraban en la fecha especfica. Los atributos que no son temporales se importan como se encuentran en el momento de la ejecucin del proceso. Si no selecciona una fecha de evaluacin o si elimina la casilla de verificacin de la opcin Fecha de evaluacin, todos los atributos SAP se importarn tal como se encuentren en la fecha en que se ejecute el proceso TM1. 9. Asigne cada atributo de caracterstica SAP a un atributo TM1 de una de las maneras siguientes: Para asignar un atributo SAP a un nuevo atributo TM1, introduzca un nombre para el nuevo atributo TM1 en el campo Atributo TM1 correspondiente y, a continuacin, seleccione un Tipo de atributo. El nuevo atributo TM1 se crear cuando ejecute el proceso TurboIntegrator. Para asignar un atributo SAP a un atributo TM1 existente, haga clic en el campo Atributo TM1 correspondiente, seleccione un atributo y, a continuacin, seleccione un Tipo de atributo.
Tipo de atri- Descripcin buto

Texto Numrico Alias Identifica atributos con un valor de cadena. Identifica atributos con un valor numrico. Identifica atributos que son nombres alternativos para las dimensiones a las que estn asociados. Puede utilizar este atributo para mostrar las dimensiones por sus nombres alternativos en la interfaz de usuario de TM1. Un alias de dimensin debe ser exclusivo con respecto al resto de alias de dimensin o nombres de dimensin reales.
Ahora debe asignar las cifras clave de SAP a una dimensin TM1. Las cifras clave aparecen en la ltima fila de la pestaa Caractersticas. 10. Haga clic en Seleccionar cifras clave. Se abre el cuadro de dilogo Seleccionar cifras clave. 11. Seleccione cada cifra clave que desee importar a TM1. 12. Haga clic en Aceptar. 13. Asigne las cifras clave a una dimensin TM1. Si las cifras clave se asignan a una dimensin TM1 existente, haga clic en la columna TM1 Dimensin y seleccione la dimensin que corresponda a las cifras clave.
54 IBM Cognos TM1
Captulo 6: Importacin de datos utilizando TM1 Connector for SAP Business Warehouse Si desea crear una nueva dimensin TM1 a partir de las cifras clave, introduzca un nombre para la dimensin en la columna TM1 Dimensin. 14. Seleccione una Accin de dimensin TM1 para las cifras clave, como se describa anteriormente en el paso 5.
Establecimiento de restricciones de caractersticas

Puede crear un filtro en su proceso TurboIntegrator para que se importen a TM1 solo los valores de datos que se identifiquen con caractersticas que queden dentro de las restricciones especificadas. Para crear un filtro:
Pasos
1. Haga clic en el botn Restricciones de la pestaa Caractersticas. 2. Haga clic en Aadir restriccin en el cuadro de dilogo Restricciones. Se inserta una nueva fila en el cuadro de dilogo. 3. Haga clic en la lista en la columna Caractersticas SAP y seleccione la caracterstica para la que desea definir una restriccin. 4. Haga clic en la lista en la columna Firmar y seleccione si la restriccin ser inclusiva o exclusiva. Elija Incluir si desea que el proceso TurboIntegrator importe solo aquellos valores que queden dentro de la definicin de la restriccin. Elija Excluir si desea que el proceso TurboIntegrator importe solo aquellos valores que queden fuera de la definicin de la restriccin. 5. Haga clic en la columna Opcin y seleccione un operador para la restriccin. Puede elegir entre ocho operadores, como se describe en la tabla siguiente.
Operador
= <>
Descripcin
La restriccin identifica solo caractersticas iguales al Valor bajo especificado. La restriccin identifica nicamente caractersticas inferiores o superiores al Valor bajo especificado. La restriccin identifica nicamente caractersticas inferiores al Valor bajo especificado. La restriccin identifica nicamente caractersticas superiores al Valor bajo especificado. La restriccin identifica nicamente caractersticas inferiores o iguales al Valor bajo especificado.
<
>
<=
Operador
>=
Descripcin
La restriccin identifica nicamente caractersticas superiores o iguales al Valor bajo especificado. La restriccin identifica nicamente caractersticas que quedan entre el Valor bajo y el Valor elevado, ambos incluidos. La restriccin identifica nicamente caractersticas que quedan fuera del Valor bajo y el Valor elevado, ambos incluidos.
[]
][
6. Introduzca un valor bajo para la restriccin en la columna Valor bajo. 7. Introduzca un valor elevado para la restriccin, si es necesario, en la columna Valor elevado. 8. Repita los pasos 2 a 8 para cada restriccin que desee aadir a su filtro. 9. Haga clic en Aceptar. Nota: las restricciones no se validan a travs de TurboIntegrator. Debe asegurarse de que las restricciones que introduce son precisas y vlidas para sus datos SAP.
Ejemplo de filtro simple

El siguiente ejemplo de filtro simple incluye dos restricciones. Cuando se ejecute el proceso TurboIntegrator, TM1 importar nicamente los valores de caracterstica ZUNIQUE entre 100 y 500. El proceso tambin importar todos los valores de caracterstica 0CALDAY excepto los inferiores a 7.
Caracterstica SAP
ZUNIQUE OCALDAY
Sgn
Incluir Excluir
Opcin
[] <
Valor bajo
100 7
Valor elevado
500
Nota importante sobre caractersticas compuestas

En el caso de caractersticas compuestas, las restricciones deben introducirse por separado. Por ejemplo, la caracterstica de tiempo 0FISPER (periodo fiscal) est compuesta en 0FISCVARNT (variante fiscal), por lo que la clave de elemento compuesto de 0FISCPER es de 9 caracteres de longitud, por ejemplo K42007001. Si desea restringir el periodo fiscal a los tres primeros periodos de 2007 y est utilizando la variante fiscal K4, debe definir las dos restricciones siguientes:
Caracterstica SAP
OFISCVARNT OFISCPER
Sgn
Incluir Incluir
Opcin
= []
Valor bajo
1K4 2007001
Valor elevado
2007003
56 IBM Cognos TM1
Seleccin de parmetros de caractersticas

Los parmetros de caractersticas gestionan la seguridad, consolidacin, alias importados y otras opciones de cada caracterstica que est importando. Para cada caracterstica SAP que est importando, siga los siguientes pasos:
Pasos
1. Si desea importar las asignaciones de seguridad SAP para la caracterstica a TM1, seleccione la opcin Importar seguridad. Cuando elige importar la seguridad de SAP, TurboIntegrator crea nuevos grupos de usuarios de TM1 y asigna privilegios de seguridad de la dimensin a aquellos grupos basados en los roles de seguridad que se definieron en SAP. Como el modelo de seguridad de SAP solo es compatible con los privilegios de Lectura y Ninguno, estos son los nicos que se crean en TM1. Por ejemplo, si el sistema SAP incluye un rol llamado Planificador con acceso de Lectura a la caracterstica Centro de coste, TurboIntegrator crea un nuevo grupo de usuarios de TM1 llamado Planificador y asigna al grupo de usuarios el acceso de Lectura a la dimensin TM1 que se ha creado o actualizado a partir de la caracterstica Centro de coste. 2. Si desea crear una consolidacin de nivel superior para la la dimensin de TM1 que se ha creado a partir de la caracterstica, introduzca el nombre de la consolidacin de nivel superior en la columna Consolidacin superior. La dimensin TM1 resultante incluir una consolidacin que llevar el nombre que haya introducido. Por ejemplo, si introduce Total en la columna Consolidacin superior, la dimensin incluye una consolidacin de nivel superior llamada Total con todos los elementos importados como hijos de la consolidacin. 3. Si desea asegurar que se generan alias de TM1 exclusivos para todos elementos que se crean a partir de la caracterstica SAP, seleccione la opcin Convertir los textos en exclusivos. Cuando importa una caracterstica SAP a TM1, los valores de caracterstica se convierten en elementos de dimensin TM1 mientras que las descripciones de valores SAP se convierten en alias de elementos de TM1. En TM1, todos los alias de elemento de una dimensin deben ser exclusivos. Si un proceso TurboIntegrator intenta asignar el mismo alias a varios elementos, el proceso generar errores y fallar la creacin del alias. Cuando la opcin Convertir los textos en exclusivos est seleccionada, TM1 examina las descripciones SAP que se han importado y convertido en alias de TM1. Si TM1 detecta que varios valores utilizan descripciones idnticas, TM1 anexa el nombre del valor a la descripcin para generar alias exclusivos. Por ejemplo, la siguiente tabla muestra cmo genera TM1 los alias cuando varios valores de la caracterstica SAP comparten la misma descripcin.
Valor de caracterstica SAP (elemento Descripcin de valor SAP Alias de TM1 de TM1)
US000 Regin Regin
Valor de caracterstica SAP (elemento Descripcin de valor SAP Alias de TM1 de TM1)
US001 US002 US003 Estado Estado Estado Estado Estado US002 Estado US003
El valor de caracterstica US000 tiene una descripcin de Regin. ste es el nico valor con esta descripcin, por lo que TM1 asigna Regin como alias. Los valores US001, US002 y US003 comparten todos la misma descripcin SAP, Estado. El primer valor detectado en el proceso TurboIntegrator que utiliza la descripcin Estado, el US001, recibe el alias Estado. Para mantener la exclusividad, el resto de los valores que utilizan la descripcin Estado reciben alias que se generan aadindole el nombre del valor al nombre de la descripcin. Es posible modificar sus scripts de TurboIntegrator para que utilicen la funcin AttrPutS para insertar alias exclusivos cuando importa una caracterstica SAP. Sin embargo, la opcin Convertir los textos en exclusivos se presenta como una forma sencilla de generar alias exclusivos sin necesidad de modificar scripts. 4. Haga clic en el botn de la columna Fecha de evaluacin y seleccione una fecha de evaluacin para la caracterstica. Todos los valores de caracterstica existentes entre la fecha seleccionada y la fecha de ejecucin del proceso se importarn a TM1. Si no selecciona una fecha de evaluacin, la fecha por defecto ser la fecha en la que se ejecuta el proceso TurboIntegrator.
Guardar y ejecutar el proceso SAP TurboIntegrator

Pasos
1. Haga clic en el botn Ejecutar . TM1 le solicitar que asigne un nombre al proceso y que lo guarde. 2. Guarde el proceso como create_newcube. Tras unos segundos, debera aparecer un mensaje confirmando que el proceso se ha ejecutado con xito. 3. Abra Server Explorer. Debera comprobar si se ha creado y llenado el cubo import_cube y si se hayan creado todas las dimensiones necesarias.
Ver los resultados

Cuando define un proceso para importar un InfoCube a TM1 y crear un nuevo cubo TM1, se producen las siguientes acciones:
58 IBM Cognos TM1
Captulo 6: Importacin de datos utilizando TM1 Connector for SAP Business Warehouse Para cada caracterstica SAP que elige incluir en su cubo, TM1 genera un proceso para importar la caracterstica y crear la dimensin TM1 correspondiente. TM1 genera un proceso maestro que ejecuta los procesos de creacin de dimensiones descritos anteriormente, construye el cubo TM1 e importa valores de datos. La imagen siguiente muestra los procesos que se crean cuando crea un proceso llamado SAP import para importar un InfoCube a TM1.
Proceso maestro
Procesos para crear dimensiones TM1 a partir de caractersticas SAP presentes en el InfoCube
Cuando define un proceso para crear o actualizar una dimensin TM1 a partir de una caracterstica SAP, todos los valores de la caracterstica se convierten en elementos de dimensin. El nombre tcnico del valor SAP es el nombre asignado al elemento TM1. El nombre de la descripcin SAP se convierte en un alias de elemento TM1.
Si elige importar atributos de la caracterstica SAP, TM1 crea nuevos atributos de dimensin y les asigna valores basados en los valores de atributo de la caracterstica de SAP. Si elige importar la informacin de seguridad para las caractersticas SAP, TM1 crea nuevos grupos de usuarios de TM1 y asigna privilegios de seguridad de la dimensin a aquellos grupos segn las funciones de seguridad que se definieron en SAP.
Importacin de una caracterstica desde SAP

Puede importar una caracterstica desde BW SAP a una dimensin TM1. Cuando importa una caracterstica, puede especificar qu atributos y jerarquas de SAP desea importar, as como elegir importar definiciones de seguridad SAP para la caracterstica. Para importar una caracterstica de SAP a TM1, siga el mismo procedimiento descrito por "Importacin de un InfoCube desde SAP" (p. 48), consulte "Asignacin de una caracterstica SAP a una dimensin TM1" (p. 60) para obtener instrucciones sobre cmo realizar la asignacin.
Asignacin de una caracterstica SAP a una dimensin TM1

Para asignar una caracterstica SAP a una dimensin TM1:
Pasos
1. Seleccione Caracterstica en la lista de fuentes SAP. 2. Haga clic en la pestaa Caracterstica. 3. Para ver los nombres tcnicos de las caractersticas SAP de su sistema, seleccione la opcin Mostrar nombres tcnicos SAP. Para ver los nombres descriptivos de las caractersticas SAP de su sistema, desactive la opcin Mostrar nombres tcnicos SAP. 4. Haga clic en la opcin InfoCube SAP y seleccione el InfoCube SAP que contiene la caracterstica que desea importar a TM1. 5. Haga clic en la opcin Caracterstica SAP para cargar desde y seleccione la caracterstica SAP que desea importar a TM1. 6. Si desea importar la caracterstica SAP a una dimensin TM1 existente, haga clic en la opcin TM1 Dimensin para cargar en y seleccione la dimensin TM1 que recibir los datos de la caracterstica SAP. Si desea crear una nueva dimensin TM1 cuando importe la caracterstica, introduzca el nombre de la nueva dimensin TM1 en el campo TM1 Dimensin para cargar en. 7. Seleccione una Accin de dimensin TM1.
Accin de dimensin
Crear Recrear
Descripcin
Crear una nueva dimensin TM1 desde la caracterstica SAP. Recrear completamente una dimensin TM1 existente con elementos importados desde la caracterstica SAP. Actualizar una estructura de dimensin existente aadiendo nuevos elementos importados desde la caracterstica SAP. No importar la caracterstica SAP a TM1. Seleccione esta accin solo si desea guardar la definicin del proceso sin importar realmente la caracterstica SAP. Posteriormente podr cambiar la Accin de dimensin a Crear, Recrear o Actualizar (segn convenga) cuando desee importar la caracterstica.
Actualizar
No cargar
8. Si desea importar las asignaciones de seguridad SAP de la caracterstica a TM1, seleccione la opcin Recuperar los parmetros de seguridad.
60 IBM Cognos TM1
Captulo 6: Importacin de datos utilizando TM1 Connector for SAP Business Warehouse Cuando elige importar la seguridad de SAP, TurboIntegrator crea nuevos grupos de usuarios de TM1 y asigna privilegios de seguridad de la dimensin a aquellos grupos basados en los roles de seguridad que se definieron en SAP. Como el modelo de seguridad de SAP solo es compatible con los privilegios de Lectura y Ninguno, estos son los nicos que se crean en TM1. Por ejemplo, si el sistema SAP incluye un rol llamado Planificador con acceso de Lectura a la caracterstica Centro de coste, TurboIntegrator crea un nuevo grupo de usuarios de TM1 llamado Planificador y asigna al grupo de usuarios el acceso de Lectura a la dimensin TM1 que se ha creado o actualizado a partir de la caracterstica Centro de coste. 9. Si desea crear una consolidacin de nivel superior para la dimensin de TM1 que se ha creado a partir de la caracterstica, introduzca el nombre de la consolidacin de nivel superior en el cuadro Consolidacin superior. 10. Haga clic en el botn Seleccionar jerarquas. Se abre el cuadro de dilogo Seleccionar jerarquas. 11. Haga clic en la lista Fecha de evaluacin y seleccione una fecha de evaluacin. La fecha seleccionada aparece con una casilla de verificacin en la opcin de Fecha de evaluacin. Todas las jerarquas existentes entre la fecha de evaluacin seleccionada y la fecha de ejecucin del proceso se importarn a TM1 Si no selecciona una fecha de evaluacin o si elimina la casilla de verificacin de la opcin Fecha de evaluacin, las jerarquas se importarn tal y como se encuentren en la fecha en la que se ejecute el proceso TM1. 12. Seleccione las jerarquas que desea importar a TM1 y haga clic en Aceptar. Si la caracterstica SAP no contiene jerarquas, puede hacer clic en Cancelar para descartar el cuadro de dilogo Seleccionar jerarquas. Importante: ninguna jerarqua con intervalos se puede importar a TM1. El intento de importar una jerarqua de ese tipo provoca el fallo del proceso TurboIntegrator. Debe estar familiarizado con sus caractersticas SAP y asegurarse de que no intenta importar una jerarqua que contenga intervalos. 13. Haga clic en el botn Seleccionar atributos. Se abrir el cuadro de dilogo Atributos de caracterstica. 14. Haga clic en la lista Fecha de evaluacin y seleccione una fecha de evaluacin para los atributos La fecha seleccionada aparece con una casilla de verificacin bajo la opcin Fecha de evaluacin, y todos los atributos SAP existentes entre la fecha de evaluacin seleccionada y la fecha de ejecucin del proceso se importarn a TM1. Si no selecciona una fecha de evaluacin o si elimina la casilla de verificacin de la opcin Fecha de evaluacin, los atributos SAP se importarn tal como se encuentren en la fecha en que se ejecute el proceso TM1. 15. Asigne cada atributo de caracterstica SAP a un atributo TM1 de una de las maneras siguientes:
Captulo 6: Importacin de datos utilizando TM1 Connector for SAP Business Warehouse Introduzca el nombre de atributo TM1 correspondiente a cada atributo SAP y, a continuacin, seleccione un Tipo de atributo. Haga clic para seleccionar un nombre de atributo TM1 existente para cada atributo SAP y, a continuacin, seleccione un Tipo de atributo.

16. Si desea asegurar que se generan alias de TM1 exclusivos para todos elementos que se crean a partir de la caracterstica SAP, seleccione la opcin Convertir los textos en exclusivos. Para obtener ms informacin, consulte "Seleccin de parmetros de caractersticas" (p. 57). 17. Haga clic en la lista Fecha de evaluacin y seleccione una fecha de evaluacin para la caracterstica. Todos los valores de caracterstica existentes entre la fecha seleccionada y la fecha de ejecucin del proceso se importarn a TM1. Si no selecciona una fecha de evaluacin, la fecha por defecto ser la fecha en la que se ejecuta el proceso TurboIntegrator. Guarde y ejecute el proceso Atributos.
Importacin de seguridad desde SAP

Puede importar los nombres de usuario y los roles de SAP a TM1. Cuando importa definiciones de seguridad SAP, los roles de SAP se convierten en grupos de usuarios de TM1, mientras que los nombres de usuario de SAP se convierten en usuarios de TM1. Nota: cuando importa nombres de usuario de SAP a TM1, las contraseas correspondientes a los nombres de usuario no se importan a TM1. Los usuarios de TM1 resultantes tienen una contrasea vaca en TM1. Para importar seguridad de SAP, siga el mismo procedimiento descrito en "Importacin de un InfoCube desde SAP" (p. 48), consulte "Seleccin de las definiciones de seguridad SAP que desea importar" (p. 63) para identificar las selecciones.
62 IBM Cognos TM1
Seleccin de las definiciones de seguridad SAP que desea importar

Para especificar qu definiciones de seguridad SAP desea importar:
Pasos
1. Seleccione Seguridad en la lista de fuentes SAP. 2. Haga clic en la pestaa Seguridad. Puede elegir importar cualquier combinacin de roles y nombres de usuario. Si especifica solo una cadena de Filtro de rol, TM1 importa nicamente los roles SAP que coinciden con la cadena del filtro, y utiliza esos roles para crear grupos de usuarios de TM1. Si especifica solo una cadena de Filtro nombre de usuario, TM1 importa solo los nombres de usuario de SAP que coinciden con la cadena del filtro y los utiliza para crear usuarios de TM1. Si especifica tanto una cadena de Filtro de rol y otra de Filtro nombre de usuario, TM1 importa los roles SAP y nombres de usuario que se ajustan a las respectivas cadenas. Los roles de SAP se convierten en grupos de usuarios de TM1 y los nombres de usuario de SAP se convierten en usuarios de TM1. Posteriormente, los usuarios de TM1 se asignan a los grupos de usuarios de TM1 apropiados, segn las asociaciones de rol/nombre de usuario de SAP. Si deja los cuadros de Filtro de rol y Filtro nombre de usuario vacos, TM1 importa todos los roles y nombres de usuario de SAP.
3. Para especificar un Filtro de rol, introduzca una cadena de bsqueda en el cuadro Filtro de rol. La cadena de bsqueda puede incluir el carcter comodn %, que representa cualquier nmero de caracteres. Tambin puede hacer clic en la lista para seleccionar el nombre de rol concreto que desea importar a TM1. 4. Para especificar un Filtro nombre de usuario, introduzca una cadena de bsqueda en el cuadro Filtro nombre de usuario. Como en el Filtro de rol, puede utilizar el carcter comodn % en la cadena de bsqueda. Guarde y ejecute el proceso Atributos.
Importar resultados de seguridad

Cuando importa la seguridad de SAP, todos los roles de SAP se convierten en grupos de usuarios de TM1 y todos los nombres de usuario de SAP se convierten en usuarios de TM1. Posteriormente, los usuarios de TM1 se asignan a los grupos de usuarios de TM1 apropiados, segn las asociaciones de rol/nombre de usuario de SAP.
Importacin y conversin de datos de divisa desde SAP

Puede importar datos de divisa desde BW SAP a un cubo TM1. El cubo que recibe los datos de divisa debe contener exactamente tres dimensiones: una para la divisa inicial (la divisa desde), una para la segunda divisa (la divisa a) y otra para el mtodo de conversin de divisa. Para importar datos de divisa desde SAP a TM1, siga el procedimiento siguiente descrito en "Importacin de un InfoCube desde SAP" (p. 48). Consulte "Asignacin de divisas de SAP a cubos y dimensiones de TM1" (p. 64) para asignar divisas.
Asignacin de divisas de SAP a cubos y dimensiones de TM1

Para asignar datos de divisa de SAP a cubos y dimensiones de TM1:
Pasos
1. Seleccione Divisa en la lista de fuentes SAP. 2. Haga clic en la pestaa Divisa de SAP. 3. Para ver los nombres tcnicos para las divisas de SAP y los tipos de conversin, seleccione la opcinMostrar nombres tcnicos SAP. Para ver los nombres descriptivos, desactive la opcin Mostrar nombres tcnicos SAP. Nota: los elementos TM1 creados durante el proceso de importacin siempre utilizan nombres tcnicos de SAP, independientemente de los parmetros de la opcin Mostrar nombres tcnicos SAP. 4. Para importar datos de divisa a un cubo tridimensional existente en su servidor TM1, haga clic en el campo Introducir nombre del cubo y seleccione el cubo. Para crear un nuevo cubo para almacenar los datos de divisa de SAP, introduzca un nombre de cubo en el campo Introducir nombre del cubo. 5. Haga clic en el campo Divisa DESDE para seleccionar la divisa inicial que desea importar desde SAP. La lista de divisas disponibles refleja las divisas definidas en su sistema SAP. 6. En el campo Dimensin de destino adyacente, especifique la dimensin TM1 que recibir las cadenas de divisa de SAP. 7. Haga clic en el campo Divisa A para seleccionar la segunda divisa que desea importar desde SAP. La lista de divisas disponibles refleja las divisas definidas en su sistema SAP. 8. En el campo Dimensin de destino adyacente, especifique la dimensin TM1 que recibir las cadenas de divisa de SAP. 9. Haga clic en el campo Tipo de conversin para seleccionar el mtodo de conversin que utilizar para convertir la divisa inicial en la segunda divisa.
64 IBM Cognos TM1
Captulo 6: Importacin de datos utilizando TM1 Connector for SAP Business Warehouse La lista de tipos de conversin disponibles refleja los mtodos de conversin definidos en su sistema SAP. 10. En el campo Dimensin de destino adyacente, especifique la dimensin TM1 que recibir los tipos de conversin de SAP.
Uso de comodines en la pestaa Divisa de SAP

Las cadenas de comodines solo son vlidas cuando est seleccionada la opcin Mostrar nombres tcnicos SAP. En lugar de seleccionar un solo elemento de las listas Divisa DESDE, Divisa A y Tipo de conversin, puede introducir una cadena de comodines para recuperar todos los elementos coincidentes en SAP. El nico carcter comodn vlido es %, que encuentra cualquier cadena de 0 o ms caracteres. Por ejemplo, introduzca el carcter comodn % en los campos Divisa DESDE, Divisa A y Tipo de conversin para recuperar todos los tipos de conversin y divisas de SAP.
Tambin puede utilizar el carcter % en combinacin con otros caracteres. Por ejemplo, introduzca EU% en el campo Divisa DESDE para recuperar todas las divisas que comiencen con los caracteres EU, o introduzca 001% en el campo Tipo de conversin para recuperar todos los tipos de conversin que comiencen con los caracteres 001. Cuando utiliza comodines, solo se importan a TM1 aquellos registros de SAP que coinciden con todas las cadenas de comodines especificadas. Por ejemplo, asumamos que su fuente SAP contiene los registros que se muestran en la tabla siguiente:
Divisa DESDE
RUB SAR
Divisa A
EUR EUR
Tipo de conversin
EURX20010101 EURX20010101
Valor
26.980003.54000-
Divisa DESDE
DEM
Divisa A
USD
Tipo de conversin
200119970101
Valor
1.64110-
Si la pestaa Divisa de SAP utiliza las cadenas de comodines que se muestran a continuacin, no se recuperar ningn registro. Ninguno de los registros de la fuente SAP coincide con todas las cadenas de comodines especificadas.
Guarde y ejecute el proceso Atributos.
Resultados de la divisa
Cuando importa datos de divisa desde SAP, se producen las siguientes acciones: La Divisa DESDE (o divisas, si se utilizan comodines) especificada se crea como un elemento en la dimensin de destino especificada. La Divisa A (o divisas, si se utilizan comodines) especificada se crea como un elemento en la dimensin de destino especificada. El Tipo de conversin (o tipos de conversin, si se utilizan comodines) especificado se crea como un elemento en la dimensin de destino especificada. Los valores de divisa se escriben en el cubo TM1 especificado.
La siguiente imagen muestra un cubo que se ha creado mediante la importacin de todos los datos de divisa SAP a TM1 utilizando comodines, como se muestra anteriormente. Los elementos creados en las dimensiones currency1 y currency2 se identifican fcilmente como cdigos de divisa. El elemento de ttulo M es un tipo de conversin de SAP.
66 IBM Cognos TM1
Guarde y ejecute el proceso Atributos.
Importacin de una tabla SAP

Para utilizar TurboIntegrator para importar una tabla BW SAP a un cubo TM1, siga el mismo procedimiento descrito en "Importacin de un InfoCube desde SAP" (p. 48). Consulte "Creacin de una consulta de tabla SAP" (p. 67) y "Identificacin y asignacin de variables" (p. 68).
Creacin de una consulta de tabla SAP

Para consultar una tabla que se encuentra en su sistema SAP:
Pasos
1. Seleccione Tabla SAP en la lista de fuentes SAP. 2. Haga clic en la pestaa Tabla SAP. 3. Introduzca el nombre de la tabla SAP que desea consultar en el cuado Nombre tabla. 4. En el cuadro Cadena de filtro, introduzca una cadena de filtro SQL para utilizarla en la clusula WHERE cuando la instruccin de SQL SELECT que ha generado TurboIntegrator se ejecute sobre la tabla SAP. Por ejemplo, para recuperar solo los clientes con un valor de R110, introduzca CUSTOMER = 'R110'. Nota: debe haber un espacio a ambos lados del signo (=) en la cadena de filtro que introduzca. Si falta el espacio en alguno de los lados del signo igual, se producir un error de sintaxis.
Captulo 6: Importacin de datos utilizando TM1 Connector for SAP Business Warehouse Cualquier error de sintaxis en la cadena de filtro que introduzca provocar la interrupcin del proceso TurboIntegrator. CUSTOMER = 'R110' se ejecutar correctamente. CUSTOMER='R110' provocar un error de sintaxis. Si no introduce una cadena de filtro, la instruccin SELECT generada devuelve la tabla entera.
Identificacin y asignacin de variables

Una vez realizada la consulta a la tabla SAP, TurboIntegrator genera una serie de variables basadas en el resultado de la consulta, con una variable para cada columna de la tabla SAP. Debe identificar y asignar cada variable para importar datos correctamente desde la tabla SAP. Para obtener ms detalles sobre la identificacin y asignacin de variables, consulte Identificacin de variables en la fuente de datos.
Escritura de datos TM1 en SAP

Puede escribir datos de TM1 en SAP creando un proceso TurboIntegrator que exporte los datos a una tabla ODS transaccional. La tabla ODS debe haber sido creada por un administrador SAP, y debe encontrarse en el sistema SAP antes de crear el proceso TurboIntegrator. Una vez que se han exportado correctamente los datos de TM1 a la tabla ODS, un administrador SAP puede utilizar la funcionalidad de SAP para pasar datos de una tabla ODS a un InfoCube SAP. En muchas casos, el ciclo de importacin de datos SAP a TM1 y exportacin de TM1 a SAP tendr un aspecto parecido al siguiente:
Import SAP InfoCube into TM1
Transfer data from ODS table to original InfoCube
Work with data in TM1
Export TM1 cube view to ODS table
Para exportar datos desde una vista de cubo TM1 a una tabla ODS, siga los mismos procedimientos para importar datos. Consulte "Asignacin de dimensiones y valores de una vista TM1 a una tabla ODS" (p. 69) para asignar dimensiones y valores.
68 IBM Cognos TM1
Asignacin de dimensiones y valores de una vista TM1 a una tabla ODS

Para asignar dimensiones y valores de una vista de cubo TM1 a una tabla ODS existente:
Pasos
1. Seleccione Tabla ODS en la lista de fuentes SAP. 2. Haga clic en la pestaa Configuracin de ODS. 3. Haga clic en el botn Examinar, junto al campo Seleccionar vista TM1 para elegir la vista que desea exportar. Tambin puede introducir un nombre de vista directamente en el campo Seleccionar vista TM1. El nombre debe tener el siguiente formato:
<ServerName>:<CubeName>-><ViewName>
Por ejemplo, para exportar la vista Regin del cubo SalesCube del servidor sdata1, utilizara la siguiente cadena:
sdata1:SalesCube->Region
Nota: al exportar de una vista de cubo a una tabla ODS, la ltima dimensin del cubo debe ser la dimensin de medidas. Si la dimensin de medidas no es la ltima dimensin del cubo, no podr asignar correctamente los valores del cubo a la columna(s) de cifras clave de la tabla ODS. 4. Para ver los nombres tcnicos de las tablas ODS de su sistema SAP, seleccione la opcin Mostrar nombres tcnicos. Para ver los nombres descriptivos, desactive la opcin Mostrar nombres tcnicos. 5. Haga clic en el campo Seleccionar tabla ODS para seleccionar la tabla ODS a la que desea exportar datos de TM1. Cuando selecciona una tabla ODS, la Columna de la tabla ODS muestra todas las columnas de la tabla seleccionada. Las columnas pueden ser caractersticas SAP o cifras clave. Debe conocer la estructura de las tablas ODS para saber qu columnas son caractersticas y cules son cifras clave; TurboIntegrator no distingue entre los tipos de columna de la tabla ODS. 6. Asignar dimensiones TM1 a las columnas de la caracterstica en la tabla ODS. Para asignar una dimensin, haga clic en la lista y seleccione la dimensin que desea asignar a la columna de tabla correspondiente. Por ejemplo, la siguiente tabla es una representacin de la dimensin TM1 account1 asignada a la columna de tabla 0QUANTITY.
Columna de la tabla ODS

OQUANTITY
TM1 Dimensin
account1
Seleccionar medida
Debe tener en cuenta los siguientes detalles al asignar dimensiones a las caractersticas:
Captulo 6: Importacin de datos utilizando TM1 Connector for SAP Business Warehouse No tiene que asignar una dimensin a cada columna de la caracterstica de la tabla ODS. Puede que algunas columnas no tengan una dimensin TM1 correspondiente cuando termine con la asignacin. En ese caso, cualquier columna de la caracterstica que no est asignada se vaciar al finalizar la exportacin. No debera asignar una nica dimensin TM1 a varias columnas de la tabla de caractersticas de ODS. La interfaz de usuario de TurboIntegrator no le impide hacerlo, pero tal asignacin dar como resultado valores de columna redundantes en la tabla ODS. Cuando asigna una dimensin de ttulo de vista TM1 a una caracterstica y la dimensin de ttulo no utiliza un subconjunto con nombre, solo se exportar a la tabla ODS el ltimo elemento del actual subconjunto de ttulo sin nombre. Si la dimensin de ttulo s utiliza un subconjunto con nombre, todos los elementos del subconjunto se exportan a la tabla ODS.
7. Asignar la dimensin de medidas de TM1 a todas las columnas de cifras clave de la tabla ODS. Se asume que la ltima dimensin de la vista del cubo de origen es la dimensin de medidas. Cuando asigna una dimensin de medidas a una columna de la tabla ODS, se habilita el botn Seleccionar medida. La siguiente tabla es una representacin de la dimensin account1 asignada a la columna de cifra clave 0QUANTITY de la tabla ODS. Como account1 es la ltima dimensin del cubo TM1, se habilita el botn Seleccionar medida.

OAMOUNT OQUANTITY
TM1 Dimensin
Seleccionar medida
account1
Seleccionar medida
8. Haga clic en el botn Seleccionar medida. Se abrir el editor de subconjuntos. 9. Seleccione el nico elemento que se asigna directamente a la columna de cifras clave de la tabla ODS y, a continuacin, haga clic en Aceptar. El elemento seleccionado se muestra como una etiqueta en el botn Seleccionar medida.

OAMOUNT OQUANTITY
TM1 Dimensin
Seleccionar medida
account1
Unidades
Si su tabla ODS incluye una nica columna de cifras clave, tambin puede utilizar las instrucciones de asignacin alternativa de cifras clave que se describen en la siguiente seccin. 10. Repita los pasos 7 a 9 para todas las columnas de cifras clave de la tabla ODS. 70 IBM Cognos TM1
Captulo 6: Importacin de datos utilizando TM1 Connector for SAP Business Warehouse Si su tabla ODS contiene varias columnas de cifras clave, la dimensin de medidas de TM1 debera asignarse a todas estas columnas, pero solo deber seleccionarse un nico elemento para cada cifra clave, como se muestra en la siguiente representacin:

OAMOUNT OQUANTITY OPRICE
TM1 Dimensin
account1 account1 account1
Seleccionar medida
Sales Unidades Precio
Instrucciones de asignacin alternativa de cifras clave

Si su tabla ODS incluye una nica columna de cifras clave, puede utilizar la opcin _TM1CellValue_ para asignar valores de cubo TM1 a la tabla ODS. No puede utilizar la opcin _TM1CellValue_ si su tabla ODS contiene varias columnas de cifras clave. Para utilizar la opcin _TM1CellValue_:
Pasos
1. Complete los pasos del 1 al 6 en"Asignacin de dimensiones y valores de una vista TM1 a una tabla ODS" (p. 69). 2. NO asigne la dimensin de medidas de TM1 a la columna de cifras clave. En su lugar, haga clic en la columna Dimensin TM1 y seleccione _TM1CellValue_. Por ejemplo, la siguiente tabla es una representacin de valores de cubo asignados a la columna de cifras clave 0SALES_UNIT.

OSALES_UNIT OQUANTITY
TM1 Dimensin
_TM1CellValue_ account1
Cuando utiliza este mtodo alternativo para asignar valores del cubo TM1, la dimensin de medidas de TM1 nodebera asignarse a ninguna columna ODS. Guarde y ejecute el proceso Atributos.
Resultados ODS
Tras la correcta ejecucin, se escriben los datos TM1 en la tabla ODS especificada, utilizando las asignaciones que especific.
72 IBM Cognos TM1
Captulo 7: Importacin de datos a travs de IBM Cognos TM1 Package Connector

IBM Cognos admite la conectividad con paquetes de IBM Cognos BI mediante TM1 Package Connector. Los paquetes pueden estar basados en InfoQueries e InfoCubes de SAP Business Warehouse. Existen tres fases para importar un paquete basado en BW SAP mediante TM1 Package Connector: Crear una consulta BW SAP. Tambin puede importar directamente desde un InfoCube. Crear un paquete con Framework Manager. Crear un paquete de TurboIntegrator que utilice TM1 Package Connector.
Este documento es principalmente un recurso que debe describirse mediante TM1 Package Connector. La segunda parte de este documento proporciona informacin sobre Directrices para trabajar con datos BW SAP y Crear un paquete con Framework Manager. Puede consultar ms informacin sobre estos temas en la documentacin de SAP y en la documentacin de IBM Cognos Framework Manager. IBM Cognos Package Connector es un componente opcional que est almacenado en un CD independiente del disco de instalacin de TM1 principal. Consulte "Instalacin de IBM Cognos TM1 Package Connector" en la Gua de instalacin de IBM Cognos TM1 para obtener ms informacin sobre cmo instalar y configurar IBM Cognos Package Connector.
Establecimiento de una conexin al servidor Cognos BI

Tras instalar y configurar los componentes, siga estas instrucciones para establecer la conexin:
Pasos
1. Ejecute TM1. 2. En el panel de la izquierda de Server Explorer de TM1, haga clic con el botn derecho del ratn en el grupo Procesos y seleccione Crear nuevo proceso. Se abrir la ventana TurboIntegrator. 3. Seleccione la opcin IBM Cognos Package en el cuadro de dilogo Data Source Type. 4. Se selecciona Paquete por defecto. Consulte Conexin a paquetes publicados. En su lugar, puede seleccionar Dimension si solo desea importar jerarquas desde una nica dimensin de un paquete. 5. Introduzca los detalles de conexin: Si su servidor IBM Cognos BI permite la conexin annima, podr hacer clic en "Log on". De lo contrario, introduzca sus credenciales de conexin aqu: Licensed Materials Property of IBM Copyright IBM Corp. 2007, 2010.
73
Captulo 7: Importacin de datos a travs de IBM Cognos TM1 Package Connector Espacio de nombres de autenticacin La lista desplegable muestra todos los espacios de nombres de autenticacin disponibles. ID de usuario y Contrasea Introduzca un ID de usuario y una contrasea para un usuario en el espacio de nombres de autenticacin seleccionado. Conexiones Le permite gestionar la informacin de conexin relacionada con el proceso de TI. El botn se activar cuando haya iniciado sesin correctamente en el servidor BI. La primera vez que autentique el servidor BI se crear automticamente una conexin denominada "BI Server Logon". Si actualiza las credenciales en la ficha Connection despus de conectarse por primera vez, dichos cambios no actualizarn esta conexin. Debe utilizar el cuadro de dilogo Manage Signons para modificar la conexin. Podr Add, Modify y Remove signons. Si elimina una conexin es posible que TI sea incapaz de ejecutar un proceso cuando se desactive la conexin annima. A medida que trabaje con dimensiones y medidas, podrn crearse conexiones de fuentes de datos. Tambin podrn gestionarse a travs de la ventana Signons. Conexin/Desconexin Haga clic en Log on para conectarse al servidor BI. Una vez conectado, podr utilizar la opcin Log off para desconectarse del servidor BI.
Conexin a paquetes publicados

Una vez conectado al servidor BI, seleccione el paquete con el que desee trabajar. Si no est importando medidas, despus de seleccionar un paquete, contine con la ficha Dimension.
Pasos
1. Localice el paquete. Haga clic en el botn Browse para seleccionar un paquete disponible. Solo podr seleccionar paquetes que contengan dimensiones. Al seleccionar un paquete en la ventana Browse Metadata, el campo Select Package se rellenar automticamente. El botn Editar se habilita tras seleccionar un paquete. 2. Seleccione el TM1 cube to load to. Si est creando un cubo, introduzca el nombre del cubo. Si est volviendo a crear o actualizando un cubo existente, seleccinelo de la lista. 3. Especifique las acciones de importacin que desea llevar a cabo. Complete la Accin de cubo y las Acciones de datos segn requiera esta importacin, tal y como lo hara con cualquier otro tipo de fuente de datos. Consulte Asignacin de variables para obtener ms informacin sobre estas opciones.
74 IBM Cognos TM1
Captulo 7: Importacin de datos a travs de IBM Cognos TM1 Package Connector Para los paquetes basados en BW SAP, es posible que deba seleccionar Accumulate Values si est utilizando una solicitud de segmentador para acelerar la extraccin de datos. Compruebe sus resultados. 4. Para definir las dimensiones del paquete, haga clic en la ficha Dimension. 5. Defina la estructura de Jerarqua y Atributo con los cuadros de dilogo que se muestran al hacer clic en Select Hierarchies o Select Attributes. Tenga en cuenta la siguiente informacin sobre Jerarquas y Atributos: Jerarqua por defecto Si especifica la Dimensin TM1 sin preseleccionar ninguna jerarqua, TM1 seleccionar automticamente la primera como la Jerarqua por defecto. Puede cambiar la seleccin mediante la desactivacin o activacin de las casillas de verificacin. Seleccin previa a la asignacin Tambin puede seleccionar jerarquas y todos los subelementos como filtros antes de realizar la asignacin a una dimensin TM1. Si rellena la dimensin TM1 en la dimensin de jerarquas preseleccionadas, se aplicarn todas las selecciones de forma automtica. Si anula la seleccin de cualquier dimensin asignada al borrar el nombre de la dimensin TM1 en el campo, se borrarn automticamente todas las jerarquas preseleccionadas bajo las dimensiones correspondientes. Nombre frente a referencia La jerarqua muestra el Nombre de jerarqua y la Referencia de jerarqua para identificar la jerarqua especificada con total claridad. Se puede repetir el nombre de jerarqua, pero la referencia de jerarqua es nica. Filtros Si se define un filtro en el paquete y se selecciona una jerarqua, el botn Select Filters se pondr a su disposicin para que pueda seleccionar los filtros que desee aplicar. Asegrese de que el filtro coincide con la jerarqua seleccionada o es posible que se produzca un error en su consulta. Mltiples niveles en una jerarqua IBM Cognos permite a los usuarios definir varios niveles de una jerarqua. Cuando una jerarqua define varios niveles, los nombres de atributos pueden repetirse en diferentes niveles.
En el ejemplo anterior, la dimensin City contiene City, Geography, Geography_link, etc. Cada jerarqua define varios niveles.
En el ejemplo anterior, las opciones Etiqueta de nivel, Nmero de nivel, Nombre nico de jerarqua, etc. son las mismas en los distintos niveles de jerarquas diferentes. TM1 realiza la consolidacin de los atributos en base a dos factores: el nombre externo del atributo y los roles del atributo. El orden de precedencia es el nombre externo del atributo y, a continuacin, los roles del atributo. Si cualquier atributo contiene los mismos valores de Nombre externo del atributo, se consolidar tal atributo. Si un atributo no contiene el nombre externo, la firma de sus roles (donde todos los roles acompaan a una firma de rol) se evaluar como el factor de consolidacin. Al especificar la asignacin de atributos TM1, durante la importacin se seleccionan todos los atributos cuyo nombre externo o firma de rol coincida con los atributos TM1 asignados. Es posible que se asigne ms de un atributo. 6. Seleccionar atributos 76 IBM Cognos TM1
Captulo 7: Importacin de datos a travs de IBM Cognos TM1 Package Connector Asigne un atributo de dimensin a un atributo TM1 de una de las siguientes formas: Para asignar un atributo a un nuevo atributo TM1, introduzca un nombre para el nuevo atributo TM1 en el campo Atributo TM1 correspondiente y, a continuacin, seleccione un Tipo de atributo. El nuevo atributo TM1 se crear cuando ejecute el proceso TurboIntegrator. Para asignar un atributo a un atributo TM1 existente, haga clic en el campo Atributo TM1 correspondiente, seleccione un atributo y, a continuacin, seleccione un Tipo de atributo.

Ahora debe asignar las medidas a una dimensin TM1. Las medidas aparecen en la ltima fila de la ficha Dimensions. Las medidas deben seleccionarse haciendo clic en Select Measures. TurboIntegrator no selecciona previamente las medidas, ya que no existen medidas predeterminadas. 7. Haga clic en Select Measures. Se abre el cuadro de dilogo Select Measures. Nota: un paquete puede tener varias dimensiones de medidas. El nombre de la medida incluye el nombre de la dimensin de medidas del paquete. 8. Seleccione cada medida que desee importar a TM1. 9. Haga clic en Filters para seleccionar los filtros que desee aplicar a la consulta de medida. Asegrese de que el filtro coincide con la jerarqua seleccionada o es posible que se produzca un error en su consulta. 10. Haga clic en Aceptar. 11. Asigne las medidas a una dimensin TM1. Si las medidas se asignan a una dimensin TM1 existente, haga clic en la columna TM1 Dimension y seleccione la dimensin que corresponda a la medida. Si desea crear una nueva dimensin TM1 a partir de la medida, introduzca un nombre para la dimensin en la columna TM1 Dimension.
Captulo 7: Importacin de datos a travs de IBM Cognos TM1 Package Connector 12. Seleccione una Accin de dimensin TM1 para las medidas. 13. Parmetros de dimensiones Utilice la ficha Dimension settings para definir la Top Consolidation de las dimensiones especificadas. 14. Edicin de solicitudes Puede hacer clic en el botn Prompts para abrir una ventana de Cognos de edicin de solicitudes para establecer y cambiar los valores de las solicitudes. Las variables de BW SAP aparecen como solicitudes en los paquetes de IBM Cognos. Si existen solicitudes obligatorias en el paquete, los valores de las solicitudes debern proporcionarse antes de que TI ejecute la consulta. De lo contrario, el proceso no se realizar correctamente. Puede pulsar el botn Solicitudes si desea utilizar la interfaz de usuario para ajustar valores o rangos. Haga clic en la celda de la columna Value para establecer el valor de la solicitud.
O bien, puede utilizar las siguientes API de TI. Si sabe los nombres de solicitud, puede utilizar directamente CGAddPromptValues facilitando el nombre de solicitud y los valores. Estas funciones deben introducirse en el Prolog del Parent TI. Estas funciones le permiten recuperar las solicitudes definidas en el TI. Para definirlas en el proceso de TI subyacente, deber iniciar la pantalla de solicitudes en su TI. Haga clic en Prompts, seleccione las solicitudes de todas las consultas definidas y haga clic en OK para que estn disponibles.
API de TI
CGPromptSize() CGPromptGetNextMember(int index)
Descripcin
devuelve el nmero total de solicitudes que deben establecerse devuelve la solicitud ordenada por ndice (0-(CGPromptSize ()-1))
78 IBM Cognos TM1
API de TI
Descripcin
CGAddPromptValues(promptName, value 1, value establece los valores de solicitud ordenados por nombre de 2...) solicitud Ejemplo
count=CGPromptSize(); while(i<count); prmptname=CGPromptGetNextMember(i); CGAddPrompt Values(prmptname, 1999-01-01,2009-01-01); i=i+1; end;
15. Cuando haya medidas, jerarquas y dimensiones asignadas, puede probar la consulta haciendo clic en Test Queries. Test Queries inicia la ejecucin de una consulta antes de que TI se ejecute. Puede utilizarse para probar previamente si las consultas se ejecutan correctamente y para proporcionar valores de consulta que falten o informacin de la conexin. 16. Haga clic en la casilla de verificacin Show Namespace para incluir el espacio de nombres en la lista Dimension. 17. Complete las fichas Avanzado y Programacin si fuera necesario. Consulte Edicin de tareas y procedimientos avanzados para obtener ms informacin. Package Connector tambin genera el proceso TI de cada dimensin. Ello le proporciona flexibilidad para aadir sus propias instrucciones de scripts de TI en caso necesario. 18. Guarde y ejecute el proceso TI. Consulte Guardar y ejecutar el proceso TurboIntegrator.
Importacin de una nica dimensin

Puede utilizar la opcin del men desplegable Dimension de la ficha Data Source para definir rpidamente una nica dimensin. Seleccione Dimension en el men desplegable del paquete de IBM Cognos para abrir directamente la ficha Dimension y especifique las acciones que desee realizar y definir en las jerarquas.
Pasos
1. Localice el paquete. Haga clic en el botn Browse para seleccionar un paquete disponible. 2. Identifique la Dimensin para cargar desde:. El men desplegable muestra una lista con las dimensiones disponibles en el paquete seleccionado. 3. Identifique la Dimensin TM1 para cargar en:. El men desplegable muestra una lista con las dimensiones disponibles si est actualizando una dimensin existente. 4. Seleccione una Accin de dimensin TM1 tal y como lo hara con cualquier otra fuente de datos. Consulte Asignacin de dimensiones para obtener ms informacin.
Captulo 7: Importacin de datos a travs de IBM Cognos TM1 Package Connector 5. Identifique la Consolidacin superior: Si desea crear una consolidacin de nivel superior para la dimensin TM1, introduzca aqu el nombre de la consolidacin de nivel superior. La dimensin TM1 resultante incluir una consolidacin con el nombre que haya introducido. Por ejemplo, si introduce Total en Top Consolidation, la dimensin incluye una consolidacin de nivel superior llamada Total con todos los elementos importados como hijos de la consolidacin. 6. Consulte Especificacin de una solicitud de segmentacin para una consulta BW SAP para obtener ms informacin sobre cmo especificar solicitudes. 7. Cuando haya medidas, jerarquas y dimensiones asignadas, puede probar la consulta haciendo clic en Test Queries. Test Queries inicia la ejecucin de una consulta antes de que TI se ejecute. Puede utilizarse para probar previamente si las consultas se ejecutan correctamente y para proporcionar valores de consulta que falten o informacin de la conexin.
Guardar y ejecutar el proceso TurboIntegrator

Pasos
1. Haga clic en el botn Ejecutar. TM1 le pide que asigne un nombre al proceso y que lo guarde. 2. Guarde el proceso. A continuacin, debera ver la confirmacin de que el proceso se ha ejecutado correctamente. 3. Abra Server Explorer. Debera comprobar si se ha creado y llenado el cubo que especific y si se han creado todas las dimensiones necesarias.
Ver los resultados

Cuando define un proceso para importar un paquete a TM1 y crear un nuevo cubo TM1, se producen las siguientes acciones: Para cada dimensin que elige incluir en su cubo, TM1 genera un proceso para importar la dimensin y crear una dimensin TM1 correspondiente. TM1 genera un proceso maestro que ejecuta los procesos de creacin de dimensiones descritos anteriormente, construye el cubo TM1 e importa valores de datos. La imagen siguiente muestra los procesos que se crean cuando crea un proceso llamado SAP import para importar un InfoCube a TM1.
80 IBM Cognos TM1
Proceso maestro
Procesos para crear dimensiones TM1 a partir de caractersticas presentes en el InfoCube
El elemento de consulta definido como clave del nivel de la jerarqua se utiliza como nombre de elemento TM1.
Directrices para trabajar con datos BW SAP

Se deben tener en cuenta varios aspectos concretos al utilizar paquetes basados en SAP creados con Framework Manager. Para obtener ms informacin sobre cmo crear consultas SAP, cmo crear paquetes basados en SAP con Framework Manager y cmo utilizar los mismos en TM1, consulte Cmo trabajar con datos BW SAP utilizando un paquete de Framework Manager. Para obtener informacin general sobre cmo crear paquetes con Framework Manager, consulte "Crear o modificar un paquete" en la User Guide de Framework Manager.
Cmo trabajar con datos BW SAP utilizando un paquete de Framework Manager

Puede sacar partido a los datos BW SAP en IBM Cognos TM1 Package Connector utilizando un paquete basado en SAP creado con Framework Manager y publicado en Content Manager. Este es el mtodo recomendado para sacar partido a los datos BW SAP. Se deben tener en cuenta varios aspectos concretos al utilizar paquetes basados en SAP creados con Framework Manager. Puede utilizar TM1 Package Connector para importar los datos dimensionales y los datos de hecho desde una fuente de consultas BW SAP. Las siguientes instrucciones le indican cmo volver a crear un cubo BW SAP como cubo IBM Cognos TM1. Para realizarlo, el paquete de consultas BW SAP debe tener un formato especfico. Deben seguirse tres pasos para importar una consulta BW SAP y acceder a las dimensiones y hechos con IBM Cognos: Creacin de una consulta BW con SAP Business Explorer Query Designer Crear un paquete con Framework Manager. Crear un proceso de TI que utilice TM1 Package Connector.
Limitaciones
Este proceso de extraccin est limitado nicamente a fuentes de datos BW SAP.
Captulo 7: Importacin de datos a travs de IBM Cognos TM1 Package Connector La fuente de datos debe ser una consulta creada especficamente y definida en la fuente de datos BW SAP.
Para obtener informacin general sobre cmo crear paquetes, consulte "Crear o modificar un paquete" en la User Guide de Framework Manager.
Creacin de una consulta BW con SAP Business Explorer Query Designer

Debe crear una consulta que incluya el cubo que desee importar. Le recomendamos que base la consulta en un nico InfoCube de la base de datos. Es posible que una consulta basada en varias fuentes genere errores BW SAP durante la recuperacin de datos. Los pasos que utilice pueden variar en funcin de la versin de Query Designer que utilice.
Pasos
1. En Query Designer, haga clic en Nueva consulta. 2. En el cuadro de dilogo Nueva consulta, seleccione el proveedor de informacin que contenga el cubo que desee importar. 3. Haga clic en el icono Herramientas para consultar el nombre tcnico del InfoObject.
4. Arrastre una caracterstica que desee importar del catlogo de InfoObject que est situado en la columna izquierda hasta uno de los campos que aparecen en la parte derecha de la pgina. Por ejemplo, Columnas o Filas.
Las caractersticas que seleccione definirn los metadatos del cubo. Las caractersticas deben ajustarse a las siguientes restricciones: Debe tener al menos una nica variable opcional para segmentar solicitudes de extraccin de datos. Ello puede producir un rendimiento muy superior al de las solicitudes habituales. Seleccione una caracterstica que represente la fuente de datos. Las caractersticas pueden ser cifras clave, que se convertirn en medidas del cubo TM1; o dimensiones, que se convertirn en las dimensiones del cubo TM1.
82 IBM Cognos TM1
Captulo 7: Importacin de datos a travs de IBM Cognos TM1 Package Connector No asigne a ninguna de las caractersticas una jerarqua mostrada, ni explcitamente ni a travs de una variable. Todas las cifras clave de la consulta BW SAP deben ser numricas. No seleccione la caractersticas Divisa/Unidad. Asegrese de que todas las cifras clave seleccionadas utilicen la misma divisa. nicamente incluya caractersticas en la consulta BW SAP que desee extraer con TM1 Package Connector. Si incluye caractersticas innecesarias, aumentar el volumen de datos, por lo que el rendimiento se ver afectado de forma negativa. Se deben copiar las caractersticas en los campos Columnas o Filas de la definicin de consulta. Si se copian en los campos Free Characteristics o Filter, las caractersticas se muestran como dimensiones al importarse desde el paquete, pero el proceso de extraccin de secuencias utilizado al segmentar la extraccin de datos no puede obtener los valores. Si ha definido filtros, estos deben hacer referencia nicamente a las dimensiones incluidas en otra parte de la definicin de consulta. Si incluye una caracterstica libre, no aparecer ningn valor para dicha caracterstica en la extraccin de cifras clave. Un filtro aplicado a una caracterstica libre acta como filtro en los datos BW SAP devueltos. Puede utilizarlo como filtro para definir un subconjunto de un InfoCube. Utilice una solicitud de lista de seleccin, en lugar de una solicitud de escritura para la consulta. Una solicitud de lista de seleccin ofrece valores para segmentar los datos.
5. Si desea definir los metadatos que rellenarn el cubo, deber modificar las propiedades de cada caracterstica que haya seleccionada para su inclusin. Haga clic con el botn secundario del ratn en una caracterstica y seleccione Propiedades. 6. En el cuadro de dilogo Propiedades de la caracterstica, modifique el valor Mostrar como a Clave y el valor Suprimir filas de resultados a Siempre. Tenga en cuenta que cualquier restriccin o filtro que se aplique aqu se mantendr de ahora en adelante.
7. Repita los pasos 5 y 6 para cada caracterstica que seleccion en el paso 4. Nota: nicamente debe seleccionar las caractersticas que necesite. Para evitar el consumo excesivo de memoria, la disminucin del rendimiento del sistema o que se produzca un error, piense con detenimiento qu caractersticas desea incluir en la consulta. Le recomendamos que consulte a un administrador BW SAP para asegurarse de que no se superen los volmenes de datos. 8. Haga clic en el icono Propiedades de las consultas y en la ficha Ampliadas active la casilla
de verificacin Permitir acceso externo a esta consulta. As se expone la consulta a Framework Manager. 9. Haga clic en Guardar y proporcione una Descripcin y un Nombre tcnico para la nueva consulta. Le recomendamos que utilice la convencin de nomenclatura BW SAP en el campo Nombre tcnico. Es decir, comience la entrada con la letra 'Z' seguida de un nombre intuitivo o la convencin de nomenclatura estndar. Es muy importante anotar este nombre tcnico, puesto que lo necesitar para encontrar la consulta en Framework Manager. Ahora est listo para Crear una variable. Para obtener ms informacin sobre el uso de SAP Query Designer, consulte la documentacin de BW SAP.
Crear una variable

Ahora puede crear un parmetro de solicitud opcional para la consulta, de forma que TM1 Package Connector pueda emitir consultas de menor tamao a SAP y, por lo tanto, recuperar el conjunto de datos completo. Esta tcnica debe utilizarse donde el volumen de datos producira errores en el servidor BW SAP.
Directrices para extraer datos de hecho BW SAP en TM1 Package Connector

No existen reglas establecidas para utilizar las variables al extraer datos BW SAP a fin de utilizarse en TM1 Package Connector. Sin embargo, debe tener cuidado de no solicitar demasiados datos, ya que podra disminuir el rendimiento o producirse un error con mensajes de memoria insuficiente en su entorno SAP. 84 IBM Cognos TM1
Captulo 7: Importacin de datos a travs de IBM Cognos TM1 Package Connector Una directriz bsica a seguir es que cuando se utiliza una variable para segmentar la extraccin de datos, TM1 Package Connector obtendr en primer lugar todos los miembros que existan para la dimensin en relacin a la cual se define la variable. A continuacin, TM1 Package Connector obtendr datos de forma individual para extraer los datos de hecho de cada miembro individual de la dimensin, a fin de satisfacer la variable. Esto permite a TM1 Package Connector descomponer la extraccin de datos en grupos que puede gestionar el servidor BW SAP. No existen estndares establecidos con respecto a qu dimensiones se deben aplicar. Para alcanzar un rendimiento ptimo, debe comprender los datos BW SAP y determinar qu dimensin descompone los datos de hecho equitativamente. Debe seleccionar con detenimiento qu dimensiones se definirn en la variable. Para obtener un rendimiento ptimo, es posible que se necesite algo de experiencia. Por ejemplo, es posible que tenga una dimensin [COUNTRY] que contenga tres pases como elementos, United States (US), Canada (CA) y Mexico (MX). Si la mayor parte del negocio se lleva cabo en United States (90%) y el resto (10%) se registra en Canada y Mexico a partes iguales, esta dimensin no descompondra los datos equitativamente. Las consultas que aparecen como resultado tendran una peticin de gran tamao (US) y dos ms pequeas (CA y MX). Por lo tanto, esta dimensin no sera una buena candidata. No desea aplicar una variable a una dimensin que podra generar demasiadas peticiones pequeas. Por ejemplo, [0MATERIAL], una dimensin que se utiliza a menudo en entornos BW SAP, probablemente no sera una buena candidata porque generara demasiadas peticiones pequeas. Es posible que se haya definido una dimensin para [COSTCENTER] que divida equitativamente los datos en 10 centros de costes distintos que pueden utilizarse para segmentar los datos en partes iguales. Otra buena alternativa podra ser el ao de calendario o el mes de calendario, ya que puede dividir los datos en secciones que funcionen adecuadamente. No es necesario aplicar ninguna variable a consultas para la extraccin de datos. Algunas extracciones se llevarn a cabo sin ningn problema cuando no se apliquen variables. No se puede aplicar ninguna frmula, puesto que no existen dos entornos parecidos. Sin embargo, se recomienda utilizar un mtodo prudente para evitar perturbar el entorno BW SAP.
Pasos
1. En Query Designer, haga clic con el botn secundario del ratn en una caracterstica que haya seleccionado en el proceso anterior y seleccione Restringir. Para asegurarse de que los datos se distribuyen uniformemente, seleccione una caracterstica que represente al cubo y no genere un gran nmero de valores. Desea obtener una variable en la que el nmero de filas de cada valor de la variable sea similar; no desea una obtener una variable demasiado especfica (por ejemplo, no demasiadas filas por valor que generen un nmero excesivo de consultas), ni desea una variable demasiado general (por ejemplo, ms de un milln de filas por valor). 2. En el cuadro de dilogo Seleccin de, haga clic en la ficha Variables, haga clic con el botn secundario del ratn en cualquier parte de la ventana Descripcin y seleccione Nueva variable. Nota: si una de las caractersticas que ha seleccionado ya contiene una variable, puede evitar la creacin de una nueva variable y continuar con el paso 7 de este procedimiento.
Captulo 7: Importacin de datos a travs de IBM Cognos TM1 Package Connector 3. En la pgina Informacin general del Asistente de nueva variable, introduzca un Nombre de variable y una Descripcin y seleccione una dimensin como caracterstica. Haga clic en Siguiente. 4. En la pgina Detalles, seleccione nico valor, Mltiples valores nicos o Intervalo en el campo La variable representa, Opcional en el campo La entrada de variable es y active la casilla de verificacin Listo para entrada. Haga clic en Siguiente.
5. En la pgina Valores por defecto, asegrese de que el campo Valor por defecto est vaco. 6. Haga clic en Siguiente hasta que vuelva al cuadro de dilogo Seleccin de . La nueva variable aparece en la ventana Descripcin. 7. Seleccione la variable y haga clic en la flecha hacia la derecha para mover la variable
seleccionada sobre la ventana Seleccin y guardar la consulta. Ya puede importar la consulta en Framework Manager.
Crear un paquete con Framework Manager

Para crear un paquete con Framework Manager deber Importar los metadatos BW SAP utilizando el Asistente de metadatos que se describe aqu. Framework Manager importa la consulta BW SAP a un modelo, y define un paquete que exporta a Content Manager. Al importar, tenga en cuenta lo siguiente: Las dimensiones seleccionadas en la consulta BW SAP estn disponibles en Dimension Folders del cuadro de dilogo Import. Cada dimensin contendr al menos una jerarqua. Seleccione siempre la jerarqua principal cuyo nombre coincida con la jerarqua.
86 IBM Cognos TM1
Captulo 7: Importacin de datos a travs de IBM Cognos TM1 Package Connector Si estn disponibles otras jerarquas, seleccione una que proporcione el conjunto de niveles que desee de la jerarqua. Framework Manager importa las dimensiones de tiempo al modelo desde la fuente de datos BW SAP nicamente si se activa un parmetro de configuracin. Consulte Importacin de metadatos desde BW SAP para obtener ms detalles. Si establece la configuracin como una dimensin de tiempo, estar realizando una entrada global; las dimensiones importadas se tratarn como cadenas de tiempo.
Cree un paquete. Al crear el paquete para publicarlo en Content Manager, oculte la jerarqua principal en las dimensiones a las que import dos jerarquas. La jerarqua principal es necesaria, y debe estar en el paquete para que el proceso de consulta funcione correctamente. Puede ocultar la jerarqua si no desea que est visible.
Importacin de metadatos desde BW SAP

Si una dimensin es una dimensin de tiempo o no, se determina al importar los metadatos del cubo BW SAP a una definicin de modelo de FrameWork Manager. Para que esto se realice correctamente, deber establecer unos parmetros de configuracin. Por defecto, el valor no est establecido. En el directorio configuration, ubicado donde se instal Framework Manager, se incluye un archivo de configuracin para controlar el acceso a BW SAP. Se denomina sapbw_config.xml. El instalador no instala este archivo directamente. En su lugar, instala un archivo denominado sapbw_config.xml-sample. Si sapbw_config.xml no existe, crelo copiando sapbw_config. xml-sample o cambiando el nombre a sapbw_config.xml-sample. En sapbw_config.xml, encontrar las siguientes lneas:
<provider name="SAPBWODP">  <parameter name="UseStgDTypes" value="true"/> <!-Controls the use of a faster version of GetMembers. Default is "true".--> <parameter name="UseFastGetMembers" value="true"/> </provider>
Asegrese de que UseStgDTypes tiene el valor = verdadero. Por defecto, el valor es falso. Esto debe realizarse antes de iniciar FrameWork Manager y antes de importar los metadatos de BW SAP para crear el modelo. Lo que hace este cambio es permitir la importacin de los metadatos con el fin de reconocer que una Dimensin del cubo BW SAP es una dimensin de tiempo. Se trata de una Dimensin en la que los elementos de los niveles inferiores de la Dimensin tienen valores clave que son fechas.
Pasos para importar utilizando el asistente de metadatos

1. En Framework Manager, haga clic en Create a new project. 2. Rellene los campos del cuadro de dilogo New Project. Haga clic en Aceptar. 3. Realice los pasos del Metadata Wizard. Cuando se le solicite que seleccione una fuente de datos, si debe crear una nueva fuente de datos, haga clic en New
Captulo 7: Importacin de datos a travs de IBM Cognos TM1 Package Connector 4. En la pgina Select Objects, localice la consulta que defini en BW SAP Query Designer en la fase anterior. Desplace la lista para obtener el nombre tcnico que proporcion cuando cre la variable. La estructura de la carpeta es la siguiente: Jerarquas > Definiciones de niveles > Definiciones de elementos de consulta. 5. Seleccione los elementos de consulta principales relacionados con el nivel. Es decir, los que incluyan (Key), (Name), etc. 6. Siga las pantallas restantes del Metadata Wizard, acepte los valores por defecto y haga clic en Next. Se crearn las dimensiones y se importarn los metadatos. 7. En la pantalla final del asistente, compruebe los resultados y haga clic en Finish.
Pasos para crear un paquete

1. Haga clic en la carpeta Packages, y en el men Actions, haga clic en Create, Package. 2. En la pgina Provide Name, introduzca el nombre del paquete y, si lo desea, una descripcin y un consejo para la pantalla. Haga clic en Siguiente. 3. Seleccione la consulta que import en la seccin anterior. 4. En la pgina Define objects, al ocultar o al excluir objetos hijo del paquete, deber seleccionarlos uno por uno. Si se excluyen los objetos padre tambin se excluirn sus hijos. Tenga en cuenta que si excluye (o no selecciona) muchos objetos de los cubos ms grandes, deber contar con mucho tiempo. Nota: Framework Manager admite la funcin ctrl+maysculas y alt+maysculas. Utilice estas pulsaciones de tecla para seleccionar varios objetos que desee incluir u ocultar en el cubo. Por ejemplo, si desea incluir solo dos elementos en una rama grande, seleccione toda la rama, utilice ctrl+maysculas para eliminar la seleccin de los elementos que desee incluir y oculte el resto de los elementos seleccionados. Para obtener ms informacin sobre cmo incluir, excluir y ocultar objetos, consulte "Crear o modificar un paquete" en la Gua de usuario de Framework Manager. 5. Seleccione si desea utilizar los permisos de acceso por defecto del paquete: Para aceptar los permisos de acceso por defecto, haga clic en Finish. Para establecer los permisos de acceso, haga clic en Next.
6. Si se le solicita que abra el Publish Package Wizard, haga clic en Yes. 7. Seleccione los valores predeterminados y haga clic en Publish. Se publicar el paquete en el almacn de contenido y podr acceder al paquete en TM1. 8. En la pantalla final, compruebe los resultados y haga clic en Finish. Ahora ya puede crear un modelo en TM1. Para obtener ms informacin sobre cmo crear un paquete, consulte "Crear o modificar un paquete" en la Gua de usuario de Framework Manager.
88 IBM Cognos TM1
Especificacin de una solicitud de segmentacin para una consulta BW SAP

Las solicitudes de segmentacin se utilizan para consultar los datos de hecho de la fuente de datos BW SAP. Tambin conocida como variable BEx, las solicitudes de segmentacin garantizan que la consulta recuperar una muestra representativa de los datos de hecho. Una solicitud de segmentacin puede tener un solo valor, varios valores o un rango. Si especifica un rango, debe ser inclusivo, incluyendo un valor para el principio y para el final del rango. Una solicitud de segmentacin debe ser opcional y no tener valores predeterminados especificados. Se permiten varias solicitudes, o variables BEx. Si tiene varias solicitudes, solo podr seleccionar una como solicitud de segmentacin. La solicitud de segmentacin no debera tener valores especificados en ninguna consulta. Las solicitudes obligatorias que no estn especificadas en la solicitud de segmentacin deben tener un valor especificado. Las solicitudes opcionales que no estn especificadas como solicitud de segmentacin pueden o no tener un valor, segn sea necesario.
Pasos
1. Despus de seleccionar las jerarquas y las medidas, haga clic en Prompts. 2. En la lista Prompt for segmenting data, seleccione la solicitud para segmentar los datos de hecho. Solo se enumeran solicitudes vlidas. 3. Asegrese de que la solicitud de segmentacin no tiene valores por defecto especificados. Consejo: para borrar los valores de una solicitud, haga clic en la solicitud en la lista Current prompt values y haga clic en Clear Value. 4. Asegrese de que las solicitudes obligatorias que aparecen en la lista Current prompt values tienen un valor especificado. 5. Haga clic en Aceptar.
Realizacin de consultas paralelas con una solicitud de segmentador

Si ha definido una solicitud para segmentar la extraccin de hechos BW SAP, puede establecer una preferencia para que TM1 Package Connector mejore su rendimiento.
Pasos
1. Localice la carpeta de instalacin de TM1 Package Connector, desplcese hasta la carpeta Configuracin y abra el archivo cogtr.xml en un editor de textos (preferiblemente en un editor XML). 2. Aada la siguiente entrada a la seccin "Transformer" del archivo:
<Preference Name="SegmenterParallelQueryCount" Value="16"/>
3. Establezca el valor en el nmero de consultas paralelas que desee que emita TM1 Package Connector. Por defecto las emite de una en una. 4. Guarde el archivo.
Captulo 7: Importacin de datos a travs de IBM Cognos TM1 Package Connector TM1 Package Connector ejecutar ahora consultas de medidas en paralelo segn el valor que especifique. Por ejemplo, puede definir una variable opcional de InfoQuery al mes y existen 48 meses en la caracterstica. Puede especificar esta variable como solicitud de segmentador para la dimensin de medidas. TM1 Package Connector ejecutar hasta 16 consultas en paralelo (una al mes), que podran aumentar enormemente el porcentaje de extraccin de datos de hecho. Pngase en contacto con su administrador SAP para asegurarse de que las consultas de extraccin de datos no afectan negativamente al entorno BW SAP de otros usuarios.
90 IBM Cognos TM1
Captulo 8: Edicin de tareas y procedimientos avanzados

Esta seccin describe la gestin de los procesos IBM Cognos TM1 TurboIntegrator que incluyen tareas, la planificacin de procesos para que se ejecuten automticamente.
Utilizacin del modo de carga de gran volumen

El modo de carga de gran volumen permite que TM1 se ejecute en un modo especial y optimizado de un solo usuario o de un solo proceso/tarea. Este modo puede aumentar el rendimiento de tareas dedicadas cuando se espera poca o ninguna actividad. Algunos ejemplos de la utilizacin del modo de carga de gran volumen son: Un administrador TM1 que necesite realizar operaciones de mantenimiento de forma manual. Una ventana nocturna para cargar grandes cantidades de datos.
Por lo general, TM1 se ejecuta en un modo de multiusuario en el que se pueden ejecutar varios usuarios, tareas y procesos de forma simultnea al acceder a los datos TM1. En el modo de carga de gran volumen, el servidor TM1 evita la actividad simultnea mediante la suspensin temporal de otros usuarios, tareas y procesos, y elimina la carga de trabajo que exige un entorno multiusuario. El modo de carga de gran volumen realmente no desconecta usuarios, sino que simplemente suspende su interaccin con TM1. Una vez que finalice el modo de carga de gran volumen, se vuelve a activar cualquier usuario que se haya conectado previamente y se reanuda la interaccin del usuario con TM1. Puede habilitar el modo de carga de gran volumen directamente en un proceso TI o con el API de TM1. En cualquier caso, utilice comandos para entrar y salir del modo de carga de gran volumen.
Aspectos que debe tener en cuanta al utilizar el modo de carga de gran volumen
Debe tener en cuenta los siguientes aspectos al utilizar el modo de carga de gran volumen: El modo de carga de gran volumen no muestra un mensaje de aviso a los usuarios finales. Tendr que programar y coordinar el uso del modo de carga de gran volumen en consecuencia. Durante el modo de carga de gran volumen nicamente puede estar activo un usuario o proceso. No se pueden establecer conexiones nuevas al servidor mientras se encuentre en el modo de carga de gran volumen. Un proceso TI no puede utilizar ExecuteCommand para iniciar un programa de lnea de comandos que intente volver a conectarse al mismo servidor TM1. El intento de conexin no se realizar correctamente. Cualquier tarea programada para ejecutarse mientras est habilitado el modo de carga de gran volumen se desactivar y no se ejecutar. 91
Inicio del modo de carga de gran volumen

Cuando un servidor entra en el modo de carga de gran volumen, todos los procesos realizados por otros subprocesos se detienen. Se suspendern los subprocesos de usuario existentes y las tareas en ejecucin. nicamente se mantendr activo el subproceso que inici el modo de carga de gran volumen. Se desactivarn todas las tareas programadas, excepto la que inicia el modo de carga de gran volumen. Tambin se suspendern todas las conexiones TM1Top y todos los subprocesos especficos del sistema.
Finalizacin del modo de carga de gran volumen

Cuando se deshabilita el modo de carga de gran volumen, se reanudarn todos los subprocesos de usuario y del sistema y se habilitarn las conexiones de usuario. Las aplicaciones personalizadas que API de TM1 utiliza para habilitar el modo de carga de gran volumen deben tambin utilizar la funcin de API de TM1 API necesaria para salir del modo de carga de gran volumen. Sin embargo, si se interrumpe la conexin del cliente (se produce un fallo en la red o el cliente se desconecta o no responde), el servidor saldr automticamente del modo de carga de gran volumen. De forma similar, si se ejecuta un proceso/tarea TI en el modo de carga de gran volumen y se cierra el proceso, ya sea de forma correcta o con errores, el servidor saldr automticamente de dicho modo. Cuando el servidor vuelve al modo multiusuario normal, las tareas que se desactivaron, vuelven a activarse y regresan a su programacin normal. Si las tareas se programaron para ejecutarse, pero el modo de carga de gran volumen lo impidi, no se ejecutarn de forma inmediata, sino que se ejecutarn segn lo programado. Es posible que sea necesario ajustar el tiempo de inicio de las tareas programadas para evitar que se bloqueen mientras el modo de carga de gran volumen se encuentre activado.
Comandos del proceso TurboIntegrador para el modo de carga de gran volumen

Puede habilitar el modo de carga de gran volumen en las secciones Prlogo o Eplogo de un proceso TI. Para una mayor eficacia, le recomendamos que habilite el modo de carga de gran volumen en la primera instruccin, o en las primeras instrucciones, de la seccin Prlogo del proceso. Tras habilitar el modo de carga de gran volumen en un proceso, solo se podr deshabilitar en la ltima lnea de la seccin Eplogo. Si trata de deshabilitar el modo de 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 TI, continuar habilitado hasta que se desactive explcitamente o hasta que la tarea finalice. Esto significa que puede habilitar el modo en un proceso de una tarea y, a continuacin, ejecutar una serie de procesos TI antes de deshabilitarlo. Tambin puede entrar y salir del modo de carga de gran volumen repetidas veces, utilizndolo solo para determinados puntos importantes de una tarea. Utilice los siguientes comandos TI para habilitar y deshabilitar el modo de carga de gran volumen en un proceso TI.
EnableBulkLoadMode()
92 IBM Cognos TM1

DisableBulkLoadMode(): esta funcin solo se puede utilizar en la ltima lnea de la seccin Eplogo
del proceso TI al utilizar el modo de carga de gran volumen.
Funciones API C de TM1 para el modo de carga de gran volumen

Las siguientes funciones API C de TM1 estn disponibles para habilitar o deshabilitar el modo de carga de gran volumen.
TM1ServerEnableBulkLoadMode TM1ServerDisableBulkLoadMode
Para obtener ms informacin, consulte la Gua API de IBM Cognos TM1.
Edicin de procedimientos
Tras especificar la fuente de datos, identificar todas las variables y definir todas las instrucciones de asignacin, TurboIntegrator genera cuatro procedimientos basados en las opciones que seleccion en las pestaas de TurboIntegrator. Estos procedimientos se identifican como subpestaas de la pestaa Avanzado.
Los procedimientos son:
Pestaa
Prlogo Metadatos
Descripcin
Una serie de instrucciones para ejecutarlas antes de que se procese la fuente de datos. Una serie de instrucciones que actualizan o crean un cubo, dimensiones y otras estructuras de metadatos durante el procesamiento. Una serie de instrucciones que manipulan valores para cada registro de la fuente de datos. Una serie de instrucciones para ejecutar despus de que se procese la fuente de datos. Puede editar estos procedimientos para que incluyan funciones de TurboIntegrator y funciones de reglas de TM1 que amplen las capacidades de TurboIntegrator. Por ejemplo, puede editar el
Datos Eplogo
Captulo 8: Edicin de tareas y procedimientos avanzados procesamiento de Datos para que incluya las instrucciones que indican al proceso que se salte los registros que contengan valores cero, o escribir los registros importados en un archivo externo. Para obtener una lista completa de todas las funciones de reglas de TM1 y TurboIntegrator, consulte la Gua de referencia de IBM Cognos TM1. Cuando edita procedimientos, tenga en cuenta que cada procedimiento est pensado para ejecutar ciertos tipos de accin en momentos especficos de un proceso. De esta manera, debera crear acciones o instrucciones que sean apropiadas para un procedimiento concreto. Nota: cuando la fuente de datos para un proceso es NONE, se ignoran los procedimientos de Datos y Metadatos al ejecutar el proceso. No se ejecutar ninguna funcin o instruccin de las subpestaas Datos o Metadatos, aunque TM1 no enviar ningn error o advertencia de que parte del proceso no se ha ejecutado. Para editar un procedimiento:
Pasos
1. Haga clic en la pestaa Avanzado. 2. Haga clic en la subpestaa del procedimiento que desee editar. 3. Introduzca sus instrucciones en el cuadro de texto antes de esta lnea:
#****GENERATED STATEMENTS START****
o despus de sta:
#****GENERATED STATEMENTS FINISH****
Importante: las instrucciones creadas por el usuario pueden insertarse antes o despus de las instrucciones generadas, pero no se pueden insertar dentro de las instrucciones generadas por TurboIntegrator.
Ejecucin de un proceso a peticin

Para ejecutar un proceso a peticin, seleccione el proceso en Server Explorer y elija Proceso, Ejecutar proceso. Tambin puede ejecutar un proceso desde TurboIntegrator seleccionando Archivo, Ejecutar .
Programacin de un proceso para la ejecucin automtica con tareas

Puede ejecutar procesos a peticin y crear una tarea para ejecutar procesos en los intervalos definidos. Ambos mtodos de ejecucin no son exclusivos entre s. Puede ejecutar un proceso a peticin en cualquier momento, incluso si el proceso est programado para la ejecucin automtica como tarea. Una tarea es un objeto TM1 que ejecuta uno o ms procesos con la frecuencia definida por el usuario. Una tarea est compuesta de: Una lista de procesos para ejecutar. Una fecha y hora de inicio para la ejecucin inicial de la tarea.
94 IBM Cognos TM1
Captulo 8: Edicin de tareas y procedimientos avanzados La frecuencia a la que se ejecutar posteriormente la tarea.
Una vez definidas, las tareas se pueden activar y desactivar segn sea necesario. El acceso a las funciones de las tareas se controla mediante privilegios de seguridad de grupos de usuarios. Debe formar parte del grupo ADMIN o DataAdmin para crear tareas en un servidor TM1. Los usuarios deben tener privilegio de Lectura en una tarea para poder verla en Server Explorer y ejecutarla manualmente. Puede programar un proceso para la ejecucin automtica como tarea desde TurboIntegrator.
Pasos
1. Haga clic en la pestaa Programar de la ventana TurboIntegrator.
2. Seleccione la opcin Programar este proceso como una tarea llamada. 3. Introduzca un nombre para el proceso en el cuadro adyacente. Por defecto, TurboIntegrator asigna el nombre del proceso a la tarea. 4. Haga clic en una fecha del calendario para especificar una fecha de inicio para la ejecucin inicial de la tarea. 5. Introduzca una Hora para especificar la hora de inicio de la ejecucin inicial de la tarea. 6. Establezca los campos del cuadro Frecuencia de ejecucin de tareas para definir el intervalo al que se ejecutar la tarea. 7. Seleccione Archivo, Guardar para guardar el proceso con la informacin de programacin. Cuando programa un proceso desde TurboIntegrator, la tarea se activa automticamente y se ejecutar a la hora de inicio especificada. Tambin puede crear una tarea para un proceso (o conjunto de procesos) directamente desde Server Explorer.
Captulo 8: Edicin de tareas y procedimientos avanzados 8. En Server Explorer, seleccione el icono de Tareas, que hay junto al servidor en el que desea crear la tarea.
9. Seleccione Tareas, Crear nueva tarea. Se abre el Asistente para la configuracin de tareas. 10. En la lista Disponible, seleccione el proceso para el que desea crear una tarea. 11. Haga clic en 12. Haga clic en Siguiente. 13. Haga clic en una fecha del calendario para especificar una fecha de inicio para la ejecucin inicial de la tarea. 14. Introduzca una hora para especificar la hora de inicio de la ejecucin inicial de la tarea. 15. Establezca los campos del cuadro Frecuencia de ejecucin de tareas para definir el intervalo al que se ejecutar la tarea. 16. Rellene el cuadro Tarea programada activa. 17. Haga clic en Finalizar. Se abrir el cuadro de dilogo Guardar tarea como. 18. Introduzca un nombre para la tarea y haga clic en Guardar.
Nota importante sobre las horas de inicio de las tareas

La hora y fecha de inicio de la tarea se almacena en el formato de Hora del meridiano de Greenwich (GMT) y la ejecucin de la tarea est basada en GMT. TM1 no proporciona alojamiento automtico para el horario de verano. Si el reloj del sistema del servidor TM1 est configurado para utilizar el Horario de verano, debe modificar la fecha y hora de inicio de la tarea al principio y fin del horario de verano para mantener consistencia local en la programacin de la ejecucin de la tarea. El da en el que empieza el horario de ahorro de luz solar o de verano, modifique la tarea para que utilice la fecha actual y la hora de inicio deseada. El da en el que finaliza el horario de verano, modifique de nuevo la tarea para que utilice la fecha actual y la hora de inicio deseada.
96 IBM Cognos TM1
Edicin de una tarea

Para abrir una tarea para modificarla en el Asistente para la configuracin de tareas:
Pasos
1. Seleccione la tarea en el panel izquierdo de Server Explorer. 2. Seleccione Tarea, Editar tarea.
Activacin de una tarea

Para activar una tarea que est actualmente desactivada:
Pasos
1. Seleccione la tarea en el panel izquierdo de Server Explorer. 2. Active la opcin Tarea, Activar.
Desactivacin de una tarea

Para suspender la ejecucin peridica programada de una tarea:
Pasos
1. Seleccione la tarea en el panel izquierdo de Server Explorer. 2. Desactive la opcin Tarea, Activar.
Borrar una tarea

Para borrar una tarea:
Pasos
1. Seleccione la tarea en el panel izquierdo de Server Explorer. 2. Seleccione Tarea, Borrar. Nota: no puede borrar una tarea activa. Debe desactivar la tarea antes de poder borrarla correctamente.
Ejecucin de una tarea a peticin

Para ejecutar una tarea a peticin:
Pasos
1. Seleccione la tarea en el panel izquierdo de Server Explorer. 2. Seleccione Tarea, Ejecutar.
98 IBM Cognos TM1
Apndice A: TurboIntegrator Tutorial

Este tutorial le guiar a travs de las funciones avanzadas de IBM Cognos TM1 TurboIntegrator. Este tutorial est diseado para los usuarios responsables de implementar TM1 y de desarrollar estrategias de utilizacin dentro de su empresa. El usuario avanzado de TM1, o el desarrollador, suele ser el responsable de crear, mantener y desarrollar cubos y dimensiones TM1, as como de los procesos de importacin de datos. Antes de seguir trabajando con este tutorial, debera tener una buena comprensin de los conceptos de TM1 y conocer el funcionamiento de las funcionalidades de TM1. El tutorial le ensea cmo utilizar TurboIntegrator para crear dimensiones y cubos, importar archivos sin formato y fuentes de datos ODBC. Tambin le mostrar cmo ampliar la potencia de TurboIntegrator utilizando funciones de scripts avanzados. Este tutorial incluye adems consejos y sugerencias sobre cmo abordar un problema con TurboIntegrator TM1.
Configuracin del directorio de datos del tutorial

Este tutorial se basa en datos de muestra que se proporcionan junto con TM1. Antes de comenzar este tutorial, debe configurar su directorio de datos del servidor local para que haga referencia a los datos de muestra. Para configurar su directorio de datos:
Pasos
1. Haga clic ratn en TM1 en el panel izquierdo de Server Explorer y seleccione Archivo, Opciones. Se abrir el cuadro de dilogo Opciones. 2. Haga clic en el botn Examinar del Directorio de datos del servidor local para desplazarse hasta el directorio de datos de muestra de TurboIntegrator. El directorio de datos de muestra se llama TI_data y se encuentra en su directorio <dir_instal>\Custom\TM1Data\. Si instal TM1 en el directorio de instalacin predeterminado, la ruta completa hasta el directorio de datos de muestra ser C:\Archivos de programa\Cognos\TM1\ Custom\TM1Data\TI_Data. 3. Haga clic en Aceptar en el cuadro de dilogo Opciones para establecer el directorio de datos y reiniciar el servidor local.
Descripcin general de TurboIntegrator

TurboIntegrator TM1 le permite crear procesos que automatizan la importacin de datos, la gestin de metadatos y otras tareas. Un proceso es un objeto TM1 que consta de: Una descripcin de una fuente de datos 99
Apndice A: TurboIntegrator Tutorial Un conjunto de variables correspondientes a cada columna de la fuente de datos Un conjunto de asignaciones que define la relacin entre variables y estructuras de datos en la base de datos de TM1. Un procedimiento de prlogo, que consiste en una serie de acciones que se deben ejecutar antes de procesar la fuente de datos. Un procedimiento de metadatos, que consiste en una serie de acciones que actualizan o crean cubos, dimensiones y otras estructuras de metadatos. Un procedimiento de datos que consiste en una serie de acciones que se han de ejecutar en cada registro de la fuente de datos. Un procedimiento de eplogo que se ejecutar tras procesar la fuente de datos. Un conjunto de parmetros que se pueden utilizar para generalizar un proceso, de manera que se pueda utilizar en mltiples situaciones.
Puede utilizar TurboIntegrator para importar datos de fuentes ODBC, archivos ASCII, datos basados en SAP, fuentes multidimensionales OLAP, vistas de cubos TM1 y subconjuntos de dimensiones TM1. TurboIntegrator incluye un completo conjunto de funciones que puede utilizar para mejorar las capacidades del proceso. Puede utilizar estas funciones para crear scripts que exportan datos a archivos ASCII y fuentes ODBC, o que utilicen expresiones condicionales para controlar el procesamiento. Adems de estas funciones de TurboIntegrator, puede incorporar todas las funciones de reglas TM1 estndar en una definicin de proceso, excepto las funciones STET y UNDEFVALS. El acceso a TurboIntegrator se controla mediante grupos de usuarios. Debe ser miembro del grupo ADMIN para obtener acceso a todas las caractersticas de TurboIntegrator y definir procesos en un servidor TM1 en red. No existe ninguna interfaz que sirva de ayuda en la creacin de funciones de TurboIntegrator. Debe introducir funciones de forma manual directamente en la correspondiente subpestaa de la pestaa Avanzado. Los argumentos de cadena para funciones de TurboIntegrator deben aparecer entre comillas simples. Para indicar el fin de cada funcin, debe incluirse un punto y coma (;) en la ventana de TurboIntegrator.
Creacin de un proceso TurboIntegrator

La creacin de un proceso implica cinco pasos. Cada paso se completa estableciendo opciones o editando valores en una pestaa individual de la ventana TurboIntegrator. Los pasos necesarios para crear un proceso son:
Pasos
1. Definir una fuente datos 2. Establecer variables 3. Asignar datos
100 IBM Cognos TM1
Apndice A: TurboIntegrator Tutorial 4. Editar funciones de scripts avanzados 5. Programar los procesos finalizados Debe completar cada pestaa de la ventana TurboIntegrator en orden secuencial para crear un proceso. TurboIntegrator no le permite pasar a una nueva pestaa hasta que no proporcione toda la informacin necesaria en la pestaa actual.
Creacin de dimensiones utilizando TurboIntegrator

Puede utilizar TurboIntegrator TM1 para crear una lista de elementos para una dimensin a partir de una de las varias fuentes de datos posibles, incluyendo ODBC y archivos ASCII. sta es la manera rpida de crear una larga lista de elementos, como mil nombres de una dimensin de cliente.
Archivo ASCII de muestra

Aqu est el archivo ASCII delimitado (example.cma) que utilizar para construir una dimensin e importar datos.
"New England", "Massachusetts", "Boston", "SuperMart", "Feb" , 2000000"New England", "Massachusetts", "Springfield", "SuperMart", "Feb" , 1400000"New England", "Massachusetts", "Worcester", "SuperMart", "Feb" , 2200000
Cada uno de los registros de este archivo fuente tiene seis campos, y tres de ellos se utilizarn para crear la dimensin Example. Los dos primeros campos se convertirn en elementos consolidados. El tercer campo se convertir en un elemento numrico. El resto de campos se ignorar. En el Editor de dimensiones, la dimensin Example aparecer de la manera siguiente.
Los valores numricos de Boston, Springfield y Worcester se consolidarn en los totales de Massachusetts, que se consolidarn en los totales de New England.
Creacin de una dimensin a partir de un archivo ASCII

Para crear una dimensin utilizando el archivo de muestra example.cma:
Pasos
1. En el panel izquierdo de Server Explorer, seleccione Procesos bajo el servidor local. 2. Seleccione Proceso, Crear nuevo proceso. Se abrir la ventana TurboIntegrator. 3. Seleccione Texto como el Tipo de fuente de datos. 4. Haga clic en el botn Examinar para el Nombre de la fuente de datos y seleccione example.cma en su directorio TI_data. 5. Deje vaco el campo Nombre de la fuente de datos en el Servidor.
Apndice A: TurboIntegrator Tutorial 6. Defina el Tipo de delimitador como Delimitado y la Coma como Delimitador. 7. Ignore los campos Carcter de comillas y Nmero de registros de ttulos, ya que no hay comillas ni registros de ttulo en el archivo de entrada. El Separador decimal debera ser el punto (.) y el Separador de millares la coma (,). 8. Haga clic en el botn Vista previa para ver los registros del archivo fuente example.cma. Estos registros le permiten examinar la estructura de los registros de la fuente de datos.
Identificacin de variables
Tras cargar los datos de origen en TurboIntegrator, debe identificar el contenido de cada campo de la fuente. TM1 asigna una variable a cada campo de la fuente.
Pasos
1. Haga clic en la pestaa Variables para ver la siguiente cuadrcula, que muestra una fila para cada variable de la fuente de datos.
La primera columna de la cuadrcula asigna un Nombre de variable a cada campo de la fuente de datos. Para asignar sus propias variables, haga clic en la celda apropiada e introduzca un nuevo nombre de variable. La segunda columna asigna un Tipo de variable para cada variable. Esto identifica el tipo de datos del campo fuente. Puede cambiar el tipo seleccionando uno de la lista desplegable. La tercera columna, Valor de ejemplo, enumera el contenido del primer registro de la fuente de datos. En la imagen anterior, New England es el contenido del primer campo del primer registro de example.cma. La columna Contenido determina el tipo de datos TM1 (Elemento, Consolidacin, Datos, Atributo, Otros o Ignorar) que identifica cada variable. En el ejemplo, las primeras tres variables identifican consolidaciones y elementos de una jerarqua regional. 2. En la columna Contenido de la variable V1, seleccione Consolidacin en la lista desplegable. 3. Haga lo mismo para la variable Massachusetts. 4. Para la variable Boston, seleccione Elemento. 5. Seleccione Ignorar para el resto de las variables, ya que no se utilizarn para crear la dimensin.
102 IBM Cognos TM1
Tras identificar las variables en la fuente de datos, debe asignarlas a objetos TM1.
Pasos
1. Haga clic en la pestaa Asignaciones y, a continuacin, en la subpestaa Cubo. 2. No est creando un cubo, por tanto, seleccione Ninguna accin en el cuadro Accin de cubo. 3. La Accin de datos no es relevante, ya que no est creando ni actualizando un cubo. Puede ignorar este cuadro. 4. La opcin Registro de cubos no es relevante, ya que no est procesando valores de datos. Deje esta opcin sin seleccionar. 5. Haga clic en la subpestaa Dimensiones. Esta cuadrcula tiene una fila para cada variable que identific como un Elemento en el tipo de contenido. Debe especificar un tipo de elemento e identificar la dimensin a la que pertenece el elemento. 6. Est creando una nueva dimensin, por tanto, escriba Example en la columna Dimensin de la variable Boston. 7. Seleccione Crear en la lista desplegable Accin. 8. Seleccione Numrico en la lista desplegable Tipo de elemento. La subpestaa Dimensiones debera tener este aspecto:
La variable Boston est ahora asignada como elemento numrico de una nueva dimensin llamada Example. Ahora puede asignar las variables identificadas como consolidaciones. 9. Haga clic en la subpestaa Consolidaciones.
Apndice A: TurboIntegrator Tutorial TM1 identifica correctamente las dos variables de consolidacin como miembros de la nueva dimensin Example. Solo tiene que identificar la variable de hijo de cada consolidacin. 10. Para la Variable de consolidacin V1, seleccione Massachusetts como la Variable de hijo. 11. Para la Variable de consolidacin Massachusetts, seleccione Boston como la Variable de hijo. 12. No modifique el Peso de ninguna de las variables de consolidacin. Cuando haya terminado, la subpestaa Consolidaciones debera aparecer del modo siguiente.
Todas las asignaciones han finalizado. Si lo desea, puede hacer clic en la pestaa Avanzado y, a continuacin, haga clic en las distintas subpestaas para ver los scripts generados por TurboIntegrator que crean la nueva dimensin Example e insertan consolidaciones y elementos. En secciones posteriores de este tutorial analizaremos de forma ms detallada los scripts de TurboIntegrator.
Guardar y ejecutar el proceso

Pasos
1. Haga clic en el botn Ejecutar . TM1 le solicitar que guarde el proceso. 2. Guarde el proceso como create_Example_dimension. Se recomienda guardar los procesos con nombres descriptivos. Tras unos segundos, debera ver un cuadro de mensaje que muestra una confirmacin de que el proceso se he ejecutado con xito. 3. Cierre la ventana TurboIntegrator. 4. Abra Server Explorer. 5. Haga clic con el botn derecho del ratn en la nueva dimensin Example y seleccione Editar estructura de dimensin. La dimensin Example se abre en el Editor de dimensiones. 6. Haga clic en para ordenar los miembros de la dimensin por nivel de jerarqua.
104 IBM Cognos TM1
La dimensin Example se ha creado correctamente. New England es un elemento consolidado que contiene Massachusetts (elemento consolidado), que, a su vez, contiene Boston, Springfield y Worcester (elementos numricos).
Creacin de una dimensin a partir de una fuente ODBC

Esta parte del tutorial le guiar en la creacin de una dimensin a partir de una fuente de datos ODBC. El procedimiento es muy similar al de crear una dimensin a partir de un archivo ASCII.
Definicin de la fuente de datos

Antes de continuar con el tutorial, debe aadir una base de datos de Access como fuente de datos ODBC para que est disponible en TurboIntegrator.
Pasos
1. Abra el cuadro de dilogo Administrador de fuentes de datos ODBC de Windows. El procedimiento necesario para acceder a este cuadro de dilogo vara en funcin de la versin de Windows que utilice. Consulte la ayuda en lnea de Windows para obtener ms detalles. 2. En la pestaa DSN de usuario, haga clic en el botn Aadir. Se abrir el cuadro de dilogo Crear nueva fuente de datos. 3. Seleccione Controlador de Microsoft Accessy haga clic en Finalizar. Se abrir el cuadro de dilogo Configuracin de ODBC Access. 4. Escriba NewDB en el campo Nombre de fuente de datos. 5. Haga clic en el botn Seleccionar. Se abrir el cuadro de dilogo Seleccionar base de datos. 6. Desplcese al directorio TI_Data y seleccione NewDB.mdb. 7. Haga clic en Aceptar para salir del cuadro de dilogo Seleccionar base de datos. 8. Haga clic en Aceptar para salir del cuadro de dilogo Administrador ODBC. La base de datos de Access NewDB est ahora disponible como fuente ODBC.
Consultar la fuente de datos

Para consultar la fuente de datos:
Pasos
1. En Server Explorer, haga clic con el botn derecho del ratn en el icono Procesos y seleccione Crear nuevo proceso. Se abrir la ventana TurboIntegrator. 2. Seleccione ODBC como el Tipo de fuente de datos. 3. Haga clic en el botn Examinar junto al campo Nombre de fuente de datos. 4. Se abrir el cuadro de dilogo Fuentes de datos ODBC. 5. Seleccione NewDB y haga clic en Aceptar. NewDB.mdb tiene una tabla, ACCOUNT, que tiene 27 campos. Escribir una consulta SQL para seleccionar informacin de seis de ellos. Todas las consultas ODBC deben utilizar el dialecto SQL de la DBMS subyacente. La sintaxis de una consulta de MS Access ser diferente de una consulta Informix o una de SQL Server, etc. Para garantizar una correcta sintaxis, primero puede crear la consulta utilizando la prestacin de consulta de la DBMS subyacente, a continuacin, copie la consulta y pguela en el campo Consulta de TurboIntegrator. 6. El el campo Consulta, escriba la siguiente instruccin exactamente como se abre:
SELECT [ACCOUNT_ID], [PARENT_ID], [NAME], [TYPE], [SALESREP], [SALESTEAM] FROM ACCOUNT;
7. Haga clic en Previsualizar para ver los diez primeros registros que devuelve la consulta.
Utilizacin de un parmetro en SQL

Puede crear un parmetro para utilizarlo en el campo Fuente de datos y, a continuacin, llamar a dicho parmetro como parte de una consulta. Por ejemplo, en la siguiente instruccin SQL,
SELECT * FROM customer WHERE last_name = Smith
puede sustituir el valor de Smith por el parmetro pLastName para que la instruccin SQL sea:
SELECT * FROM customer WHERE last_name = ?pLastName?
Al crear un parmetro, tenga en cuenta lo siguiente: Debe crear en primer lugar el proceso TI utilizando una fuente ODBC. As se llenar la ficha Variables. En este punto, puede utilizar la variable DATASOURCEQUERY para sobrescribir el valor del cuadro de texto de la consulta en la ficha Fuente de datos. El nmero de columnas del conjunto devuelto debe coincidir con el nmero que apareca cuando se desarroll el proceso TI. El tipo de datos de las columnas tambin debe coincidir.
106 IBM Cognos TM1
Apndice A: TurboIntegrator Tutorial Es muy importante escribir el parmetro entre comillas simples cuando se trata de un parmetro de cadena. En un parmetro numrico, no utilice las comillas simples; por ejemplo, la consulta que utiliza un parmetro numrico podra ser
SELECT * FROM customer WHERE last_name = ?pQuantity?
Para crear el parmetro, utilice la ficha Avanzado del cuadro de dilogo Proceso TurboIntegrator para sustituir el parmetro PO por defecto por el parmetro que desee utilizar, como por ejemplo: pLastName.
Tras consultar los datos de origen, debe identificar el contenido de cada campo en los resultados de la consulta.
Pasos
1. Haga clic en la pestaa Variables. La cuadrcula de la pestaa de variables debera aparecer de la siguiente manera:
Tenga en cuenta que la columna Nombre de variable se ha rellenado con los nombres de columna correctos de la base de datos. 2. Cambie las selecciones de la columna Contenido con estas selecciones.
ACCOUNT_ID PARENT_ID NAME TIPO SALESREP SALESTEAM Ahora est listo para asignar variables.
Contenido
Ignorar Ignorar Elemento Consolidacin Consolidacin Consolidacin
En primer lugar, tiene que asignar elementos a dimensiones.
Pasos
1. Haga clic en la pestaa Asignaciones y, a continuacin, en la subpestaaDimensiones. La nica variable que identific como elemento se muestra en la cuadrcula. 2. En la columna Dimensin, escriba DB. 3. Seleccione Crear en el men de lista desplegable Accin. 4. Seleccione Numrico en el men de lista desplegable Tipo de elemento. La subpestaa Dimensiones debera tener este aspecto:
Ahora est listo para asignar variables de consolidacin.
Pasos
1. Haga clic en la subpestaa Consolidaciones. TM1 identifica correctamente cada variable de consolidacin como asignacin a la dimensin DB. 2. Establezca la Variable de hijo de cada variable de consolidacin.
Variable de consolidacin
TIPO SALESREP SALESTEAM
Variable de hijo
SALESREP NAME TIPO
Cuando haya establecido todas las Variables de hijo, la subficha Consolidaciones debera tener este aspecto:
108 IBM Cognos TM1

Pasos
1. Haga clic en el botn Ejecutar . TM1 le solicitar que guarde el proceso. 2. Guarde el proceso como create_DB_dimension. Tras unos segundos, debera aparecer un mensaje confirmando que el proceso se ha ejecutado con xito. 3. Cierre la ventana TurboIntegrator. 4. Abra Server Explorer. 5. Haga doble clic en la nueva dimensin DB. La dimensin DB se abre en el Editor de subconjuntos. 6. Seleccione Editar Ordenar Jerarqua en la barra de men del Editor de subconjuntos para mostrar los elementos y consolidaciones de la dimensin. La dimensin DB contiene ms de 40 elementos y tiene cuatro niveles de jerarqua.
Creacin de un cubo y procesar datos

El siguiente ejemplo muestra cmo usar TurboIntegrator TM1 para crear un cubo, dimensiones y procesar datos al mismo tiempo.
Definicin de la fuente de datos

Realice los siguientes pasos para definir una fuente de datos.
Pasos
1. En el panel izquierdo de Server Explorer, haga clic con el botn derecho del ratn en el icono Procesos y seleccione Crear nuevo proceso. Se abrir la ventana TurboIntegrator. 2. Haga clic en la pestaa Fuente de datos de la ventana TurboIntegrator. 3. Establezca el Tipo de fuente de datos como Texto; el Tipo de delimitador como Delimitado; y el Delimitador como Dos puntos. Ignore los campos Comillas y Nmero de registros de ttulos. 4. Asegrese de que el Separador decimal es el punto (.) y el Separador de millares es la coma (,). 5. Haga clic en el botn Examinar junto al campo Nombre de la fuente de datos y seleccione el archivo newcube.csv de su directorio TI_data. 6. Haga clic en Vista previa para ver los primeros diez registros de la fuente de datos.
Apndice A: TurboIntegrator Tutorial Cada registro de newcube.csv contiene 20 campos. Puede desplazarse a lo largo de la cuadrcula de visualizacin para ver todos los campos.
Tras cargar los datos de origen en TurboIntegrator, debe identificar el contenido de cada campo de la fuente.
Pasos
1. Haga clic en la pestaa Variables. Algunas variables utilizarn la convencin de nomenclatura Vn, mientras que otras utilizarn los nombres correspondientes al primer registro del archivo de origen. 2. Para simplificar el proceso de edicin, cambie el nombre a todas las variables utilizando la convencin Vn. La primera variable debera nombrarse V1, la segunda V2, etc. Cuando haya terminado, la pestaa Variables debera aparecer del modo siguiente:
3. Para cada variable, seleccione un tipo de la lista desplegable Tipo de variable asociada. Para las variables V1, V2 y V3, el tipo es Numrico. Para el resto de variables, el tipo es Cadena. 4. Para cada variable, seleccione un tipo de contenido de la lista desplegable Contenido asociada. Consulte la siguiente tabla para identificar el tipo de contenido de cada variable.
110 IBM Cognos TM1
V1 V2 V3 V4 V5 V6 V7 V8 V9 V10
Contenido
Datos Datos Datos Elemento Consolidacin Consolidacin Consolidacin Consolidacin Consolidacin Elemento
V11 V12 V13 V14 V15 V16 V17 V18 V19 V20
Contenido
Consolidacin Consolidacin Consolidacin Elemento Consolidacin Consolidacin Elemento Elemento Elemento Elemento
Cuando haya terminado, la cuadrcula Variables debera aparecer del modo siguiente:
Ha identificado variables para datos, elementos y consolidaciones. Ahora tiene que asignar las variables y proporcionar instrucciones para crear un nuevo cubo.
Asignacin del cubo

Para proporcionar instrucciones de asignacin de cubo:
Pasos
1. Haga clic en la pestaa Mapas. 2. Haga clic en la subpestaa Cubo. 3. SeleccioneCrear para la Accin de cubo. 4. Escriba NewCube en el campo Nombre de cubo. 5. Seleccione Almacenar valores para la Accin de datos. 6. No habilite la opcin Activar el registro de cubos. Cuando habilita el registro de cubos, TM1 registra los cambios en los datos del cubo durante el proceso. Est creando un nuevo cubo, por tanto, no necesita registrar los cambios.
112 IBM Cognos TM1
Asignacin de variables de elemento a dimensiones

Ahora puede asignar todas las variables que identific como que contenan un tipo de Elemento para las dimensiones apropiadas.
Pasos
1. Haga clic en la subpestaa Dimensiones. 2. Utilizando la siguiente tabla como gua, especifique una Dimensin, Accin y Tipo de elemento para cada variable de elemento.
Variable de elemento
V4 V10 V14 V17 V18 V19 V20 Variables de datos
Dimensin
date elemento cliente trabajo pas agente libro medida
Accin
Crear Crear Crear Crear Crear Crear Crear Crear
Tipo de elemento
Numrico Numrico Numrico Numrico Numrico Numrico Numrico Numrico
Puede aceptar los valores predeterminados de Orden en el cubo de cada variable. Cuando haya terminado, la subpestaa Dimensiones debera aparecer del modo siguiente:
Asignacin de variables de datos

Ahora debe asignar las variables que identific como que contenan un tipo de Datos a elementos individuales.
Pasos
1. Haga clic en la subpestaa Datos. 2. Para la variable de datos V1, introduzca peso como el elemento al que se asignar la variable. 3. Para V2, introduzca conversin. 4. Para V3, introduzca porciones. 5. En la columna Tipo de elemento, seleccione Numrico para los tres elementos. La subpestaa Datos debera mostrarse de la siguiente manera:
Asignacin de variables de consolidacin

Ahora debe asignar rutas de consolidacin para todas las variables que identific como que contenan un contenido de Consolidacin.
Pasos
1. Haga clic en la subpestaa Consolidaciones. 2. Utilizando la siguiente tabla como gua, especifique una Dimensin y Variable de hijo para cada consolidacin.
V5 V6 V7 V8 V9 V11
Dimensin
elemento elemento elemento elemento elemento cliente
Variable de hijo
V6 V7 V8 V9 V10 V12
114 IBM Cognos TM1
V12 V13 V15 V16
Dimensin
cliente cliente trabajo trabajo
Variable de hijo
V13 V14 V16 V17
3. Puede aceptar el Peso y Orden de componentes predeterminado para todas las variables de consolidacin. Cuando haya terminado, la subpestaa Consolidacin debera aparecer de la manera siguiente:
Ahora que ha terminado las asignaciones para crear nuevas dimensiones, inserte elementos y consolidaciones en las dimensiones, cree un nuevo cubo y rellnelo con datos.

Pasos
1. Haga clic en el botn Ejecutar . TM1 le solicitar que guarde el proceso. 2. Guarde el proceso como create_newcube. Tras unos segundos, debera aparecer un mensaje confirmando que el proceso se ha ejecutado con xito. 3. Abra Server Explorer y fjese en que se ha creado y completado el cubo NewCube, y se han creado todas las dimensiones necesarias.
Examine el nuevo cubo (se ha rellenado muy escasamente) y las dimensiones que acaba de crear.
Scripts avanzados
Utilice la pestaa Avanzado de TurboIntegrator para crear parmetros que puedan trasladarse a un proceso en el tiempo de ejecucin o para editar procedimientos de un proceso, mejorando de este modo las capacidades de TurboIntegrator. Los procedimientos se editan mediante la creacin de scripts que incorporan funciones de TurboIntegrator y funciones de reglas de TM1.
Edicin de los procedimientos de Prlogo, Metadatos, Datos y Eplogo

Puede mejorar las capacidades de TurboIntegrator editando los procedimientos que definen las acciones de un proceso. Un procedimiento es un grupo de instrucciones que manipulan datos o metadatos TM1. Un proceso incluye cuatro procedimientos que se ejecutan de forma secuencial. Cada procedimiento contiene instrucciones generadas que ha creado TM1 basndose en las opciones que seleccion en algn otro lugar de la ventana TurboIntegrator. Puede editar estos procedimientos aadiendo sus propias instrucciones que incorporan funciones de TurboIntegrator y Funciones de reglas. Los procedimientos que contiene un proceso son:
Pestaa
Prlogo Metadatos
Descripcin
Una serie de acciones que se debe ejecutar antes de que se procese la fuente de datos. Una serie de acciones que actualizan o crean un cubo, dimensiones y otras estructuras de metadatos durante el procesamiento. Una serie de acciones de datos que se ejecutan en cada registro de la fuente de datos. Una serie de acciones que se ejecutan despus de que se procese la fuente de datos.
Datos Eplogo
116 IBM Cognos TM1
Apndice A: TurboIntegrator Tutorial Cuando edita procedimientos, tenga en cuenta que cada procedimiento est pensado para ejecutar ciertos tipos de accin en momentos especficos de un proceso. De esta manera, debera crear acciones o instrucciones que sean apropiadas para un procedimiento concreto. Por ejemplo, para exportar datos procesados a un archivo ASCII, aadira la funcin ASCIIOutput al procedimiento de Datos. ASCIIOutput es una funcin que manipula los datos y debera ejecutarse durante el procesamiento. Por tanto, el procedimiento de Datos es la ubicacin correcta para la funcin.
Edicin de un procedimiento
Para editar un procedimiento:
Pasos
1. Haga clic en la pestaa Avanzado de la ventana TurboIntegrator. 2. Haga clic en la subpestaa del procedimiento que desee editar. 3. Introduzca sus instrucciones en el cuadro de texto antes de la lnea #****GENERATED STATEMENTS START**** o despus de la lnea #****GENERATED STATEMENTS FINISH****. No debera editar las instrucciones generadas entre estas dos lneas.
Creacin de una dimensin con jerarquas desequilibradas

En este ejercicio, utilizar el siguiente archivo de entrada para crear una dimensin con jerarquas desequilibradas.
TOTAL,NORTH,TK1,G1 TOTAL,NORTH,TK1,G2 TOTAL,NORTH,TK1,G3 TOTAL,NORTH,TK1,G4 TOTAL,NORTH,TK2,G5 TOTAL,NORTH,TK2,G6 TOTAL,SOUTH,TK3,G7 TOTAL,SOUTH,TK3,G8 TOTAL,SOUTH,TK3,G9 TOTAL,SOUTH,TK4,G10 TOTAL,SOUTH,TK4,G11 TOTAL,SOUTH,TK4,G12 TOTAL,TK5,G13 TOTAL,TK5,G14 TOTAL,TK6,G15 TOTAL,TK6,G16 TOTAL,TK6,G17 TOTAL,G18 TOTAL,G19
Apndice A: TurboIntegrator Tutorial El resultado final tendr este aspecto:
Para comenzar a crear la dimensin:
Pasos
1. En el panel izquierdo de Server Explorer, haga clic con el botn derecho del ratn en el icono Procesos y seleccione Crear nuevo proceso. Se abrir la ventana TurboIntegrator. 2. Seleccione el Tipo de fuente de datos de Texto. 3. Haga clic en el botn Examinar junto al campo Nombre de la fuente de datos y seleccione unbalanced.csv en su directorio TI_data. 4. Deje todas las opciones restantes de la pestaa Fuente de datos con sus parmetros predeterminados. 5. Haga clic en Actualizar para ver los primeros diez registros de la fuente de datos.
118 IBM Cognos TM1
Tras cargar los datos de origen en TurboIntegrator, debe identificar el contenido de cada campo de la fuente.
Pasos
1. Haga clic en la pestaa Variables. 2. El la columna Contenido, seleccione Consolidacin para las variables Total, North y TK1. 3. Seleccione Elemento para la variable G1.
Ha identificado elementos de variables y consolidaciones. Ahora tiene que asignar las variables a una dimensin y definir rutas de consolidacin.
Pasos
1. Haga clic en la pestaa Mapas. 2. Haga clic en la subpestaa Dimensiones. 3. Para la variable de elemento G1, introduzca desequilibrada como Dimensin, Crear para la Accin y Numrico para el Tipo de elemento.
4. Haga clic en la subpestaa Consolidaciones. 5. En la columna Dimensin, seleccione desequilibrada de la lista desplegable para las tres variables. 6. Para la Variable de consolidacin Total, seleccione Norte como Variable de hijo. 7. Para la Variable de consolidacin North, seleccione TK1 como Variable de hijo. 8. Para la Variable de consolidacin TK1, seleccione G1 como Variable de hijo.
Copia de Instrucciones generadas

TM1 genera instrucciones de forma dinmica al cambiar las opciones de la ventana TurboIntegrator. Va a editar las instrucciones generadas en las subfichas Prlogo y Metadatos de la pestaa Avanzado, para alojar una jerarqua de dimensin desequilibrada. Para facilitar las cosas un poco, copiar y pegar las instrucciones generadas, de manera que estn disponibles despus de cambiar las opciones de la ventana TurboIntegrator.
Pasos
1. Haga clic en la pestaa Avanzado y, a continuacin, en la subpestaa Prlogo. 2. Copie las funciones DimensionDestroy y DimensionCreate que hay entre las lneas de comentario
#****GENERATED STATEMENTS START**** #****GENERATED STATEMENTS FINISH****
y pguelas bajo las lneas de comentario.
3. Haga clic en la subpestaa Metadatos. Existen dos funciones: La funcin DimensionElementInsert aade un elemento simple (hoja) a una dimensin. Puede utilizar esta funcin para aadir tanto elementos numricos como de cadena. La funcin DimensionElementComponentAdd aade un componente (hijo) a un elemento consolidado. 4. Copie todas las instrucciones generadas y pguelas debajo de la ltima lnea de comentario.
120 IBM Cognos TM1
Eliminar permanentemente las instrucciones generadas

Para eliminar permanentemente las instrucciones generadas:
Pasos
1. Haga clic en la pestaa Variables y cambie las selecciones de la columna Contenido a Otros.
Cuando una variable se identifica como Otros, la variable est disponible para utilizarla en scripts avanzados. Si una variable se identifica como Ignorar, TurboIntegrator no la procesa y, por tanto, no se puede hacer referencia a ella en scripts avanzados. 2. Para verificar que las instrucciones se han eliminado, haga clic en la pestaa Avanzado y, a continuacin, en las subpestaas Prlogo y Metadatos. Las instrucciones deben aparecer de la siguiente manera:
Prolog> #****GENERATED STATEMENTS START**** #****GENERATED STATEMENTS FINISH**** DIMENSIONDESTROY('unbalanced'); DIMENSIONCREATE('unbalanced'); Metadata> #****GENERATED STATEMENTS START**** #****GENERATED STATEMENTS FINISH**** DIMENSIONELEMENTINSERT('unbalanced','',G1,'n'); DIMENSIONELEMENTINSERT('unbalanced','',TOTAL,'c'); DIMENSIONELEMENTINSERT('unbalanced','',NORTH,'c');

DIMENSIONELEMENTINSERT('unbalanced','',TK1,'c'); DIMENSIONELEMENTCOMPONENTADD('unbalanced',TOTAL,NORTH,1.000000); DIMENSIONELEMENTCOMPONENTADD('unbalanced',NORTH,TK1,1.000000); DIMENSIONELEMENTCOMPONENTADD('unbalanced',TK1,G1,1.000000);
Edicin de las instrucciones de TurboIntegrator

Examine el script que est actualmente en la subpestaa Metadatos, que aparecer de la siguiente manera.
DIMENSIONELEMENTINSERT('unbalanced','',G1,'n'); DIMENSIONELEMENTINSERT('unbalanced','',TOTAL,'c'); DIMENSIONELEMENTINSERT('unbalanced','',NORTH,'c'); DIMENSIONELEMENTINSERT('unbalanced','',TK1,'c'); DIMENSIONELEMENTCOMPONENTADD('unbalanced',TOTAL,NORTH,1.000000); DIMENSIONELEMENTCOMPONENTADD('unbalanced',NORTH,TK1,1.000000); DIMENSIONELEMENTCOMPONENTADD('unbalanced',TK1,G1,1.000000);
Este script, que se ha generado basndose en el primer registro de unbalanced.csv, es vlido para los registros que contienen cuatro campos. El script crea elementos de dimensiones de cada campo de la fuente y, a continuacin, crea una jerarqua. El script, sin embargo, no es vlido para registros que contienen menos de cuatro campos. Como el archivo fuente unbalanced.csv contiene registros de diferente longitud, debe modificar el script para evaluar cada uno de los registros de la fuente. El script debera determinar el nivel correcto de consolidacin y especificar una ruta de consolidacin adecuada para cada posible nivel de consolidacin. Esto se puede llevar a cabo editando el script para que incluya una funcin IF que le permita ejecutar otras instrucciones de TurboIntegrator basadas en condiciones definidas.
Pasos
1. Haga clic en la pestaa Avanzado y, a continuacin, en la subpestaa Metadatos. 2. Inserte la lnea
IF (G1@<>'');
antes de la primera instruccin DIMENSIONELEMENTINSERT. Esta instruccin IF indica que si la variable G1 de la cadena no est en blanco, las instrucciones que le siguen se debern ejecutar. Si V4est en blanco, el proceso debera saltarse la siguiente instruccin condicional. La subpestaa Metadatos aparecer ahora de la siguiente forma:
#****GENERATED STATEMENTS START**** #****GENERATED STATEMENTS FINISH**** IF (G1@<>''); DIMENSIONELEMENTINSERT('unbalanced','',G1,'n'); DIMENSIONELEMENTINSERT('unbalanced','',TOTAL,'c'); DIMENSIONELEMENTINSERT('unbalanced','',NORTH,'c'); DIMENSIONELEMENTINSERT('unbalanced','',TK1,'c'); DIMENSIONELEMENTCOMPONENTADD('unbalanced',TOTAL,NORTH,1.000000); DIMENSIONELEMENTCOMPONENTADD('unbalanced',NORTH,TK1,1.000000); DIMENSIONELEMENTCOMPONENTADD('unbalanced',TK1,G1,1.000000);
122 IBM Cognos TM1
Apndice A: TurboIntegrator Tutorial Cuando IF (G1@<>'') es true, TurboIntegrator inserta tres elementos consolidados (Total, North, TK1) y un solo elemento numrico (G1) en la dimensin desequilibrada. TurboIntegrator crea tambin una jerarqua de cuatro niveles, donde Total es el padre de North, North es el padre de TK1 y TK1 es el padre de G1. 3. Inserte la lnea
ELSEIF (TK1@<>'');
despus de la ltima instruccin DIMENSIONELEMENTCOMPONENTADD. Esta instruccin condicional ELSEIF indica que si la variable V3 de la cadena no est en blanco, las instrucciones que le siguen se debern ejecutar. Si V3est en blanco, el proceso debera saltarse la siguiente instruccin condicional. 4. Debe insertar las instrucciones que desea se ejecuten cuando ELSEIF (TK1@<>'') sea true. Cuando ELSEIF (TK1@<>'') es true, el registro fuente contiene tres campos. De esta manera, las instrucciones deberan crear un elemento de dimensin a partir de cada campo y, a continuacin, una jerarqua de tres niveles. 5. Inserte las siguientes instrucciones inmediatamente despus de ELSEIF (TK1@<>'');.
DIMENSIONELEMENTINSERT('unbalanced','',TOTAL,'c'); DIMENSIONELEMENTINSERT('unbalanced','',NORTH,'c'); DIMENSIONELEMENTINSERT('unbalanced','',TK1,'n'); DIMENSIONELEMENTCOMPONENTADD('unbalanced',TOTAL,NORTH,1.000000); DIMENSIONELEMENTCOMPONENTADD('unbalanced',NORTH,TK1,1.000000);
Cuando IF (TK1@<>'') es true, TurboIntegrator inserta dos elementos consolidados (TOTAL y NORTH) y un solo elemento numrico (TK1) en la dimensin desequilibrada. TurboIntegrator crea tambin una jerarqua de tres niveles donde TOTAL es el padre de NORTH y NORTH es el padre de TK1. 6. Inserte la lnea
ELSE;
despus de la ltima instruccin DIMENSIONELEMENTCOMPONENTADD. 7. Debe insertar las instrucciones que desea ejecutar cuando el proceso llegue a la instruccin ELSE. (Esto sucede cuando tanto IF (G1@<>'') como ELSEIF (TK1@<>'') son false.) Cuando el proceso llega a la instruccin ELSE, el registro fuente contiene dos campos. Las instrucciones que inserte deberan crear un elemento de dimensin a partir de cada campo y, a continuacin, una jerarqua de dos niveles. 8. Inserte las siguientes instrucciones inmediatamente despus de ELSE;.
DIMENSIONELEMENTINSERT('unbalanced','',TOTAL,'c'); DIMENSIONELEMENTINSERT('unbalanced','',NORTH,'n'); DIMENSIONELEMENTCOMPONENTADD('unbalanced',TOTAL,NORTH,1.000000);
Estas instrucciones le indican a TurboIntegrator que inserte el elemento consolidado TOTAL y el elemento numrico NORTH en la dimensin desequilibrada, y que cree una jerarqua donde TOTAL es el padre de NORTH.
Apndice A: TurboIntegrator Tutorial 9. Inserte la lnea

ENDIF;
despus de la instruccin final DIMENSIONELEMENTCOMPONENTADD. ENDIF indica el final de la instruccin IF. Cuando haya terminado, la subpestaa Metadatos completada debera aparecer de la manera siguiente:
#****GENERATED STATEMENTS START**** #****GENERATED STATEMENTS FINISH**** IF (G1@<>''); DIMENSIONELEMENTINSERT('unbalanced','',G1,'n'); DIMENSIONELEMENTINSERT('unbalanced','',TOTAL,'c'); DIMENSIONELEMENTINSERT('unbalanced','',NORTH,'c'); DIMENSIONELEMENTINSERT('unbalanced','',TK1,'c'); DIMENSIONELEMENTCOMPONENTADD('unbalanced',TOTAL,NORTH,1.000000); DIMENSIONELEMENTCOMPONENTADD('unbalanced',NORTH,TK1,1.000000); DIMENSIONELEMENTCOMPONENTADD('unbalanced',TK1,G1,1.000000); ELSEIF (TK1@<>''); DIMENSIONELEMENTINSERT('unbalanced','',TOTAL,'c'); DIMENSIONELEMENTINSERT('unbalanced','',NORTH,'c'); DIMENSIONELEMENTINSERT('unbalanced','',TK1,'n'); DIMENSIONELEMENTCOMPONENTADD('unbalanced',TOTAL,NORTH,1.000000); DIMENSIONELEMENTCOMPONENTADD('unbalanced',NORTH,TK1,1.000000); ELSE; DIMENSIONELEMENTINSERT('unbalanced','',TOTAL,'c'); DIMENSIONELEMENTINSERT('unbalanced','',NORTH,'n'); DIMENSIONELEMENTCOMPONENTADD('unbalanced',TOTAL,NORTH,1.000000); ENDIF;
10. Seleccione Archivo, Guardar y nombre al proceso create_unbalanced_dim. 11. Seleccione Archivo, Ejecutar para ejecutar el proceso. 12. Para verificar que la dimensin se ha construido correctamente, abra la dimensin desequilibrada en el Editor de dimensiones. Debera tener el aspecto de la siguiente imagen.
124 IBM Cognos TM1
Creacin de subconjuntos
En este ejercicio crear subconjuntos para la dimensin newdim, que se crea por medio del proceso de la dimensin.
Pasos
1. Abra el proceso subconjuntos de la ventana de TurboIntegrator. Puede que tenga que editar la fuente de datos para que apunte a region.csv de su directorio TI_data. Si cambia la fuente de datos, le pedir que especifique cmo se deberan tratar las variables del proceso. Seleccione Mantener todas las variables. Este ejemplo utiliza las funciones de TurboIntegrator TM1 SubsetCreate() y SubsetElementInsert () para crear y rellenar subconjuntos de dimensiones. La vista previa del archivo fuente tiene este aspecto:
Aqu estn los scripts de los subconjuntos del proceso:

Prolog> #****GENERATED STATEMENTS START**** #****GENERATED STATEMENTS FINISH**** SubsetCreate('NewDim','Europe'); SubsetCreate('NewDim','US'); SubsetCreate('NewDim','ROW'); Metadata> #****GENERATED STATEMENTS START**** #****GENERATED STATEMENTS FINISH**** SubsetElementInsert('NewDim',V4,V0,0);
2. Ejecute el proceso. 3. En Server Explorer, ample la dimensin newdim y vea los subconjuntos que acaba de crear.
Creacin de atributos
La funcin AttrPutS asigna un valor a un atributo de elemento de cadena. Si desea asignar la cadena Europe al atributo Continent del pas Sweden en la dimensin NewDim, escribira la funcin AttrPutS de esta manera:
AttrPutS(Europe,'NewDim',Sweden,'Continent');
Pasos
1. Abra el proceso Atributos en TurboIntegrator. Puede que tenga que editar la fuente de datos para que apunte a region.csv de su directorio TI_data. Si cambia la fuente de datos, le pedir que especifique cmo se deberan tratar las variables del proceso. Seleccione Mantener todas las variables.
126 IBM Cognos TM1
Apndice A: TurboIntegrator Tutorial 2. Haga clic en la pestaa Variables. Tenga en cuenta que V4 y V5 se han identificado como Atributo. 3. Haga clic en la celda Frmula de V5. Aparece V5=V0|V4; Esta frmula concatena los valores de las variables V4 y V5. 4. Haga clic en la pestaa Asignaciones y en la subpestaa Atributos. El tipo de atributo de la variable V4 se ha definido como Texto y el tipo de V5 como Alias. 5. Haga clic en la pestaa Avanzado y en la subpestaa Datos para mostrar las instrucciones generadas y dos instrucciones adicionales.
#****GENERATED STATEMENTS START**** V5=v0|v4; AttrPutS(V4,'newdim',V0,'continent'); AttrPutS(V5,'newdim',V0,'cont'); #****GENERATED STATEMENTS FINISH**** AttrPutS(V4,'newdim',V1,'continent'); AttrPutS(V4,'newdim',V2,'continent');
Las dos instrucciones anteriores se aadieron manualmente porque V1 y V2 no se declararon como contenido en la pestaa Variables. Sin embargo, deben asignarse al atributo de texto Continent. 6. Guarde y ejecute el proceso Atributos
Ver los atributos

Despus de asignar un valor de atributo, puede visualizar la asignacin de la siguiente manera.
Pasos
1. En Server Explorer, haga doble clic en la dimensin newdim para abrir el Editor de subconjuntos. 2. Haga clic en el botn Agrupar todo en un subconjunto .
3. Seleccione Editar, Filtro por, Atributo en el men para mostrar el cuadro de dilogo Filtro por atributo. 4. Seleccione un valor de atributo de la lista desplegable del cuadro de dilogo Filtro por atributo para visualizar en el Editor de subconjuntos todos los pases de un continente determinado.
128 IBM Cognos TM1
Apndice B: Palabras reservadas de TurboIntegrator

Este anexo contiene las palabras reservadas de IBM Cognos TM1 TurboIntegrator. Para prevenir errores en sus scripts de TurboIntegrator, debera evitar crear variables de TM1 con nombres que coincidan con cualquiera de las palabras aparecen en las tablas siguientes. Hay cuatro categoras de palabras reservadas en TurboIntegrator: Nombres de funciones de regla Nombres de funciones de proceso Nombres de variables implcitas Palabras clave de TurboIntegrator
Nombres de funciones de regla

Incluimos aqu las palabras reservadas para funciones de regla de TM1: ABS ACOS ASENO ATAN ATTRN ATTRS AVG BANNR BDATE BDAYN CAPIT CENTR CARACTER CNT CODIGO COL
129
Apndice B: Palabras reservadas de TurboIntegrator Consolidate Children COS FECHA DATES DATFM DIA DAYNO DBG16 DBGEN DELET DFRST DIMIX DIMNM DIMSIZ DISPLY DNEXT DNLEV DTYPE DYS ELCOMP ELCOMPN ELISANC ELISCOMP ELISPAR ELLEV ELPAR ELPARN ELWEIGHT EXP FILL
130 IBM Cognos TM1
Apndice B: Palabras reservadas de TurboIntegrator VF HEX SI INSRT ENTERO TIR ISLEAF ISUND LIN LN LOG LONG LOOK MINUSC MAX MEM MIN RESIDUO MES MOS NCELL AHORA VNA PAYMT VA ALEATORIO DERECHA REDONDEAR ROUNDP SCAN
Apndice B: Palabras reservadas de TurboIntegrator SCELL SIGNO SENO SLEEP RAIZ STDDV STR SUBSIZ SUBST SUMA TABDIM TAN HORA TIMST TIMVL HOY ESPACIOS UNDEF MAYUSC VAR WHOAMI WIDTH AO YRS
Nombres de funciones de proceso

Estos son los nombres de funciones de proceso TurboIntegrator: AddClient AddGroup AllowExternalRequests
132 IBM Cognos TM1
Apndice B: Palabras reservadas de TurboIntegrator ASCIIDelete ASCIIOutput AssignClientPassword AssignClientToGroup AttrDelete AttrInsert AttrPutN AttrPutS AttrToAlias BatchUpdateFinish BatchUpdateStart CellGetN CellGetS CellIsUpdateable CellPutN CellPutProportionalSpread CellPutS ChoreQuit CubeCreate CubeDestroy CubeExists CubeGetLogChanges CubeLockOverride CubeProcessFeeders CubeSetConnParams CubeSetIsVirtual CubeSetLogChanges CubeSetSAPVariablesClause CubeSetSlicerMembers CubeUnload
Apndice B: Palabras reservadas de TurboIntegrator DeleteClient DeleteGroup DimensionCreate DimensionDeleteAllElements DimensionDestroy DimensionEditingAliasSet DimensionElementComponentAdd DimensionElementComponentDelete DimensionElementDelete DimensionElementInsert DimensionElementInsertByAlias DimensionElementPrincipalName DimensionExists DimensionSortOrder ElementSecurityGet ElementSecurityPut EncodePassword ExecuteCommand ExecuteProcess Expand FileExists GetProcessErrorFileDirectory GetProcessErrorFilename IsNull ItemReject ItemSkip LockOff LockOn NumberToString NumberToStringEx
134 IBM Cognos TM1
Apndice B: Palabras reservadas de TurboIntegrator NumericGlobalVariable NumericSessionVariable ODBCClose ODBCOpen ODBCOutput ProcessBreak ProcessError ProcessExitByBreak ProcessExitByChoreQuit ProcessExitByQuit ProcessExitMinorError ProcessExitNormal ProcessExitOnInit ProcessExitSeriousError ProcessExitWithMessage ProcessQuit PublishView RemoveClientFromGroup ReturnSQLTableHandle ReturnViewHandle RuleLoadFromFile SaveDataAll SecurityRefresh ServerShutDown SetChoreVerboseMessages StringGlobalVariable StringSessionVariable StringToNumber StringToNumberEx SubsetAliasSet
Apndice B: Palabras reservadas de TurboIntegrator SubsetCreate SubsetCreateByMDX SubsetDeleteAllElements SubsetDestroy SubsetElementDelete SubsetElementInsert SubsetExists SubsetFormatStyleSet SubsetGetElementName SubsetGetSize SubsetIsAllSet SwapAliasWithPrincipalName ViewColumnDimensionSet ViewColumnSuppressZeroesSet ViewConstruct ViewCreate ViewDestroy ViewExists ViewExtractSkipRuleValuesSet ViewExtractSkipRuleValuesSet ViewExtractSkipZeroesSet ViewRowDimensionSet ViewRowSuppressZeroesSet ViewSetSkipCalcs ViewSetSkipRuleValues ViewSetSkipZeroes ViewSubsetAssign ViewSuppressZeroesSet ViewTitleDimensionSet ViewTitleElementSet
136 IBM Cognos TM1
Apndice B: Palabras reservadas de TurboIntegrator ViewZeroOut WildcardFileSearch
Nombres de variables implcitas

Esto son los nombres de variables implcitas para TurboIntegrator: DatasourceASCIIDecimalSeparator DatasourceASCIIDelimiter DatasourceASCIIHeaderRecords DatasourceASCIIQuoteCharacter DatasourceASCIIThousandSeparator DatasourceCubeview DatasourceDimensionSubset DatasourceNameForClient DatasourceNameForServer DatasourceODBOCatalog DatasourceODBOConnectionString DatasourceODBOCubeName DatasourceODBOHierarchyName DatasourceODBOLocation DatasourceODBOProvider DatasourceODBOSAPClientId DatasourceODBOSAPClientLanguage DatasourcePassword DatasourceQuery DatasourceType DatasourceUseCallerProcessConnection DatasourceUsername MinorErrorLogMax NValue OnMinorErrorDoItemSkip
Apndice B: Palabras reservadas de TurboIntegrator SValue Value_Is_String
Palabras clave de TurboIntegrator

Estas son las palabras clave de TurboIntegrator reservadas. break else elseif end endif if while
138 IBM Cognos TM1
ndice
A
additional connection parameters, 50 alias en funciones de TI, 13 archivo ASCII de muestra, 101 ASCII archivo de muestra, 101 archivos, 9 archivo sin formato, 23 asignar consolidaciones, 21 cubo, 20, 24 datos, 21 dimensin, 21 subconjunto de dimensin, 33 variables, 20 variables de consolidacin a dimensin, 25 variables de cubo, 24 variables de elemento de dimensin, 25 asunto de consulta de hecho detallado, 81 mltiples, 21 subconjunto de dimensin, 33 consulta SQL, 27 consulta BW SAP especificacin de la solicitud de segmentacin, 89 Consultar la fuente de datos, 106 consultas paralelas, 89 consulta SQL, 27 contrasea, 50 Convencin de nomenclatura universal fuente de datos, 15 cubo archivo sin formato ASCII, 23 asignar, 20, 24 creacin, 23 fuente de datos, 23 variables, 24 vista, 31
D B
BW SAP directrices para utilizar datos de hecho, 84 datos asignar, 21 fuente, 11, 15, 17, 23, 31, 32 fuente ODBC, 27 procedimiento, 11 variables, 25 Datos BW SAP Cognos Planning, 81 dimensin archivo ASCII sin formato, 15 asignar, 21 asignar variables de consolidacin, 25 asignar variables de datos, 25 asignar variables de elemento, 25 consolidaciones de subconjunto, 33 fuente de datos del subconjunto, 32 ODBO, 43 divisa importar desde SAP, 64
C
campo Cadena de filtro, 67 campo Nombre de tabla, 67 caracterstica, 59 asignar, 52, 74 cifras clave, 52, 69, 74 cifras clave detalladas, 81 clusula WHERE, 67 client, 50 comodines, 65 conexin cadena de TM1, 36 cadena MSAS, 36 parmetros SAP, 49, 73 consolidaciones asignar, 21 Licensed Materials Property of IBM Copyright IBM Corp. 2007, 2010.
139
ndice
E
elementos importar desde fuentes de datos, 15 extraccin de datos directrices de BW SAP para utilizar las variables, 84
F
filtro de nombre de usuario, 63 filtro de rol, 63 funciones uso en procesos TurboIntegrator, 10
fuente de datos, 35 Fuente de datos, 35 guardar cubo, 40 guardar dimensin, 43 Nombre del proveedor, 35 ubicacin, 35 Ubicacin, 35 OLAP, 35 OLE_LINK1, 117 OLE DB, 35
P I
IBM Cognos 8 Planning y datos BW SAP, 81 idioma, 50 importar datos descripcin general, 9 InfoCube, 50, 64 packet size, 50 palabras reservadas descripcin general, 129 funciones de proceso, 132 funciones de regla, 129 nombres de variables implcitas, 137 palabras clave de TurboIntegrator, 138 parmetro de la fuente de datos, 106 procedimiento de Eplogo, 11 procedimiento de metadatos, 11 procedimiento de prlogo, 11 proceso consejos, 12 definicin, 10 edicin, 93 ejecutar, 22, 94 ejecutar ODBO, 44 guardar, 22, 44 procedimientos, 11 procesos TI recomendaciones, 12
M
MDX, 28 medidas para IBM Cognos 8 Planning, 81 Microsoft Analysis Services, 35, 40, 44 cadena de conexin, 36 conexin, 38 importacin de una dimensin, 41 importacin de un cubo, 37 modo de carga de gran volumen, 91 modo de prueba ejecucin con un proceso de TurboIntegrator, 13 Funciones de TurboIntegrator, 14 utilizacin con procesos TurboIntegrator, 13 MSAS cadena de conexin, 36
R
registro de mensajes, 44 registros, longitud fija, 17 registros de longitud fija, 17
O
ODBC, 9 catlogo, 35 definicin de fuente de datos, 27 fuente de datos, 27 ODBO Catlogo, 35 cubo, 39 dimensin, 43 dimensiones de cubo, 39, 40 140 IBM Cognos TM1
S
SAP asignar, 50, 52, 60, 64, 67, 69, 74 BW, 49, 73 caractersticas, 45, 52, 59, 74 cifras clave, 52, 69, 74 cubo de consulta, 46
ndice cubos de consulta, 45 dimensiones, 45 divisa, 64 establecimiento de una conexin con BW, 49, 73 importacin, 60 importar seguridad, 62 jerarqua de objeto, 46 jerarquas, 45, 52, 60, 74 nombres tcnicos, 46 parmetros de conexin, 49, 73 RFC, 46 roles, 63 terminologa, 45 utilizar comodines, 65 seguridad importar desde SAP, 60, 62 servidor registrado, 35 solicitudes especificacin de la segmentacin de la consulta BW SAP, 89 STET, 12 system, 50 editar procedimientos dentro de un proceso, 116
U
UNC, 15 user, 50
V
variables asignar, 20 asignar a dimensin, 25 asignar consolidacin a dimensin, 25 asignar cubo, 24 cubo, 24 directrices para utilizar datos de hecho BW SAP, 84 fuente de datos, 17 nombres por defecto, 17
T
tablas ODS, 69 exportar a, 68 tarea asistente para la configuracin, 94 definicin, 10, 94 ejecucin automtica, 94 TM1, 9 cubo, 9 registro de mensajes, 44 TurboIntegrator funciones, 10 importar datos, 10 importar desde MDX, 28 ODBC, 27 palabras reservadas, 129 proceso, 11 tutorial, 99 tutorial creacin, 100, 101, 109, 125, 126 crear dimensiones, 101 descripcin general, 99 directorio de datos, 99 Gua de TurboIntegrator 141

Guia Turbo Integrator

Caricato da

Informazioni sul documento

Copyright

Formati disponibili

Condividi questo documento

Condividi o incorpora il documento

Opzioni di condivisione

Hai trovato utile questo documento?

Questo contenuto è inappropriato?

Copyright:

Formati disponibili

Guia Turbo Integrator

Caricato da

Copyright:

Formati disponibili

IBM Cognos TM1

Informacin sobre el producto

Captulo 1: Informacin bsica de TurboIntegrator

6 IBM Cognos TM1

Declaracin de limitacin de responsabilidad de los ejemplos

8 IBM Cognos TM1

Captulo 1: Informacin bsica de TurboIntegrator

Fuentes de datos disponibles con TurboIntegrator

Lmite de longitud de cadena en TurboIntegrator

Licensed Materials Property of IBM Copyright IBM Corp. 2007, 2010.

Puede utilizar TurboIntegrator para realizar cualquier combinacin de estas acciones.

10 IBM Cognos TM1

Orden de operaciones en un proceso TurboIntegrator

Captulo 1: Informacin bsica de TurboIntegrator 8. TM1 cierra el proceso TurboIntegrator.

Apuntes sobre los procesos TurboIntegrator

Conexiones simultneas al mismo Servidor TM1.

12 IBM Cognos TM1

Alias en funciones de TurboIntegrator

Utilizacin de espacios de trabajo personales y modos de prueba con procesos TurboIntegrator

Utilizacin de las funciones de TurboIntegrator con modos de prueba

14 IBM Cognos TM1

Captulo 2: Importacin de un archivo de texto

Creacin de una dimensin desde un archivo de texto

Definicin de una fuente datos

Licensed Materials Property of IBM Copyright IBM Corp. 2007, 2010.

16 IBM Cognos TM1

Captulo 2: Importacin de un archivo de texto

Uso de registros de longitud fija

Identificacin de variables en la fuente de datos

18 IBM Cognos TM1

Captulo 2: Importacin de un archivo de texto

Para definir las variables de la dimensin Location:

Desactivar la asignacin de cubo

20 IBM Cognos TM1

Captulo 2: Importacin de un archivo de texto

Desactivar la asignacin de datos

Guardar y ejecutar el proceso TurboIntegrator

22 IBM Cognos TM1

Captulo 2: Importacin de un archivo de texto

Creacin de un cubo desde un archivo de texto

Definicin de la fuente de datos del cubo

Captulo 2: Importacin de un archivo de texto

Definicin de variables de cubo

Asignacin de variables de cubo

24 IBM Cognos TM1

Captulo 2: Importacin de un archivo de texto

Asignacin de variables de elemento de cubo a dimensiones

Asignacin de variables de datos de cubo

Asignacin de variables de consolidacin

Captulo 2: Importacin de un archivo de texto

Guardar y ejecutar el proceso de cubo

26 IBM Cognos TM1

Captulo 3: Importacin desde una fuente ODBC

Definicin de una fuente de datos ODBC

en el que desea crear el proceso y seleccione Crear nuevo proceso.

Generacin de un proceso TurboIntegrator a partir de una instruccin MDX

Construccin del proceso MDX de TurboIntegrator

28 IBM Cognos TM1

Captulo 3: Importacin desde una fuente ODBC

30 IBM Cognos TM1

Captulo 4: Importacin desde un subconjunto o vista TM1

Utilizacin de una vista de cubo TM1 como fuente de datos

Crear un proceso de cubo

Licensed Materials Property of IBM Copyright IBM Corp. 2007, 2010.