Вы находитесь на странице: 1из 70

Manual de Usuario de Enterprise Architect

Mapfre
22/11/2004

VERSIN 3.60.641
EDICIN CORPORATE
El presente documento es propiedad de MAPFRE y es exclusivamente para uso
interno o de cualquiera de las Entidades del Sistema MAPFRE. Queda prohibida
la reproduccin total o parcial, distribucin, comunicacin pblica y transformacin,
que no podrn ser realizadas sin su autorizacin previa y por escrito.

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Control de Cambios
ndice de Figuras
Figura 1 : Apertura de Enterprise Architect...................................................................2
Figura 2 : Nuevo Proyecto............................................................................................... 2
Figura 3 : Mens............................................................................................................... 3
Figura 4 : Barra de Objetos............................................................................................. 3
Figura 5 : Zona de Diagramas......................................................................................... 4
Figura 6 : Navegador........................................................................................................ 4
Figura 7 : Menu emergente para un Diagrama, para un Elemento y para un Proyecto
5
Figura 8: Pantalla de creacin de un nuevo diagrama.................................................7
Figura 9: Propiedades de un elemento..........................................................................8
Figura 10: Acceso al comportamiento de Enterprise Architect: Auto Instance.........9
Figura 11: Propiedades del diagrama. Highlight Foreingn Object............................10
Figura 12: Propiedades de un mensaje.......................................................................11
Figura 13: Propiedades de un mensaje.......................................................................11
Figura 14: Copiar diagramas......................................................................................... 12
Figura 15: Ocultar Relaciones.......................................................................................13
Figura 16: Visualizar Ocultar Relaciones.....................................................................13
Figura 17: Acceso a las propiedades del Diagrama....................................................14
Figura 18: Propiedades del Diagrama..........................................................................14
Figura 19: Men Configuration......................................................................................15
Figura 20: Mensaje Diagrama Colaboracin................................................................16
Figura 21: Diagrama de Actividad de las Pruebas realizadas en Desarrollo Web
utilizando calles.............................................................................................................. 17
Figura 22:Opcin de creacin de Swinlanes...............................................................17
Figura 23: Opciones de configuracin de las calles (swimlanes)..............................18
Figura 24: Seleccin opcin Exportar.........................................................................19
Figura 25: Exportar hacia un fichero XML....................................................................19
Figura 26: Opciones de Export para una Lgica de Negocio....................................20
Figura 27: Seleccin opcin import from XML............................................................21
Figura 28: Ventana import package from XML............................................................21
Figura 29: Matriz de elementos.....................................................................................22
Figura 30: Configuracin de la Matriz de Elementos..................................................23
Figura 31: Seleccin de Origen o Destino de la Matriz...............................................23
Figura 32: Ejemplo de matriz de elementos.................................................................24
Figura 33 : Mensaje de Seguridad Habilitada..............................................................27
Figura 34: Men de Seguridad......................................................................................28
Figura 35: Bloqueo de un Diagrama Artefacto del diagrama..................................29
Figura 36: Desbloqueo de un Diagrama Artefacto del diagrama............................29
Figura 37: Bloqueo/Desbloqueo desde el browser.....................................................30

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 ndice
Figura 38: Bloqueo/Desbloqueo de un paquete y de los subpaquetes incluidos en
l. 30
Figura 39 : Dialogo de Mantener Grupos y Permisos.................................................31
Figura 40 : Dialogo de Mantener Usuarios...................................................................34
Figura 41: Asignacin de grupo a un usuario.............................................................34
Figura 42: Resumen de la preparacin del Repositorio..............................................35
Figura 43: Pantalla Gestin de Bloqueos.....................................................................36
Figura 44: Resumen del proceso de crear un backup................................................38
Figura 45: Botn de Refrescar Proyecto........................................................41
Figura 46: Resumen del uso de bloqueos....................................................................43
Figura 47: Men View..................................................................................................... 44
Figura 48. Opciones para personalizar la Barra de Herramientas.............................45
Figura 49: Opciones "Default Tools"............................................................................46
Figura 50: Opciones "Project Bar"................................................................................46
Figura 51: Opciones "Code Generation"......................................................................46
Figura 52: Opciones "UML Elements"..........................................................................47
Figura 53: Opciones "Diagram Bar".............................................................................47
Figura 54:Opciones: "Current Object".........................................................................47
Figura 55: Navegador..................................................................................................... 48
Figura 56: Propiedades de los elementos....................................................................48
Figura 57: Pruebas de Sistema.....................................................................................49
Figura 58: Casos de Prueba.......................................................................................... 49
Figura 59: Identificacin de defectos y cambios.........................................................49
Figura 60: Opciones de apariencia...............................................................................50
Figura 61: Barra de estado............................................................................................ 50
Figura 62: Opciones de EA............................................................................................ 51
Figura 63: Excluir paquetes para la documentacin...................................................54
Figura 64: Opciones de documentacin RTF..............................................................54
Figura 65: Opciones de documentacin .....................................................................56
Figura 66: Opciones de lenguaje..................................................................................57
Figura 67: Vista de Recursos........................................................................................ 58
Figura 68: Men desplegable con opciones de documentacin................................59
Figura 69: Publicacin en HTML...................................................................................62
Figura 70: Opciones generacin HTML........................................................................63

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 ndice
ndice de Tablas
Tabla 1: Relacin modelos - tipos de diagrama...........................................................26
Tabla 2: Permisos y perfiles para un grupo de trabajo...............................................32
Tabla 3: Tabla de exportacin.......................................................................................37

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 ndice
ndice
Manual de Usuario de Enterprise Architect...................................................................1
1 Introduccin............................................................................................................................. 1
2 Inicio........................................................................................................................................ 2
3 Entorno.................................................................................................................................... 5
Navegador................................................................................................................................. 5
Mover elementos..................................................................................................................... 5
Cambiar elementos de orden..................................................................................................6
Enlace a ficheros externos desde el esqueleto EA.................................................................6
Trabajo con los Diagramas........................................................................................................7
Crear Diagramas..................................................................................................................... 7
Borrar un diagrama.................................................................................................................. 7
Crear artefactos....................................................................................................................... 8
Borrar un artefacto................................................................................................................... 8
Localizar un artefacto, mostrar su uso y donde es referenciado...........................................8
Aadir atributos y operaciones a artefactos............................................................................9
Arrastrar desde el Navegador..................................................................................................9
Guas de estilo....................................................................................................................... 10
Tratamiento de los Diagramas de Secuencia........................................................................10
Copiar diagramas ................................................................................................................ 12
Ocultar/Visualizar relaciones en los diagramas .................................................................13
Ocultar elementos en un diagrama........................................................................................14
Extender caractersticas de Enterpise Architect .................................................................15
Diagramas de colaboracin...................................................................................................16
Creacin de calles (Swinlanes) en los diagramas de Actividad............................................16
Import/Export de ficheros XMI (XML) .....................................................................................18
Export .........................................................................................................18
Import 20
Matrices de Elementos............................................................................................................22
4 Tipos de diagrama a utilizar ..............................................................................................25
5 Polticas de Seguridad...........................................................................................................27
Preparacin de un nuevo repositorio ......................................................................................27
Habilitar las funciones de seguridad ...................................................................................27
Forma de Trabajar con los bloqueos.....................................................................................28
Crear Grupos ....................................................................................................................... 31
Crear Usuarios....................................................................................................................... 32
Resumen del procedimiento de creacin de un repositorio nuevo........................................35
Procedimientos de Gestin ....................................................................................................36
Ver/Gestionar bloqueos del equipo.......................................................................................36
Backup para el sistema de control de versiones...................................................................37
Resumen del procedimiento de backup para versionado......................................................38
6 Seguridad y Trabajo en Grupo.............................................................................................39
Mecanismos de Seguridad......................................................................................................39
EA y las exigencias del trabajo en equipo.............................................................................39
Procedimientos de trabajo en Grupo ....................................................................................40
Refrescar el Proyecto a menudo...........................................................................................40
Empezar a trabajar con un artefacto / diagrama...................................................................41
Terminar de usar un artefacto / diagrama.............................................................................41
Ver/Gestionar locks personales.............................................................................................41
Resumen del procedimiento de bloqueo y desbloqueo.........................................................43
7 Anexo A. Men View ..........................................................................................................44
Vistas 44
Opciones.................................................................................................................................. 51
8 Anexo B. Generacin de Documentacin en EA...................................................................53
Introduccin ............................................................................................................................ 53
Generacin de Documentacin en RTF..................................................................................53
Generacin de una plantilla de documentacin......................................................................53
Plantillas almacenadas............................................................................................................58
Generar la documentacin a partir de una plantilla.................................................................58
Numeracin de las pginas en RTF......................................................................................61
Publicacin en HTML...............................................................................................................62
Anexo C. Versionado de un fichero eap..................................................................................64

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 ndice
1 Introduccin
En este documento se registran los aspectos de gestin y uso de la herramienta
Enterprise Architect (EA). La correcta utilizacin de esta herramienta sirve de ayuda en el
proceso de desarrollo y en el mantenimiento de las aplicaciones que siguen el Modelo
Web.
El documento se ir ampliando a medida que se vaya potenciado el uso de la
herramienta. Cada ampliacin constituir una nueva versin del mismo que se publicar
en Documentum.
Esta gua no pretende sustituir a la ayuda suministrada con el producto ni ser una
traduccin al espaol de la misma (la ayuda de Enterprise Architect est en ingls).
Simplemente sirve para dirigir los primeros pasos con la herramienta y para comentar los
aspectos ms relevantes.
Este documento est actualizado y recoge los cambios de la nueva versin 3.6 build 641
de Enterprise Architect edicin Corporate.

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 1
2 Inicio
La creacin de un proyecto en Enterprise Architect permite basarlo en otro ya existente.
En Mapfre Mutualidad se utiliza Esqueleto-Mapfre.eap que est publicado en
Documentum y que sirve como base de todos los proyectos de nueva creacin.
Esto permite tener definidos una serie elementos que coinciden con las necesidades de
la metodologa y de la arquitectura propuestas por Mapfre.
Al arrancar EA, para crear un proyecto, se debe pulsar la opcin New:

Figura 1 : Apertura de Enterprise Architect

A continuacin se introduce el nombre del directorio del proyecto 1 junto con el nombre
del proyecto en el campo New Project y el nombre del fichero .eap en el que se debe
basar el nuevo proyecto en el campo Model Project:

