Freh.docx

ESPECIFICACIÓN DE DISEÑO DE SERVICIO DE NEGOCIO Dirección Tecnología de la Información Jefatura de Arquitectura Clasificación de la Información: Confidencial / Uso Interno

El siguiente cuadro nos ayuda para gestionar las diferentes modificaciones del contrato del servicio. CONTROL DE VERSIONES Versión 1.0

Elaborado por Jordan Ocmin Ramirez

Aprobado por Rolando Martinez

2.0

Claudia Salazar

Rolando Martinez

3.0

Jose Montenegro

Rolando Martinez

Fecha 19/07/2016

Motivo Versión Inicial.

Se agregó la consulta de 21/11/2016 segmento corporativo Modificación del método 01/06/2017 obtenerSegmentoI VR

DATOS DEL PROYECTO: Código del Proyecto

Nombre del Proyecto

PROY-23854

IDEA-30194: Requerimiento Expansion de Plataforma IPCC

PROY-26768

IDEA-34291: Requerimiento Desarrollo de Servicios - IPCC Phase 2

PROY-27671

IDEA-35629: Requerimiento IPCC -STAGE 3 Outbound/ATC Integraciones CTI-CRM

AMERICA MOVIL PERU SAC

Pagina: 1 / 11

ESPECIFICACIÓN DE DISEÑO DE SERVICIO DE NEGOCIO Dirección Tecnología de la Información Jefatura de Arquitectura Clasificación de la Información: Confidencial / Uso Interno

TABLA DE CONTENIDOS

1.

Objetivo

3

2.

Audiencia

3

3.

Diagrama de Interfaces

3

4.

Plantilla de diseño del servicio

4

4.1 4.2

Datos generales del servicio SegmentoLineaWS 4 Plantilla de especificación de cada método del servicio 4 4.2.1 Método obtenerSegmentoIVR 4 4.2.1.1 Datos de entrada del método obtenerSegmentoIVR .................................... 5 4.2.1.2 Datos de salida del método obtenerSegmentoIVR ....................................... 6 4.2.1.3 Diseño del método obtenerSegmentoIVR del servicio SegmentoLineaWS ....... 8 4.2.1.4 Recursos que usará el método obtenerSegmentoIVR ................................ 10 4.2.1.5 Códigos/Mensajes de respuesta del método obtenerSegmentoIVR ............... 10 4.2.1.6 Métricas de negocio del método .............................................................. 11

AMERICA MOVIL PERU SAC

Pagina: 2 / 11

ESPECIFICACIÓN DE DISEÑO DE SERVICIO DE NEGOCIO Dirección Tecnología de la Información Jefatura de Arquitectura Clasificación de la Información: Confidencial / Uso Interno

Especificación de diseño del servicio 1. Objetivo El objetivo del presente documento es presentar la plantilla que sirve para describir servicio (servicio de datos, servicio de reglas o servicio BI) del área de Arquitectura e Integración, este diseño tiene un perfil funcional y técnico alineado que fue identificado a partir de la propuesta de solución, sirviendo de Input para los desarrolladores. Adicionalmente, este documento contiene la descripción de las diferentes características que debe contener el servicio al momento de ser diseñado, desde el modelado del servicio hasta la invocación de los servicios y/o otros recursos. Este documento solo contiene datos del ambiente de desarrollo. 2. Audiencia Los estándares del presente documento están dirigidos a:   

Arquitectos de integración que requieran diseñar un nuevo servicio Desarrolladores de soluciones de tecnología de información que requieran consultar el detalle de la implementación del servicio. Directores y Líderes de proyectos que requieran compartir la funcionalidad del servicio.

3. Diagrama de Interfaces En el diagrama se muestra las interfaces del servicio y su dependencia con otros servicios.

AMERICA MOVIL PERU SAC

Pagina: 3 / 11

ESPECIFICACIÓN DE DISEÑO DE SERVICIO DE NEGOCIO Dirección Tecnología de la Información Jefatura de Arquitectura Clasificación de la Información: Confidencial / Uso Interno

4. Plantilla de diseño del servicio 4.1 Datos generales del servicio SegmentoLineaWS Los detalles del servicio debe contemplar la especificación funcional y técnica SOLO de los servicios de negocio, servicios compuestos (orquestación) y/o servicios batch “asíncronos”, NO aplica para servicios de datos puntuales que exponen funcionalidades granulares (aquellos que no contienen un flujo, por ejemplo los servicios de OSB de Datos y Servicios de Reglas BRMS, estos solo serán detallados en el Contrato del Servicio). Nombre del servicio

SegmentoLineaWS

Descripción servicio

Servicio que permite obtener información sobre el segmento al cual pertenece la línea de un cliente.

