Intregración de Clientes Entre Servidores

Documento de Análisis TécnicoMaestro de Clientes

Para:

Área de programación

Líder UsuarioEduardo Arana

Equipo FuncionalDany Tinoco

Equipo Técnico

Lima, Julio del 2015

Corporación Grupo Romero – TI Corporativo

Documento de Análisis Técnico (DAT)

Revisión y Cambios

Registro de Cambios

Fecha Autor Versión Observaciones

17/06/15 Dany Tinoco 1.0 Versión inicial

Revisores

Fecha Revisor Versión Observaciones

Pág. 2 de 27


Sección Funcional

1. Objetivos

- Integrar la creación de clientes SAP (Servidor Actual Nuevo Servidor).

2. Pre Requisitos

Agregar botón en el servidor Actual Desarrollar BAPI de envió de datos desde el servidor Actual. Desarrollar BAPI de creación de clientes en el Nuevo servidor de Ransa.

3. Definiciones, Siglas y abreviaturas RANSA SERVIDOR ACTUAL

- Los clientes se crearan en el servidor Actual en el grupo de cuentas “1600 – Clientes Lima” a nivel de datos generales y de sociedad:

- Se requiere agregar un botón en el maestro de clientes XD01, XD02, XD03Que replique el cliente existente en el servidor Actual hacia el Nuevo servidor,Estos datos solo serán creados a nivel de Datos Generales y Datos de Sociedad.

- Agregar el botón (Nuevo servidor) en la ventana – Datos Adicionales de Sociedad.

Pág. 3 de 27


- Este botón tendrá la funcionalidad de enviar los datos generales y de sociedad del cliente al nuevo servidor de Ransa.

- Solo debe aparecer el botón cuando se ingrese con la sociedad 251 (Ingresar por constantes la sociedad permitida).

- Antes de ejecutar la Bapi debe salir un Popup (Esta seguro que desea replicar el cliente en el Nuevo Servidor).

- Solo debe enviar la información SI el código de cliente ya existe.- Esta bapi debe enviar los datos al Nuevo servidor de Ransa, ingresar los

parámetros por constantes.

o Parámetros DEV Nuevo Landscape (D01)o IP: 10.72.2.242o ID de sistema: D01 o Instancia: 00

- Los datos que se enviaran son los siguientes:

Datos Generales. Ventana de Dirección:

o Nombre 2.o Nombre 3.o Nombre 4.o Calle/Número.

Complemento. Calle 4. Calle 5.

o País.o Zona de Transporte (6000000) Se debe completar por defecto pero

Pág. 4 de 27


No se utilizara para Ransa.o Teléfono.o E-mail.

Ventana de Datos de Control:o Acreedor.o Sociedad GL. Asociada.o Identificación fiscal:

Nº ident.fis.1 (RUC). (92 R.U.C.) Nº ident.fis.2 (DNI). (96 D.N.I) NIF 3 (Extranjero). (91 Carnet Extranjería)

Ventana de Datos de Control:o Persona de contacto.

Nombre. Función Interlocutor. (Define la función del contacto, en este

punto se administra los correos de factura electrónica y los correos de la gestión de cobranza).

Tratamiento es un dato por defecto. Nombre de Pila. Teléfono. Correo electrónico.

Datos de Sociedad. Ventana de Gestión de Cuenta:

o Cuenta Asociada.o Grupo de Tesorería (EL) Se debe completar por defecto pero No se utilizará

para Ransa. Ventana de Gestión de Cuenta:

o Grabar Historial (Check). Ventana de Gestión de Correspondencia:

o Cliente Electrónico (Check).

Pág. 5 de 27


- A nivel de Estructura de la bapi es la siguiente.

EstructuraDenominación Campo Tipo LongitudNUMTRACod. ClienteSociedad

KUNNRBUKRS

CHARCHARCHAR

1010

4Nombre 1Nombre 2Nombre 3Nombre 4

NAME1NAME2NAME3NAME4

CHARCHARCHARCHAR

35353535