Figura 2 : Nuevo Proyecto

Una vez creado el proyecto, EA presentar la misma pantalla que se muestra en la


Figura 1 y se proceder a cargar el proyecto creado pulsando Open.

1
El directorio del proyecto nuevo tiene que estar creado en el sistema de directorios. Si no es as, dar un error

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 2
La ventana de Enterprise Architect se divide en varias zonas. Las ms significativas son:
Los mens con las opciones para manipular EA

Figura 3 : Mens

Los elementos que se pueden crear, agrupados por tipos de diagramas (Object Toolbar)

Figura 4 : Barra de Objetos

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 3
La zona de dibujo donde se muestra la representacin grfica de los diagramas

Figura 5 : Zona de Diagramas

El Navegador que constituye el repositorio de la informacin

Figura 6 : Navegador

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 4
3 Entorno

Navegador
El Navegador es el repositorio de informacin de Enterprise Architect. Todos los
elementos creados en el proyecto se almacenan en el Navegador en forma de rbol
(figura 6 de la anterior pgina).
La estructura del proyecto ser la misma que la del esqueleto propuesto: la informacin
se agrupa en niveles, los niveles ms altos son las vistas (Views) y cada vista se
corresponde con una fase del proyecto propuesta por la Metodologa de Desarrollo de
Aplicaciones Web en Mapfre. Las vistas contienen packages (paquetes o carpetas) y/o
diagramas y a su vez, los packages contienen diagramas y/o elementos (artefactos de
UML). Los diagramas podrn visualizar cualquier elemento del repositorio.
Cualquier elemento del Navegador tiene asociadas una serie de propiedades que lo
caracterizan y una serie de opciones que representan las funciones que se pueden
realizar. Para acceder a esas opciones, se selecciona el elemento y al pulsar el botn
inverso del ratn, se muestra un men emergente con las opciones disponibles.
Dependiendo del tipo de elemento seleccionado ( elemento simple, diagrama, proyecto)
aparecen unas opciones u otras.

Figura 7 : Menu emergente para un Diagrama, para un Elemento y para un Proyecto

Con estas opciones se pueden crear elementos, crear diagramas, crear proyectos,
renombrar elementos, crear documentacin y borrar elementos.

Mover elementos
Para mover elementos, diagramas o packages desde un lugar a otro, dentro del rbol, se
debe hacer lo siguiente:

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 5
1. Seleccionar el elemento con el del ratn
2. Arrastrarlo hasta situarse en el destino
NOTA: Las vistas no se pueden desplazar dentro del rbol.

Cambiar elementos de orden


Los elementos en el Navegador se pueden cambiar de orden:
- Para subir un elemento dentro del rbol del Navegador se debe pulsar <ALT> U o
seleccionar la opcin Move Up del men emergente.
- Para bajar un elemento dentro del rbol del Navegador se debe pulsar <ALT> o
seleccionar la opcin Move Down del men emergente.

Enlace a ficheros externos desde el esqueleto EA


En Ea se pueden enlazar ficheros externos (word, excel etc..) a los elementos carpetas
del navegador (excepto a los diagramas). Con el botn dcho del ratn entramos en las
Propiedades de ese elemento y dento de estas abrimos la carpeta File . Aqu se puede
indicar el path del fichero que queremos enlazar.

Figura : Carpeta Files de propiedades, nos permite enlazar un fichero externo.

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 6
Trabajo con los Diagramas

Crear Diagramas
Los diagramas se crean a partir de la opcin New Diagram del men emergente de uno
de estos artefactos: vista, package, diagrama o elemento. Aunque desde algunos
elementos no haya acceso a la creacin de todos los diagramas 2, siempre se presenta la
misma pantalla para crearlos, donde se asigna un nombre y se elige su tipo:

Figura 8: Pantalla de creacin de un nuevo diagrama

El tipo de diagrama Custom no es un diagrama estndar de UML. En la Metodologa de


Desarrollo de Aplicaciones Web de Mapfre se propone el uso de estos diagramas para la
Definicin de Requisitos y para la Definicin de la Interfaz de Usuario, aunque esta ltima
es opcional realizarla con EA. Tambin se usa para mostrar la trazabilidad entre los
Requisitos y los Casos de Usoy la trazabilidad entre el Anlisis y el Diseo.

Borrar un diagrama
Para borrar un diagrama hay que dar los siguientes pasos:
1. Seleccionar en el Navegador el diagrama
2. Pulsar <control>+<supr.>
o bien
1. Seleccionar el diagrama
2. Acceder con el botn inverso del ratn al men emergente y seleccionar la opcin
Delete Nombre Diagrama.
Los elementos que estaban contenidos en el diagrama permanecen en el repositorio y,
por tanto, se siguen mostrando en el Navegador.

2
Por ejemplo en las clases y en los Casos de Uso, el men emergente para crear un diagrama no muestra todos los
posibles diagramas.

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 7
Crear artefactos
La lista de artefactos que estn disponibles para cada diagrama se presenta en la UML
Toolbox. Aunque EA lo permita, no todos los artefactos ni todas las relaciones son
propios de un determinado diagrama. El standard UML es quien dicta los elementos
posibles para cada diagrama. Las relaciones estn disponibles tambin en la UML
Toolbox.

Para incluir un icono que represente a un artefacto en un diagrama se debe hacer lo


siguiente:
1. Seleccionar el elemento (artefacto) con el ratn
2. Arrastrar el elemento desde el Navegador hasta el diagrama
3. Rellenar las propiedades del elemento en la ventana que aparece automticamente

Figura 9: Propiedades de un elemento

NOTA IMPORTANTE. En ocasiones dos elementos del mismo tipo quedan situados uno
encima de otro, dando la impresin de que slo existe uno. Para independizarlos, basta
pinchar encima y arrastrar hasta otra zona del diagrama. Los elementos que se van
generando en el diagrama, se muestran en el Navegador.

Borrar un artefacto
Si un elemento se borra del diagrama, este permanece en el Navegador y por tanto,
sigue existiendo en el proyecto para poder ser utilizado. Para borrar el elemento de
forma definitiva, hay que seleccionarlo y borrarlo en el Navegador de forma similar al
borrado de un diagrama anteriormente expuesto.

Localizar un artefacto, mostrar su uso y donde es referenciado


Para realizar estas operaciones se deber seleccionar un artefacto concreto de un
diagrama, y despus entrar dentro del men Element, aqu se encontrarn las
opciones siguientes: Show Usage muestra para un elemento seleccionado (una clase
por ejemplo) en que diagramas es utilizado, Locate in Browser localiza en el rbol de
navegacin (Project view) el elemento seleccionado y Show other References muestra
donde ese elemento es referenciado, por ejemplo si se pasa como parmetro en un
mtodo.

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 8
Aadir atributos y operaciones a artefactos
A algunos artefactos se les podrn aadir atributos y operaciones (por ejemplo a una
clase, un objeto, un actor etc..). Si el artefacto est en un diagrama, seleccionado el
artefacto con el botn derecho se visualizarn en el desplegable que aparece, las
opciones Attributes y Operations. Para aadir atributos se elige la opcin Attributes y
aparecer la ventana de gestin de atributos donde podremos crear, modificar y borrar
estos. Para aadir operaciones se elige la opcin Operations y aparecer la ventana de
gestin de operaciones.
Las opciones anteriores tambin se pueden hacer desde el browser, seleccionado el
artefacto y accediendo a la opcin Element del men principal. En cualquier caso cuando
se selecciona un artefacto, con la tecla rpida F9 tambin aparecer la ventana de
gestin de atributos, y pulsando F10 obtendremos la de operaciones.

Arrastrar desde el Navegador


Aquellos elementos que convenga tener agrupados porque se vayan a usar en distintos
puntos del proyecto, se crearn en el Navegador colgando de un package y para
asociarlos a un diagrama, se arrastrarn desde el Navegador hasta el diagrama.
Cuando se arrastra un elemento desde el Navegador hasta el diagrama se puede operar
de dos formas diferentes:
1. Si no se pulsa <Crtl> antes de soltar el elemento en el diagrama, ste representar
al artefacto. Ejemplo: una clase.
2. Si se pulsa <Crtl> antes de soltar el elemento en el diagrama, se crear una
instancia del elemento tomado del Navegador. Ejemplo: un objeto.
Los ejemplos anteriores son especialmente interesantes de cara a los diagramas de
secuencia. Se selecciona una clase de anlisis del sitio donde estn agrupadas y se
incluye en los diagramas como instancias de la misma (ms pequeas y su nombre con
el signo : por delante).
Para que el funcionamiento sea como aqu se explica, la opcin Auto Instance de la
ventana Diagram Behaviour tiene que estar desmarcada. Para acceder a esa ventana
hay que entrar a la siguiente opcin de men: Tools/Options y seleccionar en el rbol de
la izquierda Diagram y a continuacin Behaviour:

Figura 10: Acceso al comportamiento de Enterprise Architect: Auto Instance

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 9
Si la opcin Auto Instance est marcada, el funcionamiento de la tecla Control es a la
inversa de lo explicado en el prrafo anterior.
Cuando un elemento se arrastra desde el Navegador hasta un diagrama y se deja como
tal (no como una instancia del mismo), por defecto, aparece en el diagrama acompaado
de una etiqueta en la que pone from nombre del elemento padre en el navegador
(Este elemento normalmente es un package). Si se quiere eliminar esa referencia en el
diagrama utilizado, hay que acceder a las propiedades del diagrama (pulsando doble
click en el diagrama o botn inverso) y desmarcar la opcin Highlight Foreing Objects:

Figura 11: Propiedades del diagrama. Highlight Foreingn Object

Guas de estilo
Los diagramas se enmarcan dentro de un recuadro para poderlos documentar mejor en
papel. Para ello se utiliza el recuadro rojo de la barra de herramientas cuyo tooltip es
boundary. Para poder ver las propiedades del diagrama hay que hacer doble click fuera
del recuadro.
Desde los diagramas tambin se puede acceder a los mens emergentes de cada uno
de los elementos utilizando el procedimiento habitual: seleccionar el elemento y pulsar el
botn inverso del ratn.

Tratamiento de los Diagramas de Secuencia


