Interfejs xAPI w usłudze Learning Manager

Co to jest xAPI?

Interfejs Experience API (xAPI) to standard e-learningowy, który pozwala zawartościom i systemom nauczania komunikować się z sobą, tak aby rejestrować i śledzić wszystkie rodzaje doświadczeń edukacyjnych. Doświadczenia związane z nauką są zapisywane w systemie Learning Record Store (LRS). Systemy LRS mogą istnieć w ramach tradycyjnych platform edukacyjnych lub samodzielnie.

Więcej informacji na temat standardu xAPI znajduje się pod adresem:  https://github.com/adlnet/xAPI-Spec.

W jaki sposób usługa Learning Manager obsługuje interfejs xAPI?

Usługa Learning Manager ma wbudowany system Learning Record Store (LRS). System LRS może akceptować polecenia xAPI z zawartości obsługiwanej na serwerach usługi Learning Manager. System ten akceptuje nawet polecenia interfejsu xAPI generowane przez inne systemy. Te polecenia interfejsu xAPI są przechowywane w usłudze Learning Manager, a następnie mogą być eksportowane poza system w celu wizualizacji do dowolnego zewnętrznego systemu magazynowania danych.

Kiedy używany jest standard xAPI?

Coraz częściej istnieje potrzeba rejestrowania doświadczeń edukacyjnych użytkownika, które obejmują wiele systemów.  Istnieje również potrzeba śledzenia dokładnego zaangażowania ucznia w zawartości szkoleniową. Standard ten wykracza poza pozyskiwanie wyłącznie informacji o atrybutach Start, W toku i Ukończenie (które są pozyskiwane przez SCORM).

Korzystanie z interfejsu xAPI usługi Learning Manager

Konfiguracja aplikacji

  1. Zaloguj się jako administrator ds. integracji. Wybierz opcję Aplikacje > Zarejestruj się.

    Rejestracja aplikacji
    Rejestracja aplikacji

  2. Zarejestruj nową aplikację.

    Tworzenie aplikacji
    Tworzenie aplikacji

  3. Zdefiniuj zakres.

    • Jeśli włączono opcję Dostęp do odczytu i zapisu xAPI w roli administratora, administrator może wysyłać i odbierać polecenia i dokumenty xAPI.
    • Jeśli włączono opcję Dostęp do odczytu i zapisu xAPI w roli ucznia, uczeń może wysyłać i odbierać polecenia i dokumenty xAPI.
  4. Zapisz zmiany. Uzyskasz identyfikator i tajny klucz programisty.

Punkty końcowe :

Kliknij poniższe łącze, aby wyświetlić dokument Swagger xAPI:

https://learningmanagereu.adobe.com/docs/learningmanagerapi/xapi/

Uwaga: Usługa Learning Manager obsługuje interfejs xAPI 1.0.3.

Uwierzytelnianie API

Standard xAPI usługi Learning Manager uwierzytelnia i autoryzuje aplikacje klienckie za pośrednictwem platformy OAuth 2.0.Po zarejestrowaniu aplikacji można uzyskać dostęp do wartości clientId i clientSecret. Zapytanie GET w adresie URL służy do uwierzytelniania użytkowników usłudze Learning Manager za pomocą wstępnie skonfigurowanych kont, na przykład logowania jednokrotnego czy identyfikatora Adobe ID. 

GET https://learningmanager.adobe.com/oauth/o/authorize?client_id=<Wprowadź identyfikator klienta>&redirect_uri=<Wprowadź adres URL przekierowania>&state=<Dowolny ciąg danych>&scope=<admin:xapi lub learner:xapi>&response_type=CODE.

Śledzenie instrukcji interfejsu xAPI jako elementów edukacyjnych Learning Manager

Autor może wybrać moduł xAPI podczas tworzenia kursów do monitorowania pracy użytkowników poza usługą Learning Manager. Pozwala to na przykład oceniać działania, jakie użytkownicy wykonują na innej platformie w ramach kursu.

  1. Tworząc Moduł aktywności, w opcji Typ użyj menu podręcznego, aby wybrać opcję Moduł oparty na xAPI.

    Tworzenie modułu opartego na xAPI
    Tworzenie modułu opartego na xAPI

  2. Należy zapewnić standard IRI. W przypadku jego braku usługa Learning Manager wygeneruje go automatycznie.

    Uwaga:

    Numer IRI dla danej aktywności jest niepowtarzalny w obrębie konta. Oznacza to, że dwa moduły w usłudze Learning Manager nie mogą mieć tego samego IRI. Nowy standard IRI jest generowany w następujących przypadkach:

    • Kiedy kurs z modułem Wersja standardu xAPI jest udostępniony pomiędzy kontami.
    • Kiedy certyfikacja z modułem xAPI powtarza się.

     

    Wszystkie polecenia interfejsu xAPI z wymienionym numerem IRI są śledzone w powyższym module i odzwierciedlane w raportach usługi Learning Manager. 

  3. Aby skopiować automatycznie wygenerowany IRI, odwiedź ponownie stronę Moduł aktywności.

  4. Opublikuj moduł.

Istotne kwestie:

  • Obecnie usługa Learning Manager obsługuje tylko identyfikator mbox. Nie są obsługiwane inne konta, takie jak mboz_sha1 czy openid.
  • Wartości stateId i profileId są uniwersalnymi unikatowymi identyfikatorami, gdy są używane w usłudze Learning Manager.
  • Żądanie PUT nie zastępuje dokumentu dla agentów/profilu xAPI, aktywności/profilu ani aktywności/stanu.
  • Grupa niezidentyfikowana nie jest obsługiwana dla opcji Aktor.
  • Parametr „related_activities” nie jest obsługiwany w instrukcji GET.
  • Parametry „format=ids” i „format=canonical” nie są obsługiwane w poleceniach GET.
  • Anulowanie instrukcji interfejsu xAPI nie cofa żadnych operacji, które miały miejsce w usłudze Learning Manager w momencie wysłania tej instrukcji.

Generowanie raportów

Wersja standardu xAPI można generować w formacie XLS. Jako administrator wybierz opcję Raporty > Raporty programu Excel > Raport aktywności interfejsu xAPI.

Pobrany raport zawiera wszystkie informacje zamieszczone przez ucznia i administratora dla każdego polecenia.

Te same raporty mogą być tworzone/planowane przy użyciu łączników FTP i Box dla dowolnej integracji stron trzecich. Należy wykonać następujące kroki:

Zaloguj się jako administrator ds. integracji, otwórz łącznik FTP/Box, wybierz raport aktywności interfejsu xAPI z lewego panelu i wybierz opcję planowania/tworzenia raportu.

Planowanie raportu
Planowanie raportu

Uwaga:
  • Gdy w instrukcji interfejsu xAPI jest wysyłany tylko wynik (bez wyniku maksymalnego), transkrypt ucznia nie zawiera wyniku testu.
  • Aby uzyskać wynik procentowy w usłudze Learning Manager, przez interfejs xAPI są wysyłane oceny skalowane.

Przykładowy raport

Pobierz

Pomoc dostępna szybciej i łatwiej

Nowy użytkownik?