Método de WS para obtener las Evaluaciones de un Aula

obtener_prg_items

obtener_prg_items ( id_grupo as Integer, id_tipo_item as String, (opcional) id_unidad as String )

El método devuelve las evaluaciones existentes para un aula dada, permitiendo filtrar por unidad.

Devuelve: 0{id_prg_item + id_unidad + tipo + nombre + obligatorio + activado + alcance_selectivo + orden + indent}n


Funcionamiento

  • Por ahora el ws solo permite obtener los ítems de tipo evaluación. Por lo tanto el único 'id_tipo_item' que se procesará es EV y siempre deberá especificarse.
  • Si queremos obtener todas las evaluaciones existentes para un aula, pasamos como parámetro el 'id_grupo' de un grupo.
  • Si queremos obtener solamente las evaluaciones correspondientes a una unidad dada del grupo, adicionalmente deberemos especificar valor para el parámetro 'id_unidad'.


Ejemplo de Respuesta

Ejemplo de respuesta de la llamada obtener_prg_items, pasando como parámetro el 'id_grupo'= 24 y la 'id_unidad'= 1

  • Llamada:

     <aula:obtener_prg_items>
        <aula:id_grupo>24</aula:id_grupo>
        <aula:id_tipo_item>EV</aula:id_tipo_item>
        <aula:id_unidad>1</aula:id_unidad>
     </aula:obtener_prg_items>

En esta llamada, podemos observar que: se desean obtener las evaluaciones del grupo con 'ig_grupo' = 24 , que pertenezcan a la unidad con 'id_unidad' = 1.

  • Respuesta:

     <obtener_prg_items_response xmlns="urn:Educativa/Aula/">
        <prg_item>
           <id_prg_item>16</id_prg_item>
           <id_unidad>1</id_unidad>
           <tipo>EV</tipo>
           <nombre>evaluacion parcial</nombre>
           <obligatorio>true</obligatorio>
           <activado>true</activado>
           <alcance_selectivo>false</alcance_selectivo>
           <orden>4</orden>
           <indent>2</indent>
        </prg_item>
        <prg_item>
           <id_prg_item>18</id_prg_item>
           <id_unidad>1</id_unidad>
           <tipo>EV</tipo>
           <nombre>evaluacion final</nombre>
           <obligatorio>true</obligatorio>
           <activado>true</activado>
           <alcance_selectivo>false</alcance_selectivo>
           <orden>5</orden>
           <indent>1</indent>
        </prg_item>
     </obtener_prg_items_response>


Errores de validación

Educativa::Aula::Error::IdGrupoInvalido - ocurre cuando el 'id_grupo' ingresado no es integer o es superior al numero mayor permitido.

Educativa::Aula::Error::GrupoInexistente - ocurre cuando el grupo ingresado no existe en la base de datos.

Educativa::Aula::Error::UnidadInexistente - ocurre cuando la unidad ingresada no existe en el grupo ingresado.

Educativa::Aula::Error::TipoItemIncorrecto - ocurre cuando el 'id_tipo_item' ingresado es distinto a EV