Можливості інтеграції
Дашборди читають дані напряму з PeopleForce, тож цифри в Power BI збігаються з HR-системою при кожному оновленні.
Живі HR-датасети через REST API
Події змін через вебхуки
Експорт звітів за розкладом
Механіка
Які дані потрапляють у ваш BI-інструмент
Дані йдуть із PeopleForce у ваш BI-інструмент. REST API повертає поточний стан на кожен виклик, вебхуки надсилають payload невдовзі після зміни запису, а експорти звітів приходять файлами за розкладом.
| Що передається | Куди | Коли | Дані |
|---|---|---|---|
Люди та оргструктура співробітники, структура, історія змін | PeopleForce BI-інструмент | на кожне оновлення BI-модель через REST API | співробітники, кастомні поля, таблиці співробітників, історія полів, департаменти, підрозділи, локації, команди, позиції, юрособи, профілі посад, аудити |
Відпустки та відсутності заявки, баланси, політики | PeopleForce BI-інструмент | на кожне оновлення BI-модель через REST API | заявки на відпустки, баланси відпусток, історії відпусток, типи відпусток, політики відпусток, свята, звіти про баланси відпусток і робочі години |
Рекрутинг вакансії, кандидати, заявки | PeopleForce BI-інструмент | на кожне оновлення BI-модель через REST API | вакансії, кандидати, заявки, рухи етапами, джерела, воронки, причини дискваліфікації |
Перформанс і час модулі Perform і Time | PeopleForce BI-інструмент | на кожне оновлення BI-модель через REST API | цілі, KPI, цикли оглядів, огляди, учасники, відповіді, табелі, записи табеля, проєкти, заявки на понаднормові |
Події змін теми вебхуків | PeopleForce BI-інструмент | зазвичай за секунди на ваш ендпоінт | створення, старт, оновлення та звільнення співробітника; зміни позиції, профілю посади, зарплати й статусу зайнятості; погодження, відхилення та відкликання заявки на відпустку; кандидат, вакансія, заявка, прийняття та відхилення офера; старт опитування |
Дані про компенсації та чутливі дані кандидатів вмикаються окремо на API-ключі типу Company: компенсація співробітників, діапазон базової компенсації вакансії, бажана базова компенсація кандидата та чутливі поля кандидата за замовчуванням стоять у None і переходять у View, коли цього потребує дашборд. Один ключ типу Company працює для API v1, v2 і v3; v3 обслуговує також усі ендпоінти v2 і v1.
Параметри
Що налаштовується
Усе нижче налаштовують у PeopleForce адміністратор або користувач із відповідним правом доступу; BI-інструмент тримає власний розклад оновлення та сховище облікових даних.
Параметр | Варіанти |
|---|---|
API-ключ | Налаштування → Безпека → API-ключі: тип Company для звітності, тип Career для карʼєрного сайту; на ключах Company — чотири перемикачі чутливих даних (None / View / Edit, за замовчуванням None) і білий список IP; токен показується один раз при створенні |
Вебхук | URL ендпоінта, тема, необовʼязковий спільний секрет для підпису; невдалу доставку можна повторно надіслати з журналу доставок |
Розклад звіту | Звіт, формат XLSX або CSV, дні й час, одержувачі, перемикач активності |
Експорт звіту | Будь-який звіт → Експорт, XLSX або CSV, на вимогу |
Оновлення в BI-інструменті | Заплановане оновлення Power BI, data freshness у Looker Studio або cron вашого ETL; API відповідає поточним станом на кожен виклик |
Умови роботи інтеграції
Хто отримує доступ, як працюють чутливі поля і наскільки свіжі цифри на кожному оновленні.
Доступ — із пакетом Professional
Чутливі дані — вмикаються окремо на ключі
Свіжість — обирає споживач
Часті питання
Те, що запитують аналітики й адміністратори, коли вперше підʼєднують BI-інструмент до PeopleForce.
API та вебхуки в довідціЯк збирається аналітика рекрутингу в Power BI?
Із рекрутингових ресурсів API: вакансії, кандидати, заявки з їхнім етапом у воронці, рухи етапами, джерела та причини дискваліфікації. Рухи мають часові мітки, що дає time-to-hire і час на етапі для кожної вакансії; джерела дають розріз по каналах.
Яку версію API використовувати для BI-підключення?
v3. Вона обслуговує також усі ендпоінти v2 і v1, тож одна базова URL і один ключ типу Company покривають дані про людей, відпустки, рекрутинг, перформанс і час.
Чи доступні дані Perform через API?
Так. Цілі, KPI, цикли оглядів, огляди, учасники, питання й відповіді читаються через ресурси performance в API.
Як перенести дані опитувань Pulse у BI?
Результати опитування експортуються з самого опитування файлом і завантажуються в BI-модель поруч із даними з API. Для анонімних опитувань файл анонімізований і містить департамент, підрозділ, тип зайнятості та стаж. Вебхук survey_start позначає початок кожного запуску опитування.
Як Power BI автентифікується в PeopleForce?
Через заголовок X-API-KEY у конекторі Web: ключ додається в розширених параметрах як HTTP-заголовок запиту. Перемикачі чутливих даних на ключі вирішують, чи повертатимуться зарплатні поля.
Чи можна лишити зарплатні дані поза BI-підключенням?
Так. Компенсація співробітників і три інші перемикачі чутливих даних на ключі типу Company за замовчуванням стоять у None, тож новий ключ повертає всі інші дані й жодного з цих полів, доки на ключі не встановлять View.