del

Beneficios del negocio Objetivo estratégico relacionado ID

Mejora en los tiempos de respuesta Calidad de atención y servicio 73982

Dueño del servicio

Provisión y mediación

CLARITY

PROY-27671

Número de métodos Clasificación servicio

del

Analista Integración

De

Analista Funcional

1 JAVA _X_

BPEL___

OSB Compuesto___

Jose Montenegro Stephanie Aguilar Melgarejo

4.2 Plantilla de especificación de cada método del servicio 4.2.1 Método obtenerSegmentoIVR Nombre del método: Método: Descripción Método:

del

obtenerSegmentoIVR

Síncrono (Request/Response) _X_ Asíncrono (OneWay) __ Asíncrono (ACK) __ Método que permite consultar en REPTDM, el segmento de una línea.

Pruebas de Stress:

Si _X_

SLA permitido:

2000 ms

Tipo de notificación ante errores:

SMS___

Tipo de seguridad del método

Restricción por IP _X

Estimación transacciones segundo

de por

AMERICA MOVIL PERU SAC

Nuevo _X_ Modificado __

No ___

Mail___ Otros(Log)_X_

20_ tps

Pagina: 4 / 11

ESPECIFICACIÓN DE DISEÑO DE SERVICIO DE NEGOCIO Dirección Tecnología de la Información Jefatura de Arquitectura Clasificación de la Información: Confidencial / Uso Interno

Cliente que invocará el servicio Disponibilidad servicio

Aplicación _X_ Lista de clientes: - IVR IPCC

del

Servicio__

Shell__

24x7

Uso de servicio de reglas

Si ___

No_X__

Métricas del método

Si ___

No_X_

Palabras claves

Segmento, linea

4.2.1.1 Datos de entrada del método obtenerSegmentoIVR Nombre auditRequest msisdn listaAdicional Request

Tipo

Longitud

auditRequestTy pe String

Descripción

Formato

Lista valores

Formato

Lista valores

Formato

Lista valores

Formato

Lista valores

Datos de auditoría

parametrosType

Número de la línea Lista de parámetros opcionales

auditRequestType Nombre

Tipo

idTransaccion

string

ipAplicacion

string

nombreAplicacion

string

usuarioAplicacion

string

Longitud

Descripción ID que debe ser generada por el cliente que invoca al servicio. IP de la aplicación que invoca el servicio. Nombre descriptivo de la aplicación que invoca el servicio. Usuario para acceder al servicio.

parametrosType Nombre

Tipo

parametrosType

objetoOp cional

Longitud

Descripción Objeto de opcionales

parámetros

objetoOpcional Nombre

Tipo

campo

string

Nombre adicional.

valor

string

Valor del campo a enviar.

AMERICA MOVIL PERU SAC

Longitud

Descripción de

campo

Pagina: 5 / 11

ESPECIFICACIÓN DE DISEÑO DE SERVICIO DE NEGOCIO Dirección Tecnología de la Información Jefatura de Arquitectura Clasificación de la Información: Confidencial / Uso Interno

Diagrama request xsd.

4.2.1.2 Datos de salida del método obtenerSegmentoIVR Nombre

Tipo

Longitud

auditResponse

auditResp onseType

Descripción

Formato

Lista valores

Datos de auditoría

valorSegmento

string

Valor del segmento

listaAdicionalRespo nse

parametr osType

Lista de parámetros opcionales

Normal= 0 VIP = 1 Premium = 2

auditResponseType Nombre

Tipo

idTransaccion

string

codigoRespuesta mensajeRespuesta

string string

AMERICA MOVIL PERU SAC

Longitud

Descripción

Formato

Lista valores

Código de transacción Código de error. Mensaje de error.

Pagina: 6 / 11

ESPECIFICACIÓN DE DISEÑO DE SERVICIO DE NEGOCIO Dirección Tecnología de la Información Jefatura de Arquitectura Clasificación de la Información: Confidencial / Uso Interno

parametrosType Nombre

Tipo

parametrosType

objetoOp cional

Longitud

Descripción Objeto de opcionales

Formato

Lista valores

Formato

Lista valores

parámetros

objetoOpcional Nombre

Tipo

campo

String

valor

String

Longitud

Descripción Nombre adicional.

de

campo

Valor del campo a enviar.

Diagrama response xsd.

AMERICA MOVIL PERU SAC

Pagina: 7 / 11

ESPECIFICACIÓN DE DISEÑO DE SERVICIO DE NEGOCIO Dirección Tecnología de la Información Jefatura de Arquitectura Clasificación de la Información: Confidencial / Uso Interno