La creacin de los mensajes en los diagramas de secuencia es menos inmediata que la
del resto de los elementos que se crean en un diagrama. Los pasos a realizar son los
siguientes:
1. Elegir el icono correspondiente a Message en la barra del diagrama de secuencia.
2. Arrastrar desde un actor hasta un objeto previamente incluidos en el diagrama o
desde un objeto a otro.

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 10
3. En la ventana que aparece, Message Properties, pulsar el botn New que hay junto
al combo-box correspondiente al Mensaje. Tener en cuenta que la casilla Show
Inherited Methods aparece por defecto como marcada, esto significa que en la lista
de mensajes a elegir se van a tener tambin los mensajes de aquellas clases de las
cuales herede la clase actual a la que pertenece el objeto que hemos creado. Las
asociaciones de realizacin entre clases tambin se consideran como un tipo de
herencia . Como recomendacin y para evitar confusiones se recomienda desmarcar
esta opcin.

Figura 12: Propiedades de un mensaje

4. En la nueva ventana, ventana de propiedades de la clase a la que pertenece el


objeto al que llega el mensaje, hay que teclear, en el campo Name, el nombre del
mensaje y pulsar el botn Save. Este nombre aparecer en la lista que hay en la
zona inferior de la pantalla como operacin asociada a la clase tratada.

Figura 13: Propiedades de un mensaje

5. Una vez que la operacin est en la lista como consecuencia de haber pulsado
Save, se pulsa OK y aparece automticamente la ventana anterior, la de propiedades
del mensaje.
6. En la ventana de propiedades del mensaje se debe pinchar en el combo box
perteneciente al mensaje y elegir aqul que se acaba de crear.

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 11
Copiar diagramas
Se puede copiar el contenido de cualquier diagrama, con independencia de su tipo y
pegarlo en otro diagrama. Puede ser especialmente til en el caso de los diagramas de
secuencia. Los pasos a realizar son:
1. Seleccionar el diagrama a copiar desde el Navegador y con el botn inverso del
ratn, elegir la opcin Copy Diagram to Clipboard.
2. Seleccionar el package donde se quiere copiar el diagrama y con el botn inverso
del ratn elegir la opcin Paste Diagram.
3. En el cuadro de dilogo de la figura siguiente, seleccionar la opcin Deep si se
quieren crear nuevos objetos o la opcin Shallow si no se desea crear los objetos.

Figura 14: Copiar diagramas

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 12
Ocultar/Visualizar relaciones en los diagramas
EA permite ocultar relaciones entre los elementos de un diagrama sin que afecte a las
relaciones que se muestran en otros diagramas. Esta posibilidad puede resultar til
cuando entre los elementos que se van a utilizar en un diagrama existen relaciones que
no se quieren representar. Esto se da, a veces, en los diagramas de clases. Para ocultar
las relaciones entre elementos en un diagrama se deben dar los siguientes pasos:
1. Seleccionar en la zona de dibujo la relacin entre dos elementos del diagrama que
se desea ocultar.
2. Con el botn inverso del ratn elegir la opcin Hide Connector del men emergente.

Figura 15: Ocultar Relaciones

Hay otra posibilidad que vale tanto para ocultar relaciones como para visualizarlas:
1. Seleccionar en el men principal la opcin Diagram.
2. Seleccionar del men emergente que aparece la opcin Set Visible Relations.
3. Marcar o Desmarcar las relaciones que se desean visualizar.

Figura 16: Visualizar Ocultar Relaciones

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 13
Ocultar elementos en un diagrama
EA permite ocultar elementos concretos de un artefacto perteneciente a un diagrama,
para ello se tiene que hacer lo siguiente:
1. Situarse en el diagrama sobre el que estamos trabajando (asegurarse de que no
estamos sobre la boundary la cual encuadra a los artefactos del diagrama).
2. Con el botn inverso del ratn elegir la opcin Diagram Properties del men
emergente.

Figura 17: Acceso a las propiedades del Diagrama

3. Hacer check sobre la propiedad del diagrama que se quiere activar dentro de la
seccin de Appearance options, por ejemplo, en la figura siguiente se hace check
sobre la opcin Hide Operations que oculta las operaciones mtodos de todos
los artefactos del diagrama (ya sean una clase, una entidad etc..).

Figura 18: Propiedades del Diagrama

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 14
Extender caractersticas de Enterpise Architect
Si para un proyecto se quieren crear nuevas caractersticas que se puedan asociar a
todos lo elementos del proyecto tales como estereotipos, nuevas cardinalidades o
nuevos tipos de requisitos se debe hacer as:
Men Configuration
- Opcin General Types: aqu puedo crear nuevos requerimientos, restricciones
etc..
- Opcin UML: dentro de esta opcin puedo crear estereotipos, valores
etiquetados, nuevas cardinalidades etc..

Si en vez de aadir la informacin de esta manera, se hiciera para un elemento concreto,


no quedara almacenado para que otros elementos lo pudieran seleccionar.
Figura 19: Men Configuration

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 15
Diagramas de colaboracin
Los diagramas de colaboracin, complementarios de los de secuencia en UML, se
construyen con los diagramas de tipo Collaboration.
Para representar una relacin entre los objetos en forma de mensaje, ya que esta no se
puede hacer de forma directa, se tienen que seguir los siguientes pasos:
1. Dibujar una asociacin entre los dos objetos a relacionar.
2. Seleccionar la asociacin, con el botn inverso del ratn y en el men emergente
elegir Add Mensaje from to

Figura 20: Mensaje Diagrama Colaboracin

3. Aparece el cuadro de dialogo para crear el mensaje.


4. Seguir los mismos pasos que para crear un mensaje en el diagrama de secuencia.

Creacin de calles (Swinlanes) en los diagramas de Actividad


A menudo es til organizar las actividades en un modelo segn su responsabilidad, por
ejemplo, agrupando juntas todas las actividades manejadas por una organizacin del
negocio. Esta clase de asignacin puede mostrarse organizando las actividades en
regiones distintas separadas por lneas en el diagrama. Debido a su aspecto, cada
regin se llama calle (swinlanes).
Un ejemplo de utilizacin de calles se puede observar en el siguiente diagrama de
actividad en el cual se ve como las actividades asociadas a la disciplina de pruebas son
situadas en una calle u otra dependiendo de la fase a la que pertenezcan:

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 16
Figura 21: Diagrama de Actividad de las Pruebas realizadas en Desarrollo Web utilizando calles

Para crear calles en un diagrama de actividad se elegir la opcin Configure Swimlanes


dentro del men Diagram:

Figura 22:Opcin de creacin de Swinlanes.

Una vez elegida esta opcin aparecer la siguiente ventana donde se podrn configurar
las distintas calles que se quieran utilizar, su nombre, tamao, color etc..

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 17
Figura 23: Opciones de configuracin de las calles (swimlanes)

Import/Export de ficheros XMI (XML)


Enterprise Architect permite el intercambio de informacin procedente de distintos
modelos (EA, Rose, Together) a travs de ficheros XMI (basado en XML). Esto ofrece la
posibilidad de que elementos en EA puedan ser movidos entre distintos modelos (poder
importar exportar un paquete de un modelo hacia otro). Tambin nos permite limitar la
exportacin de elementos entre modelos EA y los de otras herramientas como Rational
Rose, Together etc..
Dentro de EA se pueden hacer export/import de un modelo a nivel de Vista (View) de
paquete (Package).
A continuacin se muestra la forma de realizar estas dos operaciones:

Export
1. Primeramente se selecciona la vista o paquete a exportar, despus se accede al
men contextual con el botn alternativo del ratn y se elige la opcin Import/Export,
y pulsamos Export package to XML file. Tambin es posible acceder mediante
ProyectImport/ExportExport package to XML file

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 18
Figura 24: Seleccin opcin Exportar

2. Una vez seleccionada la opcin anterior aparece la siguiente ventana en la que se


dar un nombre y una ruta al fichero XML de salida.

Figura 25: Exportar hacia un fichero XML

A continuacin se explican para que sirven las distintas opciones de la ventana


anterior:

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 19
Export Diagrams -> chequeado por defecto, permite incluir en el fichero XML a
generar todos los diagramas que contiene la carpeta vista selecionada para la
exportacin.
Format XML Output -> chequeado por defecto, indica que el formato de salida del
fichero generado es XML.
Unisys/Rose Format -> si se chequea est opcin se indica que el formato de salida
del fichero generado es Rose UML 1.3, XMI 1.1 format.
Generate Diagram Images -> chequeando esta opcin se activar el combo de la
derecha en el cual se elegir el formato de imagen deseado , por ejemplo eligiendo el
formato GIF se posibilita la publicacin de las imgenes de los diagramas de los
modelos automticamente en un fichero .gif independiente del XML. Por defecto
cuando se realicen export de Lgicas de Negocio para que puedan ser publicarlas en
Documentum se utilizarn las opciones comentadas en este punto:

Figura 26: Opciones de Export para una Lgica de Negocio

Use DTD -> chequeando esta opcin se indica que se usar la DTD para UML 1.3 .
Write Log file ->chequeando esta opcin se indica que escribiremos en un fichero de
Log las actividades del resultado de la exportacin, este fichero ser creado en el
mismo directorio donde se haya hecho la exportacin.
XMI 1.0 -> chequeando esta opcin se indica que el formato de salida del fichero
generado es XMI 1.0 format.

3. Una vez elegidas las opciones deseadas se pulsa el botn Export,se exporta el
paquete vista elegido a XML en el path que se le haya indicado . Cuando el
proceso finaliza en la misma ventana aparece el mensaje XMI Document Export
Complete y se pulsar el botn Close para salir de esta.

Import
A continuacin se detallan los pasos para realizar la importacin de ficheros desde XMI
(basado en XML):

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 20
1. Primeramente se seleccionar el paquete vista bajo el cual se quiere importar,
despus se accede al men contextual con el botn alternativo del ratn y se elige la
opcin Import/Export , despus Import package from XML file. Tambin es posible
acceder mediante ProyectImport/ExportImport package from XML file

Figura 27: Seleccin opcin import from XML

2. La accin anterior har que aparezca la ventana de importacin siguiente donde se


indicar la ruta del directorio donde se encuentra el fichero xml a importar.

Figura 28: Ventana import package from XML

