IBM Kenexa BrassRing - Integracja testów HackerRank
Last updated: December 27, 2024
Przegląd
Poniższy diagram opisuje przepływ pracy integracji BrassRing i HackerRank dla rekruterów. Rekruterzy będą przenosić kandydata do niestandardowego statusu Test HackerRank. Po wejściu w ten status BrassRing wyśle ładunek do HackerRank za pomocą API Eksportu Kandydata. HackerRank następnie wyśle zaproszenie do testu do kandydata. Po ukończeniu testu przez kandydata i ocenie testu przez HackerRank, HackerRank wyśle wyniki z powrotem do BrassRing za pomocą API Importu Formularzy.
Wymagania wstępne
W HackerRank for Work
W BrassRing
Musisz posiadać plan Enterprise z licencją Rekrutera.
Musisz mieć aktywne konto użytkownika typu Rekruter z uprawnieniami Administrator Firmy. To konto użytkownika musi należeć do dowolnego zespołu.
Zalecane: konto Sandbox HackerRank for Work do testowania integracji.
Musisz być klientem BrassRing z dostępem do API Eksportu Kandydatów i Importu Formularzy. Skontaktuj się z przedstawicielem IBM, jeśli nie jesteś pewien, czy masz dostęp do tych API.
Musisz albo: być Administratorem Workbench i skonfigurować integrację samodzielnie, albo współpracować z usługami profesjonalnymi IBM.
Zalecane: środowisko Sandbox BrassRing do testowania integracji.
Kroki integracji
Integracja obejmuje 3-etapowy proces:
Skonfiguruj listę testów HackerRank w BrassRing
Skonfiguruj Eksport Kandydatów
Skonfiguruj Import Formularzy
Skonfiguruj listę testów HackerRank w BrassRing
Listy testów muszą być ustawione po stronie BrassRing jako opcje w polu HACKERRANK_TEST_ID.
Podczas tworzenia i testowania integracji po raz pierwszy, możesz pobrać nazwę i ID testu z strony Testu HackerRank oraz adres URL strony, odpowiednio. W poniższym przykładzie ID testu to 454785, a nazwa testu to „HackerRank Full-stack Developer Hiring Test”.
Gdy integracja będzie gotowa, Twój Inżynier Rozwiązań HackerRank może wykonać jednorazowy masowy eksport wszystkich nazw testów i ID testów do wprowadzenia do BrassRing.
Za każdym razem, gdy w HackerRank zostaną utworzone nowe testy, które muszą być użyte w BrassRing, będziesz musiał dodać je ręcznie.
Skonfiguruj eksport kandydatów
Pobierz klucz API BrassRing z HackerRank for Work
Zaloguj się do HackerRank for Work za pomocą konta administratora firmy.
Na stronie głównej kliknij rozwijane menu obok ikony użytkownika w prawym górnym rogu.
Kliknij Ustawienia.
Na lewym panelu kliknij Integracje. Wyświetlana jest strona Integracje . Przewiń w dół i kliknij Konfiguruj na opcji BrassRing. Możesz również wyszukać integrację za pomocą paska wyszukiwania.
Kliknij Generuj token API, aby wygenerować token API.
Wyświetlany jest unikalny klucz API.
Skopiuj ten klucz. Będziesz musiał dodać ten klucz do konta BrassRing, aby nawiązać integrację.
Uwaga: Upewnij się, że bezpiecznie przechowujesz klucz API. Po zamknięciu wyskakującego okienka nie będziesz mógł ponownie odzyskać klucza.
Konfiguracja URL i uwierzytelniania
W BrassRing utwórz nową ładunek eksportu Kandydatów. Powinien być wysłany na następujący adres URL:
https://ats.hackerrank.com/brassring/v2/invite
Użytkownik dla tego eksportu powinien być ustawiony na klucz API BrassRing wygenerowany w HackerRank. (Pole hasła nie jest używane przez HackerRank i można je ustawić na dowolną wartość, jeśli jest to pole obowiązkowe.)
Uwaga - Klucz API może być dłuższy niż pola nazwy użytkownika i hasła. Jeśli tak jest, będziesz musiał złożyć wniosek do swojego przedstawiciela ds. integracji IBM, aby został on skonfigurowany przez IBM.
Konfiguracja ładunku XML eksportu kandydatów
To jest format dla XML eksportu kandydatów, który jest obsługiwany przez HackerRank od razu. Będziesz musiał skonfigurować Workbench, aby utworzyć odpowiadający XML:
<?xml version="1.0" encoding="UTF-8"?>
<Envelope version="01.00">
<Sender>
<Id></Id>
<Credential></Credential>
</Sender>
<Recipient>
<Id></Id>
</Recipient>
<TransactInfo transactType="data">
<TransactId></TransactId>
<TimeStamp></TimeStamp>
</TransactInfo>
<Packet>
<PacketInfo packetType="data">
<PacketId>1</PacketId>
<Action>SET</Action>
<Manifest>HACKERRANK_CANDIDATE</Manifest>
</PacketInfo>
<Payload><![CDATA[<?xml version="1.0"?>
<HACKERRANK_CANDIDATE>
<CANDIDATEID></CANDIDATEID>
<REQUISITIONNUMBER></REQUISITIONNUMBER>
<BRREQNUMBER></BRREQNUMBER>
<JOBCODE></JOBCODE>
<STATUS></STATUS>
<EMAIL></EMAIL>
<FIRSTNAME></FIRSTNAME>
<LASTNAME></LASTNAME>
<HR_ACCOMMODATION></HR_ACCOMMODATION>
</HACKERRANK_CANDIDATE>
]]></Payload>
</Packet>
<Packet>
<PacketInfo packetType="data">
<PacketId>2</PacketId>
<Action>SET</Action>
<Manifest>HACKERRANK_CANDIDATE_REQEXPORT</Manifest>
</PacketInfo>
<Payload><![CDATA[<HACKERRANK_CANDIDATE_REQEXPORT language="en">
<REQFORM id="111"></REQFORM>
<RECRUITEREMAIL></RECRUITEREMAIL>
<HACKERRANKTESTID></HACKERRANKTESTID>
</HACKERRANK_CANDIDATE_REQEXPORT>
]]></Payload>
</Packet>
</Envelope>Wymagane pola systemowe
Nazwa pola
Format
Uwaga
CANDIDATEID
Integer
To jest unikalny identyfikator kandydata w systemie BrassRing
REQUISITIONNUMBER
Varchar
(Opcjonalnie) To jest numer wymagań klienta, również określany jako Opcjonalny numer wymagań. Wartość będzie pusta, jeśli klient go nie używa
BRREQNUMBER
Varchar
To jest unikalny identyfikator oferty w BrassRing. Zawsze jest to wartość kończąca się na „BR”, na przykład 100 BR, 3423BR itp.
JOBCODE
Varchar
(Opcjonalnie) To jest standardowy kod stanowiska powiązany z ofertą pracy
STATUS
Varchar
(Opcjonalnie) To jest wartość statusu HR, która wywołała integrację
Niestandardowe pola kandydata
Nazwa pola
Format
Uwaga
Varchar
To jest adres e-mail kandydata. HackerRank wyśle e-mail z zaproszeniem.
FIRSTNAME
Varchar
Imię kandydata.
LASTNAME
Varchar
Nazwisko kandydata.
HR_ACCOMMODATION
Varchar
(Opcjonalne) To pole reprezentuje czas dostosowania, specyficzny dla kandydata. Pole oczekuje wartości w procentach. Czas procentowy zostanie dodany do testu, aby utworzyć czas testu dostosowany do kandydata. Na przykład, jeśli test trwa 1 godzinę, możesz wpisać 50, aby test trwał 1 godzinę i 30 minut.
Własne pola rekrutacyjne
Nazwa pola
Format
Uwaga
RECRUITEREMAIL
Varchar
To jest adres e-mail użytkownika w BrassRing, który wykonuje akcję. Jest to ważne, aby raport z HackerRank został wysłany do odpowiedniego rekrutera. Dodatkowo zapewnia to poprawne audytowanie w HackerRank.
HACKERRANKTESTID
Varchar
To jest ID testu, który powinien zostać wysłany do kandydata. Na przykład, ID testu dla poniższego URL testu to 454785: https://www.hackerrank.com/work/tests/454785/questions
Podgląd wysyłki XML eksportu kandydata do HackerRank
Po zakończeniu konfiguracji Workbench, wygeneruj przykładowy XML i wyślij go do HackerRank w celu weryfikacji.
Konfiguracja importu formularza
Ustawienie XML eksportu kandydata
To jest format dla Importu XML formularza, który jest wysyłany z HackerRank od podstaw. Będziesz musiał skonfigurować Workbench, aby utworzyć odpowiadający XML:
<?xml version="1.0" encoding="UTF-8"?>
<Envelope version="01.00">
<Sender>
<Id>HRXMLEMPLID</Id>
<Credential></Credential>
</Sender>
<Recipient>
<Id />
</Recipient>
<TransactInfo transactType="data">
<TransactId></TransactId>
<TimeStamp>M</TimeStamp>
</TransactInfo>
<Packet>
<PacketInfo packetType="data">
<PacketId>1</PacketId>
<Action>SET</Action>
<Manifest>HACKERRANK_FORM_IMPORT</Manifest>
</PacketInfo>
<Payload><![CDATA[<?xml version="1.0"?>
<form formTypeId="(generated by BR)" formName="HackerRank Results" formId="" action="UpdateIndividual" resumeKey="" FirstName="" LastName="" email="" homePhone="" language="EN" autoreq="" optionalreq="">
<FormInput name="(generated by BR)" title="Assessment Name"></FormInput>
<FormInput name="(generated by BR)" title="First Name"></FormInput>
<FormInput name="(generated by BR)" title="Last Name"></FormInput>
<FormInput name="(generated by BR)" title="Percentage"></FormInput>
<FormInput name="(generated by BR)" title="Requisition ID"></FormInput>
<FormInput name="(generated by BR)" title="Date of Assessment"></FormInput>
<FormInput name="(generated by BR)" title="Link to Assessment Summary Page"></FormInput>
<FormInput name="(generated by BR)" title="Overall Score"></FormInput>
<FormInput name="(generated by BR)" title="Assessment Code/ID"></FormInput>
<FormInput name="(generated by BR)" title="Candidate Status"></FormInput>
</form>]]></Payload>
</Packet>
</Envelope>
Niowe pola formularza
To jest status wyników kandydata. Pasuje do statusu, który jest wyświetlany w HackerRank.
Nazwa pola
Uwaga
Nazwa oceny
To jest adres e-mail kandydata. HackerRank wyśle e-mail z zaproszeniem.
Imię
Imię kandydata.
Nazwisko
Nazwisko kandydata.
Procent
To jest wynik procentowy kandydata
ID Wniosku
To jest numer wniosku. Będzie on odpowiadał BRREQNUMBER z Eksportu Kandydata.
Data oceny
To jest data oceny
Link do Podsumowania Oceny
To jest link powrotny do wyników testu w HackerRank
Ogólny wynik
To jest wynik, w punktach.
Kod/ID oceny
To jest test, który został wykonany.
Status kandydata
Podgląd przesyłania XML Payload Importu Formularza do HackerRank
Następujące pola są generowane przez BrassRing i będą specyficzne dla środowiska:
pole formTypeID
pole formName
Każde pole nazwy FormInput
Po utworzeniu ładunku XML, musisz wysłać podglądowy plik XML do HackerRank, aby poprawne identyfikatory mogły zostać wysłane z HackerRank for Work.