Asignar Usuario Grupo

asignar_usuario_grupo (id_usuario as String , usuario_grupo as UsuarioGrupoAlta , (opcional) enviar_aviso as Boolean)

usuario_grupo as UsuarioGrupoAlta= id_grupo as Integer, administrador_grupo as String, estado as Boolean, perfil as String

El método asigna un usuario a un grupo en particular con las características especificadas.

Devuelve: [1|error]


Funcionamiento

  • Si queremos asignar un usuario a un grupo, debemos correr el WS para ese 'id_usuario', especificando además, los siguientes parámetros: 'id_grupo', 'perfil', 'estado', 'administrador_grupo'.
  • Los parámetros 'perfil', 'estado' y 'administrador_grupo' son opcionales, si no se especifican se les asignan los siguientes valores por defecto:
    • 'perfil' se seteará "A".
    • 'estado' se seteará "A".
    • 'administrador_grupo' se seteará "-".
  • Si se desea notificar por mail al usuario inscripto debemos asignar en "1" el campo opcional 'enviar_aviso'.
  • El usuario ya debe pertenecer a la plataforma, no puede ser un usuario nuevo.


Ejemplo de Respuesta

Ejemplo de respuesta de la llamada asignar_usuario_grupo con un usuario y un grupo al cual asignarlo, que indica agregar el usuario al grupo especificado:


  • Llamada:

      <aula:asignar_usuario_grupo>
        <aula:id_usuario>john_cale</aula:id_usuario>
        <aula:usuario_grupo>
           <aula:administrador_grupo>1</aula:administrador_grupo>
           <aula:estado>1</aula:estado>
           <aula:id_grupo>152</aula:id_grupo>
           <aula:perfil>A</aula:perfil>
        </aula:usuario_grupo>
        <!--Optional:-->
        <aula:enviar_aviso>1</aula:enviar_aviso>
     </aula:asignar_usuario_grupo>


  • En esta llamada, podemos observar que se solicita asignar el usuario john_cale, al grupo con 'id_grupo'= "152", y con las siguientes características en relación a la pertenencia al grupo:
    • 'perfil'= "A", indica que el usuario es Alumno para este grupo, se guarda en la base 'categoría_usuario' = "A".
    • 'estado'= "1", indica que el usuario esta activo para este grupo, se guarda en la base 'estado_usuario'= "A".
    • 'administrador_grupo'= "1", indica que el usuario es administrador del grupo, se guardara en la base 'administrador_curso'= "X".
    • 'enviar_aviso' = "1", indica que se quiere notificar por mail al usuario en que aula se inscribió.


  • Respuesta:


 <asignar_usuario_grupo_response xmlns="urn:Educativa/Aula/">
        <estado>1</estado>
     </asignar_usuario_grupo_response>


Errores de validación

  • Educativa::Aula::Error::IdUsuarioInvalido - ocurre cuando la identificación del usuario contiene caracteres inválidos.
  • Educativa::Aula::Error::UsuarioInexistente - ocurre cuando el usuario no existe en la plataforma.
  • Educativa::Aula::Error::UsuarioExistenteEnGrupo - ocurre cuando el usuario ya se encuentra registrado en el grupo.
  • Educativa::Aula::Error::GrupoInexistente - ocurre cuando se intenta obtener un grupo que 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.