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. 

image2.png

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. 

integ_brassring.png

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

  1. Zaloguj się do HackerRank for Work za pomocą konta administratora firmy.

  2. Na stronie głównej kliknij rozwijane menu obok ikony użytkownika w prawym górnym rogu.

  3. Kliknij Ustawienia.

    settings.png
  4. 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.

    integ_brassring1.png
  5. Kliknij Generuj token API, aby wygenerować token API.

    integ_brassring_api.png

    Wyświetlany jest unikalny klucz API.

    integ_brassring_api_token.png
  6. 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

EMAIL

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.