El servicio consultar_usuarios_con_avances() retorna los usuarios con el detalle de los grupos donde se registra avance.


Declaración:

consultar_usuarios_con_avances ( id_usuario As string , id_grupo As string , perfil As string , tipo_grupo As integer , fecha_desde As dateTime , fecha_hasta As dateTime ) As Usuario



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

Si se desea utilizar el filtro el usuario debe contener entre 3 y 30 caracteres. Sólo se pueden incluir letras minúsculas, números y/o '.', '_', '@', '-'. No se pueden usar mayúsculas, acentos ni caracteres, como por ejemplo: #, ! , *, ? , etc.)


Id_grupo

Opcional.
Filtra por usuarios que pertenezcan a dicho id_grupo

Si se desea utilizar el filtro debe ser cualquier numero entero positivo (1,2,3,…)


perfil

Opcional.
Filtra por el perfil de usuario en el grupo (administrador, alumno, profesor, invitado, etc...) del usuario.


Valores posibles

  • “A” Alumno
  • “I” Invitado
  • “P” Profesor
  • “D” Directivo
  • “M” Ayudante
  • “X” Coordinador
  • “” Para no utilizar este filtro

fecha_desde

Opcional

Obtiene solo el avance en los usuarios que hayan interactuado con el curso desde la fecha especificada.

fecha_hasta

Opcional

Obtiene solo el avance en los usuarios que hayan interactuado con el curso hasta la fecha especificada. En caso de no estar determinado se toma la fecha actual.

Nota: el parámetro tipo_grupo no es necesario y no debería utilizarse a partir de la versión 9. Si ya existe deberá siempre enviar el valor “7”. Si esto no se cumple se devolverá el error TipoGrupoInvalido.


Excepciones:

Educativa::Aula::Error::UsuarioInexistente

Esta excepción se lanza cuando el usuario indicado en el parámetro no existe

Educativa::Aula::Error::GrupoInexistente

Ocurre cuando el parámetro id_grupo esta establecido pero el grupo es inexistente.

Educativa::Aula::Error::TipoGrupoInvalido

Ocurre si se especifica el parámetro tipo_grupo es distinto de los valores permitidos

Educativa::Aula::Error::PerfilUsuarioInvalido

Si el parámetro perfil es distinto de los valores permitidos


Devuelve:

# Educativa::SOAP::Elements::consultar_usuarios_response

{

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

    [

       {

         # Educativa::SOAP::Types::Usuario

         administrador_usuario =>  $some_value, # boolean

         id_usuario =>  $some_value, # string

         nombre =>  $some_value, # string

         apellido =>  $some_value, # string

         clave =>  $some_value, # string

         codigo_postal =>  $some_value, # string

         dato_adicional_1 =>  $some_value, # string

         dato_adicional_2 =>  $some_value, # string

         dato_adicional_3 =>  $some_value, # string

         direccion =>  $some_value, # string

         email =>  $some_value, # string

         id_idioma =>  $some_value, # int

         localidad =>  $some_value, # string

         telefono =>  $some_value, # string

         url =>  $some_value, # string

         grupos => # Array of Educativa::SOAP::Types::UsuarioGrupo

             [

                 {

                   # Educativa::SOAP::Types::UsuarioGrupo

                   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

                   dato_adicional =>  $some_value, # string

                   avance => $some_value, # float

                 },

             ]

         },

      ]

 }


SOAP Request

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

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

  <soapenv:Header/>

  <soapenv:Body>

     <aula:consultar_usuarios_con_avance>

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

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

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

        <aula:fecha_desde>?</aula:fecha_desde>

        <aula:fecha_hasta>?</aula:fecha_hasta>

     </aula:consultar_usuarios_con_avance >

  </soapenv:Body>