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.
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.
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
Log in op HackerRank for Work met het bedrijfsbeheerder account.
Op de startpagina, klik op de dropdown naast het gebruikersicoon in de rechterbovenhoek.
Klik op Instellingen.
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.
Klik op Genereer API-token om de API-token te genereren.
Een unieke API-sleutel wordt weergegeven.
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
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.