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 d'apprentissage, 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 d'apprentissage, 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»

}

Remarque :  La date d'achèvement recommandée (recommendedCompletionDate) et la durée en minutes (lengthInMinutes) sont des options facultatives. Si vous ne fournissez pas la date d'achèvement recommandée et la durée en minutes, leurs valeurs sont basées sur les valeurs du module.

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 d'apprentissage à Genesys Cloud via le point de terminaison PATCH /api/v2/learning/modules/{moduleId}/users/{userId}/assignments

Instruction

Ce PATCH /api/v2/learning/modules/{moduleId}/users/{userId}/assignments endpoint est protégé par la permission 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
}

Remarque :  Si vous avez des questions sur la façon de créer votre middleware, Genesys vous recommande de contacter votre partenaire ou le service clientèle.