A continuacin se explican para que sirven las distintas opciones de esta ventana:

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 21
Import Diagrams -> chequeado por defecto, permite incluir en la carpeta que se crear
en la importacin todos los diagramas que contiene el XML.
Strip GUIDS -> chequeando esta opcin podemos importar el mismo paquete varias
veces un un mismo modelo, esta opcin lo que hace es asignar un nuevo id
(identificador dentro del modelo eap) al paquete para que no se repita ya que en el caso
de darse esta situacin no se podra importar el paquete al modelo.
Write Log file -> chequeando esta opcin se indica que escribiremos en un fichero de
Log las actividades del resultado de la importacin, este fichero ser creado en el
mismo directorio desde donde se haya hecho la importacin.

3. Una vez elegidas las opciones deseadas se pulsa el botn Import, esta accin
importa el contenido del XML en la carpeta de Enterprie Architect que hayamos
seleccionado . Cuando el proceso finaliza en la misma ventana aparece el mensaje
Import Complete! y se pulsar el botn Close para salir de esta.

Matrices de Elementos
Existe una matriz en la que se muestran las relaciones que existen entre 2 grupos de
elementos. Estos dos grupos pueden ser del mismo tipo o de tipo diferente. Para que la
matriz quede cumplimentada correctamente tras la seleccin que se realiza, al crear la
relacin entre los elementos, dicha relacin se debe estereotipar correctamente.
Para acceder a esta funcionalidad hay que realizar los siguientes pasos:
1. Acceder al Men View y
2. Seleccionar la opcin Relationship Matrix:

Figura 29: Matriz de elementos

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 22
En la ventana que aparece se muestran las opciones que podemos configurar para
conformar una matriz de elementos.

Figura 30: Configuracin de la Matriz de Elementos

Para rellenar los campos Source y Target es necesario pulsar los botones que contienen
los puntos suspensivos.
Aparecer una ventana donde se podr seleccionar en un rbol que es como el del
Navegador pero ms limitado (no tiene diagramas ni elementos), una vista o un package:

Figura 31: Seleccin de Origen o Destino de la Matriz

Los campos Type estn asociados a Source y a Target respectivamente. Permiten


escoger de una lista posibles tipos de elementos.

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 23
Para que en la matriz aparezca informacin se debe tener en cuenta lo siguiente:
- Que haya elementos del tipo seleccionado que sean descendientes de la vista o del
package elegidos en Source o en Target.
- Que exista relacin entre los elementos resultantes de las selecciones anteriores.

Figura 32: Ejemplo de matriz de elementos

La funcin de esta matriz no slo es la de visualizacin de las relaciones del modelo sino
tambin la de actualizacin. En la matriz se pueden crear nuevas relaciones entre los
elementos fuente y destino, teniendo en cuenta que en todos los diagramas en que
intervengan el origen y el destino tratados, aparecer la relacin creada.
Para crear una nueva relacin hay que realizar los siguientes pasos:
1. hacer click en la casilla donde confluyen los elementos origen y destino
2. pulsar el botn inverso del ratn
3. seleccionar la opcin Create New RelationShip

La seleccin realizada en esta ventana se puede almacenar para su posterior utilizacin


sin necesidad de volver a hacer una seleccin en cada uno de los campos. Para utilizar
una de estas plantillas, guardada con anterioridad, se despliega el campo Profiles y para
crear una plantilla nueva se accede al men Profiles y se selecciona la opcin Save as
New Profile.

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 24
4 Tipos de diagrama a utilizar
Diagrama rbol Navegador Tipo diagrama
Modelo de Dominio Definicin de Logical Diagram (Class)
Proyecto/Requisitos/Modelo de
Dominio.
Requisitos Definicin de Custom Diagram
Funcionales Proyecto/Requisitos/Requisitos
Funcionales
Requisitos No Definicin de Custom Diagram
Funcionales Proyecto/Requisitos/Requisitos
No Funcionales
DCU Principal y Definicin de Use Case Diagram
Resto de diagramas Proyecto/Requisitos/Modelo de
de Casos de Uso Casos de Usoy subpackages
Trazabilidad Definicin de Custom Digram
CU/Requisito Proyecto/Requisitos/Trazabilidad
CU-Requisitos
DEST_NombreClase Definicin de Statechart Diagram
Entity Proyecto/Anlisis/Clases de
Anlisis/Entity Datos
DSCAN Realizacin Desarrollo del Sequence Diagram
de Analisis de Casos Proyecto/Anlisis/Realizacin de
de Uso Anlisis/RAN del caso de uso
DCLAN Realizacin Desarrollo del Logical Diagram (Class)
de Anlisis de Casos Proyecto/Anlisis/Realizacin de
de Uso Anlisis/RAN del caso de uso
DPNAN Diagrama de Desarrollo del Activity Diagram
proceso de Negocio Proyecto/Anlisis/Realizacin de
de Anlisis del caso Anlisis/RAN del caso de
de uso uso/DPNAN del caso de uso
DTNAN Diagrama de Desarrollo del Activity Diagram
tareas de Negocio de Proyecto/Anlisis/Realizacin de
(Las actividades sern de
anlisis del Caso de Anlisis/RAN del caso de
tipo estado)
Uso uso/Tareas de Negocio
Otros Diagramas de Desarrollo del Activity Diagram
Realizacin de Proyecto/Anlisis/Realizacin de
Anlisis Analisis/Otros
Diagramas/Diagramas de
Actividad
Desarrollo del StateChart Diagram
Proyecto/Anlisis/Realizacin de
Analisis/Otros
Diagramas/Diagramas de
Estados
Prototipo IU Desarrollo del Custom Diagram
Proyecto/Anlisis/Prototipo IU
Diagrama de Clases Desarrollo del Proyecto/Diseo Logical Diagram (Class)
de Diseo

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 25
Diagrama rbol Navegador Tipo diagrama
DCLDS del caso de Desarrollo del Logical Diagram (Class)
uso proyecto/Diseo/Realizacin de
Diseo/RDS del caso de
uso/PIM-Plataforma Integracin
Multicanal
DPNDS del caso de Desarrollo del Activity Diagram
uso / Diag Proceso Proyecto/Diseo/Realizacin de
Negocio Diseo/RDS del caso de
uso/PIM/DPNDS del caso de uso
DTNDS Diagrama de Desarrollo del Activity Diagram
tareas de Negocio de Proyecto/Diseo/Realizacin de
diseo del Caso de Uso Diseo/RDS del caso de uso/Tareas
de Negocio
DCL_Pantalla Desarrollo del Logical Diagram (Class)
Proyecto/Diseo/Realizacin de
Diseo/RDS del caso de uso/PIM-
Plataforma Integracin Multicanal
(diagrama que cuelgue de una
actividad que represente una
pantalla)
DSC_Pantalla Desarrollo del Sequence Diagram
Proyecto/Diseo/Realizacin de
Diseo/RDS del caso de
uso/PIM-Plataforma Integracin
Multicanal (diagrama que cuelgue
de una actividad que represente
una pantalla)
DSC_InLN Desarrollo del Sequence Diagram
DSC_InLG Proyecto/Diseo/Realizacin de
Diseo/RDS del caso de
uso/PIM-Plataforma Integracin
Multicanal (diagrama que cuelgue
de una actividad que represente
una invocacin a LG o LN)
Diagrama de Desarrollo del Activity Diagram
representacin de un Proyecto/Diseo/Realizacin de
Procedimiento Diseo/LN-Lgicas de Negocio
general
Diagrama de Desarrollo del Activity Diagram
representacin de un Proyecto/Diseo/Realizacin de
Procedimiento Diseo/LN-Lgicas de
general Negocio/Nombre del Caso de
Uso
rbol de Datos Desarrollo del Logical Diagram (Class)
Proyecto/Diseo/Diseo de
Datos/Diccionario de Datos
DCL_Modelo de Desarrollo del Logical Diagram (Class)
Datos Proyecto/Diseo/Diseo de
Datos/Modelo de Datos
Trazabilidad Anlisis Desarrollo del Custom Diagram
Diseo Proyecto/Trazabilidad Anlisis
diseo
Tabla 1: Relacin modelos - tipos de diagrama

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 26
5 Polticas de Seguridad
Este apartado propone una forma de trabajar con la herramienta Enterprise Architect que
minimiza los posibles problemas que pueden surgir en un entorno multi-usuario. Es
importante que todo el equipo siga el mismo procedimiento para evitar posibles
conflictos.
En este punto se describen las polticas de seguridad y las acciones a realizar en la
gestin de usuarios, los procedimientos de gestin de bloqueos y los procesos Backups
del proyecto.

Preparacin de un nuevo repositorio


En este apartado se describen los aspectos que hay que tener en cuenta para la
preparacin de un nuevo repositorio: creacin de grupos, creacin de usuarios y
procedimiento general a seguir.

Habilitar las funciones de seguridad


Cuando se crea un proyecto nuevo en Enterprise Architect es necesario habilitar la
seguridad en el modelo. Esto se hace desde el men Project|Security|Enable
Security introduciendo un cdigo que se proporciona con la licencia, este se puede
obtener tambin en la siguiente pagina web
http://www.sparxsystems.com.au/ea_downloads.htm.
El cdigo para la versin 3.60.641 es:
{F08113BA-8B4F-41df-8F01-46DF2C35D249}

Si no surge ningn problema, saldr el siguiente mensaje:

Figura 33 : Mensaje de Seguridad Habilitada

En el siguiente paso, se debe cambiar de usuario utilizando el men Project|


Security|Login as Another User para habilitar las otras opciones del men de
seguridad que se han quedado de color gris porque el usuario por defecto tiene pocos
privilegios.
UserId: admin
Password: password
Una vez hecha la conexin con el usuario admin, se debe cambiar la contrasea
utilizando el men Project|Security|Change Password. Esto previene el uso
indebido de la herramienta.
A continuacin se debe activar sobre la opcin de bloqueo por defecto accediendo a
Project|Security|Require User Lock to Edit.

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 27
Figura 34: Men de Seguridad

Forma de Trabajar con los bloqueos


Una vez habilitadas las funciones de seguridad, la forma de trabajar en un proyecto EA
se detalla a continuacin.
Se va a trabajar en modo de Bloqueo Total, en este modo por defecto todo est
bloqueado. El modo de trabajo consiste en solicitar el desbloqueo para un usuario
concreto antes de empezar a trabajar con un objeto, este usuario bloquear el objeto y
slo el podr actualizarlo pero para los dems est inaccesible.
En EA podemos bloquear elementos a nivel de paquete desde el browser (Project
View) a nivel de diagrama directamente desde este, pulsando con el botn derecho
sobre el diagrama, paquete sobre cualquier artefacto dentro de estos y eligiendo la
opcin Apply User Lock.
El hecho de poder bloquear elementos desde el browser y desde los diagramas es
peligroso ya que dichos bloqueos se pueden solapar dificultando el entendimiento y el
manejo de los modelo EA. Debido a esto en este manual se van a dar unos consejos a
seguir de cmo realizar los bloqueos para que no surjan problemas.

