Modificar Usuario Grupo

modificar_usuario_grupo ( id_usuario as Integer, (opcional) administrador_grupo as String, (opcional) estado as String, id_grupo as Integer, perfil as String )

El método modifica los datos de un usuario relacionados con el grupo indicado, al que este usuario pertenece.

Devuelve: estado

Indica si el usuario fue creado correctamente o no.


Funcionamiento

  • Si queremos modificar los datos de un usuario referentes a su relación con el grupo, debemos especificar mínimamente valores para los siguientes campos obligatorios:
    • 'id_usuario': debe corresponder con un valor existente para 'id_usuario' en la tabla usuarios.
    • 'id_grupo': debe corresponder con un valor existente para 'id_curso' en la tabla cursos.
  • El campo 'perfil' debe corresponderse con un valor de 'IdCategoria' existente en la tabla perfiles_. Su envío es opcional, si no se setea un valor se conserva el valor que el campo contiene actualmente.
  • Los campos 'administrador_grupo' y 'estado' son de tipo booleano, por lo tanto deberían pasarse valores 0 o 1, o "true" o "false".
  • Si no se especifican valores para 'administrador_grupo' y/o 'estado', se setean los siguientes valores por defecto:
    • 'estado' se seteará "-".
    • 'administrador_grupo' se seteará "-".


Ejemplo de Respuesta

Ejemplo de respuesta de la llamada modificar_usuario_grupo con los datos a modificar en la relación usuario-grupo


  • Llamada:

    <aula:modificar_usuario_grupo>
        <aula:id_usuario>m_bunge</aula:id_usuario>
        <aula:usuario_grupo>
           <aula:administrador_grupo>true</aula:administrador_grupo>
           <aula:estado>0</aula:estado>
           <aula:id_grupo>25</aula:id_grupo>
           <aula:perfil>I</aula:perfil>
        </aula:usuario_grupo>
     </aula:modificar_usuario_grupo>


En esta llamada, podemos observar que: se solicita modificar los atributos para un usuario con 'id_usuario'= "m_bunge" en relación con el grupo con 'id_grupo'= "25".


  • Respuesta:

 <modificar_usuario_grupo_response xmlns="urn:Educativa/Aula/">
        <estado>1</estado>
     </modificar_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 se encuentra registrado en la plataforma.
  • Educativa::Aula::Error::UsuarioAnonimo - ocurre cuando el parámetro 'id_usuario' es el usuario _anonimo.
  • Educativa::Aula::Error::IdGrupoInvalido - ocurre cuando el 'id_grupo' ingresado no es integer.
  • Educativa::Aula::Error::GrupoInexistente - ocurre cuando el 'id_grupo' ingresado no existe en la plataforma.
  • Educativa::Aula::Error::UsuarioInexistenteEnGrupo - ocurre cuando se intenta modificar un usuario en un grupo en el que no existe.
  • Educativa::Aula::Error::PerfilUsuarioInvalido - ocurre cuando el perfil ingresado no corresponde a uno de los perfiles existentes en la plataforma.