Medea » Samuel » Samuel WS v2 es »

Cálculo y visualización del modelo

Este servicio es accesible mediante al siguientes dirección: http://samuel.iaia.lcc.uma.es/samuelToIngrid?wsdl.

Las operaciones asociadas permite calcular y visualizar el modelo de conocimiento por alumno o grupo:

  • viewModelByLast, calcula y visualiza el modelo de conocimiento asociado a un alumno.
  • viewGroupModelByLast, calcula y visualiza el modelo de conocimiento asociado a un grupo de alumnos.

Operaciones

viewModelByLast 

  ResponseView viewModelByLast(String idLRRequest,         Long idStudentLR,   
                               List<Long> groupList        List<Integer> idLRReportList, 
                               String urlOntology,         Date date,
                               int period,                 Date startDate,     
                               int windowSize,             int windowType,
                               int method,                 boolean weighted,
                               String configurationXML,    Boolean showIndeterminateStudents, 
                               String sign,                String actionsXML)
Parámetros

  • idLRRequest: identificador del recurso de aprendizaje que hace la petición.
  • idStudentLR: identificador del estudiante en el recurso de aprendizaje que hace la petición.
  • groupList: lista de identificadores de estudiantes.
  • idLRReportList: lista de recursos de aprendizaje del que provienen las evidencias de conocimiento. Valores permitidos: 1: Componente, 2: Profesor y 3: Estudiante.
  • urlOntology: URL de acceso al fichero OWL que define la ontología a almacenar.
  • date: fecha fin para la generación del modelo
  • period: número de días usados para mostrar la evolución temporal del modelo.
  • startDate: fecha inicial para la generación del modelo.
  • windowSize: tamaño de ventana (en días o en número de evidencias, según el parámetro windowType) en la que se asume que el conocimiento del alumno no cambia.
  • windowType: tipo de ventana: 1 para ventana tipo número evidencias y 2 para ventana tipo número de días.
  • method: método de acumulación de evidencias: 1 - Graded Response Model.
  • weighted: true si queremos dar más peso a las evidencias más recientes, en cualquier otro caso false.
  • configurationXML: cadena XML que define el aspecto visual del modelo mostrado.
  • showIndeterminateStudents: si el valor es true no se tienen en cuenta los estudiantes sin evidencias, si es false sí se tienen en cuenta.
  • sign: firma que permite verificar si la petición realizada ha sido realizada por el componente de la petición.
  • actionsXML: cadena XML que define un conjunto de actividades recomendadas, asociadas a cada uno de los conceptos que conforman la ontología.

