GUÍA DE BUENAS PRÁCTICAS PARA COMPLETAR LAS PLANTILLAS DE...

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


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).


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.


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.


… … …

Objetivo N Descripción del objetivo N, representa el propósito que se desea llevar a cabo en el proyecto.


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.



… … … …

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.




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 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


Fuente. Por ejemplo: Entrevistas.

… … … …

Expectativa N

Descripción de la Expectativa N. representa lo que espera el cliente del proyecto



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.


Hoja 8 de 27

SUPOSICIONES DEL PROYECTO

Analista: Nombre y Apellido del Analista Fecha: dd/mm/aaaa


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.



Suposición B

Descripción de la Suposición B. Representa el supuesto que posee el proyecto.



… … … …

Suposición N

Descripción de la Suposición N. Representa el supuesto que posee el proyecto.



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.


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


Objetivo con el cual se relacio-

na.


Restricción B




na.


… … … … …

Restricción N




na.


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).


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



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.


na. Fuente

Riesgo B



Descripción del Riesgo B.


na. Fuente

… … … … …

Riesgo N



Descripción del Riesgo N.


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


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



Hoja 11 de 27



ID Acción Acción ID Riesgo … … …

Acción N Descripción del plan de contingencia N donde se


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


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


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.


se relaciona


… … …

Objetivo N Descripción del objetivo N. Representa el interés del cliente, que es lo que pretende obtener.


se relaciona


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



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.



Suposición B Descripción de la Suposición B. Re-presenta el supuesto que posee el requisito.



… … … …

Suposición N Descripción de la Suposición N. Re-presenta el supuesto que posee el requisito.



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


Hoja 13 de 27

RESTRICCIONES DEL REQUISITO



ID Restricción Tipo Descripción Objetivo del

Req. Referencia

Restricción A

De org. / de datos/ de recursos humanos/ de recursos técnicos




Restricción B





… … … … …

Restricción N





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



ID# Identificación del proyecto, puede ser una frase muy breve y concisa que represente el objetivo del requisito.


Req. Referncia

Riesgo A

Genérico / Especi-

fico

Impacto x Prob.ocurren

cia

Descripción del Riesgo A.


na. Fuente

Riesgo B

Genérico / Especi-

fico


cia

Descripción del Riesgo B.


na. Fuente

… … … … …

Riesgo N

Genérico / Especi-

fico


cia

Descripción del Riesgo N.


na. Fuente


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.




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


… … …

Acción N Descripción del plan de contingencia N donde


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


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


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


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.


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


Atributo Origen Tipo de Atributo Objetivo del

Req. Referencia

Nombre del Atributo A

Archivo desde donde se obtiene

Alfanumérico / Numé-rico / Booleano / Lista


na.

Fuente donde está la documentación de del atributo A que se usó para

completar la planti-lla

Nombre del Atributo B


Alfanumérico / Numé-rico / Booleano


na.

Fuente donde está la documentación

de el atributo B que se usó para comple-

tar la plantilla. … … … … …

Nombre del Atributo N


Alfanumérico / Numé-rico / Booleano


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


Término Descripción Tipo Referencia

Concepto A Definición/significado del concepto A Acrónimo / Defini-ción / Abreviatura

Fuente desde donde esta


Hoja 16 de 27



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


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.


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.


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.


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:


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


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.


RESTRICCIONES DEL PROYECTO


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.




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


Hoja 23 de 27




1 Realizar nuevas encuestas para poder tener una

información mas actualizada. 1, 2

OBJETIVOS DEL REQUISITO


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


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



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



ID# Ej-TURISTA


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




1 Realizar entrevistas que mejoren los datos

actuales. 1, 2

ATRIBUTOS RELACIONADOS CON LOS REQUISITOS



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


Sexo Encuesta / Base de

datos Alfanumérico 1


Edad Encuesta / Base de

datos Lista de Numérico 1


Motivo Encuesta Alfanumérico 1, 2 Ejemplo de Encues-

ta / Entrevistas Noches en

alojamientos Encuesta / Base de

datos Numérico 1, 2


Gasto por día

Encuesta Numérica 2 Encuesta / Entrevis-

tas Tours reali-

zados Encuesta Lista de Alfanumérico 2


Gasto en Compras

Encuesta Numérica 2 Encuesta / Entrevis-

tas Opinión /

Satisfacción Encuesta Alfanumérico 2


Tarifa Encuesta / Base de

datos Numérico 2


FUENTE DE INFORMACIÓN PARA LOS REQUERIMIENTOS


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




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


Hoja 26 de 27




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


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.

GUÍA DE BUENAS PRÁCTICAS PARA COMPLETAR LAS PLANTILLAS DE...

Documents

Transcript of GUÍA DE BUENAS PRÁCTICAS PARA COMPLETAR LAS PLANTILLAS DE...