Cornerstone Learning vILT （預覽版）
自訂連接器透過利用客戶的 Azure AD 租戶環境、確保資料完整性和簡化身份驗證來簡化 vILT 整合。 不需要外部 Graph API 權限，增強安全性。 這種多功能連接器有助於針對不同場景的低程式碼解決方案。 透過合併此自訂連接器，可以在客戶的基礎架構中無縫釋放 Microsoft Teams API 在 MS Teams 整合方面的全部潛力。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部 （DoD） |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| Power Automate（自動化服務） | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 連絡人 | |
|---|---|
| 名稱 | 基石支援中心 |
| URL | https://www.cornerstoneondemand.com/community-and-support/ |
| DL-TECH-CSXL-CSODSUPPORT-MSFT-CISCO@csod.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | 基石點播 |
| 網站 | https://www.cornerstoneondemand.com/solutions/integrations-and-apis/ |
| 隱私策略 | https://www.cornerstoneondemand.com/client-privacy-policy/ |
| 類別 | 通敵;安全 |
Cornerstone Learning vILT 連接器
Logic Apps 的自訂連接器提供量身打造的解決方案，旨在順暢地整合到客戶的 Azure AD 租用戶環境中，特別是解決虛擬 Instructor-Led 訓練 （vILT） 整合。 透過在客戶的 Microsoft 365 租用戶內運行，此解決方案可確保資料和流程完整性，因為所有互動都在已建立的環境中進行。 例如，如果客戶想要利用 MS Teams 進行 vILT 會話，他們可以在租用戶內開發邏輯應用程式，並利用此連接器來協助呼叫 Microsoft Graph API。 這種方法消除了對 Cornerstone 的外部圖形 API 權限的需求，從而增強了安全性並簡化了身份驗證程序。 此外，它還優化了安全措施，同時提供透明的整合流程，使客戶能夠在其基礎設施中無縫利用 Microsoft Teams API 的全部功能。 透過將自訂連接器合併到 vILT 工作流程中，組織可以簡化培訓操作、減少開發開銷並充分發揮其整合的潛力。
先決條件
若要使用此連接器，客戶必須擁有 Cornerstone LMS，並從 Cornerstone Edge Marketplace 購買 Cornerstone Azure vILT 連接器。
如何取得認證
- 從 Cornerstone Edge Marketplace 購買連接器時，使用者需要提供整合名稱以及 API 金鑰。
- 公司識別碼和帳戶託管位置詳細資料將自動填入，以便在從連接器庫設定應用程式時使用。
開始使用連接器
應將Cornerstone Learning VILT聯結器新增為每個工作流程的觸發器，以便接收允許您支援在CSX中執行的每個操作的詳細資訊。請確保為可在CSX虛擬潛在客戶培訓模組中執行的每個操作構建一個工作流程，使用與每個操作關聯的聯結器操作將預期響應傳送到CSX。 此連接器支援的觸發程式/動作集：• 新增/更新講師：順暢地管理邏輯應用程式工作流程中的講師資訊。 • 管理會話：創建/更新/取消會話。 • 啟動會話：輕鬆啟動 vILT 會話。 • 檢索考勤資料：存取參與者考勤報告。
已知問題與限制
不支援擴充選項。
常見錯誤和補救措施
授權錯誤：如果使用者遇到「找不到 API 金鑰」的錯誤，他們應該驗證 API 金鑰以解決問題。
FAQ
Cornerstone 是否支援建立邏輯應用程式 – 否，Cornerstone 不支援建立邏輯應用程式;客戶有責任自行設定。
正在建立連線
連接器支援下列驗證類型：
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用：所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| 帳戶託管於 | 字串 | 指定將使用此連線的 API 伺服器 URL。 | 對 |
| API 金鑰 | securestring | 此 API 的 API 金鑰 | 對 |
| 公司識別碼 | 字串 | CSOD 中的公司識別碼 | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 回應刪除工作階段事件 |
回應刪除工作階段事件 |
| 回應取得出席事件 |
回應取得出席事件 |
| 回應啟動工作階段事件 |
回應啟動工作階段事件 |
| 回應建立工作階段事件 |
回應建立工作階段事件 |
| 回應新增講師活動 |
回應新增講師活動 |
| 回應更新工作階段事件 |
回應更新工作階段事件 |
| 回應更新講師事件 |
回應更新講師事件 |
回應刪除工作階段事件
回應刪除工作階段事件
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
是成功的
|
isSuccessful | boolean | ||
|
訊息
|
message | string | ||
|
correlationId
|
correlationId | True | uuid |
回應取得出席事件
回應取得出席事件
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
是成功的
|
isSuccessful | boolean | ||
|
訊息
|
message | string | ||
|
correlationId
|
correlationId | True | uuid | |
|
電子郵件
|
string |
出席者的電子郵件地址。 |
回應啟動工作階段事件
回應啟動工作階段事件
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
是成功的
|
isSuccessful | boolean | ||
|
訊息
|
message | string | ||
|
correlationId
|
correlationId | True | uuid | |
|
加入網址
|
joinUrl | string |
使用者或講師用來啟動虛擬會議工作階段的 URL |
回應建立工作階段事件
回應建立工作階段事件
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
是成功的
|
isSuccessful | boolean | ||
|
訊息
|
message | string | ||
|
correlationId
|
correlationId | True | uuid | |
|
corpId
|
corpId | string | ||
|
會議標識符
|
meetingId | string | ||
|
start
|
start | date-time | ||
|
結束
|
end | date-time | ||
|
主機電子郵件
|
hostEmail | string | ||
|
加入網址
|
joinURL | string |
回應新增講師活動
回應新增講師活動
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
是成功的
|
isSuccessful | boolean | ||
|
訊息
|
message | string | ||
|
correlationId
|
correlationId | True | uuid |
回應更新工作階段事件
回應更新工作階段事件
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
是成功的
|
isSuccessful | boolean | ||
|
訊息
|
message | string | ||
|
correlationId
|
correlationId | True | uuid | |
|
corpId
|
corpId | string | ||
|
會議標識符
|
meetingId | string | ||
|
start
|
start | date-time | ||
|
結束
|
end | date-time | ||
|
主機電子郵件
|
hostEmail | string | ||
|
加入網址
|
joinURL | string |
回應更新講師事件
回應更新講師事件
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
是成功的
|
isSuccessful | boolean | ||
|
訊息
|
message | string | ||
|
correlationId
|
correlationId | True | uuid |
觸發程序
| 訂閱以創建講師 |
訂閱以創建講師 |
| 訂閱以建立工作階段 |
訂閱以建立工作階段 |
| 訂閱以獲得出席率 |
訂閱以獲得出席率 |
| 訂閱刪除工作階段 |
訂閱刪除工作階段 |
| 訂閱啟動工作階段 |
訂閱啟動工作階段 |
| 訂閱更新工作階段 |
訂閱更新工作階段 |
| 訂閱更新講師 |
訂閱更新講師 |
訂閱以創建講師
訂閱以創建講師
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
電子郵件
|
string |
電子郵件 |
|
|
名字
|
firstName | string |
名字 |
|
lastName
|
lastName | string |
lastName |
訂閱以建立工作階段
訂閱以建立工作階段
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
創作者電子郵件
|
creatorEmail | string |
創作者電子郵件 |
|
title
|
title | string |
title |
|
說明
|
description | string |
說明 |
|
日期開始
|
dateBegin | string |
日期開始 |
|
日期結束
|
dateEnd | string |
日期結束 |
|
UTCOffset
|
timeZone.UTCOffset | string |
UTCOffset |
|
講師電子郵件
|
instructorEmails | string |
說明 |
|
sessionId
|
sessionId | string |
sessionId |
|
loId
|
loId | string |
loId |
訂閱以獲得出席率
訂閱以獲得出席率
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
sessionId
|
sessionId | string |
sessionId |
訂閱刪除工作階段
訂閱刪除工作階段
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
sessionId
|
sessionId | string |
電子郵件 |
訂閱啟動工作階段
訂閱啟動工作階段
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
sessionId
|
sessionId | string |
sessionId |
|
base64編碼電子郵件
|
base64EncodedEmail | string |
base64編碼電子郵件 |
訂閱更新工作階段
訂閱更新工作階段
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
創作者電子郵件
|
creatorEmail | string |
創作者電子郵件 |
|
title
|
title | string |
title |
|
說明
|
description | string |
說明 |
|
日期開始
|
dateBegin | string |
日期開始 |
|
日期結束
|
dateEnd | string |
日期結束 |
|
UTCOffset
|
timeZone.UTCOffset | string |
UTCOffset |
|
講師電子郵件
|
instructorEmails | string |
說明 |
|
sessionId
|
sessionId | string |
sessionId |
|
loId
|
loId | string |
loId |
訂閱更新講師
訂閱更新講師
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
舊電子郵件
|
oldEmail | string |
舊電子郵件 |
|
新電子郵件
|
newEmail | string |
新電子郵件 |
|
名字
|
firstName | string |
名字 |
|
lastName
|
lastName | string |
lastName |
|
是活躍的
|
isActive | boolean |
是活躍的 |