Consultar Usuarios Aprobados

consultar_usuarios_aprobados (id_grupo as Integer,  (opcional) finalizacion_fecha_desde as DateTime,  (opcional) finalizacion_fecha_hasta as DateTime)

El método permite obtener aquellos alumnos que finalizaron el cursado de un aula, así como también nos permite filtrar por aquellos alumnos que finalizaron el aula en un rango de fechas dado.

Devuelve: 0{id_grupo + id_usuario + fecha_finalización}


Funcionamiento

  • Si queremos consultar todos los alumnos que hayan finalizado el aula especificamos solamente el parámetro 'id_grupo'
  • Si queremos consultar solamente los alumnos que hayan finalizado el cursado de un aula en un rango de fechas dado, utilizamos los atributos 'finalizacion_fecha_desde' y 'finalizacion_fecha_hasta'.
  • Pueden especificarse los dos campos o solamente uno, según la necesidad.
  • El ws solamente considera como alumnos a usuarios con permiso 'cursa'.
  • Se considera alumnos aprobados a aquellos que tengan valor para el campo 'fecha_finalizacion' de la tabla usuarios.


Ejemplo de Respuesta

Ejemplo de respuesta de la llamada consultar_usuarios_aprobados, para un grupo específico hasta una fecha dada.


  • Llamada:

     <aula:consultar_usuarios_aprobados>
        <aula:id_grupo>64</aula:id_grupo>
        <aula:finalizacion_fecha_desde></aula:finalizacion_fecha_desde>
        <aula:finalizacion_fecha_hasta>2023-04-02</aula:finalizacion_fecha_hasta>
     </aula:consultar_usuarios_aprobados>

En esta llamada, podemos observar que: se solicita consultar los alumnos que finalizarón el aula con 'id_grupo'= "64" y antes de la fecha "2023-04-02".


  • Respuesta:

 <consultar_usuarios_aprobados_response xmlns="urn:Educativa/Aula/">
   <aula:usuario_grupo>
     <id_grupo>64</id_grupo>
     <id_usuario>alumno1</id_usuario>
     <fecha_finalización>2023-03-20</fecha_finalización>
   </aula:usuario_grupo>
   <aula:usuario_grupo>
     <id_grupo>64</id_grupo>
     <id_usuario>alumno2</id_usuario>
     <fecha_finalización>2023-02-17</fecha_finalización>
   </aula:usuario_grupo>
   <aula:usuario_grupo>
     <id_grupo>64</id_grupo>
     <id_usuario>alumno3</id_usuario>
     <fecha_finalización>2023-03-05</fecha_finalización>
   </aula:usuario_grupo>
 </consultar_usuarios_aprobados_response>


Errores de validación

  • Educativa::Aula::Error::IdGrupoInvalido - ocurre cuando el 'id_grupo' ingresado no es integer.
  • Educativa::Aula::Error::GrupoInexistente - ocurre cuando el grupo ingresado no existe en la base de datos.
  • Educativa::Aula::Error::UsuarioInexistenteEnGrupo 
  • Educativa::Aula::Error::FechaFormatoInvalido - cuando la fecha ingresada tiene un formato inválido debido a que no se están usando 'separadores válidos' (uno o más de estos: '-', ' ') entre los distintos valores que componen la fecha (año, mes, día)
  • Educativa::Aula::Error::FechaInvalida - al ingresar una fecha inválida o inexistente, debido a que:

- el año ingresado no es un número entero positivo de 4 dígitos, entre 1000 y 9999.

- el mes ingresado no esta entre 1 y 12. Se debe permitir el 0 a la izquierda en los números de 1 dígito.

- el día ingresado no esta entre 1 y 31. Se debe permitir el 0 a la izquierda en los números de 1 dígito.

- el día ingresado no pertenece al mes indicado. Ej: 2014-11-31, noviembre no tiene día 31.

  • Educativa::Aula::Error::RangoFechaInvalido - cuando la fecha de finalización es anterior a la fecha de inicio.