Asignar Usuario Grupo

asignar_usuario_grupo (id_usuario as String , usuario_grupo as UsuarioGrupoAlta)

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á "-".
  • 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>
    </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".
  • 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.