1. Especificaciones Técnicas integración BVC
1.5. Servicios de la BVC
1.5.2. Diseño de servicios Funcionales
1.5.2.4. Servicio de Notificaron de Especies
Código y nombre del servicio
S0107 – Notificación de Especies
Objetivos del servicio
El objetivo de este servicio es informar a los afiliados, los movimientos (Creación, activa-
ción, inactivación, modificación) de una especie en el sistema de negociación.
Características del servicio
Este servicio debe tener las siguientes características:
Característica Valor
Comentarios
Sincrónico No
Patrón Notificación
Capa BackOffice
Frecuencia Por Evento
Necesidad entre-
ga certificada
Si
Tamaño del men-
saje
Bytes
Dependencia de
la sesión
No
Consideraciones del servicio
Las siguientes son las consideraciones que se deben tener para este servicio:
Item
Descripción
Información
de entrada
al servicio
El servicio recibirá la información en FIXML
Respuesta
No existe una respuesta asociada a este servicio.
1.5.2.4.2.
Diagrama de secuencia
El siguiente es el diagrama de secuencia para el servicio:
Actor
Descripción para la prueba
BUS
Es la plataforma encargada de enviar los mensajes desde el
BackOffice hacia los consumidores. Además cumple con las ta-
reas de procesamiento de información, transformación de da-
tos, ejecución de reglas del negocio, encriptamiento, entre
otras.
Adaptador
Conector
Este actor se encarga de recibir la información enviada por el BackOffice y enviarla al servicio
BackOffice
Sistema de la Bolsa de donde se notifican los cambios y modifi-
caciones de las especies, que deben ser enviados a todas las
firmas
encargadas de recuperar los mensajes publicados por el servi-
cio.
Las especificaciones de los mensajes y las reglas de transformación se encuentran detalladas
en el formato FOI que se relaciona a continuación y los XML y XSD utilizados:
¾
BUS_EJ_FOI_FIXMLM002-NotificacionEspecies
Ejemplo Archiv XML
¾
M002-FIXML-NotificacionEspecie
1.5.2.4.3.
Proceso en el bus para el uso del servicio
El proceso que debe ejecutar el BUS en la ejecucion de este servicio es el siguiente:
1.5.2.4.4. Pasos del proceso
#
Paso
Tipo Paso
Descripción
1 Recibir Mensaje de
Notificación Espe-
cie
Actividad
Se encarga de recibir la información y aso-
ciarla al esquema de FIXML
2 Validar Información Actividad Valida que la información contenida en el mensaje ten- ga los datos requeridos y necesarios para ejecutar todo el proceso, y concuerden con los estándares definidos.
#
Paso
Tipo Paso
Descripción
3 Información Inválida Condición Esta condición valida si los datos fueron o no válidos. 4 Insertar Registro en log
de errores
Actividad Crea un nuevo registro en la base de datos propietaria con la información del error. Si el error fue debido a datos inválidos no debe generar reproceso, en caso contrario, es necesario publicar nuevamente el mensa- je
5 Enviar Mensaje Actividad Publica el mensaje. Este mensaje debe llegar a todos los afiliados registrados para el servicio.
6 Mensaje Enviado? Condición Valida si el mensaje fue publicado exitosamente
1.5.2.4.5. Escenarios de prueba (Unitarias de desarrollo)
Escenario 1: Mensaje con Datos Faltantes
# 0001
Nombre de la prueba Tipo de Operación
Tipo de Operaciones por punta
Mercado Todos
Numero Fracciones Punta
Resultado Esperado Alarma al Administrador y Registro creado en la tabla de errores Descripción Paso Descripción Resultado esperado
1 El BO envía las trama de notificación especies
La trama es recibida por el adaptador-traductor trama-FIXML
2 El servicio recibe un XML con datos faltantes
En esta prueba consiste en que el BackOffice envía una trama de notifi- cación especie con alguno de los datos requeridos sin ningún valor. El servicio debe validar que se encuentren los datos requeridos y generar una alarma
indicando el error. 3 El servicio valida que todos los campos estén llenos.
Debe encontrar que exis- ten datos faltantes
4 El servicio inserta un registro en la base de datos.
Un nuevo registro es creado en la tabla de Log, con la información del error y genera una alerta administrativa
Escenario 2: Enviar Mensaje cuando el Destino no está dis-
ponible
# 0002
Nombre de la prueba Enviar Mensaje cuando el Destino no está disponible Tipo de Operación
Tipo de Operaciones por punta
Mercado Todos
Numero Fracciones Punta
Resultado Esperado Registro en la tabla de errores y de reproceso.
Descripción Paso Descripción Resultado esperado 1 El servicio recibe un mensaje con
todos los campos obligatorios lle- nos.
2 El servicio intenta publicar el XML. El mensaje no puede ser enviado porque el compo- nente de transporte no esta disponible
Este escenario consiste en que el BO envía la notificación de una especie, correctamente y el servicio de nego- cio recibe un mensaje XML válido pero el servicio de transporte no esta dis- ponible.
3 El servicio registra el error y una actividad de reproceso
Se crea un registro nuevo en la tabla de errores y se genera una alerta adminis- trativa.
Escenario 3: Notificación enviada exitosamente
# 0003
Nombre de la prueba Notificación enviada exitosamente Tipo de Operación
Tipo de Operaciones por punta
Mercado Todos
Numero Fracciones Punta
Resultado Esperado FIXML publicado exitosamente
Descripción Paso Descripción Resultado esperado 1 El BO notifica que una especie se ha creado
o modificado
2 El servicio recibe un mensaje FIXML con todos los campos de la especie y la publica Este escenario consiste en notificar
exitosamente una especie a los afilia- dos
3 Los afiliados registrados al servicio reciben la información de la especie publicada por el BO
El XML es enviado a los afiliados regis- trados para el servi- cio.
Escenario 4: Trama de Notificación de Especie Incorrecta
# 0004
Nombre de la prueba Trama de notificación de especie incorrecta Tipo de Operación
Tipo de Operaciones por punta
Mercado Todos
Numero Fracciones Punta
Resultado Esperado Alarma al Administrador
Descripción Paso Descripción Resultado esperado En esta prueba consiste en que
el BackOffice envía una trama de
1 El BO envía las trama de notificación de especie
notificación de especie con una longitud diferente a la estableci- da. El servicio debe validar la longitud de la estructura y gene- rar una alarma indicando el error.
2 La trama es capturada por el adaptador-traductor trama-FIXML, para realizar las transformaciones y en- viarlas al servicio de nego- cio.
El adaptador detecta un error en la longi- tud y genera una alarma al administra- dor
Escenario 5: Los datos de la trama no corresponden con el
Esquema XML definido
# 0005
Nombre de la prueba Los datos de la trama no corresponden con el esquema XML definido Tipo de Operación
Tipo de Operaciones por punta
Mercado Todos
Numero Fracciones Punta
Resultado Esperado Alarma al Administrador
Descripción Paso Descripción Resultado esperado 1 El BO envía las trama de notifica-
ción especie Esta prueba consiste en que el Bac-
kOffice envía una trama de notifica- ción especie con un campo con un valor invalido (por ejemplo Ne- mo=1234567890XXX). El servicio valida que este valor no se permita para el campo y generar una alarma indican- do el error.
2 La trama es capturada por el adap- tador-traductor trama-FIXML, para realizar las transformaciones y enviarlas al servicio de negocio.
El adaptador detecta un error en los datos y gene- ra una alarma al admi- nistrador