Workday integration
What the Workday switch on a catalog course and its offerings actually does, how enrolments come back and why they only come when you ask, what matches a Workday learner to an ABS Elevate account, and what to check when courses stop arriving.
Some programs are run with a client organisation whose own people register for courses in Workday, their learning system, rather than in ABS Elevate. For those programs ABS Elevate can push a course and its offerings into Workday, and pull back the people who enrolled there.
This article is about the four controls you will actually meet, and about the things the integration does silently that you are nevertheless answerable for. It is not about how the connection works; that is your platform administrator's.
You will only see any of this on the cohorts it applies to
The Workday controls are not a school-wide setting you can switch on. They appear only on cohorts attached to the one client organisation the integration was built for — the attachment made by Customers on the cohort form; see Programs and cohorts.
On every other cohort the switch is simply not drawn, and neither is the button that fetches enrolments. If you are looking for them and cannot find them, look at the cohort's customers before you look at anything else.
Everything Workday-related is in English, in both languages, with no exceptions.
The shape of it
Three movements, and only one of them is automatic.
Courses and offerings go out, when you save them
Turning the switch on and saving sends the catalog course, and then each offering, to Workday. Nothing schedules this; it happens as part of the save.
People enrol in Workday
Out of sight of ABS Elevate. Their system, their screens, their rules.
Enrolments come back, when you ask for them
There is no notification from Workday when somebody enrols, and nothing polls it. A button on the catalog fetches them, and planning an offering fetches them first. Between those two acts, ABS Elevate does not know.
Afterwards there is a fourth movement that nobody presses a button for: attendance you record in a class travels back to Workday on its own. It has a section of its own at the end of this article, and it is the part most often not known about.
Putting a course into Workday
The switch lives on the catalog course form — the cohort's Catalog tab, then Add new course to the catalog or the pencil on an existing row. See Catalog and offerings for the rest of that form.
Turn on Enable Workday Integration
A switch with the Workday mark beside it, below the three switches that decide how the course appears to learners.
Choose the security categories
A multiple picker appears, labelled security category, with the placeholder "Select security categories...".
These are Workday's own categories, read live from Workday: they are how Workday decides which of its people may see and register for the course. ABS Elevate neither creates them nor interprets them — it passes on what you choose. Which ones to pick is a question for whoever administers Workday at the client, not a judgement to make from this screen.
Save
The course is created in Workday as part of the save, and the platform confirms: "The course has been added successfully to Workday".
Where Workday refuses, the message you get is Workday's own, prefixed "Workday course error:".
If the category picker never loads, stop there
The list of categories is read from Workday each time the form is opened. If it will not load, the connection to Workday is not working, and saving the course will not put it there either.
That is a platform-administrator problem rather than something to retry from the form. Note the time and tell them, because the same outage is what will be behind enrolments not arriving an hour later.
The Workday Status panel
Reopen a catalog course that is already in Workday and a panel headed Workday Status appears, with a sentence under it explaining whichever button is chosen:
- Active — "Course is available for enrollment in Workday."
- Inactive — "Course is not available for enrollment in Workday."
- Duplicate — "Creates a new course with identical values. The original course remains inactive."
Duplicate is offered only while the course is not currently active in Workday, so a course that is open for enrolment shows two buttons rather than three. If you are looking for it and there are only two, that is why: set the course Inactive and save, and it appears when you reopen the form.
Inactive is how you close a course to further enrolment on the Workday side without touching anything in ABS Elevate. Duplicate is the heavier one: it makes a second course in Workday with the same details and leaves the first one closed, which is what you want when a course has to be re-run from scratch rather than amended. Read the sentence under the buttons before you save — it is the only description of the setting anywhere.
Where the last attempt to synchronise failed, the panel is replaced by an amber warning — "This catalog course is not synchronized with with Workday." — and a single button, Retry Sync. Choosing it and saving tries again, and the panel says what it will do: "retry create catalog course in workday".
Putting an offering into Workday
The same switch, Enable Workday Integration, sits on the offering form. Turn it on, save, and the offering is created in Workday against its course: "The course offering has been added successfully to Workday".
An offering is what people actually enrol in, so this step is not optional. A course in Workday with no offering in Workday is a course nobody can register for, and nothing on the catalog screen will point that out.
Getting the enrolments back
Two things fetch them, and they fetch the same way.
Fetch Enrollments, at the top right of the cohort's catalog, is the deliberate one. It reads "Fetching..." while it works and then either "Enrollments fetched successfully" or "Failed to fetch enrollments".
Setting an offering's status to Planned is the incidental one: the planning dialog fetches first, showing "fetching workday students..." in orange and holding the Plan button disabled until it has finished. That is deliberate, and it is why the dialog sometimes takes a moment to become usable. Let it finish; the people it is fetching are the people you are about to enrol.
Only pending offerings are fetched
A fetch covers the offerings that are both in Workday and still Pending. An offering already Planned or Canceled is skipped, and so is one whose Workday switch was never turned on.
So enrolments that arrive in Workday after you have planned an offering do not reach ABS Elevate at all, by any route. If the client's people are still registering, leave the offering pending until they have stopped.
A learner is matched by email address, and an unmatched one vanishes silently
This is the single most useful fact in this article.
A Workday enrolment reaches ABS Elevate only if the person's Workday email address matches the Account Email of an existing ABS Elevate account, character for character, compared in lower case. Nothing else is looked at — not the name, not any identifier, not the cohort.
Everything that follows from that is unannounced:
- Somebody with no ABS Elevate account is skipped. The fetch still reports success.
- Somebody whose two addresses differ — a work address in one system and a personal one in the other, or an address recorded with capital letters — is skipped in exactly the same way.
- No count is shown, no list of what was skipped, and no warning anywhere.
The fetch reporting success means the exchange happened, not that everybody came across. So when a fetch brings back eleven of the fourteen people the client told you about, the three are not lost in transit: they do not have matching accounts. Create them under People with the address Workday holds — see People — and fetch again.
What a fetch does to the offering
An enrolment that Workday reports as enrolled is added to the offering's registrations, exactly as though the learner had chosen it themselves. It then appears in the planning dialog and can be given a place like anyone else.
A withdrawal is also honoured: where Workday reports somebody as withdrawn, dropped, not approved, cancelled or rescinded, the fetch takes them off the offering. Any other state Workday might report is ignored, and the person is left as they were.
So a fetch is not only an addition. Running one after the client has done some tidying will remove people from your offering, quietly and without a summary. Run it when you are about to plan, and read the list of names in the planning dialog rather than assuming it is the list you saw last week.
Enrolments made in ABS Elevate are not sent to Workday
Adding somebody to a Workday-linked offering from this side — by planning them into it, or by adding them to the class afterwards — puts them on your list and tells Workday nothing.
There is no button anywhere that pushes them the other way. That is a gap in the screens rather than in the platform: the push itself exists and your platform administrator can run it for a named offering, which adds the people Workday is missing. So ask them first.
If that is not available to you, the fallback is the slower one: somebody who has to be on the client's record as well as on yours has to be enrolled in Workday too, by whoever does that at the client.
Attendance goes back on its own
Once the offering is planned and the class is running, marking attendance on a lecture updates that learner's record in Workday. No screen mentions it, no confirmation is shown, and there is no button that starts or stops it.
It happens only for the people whose enrolment came from Workday in the first place. For anybody you added on this side there is nothing over there to update, so their attendance stays here — which means a class can have two kinds of learner on it whose marks go to two different places.
What travels is how much of the course the person attended, and — once the register is complete — a pass or a fail. The rules are worth knowing because they are not the ones you would guess:
- In a course of five or more lectures, once three quarters of them are marked Present for somebody, a pass is sent for them. It does not wait for the rest of the course.
- Otherwise, nothing is graded until every lecture of that course carries a status. One lecture left Unspecified is enough to leave the Workday record without a result, however complete everything else is.
- When the register is complete: all lectures Present is a pass; anything less is a fail.
- Where some lectures are still Unspecified and nobody has been marked present or late, nothing is sent at all.
- Late counts as three quarters of that lecture's time towards the time credited.
Read the second and the fifth of those together. The common shape of a half-marked register — a couple of absences recorded, the rest never touched — is the shape that sends nothing. See Classes and lectures for the attendance vocabulary and for the rule that attendance figures stay at "N/A" until a lecture is marked Completed.
Taking a learner off a course of the class marks them as failed in Workday
Removing somebody from a course inside one of these classes does not just remove them here. Where their enrolment came from Workday, it sets them over there as no longer attending, with a fail.
That is very often not what is meant. Somebody who transferred to another group, or who was put on the wrong course by mistake, will carry a failure on the client's record, and no screen in ABS Elevate says so or offers to take it back.
So before you remove anybody from one of these courses, be sure removal is what you mean rather than correction — and where it is a correction, say so to whoever keeps the record at the client, because the platform has already told them otherwise.
When the Workday courses stop arriving
Work down this list in order. It is arranged so that the cheapest checks, and the ones that are most often the answer, come first.
Are you on the right cohort?
If there is no Fetch Enrollments button at the top of the catalog, this cohort is not attached to the client organisation. Nothing else in this list applies.
Is the offering still Pending?
A fetch skips anything Planned or Canceled. The status is the button in the offering's row; see Catalog and offerings.
Is the offering in Workday at all?
The switch is per course and per offering. A course that went across with an offering created before the switch was turned on has nothing in Workday for anybody to enrol in.
Did the course synchronise?
Open the catalog course. If Workday Status shows the amber "This catalog course is not synchronized with with Workday.", the course never arrived. Use Retry Sync and save.
Is the course Active?
Inactive in the Workday Status panel means Workday is not accepting enrolments for it. Somebody may have set it deliberately.
Do the missing people have accounts, with the right address?
The email match, above. This is the answer more often than everything else on this list put together. Check the exact address on the account under People → Accounts against the address the client holds.
Did the fetch itself fail?
"Failed to fetch enrollments" means the connection to Workday did not work. So does a security-category picker that will not load. Both are for your platform administrator, with the time it happened.
If every one of those is clear and the people are still missing, the question left is whether they have actually enrolled on the Workday side — which is a question for the client, and one you can ask with some confidence once this list is exhausted.
Related pages
Catalog and offerings
The catalog course and offering forms the Workday controls sit on, and what planning an offering does.
Programs and cohorts
Customers on the cohort form, which is what makes the Workday controls appear.
People
Creating the accounts a Workday enrolment has to match.
Classes and lectures
The attendance that travels back, and what a class does and does not arrive with.
Settings
The five school-wide areas under Tools — academic periods and the one that is Active, grade levels, classrooms and their calendars, scoring grids, and gradebook templates with their computed columns.
Publish a new program
This page has not been written yet; it is listed here so the navigation is complete.