Calcula y genera el modelo de conocimiento asociado a un alumno (idStudentLR). El modelo de conocimiento se basa en el conjunto de evidencias asociadas al alumno, restringidas a la ventana de tiempo especificada (windowSize y windowType, comparándolas con el conjunto de evidencias, restringidas a la misma ventana de tiempo, asociadas al grupo al que pertenece y aplicando el método de acumulación elegido.

Una vez realizado el cálculo, se proporciona una URL donde se puede visualizar el resultado del modelo de conocimiento generado.

Las cadenas XML, configurationXML y actionsXML, son opcionales, así como las fechas fin e inicio para la generación del modelo.

El formato de las cadenas XML para los parámetros configurationXML y actionsXML deben cumplir con los siguientes esquemas configuration.xsd y actions.xml, respectivamente. Para obtener una información más detallada de cada uno de los elementos de dichos esquemas consulte el manuel de integración de Ingrid

Ejemplo soapUI 

Petición:
  <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
                    xmlns:ser="http://server.ws.samuel.medea.iaia.lsi/">
     <soapenv:Header/>
     <soapenv:Body>
        <ser:viewModelByLast>
           <!--Required:-->
           <idLRRequest>14</idLRRequest>
           <!--Required:-->
           <idStudentLR>4</idStudentLR>
           <!--Required: One or more repetitions:-->
           <groupList>4</groupList>
           <groupList>50</groupList>
           <groupList>51</groupList>
           <!--Required; one or more repetitions:-->
           <idLRReportList>1</idLRReportList> <!-- Evidence recorder by the components -->
           <idLRReportList>2</idLRReportList> <!-- Evidence recorder by the teacher -->
           <idLRReportList>3</idLRReportList> <!-- Evidence recorder by the student -->
           <!--Required:-->
           <urlOntology>http://localhost/grade/report/samuel/owl.php?id=2</urlOntology>
           <!--Optional:-->
           <date></date>
           <!--Required:-->
           <period>7</period>
           <!--Optional:-->
           <startDate></startDate>
           <!--Required:-->
           <windowSize>100</windowSize>
           <!--Required: Allowed values: 1 to window type evidence number -->
           <!--                          2 to window type number of days-->
           <windowType>1</windowType>
           <!--Required: Allowed values: 1 Graded Response Model-->
           <method>1</method>
           <!--Required: true to give more weight to more recent evidence -->
           <weighted>false</weighted>
           <!--Optional:-->
           <configurationXML><![CDATA[<Configuration>
                  <lang>en_utf8</lang>
                  <course>Matemáticas</course>
                  <showHeader>true</showHeader>
              </Configuration>]]>
           </configurationXML>
           <!--Required: true to show students that we has been obtained
                         knowledge, false otherwise.-->
           <showIndeterminateStudents>false</showIndeterminateStudents>
           <!--Required: signature that allows us to verify if the request comes from a
                         registered component.-->
           <sign><![CDATA[TaBH2o19Wwy1Wg5FITapP2OQy123imu7omMZmQogV0V+rNdC0HXIuHO7hMaqq5DPWg6qxdfTqh1SYcnGJzhThA==]]></sign>
           <!--Optional:-->
           <actionsXML></actionsXML>
        </ser:viewModelByLast>
     </soapenv:Body>
  </soapenv:Envelope>

Resultado:
  <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
     <S:Body>
        <ns2:viewModelByLastResponse xmlns:ns2="http://server.ws.samuel.medea.iaia.lsi/">
           <return>
              <code>0</code>
              <message/>
              <urlModel>http://ingrid.iaia.lcc.uma.es/ingrid.html?id=cd5d6184900c4341ac9f13ea1623b773</urlModel>
           </return>
        </ns2:viewModelByLastResponse>
     </S:Body>
  </S:Envelope>

Menú

viewGroupModelByLast 

  ResponseView viewGroupModelByLast(String idLRRequest,                 List<Long> group,
                                    List<Integer> idLRReportList,       String urlOntology,
                                    Date endDate,                       int period,
                                    Date startDate,                     int windowSize,
                                    int windowType,                     int method,
                                    boolean weighted,                   String configurationXML,
                                    Boolean showIndeterminateStudents,  String sign)
Parámetros

  • idLRRequest: identificador del recurso de aprendizaje que hace la petición.
  • group: lista de identificadores de estudiantes.
  • idLRReportList: lista de recursos de aprendizaje del que provienen las evidencias de conocimiento. Valores permitidos: 1: Componente, 2: Profesor y 3: Estudiante.
  • urlOntology: URL de acceso al fichero OWL que define la ontología a almacenar.
  • date: fecha fin para la generación del modelo
  • period: número de días usados para mostrar la evolución temporal del modelo.
  • startDate: fecha inicial para la generación del modelo.
  • windowSize: tamaño de ventana (en días o en número de evidencias, según el parámetro windowType) en la que se asume que el conocimiento del alumno no cambia.
  • windowType: tipo de ventana: 1 para ventana tipo número evidencias y 2 para ventana tipo número de días.
  • method: método de acumulación de evidencias: 1 - Graded Response Model.
  • weighted: true si queremos dar más peso a las evidencias más recientes, en cualquier otro caso false.
  • configurationXML: cadena XML que define el aspecto visual del modelo mostrado.
  • showIndeterminateStudents: si el valor es true no se tienen en cuenta los estudiantes sin evidencias, si es false sí se tienen en cuenta.
  • sign: firma que permite verificar si la petición realizada ha sido realizada por el componente de la petición.

Calcula y genera el modelo de conocimiento asociado a un grupo de alumnos (group). El modelo de conocimiento se basa en el conjunto de evidencias asociadas a cada uno de los alumnos, restringidas a la ventana de tiempo especificada (windowSize y windowType, y aplicando el método de acumulación elegido. Los alumnos que no existan en el sistema se ignorarán a la hora de realizar el cálculo y generación del modelo.

Una vez realizado el cálculo, se proporciona una URL donde se puede visualizar el resultado del modelo de conocimiento generado.

Las cadenas XML, configurationXML y las fechas fin e inicio para la generación del modelo no son obligatorios.

El formato de las cadenas XML para los parámetros configurationXML y actionsXML deben cumplir con los siguientes esquemas configuration.xsd y actions.xml, respectivamente. Para obtener una información más detallada de cada uno de los elementos de dichos esquemas consulte el manuel de integración de Ingrid

Ejemplo soapUI 

Petición:
  <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
                    xmlns:ser="http://server.ws.samuel.medea.iaia.lsi/">
     <soapenv:Header/>
     <soapenv:Body>
        <ser:viewModelByLast>
           <!--Required:-->
           <idLRRequest>14</idLRRequest>
           <!--Required: One or more repetitions:-->
           <group>4</group>
           <group>50</group>
           <group>51</group>
           <!--Required; one or more repetitions:-->
           <idLRReportList>1</idLRReportList> <!-- Evidence recorder by the components -->
           <idLRReportList>2</idLRReportList> <!-- Evidence recorder by the teacher -->
           <idLRReportList>3</idLRReportList> <!-- Evidence recorder by the student -->
           <!--Required:-->
           <urlOntology>http://localhost/grade/report/samuel/owl.php?id=2</urlOntology>
           <!--Optional:-->
           <date></date>
           <!--Required:-->
           <period>7</period>
           <!--Optional:-->
           <startDate></startDate>
           <!--Required:-->
           <windowSize>100</windowSize>
           <!--Required: Allowed values: 1 to window type evidence number -->
           <!--                          2 to window type number of days-->
           <windowType>1</windowType>
           <!--Required: Allowed values: 1 Graded Response Model-->
           <method>1</method>
           <!--Required: true to give more weight to more recent evidence -->
           <weighted>false</weighted>
           <!--Optional:-->
           <configurationXML><![CDATA[<Configuration>
                  <lang>en_utf8</lang>
                  <course>Matemáticas</course>
                  <showHeader>true</showHeader>
              </Configuration>]]>
           </configurationXML>
           <!--Required: true to show students that we has been obtained
                         knowledge, false otherwise.-->
           <showIndeterminateStudents>false</showIndeterminateStudents>
           <!--Required: signature that allows us to verify if the request comes from a
                         registered component.-->
           <sign><![CDATA[TaBH2o19Wwy1Wg5FITapP2OQy123imu7omMZmQogV0V+rNdC0HXIuHO7hMaqq5DPWg6qxdfTqh1SYcnGJzhThA==]]></sign>
           <!--Optional:-->
           <actionsXML></actionsXML>
        </ser:viewModelByLast>
     </soapenv:Body>
  </soapenv:Envelope>

Resultado:
  <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
     <S:Body>
        <ns2:viewModelByLastResponse xmlns:ns2="http://server.ws.samuel.medea.iaia.lsi/">
           <return>
              <code>0</code>
              <message/>
              <urlModel>http://localhost:8080/ingrid/ingrid.html?id=03991da2197e4bf8bae98c561b636c31</urlModel>
           </return>
        </ns2:viewModelByLastResponse>
     </S:Body>
  </S:Envelope>

Menú

Samuel-medea-v2-soapui-project.xml - Proyecto Soap UI (41.5 kB) María del Rosario Baena Priego, 18/07/2012 13:11

Redmine Appliance - Powered by TurnKey Linux