Centro de soporte de Workiva

Con el conector IBM® Planning Analytics® TM1®, puedes utilizar comandos en una cadena para interactuar con IBM Planning Analytics, desarrollado por Cognos® TM1. Por ejemplo, con este conector, puedes:

• Gestiona el trabajo y sus tareas en Planning Analytics
• Gestionar cubos TM1 y vistas de cubos y celdas
• Filtrar los registros de mensajes y transacciones.
• Gestionar procesos y sus registros de errores

Nota: Este conector ha sido creado por Workiva y conecta con un sistema de terceros. Aunque nuestro equipo de asistencia puede ayudarte a configurar este conector dentro de tu espacio de trabajo, no podemos solucionar ni ayudar de ningún otro modo con los problemas que se originen fuera de la plataforma Workiva.

Requisitos previos

Para habilitar la conexión, el conector utiliza la API REST de IBM Planning Analytics. Nota: El conector es compatible con la versión 10.2 o superior de IBM Planning Analytics.

Para establecer la conexión, necesitarás:

• La URL completa de la instancia TM1 a la que conectarse, como https://TM1-url.com/api/v1
• Cuenta de servicio designada establecida en la instancia TM1 para el conector.
• Nombre de usuario y contraseña de la cuenta de servicio
• Credenciales de autenticación adicionales para el servidor TM1, si se activa Autenticación integrada Windows@ (IWA) o Cognos Autenticación Manager (CAM)
  • Si la AIT está activada, su testigo de autenticación
  • Si CAM está activado, su espacio de nombres protocolo ligero de acceso a directorios (LDAP)
• Para conectarte a un servidor TM1 local, el GroundRunner para ejecutar los comandos

  Nota: Para conectarte a una instancia de TM1 en la nube, utiliza el CloudRunner predeterminado.

Establece el conector IBM Planning Analytics TM1

Nota: Para que el conector esté disponible para su uso en las cadenas de tu organización, un administrador de seguridad de la organización primero lo habilita desde Configuración.

1. En el Generador de cadenas, haz clic en Conexiones  compare_arrows y, a continuación, en Crear en la parte superior derecha.
2. En Conector Conexión, selecciona IBM Planning Analytics TM1 y el corredor para utilizar el conector.
   
3. En Información básica, introduce un nombre único y una descripción para ayudar a identificar la conexión.
4. En Propiedades, ingresa los detalles de la conexión:
   
   

   Propiedad	Detalles
   URL API TM1	Introduce la URL completa de la instancia de TM1 a la que conectarte, como https://TM1-url.com/api/v1.
   Nombre de usuario	Introduce el nombre de usuario de la cuenta de servicio del conector en la instancia TM1.
   Contraseña	Introduce la Contraseña para la propiedad Nombre de usuario.
   Token	Si la autenticación integrada de Windows (IWA) está activada para el servidor TM1, introduce su token de autenticación.
   Tipo de Autenticación	Selecciona el Tipo de Autenticación habilitado para el servidor TM1: Autenticación básica, solo para autenticación de nombre de usuario y contraseña de TM1 Autenticación Integrada de Windows, si la IWA está activada Gestor de Autenticación de Cognos (CAM), si está activada la seguridad de Cognos.
   Espacio de nombres LDAP	Si CAM está activado, introduce su espacio de nombres LDAP.

   Nota: Todas las credenciales sensibles se cifran automáticamente y se almacenan con un cifrado Advanced Encryption Standard (AES)-256.

5. Selecciona los entornos para utilizar la conexión y haz clic en Guardar.
6. Para probar la conexión, crea y ejecuta una cadena con el comando List Cubesdel conector, y comprueba que devuelve un resultado válido.

Solución de problemas

Si falla la conexión con IBM Planning Analytics:

• Comprueba la URL de la instancia TM1 a la que conectarte.
• Verifica las credenciales de autenticación de la cuenta de servicio.
• Verifica el tipo de autenticación activado para el servidor TM1 y sus credenciales relacionadas, como el token IWA o el espacio de nombres LDAP.

Si recibes el error No se ha podido encontrar una ruta de certificación válida para el destino solicitado, añade el certificado del servidor a tu almacén de claves Java® de confianza:

1. Para obtener el certificado desde el servidor, introduce este comando:

   # openssl s_client -connect tm1server.tux:5010 -servername tm1server.tux:5010 <> public.crt

2. Para importar el certificado a tu almacén de claves, introduce este comando:

   # /usr/lib/jvm/java-8-openjdk-amd64$ sudo bin/keytool -import -alias tm1server.tux -keystore jre/lib/security/cacerts -file /home/administrator/public.crt

   Nota: La contraseña de tu almacén de claves puede ser changeit.