Declaración:

obtener_avance_usuarios_grupos ( array [string id_usuario, integer id_grupo] )


Retorna una lista de objetos con la informacion del avance de cada usuario en un grupo que maneja avance.

Como parámetros de entrada se recibe una lista de duplas id_usuario/id_grupo

El avance del usuario es un valor numérico con decimales (float) entre 0 y 100. El avance igual a 100 determina que el usuario ya finalizo el curso.


Parámetros:

id_usuario

Requerido .

id_grupo

Requerido. Filtra por usuarios que pertenezcan a dichos id_grupo


Excepciones:

Educativa::Aula::Error::GrupoInexistente

Esta excepción ocurre cuando se intenta obtener un grupo que no existe en la base de datos.

Educativa::Aula::Error::GrupoSinAvance

Esta excepción ocurre cuando el grupo no posee grado de avance sobre los usuarios del mismo.


Devuelve:

El método retorna por cada dupla recibida una estructura como la siguiente:

{

usuarios => # Array of Educativa::SOAP::Types::Aula::AvanceUsuariosGrupos

{

  id_usuario => string  id_usuario,

  id_grupo   => integer id_grupo,

  avance     => float   avance calculado en el grupo, # Solo si no ocurre un error

  error      => { # Solo si ocurre un error

    error_code   => string codigo del error ocurrido

    error_string => string descripcion del error ocurrido

  }

}

},


SOAP Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"

   xmlns:aula="urn:Educativa/Aula/">

  <soapenv:Header/>

  <soapenv:Body>

     <aula:obtener_avance_usuarios_grupos>

     <!--1 or more repetitions:-->

       <aula:usuario_grupo>

         <aula:id_usuario>alumno</aula:id_usuario>

         <aula:id_grupo>1</aula:id_grupo>

       </aula:usuario_grupo>

       <aula:usuario_grupo>

         <aula:id_usuario>alumno</aula:id_usuario>

         <aula:id_grupo>18</aula:id_grupo>

       </aula:usuario_grupo>

     </aula:obtener_avance_usuarios_grupos>

  </soapenv:Body>

</soapenv:Envelope>