Centrum wsparcia Workiva

Dzięki konektorowi IBM® Planning Analytics® TM1® możesz używać poleceń w łańcuchu do interakcji z IBM Planning Analytics, obsługiwanym przez IBM Cognos® TM1. Na przykład, za pomocą tego złącza możesz:

• Zarządzaj obowiązkami i ich zadaniami w Planning Analytics
• Zarządzaj kostkami TM1, widokami kostek i komórkami
• Filtruj dzienniki wiadomości i transakcji
• Zarządzaj procesami i ich dziennikami błędów

Uwaga: To złącze jest zbudowane przez Workiva i łączy się z systemem innej firmy. Chociaż nasz zespół pomocy technicznej może pomóc w skonfigurowaniu tego łącznika w Twojej przestrzeni roboczej, nie jesteśmy w stanie rozwiązywać problemów ani w inny sposób pomagać w przypadku jakichkolwiek problemów, które powstały poza platformą Workiva.

Wymagania wstępne

Aby włączyć połączenie, konektor korzysta z interfejsu API REST IBM Planning Analytics. Uwaga: Konektor obsługuje IBM Planning Analytics w wersji 10.2 lub nowszej.

Aby skonfigurować połączenie, będziesz potrzebować:

• Pełny adres URL instancji TM1, z którą chcesz się połączyć, np. https://TM1-url.com/api/v1
• Wyznaczone konto usługi skonfigurowane w instancji TM1 dla łącznika
• Nazwa użytkownika i hasło konta usługi
• Dodatkowe poświadczenia uwierzytelniania dla serwera TM1, jeśli włączone jest uwierzytelnianie Integrated Windows@ authentication (IWA) lub Cognos Authentication Manager (CAM)
  • Jeśli usługa IWA jest włączona, jej token uwierzytelniania
  • Jeśli funkcja CAM jest włączona, jej przestrzeń nazw protokołu LDAP (lightweight directory access protocol)
• Aby połączyć się z lokalnym serwerem TM1, GroundRunner, aby wykonać polecenia

  Uwaga: Aby połączyć się z wystąpieniem TM1 w chmurze, użyj domyślnego CloudRunner.

Skonfiguruj konektor IBM Planning Analytics TM1

Uwaga: Aby udostępnić łącznik do użytku w łańcuchach organizacji, administrator bezpieczeństwa organizacji najpierw włącza go z Konfiguracja.

1. Na stronie Chain Builder kliknij Connectionscompare_arrows, a następnie Create w prawym górnym rogu.
2. W sekcji Connector Connection wybierz IBM Planning Analytics TM1 i runner, który ma być używany z konektorem.
   
3. W sekcji Basic Info wprowadź unikalną nazwę i opis, aby ułatwić identyfikację połączenia.
4. W sekcji Properties wprowadź szczegóły połączenia:
   
   

   Właściwość	Szczegóły
   Adres URL API TM1	Wprowadź pełny adres URL instancji TM1, z którą chcesz się połączyć, np. https://TM1-url.com/api/v1.
   Nazwa użytkownika	Wprowadź nazwę użytkownika konta usługi konektora w instancji TM1.
   Hasło	Wprowadź hasło dla właściwości Username.
   Token	Jeśli zintegrowane uwierzytelnianie systemu Windows (IWA) jest włączone dla serwera TM1, wprowadź jego token uwierzytelniania.
   Typ uwierzytelniania	Wybierz typ uwierzytelniania włączony dla serwera TM1: Basic Auth, tylko do uwierzytelniania nazwy użytkownika i hasła TM1 Zintegrowane uwierzytelnianie systemu Windows, jeśli włączona jest funkcja IWA Cognos Authentication Manager (CAM), jeśli zabezpieczenia Cognos są włączone
   Przestrzeń nazw LDAP	Jeśli funkcja CAM jest włączona, wprowadź jej przestrzeń nazw LDAP.

   Uwaga: Wszystkie poufne dane uwierzytelniające są automatycznie szyfrowane i przechowywane przy użyciu szyfrowania Advanced Encryption Standard (AES) -256.

5. Wybierz środowiska, w których ma być używane połączenie i kliknij Zapisz.
6. Aby przetestować połączenie, utwórz i uruchom łańcuch za pomocą polecenia List Cubes konektora i sprawdź, czy zwraca prawidłowe dane wyjściowe.

Rozwiązywanie problemów

Jeśli połączenie z IBM Planning Analytics nie powiedzie się:

• Sprawdź adres URL instancji TM1, z którą chcesz się połączyć.
• Zweryfikuj poświadczenia uwierzytelniania konta usługi.
• Zweryfikuj typ uwierzytelniania włączony dla serwera TM1 i powiązane z nim dane uwierzytelniające, takie jak token IWA lub przestrzeń nazw LDAP

Jeśli pojawi się błąd Unable to find valid certification path to requested target, dodaj certyfikat serwera do zaufanego magazynu kluczy Java®:

1. Aby uzyskać certyfikat z serwera, wprowadź to polecenie:

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

2. Aby zaimportować certyfikat do magazynu kluczy, wprowadź to polecenie:

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

   Uwaga: Hasłem do Twojego magazynu kluczy może być changeit.