guia turbo integrator

IBM Cognos TM1

Versión 9.5.1

Guía de TurboIntegrator

Información sobre el productoEste documento se aplica a IBM Cognos TM1 Versión 9.5.1 y puede también aplicarse a las siguientes releases. Para comprobar las versionesnuevas de este documento, visite los IBM Cognos Information Centers (http://publib.boulder.ibm.com/infocenter/cogic/v1r0m0/index.jsp).

CopyrightMateriales bajo Licencia - Propiedad de IBM© Copyright IBM Corp. 2007, 2010.

US Government Users Restricted Rights – El uso, la duplicación o la revelación están restringidos por el Contrato GSA ADP Schedule con IBMCorp.IBM, el logotipo de IBM, ibm.com, TM1, y Cognos son marcas registradas o marcas comerciales registradas de International Business MachinesCorp. en muchas jurisdicciones de todo el mundo. Otros nombres de productos y servicios pueden ser marcas registradas de IBM o de otrasempresas. 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 otrospaíses.

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

http://publib.boulder.ibm.com/infocenter/cogic/v1r0m0/index.jsp

Índice

Introducción 7

Capítulo 1: Información básica de TurboIntegrator 9Fuentes de datos disponibles con TurboIntegrator 9Límite de longitud de cadena en TurboIntegrator 9Importación de opciones 10Funciones de TurboIntegrator 10Procesos y tareas 10Orden de operaciones en un proceso TurboIntegrator 11Apuntes sobre los procesos TurboIntegrator 12Conexiones simultáneas al mismo Servidor TM1. 12Alias en funciones de TurboIntegrator 13Utilización de espacios de trabajo personales y modos de prueba con procesos TurboIntegra-

tor 13Ejecución manual de un proceso TurboIntegrator con un espacio de trabajo personal o un

modo de prueba 13Utilización de las funciones de TurboIntegrator con modos de prueba 14

Capítulo 2: Importación de un archivo de texto 15Creación de una dimensión desde un archivo de texto 15

Definición de una fuente datos 15Identificación de variables en la fuente de datos 17Asignación de variables 20Guardar y ejecutar el proceso TurboIntegrator 22

Creación de un cubo desde un archivo de texto 23Definición de la fuente de datos del cubo 23Definición de variables de cubo 24Asignación de variables de cubo 24Asignación de variables de elemento de cubo a dimensiones 25Asignación de variables de datos de cubo 25Asignación de variables de consolidación 25Guardar y ejecutar el proceso de cubo 26

Capítulo 3: Importación desde una fuente ODBC 27Unicode y DSN 27Definición de una fuente de datos ODBC 27Generación de un proceso TurboIntegrator a partir de una instrucción MDX 28

Construcción del proceso MDX de TurboIntegrator 28

Capítulo 4: Importación desde un subconjunto o vista TM1 31Utilización de una vista de cubo TM1 como fuente de datos 31

Crear un proceso de cubo 31Utilización de un subconjunto TM1 como fuente de datos 32

Definir subconjunto de dimensión como fuente de datos 32Definir variables de dimensión 32

Licensed Materials – Property of IBM3© Copyright IBM Corp. 2007, 2010.

Asignación de variables de dimensión 33Guardar y ejecutar la dimensión 34

Capítulo 5: Importación desde MSAS 35Base de datos OLE para fuentes de datos OLAP 35

Nombre del proveedor ODBO 35Ubicación de ODBO 35Fuente de datos ODBO 35Catálogo ODBC 35Cadenas de conexión: MSAS frente a TM1 36Conexión a una base de datos OLE para fuente de datos OLAP cuando utiliza autenticación

CAM 37Importación de un cubo MAS 37

Conexión a Analysis Services con TurboIntegrator 38Especificar el cubo con la pestaña Cargar cubo ODBC 39Uso de la pestaña Dimensiones de cubo 40Guardar y ejecutar el proceso MAS 40

Importación de una dimensión MAS 41Definición de parámetros de conexión MAS 42Uso de la pestaña Cargar dimensión de ODBO 43Guardar y ejecutar el proceso MAS de la dimensión 44Registro de mensajes de TM1 44

Capítulo 6: Importación de datos utilizando TM1 Connector for SAP Business Warehouse 45Objetos SAP y terminología 45

Objetos análogos en SAP y TM1 45Jerarquía de objeto SAP 46

Requisitos previos del software TM1 Connector for BW SAP 46El archivo Saprfc.ini y las librerías RFC 46

Microsoft Windows (x86) 46Microsoft Windows (x86, x64) 47UNIX (Sun Solaris, IBM AIX) 47

Instalación de la interfaz de TM1 en BW SAP 48Importación de un InfoCube desde SAP 48

Establecimiento de una conexión con BW SAP 49Asignación de un InfoCube SAP a un cubo TM1 50Asignación de características SAP a dimensiones TM1 52Establecimiento de restricciones de características 55Selección de parámetros de características 57Guardar y ejecutar el proceso SAP TurboIntegrator 58Ver los resultados 58

Importación de una característica desde SAP 59Asignación de una característica SAP a una dimensión TM1 60

Importación de seguridad desde SAP 62Selección de las definiciones de seguridad SAP que desea importar 63

Importación y conversión de datos de divisa desde SAP 64Asignación de divisas de SAP a cubos y dimensiones de TM1 64

Importación de una tabla SAP 67Creación de una consulta de tabla SAP 67Identificación y asignación de variables 68

4 IBM Cognos TM1

Índice

Escritura de datos TM1 en SAP 68Asignación de dimensiones y valores de una vista TM1 a una tabla ODS 69

Capítulo 7: Importación de datos a través de IBM Cognos TM1 Package Connector 73Establecimiento de una conexión al servidor Cognos BI 73

Conexión a paquetes publicados 74Importación de una única dimensión 79

Guardar y ejecutar el proceso TurboIntegrator 80Ver los resultados 80Directrices para trabajar con datos BW SAP 81

Cómo trabajar con datos BW SAP utilizando un paquete de Framework Manager 81Especificación de una solicitud de segmentación para una consulta BW SAP 89

Realización de consultas paralelas con una solicitud de segmentador 89

Capítulo 8: Edición de tareas y procedimientos avanzados 91Utilización del modo de carga de gran volumen 91

Aspectos que debe tener en cuanta al utilizar el modo de carga de gran volumen 91Comandos del proceso TurboIntegrador para el modo de carga de gran volumen 92Funciones API C de TM1 para el modo de carga de gran volumen 93

Edición de procedimientos 93Ejecución de un proceso a petición 94Programación de un proceso para la ejecución automática con tareas 94

Nota importante sobre las horas de inicio de las tareas 96Edición de una tarea 97Activación de una tarea 97Desactivación de una tarea 97Borrar una tarea 97Ejecución de una tarea a petición 97

Apéndice A: TurboIntegrator Tutorial 99Configuración del directorio de datos del tutorial 99Descripción general de TurboIntegrator 99Creación de un proceso TurboIntegrator 100

Creación de dimensiones utilizando TurboIntegrator 101Creación de un cubo y procesar datos 109

Scripts avanzados 116Edición de los procedimientos de Prólogo, Metadatos, Datos y Epílogo 116Creación de subconjuntos 125Creación de atributos 126

Apéndice B: Palabras reservadas de TurboIntegrator 129Nombres de funciones de regla 129Nombres de funciones de proceso 132Nombres de variables implícitas 137Palabras clave de TurboIntegrator 138

Índice 139

Guía de TurboIntegrator 5

Índice

6 IBM Cognos TM1

Índice

Introducción

Este documento se ha concebido para utilizarse con IBM® Cognos® TM1

Este manual describe cómo utilizar TurboIntegrator IBM Cognos TM1 de Cognos para importar

datos y metadatos a TM1 desde varias fuentes.

Business Performance Management realiza la gestión y supervisión 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 gestión proactiva

de los negocios:

● Amplia implementación

● Toma de decisiones colaborativa

● Revisión y mejoras continuas y a tiempo real

● Control de los indicadores de rendimiento clave

IBM Cognos TM1 integra planificación del negocio, medida del rendimiento y datos operacionales

para permitir que las empresas puedan optimizar la efectividad de sus negocios y la interacción con

los clientes, independientemente de su geografía o estructura. TM1 proporciona visibilidad inmediata

de los datos, responsabilidad dentro de un proceso de colaboración y una visión de la información

coherente, permitiendo a los gerentes estabilizar rápidamente fluctuaciones operativas y aprovechar

las nuevas oportunidades.

Audiencia

La Guía de TurboIntegrator IBM Cognos TM1 está pensaba para los usuarios de TM1 con cono-

cimientos básicos sobre cómo están estructurados los datos para importar a TM1.

Búsqueda de información

Para buscar la documentación de producto más actual, incluida toda la documentación traducida,

acceda a uno de los centros de información 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 versión y las guías de instalación

de los productos directamente en los discos de los productos IBM Cognos.

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

Viaje de aventuras, Ventas de VA, cualquier variante del nombre de Viaje de aventuras, y Ejemplo

de planificación, 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, distribución de productos, finanzas y recursos

humanos. Cualquier parecido con nombres, direcciones, números de contacto o valores de transacción

reales es una mera coincidencia. Otros archivos de ejemplo pueden contener datos ficticios generados

manual o informáticamente, datos relativos a hechos procedentes de orígenes públicos o académicos,




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 refe-

rencia pueden ser marcas comerciales de sus respectivos propietarios. Queda prohibida la duplicación

no autorizada.

Funciones de accesibilidad

Este producto no admite actualmente funciones de accesibilidad que ayuden a los usuarios con

discapacidad física, como movilidad o visión limitada, a utilizar este producto.

8 IBM Cognos TM1

Introducción

Capítulo 1: Información básica de TurboIntegrator

Esta sección describe información básica sobre cómo importar datos a un cubo IBM® Cognos®

TM1® utilizando TurboIntegrator. TurboIntegrator le permite diseñar un proceso que reconozca

la estructura de datos de la fuente y la transforme en la estructura apropiada que necesita TM1.

Una vez diseñado el proceso TI, puede volver a ejecutarlo o programarlo para que se utiliza cuando

importe datos desde una fuente dinámica. Las secciones siguientes describen los pasos a seguir para

importar datos desde tipos específicos de fuentes.

Antes de empezar a utilizar TurboIntegrator, asegúrese de comprender esta información, que se

aplica a todos los tipos de fuentes:

● "Fuentes de datos disponibles con TurboIntegrator" (p. 9).

● "Límite de longitud de cadena en TurboIntegrator" (p. 9).

● "Importación 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 TurboIntegratorUtilizando 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 través 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 información acerca de estos tipos de

fuentes.

Límite de longitud de cadena en TurboIntegratorTurboIntegrator es capaz de tratar datos de cadena de un tamaño de hasta 8000 caracteres de un

byte de forma simultánea. Se aplica este límite cuando su proceso informático está realizando


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 líneas de datos desde un archivo de texto, cada línea 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.

Importación de opcionesCuando 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, permitiéndole cambiar los

datos y los metadatos durante la importación.

● Actualizar un cubo existente manteniendo su estructura. Le permite importar datos a una

estructura de cubo existente.

● Crear una dimensión en TM1 a partir de datos importados de una fuente.

● Actualizar una dimensión en TM1 a partir de datos importados.

Puede utilizar TurboIntegrator para realizar cualquier combinación de estas acciones.

Funciones de TurboIntegratorTurboIntegrator incluye una serie de funciones que le permiten manipular cubos, vistas, dimensiones,

elementos y otros objetos TM1® mientras importa datos.

Además de estas funciones de TurboIntegrator, puede incorporar todas las funciones de reglas TM1

estándar en un proceso TurboIntegrator, excepto la función STET.

Las funciones de TurboIntegrator se describen en “Funciones de TurboIntegrator TM1” en la Guía

de referencia de IBM Cognos TM1.

Procesos y tareasImporte datos con TurboIntegrator definiendo un proceso. Un proceso es un objeto TM1® que

consta de:

● Una descripción 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 relación entre variables y estructuras de datos en la

base de datos de TM1.

● Un procedimiento de Prólogo, que consiste en una serie de acciones que se deben ejecutar antes

de procesar la fuente de datos.

10 IBM Cognos TM1


● 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 Epílogo que se ejecutará tras procesar la fuente de datos.

● Un conjunto de parámetros que se pueden utilizar para generalizar un proceso, de manera que

se pueda utilizar en múltiples 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 más información, consulte “Edición de tareas y procedimientos avanza-

dos”.

Orden de operaciones en un proceso TurboIntegratorUn proceso TurboIntegrator incluye varios procedimientos: Prólogo, Metadatos, Datos y Epílogo.

Estos procedimientos se pueden ver como subpestañas de la pestaña 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 subpestaña de procedimiento correspondiente en el editor de TurboIntegrator. También puede

crear sus propios scripts en cualquiera de las subpestañas 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 Prólogo 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 pro-

cedimiento de Epílogo tras finalizar el proceso de Prólogo.

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 procedi-

mientos de Prólogo o Epílogo.

3. Si la fuente de datos es distinta de Ninguno, TurboIntegrator abre la fuente de datos del proceso.

4. Todas las líneas del procedimiento Metadatos se ejecutan de forma secuencial según el primer

registro de la fuente de datos. Todas las líneas se ejecutan de forma secuencial según el segundo

registro de la fuente de datos y así sucesivamente hasta que se han procesado todos los registros.

5. Todas las líneas del procedimiento de Datos se ejecutan de forma secuencial según el primer

registro de la fuente de datos. Todas las líneas se ejecutan de forma secuencial según 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 Epílogo.



8. TM1 cierra el proceso TurboIntegrator.

Apuntes sobre los procesos TurboIntegratorTenga en cuenta los siguientes elementos al crear y editar procesos TurboIntegrator.

● TurboIntegrator compila una dimensión nueva o alterada sólo al finalizar un procedimiento

en el que se crea o altera la dimensión.

En el caso de una dimensión nueva, significa que no puede acceder a la nueva dimensión (a

través de TurboIntegrator o de otro modo) hasta que el procedimiento en el que se ha creado

la dimensión haya terminado de procesar todos los registros de la fuente de datos. En el caso

de una dimensión alterada, significa que no puede acceder a ningún elemento nuevo de la

dimensión hasta que el procedimiento en el que se ha alterado la dimensión haya terminado

de procesarse.

● La funciones de reglas y TurboIntegrator (a excepción de STET) se pueden utilizar en cualquier

procedimiento de un proceso. Además, no hay restricciones respecto a qué funciones se pueden

utilizar en un procedimiento concreto, todas las funciones son válidas en cualquier procedimiento

de TurboIntegrator.

● Consulte "Fórmulas" en el capítulo Introducción a las reglas de IBMCognos TM1Rules Guide

para obtener más información sobre cómo utilizar diferentes tipos de operadores, como por

ejemplo, operadores lógicos y aritméticos de reglas y procesos TI.

Sin embargo, debe crear una secuencia lógica de funciones para asegurar que el proceso cumple su

objetivo. Por ejemplo, si desea construir un proceso que añada nuevos elementos a una dimensión

y actualice los valores de datos de los nuevos elementos, debe asegurarse de que el proceso añade

los nuevos elementos y compila la dimensión antes de intentar actualizar los valores de datos de

los elementos nuevos. En la mayoría de los casos, añadirá los elementos nuevos en el procedimiento

de Metadatos utilizando la función DimensionElementInsert, y a continuación actualizará los

valores en el procedimiento Datos utilizando la función CellPutN.

Utilizando el ejemplo anterior, si intenta construir un proceso en el que los dos elementos nuevos

se añadan 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 sólo al finalizar el procedimiento. Hasta que se haya compilado la dimensión, 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 simultáneas al mismo Servidor TM1.No lleve a cabo operaciones en un proceso TurboIntegrator que cree una nueva conexión al mismo

servidor TM1® en el que se está ejecutando el proceso. Este tipo de entorno puede provocar una

situación 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


● No utilice un proceso TI para enviar una consulta ODBO MDX (a través 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 estén a la espera de que el otro termine.

● No utilice la función 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 aplicación personalizada o cualquier aplicación de IBM

Cognos, como por ejemplo la utilidad ETLDAP de TM1, que podría volver a conectarse al

mismo servidor TM1.

Tenga en cuenta que al utilizar la función 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 básicamente no responde a la espera de que se termine de ejecutar el programa externo.

Alias en funciones de TurboIntegratorEn reglas o en funciones de TurboIntegrator es posible utilizar un nombre de alias en lugar del

nombre principal del elemento correspondiente.

Utilización de espacios de trabajo personales y modos de pruebacon procesos TurboIntegrator

Esta sección describe cómo utilizar espacios de trabajo personales y modos de prueba con funciones

y procesos TurboIntegrator.

Ejecución manual de un proceso TurboIntegrator con un espacio de trabajo per-sonal 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 eje-

cutarse sobre datos básicos.

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 botón derecho del ratón en el proceso, y haga clic en

Utilizar el modo de prueba activo para habilitar esta opción.

4. Haga clic con el botón derecho del ratón en el proceso y seleccione Ejecutar.



Se ejecutará el proceso utilizando el modo de prueba activo actual.

Utilización de las funciones de TurboIntegrator con modos de pruebaLas 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 más información, consulte la sección que trata sobre las funciones del modo de prueba

de TurboIntegrator en la Guía de referencia de IBM Cognos TM1.

14 IBM Cognos TM1


Capítulo 2: Importación de un archivo de texto

Esta sección describe cómo 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

importación desde otros tipos de datos varía levemente, esta sección describe los pasos comunes a

la mayoría 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.

Creación de una dimensión desde un archivo de textoPuede utilizar TurboIntegrator para crear una dimensión a partir de una lista de nombres de ele-

mentos de una fuente de datos. Ésta es la forma más rápida de crear una dimensión que contenga

cientos o miles de elementos.

Al crear una dimensión 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 petición

o en un intervalo programado.

Para crear una dimensión con TurboIntegrator:

❑ Defina la fuente de datos para TM1. Consulte "Definición de una fuente datos" (p. 15).

❑ Identifique las variables que TM1 encontrará. Consulte "Identificación de variables en la fuente

de datos" (p. 17).

❑ Asigne las variables a sus tipos de datos. Consulte "Asignación de variables" (p. 20).

❑ Guarde el proceso y ejecútelo. Consulte "Guardar y ejecutar el proceso TurboIntegrator" (p. 22).

Definición de una fuente datosSiempre 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 botón derecho del ratón en Procesos en el panel izquierdo de Server Explorer

y seleccione Procesos, Crear nuevo proceso.

2. Haga clic en Texto en la pestaña Fuente de datos.

Se abrirá la ventana TurboIntegrator.

3. Haga clic en Examinar.

Se abrirá el cuadro de diálogo Seleccionar archivo de entrada.

4. Desplácese hasta NewEngland.cma, selecciónelo y haga clic en Abrir.


NewEngland.cma está disponible en el directorio de datos de muestra PData o SData. Si aceptó

el directorio de instalación 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 debería utilizar la Convención de nomenclatura

universal (UNC) para especificar la ubicación del archivo. Si va a ejecutar sistemáticamente el

proceso con un archivo ASCII debería utilizar UNC y asegurarse de lo siguiente:

● Si trabaja con un servidor TM1 de Windows®, el archivo ASCII debería 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 debería 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 mayúsculas ni espacios.

5. Haga clic en Aceptar en el cuadro de advertencia.

6. Complete el cuadro de diálogo TI de la forma siguiente:

NewEngland.cma es una fuente delimitada que utiliza comas como delimitador; comillas dobles

como carácter de comillas; sin registros de título; la coma como separador decimal y el punto

como separador de millares.

Para definir esta fuente introduzca la configuración siguiente:

● En Tipo de delimitador, seleccione Delimitado.

● Seleccione Coma como el Delimitador.

● Introduzca " en Carácter de comillas.

● Deje en blanco el campo Número de registros de títulos.

● 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 también 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

ubicación de su archivo de fuente de datos, seleccione el Tipo de delimitador de Ancho fijo y, a

continuación, haga clic en Establecer el ancho de campo.

El cuadro de diálogo Previsualización de datos muestra los tres primeros registros de sus datos de

origen. Para establecer anchos de campo según 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 línea en el encabezado de la columna y se extiende a los tres registros.

2. Haga clic en el salto de línea y arrástrelo a la posición 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 línea a la posición que

separa la segunda columna de la tercera.

4. Establezca saltos de línea para el resto de columnas de la fuente de texto.

5. Haga clic en Aceptar para volver a la ventana TurboIntegrator.

Identificación de variables en la fuente de datosTras 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.



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 jerarquía para la dimensión Location, que construirá a partir

del archivo de texto fuente.

● La nueva consolidación New England se encuentra en la parte más alta de la jerarquía.

● 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 más bajo de la jerarquía.

● Las columnas restantes no se utilizan para la creación de la dimensión Location.

Aquí se incluye la pestaña 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 práctica

recomendada es asignar a las variables un nombre significativo. Los nombres significativos facilitan

la lectura y la resolución 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:

Nombre de la variableValor de ejemplo

RegiónNew England

EstadoMassachusetts

18 IBM Cognos TM1


Nombre de la variableValor de ejemplo

CiudadBoston

Los nombres de variable deben empezar con una letra y pueden contener únicamente estos caracteres:

DescripciónCarácter

De la A a la ZLetras en mayúscula

De la a a la zLetras en minúscula

De 0 a 9Dígitos

.Period

_Subrayado

$Símbolo de dólar

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 precisión para datos ASCII,

pero no para datos extraídos de una fuente de datos ODBC.

El campo Contenido puede definirse con uno de estos parámetros:

DescripciónOpción

Ignorar el contenido de la columna al procesar la fuente de datos.Ignorar

La columna contiene elementos simples para la dimensión que desea crear.Elemento

La columna contiene elementos consolidados para la dimensión que desea crear.Consolidación

La columna contiene valores de datos.Datos

Para este ejemplo debería ignorar la columna que contiene los valores de datos. Las columnas

que contienen valores de datos no se importan al crear una dimensión.

La columna contiene atributos de elemento para la dimensión que desea crear.Atributo

La columna contiene datos que no se incluyen en ninguna de las cuatro categorías anteriores.

Habitualmente, se utiliza esta configuración para las columnas que contienen datos que se

procesarán mediante fórmulas y variables personalizadas.

Otros



Los datos de texto de este ejemplo contienen elementos y consolidaciones para una dimensión

Location.:

● No contiene ningún atributo.

● Contiene valores de datos pero no son relevantes para la creación de la dimensión Location,

ya que son elementos de otras dimensiones.

Para definir las variables de la dimensión Location:

Pasos

1. Haga clic en la pestaña Variables de la ventana TurboIntegrator.

2. Establezca el campo Contenido para las variables Region, State y City tal y como se especifica

aquí:

ContenidoVariable

ConsolidaciónRegión

ConsolidaciónEstado

ElementoCiudad

● La variable Region se ha identificado ahora como una consolidación

● La variable State se ha identificado también como una consolidación

● La variable Ciudad se ha identificado como elemento a nivel de hoja (no consolidado).

Asignación de variablesTras identificar las variables de su fuente de datos, deberá asignarlas a elementos y consolidaciones.

Para comenzar a asignar variables, haga clic en la pestaña Asignaciones de la ventana TurboInte-

grator.

La pestaña Asignaciones contiene varias pestañas adicionales. La pestaña Cubo siempre está dispo-

nible. El resto de pestañas se habilitan según el contenido de la columna que definió en la pestaña

Variables. Por ejemplo, si identifica una columna como que contiene elementos, estará disponible

la pestaña Dimensión. Si identifica una columna como que contiene consolidaciones, se habilitará

la pestaña Consolidaciones y así sucesivamente.

Desactivar la asignación de cubo

No debería realizar acciones de cubo al crear una dimensión. Para evitar la asignación de cubos:

Pasos

1. Haga clic en la pestaña Cubo.

2. Seleccione Ninguna acción en el cuadro Acción de cubo.

20 IBM Cognos TM1


Asignación de dimensiones

Si identifica todas las columnas de su fuente de datos como que contienen elementos, deberá asignar

tales elementos a la dimensión que está creando:

Pasos

1. Haga clic en la pestaña Dimensiones.

2. Escriba Ubicación en el campo Dimensión.

Si se asignan varios elementos a la misma dimensión, escriba el nombre de la dimensión para

cada elemento.

Cuando introduce un nuevo nombre de dimensión en la columna Dimensión, la columna Acción

aparecerá por defecto como Crear.

Si introduce el nombre de una dimensión existente, tendrá la opción de volver a crear o actua-

lizar la dimensión. Si selecciona la acción Recrear, se borrarán los elementos de la dimensión

existente y se sustituirán por los datos de la fuente de datos. Si selecciona la acción Actualizar,

se actualizará la dimensión 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 parámetro es casi siempre

Numérico.

4. Seleccione una opción de Orden de elementos. El orden de elementos determina cómo se aña-

dirán los elementos a la dimensión durante el proceso.

Los datos de este ejemplo contienen un solo elemento numérico que se asigna a una nueva

dimensión Location. Se muestra la pestaña Dimensiones completada, como se indica a conti-

nuación.

Desactivar la asignación de datos

No debería realizar ninguna asignación de datos al crear una dimensión. Dado que se especificó

Ninguna acción en la pestaña Asignación de cubo ("Desactivar la asignación de cubo" (p. 20)),

esta pestaña Datos pasa a ser no disponible.

Asignación de consolidaciones

Si identifica todas las columnas de su fuente de datos como que contienen consolidaciones, deberá

asignar tales rutas de consolidación a la dimensión que está creando:

Pasos

1. Haga clic en la pestaña Consolidaciones.

La pestaña muestra las variables definidas como consolidaciones, Region y State.

Puede definir la jerarquía de consolidación de la dimensión especificando la variable de hijo de

cada variable de consolidación.



2. El hijo inmediato de la variable de consolidación Región es Estado. Haga clic en el botón de

paréntesis angular derecho del campo Variable de hijo para obtener la consolidación de

Region, seleccione Estado y haga clic en Aceptar.

3. El hijo inmediato de la variable de consolidación Estado es Ciudad. Haga clic en el botón de

paréntesis angular derecho del campo Variable de hijo para obtener la consolidación de

State, seleccione Ciudad y haga clic en Aceptar.

4. Para cada consolidación, haga clic en el botón Orden de componentes. Se abrirá el cuadro de

diálogo Ordenación de elementos del componente.

5. Haga clic en Automático, Nombre y Ascendente.

Nota: al configurar varias consolidaciones dentro de la misma dimensión, debe establecer todas

las consolidaciones con los mismos parámetros de Ordenación de elementos del componente.

Si estableció dos consolidaciones en la misma dimensión con diferentes parámetros de Ordena-

ción de elementos del componente, TurboIntegrator produce un error de Discordancia de

información de ordenación cuando intenta guardar y ejecutar el proceso.

Guardar y ejecutar el proceso TurboIntegratorTras definir una fuente de datos y configurar las variables, se compila y se guarda el proceso Tur-

boIntegrator. Para crear la dimensión, ejecute el proceso completado.

Pasos

1. Haga clic en Archivo, Guardar en la barra de menú de TurboIntegrator.

Se abrirá el cuadro de diálogo Guardar proceso como.

2. Introduzca un nombre para el proceso y haga clic en Guardar.

Si TM1® encuentra un error durante la compilación 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 ejecución o modificación.

Para ejecutar el proceso y crear la dimensión, haga clic en Archivo, Ejecutar en la barra de

menú de TurboIntegrator. También 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 envía un mensaje de confirmación.

Si TM1 no puede ejecutar el proceso, un cuadro de diálogo detallará los errores que se han

encontrado durante la ejecución.

Al procesar NewEngland.cma, se crea una nueva dimensión Location.

22 IBM Cognos TM1


Creación de un cubo desde un archivo de textoTurboIntegrator también puede crear un cubo completo a partir de un archivo de texto. Este pro-

cedimiento construye también algunas dimensiones y elementos y realiza alguna manipulación de

datos.

El procedimiento para construir un cubo es similar al proceso de creación de una dimensión:

❑ Defina la fuente de datos para TM1®. Consulte "Definición de la fuente de datos del

cubo" (p. 23).

❑ Identifique las variables que TM1 encontrará. Consulte "Definición de variables de

cubo" (p. 24).

❑ Asigne las diferentes variables a sus tipos de datos en el cubo resultante. Consulte "Asignación

de variables de cubo" (p. 24), "Asignación de variables de elemento de cubo a dimensio-

nes" (p. 25). "Asignación de variables de datos de cubo" (p. 25) y "Asignación de variables

de consolidación" (p. 25).

❑ Guarde el proceso y ejecútelo. 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 lla-

mado import_cube.csv. Este ejemplo describe cómo construir un cubo TM1 a partir de

import_cube.csv.

Definición de la fuente de datos del cuboEl 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 botón derecho del ratón en el icono

Procesos y seleccione Crear nuevo proceso.

2. Haga clic en la pestaña Fuente de datos de la ventana TurboIntegrator.

3. Seleccione Texto como el Tipo de fuente de datos.

4. Haga clic en el botón 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 instalación prede-

terminado, 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 Número de registros de título para este ejemplo.

6. Asegúrese 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

información que se importará a TM1® como nombres de elemento. La sexta columna contiene

datos del cubo.



Definición de variables de cuboTras identificar los datos de origen en TurboIntegrator, debe identificar el contenido de cada campo

de la fuente.

Pasos

1. Haga clic en la pestaña 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 deberían identificarse como Elemento. V6

debería identificarse como Datos.

Asignación de variables de cuboHa 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 pestaña Mapas.

2. Haga clic en la pestaña Cubo.

3. SeleccioneCrear para la Acción de cubo.

4. Escriba import_cube en el campo Nombre de cubo.

5. Seleccione Almacenar valores para la Acción de datos.

6. No habilite la opción 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


Asignación de variables de elemento de cubo a dimensionesAsignar todas las variables que identificó que contienen un tipo de Elemento para las dimensiones

apropiadas.

Pasos

1. Haga clic en la pestaña Dimensiones.

2. Defina valores en la pestaña Dimensiones según la tabla siguiente.

Orden en el cuboDimensiónValor de ejemploVariable de elemento

1actvsbud2RealReal

2region2ArgentinaArgentina

3model2S Series 1.8 L SedanV3

4measuresUnidadesUnidades

5month2EnEn

3. Para todas las variables de elemento, defina la Acción como Crear y el Tipo de elemento como

Numérico

Asignación de variables de datos de cuboPara este ejemplo, existe solo una variable de datos: V6. No necesita asignar esta variable de datos.

TurboIntegrator lo hace automáticamente. La pestaña de datos ni siquiera está habilitada en este

ejemplo.

TurboIntegrator añade los datos al cubo en la intersección de las dimensiones creadas. Si hubiera

2 o más variables definidas como datos en la pestaña Variables, tendría que especificar información

de dónde se deberían añadir en el cubo.

Para obtener un ejemplo más detallado de asignación de valores de datos en un cubo, consulte el

“TurboIntegrator Tutorial”.

Asignación de variables de consolidaciónNinguna variable de este ejemplo está definida como consolidación en la pestaña Variables. La

pestaña Consolidación no está habilitada en este ejemplo.

Para obtener un ejemplo más detallado de asignación de consolidaciones en un cubo, consulte el

“TurboIntegrator Tutorial”.



Guardar y ejecutar el proceso de cuboPara guardar y ejecutar el proceso:

Pasos

1. Haga clic en el botón Ejecutar.

TM1® le solicitará que asigne un nombre al proceso y que lo guarde.

2. Guarde el proceso como create_newcube.

Tras unos segundos, debería aparecer un mensaje confirmando que el proceso se ha ejecutado

con éxito.

3. Abra Server Explorer. Debería comprobar si se ha creado y llenado el cubo import_cube y si

se hayan creado todas las dimensiones necesarias.

26 IBM Cognos TM1


Capítulo 3: Importación desde una fuente ODBC

A través 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 dimensión

a partir de datos relacionales son los mismos que para crear un cubo o una dimensión a partir de

un archivo de texto. Para obtener un tutorial detallado por pasos sobre cómo crear objetos en

TurboIntegrator utilizando una fuente ODBC, consulte “TurboIntegrator Tutorial”.

Unicode y DSNAl configurar el DSN para importar datos Unicode de una base de datos Oracle a través del cliente

versión 11g o el controlador ODBC, asegúrese de especificar la opción Activar cierre de cursores

en la ficha Aplicación. Los procesos de TI pueden producir un error si no se especifica esta opción.

El controlador ODBC 11g de Oracle no admite la opción SQL_CLOSE de SqlFreeStmt.

Definición de una fuente de datos ODBCPara definir una fuente de datos ODBC:

Pasos

1. Abra Server Explorer.

2. Haga clic con el botón derecho del ratón en el icono Procesos que se encuentra bajo el servidor

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


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 contraseña válidos para

la base de datos de destino en los campos UserName y Contraseña.

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


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 continuación, copiar la instrucción 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.


Si la consulta era válida y la conexión se definió correctamente, aparecerán los diez primeros

registros de la base de datos de destino en la ventana de TurboIntegrator.

Consulte “Identificación de variables en la fuente de datos” para ver los pasos utilizados para

definir variables ODBC.

Consulte “Asignación de variables” para obtener instrucciones sobre las instrucciones de asig-

nación ODBC.

Consulte “Guardar y ejecutar el proceso TurboIntegrator” para obtener más detalles sobre

guardar y ejecutar un proceso TurboIntegrator.

Generación de un proceso TurboIntegrator a partir de una ins-trucción MDX

Esta sección describe cómo extraer datos de una fuente de datos ODBO utilizando una instrucción

MDX e importar los datos a TM1.

Se recomienda generar una instrucción MDX utilizando otra utilidad, para posteriormente utilizar

la instrucción MDX que está en funcionamiento como la base para su importación de datos a TM1.

Cuando importa datos a TM1, es importante empezar con una instrucción MDX que tenga un

número limitado de columnas. Algunas instrucciones MDX generan un gran número de columnas.

Este tipo de consultas no son prácticas como punto de partida para una importación.

Un método para limitar el número de columnas es colocar en las columnas sólo las medidas que le

interesan.

Construcción del proceso MDX de TurboIntegratorUna vez que tenga una instrucción MDX que devuelva datos útiles, puede construir su proceso

TurboIntegrator.

Para comenzar, realice estos pasos:

Pasos

1. En Server Explorer, haga clic con el botón derecho del ratón 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 parámetros de conexión necesarios en la pestaña de Conexión de la ventana

TurboIntegrator. Los parámetros de conexión son específicos de cada proveedor.

28 IBM Cognos TM1


4. Haga clic en Conectar. Si se conecta correctamente, el botón de conexión se vuelve de color

gris y puede acceder a la pestaña Consulta MDX.

5. Haga clic en la pestaña Consulta MDX.

6. Escriba su consulta MDX en esta pestaña. También puede cortar una consulta MDX que esté

en funcionamiento desde otra aplicación y pegarla en esta pestaña.

7. Haga clic en la pestaña Variables. Para cada columna generada por la instrucción MDX, Tur-

boIntegrator genera una variable.

Las columnas que contienen encabezados de fila se asignan normalmente como elementos de

dimensión. Las columnas que contienen elementos de datos se asignan como datos.

8. Consulte “Asignación de variables” para asignar las variables a estructuras TM1. Una vez que

se haya conectado a la fuente de datos ODBO y definido la instrucción MDX, el proceso para

completar el proceso TurboIntegrator es idéntico al de una importación de datos ODBC.



30 IBM Cognos TM1


Capítulo 4: Importación desde un subconjunto ovista 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é específicamente diseñada para su

importación.

No todas las vistas de cubo TM1 se pueden importar correctamente. Al construir una vista con

ciertos parámetros desde dentro de TurboIntegrator, su importación siempre funcionará correcta-

mente.

Utilización de una vista de cubo TM1 como fuente de datosPara 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 continuación, siga los procedimientos descritos

en "Importación de un archivo de texto".

Crear un proceso de cuboPara crear un proceso que utilice una vista de cubo como fuente de datos:

Pasos

1. Haga clic con el botón derecho del ratón 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. TurboInte-

grator 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 diálogo 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, selecciónela.

Si esa vista no existe, haga clic en Crear vista para abrir la ventana Extracción de vistas y cree

la vista. Tras crear la vista, selecciónela en el cuadro de diálogo 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 TurboInte-

grator.


Continúe con los pasos descritos en "Importación de un archivo de texto" para completar la

importación a su vista TM1.®.

Utilización de un subconjunto TM1 como fuente de datosTurboIntegrator le permite extraer datos de un subconjunto de una dimensión TM1® y mover esa

información a otro objeto TM1. En el siguiente ejemplo, la consolidación Europe de la dimensión

Region se extrae y se utiliza para formar una nueva dimensión llamada Region_Europe.

Cuando está extrayendo información de un subconjunto de dimensión, el objeto de destino es

normalmente otra dimensión. No puede construir un cubo a partir de información extraída de un

subconjunto de dimensión.

El procedimiento para extraer datos utilizando un Subconjunto TM1 es similar a otro proceso

TurboIntegrator. Consulte "Definir subconjunto de dimensión como fuente de datos" (p. 32) para

comenzar.

Definir subconjunto de dimensión como fuente de datosSiga estos pasos para crear un proceso que utilice un subconjunto de dimensión como fuente de

datos:

Pasos

1. Haga clic con el botón derecho del ratón en Procesos en Server Explorer y seleccione Crear

nuevo proceso.

2. Haga clic en TM1 y seleccione Subconjunto de dimensión 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 diálogo Examinar subconjuntos del servidor.

4. Seleccione la dimensión que contiene los elementos que desea importar.

5. Seleccione el subconjunto que desea utilizar como una fuente de datos y haga clic en Aceptar.


Los elementos del subconjunto de dimensión seleccionado aparecen en el panel de previsualiza-

ción.

Definir variables de dimensiónConsulte "Definición de variables de cubo" para obtener detalles sobre cómo identificar y definir

variables en TurboIntegrator.

La siguiente imagen muestra la pestaña Variables con la variable de región identificada como ele-

mento.

32 IBM Cognos TM1

Capítulo 4: Importación desde un subconjunto o vista TM1

En este ejemplo, los elementos extraídos de la fuente de datos del subconjunto se añadirán como

hijos de una consolidación de nivel superior llamada All Europe. Para construir una nueva consoli-

dación siga estos pasos:

Pasos

1. Haga clic en Nueva variable.

Se muestra la variable V2 en la pestaña Variables.

2. Haga clic en Fórmula.

Se abrirá el cuadro de diálogo Fórmula de variables del proceso.

3. Modifique la fórmula de la siguiente manera:

V2='All Europe';


5. Cambie el Tipo de variable de V2 a Cadena.

6. Cambie el parámetro Contenido de V2 a Consolidación.

En la siguiente sección, los elementos importados de la fuente de datos de subconjunto se añaden

a la consolidación All Europe.

Asignación de variables de dimensiónConsulte "Asignación de variables" para obtener detalles del procedimiento para asignar datos

importados a objetos TM1®.

En este ejemplo, debe configurar las pestañas Cubo, Dimensiones y Consolidaciones para crear una

nueva dimensión llamada Europe. Europe tiene una sola consolidación llamada All Europe.

Configuración de la pestaña Cubo

Configure las siguientes opciones en la pestaña Cubo:

OpciónTipo de acción

Ninguna acciónAcción de cubo

Almacenar valoresAcción de datos

Configuración de la pestaña Dimensiones

La ficha Dimensiones le permite asignar los datos entrantes a dimensiones TM1®. En este ejemplo

solo se crea una dimensión llamada Europe. Configure las siguientes opciones en la pestaña

Dimensiones:



OpciónNombre de opción

EuropeVariable de elemento

RegiónDimensión

CrearAcción

NuméricoTipo de elemento

Configuración de la pestaña Consolidaciones

La variable All Europe que añadió anteriormente debería aparecer en la pestaña Consolidaciones.

Tenga en cuenta que el Valor de ejemplo tiene el valor que estableció en la fórmula. Como el proceso

contiene solo dos variables, TM1® identifica correctamente la variable de región como hijo de la

variable V2. No es necesario modificar los parámetros de la pestaña de Consolidaciones.

Guardar y ejecutar la dimensiónConsulte "Guardar y ejecutar el proceso TurboIntegrator" para obtener detalles sobre cómo guardar

y ejecutar un proceso TurboIntegrator.

Tras guardar y ejecutar el proceso, TM1® crea una nueva dimensión llamada Europe con una única

consolidación llamada All Europe, que contiene elementos de hoja para todos los países europeos.

34 IBM Cognos TM1


Capítulo 5: Importación 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 sección

muestra cómo utilizar TurboIntegrator para importar cubos y dimensiones desde Microsoft

Analysis Services.

Base de datos OLE para fuentes de datos OLAPUna base de datos OLE para fuente de datos OLAP se identifica mediante los siguientes parámetros:

● Nombre del proveedor ODBO

● Ubicación de ODBO

● Fuente de datos ODBO

● Catálogo 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.

Ubicación de ODBOEl campo de ubicación es el nombre la ubicación donde un administrador asigna una instancia

determinada del servicio proveedor de ODBO.

La interpretación exacta de este campo es específica del vendedor.

Fuente de datos ODBOÉste es el nombre que asigna su administrador a un conjunto de catálogos de una ubicación deter-

minada. En Microsoft® Analysis Services, éste es el nombre de un servidor registrado.

Catálogo ODBCÉste es el nombre asignado por su administrador a una colección determinada de bases de datos

(cubos, dimensiones y otros objetos). Para Microsoft® Analysis Services, éste es el nombre de la

base de datos.


Cadenas de conexión: MSAS frente a TM1La base de datos OLE de TM1® para el proveedor OLAP ha sido modificada para proporcionar

más flexibilidad a la hora de que los programadores construyan cadenas de conexión. Esto se hizo

para hacer compatibles las cadenas de conexión TM1 con cadenas de conexión MSAS.

En versiones anteriores de TM1, la conexión a través de proveedor de bases de datos OLE de TM1

requería los siguientes campos:

Configuración de ejemploCampo

MyServerLocation

El nombre del equipo del host del Servidor de administración TM1.

SdataFuente de datos

El nombre del servidor TM1.

AdminuserID

El nombre de usuario de TM1.

Applepassword

La contraseña para el usuario de TM1.

Puede utilizar los parámetros que se describen anteriormente, o puede conectarse a TM1 utilizando

los parámetros de la tabla siguiente. Estos parámetros se utilizan también para conectarse a

Microsoft® Analysis Services desde TurboIntegrator.

Configuración de ejemploCampo

MyServerFuente de datos

El nombre del equipo del host del Servidor de administración TM1.

SdataCatalog

El nombre del servidor TM1.

AdminuserID

El nombre de usuario de TM1.

Applepassword

La contraseña para el usuario de TM1.

36 IBM Cognos TM1


Conexión a una base de datos OLE para fuente de datos OLAP cuando utilizaautenticación CAM

Si su servidor TM1® está configurado para utilizar autenticación de Cognos Access Manager (CAM),

debe especificar el ID de espacio de nombres CAM utilizado por el servidor TM1 cuando establece

una conexión a una fuente de datos ODBO.

Si trabaja con una versión de 32 bits del servidor TM1, puede especificar el espacio de nombres

CAM en la sección de Parámetros de conexión adicionales de la pestaña Conexión de TurboInte-

grator. 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 versión de 64 bits del servidor TM1, debe especificar el ID de espacio de nombres

CAM mediante una cadena de conexión, utilizando el mismo formato que se indica anteriormente.

Por ejemplo, la siguiente cadena de conexión 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 conexión.

Importación de un cubo MASEste procedimiento describe cómo importar un cubo de datos simple de Microsoft® Analysis Services

a TM1®. Por ejemplo, la siguiente tabla es una representación de un cubo, tal y como se ve en

Analysis Services:

Explorador de cubos: ventas

All store2store2

All timetime

MeasuresLevel

Store CostStore SalesPaís+

48,101.77120.160.84All customer

3,851.549.628.88Canadá+

19,488.7348,622.07México+

24,761.4961,909.89EE.UU.+



Este cubo tiene cuatro dimensiones: time, store2, customer y measures.

Para importar un cubo a TM1 desde Microsoft Analysis Services:

❑ Establezca la conexión a la fuente de datos MAS. Consulte "Conexión a Analysis Services con

TurboIntegrator" (p. 38).

❑ Especifique qué cubo va a importar. Consulte "Especificar el cubo con la pestaña Cargar cubo

ODBC" (p. 39).

❑ Defina las dimensiones. Consulte "Uso de la pestaña Dimensiones de cubo" (p. 40).

❑ Guarde el proceso y ejecútelo. Consulte "Guardar y ejecutar el proceso MAS" (p. 40).

Conexión a Analysis Services con TurboIntegratorUtilice TurboIntegrator para crear un proceso que se conecta a Microsoft® Analysis Services.

Pasos

1. Ejecute TM1® Architect y conéctese utilizando un nombre de usuario y contraseña válidos.

2. Haga clic con el botón derecho del ratón en Procesos y seleccione Crear nuevo proceso.

Se abrirá el cuadro de diálogo TurboIntegrator.

3. Haga clic en la opción ODBO y, a continuación, seleccione Cubo.

El cuadro de diálogo muestra las opciones que le permiten crear una cadena de conexión ODBO.

4. Introduzca parámetros de conexión en el cuadro de diálogo de la siguiente manera:

ValorCampo

Elija Proveedor de base de datos Microsoft OLE de OLAP Services.Proveedor de ODBO

Deje este parámetro en blanco.Ubicación de ODBO

Introduzca el nombre del equipo del servidor que alberga Analysis

Services.

Fuente de datos

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 en este campo.

Catálogo ODBO

Introduzca un nombre de usuario válido para la base de datos de

Analysis Services.

ID de usuario de

ODBO

Introduzca una contraseña válida para este nombre de usuario para

la base de datos de Analysis Services.

Contraseña de ODBO

38 IBM Cognos TM1


ValorCampo

Algunos servidores de ODBO podrían requerir parámetros adicionales

para conectarse correctamente. Introduzca esos parámetros en este

campo, separados por punto y coma.

Parámetros de cone-

xión adicionales

5. Haga clic en Conectar. Si se conecta correctamente, el botón Conectar se vuelve de color gris

y puede acceder a la pestaña Cargar cubo ODBO.

Especificar el cubo con la pestaña Cargar cubo ODBCLa pestaña Cargar cubo ODBO le permite especificar qué cubo va a importar desde Analysis Services,

además de otra información. Siga los siguientes pasos para completar esta pestaña.

Pasos

1. Haga clic en la pestaña Cargar cubo ODBO.

2. Elija una acción de cubo. Estas opciones se describen en la tabla siguiente:

DescripciónOpción

Copia datos y metadatos desde la fuente de datos ODBC y crea un nuevo

cubo en TM1®. Utilice esta opción únicamente cuando no exista en el servidor

TM1 ninguno de los cubos y dimensiones que está importando.

Crear cubo

Destruye un cubo TM1 existente y lo reconstruye utilizando datos y metada-

tos de la fuente de datos ODBO. Utilice esta opción solo cuando existan las

dimensiones y cubos TM1 y desee sustituirlos por datos y estructuras nuevas.

Recrear cubo

Copia datos de un cubo ODBO existente y los inserta en un cubo TM1

existente. Esta opción no cambia la estructura de los cubos y dimensiones

en el servidor TM1.

Actualizar cubo

El valor por defecto para la pantalla. Los procesos que especifican Ninguna

acción no afectan a los datos o metadatos del cubo. Utilice está opción para

probar y depurar procesos, o para definir sus propias operaciones personali-

zadas.

Ninguna acción

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.



5. El en panel Acción de datos, elija Almacenar valores. Esta opción escribe valores de celda del

cubo ODBO en el cubo TM1. La opción Acumular valores le permite agregar valores según se

van importando.

Uso de la pestaña Dimensiones de cuboLa pestaña 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 dimensión [customer] de Analysis Services, la dimensión

correspondiente de TM1 se llama Customer_.

Este cuadro de diálogo presenta las opciones siguientes:

● Puede elegir asignar una dimensión ODBO a una dimensión existente en TM1. Para hacerlo,

haga clic en cualquier dimensión de la columna Dimensión TM1 y elija otra dimensión TM1.

● También puede importar los elementos de la dimensión ODBO a una dimensión TM1 totalmente

nueva. Haga clic en la celda correspondiente bajo la columna Dimensión TM1, a continuación

escriba el nombre de la nueva dimensión. Por ejemplo, sustituya la dimensión customer_ por

una dimensión llamada MyCustomerDim.

● Para cada dimensión importada debe elegir una Acción de dimensión TM1. Seleccione una de

las siguientes opciones:

DescripciónOpción

Importa datos de la dimensión desde el cubo ODBO y crea una nueva

dimensión en TM1 con el conjunto completo de elementos de la dimensión.

Ésta es la acción predeterminada.

Crear

Importa datos de la dimensión desde el cubo ODBO y crea una nueva

dimensión en TM1 con un conjunto limitado de elementos.

Solo filtro:

MDX

No importar esta dimensión desde la fuente de datos ODBO.Ninguna

acción

Guardar y ejecutar el proceso MASUna vez que haya finalizado sus cambios en la pestaña Dimensiones de cubo, haga clic en para

guardar y ejecutar el proceso.


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® debería importar sus datos y crear el nuevo cubo. Aparecerá un cuadro de diálogo para

mostrar el progreso de la importación.

40 IBM Cognos TM1


Importación de una dimensión MASEsta sección describe cómo importar una dimensión de Microsoft® Analysis Services a TM1®. La

siguiente tabla es una representación de la dimensión, tal y como se ve en Analysis Services.

Miembros de dimensión

All store2O-

CanadáO+

MéxicoO-

DFO+

GuerreroO+

JaliscoO+

VeracruzO+

YucatánO+

ZacatecasO+

EE.UU.O-

CAO+

OO+

WAO+

TM1 requiere que todos los elementos de una dimensión tengan nombre exclusivos. TM1 también

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 consolidación y elemento de una

dimensión importada con los nombres de todos sus padres entre corchetes, separados por puntos.

La siguiente imagen muestra la dimensión de almacén después de haberla importado a TM1.



Tras la importación, 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 importación.

Definición de parámetros de conexión MASEl primer paso para importar una dimensión de Analysis Services a TM1® es conectarse a Analysis

Services y elegir la opción Dimensión ODBO. Siga estos pasos:

Pasos

1. Ejecute TM1 Architect y conéctese utilizando un nombre de usuario y contraseña válidos.

2. Haga clic con el botón derecho del ratón en Procesos y seleccione Crear nuevo proceso.

Se abrirá el cuadro de diálogo TurboIntegrator.

3. Haga clic en la opción ODBO y, a continuación, seleccione Dimensión.

4. Introduzca parámetros de conexión en el cuadro de diálogo de la siguiente manera:

ValorCampo

Elija Proveedor de base de datos Microsoft OLE de OLAP Services.Proveedor de ODBO

Deje este parámetro en blanco.Ubicación de ODBO

Introduzca el nombre del equipo del servidor que alberga Analysis

Services.

Fuente de datos 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.

Catálogo ODBO

Introduzca un nombre de usuario válido para la base de datos de

Analysis Services.

ID de usuario de ODBO

42 IBM Cognos TM1


ValorCampo

Introduzca una contraseña válida para este usuario para la base de

datos de Analysis Services.

Contraseña de ODBO

Deje este campo en blanco.Parámetros de conexión

adicionales

5. Haga clic en Conectar. El botón de conexión debería volverse gris, indicando así que se ha

conectado correctamente.

Uso de la pestaña Cargar dimensión de ODBOUna vez que se ha conectado correctamente a Analysis Services, debería especificar información

sobre las dimensiones fuente y de destino para el proceso de carga de su dimensión. Siga estos pasos:

Pasos

1. Haga clic en la pestaña Cargar dimensión de ODBO.

2. Elija una Acción de dimensión TM1. Seleccione una de las siguientes opciones:

DescripciónOpción

Copia una dimensión de la fuente de datos ODBO y crea una nueva dimensión

en TM1®.

Crear dimen-

sión

Destruye una dimensión TM1 existente y la reconstruye utilizando datos de la

fuente de datos ODBO.

Recrear

dimensión

Actualizar dimensión asume que TM1 ya tiene una dimensión en la que desea

insertar o borrar elementos.

Actualizar

dimensión

● Si los elementos existen en la fuente de datos ODBO pero no en TM1, se

añaden los elementos a la dimensión TM1.

● Si los elementos existen en TM1 pero no en la fuente de datos ODBO, la

importación no afectará a esos elementos. No se realizan cambios en los

elementos de la dimensión local.

● Si los elementos existen en la fuente de datos ODBO y en la dimensión

local, se importan los elementos de la fuente de datos ODBO, y se crean

en la dimensión local como <element_name>_1. Tenga en cuenta que así

aumentará el tamaño de la dimensión.

El valor por defecto para la pantalla. Este proceso no afecta a la dimensión

TM1.

Ninguna

acción



3. Haga clic en la lista Cubo ODBO que incluye la dimensión y elija el cubo que contiene la

dimensión que desea importar desde Analysis Services.

4. Haga clic en la lista Dimensiones del cubo y elija la dimensión que desea importar.

5. Si está actualizando o recreando una dimensión, haga clic en la lista TM1 Dimensión para

cargar y seleccione una dimensión de la lista.

Si está creando una dimensión nueva, escriba el nombre de su nueva dimensión en el campo

TM1 Dimensión para cargar.

Guardar y ejecutar el proceso MAS de la dimensiónUna vez que haya finalizado sus cambios en la pestaña Cargar dimensión ODBO, haga clic en

para guardar y ejecutar el proceso.


Indique el nombre del nuevo proceso y, a continuación, haga clic en Guardar. Comienza la impor-

tación y TM1® muestra un cuadro de diálogo que indica el estado de la importación.

Registro de mensajes de TM1Cuando finaliza el proceso, los errores leves podrían 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 botón derecho del ratón

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


Capítulo 6: Importación de datos utilizando TM1Connector for SAP Business Warehouse

IBM® Cognos® TM1® TurboIntegrator le permite importar datos desde BW SAP utilizando Llamadas

de función remota (RFC). Esta sección describe los objetos SAP que puede importar a TM1 a través

de TM1 Connector for SAP, y los procedimientos para importarlos. También describe cómo volver

a escribir datos TM1 en SAP a través de tablas ODS.

Nota: el acceso de TurboIntegrator a datos SAP se debe utilizar en conformidad con su licencia

SAP.

Objetos SAP y terminologíaAntes 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 sección explica la

información que necesita saber antes de importar datos desde BW SAP.

Objetos análogos en SAP y TM1La siguiente tabla enumera la jerarquía de objetos SAP que tienen un objeto correspondiente en

TM1®.

TM1SAP

dimensiones TM1.características

La dimensión de medidas en un cubo TM1, que define las unidades que están midiendo los

datos en el cubo, es directamente análoga a una característica cifras clave de un cubo de

información de SAP.

Importados como elementos de dimensiónvalores de caracterís-

tica

Importados a TM1 como cuboscubos de consulta

Las características de SAP pueden contener una o varias jerarquías. Las jerarquías se pro-

porcionan a TM1 a través del proveedor ODBO SAP como dimensiones. Puede elegir entre

las jerarquías de una característica cuando importe la característica a TM1.

jerarquías

Sin objeto correspondiente en TM1.dimensiones

Por ejemplo, SAP implementa objetos llamados dimensiones. Las dimensiones de SAP son

colecciones de características. TM1 no tiene objeto análogo a las dimensiones SAP. Puede

importar características individuales a TM1, pero no puede importar dimensiones SAP.


Jerarquía de objeto SAPLa siguiente tabla muestra la jerarquía de objeto SAP y los objetos análogos en TM1®.

Objetos TM1Objetos SAP

CubosCubos de información

CubosCubos de consulta

CubosDimensiones

DimensionesCaracterísticas y cifras clave

DimensionesJerarquías

Elementos de dimensionesValor de característica

Alias de elementosAtributo que se muestra: nombre que se muestra

Nombre del elementoAtributo que se muestra: nombre exclusivo

Requisitos previos del software TM1 Connector for BW SAPLos siguientes requisitos previos de software deben cumplirse antes de que pueda ejecutar TurboIn-

tegrator e importar datos de BW SAP.

● Debe instalar las bibliotecas SAP específicas de la plataforma y el sistema operativo en el que

está ejecutando SAP. Puede descargar las bibliotecas SAP más recientes de SAP Service Market-

place.

● 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 "Instalación de la interfaz

de TM1 en BW SAP" (p. 48).

El archivo Saprfc.ini y las librerías RFCEl método que se utiliza para habilitar el archivo Saprfc.ini y las librerías RFC varía según la plata-

forma, como se describe en las siguientes secciones. Para obtener más información sobre el archivo

Saprfc.ini, consulte el sitio web de ayuda de SAP.

Microsoft Windows (x86)Las plataformas Windows® requieren una biblioteca de vínculos dinámicos (Librfc32.dll) y el archivo

Saprfc.ini de SDK RFC SAP específico de la plataforma, disponible desde SAP.

46 IBM Cognos TM1

Capítulo 6: Importación de datos utilizando TM1 Connector for SAP Business Warehouse

La biblioteca de vínculos dinámicos se puede ubicar en cualquier directorio del equipo, siempre

que el directorio se añada 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 instalarán automáticamente todos los archivos RFC SAP

necesarios. A continuación, 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) específico de la versión y de la plataforma disponible

desde SAP.

● Todos los archivos (.dll) de la biblioteca de vínculos dinámicos incluidos en las subcarpetas de

SDK RFC SAP.

● El archivo Saprfc.ini proporcionado por SDK RFC SAP

Archivos de la biblioteca de vínculos dinámicos

La lista exacta de archivos SAP de la biblioteca de vínculos dinámicos varía, dependiendo de la

versión de SDK RFC SAP que utilice. Puede ubicar los archivos de la biblioteca de vínculos dinámicos

en cualquier directorio del equipo, siempre que el directorio se añada 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 específicas de la marca o plataforma y el archivo

Saprfc.ini de SDK RFC SAP específico 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 ubicación de la biblioteca RFC SAP, dependiendo del sistema operativo específico.

● LD_LIBRARY_PATH (Sun Solaris)

● LIBPATH (IBM AIX)

También 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 continuación:

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 continuación:

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

Instalación de la interfaz de TM1 en BW SAPPara instalar la interfaz, siga las instrucciones que se describen en una de las siguientes publicaciones,

en función de su versión. 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)

