Guia Para El Informe Tecnico de Proyectos - Copia

Instituto Tecnológico Superior de Coatzacoalcos

Lic. En Informática e Ing. En Sistemas Computacionales

Guía para la elaboración del Informe Técnicode Proyectos

Abril de 2008


Guía para la elaboración del Informe Técnico

Introducción

El informe de investigación representa uno de los aspectos más importantes de la ciencia. Lo anterior requiere que el investigador conozca los principios, convencionalismos, estilo y formato propios de la redacción de documentos técnico-científicos.

El reporte técnico de investigación es un documento que se utiliza para informar tanto los procedimientos como los resultados de una investigación o proyecto de desarrollo tecnológico en forma concisa y dentro de una estructura lógica.

El propósito de esta guía es normar la publicación de los reportes técnicos que dan constancia de las actividades de investigación y desarrollo tecnológico realizadas por los alumnos del ITESCO como parte de su programa de titulación.

Se incluye una descripción de los tipos de documentos que pueden ser considerados como reportesTécnicos y un formato recomendado para dichos documentos.

Esta guía fue aprobada por la Academia de Informática y Sistemas del ITESCO en el mes de Abril de 2008.

Página 2



Especificaciones de formato.

De la portada

La primera hoja o portada del informe técnico deberá contener el título, nombre del autor(es), fecha de elaboración, …. (listar el resto de los elementos en orden de aparición)

Todos los datos se centrarán en el espacio en blanco de la figura. Se recomienda usar la portada que se incluye en el Anexo 1 como modelo. El título se escribirá en <<Indicar estilo>> de tamaño <<indicar tamaño>> en tamaño … etc. <<describir la portada>>

Del documento

Tamaño de la hoja y márgenes. Se deberá utilizar hoja tamaño carta, los márgenes superior e inferior deberán ser de << N >> cm. y los márgenes izquierdo y derecho deberán ser de <<N>>cm.

Fuente: Tipo, tamaño y estilo. Se recomienda elegir entre las fuentes: Times New Roman, Arial, Verdana o Tahoma. El tamaño de letra a usar en el texto es <<N>>. El tamaño y estilo a aplicar en títulos y subtítulos se detalla a continuación.

Nivel de título Tamaño y estilo EjemploTitulo nivel 1 <<N>> puntos, <<Estilo>><<Alineacion>>Subtitulo nivel 1Subtitulo nivel 2

Párrafo: Interlineado y alineación. El interlineado para el contenido del informe deberá ser: Sencillo en interior de párrafo. Doble entre párrafosTodo el documento deberá presentarse justificada, excepto en aquellos contenidos que requieran específicamente alineación al centro, izquierda o derecha.

Encabezados y pies de página

Tablas, gráficas y figuras

El formato de las tablas es libre, solo deberá observarse que el tipo y tamaño de letra sea igual al utilizado en el texto del documento. En casos excepcionales, se podrá utilizar un tamaño de letra menor a la del texto del documento pero que no sea menor de 8. Las tablas serán numeradas en forma consecutiva comenzando con 1.

El formato de las gráficas es libre, y deberán ser numeradas consecutivamente comenzando con 1, y en forma independiente.

Página 3



Las figuras y/o fotografías deberán ser de buena calidad. Se recomienda evitar el uso de sombras y líneas punteadas. Las figuras serán numeradas en forma consecutiva comenzando con 1 y de manera independiente de las tablas.

Las gráficas, figuras y tablas deberán ser referenciadas dentro del texto.

Códigos de programas. Se recomienda usar el tipo de letra Courier de tamaño 9 para listar código de programas. En caso de que el código exceda una página de longitud, se recomienda colocarlo en anexos al final del documento.

Referencias Bibliográficas. Conviene que sean actuales, autorizadas y de primera mano: libros, artículos, documentos, entrevistas, observación directa, ponencias, etc.Deberá de listarse las fuentes consultadas de acuerdo a las normas comúnmente aceptadas:

Si es de un libro:Autores. Nombre del libro. Edición. Editorial. Año. Páginas

Si es de una revista:Autor. “Artículo”. Revista. Fecha. Páginas

Si es de Internet:Autor. “Artículo”. Dirección de Internet. Fecha.

Anexos. Los anexos deberán colocarse al final del documento después de las referencias. Se recomienda usar caracteres alfabéticos para distinguirlos, por ejemplo: Anexo A, Anexo B, etc. Se recomienda colocar en los anexos información que, aunque importante, no es indispensable para la comprensión de lo reportado. Por ejemplo: demostraciones y desarrollos matemáticos, código de programas, diagramas eléctricos y mecánicos, etc.

Especificaciones para el desarrollo del reporte

En esta sección se proporcionan observaciones, tips y descripciones sobre lo que se espera en la redacción del informe técnico a desarrollar. Comenzando con una serie de consejos para la asignación del título del proyecto, y después presentando la organización del índice y posteriormente la descripción de cada uno de los puntos citados en el éste.

Titulo

En este apartado identificarás el título de tu trabajo procurando que no exceda de quince palabras. Deberás DESCRIBIR EL CONTENIDO del artículo en forma clara, exacta y concisa.

Se sugiere que tu título incluya: El tema central a investigar o unidad de medición. Ejemplo: tiempo de espera, cáncer cérvico-

uterino, satisfacción del usuario, expediente clínico, etc. Lugar de desarrollo de la investigación (Hospital, Jurisdicción Sanitaria, Centro de Salud,

Comunidad o Sector)

Página 4



Tiempo de realización. Es pertinente especificar cuál es el periodo de estudio, si éste es importante para medir el impacto, mejora o comportamiento de una población muestra en un determinado lapso.

Índice

Deberá generarse la tabla de contenido, con el desglose del mismo especificando las páginas correspondientes, un ejemplo del mismo se muestra a continuación:

IntroducciónJustificaciónObjetivosCapitulo I. Planteamiento del problema

Caracterización del área en que participóProblemática a resolverAlcances y limitaciones

Capitulo II. Fundamento teórico (Marco teórico)Capitulo III. Reporte de actividades

Procedimiento y descripción de las actividades realizadasResultados (planos, gráficas, prototipos y programas)

Conclusiones y recomendacionesFuentes de información (contrastar con residencia)Anexos

