# Umbrello kasutamine

See peatükk tutvustab Umbrello kasutajaliidest ja selgitab kõike, mida vaja modelleerimise alustamiseks. Kõik Umbrello toimingud on kättesaadavad nii menüü kui tööriistaribade kaudu, lisaks pakub Umbrello laialdast kontekstimenüüde kasutamise võimalust. Klõpsates parema hiirenupuga ükskõik millisel Umbrello tööalal või puuvaates asuval elemendil avaneb kõiki selle elemendi kasulikke käske sisaldav menüü. Mõne kasutaja jaoks on see alguses pisut segadusttekitav, sest nad on harjunud kasutama rohkem menüüd või tööriistaribasid, kuid pärast parema hiireklõpsuga harjumist kiirendab see sinu tööd tublisti.

## Kasutajaliides

Umbrello põhiaken on jagatud kolmeks alaks, mis aitavad anda sulle mudeliga töötades ülevaate kogu süsteemist ja kiire juurdepääsu erinevatele skeemidele.

Neid alasid nimetatakse:

- puuvaade

- tööala

- dokumentatsiooniaken

Umbrello kasutajaliides Umbrello kasutajaliides

Umbrello kasutajaliides

### Puuvaade

Puuvaade asub põhiakna ülemises vasakus osas ja kuvab kõiki skeeme, klasse, tegijaid ja kasutusklasse, millest mudel koosneb. Puuvaade võimaldab saada kiire ülevaate mudelis sisalduvatest elementidest. Samuti võimaldab puuvaade lülituda kiirelt erinevate mudeli skeemide vahel ja lisada mudeli elemente skeemi.

Kui töötad mudeliga, mis sisaldab rohkem kui paari klassi ja skeemi, siis aitab puuvaate elementide kaustadesse jagamise võimalus sul asjade üle kontrolli hoida. Kaustu saab luua valides kontekstimenüüst sobiva käsu ja lohistades vajalikud elemendid õigetesse kaustadesse.

### Dokumentatsiooniaken

Dokumentatsiooniaken on pisike aken, mis asub Umbrello põhiakna alumises vasakus osas ja annab kiire ülevaate valitud elemendi dokumentatsioonist. Dokumentatsiooniaken on väike seepärast, et see on mõeldud elemendi dokumentatsioonile pilgu peale viskamiseks. Kui soovid näha elemendi dokumentatsiooni detailsemalt, siis ava elemendi omaduste dialoog.

### Tööala

Tööala on Umbrello akna põhiala, milles toimub põhiline tegevus. Tööala kasutatakse mudeli skeemide redigeerimiseks ja vaatamiseks. Tööala kuvab aktiivset skeemi. Korraga on tööalal võimalik kuvada vaid ühte skeemi.

## Mudelite loomine, laadimine ja salvestamine

Umbrelloga millegi kasuliku tegemiseks on esimese asjana vaja luua või avada mudel. Umbrello käivitamisel laaditakse viimati kasutatud mudel või luuakse uus tühi mudel (vastavalt seadistustedialoogis määratud eelistustele).

### Uus mudel

Kui soovid mingil hetkel luua uut mudelit, siis saad seda teha valides menüüst Fail käsu Uus või klõpsates tööriistaribal nuppu Uus. Kui töötad hetkel mudeliga, mida on muudetud, siis küsib Umbrello, kas sa soovid enne uue mudeli laadimist eelmise mudeli muudatusi salvestada.

### Mudeli salvestamine

Mudelit on võimalik igal hetkel salvestada valides menüüst Fail käsu Salvesta või klõpsates tööriistaribal nuppu Salvesta. Kui soovid salvestada mudelit mõne teise nimega, siis kasuta menüüs Fail asuvat käsku Salvesta kui...

Ohutuse tagamiseks võimaldab Umbrello salvestada tööd ka kindla ajaintervalli tagant. Kui soovid seda kasutada, siis saad seadista see Umbrello menüüs Seadistused.

### Mudeli laadimine

