Reach 360: API de importación para completar el curso

Artículo actualizado el

Este artículo se aplica a:

Qué hace este terminal de API

La API de finalización de cursos de importación proporciona información diferente, en función de si se trata de un curso de Articulate 360 o de un curso importado con contenido de terceros. En todos los cursos, los administradores verán cuándo se inscribieron los usuarios en el curso. El curso se añadirá a las bibliotecas de los alumnos y se marcará como completado. Cuando se lanza, comienza desde el principio. Los cursos importados no incluyen datos de informes a nivel de pregunta.

Los cursos de terceros no mostrarán la puntuación de un cuestionario cuando se importen. Esto podría provocar que un curso se marque como completado con una puntuación reprobatoria, incluso si el cuestionario es un requisito para completarlo. Al realizar la cuestionario después de importarla, se registrará una nueva puntuación de la cuestionario.

Cuando se importen los cursos completados en Articulate 360, si es obligatorio realizar un cuestionario, se establecerá en una puntuación del 100% que se reflejará en la biblioteca del alumno. Los alumnos ven la página de resultados del cuestionario cuando lo ven y, si está permitido, pueden volver a realizar el cuestionario. Su intento se registra en el informe de actividades con una nueva puntuación en la cuestionario, pero se mantienen el estado del curso y la puntuación del 100% de la cuestionario.

Puntos finales

  • POST /courses/{courseId}/users/{userId}/completions- importa los datos de finalización de un solo par de cursos y usuarios a Rise.

Importar datos de finalización

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

Notas:

  • El registro de finalización está asociado a la versión publicada actual del curso
  • Los parámetros de fecha se reflejan en las columnas Duración de varios informes (es decir, la duración de una finalización importada se calcula como la diferencia entrestartedAt ycompletedAt). Las vistas de los informes en Reach 360 pueden tardar hasta 5 minutos en actualizarse.
  • Varias llamadas a este punto final tienen lo mismocourseId yuserId anularán los parámetros de fecha proporcionados en las llamadas anteriores (es decir, este punto de conexión solo creará un único registro de finalización para una pareja determinada de cursos y usuarios, independientemente del número de veces que se llame)
  • El usuario no tiene que estar inscrito en el curso antes de la solicitud. En ese caso, se crea una nueva inscripción de alumnos. Sin embargo, si están inscritos, se utiliza la inscripción existente.

Parámetros de solicitud (JSON)

  • completedAt(fecha ISO 8601, obligatoria): cuando el usuario haya completado el curso
  • startedAt(fecha ISO 8601, obligatoria): cuando el usuario comenzó el curso

Respuesta de éxito

202 «Aceptado»

Códigos de error específicos de endpoints:

  • course_not_found
  • course_not_published
  • user_not_found