PLANTILLA PARA ESPECIFICAR CONTRATOS DE SERVICIOS. MEPROC Documento de Especificación de Servicios (Contrato): Servicio-S09 Versión 1.0 MEPROC Documento de especificación de un servicio SOA (Contrato) Versión: 1.0 Fecha: 16/05/2010 Revisión Fecha Versión Descripción Autor Aprobaciones Nombre / Rol Derechos Reservados Jorge Arias Consultor Independiente Fecha Plantilla para levantar contratos de Servicios Firma Pág. 2 de 8 MEPROC Documento de especificación de un servicio SOA (Contrato) Versión: 1.0 Fecha: 16/05/2010 Tabla de Contenido 1. Breve Descripción 4 2. Versión del servicio 4 3. Roles 4 4. Dueños del servicio 4 5. Descripción de la interfaz del servicio 4 6. Detalle del contrato del servicio 5 6.1 <Coloque aquí el nombre de función o método para la cual desee describir el contrato>Error! Bookmark not defined. 6.1.1 Mensaje de entrada 5 6.1.2 Mensaje de Salida 5 6.1.3 Excepciones 6 7. Implementación del servicio 7 8. Manejo de requerimientos no funcionales 8 Derechos Reservados Jorge Arias Consultor Independiente Plantilla para levantar contratos de Servicios Pág. 3 de 8 MEPROC Documento de especificación de un servicio SOA (Contrato) Versión: 1.0 Fecha: 16/05/2010 Documento de Especificación del Servicio <Nombre del servicio> 1. Breve Descripción Parametrizar factores de Evaluación para Estudio de Crédito : Se encarga de permitir configurar los factores de negocio que me permiten calcular el score para el estudio de crédito. 2. Versión del servicio 1.0 3. Roles Role Sistema Proveedor Descripción CustomerScoringSystems Potenciales Sistemas consumidores 4. BlackListSystem Dueños del servicio <De acuerdo a una matriz RACI (Resposible, Accountable, Consulted, Informed> indique las áreas de negocio o personas responsables del servicio> Resposible Accountable Informed Area estudio de credito Area estudio de credito Area de Riesgo, Servicio al Cliente Nota: Recuerde que el secreto de SOA es la gobernabilidad, la cual es un principio de base de la organización alrededor de su visión de arquitectura empresarial. 5. Descripción de la interfaz del servicio Nombre de la operación Crear Factor Descripción de la operación Se crea un factor o condición que permite la aprobación o rechazo del crédito Mensaje de Mensaje de entrada salida Se envía en el mensaje el valor del factor, la condición que debe cumplir y el campo a evaluar del cliente Modificar Factor Se modifica un valor Se envía el id del El factor ha sido Derechos Reservados Jorge Plantilla para levantar contratos Arias Consultor de Servicios Independiente Excepciones El campo del cliente no existe. La condición a evaluar no es valida El factor no Pág. 4 de 8 MEPROC Documento de especificación de un servicio SOA (Contrato) previamente definido Eliminar Factor 6. Se elimina un factor factor a modificar con los nuevos valores a modificar Enviamos el id del factor que se quiere quitar de la evaluación del crédito Versión: 1.0 Fecha: 16/05/2010 actualizado o no existe El factor no existe Detalle del contrato del servicio <Describa en esta sección de manera detalla los tipos de datos, y las reglas que aplican para cada uno de ellos, que componen los mensajes de entrada y salida de las diferentes funciones descritas en la sección 5. 6.1 Crear Factor 6.1.1 Mensaje de entrada (en su defecto coloco una referencia al archivo XSD que contiene la definición del mensaje de entrada) Atributo Campo Valor Condición Descripción Campo del cliente a evaluar Valor que debe cumplir la condición para paso ok Condicion a evaluar en el factor Tipo Obligatorio String Si Int Si String si Valores (Dominio, Valor por default, etc.) Regla de negocio 6.1.2 Mensaje de Salida (en su defecto coloco una referencia al archivo XSD que contiene la definición del mensaje de entrada) Atributo Mensaje Descripción Mensaje de descripción de la creación exitosa o no del factor Derechos Reservados Jorge Arias Consultor Independiente Tipo String Obligatorio Valores (Dominio, Valor por default, etc.) Regla de negocio Si Plantilla para levantar contratos de Servicios Pág. 5 de 8 MEPROC Documento de especificación de un servicio SOA (Contrato) Versión: 1.0 Fecha: 16/05/2010 6.1.3 Excepciones En esta sección se debe describir todas las posibles excepciones que puede llegar a generar la ejecución de la operación que está siendo descrita. Nombre de la excepción Error Descripción Error al crear el factor no es lógico el factor Regla de negocio 6.2 Modificar Factor 6.2.1 Mensaje de entrada (en su defecto coloco una referencia al archivo XSD que contiene la definición del mensaje de entrada) Atributo Campo Valor Condición Id Descripción Campo del cliente a evaluar Valor que debe cumplir la condición para paso ok Condicion a evaluar en el factor Id del factor a modificar Tipo Obligatorio String No Int No String No Int Si Valores (Dominio, Valor por default, etc.) Regla de negocio 6.2.2 Mensaje de Salida (en su defecto coloco una referencia al archivo XSD que contiene la definición del mensaje de entrada) Atributo Mensaje Descripción Mensaje de descripción de la modificacion exitosa o no del factor Tipo String Obligatorio Valores (Dominio, Valor por default, etc.) Regla de negocio Si 6.2.3 Excepciones En esta sección se debe describir todas las posibles excepciones que puede llegar a generar la ejecución de la operación que está siendo descrita. Derechos Reservados Jorge Arias Consultor Independiente Plantilla para levantar contratos de Servicios Pág. 6 de 8 MEPROC Documento de especificación de un servicio SOA (Contrato) Nombre de la excepción Error Descripción Error al modificar el factor cuando no existe Versión: 1.0 Fecha: 16/05/2010 Regla de negocio 6.3 Eliminar Factor 6.3.1 Mensaje de entrada (en su defecto coloco una referencia al archivo XSD que contiene la definición del mensaje de entrada) Atributo Id Descripción Id del factor a eliminar Tipo Int Obligatorio Valores (Dominio, Valor por default, etc.) Regla de negocio Si 6.3.2 Mensaje de Salida (en su defecto coloco una referencia al archivo XSD que contiene la definición del mensaje de entrada) Atributo Mensaje Descripción Mensaje de descripción de la eliminacion exitosa o no del factor Tipo String Obligatorio Valores (Dominio, Valor por default, etc.) Regla de negocio Si 6.3.3 Excepciones En esta sección se debe describir todas las posibles excepciones que puede llegar a generar la ejecución de la operación que está siendo descrita. Nombre de la excepción Error Error 7. Descripción Error al eliminar el factor no existe Error al eliminar el factor no se puede eliminar Regla de negocio Implementación del servicio Derechos Reservados Jorge Arias Consultor Independiente Plantilla para levantar contratos de Servicios Pág. 7 de 8 MEPROC Documento de especificación de un servicio SOA (Contrato) Función Detalles de implementación Debe tenerse en cuenta que cambiar o crear un factor de evaluación corresponda con los motivadores y estrategias de negocio del área de estudio de crédito y con el área comercial Estudio de crédito 8. Versión: 1.0 Fecha: 16/05/2010 Manejo de requerimientos no funcionales Agrupador Requerimiento Invocación Seguridad Calidad de Servicio Transacciones Derechos Reservados Jorge Arias Consultor Independiente Requerimiento Detalle del requerimiento Tipo de invocación Protocolo Autenticación Autorización Integridad & No repudio Síncrono Privacidad Tiempo de respuesta (Segs.) Numero de invocaciones / segundo Transacciones SOAP/HTTP Si debe usarse LDAP Solo administrador del sistema 2 seg 0.5 Propagación de contextos Plantilla para levantar contratos de Servicios Pág. 8 de 8