NORMATIVA GERENCIA DE SISTEMAS

Ttulo:
ESTNDARES DE DESARROLLO EN SAP
Sustituye a:
Cdigo Fecha de Vigencia Cdigo Pgina Fecha
N-SIDE-001 01/08/2007 ---------- ---------- ----------

REGISTRO DE REVISIONES

NRO. FECHA EDICIN PGINA(S) TIPO DE MODIFICACIN RESPONSABLE

REVISIN DE APROBACIN

Emisor Aprobacin Tipo de Documento

Ziomara Lpez Eduardo A. Oropeza R.

SELLO
Pgina 1 de 12 F-SINO-002
 NORMATIVA GERENCIA DE SISTEMAS
Ttulo:
ESTNDARES DE DESARROLLO EN SAP
Sustituye a:
Cdigo Fecha de Vigencia Cdigo Pgina Fecha
N-SIDE-001 01/08/2007 ---------- ---------- ----------

LISTA DE DISTRIBUCIN

N. UNIDAD
0 Gerencia de Sistemas.

Emisor Aprobacin Tipo de Documento

Ziomara Lpez Eduardo A. Oropeza R.

SELLO
Pgina 2 de 12 F-SINO-002
 NORMATIVA GERENCIA DE SISTEMAS
Ttulo:
ESTNDARES DE DESARROLLO EN SAP
Sustituye a:
Cdigo Fecha de Vigencia Cdigo Pgina Fecha
N-SIDE-001 01/08/2007 ---------- ---------- ----------

I. OBJETO:

La presente normativa fija los estndares que se deben seguir para la generacin de
desarrollos en el Sistema MySAP.

II. ALCANCE:

Esta normativa aplica al rea de desarrollo en la Gerencia de Sistemas.

III. DOCUMENTOS RELACIONADOS:

No tiene documentos relacionados.

IV. UNIDADES Y/O PERSONAL INVOLUCRADO:

Las unidades y/o personal involucrado con esta normativa son:

Gerencia de Sistemas

V. ARCHIVO DE DOCUMENTOS:

Esta normativa esta archivada en:

\\cindu1\sistemas\normas\cindu\10 normas\N-SIDE-001 - Estandares de Desarrollo en

SAP.doc

Emisor Aprobacin Tipo de Documento

Ziomara Lpez Eduardo A. Oropeza R.

SELLO
Pgina 3 de 12 F-SINO-002
 NORMATIVA GERENCIA DE SISTEMAS
Ttulo:
ESTNDARES DE DESARROLLO EN SAP
Sustituye a:
Cdigo Fecha de Vigencia Cdigo Pgina Fecha
N-SIDE-001 01/08/2007 ---------- ---------- ----------

VI. REGISTROS ASOCIADOS:

Los registros asociados a esta normativa son:

Tiempo de Retencin
Cdigo Descripcin Archivo Activo Archivo
Muerto
Mientras est
F-SINO-001 Registro de Revisiones vigente el -------------
documento
Mientras est
F-SINO-003 Lista de Distribucin vigente el -------------
documento

F-SIDE-001 Validacin de Desarrollos Mientras se realiza 5

el proceso

VII. NORMAS:

7.1 Responsabilidad y Autoridad:

7.1.1 La Gerencia de Sistemas tiene la responsabilidad:

7.1.2.1. Distribuir entre los desarrolladores, establecer tiempos y prioridades

sobre los desarrollos o modificaciones que se reciben en la
Gerencia de Sistemas.

7.1.2.2. Realizar los desarrollos y pruebas en el Sistema Desarrollo de SAP

ECC.

7.1.2.3. Revisar el transporte del desarrollo en el Sistema Productivo de

SAP ECC.

7.1.2.4. Utilizar los estndares establecidos para programacin y verificar la

aplicacin de los mismos por parte de los desarrolladores en el
Sistema SAP ECC.

VIII. PROCEDIMIENTO GENERAL:

8.1. Estndares de Programacin para el ambiente SAP ECC:

Emisor Aprobacin Tipo de Documento

