Add learning management systems for Microsoft Viva Learning
Article
Viva Learning works with a growing set of learning management systems. This set can change at any time as more providers join or change their status with the program.
Learning management systems aren't enabled by default. To enable these sources, add them to the Viva Learning Admin tab and follow the specific instructions shown in the following table.
Available learning management systems are subject to change. Depending on your organization, you may have access to different learning management systems than are listed here.
Dataflow architecture
The dataflow diagram illustrates how Viva Learning uses the LMS connector to ingest the learning content catalog and learner records (assignments and completion status). The learning management system (LMS) is the ultimate source of content and learner records for their customers. Viva Learning extracts the content and learner records from the LMS by the LMS Connector as depicted in the following diagram.
LMS Viva Learning requires two types of data from every LMS.
Content catalog: Fields that are extracted as part of the Content Catalog package or API from the LMS. View the table
Assignment and completion records (learner records sync): Fields that are extracted as part of the Assignment & Completion package or API from the LMS. View the assignment table. View the completion table.
LMS Connector The LMS Connector pulls content from the LMS using both API and SFTP mechanisms. The first time you sync, the LMS extractor pulls the full data. Afterward, a scheduler triggers once every 24 hours to refresh the data and pull any changes. Then the extract is validated and processed. If you encounter any error in processing, the error code displays on the admin portal. User records received from the extract are mapped with Microsoft Entra ID records to ensure the correct assignment and completion status for every user. Once all the records are processed, the data is synchronized to Viva Learning and displayed in Viva Learning.
Viva Learning Content details (content provider logo, thumbnail, title, description, etc.) display on the Home and Learning tabs in Viva Learning. The My learning tab shows the user's assigned and completed courses, which are fetched from the LMS.
Content catalog
These are the data extracted from the LMS as part of the Content Catalog package.
Metadata field name
Field details
Priority
Content provider (LMS) name
LMS's name. Can be provided separately and appended.
Required
Content provider (LMS) logo URL
URL to the LMS's logo for display purposes.
Required
Title of learning content
Title of learning content
Required
Content module's thumbnail URL
URL to the learning content thumbnail image for display purposes
Required
Content module's URL (deep link to consume content)
URL to learning content. This is the link that the user selects to consume content.
Required
Content module description/summary
Description or summary of learning content
Required
Content language/locale
Language in which content is available. Metadata should be provided in all available languages.
Required
Content module duration
Time duration of learning content
Required
Last modified date of content module/content creation date
Date the learning content was last modified
Required
Content format
Content format, such as article or video
Required
Assigned user role
Roles or groups that have permissions to the content
Required for role-based access
Content source name
Name of the course content provider
Recommended
Content source logo URL
Logo of the course content provider
Recommended
Content ID
Unique identifier for learning content
Recommended
Content module author/creator/contributor
Author/creator/contributor of learning content
Recommended
Content module length/size
Size of content, not based on time. For example, it could be the number of pages.
Recommended
Tags and keywords
Keywords, topics, and other tags associated with the learning content
Recommended
Difficulty level
Difficulty level of the course (such as beginner, intermediate, or advanced)
Recommended
Content module thumbnail alt text
Alternative text to support accessible design for images. Text describes images read by screen readers for users with assistive technology.
Recommended
Popularity score
Rating or popularity score for learning content
Recommended
Skills associated
Skills tags associated with the learning content
Recommended
Assignment records
These are the data extracted from the LMS for assignment records.
Metadata field name
Field details
Priority
Tenant ID
Tenant ID
Required
Configuration ID
LMS configuration ID. This is the equivalent to the learning source ID of the LAS
Required
ID
Object unique key (configid+externalAssignmentId)
Required
Learning object ID
Unique identifier for the assigned learning object
Required
Learner ID
ID of the learner/user to whom the learning object was assigned
Required
External assignment ID
Unique assignment ID on each LMS side
Required
Assignment due date
Date the assigned course is due for completion
Required
Assignment completion status
Current completion status of the assigned learning object. This can be Not started, In progress, or Completed.
Required
Assignment date
Date the learning object was assigned
Required
Assigner ID
ID of the user who assigned the learning object
Recommended
Assignment completion date
Date the assignee completed the learning object
Recommended
Assignment title
Title that an assigner can maintain
Recommended
Notes
Notes or comments on the assignment
Recommended
Completion status
The following table outlines the data extracted from the LMS for completion status.
Metadata field name
Field details
Priority
Tenant ID
Tenant ID
Required
Configuration ID
LMS configuration ID. The equivalent to the learning source ID of the LAS
Required
ID
Object unique key (configid+externalAssignmentId)
Required
User ID
Unique identifier for the user or employee
Required
Learning object ID
Unique identifier for the assigned learning object
Required
Completion status of learning object
The current completion status of the learning object. This can be either In progress or Completed.
Required
Date of completion
Date the user completed the learning object
Recommended
Start date
Date the user started the learning object
Recommended
Course completion ID
Unique identifier for the course completion record
Recommended
Current time
How far the user has progressed in the course (time)
Recommended
Current page number
How far the user has progressed in the course (page number)
Find out about Viva Learning by learning what it is, what users can do with it, and where to find its terms and policies. Additionally, learn when to use Viva Learning and where the data is stored.