PDF de programación - Normas y Estandares

Universidad de Córdoba

NORMAS Y ESTANDARES

Desarrollo de Aplicaciones

Revisión 1.0

Servicio de Informática
Area de Sistemas
Mayo 1993

1.

Introducción.

La Dirección de Informática de la Universidad de Córdoba tiene
como uno de sus objetivos fundamentales la promoción de la
integración de herramientas y procedimientos en el desarrollo
de los Sistemas de Información.

Uno de los aspectos clave de esta integración es la definición y
uso homogéneo de todas las herramientas de desarrollo.

Los objetivos de dicha normalización son:

Aumentar la confianza del usuario final en las aplica-
ciones desarrolladas, ofreciéndole un entorno familiar,
sin sorpresas ni excepciones.

Promover la colaboración entre los diferentes grupos de
desarrollo permitiendo que soluciones elaboradas para
una aplicación se utilicen en el desarrollo de otras.

Facilitar el mantenimiento de aplicaciones haciendo que
que un módulo no esté ligado al programador del mismo.

Dentro de la Dirección de Informática, se identifica el Area de
Sistemas como el área responsable de promover esta normaliza-
ción y de verificar su cumplimiento.

Para ello, el Area de Sistemas elaborará un conjunto de docu-
mentos que sirvan como base para dicha normalización, ofre-
ciendo un punto de referencia en la discusión sobre la misma.

Una vez aprobados, los Analistas responsables de cada aplicación
cuidarán de que los estándares se lleven a la práctica y el Area
de Sistemas verificará la implantación de los mismos.

Este documento contiene normas para el desarrollo de software
en sus aspectos fundamentales: estándares de nomenclatura,
entornos de explotación y desarrollo, uso de las herramientas,...

Los principales destinatarios son los analistas y programadores
responsables del desarrollo y mantenimiento de aplicaciones de
gestión. Se supone un conocimiento básico de ORACLE y de
todas las herramientas comentadas.

El documento no pretende ser completo. Muchos aspectos del
desarrollo de software quedarán fuera de estas especificaciones.

Servicio de Informática - Area de Sistemas

1

Universidad de Córdoba

❏
❏
❏
Capítulo 1 Introducción.

Por ello, resulta especialmente interesante que los responsables
de las diferentes aplicaciones propongan nuevos estándares para
todos aquellos aspectos no cubiertos en este documento, evitando
la diversificación de criterios en las soluciones propuestas a prob-
lemas comunes.

Este documento no contiene estándares sobre todos los aspectos
relacionados con el desarrollo de software. Se prepararán docu-
mentos adicionales que estandarícen aspectos como:



Metodología de análisis.

Desarrollo de pruebas unitarias y de integración.

Administración de Sistemas.

Administración de Bases de Datos.

Documentación.

Sistema de Gestión de Código.

Actualmente, el Area de Sistema tiene publicados dos Manuales
que se incorporan a la documentación de estándares:



Guia de Operación. Que normaliza el aspecto final de la
aplicación desde el punto de vista del usuario.

Sistema de Impresión. Manual del Programador. Que
normaliza la interface usuario-listados.

Servicio de Informática - Area de Sistemas

2

Universidad de Córdoba

2. Generalidades.

1.

Conceptos.

Aplicaciones

Funciones

Módulos

Introducimos en este apartado algunos conceptos generales que
nos serán de utilidad en la definición de estándares.

Llamaremos aplicación a cualquier desarrollo software funciona-
lmente independiente que, no obstante, puede interconectarse,
puntualmente, a otros desarrollos. Ejemplos de aplicaciones son
SIGA, SIGE y GAD.

A cada aplicación se le asocia un código único de una letra que
denominamos código de aplicación. Asimismo, se le asociará un
código extendido de no más de tres caracteres ( Tabla A.I,
Apéndice A).

Las aplicaciones se dividen en funciones con poca relación entre
sí cada una de las cuales cubre un aspecto del organigrama funci-
onal de la aplicación. Una aplicación típica no tendrá más de una
docena de tales funciones.

Las funciones se descomponen, a su vez, en subfunciones. La
comunicación entre las diferentes subfunciones de una misma
función será, en general, elevada. La subdivisión funcional puede
continuar, pero solo será significativa a propósitos de estanda-
rización un máximo de cinco niveles funcionales.

Funciones y subfunciones se codifican empleando un carácter
para cada nivel hasta un máximo de cinco caracteres, formando
una combinación única dentro de cada aplicación.

El nivel más bajo de esta jerarquía está formado por el módulo.
Una subfunción emplea uno o más módulos para realizar la tarea
que tiene encomendada. Un módulo puede ser cualquier pro-
grama: sell scripts, formas, reports,...

