Best Practices für externe Lernmodule
In diesem Artikel werden die Best Practices für die Interaktion Ihrer Middleware mit den Genesys-APIs aufgeführt.
Genesys Cloud kann die Systeme, die außerhalb der Genesys Cloud-Plattform liegen, mit den Genesys-Lernmodulen synchronisieren.
Beschreibung
To create a learning module, the administrator can use the POST /learning/modules endpoint.
Anleitung
Das externe Modul muss eine einzelne URL sein, die auf die externe Lernressource verweist.
Beispiel
{
"Name": „SMART-Ziele“,
"Beschreibung": „Diese externe Schulung führt Sie durch die Erstellung von SMART-Zielen.“,
„completionTimeInDays“: 14,
„informSteps“: [
{
"Typ": „URL“,
"Name": „SMART-Ziele“,
"Befehl": 1,
„Wert“: „https://myLms.com/courses/1234“
}
],
„excludedFromCatalog“: wahr,
„externalId“: „1234“,
"Typ": „Extern“
}
Beschreibung
To publish a learning module, the administrator can use the POST /api/v2/learning/modules/{moduleId}/publish endpoint.
Anleitung
Wenn Sie ein Lernmodul nach der Veröffentlichung bearbeiten, müssen Sie das Modul erneut veröffentlichen, damit den Benutzern die aktualisierte Version des Moduls zugewiesen wird. Sie können die Module aus dem Katalog ausblenden, um zu verhindern, dass sie in der Modulliste angezeigt werden, wenn der Vorgesetzte die Lernmodule über die Workspace Development-Seiten zuweist.
Beschreibung
To assign a learning module, the administrator can use the POST /api/v2/learning/assignments endpoint.
Anleitung
Sie können einem Benutzer eine bestimmte Version eines Lernmoduls zuweisen. Die Version des Lernmoduls wird erst festgelegt, wenn der Benutzer die Aufgabe startet. Wenn ein Benutzer keine Aufgabe gestartet hat und eine neuere Version des Moduls veröffentlicht wird, wird dem Benutzer automatisch die neueste Version des Lernmoduls zugewiesen.
Beispiel
{
„Modul-ID“: „2169a726-31e1-4d69-b161-1b62ccb1c99e“,
"Benutzer-ID": „1e39d64f-68ff-41cc-8a2e-781cbce08409“,
„empfohlenes Fertigstellungsdatum“: „2024-02-01T15:00:00Z“,
„lengthInMinutes“: “60”
}
Beschreibung
Sie können das Lernmodul über Genesys Cloud starten. Während des Aufgabenstarts wird ein Titelbildschirm mit der Modulbeschreibung und dem Titelbild angezeigt.
Anleitung
Wenn Sie auf klicken, um die Aufgabe zu starten, werden Sie im Modulschritt zu der URL weitergeleitet, die auf die externe Lernressource verweist .
Beschreibung
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.
Anleitung
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.
Beispiel
{
"Zustand": "Vollendet",
„percentageScore“: 85,
„isPassed“: wahr
}
