외부 학습 모듈 모범 사례
이 문서에는 미들웨어가 Genesys API와 상호 작용하도록 만드는 모범 사례가 나열되어 있습니다.
Genesys Cloud는 Genesys Cloud 플랫폼 외부 시스템을 Genesys 학습 모듈과 동기화할 수 있습니다.
설명
To create a learning module, the administrator can use the POST /learning/modules
endpoint.
지침
외부 모듈은 외부 학습 리소스를 가리키는 단일 URL이어야 합니다.
예
{
"이름": "스마트 목표",
"설명": "이 외부 교육에서는 SMART 목표를 설정하는 방법을 안내합니다.",
"completionTimeInDays": 14,
"informSteps": [
{
"유형": “URL”,
"이름": "스마트 목표",
"주문하다": 1,
"값": "https://myLms.com/courses/1234"
}
],
"excludedFromCatalog": 사실,
"외부 ID": “1234”,
"유형": "외부"
}
설명
To publish a learning module, the administrator can use the POST /api/v2/learning/modules/{moduleId}/publish
endpoint.
지침
게시 후 학습 모듈을 편집하는 경우 모듈의 업데이트된 버전이 사용자에게 할당되도록 하려면 모듈을 다시 게시해야 합니다. 감독자가 작업 공간 개발 페이지를 통해 학습 모듈을 할당할 때 모듈 목록에 모듈이 표시되지 않도록 카탈로그에서 모듈을 숨길 수 있습니다.
설명
To assign a learning module, the administrator can use the POST /api/v2/learning/assignments
endpoint.
지침
특정 버전의 학습 모듈을 사용자에게 할당할 수 있습니다. 학습 모듈의 버전은 사용자가 과제를 시작할 때만 결정됩니다. 사용자가 할당을 시작하지 않았고 최신 버전의 모듈이 게시된 경우 최신 버전의 학습 모듈이 자동으로 사용자에게 할당됩니다.
예
{
"모듈 ID": "2169a726-31e1-4d69-b161-1b62ccb1c99e",
"사용자 ID": "1e39d64f-68ff-41cc-8a2e-781cbce08409",
"권장 완료 날짜": “2024-02-01T15:00:00Z”,
"길이분": "60"
}
설명
Genesys Cloud에서 학습 모듈을 시작할 수 있습니다. 과제가 시작되는 동안 모듈 설명과 표지 아트가 포함된 표지 화면이 표시됩니다.
지침
과제를 시작하기 위해 클릭하면 외부 학습 리소스를 가리키는 모듈 단계의 URL로 리디렉션됩니다. .
설명
To update the assignment, the external system must send the results of the learning resource to Genesys Cloud via the PATCH /api/v2/learning/modules/{moduleId}/users/{userId}/assignments
endpoint.
지침
This PATCH /api/v2/learning/modules/{moduleId}/users/{userId}/assignments
endpoint is gated behind the learning:externalAssignment:edit permission that is not assigned to any roles by default. The endpoint always updates the latest assignment for that user and the learning module.
예
{
"상태": "완전한",
"백분율점수": 85,
"isPassed": 사실
}