Ziomara Lpez Eduardo A. Oropeza R.

SELLO
Pgina 4 de 12 F-SINO-002
 NORMATIVA GERENCIA DE SISTEMAS
Ttulo:
ESTNDARES DE DESARROLLO EN SAP
Sustituye a:
Cdigo Fecha de Vigencia Cdigo Pgina Fecha
N-SIDE-001 01/08/2007 ---------- ---------- ----------

SAP ECC es un sistema de tipo ERP (Enterprise Resource Planning) diseado

para la plataforma Cliente/Servidor.

El sistema ECC fue desarrollado con un lenguaje de cuarta generacin propietario

de la empresa SAP AG denominado ABAP/4 (Advance Business Application
Programming /4), hoy da slo ABAP.

La actividad de desarrollo del rea de sistemas se rige por un estndar de

programacin que se describe a continuacin.

Nomenclatura para los nombres de los programas: Todo programa u objeto

debe identificarse con un nombre completo ajustado a la siguiente
nomenclatura.

ZXX999Y_descripcion

Donde:
(Z) Se define como constante estndar para desarrollos y creacin de objetos
propios del usuario en SAP ECC.

(XX) Clave que indica el mdulo principal para el cual el programa fue
desarrollado.
Como por Ejemplo:
AP: Cuentas por Pagar
AR: Cuentas por Cobrar
GL: Libro Mayor
AA: Activos Fijos
SD: Ventas (Sales and Distribution)
MM: Manejo de Materiales
PP: Planificacin de la Produccin
CO: Controlling.
WM: Warehouse Management
BC: Basis components

(999) Numeracin consecutiva que indica la secuencia de los programas

desarrollados para la misma aplicacin. Para asignar un nmero a un programa
nuevo debe buscarse el primer cdigo libre y asegurarse de que ese programa
no est entre las listas de programas borrados.

(Y) Clave que identifica el tipo de programa. Entre los tipos podemos
seleccionar:
P: Procesos de actualizacin de objetos como tablas; dynpros.
R: Reporte o listado.
Emisor Aprobacin Tipo de Documento

Ziomara Lpez Eduardo A. Oropeza R.

SELLO
Pgina 5 de 12 F-SINO-002
 NORMATIVA GERENCIA DE SISTEMAS
Ttulo:
ESTNDARES DE DESARROLLO EN SAP
Sustituye a:
Cdigo Fecha de Vigencia Cdigo Pgina Fecha
N-SIDE-001 01/08/2007 ---------- ---------- ----------

B: Batch Input
F: Formulario
O: Output.
I: De tipo Include.
L: De Librera (Rutinas genricas).,

(_descripcion) Nombre descriptivo a juicio del programador que puede ocupar

el resto de la longitud del programa.

Nombres de las funciones:

Los nombres de las funciones deben comenzar por Z_ y el resto deber ser un
nombre descriptivo.

Lineamientos de Programacin.

Todo programa debe poseer un encabezado donde se deber indicar el nombre

del programa, el nombre del programador, fecha de creacin y de la ltima
modificacin, as como una sinopsis de la funcin del programa y un registro de
modificaciones. Para todos los efectos, se recomienda utilizar el programa
ZMODELO como plantilla para iniciar los desarrollos.

No se deber programar llamadas de un programa tipo include dentro de otro

programa tipo include.

Deber utilizarse la tcnica de modularizacin mediante la programacin del

lenguaje de forma estructurada. Los PERFORM debern de estructurarse
lgicamente.

El programa debe tener bien identificadas las secciones de Tablas

Internas/Externas, Parmetros, Variables y Constantes, Data y Select Options.
Deber tener una seccin de rutina principal o Main Section, que defina el
ciclo de procesos del programa.

Todas las subrutinas de tipo PERFORM debern estar perfectamente

documentadas, con breve descripcin de lo que persigue lograr. Si la subrutina
utiliza parmetros de entrada/salida, estos debern de incluirse e identificarse.

Para la nomenclatura de los nombres de variables y constantes del programa

se deber utilizar la siguiente estandarizacin:

