Construcción Al modelo de integración a la cadena logística Sena 2 0 1 0 Realizado Por
Sena - CASOS DE USO INTEGRACIÓN SOFIA PLUS...
Transcript of Sena - CASOS DE USO INTEGRACIÓN SOFIA PLUS...
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 1 de 73
Fecha: 26-06-2012
CASOS DE USO – INTEGRACIÓN SOFIA PLUS – PLATAFORMAS DE BILINGÜISMO
Fecha Versión Elaboró Observaciones
17/09/2010 1.0 Oscar Fernando Bonilla / Guido
Julián Bucheli / Olga Mercedes
Rodriguez / Wladimir Tarazona
Primera versión del documento
28/09/2010 1.1 Oscar Fernando Bonilla / Guido
Julián Bucheli / Olga Mercedes
Rodriguez / Wladimir Tarazona.
Versión para implementación.
30/09/2010 1.2 Oscar Fernando Bonilla / Guido
Julián Bucheli / Olga Mercedes
Rodriguez / Wladimir Tarazona
Versión revisada para implementación.
05/10/2010 1.3 Olga Rodríguez Se actualiza la información relacionada con el modelo
de datos, acorde con lo creado en el esquema
correspondiente de base de datos.
26/06/2012 1.4 Andrés Villanueva Cambios definidos en el proceso de unificación SOFIA
Plus y Oficina Virtual.
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 2 de 73
Fecha: 26-06-2012
Tabla de contenido
CASOS DE USO – INTEGRACIÓN SOFIA PLUS – PLATAFORMAS DE BILINGUISMO .............................. 1
1. Objetivo ....................................................................................................................................... 5
2. Descripción del sistema (SOFIA Plus – EDO) ............................................................................... 5
3. Alcance ........................................................................................................................................ 5
4. Requerimientos funcionales ....................................................................................................... 6
4.1. Casos de uso ............................................................................................................................ 6
4.2. Caso de uso detallado – Programar pruebas .......................................................................... 8
4.3. Caso de uso detallado – Cancelación masiva pruebas .......................................................... 11
4.4. Caso de uso detallado – Cancelación prueba por petición del Aspirante ............................. 13
4.5. Caso de uso detallado – Cancelar prueba ............................................................................. 14
4.6. Caso de uso detallado – Reinicio manual de prueba ............................................................ 15
4.7. Caso de uso detallado – Obtener resultados pruebas de nivel ............................................ 17
4.8. Caso de uso detallado – Cargue manual de resultados pruebas de nivel ............................. 20
4.9. Caso de uso detallado – Crear curso ..................................................................................... 21
4.10. Caso de uso detallado – Desactivar curso ......................................................................... 23
4.11. Caso de uso detallado – Enrolamiento Aprendiz .............................................................. 25
4.12. Caso de uso detallado – Enrolamiento Instructor ............................................................. 27
4.13. Caso de uso detallado – Desactivar usuario ...................................................................... 29
4.14. Caso de uso detallado – Reenvío manual de solicitud ...................................................... 33
5. Diagramas de secuencia ............................................................................................................ 38
6.1. Diagrama de secuencia – Programar prueba ....................................................................... 38
6.2. Diagrama de secuencia – Reprogramar prueba ................................................................... 39
6.3. Diagrama de secuencia – Reinicio manual de prueba.......................................................... 39
6.4. Diagrama de secuencia – Cancelar prueba .......................................................................... 40
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 3 de 73
Fecha: 26-06-2012
6.5. Diagrama de secuencia – Obtener resultados prueba de nivel ........................................... 41
6.6. Diagrama de secuencia – Obtener resultados de curso ....................................................... 42
6.7. Diagrama de secuencia – Cargue manual de resultados...................................................... 43
6.8. Diagrama de secuencia – Crear curso .................................................................................. 43
6.9. Diagrama de secuencia – Desactivar curso .......................................................................... 44
6.10. Diagrama de secuencia – Enrolamiento aprendiz ............................................................ 45
6.11. Diagrama de secuencia – Enrolamiento instructor .......................................................... 46
6.12. Diagrama de secuencia – Desactivar usuario ................................................................... 47
6.13. Diagrama de secuencia – Reenvío manual de solicitud ................................................... 48
6. Diagrama de clases .................................................................................................................... 49
7. Diagrama de estados ................................................................................................................. 50
8. Requerimientos No Funcionales ............................................................................................... 51
9.1. Confidencialidad .................................................................................................................... 51
9.2. Autenticidad .......................................................................................................................... 51
9.3. Integridad .............................................................................................................................. 51
9.4. Impacto sobre el Desempeño de los Sistemas ...................................................................... 51
9.5. Escalabilidad .......................................................................................................................... 52
9.6. Desempeño ........................................................................................................................... 52
9.7. Trazabilidad ........................................................................................................................... 52
9. Especificación Mensajes Webservice ........................................................................................ 53
18.1. ProgramarPruebaSENA ..................................................................................................... 53
18.2. CancelarPruebaSENA......................................................................................................... 55
18.3. ObtenerResultadosPruebaSENA ....................................................................................... 56
18.4. CrearCursoSENA ................................................................................................................ 57
18.5. CancelarCursoSENA ........................................................................................................... 58
18.6. EnrolamientoAprendizSENA .............................................................................................. 59
18.7. EnrolamientoInstructorSENA ............................................................................................ 60
18.8. DesactivarUsuarioSENA ..................................................................................................... 61
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 4 de 73
Fecha: 26-06-2012
18.9. CargueNotasSENA ............................................................................................................. 62
10. Modelo de datos ................................................................................................................... 64
11. Control del proceso – Registros de mensajes ....................................................................... 67
12. Catálogos de aplicación ......................................................................................................... 72
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 5 de 73
Fecha: 26-06-2012
1. Objetivo El presente documento corresponde a la especificación en UML de los casos de uso de las
funcionalidades de interoperabilidad para las aplicaciones SOFIA Plus y la plataforma de
Bilingüismo del SENA y en general el esquema aplicable para la integración de la aplicación SOFIA
Plus con las plataformas de Bilingüismo.
2. Descripción del sistema (SOFIA Plus – Bilingüismo) La implementación del esquema de interoperabilidad tiene dos componentes definidos: El primer
componente será el encargado de interactuar con las plataformas de bilingüismo para realizar la
programación de las pruebas y obtener la información de los resultados obtenidos por los
aspirantes, el segundo componente se encargará de la gestión de los cursos desde SOFIA Plus
hacia la plataforma.
Ambos componentes son diseñados con el objetivo de asegurar una estructura genérica, mediante
la cual se pueda realizar este proceso con cualquier plataforma similar. El diseño de los casos de
uso se ha realizado de manera genérica para que cualquiera que sea el proveedor pueda
integrarse con SOFIA Plus. Las operaciones de integración están definidas para que éstas sean
atómicas, en las cuales, en una sola invocación, se realizan todas las operaciones subsecuentes de
los procesos de integración.
Se concluye que los desarrollos que se realizaran en el proceso de unificación de Oficina Virtual y
SOFIA Plus, serán estándares a los procesos definidos por la Dirección de Formación Profesional y
cualquier proveedor de bilingüismo deberá integrarse a los desarrollos mencionados.
3. Alcance La especificación definida en el presente documento, involucra únicamente los requerimientos e
implementaciones necesarias para la operación de la integración entre las plataformas SOFIA
PLUS y las plataformas de Bilingüismo en lo relacionado con las operaciones de negocio necesarias
para que los aspirantes que se inscriban a programas de formación de bilingüismo puedan realizar
la prueba de valoración de nivel y aplicar al respectivo programa de formación de acuerdo al
resultado obtenido en la misma.
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 6 de 73
Fecha: 26-06-2012
4. Requerimientos funcionales
4.1. Casos de uso
Imagen 1: Diagramas de caso de uso Bilingüismo – Pruebas de nivel
uc Bilinguismo - Programación pruebas de ni...
SOFIA PLUS OFERTA -
INCRIPCIÓN
Programar prueba
Cancelar prueba por
petición del aspirante
SOFIA PLUS - TIMER
Obtener resultados
pruebas de niv el
Usuario Soporte
Reinicio manual de
prueba
Cargue manual de
resultados
Administrador de
Sistema / Administrador
de Interoperabilidad
Cancelación masiv a
pruebas
Cancelar prueba
Obtener resultados
pruebas
«invokes»
«invokes»
«invokes»
«invokes»
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 7 de 73
Fecha: 26-06-2012
Imagen 2: Diagramas de caso de uso Bilingüismo – Formación
uc Bilinguismo - formación
Crear curso
Enrolamiento
Aprendiz
Enrolamiento
Instructor
Desactiv ar Usuario
Desactiv ar curso
Integración - Bilinguismo
Reenv ío manual de
solicitud
Agente SGS /
Administrador de
Sistema
SOFIA PLUS - TIMER
Cargue notas finales
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 8 de 73
Fecha: 26-06-2012
4.2. Caso de uso detallado – Programar pruebas
Nombre: Programar pruebas
Descripción:
La aplicación SOFIA PLUS – OFERTA envía las solicitudes de programación de las pruebas a
la plataforma de bilingüismo correspondiente, registrando la información del usuario con
los datos básicos de SOFIA PLUS. Dicha plataforma retorna la confirmación de
programación de la prueba y los datos de acceso para que los aspirantes presenten las
pruebas. Una vez confirmada la inscripción, el sistema envía un correo al aspirante con la
información de acceso y el detalle sobre plazos y condiciones para la presentación de las
pruebas.
En caso de que desde SOFIA PLUS se esté enviando una programación de prueba y en la
plataforma de bilingüismo ya exista una prueba programada para el aspirante, la
plataforma de bilingüismo deberá cancelar la anterior programación y registrar la nueva
de forma automática.
Actores:
SOFIA PLUS - OFERTA
INTEGRACIÓN – PRUEBA BILINGÜISMO
PLATAFORMA DE BILINGÜISMO
Precondiciones:
SOFIA PLUS funciona correctamente.
Existe conectividad entre SOFIA Plus – OFERTA y la plataforma de bilingüismo
Están parametrizados y configurados todos los elementos de configuración en las tablas y en la aplicación para la interoperabilidad con la plataforma de bilingüismo.
Flujo Principal:
1. El paquete funcional de inscripción de la aplicación SOFIA PLUS – OFERTA, en el marco del proceso de inscripción a un programa de bilingüismo realizado por un aspirante SENA, notifica al paquete funcional de integración de pruebas de bilingüismo la solicitud de programación de prueba de nivel. El sistema SOFIA PLUS – OFERTA deberá enviar los siguientes parámetros en el momento de la solicitud de programación de prueba de nivel:
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 9 de 73
Fecha: 26-06-2012
Id_PruebaNivel_Sofia
NIS
Nombres
Apellidos (Primer + segundo apellido registrado en SOFIA PLUS)
Idioma
Correo
2. El paquete de integración con bilingüismo construye un mensaje con los siguientes datos (Todos los datos son obligatorios), para cada una de las peticiones de programación de pruebas recibidas:
Id_PruebaNivel_Sofia
NIS
Nombres
Apellidos (Primer + segundo apellido registrado en SOFIA PLUS)
Idioma
Correo electrónico
3. El sistema SOFIA PLUS construye un arreglo de solicitudes de programación de prueba, el cual estará compuesto por mínimo un elemento.
4. El paquete de integración con bilingüismo invoca el Webservice de PROGRAMACIÓN DE PRUEBA (programarPruebaSENA) de la plataforma de bilingüismo, enviando los datos del mensaje construido (arreglo de solicitudes de programación de prueba). El sistema deberá construir la URL de invocación del API a partir de la información registrada en el catálogo de plataforma de bilingüismo en SOFIA Plus y consultando el alias del API (Nombre de las operaciones y el Access point al webservice) en un XML donde se almacenan estos valores.
5. El sistema esperará durante máximo 30 segundos por la respuesta generada por la
plataforma de bilingüismo a la cual se envió la solicitud. Esta deberá devolver un código y unos parámetros de respuesta [E2]:
Código de respuesta
Descripción Parámetros de retorno
0 La prueba se programa de manera exitosa.
url_prueba: Es la URL generada por la plataforma para acceder a la prueba de
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 10 de 73
Fecha: 26-06-2012
nivel.
1 Error en la programación de la prueba.
Ninguno
2 Longitud de UserName inválido
Ninguno
3 Longitud de Nombre inválido Ninguno
4 Longitud de Apellido inválido Ninguno
5 Correo electrónico inválido Ninguno
6. El sistema recibe la respuesta de la plataforma de bilingüismo con los siguientes parámetros:
Id_PruebaNivel_Sofia
URL
Usuario
Contraseña
Fecha creación prueba
Código tipo de respuesta De acuerdo al tipo de respuesta realiza las siguientes acciones: Código de respuesta 0: Valida que se haya recibido correctamente el parámetro de URL. Si es correcto retorna al proceso de Inscripción código de programación correcta y la cadena con la URL. Código de repuesta diferente de 0: Retorna un código de error y un mensaje con la indicación del error presentado.
Flujo Alternativo:
Ninguno.
Excepciones:
[E2] Si se presenta un timeout de la invocación se deberá devolver una notificación
indicando que la prueba no pudo ser programada y que el usuario deberá realizar un
nuevo intento.
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 11 de 73
Fecha: 26-06-2012
Post condiciones:
Una vez entregada la información al paquete funcional de Inscripción de SOFIA PLUS dicho
paquete deberá registras la información de la prueba en la tabla de control de pruebas
PRUEBAS_NIVEL_BILINGUISMO.
4.3. Caso de uso detallado – Cancelación masiva pruebas
Nombre: Cancelación masiva pruebas
Descripción:
SOFIA Plus mediante un TIMER de sistema del componente de interoperabilidad, realizará
una verificación en la cual las pruebas de nivel programadas serán canceladas cuando el
plazo de 15 días haya expirado para inscripciones en la bolsa nacional y 3 meses en la
bolsa se centro (Estos deben ser valores parametrizable por el Sistema).
Adicionalmente para los casos en que la inscripción del aspirante al programa de
bilingüismo se cancela en SOFIA Plus, el sistema envía una notificación a la plataforma de
bilingüismo para cancelar la prueba que estaba programada.
Observaciones: se asume que la plataforma de bilingüismo realizará la cancelación de
la prueba de manera automática, cuando ha sido presentada completa y correctamente
realizada por el aspirante. La plataforma de bilingüismo solo enviará los resultados
completos de las pruebas. Las pruebas que se hayan presentando parcialmente deberán
ser reiniciadas y reprogramadas de manera automática por la plataforma de bilingüismo y
deberá notificarle al aprendiz que la prueba no se presento de manera exitosa.
Actores:
SOFIA PLUS – Componentes de interoperabilidad bilingüismo.
SOFIA PLUS - Oferta
Plataforma de bilingüismo.
Precondiciones:
SOFIA PLUS funciona correctamente.
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 12 de 73
Fecha: 26-06-2012
La plataforma de bilingüismo funciona correctamente.
Existe conectividad entre las plataformas SOFIA PLUS – Bilingüismo.
Flujo Principal:
1. SOFIA Plus ejecuta de manera diaria un TIMER de sistema, el cual verifica los casos cuyo periodo para la presentación de las pruebas de nivel ha expirado, 15 días para inscripciones en la bolsa nacional y 3 meses en la bolsa se centro (Estos deben ser valores parametrizable por el Sistema). [A1]
2. Con el listado de pruebas expiradas, se invoca el caso de uso cancelación de pruebas Extend:CANCELAR PRUEBA. El proceso de envío de peticiones, deberá enviarlas por grupos. La cantidad de peticiones enviadas deberá ser parametrizable en el sistema. La información a enviar para cada una de las pruebas a cancelar, corresponde al Id_PruebaNivel_Sofia.
3. Para cada una de las pruebas canceladas, se deberá actualiza el estado en la tabla PRUEBAS_NIVEL_BILINGUISMO al estado VENCIDA y debe actualizar la fecha en la que la prueba fue cancelada.
4. EL sistema deberá realizar la actualización en la inscripción asociada al aspirante, reclasificando al aspirante al nivel básico de bilingüismo aplicable al programa de formación asociado para las inscripciones de centro y cancelando las inscripciones de las pruebas de nivel no realizadas por bolsa nacional. El sistema deberá notificar al usuario vía email de la inscripción realizada (Debe quedar en estado inscrito).
Flujo Alternativo:
[A1] Cuando el aspirante solicita cancelación de la inscripción al programa de bilingüismo,
el sistema SOFIA Plus en el momento de aplicar la cancelación deberá invocar el método
para cancelar la prueba en la plataforma de bilingüismo.
La cancelación de la prueba se realiza online pero no se espera repuesta o confirmación de
la plataforma de bilingüismo.
Excepciones:
Ninguno.
Post condiciones:
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 13 de 73
Fecha: 26-06-2012
Ninguno.
4.4. Caso de uso detallado – Cancelación prueba por petición del Aspirante
Nombre: Cancelación prueba por petición del Aspirante
Descripción:
Para los casos, en que un aspirante del SENA se encuentre preinscrito en programas de
bilingüismo y decida cancelar dicha preinscripción, ya sea directamente o a través de una
solicitud a la mesa de ayuda, el paquete funcional encargado de dicha operación en SOFIA
Plus, deberá invocar en el paquete de integración de interoperabilidad con bilingüismo la
operación para realizar la cancelación de pruebas.
Una vez realizada la invocación SOFIA Plus deberá completar el proceso de cancelación de
la prueba previamente programada.
Actores:
SOFIA PLUS – Sistema cancelación inscripciones
SOFIA PLUS – Componentes de interoperabilidad bilingüismo.
Precondiciones:
SOFIA PLUS funciona correctamente.
La plataforma de bilingüismo funciona correctamente.
Existe conectividad entre las plataformas SOFIA PLUS – Bilingüismo.
Flujo Principal:
1. SOFIA PLUS mediante el módulo de cancelación de inscripciones en el paquete funcional de inscripciones, realiza el llamado al método de cancelación de pruebas de nivel, del paquete funcional de integración con bilingüismo.
2. En la invocación el sistema debe indicar el ID de la prueba de nivel Id_PruebaNivel_Sofia de la inscripción para el cual se realizará la cancelación de la prueba de nivel.
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 14 de 73
Fecha: 26-06-2012
3. El paquete de integración de SOFIA PLUS invoca el proceso de cancelar prueba pasando la información del NIS (Obtenido del Id_PruebaNivel_Sofia) para el cual se realizará dicha cancelación. Extend: CANCELAR PRUEBA.
5. Para cada una de las pruebas canceladas, se deberá actualiza el estado en la tabla PRUEBAS_NIVEL_BILINGUISMO al estado CANCELADA.
Flujo Alternativo:
Ninguno
Excepciones:
Ninguno.
Post condiciones:
Ninguno.
4.5. Caso de uso detallado – Cancelar prueba
Nombre: Cancelar prueba
Descripción:
Para los casos en que se solicita cancelación de prueba, bien sea por un proceso masivo o
un proceso manual, el paquete funcional de integración con bilingüismo realiza la
invocación del webservice en la plataforma de bilingüismo, reportándole la cancelación de
una prueba previamente programada.
Actores:
SOFIA PLUS – Componentes de interoperabilidad bilingüismo.
SOFIA PLUS - Oferta
Plataforma de bilingüismo.
Precondiciones:
SOFIA PLUS funciona correctamente.
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 15 de 73
Fecha: 26-06-2012
La plataforma de bilingüismo funciona correctamente.
Existe conectividad entre las plataformas SOFIA PLUS – Bilingüismo.
Flujo Principal:
1. El paquete funcional de integración con pruebas de bilingüismo recibe una solicitud de cancelación de prueba, provenientes de alguno de los procesos de la aplicación SOFIA PLUS.
2. El sistema arma un mensaje para el webservice con el arreglo de los NIS de aspirantes enviados y el código del idioma del que se cancelará la prueba.
3. El sistema invoca el webservice en la plataforma de bilingüismo CancelarPruebaSENA pasando el arreglo de los NIS-Idioma en el mensaje construido previamente. [E1]. Para los mensajes enviados se deberá almacenar un registro en la tabla de control del proceso, incluyendo detalle de los casos enviados en la tabla de detalle del control del proceso. (Almacenando tipo de operación cancelación, el NIS del aspirante y el Idioma del que se cancela la prueba).
Flujo Alternativo:
Ninguno
Excepciones:
[E1]. Si se presenta un error http del tipo 404 o similar en el cual la plataforma de
bilingüismo no responde a la solicitud enviada, el sistema creará el registro del mensaje
con el estado pendiente y será reprocesado en la próxima ejecución del proceso.
Post condiciones:
Ninguno.
4.6. Caso de uso detallado – Reinicio manual de prueba
Nombre: Reinicio manual de prueba
Descripción:
A través de la opción disponible dentro del rol de “Integrador” o “Grupo de innovación de
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 16 de 73
Fecha: 26-06-2012
la Formación” en SOFIA PLUS, se envía la solicitud de reprogramación de la prueba al
sistema de bilingüismo, con la información del NIS del aspirante y el idioma. La plataforma
de bilingüismo usará para la atención de dichas solicitudes el mismo API de programación
de pruebas. La prueba programada previamente en la plataforma de bilingüismo, no será
tenida en cuenta.
Actores:
SOFIA Plus
Plataforma de bilingüismo.
Precondiciones:
SOFIA Plus funciona correctamente.
La plataforma de bilingüismo funciona correctamente.
Existe conectividad entre las plataformas SOFIA Plus – Bilingüismo.
El aspirante al que se le reprograme la prueba no puede estar en formación ni tener aprobados niveles en el idioma al que se intente reiniciar la prueba. Si existen niveles aprobados en dicho idioma el aprendiz será inscrito en el último nivel aprobado para el idioma seleccionado. La prueba programada previamente en la plataforma de bilingüismo, no será tenida en cuenta.
Flujo Principal:
1. El sistema SOFIA PLUS envía la solicitud de reprogramación de prueba, enviando la misma información que aplica para el caso de la programación inicial de la prueba de nivel (Invocación del webservice programaPruebaSENA). [E1]. Antes de realizar la solicitud de reinicio de la prueba, el sistema SOFIA PLUS deberá validar que se está dentro del periodo de 15 días destinado para que los aspirantes presentes las pruebas de nivel de inglés [E2] para pruebas de bolsa Nacional o 3 meses para pruebas de centro . Extend:PROGRAMAR PRUEBA. los parámetros que enviarán son:
NIS de aspirante a quien se le reiniciará la prueba.
Idioma del que se reiniciará la prueba.
A partir de la reprogramación o reinicio de la prueba, el sistema habilitará nuevamente la prueba durante el tiempo en las pruebas estarán habilitadas (parámetro de sistema).
2. Una vez recibida la confirmación del reinicio de la prueba, el componente de
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 17 de 73
Fecha: 26-06-2012
interoperabilidad envía una respuesta hacia SOFIA Plus, para que sea informado el usuario que solicitó el reinicio de prueba. SOFIA Plus envía un correo electrónico con la información de acceso a la prueba de nivel, el mensaje será el mismo que se envía cuando la prueba de nivel fue programada.
3. El sistema debe almacenar el histórico de estas acciones en la tabla de control del proceso y puede ser consultado por el grupo de innovación. Los parámetros almacenados en el histórico son:
Quien realizo el reinicio de la prueba,
Aspirante a quien se le realizo el reinicio de prueba
Fecha de realización de la acción.
Nota obtenida en la prueba fallida. En todo caso el componente de interoperabilidad envía una respuesta hacia SOFIA Plus, para que sea informado el agente SGS.
Flujo Alternativo:
Ninguno.
Excepciones:
[E1] No se pudo realizar el reinicio de la prueba por problemas de comunicación con la
plataforma de bilingüismo. En este caso el usuario de soporte deberá indicar que el caso
queda pendiente y se intentará más tarde la realización del proceso.
[E2] La aplicación deberá devolver un mensaje para que la aplicación SOFIA PLUS notifique
al usuario que el plazo venció y las pruebas no pueden ser reprogramadas.
Post condiciones:
Ninguno.
4.7. Caso de uso detallado – Obtener resultados pruebas de nivel
Nombre: Obtener resultados pruebas de nivel
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 18 de 73
Fecha: 26-06-2012
Descripción:
De manera diaria la aplicación SOFIA Plus mediante el componente de interoperabilidad,
consultará la información de los resultados finales de las pruebas realizadas por los
aspirantes, (no se cargará información de resultados parciales). Los resultados de la
pruebas se registrarán en SOFIA Plus y a partir del resultado obtenido se reclasificará la
inscripción del aprendiz a la bolsa de inscripciones (ficha de caracterización) acorde al nivel
obtenido en la prueba.
Actores:
SOFIA Plus – Componente de interoperabilidad pruebas bilingüismo.
Plataforma de bilingüismo.
Precondiciones:
SOFIA Plus funciona correctamente.
La plataforma de bilingüismo funciona correctamente.
Existe conectividad entre las plataformas SOFIA Plus – Bilingüismo.
Flujo Principal:
1. El sistema SOFIA Plus inicia el TIMER de cargue de resultados de pruebas de nivel.
2. El TIMER de SOFIA Plus invoca la interfaz de comunicación con la plataforma de bilingüismo solicitando los resultados registrados para el día anterior (La fecha corresponde al momento de presentación de la prueba). Para realizar esto, se invoca la operación de obtener resultados (Webservice ObtenerResultadosPruebaSENA) pasando como parámetro la fecha; la plataforma de bilingüismo devolverá un XML con la información de los resultados usando la siguiente estructura:
NIS
Idioma de prueba
Nivel Obtenido
Fecha (Fecha en que se presentó la prueba)
3. El componente de interoperabilidad valida los registros entregados por la
plataforma de bilingüismo.
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 19 de 73
Fecha: 26-06-2012
4. Para los registros que son válidos, el sistema realiza el cargue de los datos en la tabla de control de pruebas de bilingüismo. Registrando la siguiente información en la tabla PRUEBAS_NIVEL_BILINGUISMO [E1]:
Fecha de presentación de la prueba (dd/mm/aaaa hh24:mi:ss)
Nivel Obtenido. (El valor final obtenido deberá corresponder a uno de los niveles aplicables a la plataforma de bilingüismo, los cuales estará definidos en SOFIA Plus.
Esta información podrá ser consultada por los usuarios con role “Grupo de Innovación de formación”, “CallCenter” y demás roles que pueden consultar información relacionada a inscripciones.
5. Para el registro cargado se debe actualizar la información de la inscripción del
aspirante al estado inscrito en el nivel obtenido después de presentar la prueba.
6. Se le envía un correo electrónico al aspirante con la información de la inscripción en la que quedó confirmado.
7. Para validaciones del SENA, el sistema cada vez que el timer se ejecute debe almacenar en un histórico la siguiente información que podrá ser consultada por el grupo de innovación de la formación:
Fecha de ejecución del timer.
Número de registros que debe traer
Número de registros obtenidos satisfactoriamente.
Flujo Alternativo:
Para los registros que tienen error se guardan en un Log en base de datos y se genera un
archivo con el detalle de errores del Log
Excepciones:
[E1]. En caso de que se identifique que la información de resultados de la prueba ya había
sido cargada, no se actualizará la información registrada previamente. Se debe inscribir en
el Log un registro con la indicación de que el resultado de la prueba ya había sido
registrado previamente.
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 20 de 73
Fecha: 26-06-2012
Post condiciones:
El aspirante queda INSCRITO dentro del nivel correspondiente
Regla de negocio
4.8. Caso de uso detallado – Cargue manual de resultados pruebas de nivel
Nombre: Cargue manual de resultados pruebas de nivel
Descripción:
El Administrador de Sistema / Administrador de Interoperabilidad tiene la opción de
ejecutar de manera manual el cargue de resultados de las pruebas de nivel de bilingüismo.
Mediante esta opción el administrador indica la información de fecha (DD/MM/YYYY) y el
sistema inicia el proceso de cargue, también podrá buscar un aprendiz especifico para
cargar los resultados de este.
Actores:
Administrador de Sistema / Administrador de Interoperabilidad
SOFIA Plus – Componente de interoperabilidad pruebas bilingüismo.
Plataforma de bilingüismo.
Precondiciones:
SOFIA Plus funciona correctamente.
La plataforma de bilingüismo funciona correctamente.
Existe conectividad entre las plataformas SOFIA Plus – Bilingüismo.
Flujo Principal:
1. El usuario ingresa con rol Administrador de Sistema al paquete funcional de administración del sistema y a la opción de cargue pruebas de bilingüismo.
2. El sistema presenta la información para el ingreso de la fecha o búsqueda de Usuario. Adicionalmente le presenta la opción de iniciar proceso.
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 21 de 73
Fecha: 26-06-2012
3. El usuario registra la fecha para la cual se desea realizar el cargue datos o la
búsqueda del usuario al cual se le desea cargar el resultado, y da la opción de iniciar el proceso. El sistema invoca el proceso de ejecución del cargue INCLUDE: Obtener resultados pruebas de nivel.
4. Si la búsqueda se hace por NIS y el aprendiz tiene varias pruebas de nivel programadas (Ingles, francés), el administrador seleccionará sobre cual cargará el resultado obtenido.
Flujo Alternativo:
Ninguno.
Excepciones:
Ninguno.
Post condiciones:
Ninguno.
4.9. Caso de uso detallado – Crear curso
Nombre: Crear curso
Descripción:
La Aplicación SOFIA Plus mediante un TIMER de sistema consulta la información
relacionada con eventos de actualizaciones de fichas de caracterización de programas de
bilingüismo, en las tablas de control de eventos (INTEGRACION.INDICE_CAMBIO). El
evento que se considera corresponde a la actualización del estado de la ficha a “EN
EJECUCIÓN”. Para el listado de fichas que cumplen con esta condición se enviará la
notificación a la plataforma de bilingüismo para que realice la creación del curso.
Actores:
SOFIA Plus – Componente de interoperabilidad bilingüismo.
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 22 de 73
Fecha: 26-06-2012
Plataforma de bilingüismo.
Precondiciones:
SOFIA Plus funciona correctamente.
La plataforma de bilingüismo funciona correctamente.
Existe conectividad entre las plataformas SOFIA Plus – Bilingüismo.
Flujo Principal:
1. SOFIA Plus consulta la información correspondiente a la fichas de caracterización de programas de bilingüismo que han cambiado su estado a “EN EJECUCIÓN”, revisando los eventos en la tabla índice cambio correspondientes a actualizaciones de ficha.
2. Para cada una de las fichas identificadas se invoca el método de creación de cursos en la plataforma de bilingüismo pasando los siguientes datos: [E1]
Código de la ficha de caracterización (ClassName).
Idioma
Nivel del Idioma
Código Regional
Código Centro
Nombre del programa de formación al que pertenece la ficha.
3. Todos los registros enviados al proveedor para la creación de programas deben ser
registrados en una tabla de control de procesos. Los registros de esta tabla asociados a las fichas deben almacenar:
Id_Ficha
Fecha de envío del mensaje.
Estado (Enviado, Pendiente, Creado, Reenviado)
Tipo de mensaje (Curso / Usuario)
Id_Error
Id_plataforma_bilinguismo
El sistema permitirá al grupo de Innovación de FPI ver la información de las fichas registradas en la tabla de control de procesos de bilingüismo con el respectivo código de error. El proveedor debe proporcionar al SENA el listado de los errores (excepciones) para poder tramitar la solución.
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 23 de 73
Fecha: 26-06-2012
Flujo Alternativo:
Ninguno.
Excepciones:
[E1]. Si se presenta un error http del tipo 404 o similar en el cual la plataforma de
bilingüismo no responde a la solicitud enviada, el sistema creará el registro del mensaje
con el estado pendiente y será reprocesado en la próxima ejecución del proceso.
Post condiciones:
Ninguno.
4.10. Caso de uso detallado – Desactivar curso
Nombre: Desactivar curso
Descripción:
La Aplicación SOFIA Plus mediante un TIMER de sistema consulta la información
relacionada con eventos de actualizaciones de fichas de caracterización de programas de
bilingüismo, en las tablas de control de eventos (INTEGRACION.INDICE_CAMBIO). El
evento que se considera corresponde a la actualización del estado de la ficha a
“TERMINADA”, “TERMINADA POR UNIFICACIÓN” o “CANCELADA”. Para el listado de
fichas que cumplen con esta condición se enviará la notificación a la plataforma de
bilingüismo para que realice la cancelación del curso.
Actores:
SOFIA Plus – Componente de interoperabilidad bilingüismo.
Plataforma de bilingüismo.
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 24 de 73
Fecha: 26-06-2012
Precondiciones:
SOFIA Plus funciona correctamente.
La plataforma de bilingüismo funciona correctamente.
Existe conectividad entre las plataformas SOFIA Plus – Bilingüismo.
Flujo Principal:
1. SOFIA Plus consulta la información correspondiente a la fichas de caracterización de programas de bilingüismo que han cambiado su estado a “TERMINADA”, “TERMINADA POR UNIFICACIÓN” o “CANCELADA”, revisando los eventos en la tabla INDICE_CAMBIO correspondientes a actualizaciones de ficha.
2. Para cada una de las fichas identificadas se invoca el método de cancelación de cursos en la plataforma de bilingüismo pasando el código de la ficha (ClassName). [E1].
1. Una vez SOFIA Plus notifica al proveedor que un programa debe ser desactivado el
proveedor debe desactivar a todos los aprendices e instructores del programa, pero el programa quedará visible durante un tiempo definido por el SENA. Todos los registros enviados al proveedor para la desactivación de programas deben ser registrados en la tabla de control de procesos. Los registros de esta tabla asociados a las fichas desactivadas deben ser:
Id_Ficha
Fecha de envío del mensaje.
Estado (Enviado, Pendiente, Desactivado, Reenviado)
Tipo de mensaje (Curso / Usuario)
Código de la ficha
Id_Error
Id_plataforma_bilinguismo El sistema permitirá al grupo de Innovación de FPI ver la información de las fichas registradas en la tabla que se han desactivado.
Flujo Alternativo:
Ninguno.
Excepciones:
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 25 de 73
Fecha: 26-06-2012
[E1]. Si se presenta un error http del tipo 404 o similar en el cual la plataforma de
bilingüismo no responde a la solicitud enviada, el sistema creará el registro del mensaje
con el estado pendiente, y será reprocesado en la próxima ejecución del proceso.
Post condiciones:
Ninguno.
4.11. Caso de uso detallado – Enrolamiento Aprendiz
Nombre: Enrolamiento Aprendiz
Descripción:
La Aplicación SOFIA Plus mediante un TIMER de sistema, consulta la información
relacionada con eventos de paso de registros académicos a estado “EN TRÁNSITO”,
asociados a fichas de caracterización de programas de bilingüismo, en la tabla de control
de eventos denominada INTEGRACION.INDICE_CAMBIO. Para el listado de registros
académicos que cumplen con esta condición, se enviará la notificación a la plataforma de
bilingüismo para que realice el enrolamiento del aprendiz al curso. En caso de que el
usuario no esté creado en la plataforma de bilingüismo, dicho sistema deberá realizar la
creación del usuario con los datos enviados por SOFIA Plus.
Actores:
SOFIA Plus – Componente de interoperabilidad bilingüismo.
Plataforma de bilingüismo.
Precondiciones:
SOFIA Plus funciona correctamente.
La plataforma de bilingüismo funciona correctamente.
Existe conectividad entre las plataformas SOFIA Plus – Bilingüismo.
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 26 de 73
Fecha: 26-06-2012
Flujo Principal:
1. SOFIA Plus consulta la información correspondiente a los registros académicos de fichas de caracterización de bilingüismo que han cambiado su estado a “EN TRÁNSITO” revisando los eventos en la tabla INTEGRACION.INDICE_CAMBIO.
2. Para cada uno de los registros académicos identificados, se invoca el método de enrolamiento de aprendiz en la plataforma de bilingüismo pasando la siguiente información: [A1]
NIS
Nombres
Apellidos
Correo electrónico
Id_Ficha
3. Todos los registros enviados al proveedor para el enrolamiento de aprendices a
programas de bilingüismo deben ser registrados en una tabla de control de procesos. Los registros de esta tabla asociados a los enrolamiento deben tener:
Fecha de envío del mensaje.
Estado (Enviado, Pendiente, Creado, Reenviado)
Tipo de mensaje (Curso / Usuario)
NIS
Id_Ficha
Id_plataforma_bilinguismo
4. Para cada solicitud de enrolamiento de aprendiz enviada, se espera respuesta de la plataforma bilingüismo con la indicación del código de resultado. Si este corresponde a un error, debido a que el curso asociado al aprendiz, no ha sido creado aún, el mensaje se dejará como pendiente para que sea reprocesado por el TIMER de la aplicación.
Flujo Alternativo:
[A1] Cuando el usuario no existe en la plataforma de bilingüismo, ésta lo creará con los
datos de registro enviados por SOFIA Plus.
Excepciones:
[E1]. Si se presenta un error http del tipo 404 o similar en el cual la plataforma de
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 27 de 73
Fecha: 26-06-2012
bilingüismo no responde a la solicitud enviada, el sistema creará el registro del mensaje
con el estado pendiente y será reprocesado en la próxima ejecución del proceso.
Post condiciones:
Ninguno.
4.12. Caso de uso detallado – Enrolamiento Instructor
Nombre: Enrolamiento Instructor
Descripción:
La Aplicación SOFIA Plus mediante un TIMER de sistema, consulta la información
relacionada con la asignación de un instructor a la ficha de caracterización de programas
de bilingüismo, en la tabla de control de eventos (INTEGRACION.INDICE_CAMBIO). Para el
listado de instructores asociados a fichas en estado “EN EJECUCIÓN” se enviará la
notificación a la plataforma de bilingüismo, para que realice el enrolamiento del instructor
a la ficha. En caso de que el usuario instructor no esté creado en la plataforma de
bilingüismo, dicho sistema deberá realizar la creación del usuario con los datos enviados
por SOFIA Plus.
Desde SOFIA PLUS, se validará que las solicitudes de enrolamiento de instructores
enviadas sean consistentes, en relación principalmente a que las fichas o cursos hayan sido
previamente reportadas a la plataforma de bilingüismo.
Actores:
SOFIA PLUS – Componente de interoperabilidad bilingüismo.
Plataforma de bilingüismo.
Precondiciones:
SOFIA PLUS funciona correctamente.
La plataforma de bilingüismo funciona correctamente.
Existe conectividad entre las plataformas SOFIA PLUS – Bilingüismo.
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 28 de 73
Fecha: 26-06-2012
Flujo Principal:
1. SOFIA PLUS consulta la información relativa a la asignación de instructores a fichas de caracterización del programa bilingüismo (Operación de inserción en base de datos en la tabla INTEGRACION.INDICE_CAMBIO.
2. Para cada uno de los instructores identificados, se obtiene la información básica necesaria y se valida si se ha enviado la solicitud de creación de la ficha de caracterización a la cual corresponde el instructor que se está asociando a la plataforma de bilingüismo. La información que se enviará es la siguiente:
NIS Instructor.
Apellidos (Primer apellido + Segundo apellido)
Correo electrónico
Id_Ficha.
3. Todos los registros enviados al proveedor para el enrolamiento de instructores a programas de bilingüismo deben ser registrados en una tabla de control de procesos. Los registros de esta tabla asociados a los enrolamiento deben tener:
Fecha de envío del mensaje.
Estado (Enviado, Pendiente, Creado, Reenviado)
Tipo de mensaje (Curso / Usuario)
NIS Instructor
Id_Ficha
Id_plataforma_bilinguismo
4. Para cada solicitud de enrolamiento de instructor enviada a la plataforma de bilingüismo, se deberá crear un registro de control de notificaciones enviadas, en donde se registre la siguiente información [E1]:
5. Para cada solicitud de enrolamiento de instructor enviada, se espera respuesta de
la plataforma bilingüismo con la indicación del código de resultado. Si este corresponde a un error, debido a que el curso asociado al instructor, no ha sido creado aún, el mensaje se dejará como pendiente para que sea reprocesado por el TIMER de la aplicación.
Flujo Alternativo:
Ninguno.
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 29 de 73
Fecha: 26-06-2012
Excepciones:
[E1]. Si se presenta un error http del tipo 404 o similar en el cual la plataforma de
bilingüismo no responde a la solicitud enviada, el sistema creará el registro del mensaje
con el estado pendiente, y será reprocesado en la próxima ejecución del proceso.
Post condiciones:
Ninguno.
4.13. Caso de uso detallado - Enrolamiento Gestión Desarrollo Curricular a Fichas
Nombre: Enrolamiento Instructor
Descripción:
La Aplicación SOFIA Plus mediante un TIMER de sistema, consulta la información
relacionada con los coordinadores académicos asociados a los centros de las fichas de
caracterización en estado “EN EJECUCIÓN” de programas de bilingüismo en la tabla
(INTEGRACION.INDICE_CAMBIO). Se enviará la notificación a la plataforma de bilingüismo,
para que realice el enrolamiento de los usuarios con rol “Gestión Desarrollo Curricular” a
fichas del centro asociado a la ficha. En caso de que el usuario “Coordinador Académico”
no esté creado en la plataforma de bilingüismo, dicho sistema deberá realizar la creación
del usuario con los datos enviados por SOFIA Plus, incluyendo la creación del usuario
supervisor.
Desde SOFIA PLUS, se validará que las solicitudes de enrolamiento de usuarios con rol
“Gestión Desarrollo Curricular” enviadas sean consistentes, en relación principalmente a
que las fichas o cursos hayan sido previamente reportadas a la plataforma de bilingüismo.
Actores:
SOFIA PLUS – Componente de interoperabilidad bilingüismo.
Plataforma de bilingüismo.
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 30 de 73
Fecha: 26-06-2012
Precondiciones:
SOFIA PLUS funciona correctamente.
La plataforma de bilingüismo funciona correctamente.
Existe conectividad entre las plataformas SOFIA PLUS – Bilingüismo.
Flujo Principal:
1. SOFIA Plus consulta la información correspondiente a la fichas de caracterización de programas de bilingüismo que han cambiado su estado a “EN EJECUCIÓN”, revisando los eventos en la tabla índice cambio correspondientes a actualizaciones de ficha, adicionalmente consulta los usuarios con rol “Gestión Desarrollo Curricular” asociados el centro de la ficha
2. Para cada uno de los usuarios con rol “Gestión Desarrollo Curricular” identificados, se obtiene la información básica necesaria y se valida si se ha enviado la solicitud de creación de la ficha de caracterización a la cual corresponde el instructor que se está asociando a la plataforma de bilingüismo. La información que se enviará es la siguiente:
NIS Coordinador Académico
Apellidos (Primer apellido + Segundo apellido)
Correo electrónico
Id_Ficha
Código Centro
3. Todos los registros enviados al proveedor para el enrolamiento de usuarios con rol “Gestión Desarrollo Curricular” a programas de bilingüismo deben ser registrados en una tabla de control de procesos. Los registros de esta tabla asociados a los enrolamiento deben tener:
Fecha de envío del mensaje.
Estado (Enviado, Pendiente, Creado, Reenviado)
Tipo de mensaje (Curso / Usuario)
NIS Coordinador Académico
Id_Ficha
Id_plataforma_bilinguismo
4. Para cada solicitud de enrolamiento de instructor enviada a la plataforma de
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 31 de 73
Fecha: 26-06-2012
bilingüismo, se deberá crear un registro de control de notificaciones enviadas, en donde se registre la siguiente información [E1]:
5. Para cada solicitud de enrolamiento de usuarios con rol “Gestión Desarrollo
Curricular enviada, se espera respuesta de la plataforma bilingüismo con la indicación del código de resultado. Si este corresponde a un error, debido a que el curso asociado al usuario, no ha sido creado aún, el mensaje se dejará como pendiente para que sea reprocesado por el TIMER de la aplicación.
Flujo Alternativo:
Ninguno.
Excepciones:
[E1]. Si se presenta un error http del tipo 404 o similar en el cual la plataforma de
bilingüismo no responde a la solicitud enviada, el sistema creará el registro del mensaje
con el estado pendiente, y será reprocesado en la próxima ejecución del proceso.
Post condiciones:
Ninguno.
4.14. Caso de uso detallado – Desactivar usuario
Nombre: Desactivar usuario
Descripción:
La Aplicación SOFIA Plus mediante un TIMER de sistema, consulta la información
relacionada con la desactivación de un aprendiz o instructor de fichas de caracterización
de programas de bilingüismo, en la tabla de control de eventos
(INTEGRACION.INDICE_CAMBIO). Los eventos que se consideran, corresponden a:
Aprendiz: Actualización de registro académico a estado “CANCELADO”, “RETIRO VOLUNTARIO”, “CERTIFICADO” o “DESERTADO”.
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 32 de 73
Fecha: 26-06-2012
Instructor. Actualización de la información de instructor por ficha, cuando pierde la vigencia según el registro en SOFIA Plus.
Para el listado de usuarios que cumplen con estas condiciones se enviará la notificación a
la plataforma de bilingüismo para que realice la cancelación del usuario.
Actores:
SOFIA Plus – Componente de interoperabilidad bilingüismo.
Plataforma de bilingüismo.
Precondiciones:
SOFIA Plus funciona correctamente.
La plataforma de bilingüismo funciona correctamente.
Existe conectividad entre las plataformas SOFIA Plus – Bilingüismo.
Flujo Principal:
1. SOFIA Plus consulta la información correspondiente a los instructores que han perdido vigencia o a los aprendices que han sido actualizados (registros académicos), revisando los eventos en la tabla INTEGRACION.INDICE_CAMBIO correspondientes.
2. Para cada uno de los usuarios identificados, se invoca el método de cancelación de usuario en la plataforma de bilingüismo pasando el NIS y el código de la ficha de caracterización. La información que se enviará es la siguiente:
NIS
Id_Ficha
3. Todos los registros enviados al proveedor para el enrolamiento de desactivación de usuarios a la plataforma de bilingüismo deben ser registrados en una tabla de control de procesos. Los registros de esta tabla asociados a los enrolamiento deben tener:
Fecha de envío del mensaje.
Estado (Enviado, Pendiente, Creado, Reenviado)
Tipo de mensaje (Curso / Usuario)
Tipo de Usuario (instructor aprendiz)
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 33 de 73
Fecha: 26-06-2012
NIS
Id_Ficha
Id_plataforma_bilinguismo
Flujo Alternativo:
Ninguno.
Excepciones:
[E1]. Si se presenta un error http del tipo 404 o similar en el cual la plataforma de
bilingüismo no responde a la solicitud enviada, el sistema creará el registro del mensaje
con el estado pendiente, y será reprocesado en la próxima ejecución del proceso.
Post condiciones:
Ninguno.
4.15. Caso de uso detallado – Reenvío manual de solicitud
Nombre: Reenvío manual de solicitud
Descripción:
El administrador del sistema o el administrador de sistema o grupo de Innovación de FP,
gestiona el envío manual de solicitudes en estado “PENDIENTE” hacia la plataforma de
bilingüismo. Para esto, debe diligenciar el filtro de búsqueda de la solicitud, según
corresponda:
Solicitudes de creación de curso
Solicitudes de desactivación de curso
Solicitudes de enrolamiento de aprendiz
Solicitudes de enrolamiento de instructor
Solicitudes de desactivación de usuario
Una vez la solicitud es reenviada, la información correspondiente al envío debe quedar
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 34 de 73
Fecha: 26-06-2012
actualizada en el registro de control, dependiendo del tipo de notificación.
Actores:
Administrador de sistema / Administrador de interoperabilidad
Precondiciones:
SOFIA Plus funciona correctamente.
La plataforma de bilingüismo funciona correctamente.
Existe conectividad entre las plataformas SOFIA Plus – Bilingüismo.
Flujo Principal:
1. El Administrador de sistema o grupo de Innovación de FP, diligencia el filtro de búsqueda de la solicitud utilizando una o más opciones de las siguientes:
Solicitud para creación de curso: o Código de la ficha de caracterización o Nombre del programa de formación al que pertenece la ficha. o Nivel o Fecha de inicio o Código de regional o Código de Centro
Solicitud para la desactivación de un curso: o Código de la ficha
Solicitud para el enrolamiento del aprendiz o Nombre de usuario (NIS) o Nombres o Apellidos (Primer apellido + Segundo apellido) o Correo electrónico o Código de la ficha de caracterización
Solicitud para el enrolamiento del instructor: o Nombre de usuario (NIS) o Nombres o Apellidos (Primer apellido + Segundo apellido) o Correo electrónico o Código de la ficha de caracterización
Solicitud para la desactivación de un usuario o NIS
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 35 de 73
Fecha: 26-06-2012
o Código de la ficha
2. El Administrador de sistema o grupo de Innovación de FP, selecciona la solicitud en estado “PENDIENTE” respectiva y procede con el envío manual, a través del botón “Reenviar Solicitud”.
3. El sistema configura nuevamente el mensaje de la solicitud (según los parámetros
anteriormente especificados) y envía a la plataforma de bilingüismo.
4. El sistema actualiza, en el registro de control, el estado de la notificación de acuerdo al tipo de solicitud y dependiendo de si ésta requiere respuesta o no: Información de control:
Fecha de envío del mensaje.
Estado (Enviado, Pendiente, Reenviado)
Tipo de mensaje (Curso / aprendiz / Instructor)
Código de la Ficha
NIS del usuario
Flujo Alternativo:
Ninguno.
Excepciones:
Ninguna.
Post condiciones:
Ninguno.
4.16. Caso de uso detallado – Cargue de notas finales.
Nombre: Cargue de notas finales
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 36 de 73
Fecha: 26-06-2012
Descripción:
La aplicación SOFIA PLUS mediante el paquete funcional de integración con plataformas de
bilingüismo, lanza un TIMER de la aplicación, mediante el cual se realiza un cargue diario o
con la frecuencia definida de los resultados obtenidos por los aprendices en una ficha
específica. Este proceso se realiza consultando la tabla INDICE_CAMBIO, e identificando las
fichas de caracterización que pasaron al estado “TERMINADA” en la aplicación.
Actores:
SOFIA PLUS – TIMER cargue de notas de bilingüismo.
PLATAFORMA DE BILINGUISMO.
Precondiciones:
SOFIA Plus funciona correctamente.
La plataforma de bilingüismo funciona correctamente.
Existe conectividad entre las plataformas SOFIA Plus – Bilingüismo.
Flujo Principal:
1. El proceso de SOFIA PLUS programado mediante un TIMER de la aplicación, realizará un cargue diario o con la frecuencia definida de los resultados obtenidos por los aprendices en una ficha específica. Este proceso se realiza consultando la tabla INDICE_CAMBIO, e identificando las fichas de caracterización que pasaron al estado “TERMINADA” en la aplicación.
2. El sistema para cada una de las fichas identificadas envía una petición a la plataforma de bilingüismo solicitando los resultados de los aprendices de esa ficha. El parámetro enviada corresponde únicamente al ID de la Ficha de SOFIA PLUS.
3. El cargue de los datos de las notas finales se deberá realizar en la tabla
RESULTADOS_BILINGUISMO, asociando los resultados obtenidos por el ID del registro académico del aprendiz.
Flujo Alternativo:
Ninguno.
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 37 de 73
Fecha: 26-06-2012
Excepciones:
Ninguna.
Post condiciones:
Ninguno.
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 38 de 73
Fecha: 26-06-2012
5. Diagramas de secuencia
6.1. Diagrama de secuencia – Programar prueba
sd Programar prueba
SOFIA_Plus «interface»
SVC_Integracion
«interface»
SVC_Idiomas
Plataforma_Idiomas
alt Error en la programación de la prueba
«inscripcion»
programaPrueba()
programarPruebaBilinguismo(nis,nombre,apellido,correo)
validarDatosCorreo()
conformarArray()
guardarInformacionControlEnvio()
activarTimeOut()
programarPrueba(nis,nombre,apellidos,correo,codigoControl)
generarPassword()
clasificarEnClase()
validarSintaxis()
programarPruebaSena()
validarUsuario()
generarUrlAccesoPrueba()
respuesta() :
l ink,resuesta/error
actualizarEstado() :Enviado
:error
actualizarEstado() :
Pendiente
resultadosProgramacionPrueba() :
error
resultadosProgramacionPrueba() :
URL,codigoProgramacionPrueba
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 39 de 73
Fecha: 26-06-2012
6.2. Diagrama de secuencia – Reprogramar prueba
6.3. Diagrama de secuencia – Reinicio manual de prueba
sd Reprogramar prueba
Usuario_Bilinguismo Plataforma_Idiomas
loop Error en intentos de presentación de prueba (15 días desde la inscripción)
presentarPruebaBilinguismo()
notificacionCorreo() :error
determinarTerminacionAnormal()
validarEstadoUsuario()
reactivarPrueba()
notificacionCorreo(url_presentacion_prueba)
sd Reinicio manual de prueba
Usuario_Bilinguismo SOFIA_Plus «interface»
SVC_Integracion
«interface»
SVC_Idiomas
Plataforma_Idiomas
ref
Programar prueba
reinicioManualPrueba()
«SGS»
validarTiempoPresentacionPrueba()
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 40 de 73
Fecha: 26-06-2012
6.4. Diagrama de secuencia – Cancelar prueba
sd Cancelar prueba
Usuario_Bilinguismo SOFIA_Plus «interface»
SVC_Integracion
«interface»
SVC_Idiomas
Plataforma_Idiomas
alt Error en la programación de la prueba
validarTiempoPresentacionPrueba()
notificacionCorreo(cancelacion de prueba)
cancelarPrueba() :nis
validarDatosCorreo()
conformarArray()
guardarInformacionControlEnvio()
activarTimeOut()
cancelarPrueba(nis)
validarSintaxis()
cancelarPruebaSena()
cancelarPruebaSena()
inhabilitarResultados()
respuesta()
actualizarEstado()
:error
actualizarEstado()
resultadoCancelacionPrueba() :error
resultadoCancelacionPrueba() :prueba cancelada
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 41 de 73
Fecha: 26-06-2012
6.5. Diagrama de secuencia – Obtener resultados prueba de nivel
sd Obtener resultados prueba de ni...
SOFIA_Plus «interface»
SVC_Integracion
«interface»
SVC_Idiomas
Plataforma_Idiomas
alt Error en la programación de la prueba
correrTimer()
obtenerResultadosPruebasNivel(fecha,nis)
validarDatosCorreo()
conformarArray()
guardarInformacionControlEnvio()
activarTimeOut()
obtenerResultadosPrueba(nis,fecha)
validarSintaxis()
conformarListaResultados()
respuesta() :
nis,date,reading,listening,grammar,...,final,nivel«array»
generarVistaResultadosIdiomas()
actualizarEstado(enviado)
actualizarFormato()
:error
actualizarEstado() :
pendienteresultadosPruebas(error)
resultadosPruebas(fecha,nis,reading,listening,grammar,...,final)
verificarResultado()
incripcionAlCurso()
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 42 de 73
Fecha: 26-06-2012
6.6. Diagrama de secuencia – Obtener resultados de curso
sd Obtener resultados de curso
SOFIA_Plus «interface»
SVC_Integracion
«interface»
SVC_Idiomas
Plataforma_Idiomas
alt Error en la programación de la prueba
correrTimer()
obtenerResultadosCurso()
validarDatosCorreo()
conformarArray()
guardarInformacionControlEnvio()
activarTimeOut()
obtenerResultadosCurso(fecha,nis)
validarSintaxis()
conformarListaResultados()
respuesta() :resultado,nis,fecha
generarVistaResultadosIdiomas()
actualizarEstado() :enviado
actualizarFormato()
:error
actualizarEstado() :pendiente
resultadosPruebas() :error
resutadosCurso()
verificarResultado()
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 43 de 73
Fecha: 26-06-2012
6.7. Diagrama de secuencia – Cargue manual de resultados
6.8. Diagrama de secuencia – Crear curso
sd Cargue manual de resultados de prueba
Usuario_Bilinguismo SOFIA_Plus «interface»
SVC_Integracion
«interface»
SVC_Idiomas
Plataforma_Idiomas
El proceso se correo
por solicitud del
administrados del
sistema o el
administrador de
interoperacbilidad y se
invoca el mismo
proceso para cargua
automático de
resultados (sin el timer)
ref
Obtener resultados prueba de niv el
cargueManualResultados()
actualizarFecha()
sd Crear curso
SOFIA_Plus «interface»
SVC_Integracion
«interface»
SVC_Idiomas
Plataforma_Idiomas
loop
alt error env io
actualizarEstadoFicha()
consultarEstadoFicha(estado:EN
EJECUCION)
validarDatosCorreo()
conformarArray()
guardarInformacionControlEnvio()
activarTimeOut()
crearClase(codigoFicha,nombrePrograma,nivel,starDate)
validarSintaxis()
crearClaseSena()
respuesta()
actualizarEstado() :Enviado
:error,404
actualizarEstado(Pendiente)
resultadoCreacionClase(error)
resultadoCreacionClase()
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 44 de 73
Fecha: 26-06-2012
6.9. Diagrama de secuencia – Desactivar curso
sd Desactiv ar cur...
SOFIA_Plus «interface»
SVC_Integracion
«interface»
SVC_Idiomas
Plataforma_Idiomas
loop error env io
desactivarCurso(codigo_ficha_caracterizacion)
validarDatosCorreo()
conformarArray()
guardarInformacionControlEnvio()
activarTimeOut()
desactivarClase(codigoFicha)
validarSintaxis()
desactivarClaseSena()
respuesta()
actualizarEstado(Enviado)
:error,404
actualizarEstado() :pendiente
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 45 de 73
Fecha: 26-06-2012
6.10. Diagrama de secuencia – Enrolamiento aprendiz
sd Enrolamiento aprendiz
SOFIA_Plus «interface»
SVC_Integracion
«interface»
SVC_Idiomas
Plataforma_Idiomas
ref
Crear curso
alt No existencia de la clase asociada
alt error en el enrolamiento
activacionRegistroAcademico(nis)
enrolamientoAprendiz(nis,fecha,fichaCaracterizacion)
validarDatosCorreo()
conformarArray()
guardarInformacionControlEnvio()
activarTimeOut()
enrolarAprendiz(nis,fichaCaracterizacion)
validarSintaxis()
enrolarAClase()
respuesta()
actualizarEstado(Enviado)
:error,404
actualizarEstado(Pendiente)
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 46 de 73
Fecha: 26-06-2012
6.11. Diagrama de secuencia – Enrolamiento instructor
sd Enrolamiento instructor
SOFIA_Plus «interface»
SVC_Integracion
«interface»
SVC_Idiomas
Plataforma_Idiomas
alt error en el enrolamiento
asiganarInstructorFicha()
enrolamientoInstructor(nis,fecha,fichaCaracterizacion)
validarDatosCorreo()
conformarArray()
guardarInformacionControlEnvio()
activarTimeOut()
enrolarInstructor(nis,fichaCaracterizacion)
validarSintaxis()
enrolarAClase()
respuesta()
actualizarEstado(enviado)
:error,404
actualizarEstado(pendiente)
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 47 de 73
Fecha: 26-06-2012
6.12. Diagrama de secuencia – Desactivar usuario
sd Desactiv ar usua...
SOFIA_Plus «interface»
SVC_Integracion
«interface»
SVC_Idiomas
Plataforma_Idiomas
alt error en la desactiv acion
«evento» cancelarFicha()
«evento» actualizarEstadoAprendiz()
«evento» actualizarVigenciaInstructor()
desactivarUsuario() :nis,ficha
validarDatosCorreo()
conformarArray()
guardarInformacionControlEnvio()
activarTimeOut()
desactivarUsuario(nis,ficha)
validarSintaxis()
desactivarUsuario(nis,clase)
respuesta()
actualizarEstado(enviado)
:error,404
actualizarEstado(pendiente)
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 48 de 73
Fecha: 26-06-2012
6.13. Diagrama de secuencia – Reenvío manual de solicitud
sd Reenv io manual de solicit...
Usuario_Bilinguismo SOFIA_Plus «interface»
SVC_Integracion
«interface»
SVC_Idiomas
Plataforma_Idiomas
Invocación del método
respectivo (sin timer)
refCrear curso
ref
Desactiv ar curso
refEnrolamiento aprendiz
refEnrolamiento instructor
refDesactiv ar usuario
reenviarSolicitud()
«Administracion»
«Administracion» reenvioManualSolicitud()
actualizarDatosBusqueda(creacion de curso, desactivacion curso, enrolamiento aprendiz, enrolamiento instructor, desactivacion usuario)
reenviarSolicitud(según solicitud)
actualizarEstado() :reenviado
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 49 de 73
Fecha: 26-06-2012
6. Diagrama de clases
class Bilinguismo
Usuario_Bilinguismo
- nis
+ notificacionCorreo()
SOFIA_Plus
- ficha_caracterizacion
+ activacionRegistroAcademico()
+ actualizarDatosBusqueda()
+ actualizarEstadoAprendiz()
+ actualizarEstadoFicha()
+ actualizarFecha()
+ actualizarVigenciaInstructor()
+ asiganarInstructorFicha()
+ cancelarFicha()
+ cargueManualResultados()
+ consultarEstadoFicha()
+ correrTimer()
+ incripcionAlCurso() : void
+ reenviarSolicitud()
+ reenvioManualSolicitud()
+ reinicioManualPrueba()
+ resultadoCancelacionPrueba()
+ resultadoCreacionClase()
+ resultadosProgramacionPrueba()
+ resultadosPruebas()
+ resutadosCurso()
+ validarTiempoPresentacionPrueba()
+ verificarResultado()
«inscripcion»
+ programaPrueba()
+ programarPruebaBilinguismo()
«interface»
SVC_Integracion
+ activarTimeOut()
+ actualizarEstado()
+ actualizarFormato()
+ cancelarPrueba()
+ conformarArray()
+ desactivarCurso()
+ desactivarUsuario()
+ enrolamientoAprendiz()
+ enrolamientoInstructor()
+ generarVistaResultadosIdiomas()
+ guardarInformacionControlEnvio()
+ obtenerResultadosCurso()
+ obtenerResultadosPruebasNivel()
+ programarPruebaBilinguismo()
+ reenviarSolicitud()
+ validarDatosCorreo()
Plataforma_Idiomas
- aprendiz
- clase
- instructor
- supervisor
- test_clase
+ cancelarPruebaSena()
+ conformarListaResultados()
+ crearClaseSena()
+ desactivarClaseSena()
+ desactivarUsuario()
+ determinarTerminacionAnormal()
+ enrolarAClase()
+ generarUrlAccesoPrueba()
+ inhabilitarResultados()
+ presentarPruebaBilinguismo()
+ programarPruebaSena()
+ reactivarPrueba()
+ validarEstadoUsuario()
+ validarUsuario()
«interface»
SVC_Idiomas
+ cancelarPrueba()
+ clasificarEnClase()
+ crearClase()
+ desactivarClase()
+ desactivarUsuario()
+ enrolarAprendiz()
+ enrolarInstructor()
+ generarPassword()
+ obtenerResultadosCurso()
+ obtenerResultadosPrueba()
+ programarPrueba()
+ respuesta()
+ validarSintaxis()
1
1
1 1..
1
1
1.. 1
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 50 de 73
Fecha: 26-06-2012
7. Diagrama de estados
stm Mensaj ...
Initial
Env iadoPendiente
Reenv iado
Final
[Respuesta:error,404,timeout]
/Actualizar informacionEnvioControl
[reenvio manual de solicitud]
[Respuesta:error,404,timeout]
/Actualizar informacionEnvioControl
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 51 de 73
Fecha: 26-06-2012
8. Requerimientos No Funcionales Esta sección documenta los requerimientos no funcionales de la integración entre SOFIA PLUS y
las plataformas de bilingüismo.
9.1. Confidencialidad
Los mensajes enviados entre Sofía Plus y las plataformas de bilingüismo en lo posible deberán ser
cifrados para garantizar que su contenido no pueda ser leído por un tercero que intercepte el
mensaje. SE revisará con cada uno de los proveedores los mecanismos y viabilidad de
implementación de mecanismos de cifrado y protección de datos.
9.2. Autenticidad
Para garantizar la identidad las plataformas de bilingüismo, éste deberá presentar un certificado
digital válido, o un mecanismo similar de manejo de tokens entre las plataformas. SE definirá de
manera conjunta con los proveedores el alcance y mecanismo de implementación de estas
medidas de seguridad.
9.3. Integridad
La integración debe garantizar la integridad entre los dos sistemas, es decir que todas las
peticiones enviadas a las plataformas de bilingüismo puedan ser verificadas y de ser necesario
reenviadas. Si falla el proceso automático, se debe garantizar que la información del mensaje sea
almacenada en algún log de error para poder recrear los mensajes.
9.4. Impacto sobre el Desempeño de los Sistemas
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 52 de 73
Fecha: 26-06-2012
El impacto sobre el desempeño percibido por el usuario en Sofía Plus debe ser mínimo por lo cual
el envío del mensaje de realizarse de manera asíncrona. El sistema SOFIA PLUS implementará para
los casos de envío masivos un control de flujo para la frecuencia de peticiones. Este control se
parametriza como el número de mensajes por minuto que puede ser enviado a las plataforma de
bilingüismo.
9.5. Escalabilidad
El sistema debe poder ser fácilmente modificado para manejar más carga transaccional. Los
niveles de servicio para escalabilidad serán definidos en una segunda fase del proceso de
implementación, posterior a la entrada en operación del esquema de integración entre las
plataformas.
9.6. Desempeño
Los parámetros de timeout y reintentos de conexión serán definidos por SOFIA Plus teniendo en
cuenta restricciones técnicas y una vez entre en operación el Sistema.
9.7. Trazabilidad
Todo error en el envío de un mensaje a las plataformas de bilingüismo debe quedar registrado en
un log con la información completa del mensaje para poder ser recreado manualmente. Se
utilizará un ID único asignado a cada uno de los mensajes generados desde la plataforma SOFIA
PLUS el cuál será referenciado a las transacciones administradas y procesadas las plataformas de
bilingüismo.
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 53 de 73
Fecha: 26-06-2012
9. Especificación Mensajes Webservice
A continuación se presente la estructura base de los mensajes SOAP, en relación a los
tipos de datos XSD que serán implementados para la ejecución de las operaciones con la
plataforma de bilingüismo.
18.1. ProgramarPruebaSENA
Esta operación realizar la solicitud de programación de prueba de nivel de bilingüismo.
Parámetros de entrada:
<xs:element name='idMensaje' type='xs:long'/>
<xs:complexType name='programacionPrueba'>
<xs:sequence>
<xs:element name='idUsuario' type='xs:string'/>
<xs:element name='nombres' type='xs:string'/>
<xs:element name='apellidos' type='xs:string'/>
</xs:sequence>
</xs:complexType>
Nombre Tipo Descripción
idMensaje xsd:long Código único asignado al mensaje generado por el sistema SOFIA PLUS.
idUsuario xsd:string Nombre de usuario. Corresponde al NIS del usuario asignado en SOFIA PLUS.
nombres xsd:int Nombre del usuario registrado en SOFIA PLUS.
apellidos xsd:long Apellidos del usuario registrado en SOFIA PLUS. (Primer y segundo apellido concatenados).
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 54 de 73
Fecha: 26-06-2012
Parámetros de salida:
<xs:element name='codigoError' type='xs:long'/>
<xs:complexType name='pruebasProgramadas'>
<xs:sequence>
<xs:element name='idUsuario' type='xs:string'/>
<xs:element name='urlPrueba' type='xs:string'/>
</xs:sequence>
</xs:complexType>
Nombre Tipo Descripción
codigoError xsd:long Código de error de la operación. Cuando se recibe un 0 (Cero) la operación fue realizada de manera exitosa.
idUsuario xsd:string Nombre de usuario. Corresponde al NIS del usuario asignado en SOFIA PLUS.
urlPrueba xsd:int URL absoluta mediante la cual el aspirante accede a la prueba de valoración de nivel. La url debe ser codificada para evitar la presentación de datos a los usuarios finales.
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 55 de 73
Fecha: 26-06-2012
18.2. CancelarPruebaSENA
Esta operación realiza la cancelación de una prueba de nivel previamente programada en
la plataforma de bilingüismo.
Parámetros de entrada:
<xs:element name='idMensaje' type='xs:long'/>
<xs:complexType name='cancelacionPrueba'>
<xs:sequence>
<xs:element name='idUsuario' type='xs:string'/>
</xs:sequence>
</xs:complexType>
Parámetros de salida: NO TIENE
Nombre Tipo Descripción
idMensaje xsd:long Código único asignado al mensaje generado por el sistema SOFIA PLUS.
idUsuario xsd:string Nombre de usuario. Corresponde al NIS del usuario asignado en SOFIA PLUS.
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 56 de 73
Fecha: 26-06-2012
18.3. ObtenerResultadosPruebaSENA
Esta operación obtiene un arreglo con los resultados de las pruebas obtenidas por los
aspirantes SENA, para una fecha específica (La fecha corresponde a la fecha de
presentación de la prueba).
Parámetros de entrada:
<xs:element name='idMensaje' type='xs:long'/>
<xs:element name='fecha' type='xs:date'/>
Parámetros de salida:
<xs:complexType name='resultadosPrueba'>
<xs:sequence>
<xs:element name='idUsuario' type='xs:long'/>
<xs:element name='language' type='xs: string'/>
<xs:element name='fechaPrueba' type='xs:date'/>
<xs:element name='reading' type='xs:string'/>
<xs:element name='listening' type='xs:string'/>
<xs:element name='grammar' type='xs:string'/>
<xs:element name='speaking' type='xs:string'/>
<xs:element name='final' type='xs:string'/>
</xs:sequence>
</xs:complexType>
Nombre Tipo Descripción
idMensaje xsd:long Código único asignado al mensaje generado por el sistema SOFIA PLUS.
fecha xsd:date Fecha para la cual se solicitan los resultados de la prueba de nivel.
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 57 de 73
Fecha: 26-06-2012
18.4. CrearCursoSENA
Esta operación envía un arreglo de cursos para que sean creados por la plataforma de
bilingüismo.
Parámetros de entrada:
<xs:element name='idMensaje' type='xs:long'/>
<xs:complexType name='listaCreacionCursos'>
<xs:sequence>
<xs:element name='idCurso' type='xs:long'/>
<xs:element name='nombrePrograma' type='xs:string'/>
<xs:element name='nivel' type='xs:string'/>
</xs:sequence>
</xs:complexType>
Parámetros de salida: No tiene.
Nombre Tipo Descripción
idMensaje xsd:long Código único asignado al mensaje generado por el sistema SOFIA PLUS.
idCurso xsd:long Código de la ficha de caracterización generado por SOFIA PLUS.
nombrePrograma xsd:string Nombre del programa de formación asociado a la ficha de caracterización.
nivel xsd:string Nivel del programa de bilingüismo aplicable a la plataforma (Por Ej. A1, B1, etc.)
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 58 de 73
Fecha: 26-06-2012
18.5. CancelarCursoSENA
Esta operación envía un arreglo con la lista de cursos a cancelar en la plataforma de
bilingüismo.
Parámetros de entrada:
<xs:element name='idMensaje' type='xs:long'/>
<xs:complexType name='listaCancelacionCursos'>
<xs:sequence>
<xs:element name='idCurso' type='xs:long'/>
</xs:sequence>
</xs:complexType>
Parámetros de salida: No tiene.
Nombre Tipo Descripción
idMensaje xsd:long Código único asignado al mensaje generado por el sistema SOFIA PLUS.
idCurso xsd:long Código de la ficha de caracterización generado por SOFIA PLUS.
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 59 de 73
Fecha: 26-06-2012
18.6. EnrolamientoAprendizSENA
Esta operación envía un arreglo con la lista de aprendices a ser enrolados en cursos en la
plataforma de bilingüismo.
Parámetros de entrada:
<xs:element name='idMensaje' type='xs:long'/>
<xs:complexType name='aprendices'>
<xs:sequence>
<xs:element name='idUsuario' type='xs:string'/>
<xs:element name='nombres' type='xs:string'/>
<xs:element name='apellidos' type='xs:string'/>
<xs:element name='email' type='xs:string'/>
<xs:element name='idCurso' type='xs:long'/>
</xs:sequence>
</xs:complexType>
Parámetros de salida: No tiene.
Nombre Tipo Descripción
idMensaje xsd:long Código único asignado al mensaje generado por el sistema SOFIA PLUS.
idUsuario xsd:string Nombre de usuario. Corresponde al NIS del usuario asignado en SOFIA PLUS.
nombres xsd:int Nombre del usuario registrado en SOFIA PLUS.
apellidos xsd:long Apellidos del usuario registrado en SOFIA PLUS. (Primer y segundo apellido concatenados).
idCurso xsd:long Código de la ficha de caracterización generado por SOFIA PLUS.
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 60 de 73
Fecha: 26-06-2012
18.7. EnrolamientoInstructorSENA
Esta operación envía un arreglo con la lista de los instructores que deben ser enrolados en
cursos y la lista de coordinadores académicos (Supervisores) que tienen a cargo el
seguimiento del instructor.
Parámetros de entrada:
<xs:element name='idMensaje' type='xs:long'/>
<xs:complexType name='instructores'>
<xs:sequence>
<xs:element name='idUsuario' type='xs:long'/>
<xs:element name='nombres' type='xs:string'/>
<xs:element name='apellidos' type='xs:string'/>
<xs:element name='email' type='xs:string'/>
<xs:element name='idCurso' type='xs:long'/>
<xs:complexType name='supervisores'>
<xs:sequence>
<xs:element name='idUsuarioSupervisor' type='xs:long'/>
<xs:element name='nombresSupervisor' type='xs:string'/>
<xs:element name='apellidosSupervisor' type='xs:string'/>
<xs:element name='emailSupervisor' type='xs:string'/>
</xs:sequence>
</xs:complexType>
</xs:sequence>
</xs:complexType>
Nombre Tipo Descripción
idMensaje xsd:long Código único asignado al mensaje generado por el sistema SOFIA PLUS.
idUsuario xsd:string Nombre de usuario. Corresponde al NIS del
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 61 de 73
Fecha: 26-06-2012
Parámetros de salida: No tiene.
18.8. DesactivarUsuarioSENA
Esta operación envía un arreglo con la lista de los usuarios (Instructores y aprendices) a
ser desactivados en curso específico.
Parámetros de entrada:
<xs:element name='idMensaje' type='xs:long'/>
<xs:complexType name='usuarios'>
<xs:sequence>
<xs:element name='idUsuario' type='xs:long'/>
<xs:element name='idCurso' type='xs:long'/>
</xs:sequence>
</xs:complexType>
usuario asignado en SOFIA PLUS.
nombres xsd:int Nombre del usuario registrado en SOFIA PLUS.
apellidos xsd:long Apellidos del usuario registrado en SOFIA PLUS. (Primer y segundo apellido concatenados).
idCurso xsd:long Código de la ficha de caracterización generado por SOFIA PLUS.
Nombre Tipo Descripción
idMensaje xsd:long Código único asignado al mensaje generado por el sistema SOFIA PLUS.
idUsuario xsd:string Nombre de usuario. Corresponde al NIS del usuario asignado en SOFIA PLUS.
idCurso xsd:long Código de la ficha de caracterización generado por SOFIA PLUS.
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 62 de 73
Fecha: 26-06-2012
Parámetros de salida: No tiene.
18.9. CargueNotasSENA
Esta operación obtiene la información de la matriz de notas finales para un programa de
bilingüismo para una ficha en particular.
Parámetros de entrada:
<xs:element name='idMensaje' type='xs:long'/>
<xs:element name='idCurso' type='xs:long'/>
Parámetros de salida:
<xs:complexType name='instructores'>
<xs:sequence>
<xs:element name='idUsuario' type='xs:long'/>
<xs:element name='PercentageDone' type='xs:string'/>
<xs:element name='TestAvgAll' type='xs:string'/>
<xs:element name='Project' type='xs:string'/>
<xs:element name=' ExitTest' type='xs:string'/>
<xs:element name=' TimeOnTask' type='xs:string'/>
<xs:element name=' Communication' type='xs:string'/>
Nombre Tipo Descripción
idMensaje xsd:long Código único asignado al mensaje generado por el sistema SOFIA PLUS.
idCurso xsd:long Código de la ficha de caracterización generado por SOFIA PLUS.
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 63 de 73
Fecha: 26-06-2012
<xs:element name='FinalGrade' type='xs:string'/>
<xs:element name='Comments ' type='xs:string'/>
</xs:sequence>
</xs:complexType>
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 64 de 73
Fecha: 26-06-2012
10. Modelo de datos La aplicación de integración con bilingüismo requiere para su operación de un grupo de
estructuras de datos mediante las cuales se registre y controle la información y programación de
las pruebas de nivel y de los procesos asociados.
ESQUEMA DE BASE DE DATOS: OFIVIRTUAL
PRUEBA_NIVEL_BI
Nombre de la columna Llave foránea Descripción Tipo de dato Requerido
PNB_ID Ninguna El código único de la prueba de nivel programada.
NUMBER (10) SI
ING_ID INSCRIPCION.
INGRESO_ASPIRANTE. ING_ID
Id asociado al registro de la tabla ingreso aspirante de SOFIA PLUS. La combinación de PNB_ID e ING_ID debe ser única en la tabla.
NUMBER (10) SI
PNB_FCH_INSCRIPCION Ninguna Fecha en la cual se registro la inscripción del aspirante.
DATE
PNB_FCH_REALIZACION Ninguna
Fecha en la cual el aspirante presentó la prueba en la plataforma de inglés.
DATE NO
PNB_ESTADO Ninguna
Estado de la programación de la prueba. Los estados son: 0: Programada: Pruebas para las cuales se envío el mensaje de programación a la plataforma de bilingüismo. 1: Completada: pruebas para las
NUMBER (1) SI
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 65 de 73
Fecha: 26-06-2012
cuales se recibió resultado. 2: Cancelada. Para las que son canceladas por el usuario. 3: Vencida. Esto para las pruebas que pasados los 15 días no se presentaron.
PNB_URL Ninguna
URL absoluta de acceso a la prueba por el aspirante. Cada vez que se realice una reprogramación de se deberá actualizar el dato.
VARCHAR(400) NO
PNB_NOTA_READING Ninguna
Nota obtenida por el aspirante en la prueba presentada para las habilidades de lectura del idioma al que ha aplicado.
VARCHAR2 (8) NO
PNB_NOTA_LISTENING Ninguna
Nota obtenida por el aspirante en la prueba presentada para las habilidades de compresión del idioma al que ha aplicado.
VARCHAR2 (8) NO
PNB_NOTA_GRAMMAR Ninguna
Nota obtenida por el aspirante en la prueba presentada para las habilidades de escritura del idioma al que ha aplicado.
VARCHAR2 (8) NO
PNB_NOTA_SPEAKING Ninguna
Nota obtenida por el
aspirante en la prueba
presentada para las
habilidades de habla
del idioma al que ha
VARCHAR2 (8) NO
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 66 de 73
Fecha: 26-06-2012
aplicado.
PNB_NIVEL
Valor de nota final entregado por la plataforma de bilingüismo.
VARCHAR2 (8) NO
Los resultados finales obtenidos en los cursos impartidos en las plataformas de Bilingüismo
deberán ser cargados en la siguiente estructura de datos:
ESQUEMA DE BASE DE DATOS: OFIVIRTUAL
RESULTADO_RGA_BI
Nombre de la columna Llave foránea Descripción Tipo de dato Requerido
RRB_ID Ninguna
El código único del mensaje. Corresponde a la llave primaria de la tabla.
NUMBER (10)
SI
RGA_ID MATRICULA.
REGISTRO_ACADEMICO. RGA_ID
Id al registro académico para el cual se registran las notas finales. La combinación de REB_ID y RGA_ID debe ser única.
NUMBER (10)
SI
RRB_FECHA_REGISTRO Ninguna
Fecha en la cual se registraron las notas finales en SOFIA PLUS.
DATE SI
RRB_PORCENTAJE_COMPLETADO Ninguna
% de completitud de las actividades del programa de formación.
NUMBER(13) NO
RRB _PROMEDIO_GENERAL Ninguna Nota obtenida por el aprendiz
NUMBER (2) NO
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 67 de 73
Fecha: 26-06-2012
promedio en todas las pruebas realizadas en el programa.
RRB_NOTA_PROYECTO Ninguna
Nota obtenida por el aprendiz en el proyecto de clase.
VARCHAR2 (8)
NO
RRB_NOTA_PRUEBA_FINAL Ninguna
Nota obtenida por el aprendiz en la prueba de valoración final del programa.
VARCHAR2 (8)
NO
RRB_TIEMPO_CURSADO Ninguna
Tiempo total (En
horas) usado por
el aprendiz para
completar el
programa de
formación en
bilingüismo.
VARCHAR2 (8)
NO
RRB_NOTA_COMUNICACION Ninguna
Valor de nota final para habilidades de comunicaciones en el idioma.
VARCHAR2 (8)
NO
RRB_NOTA_FINAL Ninguna Nota final obtenida por el aprendiz.
VARCHAR2 (8)
NO
RRB_COMENTARIO Ninguna
Comentarios registrados por el instructor a cargo.
VARCHAR2 (4000)
NO
11. Control del proceso – Registros de mensajes
EL proceso de envío de mensajes a las plataformas de Bilingüismo, están controlados mediante
unos registros de control de proceso que son almacenados en tablas de la aplicación SOFIA PLUS,
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 68 de 73
Fecha: 26-06-2012
Se tienen dos tipos de registros: Los registros de control de mensajes y los registros de control de
proceso.
En la tabla de control de mensajes se almacenará la información relacionada con los siguientes
tipos de operación:
ESTE DEBER SER UN PROPERTIES DE LA APLICACIÓN
Tipo de operación
Nombre Operación / Webservice relacionado
Descripción
0 Cancelación de prueba de nivel CancelarPruebaSENA
Información del mensaje enviado para la cancelación de una prueba de nivel.
1 Crear curso CrearCursoSENA
Información del mensaje enviado para la creación de un curso.
2 Desactivación de curso CancelarCursoSENA
Información del mensaje enviado para la desactivación de un curso.
3 Enrolamiento aprendiz EnrolamientoAprendizSENA
Información del mensaje enviado para el enrolamiento de un aprendiz.
4 Enrolamiento instructor EnrolamientoInstructorSENA
Información del mensaje enviado para el enrolamiento de un instructor.
5 Desactivación de aprendiz DesactivarUsuarioSENA
Información del mensaje enviado para la desactivación de aprendiz.
5 Desactivación de instructor
DesactivarUsuarioSENA Información del mensaje enviado para la desactivación de instructor.
6 Solicitud de resultados CargueNotasSENA
Información del mensaje enviado para el cargue de resultados finales del curso.
Para cada uno de estos mensajes se almacena un registro de mensaje en una tabla de nombre
CONTROL_PROCESO_BILINGUISMO, la cual tiene la siguiente estructura:
ESQUEMA DE BASE DE DATOS: OFIVIRTUAL
CONTROL_PROCESO_BI
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 69 de 73
Fecha: 26-06-2012
Nombre de la columna Llave foránea Descripción Tipo de
dato Requerido
CPB_ID Ninguna
El código único del mensaje. Corresponde a la llave primaria de la tabla.
NUMBER (10)
SI
SPB_ID SESION_CP_BILINGUISMO.
SPB_ID
El ID de la sesión de procesamiento relacionado en la tabla de control de proceso. Campo obligatorio de asociado a la tabla CONTROL_PROCESO_ BILINGUISMO.
NUMBER (10)
SI
CPB_TIPO_OPERACION Ninguna
Indica el tipo de operación enviado. Los tipos de operación corresponden a la tabla especificada anteriormente (0, 1, 2, 3, 4, 5, 6).
NUMBER (2)
SI
CPB _FCH_EJECUCION Ninguna
Fecha en la cual se realizó el último procesamiento del mensaje.
DATE SI
CPB_ESTADO Ninguna
Estado del mensaje:
0: ENVIADO
1: PENDIENTE
2: REENVIADO
NUMBER (1)
SI
CPB_MENSAJE_ENVIADO Ninguna Mensaje SOAP enviado CLOB SI
ECB_ID CBP_ERRORES. ID_ERROR
Código de error. Este código debe estar asociado a una tabla de catálogo de errores.
NUMBER (2)
NO
Debido a que en los mensajes se agrupan operaciones, se debe almacenar en una tabla la
información de tallada de las operaciones invocadas por usuario o por curso. Para esto cada
registro de la tabla de control de proceso de deberá tener el detalle asociado en la tabla
DETALLE_CP_BILINGUISMO, la cual deberá tener la siguiente estructura:
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 70 de 73
Fecha: 26-06-2012
ESQUEMA DE BASE DE DATOS: OFIVIRTUAL
DETALLE_CONTROL_PROCESO_BI
Nombre de la columna
Llave foránea Descripción Tipo de dato Requerido
DCB_ID Ninguna
El código único del mensaje. Corresponde a la llave primaria de la tabla.
NUMBER (10)
SI
CPB_ID CONTROL_PROCESO_BILINGUISMO.
CPB_ID
El ID del control de proceso de menajes de bilingüismo. La combinación DCPB_ID y CPB_ID debe ser única en la base de datos.
NUMBER (10)
SI
FIC_ID Ninguna
Código de la ficha de caracterización relacionado con la operación. Este código tiene aplicación para los mensajes del tipo 1, 2, 3, 4, 5 y 6.
NUMBER(10) NO
NIS_ASP Ninguna
Corresponde al NIS del usuario relacionado con la operación. Este código tiene aplicación para los mensajes del tipo 0, 3, 4 y 5.
NUMBER(10) NO
LENGUAJE Ninguna
Corresponde al lenguaje o idioma para el cual se está aplicando
VARCHAR() NO
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 71 de 73
Fecha: 26-06-2012
DCB_FCH_EJECUCION Ninguna
Fecha en la cual se realizó el último procesamiento del mensaje.
DATE SI
Cada uno de los mensajes registrados en la tabla de control de procesamiento, estará asociado a
una sesión de procesamiento. La sesión de procesamiento se entenderá como el grupo de
mensajes que son procesados por un proceso de sistema, no importa si este es iniciado de manera
manual o automática. La información de control de la sesión de procesamiento se deberá
almacenar en una tabla con el nombre SESION_CP_BILINGUISMO. El registro relacionado a la
sesión de proceso debe ser creado de manera previa al inicio de envío de los mensajes. La
estructura de dicha tabla debe ser de la forma:
ESQUEMA DE BASE DE DATOS: OFIVIRTUAL
SESION_PROCESO_BI
Nombre de la columna Descripción Tipo de dato
SPB_ID Id de La sesión de procesamiento.
NUMBER (10) SI
SPB_FCH_CREACION Fecha en la cual se inició la ejecución del proceso
DATE SI
SPB_VENTANA_INICIO Id del registro de integración.indice_cambio en el cual se inició el proceso
NUMBER (10) SI
SPB_VENTANA_FIN Id del registro de integración.indice_cambio en el cual finalizó el proceso
NUMBER (10) SI
Los errores que se puedan presentar en el proceso deberán estar registrados en una tabla con el
nombre CBP_ERRORES con una estructura del tipo:
ESQUEMA DE BASE DE DATOS: OFIVIRTUAL
ERROR_CARGUE_BI
Nombre de la columna Descripción Tipo de dato
ID_ERROR Id del error. NUMBER (3)
SI
DESCRIPCION Descripción del error asociado. Por ej. Para los problemas relacionados
VARCHAR (200) BYTES
SI
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 72 de 73
Fecha: 26-06-2012
con conectividad deberá indicar que la otra plataforma no se encontraba disponible.
12. Catálogos de aplicación
Los siguientes son los catálogos que deberán ser creados y administrados en la aplicación SOFIA
PLUS para la administración de la integración con las plataformas de bilingüismo.
Catálogo de plataformas de Bilingüismo
En este catálogo se almacena la información de las plataformas de bilingüismo con las cuales
interactúa el sistema SOFIA PLUS. Las plataforma deben ser asociadas a los programas de
formación de SOFIA PLUS con el objetivo de poder identificar la plataforma a la cual se debe
realizar solicitudes en el momento de inscripción a los programas de bilingüismo, o en el momento
de realizar las invocaciones relacionadas con creación de cursos, enrolamiento y novedades de
usuarios.
ESQUEMA DE BASE DE DATOS: CATALOGO
PLATAFORMA_BILINGUISMO
Nombre del campo Descripción Tipo de dato Longitud Requerido
PLB_ID Corresponde al identificador único de cada plataforma de bilingüismo
NUMBER 10 SI
PLB_NOMBRE Nombre de la plataforma de bilingüismo
VARCHAR2 200 SI
PLB_DESCRIPCION Descripción de la plataforma. VARCHAR2 400 SI
PLB_URL URL absoluta para del punto de acceso a los web Service y demás componentes de integración con las plataformas de bilingüismo.
VARCHAR2 400 SI
PLB_ESTADO Estado de uso de la plataforma. 1: Activa 0: Inactiva
NUMBER 1 SI
PLB_SECURITY_KEY Código hash de seguridad para validación de datos entre las
VARCHAR2 400 NO
Especificación SOFIA Plus
Plataformas Bilingüismo
Versión: 1.4 Página 73 de 73
Fecha: 26-06-2012
dos plataformas.