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
Um ein Lernmodul zu erstellen, kann der Administrator das verwenden POST /learning/modules
Endpunkt.
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
Um ein Lernmodul zu veröffentlichen, kann der Administrator das verwenden POST /api/v2/learning/modules/{moduleId}/publish
Endpunkt.
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
Um ein Lernmodul zuzuweisen, kann der Administrator das verwenden POST /api/v2/learning/assignments
Endpunkt.
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
Um die Aufgabe zu aktualisieren, muss das externe System die Ergebnisse der Lernressource über das an Genesys Cloud senden PATCH /api/v2/learning/modules/{moduleId}/users/{userId}/assignments
Endpunkt.
Anleitung
Das PATCH /api/v2/learning/modules/{moduleId}/users/{userId}/assignments
Endpunkt ist hinter dem eingezäunt learning:externalAufgabe:edit Berechtigung, die standardmäßig keiner Rolle zugewiesen ist. Der Endpunkt aktualisiert immer die neueste Aufgabe für diesen Benutzer und das Lernmodul.
Beispiel
{
"Zustand": "Vollendet",
„percentageScore“: 85,
„isPassed“: wahr
}