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

向 HackerRank 预览候选人导出 XML 负载

配置工作台完成后，生成示例 XML 并发送给 HackerRank 进行验证。

配置表单导入

设置候选人导出 XML 负载

这是 HackerRank 默认发送的表单导入 XML的格式。您需要配置工作台以创建匹配的 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 将发送邀请电子邮件。

名字

候选人名字。

姓氏

候选人姓氏。

百分比

这是候选人的百分比得分

招聘ID

这是招聘编号。它将与候选人导出中的 BRREQNUMBER 匹配。

评估日期

这是评估的日期

评估摘要链接

这是返回 HackerRank 测试结果的链接

总体得分

这是得分，单位为分数。

评估代码/ID

这是所参加的测试。

候选人状态

发送表单导入 XML 负载预览到 HackerRank

以下字段由 BrassRing 生成，并且将根据环境而异：

formTypeID 字段
formName 字段
每个 FormInput 名称字段

一旦XML负载创建完成，您必须向HackerRank发送预览XML，以便从HackerRank for Work中发送正确的标识符。