CASOS DE USO INTEGRACIÓN SOFIA PLUS PLATAFORMAS DE ... -...

73
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.

Transcript of CASOS DE USO INTEGRACIÓN SOFIA PLUS PLATAFORMAS DE ... -...

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.