Шлюз successfactors (независимый Publisher) (предварительная версия)

Интеграция SAP SuccessFactors с помощью шлюза Successfactors. Управление кандидатами, публикацией заданий, приложениями, интервью, списками выбора и метаданными. Отслеживайте и корректируйте квоту https://sap-connectors.bajonczak.com.

Этот соединитель доступен в следующих продуктах и регионах:

Service Class Регионы
Copilot Studio Премия Все регионы Power Automate за исключением следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Логические приложения Стандарт Все регионы Logic Apps , кроме следующих:
     - Azure для государственных организаций регионы
     - Azure регионы Китая
     - Министерство обороны США (DoD)
Power Apps Премия Все регионы Power Apps кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Power Automate Премия Все регионы Power Automate за исключением следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Контакт
Имя Саша Бажончак
URL https://sap-connectors.bajonczak.com
Сообщение электронной почты xbeejayx@hotmail.com
Метаданные соединителя
Publisher SBajonczak
Веб-сайт https://sap-connectors.bajonczak.com/
Политика конфиденциальности https://sap-connectors.bajonczak.com/privacy
Categories Управление бизнесом; Кадровые ресурсы

Соединитель карьеры SuccessFactors

Introduction

Соединитель SuccessFactors Career Предоставляет структурированный уровень интеграции для создания и поддержания данных, связанных с карьерой, в SAP SuccessFactors. Соединитель предназначен для упрощения взаимодействия между внешними системами, платформами автоматизации и SuccessFactors путем предоставления четких и повторно используемых действий для распространенных сценариев подбора и управления карьерой.

В текущей версии соединитель фокусируется на области "Кандидат " SAP SuccessFactors. Он поддерживает создание и изменение записей кандидатов и предназначен для автоматизации процессов приема кандидатов из внешних источников, таких как Copilot Studio, Power Automate, пользовательские бизнес-приложения, порталы кадров или другие службы интеграции.

Соединитель разрабатывается пошаговые шаги. Первый основной этап реализации сосредоточен на модуле карьеры и вербовки, начиная с управления кандидатами и постепенно расширяясь в связанные объекты и процессы подбора.

Текущие возможности

Начальная версия соединителя поддерживает основные операции кандидатов в SuccessFactors.

Это включает в себя возможность создания новых кандидатов и обновления существующих сведений о кандидате. Кандидаты могут быть обогащены дополнительными метаданными, чтобы предоставить более полный профиль кандидата внутри SuccessFactors.

Ниже приведены примеры поддерживаемых или запланированных метаданных, связанных с кандидатами:

  • Сведения о личном кандидате
  • Контактная информация
  • История образования
  • Внешний опыт работы
  • Ссылки на положение задания
  • Справочная информация, связанная с карьерой
  • Дополнительные метаданные, необходимые для подчиненных процессов

Цель — предоставить надежный и многократно используемый интерфейс соединителя, который скрывает сложность базового API SuccessFactors и позволяет использовать системы для работы с упрощенной и бизнес-ориентированной моделью.

Запланированное расширение модуля карьеры

После завершения и стабилизации функциональных возможностей управления кандидатами необходимо расширить соединитель далее в процессе подбора.

Плановая стратегия включает поддержку создания и управления объектами, связанными с заданиями, особенно предложениями заданий и данными, связанными с заданием. Это позволит внешним системам не только отправлять и обогащать данные кандидатов, но и поддерживать создание и обслуживание возможностей заданий в SuccessFactors.

Предполагаемый поток:

  1. Создание или обновление записей кандидатов.
  2. Обогатите кандидатов соответствующими метаданными, такими как образование, опыт работы и информация о должности.
  3. Расширьте соединитель для поддержки создания предложения заданий.
  4. Создайте более широкий уровень интеграции для подбора и карьерных процессов SuccessFactors.

Назначение соединителя

