Ideally Worklete will integrate with your company's HRIS system to insure that user information is up to date on the Worklete platform and to enable SSO integrations for a streamlined login process. In lieu of that, a standardized report with the details described below will suffice for us to establish and maintain an accurate active user roster.
We utilize this information to determine who will receive training, what kind of training they receive, and which location they are trained at.
The information below will provide insights for your HR team to build an automated report from your HRIS System to provide updated roster information to Worklete on a re-occurring basis.
File Format and Naming
The data should be in a CSV file with headers. The file name can be anything as long as it is unique and contains no special characters (except for underscore). We suggest naming it users_<time stamp>.csv and replacing the “<time stamp>” value with the current seconds since the epoch to ensure uniqueness.
Data Description
Note: Old data will be overwritten by new data.
Each File should:
- Contain no duplicate user_ids.
- Only contain active users, if a user is on leave or has left the company, please filter them out.
Data Field Definitions
These are the specific fields that our system uses. Feel free to include any additional fields you choose, they will be stored in their raw data format for use in further and more complex analysis.
If no data exists for an optional field, please leave it blank in that row.
|
Field |
Required? |
Description |
|
user_id |
yes |
The unique identifier for the user/employee. User IDs MUST be consistent across all of your Worklete integrations. If you are using SSO, this should be that ID |
|
first_name |
yes |
The user’s first name |
|
last_name |
yes |
The user’s last name |
|
location_id |
yes |
The location where the user should be trained at. Location IDs MUST be consistent across all of your Worklete integrations |
|
|
no |
The user's email address |
|
job_function |
no |
The job function for the user in the Worklete platform. This will help determine what content the user gets. |
|
job_title |
no |
A value representing the learner's job title should be used in the job title is free text and not deterministic of job function. Used in data analysis |
|
language |
no |
The ISO_639-1 (https://en.wikipedia.org/wiki/ISO_639-1 ) language code that this learner prefers. |
|
supervisor |
yes |
The user's direct supervisor |
Data Delivery
Data can be uploaded to AWS S3 via API access or an SFTP. It can be delivered as often as needed for updates. It will be processed once every 24 hours.
Authentication and Destination
Contact your Account Rep to set up your AWS key and receive an S3 destination for data.
Comments
0 comments
Please sign in to leave a comment.