Cornerstone Learning vILT (Preview)

The custom connector streamlines vILT integration by leveraging customers' Azure AD tenant environments, ensuring data integrity and simplifying authentication. No external Graph API permissions are needed, enhancing security. This versatile connector facilitates low-code solutions for diverse scenarios. By incorporating this custom connector, the full potential of Microsoft Teams API in the case of MS Teams integration is unlocked seamlessly within customers' infrastructure.

This connector is available in the following products and regions:

Service	Class	Regions
Logic Apps	Standard	All Logic Apps regions except the following:      -   Azure Government regions      -   Azure China regions      -   US Department of Defense (DoD)

Contact
Name	Cornerstone Support Central
URL	https://www.cornerstoneondemand.com/community-and-support/
Email	DL-TECH-CSXL-CSODSUPPORT-MSFT-CISCO@csod.com

Connector Metadata
Publisher	Cornerstone On Demand
Website	https://www.cornerstoneondemand.com/solutions/integrations-and-apis/
Privacy policy	https://www.cornerstoneondemand.com/client-privacy-policy/
Categories	Collaboration;Security

Cornerstone Learning vILT Connector

The custom connector for Logic Apps provides a tailored solution designed to seamlessly integrate within customers' Azure AD tenant environments, specifically addressing virtual Instructor-Led Training (vILT) integrations. By operating within customers' Microsoft 365 tenants, this solution ensures data and process integrity, as all interactions take place within established environments. For instance, if a customer aims to utilize MS Teams for vILT sessions, they can develop a Logic App within their tenant and utilize this connector to facilitate calls to the Microsoft Graph API. This approach eliminates the need for external Graph API permissions to Cornerstone, thereby enhancing security and simplifying authentication procedures. Moreover, it optimizes security measures while offering a transparent integration process, empowering customers to seamlessly leverage the full capabilities of Microsoft Teams API within their infrastructure. By incorporating the custom connector into vILT workflows, organizations can streamline training operations, reduce development overhead, and fully realize the potential of their integrations.

Prerequisites

To utilize this connector, customers need to have Cornerstone LMS and purchase the Cornerstone Azure vILT connector from Cornerstone Edge Marketplace.

How to get credentials

1. Upon purchasing the connector from Cornerstone Edge Marketplace, users need to provide an Integration name along with the API Key.
2. Corporation Identifier and Account Hosted On details will be auto-populated for use while setting up the app from the Connectors Gallery.

Get started with your connector

The Cornerstone Learning VILT connector should be added as trigger of each workflow in order to receive the details that will allow you to support each action performed in CSX.Please make sure a workflow is built per each action that can be performed in the CSX Virtual Lead Training module, using the connector's action associated to each of them to send the expected response to CSX. The set of triggers/actions available in this connector support: • Add/Update Instructors: Seamlessly manage instructor information within the Logic App workflow. • Manage Sessions: Create/Update/Cancel Sessions. • Launch Sessions: Initiate vILT sessions with ease. • Retrieve Attendance data: Access participant attendance reports.

Known issues and limitations

Extended options are not supported.

Common errors and remedies

Authorization Error : If users encounter an error stating "No API key found," they should verify the API key to resolve the issue.

FAQ

Will Cornerstone support the creation of Logic Apps – No, Cornerstone does not support the creation of Logic Apps; customers are responsible for setting them up themselves.

Creating a connection

The connector supports the following authentication types:

Default	Parameters for creating connection.	All regions	Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name	Type	Description	Required
Account hosted on	string	Specifies the API Server URL that this connection will be used with.	True
API Key	securestring	The API Key for this api	True
Corporation Identifier	string	The Corporation Identifier in CSOD	True

Throttling Limits

Name	Calls	Renewal Period
API calls per connection	100	60 seconds

Actions

Respond to Add Instructor Event	Respond to Add Instructor Event
Respond to Create Session Event	Respond to Create Session Event
Respond to Delete Session Event	Respond to Delete Session Event
Respond to Get Attendance Event	Respond to Get Attendance Event
Respond to Launch Session Event	Respond to Launch Session Event
Respond to Update Instructor Event	Respond to Update Instructor Event
Respond to Update Session Event	Respond to Update Session Event

Respond to Add Instructor Event

Operation ID:

addInstructorResponse

Respond to Add Instructor Event

Parameters

Name	Key	Required	Type	Description
isSuccessful	isSuccessful		boolean
message	message		string
correlationId	correlationId	True	uuid

Respond to Create Session Event

Operation ID:

createSessionResponse