Основной целью этого соединителя является предоставление чистого, повторного использования и удобного для автоматизации интерфейса для сценариев карьеры и вербовки SAP SuccessFactors.

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

Это упрощает:

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

Целевой сценарий

Типичный сценарий для этого соединителя — это автоматизация управления персоналом или вербовкой, в которой данные кандидата собираются через внешний интерфейс, а затем передаются в SuccessFactors.

Например, агент Copilot Studio может собирать сведения о кандидатах во время беседы, извлекать структурированные данные, такие как имя, контактные данные, образование, опыт работы и интересы заданий, а затем использовать этот соединитель для создания или обновления записи кандидата в SuccessFactors.

На более позднем этапе одно семейство соединителей может быть расширено для поддержки более полного комплексного сценария автоматизации вербовки.

Состояние разработки

Этот соединитель в настоящее время находится на этапе ранней реализации.

Текущий фокус:

  • Зачисление кандидата / создание и изменение
  • Публикация заданий, перечисление / создание/ изменение
  • Перечисление приложения задания / создание и изменение

Будущее развитие будет сосредоточено на расширении области подбора, особенно вокруг предложений рабочих мест и связанных объектов карьеры.

Сводка

Соединитель Карьеры SuccessFactors предназначен для создания выделенного уровня интеграции для процессов подбора и карьеры SAP SuccessFactors. Первый шаг реализации посвящен кандидатам и обогащению метаданных кандидатов. Будущие версии расширят соединитель для поддержки предложений заданий и более широких рабочих процессов подбора.

Этот поэтапный подход позволяет соединителю доставить ценность рано при сохранении гибкости архитектуры для будущих расширений модуля SuccessFactors Career.

Контакт

Саша Бажончак (xbeejayx@hotmail.com) https://sap-connectors.bajonczak.com

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:

По умолчанию Параметры для создания подключения. Все регионы Недоступен для совместного использования

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя Тип Описание Обязательный
Ключ API securestring Ключ API для этого API True

Действия

Добавление вложения кандидата

Добавляет вложение файла (например, cv) к существующему кандидату.

Добавление комментария кандидата

Добавляет комментарий к существующему кандидату.

Добавление тега кандидата

Добавляет тег к существующему кандидату.

Настройка кандидатов в образование

Задает рекорд образования для существующего кандидата через upsert. Поля, не отправленные, остаются неизменными.

Настройка опыта работы с кандидатами

Задает внешний опыт работы для существующего кандидата через upsert.

Обновление кандидата

Обновляет существующего кандидата с помощью upsert.

Получение кандидата по идентификатору

Возвращает одного кандидата по идентификатору кандидата SAP SuccessFactors.

Получение кандидатов

Возвращает список кандидатов из SAP SuccessFactors.

Получение необработанных метаданных

Возвращает необработанные метаданные OData (EDMX/XML) экземпляра SAP SuccessFactors. Содержит все типы сущностей и их поля.

Получение параметров выбора

Возвращает все параметры для заданного списка выбора.

Получение полей сущностей

Возвращает все доступные имена полей для данной сущности (например, JobRequisition или JobApplicationInterview). Полезно для обнаружения полей, доступных в этом экземпляре SAP SuccessFactors.

Получение приложений заданий

Возвращает список приложений заданий с разбивкой на страницы.

Получение приложения задания по идентификатору

Возвращает одно приложение задания по идентификатору.

Получение публикации заданий

Возвращает список публикаций заданий с разбивкой на страницы.

Получение публикации задания по идентификатору

Возвращает одно задание, размещенное по идентификатору запроса.

Создание кандидата

Создает нового кандидата в SAP SuccessFactors.

Создание собеседования на задание

Создает новое собеседование для приложения в SAP SuccessFactors.

Добавление вложения кандидата

Добавляет вложение файла (например, cv) к существующему кандидату.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор кандидата
candidateId True string

Идентификатор кандидата SF.

fileName
fileName True string

Имя файла, включая расширение, например "CV_John_Doe.pdf".

