Integration Overview
Ethena’s Workday integration allows organizations to manage their Ethena enrollment automatically as well as keep learners’ individual profile information up to date. Ethena will automatically add new team members into Ethena as well as update key information such as location or managerial status, so that if additional training is needed, Ethena can automatically assign it without any input from an administrator.
To populate their user feed into Ethena via Workday, Ethena customers create a custom report (RaaS) in Workday that includes the required fields, outlined below. They'll then create an Integration Service User for Ethena that can access the report. On a twice-daily basis, our integration will pull the data from that report and adjust user records in Ethena accordingly.
By default, the Ethena<>Workday integration is a one-way sync (pushing your user list to Ethena). If you're interested in a bidirectional Workday sync, to push completion records from Ethena back to Workday, please reach out to your CSM for more information.
Setup Instructions
Ethena’s technical team will work directly with the Workday team in your organization to make the integration process as seamless as possible. Please follow the below instructions to initiate your Workday integration.
- Create an Integration System User within Workday. The Integration System User will be used to access Custom Reports.
- Create a Security Group with the necessary permissions to access the report, such as ‘Integration System Security Group (Unconstrained).’ Add the Integration System User to the group.
- Add domain security policies to the Security Group you created. Be sure to provide ‘Get’/'View' access for any necessary data types.
- Create a Custom Report using data source ‘All Active Workers’ (includes non-employee worker types) or ‘All Active Employees.’ Ethena will note when workers disappear or appear in the report and enable and disable them accordingly.
- Add the following fields to the report. Fields marked with an asterisk are required.
-
- employee ID*
- email*
- name*
- country* - Three letter ISO country code
- state* - Two letter US state abbreviation. If not in the US, leave blank.
- isManager* - Indicates whether this worker is a supervisor
- workerType* - Full time, contractor, etc
- department*
- manager_worker_id* - Worker ID of the learner’s supervisor
- leave_start - Optional field for handling leaves of absence. See FAQs for details on this field.
- custom_reporting_field - Optionally include one additional reporting field to enhance your Ethena analytics experience, such as function, e-staff name, or supervisory org.
- Note: Ethena customers with the Advanced Analytics add-on can include unlimited custom reporting fields.
- Add Integration System User as an authorized user on the report.
- Share the following information via email with support@goethena.com:
- If basic authorization is preferred:
- Username
- Password
- JSON Report URL
- If OAuth is preferred:
- Client ID
- Client Secret
- Token URL
- JSON Report URL
- Refresh Token
- If basic authorization is preferred:
Once the URL and credentials are provided, expect a one-week turnaround time for Ethena to ingest the fields provided and set the integration live.
Domain Security Policy Permissions
Here is a sample list of permissions you may need to include for this integration. All permissions should be Get Only and View Only. The specific permissions will vary depending on the fields you choose to include.
Domain Security Policy | Functional Area |
Worker Data: General Staffing Information | Staffing |
Worker Data: Organizations | Staffing |
Worker Data: Leaves of Absence | Time Off and Leave |
Worker Data: Current Staffing Information | Staffing |
Worker Data: Organization Information | Staffing |
Worker Data: Current Management Level Information | Staffing |
Worker Data: Active Employees | Staffing |
Worker Data: Workers | Staffing |
Worker Data: Active and Terminated Workers | Staffing |
Worker Data: All Positions | Staffing |
Person Data: Work Contact Information | Contact Information |
Person Data: Work Address | Contact Information |
Person Data: Work Email | Contact Information |
Indexed Data Source: Workers | Staffing |
Integration FAQs
How do you enroll learners in Ethena courses?
If all learners at your organization included in the RaaS should be enrolled in an Ethena course, you can easily select all learners in Ethena. For courses like Harassment Prevention, Ethena will use the location information provided to automatically assign each learner the training that they need based on regulations. If only a subset of learners should be enrolled in some courses, you can manage enrollment based on manager status, department, location, and employee type directly in Ethena. If needed, you can also manage enrollments manually per user or via CSV.
At what frequency will the Workday report update for Ethena?
Ethena pulls this report one to two times per day to ensure that our records are up to date. The sync time varies each day.
How do you handle terminations?
Ethena assumes that everyone included in the report is an active worker, and that anyone not in the report should be deactivated, so would expect terminated team members to be excluded from the report. When a worker who previously appeared in the report no longer shows up, Ethena marks them as “disabled” in our platform, which is functionally equivalent to “terminated” but used out of caution because the process is automated.
Note: If you already have users loaded into Ethena before setting up your Workday integration, you may need to do some initial cleanup of users who were terminated prior to the Workday integration being initiated.
How do you handle leave of absence?
Ethena provides an optional advanced field to handle leaves of absence. Please provide an additional date field labeled “leaveStart''. This field should be filled when a leave is known and in the future, remain filled throughout the extent of the worker’s leave, and then nulled-out when the worker is back from leave. This prevents any confusion around adjustment of leave dates and makes for a smooth process but does require some more advanced Workday logic. This field is optional, and prevents workers from getting notifications from Ethena while on leave, and schedules training for when the worker returns. Feel free to reach out with any questions on this field.
Some customers who are extra vigilant around employee leaves choose to unenroll on-leave folks from their trainings entirely. If you choose to go this route, we recommend passing an “on_leave” boolean in addition to, or instead of, “leaveStart”.
What happens to a learner record if a contractor converts to full-time, or changes their email or name?
As long as the worker ID stays the same, we can ensure that the learner record remains consistent with the learner. If the worker ID updates, our team will need to discuss other options with you.
What types of reporting fields should we include and why?
Ethena provides additional reporting capabilities through embedded Looker reports. By including additional fields to slice and dice the data such as Function, Supervisor Name, E-Staff or C-Suite Name, another level of department reporting, Supervisory Org and so on, teams are able to get the most out of Ethena’s platform.
Comments
0 comments
Please sign in to leave a comment.