Declaración:

registrar_usuarios ((opcional) administrador_usuario as Boolean, id_usuario as Integer, nombre as String, apellido as String, clave as String,(opcional) id_idioma as String, (opcional) email as String, (opcional) foto_nombre as String, (opcional) foto_base64 as Base64, (opcional) ((opcional) administrador_grupo as String, (opcional) estado as String, id_grupo as Integer, (opcional) perfil as String))

El método crea usuarios en el campus asociándolos a grupos (cada usuario puede asociarse a un único grupo) y estableciéndole las características especificadas.


Devuelve:

  • estado 'true' si el usuario fue creado correctamente en el grupo indicado: por cada tupla de datos que se pudo procesar correctamente.
  • estado 'false' por cada tupla de datos que NO se pudo procesar correctamente. En este caso se muestra también el error correspondiente.


Parámetros

administrador_usuario

Opcional.

Toma valores 0 ó 1, o 'true' ó 'false'.

id_usuario

Requerido.

El "id_usuario" ingresado esta sujeto a las mismas validaciones a las que es sometido al ingresarlo desde la administración

Nombre

Requerido.

No puede superar los 50 caracteres.

Apellido

Requerido.

No puede superar los 50 caracteres.

Clave

Requerido.

Sujeto a las restricciones definidas en la configuración. Es permanente.

id_idioma

Opcional.

Debe corresponder con un valor de "id_idioma" existente en la tabla idiomas.

email

Opcional.

Email del usuario.

foto_nombre

Opcional.

Se especifica el [nombre].[extension] de la foto subida. Están permitidas las siguientes extensiones:".gif",".jpg", ".jpeg", ".png", ".bmp".

foto_base64

Opcional.

Se especifica la codificación en base64 correspondiente a la foto en cuestión

Id_grupo

Requerido.

Identificación del grupo al cual se agrega el usuario. Corresponde con un valor existente para "id_curso" en la tabla cursos.

administrador_grupo

Opcional.

Toma valores 0 o 1, o 'true' o 'false'.

estado

Opcional.

Toma valor 0 para usuarios desactivados. Con cualquier otro valor que especifiquemos, el usuario va a registrarse como activo.

perfil

Opcional.

Debe corresponder con un perfil existente en el grupo.


Excepciones

Educativa::Aula::Error::…

…IdUsuarioInvalido

Ocurre cuando la identificación del usuario contiene caracteres inválidos

…UsuarioExistente

Ocurre cuando el usuario ya se encuentra registrado en la plataforma

…GrupoInexistente

ocurre cuando se intenta inscribir el usuario a un grupo no existente en la plataforma

…PerfilUsuarioInvalido

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

…UsuarioExistenteSistema

ocurre cuando el usuario existe en otro producto, en un entorno con login centralizado

…InvalidEmailAddress

ocurre cuando el mail ingresado no es una dirección válida

…InvalidNombreApellidoUsuario

Ocurre cuando el nombre o apellido ingresado contienen caracteres no permitidos

…ClaveUsuarioInvalida

Ocurre cuando la clave ingresada no cumple con la política de claves definida en la plataforma

…IdiomaInvalido

Ocurre cuando el id_idioma ingresado no esta definido en la plataforma

…NombreArchivoInvalido

Ocurre cuando el [nombre].[extension], ingresados en "foto_nombre", supera los 250 caracteres.También ocurre cuando las tags del parámetro fueron borradas o se paso el valor vacío, siendo que que el párametro "foto_base64" si fue especificado

…ExtensionInvalida

Ocurre cuando la [extension] del nombre ingresado en "foto_nombre" no esta dentro de las siguientes: ".gif", ".jpg", ".jpeg", ".png", ".bmp"

…TipoMimeInvalido

Ocurre cuando el tipo de mime definido en la cabecera de la cadena, especificada en "foto_base64", no corresponde a uno de los tipos de mimes definidos para los tipos de archivos permitidos

…Base64Invalido

Ocurre cuando cuando habiendo especificado valor para el parámetro "foto_nombre", el parámetro "foto_base64" fue especificado vacío, o sus tags fueron borradas directamente


Ejemplo de llamada (ingresaríamos el siguiente bloque n veces)

<aula:registrar_usuario>

       <aula:usuario>

          <aula:administrador_usuario>false</aula:administrador_usuario>

          <aula:id_usuario>f_manes</aula:id_usuario>

          <aula:nombre>facundo</aula:nombre>

          <aula:apellido>manes</aula:apellido>

          <aula:clave>asdasd</aula:clave>

          <aula:id_idioma>1</aula:id_idioma>

          <aula:email>f_manes@hotmail.com</aula:email>

          <aula:foto_nombre>lisa.jpg</aula:foto_nombre>

          <aula:foto_base64>data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEASABIAAD/2wBDAAkGBwgHBgkICAgKCgkLDhcPDg0NDhwUFREXIh4jIyEeI....</aula:foto_base64>

       </aula:usuario>

       <aula:usuario_grupo>

          <aula:administrador_grupo>true</aula:administrador_grupo>

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

          <aula:id_grupo>42</aula:id_grupo>

          <aula:perfil>I</aula:perfil>

       </aula:usuario_grupo>

    </aula:registrar_usuario>


Respuesta (se mostrará un bloque con la respuesta a cada tupla ingresada)

<usuario_grupo>

       <id_usuario>f_manes</id_usuario>

       <estado>false</estado>

       <error>

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

          <error_string>No existe el grupo "24"</error_string>

       </error>

    </usuario_grupo>