fileContent
fileContent True string

Содержимое файла в виде строки в кодировке Base64.

модуль
module string

Модуль SF. Значение по умолчанию: "RECRUITING".

moduleCategory
moduleCategory string

Категория SF. Значение по умолчанию: "Вложения".

Возвращаемое значение

Добавление комментария кандидата

Добавляет комментарий к существующему кандидату.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор кандидата
candidateId True string

Идентификатор кандидата SF.

содержимое
content True string

Возвращаемое значение

Добавление тега кандидата

Добавляет тег к существующему кандидату.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор кандидата
candidateId True string

Идентификатор кандидата SF.

label
label True string

Возвращаемое значение

Настройка кандидатов в образование

Задает рекорд образования для существующего кандидата через upsert. Поля, не отправленные, остаются неизменными.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор кандидата
candidateId True string

Идентификатор кандидата SF.

учебное заведение
school string

Школа или университет, например "TU München".

startDate
startDate string

Дата начала (ISO или OData /Date(ms)/).

Дата окончания
endDate string

Дата окончания (ISO или OData /Date(ms)/).

Возвращаемое значение

Настройка опыта работы с кандидатами

Задает внешний опыт работы для существующего кандидата через upsert.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор кандидата
candidateId True string

Идентификатор кандидата SF.

работодатель
employer string

Имя работодателя, например ACME GmbH.

startDate
startDate string

Дата начала (ISO или OData /Date(ms)/).

Дата окончания
endDate string

Дата окончания (ISO или OData /Date(ms)/).

Возвращаемое значение

Обновление кандидата

Обновляет существующего кандидата с помощью upsert.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор кандидата
candidateId True string

Идентификатор кандидата SF, например "45417".

firstName
firstName True string
lastName
lastName True string
country
country True string

Код страны ISO, например "US", "DE", "BR".

основная электронная почта
primaryEmail True email
address
address string
мобильный телефон
cellPhone string

Номер мобильного телефона, например "+1 866 9999-9999".

гендер
gender string

Пол: "M" или "F".

minAnnualSal
minAnnualSal string

Требуемая минимальная зарплата в виде строки, например "70000".

city
city string

Город (необязательно). Бесплатный текст.

zip
zip string

ZIP-код (необязательно). Бесплатный текст.

учебное заведение
school string

Школа или университет, например "TU München".

startDate
startDate string

Дата начала (ISO или OData /Date(ms)/).

Дата окончания
endDate string

Дата окончания (ISO или OData /Date(ms)/).

работодатель
employer string

Имя работодателя, например ACME GmbH.

startDate
startDate string

Дата начала (ISO или OData /Date(ms)/).

Дата окончания
endDate string

Дата окончания (ISO или OData /Date(ms)/).

label
label True string
educationSchool
educationSchool string

Школа или университет (плоская, для Power Platform).

educationMajor
educationMajor string

Поле исследования или основной (плоский).

educationDegree
educationDegree string

Степень, например "Бакалавр", "Мастер" или код SF "217" (плоская).

educationStartDate
educationStartDate string

Дата начала образования (ISO или OData /Date(ms)/) (плоская).

educationEndDate
educationEndDate string

Дата окончания образования (ISO или OData /Date(ms)/) (плоская).

workExperienceEmployer
workExperienceEmployer string

Работодатель (плоский, для Power Platform).

workExperienceStartDate
workExperienceStartDate string

Дата начала работы (ISO или OData /Date(ms)/) (неструктурированный).

workExperienceEndDate
workExperienceEndDate string

Дата окончания работы (ISO или OData /Date(ms)/) (неструктурированный).

attachmentFileName
attachmentFileName string

Имя файла вложения, включая расширение (неструктурированное), например "CV.pdf".

attachmentFileContent
attachmentFileContent string

Содержимое файла вложения в виде строки в кодировке Base64 (flat).

attachmentModule
attachmentModule string

