Power BI i eksport BI: dane HR z PeopleForce w twoim BI

Możliwości integracji

Dashboardy czytają dane bezpośrednio z PeopleForce, więc liczby w Power BI zgadzają się z systemem HR przy każdym odświeżeniu.

Aktualne zbiory danych HR przez REST API

Pracownicy z polami niestandardowymi i historią zmian, departamenty, dywizje, lokalizacje, zespoły i stanowiska, wnioski urlopowe i salda, kandydaci i rekrutacje, cele i oceny, karty czasu pracy. Power BI czyta każdy zbiór danych przez łącznik Web i odświeża go zgodnie z harmonogramem ustawionym w usłudze Power BI.

Zdarzenia zmian przez webhooki

Nowe zatrudnienia, zwolnienia, zmiany stanowiska i wynagrodzenia, decyzje urlopowe, nowi kandydaci i aplikacje trafiają na wskazany endpoint, zwykle w ciągu kilku sekund. Jeśli na endpoincie ustawiono wspólny sekret, dostawa jest podpisana; każda dostawa zawiera delivery id do deduplikacji.

Eksport raportów według harmonogramu

Dowolny własny raport zbudowany w sekcji Raporty trafia do wybranych osób jako plik XLSX lub CSV w cyklicznym harmonogramie. Ten sam raport eksportuje się na żądanie, a akcja «Uruchom» wysyła go odbiorcom natychmiast.

Mechanika

Jakie dane trafiają do narzędzia BI

Dane płyną z PeopleForce do narzędzia BI. REST API zwraca aktualny stan przy każdym wywołaniu, webhooki wysyłają payload krótko po zmianie rekordu, a eksporty raportów przychodzą plikami według harmonogramu.

Co jest przekazywane	Dokąd	Kiedy	Dane
Ludzie i struktura organizacji pracownicy, struktura, historia zmian	PeopleForce narzędzie BI	przy każdym odświeżeniu model BI przez REST API	pracownicy, pola niestandardowe, tabele pracowników, historia pól, departamenty, dywizje, lokalizacje, zespoły, stanowiska, podmioty prawne, profile stanowisk, audyty
Urlopy i nieobecności wnioski, salda, polityki	PeopleForce narzędzie BI	przy każdym odświeżeniu model BI przez REST API	wnioski urlopowe, salda urlopów, historie urlopów, typy urlopów, polityki urlopowe, dni wolne, raporty sald urlopowych i godzin pracy
Rekrutacja rekrutacje, kandydaci, aplikacje	PeopleForce narzędzie BI	przy każdym odświeżeniu model BI przez REST API	rekrutacje, kandydaci, aplikacje, ruchy między etapami, źródła, lejki, powody dyskwalifikacji
Wyniki i czas pracy moduły Perform i Time	PeopleForce narzędzie BI	przy każdym odświeżeniu model BI przez REST API	cele, KPI, cykle ocen, oceny, uczestnicy, odpowiedzi, karty czasu pracy, wpisy czasu pracy, projekty, wnioski o nadgodziny
Zdarzenia zmian tematy webhooków	PeopleForce narzędzie BI	zwykle w ciągu sekund na wskazany endpoint	utworzenie, start, aktualizacja i zwolnienie pracownika; zmiany stanowiska, profilu stanowiska, wynagrodzenia i statusu zatrudnienia; akceptacja, odrzucenie i wycofanie wniosku urlopowego; kandydat, rekrutacja, aplikacja, akceptacja i odrzucenie oferty; start ankiety

Dane o wynagrodzeniach i dane wrażliwe kandydatów włącza się osobno na kluczu API typu Company: wynagrodzenie pracowników, widełki wynagrodzenia w rekrutacji, oczekiwane wynagrodzenie kandydata i wrażliwe pola kandydata domyślnie stoją na None i przechodzą na View, gdy wymaga tego dashboard. Jeden klucz typu Company działa w API v1, v2 i v3; v3 obsługuje też wszystkie endpointy v2 i v1.

Pełny wykaz endpointów REST API

przykłady zapytań i odpowiedzi dla każdego endpointu

Dokumentacja dla deweloperów

Parametry

Co można skonfigurować

Wszystko poniżej ustawia w PeopleForce administrator lub użytkownik z odpowiednim uprawnieniem; narzędzie BI utrzymuje własny harmonogram odświeżania i własne miejsce przechowywania poświadczeń.

Parametr	Opcje
Klucz API	Ustawienia → Bezpieczeństwo → Klucze API: typ Company do raportowania, typ Career do strony kariery; na kluczach Company cztery przełączniki danych wrażliwych (None / View / Edit, domyślnie None) i lista dozwolonych adresów IP; token pokazywany jest raz, przy tworzeniu
Webhook	URL endpointu, temat, opcjonalny wspólny sekret do podpisu; nieudaną dostawę można wysłać ponownie z dziennika dostaw
Harmonogram raportu	Raport, format XLSX lub CSV, dni i godzina, odbiorcy, przełącznik aktywności
Eksport raportu	Dowolny raport → Eksport, XLSX lub CSV, na żądanie
Odświeżanie w narzędziu BI	Zaplanowane odświeżanie w Power BI, data freshness w Looker Studio albo cron procesu ETL; API odpowiada aktualnym stanem przy każdym wywołaniu

Warunki działania integracji

Kto dostaje dostęp, jak traktowane są pola wrażliwe i jak świeże są liczby przy każdym odświeżeniu.

Dostęp — w pakiecie Professional

Dostęp do API i webhooki są dostępne w pakiecie Professional; harmonogramy raportów wymagają też Core HR. Klucze tworzy się w sekcji Ustawienia → Bezpieczeństwo → Klucze API, a ten sam klucz typu Company obsługuje Power BI, zadanie ETL albo własny skrypt.

Dane wrażliwe — włączane osobno na kluczu

Klucz typu Company czyta dane organizacji na potrzeby dashboardów zatrudnienia, nieobecności, rekrutacji i wyników. Wynagrodzenie pracowników, widełki wynagrodzenia w rekrutacji, oczekiwane wynagrodzenie kandydata i wrażliwe pola kandydata to osobne przełączniki, domyślnie None, i pozostają takie, dopóki dashboard nie będzie wymagał View.

Świeżość — wybiera ją odbiorca danych

API zwraca aktualny stan przy każdym wywołaniu, więc zbiór danych jest tak świeży, jak ostatnie odświeżenie w Power BI. Webhooki docierają zwykle w ciągu sekund od zmiany; nieudaną dostawę można wysłać ponownie z dziennika dostaw. Harmonogramy raportów uruchamiają się w dniu i o godzinie ustawionych w PeopleForce.