Declaración:

asignar_usuarios_grupos (1{id_usuario As string , usuario_grupo As UsuarioGrupoAlta}n)

El método asigna usuarios a grupos con las características especificadas (pudiendo discriminar qué usuarios queremos asignar en qué grupos específicos).

Devuelve:

  • estado 'true' si asigna correctamente el usuario al grupo indicado: por cada tupla de datos que se pudo procesar correctamente.
  • estado 'false' si no pudo asignar correctamente el usuario al grupo indicado: por cada tupla de datos que no se pudo procesar correctamente. En este caso se muestra también el error correspondiente.


Parámetros:

id_usuario

Requerido.
Identificación del usuario

usuario_grupo

Requerido.
Objeto con la información del usuario en el grupo a asignar.


Excepciones:

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::IdGrupoInvalido

Ocurre cuando el "id_grupo" ingresado no es integer o es superior al número mayor permitido.

Educativa::Aula::Error::GrupoInexistente

Ocurre cuando se intenta obtener un grupo que no existe en la base de datos.

Educativa::Aula::Error::UsuarioExistenteEnGrupo

Ocurre cuando el usuario ya se encuentra registrado en el grupo.

Educativa::Aula::Error::PerfilUsuarioInvalido

Ocurre cuando el perfil ingresado no corresponde a uno de los perfiles existentes en la plataforma.


Ejemplo: se solicita asignar dos usuarios a dos grupos distintos.

SOAP Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"

   xmlns:aula="urn:Educativa/Aula/">

  <soapenv:Header/>

  <soapenv:Body>

<aula:asignar_usuarios_grupos>

       <aula:asignar_usuarios_grupos>

          <aula:id_usuario>aime</aula:id_usuario>

          <aula:usuario_grupo>

             <aula:id_grupo>21</aula:id_grupo>

             <aula:administrador_grupo>1</aula:administrador_grupo>

             <aula:estado>1</aula:estado>

             <aula:perfil>A</aula:perfil>

          </aula:usuario_grupo>

       </aula:asignar_usuarios_grupos>

       <aula:asignar_usuarios_grupos>

          <aula:id_usuario>bunge</aula:id_usuario>

          <aula:usuario_grupo>

             <aula:id_grupo>22</aula:id_grupo>

             <aula:administrador_grupo>1</aula:administrador_grupo>

             <aula:estado>1</aula:estado>

             <aula:perfil>A</aula:perfil>

          </aula:usuario_grupo>

       </aula:asignar_usuarios_grupos>

  </soapenv:Body>

</soapenv:Envelope>


Respuesta

<asignar_usuarios_grupos_response xmlns="urn:Educativa/Aula/">

       <usuario_grupo>

          <id_usuario>aime</id_usuario>

          <id_grupo>21</id_grupo>

          <estado>true</estado>

       </usuario_grupo>

       <usuario_grupo>

          <id_usuario>bunge</id_usuario>

          <id_grupo>22</id_grupo>

          <estado>false</estado>

          <error>

             <error_code>Educativa::Aula::Error::UsuarioInexistente</error_code>

             <error_string>No existe el usuario "bunge"</error_string>

          </error>

       </usuario_grupo>

    </asignar_usuarios_grupos_response>