Модуль SF для вложения (неструктурированный). Значение по умолчанию: "RECRUITING".

attachmentModuleCategory
attachmentModuleCategory string

Категория SF для вложения (плоская). Значение по умолчанию: "Вложения".

commentContent
commentContent string

Текст примечания (плоская, одна запись). Хранится в качестве поля резюме или заметки кандидата в SF.

tagLabel
tagLabel string

Метка тега (плоская, одна запись). Значения, разделенные запятыми, создают несколько тегов.

Возвращаемое значение

Получение кандидата по идентификатору

Возвращает одного кандидата по идентификатору кандидата SAP SuccessFactors.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор кандидата
candidateId True string

Идентификатор кандидата SF, например "12333".

Возвращаемое значение

Получение кандидатов

Возвращает список кандидатов из SAP SuccessFactors.

Параметры

Имя Ключ Обязательно Тип Описание
Верх
top integer

Максимальное количество возвращаемых записей (по умолчанию: 20).

Возвращаемое значение

Список кандидатов, возвращаемых GET /api/v1/candidates.

Получение необработанных метаданных

Возвращает необработанные метаданные OData (EDMX/XML) экземпляра SAP SuccessFactors. Содержит все типы сущностей и их поля.

Возвращаемое значение

response
string

Получение параметров выбора

Возвращает все параметры для заданного списка выбора.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор списка выбора
picklistId True string

Идентификатор списка выбора, например "Пол".

Возвращаемое значение

Получение полей сущностей

Возвращает все доступные имена полей для данной сущности (например, JobRequisition или JobApplicationInterview). Полезно для обнаружения полей, доступных в этом экземпляре SAP SuccessFactors.

Параметры

Имя Ключ Обязательно Тип Описание
Имя сущности
entityName True string

Имя сущности OData, например JobRequisition.

Возвращаемое значение

Получение приложений заданий

Возвращает список приложений заданий с разбивкой на страницы.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор задания Requisition
JobReqId integer

Фильтр nach Job-Ausschreibungs-ID. Empfohlen um nur Bewerbungen für eine bestimmte Stelle zu erhalten.

Status
Status string

Фильтр nach Bewerbungsstatus, z.B. "Активный".

Пропустить
Skip integer

Anzahl zu überspringender Einträge (OData $skip).

Верх
Top integer

Maximale Anzahl zurückgegebener Einträgege (OData $top). Значение по умолчанию 50, макс. 200.

Возвращаемое значение

Получение приложения задания по идентификатору

Возвращает одно приложение задания по идентификатору.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор
id True integer

Идентификатор приложения (applicationId).

Возвращаемое значение

Bewerbung (JobApplication) aus SAP SuccessFactors. Verknüpft einen Kandidaten mit einer Ausschreibung (JobRequisition).

Тело
JobApplication

Получение публикации заданий

Возвращает список публикаций заданий с разбивкой на страницы.

Параметры

Имя Ключ Обязательно Тип Описание
Только активный
ActiveOnly boolean

Nur aktive (nicht gelöschte) Ausschreibungen zurückgeben. true = nur aktive, false = alle inkl. gelöschte. Значение по умолчанию: true.

Тип шаблона
TemplateType string

Фильтрация nach Template-Type, z.B. "JOB_REQ". Leer = alle.

Пропустить
Skip integer

Anzahl zu überspringender Einträge (OData $skip).

Верх
Top integer

Maximale Anzahl zurückgegebener Einträgege (OData $top). Значение по умолчанию 50, макс. 200.

Возвращаемое значение

Получение публикации задания по идентификатору

Возвращает одно задание, размещенное по идентификатору запроса.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор
id True integer

Идентификатор задания реквизиции.

Возвращаемое значение

Job-Ausschreibung aus SAP SuccessFactors (JobRequisition). Beinhaltet die häufigsten Felder; weitere Instanz-spezifische Felder sind in PremiumConnector.SF.Models.JobPosting.JobRequisition.AdditionalFields verfügbar.