IntroducciónExposición breve y precisa del contenido básico de la investigación, con la inclusión de la metodología utilizada, los resultados obtenidos y las conclusiones relevantes, incluyendo sus posibles aplicaciones (máximo en 200 palabras). Esta redacción debe incluir básicamente

a. Planteamiento del problemab. Explicitar las metas y objetivos de la investigación.c. Presentación general de los resultados de las acciones de investigación

Se propone iniciar a redactar la introducción respondiendo concisamente las siguientes cuestiones, las cuales nos pueden servir de guía a la hora de ir integrando los contenidos de la introducción:

¿De qué se trata la investigación propuesta? ¿Cuál es su objetivo? ¿En qué contexto general se ubica? ¿Por qué reviste interés? ¿Qué resultados son los más significativos?

A continuación algunos ejemplos de introducción, tomados de diversos autores:El siguiente fragmento es tomado de Salgado, J., López, C. y Mariño, C. (2001, marzo).

Página 5



Disponible en: http://www.efdeportes.com/efd32/waterp.htm [2005, 27 de octubre]

La iniciación al Waterpolo a través del juego

Introducción

El presente trabajo surge de los resultados obtenidos de una experiencia llevada a cabo en la Escola de Polo Acuático que organizó la A.D. del I.N.E.F. de Galicia, España en colaboración con el Concelho de Oleiros durante el curso académico de 1996-97. Los alumnos y alumnas tenían una edad comprendida entre los 10 y los 14 años (aunque la mayor parte tenían 12), seleccionados de entre los de mejores habilidades acuáticas de la Escola de Natación del curso anterior (organizada por las entidades anteriormente citadas), lo que en principio nos permitía esperar un grupo con total independencia en el medio acuático…

Planteamiento del problemaLa definición de un problema específico es el primer paso en la elaboración de un proyecto de investigación y comprende las acciones necesarias para determinar lo que se va a investigar, además de que la selección del problema requerirá una fundamentación teórica y práctica de su importancia.

De la definición clara y precisa del problema depende la definición adecuada de las estrategias para abordarlo.El planteamiento del problema de investigación debe abarcar los siguientes aspectos:

Formulación o enunciado del problema. Delimitación o alcance del problema.

La formulación del problema debe consistir en una presentación clara del problema, con afirmaciones breves.

JustificaciónLa justificación del tema de investigación consiste en la fundamentación teórica y práctica de la elección de un problema y la exposición de los motivos de interés para realizar la investigación, incluyendo la determinación de los hechos que justifican su abordaje. Lo anterior implica un cuestionamiento de los criterios y supuestos en que se fundamentó dicha elección.

La justificación de una investigación deberá, en la medida de lo posible, poner en evidencia las razones teóricas, metodológicas y técnicas de un lado, y prácticas del otro, para realizar el trabajo. Dada la naturaleza de la investigación que se pretende realizar en el Departamento, serán especialmente importantes las razones técnicas y prácticas para realizar el estudio.

En la justificación se debe mencionar directamente la necesidad de la sociedad, grupo o persona que dió origen al proyecto, explicando en qué consisten los beneficios que darán los productos del proyecto.Se deberá describir de manera suficientemente clara, al grupo social que generó el proyecto y al grupo social que recibirá los beneficios: ¿cómo fué que se eligió ese problema de investigación? ¿qué empresa,

Página 6



industria, organismo, institución o circunstancia dió la opción de llevar a cabo el proyecto con esa temática?.

Se deberá cuidar que el proyecto promueva investigaciones que fomenten el desarrollo tecnológico, explicándose de que manera se logra esto.

Para la justificación se te sugiere que des respuesta a las siguientes preguntas: Trascendencia - ¿A quién afecta? ¿Qué tan importante es el problema? Magnitud - ¿Qué tan grande es? Vulnerabilidad - ¿Qué tan posible es resolverlo? Factibilidad – Desde mi ámbito de competencia ¿Qué tanto se puede modificar?

Objetivos: generales y específicosUna vez seleccionado y definido el problema a investigar, se deberá proceder a formular los objetivos de la investigación, en los cuales se responde a la pregunta de cuál es la finalidad del proyecto: exige definir qué es lo que se quiere lograr a través de la investigación.

Se deberán incluir tanto los propósitos de orden muy amplio (objetivos generales) como los objetivos más dirigidos (objetivos particulares o específicos). Cada objetivo deberá consistir en un enunciado claro y preciso de las metas que se persiguen. El enunciado de un objetivo debe excluir el mayor número de interpretaciones posibles del propósito a lograr.La definición de los objetivos es fundamental ya que la evaluación del trabajo de investigación se basa fundamentalmente en el logro de los objetivos planteados mediante un proceso sistemático, los cuales deben haber sido previamente señalados y seleccionados al comienzo de la investigación.

Objetivo GeneralRepresenta la finalidad que persigue la investigación, es decir, los logros DIRECTOS Y VALUABLES que se pretenden alcanzar. Corresponde a una pregunta de investigación cuya respuesta constituirá la conclusión del estudio. Debes tener especial cuidado para que el objetivo describa precisa y cabalmente tu investigación. Te sugerimos que contestes las siguientes preguntas para poder definir tu objetivo general:

¿Qué se va a hacer? Es decir, acción central a realizar. ¿En quién se va a realizar? Es decir, cuál es la unidad de observación. ¿Dónde se va a efectuar? Es decir, el lugar a donde se va llevar a cabo el estudio. ¿Cuándo y cuánto tiempo se va a operar? Es decir, el periodo para el desarrollo del

estudio.

Objetivos específicosEs aconsejable SUBDIVIDIR EL OBJETIVO general en partes más reducidas y conectadas, que te lleven al logro de dicho objetivo. Deberás especificar lo que se hará en el estudio, dónde y con qué fin. Deben ser claros, coherentes, realistas, medibles e iniciar en infinitivo.

Caracterización del área en que participóDeberá incluirse una descripción detallada acerca del área o departamento en el que se desarrollará el proyecto, ésta descripción incluirá:

Página 7



Ubicación del departamento dentro de la organización o empresa. Organigrama del área o departamento. Funciones y responsabilidades del departamento.

Problemas a resolver con su respectiva priorizaciónListado de los problemas detectados y que serán resueltos a partir de la puesta en marcha del proyecto propuesto.Ejemplo:Considerando las actividades que se desempeñan en el área, y previo análisis de éstas y el historial de resultados obtenidos, se identifican las siguientes áreas de oportunidad, las cuales serán atendidas por el proyecto propuesto:

Duplicidad en la información Acceso a información crítica por personal no autorizado. Retraso en la entrega de resultados de procesamiento de datos.

Alcances y limitacionesLos alcances permiten eestablecer qué puntos se abarcarán al desarrollar el proyecto, hasta dónde se va a llegar. Las limitaciones permiten determinar si existen obstáculos para el logro del objetivo final del proyecto tales como Falta de equipo, software, recurso humano.

Fundamento teóricoEl marco teórico, marco referencial o marco conceptual tiene el propósito de dar a la investigación un sistema coordinado y coherente de conceptos y proposiciones que permitan abordar el problema. "Se trata de integrar al problema dentro de un ámbito donde éste cobre sentido, incorporando los conocimientos previos relativos al mismo y ordenándolos de modo tal que resulten útil a nuestra tarea".

El fin que tiene el marco teórico es el de situar a nuestro problema dentro de un conjunto de conocimientos, que permita orientar nuestra búsqueda y nos ofrezca una conceptualización adecuada de los términos que utilizaremos.

Como mínimo hay que mencionar los elementos teórico-metodológicos en que se basaron las acciones investigativas:a) Explicitar conceptos, teorías y principios en que se fundamentaron las acciones de investigación.b) Analizar cómo se fueron realizando dichas acciones, cómo se fue fusionando la teoría con la práctica, etcétera.También debe incluirse el contexto en el que se llevaron a cabo las acciones de investigación:a) Las características de la población.b) Por qué se trabajó con dicha muestra. c) Describir los factores que intervinieron en el desarrollo de la investigación, ya sea que la hayan favorecido o limitado.

Página 8



Marco de Referencia

Esto exige del investigador la Identificación de un marco de referencia sustentado en el conocimiento científico; por ello, “cada investigación toma en cuenta el conocimiento previamente construido, por lo que cada investigación e apropia de parte de la estructura teórica ya existente”.

Marco Teórico

Es una descripción detallada de cada uno de los elementos de la teoría que serán directamente utilizados en el desarrollo de la investigación. También incluye las relaciones más significativas que se dan entre esos elementos teóricos.

Descripción de las actividades realizadas (para proyectos de investigación Descriptiva)

Objetivo:

El objetivo de la investigación descriptiva consiste en llegar a conocer las situaciones, costumbres y actitudes predominantes a través de la descripción exacta de las actividades, objetos, procesos y personas. Su meta no se limita a la recolección de datos, sino a la predicción e identificación de las relaciones que existen entre dos o más variables. Los investigadores no son meros tabuladores, sino que recogen los datos sobre la base de una hipótesis o teoría , iexponen y resumen la información de manera cuidadosa y luego analizan minuciosamente los resultados, a fin de extraer generalizaciones significativas que contribuyan al conocimiento.

Página 9

ESTELA, 29/04/08,

Consultar definición en el investigación experimental



Etapas:

1. Examinan las características del problema escogido. ( influencia , movimiento, incidencias…)

2. Lo definen y formulan sus hipótesis.

3. Enuncian los supuestos en que se basan las hipótesis y los procesos adoptados.

4. Eligen los temas y las fuentes apropiados.

5. Seleccionan o elaboran técnicas para la recolección de datos.

6. Establecen, a fin de clasificar los datos categorías precisas, que se adecuen al propósito del estudio y permitan poner de manifiesto las semejanzas, diferencias y relaciones significativas.

7. Verifican la validez de las técnicas empleadas para la recolección de datos.

8. Realizan observaciones objetivas y exactas.

9. Describen, analizan e interpretan los datos obtenidos, en términos claros y precisos.

Recolección de datos:

En el informe de la investigación se señalan los datos obtenidos y la naturaleza exacta de la población de donde fueron extraídos. La población —a veces llamada universo o agregado— constituye siempre una totalidad. Las unidades que la integran pueden ser individuos, hechos o elementos de otra índole. Una vez identificada la población con la que se trabajará, entonces se decide si se recogerán datos de la población total o de una muestra representativa de ella. El método elegido dependerá de la naturaleza del problema y de la finalidad para la que se desee utilizar los datos.

Población total:

Muchas veces no es difícil obtener información acerca de todas las unidades que componen una población reducida, pero los resultados no pueden aplicarse a ningún otro grupo que no sea el estudiado.

Muestra de la población:

Cuando se trata de una población excesivamente amplia se recoge la información a partir de unas pocas unidades cuidadosamente seleccionadas, ya que si se aborda cada grupo, los datos perderían vigencia antes de concluir el estudio. Si los elementos de la muestra representan las características de la población, las generalizaciones basadas en los datos obtenidos pueden aplicarse a todo el grupo.

Expresión de datos:

Los datos descriptivos se expresan en términos cualitativos y cuantitativos. Se puede utilizar uno de ellos o ambos a la vez.

Cualitativos (mediante símbolos verbales): Se usan en estudios cuyo objetivo es examinar la naturaleza general de los fenómenos. Los estudios cualitativos proporcionan una gran cantidad de información valiosa, pero poseen un limitado grado de precisión, porque emplean términos cuyo significado varía para las diferentes personas, épocas y contextos. Los estudios cualitativos contribuyen a identificar los factores importantes que deben ser medidos. (Visión cientificista).

Cuantitativos (por medio de símbolos matemáticos): Los símbolos numéricos que se utilizan para la exposición de los datos provienen de un cálculo o medición. Se pueden medir las diferentes unidades, elementos o categorías identificables.

Página 10



Descripción de las actividades realizadas (para proyectos de desarrollo de software)

El proceso de desarrollo de software define quién debe hacer qué, cuándo y cómo. No existe un proceso de software universal, las características de cada proyecto exigen que el proceso sea configurable.

Rational Unified Process (RUP) menciona tres formas de desarrollo: Proceso Dirigido por los Casos de Uso, Proceso Iterativo e Incremental y Proceso Centrado en la Arquitectura, siendo el primero uno de los más empleados debido a su estrecha relación con UML.

Proceso Dirigido por los Casos de Uso

Etapas:

1) Ingeniería de requerimientos.

(Capturar, definir y validar los casos de uso). La Ingeniería de Requerimientos cumple un papel primordial en el proceso de producción de software, ya que enfoca un área fundamental: la definición de lo que se desea producir. Su principal tarea consiste en la generación de especificaciones correctas que describan con claridad, sin ambigüedades, en forma consistente y compacta, el comportamiento del sistema; de esta manera, se pretende minimizar los problemas relacionados al desarrollo de sistemas.