Bloqueos sobre un diagrama elementos de este


- Bloqueo del diagrama completo -> Por defecto, cuando un usuario realiza un bloqueo
sobre un diagrama se bloquean tambin los elementos que componen ese diagrama,
a no ser que algn elemento ya estuviese bloqueado anteriormente por otro usuario
distinto con lo cual el bloqueo sobre este elemento no se hace efectivo y se sigue
conservando el bloqueo antiguo. Remarcar que cuando un usuario crea un
diagrama, EA por defecto bloquea dicho diagrama y todos los artefactos que se
creen dentro, es decir es como si hiciese un Apply User Lock automtico sobre el
diagrama y todo su contenido. Si se intenta bloquear un diagrama que ya est
bloqueado Ea nos avisa de ello con una pantalla y no nos permite bloquear.
- Bloqueo sobre un elemento concreto del diagrama -> se bloquear slo ese
elemento. Si se da el caso en que el elemento ya est bloqueado por otro usuario,
EA no nos avisa de ello pero no nos permite hacer ninguna operacin sobre l.

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 28
Los bloqueos se realizan pulsando con el botn derecho sobre el diagrama, sobre
cualquier artefacto dentro de estos y eligiendo la opcin Apply User Lock.

Figura 35: Bloqueo de un Diagrama Artefacto del diagrama

Con esta accin se consigue disponer del diagrama el artefacto en exclusiva para la
persona que lo ha bloqueado pero los dems no pueden modificar nada de l.

- Desbloqueo -> Cuando un usuario finaliza los cambios, se pulsa con el botn derecho
sobre el diagrama sobre el artefacto y se elige la opcin Release User Lock

Figura 36: Desbloqueo de un Diagrama Artefacto del diagrama

Esto har que el usuario pierda el control sobre el diagrama el artefacto con el que est
trabajando y este quede a disposicin de ser bloqueado por otro usuario para poder
realizar ms cambios.

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 29
<<Sobre un diagrama cualquier elemento incluido en este se pueden realizar cualquier
tipo de operacin, excluyendo el borrado fsico del modelo, esto ltimo slo se puede
hacer desde el browser (project view). Es decir, desde el diagrama yo puedo borrar un
elemento de este (una clase por ejemplo) pero este sigue existiendo en el browser. Para
borrar un elemento diagrama del modelo se tiene que hacer obligatoriamente desde el
browser (Project View).>>

Bloqueos/Desbloqueos sobre paquetes elementos del browser (Project View)


Tambin se pueden bloquear/desbloquear elementos desde el browser (paquetes,
diagramas elemento dentro de estos), pulsando con el botn derecho sobre el
elemento a bloquear/desbloquear:

Figura 37: Bloqueo/Desbloqueo desde el browser

En el caso de bloquear/desbloquear un paquete desde el browser, aparece una opcin


para poder bloquear/desbloquear tambin todos los subpaquetes que hay dentro de este,
esto se hace chequeando la opcin Include Child Packages.

Figura 38: Bloqueo/Desbloqueo de un paquete y de los subpaquetes incluidos en l.

Si se marca esta opcin se bloquear/desbloquear todo lo que hay por debajo del
paquete incluidos los subpaquetes, sin embargo si la herramienta detecta que hay algn
subpaquete que est bloqueado por otro usuario nos lo indicar mediante un mensaje
por pantalla y por tanto esta subcarpeta concreta no ser bloqueada/desbloqueada.
En el caso de no marcar la opcin Include Child Packages se bloquear/desbloquear
el paquete y todos los diagramas y elementos que haya dentro de l, pero no los

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 30
subpaquetes y su contenido. Como ya se ha dicho anteriormente, si algn diagrama
elemento est ya bloqueado por otro usuario este no se podr bloquear/desbloquear.
En el caso de bloquear/desbloquear un diagrama un elemento desde el browser el
resultado ser el mismo que si lo hicisemos desde un diagrama, nos saldra la pantalla
de la figura 34 pero sin incluir la opcin Include Child Packages y el funcionamiento
sera el mismo que hemos visto para el punto 5.1.2.2, con la salvedad de que desde el
browser si se pueden borrar fsicamente del modelo diagramas los elementos dentro
de estos, siempre que estos no estn bloqueado por otro usuario. Lo mismo ocurre para
un subpaquete paquete que queramos borrar del modelo, esta operacin slo se podr
hacer desde el browser (Project View), por supuesto siempre que esa carpeta no est
bloqueada por otro usuario.

Crear Grupos
Antes de crear los usuarios, conviene definir los grupos propuestos en la metodologa.
Para ello se utilizar el cuadro de dialogo de grupos Project|Security|Maintain
Groups.

Figura 39 : Dialogo de Mantener Grupos y Permisos

Utilizando el cuadro anterior se definen los perfiles y los permisos que se asignan a cada
perfil. De ese modo en vez de asignar derechos a cada usuario individualmente, se
pueden asignar a nivel de grupo, aadiendo privilegios extras o individuales solo cuando
sea absolutamente necesario.
Si se definen, por ejemplo, los grupos Analistas, Jefe de proyectos y Lectores se
tendra la configuracin bsica necesaria para un equipo pequeo. Luego cada nombre
de usuario puede ser asociado a uno o ms grupos. De esta manera el Jefe de
proyecto puede ser Analista tambin si necesitara editar diagramas.
No hay que olvidar que hay otro usuario que es el admin, y que por defecto es miembro
de grupo Administrators que tiene todos los derechos. Es importante que no se borre
este usuario a no ser que se haya creado otro con todos los derechos.
Los permisos y perfiles tpicos para un grupo de trabajo se muestran en la siguiente
pagina.

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 31
Permiso Analistas Lectores J. de proyecto Explicacin
Administer Database X Compactar y reparar base de datos
Change Password X X X Cambiar contrasea
Check Data Integrity X Comprobar la consistencia de elementos en
el modelo y corregir errores
Configure Datatypes X Aadir / Modificar tipos de datos
Configure Images Definir otras imgenes para los elementos
Configure Packages X X Cambiar propiedades de paquetes
Configure Resources X X Importar y gestionar patrones, perfiles,
favoritos etc.
Configure Stereotypes X Gestionar la lista de estereotipos
Export EXI X X Exportar el modelo a XMI
Generate Documents X X Generar documentacin
Generate Source Code DLL X Generar cdigo fuente
Import XMI X X Importar desde un fichero XMI
Lock Elements X Pedir prestados elementos para trabajar
con ellos (obtener el lock)
Manage Diagrams X Borrar y crear nuevos diagramas, copiar
diagramas existentes etc.
Manage Issues X Borrar y aadir temas pendientes
Manage Project Information X Gestionar listas de recursos, riesgos etc.
Manage Reference Data X Gestionar referencias (listas de lenguajes /
Update tipos etc.)
Manage Replicas X Gestionar rplicas
Manage Tests X X Gestionar pruebas
Reverse Engineer from DDL X Crear un modelo directamente desde el
and Source cdigo fuente
Security - Enable/Disable Habilitar / deshabitar seguridad en un
modelo
Security - Manage Locks X Gestionar los prestamos locks de todo el
equipo
Security - Manage Users X Dar de alta y borrar usuarios
Spell Check X X Comprobar la ortografa
Transfer Data Transferir datos entre dos DBMS
Update Diagrams X Cambiar propiedades y posicionamiento de
los objetos en un diagrama
Update Elements X Cambiar elementos
View Locks X X Ver los locks de todo el mundo

Tabla 2: Permisos y perfiles para un grupo de trabajo

Crear Usuarios
La creacin de usuarios se realiza desde dentro de la propia herramienta partiendo de
los grupos definidos.
Para crear los usuarios se utiliza el men Project|Security|Maintain Users.

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 32
Manual de Usuario de Enterprise Architect Mapfre
22/11/2004 Pgina 33
Figura 40 : Dialogo de Mantener Usuarios

Una vez grabados los detalles bsicos, cada usuario se debe asignar a uno o ms
grupos pulsando el botn Group Membership.

Figura 41: Asignacin de grupo a un usuario

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 34
Resumen del procedimiento de creacin de un repositorio nuevo
A continuacin se muestra un diagrama de flujo con el resumen de creacin de un nuevo
repositorio que incluye la creacin de usuarios y grupos3.

B.
Datos

Oracle Access

Crear Base de Crear


datos Oracle Repositorio
como se nativo como
explica en
"Gua de Uso Se explica en
de EA con Oracle" "Gua del
Usuario"

Habilitar
Seguridad

Entrar como
usuario
Admin

Cambiar
contrasea
Admin

Activar
"Require User
Lock"

Crear Grupos
y dar
permisos

Crear
Usuarios y
asociar a
grupos

Figura 42: Resumen de la preparacin del Repositorio

3
En este diagrama se considera la opcin de poder crear el repositorio en una base de datos Oracle, aunque en
principio se crear en Access que es el repositorio nativo de EA.

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 35
Procedimientos de Gestin
En este apartado se describen los aspectos que hay que tener en cuenta para la gestin
de bloqueos, backups y procedimiento de versionado.

Ver/Gestionar bloqueos del equipo


El jefe de proyecto puede ver los artefactos que estn bloqueados en cada momento y,
en caso necesario, desbloquearlos.
Esta opcin esta disponible utilizando el men Project|Security|View and
Manage Locks.

Figura 43: Pantalla Gestin de Bloqueos

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 36
Backup para el sistema de control de versiones

La versin 3.60 (build 641) de Enterprise Architect proporciona soporte para el control de
versiones de proyectos, permite integracin con SCC (Source Code Control) en concreto
con Microsoft Visual SourceSafe. Sin embargo, esta funcionalidad de Corporate no se va
a utilizar porque en Mapfre se usa como control de versiones CVS que estar integrado
en la plataforma Eclipse en WSSD dependiendo del perfil de la persona.
Peridicamente hay que hacer una copia del modelo y de los ficheros adjuntados de
forma que ocupe el menor espacio posible y, con una frecuencia suficientemente alta
para que no se pierda mucho trabajo si surge algn problema. Como ya se ha
comentado, se har con el control de versiones CVS y teniendo en cuenta la estructura
de directorios definida en ste.
An as, si se quieren realizar backups auxiliares la siguiente tabla resume los resultados
de los distintos mtodos de crear un backup sobre un mismo proyecto de gran tamao,
utilizando las dos bases de datos posibles.

