SFTP - Instrucciones para cargas de datos de RRHH
ÍNDICE
Descripción general
Para información y pautas generales sobre SFTP, consulte SFTP - Instrucciones de configuración.
Todos los usuarios de Spotnana (viajeros, asistentes, aprobadores, etc.) deben tener un perfil creado en la herramienta de reservas en línea de Spotnana (OBT) antes de poder gestionar sus viajes. Para garantizar que cada usuario tenga el acceso correcto (por ejemplo, dar acceso a nuevos empleados o retirarlo a quienes dejan la empresa), es importante mantener actualizados estos perfiles (creando, actualizando o eliminando registros según corresponda). Además, Spotnana utiliza datos de RRHH, como la jerarquía de reportes y las entidades legales, para definir políticas, aprobaciones y otras configuraciones relacionadas con viajes y pagos.
Para asegurarnos de contar siempre con la información correcta, debe cargar su archivo de RRHH en formato CSV en el servidor de Spotnana. Puede programar estas cargas con la frecuencia que desee. Spotnana procesará el archivo tan pronto como lo recibamos.
Nota: Spotnana también ofrece conexiones directas con varios sistemas de RRHH comunes (Bamboo HR, ADP Workforce Now y Workday).
Arquitectura y flujo de trabajo
Este diagrama muestra un escenario donde varios clientes cargan sus datos de RRHH a Spotnana utilizando SFTP.
Instrucciones
En esta sección encontrará información útil para que sus cargas de archivo se realicen correctamente.
Lógica de procesamiento de archivos de RRHH
El campo principal que se utiliza para identificar a cada usuario es el ID de empleado.
Nota: En ciertos casos, Spotnana puede utilizar el Correo electrónico corporativo como identificador del empleado. Sin embargo, esto tiene algunas limitaciones. Por ejemplo, si el correo electrónico del usuario cambia (por cambio de nombre, de dominio, traslado, etc.), nuestro sistema desactivará la cuenta original y creará una nueva para ese empleado.
La lógica que se sigue para procesar el contenido de su archivo CSV es la siguiente:
Si la columna ACTION para la fila del usuario está configurada como CREATE y el ID de empleado o Correo electrónico corporativo no existen en la base de datos de Spotnana, se creará un perfil nuevo para ese usuario en Spotnana.
Si la columna ACTION para la fila del usuario está configurada como UPDATE y el ID de empleado o Correo electrónico corporativo coinciden con un valor existente en la base de datos de Spotnana, el perfil de ese usuario se actualizará con la nueva información proporcionada en su archivo.
Nota: Si un usuario tenía campos opcionales en su perfil de una carga anterior y esos campos ya no aparecen en una actualización posterior, dichos valores se eliminarán del perfil.
Si la columna ACTION para la fila del usuario está configurada como DELETE y el ID de empleado o Correo electrónico corporativo coinciden con un valor existente en la base de datos de Spotnana, el perfil será desactivado. Si no se encuentra ningún registro que coincida con el ID de empleado o Correo electrónico corporativo, se omitirá esa fila y no se realizará ninguna acción.
Nota: Cada perfil de usuario que se cree debe estar asociado a una entidad legal. Estas entidades legales deben existir previamente en Spotnana antes de intentar cargar los perfiles de usuario. Las oficinas son opcionales, pero si en su archivo CSV de usuarios se hace referencia a una oficina, esa oficina debe existir previamente en Spotnana.
Formato de archivo y convenciones de nombres
El nombre del archivo .CSV de RRHH debe seguir este formato:
hr_feed.*.csv
donde el * (comodín) puede ser cualquier conjunto de caracteres que desee agregar al nombre. Es importante que el punto después de “feed” y el punto antes de “csv” estén presentes. El nombre del archivo no distingue entre mayúsculas y minúsculas. Recomendamos incluir la fecha y hora en el nombre del archivo para facilitar la resolución de problemas en el futuro. Por ejemplo:
hr_feed.spotnana_integration_<DateTime>.csv
El archivo .CSV de RRHH también debe seguir un formato específico. Los nombres de las columnas deben coincidir exactamente con el formato definido (consulte la sección Formato del archivo de RRHH a continuación). Puede encontrar más detalles sobre el formato del archivo en el Apéndice 1.
Es necesario cumplir con ciertas validaciones de datos (consulte la sección Formato del archivo de RRHH a continuación para más detalles).
Frecuencia y programación
Para información general sobre frecuencia y programación, consulte la sección Frecuencia y programación de SFTP - Instrucciones de configuración.
Le recomendamos cargar un archivo al menos una vez al día para asegurarse de que Spotnana reciba cualquier alta, actualización o baja que se haya producido. Si sigue esta práctica:
los nuevos empleados tendrán su perfil en Spotnana el mismo día que comiencen a trabajar y podrán reservar viajes de inmediato. Esto supone que incluya los nombres de los empleados en el archivo que cargue en su fecha de inicio.
los empleados que dejan la empresa tendrán su acceso revocado en su último día. Esto supone que retire los nombres de los empleados del archivo que cargue en su fecha de salida.
Formato del archivo de RRHH
Utilice esta información para asegurarse de que los datos en su archivo de RRHH estén correctamente preparados y formateados antes de cargarlos.
Nota: Debe asegurarse de haber enviado a Spotnana su clave pública SSH y que tengamos configurada una carpeta SFTP para usted antes de que podamos procesar cualquiera de sus archivos.
¿Le ha sido útil este artículo?
¡Qué bien!
Gracias por sus comentarios
¡Sentimos mucho no haber sido de ayuda!
Gracias por sus comentarios
Sus comentarios se han enviado
Agradecemos su esfuerzo e intentaremos corregir el artículo