Dirección STREET CHAR 60Número HOUSE_NUM1 CHAR 10Complemento HOUSE_NUM2 CHAR 10Calle 4 STR_SUPPL3 CHAR 40Calle 5 LOCATION CHAR 40País COUNTRY CHAR 3Zona de Transporte TRANSPZONE CHAR 10Acreedor LIFNR CHAR 10Sociedad GL. Asociada VBUND CHAR 6Nº ident.fis.1 (RUC) STCD1 CHAR 16Nº ident.fis.2 (DNI) STCD2 CHAR 11NIF 3 (Extranjero). STCD3 CHAR 18Cuenta Asociada AKONT CHAR 10Grp. Tesorería FDGRV CHAR 10Grabar Historial XZVER CHAR 1

Pág. 6 de 27


Cliente Electrónico ZAMIV CHAR 1

Tabla:

Tabla de GeneralesDenominación Campo Tipo LongitudTeléfono TEL_NUMBER CHAR 30Extensión TEL_EXTENS CHAR 10E-mail SMTP_ADDR CHAR 241

Tabla de ContactoDenominación Campo Tipo LongitudApellido de Contacto NAME_LAST CHAR 35Nombre de Contacto NAME_FIRST CHAR 35Función Per. Contacto PAFKT CHAR 2Teléfono TEL_NUMBER CHAR 30Extensión TEL_EXTENS CHAR 10E-mail 1 SMTP_ADDR CHAR 241

Esta información esta en memoria y se puede validar en las tablas.

Completar estructura:- Con el código de cliente KUNNR ir a la KNA1 y Obtener el campo

ADNRNLIFNRVBUNDSTCD1STCD2STCD3

- Con el campo ADNRN ir a la tabla ADRC y obtener los camposNAME1NAME2NAME 3NAME 4STREET

Pág. 7 de 27


HOUSE_NUM1HOUSE_NUM2STR_SUPPL3LOCATIONCOUNTRYTRANSPZONE

- Con el código de cliente y la sociedad ir a la tabla KNB1 y obtener los campos.AKONTFDGRVXZVERZAMIV+

Completar Tabla de teléfonos.- Ir a la tabla la tabla ADR2 con el campo ADDRNUMBER = ADNRN

y PERSNUMBER = SPACE, obtener los campos:TEL_NUMBERTEL_EXTENS

Completar Tabla de Correos.- Ir a la tabla la tabla ADR6 con el campo ADDRNUMBER = ADNRN

y PERSNUMBER = SPACE, obtener los campos:SMTP_ADDR

Completar Tabla de Contactos.Ir a la tabla la KNVK y obtener los contactos.NAME_LAST = NAME1NAME_FIRST = NAMEVPAFKT = PAFKTPRSNR Obtener tabla de teléfonos de contacto.

o Ir a la tabla ADR2 con los campos ADRNR del cliente y con el PRSNR del contactoY obtener los campos:TEL_NUMBERTEL_EXTENS

o Ir a la tabla ADR6 con los campos ADRNR del cliente y con el PRSNR del contacto y obtener los campos:SMTP_ADDR

RANSA NUEVO SERVIDOR

Pág. 8 de 27


- Crear una bapi en el nuevo servidor de Ransa, la cual recepciones los datos enviados por la bapi anterior.Esta bapi deberá crear o modificar clientes mediante una bapi o un batch imput.

Sugerencia: Copiar la bapi ZBAPI_DEBITOR y completar las estructuras restantes para la creación o modificación de clientes, de lo contrario realizar un batch Imput.

- Validar si el código de cliente existe en la tabla KNA1, en caso de existir solo debe actualizar los datos, de no existir se deberá crear el cliente ingresando los siguientes parámetros.

- Si crea el cliente se debe ingresar por la transacción XD01:

Pág. 9 de 27


Región, Población (Departamento) y Distrito son datos por defecto solo para la creación,el Código Postal se completa por defecto con el llenado de estos campos.Región: 15Población: LIMADistrito: LIMANO se debe considerar estos campos al momento de la modificación.

