# Treballant amb &umbrello;

Aquest capítol us presentarà la interfície d'usuari del &umbrello; i us explicarà tot el que necessiteu conèixer per començar amb el modelat. Totes les accions en &umbrello; són accessibles a través del menú i les barres d'eines, però &umbrello; també fa un ús intensiu dels menús contextuals del &BDR;. Podeu clicar amb el &BDR; en la majoria d'elements en l'àrea de treball de &umbrello; o en la vista d'arbre per obtenir un menú amb les funcions més útils que poden ser aplicades a l'element particular sobre el que esteu treballant. Alguns usuaris troben això una mica confús a l'inici perquè estan més familiaritzats a treballar amb el menú o les barres d'eines, però una vegada que us acostumeu clicar amb el &BDR; accelerarà el vostre treball.

## Interfície d'usuari

La finestra principal de &umbrello; està dividida en tres àrees que us ajuden a mantenir una vista general del vostre sistema sencer i accedir als diferents diagrames de manera ràpida mentre treballeu en el vostre model.

Les tres àrees s'anomenen:

- Vista d'arbre

- Àrea de treball

- Finestra de documentació

La interfície d'usuari del &umbrello;
La interfície d'usuari del &umbrello;

La interfície d'usuari del &umbrello;

### Vista d'arbre

La vista d'arbre està ubicada normalment en la part superior esquerra de la finestra i mostra la totalitat dels diagrames, classes, actors i els casos d'ús que construeixen el model. La vista d'arbre us permet obtenir una vista general ràpida dels elements que composen el model. La vista d'arbre també us dóna un accés ràpid per commutar entre els diferents diagrames del odel i inserir elements del model en el diagrama actual.

