university

vILT CONNECTOR Edge Integration Guide

1

TABLE OF CONTENTS

WELCOME TO 3PREREQUISITES 3PREPARATIONS 4EDGE SETUP 4GETTING STARTED 4CREATING INSTRUCTORS 6 UPDATING INSTRUCTORS 6CREATING & EDITING EVENTS/ SESSIONS 6LAUNCH A SESSION 7GET ATTENDANCE 7 AUTOMATED ROSTER UPDATE 7 MANUAL ROSTER UPDATE 7FREQUENTLY ASKED QUESTIONS 8

2

VERSION HISTORY

VERSION DATE AUTHOR DESCRIPTION

1.0 4/8/2019 Cornerstone Original version

3

WELCOME TOvILT CONNECTOR

Cornerstone's Virtual Instructor Led Training (vILT) Connector allows you to build your own integrations with any virtual meeting provider. This connector allows seamless integration with the Cornerstone Learning platform, connecting end users to virtual meeting sessions, capabilities to track attendance, and scheduling tools for instructors.

While we encourage all clients to be a part of the vILT Connector Early Adopter, it’s important to make sure the features meet your needs. Here are a few characteristics of an Early Adopter:

• Knowledge of how to integrate with public APIs

• Clients who only require:

• Session with a single part

• Use one account for their organization to manage virtual meeting training

• Create/Update Instructor, Create/Update Session, Get Attendance, Launch Session workflows to satisfy their organizational needs.

PREREQUISITES1. To configure this integration you must have Edge Marketplace - Manage and Edge Integrations -

Manage permissions.

2. To configure ILT Session and Events your user must have standard ILT Permissions.

3. To utilize this feature a client must have Cornerstone Learning, Cornerstone Edge and a virtual meeting provider.

4

1. Log in to your Cornerstone portal.

2. Navigate to the Edge Marketplace (Admin > Tools > Edge > Marketplace).

3. Search for vILT Connector then click on the vILT Connector tile.

4. Click on Create Integration.

5. Enter your virtual meeting provider information, then click Submit.

EDGE SETUPGETTING STARTED

PREPARATIONS1. Have your virtual meeting provider or 3rd party engineering/software development team review the

vILT Connector documentation within the API Explorer.

2. Virtual meeting provider or 3rd party engineering/software development team develops the integration based on the requirements provided in the Cornerstone documentations.

56. Click on Configure Now. You will then be directed to the Settings page. You can also navigate to

this page by going to Admin > Tools > Edge > Integrations > search for vILT Connector > click on vILT Connector

7. Configure the integration on the Settings page.

• Integration Name - This is a name use to identify the integration implemented on your side, this can be any name you choose.

• Username - This is the username provided by your vendor/development partner in order to authenticate the request from Cornerstone LMS to the virtual meeting vendor provider.

• Password - This is the password for the username provided by your vendor/development partner in order to authenticate the request from Cornerstone LMS to the virtual meeting vendor provider.

• Base Service URL - This is the base URL endpoint for all the virtual meeting vendor webhooks. This is provided by your vILT Vendor.

8. Select the Save Settings button.

9. Search for vILT Connector integration and enable the integration by turning on the toggle switch.

6

ILT Administrators can add Instructors added to vILT custom provider using the Vendors & Instructors configuration page. An existing Cornerstone user can be added as an instructor or any other instructor can be added. User First Name, Last Name and email address are required.  Upon clicking submit, the instructor information will be sent to the virtual meeting provider.

Depending on your virtual provider, instructors may need to be registered instructors with the provider. Instructors are validated with 3rd party providers by using the instructor email.

ILT Administrators can edit existing Instructors added to vILT custom provider using the Vendors & Instructors configuration page. User First Name, Last Name and email address are required, but can be edited.  Upon clicking submit, the updated instructor information will be sent to the virtual meeting provider.

CREATING INSTRUCTORS

UPDATING INSTRUCTORS

Event and Session creation is identical to existing ILT workflows. Events created for vILT sessions must be associated with the vILT custom provider. Session information is sent to the virtual meeting provider when "Save" is pressed from the create session Summary page.

CREATING & EDITINGEVENTS/ SESSIONS

7

Once a session has successfully requested or been assigned end users can launch a session from their Cornerstone Transcript, when the designated launch timeframe has opened.

Depending on your virtual provider, instructors may have a different launch URL to initialize the session.

LAUNCH A SESSION

After a session has been updated or completed, the roster will be sent using Get Attendance workflow automatically.

For each email address reported in the GetAttendance call that matches a CSOD user email, we should mark that user as attended for the specific session. Other users and non-matches will not result in any attendance changes within the CSOD system.

 

GET ATTENDANCEAUTOMATED ROSTER UPDATE

A user can also manually call GetAttendance from the UI. On the session roster, click the UPDATE ROSTER button at least 24 hours after the session ends. This obtains the attendance information from the provider directly and updates the roster within the Cornerstone portal. The instructor should wait at least 24 hours after the session ends to ensure that the provider has properly recorded all attendance. Then, click the SUBMIT ROSTER button.

Consideration: Using the manual roster update will overwrite the existing roster for the session. 

MANUAL ROSTER UPDATE

8

Q: What is not available with this connector?

A: With this vILT connector Sessions with multiple parts, Sessions with Extended Options (vendor specific configurable options such as allow recording or for non-registered users to join), and cancel session are not available. Early Adopters can still cancel the session within CSOD, but session will not be automatically cancelled on the meeting provider side.

Q: What vendors/providers can I use with this connector?

A: The connector was designed after analyzing several popular vendors and is built to require only fundamental data. We recommend reviewing the documentation to evaluate if it will satisfy the requirements.

Q: Can I continue use my existing vILT integration?

A: Cornerstone will continue to support these integrations, but are aware that new integrations can be created by others with more or newer features

Q: Can I use this new connect and my existing vILT integration at the same time?

A: Yes, existing integrations should not be impacted.

Q: Can I use this connector with multiple virtual meeting providers?

A: You can have a single vILT provider using the connector for the Early Adopter.

Q: Can I associate multiple accounts for a single integration?

A: The Early Adopter will allow a client to have a single provider that uses the connector. For example, they can use one Skype Cloud account per portal.

FREQUENTLY ASKED QUESTIONS