La nomenclatura: X_nomvariable

Donde X puede tomar cualquiera de los siguientes valores:

Emisor Aprobacin Tipo de Documento

Ziomara Lpez Eduardo A. Oropeza R.

SELLO
Pgina 6 de 12 F-SINO-002
 NORMATIVA GERENCIA DE SISTEMAS
Ttulo:
ESTNDARES DE DESARROLLO EN SAP
Sustituye a:
Cdigo Fecha de Vigencia Cdigo Pgina Fecha
N-SIDE-001 01/08/2007 ---------- ---------- ----------

(V) Indicador de una variable de trabajo.

(C) Indicador para variable de valor Constante del programa.
(B) Variable de Decisin booleana. 1 0.
(P) Parmetro de entrada de usuarios.
(S) Select-Options.

(_nomvariable) Nombre de la variable.

La variable debe tener un nombre lgico que guarde relacin con su funcin y
en ningn caso deben ser nombres de objetos no relacionados.

Las variables de uso local, debern ser definidas dentro de la forma o rutina
correspondiente. Las variables que se definan al inicio del programa principal,
son consideradas por ABAP como variables globales, a las cuales tambin
deber agregrseles un pequeo comentario indicando las rutinas en las
cuales se utiliza.

Los comentarios son esenciales. Toda la documentacin de rigor debe estar

embuida en el cuerpo del programa, as se evita de mantener la documentacin
fuera del objeto de programacin. Debe utilizarse el editor de documentacin
R3 que posee la herramienta o banco de trabajo (Workbench).

Debe colocarse a todos los desarrollos el chequeo de autorizacin Authority

Check. Los chequeos a utilizar son:

Z_OBJ_C: Chequeo para Centro

Z_OBJ_A: Chequeo para Sociedad

Las transacciones tambin poseen su respectivo chequeo de autorizacin el

cual es Z_OBJ_R. El valor deber ser el mismo cdigo de la transaccin.
A los perfiles de usuarios deben asignrseles las correspondientes
autorizaciones dependiendo del mdulo para el cual se utilice el reporte.

Nota:
Los nicos programas que no llevarn el chequeo de autorizacin sern los
programas tipo Include y los Batch Input o Output, as como aquellos de uso
exclusivo de la gerencia de sistemas.

Absolutamente todo trabajo de desarrollo de software se realizar nicamente

en el servidor que se tenga dispuesto para tal actividad.

Todos los trabajos de desarrollo deben contener la funcin

Z_MONITOREAR_PROGRAMA. Esta controla las veces que se corre un
Emisor Aprobacin Tipo de Documento

Ziomara Lpez Eduardo A. Oropeza R.

SELLO
Pgina 7 de 12 F-SINO-002
 NORMATIVA GERENCIA DE SISTEMAS
Ttulo:
ESTNDARES DE DESARROLLO EN SAP
Sustituye a:
Cdigo Fecha de Vigencia Cdigo Pgina Fecha
N-SIDE-001 01/08/2007 ---------- ---------- ----------

desarrollo y la fecha de su ltima ejecucin. Cuando un desarrollo ya no es

usado se puede detectar a travs de esta funcin, para lo cual se debe informar
a los usuarios que hacen uso del mismo que este ser desincorporado de
productivo y se respaldar en \\cindu1\sistemas\source_code y se agregar a la
lista de programas borrados en \\cindu1\sistemas\source_code\deleted\, en
caso de que este sea requerido posteriormente. El plazo para desincorporar un
programa de productivo es de un ao.

Para los programas que no deben permitir ms ejecuciones simultneas debe

colocarse la respectiva rutina de chequeo. Esto es con la finalidad de evitar
sobrecargas en el servidor para aquellos desarrollos muy pesados. La rutina
utilizada es la siguiente:

*-- Valida si programa ya esta en ejecucin

perform check_program using sy-uname sy-repid X.

Donde X es la cantidad de ejecuciones permitidas

Todo desarrollo ser sujeto a ser transportado desde el servidor de desarrollo al

