Documentos Maestros

OpenOffice (OOo) permite crear un documento maestro, que tendrá extensión “odm” (ni “odt”, ni “ott”), para modularizar un documento, de modo que puedes hacer que determinados apartados del documento maestro sean documentos de OOo que llamaremos Documentos Hijos (pero son normales, con extensión “odt”, ya estén creados a partir de una plantilla “ott” o no). En documentos grandes, con muchos apartados, ésto facilita el mantenimiento del documento (pues determinados apartados pasan a ser documentos), así como el versionado.

En MEDEA se usa esta funcionalidad de OOo, por ejemplo, para el Documento de Requisitos, de modo que en el mismo Documento de Requisitos se pueden incluir:

• Casos de Uso.
• Historias.
• Requisitos NO funcionales.

Cada “Caso de Uso/Historia/Requisito NO Funcional” (q podrían ser cientos) va a ser un documento “odt” de OOo, creado a partir de la correspondiente plantilla “ott”; de modo que iremos insertando estos “documentos hijos” en el “documento maestro”, haciendo uso del Navegador de OOo (sale pulsando F5).

En MEDEA tenemos:

• un ejemplo genérico de Documento Maestro
• con dos Documentos Hijos (uno y dos),
• así como un modelo genérico de Documento Maestro (a partir del cual se ha generado el ejemplo),
• y una plantilla para crear cualquier Documento Hijo (a partir de la cual se han generado los 2 documentos hijos del ejemplo).
• Además del modelo genérico, MEDEA proporciona modelos concretos basados en Documento Maestro, para generar algunos artefactos en algunas disciplinas:
  • (como puede ser el caso del modelo de Documento de Requisitos
  • y la plantilla de Caso de Uso).

En el caso de MEDEA, todos los Documentos Maestros terminan con apartados con el estilo “Encabezado 3”, y cualquier Documento Hijo empieza con el estilo “Encabezado 4”. Estos 2 estilos (“Encabezado 3” y “Encabezado 4”) son los que usan para generar el Indice del Documento Maestro.

La forma general de trabajar con Documentos Maestros será la siguiente:

1. Crear el Documento Maestro a partir del correspondiente modelo que proporciona MEDEA: guardando el citado modelo (con extensión “odm”) con el nombre que le vayamos a dar, según las correspondientes instrucciones de nombrado de MEDEA para ese tipo concreto de documento.
2. Editamos el Documento Maestro, rellenándolo con los datos de nuestro Proyecto y demás información, según el documento en cuestión; y borraremos aquellas secciones del Documento Maestro que no vayamos a usar; por ejemplo, si se trata de un Documento de Requisitos y sólo vamos a tener Casos de Uso, borraremos los apartados con estilo “Encabezado 3”, correspondientes a “Historias” y “Requisitos NO Funcionales”.
3. Para insertar los Documentos Hijos en el Documento Maestro, primero hay q desplazar su “Encabezado 3”, si es que ya no está al final del documento (por ejemplo “2. Casos de Uso”) a la última posición del documento (usando el Navegador de OOo), e insertar los documentos hijos (usando el mismo Navegador), y luego mover de nuevo a su posición original el “Encabezado 3” que habíamos movido al final del documento (y debajo del cual han quedado insertados los documentos hijos, que se moverán con él).

NOTA: Lo documentos hijos no dejan insertar texto debajo de ellos. SOLO se puede insertar texto por encima y en caso de que no HAYA texto ya. Por lo tanto si tenemos un documento de la forma Texto → Documento Hijo y queremos seguir insertando texto. Habria que mover el Documento Hijo a la primera posicion e insertar ahi texto.