Respond to Create Session Event

Parameters

Name	Key	Required	Type	Description
isSuccessful	isSuccessful		boolean
message	message		string
correlationId	correlationId	True	uuid
corpId	corpId		string
meetingId	meetingId		string
start	start		date-time
end	end		date-time
hostEmail	hostEmail		string
joinURL	joinURL		string

Respond to Delete Session Event

Operation ID:

deleteSessionResponse

Respond to Delete Session Event

Parameters

Name	Key	Required	Type	Description
isSuccessful	isSuccessful		boolean
message	message		string
correlationId	correlationId	True	uuid

Respond to Get Attendance Event

Operation ID:

getAttendanceResponse

Respond to Get Attendance Event

Parameters

Name	Key	Required	Type	Description
isSuccessful	isSuccessful		boolean
message	message		string
correlationId	correlationId	True	uuid
email	email		string	Email address of the attendee.

Respond to Launch Session Event

Operation ID:

launchSessionResponse

Respond to Launch Session Event

Parameters

Name	Key	Required	Type	Description
isSuccessful	isSuccessful		boolean
message	message		string
correlationId	correlationId	True	uuid
joinUrl	joinUrl		string	URL a user or instructor uses to launch the virtual meeting session

Respond to Update Instructor Event

Operation ID:

updateInstructorResponse

Respond to Update Instructor Event

Parameters

Name	Key	Required	Type	Description
isSuccessful	isSuccessful		boolean
message	message		string
correlationId	correlationId	True	uuid

Respond to Update Session Event

Operation ID:

updateSessionResponse

Respond to Update Session Event

Parameters

Name	Key	Required	Type	Description
isSuccessful	isSuccessful		boolean
message	message		string
correlationId	correlationId	True	uuid
corpId	corpId		string
meetingId	meetingId		string
start	start		date-time
end	end		date-time
hostEmail	hostEmail		string
joinURL	joinURL		string

Triggers

Subscribe to create instructor	Subscribe to create instructor
Subscribe to create session	Subscribe to create session
Subscribe to delete session	Subscribe to delete session
Subscribe to get attendance	Subscribe to get attendance
Subscribe to launch session	Subscribe to launch session
Subscribe to update instructor	Subscribe to update instructor
Subscribe to update session	Subscribe to update session

Subscribe to create instructor

Operation ID:

Create-instructor-subscribe

Subscribe to create instructor

Returns

Name	Path	Type	Description
email	email	string	email
firstName	firstName	string	firstName
lastName	lastName	string	lastName

Subscribe to create session

Operation ID:

Create-session-subscribe

Subscribe to create session

Returns

Name	Path	Type	Description
creatorEmail	creatorEmail	string	creatorEmail
title	title	string	title
description	description	string	description
dateBegin	dateBegin	string	dateBegin
dateEnd	dateEnd	string	dateEnd
UTCOffset	timeZone.UTCOffset	string	UTCOffset
instructorEmails	instructorEmails	string	description
sessionId	sessionId	string	sessionId
loId	loId	string	loId

Subscribe to delete session

Operation ID:

Delete-session-subscribe

Subscribe to delete session

Returns

Name	Path	Type	Description
sessionId	sessionId	string	email

Subscribe to get attendance

Operation ID:

Get-attendance-subscribe

Subscribe to get attendance

Returns

Name	Path	Type	Description
sessionId	sessionId	string	sessionId

Subscribe to launch session

Operation ID:

Launch-session-subscribe

Subscribe to launch session

Returns

Name	Path	Type	Description
sessionId	sessionId	string	sessionId
base64EncodedEmail	base64EncodedEmail	string	base64EncodedEmail

Subscribe to update instructor

Operation ID:

Update-instructor-subscribe

Subscribe to update instructor

Returns

Name	Path	Type	Description
oldEmail	oldEmail	string	oldEmail
newEmail	newEmail	string	newEmail
firstName	firstName	string	firstName
lastName	lastName	string	lastName
isActive	isActive	boolean	isActive

Subscribe to update session

Operation ID:

Update-session-subscribe

Subscribe to update session

Returns

Name	Path	Type	Description
creatorEmail	creatorEmail	string	creatorEmail
title	title	string	title
description	description	string	description
dateBegin	dateBegin	string	dateBegin
dateEnd	dateEnd	string	dateEnd
UTCOffset	timeZone.UTCOffset	string	UTCOffset
instructorEmails	instructorEmails	string	description
sessionId	sessionId	string	sessionId
loId	loId	string	loId