To integrate Workforce.com and etrainu please contact the etrainu Customer Success team and they will assist.
The diagram below provides a high level overview of the data that is shared between the two platforms and the mechanism by which the data is passed.
Workforce.com Platform Access for etrainu
In order for the etrainu LMS to retrieve and pass data to the Workforce.com platform, etrainu requires an Admin account to be created within Workforce.com to enable access to Workforce.com’s APIs. Etrainu will use this account during the onboarding process and to establish necessary access to Workforce.com’s APIs for your Workforce.com account.
Please note that this admin account provides etrainu access to all data within your Workforce.com account which is necessary for the integration between the two systems to operate as designed. Following the onboarding process, the etrainu LMS securely stores the credentials to facilitate the ongoing integration processes.
To create this account, please follow these steps:
Navigate to the Workforce drop down menu in Workforce.com and your Staff listing.
To add a new admin profile manually, click +Add staff (top right) then select Add manually (Create new profile). At minimum, you will need to enter a name and email to invite the user to Workforce.com. We recommend setting up a user called 'etrainu Account', using the email - email@example.com
Once you have created this profile, give the Admin permission (remove the employee permission so you are not charged for this user), hit the blue Invite to Workforce.com button, and your partner will be able to login to complete integration.
The organization hierarchy that is setup within Workforce.com is mirrored in the etrainu LMS by the etrainu Customer Success team during the LMS onboarding process. Locations and Teams within Workforce.com are mapped into the organization hierarchy in the etrainu LMS so that learner profiles for staff are related to the appropriate Departments and Sub-organizations within the etrainu LMS (i.e. Locations in Workforce.com map to Departments in the LMS and Teams in Workforce.com map to Sub-organizations in the LMS).
The etrainu Customer Success team will use the Admin account provided to determine the Locations and Teams (and associated Workforce.com platform IDs) within the Workforce.com platform and will establish the appropriate organization structure within the LMS as part of the LMS onboarding process.
Please note that changes to Locations and Teams (e.g. new Teams or Locations) within Workforce.com are not replicated automatically to the etrainu LMS following the onboarding process. Corresponding changes must be made by the etrainu Customer Success team manually. If these changes are not made within the etrainu, the nightly learner profile synchronization process (see further details below) may fail until this occurs.
Workforce.com Qualifications & LMS Courses
Qualifications in Workforce.com that map to etrainu LMS courses must be established in Workforce.com as part of the LMS onboarding process (if they haven’t already been created). Etrainu will use the Admin account provided to assist with setup of these Qualifications and complete the necessary course mapping configuration within the LMS.
Once this setup has been completed and learners have been onboarded, course completions within the etrainu LMS will create appropriate qualifications and associate these to the staff profiles within Workforce.com.
Once the necessary organization hierarchy and course setup has been completed within the etrainu LMS, learners can be onboarded into the LMS automatically via the etrainu/Workforce.com integration as a final step in the onboarding process. When learners are created within the LMS, the LMS will send a welcome email to the learner which includes the learner’s LMS username and password as well as a link to the LMS.
Learner information is kept in sync between the systems using a nightly synchronization process. This process synchronizes the following learner profile information from Workforce.com to the etrainu LMS:
organization relationships (Location and Team changes are mirrored into the LMS)
When new staff profiles are created within Workforce.com, these will be synchronized to the etrainu LMS as part of the nightly synchronization process also and they will receive welcome emails at this time. The welcome emails will contain the learner’s LMS username and password and a link that takes them to the etrainu LMS.
For a profile to be synced from Workforce.com to etrainu, they will require the 'Employee' permission level in Workforce.com.
Learner profile changes are not possible via the etrainu LMS and must be made within Workforce.com as this is the source of truth for learner profile information.
Learners are automatically archived from the etrainu LMS when the ‘active’ field is set to ‘false’ within the Workforce.com platform. The learner’s course history is still visible to LMS administrators but learners will no longer be able to access the LMS.
LMS administrator accounts are created manually by the etrainu Customer Success team and account credentials are passed to administrators via email by the etrainu Customer Success team. The Workforce.com and etrainu integration does not create these accounts in the LMS automatically.