IBM Kenexa BrassRing - Integración de Pruebas HackerRank

Descripción general

El diagrama siguiente describe el flujo de trabajo de la integración de BrassRing y HackerRank para reclutadores. Los reclutadores moverán a un candidato a un estado de prueba personalizado de HackerRank. Al entrar en este estado, BrassRing enviará una carga útil a HackerRank a través de la API de exportación de candidatos. HackerRank enviará una invitación de prueba al candidato. Después de que el candidato haya completado la prueba y HackerRank haya calificado la prueba, HackerRank enviará los resultados de vuelta a BrassRing a través de la API de importación de formularios.

image2.png

Requisitos previos

En HackerRank para el trabajo

En BrassRing

  • Debes tener un plan Enterprise con una licencia de reclutador.

  • Debes tener una cuenta de usuario activada con tipo de Reclutador con permisos de Administrador de la empresa. Esta cuenta de usuario debe pertenecer a cualquier equipo.

  • Recomendado: cuenta de HackerRank para Work Sandbox para pruebas de integración.

  • Debes ser un cliente de BrassRing con acceso a las API de exportación de candidatos e importación de formularios. Póngase en contacto con su representante de IBM si no está seguro de tener acceso a estas API.

  • Debes: ser un administrador de Workbench y configurar la integración tú mismo o trabajar con los servicios profesionales de IBM.

  • Recomendado: entorno de BrassRing Sandbox para pruebas de integración.

Pasos de integración

La integración implica un proceso de 3 pasos:

  • Configurar la lista de pruebas de HackerRank en BrassRing

  • Configurar la exportación de candidatos

  • Configurar la importación de formularios

Configurar la lista de pruebas de HackerRank en BrassRing

Las listas de pruebas deben configurarse en el lado de BrassRing como opciones en un campo HACKERRANK_TEST_ID.

integ_brassring.png

Al crear e integrar por primera vez, puede obtener el nombre y el ID de la prueba desde la página de prueba de HackerRank y la URL de la página, respectivamente. En el ejemplo siguiente, el ID de la prueba es 454785 y el nombre de la prueba es «Prueba de contratación de desarrollador full-stack de HackerRank».

Cuando la integración esté lista, su ingeniero de soluciones de HackerRank puede hacer una exportación masiva única de todos los nombres de prueba e identificadores de prueba para ingresarlos en BrassRing.

En cualquier momento que se creen nuevas pruebas en HackerRank que deban utilizarse en BrassRing, deberá agregarlas manualmente.

Configurar la exportación de candidatos

Obtener la clave de API de BrassRing de HackerRank para trabajo

  1. Inicia sesión en HackerRank for Work con la cuenta de usuario de administrador de la empresa.

  2. En la página de inicio, haz clic en el menú desplegable junto al icono de usuario en la esquina superior derecha.

  3. Haz clic en Configuración.

    settings.png
  4. En el panel izquierdo, haz clic en Integraciones. Se muestra la página de Integraciones. Desplázate hacia abajo y haz clic en Configurar en la opción de BrassRing. También puedes buscar la integración en la barra de búsqueda.

    integ_brassring1.png
  5. Haz clic en Generar token de API para generar el token de API.

    integ_brassring_api.png

    Se muestra una clave de API única.

    integ_brassring_api_token.png
  6. Copia esta clave. Deberás agregar esta clave a la cuenta de BrassRing para establecer la integración.

Nota: Asegúrese de almacenar la clave de API de manera segura. Una vez que se cierra la ventana emergente, no puede recuperar la clave nuevamente.

Configuración de URL y autenticación

En BrassRing, cree una nueva carga útil de exportación de candidatos. Debe enviarse a la siguiente URL:

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

El nombre de usuario para esta exportación debe establecerse en la clave API de BrassRing generada dentro de HackerRank. (El campo de contraseña no es utilizado por HackerRank y se puede establecer en cualquier valor si es un campo obligatorio.) 

Nota: la clave API puede ser más larga de lo que permiten los campos de nombre de usuario y contraseña. Si este es el caso, deberá hacer una solicitud a su representante de integración de IBM para que sea configurada por IBM. 

Configuración de la carga útil XML de exportación de candidatos

Este es el formato para el Exportación de candidato XML que es entendido por HackerRank de fábrica. Necesitarás configurar Workbench para crear un XML coincidente:

<?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="es">
        <REQFORM id="111"></REQFORM>
 <RECRUITEREMAIL></RECRUITEREMAIL>
 <HACKERRANKTESTID></HACKERRANKTESTID>
</HACKERRANK_CANDIDATE_REQEXPORT>
]]></Payload>
  </Packet>
</Envelope>

Campos del sistema obligatorios

Nombre del campo

Formato

Nota

CANDIDATEID

Entero