Comprensión del dominio (análisis del contexto organizacional) Recolección de requerimientos Clasificación Resolución de conflictos Priorización Verificación (completos, consistente y acordes)

2) Análisis y diseño (Realizar los casos de Uso)

Análisis: Elementos que intervienen en el sistema a desarrollar, sus elementos, estructura, relaciones, funcionalidades, para saber qué se va a construir, qué funcionalidades aportará.

En esta etapa se deben identificar las entradas del problema, los resultados deseados o salidas y cualquier requerimiento o restricción adicional en la solución

Identificar qué información se proporciona (datos del problema) Identificar qué resultados deben calcularse y/o desplegarse Determinar la forma y las unidades en qué se deben desplegar los resultados Acotar las teorías, fundamentos y/o principios necesarios haciendo los supuestos y

simplificaciones necesarias Identificar los tipos y estructuras de datos necesarios para los datos del problema y para los

resultados Identificar las funciones u operaciones necesarias para cubrir los requerimientos del problema

Página 11



Es necesario determinar qué elementos intervienen en el sistema a desarrollar, así como su estructura, relaciones, evolución en el tiempo, detalle de sus funcionalidades, ... que van a dar una descripción clara de qué sistema vamos a construir, qué funcionalidades va a aportar y qué comportamiento va a tener. Para ello se enfocará el sistema desde tres puntos de vista relacionados pero diferentes:

La primera actividad de esta etapa es desarrollar un modelo conceptual:

Liste los conceptos idóneos usando la lista de categorías de conceptos y la identificación de la frase nominal relacionadas con los requerimientos en cuestión.

Dibújelos en un modelo conceptual. Incorpore las asociaciones necesarias para registrar las relaciones para las cuales debe reservar

un espacio en la memoria. Agregue los atributos necesarios para cumplir con las necesidades de información.

Uno de los aspectos indispensables para alcanzar el éxito en la culminación de un proyecto es la elaboración de un cronograma de actividades que consiste en una lista de todos los elementos terminales de un proyecto con sus fechas previstas de comienzo y final. Un elemento importante de la calendarización de estos entregables es la especificación de la cadena crítica donde se advierten las fechas de comienzo y final del elemento terminal, por lo que sugiere que la gestión de un proyecto no se base en cronograma tradicional, sino que se adicione el uso de técnicas como la gestión de buffers y la mentalidad de quien está retrasado.

Para crear un cronograma de proyecto, lo ideal que el encargado de proyecto tenga una estructura de descomposición del trabajo (EDT), una estimación de esfuerzo para cada tarea, y una lista del recurso con la disponibilidad de cada uno. El cronograma puede ser creado usando un método de valoración hecho a conciencia. La razón de esto es que un cronograma en sí mismo es una estimación: cada fecha en él se estima, y si en esas fechas no se realizan las entregas de subproductos por parte de la gente que va a hacer el trabajo, el cronograma será inexacto.Existen muchos programas de computación que realizan cronogramas de proyectos, éstos realizan automáticamente el trabajo tedioso de calcular los tiempos. Sin embargo, antes de que un encargado de proyecto pueda utilizar estas herramientas, debe entender los conceptos detrás de la EDT, de las dependencias, de la asignación de recursos, de las rutas críticas, de los diagramas de Gantt y del valor ganado. Éstas son las llaves verdaderas a planear un proyecto acertado.

Diseño: Tras la etapa anterior ya se tiene claro que debe hacer el sistema, ahora tenemos que determinar cómo va a hacerlo (¿cómo debe ser construido el sistema?; aquí se definirán en detalle entidades y relaciones de las bases de datos, se pasará de casos de uso esenciales a su definición como casos expandidos reales, se seleccionará el lenguaje más adecuado, el Sistema Gestor de Bases de Datos a utilizar en su caso, librerías, configuraciones hardware, redes, etc.). De la misma manera se realizan los diagramas de secuencia que han de dictar la forma en que se logrará programar las especificaciones de los casos de uso obtenidas en las etapas anteriores.

Se refiere a determinar cómo funcionará de forma general sin entrar en detalles. Consiste en incorporar consideraciones de la implementación tecnológica, como el hardware, la red, etc. Se define cómo se desarrollarán los Casos de Uso para cubrir las funciones que realizará el sistema, y se transforman las

Página 12



entidades definidas en el análisis de requisitos en clases de diseño, obteniendo un modelo cercano a la programación orientada a objetos.

3) Programación.

Llegado este punto se empieza a codificar algoritmos y estructuras de datos, definidos en las etapas anteriores, en el correspondiente lenguaje de programación y/o para un determinado sistema gestor de bases de datos.

4) Pruebas (Verificar que se satisfacen los casos de uso).

Consiste en comprobar que el software realice correctamente las tareas indicadas en la especificación. Una técnica de prueba es probar por separado cada módulo del software, y luego probarlo de forma integral, para así llegar al objetivo. Se considera una buena práctica el que las pruebas sean efectuadas por alguien distinto al desarrollador que la programó, idealmente un área de pruebas; sin perjuicio de lo anterior el programador debe hacer sus propias pruebas.

En general hay dos grandes formas de organizar un área de pruebas, la primera es que esté compuesta por personal inexperto y que desconozca el tema de pruebas, de esta forma se evalúa que la documentación entregada sea de calidad, que los procesos descritos son tan claros que cualquiera puede entenderlos y el software hace las cosas tal y como están descritas. El segundo enfoque es tener un área de pruebas conformada por programadores con experiencia, personas que saben sin mayores indicaciones en qué condiciones puede fallar una aplicación y que pueden poner atención en detalles que personal inexperto no consideraría.

5) Implementación.

Hacer funcionar el sistema global hardware-software incluyendo conversión de programas y datos, instalación y capacitación.

Se debe validar si el sistema cumple con los requerimientos expresados por el cliente. Las etapas de pruebas e implementación se pueden realizar en paralelo, pero no como una

única etapa.

Proceso Iterativo e Incremental. El ciclo de vida iterativo se basa en la evolución de prototipos ejecutables que se muestran a los usuarios y clientes. En el ciclo de vida iterativo a cada iteración se reproduce el ciclo de vida en cascada a menor escala y los objetivos de una iteración se establecen en función de la evaluación de las iteraciones precedentes

