Introducción


Permite la integración en Clariano de los servicios REST de la GVA sobre resultados preinscripción de grado. Los servicios que se pueden invocar se detallan a continuación.

Manual de usuario


El acceso a esta pantalla se realiza a través de la opción del menú Servicios SIUV con el permiso configurado 'PRE_SERVICIOS_SIUV’.



Al cargar la página se recoge el año y la convocatoria por defecto seleccionado en la pantalla “Cambio de Convocatoria”. Se cargan todas las fases del año-convocatoria estén publicadas o no.

Se selecciona por defecto la fase máxima (publicada o no) del año-convocatoria y a continuación se recogen los parámetros para poder establecer las conexiones con el API REST de la GVA desde el procedimiento pre_rest_pck.pr_config_api_rest_gva.




No se podrá modificar desde esta pantalla ni el Año ni la Convocatoria, pero si se puede cambiar la Fase. Al modificar la fase, se actualiza la información de solo lectura de los 4 campos de fecha que se ven en la imagen, además del Estado.



Lista de llamadas a los servicios


Cada vez que se modifica la fase o se ejecuta uno de los servicios, se refresca esta lista que muestra la información de los últimos servicios ejecutados. Podemos ver el id interno de la ejecución, fecha y hora, servicio ejecutado, si ha habido error o no, número de registros, plazas, registros con plazas, y usuario que lo ha ejecutado.




Al pulsar en el icono de la lupa de las Acciones podemos ver el detalle de la ejecución, que será la respuesta JSON de la API REST o bien el error ocurrido.


 


Pestaña Carga inicial

Disponemos de dos servicios de ejecución asíncrona, debido al volumen de información a cargar:

REST: Obtener datos

Este proceso recoge las plazas vacantes desde los servicios REST de la GVA pasando como información la fase seleccionada, año y convocatoria.

Se realiza de forma asíncrona debido al volumen de información cercano al millón de registros. Solo lo puede ejecutar un usuario con el rol ‘superusuario’ o 'desarrollador'.

Recoge información desde los servicios REST de la GVA pasando como información la fase seleccionada.

Se ejecutan uno detrás de otro los siguientes procesos:

Para que un proceso se pueda ejecutar, previamente se hace una llamada a pre_rest_pck.f_llamar_serv_inic que indicará si el proceso se ejecuta o no. En caso de que un servicio no se pueda ejecutar se continua con los siguientes, pero si uno de los servicios da error se finaliza el proceso y no se ejecutan los siguiente.

Pasar a tablas V*_

Este proceso pasa los datos de los servicios anteriores, a las tablas V_*.

Se realiza de forma asíncrona y solo lo puede ejecutar un usuario con el rol ‘superusuario’ o 'desarrollador'.

Toda la lógica del servicio se encuentra definida en el proceso de BD pre_rest_pck.pr_pasar_a_tablas_v.

Durante la ejecución del proceso, se informa a la pantalla del estado de avance mediante la consulta de la función de BD pre_rest_pck.f_estado_pasar_a_tablas_v. Esta función se ejecuta cada 30 segundos por defecto, según se indique en el parámetro de BD PRE_PARAMETROS.pasar_a_v.refrescar


Debido a que ambos procesos son asíncronos, se pierde el control sobre el mismo una vez lanzado, por tanto para evitar posibles bloqueos en los botones, se ha introducido un botón ‘Desbloquear’ cuyo objetivo es volver a habilitar los botones de los procesos en caso de que se produzca un error no controlado, así como limpiar los mensajes de progreso. En el caso del proceso primero, acaba con el servicio actual y no continua con los siguientes.

Pestaña Vacantes


 


Disponemos de dos procesos y una consulta:

REST: Comunicar vacantes (SETVACANTES)


Este proceso ejecuta una consulta a la tabla pre_cupos para obtener el listado de vacantes a comunicar a la GVA para el año-convocatoria y fase GVA seleccionada.