Тело
JobRequisition

Создание кандидата

Создает нового кандидата в SAP SuccessFactors.

Параметры

Имя Ключ Обязательно Тип Описание
firstName
firstName True string
lastName
lastName True string
country
country True string

Код страны ISO, например "US", "DE", "BR".

основная электронная почта
primaryEmail True email
address
address string
мобильный телефон
cellPhone string

Номер мобильного телефона, например "+1 866 9999-9999".

гендер
gender string

Пол: "M" или "F".

minAnnualSal
minAnnualSal string

Требуемая минимальная зарплата в виде строки, например "70000".

city
city string

Город (необязательно). Бесплатный текст.

zip
zip string

ZIP-код (необязательно). Бесплатный текст.

учебное заведение
school string

Школа или университет, например "TU München".

startDate
startDate string

Дата начала (ISO или OData /Date(ms)/).

Дата окончания
endDate string

Дата окончания (ISO или OData /Date(ms)/).

работодатель
employer string

Имя работодателя, например ACME GmbH.

startDate
startDate string

Дата начала (ISO или OData /Date(ms)/).

Дата окончания
endDate string

Дата окончания (ISO или OData /Date(ms)/).

label
label True string
educationSchool
educationSchool string

Школа или университет (плоская, для Power Platform).

educationMajor
educationMajor string

Поле исследования или основной (плоский).

educationDegree
educationDegree string

Степень, например "Бакалавр", "Мастер" или код SF "217" (плоская).

educationStartDate
educationStartDate string

Дата начала образования (ISO или OData /Date(ms)/) (плоская).

educationEndDate
educationEndDate string

Дата окончания образования (ISO или OData /Date(ms)/) (плоская).

workExperienceEmployer
workExperienceEmployer string

Работодатель (плоский, для Power Platform).

workExperienceStartDate
workExperienceStartDate string

Дата начала работы (ISO или OData /Date(ms)/) (неструктурированный).

workExperienceEndDate
workExperienceEndDate string

Дата окончания работы (ISO или OData /Date(ms)/) (неструктурированный).

attachmentFileName
attachmentFileName string

Имя файла вложения, включая расширение (неструктурированное), например "CV.pdf".

attachmentFileContent
attachmentFileContent string

Содержимое файла вложения в виде строки в кодировке Base64 (flat).

attachmentModule
attachmentModule string

Модуль SF для вложения (неструктурированный). Значение по умолчанию: "RECRUITING".

attachmentModuleCategory
attachmentModuleCategory string

Категория SF для вложения (плоская). Значение по умолчанию: "Вложения".

commentContent
commentContent string

Текст примечания (плоская, одна запись). Хранится в качестве поля резюме или заметки кандидата в SF.

tagLabel
tagLabel string

Метка тега (плоская, одна запись). Значения, разделенные запятыми, создают несколько тегов.

Возвращаемое значение

Создание собеседования на задание

Создает новое собеседование для приложения в SAP SuccessFactors.

Параметры

Имя Ключ Обязательно Тип Описание
applicationId
applicationId True string

Bewerbungs-ID aus GET /api/v1/job-applications (Feld applicationId). Pflichtfeld — первичный ключ де интервью в SF.

startDate
startDate date-time

Startdatum und -uhrzeit des Interviews (UTC). Wird в OData /Date(ms+0000)/ Format konvertiert.

Дата окончания
endDate date-time

Enddatum des Interviews (UTC). Optional.

isTimeSet
isTimeSet boolean

Gibt ob Startdatum eine genaue Uhrzeit enthält (true) oder nur ein Datum ohne Zeit (false/null).

templateType
templateType string

Template-Typ дер Ausschreibung. Typeischer Wert: "JOB_REQ".

source
source string

Quelle der Bewerbung. Mögliche Werte: "INTERNAL", "EXTERNAL".

заметки
notes string

Нотизэн zum Interview-Verlauf.

