CONTEXTO
(¿asignatura pendiente?)
ASD54
Un proyecto, un requerimiento, bajo la responsabilidad
de un Líder, implica la interacción de Analistas, Desar-
rolladores y Usuarios.
Esa interacción y sus puntos de contacto, son regis-
trables en ASD54, formando desde el inicio, la Docu-
mentación Activa del Sistema.
La utilización de ASD54, no implica un esfuerzo adicio-
nal, porque simplemente organiza, administra e integra
la información que se genera en todo desarrollo,
transformándola en Documentación.
Distribuidor autorizado
ASD54
Documentación de Software
Una asignatura pendiente, todavía. Esto más que un
juicio de valor, es una realidad si consideramos el esfuer-
zo que se le dedica a su generación y la utilidad que se
obtiene, cuando se necesita por cualquier causa o cir-
cunstancia.
Es una etapa destinada, con la anuencia de casi todos, a
transformarse en “algo, para cumplir”.
Es una “entropía”, definida por el diccionario como “Can-
tidad de energía que por su degradación no puede
aprovecharse”. Ejemplificando, el calor emitido por un
motor, es energía que no puede aprovecharse, sin
embargo adaptando el sistema, esa energía nos provee
calefacción.
El software actualmente, se desarrolla siguiendo los
principios de la Ingeniería, pero una sutil diferencia
marca la necesidad no comprendida todavía de la docu-
mentación eficiente.
o El Software es un elemento del Sistema, es
lógico, no físico.
o Se desarrolla, no se fabrica en un
sentido clásico.
o No se "estropea", pero se deteriora (no
hay "repuestos").
o La mayor parte se construye a medida
o se modifica puntualmente, a medida.
Si consideramos la exposición previa, vamos entender la
importancia de la Documentación, que por cierto nadie
discute, pero pocos enfatizan en la práctica.
La prueba de fuego de la documentación, es cuando a
Distribuidor autorizado
partir de ella, un profesional calificado puede tomar una
decisión, sin pasar por el buceo habitual en el código
fuente de las Aplicaciones...
…esto es posible en su Organización?
ASD54 en el ciclo de vida del desarrollo de software
ASD54 (Active System Documentation)
Proyectos y Requerimientos (RQT)
Permite especificar la solicitud realizada por el Usuario
Final, que puede ser ingresada manualmente o a partir
de los registros existentes en el administrador de proyec-
tos que utilice la Organización. El RQT para ASD54,
cuenta con tres partes importantes, la propia Especifi-
cación y los recursos asignados, su Definición Funcional
y los Objetos Relacionados. El conjunto de estas tres
partes, forma la documentación requerida y necesaria en
cualquier desarrollo.
Objetos
Estos componentes del desarrollo del software, son difer-
enciados en ASD54 por su accionar sobre los datos,
pueden ser Contenedores o Transformadores de ellos.
Los Contenedores son las tablas, archivos, bases. Los
Transformadores son los ejecutables y programas.
La relación y dependencia de los objetos se manifiesta,
según la plataforma para la que se documente, en forma
automatizada o manual. Si la Organización cuenta con
una herramienta de Change Management, es posible
automatizar los registros de cambio en la documentación
técnica.
La consulta de objetos, permite la visualización del ciclo
de vida del objeto, a partir de su participación en los
distintos requerimientos, mostrando no solo los cambios
que lo afectaron, sino los motivos que llevaron a
dichos cambios.
Condiciones de Prueba
Para los Objetos como para los RQT, las condiciones de
prueba se ingresan y realizan por parte del personal
asignado a esa tarea, sea de Sistemas o un Usuario
Final.
En el caso de Objetos, la condición de prueba lo acom-
paña, desde el mismo momento de su creación, por
todos los pasos de modificación que pudiera sufrir.
Documentación de Sistemas
ASD54 Active System Documentation
Prosyde S.A. - www.prosyde.com – asd54@prosyde.com
Solo se pueden agregar/borrar condiciones de prueba,
en el Objeto, no en sus cambios, lo que permite una
constante verificación de su funcionalidad a pesar de los
cambios y quien los realice.
La prueba funcional es solo para el RQT. El SIT (System
Integration Test), se realiza por parte de Sistemas, mien-
tras que el UAT (User Acceptant Test) se realiza por parte
del Usuario Final, pudiendo tomar como base el SIT.
Arquitectura
En base a la documentación generada, se puede mostrar
en formato gráfico la Arquitectura de la instalación de
software de la Organización.
Estructurada en Unidad de Negocio, Sistemas, Módulos
y Ejecutables iniciales, permiten visualizar la
composición de los distintos árboles de llamadas, y de un
objeto en particular, si se desea. Este esquema facilita la
integración de la información a partir de la documen-
tación.
Auditorias
Sobre este punto en particular, ASD54 permite afrontar-
las con una nueva característica y visión. La documen-
tación se encuentra disponible en línea, actualizada y
generada a partir del momento en que se obtienen las
definiciones para el desarrollo del software o sus modifi-
caciones.
Los entregables, pueden listarse, las imágenes resultado
de las distintas metodologías utilizadas para el desarrollo
de software, se adjuntan a los RQT, formando una unidad
integral de información, disponible en todo momento.