Bericht zur Schulungsdauer über die Learn365-API generieren

Einführung

Standardmäßig zeigt der Bericht Schulungsdauer die voraussichtliche Zeit an, die Lernende für Schulungen im aktuellen Katalog aufwenden (wie in den Schulungseinstellungen angegeben).

LMS-Administratoren und Microsoft 365 globale Administratoren können wählen, die tatsächliche Zeit zu erfassen, die Lernende zum Abschließen von E-Learning-Kursen benötigt haben, basierend darauf, wie lange sie Inhalte im Learn365 Player konsumiert haben. Zeit, die in Inhalten verbracht wird, die außerhalb des Learn365 Player gestartet und aufgerufen werden, wird nicht erfasst.

Sie können den Bericht im Learn365 Admin Center oder über die API generieren.

In diesem Artikel beschreiben wir die Schritte, die Sie befolgen sollten, um die beiden Varianten des Berichts Schulungsdauer per API zu generieren.

Bericht zur Schulungsdauer generieren – voraussichtliche Dauer

Bevor Sie den Bericht generieren, benötigen Sie die ID des Kurskatalogs, zu dem die benötigte Schulung gehört. Sie können diese Information per API ermitteln, indem Sie die Schritte in diesem Artikel befolgen.

So generieren Sie den Bericht Schulungsdauer (voraussichtliche Dauer) per API:

1. Gehen Sie zu https://api.365.systems/ und vergewissern Sie sich, dass Sie mit dem entsprechenden API-Schlüssel autorisiert sind.

2. Wählen Sie im Abschnitt Reports den GET-Endpunkt /reports/trainingDuration/learnersTrainingDuration aus und wählen Sie oben rechts Try it out.

3. Geben Sie die folgenden erforderlichen Abfrageparameter ein:

• courseCatalogId: ID eines Kurskatalogs.
• startDate: Datum und Uhrzeit, ab denen Schulungen berücksichtigt werden, zum Beispiel 2024-01-15T15:00:00.00Z. Der Bericht enthält nur Schulungen, die nach dem Startdatum abgeschlossen wurden.
• endDate: Datum und Uhrzeit, bis zu denen Schulungen berücksichtigt werden, zum Beispiel 2024-07-15T15:00:00.00Z. Der Bericht enthält nur Schulungen, die vor dem Enddatum abgeschlossen wurden.

4. Select Ausführen, um die Anfrage auszuführen.

5. Gehen Sie zum Block Response, um die Ergebnisse zu überprüfen:

• Ein 200-Code mit einer Liste von Lernenden und Schulungsdaten im Antworttext bedeutet, dass die Antwort erfolgreich ist.
• Ein 200-Code mit leerem Antworttext bedeutet, dass keine Daten zur Anzeige vorhanden sind. In diesem Fall können Sie die Anfrageparameter ändern, zum Beispiel den Datumsbereich erweitern.
• Im Fehlerfall enthält der Antworttext das Objekt error mit den Schlüsseln code und message, die das Problem erklären.

Die Daten in einer erfolgreichen Antwort sind nach Lernenden aufgeteilt und enthalten Folgendes:

• LearnerName: vollständiger Name eines Lernenden.
• Email: die E-Mail-Adresse eines Lernenden.
• Department: eine Abteilung, zu der ein Lernender gehört.
• TotalDuration: die Gesamtdauer (in Minuten) aller im Bericht für den Lernenden enthaltenen Schulungen.
• CourseInfo-Array mit einer Liste aller Kurse oder Schulungspläne, die ein Lernender im angegebenen Zeitraum abgeschlossen hat. Jeder Kurs oder Schulungsplan enthält die folgenden Details:
  • CourseCatalogName: der Name des Katalogs.
  • CourseName: der Name der Schulung, die ein Lernender abgeschlossen hat.
  • CourseCategory: eine Kategorie, zu der die Schulung gehört.
  • CourseDuration: die Dauer des Kurses oder Schulungsplans (in Minuten), so wie sie im Duration-Feld im Konfigurationsbereich des Kurses oder Schulungsplans angegeben wurde. Der Bericht gibt die Dauer an, die gültig war, als sich der Lernende für die Schulung registriert hat.
  • CompletionDate: Datum und Uhrzeit, zu der Lernende ihre Schulung abgeschlossen haben.

Den Bericht zur Schulungsdauer generieren – tatsächliche Dauer

Bevor Sie den Bericht generieren, benötigen Sie die Registrierungs-ID für die jeweilige Schulung, die Sie verfolgen möchten. Sie können diese Information per API ermitteln, indem Sie die Schritte in diesem Artikel befolgen.

So generieren Sie Training duration (tatsächliche Dauer) per API:

1. Gehen Sie zu https://api.365.systems/ und vergewissern Sie sich, dass Sie mit dem entsprechenden API-Schlüssel autorisiert sind.

2. Wählen Sie im Abschnitt Reports den GET-Endpunkt /reports/trainingDuration/learnerActualTrainingDurationaus und wählen Sie Try it out in der oberen rechten Ecke aus.

3. Geben Sie im Abfrageparameter enrollmentId die Registrierungs-ID für die Schulung ein, die Sie verfolgen möchten.

4. Wählen Sie Execute aus, um die Anfrage auszuführen.

5. Gehen Sie zum Block Response, um die Ergebnisse zu kontrollieren.

• Ein Code 200 mit einer Liste von Lernsitzungen und Daten zur Schulungsdauer im Antworttext bedeutet, dass die Antwort erfolgreich ist.
• Der Code 404 bedeutet, dass für die in der Anfrage angegebene Registrierungs-ID keine Daten angezeigt werden können.
• Im Fehlerfall enthält der Antworttext das Objekt error mit den Schlüsseln code und message, die das Problem erklären.

Daten in einer erfolgreichen Antwort:

• UserName: Benutzername der Lernenden/des Lernenden.
• CourseId: die ID des Kurses.
• CourseName: der Titel des Kurses.
• CourseStatus: Abgeschlossen.
• RealDurationMinutes: die tatsächliche Zeit, die der/die Lernende in der Lernsitzung verbracht hat.
• StartDateTime: Datum und Uhrzeit, zu der der/die Lernende die Lernsitzung gestartet hat.
• EndDateTime: Datum und Uhrzeit, zu der der/die Lernende den Learn365 Player verlassen oder den Kurs abgeschlossen hat.