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