Workday RaaS (Отчёты как услуга)

Чтобы создать системного пользователя интеграции в Workday:

1. Перейдите в Workday.

   ПРИМЕЧАНИЕ: У вас должен быть доступ администратора в Workday. URL-адреса Workday различаются в зависимости от организации, поэтому используйте ссылку для входа, специфичную для вашей компании. Если у вас нет доступа или вы не уверены, как действовать, свяжитесь с администратором Workday.

2. В строке поиска введите Create integration system user (Создать системного пользователя интеграции).

   Откроется окно Create Integration System User.
   
   
   _{Окно создания системного пользователя интеграции.}
    

3. В поле User Name введите уникальное имя пользователя. 
    

4. В поле Password введите пароль. 

   ПРИМЕЧАНИЕ:
   Ваш новый пароль не может совпадать с текущим паролем или именем пользователя.
   • Пароль должен содержать не менее 8 символов. 
   • Пароль должен включать комбинацию следующих типов символов:   
      • Алфавитные символы (буквы) 
      • Заглавные буквы (A–Z)
      • Строчные буквы (a–z)    
      • Цифры (0–9)
      • Специальные символы, такие как: !"#$%&'()*+,-./:;=>?@[\]^_{|}~`

5. Оставьте все остальные поля пустыми. 

   
   _{Пример изображения окна создания системного пользователя интеграции. Введите имя пользователя и пароль. Оставьте все остальные поля пустыми.}
    

6. Выберите OK. 
    

7. Проверьте нового системного пользователя. Выберите Done. 

   СОВЕТ! Надёжно сохраните эти учетные данные. Они понадобятся для интеграции.

   

   _{Пример изображения окна создания системного пользователя интеграции. Проверьте созданного системного пользователя, затем выберите Done.}

Учетные записи, используемые системными пользователями и интеграциями, обычно настраиваются с паролями без срока действия и должны быть ограничены администраторами безопасности.

Чтобы предотвратить истечение срока действия пароля:

1. В строке поиска введите Maintain Password Rules.
   
   Откроется окно Maintain Password Rules.
    

2. В разделе System Users exempt from password expiration добавьте созданного вами системного пользователя интеграции (ISU).

   Чтобы добавить ранее созданного системного пользователя интеграции:

   1. Выберите значок меню заметок.
      
      
      _{Чтобы добавить системного пользователя интеграции, выберите три горизонтальные линии.}
       

   2. Отобразится поле ввода для поиска. Введите имя нового системного пользователя и нажмите [Enter].
      
      
      _{В поле поиска введите имя нового системного пользователя.}
       

      Добавленный пользователь теперь появится в списке.

3. Выберите OK, затем выберите Done.

Чтобы создать группу безопасности для управления разрешениями, необходимыми для интеграции:

1. В строке поиска введите Create Security Group.
   
   Откроется окно Create Security Group.
    
2. В раскрывающемся списке Type of Tenanted Security Group выберите Integration System Security Group (Unconstrained).

3. В поле Name введите имя для новой группы безопасности.
   
   
   _{Пример изображения окна Create Security Group.}
    

   СОВЕТ! Вы можете использовать любое имя, но для согласованности рекомендуется использовать имя, совпадающее с именем системного пользователя интеграции.
4. Выберите OK.
   
   Откроется окно Edit Integration System Security Group (Unconstrained).
    
5. В разделе Integration System Users добавьте ранее созданного системного пользователя интеграции.
   
   
   _{Пример изображения окна Edit Integration System Security Group (Unconstrained).}
    
6. Выберите OK, затем выберите Done.

Чтобы применить и активировать ожидающие изменения политики безопасности:

1. В строке поиска введите Activate Pending Security Policy Changes. 
   
   Откроется окно Activate Pending Security Policy Changes.
   
   
   _{Пример изображения окна Activate Pending Security Policy Changes.}
    
2. В поле Comment введите комментарий, описывающий изменения.
   Например: "Интеграция Exclaimer: обновлена политика безопасности"
    
3. Нажмите OK.
    
4. Установите флажок Confirm, чтобы подтвердить все изменения политики безопасности. 
   
   
   _{Пример изображения с опцией установки флажка Confirm.}
    
5. Нажмите OK.

Чтобы назначить минимальные права только для чтения, необходимые Exclaimer для получения данных сотрудников:

1. В строке поиска введите Поддерживать разрешения для группы безопасности. 
   
   Отобразится окно Поддерживать разрешения для группы безопасности. 
   
   
   _{Пример изображения, показывающего окно Поддерживать разрешения для группы безопасности.}
    
2. В поле Исходная группа безопасности введите имя созданной вами группы безопасности.
    
3. Выберите ОК.
    
4. Нажмите на значок + , чтобы добавить пустую строку разрешений.
   
   
   _{Пример изображения, показывающего значок + для добавления пустой строки разрешений.} 
   
    В таблицу вставляется пустая строка разрешений политики безопасности.
    

5. Настройте разрешения, необходимые Exclaimer для получения данных сотрудников из вашего арендатора Workday. Exclaimer получает только те данные сотрудников, которые необходимы для заполнения и назначения электронных подписей, и не получает доступ к другой конфиденциальной информации. 
   
   Добавьте новую строку для каждого разрешения.
   
   В следующей таблице показан рекомендуемый минимальный набор разрешений только для чтения (Get Only):  

   СОВЕТ! Скопируйте и вставьте названия разрешений напрямую для поиска и добавления их в Workday RaaS. После вставки нажмите [Enter].

   Доступ для просмотра/изменения	Политика безопасности домена	Причина
   Только получение	Данные о человеке: рабочая контактная информация	Рабочий адрес электронной почты и номер телефона
   Только получение	Данные сотрудника: сотрудники	Базовый доступ к записям сотрудников
   Только получение	Управление: интеграция организации	Организация/отдел сотрудника
   Только получение	Данные о человеке: имя	Юридическое и предпочтительное имя сотрудника
   Только получение	Данные о человеке: рабочий адрес	Поля адреса компании/работы
   Только получение	Данные сотрудника: текущая информация о персонале	Определение активных и неактивных сотрудников
   Только получение	Данные сотрудника: активные и уволенные сотрудники	Определение активных и уволенных сотрудников

   ПРИМЕЧАНИЕ: 
   • Вам нужно заполнить только столбцы Доступ для просмотра/изменения и Политика безопасности домена. После того как вы введёте все разрешения, выберите ОК, столбец Функциональные области заполнится автоматически.
   
   
   _{Пример изображения, показывающего столбцы Доступ для просмотра/изменения и Политика безопасности домена.} 
   
     • Если вам нужны пользовательские атрибуты, потребуются дополнительные разрешения. Свяжитесь с службой поддержки для получения дополнительной информации. 
6. Выберите ОК, затем выберите Готово.

Чтобы применить и активировать ожидающие изменения политики безопасности:

1. В строке поиска введите Activate Pending Security Policy Changes.
   
   Откроется окно Activate Pending Security Policy Changes.
   
   
   _{Пример изображения окна Activate Pending Security Policy Changes.}
    
2. В поле Comment введите комментарий, описывающий изменения.
   Например: "Интеграция Exclaimer: обновлена политика безопасности"
    
3. Нажмите OK.
    
4. Установите флажок Confirm, чтобы подтвердить все изменения политики безопасности.
   
   
   _{Пример изображения с опцией установки флажка Confirm.}
    
5. Нажмите OK.

Чтобы создать пользовательский отчет Workday и включить его как веб-сервис:

1. В строке поиска введите Create Custom Report.
   
   Откроется окно Create Custom Report.
    
2. В поле Report Name введите название для пользовательского отчёта.
    
3. Разверните выпадающий список Report Type и выберите Advanced.
    

4. Отметьте опцию Enable As Web Service.
    

   ВАЖНО! Убедитесь, что эта опция включена. Exclaimer не сможет получить доступ к отчёту, если эта опция отключена.
5. Снимите отметку с опции Optimized for Performance.
    
6. В поле Data Source введите All Workers и нажмите [Enter]. 
    

7. Выберите OK.
   
   
   _{Пример изображения окна Create Custom Report.}

    

8. Убедитесь, что в поле Primary Business Object выбрана опция Worker.
   
   
   _{Пример изображения, показывающий, что в Primary Business Object выбрана опция Worker.}
    
9. В разделе Additional Info выберите вкладку Columns.
   
   
   _{Пример изображения с выбранной вкладкой Columns.}
    

