IBM Kenexa BrassRing - Integração de Testes HackerRank

Visão Geral

Abaixo o diagrama descreve o fluxo de trabalho da integração BrassRing e HackerRank para recrutadores. Os recrutadores irão mover um candidato para um status personalizado de Teste HackerRank. Ao entrar neste status, BrassRing enviará uma carga útil para o HackerRank via API de Exportação de Candidato. O HackerRank então enviará um convite para o teste ao candidato. Após o candidato ter concluído o teste e o HackerRank ter avaliado o teste, o HackerRank enviará os resultados de volta ao BrassRing via API de Importação de Formulários. 

Pré-requisitos

Etapas da Integração

A integração envolve um processo de 3 etapas:

• Configurar a Lista de Testes do HackerRank no BrassRing

• Configurar a Exportação de Candidatos 

• Configurar a Importação de Formulários 

Configurar a Lista de Testes do HackerRank no BrassRing

As listas de testes precisam ser configuradas no lado do BrassRing como opções em um campo HACKERRANK_TEST_ID. 

Ao construir e testar a integração pela primeira vez, você pode obter o Nome e o ID de Teste na página de Teste do HackerRank e a URL da página, respectivamente. No exemplo abaixo, o ID do Teste é 454785 e o Nome do Teste é “Teste de Contratação de Desenvolvedor Full-stack do HackerRank”.

Quando a integração estiver pronta, seu Engenheiro de Soluções HackerRank pode fazer uma exportação em massa de todos os Nomes de Teste e IDs de Teste para serem inseridos no BrassRing.

Sempre que novos testes forem criados no HackerRank que precisem ser usados no BrassRing, você precisará adicioná-los manualmente. 

Configurar a Exportação de Candidatos 

Obtenha a chave API do BrassRing do HackerRank for Work

1. Faça login no HackerRank for Work com a conta de usuário do Administrador da Empresa.

2. Na página inicial, clique na seta ao lado do ícone do usuário no canto superior direito.

3. Clique Configurações.

   

4. No painel esquerdo, clique Integrações. A página Integrações é exibida. Role para baixo e clique em Configurar na opção BrassRing. Você também pode procurar a Integração na barra de Pesquisa.

   

5. Clique em Gerar Token API para gerar o token API.

   

   Uma chave API única é exibida.

   

6. Cole esta chave. Você precisará adicionar esta chave à conta BrassRing para estabelecer a integração.

Configuração de URL e Autenticação

No BrassRing, crie uma nova carga útil de Exportação de Candidato. Ela deve ser enviada para a seguinte URL:

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

O nome de usuário para esta exportação deve ser definido como a chave da API do BrassRing gerada dentro do HackerRank. (O campo de senha não é usado pelo HackerRank e pode ser definido com qualquer valor se for um campo obrigatório.)

Nota - A chave da API pode ser maior do que os campos de nome de usuário e senha permitem. Se for esse o caso, você precisará fazer uma solicitação ao seu representante de integração da IBM para que ela seja configurada pela IBM.

Configurar Payload XML de Exportação de Candidato

Este é o formato para o XML de Exportação de Candidato que é compreendido pelo HackerRank de forma padrão. Você precisará configurar o Workbench para criar um XML correspondente:

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

Campos obrigatórios do sistema

Campos Personalizados do Candidato  

Campos Personalizados de Requisição  

Pré-visualização do Payload XML de Exportação do Candidato para HackerRank 

Assim que a configuração do Workbench estiver concluída, gere o XML de amostra e envie para o HackerRank para validação.

Configurar a Importação do Formulário 

Configurar Payload XML de Exportação do Candidato

Este é o formato para o XML de Importação de Formulário que é enviado do HackerRank de fábrica. Você precisará configurar o Workbench para criar um XML correspondente:

<?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="(gerado pelo BR)" formName="Resultados do HackerRank" formId="" action="UpdateIndividual" resumeKey="" FirstName="" LastName="" email="" homePhone="" language="EN" autoreq="" optionalreq="">
<FormInput name="(gerado pelo BR)" title="Nome da Avaliação"></FormInput>
<FormInput name="(gerado pelo BR)" title="Nome"></FormInput>
<FormInput name="(gerado pelo BR)" title="Sobrenome"></FormInput>
<FormInput name="(gerado pelo BR)" title="Percentagem"></FormInput>
<FormInput name="(gerado pelo BR)" title="ID da Requisição"></FormInput>
<FormInput name="(gerado pelo BR)" title="Data da Avaliação"></FormInput>
<FormInput name="(gerado pelo BR)" title="Link para a Página de Resumo da Avaliação"></FormInput>
<FormInput name="(gerado pelo BR)" title="Pontuação Geral"></FormInput>
<FormInput name="(gerado pelo BR)" title="Código/ID da Avaliação"></FormInput>
<FormInput name="(gerado pelo BR)" title="Status do Candidato"></FormInput>
</form>]]></Payload>
  </Packet>
</Envelope>

Campos Personalizados do Formulário  

Este é o status dos resultados do candidato. Ele corresponde ao status que é mostrado no HackerRank.  

Visualização Prévia do Payload XML de Importação do Formulário para HackerRank

Os seguintes campos são gerados pelo BrassRing e serão específicos do ambiente: 

• campo formTypeID

• campo formName

• Cada campo name do FormInput

Assim que a carga útil XML for criada, você deve enviar uma pré-visualização do XML para o HackerRank para que os identificadores corretos possam ser enviados do HackerRank for Work.