DBMS FORMATO TAMAO MEGAS % reduccin Minutos Multi-


usuario
EAP Original 17
EAP Sin Replicacin 12 70 3
EAP Compactado 10 58 2 No
EAP Comprimido winzip 2,7 16 3

Oracle Original 17
Oracle Exportado 8,5 50 7 No
Oracle Comprimido winzip 1,5 9 5

Ambos Export XML 7 - 28,5 - 67 15


Ambos Export XMI 8,5 50 ~ 50 No
Ambos Comprimido winzip 1,5 0,5 1
Tabla 3: Tabla de exportacin

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 37
Resumen del procedimiento de backup para versionado
A continuacin se muestra un diagrama con el procedimiento de backup.

Figura 44: Resumen del proceso de crear un backup

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 38
6 Seguridad y Trabajo en Grupo

Este punto es un resumen de cmo Enterprise Architect cubre las necesidades del
trabajo en equipo.
En el primer apartado se definen cuales son las necesidades bsicas, y luego se indican
las carencias de la herramienta para acabar proponiendo unos procedimientos
estndares que aumentan la seguridad y fiabilidad de la herramienta.
En el segundo apartado se definen los mecanismos de trabajo en grupo.
Antes de empezar a describir los mecanismos de seguridad y de trabajo en grupo es
necesario destacar que la versin que se utiliza actualmente en Mapfre es la versin 3.6
edicin Corporate.
En esta edicin, como en la anterior, se utiliza, como ya hemos comentado
anteriormente, un tipo de bloqueo concreto. El tipo de bloqueo determina el modo de
trabajo con la herramienta. En concreto, las caractersticas del tipo de bloqueo utilizado
son las siguientes:
Bloqueo total: En este modo por defecto todo est bloqueado. El modo de trabajo
consiste en solicitar, por parte de un usuario, el desbloqueo antes de empezar a
trabajar con un elemento, una vez que se consigue este el elemento permanece
bloqueado para cualquier otro usuario, hasta que el usuario que lo ha bloqueado lo
libere.
Por tanto, cuando a lo largo del documento se hable de bloqueo se entender el modo
de trabajo de Bloqueo total.

Mecanismos de Seguridad
En este apartado se describen los mecanismos de seguridad que hay que tener en
cuenta para el trabajo en equipo en EA, referentes a opciones multi-usuario, seguridad y
control de versiones.

EA y las exigencias del trabajo en equipo


Un equipo de trabajo est formado, normalmente, por un jefe de proyecto, varios
analistas y varios diseadores. Para que todos puedan trabajar con el modelo a la vez
sin que los cambios se sobreescriban, hay que utilizar las funcionalidades Multi-usuario
que proporciona la herramienta EA.
La identificacin de usuarios y la autorizacin para que realicen tareas se hace por medio
de un nombre de usuario, contrasea y unos privilegios que se describen en la seccin
Seguridad de este mismo punto. La accin de guardar versiones anteriores de los
diagramas y artefactos del modelo y la de facilitar la comparacin y recuperacin de
versiones anteriores se denomina Control de Versiones.
Multi-usuario
Si el proyecto se ha creado con las opciones correctas, la posibilidad de modificar cada
artefacto del modelo slo se conceder a un usuario. Antes de efectuar cualquier
cambio, el usuario tendr que pedir un lock (bloqueo) del artefacto en su nombre, y
antes de que este lock se cancele por l mismo o por el administrador, nadie ms podr
cambiar lo que tenga bloqueado.
Se puede pensar en este mecanismo como si fuera una biblioteca, en la que los
analistas diseadores pueden pedir prestado lo que necesiten para su trabajo, y el

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 39
administrador mantiene una lista de los prstamos por si en un momento dado hay
confusin sobre quin tiene un objeto.
El administrador del repositorio puede ver en cualquier momento, una lista de usuarios y
los artefactos con los que estn trabajando. Por defecto, el analista diseador
solamente puede ver la lista de lo que l mismo tiene bloqueado. El repositorio se puede
configurar de tal manera que dichos usuarios tambin puedan ver la lista del
administrador. Esto puede ser til en equipos grandes para que, cuando alguien necesite
un artefacto que ya esta bloqueado, se sepa quin lo tiene para poder preguntarle qu
cambios hace y cundo estar disponible ese objeto.
Concretamente, hay tres posibles formas de trabajar con un repositorio y si todo el
mundo no sigue el mismo procedimiento, puede que se pierdan cambios por tanto es
importante definir los pasos que hay que seguir para obtener y devolver un lock sobre
un artefacto.
Seguridad
Toda la informacin sobre las opciones de seguridad y las definiciones de usuarios,
grupos y permisos se almacenan en el repositorio. El repositorio reside en un esquema
de base de datos y cada esquema puede tener solamente un modelo. Esto quiere decir
dos cosas:
1) Por cada modelo (proyecto) habr que crear un esquema distinto en la base de
datos.
2) Por cada proyecto hay que definir de nuevo los usuarios, nombres, grupos,
contraseas, departamentos y privilegios aunque estos ya estn definidos en otros
esquemas porque alguna gente trabaja en varios proyectos.

Control de versiones
La versin 3.60.641 de Enterprise Architect dispone de soporte limitado para el control
de versiones de los proyectos, permite integracin con SCC (Source Code Control) en
concreto con Microsoft Visual SourceSafe. Sin embargo, esto es indiferente ya que los
equipos de los proyectos van a utilizar como control de versiones CVS el cual estar
integrado en la plataforma Eclipse en WSSD dependiendo del perfil de la persona del
equipo.
Tambin se puede guardar una copia de la base de datos o una copia del modelo
exportado en XML utilizando XMI.
Se propone mantener el modelo actualizado dentro de EA y llevarlo a un repositorio CVS
solamente en el momento en el que se tenga intencin de realizar una versin, para que
de esta forma se tengan comprometidos los cambios existentes desde la versin
anterior.

Procedimientos de trabajo en Grupo


En este apartado se describen los procedimientos de trabajo en grupo con EA, referentes
a la gestin de locks (bloqueos) personales, el trabajo con diagramas y los refrescos del
proyecto.

Refrescar el Proyecto a menudo


Al utilizar Enterprise Architect lo que se muestra en pantalla es una copia del modelo
que hay que refrescar frecuentemente. Si el tiempo que se tarda en refrescar el proyecto
es muy grande, es posible que algunos de los objetos o diagramas hayan cambiado en el
repositorio porque otra persona del equipo los ha editado y ha guardado cambios
realizados. Las opciones de seguridad seleccionadas en el repositorio aseguran que un
objeto slo puede ser cambiado por una persona (la persona que bloquea el objeto en su
nombre y que luego lo libera cuando haya terminado el cambio), pero la herramienta no
ofrece informacin respecto a si lo que hay en pantalla ha cambiado desde la ltima vez

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 40
que se refresc/carg el proyecto. Por esa razn es necesario que si se sospecha que el
modelo puede haber cambiado se refresque a menudo.

Figura 45: Botn de Refrescar Proyecto

Para ver el icono sealado en la imagen anterior es necesario tener activa la barra de
herramientas Project que es a la que pertenece el modelo, esta barra de herramientas no
est activa por defecto se selecciona desde el men view y aparece de forma que se
puede refrescar el proyecto.

Empezar a trabajar con un artefacto / diagrama


Antes de realizar cualquier cambio hay que refrescar el proyecto y luego activar la opcin
Apply User Lock sobre el artefacto sobre el diagrama con el cual queremos
trabajar, para que nadie ms lo pueda tocar.
Si queremos trabajar con un artefacto dentro de un diagrama (una clase por ejemplo)
pinchamos con el botn inverso del ratn dicho artefacto dentro del diagrama y
seleccionando la opcin Apply User Lock del men emergente. A partir de este
momento, ningn otro usuario podr editar el artefacto seleccionado. Hay que hacer
notar que si el diagrama, al cual pertenece el artefacto con el que se quiere trabajar, est
bloqueado por otro usuario no podremos modificar dicho artefacto (hay que tener en
cuenta que la herramienta no avisa de esto, simplemente no deja modificar el artefacto).
Si queremos trabajar sobre el diagrama entero, por defecto Enterprise Architect intentar
aplicar el bloqueo sobre todos los artefactos de ese diagrama, excepto los que ya estn
bloqueados los cuales no se podrn editar. Para bloquear el diagrama entero se
pinchar con el botn inverso del ratn sobre el diagrama y se seleccionar la opcin
Apply User Lock del men emergente, esta operacin me bloque el diagrama y todos
los artefactos dentro de l.
Remarcar que cuando un usuario crea un diagrama, EA por defecto bloquea dicho
diagrama y todos los artefactos que se creen dentro, para el usuario creador, es decir
hace un Apply User Lock automtico sobre el diagrama y todo su contenido.

Terminar de usar un artefacto / diagrama


Cuando se hayan terminado las modificaciones es necesario quitar los bloqueos para
que los otros usuarios puedan usar los objetos cambiados, pero antes hay que decidir si
los cambios se deben guardar o no. Si se quiere que persistan los cambios, se utiliza el
men File|Save o el icono de disquete, teniendo en cuenta que para que sea habilitado
tiene que haber seleccionado algo dentro de documento. Despus se elimina el bloqueo
utilizando el men emergente que aparece al seleccionar el objeto con el botn inverso
del ratn, seleccionando Release User Lock en el dialogo que aparece.

Ver/Gestionar locks personales


Utilizando el men Project|Security|Manage My Locks se puede ver una lista
de los objetos que se estn usando por el usuario actual. La ventana que aparece sirve
tanto para ver como para quitar bloqueos.
Hay otra operacin relacionada, que permite ver los bloqueos de otros usuarios y
dependiendo de los permisos ( si se es un administrador) se pueden borrar permisos de

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 41
otros usuarios, esta operacin est disponible desde el men Project|Security|
View and Manage Locks.

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 42
Resumen del procedimiento de bloqueo y desbloqueo
A continuacin se muestra un diagrama con el procedimiento de bloqueo y desbloqueo a
seguir.

