Meilleures pratiques en matière de modules d'apprentissage externes
Cet article liste les meilleures pratiques pour faire interagir votre middleware avec les API de Genesys.
Genesys Cloud peut synchroniser les systèmes externes à la plateforme Genesys Cloud avec les modules d'apprentissage Genesys.
Description
Pour créer un module de formation, l'administrateur peut utiliser le point de terminaison POST /learning/modules
.
Instruction
Le module externe doit être une URL unique qui pointe vers la ressource d'apprentissage externe.
Exemple:
{
"nom" : "Objectifs SMART",
"description" : "Cette formation externe vous explique comment créer des objectifs SMART,
"completionTimeInDays" : 14,
"informSteps" : [
{
"type" : "Url",
"nom" : "Objectifs SMART",
"ordre" : 1,
"valeur" : "https://myLms.com/courses/1234"
}
],
"excludedFromCatalog" : vrai,
"externalId" : "1234",
"type" : "Externe"
}
Description
Pour publier un module d'apprentissage, l'administrateur peut utiliser le point de terminaison POST /api/v2/learning/modules/{moduleId}/publish
.
Instruction
Si vous modifiez un module de formation après l'avoir publié, vous devez republier le module pour que la version mise à jour du module soit attribuée aux utilisateurs. Vous pouvez masquer les modules du catalogue pour éviter qu'ils n'apparaissent dans la liste des modules lorsque le superviseur assigne les modules d'apprentissage via les pages de développement de l'espace de travail.
Description
Pour attribuer un module de formation, l'administrateur peut utiliser le point de terminaison POST /api/v2/learning/assignments
.
Instruction
Vous pouvez attribuer une version spécifique d'un module de formation à un utilisateur. La version du module d'apprentissage n'est déterminée que lorsque l'utilisateur commence le travail. Si un utilisateur n'a pas commencé une affectation et qu'une version plus récente du module est publiée, la dernière version du module de formation est automatiquement attribuée à l'utilisateur.
Exemple:
{
"moduleId" : “2169a726-31e1-4d69-b161-1b62ccb1c99e”,
"userId" : “1e39d64f-68ff-41cc-8a2e-781cbce08409”,
"recommendedCompletionDate" : “2024-02-01T15:00:00Z”,
"lengthInMinutes" : « 60»
}
Description
Vous pouvez lancer le module de formation à partir de Genesys Cloud. Lors du lancement de l'affectation, un écran de couverture contenant la description du module et la pochette est présenté.
Instruction
Lorsque vous cliquez pour commencer le travail, vous êtes redirigé vers l'URL de l'étape du module qui pointe vers la ressource d'apprentissage externe.
Description
Pour mettre à jour l'affectation, le système externe doit envoyer les résultats de la ressource didactique à Genesys Cloud via le point de terminaison PATCH /api/v2/learning/modules/{moduleId}/users/{userId}/assignments
.
Instruction
Ce point d'accès PATCH /api/v2/learning/modules/{moduleId}/users/{userId}/assignments
est protégé par l'autorisation learning:externalAssignment:edit qui n'est attribuée à aucun rôle par défaut. Le point d'arrivée met toujours à jour la dernière affectation pour cet utilisateur et le module de formation.
Exemple:
{
"état" : "Complété",
"percentageScore" : 85,
"isPassed" : true
}