Importación de un InfoCube desde SAPCuando importa un InfoCube SAP a TM1®, las características 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 conexión a su fuente de datos MAS. Consulte "Establecimiento de una conexión

con BW SAP" (p. 49).

❑ Asigne las características de los datos SAP a las estructuras de datos TM1. Consulte:

48 IBM Cognos TM1


● "Asignación de un InfoCube SAP a un cubo TM1" (p. 50).

● "Asignación de características SAP a dimensiones TM1" (p. 52).

● "Establecimiento de restricciones de características" (p. 55).

● "Selección de parámetros de características" (p. 57).

❑ Guarde el proceso y ejecútelo. Consulte "Guardar y ejecutar el proceso SAP TurboIntegra-

tor" (p. 58).

❑ Verifique la salida. Consulte "Ver los resultados" (p. 58).

Establecimiento de una conexión con BW SAPAntes de que pueda importar datos de SAP o escribir datos en una tabla ODS, debe establecer primero

una conexión con SAP siguiendo los siguientes pasos.

Pasos

1. En el panel de la izquierda de Server Explorer de TM1, haga clic con el botón derecho del ratón

en el grupo Procesos y seleccione Crear nuevo proceso.


2. Haga clic en la opción SAP en el cuadro Tipo de fuente de datos.

3. Introduzca valores de parámetros de conexión en la pestaña Conexión.

