asignar_usuarios_alcance_prg_items
Asignar items a usuarios
asignar_usuarios_alcance_prg_items (1{ id_usuario as String, id_prg_item as Integer}n)
El método permite asignar items con alcance selectivo a usuarios
Devuelve: 1{id_usuario + id_prg_item + estado + (error_code + error_string)}n
- estado 'true' si pudo asignar correctamente el item al usuario indicado: por cada tupla de datos que se pudo procesar correctamente.
- estado 'false' si no pudo asignar correctamente el item al usuario indicado: por cada tupla de datos que no se pudo procesar correctamente. En este caso se muestra también el error correspondiente.
Funcionamiento
- Por ahora el ws solo permite asignar ítems de tipo evaluación.
- Si queremos asignar evaluaciones con alcance selectivo a usuarios, debemos correr el ws pasandole como parámetros: el 'id_usuario' de dicho usuario y el 'id_prg_item' de la evaluación correspondiente.
- La estructura correspondiente(aula:asignar_usuario_item) debe ser repetida n veces según la cantidad de tuplas usuario-item para las cuales se desee establecer alcance selectivo.
- Si se realiza una asignación de un ítem a un usuario, y este ítem no estaba configurado como de alcance selectivo previamente, se le estable la condición.
- Si al usuario indicado ya le aplicaba el alcance selectivo en el item, no se lo trata como un error.
Ejemplo de Respuesta
Ejemplo de respuesta de la llamada asignar_usuarios_alcance_prg_items, que indica asignar items con alcance selectivo para 3 usuarios.
- Llamada:
<aula:asignar_usuarios_alcance_prg_items>
<aula:asignar_usuario_item>
<aula:id_usuario>educativa</aula:id_usuario>
<aula:id_prg_item>1</aula:id_prg_item>
</aula:asignar_usuario_item>
<aula:asignar_usuario_item>
<aula:id_usuario>manu</aula:id_usuario>
<aula:id_prg_item>1</aula:id_prg_item>
</aula:asignar_usuario_item>
<aula:asignar_usuario_item>
<aula:id_usuario>manu/aula:id_usuario>
<aula:id_prg_item>2</aula:id_prg_item>
</aula:asignar_usuario_item>
</aula:asignar_usuarios_alcance_prg_items>
En esta llamada, podemos observar que: se desea asignar alcance selectivo al item con 'id_prg_item' = 1 para los usuarios "educativa" y "manu", y el item con 'id_prg_item' = 2 para el usuario "manu".
- Respuesta:
<asignar_usuarios_alcance_prg_items_response xmlns="urn:Educativa/Aula/">
<usuario_item_alcance>
<id_usuario>educativa</id_usuario>
<id_prg_item>1</id_campo>
<estado>true</estado>
</usuario_item_alcance>
<usuario_item_alcance>
<id_usuario>manu</id_usuario>
<id_prg_item>1</id_campo>
<estado>true</estado>
</usuario_item_alcance>
<usuario_item_alcance>
<id_usuario>manu</id_usuario>
<id_prg_item>2</id_campo>
<estado>false</estado>
<error>
<error_code>Educativa::Aula::Error::ItemInexistente</error_code>
<error_string>No existe el item "2"
</error>
</usuario_item_alcance>
</asignar_usuarios_alcance_prg_items_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 al usuario que le intenta asignar el ítem es el usuario 'anónimo'
Educativa::Aula::Error::ItemInexistente - ocurre cuando el 'id_prg_item' ingresado no existe.
Educativa::Aula::Error::TipoItemIncorrecto - ocurre cuando el 'id_prg_item' ingresado posee un 'id_tipo_item' distinto a EV
Educativa::Aula::Error::UnidadInexistente - ocurre cuando la unidad a la que pertenece el item no existe.
Educativa::Aula::Error::UsuarioInexistenteEnGrupo - ocurre cuando se intenta asignar un item cuyo 'id_prg_item' pertenece a un aula en la cual el usuario no existe.
Educativa::Aula::Error::PermisoUsuarioInvalido - ocurre cuando el usuario no posee los permisos en el curso (cuando no tiene permiso cursa para evaluaciones).