Documentos de Académico
Documentos de Profesional
Documentos de Cultura
Documento: GUIA_INICIO.docx
Versin: 1.0
1/6
INTRODUCCIN
Qu es una gua Metodolgica
Definiremos gua metodolgica como el documento tcnico que describe el conjunto de
normas a seguir en los trabajos relacionados con los sistemas de informacin.
Alcance
Este documento y los que hace referencia va orientado a los Tcnicos y Analistas de
aplicaciones del ASIC.
Aunque el documento no va orientado a los programadores, si es interesante que ellos la
conozcan para saber donde encontrarn la documentacin.
Beneficios
Homogenizacin de la metodologa de trabajo de todos los miembros del ASICA. Facilitar
la adaptacin de los nuevos miembros del ASIC.
Documento: GUIA_INICIO.docx
Versin: 1.0
2/6
Documento: GUIA_INICIO.docx
Versin: 1.0
3/6
Documento: GUIA_INICIO.docx
Versin: 1.0
4/6
Guas Detalladas
Desarrollo y Mantenimiento Planificado: GUIA_DESARROLLO.docx
Mantenimiento de Aplicaciones:
ORGANIZACIN DE LA DOCUMENTACIN
En las diferentes tareas realizadas en cada uno de los trabajos se generarn numerosos
documentos e informacin en base de datos que es necesaria recopilar y organizar de una
forma adecuada y uniforme.
La organizacin se basa en el siguiente paradigma:
Cada proyecto pertenece necesariamente a una aplicacin, y por lo tanto toda la
documentacin del proyecto colgar de la aplicacin.
La documentacin que se genera con un proyecto pertenece al mismo pero puede ser de
utilidad general para la aplicacin por lo que es posible se duplique en los directorios de
documentacin de la aplicacin.
Documento: GUIA_INICIO.docx
Versin: 1.0
5/6
CONTROL DE CALIDAD
La necesidad de un Control de Calidad
Mecanismo de Control de Calidad
Documento: GUIA_INICIO.docx
Versin: 1.0
6/6
Documento: GUIA_DESARROLLO.docx
Versin: 1.0
1/16
AMBITO DE APLICACIN
Esta gua debe ser aplicada a todos los trabajos que cumplan alguna de estas condiciones:
PREREQUISITOS
Los trabajos incluidos en el mbito de aplicacin cumplen el prerrequisito de haber
pasado por un proceso previo de estudio de viabilidad donde ya se han considerado las
posibles alternativas y donde se ha decidido que es necesario empezar un proyecto de
desarrollo de software.
No se est por tanto realizando un anlisis de mercado ni probando alternativas, etc. En
este momento se tiene constancia de la aplicacin que se debe desarrollar, se tiene
identificado al cliente y el alcance est ms o menos determinado.
Documentacin a
Generar
Plantilla
Localizacin de la
Documentacin
Carcter Tarea
Definicin del
proyecto
Toma de
Requisitos
funcionales
Especificacin de
requisitos tcnicos
Diseo de
procesos
Planificacin de
Tareas
PLA_PROY_DEF.dotx
PROY\ANA
Obligatoria
PLA_PROY_REQ.dotx
PLA_ACTA.dotx
PROY\ANA
Obligatoria
PLA_PROY_REQTEC.dotx
PROY\ANA
PROY\ANA
Obligatorio si lo
requiere la aplicacin
Opcional
Project Server
Opcional
PROY\DIS
PROY\DIS
Obligat si se
modifican Tablas
Opcional
PROY\DIS
Opcional
PROY\SRC\Segn_Tecnolo
ga
Herramienta Ticketing
Obligatorio
APLIC\DOCUMENTACION\
MANUALES
Opcional
Definicin de la
base de datos
Generacin de los
cuadernos de
carga
Definicin de
pruebas
Programacin y
pruebas unitarias
Pruebas de
integracin
Generacin del
manual de la
aplicacin
Entrega piloto al
usuario y
aceptacin
Implantacin de
aplicacin
Monitorizacin
Formacin
Completar Cuaderno
Carga
Mdulos del Programa
PLA_CCARGA.dotx
Incidencias
Manual de la Aplicacin
PLA_MANUAL.docx
Opcional
Opcional
Opcional
Tests a pasar por Nagios
Material Formacin
PLA_PRESENTACION.potx
Documento: GUIA_DESARROLLO.docx
Versin: 1.0
Test en PIOLIN
PROY\USUARIOS
Opcional
Opcional
2/16
Dejar en PROY\ANA
Procedimiento
Generacin documento Word segn plantilla PLA_PROY_DEF.DOTX.
Envo por email al promotor con acuse de recibo.
(Registro del proyecto en la herramienta de gestin de proyectos y en el
repositorio de la documentacin. =>Anulado de momento)
Cdigo del proyecto
El cdigo consta de: rea+Aplicacin(Subsistema)+Versin
Siendo:
rea: Una de las 5 reas de trabajo del ASICA (ALU/BIB/COD/SEG/DWH)
Aplicacin(Subsistema): Puede ser la aplicacin Maestra o el Subsistema dentro
de una aplicacin maestras.
Versin: Puede ser la versin de la aplicacin o un orden secuencial de proyecto
por ao.
Ejemplos: ALU_VINCONVAL_v2010.01, ALU_POLIFORMAT_v2.6.01
Toma de Requisitos
Documento: GUIA_DESARROLLO.docx
Versin: 1.0
3/16
Descripcin
Consiste en la toma de requisitos de Negocio/Cliente/Funcionales que debe
cumplir la aplicacin. La forma de obtencin de los requisitos se basar en las
entrevistas con los usuarios y responsables de los procesos de negocio de las
unidades involucradas.
La toma de requisitos debe acabar con una validacin de los mismos por parte del
usuario que encarg el proyecto.
Procedimiento
Planificacin y realizacin de Entrevistas.
Generacin del listado de requisitos que debern inventariarse en la Herramienta
de Toma de Requisitos (). Para la toma de requisitos se puede seguir la
GUIA_Requisitos.docx.
Validacin de requisitos por el promotor. La forma de conseguir la aceptacin por
parte del usuario puede hacerse mediante el simple formalismo de envo de un
correo al usuario con el listado de requisitos y guardar la respuesta del mismo.
Caso de no encontrar respuesta por parte del promotor se le mandar un correo
similar a este:
Estimado compaero:
El presente correo lleva anexado un documento con la especificacin de requisitos del
proyecto de software solicitado por tu unidad.
Sirva este correo como justificante de entrega de los citados requisitos.
Ruego consideres el documento y quedo a la espera de tus modificaciones y comentarios.
Si transcurridas 2 semanas desde la fecha actual no he recibido contestacin alguna,
considerar que el documento es conforme a tus necesidades.
Recibe un cordial saludo.
El analista responsable.
Documentacin a Generar
Documento de Requisitos (Obligatorio). Utilizar la plantilla PLA_PROY_REQ.DOTX
Nombre: PROY_REQ_xxxxxxxxxx.DOC (Siendo xxxxx un alias del documento)
Datos a Incluir:
Cdigo del Proyecto
Tipo de Requisito (Negocio-General / Funcional-detallado)
Cdigo Numrico de Requisito
Descripcin del Requisito
Importancia
Dejar en PROY\ANA
Otra documentacin:
Documento: GUIA_DESARROLLO.docx
Versin: 1.0
4/16
Actas de Reuniones.
Documentacin de Normativas, etc
5/16
Documento: GUIA_DESARROLLO.docx
Versin: 1.0
6/16
Documentacin a Generar
Gregales asociados a las tareas
Documentos de Cuaderno de Carga de alguna de las tareas con nombre
DIS_CCARGA_xxxx.docx (Siendo xxxxx un alias del documento)
Definicin de pruebas
Descripcin
Identificar las pruebas que de se deben hacer en cada uno de los mdulos.
Procedimiento
Identificacin y descripcin de los casos de prueba.
Documentacin a Generar
Esta documentacin se puede incluir en el propio cuaderno de carga o gregal.
Programacin y pruebas unitarias
Descripcin
Es la tarea propiamente dicha de programacin
Procedimiento
Los programadores reciben el gregal y/o el cuaderno de carga con las
caractersticas del mdulo de programacin a realizar.
Se desarrolla el mdulo siguiendo las especificaciones.
Se realizan las pruebas unitarias.
Se realizan pruebas de integracin que afecten a este mdulo.
Documentacin a Generar
Mdulo de Programacin.
Segn la tecnologa el mdulo deber ser incluido en un punto u otro.
Para Forms deber situarse en APLIC\FORMS o APLIC\REPORTS.
Para Objetos del ncleo en el esquema correspondiente.
Para Java deber incluirse en APLIC\SRC.
Pruebas de integracin
Descripcin
Basndose en los requerimientos y los procesos descritos para la aplicacin, el
analista debe realizar pruebas que corroboren que la aplicacin cumple con los
requisitos.
Procedimiento
Revisin de cada uno de los requisitos de la aplicacin.
Comprobacin en la aplicacin que el requisito se cumple tal y como indica el
procedimiento.
Generacin de Incidencias por cada funcionalidad no cubierta por la aplicacin.
Documentacin a Generar
Incidencias de programacin de un mdulo.
Documento: GUIA_DESARROLLO.docx
Versin: 1.0
7/16
Documento: GUIA_DESARROLLO.docx
Versin: 1.0
8/16
Implantacin de aplicacin
Descripcin
Paso a los servidores de explotacin de todo lo necesario para empezar a trabajar
con la aplicacin.
Procedimiento
Preparacin del entorno de produccin.
Preparacin de la Base de Datos de produccin.
Copia de los programas desde desarrollo a preproduccin.
Generacin de los datos bsicos y/o de prueba necesarios.
Documentacin a Generar
Opcionalmente se generar un manual de despliegue, o informacin de
Infraestructura o se documentar en la wiki.
Monitorizacin de la aplicacin
Descripcin
Definir los tests que debern pasarse a la aplicacin para asegurarse
constantemente que se encuentra funcionando correctamente.
Procedimiento
Identificacin de los elementos de SW/HW susceptibles de monitorizar.
Definicin de los test a ejecutar, con los parmetros necesarios
Inclusin de los tests en PIOLIN
Documentacin a Generar
Conjunto de test a incluir en PIOLIN
Formacin
Descripcin
Identificar y preparar e impartir la formacin necesaria para los usuarios de la
aplicacin.
Procedimiento
Identificar las necesidades de formacin.
Preparar la documentacin necesaria para el curso/seminario/presentacin.
Documentacin a Generar
Material de formacin.
Presentaciones: Basado en PLA_PRESENTACION.pptx
PLANTILLAS DE DOCUMENTOS
Las plantillas de documento a usar son
Acta de Reunin: PLA_ACTA.dotx
Documento definicin del proyecto: PLA_PROY_DEF.dotx
Documento: GUIA_DESARROLLO.docx
Versin: 1.0
9/16
Documento: GUIA_DESARROLLO.docx
Versin: 1.0
10/16
HERRAMIENTAS A USAR
Para la gestin del proyecto se utilizarn las siguientes herramientas.
Herramienta de Toma de Requisitos.
Nombre:
Acceso:
Manual Uso:
Herramienta de Diseo de Casos de Uso
Nombre: Visio
Acceso:\\izar2\ms\Aplicaciones\Visio 2007 Professional
Manual Uso:
Herramienta de Diseo de Tablas
Nombre: SqlDataModeler
Acceso: Instalable localmente desde ..\GrupoHerramientas\DesignerDataModeler
Manual Uso:..\GrupoHerramientas\DesignerDataModeler\SQLDeveloperDataModeler_TechReview.pdf
Documento: GUIA_DESARROLLO.docx
Versin: 1.0
11/16
Documento: GUIA_DESARROLLO.docx
Versin: 1.0
12/16
Documento: GUIA_DESARROLLO.docx
Versin: 1.0
13/16
Documento: GUIA_DESARROLLO.docx
Versin: 1.0
14/16
Documento: GUIA_DESARROLLO.docx
Versin: 1.0
15/16
Documento: GUIA_DESARROLLO.docx
Versin: 1.0
16/16
Documento: GUIA_MATNOPLAN.doc
Versin: 1.0
1/8
AMBITO DE APLICACIN
Esta gua debe ser aplicada para el mantenimiento correctivo / adaptativo, es decir a
todos los trabajos que cumplan estas condiciones:
PREREQUISITOS
Los trabajos incluidos en el mbito de aplicacin de esta gua cumplen el prerrequisito de
haber sido registrados en Gregal, bien directamente por el usuario final o bien por el
personal informtico si la comunicacin del problema lleg por telfono u otra va distinta
a Gregal.
En este momento se tiene constancia de:
una descripcin exacta del problema y con datos suficientes para que pueda ser
reproducida.
TAREAS A REALIZAR
Visin General de las Tareas
Tarea
Registro de la incidencia
Documentacin a Generar
Tarea en Gregal
Carcter de la Tarea
Obligatoria
Cuaderno Carga
Opcional
Diagrama de Tablas
Documentacin en Cdigo
(Obligatorio el N Gregal
Obligatorio
Opcional
Tarea en Gregal
Obligatoria
Opcional
Pruebas de Regresin
Opcional
Opcional
Documento: GUIA_MATNOPLAN.doc
Versin: 1.0
2/8
Opcional
Obligatoria
Tipo de Problema:
o
Documento: GUIA_MATNOPLAN.doc
Versin: 1.0
3/8
Documento: GUIA_MATNOPLAN.doc
Versin: 1.0
4/8
Documento: GUIA_MATNOPLAN.doc
Versin: 1.0
5/8
Documentacin a Generar
Se podr utilizar alguna de estas alternativas
Pruebas de Regresin
Descripcin
Es necesario comprobar que los cambios que se lleven a cabo en los componentes
afectados no produzcan otros efectos negativos sobre el mismo u otros
componentes.
Procedimiento
Comprobar que los cambios provocados por una peticin/incidencia no
introduzcan un comportamiento no deseado o errores adicionales en otros
componentes no modificados.
Organizacin de la Documentacin
Deber generarse una carpeta raz para el proyecto que incluya toda la informacin relativa.
Esta carpeta colgar de la aplicacin a la que pertenece el proyecto.
La estructura de carpetas ser la siguiente:
Documento: GUIA_MATNOPLAN.doc
Versin: 1.0
6/8
Plantillas de Documentos
Documento de Control de cambios
Debe incluir fechas de notificacin del problema y fecha de aceptacin de la solucin por
parte del analista responsable. La fecha de aceptacin implica que el analista ha realizado
pruebas de como mnimo, que el problema original ya no ocurre.
Debe incluir la descripcin del problema de forma completa de modo que la entidad
correctora sea capaz de reproducir el problema.
Documento: GUIA_MATNOPLAN.doc
Versin: 1.0
7/8
Documento: GUIA_MATNOPLAN.doc
Versin: 1.0
8/8
PANTILLAS DE
DOCUMENTOS
Fecha:
Horario:
Asistentes
Nombre
Organizacin / Departamento
Observaciones
Apuntar las observaciones y conclusiones finales
Nota: Debe redactarse este modelo teniendo en mente que el acta debe servir para:
1) Poner al da a alguien que no pudo asistir a la reunin para que pueda saber qu
decisiones se tomaron, cul fue el proceso, conclusiones de la reunion, etc.
2) Dejar constancia y servir de recordatorio futuro para quienes s asistieron, sobre los temas
tratados y decisiones acordadas.
Proyecto:
Plantilla
Fichero:
Fecha
Actualizacin:
PLA_ACTA.docx
Versin: 1.0
22 de noviembre de 2011
Pg. 1 de 1
IdTarea: NombreTarea
IdTarea: NombreTarea
Identificacin de la Tarea
Id Tarea/Gregal:
Pr:
Nombre:
:
Requisito:
1
Mdulos Afectados:
Proyecto:
Fecha:
Descripcin de la Tarea
**********
Trabajo a Realizar
Proyecto:
Fichero:
Fecha
Actualizacin:
PROY_REQUISITOS
Versin: 1.0
22 de noviembre de 2011
Pg. 1 de 2
IdTarea: NombreTarea
1. Subtarea 1
2. Subtarea 2
Validacin/Pruebas
< ELIMINAR DEL DOCUMENTO DEFINITIVO: EN ESTA SECCIN SE DEBEN INCLUIR LAS PRUEBAS
UNITARIAS QUE DEBE PASAR EL MDULO O LA FORMA DE VALIDAR QUE EL TRABAJO EST
TEMINADO CORRECTAMENTE>
Documentacin a Generar
< ELIMINAR DEL DOCUMENTO DEFINITIVO: SI LA TAREA REQUIERE GENERAR DOCUMENTACIN
O ACTUALIZAR DOCUMENTACIN EXISTENTE SE DEBE ESPECIFICAR EN ESTA SECCIN>
Proyecto:
Fichero:
Fecha
Actualizacin:
PROY_REQUISITOS
Versin: 1.0
22 de noviembre de 2011
Pg. 2 de 2
Responsable
Objetivo 1
Objetivo 2
Objetivo 3
Proyecto:
Fichero:
Fecha
Actualizacin:
PLA_PROY_DEF.docx
Versin: 1.0
22 de noviembre de 2011
Pg. 1 de 2
Proyecto:
Fichero:
Fecha
Actualizacin:
PLA_PROY_DEF.docx
Versin: 1.0
22 de noviembre de 2011
Pg. 2 de 2
Responsable
Objetivo 1
Objetivo 2
Objetivo 3
Proyecto:
Fichero:
Fecha
Actualizacin:
PLA_PROY_REQ.docx
Versin: 1.0
22 de noviembre de 2011
Pg. 1 de 2
Proyecto:
Fichero:
Fecha
Actualizacin:
PLA_PROY_REQ.docx
Versin: 1.0
22 de noviembre de 2011
Pg. 2 de 2
Requisitos Tcnicos
Requisitos Tecnicos
Datos Proyecto
Proyecto:
Cliente:
Responsable ASIC:
Versin:
Fecha:
Descripcin
Breve descripcin del proyecto para poner en contexto a los tcnicos
DESA:S/N
PRE:S/N
DESA:S/N
PRE:S/N
PRO: S/N
Servidores de aplicaciones
Tipo:
Mquina:
Versiones:
Weblogic/Tomcat.
PRO: S/N
Usuario ftp:
Servidor Aplicaciones:
SO:
Estimaciones de Carga
N Usuarios concurrentes:
Estacionalidad:
Tamao Aplicacin:
Horario Uso:
Otros recursos
Recurso
Ej: Recurso de Red
Ej: Espacio en Subversion
Proyecto:
Fichero:
Fecha
Actualizacin:
PLA_PROY_REQTEC.docx
Versin: 1.0
22 de noviembre de 2011
Pg. 1 de 1