Su administrador SAP puede proporcionarle los valores de parámetros correctos.

Nota: cuando un valor de parámetro de conexión 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 válido, pero si intenta conectarse

a este sistema desde TurboIntegrator sin poner el nombre del sistema entre comillas, fallará la

conexión.



DescripciónValor del parámetro

Nombre del sistema SAP al que desea conectarse.System

Si el nombre del sistema incluye espacios, ponga el nombre

entre comillas dobles.

Un número que corresponde a la versión de interfaz de

usuario del servidor SAP. Por ejemplo, 498.

Cliente

Su nombre de usuario en el sistema SAP.Usuario

Su contraseña en el sistema SAP.Contraseña

Idioma que desea utilizar para conectarse al sistema SAP.Language

Todas las descripciones textuales se cambian al idioma

especificado si está disponible.

El parámetro de idioma es una abreviatura de dos letras, por

ejemplo, EN=English.

Introduzca otros parámetros y valores para utilizarlos al

conectarse a su sistema BW SAP.

Parámetros de conexión adicio-

nales

Valor que limita el número de filas de cada paquete que se

envía de SAP a TM1. Un tamaño de paquete reducido daría

como resultado un aumento del tráfico de red con paquetes

pequeños, mientras que un tamaño mayor resulta en una

disminución del tráfico de red pero con paquetes más grandes

