Workiva-ondersteuningscentrum

Met de IBM® Planning Analytics® TM1® connector kunt u commando's in een keten gebruiken voor interactie met IBM Planning Analytics, powered by Cognos® TM1. Met deze connector kunt u bijvoorbeeld:

• Beheer taken in Planning Analytics
• TM1-kubussen en kubusweergaven en -cellen beheren
• Berichten- en transactielogboeken filteren
• Beheer processen en hun foutenlogboeken

Opmerking: Deze connector is gebouwd door Workiva en maakt verbinding met een systeem van derden. Hoewel ons Support team kan helpen bij het configureren van deze connector binnen uw workspace, kunnen wij geen problemen oplossen of op een andere manier helpen met problemen die hun oorsprong vinden buiten het Workiva platform.

Vereisten

Om de verbinding mogelijk te maken, gebruikt de connector de IBM Planning Analytics REST API. Opmerking: De connector ondersteunt IBM Planning Analytics versie 10.2 of hoger.

Om de verbinding op te zetten, hebt u het volgende nodig:

• De volledige URL voor de TM1-instantie waarmee verbinding moet worden gemaakt, zoals https://TM1-url.com/api/v1
• Een toegewezen serviceaccount ingesteld in de TM1-instantie voor de connector
• De gebruikersnaam en het wachtwoord van de serviceaccount
• Extra verificatiegegevens voor de TM1-server, als Geïntegreerde Windows@ verificatie (IWA) of Cognos Authentication Manager (CAM) is ingeschakeld
  • Als IWA is ingeschakeld, wordt het authenticatietoken ervan
  • Als CAM is ingeschakeld, wordt de LDAP-naamruimte (lightweight directory access protocol)
• Om verbinding te maken met een on-premise TM1-server, de GroundRunner om de opdrachten uit te voeren

  Opmerking: Om verbinding te maken met een cloud-instantie van TM1, gebruikt u de standaard CloudRunner.

De IBM Planning Analytics TM1-connector instellen

Opmerking: Om de connector beschikbaar te maken voor gebruik in de ketens van uw organisatie, moet een beveiligingsbeheerder van de org deze eerst inschakelen vanuit Configuratie.

1. Ga naar Chain Builder, klik op Connectionscompare_arrows, en vervolgens op Create rechtsboven.
2. Selecteer onder Connector Connection, IBM Planning Analytics TM1 en de runner die u met de connector wilt gebruiken.
   
3. Voer onder Basisinfo een unieke naam en beschrijving in om de verbinding te helpen identificeren.
4. Onder Eigenschappen, voert u de details van de verbinding in:
   
   

   Eigendom	Details
   TM1 API URL	Voer de volledige URL in naar de TM1-instantie waarmee u verbinding wilt maken, zoals https://TM1-url.com/api/v1.
   Gebruikersnaam	Voer de gebruikersnaam in voor de serviceaccount van de connector in de TM1 instance.
   Wachtwoord	Voer het wachtwoord in voor de eigenschap Username.
   Token	Als Geïntegreerde Windows-verificatie (IWA) is ingeschakeld voor de TM1-server, voert u het verificatietoken in.
   Type verificatie	Selecteer het type verificatie dat is ingeschakeld voor de TM1-server: Basic Auth, voor alleen TM1 gebruikersnaam- en wachtwoordverificatie Windows geïntegreerde verificatie, als IWA is ingeschakeld Cognos Authentication Manager (CAM), als Cognos beveiliging is ingeschakeld
   LDAP-naamruimte	Als CAM is ingeschakeld, voert u de LDAP-naamruimte ervan in.

   Opmerking: Alle gevoelige gegevens worden automatisch versleuteld en opgeslagen met Advanced Encryption Standard (AES)-256 codering.

5. Selecteer de omgevingen om de verbinding te gebruiken en klik op Opslaan.
6. Om de verbinding te testen, maakt een ketting aan en voert deze uit met de connector's List Cubes opdracht, en controleer of deze een geldige uitvoer geeft.

Probleemoplossing

Als de verbinding met IBM Planning Analytics mislukt:

• Controleer de URL voor de TM1-instantie waarmee u verbinding wilt maken.
• Controleer de verificatiegegevens van de serviceaccount.
• Controleer het type verificatie dat is ingeschakeld voor de TM1-server en de bijbehorende referenties, zoals het IWA-token of de LDAP-naamruimte

Als u de foutmelding Unable to find valid certification path to requested target ontvangt, voeg dan het servercertificaat toe aan uw vertrouwde Java® keystore:

1. Om het certificaat van de server te krijgen, voert u dit commando in:

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

2. Om het certificaat in uw keystore te importeren, voert u dit commando in:

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

   Opmerking: Het wachtwoord van uw keystore kan changeit zijn.