IBM Kenexa BrassRing - HackerRank 測試整合

Last updated: December 27, 2024

概述

以下圖描述了招聘人員使用 BrassRing 和 HackerRank 整合的工作流程。招聘人員將候選人移動到自訂的 HackerRank 測試狀態。進入此狀態後，BrassRing 會通過候選人導出 API 向 HackerRank 發送有效載荷。HackerRank 然後會向候選人發送測試邀請。候選人完成測試並由 HackerRank 評分後，HackerRank 會通過表單導入 API 將結果返回 BrassRing。

前提條件

在 HackerRank for Work 中

在 BrassRing 中

您必須擁有企業方案並具有招聘人員許可證。
您必須擁有已啟用的 招聘人員 類型用戶帳戶，並具有 公司管理員 權限。此用戶帳戶必須屬於任何團隊。
建議：用於整合測試的 HackerRank for Work 沙箱帳戶。

您必須是 BrassRing 客戶，並且可以訪問候選人導出和表單導入 API。如果不確定是否有權訪問這些 API，請聯繫您的 IBM 代表。
您必須：是 Workbench 管理員並自行配置整合，或與 IBM 專業服務合作。
建議：用於整合測試的 BrassRing 沙箱環境。

整合步驟

整合涉及三個步驟：

在 BrassRing 中配置 HackerRank 測試列表
配置候選人導出
配置表單導入

在 BrassRing 中配置 HackerRank 測試列表

測試列表需要在 BrassRing 端作為 HACKERRANK_TEST_ID 欄位中的選項設置。

在首次建立和測試整合時，您可以從 HackerRank 測試頁面獲取名稱和測試ID，分別為測試頁面和頁面URL。在下面的範例中，測試ID為454785，測試名稱為「HackerRank 全端開發人員招聘測試」。

當整合準備就緒後，您的 HackerRank 解決方案工程師可以一次性匯出所有測試名稱和測試ID，然後輸入到 BrassRing 中。

每當在 HackerRank 中創建新的測試需要在 BrassRing 中使用時，您都需要手動添加它們。

配置候選人匯出

從 HackerRank for Work 獲取 BrassRing API 密鑰

使用公司管理員帳戶登入 HackerRank for Work。
在首頁，點擊右上角用戶圖示旁的下拉選單。
點擊設定。
在左側面板，點擊整合。整合頁面將顯示。向下滾動並點擊配置在 BrassRing 選項上。您也可以從搜尋列搜尋整合。
點擊 產生 API 令牌 以產生 API 令牌。
顯示一個獨特的 API 金鑰。
複製此金鑰。您需要將此金鑰新增到 BrassRing 帳戶中以建立整合。

注意：確保安全存儲 API 金鑰。關閉彈出窗口後，您將無法再次檢索該金鑰。

URL 和認證設置

在 BrassRing 中，創建一個新的候選人導出負載。它應該被發送到以下 URL：

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

此導出的用戶名應設置為在 HackerRank 中生成的 BrassRing API 金鑰。（HackerRank 不使用密碼欄位，如果它是必填欄位，可以設置為任何值。）

注意 - API 金鑰可能比用戶名和密碼欄位允許的長度更長。如果是這種情況，您將需要向您的 IBM 集成代表提出請求，讓 IBM 進行配置。

設置候選人導出 XML 負載

這是 HackerRank 開箱即用的候選人導出 XML 格式。您將需要配置 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 狀態值

自訂候選人欄位

欄位名稱

格式

備註

Varchar

這是候選人的電子郵件地址。HackerRank 會寄送邀請電子郵件。

FIRSTNAME

Varchar

候選人名字。

LASTNAME

Varchar

候選人姓氏。

HR_ACCOMMODATION

Varchar

（可選）此欄位代表候選人特定的時間調整。此欄位預期輸入百分比值。百分比時間將加入測驗中，以創建候選人專屬的測驗時間。例如，測驗時間為1小時，您可以輸入50，使測驗時間變為1小時30分鐘。

自訂需求欄位

欄位名稱

格式

備註

RECRUITEREMAIL

Varchar

這是 BrassRing 中執行動作的使用者的電子郵件地址。這很重要，這樣 HackerRank 的報告才能發送給正確的招聘人員。此外，這也確保了在 HackerRank 中的正確審核。

HACKERRANKTESTID

Varchar

這是應該傳送給候選人的測試 ID。例如，以下測試 URL 的測試 ID 為 454785：https://www.hackerrank.com/work/tests/454785/questions

傳送候選人匯出 XML 負載預覽至 HackerRank

完成 Workbench 配置後，產生範例 XML 並傳送給 HackerRank 進行驗證。

配置表單匯入

設定候選人匯出 XML 負載

這是從 HackerRank 預設傳送的表單匯入 XML的格式。你需要配置 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="(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>

自訂表單欄位

這是候選人結果的狀態。它與 HackerRank 顯示的狀態相符。

欄位名稱

備註

評估名稱

這是候選人的電子郵件地址。HackerRank 會寄送邀請電子郵件。

名字

候選人名字。

姓氏

候選人姓氏。

百分比

這是候選人的百分比得分

需求編號

這是需求編號。它將與候選人匯出中的 BRREQNUMBER 相符。

評估日期

這是評估的日期

評估摘要連結

這是回到 HackerRank 測試結果的連結

整體分數

這是分數，以點數表示。

評估代碼/ID

這是所進行的測試。

候選人狀態

發送表單導入 XML 負載預覽至 HackerRank

以下欄位由 BrassRing 產生，並且會依環境而異：

formTypeID 欄位
formName 欄位
每個 FormInput 名稱欄位

一旦建立了 XML 負載，您必須將預覽 XML 發送給 HackerRank，以便從 HackerRank for Work 發送正確的識別碼。