IBM Kenexa BrassRing - HackerRank Tests Integratie

Last updated: December 27, 2024

Overzicht

De onderstaande diagram beschrijft de workflow van de BrassRing en HackerRank integratie voor recruiters. Recruiters zullen een kandidaat verplaatsen naar een aangepaste HackerRank Test-status. Bij het invoeren van deze status, zal BrassRing een payload verzenden naar HackerRank via de candidate Export API. HackerRank zal vervolgens een testuitnodiging sturen naar de kandidaat. Nadat de kandidaat de test heeft voltooid en HackerRank de test heeft beoordeeld, zal HackerRank de resultaten terugsturen naar BrassRing via de Form Import API. 

image2.png

Vereisten

In HackerRank for Work

In BrassRing

  • Je moet een Enterprise-abonnement hebben met een Recruiter-licentie.

  • Je moet een geactiveerd Recruiter-type gebruikersaccount hebben met Company Admin-rechten. Dit gebruikersaccount moet tot een team behoren.

  • Aanbevolen: HackerRank for Work Sandbox-account voor integratietests.

  • Je moet een BrassRing-klant zijn met toegang tot Candidate Export en Form Import API's. Neem contact op met je IBM-vertegenwoordiger als je niet zeker weet of je toegang hebt tot deze API's.

  • Je moet ofwel: een Workbench-beheerder zijn en de integratie zelf configureren of samenwerken met IBM professionele diensten.

  • Aanbevolen: BrassRing Sandbox-omgeving voor integratietests. 

Integratiestappen

De integratie omvat een proces van 3 stappen:

  • Configureer de lijst met HackerRank-tests in BrassRing

  • Configureer de Candidate Export 

  • Configureer de Form Import 

Configureer de lijst met HackerRank-tests in BrassRing

De lijsten met tests moeten worden ingesteld aan de zijde van BrassRing als opties in een HACKERRANK_TEST_ID-veld. 

integ_brassring.png

Bij het opbouwen en testen van de integratie voor de eerste keer, kunt u de Naam en Test-ID krijgen van de HackerRank Test-pagina en de pagina-URL, respectievelijk. In het onderstaande voorbeeld is de Test-ID 454785 en de Testnaam is “HackerRank Full-stack Developer Hiring Test.”

Wanneer de integratie klaar is, kan uw HackerRank Solutions Engineer een eenmalige bulkexport doen van alle Testnamen en Test-IDs die in BrassRing moeten worden ingevoerd.

Elke keer dat er nieuwe tests worden gemaakt in HackerRank die in BrassRing moeten worden gebruikt, moet u ze handmatig toevoegen.

Configureer de kandidaat-export

Verkrijg de BrassRing API-sleutel van HackerRank for Work

  1. Log in op HackerRank for Work met het bedrijfsbeheerder account.

  2. Op de startpagina, klik op de dropdown naast het gebruikersicoon in de rechterbovenhoek.

  3. Klik op Instellingen.

    settings.png
  4. In het linker paneel, klik op Integraties. De Integraties pagina wordt weergegeven. Scroll naar beneden en klik op Configureer op de BrassRing optie. Je kunt de integratie ook zoeken via de zoekbalk.

    integ_brassring1.png
  5. Klik op Genereer API-token om de API-token te genereren.

    integ_brassring_api.png

    Een unieke API-sleutel wordt weergegeven.

    integ_brassring_api_token.png
  6. Kopieer deze sleutel. Je moet deze sleutel toevoegen aan het BrassRing-account om de integratie tot stand te brengen.

Opmerking: Zorg ervoor dat je de API-sleutel veilig opslaat. Zodra de pop-up is gesloten, kun je de sleutel niet meer ophalen.

URL- en authenticatie-instellingen

In BrassRing, maak een nieuwe Candidate Export payload aan. Deze moet worden verzonden naar de volgende URL:

https://ats.hackerrank.com/brassring/v2/invite

De gebruikersnaam voor deze export moet worden ingesteld op de BrassRing API-sleutel die binnen HackerRank is gegenereerd. (Het wachtwoordveld wordt niet gebruikt door HackerRank en kan op elke waarde worden ingesteld als het een verplicht veld is.)

Opmerking - De API-sleutel kan langer zijn dan de velden voor gebruikersnaam en wachtwoord toestaan. Als dit het geval is, moet je contact opnemen met je IBM-integratieteam om het door IBM te laten configureren.

