Cosa fa questo endpoint API

L'API Import Course Completion fornisce informazioni diverse, a seconda che si tratti di un corso Articulate 360 o di un corso con contenuti importati da terze parti. Per tutti i corsi, gli amministratori vedranno quando gli utenti erano iscritti al corso. Il corso verrà aggiunto alle biblioteche degli studenti e contrassegnato come completato. Una volta lanciato, inizia dall'inizio. I corsi importati non includono dati di reporting a livello di domanda.

I corsi di terze parti non mostreranno il punteggio del quiz a scelta multipla quando vengono importati. Ciò potrebbe comportare che un corso venga contrassegnato come completo con un punteggio negativo, anche se il quiz a scelta multipla è un requisito per il completamento. L'esecuzione del quiz dopo l'importazione del completamento registrerà un nuovo punteggio del quiz.

Quando vengono importati i completamenti del corso Articulate 360, se è richiesto un quiz a scelta multipla, verrà impostato un punteggio del 100% che verrà riportato nella libreria dello studente. Gli studenti visualizzano la pagina dei risultati del quiz durante la visualizzazione del quiz e, se consentito, possono ripetere il quiz. Il loro tentativo viene registrato nel rapporto Attività con un nuovo punteggio del quiz, ma lo stato del corso e il punteggio del quiz del 100% rimangono invariati.

• Endpoint
• Importa dati di completamento

Endpoint

• POST /courses/{courseId}/users/{userId}/completions- importa i dati di completamento per una singola coppia corso/utente in Rise.

Importa i dati di completamento

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

Note:

• Il record di completamento è associato alla versione corrente pubblicata del corso.
• I parametri relativi alla data si riflettono nelle colonne Durata di vari report (ad esempio, la durata di un completamento importato viene calcolata come differenza tra startedAt ecompletedAt). L'aggiornamento delle visualizzazioni dei report in Reach 360 può richiedere fino a 5 minuti.
• Più chiamate a questo endpoint con lo stesso ID courseId userId sostituiranno i parametri di data forniti nelle chiamate precedenti (ad esempio, questo endpoint creerà un solo record di completamento per un determinato corso e una coppia di utenti indipendentemente dal numero di volte in cui viene chiamato)
• L'utente non deve essere iscritto al corso prima della richiesta. In tal caso, viene creata una nuova iscrizione per allievo. Se sono iscritti, tuttavia, viene utilizzata l'iscrizione esistente.

Parametri di richiesta (JSON)

• completedAt(data ISO 8601, obbligatoria) - quando l'utente ha completato il corso
• startedAt(data ISO 8601, obbligatoria) - quando l'utente ha iniziato il corso

Risposta di successo

202 «Accettato»

Codici di errore specifici dell'endpoint:

• course_not_found
• course_not_published
• user_not_found