Obtener categorías de calificaciones

obtener_categorias_calificacion_grupo (id_grupo as Integer, (opcional) id_modulo as Integer )

El método obtiene el listado de categorías de calificación existentes en el grupo, opcionalmente se puede indicar el módulo de Programa(unidad) en particular.

Devuelve El listado de todas las categorías, con los siguientes atributos: 0{id_categoría + nombre + descripción + estado + (id_modulo) + id_grupo}n


Funcionamiento

  • Si queremos obtener las categorías pertenecientes a un grupo, solo se especifica el 'id_grupo': el método retorna para el grupo 'id_grupo' indicado el listado de categorías existentes con los datos definidos anteriormente.
  • Si se especifica adicionalmente el id_modulo: se considera únicamente el módulo con el 'id_módulo' indicado dentro del grupo 'id_grupo' indicado, y se muestra la categoría correspondiente con los datos definidos anteriormente.
  • El 'id_modulo' ingresado debe corresponder con el valor existente en el atributo 'relacion' de la tabla grupos_calificaciones.


Ejemplo de Respuesta

Ejemplo de respuesta de la llamada obtener_categorias_calificacion_grupo, pasando como parámetro solamente el 'id_grupo'


  • Llamada:

  <aula:obtener_categorias_calificacion_grupo>
       <aula:id_grupo>16</aula:id_grupo>
       <aula:id_modulo></aula:id_modulo>
    </aula:obtener_categorias_calificacion_grupo>

En esta llamada, podemos observar que se solicita consultar las categorías de calificaciones definidas para el grupo con 'id_grupo'= 16.


  • Respuesta:

obtener_categorias_calificacion_grupo_response xmlns="urn:Educativa/Aula/">
       <categorias>
          <id_categoria>25</id_categoria>
          <nombre>PLATAFORMA</nombre>
          <descripcion>Calificaciones de PLATAFORMA</descripcion>
          <estado>true</estado>
          <id_modulo>25</id_modulo>
          <id_grupo>16</id_grupo>
       </categorias>
       <categorias>
          <id_categoria>26</id_categoria>
          <nombre>Redes Sociales</nombre>
          <descripcion>Calificaciones de Redes Sociales</descripcion>
          <estado>true</estado>
          <id_modulo>26</id_modulo>
          <id_grupo>16</id_grupo>
       </categorias>
       <categorias>
          <id_categoria>1166</id_categoria>
          <nombre>privada test</nombre>
          <descripcion>privada test</descripcion>
          <estado>true</estado>
          <id_grupo>1</id_grupo>
       </categorias>
</obtener_categorias_calificacion_grupo_response>

En la respuesta observamos que devuelve dos categorías de tipo UM (25 y 26) de las cuales se especifica el módulo correspondiente, y una categoría de tipo PR (1166).


Errores de validación

  • Educativa::Error::MissingParameter - No se especifico 'id_grupo'
  • Educativa::Aula::Error::IdGrupoInvalido - El 'id_grupo' ingresado no es integer o es superior al numero mayor permitido.
  • Educativa::Aula::Error::GrupoInexistente - Cuando el 'id_grupo' ingresado es inexistente.
  • Educativa::Aula::Error::IdModuloInvalido - El 'id_modulo' ingresado no es integer.
  • Educativa::Aula::Error::IdModuloInexistente - El 'id_modulo' ingresado no existe o no esta relacionado con el 'id_grupo' especificado.