por transmisión.

Tamaño de paquete

El tamaño de paquete por defecto, que es además el tamaño

mínimo, es 50.000.

4. Haga clic en Conectar.

Asignación de un InfoCube SAP a un cubo TM1Para asignar un InfoCube SAP a un cubo TM1®:

Pasos

1. Seleccione InfoCube en la lista de fuentes SAP.

2. Haga clic en la pestaña InfoCube.

3. Decida si desea ver los objetos SAP por nombre técnico o nombre descriptivo en TurboIntegrator

Para ver los objetos SAP por nombre técnico, seleccione la opción Mostrar nombres técnicos

SAP.

50 IBM Cognos TM1


Para ver los objetos SAP por nombre descriptivo, desactive la opción Mostrar nombres técnicos

SAP.

4. Haga clic en la opción Seleccionar InfoCube para cargar desde y seleccione el InfoCube SAP

que desea importar a TM1.

Si selecciona Mostrar nombres técnicos SAP, los InfoCubes se muestran y ordenan por nombre

técnico en la primera columna con los nombres descriptivos correspondientes están visibles en

la segunda columna para ayudarle a identificarlos. Cuando no se selecciona Mostrar nombres

técnicos SAP, InfoCubes ordena por nombres descriptivos con los nombres técnicos visibles en

la segunda columna.

5. Si desea importar el InfoCube SAP a un cubo TM1 existente, haga clic en la opción 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 Acción de cubo TM1.

DescripciónAcción decubo TM1

Importa datos y metadatos desde el InfoCube SAP y crea un nuevo cubo en

TM1. Utilice esta opción únicamente cuando no exista en el servidor TM1

ninguno de los cubos y dimensiones que está importando.

Crear cubo

Destruye un cubo TM1 existente y lo reconstruye utilizando los datos y

metadatos del InfoCube SAP. Utilice esta opción solo cuando existan las

dimensiones y el cubo TM1 y desee sustituirlos por nuevas estructuras y

datos del InfoCube SAP.

Recrear cubo

Importa datos de un cubo SAP existente y los inserta en un cubo TM1

existente. Esta opción no cambia la estructura de los cubos y dimensiones

en el servidor TM1.

Actualizar cubo

Los procesos que especifican Ninguna acción no afectan a los datos o

metadatos de los cubos TM1.

Ninguna acción

Utilice esta opción para probar y depurar procesos o para definir sus propias

operaciones personalizadas.

7. Seleccione una Acción de datos.



DescripciónAcción de datos

Esta opción escribe valores de celda del InfoCube SAP en el cubo TM1.Almacenar valores

Si elige esta opción cuando está seleccionada la opción Actualizar cubo,

se sobrescriben los valores existentes del cubo TM1 con los valores

importados del InfoCube.

La opción Acumular valores le permite agregar valores de cubo TM1

existentes con valores importados de un InfoCube SAP.

Acumular valores

Esta opción se habilita cuando selecciona la acción Actualizar cubo.Porción de puesta

a cero del cubo de

destinoSeleccione esta opción si desea establecer todos los puntos de datos en

una vista de cubo específica 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 botón Más 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 opción Activar registro de cubos.

Para deshabilitar la el registro durante la importación, desactive la opción Activar registro de

cubos.

Nota: deshabilitar el registro acelera la carga y la actualización de los datos, pero imposibilita

la recuperación de cualquier actualización si se produce un fallo del sistema.

Asignación de características SAP a dimensiones TM1Para asignar características SAP a dimensiones TM1®:

Pasos

1. Haga clic en la pestaña Características.

Para cada característica SAP que aparezca en la pestaña Característica, realice los pasos descritos

en "Asignación de un InfoCube SAP a un cubo TM1" (p. 50). A continuación, continúe con

Seleccionar jerarquías.

2. Haga clic en el botón Seleccionar jerarquías.

Se abre el cuadro de diálogo Seleccionar jerarquías.

3. Haga clic en la lista Fecha de evaluación y seleccione una fecha de evaluación.

La fecha seleccionada aparece con una casilla de verificación en la opción de Fecha de evaluación.

52 IBM Cognos TM1


Las jerarquías temporales se importan a TM1 tal como se encontraban en la fecha seleccionada.

Las jerarquías que no son temporales se importan tal y como se encuentran en el momento de

la ejecución del proceso.

Si no selecciona una fecha de evaluación o si elimina la casilla de verificación de la opción Fecha

de evaluación, todas las jerarquías se importarán tal y como se encuentren en la fecha en que

se ejecuta el proceso TM1.

4. Seleccione las jerarquías que desea importar a TM1 y haga clic en Aceptar.

Si la característica SAP no contiene jerarquías, puede hacer clic en Cancelar para descartar el

cuadro de diálogo Seleccionar jerarquías.

Importante: una jerarquía con intervalos no se puede importar a TM1. El intento de importar

una jerarquía de ese tipo provoca el fallo del proceso TurboIntegrator. Debe estar familiarizado

con las características de su SAP y asegurarse de que no intenta importar una jerarquía que

contenga intervalos.

5. Si la característica se asigna a una dimensión TM1 existente, haga clic en la columna TM1

Dimensión y seleccione la dimensión que corresponda a la característica.

Si desea crear una nueva dimensión TM1 a partir de la característica, introduzca un nombre

para la dimensión en la columna TM1 Dimensión.

Si no desea importar la característica a su cubo TM1, deje vacía la columna TM1 Dimensión.

6. Seleccione una Acción de dimensión TM1.

DescripciónAcción dedimensión

Crear una nueva dimensión TM1 desde la característica SAP.Crear

Recrear completamente una dimensión TM1 existente con elementos

importados desde la característica SAP.

Recrear

Actualizar una estructura de dimensión existente añadiendo nuevos elementos


Actualizar

Procesar la característica a través de TurboIntegrator pero sin utilizar la

característica para crear o modificar ninguna de las dimensiones TM1.

Tal cual

Utilice esta opción para probar y depurar los procesos, o para manipular la

característica en la pestaña Avanzado de TurboIntegrator.

No importar la característica SAP a TM1. La característica se excluye com-

pletamente cuando se procesa el InfoCube SAP a través de TurboIntegrator.

No cargar

7. Haga clic en el botón Seleccionar atributos.

Se abrirá el cuadro de diálogo Atributos de característica.



8. Haga clic en la lista Fecha de evaluación y seleccione una fecha de evaluación para los atributos.

Cuando se selecciona una fecha de evaluación, aparece la fecha con una casilla de verificación

en la opción Fecha de evaluación, y todos los atributos SAP que dependen del tiempo se

importarán a TM1 tal y como se encontraban en la fecha específica. Los atributos que no son

temporales se importan como se encuentran en el momento de la ejecución del proceso.


de evaluación, todos los atributos SAP se importarán tal como se encuentren en la fecha en que

se ejecute el proceso TM1.

9. Asigne cada atributo de característica 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 continuación, selec-

cione 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 continuación, seleccione un Tipo de

atributo.

DescripciónTipo de atri-buto

Identifica atributos con un valor de cadena.Texto

Identifica atributos con un valor numérico.Numérico

Identifica atributos que son nombres alternativos para las dimensiones a las

que están asociados. Puede utilizar este atributo para mostrar las dimensiones

por sus nombres alternativos en la interfaz de usuario de TM1. Un alias de

dimensión debe ser exclusivo con respecto al resto de alias de dimensión o

nombres de dimensión reales.

Alias

Ahora debe asignar las cifras clave de SAP a una dimensión TM1.

Las cifras clave aparecen en la última fila de la pestaña Características.

10. Haga clic en Seleccionar cifras clave.

Se abre el cuadro de diálogo Seleccionar cifras clave.

11. Seleccione cada cifra clave que desee importar a TM1.


13. Asigne las cifras clave a una dimensión TM1.

Si las cifras clave se asignan a una dimensión TM1 existente, haga clic en la columna TM1

Dimensión y seleccione la dimensión que corresponda a las cifras clave.

54 IBM Cognos TM1


Si desea crear una nueva dimensión TM1 a partir de las cifras clave, introduzca un nombre

para la dimensión en la columna TM1 Dimensión.

14. Seleccione una Acción de dimensión TM1 para las cifras clave, como se describía anteriormente

en el paso 5.

Establecimiento de restricciones de característicasPuede crear un filtro en su proceso TurboIntegrator para que se importen a TM1® solo los valores

de datos que se identifiquen con características que queden dentro de las restricciones especificadas.

Para crear un filtro:

Pasos

1. Haga clic en el botón Restricciones de la pestaña Características.

2. Haga clic en Añadir restricción en el cuadro de diálogo Restricciones.

Se inserta una nueva fila en el cuadro de diálogo.

3. Haga clic en la lista en la columna Características SAP y seleccione la característica para la que

desea definir una restricción.

4. Haga clic en la lista en la columna Firmar y seleccione si la restricción será inclusiva o exclusiva.

Elija Incluir si desea que el proceso TurboIntegrator importe solo aquellos valores que queden

dentro de la definición de la restricción.

Elija Excluir si desea que el proceso TurboIntegrator importe solo aquellos valores que queden

fuera de la definición de la restricción.

5. Haga clic en la columna Opción y seleccione un operador para la restricción.

Puede elegir entre ocho operadores, como se describe en la tabla siguiente.

DescripciónOperador

La restricción identifica solo características iguales al Valor bajo especificado.=

La restricción identifica únicamente características inferiores o superiores al

Valor bajo especificado.

< >

La restricción identifica únicamente características inferiores al Valor bajo

especificado.

<

La restricción identifica únicamente características superiores al Valor bajo

especificado.

>

La restricción identifica únicamente características inferiores o iguales al


< =



DescripciónOperador

La restricción identifica únicamente características superiores o iguales al


> =

La restricción identifica únicamente características que quedan entre el Valor

bajo y el Valor elevado, ambos incluidos.

[ ]

La restricción identifica únicamente características que quedan fuera del

