Consultar tiempo estimado de uso aula

consultar_tiempo_estimado_uso_aula (id_curso as Integer, (opcional) perfil as String, (opcional) fecha_inicio as Date, (opcional) fecha_fin as Date )

El método nos permite obtener el tiempo estimado de uso de todos los usuarios de un curso particular de la plataforma, opcionalmente filtrado perfil y por un período de tiempo dado. Adicionalmente nos muestra la fecha de primer y última interacción, y la cantidad total de interacciones de cada usuario en el curso en cuestión, en el período de tiempo indicado.

Devuelve: 0{username + id_curso + tiempo_estimado_uso + fecha_primer_interaccion + fecha_ultima_interaccion + cantidad_interacciones}n


Funcionamiento

  • Para obtener el tiempo estimado de uso de los usuarios de un curso debemos especificar el parámetro id_curso.
  • Si se quiere obtener los usuarios de un perfil en particular se debe pasar el parámetro perfil (Valores posibles: A, P, I, M, D, X).
  • Si queremos obtenerlo para un rango de fechas especifico, además de especificar los parámetros anteriores, debemos indicar los parámetros correspondientes a fechas. Existen 3 opciones: solo fecha_inicio, solo fecha_fin o bien, fecha_inicio y fecha_fin.
  • Se Restringe el periodo a lo establecido en el parámetro rango_meses_log_acciones.
    • La fecha mínima se calcula como la fecha más reciente entre el primero de mes de rango_meses_log_acciones meses atrás y el primero de mes correspondiente al primer registro existente en las tablas de log_acciones.
    • Si no ingresamos fecha_inicio se utiliza la fecha mínima calculada
    • Si la fecha_inicio ingresada es menor a la fecha mínima calculada se informa el error.
  • Formato de fechas a ingresar: aaaa-mm-dd
  • El tiempo máximo entre clics utilizado para calcular el Tiempo Estimado de Uso se toma del parámetro: tiempo_entre_clicks (por defecto son 15 minutos).
  • Formato del tiempo estimado de uso: horas:minutos.
  • Formato de las fechas de primer y última interacción: aaaa-mm-dd hh:mm:ss.
  • Las fechas se manejan en el timezone de la plataforma.



Ejemplo de Respuesta

Ejemplo de respuesta de la llamada consultar_tiempo_estimado_uso_aula, pasando los parámetros opcionales perfil, fecha_inicio y fecha_fin.


  • Llamada:

     <aula:consultar_tiempo_estimado_uso_aula>
        <aula:id_curso>32</aula:id_curso>
        <aula:perfil>A</aula:perfil>
        <aula:fecha_inicio>2025-01-01</aula:fecha_inicio>
        <aula:fecha_fin>2025-06-15</aula:fecha_fin>
     </aula:consultar_tiempo_estimado_uso_aula>

En esta llamada, podemos observar que se solicita consultar el tiempo estimado de uso para el 'id_curso'= "32", para usuarios con perfil 'A', entre las fechas 2018-05-01 y 2019-01-15. La respuesta indica el tiempo estimado de uso de los usuarios del curso, con perfil A, en el grupo indicado, en el lapso de tiempo indicado.


  • Respuesta:

 <consultar_tiempo_estimado_uso_aula_response xmlns="urn:Educativa/Aula/">
       <tiempo_est_uso>
           <username>alumno</username>
           <id_curso>32</id_curso>
           <tiempo_estimado_uso>00:00</tiempo_estimado_uso>
           <fecha_primer_interaccion/>
           <fecha_ultima_interaccion/>
           <cantidad_interacciones>0</cantidad_interacciones>
        </tiempo_est_uso>
      <tiempo_est_uso>
           <username>alumno2</username>
           <id_curso>32</id_curso>
           <tiempo_estimado_uso>03:15</tiempo_estimado_uso>
           <fecha_primer_interaccion>2025-05-12 12:10:57</fecha_primer_interaccion>
           <fecha_ultima_interaccion>2025-06-14 15:10:55</fecha_ultima_interaccion>
           <cantidad_interacciones>35</cantidad_interacciones>
        </tiempo_est_uso>
        ...
 </consultar_tiempo_estimado_uso_aula_response>


Errores de validación

  • Educativa::Aula::Error::IdGrupoInvalido - ocurre cuando el 'id_curso' ingresado no es integer.
  • Educativa::Aula::Error::GrupoInexistente - ocurre cuando el 'id_curso' ingresado no existe en la plataforma.
  • Educativa::Aula::Error::FechaFormatoInvalido - al ingresar una fecha con un formato distinto a aaaa-mm-dd.
  • Educativa::Aula::Error::PerfilInvalido - ocurre al ingresar un perfil inválido
  • Educativa::Aula::Error::FechaFormatoInvalido - al ingresar una fecha con un formato distinto a aaaa-mm-dd.
  • Educativa::Aula::Error::FechaInvalida - al ingresar una fecha no existente, ej: no existe dicho día para ese mes.
  • Educativa::Aula::Error::RangoFechaInvalido - cuando la fecha de finalización es anterior a la fecha de inicio.
  • Educativa::Aula::Error::FechaInicioInvalida - cuando la 'fecha_inicio' ingresada es menor a la fecha mínima calculada.
  • Educativa::Aula::Error::FechaFueraDeRango - cuando la 'fecha_inicio' ingresada es mayor a la fecha actual.