Wat dit API-eindpunt doet

De Import Course Completion API biedt verschillende informatie, afhankelijk van of het een Articulate 360-cursus is of een geïmporteerde inhoudscursus van derden. Voor alle cursussen kunnen beheerders zien wanneer gebruikers zijn ingeschreven voor de cursus. De cursus wordt toegevoegd aan de bibliotheken van de cursisten en als voltooid gemarkeerd. Wanneer het wordt gestart, begint het vanaf het begin. Geïmporteerde cursussen bevatten geen rapportagegegevens op vraagniveau.

Cursussen van derden geven geen quizscore weer wanneer ze worden geïmporteerd. Dit kan ertoe leiden dat een cursus als voltooid wordt aangemerkt met een onvoldoende score, zelfs als de quiz een voltooiingsvereiste is. Als je de quiz doet nadat de voltooiing is geïmporteerd, wordt een nieuwe score van de quiz geregistreerd.

Wanneer een Articulate 360-cursus wordt geïmporteerd en er een quizvereiste is, wordt deze ingesteld op een score van 100% die wordt weergegeven in de bibliotheek van de cursist. Leerlingen zien de resultatenpagina van de quiz wanneer ze de quiz bekijken en kunnen, indien toegestaan, de quiz opnieuw doen. Hun poging wordt geregistreerd in het Activiteitenrapport met een nieuwe quizscore, maar de status van de cursus en de 100% quizscore blijven behouden.

• Eindpunten
• Voltooiingsgegevens importeren

Eindpunten

• POST /courses/{courseId}/users/{userId}/completions- importeer voltooiingsgegevens voor een enkele cursus/gebruikerspaar in Rise.

Voltooiingsgegevens importeren

POST /courses/{courseId}/users/{userId}/completions

Opmerkingen:

• Het voltooiingsrecord is gekoppeld aan de huidige gepubliceerde versie van de cursus
• De datumparameters worden weergegeven in de kolommen Duur van verschillende rapporten (d.w.z. de duur van een geïmporteerde voltooiing wordt berekend als het verschil tussen startedAt encompletedAt). Het kan tot 5 minuten duren voordat de rapportweergaven binnen Reach 360 zijn vernieuwd.
• Meerdere aanroepen naar dit eindpunt met hetzelfde courseId en userId overschrijven de datumparameters die in eerdere aanroepen zijn gegeven (dit eindpunt zal dus slechts één voltooiingsrecord aanmaken voor een bepaalde cursus en gebruikerspaar, ongeacht hoe vaak de cursus is aangeroepen)
• De gebruiker hoeft voorafgaand aan de aanvraag niet ingeschreven te zijn voor de cursus. In dat geval wordt een nieuwe inschrijving voor cursisten aangemaakt. Als ze echter zijn ingeschreven, wordt de bestaande inschrijving gebruikt.

Parameters aanvragen (JSON)

• completedAt(ISO 8601-datum, vereist) - wanneer de gebruiker de cursus heeft voltooid
• startedAt(ISO 8601-datum, vereist) - wanneer de gebruiker met de cursus is begonnen

Reactie op succes

202 „Geaccepteerd”

Endpoint-specifieke foutcodes:

• course_not_found
• course_not_published
• user_not_found