Cada iteración comprende:

• Planificar la iteración (estudio de riesgos)• Análisis de los Casos de Uso y escenarios• Diseño de opciones arquitectónicas• Codificación y pruebas. La integración del nuevo código con el existente de iteraciones

anteriores se hace gradualmente durante la construcción• Evaluación de la entrega ejecutable (evaluación del prototipo en función de las

pruebas y de los criterios definidos)• Preparación de la entrega (documentación e instalación del prototipo)

Página 13



Resultados (planos, gráficas, prototipos y programas)

Resultado para Proyectos de desarrollo de Software

Se entiende como resultado el proceso por el cual se presenta todo el trabajo realizado durante un tiempo determinado. En el caso de un desarrollo de software se deben contemplar en la entrega de resultados lo siguiente:

1. Plan de instalación y capacitación.2. Manual de Instalación3. Manual de usuario4. Manual Técnico5. Discos de instalación

Plan de Instalación y Capacitación

Un plan nos da la base para realizar una instalación de su sistema o programa, en forma más rápida, profesional y efectiva. En la instalación del software tomamos en cuenta los siguientes puntos:

Distribución de la aplicación

La distribución se refiere a la disposición física de los distintos nodos o estaciones de trabajo que componen un sistema y el reparto de los componentes (almacenamiento de datos) sobre dichos nodos. Los Diagramas de distribución son herramientas muy eficientes para describir tal distribución.

Requerimientos físicos, mínimos y óptimos del equipo

Las características mínimas del equipo a partir de las cuales el software puede funcionar, así como las características óptimas donde el uso del programa no disminuye o afecta a la computadora.

Requerimientos de software preinstalado en el equipo

Especificar el software necesario para poder utilizar el programa o sistema desarrollado, es todo lo que permita o requiera el programa para funcionar, de manera correcta, como por ejemplo:

Software Base Sistema Operativo y Versiones Compilador Maquina Virtual

Capacitación

Página 14



Consiste en plan de trabajo de la fase de capacitación, se deben incluir los tiempos necesarios y puntos que se deben abarcar. Esto es el soporte que garantiza el éxito en la implementación de un software.

Manual de Instalación

Procedimientos de Instalación. Los pasos necesarios para poder lograr una instalación apropiada del software. En esta sección se hace una breve descripción de lo que se requiere para la instalación.

Manual Técnico

El manual técnico es el que contiene todas las especificaciones descritas en el análisis y el diseño del sistema. Es el manual que esta orientado al especialista, y es del cual se basan para la realización de mantenimientos al software, así como de actualizaciones y mejoras

Manual de usuario

El manual del usuario tiene todas las instrucciones para la utilización del software que hemos desarrollado. Debido a que este muestra todas la interfaces gráficas con el usuario, decidimos ubicarlo en el disco de instalación del software. De esta manera permitimos que el usuario pueda tener acceso a la documentación del manual en cualquier momento o pueda imprimirlo desde el archivo.

Discos de Instalación.

Generar los CD correspondientes de instalación. Se sugiere generar un CD que incluya toda la información anterior incluyendo el Instalador. Si el Sistema incluyendo la Base de datos requiere mas de un CD, elabore el número de CD necesarios para la entrega.

ANEXOS

Diagramas de Distribución ó Distribución Física de los Elementos del Sistema

Esta vista presenta el mapping de componentes de software ejecutables con los nodos de procesamiento (hardware). Esta arquitectura tiene en cuenta los siguientes requerimientos:

Disponibilidad del sistema Rendimiento Escalabilidad

Los diagramas de distribución muestran el despliegue de nodos (locales y remotos), en la organización de la empresa. Permite al equipo de desarrollo comprender mejor la topología de un sistema distribuido.

Página 15



Un Nodo es un objeto físico run-time que representa un recurso informático. Este recurso, generalmente dispone de datos persistentes y capacidad de proceso. En la mayoría de los casos un Nodo puede representar una pieza de hardware, desde un periférico a un servidor. Las Conexiones entre Nodos muestran las líneas de comunicación con las que el sistema tendrá que interactuar.

Los Componentes, en un diagrama de distribución, representan los módulos físicos de código, los cuales, se corresponden con los Packages (paquetes) de ejecutables. De esta manera, el diagrama muestra donde corre cada Package en el sistema.

Las Dependencias muestran cómo los componentes se comunican con otros componentes. La dirección de una Dependencia concreta, indica el conocimiento en la comunicación.

Elementos del Diagrama de Distribución

Nodo. Representa un recurso de cómputo que puede alojar artefactos y que se puede interconectar con otros nodos para describir topologías de redes.

Dispositivo. Representa un recurso físico de cómputo que posé capacidad de procesamiento; se representa igual que un nodo.

Entorno Ejecutable. Representa un recurso lógico de cómputo dentro del cual se alojan manifestaciones de componentes de cierto tipo.

Rutas de Comunicación. Asociación que se modela sólo entre objetivos de distribución (nodos, dispositivos o entornos ejecutables) indicando que estos pueden intercambiar mensajes y señales.

Componente. Representa unidades autocontenidas de software que realizan a las clases o a cualquier elemento empacable

Artefacto. Representa la manifestación de un componente en el mundo físico.

Un buen libro de UML profundiza estos términos y elementos.

SOFTWARE PARA LA ELABORACION DE CD DE PRESENTACION.

CD Splash

http://cd-splash.softonic.com/

Este programa te permite crear pantallas de presentación (las llamadas "splash screens")

Autorun CD Studio 2.12

http://autorun-cd-studio.softonic.com/

Página 16

http://autorun-cd-studio.softonic.com/

http://cd-splash.softonic.com/



Esta herramienta te permite crear páginas Web que se ejecutan desde un CD, de forma muy sencilla, a través de una interfaz asistente en tres pasos.

EasyBoot 5.1.2.586

http://easyboot.softonic.com/

Crea discos de arranque personalizados para Windows

AutoPlay Media Studio 7.0

http://autoplay-media-studio.softonic.com/

Herramienta de desarrollo visual para poder crear aplicaciones de CD y DVD con reproducción automática (autorun) desde Windows. Es la forma más fácil y rápida de crear menús AutoPlay para cualquier CD o DVD que tengamos.

