Consultar Usuarios con Avances

consultar_usuarios_con_avances ( (opcional) id_usuario as String , (opcional) id_grupo as Integer , (opcional) perfil as String , (opcional) tipo_grupo as Integer, (opcional) fecha_desde as DateTime, (opcional)fecha_hasta as DateTime)

El método nos permite consultar el avance general sobre un grupo para un usuario, así como también nos brinda la posibilidad de obtener estos avances para todos los usuarios que resulten de la aplicación de los distintos filtros.

Devuelve: 0{administrador_usuario + id_usuario + nombre + apellido + clave + codigo_postal + email + id_idioma + 1{administrador_grupo + estado + id_grupo + perfil + fecha_alta + responsable_grupo + avance}n}n


Funcionamiento

  • No hay campos obligatorios.
  • El único tipo de grupo existente es 'A Distancia' (7)
  • El avance del usuario es un valor numerico entre 0 y 100. El avance igual a 100 determina que el usuario ya finalizo el curso.
    • Para el caso de que el aula no registre avance se retorna 100 .
    • En las aulas sin unidades retorna un avance de 0.
  • Al correr el método, básicamente obtenemos información del usuario, e información de cada usuario relacionada con sus grupo.
  • La información obtenida por el WS se divide en dos bloques: información del usuario e información del usuario en relación con el grupo.
    • Cada bloque perteneciente a un usuario contiene n bloques correspondientes a la relación de ese usuario con cada uno de los grupos a los que pertenece.
    • Información del bloque perteneciente al usuario: administrador_usuario, id_usuario, nombre, apellido, clave, codigo_postal, email, id_idioma.
    • Información del bloque perteneciente a la relación entre el usuario y el grupo: administrador_grupo, estado, id_grupo, perfil, fecha_alta, responsable_grupo, avance.


Ejemplo de Respuesta

Ejemplo de respuesta de la llamada consultar_usuarios_con_avances que indica consultar el avance para un usuario específico, en los grupos con un tipo de grupo específico.


  • Llamada:

    <aula:consultar_usuarios_con_avances>
       <aula:id_usuario>alumno</aula:id_usuario>
       <aula:id_grupo></aula:id_grupo>
       <aula:perfil></aula:perfil>
       <aula:tipo_grupo>07</aula:tipo_grupo>
       <aula:fecha_desde></aula:fecha_desde>
       <aula:fecha_hasta></aula:fecha_hasta>
    </aula:consultar_usuarios_con_avances>


En esta llamada, podemos observar que: se solicita consultar el avance para un usuario con 'id_usuario'= "alumno" en los grupos con 'tipo_grupo'= "07" (a distancia).


  • Respuesta:

<consultar_usuarios_con_avances_response xmlns="urn:Educativa/Aula/">
       <usuarios>
          <administrador_usuario>false</administrador_usuario>
          <id_usuario>alumno</id_usuario>
          <nombre>Alumno</nombre>
          <apellido>Demo</apellido>
          <clave>50a5e55df99aaab0adafa7e3d59db4f094ce1435889f003109fa93098d3c14d8</clave>
          <codigo_postal>Alumno</codigo_postal>
          <email>mvideguren@e-ducativa.x</email>
          <id_idioma>1</id_idioma>
          <grupos>
             <administrador_grupo>false</administrador_grupo>
             <estado>true</estado>
             <id_grupo>1</id_grupo>
             <perfil>A</perfil>
             <fecha_alta>2011-05-25</fecha_alta>
             <responsable_grupo>false</responsable_grupo>
             <avance>0</avance>
          </grupos>
          <grupos>
             <administrador_grupo>false</administrador_grupo>
             <estado>true</estado>
             <id_grupo>6</id_grupo>
             <perfil>A</perfil>
             <fecha_alta>2013-12-03</fecha_alta>
             <responsable_grupo>false</responsable_grupo>
             <avance>0</avance>
          </grupos>
          <grupos>
             <administrador_grupo>false</administrador_grupo>
             <estado>true</estado>
             <id_grupo>11</id_grupo>
             <perfil>A</perfil>
             <fecha_alta>2013-12-03</fecha_alta>
             <responsable_grupo>false</responsable_grupo>
             <avance>0</avance>
          </grupos>
          <grupos>
             <administrador_grupo>false</administrador_grupo>
             <estado>true</estado>
             <id_grupo>16</id_grupo>
             <perfil>A</perfil>
             <fecha_alta>2013-12-12</fecha_alta>
             <responsable_grupo>false</responsable_grupo>
             <avance>0</avance>
          </grupos>
          <grupos>
             <administrador_grupo>false</administrador_grupo>
             <estado>true</estado>
             <id_grupo>23</id_grupo>
             <perfil>A</perfil>
             <fecha_alta>2013-12-12</fecha_alta>
             <responsable_grupo>false</responsable_grupo>
             <avance>0</avance>
          </grupos>
        </usuarios>
   </consultar_usuarios_con_avances_response>


Errores de validación


Educativa::Aula::Error::IdUsuarioInvalido - cuando el 'id_usuario' ingresado contiene caracteres inválidos.


Educativa::Aula::Error::UsuarioInexistente - ocurre cuando el usuario no existe en la plataforma.


Educativa::Aula::Error::GrupoInexistente - ocurre cuando el grupo ingresado no existe en la base de datos.


Educativa::Aula::Error::PerfilUsuarioInvalido - ocurre cuando el perfil ingresado no corresponde a uno de los perfiles existentes en la plataforma.


Educativa::Aula::Error::FechaHoraFormatoInvalido - la fecha-hora ingresada tiene un formato inválido debido a que:

  • no se están usando 'separadores válidos' (uno o más de estos: '-', ' ', ':', 'T') entre los distintos valores que componen la fecha-hora (año, mes, día, hora, minutos, segundos)
  • no se esta ingresando alguno de los valores correspondientes a la fecha: año, mes, día.


Educativa::Aula::Error::FechaHoraInvalida

Al ingresar una fecha inválida o inexistente, debido a que:

  • el año ingresado no es un número entero positivo de 4 dígitos, entre 1000 y 9999.
  • el mes ingresado no esta entre 1 y 12. Se debe permitir el 0 a la izquierda en los números de 1 dígito.
  • el día ingresado no esta entre 1 y 31. Se debe permitir el 0 a la izquierda en los números de 1 dígito.
  • el día ingresado no pertenece al mes indicado. Ej: 2014-11-31, noviembre no tiene día 31.
  • la hora ingresada no esta entre 0 y 23. Se debe permitir el 0 a la izquierda en los números de 1 dígito.
  • los minutos ingresados no están entre 0 y 59. Se debe permitir el 0 a la izquierda en los números de 1 dígito.
  • los segundos ingresados no están entre 0 y 59. Se debe permitir el 0 a la izquierda en los números de 1 dígito.


Educativa::Aula::Error::RangoFechaHoraInvalido - cuando la fecha de finalización es anterior a la fecha de inicio.