establecer_datos_adicionales_usuarios
Establecer datos adicionales de usuarios
establecer_datos_adicionales_usuarios (id_usuario as String, id_campo as Integer, valor as Text)
El método permite establecer valores para los datos adicionales de usuarios
Devuelve: 1{id_usuario + id_campo + resultado}n
'resultado' es un valor booleano: "true" si pudo setear el dato o "false" si no se pudo setear , en este caso se muestra también el error correspondiente.
Funcionamiento
- Si queremos setear valor para un campo de dato adicional para un usuario, debemos correr el WS pasandole como parámetros: el 'id_usuario' de dicho usuario, el 'id_campo' correspondiente al dato adicional al cual se le va a setear el valor, y el 'valor' propiamente dicho.
- La estructura correspondiente(aula:valor_da) debe ser repetida n veces según la cantidad de tuplas usuario-dato_adicional que se quieran setear.
- El tipo de dato correspondiente a 'valor' depende de cada dato adicional.
Ejemplo de Respuesta
Ejemplo de respuesta de la llamada establecer_datos_adicionales_usuarios, que indica setearles valor a datos adicionales para 3 usuarios.
- Llamada:
<aula:establecer_datos_adicionales_usuarios>
<aula:valor_da>
<aula:id_usuario>educativa</aula:id_usuario>
<aula:id_campo>15</aula:id_campo>
<aula:valor>M</aula:valor>
</aula:valor_da>
<aula:valor_da>
<aula:id_usuario>educativa</aula:id_usuario>
<aula:id_campo>3</aula:id_campo>
<aula:valor>156042078</aula:valor>
</aula:valor_da>
<aula:valor_da>
<aula:id_usuario>alumno_2</aula:id_usuario>
<aula:id_campo>18</aula:id_campo>
<aula:valor>La Pampa</aula:valor>
</aula:valor_da>
<aula:valor_da>
<aula:id_usuario>alumno_3</aula:id_usuario>
<aula:id_campo>10</aula:id_campo>
<aula:valor>mvideguren</aula:valor>
</aula:valor_da>
</aula:establecer_datos_adicionales_usuarios>
En esta llamada podemos observar que se intenta setear el valor "M" para el dato adicional con 'id_campo' 15 y el valor "156042078" para el dato adicional con 'id_campo' 3 para el usuario educativa, el valor "La Pampa" para el dato adicional con 'id_campo' 18 para el usuario alumno_2 , y el valor "mvideguren" para el dato adicional con 'id_campo' 10 para el usuario alumno_3
- Respuesta:
<establecer_datos_adicionales_usuarios_response xmlns="urn:Educativa/Aula/">
<resultado_da>
<id_usuario>educativa</id_usuario>
<id_campo>15</id_campo>
<resultado>true</resultado>
</resultado_da>
<resultado_da>
<id_usuario>educativa</id_usuario>
<id_campo>3</id_campo>
<resultado>true</resultado>
</resultado_da>
<resultado_da>
<id_usuario>alumno_2</id_usuario>
<id_campo>18</id_campo>
<resultado>true</resultado>
</resultado_da>
<resultado_da>
<id_usuario>alumno_3</id_usuario>
<id_campo>10</id_campo>
<resultado>true</resultado>
</resultado_da>
</establecer_datos_adicionales_usuarios_response>
Errores de validación
- Educativa::Aula::Error::IdUsuarioInvalido - cuando el 'id_usuario' ingresado contiene caracteres inválidos o es vacío.
- Educativa::Aula::Error::UsuarioInexistente - ocurre cuando el usuario no existe en la plataforma.
- Educativa::Aula::Error::UsuarioAnonimo - ocurre cuando el usuario que se intenta eliminar es el usuario _anonimo.
- Educativa::Aula::Error::IdCampoInexistente - cuando el 'id_campo' ingresado no existe en la plataforma.
- Educativa::Aula::Error::IdCampoInvalido - cuando el 'id_campo' ingresado no es integer.
- Educativa::Aula::Error::DAValorInvalido - cuando el valor ingresado no es un valor válido para el dato adicional en cuestión.