Refrescar Esperar hasta


Proyecto que este
disponible

Applicar User
Lock

Exito? No Ver locks e


investigar

Si

Editar el
Artefacto

Quiere
guardar?

Si No

Guardar Refrescar
cambios Proyecto

Release User
Lock

Figura 46: Resumen del uso de bloqueos

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 43
7 Anexo A. Men View

Vistas
Enterprise Architect ofrece distintas Vistas que se pueden configurar: es posible
visualizarlas/ocultaras, moverlas de posicin y aadir o quitar elementos de las mismas.
Para acceder a las Vistas se selecciona el Men View donde cada vista podr ser
marcada o desmarcada en funcin de que se quiera ver o no.

Figura 47: Men View

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 44
Para aadir o quitar elementos de un men en concreto hay que dar los siguientes
pasos:
1. situarse en la zona de un men en concreto
2. pulsar el botn inverso del ratn
3. en el men emergente, seleccionar la opcin Customize
4. aparecer la pantalla de personalizacin de los mens:

Figura 48. Opciones para personalizar la Barra de Herramientas

Desde el men Tools tambin se podr utilizar la opcin Customize con el mismo
resultado anterior.

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 45
Las distintas opciones de visualizacin de Enterprise Architect son las siguientes:

Main toolbar: Opciones de Crear nuevo proyecto, Abrir un proyecto, Salvar el diagrama
actual, Copiar los objetos seleccionados, Pegar los objetos seleccionados como un link,
Deshacer, Vista previa, Establecer el tamao de la pgina, Imprimir, Mostrar/Ocultar el
Navegador, Mostrar/Ocultar la barra de herramientas del diagrama, Vista Report del
diagrama, Ayuda.

Figura 49: Opciones "Default Tools"

Project: Opciones de: Recargar el proyecto, Insertar un nuevo diagrama, Insertar nuevo
package en el rbol, Insertar nuevo elemento en el rbol, Buscar en el rbol del proyecto,
Buscar objetos en el proyecto, Crear un informe con formato RTF, Listar las incidencias
del proyecto, Glosario del Proyecto, Opciones Locales.

Figura 50: Opciones "Project Bar"

Code Generation: Aspectos relacionados con la generacin y visualizacin de cdigo:


Seleccionar el lenguaje de programacin, Generar cdigo para una sola clase, Generar
cdigo para las clases seleccionadas, Sincronizar la clase con el cdigo fuente,
Visualizar cdigo fuente.

Figura 51: Opciones "Code Generation"

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 46
UML Elements: Opciones de: Seleccionar el tipo de Relacin, Insertar un recuadro,
Insertar una nota, Insertar una etiqueta, Insertar una nota con las propiedades de un
diagrama, Insertar un hipervnculo a una pgina Web o a un fichero, Crear una conexin
con una nota.

Figura 52: Opciones "UML Elements"

Diagram: Opciones de: Alinear elementos (izquierda, derecha, arriba, abajo), Pegar el
formato actual a los objetos seleccionados, Subir los objetos seleccionado, Bajar los
objetos seleccionados, Ir al diagrama anterior, Ir al diagrama siguiente, Ir al diagrama por
defecto, Zoom (mayor, menor, ajustando los elementos para que encajen en la ventana,
ajustar el tamao de la zona del diagrama), Visualizar propiedades de los diagramas y
Eliminar elementos seleccionados.

Figura 53: Opciones "Diagram Bar"

Object: Visualizar las propiedades de los objetos, aadir atributos y mtodos, otros usos
del objeto.

Figura 54:Opciones: "Current Object"

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 47
Project View: Navegador que acta como repositorio de informacin.

Figura 55: Navegador

Properties Workspace: Visualizacin todas las propiedades de los elementos.

Figura 56: Propiedades de los elementos

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 48
System: Para manejar tareas a realizar, incidencias o eventos que se producen y
mantener el glosario de trminos.

Figura 57: Pruebas de Sistema

Testing: Para plantear distintos tipos de pruebas.

Figura 58: Casos de Prueba

Maintenance: Permite mantener los defectos y los cambios que previamente se han
asociado a un elemento de un diagrama.

Figura 59: Identificacin de defectos y cambios

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 49
Color Tool: Se incluyen las opciones que permiten modificar la esttica de un elemento en
un diagrama: relleno, fuente, borde, grosor del borde, poner el estilo elegido a los objetos
seleccionados, seleccionar el estilo del objeto marcado, tratar estilos.

Figura 60: Opciones de apariencia

Status Bar: En la parte inferior de la ventana principal, aparece esta barra para dar
informacin acerca de la opcin que se selecciona en cada momento.

Figura 61: Barra de estado

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 50
Opciones
Dentro del men Tools/Options aparece la siguiente ventana donde se pueden marcar
distintas opciones para la informacin relacionada con la rama del rbol que se marque:

Figura 62: Opciones de EA

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 51
Manual de Usuario de Enterprise Architect Mapfre
22/11/2004 Pgina 52
8 Anexo B. Generacin de Documentacin en EA

Introduccin
Enterprise Architect proporciona documentacin en formato HTML y en formato de texto
enriquecido (RTF).

Generacin de Documentacin en RTF


El formato RTF es un formato comn a muchos de los procesadores de texto existentes
en el mercado. Es especialmente til cuando se quiere manejar documentacin en papel.
La generacin de este tipo de documentacin ayudar a obtener los productos
propuestos por la Metodologa de Mapfre.
El Esqueleto-Mapfre contiene una serie de plantillas que se usan a la hora de generar
documentaciones en formato RTF. Estas plantillas estn asociadas a las principales
fases/etapas del ciclo de vida de una aplicacin modelada en EA. Los proyectos
generados con el esqueleto antiguo no contienen esta informacin por lo que se describe
tambin cmo se deben generar esas plantillas para que una vez aadidas a los
proyectos actuales, se pueda obtener la documentacin ms fcilmente.
En este anexo se describe cmo generar documentacin RTF y cmo se almacenan las
plantillas de documentacin en EA para la nueva versin 3.60 edicin Corporate.
Hay que tener en cuenta que esta generacin automtica de documentacin no exime al
equipo de desarrollo de la labor de completar, refinar y aadir aquellos detalles que la
herramienta no sea capaz de obtener, por ejemplo, todos los documentos de entrega
propuestos por la Metodologa Mapfre tienen un apartado llamado Descripcin del
Documento que no se genera con EA. Tampoco se incluye el contendido de los ficheros
que se adjuntan a los elementos del proyecto a travs de la URL de los mismos. En
estos casos, ser necesario modificar manualmente el fichero RTF para incluir la
informacin que no se ha generado de forma automtica.

Generacin de una plantilla de documentacin


Para poder obtener un documento RTF, EA permite guardar en el repositorio las
opciones del documento en una plantilla. Cada plantilla guardada estar siempre
disponible en el proyecto tratado y eso permitir generar documentacin de forma
automtica con mayor rapidez y comodidad.
Cualquier miembro del equipo puede crear y guardar plantillas de documentacin RTF en
Enterprise Architect. Hay que seguir los siguientes pasos:
1. La generacin de la documentacin se realiza por paquetes por elementos
concretos de un diagrama. Antes de seleccionar un paquete hay que tener en cuenta
que tambin se generar documentacin para todos sus paquetes hijos (subpaquetes).
Si se desea que no aparezca algn subpaquete en la generacin del informe, hay que
excluirlo:
Seleccionar el subpaquete en el navegador y pulsar el botn inverso del ratn.
En el men emergente que aparece, seleccionar la opcin Documentation|RTF
Document Options.

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 53
Seleccionar la opcin Exclude Pakage From RTF Reports.

Figura 63: Excluir paquetes para la documentacin

2. Estando dentro de la vista de proyectos project view , las opciones de


documentacin se muestran seleccionando una carpeta y pulsando el botn derecho del
ratn.
Seleccionar el paquete para el cual se desea generar documentacin
Al pulsar el botn inverso del ratn aparece un men emergente, seleccionar la
opcin Documentation y despus Rich Text Documentation Diagrams only
Report. Se usar esta ltima opcin si slo se desea exportar a RTF los
diagramas del paquete seleccionado.

Figura 64: Opciones de documentacin RTF

Tambin se puede acceder a las opciones de documentacin desde el men principal Project|
Documentation apareciendo las mismas opciones que con el anterior camino.
Para generar un RTF de un elemento concreto de un diagrama (una clase por ejemplo) habr
que seleccionar dicho elemento en el diagrama y luego se acceder a la opcin Element del
men principal donde se seleccionar la opcin Documentation|Rich Text Format Report.
Aparecer la ventana que se muestra en la figura 57:

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 54
3. Rellenar los campos y seleccionar las opciones ms adecuadas para cada plantilla:
Document Item: es un campo que se rellena automticamente. Se refiere al
paquete del navegador al cual se aplica la generacin de documentacin RTF.
En el caso de que se quiera generar un RTF para un elemento concreto de un
diagrama en este campo aparecera el nombre de dicho elemento.
Document Type: este campo indica el tipo de documento sobre el que se ha
solicitado una documentacin RTF. Los valores pueden ser Single Element
Package dependiendo de si se va a documentar un elemento de un diagrama
el contenido de un paquete.
Output Filename: nombre del fichero resultado de la documentacin. Se debe
especificar una ruta del sistema de directorios. Se puede acceder al rbol de
directorios del sistema con el botn que aparece a la derecha del campo. Si no
se especifica ninguna ruta se considera como directorio destino aquel en el que
reside el fichero .EAP.
Template Name: las opciones que se seleccionen para documentar un
determinado paquete se guardan en el repositorio de EA como una plantilla, con
el nombre que se especifique en este campo.
Save as Document: cuando se tenga selecionada una plantilla concreta, se
puede grabar sta como un documento RTF dndole un nombre. Este nombre de
documento aparecer en la vista de recursos (Resource View) dentro de la
carpeta Documents/RTF Documents
Style: Lista desplegable de los formatos de estilo del documento RTF. El formato
RTF tiene una serie de cdigos para dar formato al documento. Por defecto EA
tiene modelado dos estilos de generacin: Formal y Basic.
Heading: Ttulo del documento RTF generado (no del fichero).
Heading Style: Lista desplegable de los estilos de cabecera para el documento.
Introduction: Texto que aparece despus del titulo de cabecera.
Filter: Opciones para filtrar los documentos RTF que se quieren generar. Se
podrn filtrar los objetos de un diagrama por fecha de creacin modificacin,
por la fase de su paquete, por el estado etc..
Template: Opciones para gestionar las plantillas. Permite crear una nueva
plantilla (New + Save), cambiar plantillas existentes (Save), borrar una plantilla
ya creada (Delete), cargar la lista de plantillas (Load).
Language: Opcin para la gestin del idioma. Esta opcin sirve para ajustar el
idioma, se ver con ms detenimiento en el siguiente prrafo.
Document: Funciones para gestionar el documento. Creacin de un documento
(Create), ver el documento generado (View), ayuda para la generacin del
documento RTF (Help), cerrar la pantalla de documentos RTF (Close).
For each Object Include: Opciones que se incluyen por cada artefacto o elemento
del paquete seleccionado.
Exclude details for: Lista de detalles de los artefactos o elementos que no se
incluyen.
Options: Opciones de documentacin. Es recomendable que se activen las
opciones Embed Diagrams in Documents y Show Diagrams.
Diagram Format: Indica el formato en el que se van a guardar las imgenes. Si
no se activa la opcin Embed Diagrams in Documents, cada diagrama que se
incluya en el documento se crea en un fichero en el directorio Images dentro del

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 55
directorio de generacin. El formato de este fichero se decide en este apartado.
Se recomienda utilizar EMF (Enterprise Metafile).