Tabla de teléfonos generales

Tabla de Correos generales

Pág. 10 de 27


- El campo N° Ident.fis.1, se completara con el campoSTCD1 de estar lleno, de lo contrario el STCD2 o STCD3

- El Tipo Nif. se completara con los siguientes valores (Traer de Constantes): Si STCD1 tiene valor. Tipo Nif = 92Si STCD2 tiene valor. Tipo Nif = 96Si STCD3 tiene valor. Tipo Nif = 91

- Para el caso del Check “Persona Física” se marcara el check solo cuando

Pág. 11 de 27


El tipo Nif es 96 o 91.

Completar Datos de Contacto :

De la tabla de contactos teléfono

Pág. 12 de 27


De la tabla de contactos E-mail

Pág. 13 de 27


Completar datos de Sociedad con los datos de la estructura:

Pág. 14 de 27


- Si Modifica el cliente se debe ingresar por la transacción XD02:

Pág. 15 de 27


Región, Población (Departamento) y Distrito son datos por defecto solo para la creación, Región: 15Población: LIMADistrito: LIMANO se debe considerar estos campos al momento de la modificación.

- Cuando se termine de ejecutar el proceso y se retorne el mensaje, se debe controlar lo siguiente en la pantalla del servidor actual.

Si se actualizo el cliente con éxito, mostrar el icono verde con el mensaje “Los Datos se actualizaron de forma correcta”.Si se presentaron errores, se debe mostrar el error devuelto por la bapi.

NOTA:

El botón “AS400 y MMS” se usara para otro proceso.

- Para un mejor control y medir los tiempos de respuesta de un servidor a otro,Se actualizara una tabla Z la cual tendrá que actualizar los siguientes datos antes y después de la llamada a la bapi para la creación de clientes.

Paso 1: Crear una tabla Z con el grupo de autorización ZAR solo en el servidor actual.

Campo Tipo LlaveBUKRS CHAR4 X

Pág. 16 de 27


TRAX CHAR10 XOBJETO CHAR30 XDTINS DATS8HRINS TIMS6USER CHAR12DTSAL DATS8HRSAL TIMS6TYPE CHAR12MESSAGE CHAR50

Paso 2: Servidor actual.- Crear una función que actualice esta tabla ya que será utilizada en diferentes

procesos.Debe de tener como parámetro de entrada, la estructura de la tabla y debe retornar el estado de Satisfactorio o Error.

- Conseguir el correlativo del rango de númerOo “ZAR000001 “. Utilizar la función:

CALL FUNCTION 'NUMBER_GET_NEXT

Y grabar los datos en la tabla, la fecha y hora de salida de la bapi y la fecha y hora de retorno respectivamente.

- BUKRS = Sociedad ejecutora- TRAX = Correlativo conseguido del rango- OBJETO = Nombre de la bapi- DTINS = Fecha de inicio.- HRINS = Hora de inicio.

Pág. 17 de 27


- USER = Usuario ejecutor- DTSAL =Fecha de Retorno.- HRSAL = Hora de Retorno- TYPE = Tipo de respuesta “S” Satisfactorio o “E” de error.- MESSAGE = “E” Mensaje de error encontrado.

“S” Cliente Actualizado de forma correcta XXXXXXXXXX.

4. Solución Propuesta

1.1. Requerimientos No Funcionales[Listar requerimientos NO funcionales de forma detallada para el conocimiento real de la necesidad del usuario.]

[RNF001 – Descripción del requerimiento NO funcional 1] [RNF002 – Descripción del requerimiento NO funcional 2] … [RNF00N – Descripción del requerimiento NO funcional N]

Pág. 18 de 27


2. Modelamiento De Requerimientos2.1. Definición De Actores

2.2. Diagrama De Casos De Uso

2.3. Especificación De Casos De Uso2.3.1. [CU000 Enviar Clientes]:

CÓDIGO

NOMBRE

DESCRIPCIÓN

ACTORES

PRE – CONDICIONES

POST – CONDICIONES