AutoRun Pro Enterprise 12.0.4.132

http://autorun-pro.softonic.com/

AutoRun Pro es una impresionante utilidad para crear menús que auto-ejecutables que acompañen a tus CD (y DVD)

Sicasoft Automatic Autorun Creator 2.3.2006.18

http://sicasoft-automatic-autorun-creator.softonic.com/

Dota tus CD con una completa automatización creando archivos AUTORUN.INF totalmente personalizables.

ArtixMedia Menu Studio 3.71

http://artixmedia-menu-studio.softonic.com/

Gracias a aplicaciones como ArtixMedia Menu Studio crearás CD mucho más presentables, con su menú personalizado, sus botones interactivos, efectos, música… Interesante si el CD es para ti y más aún si se trata de un regalo para otra persona.

Resultados (para proyectos de investigación)

Página 17

http://artixmedia-menu-studio.softonic.com/

http://sicasoft-automatic-autorun-creator.softonic.com/

http://autorun-pro.softonic.com/

http://autoplay-media-studio.softonic.com/

http://easyboot.softonic.com/



El reporte de resultados el proceso cuantitativo

Antes de elaborar el reporte de investigación debe de definirse el usuario, ya que el reporte deberá de adaptarse a éste.

Los reportes de investigación pueden presentarse en un contexto académico o en un contexto no académico.

El usuario y el contexto determinan el formato, la naturaleza, la naturaleza y la extensión del reporte de investigación.

Para presentar el reporte de investigación se pueden utilizar diversos apoyos o recursos.

Los resultados se encuentran en tablas, gráficas, cuadros, diagramas, etc. Es necesario comunicar los resultados mediante un reporte, el cual puede adquirir diferentes formatos: un libro, un artículo para una revista científica o para un diario de divulgación general, una presentación en computadora, un documento técnico, una tesis, un DVD, etc.

Lo primero es definir el tipo de reporte que es necesario elaborar, esto depende de varias precisiones:

1. Las razones por las cuales surgió la investigación (tesis, trabajo solicitado por un profesor, a solicitud de una empresa)

2. Los usuarios del estudio (un grupo de ejecutivos de la empresa3. El contexto en el que se deberá de presentar (el reporte será un contexto no académico)

Usuarios, contextos y estándares para la investigación

Usuarios Contextos comunes posibles

Estándares que normalmente aplican para elaborar el reporte

Tipo de reporte

Profesionistas y practicantes dentro del campo donde se inserta el estudio

No académico (regularmente el caso de las empresas)

Lineamientos lógicos o estándares pragmáticos

Relevancia del problema estudiado

Orientación más bien visual del contenido (gráficas, cuadros, etc.; sólo los elementos más importantes)

Resultados fácilmente identificables y aplicables

Sugerencias prácticas y concretas para implementar.

Resumen ejecutivo Informe técnico Presentaciones

audiovisuales

Muestra de introducción de un reporte no académico (Ejemplo)

Calidad total

La fundación Mexicana para la Calidad Total, A.C. (Fundameca), realizó una investigación por encuestas para conocer las prácticas, técnicas, estructuras, procesos y temáticas existentes en calidad total en

Página 18



nuestro país. La investigación de carácter exploratorio, constituye el primer esfuerzo para obtener una radiografía del estado de los procesos de calidad en México. No es un estudii exhaustivo, sólo implica un primer acercamiento, que en los años venideros irá extendiendo y profundizando la Fundación.

El reporte de investigación que a continuación se presenta tiene como uno de sus objetivos esenciales propiciar el análisis, la discusión y la reflexión, profunda respecto a los proyectos para incrementar la calidad de los productos o servicios que ofrece México a los mercados nacional e internacional. Como nación, sector y empresa: ¿vamos por el camino correcto hacía el logro de la calidad total? ¿Qué estamos haciendo adecuadamente? ¿Qué nos falta? ¿Cuáles son los obstáculos a los que nos estamos enfrentando? ¿Cuáles son los retos que habremos de rebasar en la primera década del siglo? Éstas con algunas de las preguntas que estamos valorando y necesitamos responder. La investigación pretende aportar algunas pautas para que comencemos a contestar en forma satisfactoria dichos cuestionamientos.

La muestra de la investigación fue seleccionada al azar sobre la base de tres listados: listado Expansión 500, listado de la gaceta Cambio Organizacional y listado de las reuniones para constituir Fundameca. Se acudió a 184 empresas, de las cuales 60 no proporcionaron información. Dos encuestas fueron eliminadas por detectarse inconsistencias lógicas. En total se incluyeron 122 casos válidos.

Esperamos que sus comentarios y sugerencias amplíen y enriquezcan este proceso investigativo.

Fundameca

Dirección de investigación

Recursos para presentar el reporte de investigación

Se pueden presentar en programas de dibujo, de gráficas, presentaciones y elaboración de documentos.

Reporte de Resultados Cualitativo

En los reportes de resultados del proceso cualitativo el investigador necesita definir el tipo de reporte que resulta necesario elaborar, el cual depende de las siguientes precisiones: 1) Las razones por las cuales surgió la investigación, 2) Los usuarios del estudio, 3) El contexto en el cual se habrá de presentar.

El reporte debe ofrecer una respuesta al planteamiento del problema y señalar las estrategias que se usaron para abordarlo, así como los datos que fueron recolectados, analizados e interpretados por el investigador.

Características y recomendaciones:

El reporte es una expresión narrativa donde se presentan los resultados con todo detalle, aunque debe obviarse los pormenores que conozcan los lectores. Por ejemplo: Supongamos que presentamos a la junta directiva de un hospital una investigación sobre la relación entre un grupo de médicos y sus pacientes terminales, la descripción del ambiente (el hospital) debe ser muy breve, ya que supuestamente los miembros de la junta lo conocen.

Las descripciones y narraciones utilizan un lenguaje vívido, fresco y natural. El estilo es más personal y se puede redactar en primera persona.

Página 19



Así mismo, tal informe se redacta en tiempo pasado(pretérito). Por ejemplo: “la maestra fue…”, “se entrevistaron a…”.

El lenguaje no debe ser “sexista” ni discriminatorio en modo alguno. Conviene utilizar varios diccionarios: Diccionario de lengua española(Editado por la real

academia española), diccionario de sinónimos y antónimos, diccionario de términos cualitativos, etc.