Los módulos pueden ser fuentes o ejecutables, si bien, algunas
clases de módulos (v.g. procedimientos SQL) pueden tratarse
indistintamente como fuentes o ejecutables.

Servicio de Informática - Area de Sistemas

3

Universidad de Córdoba

Capítulo 2 Generalidades.

Identificador

2. Entornos.

2.1 Definición.

Desarrollo

A cada módulo se le asigna un código de uno o más caracteres
dependiendo de la profundidad alcanzada en la codificación de
funciones: un sólo carácter si se ha llegado a cinco niveles, dos si
se llegó a cuatro,...

Por ultimo definiremos el concepto de identificador, el cual
emplearemos frecuentemente en la normalización de los nombres
de los diferentes objetos. Un identificador genérico se construye
abreviando la descripción del objeto (campo, tabla,...) al que pre-
tende identificar. Si la descripción consta de más de dos palabras
significativas, se incluirá el símbolo “_” como separador entre las
mismas. Un identificador nunca se construirá a partir de más de
tres palabras. Las palabras elegidas para construir el identifica-
dor pueden abreviarse.

El identificador puede contener exclusivamente los caracteres A-
Z, 0-9 y “_” debiendo comenzar por una letra.

Al identificador genérico se le añadirán códigos que aporten
información sobre el objeto identificado (como se describe posteri-
ormente en este documento) por lo que las palabras elegidas para
construir el identificador no deben hacer referencia a la natu-
raleza del objeto identificado.

Desde un punto de vista lógico se distinguirán tres entornos bien
diferenciados: Desarrollo, Integración y Explotación.

El Entorno de Desarrollo comprende todos los módulos sobre los
cuales trabaja el grupo de programación en las primeras fases
del desarrollo de una nueva aplicación: desarrollo y pruebas uni-
tarias. Existirá un Entorno de Desarrollo por cada nueva apli-
cación que se empiece.

Servicio de Informática - Area de Sistemas

4

Universidad de Córdoba

Capítulo 2 Generalidades.

Integración

El Entorno de Integración se compone de los módulos y escenar-
ios de datos necesarios para realizar las pruebas de integración
previas a la puesta en servicio de una aplicación. Una vez entre-
gada a los usuarios, el grupo de mantenimiento realizará su
labor sobre este entorno. Cada aplicación dispondrá de su propio
Entorno de Integración siendo posible disponer simultáneamente
de más de una versión de la misma aplicación.

Explotación

El Entorno de Explotación consta de los datos y módulos ejecuta-
bles que emplean los usuarios finales así como de todos los módu-
los necesarios para reconstruir la versión actual de los
ejecutables.

2.2 Responsabilidades.

Desarrollo

Integración

Cada programador dispondrá de sus propios directorios de tra-
bajo así como de datos independientes para realizar pruebas uni-
tarias de los módulos que vaya desarrollando. Es responsabilidad
del programador la organización de su directorio de trabajo así
como el mantenimiento de sus datos de prueba.

Se favorecerá el traspaso de módulos en desarrollo entre progra-
madores con la única limitación de que un programador no pueda
modificar el trabajo de otro.

Desde el primer momento que se necesite probar la integración
de dos o más módulos se creará un Entorno de Integración para
la aplicación correspondiente. A este entorno se pasarán los
módulos que hayan superado las pruebas unitarias y sobre los
que se vayan a realizar las pruebas de integración.

El Area de Sistemas creará los Entornos de Integración necesa-
rios pasando, a continuación, la responsabilidad del manten-
imiento de los escenarios de pruebas y de la coherencia del
Entorno de Integración al Analista responsable de la aplicación.

Hasta la puesta en servicio de la aplicación, existirán simul-
táneamente los Entornos de Desarrollo e Integración para una
misma aplicación. Una vez creado el Entorno de Explotación
dejara de existir el de desarrollo.

Servicio de Informática - Area de Sistemas

5

Universidad de Córdoba

Capítulo 2 Generalidades.

Para las aplicaciones en explotación es posible mantener varias
versiones de la misma en el Entorno de Integración (v.g. una
para mantenimiento y otra para desarrollar nuevas funcional-
idades).

Los Entornos de Integración de las diferentes aplicaciones
estarán aislados. Con el acuerdo previo de los Analistas respons-
ables, el Area de Sistemas facilitará la colaboración entre los
diferentes grupos de desarrollo.

Explotación

Las aplicaciones se distribuirán en el Entorno de Explotación
atendiendo a consideraciones de seguridad y de rendimiento.

La integridad y seguridad de los datos y módulos en el Entorno
de Explotación serán responsabilidad exclusiva del Area de
Sistemas. Se facilitaran los mecanismos adecuados para permitir
a los grupos de mantenimiento de aplicaciones el traspaso de
módulos modificados o nuevos al En