Arbeiten mit der Erfahrung API (XAPI)

In diesem Abschnitt wird beschrieben , wie mit der xapi elearning - Spezifikation arbeiten. Diese Erfahrung API, wie xapi bekannt, ermöglicht Content - Entwickler Daten über die Lernerfahrung ihrer Nutzer zu sammeln basiert. Der Abschnitt enthält Informationen über die xapi Optionen veröffentlichen und die Erfahrung Aussagen xapi zu verstehen. Die aktuellen technischen Daten, Dokumente und Erläuterungen von Begriffen finden Sie auf der offiziellen Webseite xapi ( http://tincanapi.com/ ).

Für weitere Informationen besuchen Sie diese xapi bezogenen Beiträge in unserer Trivantis Community:

Publizieren mit den xapi Optionen

Sie müssen xapi veröffentlichen die automatisierte und manuelle xapi Aussagen zu ermöglichen. Folgen Sie den Anweisungen beschrieben Publishing xapi Ihren Titel für die Veröffentlichung zu xapi vorzubereiten.

Die meisten der automatischen xapi Aussagen werden durch die Veröffentlichungsoptionen gesteuert , wenn Sie einen Titel zu xapi veröffentlichen. Diese Optionen werden in Gruppen zusammengefasst auf dem xapi Optionen Registerkarte , nachdem Sie auf Veröffentlichen :

Konformitätsstufe	Dieses Feld ist deaktiviert.
Starten Sie natürlich in einem separaten Fenster von LRS	Wählen Sie diese Option, wenn Sie die veröffentlichten Titel wollen in einem neuen Fenster gestartet werden. Wenn diese Option aktiviert ist, und der Benutzer verlässt den veröffentlichten Titel, wird das Fenster schließen, und der Benutzer wird auf die LRS zurückgeschickt werden.
Report Test / Umfrage Frage Interaktion LRS	Wählen Sie diese Interaktionsdaten für die Fragen in dem abgestuften Test enthielten aufnehmen zu dem LRS vorgelegt. Interaktionsdaten enthalten die folgenden Informationen für jede abgestuft Frage: Benutzer-Antwort Ob die Antwort des Benutzers korrekt ist oder nicht Zeit wurde die Frage beantwortet Zeitaufwand der Benutzer auf der Seite mit der Antwort
Fordert den Benutzer auf den zuletzt angezeigten Seite zu navigieren	Wählen Sie diese Option die automatische Lesezeichen-Funktion für den veröffentlichten Titel zu ermöglichen. Wenn diese Option aktiviert ist, und der Benutzer innerhalb der LRS den veröffentlichten Titel zurückkehrt, hat der Benutzer die Möglichkeit, auf die Seite überspringen er oder sie zuletzt in dem veröffentlichten Titel gesehen.
Aktivitäts-ID	Geben Sie die ID des Kurses, da es innerhalb der LRS bekannt sein wird.
Aktivitätsname	Geben Sie den Titel des Kurses, wie Sie es angezeigt werden soll innerhalb der LRS wollen.
Aktivitätsbeschreibung	Geben Sie die Beschreibung des Inhalts des Kurses, wie Sie es wollen innerhalb der LRS angezeigt werden.

Betrachten Sie die folgende , wenn die Optionen auf den Abschluss xapi Optionen tab:

Beachten Sie, dass die Aktivitäts - ID , Name der Aktivität , und Beschreibung der Aktivität für den Kurs hier eingestellt werden können. Die Optionen werden als Rahmen für weitere Anweisungen verwendet. Bei der Erstellung von Aktivitäts - ID , müssen Sie die Regeln für eine IRI (International Resource Identifier), wie die Vermeidung Leer- und Sonderzeichen folgen.
Eine versuchte Aktivität Anweisung wird automatisch gesendet , wenn der Kurs gestartet wird. Es ist für die Aktivität in der angegebenen gesendet Kursinformationen Abschnitt (spezifiziert durch Aktivitäts - ID , Name der Aktivität , und Beschreibung der Aktivität ) der xapi Veröffentlichungsoptionen.

Wenn die Option den Benutzer auffordern , auf den zuletzt angezeigten Seite zu navigieren ausgewählt ist , können Sie Ihre veröffentlichten Kurs eine xapi Aussage mit dem Verb berichten erfahrene für jeden von einem Lernenden besuchten Seite. Die Aktivität in diesem ist die HTML - Seite Namen und es ist URI-codiert , so kann es für die Lectora Bookmarking - Funktion verwendet werden.

Wenn Sie Fortschritte durch den Kurs verfolgen möchten, fügen Sie diese beiden Aktionen auf den Titel-Ebene:

Auf Show - xapi Statement - versucht - VAR (CurrentPageName)
Auf Hide - xapi Statement - abgeschlossen - VAR (CurrentPageName)

Fragen innerhalb eines Tests oder einer Umfrage wird gemeldet, wenn , wenn die Option beantwortet Bericht Test / Umfrage Frage Interaktion mit den LRS ausgewählt ist. Die Frage Text und die Antwort in der xapi Anweisung angegeben.

Der Test muss abgestuft werden, aber es muss nicht in der Gesamtnote einbezogen werden.
Zusätzlich ist der Activity - Elternteil ist Aussage Abschnitt seiner Prüfung der Tätigkeit eingestellt.

Senden bestanden oder nicht bestanden Prüfsätze

Bestanden oder xapi Aussagen fehlgeschlagen wird automatisch für Tests gesendet werden , die eingestellt werden benotet werden. Die Partitur ist mit dem Verb gesetzt entlang bestanden oder fehlgeschlagen . Der Objektanzeigename ist der Name des Tests. Die ID ist die IRI der Aktivität mit dem Namen des Tests hinzugefügt werden . (Siehe Beispiele unten.)

Die Ergebnis - Score Eigenschaften für min auf 0 und max bis 100 sind alle standardmäßig auf 0 gesetzt. Der niedrigste Passing Score (%) Bereich (auf die der Testergebnisse Tab) immer noch aufgenommen werden , wenn es auf 0 (im Fall von keinem richtig) eingestellt ist.

Abgeschlossen, Bestanden oder Fehlgeschlagen Activity Statements Sending

Wenn Sie die eingestellte AICC_Lesson_Status Variable wird eine xapi Anweisung gesendet. Die folgenden Bedingungen werden feststellen , welche Art von Anweisung gesendet wird :

Sie können eine Variable Aktion ändern verwenden , um festgelegt AICC_Lesson_Status zu abgeschlossen , bestanden oder fehlgeschlagen . Wenn dies geschehen ist, sendet der Kurs eine entsprechende abgeschlossene oder Bestanden oder Fehlgeschlagen Aussage.
Einstellen AICC_Lesson_Status zu übergeben oder abgeschlossen wird die xapi Erklärung des gesetzt result.completion auf true und die result.success zu wahren . Wenn AICC_Lesson_Status abgeschlossen ist und der Score ist weniger als die AU Meisterschaft Punktzahl, result.success wird falsch .
Wenn AICC_Lesson_Status eingestellt ist fehlgeschlagen , die xapi Aussage des result.completion wird auf wahr und result.success eingestellt ist falsch .
Die Partitur sollte in der Abschluss - Anweisung aufgenommen werden , wenn es vorhanden ist, wenn Sie ein abgestuftes, inklusive Test oder wenn Sie manuell eingestellt AICC_Score .

Senden einer xapi Statement

Sie können eine xapi Aussage von jedem Ort im Laufe senden. Es wird standardmäßig auf die gemeinsamen Elemente xapi Aussage so dass Sie ein Verb und ein Objekt angeben. Dies kann auf einer der vielen Auslöser für Aktionen ausgelöst werden. Wenn Sie die volle Kontrolle über die Mitteilung und alle seine Werte siehe Angeben Verben und Objekte unten.

Festlegen von Verben und Objekte

Lectora Inspireverwendet die ADL-Definitionen für Verben. Zusätzlich kann jeder Verbname eingegeben werden. Eingetragen Verb Namen werden die ADL-Namespace angehängt so künftige ADL Verben verwendet werden können, oder Sie können Ihr eigenes einzigartiges Verb verwenden. (Die LRS würde das Verb nicht bestätigen und Sie erlauben würde, darüber zu berichten;. Daher erlaubt die Verwendung von diesem Namespace)

Weitere Informationen zu den Verben, besuchen http://www.adlnet.gov/expapi/verbs .

Für den Objektteil der Anweisung, können Sie eine der dynamischen Variablen mit Hilfe modernster bearbeiten und den variablen Makros verwenden. Sie können auch Text verwenden, um auf eine Tätigkeit zu berichten. Das Objektfeld wird die Aktivität Bezeichner sein. Um dies zu gewährleisten ist ein gültiger IRI, ein minimaler Austausch von Zeichen wird mit diesem Ausdruck getan:

ActivityID (Der Ort der Aktivität IDs)

Erwägen Sie die Verwendung bedingte Aktionen und Aktionsgruppen für die Fähigkeit, komplexe Tracking-Szenarien zu tun.

Angeben zusätzliche Erklärung Werte

Activity Werte werden automatisch eingestellt.

Senden einer xapi Anweisung und dynamisch die Aussage zu aktualisieren

Mit Hilfe der Javascript ausführen Aktion, können Sie anpassen und dynamisch die xapi Anweisung aktualisieren, wie Sie den Titel mit Ihren Lernenden gehen durch Variablen, indem Sie in Ihrem Titel definiert. Auf diese Weise können Sie ganz einfach Vorlagen eingerichtet, die jeden Anwendungsfall gerecht wird.

Unten ist ein einfaches, aber effektives Beispiel für die Javascript, dass Sie die Aktion ausführen kann mit .. wird diese Javascript, um die Anweisung erstellen und dann die Anweisung senden, die Sie erstellt haben.

var stmt=
			
			{
			"Verb": {
			"Id": VarxAPIVerbID.getValue (),
			"Anzeige": {
			"Und": VarxAPIVerbDisplay.getValue ()
			}
			},
			"Objekt": {
			"Definition": {
			"Name": {
			"En-US": "xAPIandLODemo"
			}
			},
			"Id": "http://uniqueurl.com/xAPIandLoDemo",
			„Object“: „Aktivität“
			},
			"Führen": {
			"Ergebnis": {
			"Skaliert": (ParseInt (Test_1_Score.getValue ()) / 100)
			},
			"Vollendung": true,
			"Erfolg": true
			}
			}

			var tcAPI = window.parent.frames [ 'titlemgrframe'];
			var tc_driver = tcAPI.tc_driver;

		tcAPI.TinCanSendStatement (tc_driver, Anw, function (XHR) {});

Die obige Aussage enthält einige Funktionsaufrufe, den Wert zu erhalten LectoraVariablen. Diese könnten auch statische String-Werte, zum Beispiel, wenn Sie nur das Verb und andere Werte in der Anweisung angeben wollen.

Im Folgenden sind zwei Möglichkeiten für die xapi Anweisung Customizing:

VarxAPIVerbID.getValue()

Dies verwendet die benutzerdefinierte Variable xAPIVerbID. Verwenden Sie den gleichen Var Präfix , als ob Sie die Variable referenziert wurden in allen anderen Aktionen. Sie können diese Variable zu jedem Verb setzen Sie wollen. Stellen Sie sicher , dass Sie sowohl die tun ID und die Anzeige .

In diesem Beispiel ID ist eine URI wiehttp://adlnet.gov/expapi/verbs/answered

(Ein Beispiel entsprechende Anzeige wird beantwortet .)

(parseInt(Test_1_Score.getValue()) / 100) Dieser verwendet eine reservierte Variable , Test_1_Scoredie Partitur zu senden , die sie auf dem Test erhalten. (Dies hat nicht den Var - Präfix , da es keine benutzerdefinierten Variablen ist. Zusätzlich ist der Var automatisch vorangestellt wird , wenn es veröffentlicht wird.)

Zusätzliche Informationen erhalten

Weitere Informationen über xapi Anweisung Spezifikation finden Sie https://github.com/adlnet/xAPI-Spec/blob/master/xAPI.md . Weitere Informationen über die XAPI Anweisung Generator und Tester, besuchen http://tincanapi.com/statement-generator/ .

xapi Statement Output Beispiele (von SCORM Wolke)

2014-11-05T04: 05: 36,259
			Joe King bestanden 'http://www.uniqueurl.com/xAPI%20Template' mit Punktzahl 50
			2014-11-05T04: 05: 36,256
			Joe King falsch beantwortet ‚Umfrage-Frage 1‘ mit Antwort ‚true‘
			2014-11-05T04: 05: 36,254
			Joe King falsch beantwortet ‚My Test Frage 2‘ mit Antwort ‚falsch‘
			2014-11-05T04: 05: 36,251
			Joe King richtig beantwortet 'My Test Frage 1' mit Antwort 'true'
			2014-11-05T04: 05: 34,803
			Joe King schickte 'Custom-XAPI-Statement'
			2014-11-05T04: 05: 34,047
			Joe King erlebt ‚xapi Aktionen Seite‘
			2014-11-05T04: 05: 31,994
			Joe King erlebt ‚Nach der Umfrage Seite‘
			2014-11-05T04: 05: 27,433
			Joe King erlebt ‚Letzte Umfrage Seite‘
			2014-11-05T04: 05: 25,582
			Joe King erlebt 'Test 1 fail'
			2014-11-05T04: 05: 21,783
			Joe King nicht bestanden 'Test 1' mit Kerbe 50
			2014-11-05T04: 05: 17,391
			Joe King erfahren ‚Letzte Testseite‘
			2014-11-05T04: 05: 12.855
			Joe King erlebt 'Seite 1'
			2014-11-05T04: 05: 10.555
			Joe King erlebt 'Seite 1'
			2014-11-05T04: 05: 09,837
		Joe King versucht 'http://www.uniqueurl.com/xAPI%20Template'

Versuchte Course Statement (auto)

2014-11-05T04: 05: 09,837
			Joe King versucht 'http://www.uniqueurl.com/xAPI%20Template'
			{
			"Id": "3d26bd57-0558-4a02-934d-501c7d85d3b7",
			"Schauspieler": {
			"Name": "Joe King",
			"Konto": {
			"Homepage": "http://cloud.scorm.com/",
			"Name": "ZUASCUHYVJ|wieloch@trivantisboca.com"
			},
			"Object": "Agent"
			},
			"Verb": {
			"Id": "http://adlnet.gov/expapi/verbs/attempted",
			"Anzeige": {
			"En-US": "versucht"
			}
			},
			"Kontext": {
			"Registrierung": "61d426da-436a-4b2a-8daa-ce94f6082f2f",
			"ContextActivities": {
			"Gruppierung": [
			{
			"Id": "http://www.uniqueurl.com/xAPI%20Template",
			„Object“: „Aktivität“
			}
			]
			}
			},
			"Zeitstempel": "2014-11-05T04: 05: 07.734Z",
			"Gespeichert": "2014-11-05T04: 05: 09.837Z",
			"Behörde": {
			"Name": "Joe King",
			"Konto": {
			"Homepage": "http://cloud.scorm.com/",
			"Name": "ZUASCUHYVJ|wieloch@trivantisboca.com"
			},
			"Object": "Agent"
			},
			"Version": "1.0.0",
			"Objekt": {
			"Id": "http://www.uniqueurl.com/xAPI%20Template",
			"Definition": {
			"Name": {},
			"Beschreibung": {}
			},
			„Object“: „Aktivität“
			}
			}

Versuchte Course Statement (auto)

			2014-11-05T04: 05: 10.555
			Joe King erlebt 'Seite 1'
			{
			"Id": "3ed638c0-a422-41e5-b7d7-42bf43e59b39",
			"Schauspieler": {
			"Name": "Joe King",
			"Konto": {
			"Homepage": "http://cloud.scorm.com/",
			"Name": "ZUASCUHYVJ|wieloch@trivantisboca.com"
			},
			"Object": "Agent"
			},
			"Verb": {
			"Id": "http://adlnet.gov/expapi/verbs/experienced",
			"Anzeige": {
			"En-US": "erfahren"
			}
			},
			"Kontext": {
			"Registrierung": "61d426da-436a-4b2a-8daa-ce94f6082f2f",
			"ContextActivities": {
			"Gruppierung": [
			{
			"Id": "http://www.uniqueurl.com/xAPI%20Template",
			„Object“: „Aktivität“
			}
			],
			"Eltern": [
			{
			"Id": "http://www.uniqueurl.com/xAPI%20Template",
			„Object“: „Aktivität“
			}
			]
			}
			},
			"Zeitstempel": "2014-11-05T04: 05: 08.506Z",
			"Gespeichert": "2014-11-05T04: 05: 10.555Z",
			"Behörde": {
			"Name": "Joe King",
			"Konto": {
			"Homepage": "http://cloud.scorm.com/",
			"Name": "ZUASCUHYVJ|wieloch@trivantisboca.com"
			},
			"Object": "Agent"
			},
			"Version": "1.0.0",
			"Objekt": {
			"Id": "http://www.uniqueurl.com/xAPI%20Template/a001_page_1.html",
			"Definition": {
			"Name": {
			"En-US": "Seite 1"
			}
			},
			„Object“: „Aktivität“
			}
		}

Bestanden / Nicht bestanden Test-Statement (auto)

2014-11-05T04: 05: 21,783
			Joe King nicht bestanden 'Test 1' mit Kerbe 50
			{
			"Id": "1820c7e8-6509-4c45-B672-af7ae301ec40",
			"Schauspieler": {
			"Name": "Joe King",
			"Konto": {
			"Homepage": "http://cloud.scorm.com/",
			"Name": "ZUASCUHYVJ|wieloch@trivantisboca.com"
			},
			"Object": "Agent"
			},
			"Verb": {
			"Id": "http://adlnet.gov/expapi/verbs/failed",
			"Anzeige": {
			"En-US": "nicht bestanden"
			}
			},
			"Führen": {
			"Ergebnis": {
			"Raw": 50,
			"Min": 0,
			"Max": 100
			},
			"Erfolg": false,
			"Vollendung": false
			},
			"Kontext": {
			"Registrierung": "61d426da-436a-4b2a-8daa-ce94f6082f2f",
			"ContextActivities": {
			"Gruppierung": [
			{
			"Id": "http://www.uniqueurl.com/xAPI%20Template",
			„Object“: „Aktivität“
			}
			],
			"Eltern": [
			{
			"Id": "http://www.uniqueurl.com/xAPI%20Template",
			„Object“: „Aktivität“
			}
			]
			}
			},
			"Zeitstempel": "2014-11-05T04: 05: 20.030Z",
			"Gespeichert": "2014-11-05T04: 05: 21.783Z",
			"Behörde": {
			"Name": "Joe King",
			"Konto": {
			"Homepage": "http://cloud.scorm.com/",
			"Name": "ZUASCUHYVJ|wieloch@trivantisboca.com"
			},
			"Object": "Agent"
			},
			"Version": "1.0.0",
			"Objekt": {
			"Id": "http://www.uniqueurl.com/xAPI%20Template/Test%201",
			"Definition": {
			"Name": {
			"En-US": "Test 1"
			}
			},
			„Object“: „Aktivität“
			}
		}

Frage beantwortet Statement (auto)

2014-11-05T04: 05: 36,251
			Joe King richtig beantwortet 'My Test Frage 1' mit Antwort 'true'
			{
			"Id": "a8af22bf-8e38-447c-8e6a-500c3673f867",
			"Schauspieler": {
			"Name": "Joe King",
			"Konto": {
			"Homepage": "http://cloud.scorm.com/",
			"Name": "ZUASCUHYVJ|wieloch@trivantisboca.com"
			},
			"Object": "Agent"
			},
			"Verb": {
			"Id": "http://adlnet.gov/expapi/verbs/answered",
			"Anzeige": {
			"En-US": "beantwortet"
			}
			},
			"Führen": {
			"Erfolg": true,
			"Antwort": "true"
			},
			"Kontext": {
			"Registrierung": "61d426da-436a-4b2a-8daa-ce94f6082f2f",
			"ContextActivities": {
			"Gruppierung": [
			{
			"Id": "http://www.uniqueurl.com/xAPI%20Template",
			„Object“: „Aktivität“
			}
			],
			"Eltern": [
			{
			"Id": "http://www.uniqueurl.com/xAPI%20Template",
			„Object“: „Aktivität“
			}
			]
			}
			},
			"Zeitstempel": "2014-11-05T04: 05: 10.000Z",
			"Gespeichert": "2014-11-05T04: 05: 36.251Z",
			"Behörde": {
			"Name": "Joe King",
			"Konto": {
			"Homepage": "http://cloud.scorm.com/",
			"Name": "ZUASCUHYVJ|wieloch@trivantisboca.com"
			},
			"Object": "Agent"
			},
			"Version": "1.0.0",
			"Objekt": {
			"Id": "http://www.uniqueurl.com/xAPI%20Template-Question_1_67_1415160320014",
			"Definition": {
			"Beschreibung": {
			"En-US": "My Test Frage 1"
			},
			"Type": "http://adlnet.gov/expapi/activities/cmi.interaction",
			„Interaction“: „Richtig-Falsch“,
			"CorrectResponsesPattern": [
			"wahr"
			]
			},
			„Object“: „Aktivität“
			}
			}

Benutzerdefinierte xapi Statement von xapi Statement Aktion

2014-11-05T04: 05: 34,803
			Joe King schickte 'Custom-XAPI-Statement'
			{
			"Id": "6a108ff9-1bcc-4bb0-9021-732fb7bad775",
			"Schauspieler": {
			"Name": "Joe King",
			"Konto": {
			"Homepage": "http://cloud.scorm.com/",
			"Name": "ZUASCUHYVJ|wieloch@trivantisboca.com"
			},
			"Object": "Agent"
			},
			"Verb": {
			"Id": "http://adlnet.gov/expapi/verbs/sent",
			"Anzeige": {
			"En-US": "sent"
			}
			},
			"Führen": {},
			"Kontext": {
			"Registrierung": "61d426da-436a-4b2a-8daa-ce94f6082f2f",
			"ContextActivities": {
			"Gruppierung": [
			{
			"Id": "http://www.uniqueurl.com/xAPI%20Template",
			„Object“: „Aktivität“
			}
			],
			"Eltern": [
			{
			"Id": "http://www.uniqueurl.com/xAPI%20Template",
			„Object“: „Aktivität“
			}
			]
			}
			},
			"Zeitstempel": "2014-11-05T04: 05: 32.376Z",
			"Gespeichert": "2014-11-05T04: 05: 34.803Z",
			"Behörde": {
			"Name": "Joe King",
			"Konto": {
			"Homepage": "http://cloud.scorm.com/",
			"Name": "ZUASCUHYVJ|wieloch@trivantisboca.com"
			},
			"Object": "Agent"
			},
			"Version": "1.0.0",
			"Objekt": {
			"Id": "http://www.uniqueurl.com/xAPI%20Template/Custom-xAPI-Statement",
			"Definition": {
			"Name": {
			"En-US": "Custom-XAPI-Statement"
			}
			},
			„Object“: „Aktivität“
			}
		}

Bestanden / Compld / Fehlgeschlagen Course Statement (auto)

2014-11-05T04: 05: 36,259
			Joe King bestanden 'http://www.uniqueurl.com/xAPI%20Template' mit Punktzahl 50
			{
			"Id": "6e8c000e-47d0-4b8c-842b-d9573422ce1b",
			"Schauspieler": {
			"Name": "Joe King",
			"Konto": {
			"Homepage": "http://cloud.scorm.com/",
			"Name": 
			"ZUASCUHYVJ|wieloch@trivantisboca.com"
			},
			"Object": "Agent"
			},
			"Verb": {
			"Id": "http://adlnet.gov/expapi/verbs/passed",
			"Anzeige": {
			"En-US": "bestanden"
			}
			},
			"Führen": {
			"Ergebnis": {
			"Raw": 50,
			"Min": 0,
			"Max": 100
			},
			"Erfolg": true,
			"Vollendung": true,
			"Dauer": "PT25.97S"
			},
			"Kontext": {
			"Registrierung": "61d426da-436a-4b2a-8daa-ce94f6082f2f",
			"ContextActivities": {
			"Gruppierung": [
			{
			"Id": "http://www.uniqueurl.com/xAPI%20Template",
			„Object“: „Aktivität“
			}
			]
			}
			},
			"Zeitstempel": "2014-11-05T04: 05: 33.714Z",
			"Gespeichert": "2014-11-05T04: 05: 36.259Z",
			"Behörde": {
			"Name": "Joe King",
			"Konto": {
			"Homepage": "http://cloud.scorm.com/",
			"Name": "ZUASCUHYVJ|wieloch@trivantisboca.com"
			},
			"Object": "Agent"
			},
			"Version": "1.0.0",
			"Objekt": {
			"Id": "http://www.uniqueurl.com/xAPI%20Template",
			„Object“: „Aktivität“
			}
			}