Ir al contenido
PynPyn

Mapeo de campos de HiBob

Un token en un mensaje, como principal.preferredName o principal.managerName, lee un campo del perfil del empleado en Pyn. Cuando HiBob está conectado, Pyn puede rellenar esos campos del perfil desde Bob. Que un campo tenga valor depende de lo que contiene tu tenant de Bob, de lo que puede ver la cuenta de Bob conectada y de qué otras fuentes están conectadas. Usa las tablas para rastrear un token hasta el campo de Bob que hay que rellenar, o corregir, en Bob.

Los tokens y los campos de Bob detrás de ellos

Sección titulada «Los tokens y los campos de Bob detrás de ellos»

Selecciona Insert token en la barra de herramientas del editor, o escribe @, y la lista muestra cada token por su nombre bajo principal (el empleado inscrito) y recipient (la persona que recibe el mensaje). Cada fila es un token que Pyn puede rellenar desde Bob, no uno que siempre tenga valor: cuando el campo del perfil está vacío, el token muestra su texto de respaldo. Cada token principal de abajo con un gemelo recipient en la lista lee el mismo campo para el destinatario.

Token Campo del perfil que lee Id del campo en Bob
principal.preferredName (aparece como Preferred Name) Preferred Name; si no, la primera palabra de Display Name root.displayName
principal.firstName La primera palabra de Display Name root.displayName
principal.preferredFullName Preferred Name y apellido; si no, Display Name root.displayName
principal.legalName Legal Name root.fullName
principal.jobTitle Job Title work.title
principal.department Department work.department
principal.location Location work.site; si no, address.city
principal.startDate, principal.startDate.dayAfter, principal.startDate.nextBusinessDay, principal.nextAnniversary Start Date work.startDate
principal.tenure Tenure Date; si no, Start Date work.originalStartDate; si no, work.startDate
principal.birthday, principal.nextBirthday Birthday personal.shortBirthDate
principal.managerName, principal.managerPreferredName, principal.managerEmail El Display Name y el Primary Email Address del Manager work.reportsTo elige al manager; sus propios root.displayName y root.email rellenan los valores
principal.hrbp.name, principal.hrbp.preferredName, principal.hrbp.preferredFullName, principal.hrbp.email El nombre y el correo del HRBP employee.hrbp elige al HRBP; sus propios root.displayName y root.email rellenan los valores
principal.buddy.name, principal.buddy.preferredName, principal.buddy.preferredFullName, principal.buddy.email, principal.buddy.startDate.nextBusinessDay El nombre, el correo y la fecha de inicio del Buddy Tu campo personalizado de buddy elige al buddy; sus propios root.displayName, root.email y work.startDate rellenan los valores

Bob no tiene un campo de nombre preferido que Pyn lea, así que los tokens de nombre preferido muestran la primera palabra del Display name de Bob, salvo que otra fuente aporte un nombre preferido.

Estos tokens de la lista no tienen fuente en HiBob: date.reference, que es la fecha de referencia del enrollment, y recipient.surveyLink.

Para cualquier otro campo del perfil, como Probation End Date o un campo personalizado de Bob que el soporte de Pyn haya mapeado, selecciona Insert token, después Employee Field…, y elige el campo. En un correo Raw HTML, principal.email lee root.email, principal.personalEmail lee home.privateEmail, principal.endDate lee internal.terminationDate y principal.country lee address.country. Consulta Tokens para todos los tokens y sus textos de respaldo.

La primera columna es la etiqueta del campo en el perfil del empleado en Pyn. Cada fila es un campo que Pyn puede rellenar desde Bob, no uno que tenga todo perfil: un campo queda vacío cuando Bob no tiene valor o la cuenta conectada no puede verlo, y otra fuente puede aportarlo en su lugar. El id del campo en Bob es el nombre que la API de Bob usa para el campo.