4.2.1.3 Diseño del método obtenerSegmentoIVR del servicio SegmentoLineaWS a) Modelamiento del proceso del método

b) Diagrama de Componentes:

AMERICA MOVIL PERU SAC

Pagina: 8 / 11

ESPECIFICACIÓN DE DISEÑO DE SERVICIO DE NEGOCIO Dirección Tecnología de la Información Jefatura de Arquitectura Clasificación de la Información: Confidencial / Uso Interno

c) Descripción de cada actividad del proceso: Actividad del proceso 0. Inicio

1. Ejecutar y obtener segmentos IVR

Compon ente

Descripción del proceso Se envía al XML de request detallado en los parámetros de entrada del método. Se verifica si no existe objeto opcional donde campo="Canal" y valor="135" entonces ir a la actividad 1. Caso contrario ir a la actividad 2. Para obtener los datos del cliente se invocará al SP:   

BD REPTDM JNDI pe.com.claro.jdbc.dataSource.reptdmDS SP PKG_SEGMENTACION.IVRSS_OBTENER_SEGMENTO

Segment oLineaW SEAR.ear Segment oLineaW SEAR.ear

DATOS DE ENTRADA: NOMBRE V_MSISDN

VALOR msisdn (obtenido del Request)

DATOS DE SALIDA: NOMBRE V_VALOR_SEGMENTO V_ERRNUM V_ERRMSJ

2. Ejecutar y obtener segmentos IVR CORP

DESCRIPCIÓN Valor del segmento Código de Error Descripción de Error

-

Si K_VALOR_SEGMENTO==0 y (K_ERRNUM!=vacio o K_ERRMSJ!=vacio) y K_ERRNUM!=100 asignar el IDF1 caso contrario asignar el IDF0 y continuar con la actividad 3.

-

Si ocurre algún error de disponibilidad con la base de datos, entonces retornar IDT1 terminar el proceso.

-

Si ocurre algún error de timeout con la base de datos, entonces retornar IDT2 y terminar el proceso.

Para obtener los datos del cliente se invocará al SP:   

BD REPTDM JNDI pe.com.claro.jdbc.dataSource.reptdmDS SP PKG_SEGMENTACION.IVRSS_SEGMENTO_CORP

Segment oLineaW SEAR.ear

DATOS DE ENTRADA: NOMBRE K_MSISDN

AMERICA MOVIL PERU SAC

VALOR msisdn (obtenido del Request)

Pagina: 9 / 11

ESPECIFICACIÓN DE DISEÑO DE SERVICIO DE NEGOCIO Dirección Tecnología de la Información Jefatura de Arquitectura Clasificación de la Información: Confidencial / Uso Interno

DATOS DE SALIDA: NOMBRE K_VALOR_SEGMENTO K_ERRNUM K_ERRMSJ

3. Fin

DESCRIPCIÓN Valor del segmento Código de Error Descripción de Error

-

Si K_VALOR_SEGMENTO==0 y (K_ERRNUM!=vacio o K_ERRMSJ!=vacio) y K_ERRNUM!=100 asignar el IDF1 caso contrario asignar el IDF0 y continuar con la actividad 3.

-

Si ocurre algún error de disponibilidad con la base de datos, entonces retornar IDT1 terminar el proceso.

-

Si ocurre algún error de timeout con la base de datos, entonces retornar IDT2 y terminar el proceso. Segment oLineaW SEAR.ear

Terminar el flujo.

4.2.1.4 Recursos que usará el método obtenerSegmentoIVR



BD REPTDM

o



JNDI pe.com.claro.jdbc.dataSource.reptdmDS

 

SP PKG_SEGMENTACION.IVRSS_OBTENER_SEGMENTO PKG_SEGMENTACION.IVRSS_SEGMENTO_CORP

4.2.1.5 Códigos/Mensajes de respuesta del método obtenerSegmentoIVR a) Respuestas funcionales del método: IDF

codigoError

mensajeError

0

0

Operacion Exitosa.

1

1

Ocurrio un error con la BD :[mensaje de error]

b) Respuestas técnicas del método: IDT

codigoError

1

-1

Error en SP [nombre BD - nombre de SP]: [mensaje de error]

2

-2

Error de Timeout en [nombre BD - nombre de SP]: [mensaje de error]

AMERICA MOVIL PERU SAC

mensajeError

Pagina: 10 / 11

ESPECIFICACIÓN DE DISEÑO DE SERVICIO DE NEGOCIO Dirección Tecnología de la Información Jefatura de Arquitectura Clasificación de la Información: Confidencial / Uso Interno

4.2.1.6 Métricas de negocio del método No Aplica.

AMERICA MOVIL PERU SAC

Pagina: 11 / 11