IBM Kenexa BrassRing - אינטגרציה של מבחני HackerRank

Last updated: December 27, 2024

סקירה

התרשים שלהלן מתאר את תהליך העבודה של אינטגרציית BrassRing ו-HackerRank למגייסים. המגייסים יזיזו מועמד למצב מותאם אישית של מבחן HackerRank. עם כניסה למצב זה, BrassRing ישגר מטען ל-HackerRank באמצעות API ייצוא מועמד. HackerRank ישלח אז הזמנה למבחן למועמד. לאחר שהמועמד סיים את המבחן ו-HackerRank דרג את המבחן, HackerRank ישלח את התוצאות חזרה ל-BrassRing באמצעות API ייבוא טפסים. 

image2.png

דרישות מוקדמות

ב-HackerRank לעבודה

ב-BrassRing

  • עליך להיות בעל תוכנית Enterprise עם רישיון מגייסים.

  • עליך иметь חשבון משתמש מסוג מגייס פעיל עם הרשאות מנהל חברה. חשבון משתמש זה חייב להשתייך לכל צוות.

  • מומלץ: חשבון Sandbox של HackerRank לעבודה לבדיקה של אינטגרציה.

  • עליך להיות לקוח של BrassRing עם גישה ל-API ייצוא מועמדים ו-API ייבוא טפסים. פנה לנציג IBM שלך אם אינך בטוח אם יש לך גישה ל-API אלה.

  • עליך להיות או: מנהל סדנת עבודה ולהגדיר את האינטגרציה בעצמך או לעבוד עם שירותי מקצוע של IBM.

  • מומלץ: סביבה Sandbox של BrassRing לבדיקה של אינטגרציה. 

שלבי אינטגרציה

התהליך של אינטגרציה כולל 3 שלבים:

  • הגדר את רשימת המבחנים של HackerRank ב-BrassRing

  • הגדר את ייצוא המועמד

  • הגדר את ייבוא הטפסים

הגדר את רשימת המבחנים של HackerRank ב-BrassRing

רשימות המבחנים חייבות להיות מוגדרות בצד BrassRing כאפשרויות בשדה HACKERRANK_TEST_ID. 

integ_brassring.png

כאשר בונים ובודקים את האינטגרציה בפעם הראשונה, ניתן לקבל את השם ומזהה המבחן מדף המבחן של HackerRank ואת כתובת ה-URL של הדף, בהתאמה. בדוגמה למטה, מזהה המבחן הוא 454785 ושם המבחן הוא "מבחן גיוס מפתח Full-stack של HackerRank".

כאשר האינטגרציה מוכנה, מהנדס הפתרונות של HackerRank שלך יכול לבצע ייצוא המוני חד פעמי של כל שמות המבחנים ומזהי המבחנים כדי להכניס ל-BrassRing.

בכל פעם שנוצרים במערכת HackerRank מבחנים חדשים שיש להשתמש בהם ב-BrassRing, תצטרך להוסיף אותם ידנית. 

הגדר את ייצוא המועמדים 

קבל את מפתח ה-API של BrassRing מ-HackerRank לעבודה

  1. היכנס ל-HackerRank לעבודה עם חשבון מנהל החברה.

  2. בדף הבית, לחץ על התפריט הנפתח ליד סמל המשתמש בפינה הימנית העליונה.

  3. לחץ על הגדרות.

    settings.png
  4. בצד השמאלי, לחץ על אינטגרציות. דף ה אינטגרציות מוצג. גלול למטה ולחץ על הגדר באופציה BrassRing. תוכל גם לחפש את האינטגרציה משורת החיפוש.

    integ_brassring1.png
  5. לחץ על יצירת אסימון API כדי ליצור את אסימון ה-API.

    integ_brassring_api.png

    מופיע מפתח API ייחודי.

    integ_brassring_api_token.png
  6. העתק מפתח זה. תצטרך להוסיף מפתח זה לחשבון BrassRing כדי לקבוע את האינטגרציה.

הערה: ודא לאחסן את מפתח ה-API באופן בטוח. ברגע שהחלון הקופץ נסגר, אינך יכול לשחזר את המפתח שוב.

הגדרת URL ואימות

ב-BrassRing, צור עומס של יצוא מועמדים חדש. עליו להישלח לכתובת ה-URL הבאה:

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

שם המשתמש ליצוא זה צריך להיות מוגדר כמפתח ה-API של BrassRing שנוצר בתוך HackerRank. (שדה הסיסמה לא משמש את HackerRank וניתן להגדיר אותו לכל ערך אם זה שדה חובה.)

הערה - ייתכן שמפתח ה-API יהיה ארוך יותר משדות שם המשתמש והסיסמה מאפשרים. אם זה המקרה, תצטרך לפנות לנציג האינטגרציה של IBM כדי שיאפשרו זאת על ידי IBM.

הגדרת עומס XML ליצוא מועמדים

זהו הפורמט ל-XML ליצוא מועמדים שמובן על ידי HackerRank כברירת מחדל. תצטרך להגדיר את Workbench ליצירת 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>

שדות מערכת חובה

שם השדה

פורמט

הערה

CANDIDATEID

מספר שלם

זהו המזהה הייחודי של המועמד במערכת BrassRing

REQUISITIONNUMBER