ESCENARIO PRIMARIO

Pág. 19 de 27

Actor 01

Descripción

Accesos al Sistema


DESCRIPCIÓN DEL FLUJO

ACTOR SISTEMA

1. Banco envía Tramas 2. Generación de documentosESCENARIO SECUNDARIO

DESCRIPCIÓN DEL FLUJO

ACTOR SISTEMA

RESULTADO

FRECUENCIA

REQ. NO FUNCIONALES ASOCIADOS

CASOS DE USO RELACIONADOS

No aplica.

OPCIONES ASOCIADAS DEL SISTEMA

No aplica.

ENTIDADES ASOCIADAS

Pág. 20 de 27


NOTAS Ninguna

1. Anexos[Datos adicionales y relevantes en la funcionalidad]

Sección Técnica

1. Objetivos[Describir cual es el objetivo del documento de análisis y diseño del producto]

2. Consideraciones[Indicar las consideraciones que se tomarán en cuenta para el proceso de análisis y diseño]

3. Arquitectura de la Solución1.1. Arquitectura General del Sistema

[Colocar el diagrama con la arquitectura general del sistema, el diagrama deberá mostrar hardware, software, interacciones y servicios]

1.2. Descripción General del Sistemas[Describir cada uno de los componentes de la arquitectura del sistema]

1.3. Diagrama de Estado[Colocar el diagrama de estado y su descripción, si fuera necesario]

Pág. 21 de 27


1.4. Estructura de Datos[Es opcional, el proveedor debería proporcionarlo]

1.4.1. Diagrama de Entidad – Relación[Colocar el diagrama de entidad relación]

1.4.2. Diccionario de Datos1.4.2.1. Listado de Definición de Tablas

#Nombre

TablaDescripción Módulo y/o Sistema

1

[Nombre de la tabla][El nombre debe tener un vínculo a su descripción, líneas abajo]

23

1.4.2.2. Descripción de Tablas y Campos

TablaDescripciónTableSpace

ÍNDICES

#Nombre Índice

Columnas Tipo Detalle del Índice

123

CAMPOS

# Columna Descripción LongitudTipo Dato

Valor Default

Nulo PK FK

123

1.4.2.3. Otros objetos de Base de Datos[Opcionalmente especificar otros objetos de la base de datos]

Pág. 22 de 27


Stored Procedure:[Registrar los procedimientos almacenados que serán creados en la implementación de algunos casos de uso]

# Caso de Uso Objetivo Esquema Sistema1234

Enlaces:[Registrar los objetos que permiten el ENLACE a las bases de datos externas con las cuales se tendrá conexión]

# Nombre Definición1234

Jobs:[Registrar los Jobs que serán creados en la implementación de algunos casos de uso]

# Caso de Uso Objetivo Esquema Sistema1234

Pág. 23 de 27


1.5. Objetos de Seguridad[Es opcional, completar esta sección sólo se si el proyecto lo requiere]

1.6. Interface Aplicativa[Es opcional, completar esta sección sólo se si el proyecto lo requiere]

1.6.1. Estructura de Archivos[Registrar los archivos de texto y la estructura de los mismos]

# Campo Tipo Longitud Descripción

1 Campo 1 N 01 Descripción de campo 1

2 Campo 2 AN 08 Descripción de campo 2

:: ….

:: …….

n Campo n D NN Descripción de campo enésimo

TOTAL NN

1.6.2. Estructura de XML[Registrar los archivos XML y la estructura de los mismos]

# Campo DescripciónTag

PadreTag Nivel

1 Campo 1 Descripción de campo 1 Tag 0 Tag 1 1

2 Campo 2 Descripción de campo 2 Tag 0 Tag 2 1

:: ….

:: …….

n Campo n Descripción de campo enésimo Tag 0 Tag n 1

1.6.3. Web Services[Registrar los web services que serán invocados, describiendo sus parámetros de invocación y el retorno]

ParámetrosId Parámetro Descripción

1 Campo 1 Descripción de campo 1