Al pulsar el botón se comprueba mediante un procedimiento de BD si es posible su ejecución.

En caso de no poder ejecutarse, aparecerá un mensaje de este estilo:


 

En caso de poder ejecutarse, el mensaje podría ser de esta forma, donde podemos ver un botón extra de ‘Aceptar’ que al pulsarlo lanzará la llamada síncrona a la API REST de GVA que permitirá comunicar nuestras plazas vacantes. Una vez finalizada la ejecución, podemos ver en el listado de servicios, ya comentado, el resultado de la ejecución para el Tipo=’SETVACANTES’.


 

No se guarda información en ninguna tabla sobre la ejecución de este proceso. Toda la información necesaria se guarda en la propia llamada y es accesible desde las acciones de la misma:


 

Se incluye además una comprobación de que el campo plazas sea mayor que 0. Si no se cumple se muestra este mensaje: Antes de comunicar vacantes hay que comprobar las plazas para comunicar y que sean mayor que cero.

REST: Obtener vacantes comunicadas (GETVACANTES)


Este proceso recoge las plazas vacantes desde los servicios REST de la GVA pasando como información la fase seleccionada.

Al igual que con el servicio anterior, se comprueba si es posible su ejecución y en caso afirmativo se lanzar una llamada API REST de forma síncrona.

Una vez finalizada la ejecución, podemos ver en el listado de servicios, ya comentado, el resultado de la ejecución para el Tipo=’GETVACANTES’. La información recibida por la API REST se guarda en la tabla PRE_REST_JSON_GETVAC.

Comprobar vacantes para comunicar


Esta acción permite, mediante una consulta a la tabla pre_plazas, obtener el número de vacantes a comunicar, tomando el año-convocatoria y la fase para realizar la consulta. En ningún caso se conecta a la API de GVA ni queda registro en la lista de llamadas.

El resultado se muestra en el campo ‘Plazas’.

Pestaña Adjudicaciones

Disponemos de dos servicios y una consulta:

REST: Obtener adjudicaciones (GETADJ)

Este proceso se realiza de forma asíncrona debido a que puede tardar en ejecutarse más de una hora en las primeras fases, debido a la cantidad de registros. Solo lo puede ejecutar un usuario con el rol ‘superusuario’.

Una vez lanzado el proceso, ningún otro usuario de Clariano podrá lanzarlo hasta su terminación puesto que se bloquea el botón. Se informa en la pantalla del estado de avance del proceso.


 

Debido a que es un proceso asíncrono, se pierde el control sobre el mismo una vez lanzado, por tanto para evitar posibles bloqueos en el botón, se ha introducido un botón ‘Desbloquear’ cuyo objetivo es volver a habilitar el botón del proceso en caso de que se produzca un error no controlado.

Al igual que con servicios anteriores, se comprueba si es posible su ejecución y en caso afirmativo se lanzar una llamada API REST de forma asíncrona. La información del servicio queda guardada en la tabla pre_rest_json_adj.

Una vez finalizada la ejecución, podemos ver en el listado de servicios, al refrescar la página manualmente, el resultado de la ejecución para el Tipo=’GETADJ’. Se puede ver en plazas el número de admitidos, y en regs. con plazas las preferencias en lista de espera.

REST: Obtener notas de corte (GETNOTCORTE)


Este proceso recoge las notas de corte desde los servicios REST de la GVA pasando como información la fase seleccionada.

Se comprueba si es posible su ejecución y en caso afirmativo se lanzar una llamada API REST de forma síncrona.

Una vez finalizada la ejecución, podemos ver en el listado de servicios, ya comentado, el resultado de la ejecución para el Tipo=’GETNOTCORTE’. La información recibida por la API REST se guarda en la tabla pre_rest_json_nc.

Comparar notas de corte