Campo en Pyn Campo en Bob Id del campo en Bob Notas
Display Name Display name root.displayName Recurre a Full name, y después a First name y Last name.
Legal Name Full name root.fullName Recurre a First name y Last name (root.firstName, root.surname).
Primary Email Address Email root.email La dirección de trabajo a la que van los mensajes. Se usa también para emparejar registros.
Personal Email Address Personal email home.privateEmail Se usa para emparejar a una persona antes de su incorporación que no tiene dirección de trabajo.
Job Title Job title work.title
Department Department work.department El valor tal como lo muestra Bob, no el id de su lista.
Location Site work.site Recurre a la ciudad de la dirección (address.city).
Primary Country Country address.country De la dirección.
Postal Code Postal code address.postalCode De la dirección.
Time Zone Ninguno Se deduce del país y el código postal; ver abajo.
Birthday Date of birth personal.shortBirthDate Solo día y mes.
Start Date Start date work.startDate
Tenure Date Original start date; si no, Start date work.originalStartDate, work.startDate Cuenta desde la fecha de inicio original de Bob cuando la tiene; si no, es igual que Start Date.
Termination Date Termination date internal.terminationDate
Probation End Date Probation end date internal.probationEndDate
Original Start Date in HiBob Original start date work.originalStartDate Una propiedad solo de HiBob. Alimenta Tenure Date.
Active status Lifecycle status, después Status internal.lifecycleStatus, internal.status Un lifecycle status que contiene “leave” es On Leave. Si no, un Status de Active, o ninguno, es Active, y cualquier otro es Inactive.
Manager Reports to work.reportsTo Emparejado con el registro de Bob del manager. Consulta Manager más abajo.
HRBP HRBP employee.hrbp Emparejado con el registro de Bob del HRBP.
Buddy Tu campo de buddy Un campo personalizado Bob no tiene un campo estándar de buddy. El soporte de Pyn define qué campo personalizado lo contiene.
Campos personalizados El campo que elijas Cualquier id de campo Se leen como texto, sí/no, fecha o número. El soporte de Pyn mapea cada uno por ti.

Pyn no lee esto desde Bob: Preferred Name, Avatar Image, Secondary Email Address, Employment Type, Business Unit, Division, Team y Mentor. Los campos de tipo de empleo y de contrato de Bob no se mapean a Employment Type; el soporte de Pyn puede mapear cualquiera de los dos como campo personalizado. Cualquier otro campo personalizado de Bob, como un campo “Manager ID”, se ignora salvo que esté mapeado.

Pyn toma el id que hay dentro de Reports to y busca al empleado de Bob con ese id. Cuando Bob no devuelve ningún id, Pyn usa el Employee ID del manager en Bob (work.reportsToIdInCompany) y lo empareja con la persona que tiene ese Employee ID (work.employeeIdInCompany) en la misma empresa de Bob. El manager también tiene que estar en la sincronización, así que la cuenta de Bob conectada necesita acceso de lectura a su registro.

Pyn no lee ninguna zona horaria desde Bob. La deduce a partir de Primary Country y Postal Code: el código postal para Estados Unidos, Canadá y Australia, y el país por sí solo cuando tiene una única zona horaria. Para otros países con más de una zona horaria, Pyn usa la zona horaria de Slack de la persona cuando la tiene; si no, Time Zone queda vacío, y un paso programado en la zona horaria del destinatario se envía en la zona horaria del workspace.

Un cambio en Bob llega a Pyn, y a los tokens del siguiente mensaje que se envíe, en aproximadamente una hora. Una ejecución en la que nada cambió en Bob se registra bajo History como “Successfully integrated to HiBob. No employee changes found”. Pyn solo lee de Bob y nunca escribe en él.

Los empleados salientes permanecen en la sincronización, para que lleguen sus fechas de baja. Una persona que desaparece de los resultados de Bob se marca como Removed y pasa a Terminated.

Qué ves Qué comprobar
Un token muestra su texto de respaldo, como “Manager” o “department” El campo del perfil que hay detrás está vacío. Abre a la persona en Employees y comprueba el campo, y después las filas de abajo. Otras fuentes conectadas también pueden rellenar algunos campos; la pestaña Sources del perfil enumera cada registro detrás de una persona.
Un campo está relleno en Bob pero vacío en Pyn Abre la integración de HiBob bajo Installed y selecciona Advanced. Fields in Report enumera lo que Bob devolvió y para cuántas personas. Si falta un campo, el grupo de permisos del usuario de servicio, o tu propia cuenta si iniciaste sesión con Connect with HiBob, no puede verlo. Bob omite ese campo sin dar error.
Manager está vacío Reports to está vacío en Bob, el grupo de permisos no puede verlo, o el manager no es visible para el usuario de servicio. Un campo personalizado con un id de manager no se lee.
Location muestra una ciudad La persona no tiene Site en Bob, así que Pyn usó la ciudad de la dirección.
Falta un campo personalizado de Bob Los campos personalizados se leen solo cuando el soporte de Pyn los mapea.
Un cambio en Bob no ha llegado Espera a la siguiente actualización horaria y revisa History en la integración.