Valor bajo y el Valor elevado, ambos incluidos.

] [

6. Introduzca un valor bajo para la restricción en la columna Valor bajo.

7. Introduzca un valor elevado para la restricción, si es necesario, en la columna Valor elevado.

8. Repita los pasos 2 a 8 para cada restricción que desee añadir a su filtro.


Nota: las restricciones no se validan a través de TurboIntegrator. Debe asegurarse de que las

restricciones que introduce son precisas y válidas para sus datos SAP.

Ejemplo de filtro simple

El siguiente ejemplo de filtro simple incluye dos restricciones. Cuando se ejecute el proceso TurboIn-

tegrator, TM1® importará únicamente los valores de característica ZUNIQUE entre 100 y 500. El

proceso también importará todos los valores de característica 0CALDAY excepto los inferiores a

7.

Valor elevadoValor bajoOpciónSgnCaracterística SAP

500100[ ]IncluirZUNIQUE

7<ExcluirOCALDAY

Nota importante sobre características compuestas

En el caso de características compuestas, las restricciones deben introducirse por separado. Por

ejemplo, la característica 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:

Valor elevadoValor bajoOpciónSgnCaracterística SAP

1K4=IncluirOFISCVARNT

20070032007001[ ]IncluirOFISCPER

56 IBM Cognos TM1


Selección de parámetros de característicasLos parámetros de características gestionan la seguridad, consolidación, alias importados y otras

opciones de cada característica que está importando.

Para cada característica SAP que está importando, siga los siguientes pasos:

Pasos

1. Si desea importar las asignaciones de seguridad SAP para la característica a TM1®, seleccione

la opción Importar seguridad.

Cuando elige importar la seguridad de SAP, TurboIntegrator crea nuevos grupos de usuarios

de TM1 y asigna privilegios de seguridad de la dimensión 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

característica 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 dimensión TM1 que se ha

creado o actualizado a partir de la característica Centro de coste.

2. Si desea crear una consolidación de nivel superior para la la dimensión de TM1 que se ha creado

a partir de la característica, introduzca el nombre de la consolidación de nivel superior en la

columna Consolidación superior.

La dimensión TM1 resultante incluirá una consolidación que llevará el nombre que haya

introducido. Por ejemplo, si introduce Total en la columna Consolidación superior, la dimensión

incluye una consolidación de nivel superior llamada Total con todos los elementos importados

como hijos de la consolidación.

3. Si desea asegurar que se generan alias de TM1 exclusivos para todos elementos que se crean a

partir de la característica SAP, seleccione la opción Convertir los textos en exclusivos.

Cuando importa una característica SAP a TM1, los valores de característica se convierten en

elementos de dimensión 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 dimensión deben ser

exclusivos. Si un proceso TurboIntegrator intenta asignar el mismo alias a varios elementos, el

proceso generará errores y fallará la creación del alias.

Cuando la opción Convertir los textos en exclusivos está seleccionada, TM1 examina las des-

cripciones SAP que se han importado y convertido en alias de TM1. Si TM1 detecta que varios

valores utilizan descripciones idénticas, TM1 anexa el nombre del valor a la descripción para

generar alias exclusivos.

Por ejemplo, la siguiente tabla muestra cómo genera TM1 los alias cuando varios valores de

la característica SAP comparten la misma descripción.

Alias de TM1Descripción de valor SAPValor de característica SAP (elementode TM1)

RegiónRegiónUS000



Alias de TM1Descripción de valor SAPValor de característica SAP (elementode TM1)

EstadoEstadoUS001

Estado US002EstadoUS002

Estado US003EstadoUS003

El valor de característica US000 tiene una descripción de Región. Éste es el único valor con

esta descripción, por lo que TM1 asigna Región como alias. Los valores US001, US002 y US003

comparten todos la misma descripción SAP, Estado. El primer valor detectado en el proceso

TurboIntegrator que utiliza la descripción Estado, el US001, recibe el alias Estado. Para man-

tener la exclusividad, el resto de los valores que utilizan la descripción Estado reciben alias que

se generan añadiéndole el nombre del valor al nombre de la descripción.

Es posible modificar sus scripts de TurboIntegrator para que utilicen la función AttrPutS para

insertar alias exclusivos cuando importa una característica SAP. Sin embargo, la opción Con-

vertir los textos en exclusivos se presenta como una forma sencilla de generar alias exclusivos

sin necesidad de modificar scripts.

4. Haga clic en el botón de la columna Fecha de evaluación y seleccione una fecha de evaluación

para la característica. Todos los valores de característica existentes entre la fecha seleccionada

y la fecha de ejecución del proceso se importarán a TM1.

Si no selecciona una fecha de evaluación, la fecha por defecto será la fecha en la que se ejecuta

el proceso TurboIntegrator.

Guardar y ejecutar el proceso SAP TurboIntegratorPara guardar y ejecutar el proceso:

Pasos

1. Haga clic en el botón Ejecutar .

TM1® le solicitará que asigne un nombre al proceso y que lo guarde.



con éxito.

3. Abra Server Explorer. Debería comprobar si se ha creado y llenado el cubo import_cube y si

se hayan creado todas las dimensiones necesarias.

Ver los resultadosCuando define un proceso para importar un InfoCube a TM1® y crear un nuevo cubo TM1, se

producen las siguientes acciones:

58 IBM Cognos TM1


● Para cada característica SAP que elige incluir en su cubo, TM1 genera un proceso para importar

la característica y crear la dimensión TM1 correspondiente.

● TM1 genera un proceso maestro que ejecuta los procesos de creación 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 creardimensiones TM1 a partirde características SAPpresentes en el InfoCube

● Cuando define un proceso para crear o actualizar una dimensión TM1 a partir de una caracte-

rística SAP, todos los valores de la característica se convierten en elementos de dimensión.

● El nombre técnico del valor SAP es el nombre asignado al elemento TM1.

● El nombre de la descripción SAP se convierte en un alias de elemento TM1.

● Si elige importar atributos de la característica SAP, TM1 crea nuevos atributos de dimensión

y les asigna valores basados en los valores de atributo de la característica de SAP.

● Si elige importar la información de seguridad para las características SAP, TM1 crea nuevos

grupos de usuarios de TM1 y asigna privilegios de seguridad de la dimensión a aquellos grupos

según las funciones de seguridad que se definieron en SAP.

Importación de una característica desde SAPPuede importar una característica desde BW SAP a una dimensión TM1®. Cuando importa una

característica, puede especificar qué atributos y jerarquías de SAP desea importar, así como elegir

importar definiciones de seguridad SAP para la característica.

Para importar una característica de SAP a TM1, siga el mismo procedimiento descrito por

"Importación de un InfoCube desde SAP" (p. 48), consulte "Asignación de una característica SAP

a una dimensión TM1" (p. 60) para obtener instrucciones sobre cómo realizar la asignación.



Asignación de una característica SAP a una dimensión TM1Para asignar una característica SAP a una dimensión TM1®:

Pasos

1. Seleccione Característica en la lista de fuentes SAP.

2. Haga clic en la pestaña Característica.

3. Para ver los nombres técnicos de las características SAP de su sistema, seleccione la opción

Mostrar nombres técnicos SAP.

Para ver los nombres descriptivos de las características SAP de su sistema, desactive la opción

Mostrar nombres técnicos SAP.

4. Haga clic en la opción InfoCube SAP y seleccione el InfoCube SAP que contiene la característica


5. Haga clic en la opción Característica SAP para cargar desde y seleccione la característica SAP


6. Si desea importar la característica SAP a una dimensión TM1 existente, haga clic en la opción

TM1 Dimensión para cargar en y seleccione la dimensión TM1 que recibirá los datos de la

característica SAP.

Si desea crear una nueva dimensión TM1 cuando importe la característica, introduzca el nombre

de la nueva dimensión TM1 en el campo TM1 Dimensión para cargar en.

7. Seleccione una Acción de dimensión TM1.

DescripciónAcción dedimensión

Crear una nueva dimensión TM1 desde la característica SAP.Crear

Recrear completamente una dimensión TM1 existente con elementos


Recrear

Actualizar una estructura de dimensión existente añadiendo nuevos elementos


Actualizar

No importar la característica SAP a TM1.No cargar

Seleccione esta acción solo si desea guardar la definición del proceso sin

importar realmente la característica SAP. Posteriormente podrá cambiar la

Acción de dimensión a Crear, Recrear o Actualizar (según convenga) cuando

desee importar la característica.

8. Si desea importar las asignaciones de seguridad SAP de la característica a TM1, seleccione la

opción Recuperar los parámetros de seguridad.

60 IBM Cognos TM1


Cuando elige importar la seguridad de SAP, TurboIntegrator crea nuevos grupos de usuarios

de TM1 y asigna privilegios de seguridad de la dimensión 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

característica 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 dimensión TM1 que se ha

creado o actualizado a partir de la característica Centro de coste.

9. Si desea crear una consolidación de nivel superior para la dimensión de TM1 que se ha creado

a partir de la característica, introduzca el nombre de la consolidación de nivel superior en el

cuadro Consolidación superior.

10. Haga clic en el botón Seleccionar jerarquías.

Se abre el cuadro de diálogo Seleccionar jerarquías.

11. Haga clic en la lista Fecha de evaluación y seleccione una fecha de evaluación.

La fecha seleccionada aparece con una casilla de verificación en la opción de Fecha de evaluación.

Todas las jerarquías existentes entre la fecha de evaluación seleccionada y la fecha de ejecución

del proceso se importarán a TM1


de evaluación, las jerarquías se importarán tal y como se encuentren en la fecha en la que se

ejecute el proceso TM1.

12. Seleccione las jerarquías que desea importar a TM1 y haga clic en Aceptar.

Si la característica SAP no contiene jerarquías, puede hacer clic en Cancelar para descartar el

cuadro de diálogo Seleccionar jerarquías.

Importante: ninguna jerarquía con intervalos se puede importar a TM1. El intento de importar

una jerarquía de ese tipo provoca el fallo del proceso TurboIntegrator. Debe estar familiarizado

con sus características SAP y asegurarse de que no intenta importar una jerarquía que contenga

intervalos.

13. Haga clic en el botón Seleccionar atributos.

Se abrirá el cuadro de diálogo Atributos de característica.

14. Haga clic en la lista Fecha de evaluación y seleccione una fecha de evaluación para los atributos

La fecha seleccionada aparece con una casilla de verificación bajo la opción Fecha de evaluación,

y todos los atributos SAP existentes entre la fecha de evaluación seleccionada y la fecha de

ejecución del proceso se importarán a TM1.


de evaluación, los atributos SAP se importarán tal como se encuentren en la fecha en que se

ejecute el proceso TM1.

15. Asigne cada atributo de característica SAP a un atributo TM1 de una de las maneras siguientes:



● Introduzca el nombre de atributo TM1 correspondiente a cada atributo SAP y, a continua-

ción, seleccione un Tipo de atributo.

● Haga clic para seleccionar un nombre de atributo TM1 existente para cada atributo SAP

y, a continuación, seleccione un Tipo de atributo.









Alias

16. Si desea asegurar que se generan alias de TM1 exclusivos para todos elementos que se crean a

partir de la característica SAP, seleccione la opción Convertir los textos en exclusivos. Para

obtener más información, consulte "Selección de parámetros de características" (p. 57).

17. Haga clic en la lista Fecha de evaluación y seleccione una fecha de evaluación para la caracte-

rística. Todos los valores de característica existentes entre la fecha seleccionada y la fecha de

ejecución del proceso se importarán a TM1.

Si no selecciona una fecha de evaluación, la fecha por defecto será la fecha en la que se ejecuta

el proceso TurboIntegrator.

Guarde y ejecute el proceso Atributos.

Importación de seguridad desde SAPPuede 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 contraseñas correspondientes a los

nombres de usuario no se importan a TM1. Los usuarios de TM1 resultantes tienen una contraseña

vacía en TM1.

Para importar seguridad de SAP, siga el mismo procedimiento descrito en "Importación de un

InfoCube desde SAP" (p. 48), consulte "Selección de las definiciones de seguridad SAP que desea

importar" (p. 63) para identificar las selecciones.

62 IBM Cognos TM1


Selección de las definiciones de seguridad SAP que desea importarPara especificar qué definiciones de seguridad SAP desea importar:

Pasos

1. Seleccione Seguridad en la lista de fuentes SAP.

2. Haga clic en la pestaña Seguridad.

Puede elegir importar cualquier combinación 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, según las asociaciones de rol/nombre de usuario

de SAP.

● Si deja los cuadros de Filtro de rol y Filtro nombre de usuario vacíos, TM1 importa todos

los roles y nombres de usuario de SAP.

3. Para especificar un Filtro de rol, introduzca una cadena de búsqueda en el cuadro Filtro de rol.

La cadena de búsqueda puede incluir el carácter comodín %, que representa cualquier número

de caracteres.

También 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 búsqueda en el cuadro

Filtro nombre de usuario.

Como en el Filtro de rol, puede utilizar el carácter comodín % en la cadena de búsqueda.


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, según las asociaciones

de rol/nombre de usuario de SAP.



Importación y conversión de datos de divisa desde SAPPuede 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 método de conversión de divisa.

Para importar datos de divisa desde SAP a TM1, siga el procedimiento siguiente descrito en

"Importación de un InfoCube desde SAP" (p. 48). Consulte "Asignación de divisas de SAP a cubos

y dimensiones de TM1" (p. 64) para asignar divisas.

Asignación de divisas de SAP a cubos y dimensiones de TM1Para 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 pestaña Divisa de SAP.

3. Para ver los nombres técnicos para las divisas de SAP y los tipos de conversión, seleccione la

opciónMostrar nombres técnicos SAP.

Para ver los nombres descriptivos, desactive la opción Mostrar nombres técnicos SAP.

Nota: los elementos TM1 creados durante el proceso de importación siempre utilizan nombres

técnicos de SAP, independientemente de los parámetros de la opción Mostrar nombres técnicos

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 Dimensión de destino adyacente, especifique la dimensión 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 Dimensión de destino adyacente, especifique la dimensión TM1 que recibirá las

cadenas de divisa de SAP.

9. Haga clic en el campo Tipo de conversión para seleccionar el método de conversión que utilizará

para convertir la divisa inicial en la segunda divisa.

64 IBM Cognos TM1


La lista de tipos de conversión disponibles refleja los métodos de conversión definidos en su

sistema SAP.

10. En el campo Dimensión de destino adyacente, especifique la dimensión TM1 que recibirá los

tipos de conversión de SAP.

Uso de comodines en la pestaña Divisa de SAP

Las cadenas de comodines solo son válidas cuando está seleccionada la opción Mostrar nombres

técnicos SAP.

En lugar de seleccionar un solo elemento de las listas Divisa DESDE, Divisa A y Tipo de conversión,

puede introducir una cadena de comodines para recuperar todos los elementos coincidentes en SAP.

El único carácter comodín válido es %, que encuentra cualquier cadena de 0 o más caracteres.

Por ejemplo, introduzca el carácter comodín % en los campos Divisa DESDE, Divisa A y Tipo de

conversión para recuperar todos los tipos de conversión y divisas de SAP.

También puede utilizar el carácter % en combinación 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 conversión para recuperar todos los tipos de con-

versión 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:

ValorTipo de conversiónDivisa ADivisa DESDE

26.98000-EURX20010101EURRUB

3.54000-EURX20010101EURSAR



ValorTipo de conversiónDivisa ADivisa DESDE

1.64110-200119970101USDDEM

Si la pestaña Divisa de SAP utiliza las cadenas de comodines que se muestran a continuación, no

se recuperará ningún registro. Ninguno de los registros de la fuente SAP coincide con todas las

cadenas de comodines especificadas.


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 dimensión de destino especificada.

● La Divisa A (o divisas, si se utilizan comodines) especificada se crea como un elemento en la

dimensión de destino especificada.

● El Tipo de conversión (o tipos de conversión, si se utilizan comodines) especificado se crea

como un elemento en la dimensión 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 importación 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 fácilmente como códigos de divisa. El ele-

mento de título M es un tipo de conversión de SAP.

66 IBM Cognos TM1



Importación de una tabla SAPPara utilizar TurboIntegrator para importar una tabla BW SAP a un cubo TM1®, siga el mismo

procedimiento descrito en "Importación de un InfoCube desde SAP" (p. 48). Consulte "Creación

de una consulta de tabla SAP" (p. 67) y "Identificación y asignación de variables" (p. 68).

Creación de una consulta de tabla SAPPara 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 pestaña 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 cláusula

WHERE cuando la instrucción 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, intro-

duzca 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.



Cualquier error de sintaxis en la cadena de filtro que introduzca provocará la interrupción del

proceso TurboIntegrator.

CUSTOMER = 'R110' se ejecutará correctamente.

CUSTOMER='R110' provocará un error de sintaxis.

Si no introduce una cadena de filtro, la instrucción SELECT generada devuelve la tabla entera.

Identificación y asignación de variablesUna 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 más detalles sobre la identificación y asignación de variables, consulte “Identificación

de variables en la fuente de datos”.

Escritura de datos TM1 en SAPPuede 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 importación de datos SAP a TM1 y exportación de TM1 a SAP tendrá

un aspecto parecido al siguiente:

Import SAP InfoCubeinto TM1

Work with data in TM1Transfer data

from ODS table tooriginal InfoCube

Export TM1 cube viewto ODS table

Para exportar datos desde una vista de cubo TM1 a una tabla ODS, siga los mismos procedimientos

para importar datos. Consulte "Asignación de dimensiones y valores de una vista TM1 a una tabla

ODS" (p. 69) para asignar dimensiones y valores.

68 IBM Cognos TM1


Asignación de dimensiones y valores de una vista TM1 a una tabla ODSPara 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 pestaña Configuración de ODS.

3. Haga clic en el botón Examinar, junto al campo Seleccionar vista TM1 para elegir la vista que

desea exportar.

También 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 Región del cubo SalesCube del servidor sdata1, utilizaría

la siguiente cadena:

sdata1:SalesCube->Region

Nota: al exportar de una vista de cubo a una tabla ODS, la última dimensión del cubo debe

ser la dimensión de medidas. Si la dimensión de medidas no es la última dimensión 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 técnicos de las tablas ODS de su sistema SAP, seleccione la opción Mostrar

nombres técnicos.

Para ver los nombres descriptivos, desactive la opción Mostrar nombres técnicos.

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 características SAP o cifras clave. Debe conocer la estructura de las

tablas ODS para saber qué columnas son características y cuáles son cifras clave; TurboIntegrator

no distingue entre los tipos de columna de la tabla ODS.

6. Asignar dimensiones TM1 a las columnas de la característica en la tabla ODS.

Para asignar una dimensión, haga clic en la lista y seleccione la dimensión que desea asignar a

la columna de tabla correspondiente. Por ejemplo, la siguiente tabla es una representación de

la dimensión TM1 account1 asignada a la columna de tabla 0QUANTITY.

Seleccionar medidaTM1 DimensiónColumna de la tabla ODS

account1OQUANTITY

Debe tener en cuenta los siguientes detalles al asignar dimensiones a las características:



● No tiene que asignar una dimensión a cada columna de la característica de la tabla ODS.

Puede que algunas columnas no tengan una dimensión TM1 correspondiente cuando termine

con la asignación. En ese caso, cualquier columna de la característica que no esté asignada

se vaciará al finalizar la exportación.

● No debería asignar una única dimensión TM1 a varias columnas de la tabla de caracterís-

ticas de ODS. La interfaz de usuario de TurboIntegrator no le impide hacerlo, pero tal

asignación dará como resultado valores de columna redundantes en la tabla ODS.

● Cuando asigna una dimensión de título de vista TM1 a una característica y la dimensión

de título no utiliza un subconjunto con nombre, solo se exportará a la tabla ODS el último

elemento del actual subconjunto de título sin nombre. Si la dimensión de título sí utiliza

un subconjunto con nombre, todos los elementos del subconjunto se exportan a la tabla

ODS.

7. Asignar la dimensión de medidas de TM1 a todas las columnas de cifras clave de la tabla ODS.

Se asume que la última dimensión de la vista del cubo de origen es la dimensión de medidas.

Cuando asigna una dimensión de medidas a una columna de la tabla ODS, se habilita el botón

Seleccionar medida.

La siguiente tabla es una representación de la dimensión account1 asignada a la columna de

cifra clave 0QUANTITY de la tabla ODS. Como account1 es la última dimensión del cubo

TM1, se habilita el botón Seleccionar medida.


OAMOUNT

Seleccionar medidaaccount1OQUANTITY

8. Haga clic en el botón 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 continuación, haga clic en Aceptar.

El elemento seleccionado se muestra como una etiqueta en el botón Seleccionar medida.


OAMOUNT

Unidadesaccount1OQUANTITY

Si su tabla ODS incluye una única columna de cifras clave, también puede utilizar las instruc-

ciones de asignación alternativa de cifras clave que se describen en la siguiente sección.

10. Repita los pasos 7 a 9 para todas las columnas de cifras clave de la tabla ODS.

70 IBM Cognos TM1


Si su tabla ODS contiene varias columnas de cifras clave, la dimensión de medidas de TM1

debería asignarse a todas estas columnas, pero solo deberá seleccionarse un único elemento

para cada cifra clave, como se muestra en la siguiente representación:


Salesaccount1OAMOUNT

Unidadesaccount1OQUANTITY

Precioaccount1OPRICE

Instrucciones de asignación alternativa de cifras clave

Si su tabla ODS incluye una única columna de cifras clave, puede utilizar la opción _TM1CellValue_

para asignar valores de cubo TM1® a la tabla ODS. No puede utilizar la opción _TM1CellValue_

si su tabla ODS contiene varias columnas de cifras clave.

Para utilizar la opción _TM1CellValue_:

Pasos

1. Complete los pasos del 1 al 6 en"Asignación de dimensiones y valores de una vista TM1 a una

tabla ODS" (p. 69).

2. NO asigne la dimensión de medidas de TM1 a la columna de cifras clave. En su lugar, haga

clic en la columna Dimensión TM1 y seleccione _TM1CellValue_.

Por ejemplo, la siguiente tabla es una representación de valores de cubo asignados a la columna

de cifras clave 0SALES_UNIT.

TM1 DimensiónColumna de la tabla ODS

_TM1CellValue_OSALES_UNIT

account1OQUANTITY

Cuando utiliza este método alternativo para asignar valores del cubo TM1, la dimensión de

medidas de TM1 nodebería asignarse a ninguna columna ODS.


Resultados ODS

Tras la correcta ejecución, se escriben los datos TM1® en la tabla ODS especificada, utilizando las

asignaciones que especificó.



72 IBM Cognos TM1


Capítulo 7: Importación de datos a través de IBMCognos 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. También 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 información sobre Directrices para trabajar con

datos BW SAP y Crear un paquete con Framework Manager. Puede consultar más información

sobre estos temas en la documentación de SAP y en la documentación de IBM Cognos Framework

Manager.

IBM Cognos Package Connector es un componente opcional que está almacenado en un CD inde-

pendiente del disco de instalación de TM1 principal. Consulte "Instalación de IBM Cognos TM1

Package Connector" en la Guía de instalación de IBM Cognos TM1 para obtener más información

sobre cómo instalar y configurar IBM Cognos Package Connector.

Establecimiento de una conexión al servidor Cognos BITras instalar y configurar los componentes, siga estas instrucciones para establecer la conexión:

Pasos

1. Ejecute TM1.

2. En el panel de la izquierda de Server Explorer de TM1, haga clic con el botón derecho del ratón

en el grupo Procesos y seleccione Crear nuevo proceso.


3. Seleccione la opción IBM Cognos Package en el cuadro de diálogo Data Source Type.

4. Se selecciona Paquete por defecto. Consulte Conexión a paquetes publicados.

En su lugar, puede seleccionar Dimension si solo desea importar jerarquías desde una única

dimensión de un paquete.

5. Introduzca los detalles de conexión:

Si su servidor IBM Cognos BI permite la conexión anónima, podrá hacer clic en "Log on". De

lo contrario, introduzca sus credenciales de conexión aquí:


● Espacio de nombres de autenticación

La lista desplegable muestra todos los espacios de nombres de autenticación disponibles.

● ID de usuario y Contraseña

Introduzca un ID de usuario y una contraseña para un usuario en el espacio de nombres

de autenticación seleccionado.

● Conexiones

Le permite gestionar la información de conexión relacionada con el proceso de TI. El botón

se activará cuando haya iniciado sesión correctamente en el servidor BI.

La primera vez que autentique el servidor BI se creará automáticamente una conexión

denominada "BI Server Logon". Si actualiza las credenciales en la ficha Connection después

de conectarse por primera vez, dichos cambios no actualizarán esta conexión. Debe utilizar

el cuadro de diálogo Manage Signons para modificar la conexión. Podrá Add, Modify y

Remove signons.

Si elimina una conexión es posible que TI sea incapaz de ejecutar un proceso cuando se

desactive la conexión anónima.

A medida que trabaje con dimensiones y medidas, podrán crearse conexiones de fuentes

de datos. También podrán gestionarse a través de la ventana Signons.

● Conexión/Desconexión

Haga clic en Log on para conectarse al servidor BI. Una vez conectado, podrá utilizar la

opción Log off para desconectarse del servidor BI.

Conexión a paquetes publicadosUna vez conectado al servidor BI, seleccione el paquete con el que desee trabajar.

Si no está importando medidas, después de seleccionar un paquete, continúe con la ficha Dimension.

Pasos

1. Localice el paquete.

Haga clic en el botón 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á

automáticamente. El botón 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, selecciónelo de la lista.

3. Especifique las acciones de importación que desea llevar a cabo.

Complete la Acción de cubo y las Acciones de datos según requiera esta importación, tal y

como lo haría con cualquier otro tipo de fuente de datos. Consulte Asignación de variables

para obtener más información sobre estas opciones.

74 IBM Cognos TM1

Capítulo 7: Importación de datos a través 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 extracción de datos. Compruebe

sus resultados.

4. Para definir las dimensiones del paquete, haga clic en la ficha Dimension.

5. Defina la estructura de Jerarquía y Atributo con los cuadros de diálogo que se muestran al

hacer clic en Select Hierarchies o Select Attributes.

Tenga en cuenta la siguiente información sobre Jerarquías y Atributos:

● Jerarquía por defecto

Si especifica la Dimensión TM1 sin preseleccionar ninguna jerarquía, TM1 seleccionará

automáticamente la primera como la Jerarquía por defecto. Puede cambiar la selección

mediante la desactivación o activación de las casillas de verificación.

● Selección previa a la asignación

También puede seleccionar jerarquías y todos los subelementos como filtros antes de realizar

la asignación a una dimensión TM1. Si rellena la dimensión TM1 en la dimensión de

jerarquías preseleccionadas, se aplicarán todas las selecciones de forma automática. Si anula

la selección de cualquier dimensión asignada al borrar el nombre de la dimensión TM1 en

el campo, se borrarán automáticamente todas las jerarquías preseleccionadas bajo las

dimensiones correspondientes.

● Nombre frente a referencia

La jerarquía muestra el Nombre de jerarquía y la Referencia de jerarquía para identificar

la jerarquía especificada con total claridad. Se puede repetir el nombre de jerarquía, pero

la referencia de jerarquía es única.

● Filtros

Si se define un filtro en el paquete y se selecciona una jerarquía, el botón Select Filters se

pondrá a su disposición para que pueda seleccionar los filtros que desee aplicar.

Asegúrese de que el filtro coincide con la jerarquía seleccionada o es posible que se produzca

un error en su consulta.

● Múltiples niveles en una jerarquía

IBM Cognos permite a los usuarios definir varios niveles de una jerarquía. Cuando una

jerarquía define varios niveles, los nombres de atributos pueden repetirse en diferentes

niveles.



En el ejemplo anterior, la dimensión City contiene City, Geography, Geography_link, etc.

Cada jerarquía define varios niveles.

En el ejemplo anterior, las opciones Etiqueta de nivel, Número de nivel, Nombre único de

jerarquía, etc. son las mismas en los distintos niveles de jerarquías diferentes. TM1 realiza la

consolidación 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 continuación, los roles del atri-

buto. 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

acompañan a una firma de rol) se evaluará como el factor de consolidación.

Al especificar la asignación de atributos TM1, durante la importación se seleccionan todos los

atributos cuyo nombre externo o firma de rol coincida con los atributos TM1 asignados. Es

posible que se asigne más de un atributo.

6. Seleccionar atributos

76 IBM Cognos TM1


Asigne un atributo de dimensión 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 continuación, seleccione un

Tipo de atributo. El nuevo atributo TM1 se creará cuando ejecute el proceso TurboIntegra-

tor.

● Para asignar un atributo a un atributo TM1 existente, haga clic en el campo Atributo TM1

correspondiente, seleccione un atributo y, a continuación, seleccione un Tipo de atributo.









Alias

Ahora debe asignar las medidas a una dimensión 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 diálogo Select Measures.

Nota: un paquete puede tener varias dimensiones de medidas. El nombre de la medida incluye

el nombre de la dimensión 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. Ase-

gúrese de que el filtro coincide con la jerarquía seleccionada o es posible que se produzca un

error en su consulta.


11. Asigne las medidas a una dimensión TM1.

Si las medidas se asignan a una dimensión TM1 existente, haga clic en la columna TM1

Dimension y seleccione la dimensión que corresponda a la medida.

Si desea crear una nueva dimensión TM1 a partir de la medida, introduzca un nombre para la

dimensión en la columna TM1 Dimension.



12. Seleccione una Acción de dimensión TM1 para las medidas.

13. Parámetros de dimensiones

Utilice la ficha Dimension settings para definir la Top Consolidation de las dimensiones especi-

ficadas.

14. Edición de solicitudes

Puede hacer clic en el botón Prompts para abrir una ventana de Cognos de edición 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 deberán proporcionarse antes de que TI ejecute la consulta. De lo

contrario, el proceso no se realizará correctamente.

Puede pulsar el botón 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 estén dis-

ponibles.

DescripciónAPI de TI

devuelve el número total de solicitudes que deben establecerseCGPromptSize()