Este es el identificador único del candidato en el sistema BrassRing

REQUISITIONNUMBER

Varchar

(Opcional) Este es el número de solicitud del cliente, también denominado como el número de solicitud opcional. El valor estará vacío si el cliente no lo utiliza.

BRREQNUMBER

Varchar

Este es el identificador único del empleo en BrassRing. Siempre es un valor que termina con 'BR', por ejemplo, 100 BR, 3423BR, etc.

JOBCODE

Varchar

(Opcional) Este es el código de empleo estándar asociado con el empleo.

STATUS

Varchar

(Opcional) Este es el valor de estado de RRHH que activó la integración.

Campos personalizados del candidato 

Nombre del campo

Formato

Nota

CORREO ELECTRÓNICO

Varchar

Esta es la dirección de correo electrónico del candidato. HackerRank enviará el correo electrónico de invitación.

PRIMER NOMBRE

Varchar

Nombre del candidato.

ÚLTIMO NOMBRE

Varchar

Apellido del candidato.

Alojamiento de RRHH

Varchar

(Opcional) Este campo representa un alojamiento de tiempo que es específico del candidato. El campo espera un valor en porcentaje. El tiempo porcentual se agregará a la prueba para crear una prueba de tiempo específica para el candidato. Por ejemplo, si la prueba es de 1 hora, puede enviar 50 para hacer la prueba 1 hora y 30 minutos.

Campos de requisición personalizados  

Nombre del campo

Formato

Nota

CORREO DEL RECLUTADOR

Varchar

Esta es la dirección de correo electrónico del usuario en BrassRing que está tomando la acción. Esto es importante para que el informe de HackerRank se envíe al reclutador correcto. Además, esto garantiza una auditoría correcta en HackerRank.

ID DE LA PRUEBA DE HACKERRANK

Varchar

Este es el ID de la prueba que debe enviarse al candidato. Por ejemplo, el ID de la prueba para la siguiente URL de prueba es 454785: https://www.hackerrank.com/work/tests/454785/questions

Enviar vista previa del payload XML de exportación de candidatos a HackerRank

Una vez que la configuración de Workbench esté completa, genere el XML de muestra y envíelo a HackerRank para su validación.

Configurar la importación del formulario

Configurar el payload XML de exportación de candidatos

Este es el formato para el Formato de importación de XML que se envía desde HackerRank tal como está. Deberá configurar Workbench para crear un XML coincidente:

<?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="Resultados de HackerRank" formId="" action="UpdateIndividual" resumeKey="" FirstName="" LastName="" email="" homePhone="" language="ES" autoreq="" optionalreq="">
<FormInput name="(generated by BR)" title="Nombre de la evaluación">
</FormInput>
<FormInput name="(generated by BR)" title="Nombre">
</FormInput>
<FormInput name="(generated by BR)" title="Apellido">
</FormInput>
<FormInput name="(generated by BR)" title="Porcentaje">
</FormInput>
<FormInput name="(generated by BR)" title="ID de requisición">
</FormInput>
<FormInput name="(generated by BR)" title="Fecha de evaluación">
</FormInput>
<FormInput name="(generated by BR)" title="Enlace a la página de resumen de la evaluación">
</FormInput>
<FormInput name="(generated by BR)" title="Puntuación general">
</FormInput>
<FormInput name="(generated by BR)" title="Código/ID de la evaluación">
</FormInput>
<FormInput name="(generated by BR)" title="Estado del candidato">
</FormInput>
</form>]]</Payload>
  </Packet>
</Envelope>

Campos de formulario personalizados 

Este es el estado de los resultados del candidato. Coincide con el estado que se muestra en HackerRank.  

Nombre del campo

Nota

Nombre de la evaluación

Este es el correo electrónico del candidato. HackerRank enviará el correo electrónico de invitación.

Nombre

Nombre del candidato.

Apellido

Apellido del candidato.

Porcentaje

Este es el porcentaje de puntuación del candidato

ID de requisición

Este es el número de requisición. Coincidirá con el BRREQNUMBER de la exportación de candidatos.

Fecha de la evaluación

Esta es la fecha de la evaluación

Enlace al resumen de la evaluación

Este es un enlace de regreso a los resultados de la prueba en HackerRank

Puntuación general

Esta es la puntuación en puntos.

Código/ID de la evaluación

Esta es la prueba que se realizó.

Estado del candidato

Enviar vista previa del payload XML de importación de formulario a HackerRank

Los siguientes campos son generados por BrassRing y serán específicos del entorno: 

  • campo formTypeID

  • campo formName

  • campo de nombre de cada FormInput

Una vez que se crea la carga útil XML, debe enviar un XML de vista previa a HackerRank para que los identificadores correctos puedan ser enviados desde HackerRank para Trabajo.