Workiva Support Center

Mit dem IBM® Planning Analytics® TM1® Connector können Sie Befehle in einer Kette verwenden, um mit IBM Planning Analytics, powered by Cognos® TM1, zu interagieren. Mit diesem Konnektor können Sie beispielsweise Folgendes tun:

• Verwalten von Aufgaben und deren Teilaufgaben in Planning Analytics
• Verwalten von TM1-Würfeln, Würfelansichten und Zellen
• Nachrichten- und Transaktionsprotokolle filtern
• Verwalten von Prozessen und deren Fehlerprotokollen

Hinweis: Dieser Konnektor wird von Workiva hergestellt und verbindet sich mit einem System eines Drittanbieters. Unser Support-Team kann Ihnen zwar bei der Konfiguration dieses Konnektors innerhalb Ihres Arbeitsbereichs behilflich sein, aber wir sind nicht in der Lage, Fehler zu beheben oder anderweitig bei Problemen zu helfen, die ihren Ursprung außerhalb der Workiva-Plattform haben.

Voraussetzungen

Um die Verbindung zu aktivieren, verwendet der Connector die IBM Planning Analytics REST API. Hinweis: Der Connector unterstützt IBM Planning Analytics Version 10.2 oder höher.

Um die Verbindung herzustellen, benötigen Sie:

• Die vollständige URL für die TM1-Instanz, mit der eine Verbindung hergestellt werden soll, z. B. https://TM1-url.com/api/v1
• Ein bestimmtes Dienstkonto, das in der TM1-Instanz für den Connector eingerichtet wurde
• Der Benutzername und das Passwort des Dienstkontos
• Zusätzliche Authentifizierungsdaten für den TM1-Server, wenn Integrierte Windows@-Authentifizierung (IWA) oder Cognos Authentication Manager (CAM) aktiviert ist
  • Wenn IWA aktiviert ist, wird das Authentifizierungstoken
  • Wenn CAM aktiviert ist, wird sein Lightweight Directory Access Protocol (LDAP)-Namensraum
• Um eine Verbindung zu einem TM1-Server vor Ort herzustellen, der GroundRunner um die Befehle auszuführen

  Hinweis: Um eine Verbindung zu einer Cloud-Instanz von TM1 herzustellen, verwenden Sie den Standard-CloudRunner.

Einrichten des IBM Planning Analytics TM1-Anschlusses

Hinweis: Um den Konnektor für die Verwendung in den Ketten Ihrer Organisation verfügbar zu machen, muss ein Sicherheitsadministrator der Organisation ihn zunächst aktivieren unter Konfiguration.

1. Klicken Sie unter Chain-Generator auf Verbindungen  compare_arrows und dann auf Erstellen oben rechts.
2. Wählen Sie unter Connector Verbindung, IBM Planning Analytics TM1 und den Läufer, der mit dem Connector verwendet werden soll.
   
3. Geben Sie unter Basisinformationen einen eindeutigen Namen und eine Beschreibung ein, um die Verbindung zu identifizieren.
4. Geben Sie unter Eigenschaften die Details der Verbindung ein:
   
   

   Eigenschaft	Details
   TM1 API-Url	Geben Sie die vollständige URL der TM1-Instanz ein, mit der eine Verbindung hergestellt werden soll, z. B. https://TM1-url.com/api/v1.
   Benutzername	Geben Sie den Benutzernamen für das Dienstkonto des Connectors in der TM1-Instanz ein.
   Kennwort	Geben Sie das Passwort für die Eigenschaft Benutzername ein.
   Token	Wenn die integrierte Windows-Authentifizierung (IWA) für den TM1-Server aktiviert ist, geben Sie sein Authentifizierungstoken ein.
   Art der Authentifizierung	Wählen Sie die Art der Authentifizierung, die für den TM1-Server aktiviert ist: Basic Auth, nur für TM1-Benutzername und Passwort-Authentifizierung Integrierte Windows-Authentifizierung, wenn IWA aktiviert ist Cognos Authentication Manager (CAM), wenn Cognos-Sicherheit aktiviert ist
   LDAP-Namensraum	Wenn CAM aktiviert ist, geben Sie seinen LDAP-Namensraum ein.

   Hinweis: Alle sensiblen Anmeldedaten werden automatisch verschlüsselt und mit Advanced Encryption Standard (AES)-256-Verschlüsselung gespeichert.

5. Wählen Sie die Umgebungen aus, die die Verbindung verwenden sollen, und klicken Sie auf Speichern.
6. Um die Verbindung zu testen, erstellen Sie und führen Sie eine Kette mit dem Befehl List Cubes des Konnektors aus, und überprüfen Sie, ob er eine gültige Ausgabe liefert.

Fehlersuche

Wenn die Verbindung zu IBM Planning Analytics fehlschlägt:

• Überprüfen Sie die URL der TM1-Instanz, mit der eine Verbindung hergestellt werden soll.
• Überprüfen Sie die Authentifizierungsdaten des Dienstkontos.
• Überprüfen Sie die Art der für den TM1-Server aktivierten Authentifizierung und die zugehörigen Anmeldeinformationen, wie z. B. das IWA-Token oder den LDAP-Namespace.

Wenn Sie die Fehlermeldung Unable to find valid certification path to requested target erhalten, fügen Sie das Serverzertifikat zu Ihrem vertrauenswürdigen Java® Keystore hinzu:

1. Um das Zertifikat vom Server abzurufen, geben Sie diesen Befehl ein:

   # openssl s_client -connect tm1server.tux:5010 -servername tm1server.tux:5010 < /dev/null | sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' > public.crt

2. Um das Zertifikat in Ihren Keystore zu importieren, geben Sie diesen Befehl ein:

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

   Hinweis:Das Kennwort zu Ihrem Schlüsselspeicher lautet möglicherweise changeit.