devuelve la solicitud ordenada por índice (0-(CGPromptSize

()-1))

CGPromptGetNextMember(int index)

78 IBM Cognos TM1


DescripciónAPI de TI

establece los valores de solicitud ordenados por nombre de

solicitud

CGAddPromptValues(promptName, value 1, value

2...)

count=CGPromptSize(); while(i<count);prmptname=CGPromptGetNextMember(i); CGAddPromptValues(prmptname, ’1999-01-01’,’2009-01-01’);i=i+1; end;

Ejemplo

15. Cuando haya medidas, jerarquías y dimensiones asignadas, puede probar la consulta haciendo

clic en Test Queries.

Test Queries inicia la ejecución 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 información de la conexión.

16. Haga clic en la casilla de verificación Show Namespace para incluir el espacio de nombres en

la lista Dimension.

17. Complete las fichas Avanzado y Programación si fuera necesario. Consulte Edición de tareas

y procedimientos avanzados para obtener más información. Package Connector también genera

el proceso TI de cada dimensión. Ello le proporciona flexibilidad para añadir sus propias ins-

trucciones de scripts de TI en caso necesario.

18. Guarde y ejecute el proceso TI. Consulte Guardar y ejecutar el proceso TurboIntegrator.

Importación de una única dimensiónPuede utilizar la opción del menú desplegable Dimension de la ficha Data Source para definir

rápidamente una única dimensión. 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 jerarquías.

Pasos

1. Localice el paquete.

Haga clic en el botón Browse para seleccionar un paquete disponible.

2. Identifique la Dimensión para cargar desde:.

El menú desplegable muestra una lista con las dimensiones disponibles en el paquete seleccio-

nado.

3. Identifique la Dimensión TM1 para cargar en:.

El menú desplegable muestra una lista con las dimensiones disponibles si está actualizando una

dimensión existente.

4. Seleccione una Acción de dimensión TM1 tal y como lo haría con cualquier otra fuente de

datos. Consulte Asignación de dimensiones para obtener más información.



5. Identifique la Consolidación superior:

Si desea crear una consolidación de nivel superior para la dimensión TM1, introduzca aquí el

nombre de la consolidación de nivel superior.

La dimensión TM1 resultante incluirá una consolidación con el nombre que haya introducido.

Por ejemplo, si introduce Total en Top Consolidation, la dimensión incluye una consolidación

de nivel superior llamada Total con todos los elementos importados como hijos de la consoli-

dación.

6. Consulte Especificación de una solicitud de segmentación para una consulta BW SAP para

obtener más información sobre cómo especificar solicitudes.

7. Cuando haya medidas, jerarquías y dimensiones asignadas, puede probar la consulta haciendo

clic en Test Queries.

Test Queries inicia la ejecución 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 información de la conexión.

Guardar y ejecutar el proceso TurboIntegratorPara guardar y ejecutar el proceso:

Pasos

1. Haga clic en el botón Ejecutar.

TM1 le pide que asigne un nombre al proceso y que lo guarde.

2. Guarde el proceso.

A continuación, debería ver la confirmación de que el proceso se ha ejecutado correctamente.

3. Abra Server Explorer. Debería comprobar si se ha creado y llenado el cubo que especificó y si

se han creado todas las dimensiones necesarias.

Ver los resultadosCuando define un proceso para importar un paquete a TM1 y crear un nuevo cubo TM1, se pro-

ducen las siguientes acciones:

● Para cada dimensión que elige incluir en su cubo, TM1 genera un proceso para importar la

dimensión y crear una dimensión TM1 correspondiente.

● TM1 genera un proceso maestro que ejecuta los procesos de creación 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 creardimensiones TM1a partir de característicaspresentes en el InfoCube

● El elemento de consulta definido como clave del nivel de la jerarquía se utiliza como nombre

de elemento TM1.

Directrices para trabajar con datos BW SAPSe deben tener en cuenta varios aspectos concretos al utilizar paquetes basados en SAP creados con

Framework Manager. Para obtener más información sobre cómo crear consultas SAP, cómo crear

paquetes basados en SAP con Framework Manager y cómo utilizar los mismos en TM1, consulte

Cómo trabajar con datos BW SAP utilizando un paquete de Framework Manager. Para obtener

información general sobre cómo crear paquetes con Framework Manager, consulte "Crear o

modificar un paquete" en la User Guide de Framework Manager.

Cómo trabajar con datos BW SAP utilizando un paquete de Framework ManagerPuede 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 método 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 cómo volver a crear

un cubo BW SAP como cubo IBM® Cognos® TM1®. Para realizarlo, el paquete de consultas BW

SAP debe tener un formato específico.

Deben seguirse tres pasos para importar una consulta BW SAP y acceder a las dimensiones y hechos

con IBM Cognos:

● Creación 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 extracción está limitado únicamente a fuentes de datos BW SAP.



● La fuente de datos debe ser una consulta creada específicamente y definida en la fuente de datos

BW SAP.

Para obtener información general sobre cómo crear paquetes, consulte "Crear o modificar un

paquete" en la User Guide de Framework Manager.

Creación 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 recuperación de datos.

Los pasos que utilice pueden variar en función de la versión de Query Designer que utilice.

Pasos

1. En Query Designer, haga clic en Nueva consulta.

2. En el cuadro de diálogo Nueva consulta, seleccione el proveedor de información que contenga

el cubo que desee importar.

3. Haga clic en el icono Herramientas para consultar el nombre técnico del InfoObject.

4. Arrastre una característica que desee importar del catálogo de InfoObject que está situado en

la columna izquierda hasta uno de los campos que aparecen en la parte derecha de la página.

Por ejemplo, Columnas o Filas.

Las características que seleccione definirán los metadatos del cubo. Las características deben

ajustarse a las siguientes restricciones:

● Debe tener al menos una única variable opcional para segmentar solicitudes de extracción

de datos. Ello puede producir un rendimiento muy superior al de las solicitudes habituales.

● Seleccione una característica que represente la fuente de datos. Las características pueden

ser cifras clave, que se convertirán en medidas del cubo TM1; o dimensiones, que se con-

vertirán en las dimensiones del cubo TM1.

82 IBM Cognos TM1


● No asigne a ninguna de las características una jerarquía mostrada, ni explícitamente ni a

través de una variable.

● Todas las cifras clave de la consulta BW SAP deben ser numéricas.

● No seleccione la características Divisa/Unidad.

● Asegúrese de que todas las cifras clave seleccionadas utilicen la misma divisa.

● Únicamente incluya características en la consulta BW SAP que desee extraer con TM1

Package Connector. Si incluye características innecesarias, aumentará el volumen de datos,

por lo que el rendimiento se verá afectado de forma negativa.

● Se deben copiar las características en los campos Columnas o Filas de la definición de

consulta. Si se copian en los campos Free Characteristics o Filter, las características se

muestran como dimensiones al importarse desde el paquete, pero el proceso de extracción

de secuencias utilizado al segmentar la extracción 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 definición de consulta.

● Si incluye una característica libre, no aparecerá ningún valor para dicha característica en

la extracción de cifras clave. Un filtro aplicado a una característica libre actúa como filtro

en los datos BW SAP devueltos. Puede utilizarlo como filtro para definir un subconjunto

de un InfoCube.

● Utilice una solicitud de lista de selección, en lugar de una solicitud de escritura para la

consulta. Una solicitud de lista de selección ofrece valores para segmentar los datos.

5. Si desea definir los metadatos que rellenarán el cubo, deberá modificar las propiedades de cada

característica que haya seleccionada para su inclusión. Haga clic con el botón secundario del

ratón en una característica y seleccione Propiedades.

6. En el cuadro de diálogo Propiedades de la característica, modifique el valor Mostrar como a

Clave y el valor Suprimir filas de resultados a Siempre. Tenga en cuenta que cualquier restricción

o filtro que se aplique aquí se mantendrá de ahora en adelante.



7. Repita los pasos 5 y 6 para cada característica que seleccionó en el paso 4.

Nota: únicamente debe seleccionar las características que necesite. Para evitar el consumo

excesivo de memoria, la disminución del rendimiento del sistema o que se produzca un error,

piense con detenimiento qué características desea incluir en la consulta. Le recomendamos que

consulte a un administrador BW SAP para asegurarse de que no se superen los volúmenes de

datos.

8. Haga clic en el icono Propiedades de las consultas y en la ficha Ampliadas active la casilla

de verificación Permitir acceso externo a esta consulta. Así se expone la consulta a Framework

Manager.

9. Haga clic en Guardar y proporcione una Descripción y un Nombre técnico para la nueva con-

sulta. Le recomendamos que utilice la convención de nomenclatura BW SAP en el campo

Nombre técnico. Es decir, comience la entrada con la letra 'Z' seguida de un nombre intuitivo

o la convención de nomenclatura estándar. Es muy importante anotar este nombre técnico,

puesto que lo necesitará para encontrar la consulta en Framework Manager.

Ahora está listo para Crear una variable. Para obtener más información sobre el uso de SAP Query

Designer, consulte la documentación de BW SAP.

Crear una variable

Ahora puede crear un parámetro de solicitud opcional para la consulta, de forma que TM1 Package

Connector pueda emitir consultas de menor tamaño a SAP y, por lo tanto, recuperar el conjunto

de datos completo. Esta técnica debe utilizarse donde el volumen de datos produciría 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 podría disminuir el rendimiento o producirse un error con mensajes de memoria insuficiente

en su entorno SAP.

84 IBM Cognos TM1


Una directriz básica a seguir es que cuando se utiliza una variable para segmentar la extracción de

datos, TM1 Package Connector obtendrá en primer lugar todos los miembros que existan para la

dimensión en relación a la cual se define la variable. A continuación, TM1 Package Connector

obtendrá datos de forma individual para extraer los datos de hecho de cada miembro individual

de la dimensión, a fin de satisfacer la variable.

Esto permite a TM1 Package Connector descomponer la extracción de datos en grupos que puede

gestionar el servidor BW SAP. No existen estándares establecidos con respecto a qué dimensiones

se deben aplicar. Para alcanzar un rendimiento óptimo, debe comprender los datos BW SAP y

determinar qué dimensión descompone los datos de hecho equitativamente.

Debe seleccionar con detenimiento qué dimensiones se definirán en la variable. Para obtener un

rendimiento óptimo, es posible que se necesite algo de experiencia. Por ejemplo, es posible que

tenga una dimensión [COUNTRY] que contenga tres países 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 dimensión no descompondría

los datos equitativamente. Las consultas que aparecen como resultado tendrían una petición de

gran tamaño (US) y dos más pequeñas (CA y MX). Por lo tanto, esta dimensión no sería una buena

candidata.

No desea aplicar una variable a una dimensión que podría generar demasiadas peticiones pequeñas.

Por ejemplo, [0MATERIAL], una dimensión que se utiliza a menudo en entornos BW SAP, proba-

blemente no sería una buena candidata porque generaría demasiadas peticiones pequeñas.

Es posible que se haya definido una dimensión para [COSTCENTER] que divida equitativamente

los datos en 10 centros de costes distintos que pueden utilizarse para segmentar los datos en partes

iguales. Otra buena alternativa podría ser el año 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 extracción de datos. Algunas extrac-

ciones se llevarán a cabo sin ningún problema cuando no se apliquen variables.

No se puede aplicar ninguna fórmula, puesto que no existen dos entornos parecidos. Sin embargo,

se recomienda utilizar un método prudente para evitar perturbar el entorno BW SAP.

Pasos

1. En Query Designer, haga clic con el botón secundario del ratón en una característica que haya

seleccionado en el proceso anterior y seleccione Restringir.

Para asegurarse de que los datos se distribuyen uniformemente, seleccione una característica

que represente al cubo y no genere un gran número de valores. Desea obtener una variable en

la que el número de filas de cada valor de la variable sea similar; no desea una obtener una

variable demasiado específica (por ejemplo, no demasiadas filas por valor que generen un

número excesivo de consultas), ni desea una variable demasiado general (por ejemplo, más de

un millón de filas por valor).

2. En el cuadro de diálogo Selección de…, haga clic en la ficha Variables, haga clic con el botón

secundario del ratón en cualquier parte de la ventana Descripción y seleccione Nueva variable.

Nota: si una de las características que ha seleccionado ya contiene una variable, puede evitar

la creación de una nueva variable y continuar con el paso 7 de este procedimiento.



3. En la página Información general del Asistente de nueva variable, introduzca un Nombre de

variable y una Descripción y seleccione una dimensión como característica. Haga clic en

Siguiente.

4. En la página Detalles, seleccione Único valor, Múltiples valores únicos o Intervalo en el campo

La variable representa, Opcional en el campo La entrada de variable es y active la casilla de

verificación Listo para entrada. Haga clic en Siguiente.

5. En la página Valores por defecto, asegúrese de que el campo Valor por defecto esté vacío.

6. Haga clic en Siguiente hasta que vuelva al cuadro de diálogo Selección de…. La nueva variable

aparece en la ventana Descripción.

7. Seleccione la variable y haga clic en la flecha hacia la derecha para mover la variable

seleccionada sobre la ventana Selección 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 están disponibles en Dimension

Folders del cuadro de diálogo Import.

● Cada dimensión contendrá al menos una jerarquía.

● Seleccione siempre la jerarquía principal cuyo nombre coincida con la jerarquía.

86 IBM Cognos TM1


● Si están disponibles otras jerarquías, seleccione una que proporcione el conjunto de niveles

que desee de la jerarquía.

● Framework Manager importa las dimensiones de tiempo al modelo desde la fuente de datos

BW SAP únicamente si se activa un parámetro de configuración. Consulte Importación de

metadatos desde BW SAP para obtener más detalles. Si establece la configuración como

una dimensión de tiempo, estará realizando una entrada global; las dimensiones importadas

se tratarán como cadenas de tiempo.

● Cree un paquete.

Al crear el paquete para publicarlo en Content Manager, oculte la jerarquía principal en las

dimensiones a las que importó dos jerarquías. La jerarquía principal es necesaria, y debe estar

en el paquete para que el proceso de consulta funcione correctamente. Puede ocultar la jerarquía

si no desea que esté visible.

Importación de metadatos desde BW SAP

Si una dimensión es una dimensión de tiempo o no, se determina al importar los metadatos del

cubo BW SAP a una definición de modelo de FrameWork Manager.

Para que esto se realice correctamente, deberá establecer unos parámetros de configuración. Por

defecto, el valor no está establecido.

En el directorio “configuration”, ubicado donde se instaló Framework Manager, se incluye un

archivo de configuración 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, créelo copiando “sapbw_config.

xml-sample” o cambiando el nombre a “sapbw_config.xml-sample”.

En “sapbw_config.xml”, encontrará las siguientes líneas:

<provider name="SAPBWODP">  <parameter name="UseStgDTypes" value="true"/> 

<parameter name="UseFastGetMembers" value="true"/> </provider>

Asegúrese 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 importación de los metadatos con el fin de reconocer que

una Dimensión del cubo BW SAP es una dimensión de “tiempo”. Se trata de una Dimensión en la

que los elementos de los niveles inferiores de la Dimensión 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 diálogo New Project. Haga clic en Aceptar.

3. Realice los pasos del MetadataWizard. Cuando se le solicite que seleccione una fuente de datos,

si debe crear una nueva fuente de datos, haga clic en New…

4. En la página Select Objects, localice la consulta que definió en BW SAP Query Designer en la

fase anterior. Desplace la lista para obtener el nombre técnico que proporcionó cuando creó

la variable. La estructura de la carpeta es la siguiente: Jerarquías > 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 crearán las dimensiones y se importarán 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 página Provide Name, introduzca el nombre del paquete y, si lo desea, una descripción

y un consejo para la pantalla. Haga clic en Siguiente.

3. Seleccione la consulta que importó en la sección anterior.

4. En la página Define objects, al ocultar o al excluir objetos hijo del paquete, deberá seleccionarlos

uno por uno. Si se excluyen los objetos padre también se excluirán sus hijos. Tenga en cuenta

que si excluye (o no selecciona) muchos objetos de los cubos más grandes, deberá contar con

mucho tiempo.

Nota: Framework Manager admite la función ctrl+mayúsculas y alt+mayúsculas. 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+mayúsculas para eliminar la selección de los elementos que desee incluir y oculte el resto

de los elementos seleccionados.

Para obtener más información sobre cómo incluir, excluir y ocultar objetos, consulte "Crear

o modificar un paquete" en la Guía 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

almacén 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 más información sobre cómo crear un

paquete, consulte "Crear o modificar un paquete" en la Guía de usuario de Framework Manager.

88 IBM Cognos TM1


Especificación de una solicitud de segmentación para una consulta BW SAPLas solicitudes de segmentación se utilizan para consultar los datos de hecho de la fuente de datos

BW SAP. También conocida como variable BEx, las solicitudes de segmentación garantizan que la

consulta recuperará una muestra representativa de los datos de hecho.

Una solicitud de segmentación 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 segmentación 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 segmentación. La solicitud de segmentación no debería tener valores especi-

ficados en ninguna consulta. Las solicitudes obligatorias que no están especificadas en la solicitud

de segmentación deben tener un valor especificado. Las solicitudes opcionales que no están especi-

ficadas como solicitud de segmentación pueden o no tener un valor, según sea necesario.

Pasos

1. Después de seleccionar las jerarquías 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 válidas.

3. Asegúrese de que la solicitud de segmentación 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. Asegúrese de que las solicitudes obligatorias que aparecen en la lista Current prompt valuestienen un valor especificado.


Realización de consultas paralelas con una solicitud de segmen-tador

Si ha definido una solicitud para segmentar la extracción de hechos BW SAP, puede establecer una

preferencia para que TM1 Package Connector mejore su rendimiento.

Pasos

1. Localice la carpeta de instalación de TM1 Package Connector, desplácese hasta la carpeta

Configuración y abra el archivo cogtr.xml en un editor de textos (preferiblemente en un editor

XML).

2. Añada la siguiente entrada a la sección "Transformer" del archivo:

<Preference Name="SegmenterParallelQueryCount" Value="16"/>

3. Establezca el valor en el número de consultas paralelas que desee que emita TM1 Package

Connector. Por defecto las emite de una en una.

4. Guarde el archivo.



TM1 Package Connector ejecutará ahora consultas de medidas en paralelo según el valor que

especifique. Por ejemplo, puede definir una variable opcional de InfoQuery al mes y existen 48

meses en la característica. Puede especificar esta variable como solicitud de segmentador para

la dimensión de medidas. TM1 Package Connector ejecutará hasta 16 consultas en paralelo

(una al mes), que podrían aumentar enormemente el porcentaje de extracción de datos de hecho.

Póngase en contacto con su administrador SAP para asegurarse de que las consultas de

extracción de datos no afectan negativamente al entorno BW SAP de otros usuarios.

90 IBM Cognos TM1


Capítulo 8: Edición de tareas y procedimientosavanzados

Esta sección describe la gestión de los procesos IBM® Cognos® TM1® TurboIntegrator que incluyen

tareas, la planificación de procesos para que se ejecuten automáticamente.

Utilización del modo de carga de gran volumenEl 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 utilización 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 simultánea al acceder a los datos TM1. En el modo de carga

de gran volumen, el servidor TM1 evita la actividad simultánea mediante la suspensión 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 interacción 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 interacción 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 volumenDebe 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 línea de

comandos que intente volver a conectarse al mismo servidor TM1®. El intento de conexión 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á.


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 suspenderán los subprocesos de usuario existentes y las tareas en

ejecución. Únicamente se mantendrá activo el subproceso que inició el modo de carga de gran

volumen. Se desactivarán todas las tareas programadas, excepto la que inicia el modo de carga de

gran volumen. También se suspenderán todas las conexiones TM1Top y todos los subprocesos

específicos del sistema.

Finalización del modo de carga de gran volumen

Cuando se deshabilita el modo de carga de gran volumen, se reanudarán todos los subprocesos de

usuario y del sistema y se habilitarán las conexiones de usuario.

Las aplicaciones personalizadas que API de TM1® utiliza para habilitar el modo de carga de gran

volumen deben también utilizar la función de API de TM1® API necesaria para salir del modo de

carga de gran volumen. Sin embargo, si se interrumpe la conexión del cliente (se produce un fallo

en la red o el cliente se desconecta o no responde), el servidor saldrá automáticamente 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á automáticamente de dicho

modo.

