Consultar notas de calificaciones

obtener_notas_calificaciones ( (opcional) id_grupo as Integer, (opcional) id_categoria_calificacion as Integer, (opcional) id_calificacion as Integer, (opcional) tipo_calificacion as String, (opcional) id_usuario as String)

El método obtiene el listado de notas para cada usuario pertenecientes a las calificaciones que resultan de los filtros aplicados mediante los parámetros de entrada especificados.

Devuelve el listado de notas de cada usuario con el siguiente formato: 0{id_categoria + nombre + descripcion + estado + (id_modulo) + id_grupo + 0{id_calificacion + nombre + (descripcion) + id_docente + fecha + rango_usuarios + tipo_calificacion +([id_evaluacion | id_actividad | id_tema]) + 0{id_nota + id_usuario + fecha +(nota) + (detalles) + (observaciones)}n}n}n


Funcionamiento

  • La respuesta del WS se divide en tres bloques, cada uno contenido en el anterior: categoría de calificaciones, calificaciones y notas.
    • Podemos llegar a obtener solo el primero bloque como respuesta, si hay coincidencias en la categoría de calificaciones y/o grupo, pero no existen calificaciones asociadas.
    • Podemos llegar a obtener los dos primeros bloques, si hay coincidencias en la categoría de calificaciones y/o grupo y/o calificaciones y/o tipo de calificación, pero no existen notas asociadas.
    • Si hay coincidencias en el 'id_usuario' ingresado, indefectiblemente la respuesta contendrá notas.
  • Detalles en las respuestas (en todas se supone coincidencias en el parámetro indicado):
    • Si no se especifica parámetro alguno: el método retorna las notas de cada usuario para todas las calificaciones existentes en la plataforma.
    • Si sólo se especifica el 'id_grupo': el método retorna las notas de cada usuario agrupadas para cada calificación contenida en cada categoría de calificaciones del grupo especificado.
    • Si sólo se especifica el 'id_categoria_calificacion': el método retorna las notas de cada usuario para cada calificación contenida en la categoría de calificaciones especificada.
    • Si sólo se especifica el 'id_calificacion': el método retorna las notas de cada usuario para la calificación especificada.
    • Si sólo se especifica el 'tipo_calificacion': el método retorna las notas de cada usuario agrupadas para cada calificación del tipo especificado contenida en cada categoría de calificaciones existente.
      • 'tipo_calificacion': puede tomar los valores MANUAL, ACTIVIDAD, TEMA o AUTOEVALUACION.
    • Si solo se especifica el 'id_usuario': devuelve todas las notas para ese usuario existentes en la plataforma.
  • Filtros conjuntos permitidos: todos los parámetros pueden ser combinados.
    • En el caso de que la combinación de parámetros no produzca resultados, la respuesta será vacía.
    • Tener en cuenta que hay ciertas combinaciones que pueden llegar a ser inútiles, esto es en el caso de especificar atributos más específicos como 'id_calificación' en conjunto con atributos como 'id_grupo' o 'id_categoria_calificacion', en este caso el 'id_calificación' ya identificaría unívocamente a la calificación sin la necesidad de los demás parámetros, pero al haberlos especificados si no hay coincidencia entre los 3, el resultado será vacío.


Ejemplo de Respuesta

Ejemplo de respuesta de la llamada obtener_notas_calificaciones pasando 'id_grupo'="66", que solicita las notas de los usuarios para cada calificación dentro de las categorías de calificaciones en el grupo 66.


Llamada


<aula:obtener_notas_calificaciones> <aula:id_grupo>66</aula:id_grupo> <aula:id_categoria_calificacion></aula:id_categoria_calificacion> <aula:id_calificacion></aula:id_calificacion> <aula:tipo_calificacion></aula:tipo_calificacion> <aula:id_usuario></aula:id_usuario> </aula:obtener_notas_calificaciones>



Respuesta


<categorias>
   <id_categoria_calificacion>24</id_categoria_calificacion>
   <nombre>Categoría de Calificación Unidad 1</nombre>
   <descripcion>Evolución de Sistemas Informáticos</descripcion>
   <estado>true</estado>
   <id_modulo>1</id_modulo>
   <id_grupo>66</id_grupo>
   <calificaciones>
       <id_calificacion>18</id_calificacion>  
       <nombre>Sistemas de primera generación</nombre>
       <descripcion>Conocimientos de sistemas</descripcion>
       <id_docente>id_profesor</id_docente>
       <fecha>2010-05-18T08:20:57-03:00</fecha>      
       <rango_usuarios>GRUPO</rango_usuarios>
       <tipo_calificacion>AUTOEVALUACION</tipo_calificacion>
       <id_evaluacion>34</id_evaluacion>
           <notas>
               <id_nota>18</id_nota>  
               <id_usuario>alumno1</id_usuario>
               <fecha>2010-07-11T00:00:00</fecha>
               <nota>20/100</nota>
               <detalles></detalles>
               <observaciones></observaciones>
           </notas>
           <notas>
               <id_nota>99</id_nota>
               <id_usuario>alumno1</id_usuario>
               <fecha>2011-11-18T08:20:57-03:00</fecha>
               <nota>78/100</nota>
               <detalles/></detalles>
               <observaciones/></observaciones>
           </notas>
           <notas>
               <id_nota>50</id_nota>  
               <id_usuario>alumno2</id_usuario>
               <fecha>2010-08-11T11:00:00</fecha>
               <nota>90/100</nota>
               <detalles/></detalles>
               <observaciones/></observaciones>
           </notas>
   </calificaciones>
   <calificaciones>
       <id_calificacion>2800467</id_calificacion>
       <nombre>Composición sobre la vida</nombre>
       <descripcion/>
       <id_docente>lsilveira</id_docente>
       <fecha>2009-11-17T06:02:49-03:00</fecha>
       <rango_usuarios>GRUPO</rango_usuarios>
       <tipo_calificacion>ACTIVIDAD</tipo_calificacion>
       <id_actividad>59</id_actividad>
           <notas>
               <id_nota>52</id_nota>
               <id_usuario>lsilveira</id_usuario>
               <fecha>2009-11-17T06:02:49-03:00</fecha>
               <nota>Aprobada</nota>
               <detalles/></detalles>
               <observaciones/></observaciones>
           </notas>
   </calificaciones>
</categorias>


En esta respuesta, podemos observar que:

  • existe una sola categoría de calificaciones en el grupo 66, llamada "Categoría de Calificación Unidad 1". La misma corresponde al 'id_modulo' 1 (es decir a la unidad 1).
  • esta categoría contiene 2 calificaciones cuyo 'tipo_calificacion' nos indica que una está asociada a (es el resultado de) una evaluación con 'id_evaluacion' 34 y la otra está asociada a (es el resultado de) una actividad con 'id_actividad' 59
  • los usuarios que poseen notas en la primer calificación son alumno1 y alumno2. El alumno1 posee 2 notas, debido a que realizó 2 veces la evaluación: la que posee mayor fecha es la que se muestra en evaluaciones. Esto ocurre porque la realización de la evaluación asociada fue liberada la primera vez.
  • el usuario que posee nota en la segunda calificación es "lsilveira", aprobando la actividad.


Errores de validación

  • Educativa::Aula::Error::GrupoInexistente - ocurre cuando se intenta consultar las notas de un grupo no existente en la plataforma.
  • Educativa::Aula::Error::TipoCalificacionInvalida - cuando el 'tipo_calificacion' ingresado no es válido.