Declaración:

obtener_avance_usuarios ( integer id_grupo, string perfil, string id_usuario, date fecha_desde, date fecha_hasta )


Retorna una lista de objetos con la información del avance del usuario en un grupo que maneja avance. Los parámetros de este método son iguales a consultar_usuarios_con_avances().

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.

Si el parámetro fecha_hasta no está definido pero sí lo está fecha_desde, el web service arrojará el avance computado hasta fecha_desde.

Por lo general es útil consultar avance solo para el perfil de usuario igual a A (Alumno). Esto reduce el tiempo de procesamiento y optimiza la consulta.


Parámetros:

id_usuario

Opcional.
Si se especifica obtiene solo un usuario y los parámetros id_grupo y perfil no se tendrán en cuenta

id_grupo

Requerido.
Filtra por usuarios que pertenezcan a dicho id_grupo

perfil

Opcional.
Filtra por usuarios que pertenezcan a dicho perfil

fecha_desde

Opcional.

Junto con el parametro fecha_hasta calculan el incremento de avance entre dichos rangos de fecha

fecha_hasta

Opcional.

Junto con el parametro fecha_desde calculan el incremento de avance entre dichos rangos de fecha.


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:

{

  usuarios => # Array of Educativa::SOAP::Types::UsuarioGrupoAvance

      [

          { # Educativa::SOAP::Types::UsuarioGrupoAvance

              administrador_grupo =>  $some_value, # boolean

              estado =>  $some_value, # boolean

              id_grupo =>  $some_value, # string

              perfil =>  $some_value, # string

              fecha_alta =>  $some_value, # date

              responsable_grupo =>  $some_value, # boolean

              avance =>  $some_value, # float

              dato_adicional =>  $some_value, # string

              id_usuario =>  $some_value, # string

          },

      ]

},


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>

        <aula:id_grupo>?</aula:id_grupo>

        <aula:perfil>?</aula:perfil>

        <aula:id_usuario>?</aula:id_usuario>

     </aula:obtener_avance_usuarios>

  </soapenv:Body>

</soapenv:Envelope>