Varchar

(אופציונלי) זהו מספר הדרישה של הלקוח, המכונה גם מספר דרישה אופציונלי. הערך יהיה ריק אם הלקוח לא משתמש בו

BRREQNUMBER

Varchar

זהו המזהה הייחודי של המשרה ב-BrassRing. זה תמיד ערך שמסתיים ב-“BR”, לדוגמה 100 BR, 3423BR, וכן הלאה.

JOBCODE

Varchar

(אופציונלי) זהו קוד המשרה הסטנדרטי הקשור למשרה

STATUS

Varchar

(אופציונלי) זהו ערך מצב HR שהפעיל את האינטגרציה

שדות מועמד מותאמים

שם השדה

פורמט

הערה

EMAIL

Varchar

זהו כתובת הדוא"ל של המועמד. HackerRank ישלח את דוא"ל ההזמנה. 

FIRSTNAME

Varchar

שם הפרטי של המועמד. 

LASTNAME

Varchar

שם המשפחה של המועמד. 

HR_ACCOMMODATION

Varchar

(אופציונלי) שדה זה מייצג התאמה בזמן שהינה ספציפית למועמד. השדה מצפה לערך באחוזים. הזמן באחוזים יתווסף למבחן ליצירת זמן מבחן ספציפי למועמד. לדוגמה, אם המבחן הוא שעה, תוכל לשלוח 50 כדי שהמבחן יהיה שעה ו-30 דקות. 

שדות הזמנה מותאמים אישית  

שם השדה

פורמט

הערה

RECRUITEREMAIL

Varchar

זהו כתובת הדוא"ל של המשתמש ב-BrassRing שמבצע את הפעולה. זה חשוב כדי שהדוח מ-HackerRank יישלח למגייס הנכון. בנוסף, זה מבטיח בקרה נכונה ב-HackerRank. 

HACKERRANKTESTID

Varchar

זהו מזהה המבחן של המבחן שיש לשלוח למועמד. לדוגמה, מזהה המבחן עבור כתובת ה-URL של המבחן הבא הוא 454785: https://www.hackerrank.com/work/tests/454785/questions

תצוגת קצה של תצוגת XML ליצוא מועמד להעלאה ל-HackerRank

ברגע שההגדרה של ה-Workbench הושלמה, יצור את ה-XML המדגם ושלח ל-HackerRank לאימות.

הגדר את ייבוא הטופס

הגדר את תצורת ה-XML ליצוא מועמד

זהו הפורמט ל-XML ייבוא טופס שנשלח מ-HackerRank כברירת מחדל. תצטרך להגדיר את ה-Workbench ליצירת 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="(נוצר על ידי BR)" formName="תוצאות HackerRank" formId="" action="UpdateIndividual" resumeKey="" FirstName="" LastName="" email="" homePhone="" language="EN" autoreq="" optionalreq="">
<FormInput name="(נוצר על ידי BR)" title="שם המבחן"></FormInput>
<FormInput name="(נוצר על ידי BR)" title="שם פרטי"></FormInput>
<FormInput name="(נוצר על ידי BR)" title="שם משפחה"></FormInput>
<FormInput name="(נוצר על ידי BR)" title="אחוזון"></FormInput>
<FormInput name="(נוצר על ידי BR)" title="מספר זיהוי של דרישה"></FormInput>
<FormInput name="(נוצר על ידי BR)" title="תאריך ההערכה"></FormInput>
<FormInput name="(נוצר על ידי BR)" title="קישור לדף סיכום ההערכה"></FormInput>
<FormInput name="(נוצר על ידי BR)" title="ציון כולל"></FormInput>
<FormInput name="(נוצר על ידי BR)" title="קוד/זיהוי הערכה"></FormInput>
<FormInput name="(נוצר על ידי BR)" title="סטטוס מועמד"></FormInput>
</form>]]></Payload>
  </Packet>
</Envelope>

שדות טופס מותאמים אישית  

זהו מצב תוצאות המועמד. זה תואם למצב שמוצג ב-HackerRank.  

שם השדה 

הערה

שם הערכה

זהו כתובת הדוא"ל של המועמד. HackerRank ישלח את דוא"ל ההזמנה. 

שם פרטי

שם פרטי של המועמד. 

שם משפחה

שם משפחה של המועמד. 

אחוזים

זהו הציון באחוזים של המועמד

מספר דרישה

זהו מספר הדרישה. זה יתאים ל-BRREQNUMBER מייצוא המועמד. 

תאריך הערכה

זהו תאריך ההערכה

קישור לסיכום ההערכה

זהו קישור חזרה לתוצאות המבחן ב-HackerRank

ציון כולל

זהו הציון, בנקודות. 

קוד/זהות הערכה

זהו המבחן שנלקח. 

סטטוס מועמד

תצוגה מקדימה של טען ה-XML לייבוא טופס שלח ל-HackerRank

השדות הבאים נוצרו על ידי BrassRing ויהיו תלויים בסביבה: 

  • שדה formTypeID

  • שדה formName

  • כל שדה שם FormInput

ברגע שנוצר עומס ה-XML, עליך לשלוח תצוגה מקדימה של XML ל-HackerRank כדי שהזיהויים הנכונים יישלחו מ-HackerRank לעבודה.