Upload
others
View
10
Download
0
Embed Size (px)
Citation preview
Reporte Técnico GEMIS-TD-2011-01-RT-2012-01
GUÍA DE BUENAS PRÁCTICAS PARA COMPLETAR LAS PLANTILLAS DE
REQUERIMIENTOS PARA PROYECTOS DE EXPLOTACION DE INFORMACIÓN
Ariel Deroche & María Florencia Pollo-Cattaneo
Grupo de Estudio de Metodologías para Ingeniería en Software Universidad Tecnológica Nacional – Facultad Regional Buenos Aires
Argentina
2012
Guía de Buenas Prácticas para completar Plantillas de Requerimientos para Proyectos de Explotación de Información
Hoja 2 de 27
ÍNDICE
1 INTRODUCCIÓN .............................................................................................. 3 1.1 Objetivo del documento .............................................................................. 3 1.2 Alcance del documento ............................................................................... 3 1.3 Tabla de Acrónimos utilizados ................................................................... 3
2 PLANTILLAS PARA LA DOCUMENTACIÓN DE REQUERIMIENTOS 4 2.1 Plantillas del Proyecto ................................................................................ 5 2.1.1 Objetivos del Proyecto ............................................................................ 5 2.1.2 Criterios de éxito del proyecto ............................................................... 6 2.1.3 Expectativas del proyecto ....................................................................... 7 2.1.4 Suposiciones del proyecto ....................................................................... 7 2.1.5 Restricciones del proyecto ...................................................................... 8 2.1.6 Riesgos del proyecto ................................................................................ 9 2.1.7 Plan de Contingencia del proyecto ...................................................... 10 2.2 Plantillas de los Requisitos ....................................................................... 11 2.2.1 Objetivos del requisito .......................................................................... 11 2.2.2 Suposiciones del requisito ..................................................................... 12 2.2.3 Restricciones del requisito .................................................................... 12 2.2.4 Identificación de riesgos ....................................................................... 13 2.2.5 Plan de contingencia ............................................................................. 14 2.3 Fuente de información para los requerimientos .................................... 14 2.3.1 Atributos relacionados con los requisitos ........................................... 15 2.4 Plantillas Generales................................................................................... 15 2.4.1 Glosario .................................................................................................. 15
3 PRINCIPIOS PARA REDACTAR LAS PLANTILLAS ........... ................... 17
4 EJEMPLO ......................................................................................................... 19
5 REFERENCIAS ................................................................................................ 27
Guía de Buenas Practicas para completar las Plantillas de Requerimientos para Proyectos de Explotacion de Información
Hoja 3 de 27
1 Introducción
1.1 Objetivo del documento
Este documento tiene como propósito establecer una guía de buenas prácticas para documentar correctamente el conjunto de plantillas que se utilizan para documentar los requerimientos educidos en un Proyecto de Explotación de Información (PEI). Se basa en la necesidad de establecer una guía para la correcta documentación de los requerimientos asociados a un PEI de manera adecuada, trazable y con bases sólidas.
1.2 Alcance del documento
El alcance de este documento es definir las plantillas de requerimientos para PEI así como criterios para asegurar la correcta redacción de los mismos. No se encuentra en el alcance de este documento los métodos y técnicas que deben ser utilizados para educir dicha información.
1.3 Tabla de Acrónimos utilizados
En esta sección se identifica y describe cada acrónimo que se utiliza en el documento.
Acrónimo Descripción
EdI Explotación de Información
PEI Proyecto de Explotación de Información
Guía de Buenas Prácticas para completar Plantillas de Requerimientos para Proyectos de Explotación de Información
Hoja 4 de 27
2 Plantillas para la documentación de Requerimientos
En [1] se propone un conjunto de plantillas para documentar los requerimientos edu-cidos durante las primeras fases de un PEI. Estos requerimientos incluyen tanto los objetivos del proyecto como las expectativas, necesidades y otra información educida de los interesados (stakeholders). En la figura 1 se pueden observar las diferentes plantillas en forma sintética junto con sus relaciones.
Fig. 1. Plantillas para documentación de requerimientos con sus relaciones
Como se puede observar en la figura anterior, existen plantillas relacionadas con el proyecto, con los requisitos y una plantilla de utilización general. • En cuanto a las plantillas del proyecto, la plantilla principal (objetivos del pro-
yecto) se relaciona con las demás del proyecto (Criterios de éxito, Suposiciones, Expectativas, Restricciones, Identificación de riesgos y Plan de contingencia).
Guía de Buenas Practicas para completar las Plantillas de Requerimientos para Proyectos de Explotacion de Información
Hoja 5 de 27
• A su vez, cada objetivo del proyecto tiene asociado un conjunto de requisitos. De esta manera, un objetivo del requisito se relaciona con un objetivo del proyecto siendo el primero, objeto central que vincula las demás plantillas (Suposiciones, Restricciones, Identificación de Riesgos y Plan de contingencia.)
• Finalmente, existe una plantilla (dentro de las mencionadas en [1]) de uso gene-ral, el glosario que se encuentra relacionada con todas las plantillas anteriores.
Los tres grupos de plantillas se describen en las siguientes subsecciones.
2.1 Plantillas del Proyecto
En esta sección se describen las plantillas asociadas al PEI que se muestran con sus relaciones en la figura 2.
Objetivos del proyecto
Expectativas del
proyecto Plan de
contingencia
Criterios de éxito
del proyecto
Suposiciones del
proyecto
Restricciones del
proyecto
Identificación de riesgos
del proyecto
Fig. 2. Plantillas del Proyecto
2.1.1 Objetivos del Proyecto
En esta plantilla se deben describir cuáles son los objetivos del PEI. En cuanto a los objetivos, se los puede definir como “expresiones cualitativas de los propósitos que se desean llevar a cabo en el proyecto establecido”. Es decir, son los elementos según los cuales un proyecto es organizado por lo que deben responder claramente la pregunta ¿qué pretende el cliente de nuestro trabajo?
Normalmente los objetivos del proyecto son generales por lo que deben estar muy bien definidos cada uno en forma individual, pero debe considerar que los objetivos indicados deben ser posibles de alcanzar.
Guía de Buenas Prácticas para completar Plantillas de Requerimientos para Proyectos de Explotación de Información
Hoja 6 de 27
La cantidad de objetivos depende del grado de complejidad de los problema de ne-gocio a resolver, y por lo tanto, se debe tener presente que esto no responde a cuestio-nes de redacción, sino de comprensión teórica del problema.
OBJETIVOS DEL PROYECTO
Analista: Nombre y Apellido del Analista Fecha: dd/mm/aaaa ID# Identificación del proyecto, puede ser una frase muy breve y concisa
ID Objetivo Descripción Referencia
Objetivo A Descripción del objetivo A, representa el propósito que se desea llevar a cabo en el proyecto.
Fuente del objetivo. Por ejemplo: Entrevistas.
Objetivo B Descripción del objetivo B, representa el propósito que se desea llevar a cabo en el proyecto.
Fuente del objetivo. Por ejemplo: Entrevistas.
… … …
Objetivo N Descripción del objetivo N, representa el propósito que se desea llevar a cabo en el proyecto.
Fuente del objetivo. Por ejemplo: Entrevistas.
2.1.2 Criterios de éxito del proyecto
En esta plantilla se deben describir los puntos necesarios para que el proyecto ten-ga éxito. Se indican las condiciones cuantitativas y cualitativas que deberán ser cum-plidas por el proyecto para poder asegurar que se lograron los objetivos y que el pro-yecto terminó exitosamente. Por lo tanto, deben tener relación directa con los objeti-vos del proyecto planteados (normalmente a uno, pero podría ser a más de uno).
Debe considerarse que a pesar de que el proyecto haya finalizado sin problemas, si los criterios de éxito no fueron satisfechos (es decir, no se cumplen las condiciones indicadas), no se puede considerar que el proyecto fue un éxito.
CRITERIOS DE ÉXITO DEL PROYECTO Analista: Nombre y Apellido del Analista Fecha: dd/mm/aaaa
ID# Identificación del proyecto, puede ser una frase muy breve y concisa.
ID Criterio Descripción Objetivo del Proy. Referencia
Criterio A
Descripción del Criterio A. Representa la condición que se debe cumplir para el éxito del proyecto, relacionado con el objetivo del proyecto.
Objetivo con el cual se relaciona.
Fuente. Por ejemplo: Entre-vistas.
Criterio B
Descripción del Criterio B. Representa la condición que se debe cumplir para el éxito del proyecto, relacionado con el objetivo del proyecto.
Objetivo con el cual se relaciona.
Fuente. Por ejemplo: Entre-vistas.
… … … …
Criterio N
Descripción del Criterio N. Representa la condición que se debe cumplir para el éxito del proyecto, relacionado con el objetivo del proyecto.
Objetivo con el cual se relaciona.
Fuente. Por ejemplo: Entre-vistas.
Guía de Buenas Practicas para completar las Plantillas de Requerimientos para Proyectos de Explotacion de Información
Hoja 7 de 27
2.1.3 Expectativas del proyecto
Las expectativas representan lo que el cliente espera del proyecto, lo cual debe coincidir con las metas del proyecto. Estas metas son más amplias que los objetivos del proyecto, y están muy relacionados con los problemas del negocio. Por lo que buscan responder a la pregunta ¿por qué el cliente desea realizar el proyecto?.
Sin embargo, no siempre es posible alcanzar todas las expectativas del proyecto por lo que se le deben asociar las condiciones para medir su satisfacción. En otras palabras, debe haber una relación directa con los criterios de éxito del proyecto (pu-diendo existir un criterio asociado a más de una expectativa) e indirecta con sus obje-tivos.
EXPECTATIVAS DEL PROYECTO Analista: Nombre y Apellido del Analista Fecha: dd/mm/aaaa
ID# Identificación del proyecto, puede ser una frase muy breve y concisa.
ID Expectativa
Descripción Criterio de Éxito
del Proy. Referencia
Expectativa A
Descripción de la Expectativa A. representa lo que espera el cliente del proyecto
Criterio con el cual se relaciona.
Fuente. Por ejemplo: Entrevis-tas.
Expectativa B
Descripción de la Expectativa B. representa lo que espera el cliente del proyecto
Criterio con el cual se relaciona.
Fuente. Por ejemplo: Entrevistas.
… … … …
Expectativa N
Descripción de la Expectativa N. representa lo que espera el cliente del proyecto
Criterio con el cual se relaciona.
Fuente. Por ejemplo: Entrevistas.
2.1.4 Suposiciones del proyecto
En esta plantilla se describen los supuestos del proyecto. Al comenzar a planear todo proyecto es necesario realizar hipótesis, teorías y opiniones que no están con-firmadas. Es decir, se considera cierto concepto o hecho como válido o real y, en base al mismo, se trabaja para encontrar una solución. Por lo tanto, un supuesto puede ser general a varios objetivos del proyecto o específico a uno sólo.
El éxito final del proyecto dependerá tanto de la identificación de las suposiciones con sus riesgos asociados así como la elaboración de planes de respaldo. Al documen-tar todos los supuestos, el equipo de trabajo podrá saber qué enunciados son inciertos al momento de la toma de decisiones.
Guía de Buenas Prácticas para completar Plantillas de Requerimientos para Proyectos de Explotación de Información
Hoja 8 de 27
SUPOSICIONES DEL PROYECTO
Analista: Nombre y Apellido del Analista Fecha: dd/mm/aaaa
ID# Identificación del proyecto, puede ser una frase muy breve y concisa.
ID Suposición
Descripción Objetivo del Proy. Referencia
Suposición A
Descripción de la Suposición A. Representa el supuesto que posee el proyecto.
Objetivo con el cual se relaciona.
Fuente. Por ejemplo: Entre-vistas.
Suposición B
Descripción de la Suposición B. Representa el supuesto que posee el proyecto.
Objetivo con el cual se relaciona.
Fuente. Por ejemplo: Entre-vistas.
… … … …
Suposición N
Descripción de la Suposición N. Representa el supuesto que posee el proyecto.
Objetivo con el cual se relaciona.
Fuente. Por ejemplo: Entre-vistas.
2.1.5 Restricciones del proyecto
La palabra restricción suele ser definida como una reducción o limitación a la hora de realizar una tarea o acción especifica. Aplicada al ámbito de un proyecto, las res-tricciones afectan el desempeño del mismo y como tales, deben ser tenidas en cuenta para asegurar el éxito del proyecto. Frecuentemente las restricciones que se repiten en los distintos proyectos suelen relacionarse con el tiempo, costo y alcance del mismo. De esta manera, se ha establecido la siguiente clasificación para tener en cuenta a la hora de poder gestionar las restricciones de la mejor manera posible:
a) Asociadas a la Organización Este tipo de restricción depende de la forma de la organización donde se realiza el proyecto. Involucra desde cuestiones de política hasta cuestiones legales de la or-ganización.
b) Asociadas a los Datos Todo proyecto se basa en distintas fuentes de información, las cuales se basan en determinados datos. Los mismos deben protegerse, contar con un sistema de acce-so correcto, de calidad y cantidad. Por ejemplo, gran parte de los datos son priva-dos; se debe contar con una política de historial en donde los datos antiguos se al-macenen en un repositorio secundario, etc.
c) Asociadas a Recursos Humanos En todo proyecto poseemos recursos humanos que deben ser administrados co-rrectamente. Existen muchos tipos de organizaciones y formas para la administra-ción de los recursos humanos. Los mismos generalmente se relacionan y comuni-can en base a una estructura jerárquica. A su vez, la administración y gestión de los mismos se basa en la determinación de sus funciones, horarios, vacaciones, etc.
Guía de Buenas Practicas para completar las Plantillas de Requerimientos para Proyectos de Explotacion de Información
Hoja 9 de 27
d) Asociadas a Recursos Técnicos De la misma manera, los recursos técnicos deben ser gestionados correctamente. Aquí se incluye el hardware y software de la organización, y actividades relacio-nadas a los mismos (administración de las bases de datos, servidores y redes, entre otros).
e) Asociadas al Proyecto Relacionado con las actividades que afectan al proyecto. Por ejemplo, cuestiones de seguridad de acceso a la información, actividades que requieren ciertas medi-das, etc.
RESTRICCIONES DEL PROYECTO
Analista: Nombre y Apellido del Analista Fecha: dd/mm/aaaa ID# Identificación del proyecto, puede ser una frase muy breve y concisa.
ID Restricción
Tipo Descripción Objetivo del
Proy. Referencia
Restricción A
De org. / de datos/ de recursos humanos/ de recursos técnicos / proyecto
Descripción de la Suposición A. Representa el supuesto que posee el proyecto.
Objetivo con el cual se relacio-
na.
Fuente. Por ejemplo: Entrevistas.
Restricción B
De org. / de datos/ de recursos humanos/ de recursos técnicos / proyecto
Descripción de la Suposición A. Representa el supuesto que posee el proyecto.
Objetivo con el cual se relacio-
na.
Fuente. Por ejemplo: Entrevistas.
… … … … …
Restricción N
De org. / de datos/ de recursos humanos/ de recursos técnicos / proyecto
Descripción de la Suposición A. Representa el supuesto que posee el proyecto.
Objetivo con el cual se relacio-
na.
Fuente. Por ejemplo: Entrevistas.
2.1.6 Riesgos del proyecto
En esta plantilla se deben incluir los resultados de la gestión de riesgos de un PEI. El riesgo se puede definir como “una probabilidad de que algo pueda suceder”, o en otras palabras “un problema potencial”. El término está vinculado a la proximidad de un posible daño y a la vulnerabilidad.
La identificación de riesgos es muy importante y necesaria para definir los planes de contingencia que se aplicarán si éstos se convierten en realidad. Luego de la identi-ficación, es importante realizar una clasificación de los mismos ya que habrá riesgos más importantes que otros. Cuando hablamos de la importancia, nos referimos al grado de exposición. Un riesgo conlleva una pérdida asociada, es decir un impacto (por ejemplo: pérdida de tiempo, de calidad, de dinero, etc.), y una probabilidad de ocurrencia (por ejemplo, se toma “0” como improbable y “1” como probable). La multiplicación de ambos da como resultado la exposición (una cuantificación de los efectos de los riesgos).
Guía de Buenas Prácticas para completar Plantillas de Requerimientos para Proyectos de Explotación de Información
Hoja 10 de 27
Por otro lado, tenemos dos fuentes principales de riesgos, los cuales nos ayudarán para la clasificación y gestión de los mismos.
a) Riesgos genéricos Son aquellos riesgos que se repiten en todos los proyectos (relacionados a la orga-nización o al equipo de trabajo), tales como mala estimación de tiempo, falta de experiencia, o falta de apoyo de los gerentes de la organización entre otros.
b) Riesgos específicos Este tipo de riesgo depende exclusivamente del proyecto que se está llevando a cabo. Por lo general, al no ser genérico, requiere un tratamiento especial y suele tener un alto grado de exposición. Por ejemplo, pérdida de información, datos in-suficientes, o falta de comprensión de los requerimientos.
IDENTIFICACIÓN DE LOS RIESGOS
Analista: Nombre y Apellido del Analista Fecha: dd/mm/aaaa
ID# Identificación del proyecto, puede ser una frase muy breve y concisa.
ID Riesgo Tipo Exposición Descripción Objetivo del
Proy. Referencia
Riesgo A
Genérico / Especifico
Impacto x Prob.ocurrencia
Descripción del Riesgo A.
Objetivo con el cual se relacio-
na. Fuente
Riesgo B
Genérico / Especifico
Impacto x Prob.ocurrencia
Descripción del Riesgo B.
Objetivo con el cual se relacio-
na. Fuente
… … … … …
Riesgo N
Genérico / Especifico
Impacto x Prob.ocurrencia
Descripción del Riesgo N.
Objetivo con el cual se relacio-
na. Fuente
2.1.7 Plan de Contingencia del proyecto
Vinculado al riesgo, es el plan alternativo al de carácter normal cuyo fin es garanti-zar la continuidad, en este caso del proyecto, cuando sucede algún tipo de eventuali-dad. Forma parte de la gestión de riesgos, confeccionando un plan alternativo en caso de que un riesgo se vuelva una realidad.
PLAN DE CONTINGENCIA
Analista: Nombre y Apellido del Analista Fecha: dd/mm/aaaa ID# Identificación del proyecto, puede ser una frase muy breve y concisa.
ID Acción Acción ID Riesgo
Acción A Descripción del plan de contingencia A donde se
especifican las acciones a tomar. Riesgo con el cual se relaciona
Acción B Descripción del plan de contingencia B donde se
especifican las acciones a tomar. Riesgo con el cual se relaciona
Guía de Buenas Practicas para completar las Plantillas de Requerimientos para Proyectos de Explotacion de Información
Hoja 11 de 27
PLAN DE CONTINGENCIA
Analista: Nombre y Apellido del Analista Fecha: dd/mm/aaaa ID# Identificación del proyecto, puede ser una frase muy breve y concisa.
ID Acción Acción ID Riesgo … … …
Acción N Descripción del plan de contingencia N donde se
especifican las acciones a tomar. Riesgo con el cual se relaciona
2.2 Plantillas de los Requisitos
En esta sección se describen las plantillas asociadas a los requisitos del PEI, que se muestran en la figura 3.
Objetivos del proyecto
Plan de
contingencia
Suposiciones del
proyecto
Restricciones del
proyecto
Identificación de riesgos
del proyecto
requisito
requisito requisito
requisito
Fig. 3. Plantillas de los Requisitos
2.2.1 Objetivos del requisito
En esta plantilla se detallan los objetivos del requisito. Estos objetivos enmarcan todos los resultados particulares del proyecto cuya sumatoria debe llevar, sin duda alguna, a la obtención de los objetivos del proyecto y por ende a la solución del pro-blema de negocio planteado.
Como los resultados de un proyecto de explotación de información están vincula-dos a la transformación de datos (generalmente en grandes cantidades) en conoci-miento mediante el descubrimiento de patrones presentes (implícitamente) en ellos, los objetivos del requisito deben indicar las características generales que deben satis-faces dichos patrones. En otras palabras, indican la descripción de cada uno de los modelos, con sus características, que serán generados durante el proyecto para satis-facer sus objetivos.
Los objetivos del requisito deben ser 100% verificables, y deben ser cuidadosa-mente analizados para lograr ubicar las palabras y la redacción exacta que permitan
Guía de Buenas Prácticas para completar Plantillas de Requerimientos para Proyectos de Explotación de Información
Hoja 12 de 27
exponer en forma muy clara todos y cada uno de los alcances individuales del trabajo planteado. Además, no hay que confundir los objetivos del requisito con las activida-des que se deben realizar en el proyecto.
OBJETIVOS DEL REQUISITO
Analista: Nombre y Apellido del Analista Fecha: dd/mm/aaaa
ID# Identificación del proyecto, puede ser una frase muy breve y concisa. ID Objetivo Descr ipción Obj. del Proy Referencia
Objetivo A Descripción del objetivo A. Representa el interés del cliente, que es lo que pretende obtener.
Objetivo del Proy con el cual
se relaciona
Fuente del objeti-vo. Por ejemplo: Entrevistas.
Objetivo B Descripción del objetivo B. Representa el interés del cliente, que es lo que pretende obtener.
Objetivo del Proy con el cual
se relaciona
Fuente del objeti-vo. Por ejemplo: Entrevistas.
… … …
Objetivo N Descripción del objetivo N. Representa el interés del cliente, que es lo que pretende obtener.
Objetivo del Proy con el cual
se relaciona
Fuente del objeti-vo. Por ejemplo: Entrevistas.
2.2.2 Suposiciones del requisito
Se indican las suposiciones relacionadas con los objetivos de los requisitos. Para mayor información ver sección 2.1.4.
SUPOSICIONES DEL REQUISITO
Analista: Nombre y Apellido del Analista Fecha: dd/mm/aaaa
ID# Identificación del proyecto, puede ser una frase muy breve y concisa.
ID Suposición Suposición Objetivo del Req. Referencia
Suposición A Descripción de la Suposición A. Re-presenta el supuesto que posee el requisito.
Objetivo con el cual se relaciona.
Fuente. Por ejemplo: Entrevis-tas.
Suposición B Descripción de la Suposición B. Re-presenta el supuesto que posee el requisito.
Objetivo con el cual se relaciona.
Fuente. Por ejemplo: Entrevis-tas.
… … … …
Suposición N Descripción de la Suposición N. Re-presenta el supuesto que posee el requisito.
Objetivo con el cual se relaciona.
Fuente. Por ejemplo: Entrevis-tas.
2.2.3 Restricciones del requisito
Aquí tratamos las limitaciones asociadas a los objetivos del requisito. Los tipos de restricciones son los mismos definidos en la sección 2.1.5
Guía de Buenas Practicas para completar las Plantillas de Requerimientos para Proyectos de Explotacion de Información
Hoja 13 de 27
RESTRICCIONES DEL REQUISITO
Analista: Nombre y Apellido del Analista Fecha: dd/mm/aaaa
ID# Identificación del proyecto, puede ser una frase muy breve y concisa.
ID Restricción Tipo Descripción Objetivo del
Req. Referencia
Restricción A
De org. / de datos/ de recursos humanos/ de recursos técnicos
Descripción de la Suposición A. Representa el supuesto que posee el proyecto.
Objetivo con el cual se relaciona.
Fuente. Por ejemplo: Entrevistas.
Restricción B
De org. / de datos/ de recursos humanos/ de recursos técnicos
Descripción de la Suposición A. Representa el supuesto que posee el proyecto.
Objetivo con el cual se relaciona.
Fuente. Por ejemplo: Entrevistas.
… … … … …
Restricción N
De org. / de datos/ de recursos humanos/ de recursos técnicos
Descripción de la Suposición A. Representa el supuesto que posee el proyecto.
Objetivo con el cual se relaciona.
Fuente. Por ejemplo: Entrevistas.
2.2.4 Identificación de riesgos
También se deben identificar los riesgos relacionados a los objetivos del requisito. Los tipos de riesgos son los mismos definidos en la sección 2.1.6
IDENTIFICACIÓN DE LOS RIESGOS
Analista: Nombre y Apellido del Analista Fecha: dd/mm/aaaa
ID# Identificación del proyecto, puede ser una frase muy breve y concisa que represente el objetivo del requisito.
ID Riesgo Tipo Exposición Descripción Objetivo del
Req. Referncia
Riesgo A
Genérico / Especi-
fico
Impacto x Prob.ocurren
cia
Descripción del Riesgo A.
Objetivo con el cual se relacio-
na. Fuente
Riesgo B
Genérico / Especi-
fico
Impacto x Prob.ocurren
cia
Descripción del Riesgo B.
Objetivo con el cual se relacio-
na. Fuente
… … … … …
Riesgo N
Genérico / Especi-
fico
Impacto x Prob.ocurren
cia
Descripción del Riesgo N.
Objetivo con el cual se relacio-
na. Fuente
Guía de Buenas Prácticas para completar Plantillas de Requerimientos para Proyectos de Explotación de Información
Hoja 14 de 27
2.2.5 Plan de contingencia
Al igual que la sección 2.1.7, forma parte de la gestión de riesgos, confeccionando un plan alternativo en caso de que un riesgo en cuestión se vuelva una realidad.
PLAN DE CONTINGENCIA
Analista: Nombre y Apellido del Analista Fecha: dd/mm/aaaa ID# Identificación del proyecto, puede ser una frase muy breve y concisa.
ID Acción Acción ID Riesgo
Acción A Descripción del plan de contingencia A donde
se especifican las acciones a tomar. Riesgo con el cual se relaciona
Acción B Descripción del plan de contingencia B donde
se especifican las acciones a tomar. Riesgo con el cual se relaciona
… … …
Acción N Descripción del plan de contingencia N donde
se especifican las acciones a tomar. Riesgo con el cual se relaciona
2.3 Fuente de información para los requerimientos
Aquí se detallan todas las fuentes de información (también conocida como reposi-torios de datos) que se identificaron para utilizar en el proyecto en cuestión.
Los distintos tipos de fuentes pueden ser: bases de datos, archivos de planilla de cálculo, documentos de texto y otro tipo de reportes.
FUENTE DE INFORMACIÓN PARA LOS REQUERIMIENTOS
Analista: Nombre y Apellido del Analista Fecha: dd/mm/aaaa ID# Identificación del proyecto, puede ser una frase muy breve y concisa.
Origen Tipo Descripción Responsable Referencia
Fuente A Archivo / Base de
dato
Detalle de la fuente de informa-ción (nombre del archivo, que
contiene, etc.)
Persona res-ponsable de la fuente A de
inf.
Fuente donde está la documentación de la fuente. A que se usó para com-pletar la plantilla
Fuente B Archivo / Base de
dato
Detalle de la fuente de informa-ción (nombre del archivo, que
contiene, etc.)
Persona res-ponsable de la fuente B de
inf.
Fuente donde está la documentación de la la fuente. B que se usó para
completar la plantilla
… … … … …
Fuente N Archivo / Base de
dato
Detalle de la fuente de informa-ción (nombre del archivo, que
contiene, etc.)
Persona res-ponsable de la fuente N de
inf.
Fuente donde está la documentación de la la fuente. N que se usó para
completar la plantilla.
Guía de Buenas Practicas para completar las Plantillas de Requerimientos para Proyectos de Explotacion de Información
Hoja 15 de 27
2.3.1 Atributos relacionados con los requisitos
Se identifican los atributos de los conceptos educidos en el proceso de especifica-ción de requerimientos que serán utilizados para cumplir cada requisito. Un atributo se puede utilizar para más de un requisito. Se declaran con un identificador y el tipo de dato correspondiente. Por ejemplo, un atributo podría ser el nombre de la persona cuyo tipo es alfanumérico.
ATRIBUTOS RELACIONADOS CON LOS REQUISITOS
Analista: Nombre y Apellido del Analista Fecha: dd/mm/aaaa ID# Identificación del proyecto, puede ser una frase muy breve y concisa.
Atributo Origen Tipo de Atributo Objetivo del
Req. Referencia
Nombre del Atributo A
Archivo desde donde se obtiene
Alfanumérico / Numé-rico / Booleano / Lista
Objetivo con el cual se relacio-
na.
Fuente donde está la documentación de del atributo A que se usó para
completar la planti-lla
Nombre del Atributo B
Archivo desde donde se obtiene
Alfanumérico / Numé-rico / Booleano
Objetivo con el cual se relacio-
na.
Fuente donde está la documentación
de el atributo B que se usó para comple-
tar la plantilla. … … … … …
Nombre del Atributo N
Archivo desde donde se obtiene
Alfanumérico / Numé-rico / Booleano
Objetivo con el cual se relacio-
na.
Fuente donde está la documentación
de el atributo N que se usó para comple-
tar la plantilla.
2.4 Plantillas Generales
En esta sección se describe la plantilla del Glosario que se encuentra asociada tanto al proyecto como los requisitos del PEI.
2.4.1 Glosario
En esta plantilla se incluyen todos los conceptos, acrónimos y abreviaturas que pueden llegar a ser conflictivos y/o ambiguos. Se busca documentar toda la termino-logía especial utilizada por la organización y que será utilizada para poder compren-der los significados de las otras plantillas.
DEFINICIONES, ACRÓNIMOS Y ABREVIATURAS
Analista: Nombre y Apellido del Analista Fecha: dd/mm/aaaa ID# Identificación del proyecto, puede ser una frase muy breve y concisa.
Término Descripción Tipo Referencia
Concepto A Definición/significado del concepto A Acrónimo / Defini-ción / Abreviatura
Fuente desde donde esta
Guía de Buenas Prácticas para completar Plantillas de Requerimientos para Proyectos de Explotación de Información
Hoja 16 de 27
DEFINICIONES, ACRÓNIMOS Y ABREVIATURAS
Analista: Nombre y Apellido del Analista Fecha: dd/mm/aaaa ID# Identificación del proyecto, puede ser una frase muy breve y concisa.
Término Descripción Tipo Referencia relacionado
Concepto B Definición/significado del concepto B Acrónimo / Defini-ción / Abreviatura
Fuente desde donde esta relacionado
… … … …
Concepto N Definición/significado del concepto N Acrónimo / Defini-ción / Abreviatura
Fuente desde donde esta relacionado
Guía de Buenas Practicas para completar las Plantillas de Requerimientos para Proyectos de Explotacion de Información
Hoja 17 de 27
3 Principios para redactar las Plantillas
Para completar las plantillas se recomienda utilizar las características indicadas en el Standard 830 del IEEE [2] las cuales son:
a) Corrección Si y sólo si todo requisito que figura en ella refleja alguna necesidad real.
b) Ambigüedad Es no ambiguo si y solo si cada requisito descrito tiene una única interpretación. En términos generales, el lenguaje natural es de los más ambiguos. Por el contra-rio existen los lenguajes formales que no son ambiguos, pero son más difíciles de aprender y menos comprensibles para el que no los conoce.
c) Completitud Es completa si: · Incluye todos los requisitos significativos. · Existe una definición de respuestas a todas las posibles entradas, tanto válidas como inválidas, en todas las posibles situaciones. · Cumple con el estándar utilizado. Si hay alguna parte del estándar que no se uti-liza, se debe razonar suficientemente el por qué no se ha utilizado dicho apartado. · Aparecen definidos todos los términos y unidades de medida empleados.
d) Verificabilidad Si existe algún proceso no excesivamente costoso por el cual una persona o una máquina pueda verificar que el resultado del proyecto satisface dicho requerimien-to.
e) Consistencia Si y sólo si ningún conjunto de requisitos descritos en ella son contradictorios o entran en conflicto.
f) Clasificación Pueden clasificarse por diversos criterios: · Importancia: Pueden ser esenciales, condicionales u opcionales. · Estabilidad: Cambios que pueden afectar al requisito. Lo ideal es el establecimiento de prioridades, de modo que la implementación de un requisito de menor prioridad no emplee excesivos recursos.
Guía de Buenas Prácticas para completar Plantillas de Requerimientos para Proyectos de Explotación de Información
Hoja 18 de 27
g) Modificable Si cualquier cambio puede realizarse de manera fácil, completa y consistente. Para ello, es deseable tener una organización coherente y fácil de usar en la que aparez-ca el índice o una tabla de contenidos fácilmente accesible.
h) Trazable Si el origen de cada requerimiento es claro tanto hacia atrás (origen que puede ser un documento, una persona etc.) como hacia delante (componentes del sistema que realizan dicho requisito).
Para cumplir dichos principios se recomienda utilizar los siguientes criterios: • Usar vocabulario mínimo: Utilizando términos propios del negocio y que está cap-
turado en la plantilla de glosario. • Utilizar sentencias simples: Una sentencia simple contiene una cláusula indepen-
diente, evitando sentencias compuestas (con dos o más cláusulas independientes). • Escribir en voz activa: Es cuando el sujeto es el agente de la acción. • Escribir el “qué” y no el “cómo”: Evitar describir la forma en que se alcanzará el
objetivo, sino el objetivo en sí. • Comenzar con verbo en infinitivo en el caso de Objetivos y Expectativas.
Algunos signos de alerta de plantillas con problemas • Se utiliza “jerga” no definida. • Se utilizan conjunciones: y, o, también, con, etc. • Se utilizan sentencias de excepción: sí, pero, excepto, a menos que, aunque, etc. • Se utilizan generalizaciones: generalmente, usualmente, frecuentemente, normal-mente, típicamente, cuando sea posible, etc. • Se utilizan términos sugestivos: podría, debería, quizás, probablemente, etc. • Se utilizan aclaraciones: eso es, por ejemplo, como, etc.
Guía de Buenas Practicas para completar las Plantillas de Requerimientos para Proyectos de Explotacion de Información
Hoja 19 de 27
4 Ejemplo
A continuación, un ejemplo en donde la solución del problema incluye la aplicación de las plantillas mencionadas anteriormente.
Notas de Entrevistas realizadas: La empresa de turismo XXX desea mejorar su oferta de paquetes turísticos te-niendo en cuenta el poder adquisitivo, es decir la proyección de gastos de sus clientes. Sus principales clientes son turistas nacionales e internacionales que desean visitar a la ciudad de Buenos Aires. La expectativa de la empresa a largo plazo es realizar promociones de turismos a clientes de alta gama. Se ha realizado una encuesta a turistas en varios circuitos (zonas) de la ciudad de Buenos Aires. Entre las preguntas realizadas se le ha consultado al turista sobre sus características y los gastos realizados durante su estadía. Las características relevadas en la encuesta son:
o País de residencia del turista. o Indica si el viaje fue realizado por agencia de turismo o por cuenta
propia. o Cantidad de personas que componen el grupo de turistas. o Motivo por el que realizaron la visita. o Sexo de cada una de las personas que componen el grupo de turistas. o Edad de cada una de las personas que componen el grupo de turistas. o Si se alojó en Buenos Aires o no. o Indica la cantidad de noches que el turista se alojó en Buenos Aires. o Nombre lugar en que se alojó el turista. o Lista de objetos comprados o servicios pagados en la ciudad de Bue-
nos Aires. o Monto total estimado de compras o servicios pagados en la ciudad de
Buenos Aires. o Tours realizados por el turista en la ciudad de Buenos Aires. o Cantidad estimada por día de dinero utilizado por el turista en su visita,
está compuesto por el monto de alojamiento (si lo hubiere), compras (incluyendo las comidas) y tours realizados.
o Opinión de la ciudad de Buenos Aires. o Opinión de la relación calidad/precio de los servicios de la ciudad de
Buenos Aires.
Guía de Buenas Prácticas para completar Plantillas de Requerimientos para Proyectos de Explotación de Información
Hoja 20 de 27
• A partir de las encuestas realizadas y registradas en un archivo Excel se desea determinar las características de los turistas que realizan un mayor gasto en la ciudad de Buenos Aires.
Algunas preguntas que se desea responder son:
• ¿En dónde y en cuáles segmentos se realiza el mayor gasto?
• ¿Qué factores influyen en la elección del hotel?
• ¿A mayor gasto en hotelería mayor gasto en la ciudad?
• ¿La estadía promedio está relacionada con el motivo de la visita?
• ¿El gasto está relacionado con el grupo de viaje y motivo de la visita?
• ¿Qué turista realiza mayor gasto y más distribuido?
• ¿Hay diferencia entre el gasto del turista Nacional y el Internacional?
• ¿Los turistas de países más lejanos, se quedan más tiempo, gastan más?
• ¿Cómo influye la percepción calidad/precio en el gasto final? • Se considera que la cantidad de encuestas realizas es suficientemente representa-
tiva para determinar a los turistas que realizan la mayor cantidad de gastos.
• No todas las preguntas han sido respondidas por los turistas, éstas han sido mar-cadas en el archivo Excel con un valor negativo.
• Los gastos de los turistas se componen por:
o Gastos de alojamiento (el cual depende de su categoría). o Gastos de compras (incluyendo comida y servicios pagados). o Gastos de tours realizados.
• Se puede acceder a información de los alojamientos a partir de una base de datos pública suministrada por el Ministerio de Turismo. A partir del nombre del alo-jamiento indicado en la encuesta por el turista, es posible determinar ciertos datos del alojamiento como son su localización, categoría y tarifa por noche.
• Una aclaración la ubicación del alojamiento caracteriza su categoría (ej: en San Telmo no hay hoteles de alta gama) por lo que se puede producir mucho sesgo. El turista elige por categoría o costo del alojamiento en primer lugar y no por el barrio (o sí, pero como consecuencia del lugar donde está ubicado el alojamien-to).
• Se puede acceder a información de los tours a partir de una base de datos pública suministrada por el Ministerio de Turismo. A partir del nombre del tour indicado en la encuesta por el turista, es posible determinar ciertos datos del mismo como son su descripción y tarifa.
• De un análisis preliminar se han observado que:
Guía de Buenas Practicas para completar las Plantillas de Requerimientos para Proyectos de Explotacion de Información
Hoja 21 de 27
o Los turistas que realizan su viaje en grupo, gastan montos similares y distribuidos en las mismas proporciones.
o Los turistas que poseen una opinión positiva en cuanto al precio de los servicios han realizado mayores gastos.
o Los turistas de países más lejanos se quedan más tiempo, pero gastan menos por día.
Se aplican las plantillas al problema propuesto
OBJETIVOS DEL PROYECTO
Analista: Ariel Deroche Fecha: 20/05/2012 ID# Ej-TURISTA
ID Objetivo Descripción Referencia
1 Mejorar la oferta de paquetes turísticos realizando una proyección de sus gastos en la ciudad de Buenos Aires.
Entrevistas
CRITERIOS DE ÉXITO DEL PROYECTO Analista: Ariel Deroche Fecha: 20/05/2012
ID# Ej-TURISTA
ID Criterio Descripción Objetivo del Proy. Referencia
1 Determinar las características de los turistas de alta gama en CABA
1 Entrevistas
EXPECTATIVAS DEL PROYECTO Analista: Ariel Deroche Fecha: 20/05/2012
ID# Ej-TURISTA
ID Expectativa
Descripción Criterio de Éxito
del Proy. Referencia
1 Realizar promociones de turismos a clientes de alta gama
1 Entrevistas
Guía de Buenas Prácticas para completar Plantillas de Requerimientos para Proyectos de Explotación de Información
Hoja 22 de 27
SUPOSICIONES DEL PROYECTO
Analista: Ariel Deroche Fecha: 20/05/2012
ID# Ej-TURISTA
ID Suposición
Descripción Objetivo del Proy.
Referencia
1 Se considera que la cantidad de encuestas realizas es suficientemente representativa para determinar a los turistas que realizan la mayor cantidad de gastos.
1 Base de datos
2 Las preguntas no respondidas por los turistas se consi-deran mínimas y no afectará el análisis final.
1 Base de datos
3 Los turistas que realizan su viaje en grupo, gastan montos similares y distribuidos en las mismas propor-ciones.
1 Entrevistas, Base
de datos
4 Los turistas que poseen una opinión positiva en cuanto al precio de los servicios han realizado mayores gas-tos.
1 Entrevistas, Base de datos
5 Los turistas de países más lejanos se quedan más tiempo, pero gastan menos por día.
1 Entrevistas, Base de datos
RESTRICCIONES DEL PROYECTO
Analista: Ariel Deroche Fecha: 20/05/2012 ID# Ej-TURISTA
ID Restricción
Tipo Descripción Objetivo del Proy.
Referencia
1 Datos Los turistas que interesan son nacionales e internacionales que desean visitar a la ciudad de Bs. As.
1 Entrevistas, Base de datos
IDENTIFICACIÓN DE LOS RIESGOS
Analista: Ariel Deroche Fecha: 20/05/2012
ID# Ej-TURISTA
ID Riesgo Tipo Exposi-
ción Descripción
Objetivo del Proy.
Refe-rencia
1
Genérico
Alto / 30% Los datos de los turistas no reflejan la realidad o están desactualizados.
1
Entre-vistas,
Base de datos
2
Genérico
Alto / 10%
No se puede acceder a las bases de datos debido a que no se cuenta con información para hacerlo, permisos o no contamos con recursos.
1 Base de datos
Guía de Buenas Practicas para completar las Plantillas de Requerimientos para Proyectos de Explotacion de Información
Hoja 23 de 27
PLAN DE CONTINGENCIA
Analista: Ariel Deroche Fecha: 20/05/2012 ID# Ej-TURISTA
ID Acción Acción ID Riesgo
1 Realizar nuevas encuestas para poder tener una
información mas actualizada. 1, 2
OBJETIVOS DEL REQUISITO
Analista: Ariel Deroche Fecha: 20/05/2012
ID# Ej-TURISTA ID Objetivo Descr ipción Obj. del Proy Referencia
1 Obtener las características de los turistas 1 Entrevistas
2 Obtener la distribución de los gastos de los turistas en la ciudad de Buenos Aires.
1 Entrevistas
SUPOSICIONES DEL REQUISITO
Analista: Ariel Deroche Fecha: 20/05/2012
ID# Ej-TURISTA
ID Suposición Suposición Objetivo del Req. Referencia
1 Los datos recolectados son suficientes 1, 2 Entrevistas
2 Los gastos de los turistas están clasifi-cados en alojamiento, compras y tours realizados.
2 Entrevistas
3
De un análisis preliminar se ha obser-vado que los turistas que poseen una opinión positiva en cuanto al precio de los servicios han realizado mayor cantidad de gastos.
2 Entrevistas
4
De un análisis preliminar, los turistas que realizan su viaje en grupo, gastan montos similares y distribuidos en las mismas proporciones
2 Entrevistas
5
De un análisis preliminar se ha obser-vado que los turistas de países más lejanos se quedan más tiempo, pero gastan menos por día.
2 Entrevistas
6
A partir del nombre del tour indicado en la encuesta por el turista, es posible determinar ciertos datos del mismo como son su descripción y tarifa.
2 Entrevistas
RESTRICCIONES DEL REQUISITO
Analista: Ariel Deroche Fecha: 20/05/2012
Guía de Buenas Prácticas para completar Plantillas de Requerimientos para Proyectos de Explotación de Información
Hoja 24 de 27
ID# Ej-TURISTA
ID Restricción Tipo Descripción Objetivo del
Req. Referencia
1 Datos Las preguntas no respondidas en la encuesta se encuentran indicadas con un valor negativo.
1, 2 Entrevistas
2 Datos Solo se tiene en cuenta a los turistas que se alojaron en la Ciudad de Buenos Aires.
1, 2 Entrevistas, Base de datos
3 Datos
El turista elige el alojamiento por categoría o costo del alojamiento y no por su ubicación (la localización del alojamiento es una consecuencia de la categoría elegida).
1 Entrevistas
4 Datos Gastos y montos en pesos argentinos 1, 2 Entrevistas, Base de datos
IDENTIFICACIÓN DE LOS RIESGOS
Analista: Ariel Deroche Fecha: 20/05/2012
ID# Ej-TURISTA
ID Riesgo Tipo Exposición Descripción Objetivo del
Req. Referncia
1
Genérico
Alto / 10%
Pocos registros y/o desactualizados que no permiten obtener con-clusiones
1, 2 Base de datos
2
Genérico Medio / 20% Preguntas importantes no respondidas por los turistas.
1, 2 Entrevistas
PLAN DE CONTINGENCIA
Analista: Ariel Deroche Fecha: 20/05/2012 ID# Ej-TURISTA
ID Acción Acción ID Riesgo
1 Realizar entrevistas que mejoren los datos
actuales. 1, 2
ATRIBUTOS RELACIONADOS CON LOS REQUISITOS
Analista: Ariel Deroche Fecha: 20/05/2012 ID# Ej-TURISTA
Guía de Buenas Practicas para completar las Plantillas de Requerimientos para Proyectos de Explotacion de Información
Hoja 25 de 27
Atributo Origen Tipo de Atributo Objetivo del
Req. Referencia
Tour realiza-do
Encuesta / Base de datos
Alfanumérico 2 Encuesta / Entrevis-
tas Cantidad de
Personas Encuesta Numérico 1, 2
Encuesta / Entrevis-tas
País Encuesta / Base de
datos Alfanumérico 1, 2
Encuesta / Entrevis-tas
Sexo Encuesta / Base de
datos Alfanumérico 1
Encuesta / Entrevis-tas
Edad Encuesta / Base de
datos Lista de Numérico 1
Encuesta / Entrevis-tas
Motivo Encuesta Alfanumérico 1, 2 Ejemplo de Encues-
ta / Entrevistas Noches en
alojamientos Encuesta / Base de
datos Numérico 1, 2
Encuesta / Entrevis-tas
Gasto por día
Encuesta Numérica 2 Encuesta / Entrevis-
tas Tours reali-
zados Encuesta Lista de Alfanumérico 2
Encuesta / Entrevis-tas
Gasto en Compras
Encuesta Numérica 2 Encuesta / Entrevis-
tas Opinión /
Satisfacción Encuesta Alfanumérico 2
Encuesta / Entrevis-tas
Tarifa Encuesta / Base de
datos Numérico 2
Encuesta / Entrevis-tas
FUENTE DE INFORMACIÓN PARA LOS REQUERIMIENTOS
Analista: Ariel Deroche Fecha: 20/05/2012 ID# Ej-TURISTA
Origen Tipo Descripción Responsable Referencia
Encuesta Archivo Encuestas realizadas. Agencia de
Turismo Encuesta/ Entre-
vistas
Alojamientos Base de Datos
Datos de los alojamientos. Ministerio de
Turismo Ministerio de
Turismo
Tours Base de Datos
Datos de los tours disponibles. Ministerio de
Turismo Ministerio de
Turismo
DEFINICIONES, ACRÓNIMOS Y ABREVIATURAS
Analista: Ariel Deroche Fecha: 20/05/2012 ID# Ej-TURISTA
Término Descripción Tipo Referencia
CABA Ciudad Autónoma de Buenos Aires Acrónimo Entrevistas,
Base de datos Cantidad de
Personas Cantidad de personas que componen el
grupo de turistas. Definición de Atri-
buto Entrevistas
Categoría Categoría del alojamiento. Definición de Atri-
buto Entrevistas
Circuito Zona en donde se realizó la encuesta. Definición de Atri-
buto Entrevistas
Guía de Buenas Prácticas para completar Plantillas de Requerimientos para Proyectos de Explotación de Información
Hoja 26 de 27
DEFINICIONES, ACRÓNIMOS Y ABREVIATURAS
Analista: Ariel Deroche Fecha: 20/05/2012 ID# Ej-TURISTA
Término Descripción Tipo Referencia
Compras Lista de objetos comprados o servicios pagados en la ciudad de Buenos Aires.
Definición de Atri-buto
Entrevistas
Gastos
Dinero utilizado por el turista en su visita, está compuesto por el monto de aloja-
miento (si lo hubiere), compras (incluyen-do las comidas) y tours realizados.
Definición de Con-cepto
Entrevistas
Localización Ubicación del hotel en la ciudad de Bue-
nos Aires. Definición de Atri-
buto Entrevistas
Motivo Motivo por el que realizaron la visita. Definición de Atri-
buto Entrevistas
Noches Indica la cantidad de noches que el turista
se alojó en la ciudad de Buenos Aires. Definición de Atri-
buto Entrevistas
Tarifa Precio promedio del tour. Definición de Atri-
buto Entrevistas
Turista Personas que no viven en CABA y que
permanecen por un tiempo en concepto de vacaciones, paseos, etc.
Definición de Con-cepto
Entrevistas
Guía de Buenas Practicas para completar las Plantillas de Requerimientos para Proyectos de Explotacion de Información
Hoja 27 de 27
5 Referencias
[1] Britos, P., Dieste, O., García-Martínez, R. (2008). Requirements Elicitation in Data Mining for Business Intelligence Projects. IFIP Series, 274: 139-150.
[2] Institute of Electronic and Electrical Engineers (1998). IEEE Standard 830-1998
IEEE Recommended Practice for Software Requirements Specifications. IEEE Computer Society. E-ISBN: 0-7381-0448-5.