Cuando el servidor vuelve al modo multiusuario normal, las tareas que se desactivaron, vuelven a

activarse y regresan a su programación normal. Si las tareas se programaron para ejecutarse, pero

el modo de carga de gran volumen lo impidió, no se ejecutarán de forma inmediata, sino que se

ejecutarán según 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 volumenPuede habilitar el modo de carga de gran volumen en las secciones Prólogo o Epílogo de un proceso

TI. Para una mayor eficacia, le recomendamos que habilite el modo de carga de gran volumen en

la primera instrucción, o en las primeras instrucciones, de la sección Prólogo del proceso.

Tras habilitar el modo de carga de gran volumen en un proceso, solo se podrá deshabilitar en la

última línea de la sección Epílogo. 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 explícitamente o hasta que la tarea finalice. Esto significa que puede habilitar el modo

en un proceso de una tarea y, a continuación, ejecutar una serie de procesos TI antes de deshabilitarlo.

También puede entrar y salir del modo de carga de gran volumen repetidas veces, utilizándolo 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

Capítulo 8: Edición de tareas y procedimientos avanzados

DisableBulkLoadMode(): esta función solo se puede utilizar en la última línea de la sección Epílogo

del proceso TI al utilizar el modo de carga de gran volumen.

Funciones API C de TM1 para el modo de carga de gran volumenLas siguientes funciones API C de TM1® están disponibles para habilitar o deshabilitar el modo de

carga de gran volumen.

● TM1ServerEnableBulkLoadMode

● TM1ServerDisableBulkLoadMode

Para obtener más información, consulte la Guía API de IBM Cognos TM1.

Edición de procedimientosTras especificar la fuente de datos, identificar todas las variables y definir todas las instrucciones

de asignación, TurboIntegrator genera cuatro procedimientos basados en las opciones que seleccionó

en las pestañas de TurboIntegrator. Estos procedimientos se identifican como subpestañas de la

pestaña Avanzado.

Los procedimientos son:

DescripciónPestaña

Una serie de instrucciones para ejecutarlas antes de que se procese la fuente de datos.Prólogo

Una serie de instrucciones que actualizan o crean un cubo, dimensiones y otras estructuras de

metadatos durante el procesamiento.

Metadatos

Una serie de instrucciones que manipulan valores para cada registro de la fuente de datos.Datos

Una serie de instrucciones para ejecutar después de que se procese la fuente de datos.Epílogo

Puede editar estos procedimientos para que incluyan funciones de TurboIntegrator y funciones de

reglas de TM1® que amplíen las capacidades de TurboIntegrator. Por ejemplo, puede editar el



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 Guía de referencia de IBM Cognos TM1.

Cuando edita procedimientos, tenga en cuenta que cada procedimiento está pensado para ejecutar

ciertos tipos de acción en momentos específicos de un proceso. De esta manera, debería 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 función o instrucción de las subpestañas

Datos o Metadatos, aunque TM1 no enviará ningún error o advertencia de que parte del proceso

no se ha ejecutado.

Para editar un procedimiento:

Pasos

1. Haga clic en la pestaña Avanzado.

2. Haga clic en la subpestaña del procedimiento que desee editar.

3. Introduzca sus instrucciones en el cuadro de texto antes de esta línea:

#****GENERATED STATEMENTS START****

o después de ésta:

#****GENERATED STATEMENTS FINISH****

Importante: las instrucciones creadas por el usuario pueden insertarse antes o después de las

instrucciones generadas, pero no se pueden insertar dentro de las instrucciones generadas por

TurboIntegrator.

Ejecución de un proceso a peticiónPara ejecutar un proceso a petición, seleccione el proceso en Server Explorer y elija Proceso, Ejecutar

proceso.

También puede ejecutar un proceso desde TurboIntegrator seleccionando Archivo, Ejecutar .

Programación de un proceso para la ejecución automática contareas

Puede ejecutar procesos a petición y crear una tarea para ejecutar procesos en los intervalos definidos.

Ambos métodos de ejecución no son exclusivos entre sí. Puede ejecutar un proceso a petición en

cualquier momento, incluso si el proceso está programado para la ejecución automática como tarea.

Una tarea es un objeto TM1® que ejecuta uno o más 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 ejecución inicial de la tarea.

94 IBM Cognos TM1


● La frecuencia a la que se ejecutará posteriormente la tarea.

Una vez definidas, las tareas se pueden activar y desactivar según 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 ejecución automática como tarea desde TurboIntegrator.

Pasos

1. Haga clic en la pestaña Programar de la ventana TurboIntegrator.

2. Seleccione la opción 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 ejecución

inicial de la tarea.

5. Introduzca una Hora para especificar la hora de inicio de la ejecución inicial de la tarea.

6. Establezca los campos del cuadro Frecuencia de ejecución de tareas para definir el intervalo al

que se ejecutará la tarea.

7. Seleccione Archivo, Guardar para guardar el proceso con la información de programación.

Cuando programa un proceso desde TurboIntegrator, la tarea se activa automáticamente y se

ejecutará a la hora de inicio especificada.

También puede crear una tarea para un proceso (o conjunto de procesos) directamente desde

Server Explorer.



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 configuración 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 ejecución

inicial de la tarea.

14. Introduzca una hora para especificar la hora de inicio de la ejecución inicial de la tarea.

15. Establezca los campos del cuadro Frecuencia de ejecución 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 diálogo Guardar tarea como.

18. Introduzca un nombre para la tarea y haga clic en Guardar.

Nota importante sobre las horas de inicio de las tareasLa hora y fecha de inicio de la tarea se almacena en el formato de Hora del meridiano de Greenwich

(GMT) y la ejecución de la tarea está basada en GMT. TM1® no proporciona alojamiento automático

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 programación de la ejecución de la tarea.

El día 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 día 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


Edición de una tareaPara abrir una tarea para modificarla en el Asistente para la configuración de tareas:

Pasos

1. Seleccione la tarea en el panel izquierdo de Server Explorer.

2. Seleccione Tarea, Editar tarea.

Activación de una tareaPara activar una tarea que está actualmente desactivada:

Pasos


2. Active la opción Tarea, Activar.

Desactivación de una tareaPara suspender la ejecución periódica programada de una tarea:

Pasos


2. Desactive la opción Tarea, Activar.

Borrar una tareaPara borrar una tarea:

Pasos


2. Seleccione Tarea, Borrar.

Nota: no puede borrar una tarea activa. Debe desactivar la tarea antes de poder borrarla

correctamente.

Ejecución de una tarea a peticiónPara ejecutar una tarea a petición:

Pasos


2. Seleccione Tarea, Ejecutar.



98 IBM Cognos TM1


Apéndice A: TurboIntegrator Tutorial

Este tutorial le guiará a través de las funciones avanzadas de IBM® Cognos® TM1® TurboIntegrator.

Este tutorial está diseñado para los usuarios responsables de implementar TM1 y de desarrollar

estrategias de utilización 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 importación de datos. Antes de seguir trabajando con este tutorial, debería tener

una buena comprensión de los conceptos de TM1 y conocer el funcionamiento de las funcionalidades

de TM1.

El tutorial le enseña cómo utilizar TurboIntegrator para crear dimensiones y cubos, importar

archivos sin formato y fuentes de datos ODBC. También le mostrará cómo ampliar la potencia de

TurboIntegrator utilizando funciones de scripts avanzados. Este tutorial incluye además consejos

y sugerencias sobre cómo abordar un problema con TurboIntegrator TM1.

Configuración del directorio de datos del tutorialEste 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 ratón enTM1 en el panel izquierdo de Server Explorer y seleccioneArchivo,Opciones.

Se abrirá el cuadro de diálogo Opciones.

2. Haga clic en el botón 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_ins-

tal>\Custom\TM1Data\. Si instaló TM1 en el directorio de instalación 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 diálogo Opciones para establecer el directorio de datos y

reiniciar el servidor local.

Descripción general de TurboIntegratorTurboIntegrator TM1 le permite crear procesos que automatizan la importación de datos, la gestión

de metadatos y otras tareas.

Un proceso es un objeto TM1 que consta de:

● Una descripción 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 relación entre variables y estructuras de datos en la

base de datos de TM1.

● Un procedimiento de prólogo, 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 epílogo que se ejecutará tras procesar la fuente de datos.

● Un conjunto de parámetros que se pueden utilizar para generalizar un proceso, de manera que

se pueda utilizar en múltiples 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 proce-

samiento. Además de estas funciones de TurboIntegrator, puede incorporar todas las funciones de

reglas TM1 estándar en una definición 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 características de TurboIntegrator y definir procesos en

un servidor TM1 en red.

No existe ninguna interfaz que sirva de ayuda en la creación de funciones de TurboIntegrator. Debe

introducir funciones de forma manual directamente en la correspondiente subpestaña de la pestaña

Avanzado. Los argumentos de cadena para funciones de TurboIntegrator deben aparecer entre

comillas simples. Para indicar el fin de cada función, debe incluirse un punto y coma (;) en la ventana

de TurboIntegrator.

Creación de un proceso TurboIntegratorLa creación de un proceso implica cinco pasos. Cada paso se completa estableciendo opciones o

editando valores en una pestaña 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


4. Editar funciones de scripts avanzados

5. Programar los procesos finalizados

Debe completar cada pestaña de la ventana TurboIntegrator en orden secuencial para crear un

proceso. TurboIntegrator no le permite pasar a una nueva pestaña hasta que no proporcione

toda la información necesaria en la pestaña actual.

Creación de dimensiones utilizando TurboIntegratorPuede utilizar TurboIntegrator TM1 para crear una lista de elementos para una dimensión a partir

de una de las varias fuentes de datos posibles, incluyendo ODBC y archivos ASCII. Ésta es la manera

rápida de crear una larga lista de elementos, como mil nombres de una dimensión de cliente.

Archivo ASCII de muestra

Aquí está el archivo ASCII delimitado (example.cma) que utilizará para construir una dimensión e

importar datos.

"New England", "Massachusetts", "Boston", "SuperMart", "Feb" , 2000000"NewEngland", "Massachusetts", "Springfield", "SuperMart", "Feb" , 1400000"NewEngland", "Massachusetts", "Worcester", "SuperMart", "Feb" , 2200000

Cada uno de los registros de este archivo fuente tiene seis campos, y tres de ellos se utilizarán para

crear la dimensión Example. Los dos primeros campos se convertirán en elementos consolidados.

El tercer campo se convertirá en un elemento numérico. El resto de campos se ignorará.

En el Editor de dimensiones, la dimensión Example aparecerá de la manera siguiente.

Los valores numéricos de Boston, Springfield y Worcester se consolidarán en los totales de Massa-

chusetts, que se consolidarán en los totales de New England.

Creación de una dimensión a partir de un archivo ASCII

Para crear una dimensión 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.


3. Seleccione Texto como el Tipo de fuente de datos.

4. Haga clic en el botón Examinar para el Nombre de la fuente de datos y seleccione example.cmaen su directorio TI_data.

5. Deje vacío el campo Nombre de la fuente de datos en el Servidor.



6. Defina el Tipo de delimitador como Delimitado y la Coma como Delimitador.

7. Ignore los campos Carácter de comillas y Número de registros de títulos, ya que no hay comillas

ni registros de título en el archivo de entrada.

El Separador decimal debería ser el punto (.) y el Separador de millares la coma (,).

8. Haga clic en el botón 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.

Identificación 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 pestaña Variables para ver la siguiente cuadrícula, que muestra una fila para

cada variable de la fuente de datos.

La primera columna de la cuadrícula 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, Consolidación, Datos,

Atributo, Otros o Ignorar) que identifica cada variable. En el ejemplo, las primeras tres variables

identifican consolidaciones y elementos de una jerarquía regional.

2. En la columna Contenido de la variable V1, seleccione Consolidación 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 utilizarán para crear la dimensión.

102 IBM Cognos TM1


Asignación de variables

Tras identificar las variables en la fuente de datos, debe asignarlas a objetos TM1.

Pasos

1. Haga clic en la pestaña Asignaciones y, a continuación, en la subpestaña Cubo.

2. No está creando un cubo, por tanto, seleccione Ninguna acción en el cuadro Acción de cubo.

3. La Acción de datos no es relevante, ya que no está creando ni actualizando un cubo. Puede

ignorar este cuadro.

4. La opción Registro de cubos no es relevante, ya que no está procesando valores de datos. Deje

esta opción sin seleccionar.

5. Haga clic en la subpestaña Dimensiones.

Esta cuadrícula 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 dimensión a la que pertenece

el elemento.

6. Está creando una nueva dimensión, por tanto, escriba Example en la columna Dimensión de

la variable Boston.

7. Seleccione Crear en la lista desplegable Acción.

8. Seleccione Numérico en la lista desplegable Tipo de elemento. La subpestaña Dimensiones

debería tener este aspecto:

La variable Boston está ahora asignada como elemento numérico de una nueva dimensión lla-

mada Example.

Ahora puede asignar las variables identificadas como consolidaciones.

9. Haga clic en la subpestaña Consolidaciones.



TM1 identifica correctamente las dos variables de consolidación como miembros de la nueva

dimensión Example. Solo tiene que identificar la variable de hijo de cada consolidación.

10. Para la Variable de consolidación V1, seleccione Massachusetts como la Variable de hijo.

11. Para la Variable de consolidación Massachusetts, seleccione Boston como la Variable de hijo.

12. No modifique el Peso de ninguna de las variables de consolidación.

Cuando haya terminado, la subpestaña Consolidaciones debería aparecer del modo siguiente.

Todas las asignaciones han finalizado. Si lo desea, puede hacer clic en la pestaña Avanzado y,

a continuación, haga clic en las distintas subpestañas para ver los scripts generados por Tur-

boIntegrator que crean la nueva dimensión Example e insertan consolidaciones y elementos.

En secciones posteriores de este tutorial analizaremos de forma más detallada los scripts de

TurboIntegrator.

Guardar y ejecutar el proceso

Para guardar y ejecutar el proceso:

Pasos


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, debería ver un cuadro de mensaje que muestra una confirmación de que

el proceso se he ejecutado con éxito.

3. Cierre la ventana TurboIntegrator.


5. Haga clic con el botón derecho del ratón en la nueva dimensión Example y seleccione Editar

estructura de dimensión.

La dimensión Example se abre en el Editor de dimensiones.

6. Haga clic en para ordenar los miembros de la dimensión por nivel de jerarquía.

104 IBM Cognos TM1


La dimensión 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 numéricos).

Creación de una dimensión a partir de una fuente ODBC

Esta parte del tutorial le guiará en la creación de una dimensión a partir de una fuente de datos

ODBC. El procedimiento es muy similar al de crear una dimensión a partir de un archivo ASCII.

Definición de la fuente de datos

Antes de continuar con el tutorial, debe añadir una base de datos de Access como fuente de datos

ODBC para que esté disponible en TurboIntegrator.

Pasos

1. Abra el cuadro de diálogo Administrador de fuentes de datos ODBC de Windows.

El procedimiento necesario para acceder a este cuadro de diálogo varía en función de la versión

de Windows que utilice. Consulte la ayuda en línea de Windows para obtener más detalles.

2. En la pestaña DSN de usuario, haga clic en el botón Añadir.

Se abrirá el cuadro de diálogo Crear nueva fuente de datos.

3. Seleccione Controlador de Microsoft Accessy haga clic en Finalizar.

Se abrirá el cuadro de diálogo Configuración de ODBC Access.

4. Escriba NewDB en el campo Nombre de fuente de datos.

5. Haga clic en el botón Seleccionar.

Se abrirá el cuadro de diálogo Seleccionar base de datos.

6. Desplácese al directorio TI_Data y seleccione NewDB.mdb.

7. Haga clic en Aceptar para salir del cuadro de diálogo Seleccionar base de datos.

8. Haga clic en Aceptar para salir del cuadro de diálogo 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 botón derecho del ratón en el icono Procesos y seleccione

Crear nuevo proceso.


2. Seleccione ODBC como el Tipo de fuente de datos.

3. Haga clic en el botón Examinar junto al campo Nombre de fuente de datos.

4. Se abrirá el cuadro de diálogo 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 información 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 prestación

de consulta de la DBMS subyacente, a continuación, copie la consulta y péguela en el campo

Consulta de TurboIntegrator.

6. El el campo Consulta, escriba la siguiente instrucción 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.

Utilización de un parámetro en SQL

Puede crear un parámetro para utilizarlo en el campo Fuente de datos y, a continuación, llamar a

dicho parámetro como parte de una consulta.

Por ejemplo, en la siguiente instrucción SQL,

SELECT * FROM customer WHERE last_name = ’Smith’

puede sustituir el valor de Smith por el parámetro ’pLastName’ para que la instrucción SQL sea:

SELECT * FROM customer WHERE last_name = ’?pLastName?’

Al crear un parámetro, 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 número de columnas del conjunto devuelto debe coincidir con el número que aparecía cuando

se desarrolló el proceso TI.

● El tipo de datos de las columnas también debe coincidir.

106 IBM Cognos TM1


● Es muy importante escribir el parámetro entre comillas simples cuando se trata de un parámetro

de cadena. En un parámetro numérico, no utilice las comillas simples; por ejemplo, la consulta

que utiliza un parámetro numérico podría ser

SELECT * FROM customer WHERE last_name = ?pQuantity?

Para crear el parámetro, utilice la ficha Avanzado del cuadro de diálogo Proceso TurboIntegrator

para sustituir el parámetro PO por defecto por el parámetro 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 pestaña Variables.

La cuadrícula de la pestaña de variables debería 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.

ContenidoNombre de la variable

IgnorarACCOUNT_ID

IgnorarPARENT_ID

ElementoNAME

ConsolidaciónTIPO

ConsolidaciónSALESREP

ConsolidaciónSALESTEAM

Ahora está listo para asignar variables.




En primer lugar, tiene que asignar elementos a dimensiones.

Pasos

1. Haga clic en la pestaña Asignaciones y, a continuación, en la subpestañaDimensiones.

La única variable que identificó como elemento se muestra en la cuadrícula.

2. En la columna Dimensión, escriba DB.

3. Seleccione Crear en el menú de lista desplegable Acción.

4. Seleccione Numérico en el menú de lista desplegable Tipo de elemento.

La subpestaña Dimensiones debería tener este aspecto:

Ahora está listo para asignar variables de consolidación.

Pasos


TM1 identifica correctamente cada variable de consolidación como asignación a la dimensión

DB.

2. Establezca la Variable de hijo de cada variable de consolidación.

Variable de hijoVariable de consolidación

SALESREPTIPO

NAMESALESREP

TIPOSALESTEAM

Cuando haya establecido todas las Variables de hijo, la subficha Consolidaciones debería tener

este aspecto:

108 IBM Cognos TM1




Pasos



2. Guarde el proceso como create_DB_dimension.


con éxito.

3. Cierre la ventana TurboIntegrator.


5. Haga doble clic en la nueva dimensión DB.

La dimensión DB se abre en el Editor de subconjuntos.

6. Seleccione Editar → Ordenar → Jerarquía en la barra de menú del Editor de subconjuntos para

mostrar los elementos y consolidaciones de la dimensión.

La dimensión DB contiene más de 40 elementos y tiene cuatro niveles de jerarquía.

Creación de un cubo y procesar datosEl siguiente ejemplo muestra cómo usar TurboIntegrator TM1 para crear un cubo, dimensiones y

procesar datos al mismo tiempo.

Definición de la fuente de datos

Realice los siguientes pasos para definir una fuente de datos.

Pasos




2. Haga clic en la pestaña 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 Número de registros de títulos.

4. Asegúrese de que el Separador decimal es el punto (.) y el Separador de millares es la coma (,).

5. Haga clic en el botón 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.



Cada registro de newcube.csv contiene 20 campos. Puede desplazarse a lo largo de la cuadrícula

de visualización para ver todos los campos.



de la fuente.

Pasos


Algunas variables utilizarán la convención de nomenclatura Vn, mientras que otras utilizarán

los nombres correspondientes al primer registro del archivo de origen.

2. Para simplificar el proceso de edición, cambie el nombre a todas las variables utilizando la

convención Vn. La primera variable debería nombrarse V1, la segunda V2, etc. Cuando haya

terminado, la pestaña Variables debería 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 Numérico. 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


ContenidoNombre de la variableContenidoNombre de la variable

ConsolidaciónV11DatosV1



ElementoV14ElementoV4