interviewerUserId
interviewerUserId string

userId des Interviewers в SAP SuccessFactors (z.B. "mhoff1"). Wird als Navigation Property interviewer.userId gesetzt.

Возвращаемое значение

Определения

КандидатListResponse

Список кандидатов, возвращаемых GET /api/v1/candidates.

Имя Путь Тип Описание
items
items array of CandidateResponse
количество
count integer

КандидатResponse

Имя Путь Тип Описание
candidateId
candidateId string
firstName
firstName string
lastName
lastName string
основная электронная почта
primaryEmail string
country
country string
мобильный телефон
cellPhone string
гендер
gender string
minAnnualSal
minAnnualSal string

CreateJobInterviewResponse

Имя Путь Тип Описание
applicationId
applicationId string
startDate
startDate date-time
Дата окончания
endDate date-time
isTimeSet
isTimeSet boolean
templateType
templateType string
source
source string
заметки
notes string
interviewerUserId
interviewerUserId string

EntityFieldsResponse

Имя Путь Тип Описание
entityName
entityName string
Поля
fields array of string
количество
count integer

JobApplication

Bewerbung (JobApplication) aus SAP SuccessFactors. Verknüpft einen Kandidaten mit einer Ausschreibung (JobRequisition).

Имя Путь Тип Описание
applicationId
applicationId string

Eindeutige ID der Bewerbung.

jobReqId
jobReqId string

Verknüpfte Job-Ausschreibungs-ID.

статус
status string

Bewerbungsstatus, z.B. "Активный", "Отклонено".

candidateId
candidateId string

Kandidaten-ID.

candidateNameLF
candidateNameLF string

Имя des Kandidaten (Nachname, Vorname).

applicationDate
applicationDate string

Bewerbungsdatum (OData /Date(ms)/Format).

дата последнего изменения
lastModifiedDate string

Letztes Änderungsdatum (OData /Date(ms)/Format).

JobApplicationListResponse

Имя Путь Тип Описание
items
items array of JobApplication
количество
count integer
skip
skip integer
top
top integer

JobPostingListResponse

Имя Путь Тип Описание
items
items array of JobRequisition
количество
count integer
skip
skip integer
top
top integer

JobRequisition

Job-Ausschreibung aus SAP SuccessFactors (JobRequisition). Beinhaltet die häufigsten Felder; weitere Instanz-spezifische Felder sind in PremiumConnector.SF.Models.JobPosting.JobRequisition.AdditionalFields verfügbar.

Имя Путь Тип Описание
jobReqId
jobReqId string

Eindeutige ID der Ausschreibung.

templateType
templateType string

Template-Type, z.B. "JOB_REQ".

jobCode
jobCode string

Интерн Job-Code Nummer.

departmentCode
departmentCode string

Abteilungs-Code.

locationCode
locationCode string

Standort-Code.

divisionCode
divisionCode string

Divisions-Code.

numberOpenings
numberOpenings string

Анзал оффенер Стеллен.

удалено
deleted string

Löschstatus, z.B. "Deleted" oder NULL.

Язык defaultLanguage
defaultLanguage string

Standardsprache der Ausschreibung.

currency
currency string

Währung.

ratedApplicantCount
ratedApplicantCount string

Anzahl bewerteter Bewerber.

Дата и время создания
createdDateTime string

Erstelldatum (OData /Date(ms+tz)/Format).

closedDateTime
closedDateTime string

Schlussdatum (OData /Date(ms+tz)/ Format).

интрасетиPosting
intranetPosting boolean

Im Internet publiziert.

corporatePosting
corporatePosting boolean

Unternehmensweit publiziert.

PicklistOption

Eine einzelne Option in einer SAP SuccessFactors Pickliste.

Имя Путь Тип Описание
picklistId
picklistId string
optionId
optionId string
externalCode
externalCode string
статус
status string
местность
locale string
value
value string

string

Это базовый тип данных string.