Con il connettore IBM® Planning Analytics® TM1®, puoi utilizzare i comandi in una catena per interagire con IBM Planning Analytics, powered by Cognos® TM1. Ad esempio, con questo connettore puoi:
- Gestire le attività e i loro compiti in Planning Analytics
- Gestire i cubi TM1, le viste e le celle dei cubi
- Filtrare i log dei messaggi e delle transazioni
- Gestire i processi e i loro log di errore
Nota: Questo connettore è stato realizzato da Workiva e si collega a un sistema di terze parti. Sebbene il nostro team di assistenza possa aiutare a configurare questo connettore all'interno del tuo spazio di lavoro, non siamo in grado di risolvere i problemi o di fornire assistenza in altro modo per qualsiasi problema che abbia origine al di fuori della piattaforma Workiva.
Prerequisiti
Per attivare la connessione, il connettore utilizza l'API REST di IBM Planning Analytics. Nota: il connettore supporta la versione 10.2 o superiore di IBM Planning Analytics.
Per configurare la connessione, avrai bisogno di:
- L'URL completo dell'istanza TM1 a cui connettersi, ad esempio
https://TM1-url.com/api/v1 - Un account di servizio designato impostato nell'istanza TM1 per il connettore
- Nome utente e password dell'account di servizio
- Credenziali di autenticazione aggiuntive per il server TM1, se Autenticazione integrata Windows@ (IWA) o Cognos Authentication Manager (CAM) è abilitato
- Se IWA è abilitato, il suo token di autenticazione
- Se CAM è abilitato, il suo spazio dei nomi LDAP (lightweight directory access protocol)
- Per connettersi a un server TM1 on-premise, il GroundRunner per eseguire i comandi
Nota: Per connettersi a un'istanza cloud di TM1, usa il CloudRunner predefinito.
Configura il connettore IBM Planning Analytics TM1
Nota: Per rendere il connettore disponibile per l'uso nelle catene della tua organizzazione, un amministratore della sicurezza dell'org deve prima abilitarlo da Configurazione.
- Da Builder catena, clicca su Connessioni e poi su Crea in alto a destra.
- Sotto Connettore Connessione, seleziona IBM Planning Analytics TM1 e il runner da utilizzare con il connettore.
- In Informazioni di base, inserisci un nome e una descrizione unici per identificare la connessione.
- In Proprietà, inserisci i dettagli della connessione:
Proprietà Dettagli TM1 API Url Inserisci l'URL completo dell'istanza TM1 a cui connettersi, ad esempio https://TM1-url.com/api/v1.Nome utente Inserisci il nome utente dell'account di servizio del connettore nell'istanza TM1. Password Inserisci la password per la proprietà Nome utente. Token Se l'autenticazione integrata di Windows (IWA) è abilitata per il server TM1, inserisci il suo token di autenticazione. Tipo di autenticazione Seleziona il tipo di autenticazione abilitata per il server TM1: - Autenticazione di base, solo per l'autenticazione con nome utente e password di TM1
- Autenticazione integrata di Windows, se IWA è abilitato
- Cognos Authentication Manager (CAM), se la sicurezza Cognos è abilitata
Spazio dei nomi LDAP Se CAM è abilitato, inserisci il suo spazio dei nomi LDAP. Nota: Tutte le credenziali sensibili vengono automaticamente crittografate e memorizzate con la crittografia Advanced Encryption Standard (AES)-256.
- Seleziona gli ambienti da utilizzare per la connessione e clicca su Salva.
- Per testare la connessione, crea ed esegui una catena con il comando List Cubes del connettore e verifica che restituisca un output valido.
Risoluzione dei problemi
Se la connessione a IBM Planning Analytics fallisce:
- Controlla l'URL dell'istanza TM1 a cui connettersi.
- Verifica le credenziali di autenticazione dell'account di servizio.
- Verifica il tipo di autenticazione abilitata per il server TM1 e le relative credenziali, come il token IWA o lo spazio dei nomi LDAP.
Se ricevi l'errore Unable to find valid certification path to requested target, aggiungi il certificato del server al keystore Java® di fiducia:
- Per ottenere il certificato dal server, inserisci questo comando:
# openssl s_client -connect tm1server.tux:5010 -servername tm1server.tux:5010 <> public.crt
- Per importare il certificato nel keystore, inserisci questo 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 password del keystore può essere
changeit.