10. Добавьте следующие поля для сопоставления с полями Exclaimer:
     

    СОВЕТ! Скопируйте и вставьте названия Полей напрямую для поиска и добавления. После вставки записи нажмите [Enter]. Выберите нужную запись.

    Добавляйте новую строку для каждого поля.

    Бизнес-объект	Поле	Псевдоним XML для заголовка столбца
    Работник	Компания - Название	company_name
    Работник	Должность	job_title
    Работник	Организация руководства	department
    Работник	Организация руководства - ID	company_id
    Работник	ID Workday	workday_id
    Работник	Юридическое полное имя	full_name
    Работник	ID сотрудника	employee_id
    Работник	Статус работника	employment_status
    Работник	Юридическое имя - Имя	first_name
    Работник	Юридическое имя - Отчество	middle_name
    Работник	Юридическое имя - Фамилия	last_name
    Работник	Имя пользователя	username
    Работник	Основной рабочий мобильный телефон	work_phone
    Работник	Предпочитаемое полное имя	preferred_name
    Работник	Электронная почта - Основная рабочая	work_email
    Работник	Рабочий адрес - Форматированная строка 1	work_street_1
    Работник	Рабочий адрес - Форматированная строка 2	work_street_2
    Работник	Рабочий адрес - Город	work_city
    Работник	Рабочий адрес - Штат/Провинция	work_state
    Работник	Рабочий адрес - Страна	work_country
    Работник	Рабочий адрес - Почтовый индекс	work_postal_code

    

    _{Пример изображения, показывающего сопоставленные поля.}
     

    ПРИМЕЧАНИЕ: 
     • Если вам нужны пользовательские атрибуты, потребуются дополнительные разрешения. Свяжитесь с службой поддержки для получения дополнительной информации. 
    • Убедитесь, что используете точные Псевдонимы XML для переопределения, иначе данные могут не синхронизироваться.
    • Для пользовательских полей могут потребоваться дополнительные политики безопасности домена.
11. Выберите вкладку Общий доступ.  
    
    
    _{Пример изображения с выбранной вкладкой Общий доступ.}
     
12. В разделе Параметры общего доступа к отчету выберите Поделиться с определёнными авторизованными группами и пользователями. 
    
    
    _{Пример изображения, показывающий, что выбрана опция Поделиться с определёнными авторизованными группами и пользователями.} 
     
13. В разделе Авторизованные пользователи введите ранее созданного авторизованного пользователя интеграции. 
    
    
    _{Пример изображения, показывающий заполненное поле Авторизованные пользователи.} 
     
14. Выберите ОК, затем выберите Готово.
     

Чтобы проверить вывод пользовательского отчета и скопировать URL-адрес JSON-отчета:

1. В строке поиска введите Просмотр пользовательского отчета.

   Отобразится окно Просмотр пользовательского отчета.
    

2. В поле Пользовательский отчет введите имя отчета, который вы создали ранее.
    

3. Выберите ОК.
   
   
   _{Пример изображения, показывающего окно Просмотр пользовательского отчета.}

   Отобразится страница выбранного отчета.
    

4. Выберите три точки рядом с именем отчета, выберите Веб-сервисы, затем выберите Просмотр URL-адресов.
   
   
   _{Пример изображения, показывающего, как выбрать Просмотр URL-адресов.}
   
   Отобразится экран Просмотр URL-адресов Веб-сервиса.
    

5. Прокрутите до раздела JSON.
   
   
   _{Пример изображения, показывающего раздел JSON.}
    

6. Щелкните правой кнопкой мыши по JSON и выберите Копировать URL.
    

   СОВЕТ! Надежно сохраните URL. Он потребуется для интеграции.

7. Выберите ссылку JSON, чтобы скачать JSON-файл. Если появится запрос, введите учетные данные ISU. Проверьте, что:

   Появились все необходимые поля.

   Значения полей корректны.

Чтобы создать API-клиента для обеспечения безопасной аутентификации интеграции:

1. В строке поиска введите Просмотр домена.
   
   Откроется окно Просмотр домена.
    

2. В поле Домен введите Report Execution и нажмите [Enter].
   
   
   _{Пример изображения окна Просмотр домена.}
    

3. Выберите ОК.
   
   
   _{Пример изображения окна Просмотр домена.}
    

   СОВЕТ! Надёжно запишите Функциональные области. Они понадобятся позже.
   
   
   _{Пример изображения функциональных областей, которые нужно записать, так как они будут использоваться позже.}
    

4. В строке поиска введите Зарегистрировать API-клиента для интеграций. 
    

   Откроется окно Зарегистрировать API-клиента для интеграций.
    

5. В поле Имя клиента введите имя клиента. 
    

