Documento de Anlisis Tcnico

Maestro de Clientes

Para:
rea de programacin

Eduardo Arana
Lder Usuario
Equipo Funcional

Dany Tinoco

Equipo Tcnico

Lima, Julio del 2015

Revisin y Cambios
Corporacin Grupo Romero TI
Corporativo

Documento de Anlisis Tcnico (DAT)

Registro de Cambios
Fecha

Autor

17/06/1 Dany Tinoco

5

Versin

Observaciones

1.0

Versin inicial

Versin

Observaciones

Revisores
Fecha

Revisor

Pg. 2 de
27

Documento de Anlisis Tcnico (DAT)

Seccin Funcional
1. Objetivos
-

Integrar la creacin de clientes SAP (Servidor Actual Nuevo Servidor).

2. Pre Requisitos

Agregar botn en el servidor Actual

Desarrollar BAPI de envi de datos desde el servidor Actual.
Desarrollar BAPI de creacin 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 botn en el maestro de clientes XD01,

XD02, XD03
Que replique el cliente existente en el servidor Actual hacia el
Nuevo servidor,
Estos datos solo sern creados a nivel de Datos Generales y Datos
de Sociedad.
Agregar el botn (Nuevo servidor) en la ventana Datos
Adicionales de Sociedad.

Pg. 3 de
27

Documento de Anlisis Tcnico (DAT)

Este botn tendr la funcionalidad de enviar los datos generales y

de sociedad del cliente al nuevo servidor de Ransa.
Solo debe aparecer el botn 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 informacin SI el cdigo de cliente ya existe.
Esta bapi debe enviar los datos al Nuevo servidor de Ransa,
ingresar los parmetros por constantes.
o
o
o
o

Parmetros DEV Nuevo Landscape (D01)

IP: 10.72.2.242
ID de sistema: D01
Instancia: 00

Los datos que se enviaran son los siguientes:

Datos Generales.

Ventana de Direccin:
o Nombre 2.
o Nombre 3.
o Nombre 4.
o Calle/Nmero.
Complemento.
Calle 4.
Calle 5.
o Pas.
o Zona de Transporte (6000000) Se debe completar por
defecto pero
No se utilizara para Ransa.
o Telfono.
Pg. 4 de
27

Documento de Anlisis Tcnico (DAT)

o E-mail.
Ventana de Datos de Control:
o Acreedor.
o Sociedad GL. Asociada.
o Identificacin fiscal:
N ident.fis.1 (RUC).
N ident.fis.2 (DNI).
NIF 3 (Extranjero).
Extranjera)

