Portail de support Workiva

Avec le connecteur IBM® Planning Analytics® TM1®, vous pouvez utiliser les commandes dans une chaîne pour interagir avec IBM Planning Analytics, powered by Cognos® TM1. Par exemple, avec ce connecteur, vous pouvez :

• Gérer les corvées et leurs tâches dans Planning Analytics
• Gérer les cubes TM1, les vues des cubes et les cellules
• Filtrer les journaux de messages et de transactions
• Gérer les processus et leurs journaux d'erreurs

Note: Ce connecteur est construit par Workiva et se connecte à un système tiers. Bien que notre équipe d'assistance puisse vous aider à configurer ce connecteur dans votre espace de travail, nous ne sommes pas en mesure de dépanner ou d'aider à résoudre des problèmes qui proviennent de l'extérieur de la plateforme Workiva.

Conditions préalables

Pour activer la connexion, le connecteur utilise l'API REST d'IBM Planning Analytics. Note : Le connecteur est compatible avec la version 10.2 ou supérieure d'IBM Planning Analytics.

Pour établir la connexion, vous aurez besoin des éléments suivants :

• L'URL complète de l'instance TM1 à laquelle se connecter, par exemple https://TM1-url.com/api/v1
• Un compte de service désigné dans l'instance TM1 pour le connecteur
• Nom d'utilisateur et mot de passe du compte de service
• Informations d'authentification supplémentaires pour le serveur TM1, si Integrated Windows@ authentication (IWA) ou Cognos Authentication Manager (CAM) est activé.
  • Si l'IWA est activé, son jeton d'authentification
  • Si la fonction CAM est activée, son espace de noms LDAP (Lightweight Directory Access Protocol) est activé.
• Pour se connecter à un serveur TM1 sur site, le GroundRunner pour exécuter les commandes

  Note : Pour se connecter à une instance cloud de TM1, utilisez le CloudRunner par défaut.

Configurer le connecteur IBM Planning Analytics TM1

Note : pour que le connecteur puisse être utilisé dans les chaînes de votre organisation, un admin de sécurité de l’org. doit d’abord l’activer à partir de Configuration.

1. À partir du Générateur de chaînes, cliquez sur Connexions  compare_arrows, puis sur Créer en haut à droite.
2. Sous Connecteur Connexion, sélectionnez IBM Planning Analytics TM1 et le programme d'exécution à utiliser avec le connecteur.
   
3. Sous Informations de base, entrez un nom et une description uniques pour aider à identifier la connexion.
4. Sous Propriétés, entrez les détails de la connexion :
   
   

   Propriété	Détails
   TM1 API Url	Saisissez l'URL complète de l'instance TM1 à laquelle se connecter, par exemple https://TM1-url.com/api/v1.
   Nom d’utilisateur	Saisissez le nom d'utilisateur du compte de service du connecteur dans l'instance TM1.
   Mot de passe	Saisissez le mot de passe pour la propriété Username.
   Jeton	Si l'authentification Windows intégrée (IWA) est activée pour le serveur TM1, saisissez son jeton d'authentification.
   Type d'authentification	Sélectionnez le type d'authentification activé pour le serveur TM1 : Auth de base, pour l'authentification du nom d'utilisateur et du mot de passe de TM1 uniquement. Authentification intégrée de Windows, si IWA est activé Cognos Authentication Manager (CAM), si la sécurité Cognos est activée
   Espace de noms LDAP	Si le CAM est activé, entrez son espace de noms LDAP.

   Note : toutes les informations d’identification sensibles sont automatiquement chiffrées et stockées avec un chiffrement Advanced Encryption Standard (AES)-256.

5. Sélectionnez les environnements qui utiliseront la connexion et cliquez sur Enregistrer.
6. Pour tester la connexion, créez et exécutez une chaîne avec la commande List Cubes du connecteur et vérifiez qu'elle renvoie une sortie valide.

Dépannage

Si la connexion à IBM Planning Analytics échoue :

• Vérifiez l'URL de l'instance TM1 à laquelle se connecter.
• Vérifiez les informations d'authentification du compte de service.
• Vérifiez le type d'authentification activé pour le serveur TM1 et les informations d'identification correspondantes, telles que le jeton IWA ou l'espace de noms LDAP.

Si vous recevez l'erreur Unable to find valid certification path to requested target, ajoutez le certificat du serveur à votre keystore Java® de confiance :

1. Pour obtenir le certificat du serveur, entrez cette commande :

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

2. Pour importer le certificat dans votre keystore, entrez cette commande :

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

   Note : Le mot de passe de votre keystore peut être changeit.