Platform access level: Org Admins
Writing completions back to SuccessFactors records each learner's Arist course on their SuccessFactors learning history, so their record stays complete in one place. This flow runs outbound, after learners finish training in Arist, over the same direct OData v4 connection used for the people sync. This guide is written for the IT and SuccessFactors administrators who set the writeback up.
1. Completion writeback overview
Learning created in Arist is written back into SuccessFactors in two stages, first the course record and then each learner's completion against it, so the activity is captured on the employee's profile. The course is published to your Learning catalog first, and completions post against it afterward.
Note: Reading your employee data from SuccessFactors into Arist is a separate inbound flow, covered under Related articles.
2. Publishing courses to the Open Content Network
When a course is first built in Arist, it is sent to your Learning instance as Open Content Network (OCN) content for an administrator to import into the catalog. This import is what gives completions something to tie back to.
Important: OCN will not accept a completion for a course that has not been imported. Import the course before its learners begin, so their completions have a catalog record to attach to.
The exact OCN course-import endpoint is set in your connector at onboarding.
3. Recording completions on the learner's history
As learners finish a course in Arist, each completion is posted to SuccessFactors as an OCN learning event and lands on the user's learning history, closing the loop against the course imported in the previous step.
Each completion carries the learner ID, the course or content reference, and the completion date, sent as completionDate and completionTimeZoneID.
4. Endpoints Arist writes to
The writeback uses one course-publishing channel and one completion endpoint. Share this list with your security team, and apply any IP allow-listing your policy requires.
Stage | Channel or endpoint | Purpose |
Publish course | SAP Open Content Network (OCN) | Publishes the Arist course to your catalog for an admin to import |
Record completion |
| Posts each completion as an OCN learning event on the learner's history |
5. Write access your service account needs
The API service account Arist runs as must hold the permission to record learning events, for example Add Learning Events or Add History Record. This is what lets both the course record and the completions post to the learning history tables.
Important: Without write access scoped to the learning event service, course and completion records cannot post back to SuccessFactors. Scope the account to the Learning OData services this integration needs and nothing more, so it holds the least access required.
Related articles
HRIS Integration - SuccessFactors
Arist and SuccessFactors - Technical Guide
Note: Need help at any point? Reach out to your Arist Customer Success contact, or email [email protected].