Olemasoleva mudeli laadimiseks võid valida menüüst Fail käsu Ava või klõpsata tööriistaribal nuppu Ava. Tihtikasutatavatele mudelitele juurdepääsu kiirendamiseks on hiljuti kasutatud mudelite nimekiri saadaval menüü Fail alammenüüs Ava hiljutine.

Umbrello võimaldab töötada korraga vaid ühe mudeliga, nii et kui käsid rakendusel avada järgmise mudeli ja juba avatud mudelit on pärast viimast salvestamist muudetud, siis küsib Umbrello, kas soovid tehtud muudatusi salvestada. Siiski saab alati käivitada kaks Umbrello protsessi ning nende vahel andmeid kopeerida ja asetada.

## Mudelite redigeerimine

Mudeli elementide redigeerimiseks Umbrellos on kaks põhimoodust.

- mudeli elementide redigeerimine puuvaate kaudu

- mudeli elementide redigeerimine skeemi kaudu

Puuvaates saab erinevate elementide kontekstimenüüga peaaegu kõiki mudeli elemente lisada, eemaldada ja muuta. Puuvaates kataloogidele hiire parema nupuga klõpsates näed valikuid, mis lubavad luua erinevat laadi skeeme ning sõltuvalt sellest, kas tegemist on kasutusklassivaate või loogilise vaatega, ka tegijaid, kasutusklasse, klasse jne.

Kui oled oma mudelisse elemente lisanud, saad neid redigeerida ka nende omaduste dialoogis, mille avamiseks klõpsa puuvaates elementidele hiire parema nupuga ja vali kontekstimenüüst Omadused.

Mudelit saab redigeerida ka elemente skeemidel luues või muutes. Sellest räägitakse lähemalt järgmistes osades.

## Skeemide lisamine ja eemaldamine

Sinu &UML; mudel koosneb reast &UML;i elementidest ja nendevahelistest sidemetest. Mudelit ei saa siiski otseselt näha, selle vaatamiseks tuleb kasutada skeeme.

### Skeemide loomine

Mudeli uue skeemi loomiseks vali lihtsalt vajalik skeemitüüp kirje Uus alt menüüs Skeem ja anna sellele nimi. Skeem luuakse ja muudetakse aktiivseks ning sa näed seda kohe puuvaates.

Pane tähele, et Umbrello kasutab ohtralt ka kontekstimenüü võimalusi: sa võid klõpsata &HPN;ga kataloogile puuvaates ja valida vajaliku skeemitüübi kontekstimenüü alammenüüst Uus. Arvesta sealjuures seda, et kasutusklassiskeeme saab luua ainult kasutusklassikataloogides, teisi skeemitüüpe aga ainult loogilise vaate kataloogides.

### Skeemide eemaldamine

Kui soovid mudelist skeemi eemaldada, muuda see aktiivseks ja vali käsk Kustuta menüüst Skeem. Sama tulemuse saavutab puuvaate skeemide kontekstimenüü käsuga Kustuta.

Et skeemi kustutamine on üsna ohtlik tegevus, mis võib kaasa tuua suure töö kaotsimineku, kui teed seda kuidagi kogemata, küsib Umbrello enne skeemi tegelikku eemaldamist sinu käest üle, kas oled oma otsuses kindel. Pärast seda, kui skeem on kustutatud ja fail uuesti salvestatud, ei saa kustutamist enam kuidagi tagasi võtta.

### Skeemide ümbernimetamine

Kui soovid olemasolevale skeemile teist nime anda, klõpsa puuvaates &HPN;ga ja vali kontekstimenüüst ümbernimetamiskäsk.

Teine viis skeemile uut nime anda käib omaduste dialoogi vahendusel, mille saab avada kontekstimenüüst käsku Omadused valides või puuvaates topeltklõpsu tehes.

## Skeemide redigeerimine