6. В поле Область введите необходимые области, включая функциональные области из окна Просмотр домена.
   Вставьте ранее скопированные Функциональные области сюда.
    

7. Выберите ОК.
    

   СОВЕТ! После создания API-клиента обязательно скопируйте и сохраните Client Secret в надежном месте, так как он будет показан только при создании и впоследствии будет недоступен.
   
   Скопируйте и надежно сохраните как Client ID, так и Client Secret, так как они будут использоваться при интеграции с Exclaimer.
   
   
   _{Пример изображения Client ID и Client Secret.}

Чтобы сгенерировать или повторно использовать токен обновления для клиента API:

1. В строке поиска введите Просмотр клиентов API. 
   
   Отобразится экран Просмотр клиентов API. 
    
2. Выберите вкладку Клиенты API для интеграций.
   
   
   _{Пример изображения с выбранной вкладкой Клиенты API для интеграций.}
    
3. Найдите вашего клиента API.
    
4. Выберите три точки рядом с именем вашего клиента API. Выберите Клиент API, затем выберите Управление токенами обновления для интеграций.
   
   
   _{Пример изображения с опцией Управление токенами обновления для интеграций.}
   
   Отобразится окно Управление токенами обновления для интеграций.
   
   
   _{Пример изображения окна Управление токенами обновления для интеграций.}
    
5. В поле Учетная запись Workday добавьте того же авторизованного пользователя, который настроен для клиента API.
    
6. Нажмите ОК.
    

7. Повторно используйте существующий токен обновления, если он уже используется другими интеграциями.
   Если других интеграций нет, выберите Создать новый токен обновления, затем выберите Подтвердить удаление.

   СОВЕТ! Скопируйте токен обновления и сохраните его в надежном месте, так как он будет использоваться при интеграции с Exclaimer.

Чтобы подключиться к вашей HRIS и позволить Exclaimer синхронизировать контактные данные пользователей:

1. В выпадающем списке выберите Workday RaaS.
   
   
   _{В выпадающем списке выберите Workday RaaS.}
    

2. Выберите Подключить.
   
   Отобразится окно Workday RaaS. Предоставьте доступ только для чтения и выберите, какие модели данных будут доступны.

   ВНИМАНИЕ! Если окно Workday RaaS не отображается, добавьте в белый список cdn.bindbee.dev (и желательно .bindbee.dev), чтобы обеспечить корректную загрузку SDK Bindbee в браузере.
   ПРИМЕЧАНИЕ: Если вам нужны дополнительные пользовательские поля, наша команда может настроить их вручную. Эта опция в настоящее время недоступна в режиме самообслуживания. Свяжитесь с нашей службой поддержки для помощи в настройке необходимых пользовательских полей.
    

3. Введите URL конечной точки веб-сервисов Workday.

   Чтобы получить URL:

   1. В Workday выполните поиск по запросу Public Web Services.
      
      Отобразится окно Public Web Services.
       
   2. Найдите Human Resources (Public). Выберите Web Service, затем выберите View WSDL.
      
      
      _{Пример изображения, показывающего, как получить URL конечной точки в Workday. В окне Public Web Services найдите Human Resources (Public). Выберите Web Service, затем View WSDL.}
      
      Отобразится XML-файл.   

   3. Прокрутите страницу вниз. Скопируйте URL до (но не включая) /service/. Это и есть URL конечной точки веб-сервисов.

      ВНИМАНИЕ! Не включайте завершающий слэш после /ccx.

      
      _{Пример изображения XML-файла в Workday. Скопируйте URL до (но не включая) /service/.}
       

   4. Вставьте URL в предоставленное поле.
      
      
      _{Пример изображения в Exclaimer при попытке подключения к системе Workday RaaS.}
       
4. Выберите Далее.
5. Введите ваше имя арендатора Workday.
   
   Как найти имя арендатора Workday: 
   1. На панели управления Workday проверьте URL в вашем браузере. Скопируйте значение, которое появляется после workday.com/  
      Это и есть имя арендатора.
      
      
      _{Пример изображения имени арендатора Workday — не копируйте это имя. Проверьте URL вашей панели управления, чтобы найти имя арендатора Workday.}
       
   2. Вставьте значение в качестве имени арендатора.
      
      
      _{Введите имя арендатора Workday.} 
       
6. Выберите Далее.
    

