Declaración

consultar_accesos (id_usuario, id_grupo, opcional fecha_inicio, opcional fecha_fin)


El método nos permite obtener información de los distintos accesos que un usuario realizo sobre un grupo en particular.


Devuelve: las fechas y horas de accesos, y fecha y hora del último clic (para cada acceso) de un usuario para un grupo en particular.


Parámetros

id_usuario

Requerido.
Identificación del usuario.

id_grupo

Requerido.

Identificación del grupo.

fecha_inicio

Opcional.

Fecha de inicio a partir de la cual queremos realizar nuestra consulta (aaaa-mm-dd).

fecha_fin

Opcional.

Fecha final hasta la cual queremos realizar nuestra consulta (aaaa-mm-dd).


Excepciones

Educativa::Error::MissingParameter(id_usuario)

Ocurre cuando no se ingresó id_usuario.

Educativa::Aula::Error::IdUsuarioInvalido

ocurre cuando la identificación del usuario contiene caracteres inválidos

Educativa::Error::MissingParameter(id_grupo)

Ocurre cuando no se ingresó el id_grupo.

Educativa::Aula::Error::UsuarioInexistenteEnGrupo

ocurre cuando se intenta consultar el avance para un usuario en un grupo en el que no existe.

Educativa::Aula::Error::FechaFormatoInvalido

Ocurre al ingresar una fecha con un formato distinto a aaaa-mm-dd.

Educativa::Aula::Error::FechaInvalida

Ocurre al ingresar una fecha no existente, ej: no existe dicho día para ese mes.

Educativa::Aula::Error::RangoFechaInvalido

Ocurre cuando la fecha de finalización es anterior a la fecha de inicio.


Ejemplo: consultar la información de acceso para el "id_usuario" educativa, en el "id_curso" 32, entre las fechas 2014-10-17 y 2014-11-17. La respuesta indica las fechas de acceso (fecha y hora) a ese grupo en ese lapso, y la fecha y hora del último click en ese grupo en ese lapso


SOAP Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:aula="urn:Educativa/Aula/">

  <soapenv:Header/>

  <soapenv:Body>

<aula:consultar_accesos>

       <aula:id_usuario>educativa</aula:id_usuario>

       <aula:id_curso>32</aula:id_curso>

       <aula:fecha_inicio>2014-10-17</aula:fecha_inicio>

       <aula:fecha_fin>2014-11-17</aula:fecha_fin>

    </aula:consultar_accesos>

  </soapenv:Body>

</soapenv:Envelope>


Respuesta

<SOAP-ENV:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">

  <SOAP-ENV:Body>

     <consultar_accesos_response xmlns="urn:Educativa/Aula/">

       <id_usuario>educativa</id_usuario>

       <id_curso>32</id_curso>

       <accesos>

          <fecha_acceso>2014-10-17 13:24:11</fecha_acceso>

          <fecha_ultimo_click>2014-10-17 13:24:28</fecha_ultimo_click>

       </accesos>

       <accesos>

          <fecha_acceso>2014-11-10 18:12:43</fecha_acceso>

          <fecha_ultimo_click>2014-11-10 18:16:22</fecha_ultimo_click>

       </accesos>

       <accesos>

          <fecha_acceso>2014-11-14 18:32:58</fecha_acceso>

          <fecha_ultimo_click>2014-11-14 18:38:20</fecha_ultimo_click>

       </accesos>

       <accesos>

          <fecha_acceso>2014-11-17 13:39:05</fecha_acceso>

          <fecha_ultimo_click>2014-11-17 15:10:08</fecha_ultimo_click>

       </accesos>

    </consultar_accesos_response>

  </SOAP-ENV:Body>

</SOAP-ENV:Envelope>