Dawniej znany jako Adaptive Insights, konektor Workday Adaptive Planning używa poleceń w łańcuchu do importowania lub eksportowania danych lub metadanych.
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
Aby włączyć połączenie, konektor korzysta z interfejsu API REST Workday Adaptive Planning. Aby skonfigurować złącze, będziesz potrzebować
- Użytkownik integracji skonfigurowany w Adaptive Planning, któremu przypisano rolę z odpowiednimi uprawnieniami do wykonywania poleceń łącznika.
- Nazwa użytkownika i hasło użytkownika integracji.
- Jeśli użytkownik integracji może uzyskać dostęp do wielu wystąpień Adaptive Planning, podaj kod wystąpienia, z którym będzie się łączyć.
Uwaga: Aby określić dostępne kody wystąpień użytkownika integracji, możesz użyć punktu końcowego API Adaptive Planning
exportInstances.
Skonfiguruj konektor Workday Adaptive Planning
Uwaga: Aby udostępnić łącznik do użytku w łańcuchach organizacji, administrator bezpieczeństwa organizacji najpierw włącza go z Konfiguracja.
- Na stronie Chain Builder kliknij Connections , a następnie Create w prawym górnym rogu.
- W sekcji Connector Connection wybierz Workday Adaptive Planning i domyślny CloudRunner.
Workiva oferuje dwie metody uwierzytelniania (Basic i JWT Bearer Grant (Workday Credentials)). Możesz wybrać ten, którego chcesz użyć pod Credentials w konfiguracji połączenia.
Uwierzytelnianie przy użyciu uwierzytelniania podstawowego
- W sekcji Properties opcjonalnie wprowadź kod instancji dla instancji Adaptive Planning.
- Wybierz "Poświadczenie podstawowe" jako typ uwierzytelniania.
- Wprowadź następujące wartości:
Username: Nazwa użytkownika integracji, która ma być używana z łącznikiem.
Hasło: Hasło użytkownika podane w polu Nazwa użytkownika.
Uwierzytelnij się za pomocą JWT Bearer Grant (Workday Credentials)
Ta metoda uwierzytelniania wykorzystuje poświadczenia Workday do uwierzytelniania w Adaptive Planning i wymaga, aby:
- SSO jest włączone.
- Ustawienia dzierżawy Workday dla Adaptive Planning User Sign-on i Public APIs są włączone.
- Publiczny interfejs API ISU jest mapowany między Workday i Adaptive Planning.
Aby uzyskać szczegółowe informacje na temat tej konfiguracji, zapoznaj się z następującą dokumentacją Workday:
- Skonfiguruj SAML SSO w Adaptive Planning dla zsynchronizowanych użytkowników
- Rozwiązywanie problemów: Synchronizacja użytkownika z planowaniem adaptacyjnym
W ramach tej konfiguracji klucz prywatny x509 musi zostać przesłany do części Connection Resources tego połączenia, a certyfikat publiczny utworzony na podstawie tego klucza musi zostać przesłany do Workday i powiązany z klientem API typu "JWT Bearer Grant". Ten klient z kolei musi być powiązany z ISU, którego używasz do żądań do Adaptive Planning, ze zmapowanymi poświadczeniami między dwoma systemami.
Aby uzyskać szczegółowe informacje na temat tej konfiguracji, zapoznaj się z następującą dokumentacją Workday: Zarejestruj klientów API.
Kluczowe szczegóły
Obsługiwany format klucza prywatnego to PKCS#8 i może on być chroniony hasłem lub nie. Nowy klucz można utworzyć za pomocą openssl z następującym poleceniem:
openssl req -x509 \ -newkey rsa:2048 \ -keyout key.pem \ -out cert.pem -days 3650
Określanie hosta, domeny i dzierżawy Workday
Korzystając z punktu końcowego Workday REST API wymienionego w sekcji Klient API, zidentyfikuj hosta, domenę i dzierżawcę w formacie https://{host}.{domain}/ccx/api/v1/{tenant}
Przykład
https://wd2-impl-services1.workday.com/ccx/api/v1/mycompany
| Właściwość | Wartość |
| Najemca | mycompany |
| Gospodarz | wd2-impl-services1 |
| Domena | workday.com |
Skonfiguruj typ poświadczeń Bearer w konektorze Adaptive Planning
- Prześlij swój klucz prywatny do części Zasoby połączenia.
- Wybierz typ uwierzytelniania "Bearer".
- Wprowadź następujące informacje:
Właściwość Szczegóły klucz prywatny x509 Wprowadź nazwę przesłanego klucza prywatnego dokładnie tak, jak pokazano w zasobach połączenia. Hasło Wprowadź hasło klucza prywatnego. Pozostaw to pole puste, jeśli klucz nie jest chroniony hasłem. Identyfikator klienta Wprowadź Client ID klienta JWT Bearer Grant API. Użytkownik usługi integracji Wprowadź nazwę użytkownika usługi integracji (ISU) powiązanego z klientem API Gospodarz Wprowadź host środowiska Workday, z którym chcesz się połączyć. W adresie URL środowiska znaki przed właściwością Domain reprezentują hosta. Najemca Wprowadź dzierżawcę Workday, z którym chcesz się połączyć. Domena Wprowadź domenę środowiska Workday, z którym chcesz się połączyć, np. workday.com lub myworkday.com.
Po skonfigurowaniu uwierzytelniania:
- Wybierz środowiska, w których ma być używane połączenie i kliknij Zapisz.
- Aby przetestować połączenie, utwórz i uruchom łańcuch z poleceniem konektora Export Versions i sprawdź, czy zwraca prawidłowe dane wyjściowe.
Rozwiązywanie problemów
Jeśli połączenie z usługą Workday Adaptive Planning nie powiedzie się:
- Zweryfikuj poświadczenia uwierzytelniania użytkownika integracji.
- Upewnij się, że rola użytkownika integracji ma odpowiednie uprawnienia do poleceń wykonywanych przez łącznik.
- Jeśli użytkownik integracji może uzyskać dostęp do wielu wystąpień Adaptive Planning, sprawdź kod wystąpienia wprowadzony dla łącznika.
Aby uzyskać dodatkowe informacje na temat tworzenia żądań API Adaptive Planning przy użyciu poświadczeń Workday, zobacz tę stronę Workday: Wykonuj żądania API Adaptive Planning przy użyciu poświadczeń Workday.