IBM Kenexa BrassRing - HackerRankテスト統合

概要

以下の図は、採用担当者向けのBrassRingとHackerRankの統合のワークフローを示しています。採用担当者は候補者をカスタムのHackerRankテストステータスに移動させます。このステータスに入ると、BrassRingは候補者エクスポートAPIを通じてHackerRankにペイロードを送信します。HackerRankはその後、候補者にテスト招待を送ります。候補者がテストを完了し、HackerRankがテストを採点した後、HackerRankは結果をフォームインポートAPIを通じてBrassRingに返送します。

前提条件

統合手順

統合は3つのステップで行われます：

• BrassRingでのHackerRankテストのリストを設定する

• 候補者エクスポートを設定する

• フォームインポートを設定する

BrassRingでのHackerRankテストリストの設定

テストのリストは、HACKERRANK_TEST_IDフィールドのオプションとしてBrassRing側に設定する必要があります。

最初に統合を構築およびテストするときは、HackerRank Testページから名前とTest IDを、それぞれページURLから取得できます。以下の例では、Test IDは454785で、Test Nameは「HackerRank Full-stack Developer Hiring Test」です。

統合が準備できたら、HackerRank Solutions EngineerがすべてのTest NameとTest IDの一括エクスポートを一度だけ行い、それらをBrassRingに入力できます。

HackerRankで新しいテストが作成され、それをBrassRingで使用する必要がある場合は、手動で追加する必要があります。

候補者エクスポートの設定

HackerRank for WorkからBrassRing APIキーを取得

1. Company AdminユーザーアカウントでHackerRank for Workにログインします。  

2. ホームページで、右上隅のユーザーアイコンの横にあるドロップダウンをクリックします。

3. 設定をクリックします。

   

4. 左側のペインで、統合をクリックします。統合ページが表示されます。下にスクロールして、設定をクリックします。BrassRingオプションの< b>設定をクリックします。検索バーから統合を検索することもできます。

   

5. APIトークンを生成をクリックして、APIトークンを生成します。

   

   一意のAPIキーが表示されます。

   

6. このキーをコピーします。このキーをBrassRingアカウントに追加して、統合を確立します。

URLと認証設定

BrassRingで、新しい候補者エクスポートペイロードを作成します。次のURLに送信する必要があります：

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

このエクスポートのユーザー名は、HackerRank内で生成されたBrassRing APIキーに設定してください。（パスワードフィールドはHackerRankでは使用されず、必須フィールドの場合は任意の値に設定できます。）

注意 - APIキーは、ユーザー名とパスワードのフィールドよりも長い場合があります。その場合は、IBMの統合担当者にリクエストして、IBMによる設定を行ってもらう必要があります。

候補者エクスポートXMLペイロードの設定

これは、HackerRankが標準で理解する候補者エクスポートXMLのフォーマットです。対応するXMLを作成するためにWorkbenchを設定する必要があります：

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

必須システムフィールド

カスタム候補者フィールド

カスタムリクエジションフィールド 

HackerRankへの候補者エクスポートXMLペイロードプレビュー送信

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への送信フォームインポートXMLペイロードプレビュー

以下のフィールドはBrassRingによって生成され、環境固有のものです： 

• formTypeIDフィールド

• formNameフィールド

• 各FormInputのnameフィールド

XMLペイロードが作成されたら、HackerRankにプレビューXMLを送信する必要があります。そうすることで、HackerRank for Workから正しい識別子を送信できます。