(92
(96
(91

R.U.C.)
D.N.I)
Carnet

Ventana de Datos de Control:

o Persona de contacto.
Nombre.
Funcin Interlocutor. (Define la funcin del
contacto, en este punto se administra los correos
de factura electrnica y los correos de la gestin de
cobranza).
Tratamiento es un dato por defecto.
Nombre de Pila.
Telfono.
Correo electrnico.

Datos de Sociedad.

Ventana de Gestin de Cuenta:

o Cuenta Asociada.
o Grupo de Tesorera (EL) Se debe completar por defecto pero
No se utilizar para Ransa.
Ventana de Gestin de Cuenta:
o Grabar Historial (Check).
Ventana de Gestin de Correspondencia:
o Cliente Electrnico (Check).

Pg. 5 de
27

Documento de Anlisis Tcnico (DAT)

A nivel de Estructura de la bapi es la siguiente.

Estructura
Denominacin
NUMTRA
Cod. Cliente
Sociedad
Nombre 1
Nombre 2
Nombre 3
Nombre 4
Direccin
Nmero
Complemento
Calle 4
Calle 5
Pas
Zona de Transporte

KUNNR
BUKRS
NAME1
NAME2
NAME3
NAME4
STREET
HOUSE_NUM1
HOUSE_NUM2
STR_SUPPL3
LOCATION
COUNTRY
TRANSPZONE
LIFNR

Tipo
CHAR
CHAR
CHAR
CHAR
CHAR
CHAR
CHAR
CHAR
CHAR
CHAR
CHAR
CHAR
CHAR
CHAR
CHAR

Longitu
d
10
10
4
35
35
35
35
60
10
10
40
40
3
10
10

VBUND

CHAR

STCD1
STCD2
STCD3
AKONT
FDGRV
XZVER
ZAMIV

CHAR
CHAR
CHAR
CHAR
CHAR
CHAR
CHAR

16
11
18
10
10
1
1

Campo

Acreedor
Sociedad GL.
Asociada
N ident.fis.1
(RUC)
N ident.fis.2 (DNI)
NIF 3 (Extranjero).
Cuenta Asociada
Grp. Tesorera
Grabar Historial
Cliente Electrnico
Tabla:
Tabla de
Generales
Denominacin

Campo

Tipo

Longitu
Pg. 6 de
27

Documento de Anlisis Tcnico (DAT)

d
Telfono
Extensin
E-mail

TEL_NUMBER
TEL_EXTENS
SMTP_ADDR

CHAR
CHAR
CHAR

30
10
241

Campo

Tipo

NAME_LAST

CHAR

35

NAME_FIRST

CHAR

35

PAFKT
TEL_NUMBER
TEL_EXTENS
SMTP_ADDR

CHAR
CHAR
CHAR
CHAR

2
30
10
241

Tabla de
Contacto
Denominacin
Apellido de
Contacto
Nombre de
Contacto
Funcin Per.
Contacto
Telfono
Extensin
E-mail 1

Longitu
d

Esta informacin esta en memoria y se puede validar en las tablas.

Completar estructura:
- Con el cdigo de cliente KUNNR ir a la KNA1 y Obtener el campo
ADNRN
LIFNR
VBUND
STCD1
STCD2
STCD3
- Con el campo ADNRN ir a la tabla ADRC y obtener los campos
NAME1
NAME2
NAME 3
NAME 4
STREET
HOUSE_NUM1
HOUSE_NUM2
STR_SUPPL3
LOCATION
Pg. 7 de
27

Documento de Anlisis Tcnico (DAT)

COUNTRY
TRANSPZONE
Con el cdigo de cliente y la sociedad ir a la tabla KNB1 y obtener los campos.
AKONT
FDGRV
XZVER
ZAMIV
+

Completar Tabla de telfonos.

- Ir a la tabla la tabla ADR2 con el campo ADDRNUMBER = ADNRN
y PERSNUMBER = SPACE, obtener los campos:
TEL_NUMBER
TEL_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 = NAME1
NAME_FIRST = NAMEV
PAFKT = PAFKT
PRSNR
Obtener tabla de telfonos de contacto.
o Ir a la tabla ADR2 con los campos ADRNR del cliente y con el
PRSNR del contacto
Y obtener los campos:
TEL_NUMBER
TEL_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

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 creacin o
modificacin de clientes, de lo contrario realizar un batch Imput.

Pg. 8 de
27

Documento de Anlisis Tcnico (DAT)

Validar si el cdigo 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 parmetros.

Si crea el cliente se debe ingresar por la transaccin XD01:

Regin, Poblacin (Departamento) y Distrito son datos por defecto solo para la
creacin,el Cdigo Postal se completa por defecto con el llenado de estos campos.
Regin: 15
Pg. 9 de
27

Documento de Anlisis Tcnico (DAT)

Poblacin: LIMA
Distrito: LIMA
NO se debe considerar estos campos al momento de la modificacin.
Tabla de telfonos generales

Tabla de Correos generales

Pg. 10 de
27

Documento de Anlisis Tcnico (DAT)

El campo N Ident.fis.1, se completara con el campo

STCD1 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 = 92
Si STCD2 tiene valor.
Tipo Nif = 96
Si STCD3 tiene valor.
Tipo Nif = 91
Para el caso del Check Persona Fsica se marcara el check solo cuando
El tipo Nif es 96 o 91.

Completar Datos de Contacto :

Pg. 11 de
27

Documento de Anlisis Tcnico (DAT)

De la tabla de contactos telfono

De la tabla de contactos E-mail

Pg. 12 de
27

Documento de Anlisis Tcnico (DAT)

Completar datos de Sociedad con los datos de la estructura:

Pg. 13 de
27

Documento de Anlisis Tcnico (DAT)

Si Modifica el cliente se debe ingresar por la transaccin XD02:

Regin, Poblacin (Departamento) y Distrito son datos por defecto solo para la
creacin,
Regin: 15
Pg. 14 de
27

Documento de Anlisis Tcnico (DAT)

Poblacin: LIMA
Distrito: LIMA
NO se debe considerar estos campos al momento de la modificacin.
-

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 botn 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 despus de la llamada a la bapi para la creacin de clientes.
Paso 1: Crear una tabla Z con el grupo de autorizacin ZAR solo en el servidor
actual.
Campo
BUKRS
TRAX
OBJETO
DTINS
HRINS

Tipo
CHAR4
CHAR10
CHAR30
DATS8
TIMS6

Llave
X
X
X

Pg. 15 de
27

Documento de Anlisis Tcnico (DAT)

USER
DTSAL
HRSAL
TYPE
MESSAG
E
-

CHAR12
DATS8
TIMS6
CHAR12
CHAR50

Paso 2: Servidor actual.

Crear una funcin que actualice esta tabla ya que ser utilizada en diferentes
procesos.
Debe de tener como parmetro de entrada, la estructura de la tabla y debe
retornar el estado de Satisfactorio o Error.
Conseguir el correlativo del rango de nmerOo ZAR000001 . Utilizar la funcin:
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.
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.
Pg. 16 de
27

Documento de Anlisis Tcnico (DAT)

4. Solucin Propuesta

1.1. Requerimientos No Funcionales

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

[RNF001 Descripcin del requerimiento NO funcional 1]

[RNF002 Descripcin del requerimiento NO funcional 2]

[RNF00N Descripcin del requerimiento NO funcional N]

Pg. 17 de
27

Documento de Anlisis Tcnico (DAT)

2. Modelamiento De Requerimientos
2.1. Definicin De Actores

Actor 01
Descripcin
Accesos al
Sistema

2.2. Diagrama De Casos De Uso

2.3. Especificacin De Casos De Uso

2.3.1. [CU000 Enviar Clientes]:
CDIGO
NOMBRE
DESCRIPCIN
ACTORES

PRE
CONDICIONES
POST
CONDICIONES
ESCENARIO
PRIMARIO

Pg. 18 de
27

Documento de Anlisis Tcnico (DAT)

DESCRIPCIN DEL FLUJO

ACTOR
1. Banco enva Tramas
ESCENARIO
SECUNDARIO

SISTEMA
2. Generacin de documentos

DESCRIPCIN DEL FLUJO

ACTOR

SISTEMA

RESULTADO
FRECUENCIA
REQ. NO
FUNCIONALES
ASOCIADOS
CASOS DE USO
RELACIONADOS

No aplica.

OPCIONES
ASOCIADAS DEL
SISTEMA

No aplica.

ENTIDADES
ASOCIADAS
NOTAS

Ninguna

Pg. 19 de
27

Documento de Anlisis Tcnico (DAT)

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

Seccin Tcnica
1 Objetivos
[Describir cual es el objetivo del documento de anlisis y diseo del
producto]

5. Consideraciones
[Indicar las consideraciones que se tomarn en cuenta para el proceso de
anlisis y diseo]

6. Arquitectura de la Solucin
3.1. Arquitectura General del Sistema
[Colocar el diagrama con la arquitectura general del sistema, el
diagrama deber mostrar hardware, software, interacciones y
servicios]

3.2. Descripcin General del Sistemas

[Describir cada uno de los componentes de la arquitectura del
sistema]

3.3. Diagrama de Estado

[Colocar el diagrama de estado y su descripcin, si fuera
necesario]
Pg. 20 de
27

Documento de Anlisis Tcnico (DAT)

3.4. Estructura de Datos

[Es opcional, el proveedor debera proporcionarlo]

3.4.1. Diagrama de Entidad Relacin

[Colocar el diagrama de entidad relacin]

3.4.2. Diccionario de Datos

Listado de Definicin de Tablas

3.4.2.1.

Nombre
Tabla
[Nombre de la tabla]
[El nombre debe tener un
vnculo a su descripcin,
lneas abajo]

Descripci
n

Mdulo y/o
Sistema

2
3

3.4.2.2.

Descripcin de Tablas y Campos

Tabla
Descripci
n
TableSpac
e
NDICES
Nombre
ndice

Columnas

Tipo

Detalle del ndice

1
2
3
CAMPOS
#

Column
a

Descripcin

Longitu
d

Tipo
Dato

Valor
Defaul
t

Nul
o

PK

FK

1
2
3

3.4.2.3.

Otros objetos de Base de Datos

[Opcionalmente especificar otros objetos de la base de
datos]
Pg. 21 de
27

Documento de Anlisis Tcnico (DAT)

Stored Procedure:
[Registrar los procedimientos almacenados que sern
creados en la implementacin de algunos casos de uso]
#

Caso de
Uso

Objeti
vo

Esque
ma

Siste
ma

1
2
3
4

Enlaces:
[Registrar los objetos que permiten el ENLACE a las bases
de datos externas con las cuales se tendr conexin]
#

Nombr
e

Definicin

1
2
3
4

Jobs:
[Registrar los Jobs que sern creados
implementacin de algunos casos de uso]
#

Caso de
Uso

Objeti
vo

Esque
ma

en

la

Siste
ma

1
2
3
4

Pg. 22 de
27

Documento de Anlisis Tcnico (DAT)

3.5. Objetos de Seguridad

[Es opcional, completar esta seccin slo se si el proyecto lo
requiere]

3.6. Interface Aplicativa

[Es opcional, completar esta seccin slo se si el proyecto lo
requiere]

3.6.1. Estructura de Archivos

[Registrar los archivos de texto y la estructura de los mismos]
# Campo
1
2

Campo
1
Campo
2

Tip
o

Longit
ud

01

Descripcin de campo 1

AN

08

Descripcin de campo 2

NN

Descripcin de campo ensimo

Descripcin

:: .
:: .
n

Campo
n
TOTAL

NN

3.6.2. Estructura de XML

[Registrar los archivos XML y la estructura de los mismos]

# Campo
1
2

Campo
1
Campo
2

Tag
Padr
e

Descripcin

Descripcin de campo 1
Descripcin de campo 2

Tag

Tag 0 Tag 1
Tag 0 Tag 2

Nive
l
1
1

:: .
:: .
n

Campo

Descripcin

ensimo

de

campo Tag 0 Tag n

3.6.3. Web Services

[Registrar los web services que sern invocados, describiendo
sus parmetros de invocacin y el retorno]
Pg. 23 de
27

Documento de Anlisis Tcnico (DAT)

Parmetros
Id

Parmet
ro

Campo 1

Descripcin de campo 1

Campo 2

Descripcin de campo 2

::

::

Campo n

Descripcin

Descripcin de campo ensimo

Respuesta
Descripcin

Id
1 Descripcin de retorno 1

7. Solucin Tcnica
4.1. Dependencias

[Colocar la lista de dependencias para la solucin tcnica]

4.2. Atributos

[Colocar la lista de atributos de la solucin tcnica]

4.3. Definicin de Pantallas

[Se mostrarn las pantallas nuevas del sistema]

[Para proyectos existentes, se debe mencionar de manera
obligatoria una referencia al documento de definicin de estilos
aplicable a las pantallas (donde se definen tamao de botones,
colores de pantallas, tipo y tamao de letra, iconos estndares,
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)]

4.3.1. Pantalla: [UC01.P01-Nombre de pantalla 1]

[Adjuntar aqu la pantalla 1 del caso de uso UC01]

4.3.1.1.

Mensajes

[Indicar los mensajes que aparecern en la pantalla. Los

tipos de mensajes pueden ser de validacin (V), informacin
(I), confirmacin (C) y notificacin (N).]

Cdigo
del
Mensaje

Tipo
de
Mensa
je

Mensajes

Evento
validado

1
2

Pg. 24 de
27

Documento de Anlisis Tcnico (DAT)

4.3.1.2.

Definicin de consultas
[Indicar los detalles para la realizacin de consultas]
Nombre de
Consulta

Parmetro
s enviados

Campos
resultantes

Sentencia SQL

1
2
3

4.3.2. Pantalla: [UC01.P02-Nombre de pantalla 2]

[Copiar aqu la estructura de la pantalla UC01.P01]

4.3.3. Pantalla: [UC01.P03-Nombre de pantalla 3]

[Copiar aqu la estructura de la pantalla UC01.P01]

4.3.4. Pantalla: [UC01.P0N-Nombre de pantalla N]

[Copiar aqu la estructura de la pantalla UC01.P01]

4.4. Definicin de Reportes

[Se describirn los reportes que el sistema generar]

4.4.1. Reporte: [UC01.R01-Nombre de reporte 1]

[Describir la estructura y filtros del reporte]

Campo

1 Campo 1
2 Campo 2

Tip
o

ESTRUCTURA
Longit
ud

Descripcin

01

Descripcin de campo 1

AN

08

Descripcin de campo 2

NN

:: .
:: .
n Campo n
#
1
2

Campo
Campo filtro
1
Campo filtro
2

Tip
o

Descripcin de campo ensimo

FILTROS
Longit
Descripcin
ud

01

Descripcin de campo filtro 1

AN

08

Descripcin de campo filtro 2

NN

Descripcin de campo filtro ensimo

:: .
:: .
n

Campo filtro
n

Pg. 25 de
27

Documento de Anlisis Tcnico (DAT)

Pg. 26 de
27

Documento de Anlisis Tcnico (DAT)

4.4.2. Reporte: [UC01.R02-Nombre de reporte 2]

[Copiar aqu la estructura de la pantalla UC01.R01]

4.4.3. Reporte: [UC01.R03-Nombre de reporte 3]

[Copiar aqu la estructura de la pantalla UC01.R01]

4.4.4. Reporte: [UC01.R0N-Nombre de reporte N]

[Copiar aqu la estructura de la pantalla UC01.R01]

4.5. Lgica
[Se describe]

4.6. Subrutinas
[Se describe]

4.7. Batch Input

[Se describe]

4.8. Transaccin
[Se describe]

4.9. Include
[Se describe]

5. Definiciones
Diseo de sistema: Es el arte de definir la arquitectura de hardware y
software, componentes, mdulos y datos de un sistema de cmputo
para satisfacer ciertos requerimientos. Es la etapa posterior al anlisis de
sistemas.

Modelo de Dominio: Es un artefacto que presenta no conceptos

propios de un sistema de software sino de la propia realidad fsica.

Modelo Entidad-Relacin: Es una herramienta para el modelado de

datos de un sistema de informacin. Estos modelos expresan entidades
relevantes para un sistema de informacin, sus inter-relaciones y
propiedades.

Pg. 27 de
27