Uwaga: Ten łącznik opracowany przez firmę Workiva umożliwia połączenie platform Workiva i Workday. Wsparcie techniczne Workiva chętnie przeprowadzi Cię przez proces konfiguracji łącznika w Twojej przestrzeni roboczej. Jednak wszelkie błędy na platformie Workday lub rozwiązywanie problemów w ramach platformy Workday muszą być obsługiwane przez administratora platformy Workday lub jego zespół wsparcia.
Łącznik Workday umożliwia użycie poleceń w łańcuchu w celu interakcji z modułem HR i modułem finansowym Workday® w celu:
- Pobierz niestandardowe raporty z Workday
- Importuj dane budżetowe do Workday
- Uruchom integrację Workday Enterprise Interface Builder (EIB)
Wymagania
Aby nawiązać połączenie, będziesz potrzebować:
- Najemca Workday, z którym należy się połączyć.
- Host i domena środowiska Workday, z którym ma zostać nawiązane połączenie.
- Dane uwierzytelniające użytkownika systemu integracji utworzone w Workday.
Krok 1: Uzyskaj informacje o najemcy Workday
Informacje o dzierżawcy, hoście i domenie można ustalić w pliku WSDL XML publicznej usługi sieciowej Workday.
- Wpisz „Public Web Services” w pasku wyszukiwania Workday i wybierz ten raport.
- Znajdź usługę internetową dla konkretnej integracji, której używasz.
Przykłady obejmują: obsadę kadrową pracowników Get, zarządzanie finansami budżetu importowego, integracje dla poleceń związanych z EBI,…. - Kliknij przycisk „Powiązane działania” tej usługi, a następnie kliknij Wyświetl WSDL w menu „Usługa internetowa”.
- W pliku XML znajdź element
soapbind:address(zazwyczaj znajduje się on w dolnej części pliku). - Używając adresu URL z atrybutu
location, wyodrębnij informacje o dzierżawcy, hoście i domenie z adresu URL.
Adres URL używa następującego formatu:https://{host}.{domena}/ccx/service/{dzierżawca}/public_web_service_name/numer_wersji
Przykład
Korzystając z powyższego formatu, możemy znaleźć dzierżawcę, hosta i domenę na podstawie przykładowego adresu URL WSDL:https://wd2-impl-services1.workday.com/ccx/service/mycompany/Financial_Management/v45.1
| Właściwość | Wartość próbki |
|---|---|
| Najemca | mojafirma |
| Gospodarz | wd2-impl-services1 |
| Domena | workday.com |
Wartości te będą potrzebne podczas konfigurowania łącznika w następnym kroku.
Krok 2: Skonfiguruj uwierzytelnianie Workday
Ten łącznik oferuje dwa sposoby uwierzytelniania: OAuth2 za pośrednictwem API i użytkownik+hasło.
Uwierzytelnianie API OAuth2
Jeśli używasz uwierzytelniania API OAuth2, musisz skonfigurować klienta API w Workday. Instrukcje dotyczące tworzenia klienta API można znaleźć na stronie pomocy technicznej Workday Rejestrowanie klientów API.
W ramach konfiguracji klienta API upewnij się, że masz:
- Wybrano Nośnik jako Typ tokena dostępu.
- Włączono (zaznaczono) następujące pola wyboru:
- Niewygasające tokeny odświeżania
- Uwzględnij zakres należący do Workday
Adresy URL przekierowania
Workiva ma specyficzne dla regionu adresy URL funkcji Connection Override do konfiguracji łączników. Aby wybrać właściwy adres URL dla swojej lokalizacji, użyj poniższej tabeli.
Jeśli znajdujesz się w Ameryce Północnej, Środkowej lub Południowej, użyj domyślnego adresu URL. Jeśli znajdujesz się w regionie Azji i Pacyfiku, użyj adresu URL APAC. Jeśli znajdujesz się w regionie EMEA, użyj adresu URL UE.
| Środowisko | Adres URL przekierowania |
|---|---|
| Produkcja APAC | https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback |
| Produkcja UE | https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback |
| Produkcja amerykańska | https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback |
Punkty końcowe OAuth2
Jeśli do weryfikacji połączenia używasz protokołu OAuth2, będziesz potrzebować następujących wartości punktów końcowych. Będą one wyświetlane podczas konfigurowania klienta API Workday na stronie Edytuj klienta API w Workday.
| Punkt końcowy | Wartość próbki |
|---|---|
| Punkt końcowy REST Workday | https://xxxx.workday.com/ccx/api/v1/xxxx |
| Punkt końcowy tokena OAuth2 Workday | https://xxxx.workday.com/ccx/oauth2/xxxx/token |
| Punkt końcowy autoryzacji OAuth2 w Workday | https://xxxx.workday.com/xxxx/authorize |
WSKAZÓWKA: Jeśli używasz istniejącej instancji klienta API, która używa tokenu OAuth2 i tajnego klucza, możesz zobaczyć te informacje na górze strony Workday Wyświetl API.
Uwierzytelnianie podstawowe
Jeśli używasz uwierzytelniania podstawowego, zapoznaj się ze stroną pomocy technicznej WorkdayUtwórz konto użytkownika systemu integracji (ISU) w Workday, aby uzyskać instrukcje dotyczące tworzenia użytkownika systemu integracji (ISU).
Krok 3: Skonfiguruj łącznik Workday
Uwaga: Aby udostępnić łącznik do użytku w łańcuchach organizacji, administrator bezpieczeństwa organizacji musi go najpierw włączyć wkonfiguracji.
- W Chain Builderkliknij Connections, a następnie Create w prawym górnym rogu.
- W obszarze Połączenie łącznikawybierz Złącze Workday i domyślnego CloudRunner.
- W polu Informacje podstawowewprowadź unikalną nazwę i opis, aby ułatwić identyfikację połączenia.
-
W polu Właściwościwprowadź szczegóły połączenia.
Jeśli używasz protokołu OAuth2, musisz wprowadzić wartości dla Workday REST Endpoint, Workday OAuth2 Token Endpointi Workday OAuth2 Authorization Endpoint.
Jeśli używasz uwierzytelniania podstawowego (nazwa użytkownika + hasło), pozostaw te pola puste.Pole Zawartość Najemca Najemca Workday, z którym należy się połączyć. Gospodarz Host środowiska Workday, z którym należy nawiązać połączenie. W adresie URL środowiska znaki przed właściwością Domena reprezentują hosta. Domena Domena środowiska Workday, z którym chcesz się połączyć, np. workday.comlubmyworkday.com.Punkt końcowy REST Workday Adres URL punktu końcowego REST udostępnionego przez Workday.
(Tylko w przypadku korzystania z uwierzytelniania OAuth2.)Punkt końcowy tokena OAuth2 Workday Adres URL punktu końcowego tokena OAuth2 udostępnionego przez Workday.
(Tylko w przypadku korzystania z uwierzytelniania OAuth2.)Punkt końcowy autoryzacji OAuth2 w Workday Adres URL punktu końcowego OAuth2 udostępnionego przez Workday.
(Tylko w przypadku korzystania z uwierzytelniania OAuth2.)
Rozwiązywanie problemów
Jeśli połączenie z Workday się nie powiedzie:
- Sprawdź, czy dane uwierzytelniające użytkownika systemu integracji są prawidłowe.
- Sprawdź, czy użytkownik systemu integracji ma odpowiednie uprawnienia dostępu do grup funkcyjnych i domen związanych z poleceniami połączenia.
- Sprawdź, czy dla łącznika wprowadzono prawidłowego dzierżawcę, hosta i domenę Workday.
- Podczas uruchamiania polecenia Pobierz raport niestandardowy upewnij się, że typ raportu jest ustawiony na Zaawansowany. Raporty zbiorcze nie są obecnie dostępne za pośrednictwem interfejsu API Workday.