2 Campo 2 Descripción de campo 2

Pág. 24 de 27


:: ….

:: …….

n Campo n Descripción de campo enésimo

RespuestaId Descripción1 Descripción de retorno 1

4. Solución Técnica1.7. Dependencias

[Colocar la lista de dependencias para la solución técnica]

1.8. Atributos[Colocar la lista de atributos de la solución técnica]

1.9. Definición de Pantallas[Se mostrarán las pantallas nuevas del sistema]

[Para proyectos existentes, se debe mencionar de manera obligatoria una referencia al documento de definición de estilos aplicable a las pantallas (donde se definen tamaño de botones, colores de pantallas, tipo y tamaño de letra, iconos estándares, entre otros. En el caso de proyectos nuevos, podemos permitir que el proveedor TI nos sugiera un estilo nuevo y moderno, si no hay inconvenientes por parte del usuario)]

1.9.1. Pantalla: [UC01.P01-Nombre de pantalla 1][Adjuntar aquí la pantalla 1 del caso de uso UC01]

1.9.1.1. Mensajes[Indicar los mensajes que aparecerán en la pantalla. Los tipos de mensajes pueden ser de validación (V), información (I), confirmación (C) y notificación (N).]

#Código del Mensaje

Tipo de Mensaje

Mensajes Evento validado

12…

1.9.1.2. Definición de consultas[Indicar los detalles para la realización de consultas]

Pág. 25 de 27


#Nombre de

ConsultaParámetros

enviadosCampos

resultantesSentencia SQL

123

1.9.2. Pantalla: [UC01.P02-Nombre de pantalla 2][Copiar aquí la estructura de la pantalla UC01.P01]

1.9.3. Pantalla: [UC01.P03-Nombre de pantalla 3][Copiar aquí la estructura de la pantalla UC01.P01]

1.9.4. Pantalla: [UC01.P0N-Nombre de pantalla N][Copiar aquí la estructura de la pantalla UC01.P01]

1.10. Definición de Reportes[Se describirán los reportes que el sistema generará]

1.10.1. Reporte: [UC01.R01-Nombre de reporte 1][Describir la estructura y filtros del reporte]

ESTRUCTURA# Campo Tipo Longitud Descripción

1 Campo 1 N 01 Descripción de campo 1

2 Campo 2 AN 08 Descripción de campo 2

:: ….

:: …….

n Campo n D NN Descripción de campo enésimo

FILTROS# Campo Tipo Longitud Descripción

1 Campo filtro 1 N 01 Descripción de campo filtro 1

2 Campo filtro 2 AN 08 Descripción de campo filtro 2

:: ….

:: …….

n Campo filtro n D NN Descripción de campo filtro enésimo

Pág. 26 de 27


1.10.2. Reporte: [UC01.R02-Nombre de reporte 2][Copiar aquí la estructura de la pantalla UC01.R01]

1.10.3. Reporte: [UC01.R03-Nombre de reporte 3][Copiar aquí la estructura de la pantalla UC01.R01]

1.10.4. Reporte: [UC01.R0N-Nombre de reporte N][Copiar aquí la estructura de la pantalla UC01.R01]

1.11. Lógica[Se describe…]

1.12. Subrutinas[Se describe…]

1.13. Batch Input[Se describe…]

1.14. Transacción[Se describe…]

1.15. Include[Se describe…]

2. Definiciones

Diseño de sistema: Es el arte de definir la arquitectura de hardware y software, componentes, módulos y datos de un sistema de cómputo para satisfacer ciertos requerimientos. Es la etapa posterior al análisis de sistemas.

Modelo de Dominio: Es un artefacto que presenta no conceptos propios de un sistema de software sino de la propia realidad física.

Modelo Entidad-Relación: Es una herramienta para el modelado de datos de un sistema de información. Estos modelos expresan entidades relevantes para un sistema de información, sus inter-relaciones y propiedades.

Pág. 27 de 27

Intregración de Clientes Entre Servidores

Documents

Transcript of Intregración de Clientes Entre Servidores