Eliminar Usuarios de Grupos

eliminar_usuarios_grupos (1{id_usuario as String , id_grupo as Integer}n)

El método debe eliminar usuarios de grupos (pudiendo discriminar QUE usuarios queremos borrar en QUE grupos específicos.), excepto que el usuario sea _anonimo, webmaster, responsable dentro del grupo, responsable de una evaluación y/o encargado en el manejo de emails del grupo. Este método también debe eliminar el contenido relacionado.

Devuelve: id_usuario + id_grupo + borrado

  • borrado = "true" si pudo eliminar al usuario: por cada tupla de datos que se pudo procesar correctamente.
  • borrado = "false" si no se pudo eliminar al usuario: por cada tupla de datos que no se pudo procesar correctamente. En este caso se muestra también el error correspondiente.


Funcionamiento

  • Si queremos eliminar un usuario de un grupo específico al que pertenece, debemos correr el WS pasandole como parámetros el 'id_usuario' de dicho usuario, junto con el 'id_grupo' del grupo en el que se quiere realizar la eliminación del usuario.
  • La estructura correspondiente(aula:usuario_grupo) debe ser repetida n veces según la cantidad de tuplas usuario-grupo que se quieran eliminar.
  • El usuario debe pertenecer al grupo del cual se requiere que sea eliminado.


Ejemplo de Respuesta

Ejemplo de respuesta de la llamada eliminar_usuarios_grupos que indica eliminar dos usuarios, cada uno en un grupo distinto.


  • Llamada:

<aula:eliminar_usuarios_grupos>
 <aula:usuario_grupo>
  <aula:id_usuario>alumno_3</aula:id_usuario>
  <aula:id_grupo>32</aula:id_grupo>
 </aula:usuario_grupo>
 <aula:usuario_grupo>
  <aula:id_usuario>alumno_2</aula:id_usuario>
  <aula:id_grupo>33</aula:id_grupo>
 </aula:usuario_grupo>
</aula:eliminar_usuarios_grupos>


En esta llamada, podemos observar que: se solicita eliminar un usuario con 'id_usuario'= "alumno_3" en el grupo con 'id_grupo'= "32", y un usuario con 'id_usuario'= "alumno_2" en el grupo con 'id_grupo'= "33"


  • Respuesta:

<eliminar_usuarios_grupos_response xmlns="urn:Educativa/Aula/">
        <usuario_grupo>
           <id_usuario>alumno_3</id_usuario>
           <id_grupo>32</id_grupo>
           <borrado>true</borrado>
        </usuario_grupo>
        <usuario_grupo>
           <id_usuario>alumno_2</id_usuario>
           <id_grupo>33</id_grupo>
           <borrado>true</borrado>
        </usuario_grupo>
     </eliminar_usuarios_grupos_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::UsuarioAnonimo - ocurre cuando el usuario que se intenta eliminar es el usuario _anonimo.
  • Educativa::Aula::Error::IdGrupoInvalido - El 'id_grupo' ingresado no es integer.
  • Educativa::Aula::Error::GrupoInexistente - ocurre cuando el grupo ingresado no existe en la base de datos.
  • Educativa::Aula::Error::UsuarioInexistenteEnGrupo - ocurre cuando se intenta eliminar un usuario en un grupo en el que no existe.
  • Educativa::Aula::Error::UsuarioNoSePuedeEliminar - el usuario no se puede eliminar debido a que es:
  • webmaster (campo 'administrador_usuario' en la tabla usuarios)
  • responsables dentro del grupo (campo 'responsable_curso' en la tabla usuarios)
  • responsables de una evaluación (campo 'id_usuario' en la tabla evaluaciones)
  • encargado en el manejo de emails del grupo (campo 'webmail_usuario' en la tabla usuarios)