ConsolidaciónV15ConsolidaciónV5

ConsolidaciónV16ConsolidaciónV6

ElementoV17ConsolidaciónV7



ElementoV20ElementoV10

Cuando haya terminado, la cuadrícula Variables debería 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.

Asignación del cubo

Para proporcionar instrucciones de asignación de cubo:

Pasos


2. Haga clic en la subpestaña Cubo.

3. SeleccioneCrear para la Acción de cubo.

4. Escriba NewCube en el campo Nombre de cubo.

5. Seleccione Almacenar valores para la Acción de datos.

6. No habilite la opción 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


Asignación de variables de elemento a dimensiones

Ahora puede asignar todas las variables que identificó como que contenían un tipo de Elemento

para las dimensiones apropiadas.

Pasos


2. Utilizando la siguiente tabla como guía, especifique una Dimensión, Acción y Tipo de elemento

para cada variable de elemento.

Tipo de elementoAcciónDimensiónVariable de elemento

NuméricoCreardateV4

NuméricoCrearelementoV10

NuméricoCrearclienteV14

NuméricoCreartrabajoV17

NuméricoCrearpaísV18

NuméricoCrearagenteV19

NuméricoCrearlibroV20

NuméricoCrearmedidaVariables de datos

Puede aceptar los valores predeterminados de Orden en el cubo de cada variable.

Cuando haya terminado, la subpestaña Dimensiones debería aparecer del modo siguiente:



Asignación de variables de datos

Ahora debe asignar las variables que identificó como que contenían un tipo de Datos a elementos

individuales.

Pasos

1. Haga clic en la subpestaña Datos.

2. Para la variable de datos V1, introduzca peso como el elemento al que se asignará la variable.

3. Para V2, introduzca conversión.

4. Para V3, introduzca porciones.

5. En la columna Tipo de elemento, seleccione Numérico para los tres elementos.

La subpestaña Datos debería mostrarse de la siguiente manera:

Asignación de variables de consolidación

Ahora debe asignar rutas de consolidación para todas las variables que identificó como que contenían

un contenido de Consolidación.

Pasos


2. Utilizando la siguiente tabla como guía, especifique una Dimensión y Variable de hijo para

cada consolidación.

Variable de hijoDimensiónVariable de consolidación

V6elementoV5

V7elementoV6

V8elementoV7

V9elementoV8

V10elementoV9

V12clienteV11

114 IBM Cognos TM1


Variable de hijoDimensiónVariable de consolidación

V13clienteV12

V14clienteV13

V16trabajoV15

V17trabajoV16

3. Puede aceptar el Peso y Orden de componentes predeterminado para todas las variables de

consolidación.

Cuando haya terminado, la subpestaña Consolidación debería 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 rellénelo con datos.



Pasos





con éxito.

3. Abra Server Explorer y fíjese 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 avanzadosUtilice la pestaña Avanzado de TurboIntegrator para crear parámetros que puedan trasladarse a

un proceso en el tiempo de ejecución o para editar procedimientos de un proceso, mejorando de

este modo las capacidades de TurboIntegrator. Los procedimientos se editan mediante la creación

de scripts que incorporan funciones de TurboIntegrator y funciones de reglas de TM1.

Edición de los procedimientos de Prólogo, Metadatos, Datos y EpílogoPuede 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 basándose en las opciones que seleccionó en

algún otro lugar de la ventana TurboIntegrator. Puede editar estos procedimientos añadiendo sus

propias instrucciones que incorporan funciones de TurboIntegrator y Funciones de reglas.

Los procedimientos que contiene un proceso son:

DescripciónPestaña

Una serie de acciones que se debe ejecutar antes de que se procese la fuente de datos.Prólogo

Una serie de acciones que actualizan o crean un cubo, dimensiones y otras estructuras de

metadatos durante el procesamiento.

Metadatos

Una serie de acciones de datos que se ejecutan en cada registro de la fuente de datos.Datos

Una serie de acciones que se ejecutan después de que se procese la fuente de datos.Epílogo

116 IBM Cognos TM1


Cuando edita procedimientos, tenga en cuenta que cada procedimiento está pensado para ejecutar

ciertos tipos de acción en momentos específicos de un proceso. De esta manera, debería crear

acciones o instrucciones que sean apropiadas para un procedimiento concreto.

Por ejemplo, para exportar datos procesados a un archivo ASCII, añadiría la función ASCIIOutput

al procedimiento de Datos. ASCIIOutput es una función que manipula los datos y debería ejecutarse

durante el procesamiento. Por tanto, el procedimiento de Datos es la ubicación correcta para la

función.

Edición de un procedimiento

Para editar un procedimiento:

Pasos

1. Haga clic en la pestaña Avanzado de la ventana TurboIntegrator.

2. Haga clic en la subpestaña del procedimiento que desee editar.

3. Introduzca sus instrucciones en el cuadro de texto antes de

la línea #****GENERATED STATEMENTS START****

o después de

la línea #****GENERATED STATEMENTS FINISH****.

No debería editar las instrucciones generadas entre estas dos líneas.

Creación de una dimensión con jerarquías desequilibradas

En este ejercicio, utilizará el siguiente archivo de entrada para crear una dimensión con jerarquías

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



El resultado final tendrá este aspecto:

Para comenzar a crear la dimensión:

Pasos




2. Seleccione el Tipo de fuente de datos de Texto.

3. Haga clic en el botón 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 pestaña Fuente de datos con sus parámetros predetermi-

nados.

5. Haga clic en Actualizar para ver los primeros diez registros de la fuente de datos.

118 IBM Cognos TM1




de la fuente.

Pasos


2. El la columna Contenido, seleccione Consolidación 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 dimensión y definir rutas de consolidación.

Pasos



3. Para la variable de elemento G1, introduzca desequilibrada como Dimensión, Crear para la

Acción y Numérico para el Tipo de elemento.


5. En la columnaDimensión, seleccione desequilibrada de la lista desplegable para las tres variables.

6. Para la Variable de consolidación Total, seleccione Norte como Variable de hijo.

7. Para la Variable de consolidación North, seleccione TK1 como Variable de hijo.

8. Para la Variable de consolidación TK1, seleccione G1 como Variable de hijo.



Copia de Instrucciones generadas

TM1 genera instrucciones de forma dinámica al cambiar las opciones de la ventana TurboIntegrator.

Va a editar las instrucciones generadas en las subfichas Prólogo y Metadatos de la pestaña Avanzado,

para alojar una jerarquía de dimensión desequilibrada. Para facilitar las cosas un poco, copiará y

pegará las instrucciones generadas, de manera que estén disponibles después de cambiar las opciones

de la ventana TurboIntegrator.

Pasos

1. Haga clic en la pestaña Avanzado y, a continuación, en la subpestaña Prólogo.

2. Copie las funciones DimensionDestroy y DimensionCreate que hay entre las líneas de comen-

tario



y péguelas bajo las líneas de comentario.

3. Haga clic en la subpestaña Metadatos.

Existen dos funciones:

La función DimensionElementInsert añade un elemento simple (hoja) a una dimensión. Puede

utilizar esta función para añadir tanto elementos numéricos como de cadena.

La función DimensionElementComponentAdd añade un componente (hijo) a un elemento

consolidado.

4. Copie todas las instrucciones generadas y péguelas debajo de la última línea de comentario.

120 IBM Cognos TM1


Eliminar permanentemente las instrucciones generadas

Para eliminar permanentemente las instrucciones generadas:

Pasos

1. Haga clic en la pestaña 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 pestaña Avanzado y, a

continuación, en las subpestañas Prólogo y Metadatos.

Las instrucciones deben aparecer de la siguiente manera:

Prolog>



DIMENSIONDESTROY('unbalanced');

DIMENSIONCREATE('unbalanced');

Metadata>



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);

Edición de las instrucciones de TurboIntegrator

Examine el script que está actualmente en la subpestaña Metadatos, que aparecerá de la siguiente

manera.








Este script, que se ha generado basándose en el primer registro de unbalanced.csv, es válido para

los registros que contienen cuatro campos. El script crea elementos de dimensiones de cada campo

de la fuente y, a continuación, crea una jerarquía. El script, sin embargo, no es válido 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 debería determinar el nivel

correcto de consolidación y especificar una ruta de consolidación adecuada para cada posible nivel

de consolidación. Esto se puede llevar a cabo editando el script para que incluya una función IF

que le permita ejecutar otras instrucciones de TurboIntegrator basadas en condiciones definidas.

Pasos

1. Haga clic en la pestaña Avanzado y, a continuación, en la subpestaña Metadatos.

2. Inserte la línea

IF (G1@<>'');

antes de la primera instrucción DIMENSIONELEMENTINSERT. Esta instrucción IF indica

que si la variable G1 de la cadena no está en blanco, las instrucciones que le siguen se deberán

ejecutar. Si V4está en blanco, el proceso debería saltarse la siguiente instrucción condicional.

La subpestaña Metadatos aparecerá ahora de la siguiente forma:



IF (G1@<>'');








122 IBM Cognos TM1


Cuando IF (G1@<>'') es true, TurboIntegrator inserta tres elementos consolidados (Total,

North, TK1) y un solo elemento numérico (G1) en la dimensión desequilibrada. TurboIntegrator

crea también una jerarquía de cuatro niveles, donde Total es el padre de North, North es el

padre de TK1 y TK1 es el padre de G1.


ELSEIF (TK1@<>'');

después de la última instrucción DIMENSIONELEMENTCOMPONENTADD.

Esta instrucción condicional ELSEIF indica que si la variable V3 de la cadena no está en blanco,

las instrucciones que le siguen se deberán ejecutar. Si V3está en blanco, el proceso debería saltarse

la siguiente instrucción 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 deberían crear un elemento de dimensión a partir de cada campo y, a conti-

nuación, una jerarquía de tres niveles.

5. Inserte las siguientes instrucciones inmediatamente después de ELSEIF (TK1@<>'');.



DIMENSIONELEMENTINSERT('unbalanced','',TK1,'n');



Cuando IF (TK1@<>'') es true, TurboIntegrator inserta dos elementos consolidados (TOTAL

y NORTH) y un solo elemento numérico (TK1) en la dimensión desequilibrada. TurboIntegrator

crea también una jerarquía de tres niveles donde TOTAL es el padre de NORTH y NORTH

es el padre de TK1.


ELSE;

después de la última instrucción DIMENSIONELEMENTCOMPONENTADD.

7. Debe insertar las instrucciones que desea ejecutar cuando el proceso llegue a la instrucción

ELSE. (Esto sucede cuando tanto IF (G1@<>'') como ELSEIF (TK1@<>'') son false.)

Cuando el proceso llega a la instrucción ELSE, el registro fuente contiene dos campos. Las

instrucciones que inserte deberían crear un elemento de dimensión a partir de cada campo y,

a continuación, una jerarquía de dos niveles.

8. Inserte las siguientes instrucciones inmediatamente después de ELSE;.


DIMENSIONELEMENTINSERT('unbalanced','',NORTH,'n');


Estas instrucciones le indican a TurboIntegrator que inserte el elemento consolidado TOTAL

y el elemento numérico NORTH en la dimensión desequilibrada, y que cree una jerarquía

donde TOTAL es el padre de NORTH.




ENDIF;

después de la instrucción final DIMENSIONELEMENTCOMPONENTADD. ENDIF indica

el final de la instrucción IF.

Cuando haya terminado, la subpestaña Metadatos completada debería aparecer de la manera

siguiente:



IF (G1@<>'');








ELSEIF (TK1@<>'');



DIMENSIONELEMENTINSERT('unbalanced','',TK1,'n');



ELSE;


DIMENSIONELEMENTINSERT('unbalanced','',NORTH,'n');


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 dimensión se ha construido correctamente, abra la dimensión desequilibrada

en el Editor de dimensiones. Debería tener el aspecto de la siguiente imagen.

124 IBM Cognos TM1


Creación de subconjuntosEn este ejercicio creará subconjuntos para la dimensión newdim, que se crea por medio del proceso

de la dimensión.

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 cómo se deberían 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í están los scripts de los subconjuntos del proceso:

Prolog>



SubsetCreate('NewDim','Europe');

SubsetCreate('NewDim','US');

SubsetCreate('NewDim','ROW');

Metadata>



SubsetElementInsert('NewDim',V4,V0,0);

2. Ejecute el proceso.

3. En Server Explorer, amplíe la dimensión newdim y vea los subconjuntos que acaba de crear.

Creación de atributosLa función AttrPutS asigna un valor a un atributo de elemento de cadena. Si desea asignar la cadena

Europe al atributo Continent del país Sweden en la dimensión NewDim, escribiría la función 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 cómo se deberían tratar las

variables del proceso. Seleccione Mantener todas las variables.

126 IBM Cognos TM1



Tenga en cuenta que V4 y V5 se han identificado como Atributo.

3. Haga clic en la celda Fórmula de V5.

Aparece V5=V0|V4;

Esta fórmula concatena los valores de las variables V4 y V5.

4. Haga clic en la pestaña Asignaciones y en la subpestaña 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 pestaña Avanzado y en la subpestaña Datos para mostrar las instrucciones

generadas y dos instrucciones adicionales.


V5=v0|v4;

AttrPutS(V4,'newdim',V0,'continent');

AttrPutS(V5,'newdim',V0,'cont');




Las dos instrucciones anteriores se añadieron manualmente porque V1 y V2 no se declararon

como contenido en la pestaña Variables. Sin embargo, deben asignarse al atributo de texto

Continent.

6. Guarde y ejecute el proceso Atributos

Ver los atributos

Después de asignar un valor de atributo, puede visualizar la asignación de la siguiente manera.

Pasos

1. En Server Explorer, haga doble clic en la dimensión newdim para abrir el Editor de subconjuntos.

2. Haga clic en el botón Agrupar todo en un subconjunto .

3. Seleccione Editar, Filtro por, Atributo en el menú para mostrar el cuadro de diálogo Filtro por

atributo.

4. Seleccione un valor de atributo de la lista desplegable del cuadro de diálogo Filtro por atributo

para visualizar en el Editor de subconjuntos todos los países de un continente determinado.



128 IBM Cognos TM1


Apéndice B: Palabras reservadas de TurboIntegra-tor

Este anexo contiene las palabras reservadas de IBM® Cognos® TM1® TurboIntegrator. Para prevenir

errores en sus scripts de TurboIntegrator, debería evitar crear variables de TM1 con nombres que

coincidan con cualquiera de las palabras aparecen en las tablas siguientes.

Hay cuatro categorías de palabras reservadas en TurboIntegrator:

● Nombres de funciones de regla

● Nombres de funciones de proceso

● Nombres de variables implícitas

● Palabras clave de TurboIntegrator

Nombres de funciones de reglaIncluimos 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


● 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

Apéndice 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



● SCELL

● SIGNO

● SENO

● SLEEP

● RAIZ

● STDDV

● STR

● SUBSIZ

● SUBST

● SUMA

● TABDIM

● TAN

● HORA

● TIMST

● TIMVL

● HOY

● ESPACIOS

● UNDEF

● MAYUSC

● VAR

● WHOAMI

● WIDTH

● AÑO

● YRS

Nombres de funciones de procesoEstos son los nombres de funciones de proceso TurboIntegrator:

● AddClient

● AddGroup

● AllowExternalRequests

132 IBM Cognos TM1


● 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



● 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


● 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



● 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


● ViewZeroOut

● WildcardFileSearch

Nombres de variables implícitasEsto son los nombres de variables implícitas 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



● SValue

● Value_Is_String

Palabras clave de TurboIntegratorEstas son las palabras clave de TurboIntegrator reservadas.

● break

● else

● elseif

● end

● endif

● if

● while

138 IBM Cognos TM1


Índice

Aadditional 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

dimensión, 21

subconjunto de dimensión, 33

variables, 20

variables de consolidación a dimensión, 25

variables de cubo, 24

variables de elemento de dimensión, 25

asunto de consulta de hecho detallado, 81

BBW SAP

directrices para utilizar datos de hecho, 84

Ccampo Cadena de filtro, 67

campo Nombre de tabla, 67

característica, 59

asignar, 52, 74

cifras clave, 52, 69, 74

cifras clave detalladas, 81

cláusula WHERE, 67

client, 50

comodines, 65

conexión

cadena de TM1, 36

cadena MSAS, 36

parámetros SAP, 49, 73

consolidaciones

asignar, 21

múltiples, 21

subconjunto de dimensión, 33

consulta

SQL, 27

consulta BW SAP

especificación de la solicitud de segmentación, 89

Consultar la fuente de datos, 106

consultas paralelas, 89

consulta SQL, 27

contraseña, 50

Convención de nomenclatura universal

fuente de datos, 15

cubo

archivo sin formato ASCII, 23

asignar, 20, 24

creación, 23

fuente de datos, 23

variables, 24

vista, 31

Ddatos

asignar, 21

fuente, 11, 15, 17, 23, 31, 32

fuente ODBC, 27

procedimiento, 11

variables, 25

Datos BW SAP

Cognos Planning, 81

dimensión

archivo ASCII sin formato, 15

asignar, 21

asignar variables de consolidación, 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


Eelementos

importar desde fuentes de datos, 15

extracción de datos

directrices de BW SAP para utilizar las variables, 84

Ffiltro de nombre de usuario, 63

filtro de rol, 63

funciones

uso en procesos TurboIntegrator, 10

IIBM Cognos 8 Planning y datos BW SAP, 81

idioma, 50

importar datos

descripción general, 9

InfoCube, 50, 64

MMDX, 28

medidas

para IBM Cognos 8 Planning, 81

Microsoft Analysis Services, 35, 40, 44

cadena de conexión, 36

conexión, 38

importación de una dimensión, 41

importación de un cubo, 37

modo de carga de gran volumen, 91

modo de prueba

ejecución con un proceso de TurboIntegrator, 13

Funciones de TurboIntegrator, 14

utilización con procesos TurboIntegrator, 13

MSAS

cadena de conexión, 36

OODBC, 9

catálogo, 35

definición de fuente de datos, 27

fuente de datos, 27

ODBO

Catálogo, 35

cubo, 39

dimensión, 43

dimensiones de cubo, 39, 40

fuente de datos, 35

Fuente de datos, 35

guardar cubo, 40

guardar dimensión, 43

Nombre del proveedor, 35

ubicación, 35

Ubicación, 35

OLAP, 35

OLE_LINK1, 117

OLE DB, 35

Ppacket size, 50

palabras reservadas


funciones de proceso, 132

funciones de regla, 129

nombres de variables implícitas, 137

palabras clave de TurboIntegrator, 138

parámetro de la fuente de datos, 106

procedimiento de Epílogo, 11

procedimiento de metadatos, 11

procedimiento de prólogo, 11

proceso

consejos, 12

definición, 10

edición, 93

ejecutar, 22, 94

ejecutar ODBO, 44

guardar, 22, 44

procedimientos, 11

procesos TI

recomendaciones, 12

Rregistro de mensajes, 44

registros, longitud fija, 17

registros de longitud fija, 17

SSAP

asignar, 50, 52, 60, 64, 67, 69, 74

BW, 49, 73

características, 45, 52, 59, 74

cifras clave, 52, 69, 74

cubo de consulta, 46

140 IBM Cognos TM1

Índice

cubos de consulta, 45

dimensiones, 45

divisa, 64

establecimiento de una conexión con BW, 49, 73

importación, 60

importar seguridad, 62

jerarquía de objeto, 46

jerarquías, 45, 52, 60, 74

nombres técnicos, 46

parámetros de conexión, 49, 73

RFC, 46

roles, 63

terminología, 45

utilizar comodines, 65

seguridad

importar desde SAP, 60, 62

servidor registrado, 35

solicitudes

especificación de la segmentación de la consulta BW

SAP, 89

STET, 12

system, 50

Ttablas ODS, 69

exportar a, 68

tarea

asistente para la configuración, 94

definición, 10, 94

ejecución automática, 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

creación, 100, 101, 109, 125, 126

crear dimensiones, 101


directorio de datos, 99

editar procedimientos dentro de un proceso, 116

UUNC, 15

user, 50

Vvariables

asignar, 20

asignar a dimensión, 25

asignar consolidación a dimensión, 25

asignar cubo, 24

cubo, 24

directrices para utilizar datos de hecho BW SAP, 84

fuente de datos, 17

nombres por defecto, 17


Índice

guia turbo integrator

Documents