Академический Документы
Профессиональный Документы
Культура Документы
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.
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:
1
El directorio del proyecto nuevo tiene que estar creado en el sistema de directorios. Si no es as, dar un error
Figura 3 : Mens
Los elementos que se pueden crear, agrupados por tipos de diagramas (Object Toolbar)
Figura 6 : Navegador
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.
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:
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:
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.
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.
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.
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.
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.
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..).
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..
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
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):
A continuacin se explican para que sirven las distintas opciones de esta ventana:
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:
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:
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
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
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.
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
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.
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.
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.
Una vez grabados los detalles bsicos, cada usuario se debe asignar a uno o ms
grupos pulsando el botn Group Membership.
B.
Datos
Oracle Access
Habilitar
Seguridad
Entrar como
usuario
Admin
Cambiar
contrasea
Admin
Activar
"Require User
Lock"
Crear Grupos
y dar
permisos
Crear
Usuarios y
asociar a
grupos
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.
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.
Oracle Original 17
Oracle Exportado 8,5 50 7 No
Oracle Comprimido winzip 1,5 9 5
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.
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.
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.
Applicar User
Lock
Si
Editar el
Artefacto
Quiere
guardar?
Si No
Guardar Refrescar
cambios Proyecto
Release User
Lock
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.
Desde el men Tools tambin se podr utilizar la opcin Customize con el mismo
resultado anterior.
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.
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.
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.
Object: Visualizar las propiedades de los objetos, aadir atributos y mtodos, otros usos
del objeto.
Maintenance: Permite mantener los defectos y los cambios que previamente se han
asociado a un elemento de un diagrama.
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.
Introduccin
Enterprise Architect proporciona documentacin en formato HTML y en formato de texto
enriquecido (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:
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.
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.
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.
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