Las secciones del reporte deben relacionarse entre sí por un “hilo conductor” (el último párrafo de una sección con el primero de la siguiente sección).

En los reportes deben incluirse fragmentos de contenido o testimonios (unidades de análisis) expresados por los participantes (citas textuales, en su lenguaje, aunque las palabras sean incorrectas desde el punto de vista gramatical o puedan ser consideradas “impropias” por algunas personas).

Para enriquecer la narración, se recomienda usar ejemplos, anécdotas, metáforas y analogías. La narración puede comenzar con una historia costumbrista, un testimonio, una reflexión, una

anécdota o de manera formal (con un reporte cuantitativo). Incluso como menciona Creswell, puede no solamente iniciarse, sino estructurarse a manera de cuento, novela, etc.

ESTRUCTURA DEL REPORTE CUALITATIVO

1.- Portada: Comprende el título de la investigación, el nombre del autor o los autores y su afiliación institucional, o el nombre de la organización que patrocina el estudio, así como la fecha y lugar en que se presenta el reporte.

2.- Indice del reporte o tabla de contenidos: Incluye capítulos, apartados y subapartados (numerados o diferenciados por tamaño y características de la tipografía). A veces se elaboran otros índices (de tablas, figuras, diagramas, ilustraciones, etc.).

3.- Resumen: Constituye, de manera breve, el contenido fundamental del reporte de investigación, y en general incluye el planteamiento del problema, el método, los resultados más importantes y las principales conclusiones. En el caso de artículos para revistas científicas, no se recomienda exceder las 150 palabras, salvo que se trate de un estudio excepcional ( y en este caso, no mas de 190). Idealmente entre 100 y 120. En reporte técnicos, se sugiere un mínimo de 200 palabras y un máximo de 350.

Ejemplo de un resumen de un artículo producto de investigación cualitativa

Los constructores de supervivencia y las formas para sobrellevar la situación por mujeres que sobrevivieron al abuso sexual durante su infanciaSusan L. MorrowDepartment of Educational Psychology. University of UtahMary Lee SmithDivision of Educational Leadership and Policy Studies, Arizona State UniversityResumen

Este estudio cualitativo investigo los constructos personales de supervivencia y afrontamiento de la situación crítica por parte de 11 mujeres que padecieron abuso sexual durante su niñez.

Página 20



Se utilizaron como técnicas de recolección de datos: entrevistas en profundidad, un grupo de enfoque de 10 semanas de duración, evidencia documental, seguimiento mediante la verificación de resultados y conclusiones por parte de las mujeres participantes, y análisis cooperativo.

Poco más de 160 estrategias individuales fueron codificadas y analizadas, y se generó un modelo teórico que describe: a) las condiciones causales que subyacen al desarrollo de las estrategias de supervivencia y afrontamiento de la crisis que representa el abuso, b) los fenómenos que surgieron de esas condiciones causales, c) el contexto que influyó en el desarrollo de las estrategias, d) las condiciones intevinientes que afectaron el desarrollo de las estrategias, e) las estrategias actuales de supervivencia y afrontamiento del fenómeno y f) las consecuencias de tales estrategias.

Se identificaron subcategorías de cada componente del modelo teórico y son ilustradas por los datos narrativos. Asimismo, se discuten y valoran las implicaciones para la asesoría psicológica en lo referente a la investigación y práctica personal.

4.- Cuerpo del documento:

Introducción. Incluye los antecedentes (tratados con brevedad), el planteamiento del problema (objetivos y preguntas de investigación, así como la justificación del estudio), el contexto de la investigación ( cómo y dónde se realizó), las categorías, temas y patrones emergentes mas relevantes y los términos de la investigación, al igula que las limitaciones de ésta. Es importante que se comente la utilidad del estudio para el campo profesional. La recomendación de Laflen de hacer las siguientes preguntas para elaborar la introducción: ¿Qué descubrió o probó la investigación?, ¿en qué clase de problema se trabajó, cómo se trabajó y por qué se trabajó de cierta manera?, ¿qué motivo el estudio?,¿por qué se escribe el reporte? Y ¿qué debe saber o entender el lector al terminar de leer el reporte?

Método. Esta parte del reporte describe cómo fue llevada a cabo la investigación, e incluye:a) Contexto, ambiente o escenario de la investigación (lugar o sitio y tiempo, así como accesos y

permisos). Su descripción completa es muy importante.b) Muestra o participantes (tipo, procedencia, edades, género o aquellas características que sean

relevantes en los casos; y procedimiento de selección de la muestra).c) Diseño o Abordaje (teoría fundamentada, estudio narrativo, etc).d) Procedimiento (un resumen de cada paso en el desarrollo de la investigación: inmersión inicial

y total en el campo, estancia en el campo, primeros acercamientos. Descripción detallada de los procesos de recolección de los datos: qué datos fueron recabados, cuándo fueron recogidos y cómo –forma de recolección y/o instrumentos utilizados-; cómo se procedió con los datos una vez obtenidos –codificación, por ejemplo, registros que se elaboraron como notas y bitácoras).

Análisis y Resultados. Unidades de análisis, categorías, temas y patrones: descripciones detalladas, significados para los participantes, experiencias de estos, ejemplos relevantes de cada categoría; experiencias, significados y reflexiones esenciales del investigador, hipótesis y teoría (incluyendo el modelo o modelos emergentes). Debe aclararse cómo fue el proceso de codificación. Willians, Unrau y innell (2005) sugieren el siguiente esquema de organización:

a) Unidades, categorías, temas y patrones (con sus significados), el orden puede estar de acuerdo con la forma como emergieron, por su importancia, por derivación o cualquier otro criterio lógico.

b) Descripciones, significados, anécdotas, experiencias o cualquier otro elemento similar de los participantes.

Página 21



c) Anotaciones y bitácoras (de recolección y análisis)d) Evidencia sobre la confiabilidad o dependencia, credibilidad, transferencia confirmabilidad.

Es importante destacar en este apartado no se incluyen conclusiones ni sugerencias, así como tampoco se explican las implicaciones de la investigación. Esto se desarrolla en el siguiente apartado.