servidor productivo. Para ello al analista deber cumplir con las normas al
respecto, llenar las formas de correccin y transporte. La Gerencia de
Sistemas, debern revisar los desarrollos y validar que estos cumplan con los
estndares estipulados en esta norma, para esto debern utilizar la plantilla F-
SIDE-001 Formato para validacin de desarrollos, en el caso de los nuevos
programas. Los formatos que no cumplan con los lineamientos establecidos
debern ser devueltos al programador para que este realice las modificaciones
pertinentes.

Todos los programas deben llevar su respectiva documentacin para que esta
pueda ser consultada por el usuario que utiliza el programa. Para ello deben
completar los parmetros de la opcin de documentacin tal como se muestra a
continuacin

Al pulsar el botn de modificar el programa se desplegar una pantalla donde se

debern colocar los siguientes datos:

&DESCRIPTION&: Colocar una breve descripcin de lo que realiza el programa y

el objetivo principal del reporte que se est emitiendo.

&PRECONDITION&: Se deben colocar los parmetros ms relevantes de

ejecucin del programa, que deben ser aclarados al usuario para el correcto
funcionamiento del reporte. Por ejemplo, si el reporte posee un flag que permite la
generacin o no de ciertas columnas cuando se marca, se debe colocar esta
Emisor Aprobacin Tipo de Documento

Ziomara Lpez Eduardo A. Oropeza R.

SELLO
Pgina 8 de 12 F-SINO-002
 NORMATIVA GERENCIA DE SISTEMAS
Ttulo:
ESTNDARES DE DESARROLLO EN SAP
Sustituye a:
Cdigo Fecha de Vigencia Cdigo Pgina Fecha
N-SIDE-001 01/08/2007 ---------- ---------- ----------

observacin para que el usuario conozca esta precondicin antes de generar el

reporte.

&OUTPUT&: Especificar que informacin generar el reporte una vez que sea
ejecutado.

&EXAMPLE&: Colocar un ejemplo de la salida o despliegue que se obtendr al

emitir el reporte. Esta seccin en opcional, y debe ser colocada cuando se quiera
resaltar algo importante en el layout del reporte.

Para validar que la documentacin del programa est correcta, antes de ejecutar el
mismo visualizar la ayuda ampliada por la siguiente ruta:

Ayuda -> Ayuda ampliada

TABLAS

Nomenclatura para asignar nombres a las tablas de datos fsicas o

transparentes dentro del diccionario de datos de SAP ECC:

ZXX99

Donde:
(Z) Constante estndar para desarrollo y creacin de objetos en SAP/R3.

(XX) Clave que indica el mdulo al que pertenece la tabla.

Ejemplo:
AP: Cuentas por pagar
SD: Ventas (Sales and Distribution)
MM: Manejo de Materiales...
PP: Planning Production
WM: Warehouse management

(99) Dgitos consecutivos para diferenciar las tablas dentro de los mdulos.

9 Todas las tablas transparentes creadas por el desarrollador Z*, deben contener los
campos de fecha y hora de creacin, as como el campo usuario.

9 Si la tabla va a ser actualizada por los usuarios, debe crearse su objeto de bloqueo.

9 Deben definirse elementos de datos y dominios para los campos de las tablas,
siempre y cuando no sean reutilizables los existentes en el diccionario, por lo que
debe realizarse una revisin previa antes de crear uno nuevo.
Emisor Aprobacin Tipo de Documento

Ziomara Lpez Eduardo A. Oropeza R.

SELLO
Pgina 9 de 12 F-SINO-002
 NORMATIVA GERENCIA DE SISTEMAS
Ttulo:
ESTNDARES DE DESARROLLO EN SAP
Sustituye a:
Cdigo Fecha de Vigencia Cdigo Pgina Fecha
N-SIDE-001 01/08/2007 ---------- ---------- ----------

9 Las tablas internas (internal tables) cuando sean espejo de una tabla transparente
debe anteponerse una z (zvbrk, zbsis) y en caso de no ser espejo, se debe empezar
por

PANTALLAS

Para la elaboracin de pantallas, es importante llevar una secuencia de las