Esta acción permite, mediante la ejecución del procedimiento almacenado ‘pre_rest_pck.pr_compara_notcorte’, comparar las notas de corte de la UPV con las proporcionadas por GVA y almacenadas previamente en la tabla pre_rest_json_nc tras la ejecución del servicio GETNOTCORTE, tomando el año-convocatoria y la fase para realizar la comparación.

En ningún caso se conecta a la API de GVA ni queda registro en la lista de llamadas.

El resultado se muestra en una ventana popup de esta forma:

 

Pestaña Listas de Espera



Disponemos de dos procedimientos PL/SQL permiten conectarse a la API REST de GVA para obtener e informar sobre las listas de espera:

REST: Consultar confirmaciones (GETLE)


Permite obtener las confirmaciones en lista de espera para cada tice-cupo. La llamada se encuentra en el paquete PRE_REST_PCK.pr_estado_le. La información recogida se almacena en la tabla pre_rest_json_estado_le.

De la misma forma que cuando se llaman a los servicios de la API de GVA desde Clariano, también se guarda un registro de estas llamadas, que puede ser consultado desde la pestaña “Lista de esperapara el Tipo=’GETLE’. Asimismo se realiza una verificación previa para comprobar si es posible la ejecución del servicio.


 

REST: Comunicar confirmación (SETBAJALE)

Permite dar de baja en lista de espera en GVA a un estudiante en un tice-cupo. La llamada se encuentra en el paquete PRE_REST_PCK.pr_baja_le. La información recogida se almacena en la tabla pre_rest_json_baja_le.

De la misma forma que cuando se llaman a los servicios de la API de GVA desde Clariano, también se guarda un registro de estas llamadas, que puede ser consultado desde la pestaña “Lista de esperapara el Tipo=’SETBAJALE’. Asimismo se realiza una verificación previa para comprobar si es posible la ejecución del servicio.


Pestaña Reclamaciones


 


Disponemos de tres procesos:

REST: Obtener reclamaciones (GETRECLA)

Este proceso síncrono recoge las reclamaciones desde los servicios REST de la GVA pasando como información el rango de fechas que se visualiza en la pantalla.

Ese intervalo de fechas se obtiene desde la función de BD pre_rest_pck.pr_intervalo_recla y se actualiza en la pantalla incluso para cada cambio de fase, no siendo posible modificar las fechas. Esa misma función proporciona la información que aparece en el campo 'Estado' que tampoco se puede modificar.

Se comprueba si es posible su ejecución y en caso afirmativo se lanzar una llamada API REST de forma síncrona.

Una vez finalizada la ejecución, podemos ver en el listado de servicios, ya comentado, el resultado de la ejecución para el Tipo=’GETRECLA’. La información recibida por la API REST se guarda en la tabla PRE_REST_JSON_RECLA.

En el listado de servicios ejecutados, y solo para esta pestaña, se muestran las ejecuciones de todas las fases, no solo la fase seleccionada en el filtro.

REST: Obtener Solicitudes fuera plazo (GETFPLAZO)

Este proceso síncrono recoge las solicitudes fuera de plazo desde los servicios REST de la GVA sin enviar ningún parámetro.

Al igual que en el servicio anterior, se comprueba si es posible su ejecución y en caso afirmativo se lanzar una llamada API REST de forma síncrona.

Una vez finalizada la ejecución, podemos ver en el listado de servicios el resultado de la ejecución para el Tipo=’GETFPLAZO’. La información recibida por la API REST se guarda en la tabla PRE_REST_JSON_FPLAZO.

Importar reclamaciones

Este proceso síncrono recoge las reclamaciones almacenadas en BD y las procesa. No requiere conexión con los servicios REST de la GVA.

Previamente se realiza una llamada a la función de BD pre_rest_pck.f_llamadas_recla, con parámetro tipo = SIG que muestra mensaje informativo al usuario.

A continuación se realiza una llamada al procedimiento de BD pre_rest_pck.pr_importa_recla que permite importar las reclamaciones/solic-fplas existentes.