Si esteu treballant en un model amb alguna cosa més que unes poques classes i diagrames la vista d'arbre us pot ajudar a estar a sobre de les coses organitzant els elements del model en carpetes. Podeu crear carpetes seleccionant l'opció apropiada del menú contextual (clic amb el &BDR; en una de les carpetes de la vista d'arbre) i podeu organitzar els elements movent-los a la carpeta apropiada (arrossegant i deixant anar)

### Finestra de documentació

La finestra de documentació és la petita finestra ubicada en la part inferior esquerra de &umbrello; i us dóna una vista prèvia ràpida de la documentació per l'element seleccionat actualment. La finestra de documentació és més aviat petita perquè està pensada simplement perquè pugueu fer una ullada a la documentació de l'element prenent l'espai mínim possible de la pantalla. Si necessiteu veure la documentació més detalladament sempre podeu obrir les propietats de l'element.

### Àrea de treball

L'àrea de treball és la finestra principal en &umbrello; i és on es du a terme l'acció real. Usareu l'àrea de treball per editar i visualitzar els diagrames en el model. L'àrea de treball mostra el diagrama actiu actualment. Actualment només es pot visualitzar un diagrama alhora en l'àrea de treball.

## Creació, càrrega i desat dels models

La primera cosa que necessiteu per començar a fer alguna cosa útil amb &umbrello; és crear un model on treballar. En iniciar &umbrello; sempre carrega el darrer model usat o crea un nou, model buit (depenent del vostre arranjament establert en el diàleg de configuració). Això us permetrà començar a treballar immediatament.

### Nou model

Si necessiteu crear un nou model ho podeu fer seleccionant l'entrada Nou del menú Fitxer, o clicant en la icona Nou de la barra d'eines de l'aplicació. Si actualment esteu treballant en un model que ha estat modificat &umbrello; us demanarà si voleu desar els canvis abans de carregar el nou model.

### Desat del model

Podeu desar el model en qualsevol moment seleccionant l'opció Desa del menú Fitxer o clicant el botó Desa de la barra d'eines de l'aplicació. Si necessiteu desar el model sota un nom diferent podeu usar l'opció Desa com a... del menú Fitxer.

Per la vostra comoditat &umbrello; també us ofereix l'opció de desar automàticament la feina cada cert període de temps. Podeu configurar si voleu aquest opció així com els intervals de temps en Arranjament de &umbrello;

### Càrrega d'un model

Per carregar un model que ja existeix podeu seleccionar l'opció Obre del menú Fitxer o clicar en la icona Obre de la barra d'eines de l'aplicació. El models usats més recentment també són disponibles sota el submenú Obre recent en el menú Fitxer per accelerar l'accés als models usats més freqüentment.

&umbrello; només pot treballar en un model alhora, de manera que si demaneu al programa que carregui un model i el model actual ha estat modificat des de la darrera vegada que l'heu desat, &umbrello; preguntarà si s'han de desar els canvis per evitar qualsevol pèrdua de treball. També podeu iniciar dues o més instàncies de &umbrello; alhora, de manera que pugueu copiar i enganxar entre ambdues instàncies.

## Edició dels models

En &umbrello;, hi ha bàsicament dos maneres d'editar els elements del model.

- Editar els elements del model directament a través de la vista d'arbre

- Editar els elements a través d'un diagrama

Usant el menú contextual dels diferents elements en la vista d'arbre podreu afegir, eliminar, i modificar la majoria dels elements del model. Clicant amb el botó Dret en les carpetes en la vista d'arbre se us donarà opcions per crear els diferents tipus de diagrames així com, depenent de si la carpeta és una Vista de casos d'ús o una Vista lògica, els actors, els casos d'ús, les classes, etc.

Una vegada que heu afegit elements al model també podeu editar un element accedint al seu diàleg de propietats, que trobareu seleccionant l'opció Propietats del menú contextual mostrat en clicar amb el botó dret en els elements en la vista d'arbre.

També podeu editar el model creant o modificant elements a través dels diagrames. Es donen més detalls de com fer això en les següents seccions.

## Afegir o eliminar diagrames

El model &UML; consisteix en un conjunt d'elements &UML; i les associacions entre ells. No obstant això no podeu veure el model directament, heu d'usar els Diagrames per veure'l.

### Creació de diagrames

Per crear un nou diagrama en el model simplement seleccioneu el tipus de diagrama que necessiteu del submenú Nou en el menú Diagrama i donar-li un nom. El diagrama serà creat i activat, i podreu veure'l immediatament en la vista d'arbre.

Recordeu que &umbrello; fa extensiu l'ús dels menús contextuals: també podeu clicar amb el &BDR; en una carpeta en la vista d'arbre i seleccionar el tipus de diagrama apropiat del submenú Nou en el menú contextual. Noteu que podeu crear diagrames de casos d'ús només en les carpetes de vista de casos d'ús, i els altres tipus de diagrames només es poden crear en les carpetes de vista lògica.

### Eliminar diagrames

Si necessiteu eliminar un diagrama del model, podeu fer-ho activant-lo i seleccionant Esborra del menú Diagrama. També podeu aconseguir això seleccionant Esborra del menú contextual dels diagrames en la vista d'arbre

Com que esborrar un diagrama és una cosa seriosa que pot causar la pèrdua de treball si es fa accidentalment, &umbrello; us demanarà que confirmeu l'operació d'esborrat abans d'esborrar realment el diagrama. Una vegada que s'hagi esborrat un diagrama i s'hagi desat el fitxer no hi ha forma de desfer l'acció.

### Reanomenar els diagrames

Si voleu canviar el nom d'un diagrama existent podeu fer-ho fàcilment seleccionant l'opció Reanomena del seu menú &BDR; en la vista d'arbre.

Una altra manera de reanomenar un diagrama és fer-ho a través del seu diàleg de propietats, que podeu obtenir seleccionant Propietats del seu menú contextual o fent-hi doble clic en la vista d'arbre.

## Edició de diagrames

En treballar amb un diagrama, &umbrello; intentarà guiar-vos aplicant algunes regles simples sobre quins elements són vàlids en els diferents tipus de diagrames, així com les relacions que poden existir entre ells. Si sou un expert en &UML; probablement no ho notareu mai, però això ajuda als novicis de &UML; a crear diagrames d'acord amb l'estàndard.

Una vegada que heu creat els vostres diagrames és l'hora d'editar-los. Aquí cal fixar-se en la diferència (per als principiants subtil) entre l'edició del diagrama i l'edició del model. Com ja sabeu els diagrames són vistes del model. Per exemple, si creeu una classe editant el diagrama de classes, esteu realment editant ambdós, el diagrama i el model. Si canvieu el color o altres opcions de visualització d'una classe en el diagrama de classes, només esteu editant el diagrama, però no canvia res en el model.

### Inserció d'elements

Una de les primeres coses que heu de fer en editar un nou diagrama és inserir elements (classes, actors, casos d'ús, &etc;). Hi ha bàsicament dos maneres de per això:

- Arrossegar i deixar anar elements en el model des de la vista d'arbre

- Crear nous elements en el model i afegir-los al diagrama alhora, usant una de les eines d'edició de la barra d'eines de treball

Per inserir elements que ja existeixen en el model, simplement arrossegue-los de la vista d'arbre i deixeu-los anar on vulgueu en el diagrama. Sempre podeu moure elements en el diagrama usant l'eina de selecció

La segona manera d'afegir elements als diagrames és usant les eines d'edició de la barra d'eines de treball (noteu que això també afegeix els elements al model).

La barra d'eines de treball era ubicada per omissió a la part més a la dreta de la finestra de l'aplicació. &umbrello; 1.2 ha mogut això a la part superior de la finestra. Podeu acoblar-la en una altra vora o tenir-la flotant si ho preferiu. Les eines disponibles en aquesta barra d'eines (els botons que podeu veure) canvien depenent del tipus de diagrama en el que esteu treballant actualment. El botó per l'eina actual està activat en la barra d'eines. Podeu canviar a l'eina de selecció prement la tecla &Esc;.

Quan hageu seleccionat una eina d'edició des de la barra d'eines de treball (per exemple, l'eina per inserir classes) el punter del ratolí canvia a una creu, i podeu inserir elements en el model amb un clic simple en el diagrama. Noteu que els elements en &UML; han de tenir un nom únic. Per tant, si teniu una classe en una altre diagrama el nom de la qual és «ClasseA» i useu l'eina d'inserir classes en una altre diagrama no podeu usar aquest nom «ClasseA» per a la nova classe. Si se suposa que aquests són dos elements diferents, heu de donar-lis un nom únic. Si esteu intentant afegir el mateix element al diagrama, l'eina Insereix classe no és la correcta per a això. Enlloc d'això heu d'arrossegar i deixar anar la classe des de la vista d'arbre.

### Esborrar elements

Podeu esborrar qualsevol element seleccionant l'opció Esborra del seu menú contextual.

De nou, hi ha una gran diferència entre esborrar un objecte d'un diagrama, i esborrar un objecte del model: si esborreu un objecte des d'un diagrama, només esteu eliminant l'objecte per aquest diagrama en particular: l'element encara serà part del model i si hi ha altres diagrames usant el mateix element no patiran cap canvi. Si d'altra banda, esborreu l'element de la vista d'arbre, l'esteu esborrant realment del model. Com que l'element ja no existeix en el model, serà eliminat automàticament de tots els diagrames en els que aparegui.

### Edició dels elements

Podeu editar la majoria dels elements &UML; en el model i els diagrames obrint el seu diàleg de propietats i seleccionant l'opció apropiada. Per editar les propietats d'un objecte, seleccioneu Propietats del seu menú contextual (clic &BDR;). Cada element té un diàleg que consisteix en diverses pàgines on podeu configurar les opcions corresponents a aquest element. Per alguns elements, com ara els actors, només podeu establir un conjunt d'opcions, com ara el nom de l'objecte i la documentació, mentre que per altres elements, com ara les classes, podeu editar els atributs i les operacions, seleccioneu que voleu que es mostri en el diagrama (tota la signatura de l'operació o només els noms de les operacions, etc) i també els colors que voleu usar per la línia i el farciment de la representació de la classe en el diagrama.

Per la majoria dels elements &UML; també podeu obrir el diàleg de propietat fent-hi doble clic si esteu usant l'eina de selecció (la fletxa). L'excepció a això és Associacions, que en cas de fer-hi doble clic es crea un punt d'àncora. Per les associacions necessiteu usar el menú contextual del &BDR; per obtenir el diàleg de propietats.

Noteu que també podeu seleccionar l'opció propietats des del menú contextual dels elements en la vista d'arbre. Això us permet també editar les propietats dels diagrames, coma ara establir si s'ha de mostrar la graella o no.

### Edició de les classes

Tot i que l'edició de les propietats de tots els objectes ja s'ha tractat en la secció anterior, reservem una secció especial a les classes perquè són una mica més complicades i tenen més opcions que la majoria dels altres elements &UML;.

En el diàleg de propietats d'una classes podeu establir-ho tot, des del color que usa a les operacions i atributs que té.

#### Arranjament general de la classe

La pàgina d'opcions generals del diàleg de propietats s'explica per si mateixa. Aquí podeu canviar el nom de la classe, la visibilitat, la documentació, &etc;. Aquesta pàgina sempre està disponible.

#### Arranjament dels atributs de la classe

En la pàgina d'arranjament dels atributs podeu afegir, editar o esborrar atributs (variables) de la classe. Podeu desplaçar els atributs amunt i avall de la llista prement els botons de fletxa del costat. Aquesta pàgina sempre està disponible.

#### Arranjament de les operacions de la classe

De manera similar a la pàgina d'arranjament d'atributs, en la pàgina d'operacions podeu afegir, edit o eliminar operacions per a la classe. En afegir o editar una operació, introduïu les dades en el diàleg Propietats de l'operació. Si voleu afegir paràmetres a l'operació heu de clicar el botó Paràmetre nou..., que mostrarà el diàleg Propietats del paràmetre. Aquesta pàgina sempre està disponible

#### Arranjament de les plantilles de la classe

Aquesta pàgina us permet afegir plantilles de classe que són les classes no especificades o tipus de dades. En Java 1.5 s'anomenen genèriques.

#### Pàgina de les associacions de la classe

La pàgina Associacions de la classe mostra totes les associacions de aquesta classe en el diagrama actual. Fent doble clic en una associació es mostren les seves propietats, i depenent del tipus de l'associació podeu modificar alguns paràmetres com ara establir la multiplicitat i el nom del rol. Si l'associació no permet que es modifiquin aquestes opcions, el diàleg de propietats de l'associació és de només lectura i només podeu modificar la documentació associada amb aquesta associació.

Aquesta pàgina només està disponible si obriu les propietats de la classes des d'un diagrama. Si seleccioneu les propietats de la classe des del menú contextual de la vista d'arbre, aquesta pàgina no està disponible.

#### Pàgina de visualització de la classe

En la pàgina Opcions de visualització, podeu establir que és el que es mostrarà en el diagrama. Una classe pot ser mostrada com a només un rectangle amb el nom de la classe (útil si teniu moltes classes en el diagrama, o de moment no esteu interessat en els detalls de cada classe) o com a una visualització completa mostrant els paquets, estereotips, i atributs i operacions amb signatura i visibilitat completes

Depenent de la quantitat d'informació que voleu veure podeu seleccionar les opcions corresponents en aquesta pàgina. Els canvis que feu aquí només són opcions de visualització pel diagrama. Això significa que «ocultar» les operacions d'una classe només fa que no es mostrin en el diagrama, però l'operació encara és part del model. Aquesta opció només està disponible si seleccioneu les propietats de la classe des del diagrama. Si obriu les propietats de la classe des de la vista d'arbre aquesta pàgina no hi és ja que aquestes opcions de visualització no tenen sentit en aquest cas

#### Pàgina dels colors de la classe

En la pàgina Color de l'estri podeu configurar els colors que voleu per la línia i el farciment de l'estri. Aquesta opció òbviament només té sentit per les classes mostrades en el diagrames, i no hi és si obriu el diàleg de propietats de la classe des de la vista d'arbre.

### Associacions

Les associacions relacionen dos objectes &UML; l'un a l'altre. Normalment les associacions es defineixen entre dos classes, però també poden existir alguns tipus d'associacions entre casos d'ús i actors.

Per crear una associació seleccioneu l'eina apropiada de la barra d'eines de treball (associació genèrica, generalització, agregació, &etc;) i cliqueu en el primer element que participa de l'associació i després cliqueu en el segon element que participa. Noteu que aquests dos clics, un en cada un dels objectes que participen de l'associació, no és arrossegar un objecte i deixar-lo anar en l'altre.

Si intenteu usar una associació d'una manera contrària a l'especificació &UML; &umbrello; rebutjarà crear l'associació i obtindreu un missatge d'error. Aquest és el cas, si per exemple, existeix una generalització des de la classe A a la classe b I intenteu crear una altra generalització des de la classe B a la classe A

Clicant amb el botó Dret en una associació es mostrarà un menú de context amb les accions que hi podeu aplicar. Si necessiteu esborrar una associació simplement seleccioneu l'opció Esborra del seu menú contextual. També podeu seleccionar l'opció Propietats i, depenent del tipus d'associació, editar els atribut com ara els rols i les multiplicitats.

#### Punts d'ancoratge

Les associacions es dibuixen, per omissió, com una línia fina que connecta els dos objectes en el diagrama.

Podeu afegir punts d'ancoratge per doblegar una associació dobleclicant en algun punt de la línia de l'associació. Això inserirà un punt d'ancoratge (mostrat com un punt blau quan se selecciona la línia de l'associació) que podeu moure per donar forma a l'associació

Si necessiteu eliminar un punt d'ancoratge, doblecliqueu-lo de nou per esborrar-lo

Noteu que la única manera d'editar les propietats d'una associació és a través del menú contextual. Si intenteu dobleclicar-la com amb els altres objectes &UML;, això només inserirà un punt d'ancoratge.

### Notes, text i caixes

Les notes, les línies de text i les caixes són elements que poden estar presents en qualsevol tipus de diagrama amb no tenen un valor semàntic real, però són molt útils per afegir comentaris extra o explicacions que poden fer el diagrama més fàcil d'entendre.

Per afegir una nota o una línia de text, seleccioneu l'eina corresponent de la barra d'eines de treball i cliqueu en el diagrama on voleu posar el comentari. Podeu editar el text obrint l'element a través del seu menú contextual o en el cas de les notes, també dobleclicant-les.

#### Àncores

Les àncores s'usen per enllaçar una nota de text i un altre element &UML;. Per exemple, normalment s'usa una nota de text per explicar o fer algun comentari quant a una classe o una associació en particular, en aquest cas useu l'àncora per deixar clar que la nota «pertany» a aquest element en particular.

Per afegir una àncora entre una nota i un altre element &UML;, useu l'eina àncora de la barra d'eines de treball. Primer heu de clicar en la nota i després en l'element &UML; que voleu enllaçar a la nota.