Introduction
This article provides an overview and general instructions for the Updater managed solution, which is provided by the Zensai Global Delivery division.
Availability
The Updater managed solution is available only to Success Plus and Success Premium customers.
Prerequisites and access
- Success Plus or Success Premium subscription.
- Learn365 API key (Full Control permissions and created in the customer’s tenant).
Support and maintenance
- If you encounter issues when using this solution, contact your Customer Success Manager.
- If you want to provide feedback and ideas, contact your Customer Success Manager.
Overview
The Updater managed solution enables users to update multiple course properties for multiple courses all at once. You are able to schedule updates to happen in the future or update the courses immediately.
This guide will cover the following:
- Updater Authentication.
- Updater Settings.
- Bulk Update View.
- Creating a Bulk Update.
- Scheduling a Bulk Update.
- Selecting Courses to Update.
- Adding Update Operations.
- Demo Walkthrough
Accessing the Updater Service
To access the Updater solution, follow these steps:
1. Access the Automation Center page.
2. Select the Updater section in the left navigation menu.
IMPORTANT
GCCH customers will need to access a different login page.
Please access this page instead: GCCH Automation Center.
NOTE
When logging in for the first time, you may receive a message indicating your account has not been setup for access to your tenant's Automation Center. You will need to contact your organization's tenant administrator for access and permissions.
For more information on Automation Center Permissions, please see this article.
NOTE
When you first login, one of the following scenarios may occur:
- You login without needing to do anything.
REASON: This will occur if someone in your organization previously provided consent on behalf of the entire organization.
- You are asked to give consent on your own behalf.
REASON: This will occur if no one in your organization has provided consent on behalf of the entire organization.
- You are asked to give consent on behalf of your organization.
REASON: This may occur if you have an admin permission level assigned within your organization's Entra ID (Azure AD).
- Admin approval is required to login.
REASON: The Automation Center installs an app within your organization's Entra ID. Depending on your organization's policy, this could require the approval by IT staff (Global admins).
Updater Settings
- Email address. This will be used for notifications when updates have been successfully completed, or if there were errors pulling any reports. Note that any times referenced in notifications use UTC times.
- Learn365 API key. This will be populated from when you first logged in. The Updater uses this to access your Learn365 environment. For more information on generating a Learn365 API key in your tenant, please refer to this article.
Bulk Update View
Bulk Update (main screen)
On the Bulk Update page, you will see an overview of the previously completed or scheduled updates with the option to search for updates, create new updates, or delete old update history.
The following columns will be available on the Bulk Update page:
Name. Displays the name of the update. The name can be provided when creating a new update.
Status. Displays the current status of the update.
The status might be one of the following:
- Scheduled (when an update is scheduled to occur in the future)
- In Progress (when an update is actively running and updating)
- Completed (when an update has been completed)
- Failed (when an update has failed)
Start Date. Displays the date and time for when the update has started.
End Date. Displays the date and time for when the update has been completed.
Creation Date. Displays the date and time for when the update was created.
Modified Date. Displays the date and time for when the update was last modified or edited.
Creating a Bulk Update
To create an update, follow these steps:
- From the Bulk Update page, select Create new.
- Enter the basic details for your report:
-
- Enter a Name. This is a required field.
- Choose a schedule (if a scheduled update is desired)
- Choose a start date (if schedule is checked).
Scheduling a Bulk Update
A bulk update is scheduled through the Basic Details when creating an update. You can choose any date and time in the future that you would like the update process to start.
NOTE
Updates that are scheduled are checked automatically every 5 minutes. This means that your update can start up to 5 minutes after your scheduled update time.
Selecting Courses to Update
After defining the Basic details for the update, you then must select the courses you would like to update through the Courses to update tab.
- Select the course from Available courses.
- View all of your currently selected courses in the Selected Courses section.
You are able to search for courses by their name or course catalog name using the search bar. You are also able to filter the available courses via Title, Catalog, Tags, Categories, or Admins using the Select Filter button.
Adding Update Operations
Update operations are able to be selected once the Basic details and Courses to update sections have been completed.
To add an update operation, follow these steps:
- Select Add Update Operation.
- Select one of the fields that is available to be updated.
- Select an action.
- Provide a new value (this option may or may not be available based on the action that was selected).
A list of available actions are below:
- Add Before (Adds text before what currently exists)
- Add After (Adds text after what currently exists)
- Delete
- Delete All (Deletes all of the selected field from the course)
- Delete Selected (Deletes only the selected item from the course)
- Replace (Replaces text of what currently exists)
- Update (Updates an existing item with a new item)
Demo Walkthrough of the Updater solution
Watch the following video for a detailed walkthrough of the process for accessing and setting up the Updater managed solution.
Comments
Article is closed for comments.