7. Введите ваши данные токена обновления RaaS, ID клиента RaaS и секрет клиента RaaS.
   См. шаги 10 и 11 выше для получения данных.
   
   
   _{Введите токен обновления RaaS, ID клиента RaaS и секрет клиента RaaS.} 

    

8. Выберите Далее.
    
9. Введите URL пользовательского отчёта. См. шаг 8 выше — Проверка пользовательского отчёта.
   
   
   _{Введите URL вашего отчёта.}
    

10. Выберите Подключить.
     

    ВНИМАНИЕ! Держите окно открытым до завершения подключения. Если закрыть его слишком рано, подключение может не завершиться, и в Exclaimer оно может не отображаться как подключённое.

    
    
    _{Изображение, показывающее, что подключение установлено.}

     

11. Если вы попытаетесь подключиться к Workday снова, может появиться сообщение о том, что коннектор уже существует. Если это произойдёт, создайте заявку в службу поддержки, чтобы команда могла помочь вам.

    После установления подключения к системе Workday HRIS статус в Exclaimer отображается как Подключено.
    
    
    _{После установления подключения к системе Workday RaaS в Exclaimer отображается текст «Подключено».}
     

Чтобы повторно подключиться к системе Workday RaaS:

1. Выберите Повторное подключение.
   
   Появится сообщение о том, что повторное подключение удалит ваше текущее подключение к Workday RaaS, и любые данные больше не будут доступны, а процесс нового подключения начнется автоматически.
   
   
   _{Выберите OK, чтобы повторно подключиться к системе Workday RaaS.}  
    
2. Выберите OK для продолжения.

Чтобы отключиться от системы Workday RaaS:

1. Выберите Отключить.
   
   Появится сообщение о том, что отключение полностью удалит ваше подключение к Workday RaaS, и любые данные из системы больше не будут доступны.
   
   
   _{Выберите OK, чтобы отключиться от системы Workday RaaS.}  
    
2. Выберите OK для продолжения.

Коннекторы Workday автоматически синхронизируют данные согласно заданному расписанию. Вы также можете инициировать ручную синхронизацию.

Чтобы запустить ручную синхронизацию и немедленно обновить данные сотрудников в Exclaimer:

1. Выберите Синхронизировать сейчас.
   
   
   _{Выберите Синхронизировать сейчас, чтобы начать ручную синхронизацию.} 
    

   ПРИМЕЧАНИЕ: Кнопка Синхронизировать сейчас активируется только через 6 часов после последней успешной синхронизации. Если кнопка не активна, отображается дата и время следующей синхронизации. 
   
   
   _{Пример изображения, показывающий, что кнопка Синхронизировать сейчас не активна, и отображается дата и время следующей синхронизации.} 

Если в выводе отчёта JSON отсутствуют ожидаемые поля:

• Проверьте, что у пользователя интеграционной системы (ISU) есть необходимые разрешения безопасности домена.
• Убедитесь, что все ожидающие изменения политики безопасности были активированы.
• Проверьте, что поля были правильно добавлены на вкладку «Столбцы» в пользовательском отчёте.
• Убедитесь, что XML-псевдонимы настроены корректно.
• Проверьте вывод JSON, используя учётные данные ISU, а не учётную запись администратора.

Если окно подключения Workday RaaS не появляется в Exclaimer:

• Убедитесь, что следующие домены добавлены в белый список в вашей сети или в средствах безопасности браузера:
  • cdn.bindbee.dev
  • *.bindbee.dev
• Проверьте, что расширения браузера или блокировщики контента не препятствуют загрузке страницы.
• Обновите страницу браузера и попробуйте снова.

Если подключение к Workday не удалось во время настройки:

Проверьте, что:

• Имя арендатора Workday указано правильно.
• URL конечной точки веб-сервисов Workday введён корректно.
• Идентификатор клиента RaaS, секрет клиента и токен обновления действительны.
• Пароль пользователя интеграционной системы не истёк.
• API-клиент был успешно создан в Workday.
• Используется правильная среда Workday (Production или Sandbox/Test).

Если URL-адрес JSON-отчёта не открывается или возвращает неполные данные:

• Убедитесь, что пользовательский отчёт включён как веб-сервис.
• Подтвердите, что отчёт доступен авторизованному пользователю интеграционной системы.
• Проверьте, что пользователь интеграционной системы принадлежит к правильной группе безопасности.
• Подтвердите, что назначены необходимые разрешения безопасности домена.
• Проверьте, что ожидающие изменения политики безопасности были успешно активированы.