Discusión (conclusiones, recomendaciones e implicaciones). En esta parte se a) derivan conclusiones, b) explicitan recomendaciones para otras investigaciones (por ejemplo sugerir nuevas peguntas, muestras, abordajes) y se indica lo que prosigue y lo que debe de hacerse, c) evalúan las implicaciones de la investigación (teóricas y prácticas), d) establece cómo se respondieron las preguntas de investigación y se cumplieron o no los objetivos, e) relacionan los resultados con los estudios previos, f) comentan las limitaciones de la investigación, g) destaca la importancia y significado de todo el estudio, y h) discuten los resultados inesperados. Al elaborar las conclusiones es aconsejable verificar que estén los puntos necesarios, aquí vertidos. Desde luego, las conclusiones deben ser congruentes con los datos. Si el planteamiento cambió, es necesario explicar por qué y cómo se modificó.

El acotamiento es en relación con el planteamiento del problema y con lo realizado, no abarca el tamaño de la muestra (este no representa una limitación en una investigación cualitativa). Ejemplos de limitaciones serían que algunos participantes abandonaran el estudio; que no se efectuara una sesión grupal que era importante: que se requería evidencia contraria, pero el presupuesto o tiempo se agotó y ya no se pudo regresar al campo para recabar más datos.

Esta parte debe redactarse de tal manera que se facilite la toma de decisiones respeto de una teoría, un curso de acción o una problemática.

Dos ejemplos de conclusiones serían las que se presentan en las páginas siguientes:

De conclusiones

Estrategias de confortación a pacientes traumatizados

Janice M. Morse (1999)

Las estrategias y el estilo de atención de las enfermedades deben ser apropiados al estado de los pacientes. Por ejemplo, si se emplea una estrategia incorrecta en el caso de un paciente atemorizado más que uno aterrorizado, entonces su nivel de fortalecimiento habrá de aumentar. Si el estado del paciente se deteriora, o sino existe mejoría en diez segundo, la estrategia habrá de cambiarse de inmediato.

Una vez que los pacientes hayan obtenido un nivel tolerable de confortación, entonces ellos se sentirán seguros, confiarán en el personal y aceptarán la atención. Por ejemplo, en traumatología los enfermos que están en control o han aceptado la atención responden, son cooperados y receptivos. A pesar de su dolor, tratan de salir adelante. Un paciente que ha mejorado por completo se percata de que el cuidado es necesario y acepta cualquier medida que se requiera. El resultado es la atención se da en forma mas rápida y segura.

5.- Referencias o bibliografía.

Página 22



6.- Apéndices. Resultan útiles para describir con mayor profundidad ciertos materiales, sin distraer la lectura del texto principal del reporte. Algunos ejemplos de apéndices para un estudio cualitativo serían la guía de entrevista o de los grupos de enfoque, un nuevo programa computacional, transcripciones, fotografías, etc.

CONCLUSIONES Y RECOMENDACIONES

Se debe presentar lo que el investigador considera más destacable de su trabajo, como son: comprobación o refutación de la o las hipótesis planteadas, resultados encontrados, conclusiones específicas y generales, aportaciones a la disciplina que estudia, sugerencias para estudios posteriores.

Las conclusiones son generalizaciones de los resultados obtenidos, deben ser breves y exactas y citarse

en orden de importancia y numeradas en forma progresiva, se basan en hechos comprobados de los

resultados y se debe de evitar darlas a conocer en forma de recomendaciones. Las conclusiones se

consideran propiamente como las innovaciones y aportaciones que ofrece a la ciencia o disciplina del

trabajo realizado. Las recomendaciones son sugerencias específicas o concretas que se hacen, en orden

de importancia, basadas en los resultados y discusiones de su trabajo, son el producto de un trabajo de

desarrollo o evaluación.

En general debe de incluir:

Respuesta global al problema enunciado.

Respuestas a sub preguntas planteadas en la introducción, o resultados de las hipótesis que se

formularon.

Objetivos cumplidos y en cuanto.

Conclusiones a las que se ha llegado, renglón por renglón.

Comentarios acerca de c/u de las conclusiones.

Condiciones y/o limitaciones específicas de las conclusiones que se tengan.

Mencionar las limitaciones y problemas encontrados.

Recomendaciones:

Las recomendaciones son los resultados sugeridos después de haber realizado la investigación.

Indicar otros posibles caminos que se vieron en la investigación, pero que no se siguieron. Sugerir

nuevas líneas de investigación.

Indicar que tipo de difusión requieren los resultados. (congresos, revistas, libros, etc..).

REFERNCIA BIBLIOGRÁFICA

Página 23

Hernández y Rodríguez, Sergio. Administración. Pensamiento, Proceso, estrategia y vanguardia (1ª. Edición), McGraw Hill – Interamericana Editores. México: 2002

Villafaña Figueroa, Ricardo. “Una organización de pensadores”. Expansión. (N° 780, Diciembre 08, 1999), pp 209 - 211



La bibliografía presenta tres valores:

El de autoridad: equivale a dar validez a la investigación, sustentándola en diversos autores. El de contenido: el titulo y el subtitulo representan la guía para la inferencia de contenido de la

fuente de información. El de extensión: orienta al investigador y le da un criterio de la amplitud de la información.

Al finalizar un trabajo deben listarse, en orden alfabético o por orden de presentación, la información completa de todas las referencias bibliográficas que aparecen en el marco teórico como fundamento del desarrollo del trabajo.

Los elementos que constituyen una bibliografía son tres: el nombre del autor o autores, el título de la obra consultada y finalmente los datos relativos a la edición. (número de edición, editorial, país, año de publicación y páginas de donde se tomo el artículo)

Ejemplo para un libro:

Apellido, nombre del autor. Título del libro subrayado o letra cursiva (edición) Editorial. País donde se publicó: año de publicación.

Ejemplo para publicaciones periódicas (diarios, revistas, etc.)

Apellido, Nombre del autor. “Título del artículo entre comillas”. Nombre completo de la publicación subrayado. Volumen en número. (Número, año), Número de la página donde empieza el artículo – Número de la página donde termina el artículo.

Página 24

i teoría", es utilizado para describir ciertos fenómenos, frecuentemente indica que un resultado particular ha sido predicho por la teoría pero no ha sido aún observado. Por ejemplo, hasta hace poco, los [agujeros negros] fueron considerados teóricos. Es frecuente en la historia de la física el que una teoría produzca predicciones posteriormente confirmadas mediante nuevos experimentos u observaciones.

Guia Para El Informe Tecnico de Proyectos - Copia

Documents

Transcript of Guia Para El Informe Tecnico de Proyectos - Copia