Declaración:

registrar_usuario (administrador_usuario as Boolean, id_usuario as Integer, nombre as String, apellido as String, clave as String, id_idioma as String, opcional codigo_postal as String, opcional dato_adicional_1, opcional dato_adicional_2, opcional dato_adicional_3, opcional direccion as String, opcional email as String, opcional localidad as String, opcional telefono as String, opcional url 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 un usuario en el campus, asociándolo a un grupo y estableciendo los valores por defecto.

Devuelve: "estado", indicando si el usuario fue creado correctamente o no.


Parámetros

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

Requerido.

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

administrador_usuario

Requerido.

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

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.

codigo_postal

Opcional.

Código postal del usuario.

direccion

Opcional.

Dirección del usuario.

email

Opcional.

Email del usuario.

localidad

Opcional.

Localidad del usuario.

telefono

Opcional.

Teléfono del usuario.

url

Opcional.

Página web del usuario. Debe contener http:// ó https:// al inicio.

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

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

…UrlUsuario

Ocurre cuando la url ingresada no contiene http:// o https:// al inicio

…DAValorInvalido

Ocurre cuando uno de los valores asignados a los campos de la forma dato_adicional_[n] no cumple con las validaciones definidas, si es que estos apuntan a uno de los datos adicionales con validaciones: SITIO_WEB, DOCUMENTO, SEXO.

…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: crear un nuevo usuario en el sistema.

Se solicita crear un usuario con “id_usuario” f_manes en el grupo con "id_grupo" 24 con "perfil" Invitado.


SOAP Request

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

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

  <soapenv:Header/>

  <soapenv:Body>

  <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:codigo_postal>2000</aula:codigo_postal>

          <aula:dato_adicional_1>32910834</aula:dato_adicional_1>

          <aula:dato_adicional_2></aula:dato_adicional_2>

          <aula:dato_adicional_3></aula:dato_adicional_3>

          <aula:direccion>lisboa 277</aula:direccion>

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

          <aula:localidad>Rosario</aula:localidad>

          <aula:telefono>156203654</aula:telefono>

          <aula:url>http://fmanes.com</aula:url>

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

  </soapenv:Body>

</soapenv:Envelope>


Respuesta

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

       <estado>1</estado>

    </registrar_usuario_response>