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.
Campos del perfil que HiBob puede rellenar
Sección titulada «Campos del perfil que HiBob puede rellenar»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 | 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.
Manager
Sección titulada «Manager»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.
Zona horaria
Sección titulada «Zona horaria»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.
Cómo funciona la sincronización
Sección titulada «Cómo funciona la sincronización»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.
Solución de problemas
Sección titulada «Solución de problemas»| 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. |
Relacionado
Sección titulada «Relacionado»- Tokens para cada token, su texto de respaldo y su formato.
- HiBob para conectar Bob y conceder los permisos que Pyn necesita.
- Campos del HRIS para comparar HiBob con las otras fuentes.
- Propiedades del empleado para todos los campos de Pyn.
- Corrige un manager, una zona horaria o un correo que faltan para poner bien un valor.