Skeemi kallal töötamise ajal üritab Umbrello sind aidata, rakendades mõningaid lihtsaid reegleid: millised elemendid sobivad millist tüüpi skeemi ja millist laadi seosed saavad nende vahel eksisteerida. Kui oled &UML;i asjatundja, ei pane sa seda tõenäoliselt tähelegi, kuid &UML;i maailma uustulnukatel aitavad need reeglid luua standardile vastavaid skeeme.

Kui oled skeemi loonud, on aeg asuda seda redigeerima. Kindlasti märkad (ehkki algajatele on see vähemärgatav) erinevust skeemi ja mudeli redigeerimise vahel. Nagu juba selgitatud, on skeem ainult sinu mudeli vaade. Kui näiteks lood klassiskeemi redigeerides klassi, muudad tegelikult nii skeemi kui ka mudelit. Kui aga muudad oma klassiskeemis klassi värvi või muid esitusvalikuid, siis muudad ainult skeemi, kuid mudelis ei muutu midagi.

### Elementide lisamine

Üks esimesi asju uut skeemi redigeerima asudes on neisse elementide (klassid, tegijad, kasutusklassid &etc;) lisamine. Seda saab teha kahel viisil:

- Lohistades olemasolevad elemendid puuvaatest oma mudelisse

- Luues uued elemendid mudelis ja lisades nad samal ajal skeemile mõnda diagrammiriba redigeerimistööriista kasutades

Mudelis juba eksisteerivate elementide lisamiseks lohista need lihtsalt puuvaatest sinna, kuhu soovid neid oma skeemis asetada. Valikutööriistaga saad alati liigutada oma skeemi elemente.

Teine skeemile elementide lisamise viis on diagrammiriba redigeerimistööriistade kasutamine (pane tähele, et see lisab ka elemendid sinu mudelisse).

Diagrammiriba asus varem vaikimisi rakenduse akna paremas servas, kuid Umbrello 1.2 viis selle akna ülaserva. Soovi korral võid selle muidugi paigutada ka igasse muusse akna serva või üldse lahti haakida. Ribal saadaolevad tööriistad (nupud) muutuvad sõltuvalt sellest, millist tüüpi skeemiga on tegemist. Parajasti valitud tööriista nupp on ribal aktiveeritud. Valikutööriistale saab alati naasta klahvile &Esc; vajutades.

Kui valid diagrammiribal tööriista (näiteks klassi lisamise tööriista), võtab hiirekursor risti kuju ning sa võid vastava elemendi lisada mudelisse skeemis klõpsates. Arvesta, et &UML;i elementidel peab olema unikaalne nimi. See tähendab, et kui sul on ühel skeemil klass nimega KlassA ja sa lisad seejärel klassi lisamise tööriistaga klassi mõnele teisele skeemile, ei saa selle nimeks olla samuti KlassA. Kui nad peavad olema erinevad elemendid, peab neil olema ka unikaalne nimi. Kui aga soovid skeemile lisada sama elemendi, ei ole klassi lisamise tööriist sugugi õige vahend. Selleks tuleks klass hoopis vajalikku kohta puuvaatest lohistada.

### Elementide kustutamine

Kõiki elemente saab kustutada kontekstimenüüst Kustuta valides.

Taas tasub märkida suurt erinevust objekti eemaldamise vahel skeemilt ja objekti kustutamise vahel mudelist: kui kustutad objekti skeemilt, eemaldad ainult objekti konkreetselt skeemilt, element ise aga on endiselt sinu mudeli osa ja kui seda elementi kasutab mõni muu skeem, ei mõjuta kustutamine neid kuidagi. Kui aga kustutad elemendi puuvaatest, siis kustutad selle ka oma mudelist. Et nüüd pole enam elementi mudelis olemas, eemaldatakse see automaatselt kõigilt skeemidelt, kus see varem oli.

### Elementide redigeerimine

