Med IBM® Planning Analytics® TM1® Connector kan du bruke kommandoer i en kjede for å samhandle med IBM Planning Analytics, drevet av Cognos® TM1. Med denne kontakten kan du for eksempel
- Administrer oppgaver og deres oppgaver i Planning Analytics
- Administrere TM1-kuber og kubevisninger og -celler
- Filtrer meldings- og transaksjonslogger
- Administrere prosesser og deres feillogger
Merk: Denne kontakten er bygget av Workiva og kobles til et tredjepartssystem. Supportteamet vårt kan hjelpe deg med å konfigurere denne koblingen i arbeidsområdet ditt, men vi kan ikke feilsøke eller på annen måte hjelpe deg med problemer som oppstår utenfor Workiva-plattformen.
Forutsetninger
For å aktivere tilkoblingen bruker kontakten IBM Planning Analytics REST API. Merk: Koblingen støtter IBM Planning Analytics versjon 10.2 eller nyere.
For å sette opp tilkoblingen trenger du:
- Den fullstendige URL-en til TM1-forekomsten du skal koble deg til, for eksempel
https://TM1-url.com/api/v1 - En utpekt tjenestekonto som er satt opp i TM1-forekomsten for kontakten
- Tjenestekontoens brukernavn og passord
- Ytterligere autentiseringsopplysninger for TM1-serveren, hvis Integrated Windows@ authentication (IWA) eller Cognos Authentication Manager (CAM) er aktivert
- Hvis IWA er aktivert, vil autentiseringstokenet
- Hvis CAM er aktivert, vil LDAP-navnerommet (Lightweight Directory Access Protocol)
- Hvis du vil koble til en lokal TM1-server, bruker du GroundRunner for å utføre kommandoene
Merk: Hvis du vil koble til en skyforekomst av TM1, bruker du standard CloudRunner.
Konfigurer IBM Planning Analytics TM1-tilkoblingen
Merk: For å gjøre kontakten tilgjengelig for bruk i organisasjonens kjeder, må en sikkerhetsadministrator i organisasjonen først aktivere den fra Configuration.
- Fra Chain Builder klikker du på Connections, og deretter Create øverst til høyre.
- Under Connector Connection velger du IBM Planning Analytics TM1 og løperen som skal brukes med connectoren.
- Under Basic Info angir du et unikt navn og en beskrivelse for å identifisere tilkoblingen.
- Under Properties angir du detaljer om tilkoblingen:
Egenskap Detaljer TM1 API-URL Skriv inn den fullstendige URL-en til TM1-forekomsten du vil koble til, for eksempel https://TM1-url.com/api/v1.Brukernavn Skriv inn brukernavnet for kontaktens tjenestekonto i TM1-forekomsten. Passord Skriv inn passordet for egenskapen Username. Token Hvis integrert Windows-autentisering (IWA) er aktivert for TM1-serveren, skriver du inn autentiseringstokenet. Autentiseringstype Velg hvilken type autentisering som er aktivert for TM1-serveren: - Basic Auth, kun for TM1-brukernavn og passordautentisering
- Windows Integrated Authentication, hvis IWA er aktivert
- Cognos Authentication Manager (CAM), hvis Cognos-sikkerhet er aktivert
LDAP-navnerom Hvis CAM er aktivert, angir du LDAP-navneområdet. Merk: Alle sensitive opplysninger krypteres automatisk og lagres med Advanced Encryption Standard (AES)-256-kryptering.
- Velg miljøene som skal bruke tilkoblingen, og klikk på Lagre.
- For å teste tilkoblingen kan du opprette og kjøre en kjede med -kontaktens List Cubes -kommando, og kontrollere at den returnerer en gyldig utdata.
Feilsøking
Hvis tilkoblingen til IBM Planning Analytics mislykkes:
- Kontroller URL-adressen for TM1-forekomsten du skal koble til.
- Bekreft tjenestekontoens autentiseringsopplysninger.
- Kontroller hvilken type autentisering som er aktivert for TM1-serveren og tilhørende legitimasjon, for eksempel IWA-token eller LDAP-navneområde
Hvis du får feilen Unable to find valid certification path to requested target, må du legge til serversertifikatet i det klarerte Java® -nøkkelmagasinet:
- Skriv inn denne kommandoen for å hente sertifikatet fra serveren:
# openssl s_client -connect tm1server.tux:5010 -servername tm1server.tux:5010 < /dev/null | sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' > public.crt
- For å importere sertifikatet til keystore, skriver du inn denne kommandoen:
# /usr/lib/jvm/java-8-openjdk-amd64$ sudo bin/keytool -import -alias tm1server.tux -keystore jre/lib/security/cacerts -file /home/administrator/public.crt
Merk: Passordet til din keystore kan være
changeit.