Servicios Web

Versión 2.X

Esta versión proporciona dos servicios cuyas operaciones permiten:

• la sincronización de los datos necesarios para el cálculo y visualización del modelo de conocimiento y consultar del modelo distribuido de conocimiento para un concepto dado;
• el cálculo y visualización gráfica del modelo de conocimiento obtenido a partir de los datos proporcionados a través del anterior servicio.

A través de estos servicios, todos los componentes de aprendizaje pueden consultar el modelo de conocimiento de sus alumnos. Mediante las operaciones del primer servicio, los componentes deberán (regularmente) proporcionar datos actualizados sobre las actividades desarrolladas por sus alumnos. Dependiendo de la regularidad de estas actualizaciones, Samuel proporcionará un modelo actualizado dependiente de los datos proporcionados.

Los servicios proporcionan un respuesta con un formato común que permite identificar si la operación ha tenido éxito o el problema que ha generado una respuesta fallida. El formato de respuesta es el siguiente;

  <S:Envelope 
     xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
     <S:Body>
        <ns2:[nameOperation]Response 
            xmlns:ns2="http://server.ws.samuel.medea.iaia.lsi/">
           <return>
              <code/>
              <message/>
           </return>
        </ns2:[nameOperation]Response>
     </S:Body>
  </S:Envelope>

Los código de respuesta posibles:

• 0: operación ejecutada con éxito. El elemento message estará vacío.
• -1; operación ejecutada sin éxito. El elemento message indicará el error producido.
• -2: error producido porque algún parámetro de la petición no es correcto. El elemento message dará información sobre el parámetro incorrecto.
• -3: error producido porque algún identificador (componente, concepto, actividad o estudiante) no se encuentra en la base de datos. El elemento messaje indicará el identificador no encontrado.
• -5: error producido al parsear alguno de los parámetros que contienen cadenas XML. El elemento message indicará el error producido así como el parámetro que lo generó (si hay más de uno en la petición).