Enamikku oma mudeli ja skeemide &UML; elemente saab redigeerida nende omaduste dialoogi avades ja seal vajalikke valikuid langetades. Objekti omaduste redigeerimiseks vali selle kontekstimenüüst (klõps &HPN;ga) Omadused. Igal elemendil on mitmest kaardist koosnev dialoog, kus antud elemendi valikuid rakendada või muuta. Mõne elemendi, näiteks tegija korral, on valikuid vaid paar tükki (objekti nimi ja dokumentatsioon), mõne elemendi, näiteks klassi korral, saab aga muuta selle atribuute ja operatsioone, määrata, mida skeemil näidata (tervet operatsiooni signatuuri või ainult operatsioonide nime jne.), ning panna paika isegi värvid, mida kasutada antud klassi joonte ja täidise esitamisel skeemil.

Enamiku &UML; elementide omaduste dialoogi saab avada ka neil topeltkõpsu tehes, kui kasutad valikutööriista (nool). Erandiks on sidemed, mille korral topeltklõps loob ankurpunkti. Sidemete korral tuleb klõpsata &HPN;ga ja avada omaduste dialoog kontekstimenüüst.

Pane tähele, et omaduste dialoogi saab avada ka elementide kontekstimenüüst puuvaates. See võimaldab redigeerida ka skeemide enda omadusi, näiteks seda, kas alusvõrku näidata või mitte.

### Klasside redigeerimine

Ehkki me juba kajastasime kõigi objektide omaduste redigeerimist, väärivad klassid omaette osa, sest nad on mõnevõrra keerukamad ja neil on rohkem valikuid kui ülejäänud &UML;i elementidel.

Klassi omaduste dialoogis saab määrata kõike alates selle värvidest kuni operatsioonide ja atribuutideni.

#### Klassi üldseadistused

Omaduste dialoogi üldseadistuste kaart ei vaja ilmselt selgitamist: siin saab muuta klassi nime, nähtavust, dokumentatsiooni &etc; See kaart on alati olemas.

#### Klassi atribuutide seadistused

Atribuutide kaardil saab lisada, redigeerida ja kustutada klassi atribuute (muutujaid). Atribuute saad nimekirjas üles- ja allapoole liigutada kasti kõrval paiknevaid noolenuppe kasutades. See kaart on alati olemas.

#### Klassi operatsioonide seadistused

Sarnaselt atribuutide kaardile saab operatsioonide kaardil lisada, redigeerida ja eemaldada oma klassi operatsioone. Operatsiooni lisades või muutes tuleb põhiandmed sisestada operatsiooni omaduste dialoogi. Kui soovid operatsioonile parameetreid lisada, tuleb klõpsata nupule Uus parameeter, mis avab parameetri omaduste dialoogi. See kaart on alati olemas.

#### Klassi mallide seadistused

Sellel kaardil saab lisada klassimalle, mis on määratlemata klassid või andmetüübid. Java 1.5 nimetab neid geneerikuteks.

#### Klassi sidemete seadistused

Kaardil Klassi sidemed näeb kõiki antud klassi sidemeid aktiivsel skeemil. Topeltklõps sidemel avab selle omaduste dialoogi ning sõltuvalt sideme tüübist saab seal muuta teatud parameetreid, näiteks määrata mitmesuse ja rolli nime. Kui side ei võimalda midagi muuta, on omaduste dialoog kirjutuskaitstud ning sa saad muuta ainult antud sidemega seotud dokumentatsiooni.

See kaart on saadaval ainult siis, kui avad klassi omaduste dialoogi skeemilt. Avades selle puuvaate kontekstimenüüst, ei ole kaarti näha.

#### Klassi kuvamise seadistused

Kaardil Kuvamise seadistused saab määrata, mida skeemil näidatakse. Klassi võib näidata ainult ühe nelinurgana, milles on klassi nimi (see on kasuks, kui sul on skeemil palju klasse või kui sind parajasti ei huvita klasside üksikasjad) või ka täielikult kujul koos pakettide, stereotüüpide ning atribuutide ja operatsioonide, operatsioonide signatuuride ja nähtavusega.