La pantalla de las opciones de generacin de documentos RTF es:

Figura 65: Opciones de documentacin

La opcin Adjust de la zona Language de la pantalla anterior sirve para ajustar el idioma,
tambin permite la traduccin de algunos trminos que van a aparecer en el documento. Estas
opciones ya estarn rellenas por defecto dentro de nuestro esquema y no debern cambiarse.

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 56
Figura 66: Opciones de lenguaje

4. Guardar la plantilla y el documento creados:


Dar un nombre a la plantilla en el campo Template Name de la pantalla de la figura
57.
Pulsar botn Save de la zona de Template. Esto guarda la nueva plantilla creada
para poder ser utilizada posteriormente.
Pulsar botn Save as Document. Aparece una pantalla de dilogo, en la que habr
que introducir un nombre significativo. Esto sirve para guardar la plantilla como un
documento RTF con el nombre introducido en esta opcin. Este nombre de
documento aparecer en la vista de recursos (Resource View) dentro de la carpeta
Documents/RTF Documents.
Si las opciones son correctas pulsar Create de la zona Document. Esta opcin crea
el documento RTF en el Output que se haya indicado.

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 57
Plantillas almacenadas
Una vez guardada la plantilla ya est disponible para la generacin de RTF en cualquier
momento. Estas plantillas sern utilizadas por documentos concretos (generalmente
documentos word con documentacin de diversos diagramas EA asociados al proyecto).
En la ventana de Resource View, en la pestaa del mismo nombre se encuentra el rbol
de recursos. En Resources|Documents|RTF Documents aparece la lista de
documentos que se han creado cada uno de los cuales tendr una plantilla asociada.

Figura 67: Vista de Recursos

Por defecto el proyecto base (esqueleto) de EA que se utilizar Esqueleto-Mapfre(EA


3.60) para crear proyectos incorpora todas las plantillas que se van a necesitar para
documentar las diferentes etapas y actividades del modelo de ciclo de vida web,
simplemente se generarn documentos a partir de stas. La forma de realizar esto se
describe en el siguiente punto.

Generar la documentacin a partir de una plantilla


Los pasos a seguir para generar un documento a partir de una plantilla ya existente son:
Seleccionar la entrada del rbol RTF Document de la pestaa Resources View
(figura 59).

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 58
Pinchar con el botn inverso del ratn sobre un documento ya creado y seleccionar
la opcin Generate Document del men emergente. Esto har que aparezcan las
opciones de documentacin guardadas para esa plantilla (figura 57)., asociadas al
documento elegido. Una vez aqu se podrn realizar los cambios que sean oportunos
crear nuevas plantillas directamente crear el documento.
Si se elige la opcin Auto Generate Document del men emergente, se crear
automticamente el documento en el output que tuviera por defecto, partiendo de su
plantilla asociada. Esta opcin es igual a la anterior pero con la salvedad de que
genera el documento directamente sin la posibilidad de hacer cambios en su plantilla.
Si se elige la opcin Delete Document se borrar ese documento de la vista pero su
plantilla asociada no. Esta podr ser utilizada por otro documento.
La opcin Open Document abre en word el documento que tenga seleccionado,
siempre que ste haya sido generado previamente.

El aspecto que tendra el menu desplegable comentado sera el que se muestra a


continuacin:

Figura 68: Men desplegable con opciones de documentacin

Hay que hacer notar, como ya se ha comentado ms arriba, que las plantillas ya vienen
creadas por defecto en el Esqueleto-Mapfre(EA 3.60) con una serie de parmetros y
opciones determinadas. Si para un proyecto concreto se quisiera cambiar el aspecto el
contenido de un documento generado, habra que retocar estas plantillas. En el caso de
querer retocar el aspecto se podra hacer directamente desde word en el documento
generado.

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 59
Manual de Usuario de Enterprise Architect Mapfre
22/11/2004 Pgina 60
Numeracin de las pginas en RTF
Ir a la vista de resources y seleccionar RTF Style Templates

Con el botn derecho crear una nueva Plantilla.


Modificar el estilo Basic Style y poner el cdigo \pgnx720, dependiendo donde se ponga
ir en la esquina superior derecha o en la inferior:

Crear la documentacin haciendo referencia a esa plantilla RTF:

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 61
Publicacin en HTML
La documentacin en formato HTML es muy potente, especialmente para consultas por
pantalla. Permite obtener documentaciones completas de paquetes (packages de EA) y,
gracias a los hipervnculos que maneja, ofrece la posibilidad de revisar la informacin
asociada a cada elemento documentado.
Una buena prctica sera publicar toda la informacin disponible en Enterprise Architect
(diagramas, descripciones y comentarios etc..) sobre un proyecto concreto en pginas
html y dejarlas en un sitio accesible para todo el equipo del proyecto. De esta forma toda
persona interesada podra consultar la informacin que necesitase con la seguridad de
que no va a poder tocar el fichero asociado de Enterprise Architect ya que un cambio en
la publicacin no supone un cambio en dicho fichero, lo contrario si.

Para poder publicar parte de un proyecto su totalidad se tendran que realizar los
siguientes pasos:
Se selecciona del men principal la opcin Project y luego Documentation/HTML
Report.

Figura 69: Publicacin en HTML

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 62
Aparecer la pgina con las distintas opciones para la publicacin; primeramente
habr que seleccionar el paquete (Package) a publicar, ser aquel en el que se est
situado por defecto cuando se seleccionan las opciones anteriores. Si se quiere
publicar todo el proyecto entero, antes de entrar en las opciones de publicacin
deberemos estar posicionados en el paquete raiz del proyecto. Despus se elegir el
path en el cual se van a publicar los ficheros HTML generados (Output to). Se
recomienda que ste sea de acceso compartido para que todo el equipo de proyecto
pueda verlo. Por ltimo se podrn elegir otras opciones relativas al formato de las
imgenes generadas, informacin aadida a la publicacin (casos de prueba) etc..
Una vez comprobadas todas las opciones se realiza la publicacin pulsando el botn
OK, EA situa el html generado en el directorio destino que se le ha indicado en la
pantalla con la opcin Output to

Figura 70: Opciones generacin HTML

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 63
Anexo C. Versionado de un fichero eap

La forma de versionar un fichero de Enterprise Architect .eap que est siendo utilizado
por varias personas, dentro de un proyecto concreto de desarrollo, se debe llevar a cabo
de la forma que se explica a continuacin, distinguindose dos casos distintos.
CASO 1. El proyecto se ha generado con el plugin de Creacin de Proyectos y por tanto,
el fichero .eap est dentro de la estructura de CVS.
Los pasos que se deben dar son los siguientes.
1) El Jefe de Proyecto copiar el fichero eap del workspace del proyecto 4de Eclipse
local a una unidad de red compartida y accesible para todos los usuarios del
proyecto (no a Documentum), de tal forma que todos los integrantes del proyecto
puedan acceder a l para actualizarlo. Dicho fichero tendr activadas las opciones
de seguridad de EA proporcionadas por Corporate (la opcin Enable security) para
garantizar la consistencia de la informacin.
2) El segundo paso se da cuando el Jefe de Proyecto considere conveniente subir el
fichero .eap a CVS para crear una versin del mismo. Para hacer esto, copiar el
fichero desde el directorio de red al workspace del proyecto en su entorno local,
sustituyendo el eap anterior. Despus sincronizar y a continuacin comprometer
como si fuera un fichero ms 5. Esta operacin slo podr realizarla el Jefe de
Proyecto ya que ninguna otra persona del equipo estar autorizada a hacerlo.
Finalizado este paso, todo los integrantes del equipo volvern a trabajar con el
fichero compartido hasta que el jefe de proyecto decida otra vez hacer una nueva
versin de este.
CASO 2. El fichero .eap no se est manejando dentro del entorno de CVS.
En este caso se recomienda generar versiones con Documentum segn los pasos
siguientes:
0) Si el eap inicialmente creado no est en Documentum, se debe poner en
Documentum
1) El jefe de proyecto debe llevar el fichero .eap desde Documentum hasta un archivo
compartido de la red donde todos los integrantes del equipo puedan actualizarlo.
Dicho fichero tendr activadas las opciones de seguridad de EA proporcionadas por
Corporate (la opcin Enable security) para garantizar la consistencia de la
informacin.
2) Cuando se considere necesario crear una nueva versin del fichero .eap, el jefe de
proyecto debe registrar (check-in) el fichero de la red en Documentum con un nuevo
nmero de versin. Para realizar esta operacin, ningn integrante del equipo debe
estar utilizando el fichero que hay en la red.
3) Una vez generada la versin se debe seguir trabajando con el fichero .eap que hay
en la red hasta que se decida crear una nueva versin en Documentum.

4
Workspace de Eclipse es una estructura que fsicamente se encuentra en la maquina local de un usuario
5
Para ms informacin se debe consultar el Manual de Usuario de CVS

Manual de Usuario de Enterprise Architect Mapfre


22/11/2004 Pgina 64

Вам также может понравиться