Candidate Export XML Payload instellen

Dit is het formaat voor de Candidate Export XML dat standaard wordt begrepen door HackerRank. Je moet Workbench configureren om een overeenkomend XML te maken:

<?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>

Verplichte systeemvelden

Veldnaam

Formaat

Opmerking

CANDIDATEID

Integer

Dit is de unieke identificatie van de kandidaat in het BrassRing-systeem

REQUISITIONNUMBER

Varchar

(Optioneel) Dit is het Client Req-nummer, ook wel het Optionele Req-nummer genoemd. De waarde is leeg als de klant het niet gebruikt

BRREQNUMBER

Varchar

Dit is de unieke identificatie van de vacature in BrassRing. Het is altijd een waarde die eindigt op “BR”, bijvoorbeeld 100 BR, 3423BR, enz.

JOBCODE

Varchar

(Optioneel) Dit is de standaard functietcode die aan de vacature is gekoppeld

STATUS

Varchar

(Optioneel) Dit is de HR-statuswaarde die de integratie heeft geactiveerd

Aangepaste kandidaatvelden

Veldnaam

Formaat

Opmerking

E-MAIL

Varchar

Dit is het e-mailadres van de kandidaat. HackerRank zal de uitnodigingsmail sturen.

VOORNAAM

Varchar

Kandidaat voornaam.

Achternaam

Varchar

Kandidaat achternaam.

HR_ACCOMMODATION

Varchar

(Optioneel) Dit veld vertegenwoordigt een tijdsaanpassing die specifiek is voor de kandidaat. Het veld verwacht een waarde in procenten. De procentuele tijd wordt toegevoegd aan de test om een kandidaat-specifieke testtijd te creëren. Bijvoorbeeld, als de test 1 uur duurt, kun je 50 invoeren om de test 1 uur en 30 minuten te maken.

Aangepaste Aanvraagvelden

Veldnaam

Formaat

Opmerking

RECRUITEREMAIL

Varchar

Dit is het e-mailadres van de gebruiker in BrassRing die de actie onderneemt. Dit is belangrijk zodat het rapport van HackerRank naar de juiste recruiter wordt gestuurd. Daarnaast zorgt dit voor correcte auditing in HackerRank. 

HACKERRANKTESTID

Varchar

Dit is de Test ID van de test die naar de kandidaat moet worden gestuurd. Bijvoorbeeld, de Test ID voor de volgende test-URL is 454785: https://www.hackerrank.com/work/tests/454785/questions

Voorbeeld van de Candidate Export XML Payload naar HackerRank

Zodra de Workbench-configuratie voltooid is, genereer je de voorbeeld-XML en stuur je deze naar HackerRank ter validatie.

Configureer het Form Import

Stel Candidate Export XML Payload in

Dit is het formaat voor de Form Import XML dat standaard wordt verzonden vanuit HackerRank. Je moet Workbench configureren om een overeenkomende XML te maken:

<?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>

Aangepaste formulier velden  

Dit is de status van de resultaten van de kandidaat. Het komt overeen met de status die wordt weergegeven in HackerRank.  

Veldnaam 

Notitie

Naam beoordeling

Dit is het e-mailadres van de kandidaat. HackerRank zal de uitnodigingsmail sturen. 

Voornaam

Voornaam van de kandidaat. 

Achternaam

Achternaam van de kandidaat. 

Percentage

Dit is de percentage score voor de kandidaat

Requisitie ID

Dit is het requisitienummer. Het komt overeen met de BRREQNUMBER uit de kandidaat-export. 

Datum beoordeling

Dit is de datum van de beoordeling

Link naar beoordelingsoverzicht

Dit is een link terug naar de testresultaten in HackerRank

Algemene score

Dit is de score, in punten. 

Beoordelingscode/ID

Dit is de test die is afgenomen. 

Kandidatenstatus

Voorbeeld van het verzenden van formulier import XML-payload naar HackerRank

De volgende velden worden gegenereerd door BrassRing en zijn omgevingsspecifiek: 

  • formTypeID veld

  • formName veld

  • Elke FormInput naam veld

Wanneer de XML-payload is gemaakt, moet u een voorbeeld-XML naar HackerRank sturen zodat de juiste identificaties kunnen worden verzonden vanuit HackerRank for Work.