Langeta oma valikud sõltuvalt sellest, kui palju infot soovid skeemil näha. Siin tehtud muudatused mõjutavad ainult skeemi kuvamist. See tähendab, et klassi operatsioonide peitmine ei näita neid lihtsalt skeemil, kuid operatsioon ise kuulub endiselt mudeli koosseisu. See kaart on saadaval ainult siis, kui avad klassi omaduste dialoogi skeemilt. Avades selle puuvaate kontekstimenüüst, ei ole kaarti näha, sest seal ei ole kuvamise seadistustel mingit mõtet.

#### Klassi värvide seadistused

Kaardil Vidinate värvid saab määrata vidinate joonte ja täidise värvid. Enesestmõistetavalt on see kaart saadaval ainult skeemidel näidatavate klasside jaoks, mitte aga siis, kui valid klassi omaduste dialoogi puuvaatest.

### Sidemed

Side seob üksteisega kaks &UML;i objekti. Tavaliselt eksisteerib side kahe klassi vahel, kuid teatud tüüpi sidemed võivad olla ka kasutusklasside ja tegijate vahel.

Sideme loomiseks vali vajalik tööriist diagrammiribalt (tavaline side, üldistus, agregatsioon &etc;) ning klõpsa algul esimesel sidemes osaleval elemendil ja seejärel teisel. Pane tähele, et vaja on kaht klõpsu, üks ühel ja teine teisel sidemega ühendataval objektil, aga mitte lohistamist ühe objekti juurest teise juurde.

Kui üritad luua sideme, mis ei vasta &UML;i spetsifikatsioonile, keeldub Umbrello seda tegemast ja sa näed veateadet. Nii juhtub näiteks siis, kui klassist A on juba olemas üldistus klassini B ja sa proovid siis luua veel ühe üldistuse klassist B klassini A.

Hiire parema nupu klõpsuga sidemel ilmub kontekstimenüü, kust saab valida mitmesuguseid toiminguid. Kui soovid sideme kustutada, valigi kontekstimenüüst Kustuta. Samuti võib sealt valida Omadused ning sõltuvalt sideme tüübist võib seejärel olla võimalik redigeerida sideme atribuute, näiteks rolli ja mitmesust.

#### Ankurpunktid

Vaikimisi luuakse sidemed sirgjoonena, mis ühendab skeemil kaht objekti.

Sideme kuju muutmiseks tuleb sellel vajalikus kohas teha topeltklõps. Sellega lisatakse ankurpunkt (seda näidatakse sideme valimisel sinise punktina), mida liigutades saabki muuta sideme kuju.

Kui soovid ankurpunkti eemaldada, tee selle peal hiirega topeltklõps.

Pane tähele, et ainus viis sideme omadusi muuta käib läbi kontekstimenüü. Kui teed sellel topeltklõpsu, siis erinevalt teistest &UML;i objektidest lisab see vaid sidemel ankurpunkti.

### Märkused, tekstid ja kastid

Märkused, tekstid ja kastid on elemendid, mis võivad eksisteerida mis tahes tüüpi skeemil ja millel pole tegelikku semantilist väärtust, kuid millest on abi lisakommentaaride või selgituste pakkumiseks, mis muudab skeemid paremini arusaadavaks.

Märkuse või teksti lisamiseks vali diagrammiribalt vastav tööriist ja klõpsa skeemil kohas, kuhu soovid kommentaari lisada. Teksti saab redigeerida elementi kontekstimenüü abil avades või märkuste puhul ka neil topeltklõpsu tehes.

#### Ankrud

Ankruid kasutatakse märkuse ja &UML;i elemendi kokkusidumiseks. Tavaliselt tehakse märkus mõne klassi või sideme selgitamiseks või kommenteerimiseks ning sel juhul on väga kasulik lisada ankur, mis näitab, et see märkus kuulub just konkreetse elemendi juurde.

Ankru lisamiseks märkuse ja &UML;i elemendi vahele vali diagrammiribal ankrutööriist. Seejärel klõpsa kõigepealt märkusele ja seejärel &UML;i elemendile, millega soovid märkust ühendada.