mismas, de manera que se considere un nmero principal para la pantalla
inicial o pantallas iniciales y dejar un rango de nmeros disponibles para las
siguientes sub-pantallas o pantallas que pertenezcan a un mismo mdulo o
proceso.

Ejem: 1000 Pantalla del Men inicial

1100 Pantalla inicial de la opcin1 del men
1200 Pantalla de la opcin2 del men
1300 Pantalla de la opcin3 del men
MENU
Opcin1
Opcin2
Opcin3

MENUS

Durante la elaboracin de mens, cada uno tendr un nombre especfico.

ZXX

Donde:
(Z) Constante estndar para desarrollo y creacin de objetos en SAP/R3.

XX Clave que indica el mdulo al que pertenece el men, ejemplo:

AR: Cuentas por cobrar

SD: Ventas (Sales and Distribution)
MM: Manejo de Materiales.
PP: Planning Production
WM: Warehouse management

TRANSACCIONES:
Los nombres de las transacciones debern, de ser preferencia, los mismos que de
los programas.

Emisor Aprobacin Tipo de Documento

Ziomara Lpez Eduardo A. Oropeza R.

SELLO
Pgina 10 de 12 F-SINO-002
 NORMATIVA GERENCIA DE SISTEMAS
Ttulo:
ESTNDARES DE DESARROLLO EN SAP
Sustituye a:
Cdigo Fecha de Vigencia Cdigo Pgina Fecha
N-SIDE-001 01/08/2007 ---------- ---------- ----------

FORMULARIOS:
Cuando el formulario sea una copia del estndar, debe anteponerse una Z, de lo
contrario se debe seguir la misma nomenclatura que los programas.

CLASE DE DESARROLLO:
Coloque la clase de desarrollo segn el mdulo para el cual se elabora el
programa en el campo clase de desarrollo de la pantalla Propiedades de
Transporte y Presione Grabar.

Las clases de desarrollo utilizadas son:

ZAA: FI-AA: Desarrollos de Activos Fijos
ZAP: FI-AP: Desarrollos de Acreedores
ZAR: FI-AR: Desarrollos de Deudores
ZGL: FI-GL: Desarrollos de Libro Mayor
ZBC: Desarrollos de Basis de ECC
ZCO: Desarrollos de Controlling
ZFM: FUNCTION MODULES: Mdulos de Funcin
ZMM: Desarrollos de MM
ZPP: Desarrollos de Planificacin de la Produccin
ZSD: Desarrollos de Ventas y Distribucin
ZSF: Desarrollos de Fuerza de Ventas
ZTR: Desarrollos de Tesorera
ZWM: Desarrollos de Warehouse Management

TIPOS DE PROGRAMAS ABAP/4.

TIPO DESCRIPCION
1 Programa - Reporte de ejecucin en lnea.
J Programa de Ejecucin en Job. Reportes con sentencias
de Job-Control.
I Programa - Reporte Include o de Inclusin. Su cdigo no
ejecuta por s solo. Forma parte de otro programa que lo
llama.
M Modulo Pool: Programa que trabaja con las pantallas
(Dynpro) del Screen Painter.
V Programa de actualizacin de tablas.
F Mdulo de funciones. Programa que contiene funciones
globales. Se ejecuta normalmente desde otro programa
que lo llama con la sentencia CALL FUNTION. Pertenece
a una librera de funciones.

Emisor Aprobacin Tipo de Documento

Ziomara Lpez Eduardo A. Oropeza R.

SELLO
Pgina 11 de 12 F-SINO-002
 NORMATIVA GERENCIA DE SISTEMAS
Ttulo:
ESTNDARES DE DESARROLLO EN SAP
Sustituye a:
Cdigo Fecha de Vigencia Cdigo Pgina Fecha
N-SIDE-001 01/08/2007 ---------- ---------- ----------

IX. DIAGRAMA DE FLUJO:

No aplica.

Emisor Aprobacin Tipo de Documento

Ziomara Lpez Eduardo A. Oropeza R.

SELLO
Pgina 12 de 12 F-SINO-002