Dette kapitel giver en introduktion til &umbrello;s brugergrænseflade og fortæller dig alt du skal vide for at begynde med modellering. Alle handlinger i &umbrello; er tilgængelige via menuer og værktøjslinjer, men &umbrello; bruger også i stor udstrækning sammenhængsafhængige menuer som vises med højre museknap. Du kan højreklikke på næsten alle steder i &umbrello;s arbejdsområde eller i trævisningen for at få en menu med de mest nyttige funktioner som kan tilpasses til netop det særlige punkt som du arbejder med. Visse brugere synes at dette er lidt forvirrende i begyndelsen (fordi de er mere vant til at arbejde med menuer eller værktøjslinjer), men når man vænnet sig at højreklikke, gør det dit arbejde en hel del hurtigere. &umbrello;s hovedvindue er opdelt i tre områder som hjælper til at få et overblik over hele systemet og at komme til de forskellige diagrammer hurtigt, under arbejdet med modellen. Disse områder kaldes: Trævisning Arbejdsvisning Dokumentationsvindue &umbrello;s brugergrænseflade &umbrello;s brugergrænseflade &umbrello;s brugergrænseflade Trævisningen er sædvanligvis placeret længst op til venstre i vinduet, og viser alle diagrammer, klasser, aktører og brugstilfælde som opbygger modellen. Trævisningen lader dig få et hurtig overblik over elementerne som modellen består af. Trævisningen giver også en hurtig måde at skifte mellem de forskellige diagrammer i modellen, og at indsætte elementer fra modellen i det nuværende diagram. Hvis du arbejder med en model som har mere end et fåtal klasser og diagrammer, kan trævisningen hjælpe dig med at klare det hele ved at organisere modellen i mapper. Du kan oprette mapper ved at vælge passende punkter i den sammenhængsafhængige menu (højreklik på en af mapperne i trævisningen) og du kan organisere elementer ved at flytte dem til passende mapper (træk og slip). Dokumentationsvinduet er det lille vindue placeret længst nede til venstre i &umbrello;, som giver en hurtig forhåndsvisning af dokumentationen for objektet som for øjeblikket er markeret. Dokumentationsvinduet er ganske lille, eftersom det er beregnet til at give et hurtigt uddrag fra elementets dokumentation, mens det optager så lidt plads som muligt på skærmen. Hvis du behøver at kigge på dokumentationen i mere detalje, kan du altid åbne punktets egenskaber. Arbejdsvisningen er hovedvinduet i &umbrello;, og er stedet hvor alle virkelige handlinger sker. Man bruger arbejdsvisningen til at redigere og vise diagrammer i en model. Arbejdsvisningen viser diagrammet som for øjeblikket er aktivt. For øjeblikket kan kun et diagram af gangen vises i arbejdsvisningen. Det første du behøver at gøre, for at begynde at gøre noget nyttigt med &umbrello;, er at oprette en model at arbejde med. Når du starter &umbrello; indlæser den altid den senest brugte model, eller laver en ny, tom, model (afhængig af hvordan du indstiller i indstillingsdialogen). Det gør det muligt at begynde at arbejde direkte. Hvis du på noget tidspunkt behøver at oprette en ny mode, kan du gøre det ved at vælge punktet Ny i menuen Fil, eller ved at klikke på ikonen Ny i programværktøjslinjen. Hvis du for øjeblikket arbejder med en model som er ændret, spørger &umbrello; om dine ændringer skal gemmes, inden den nye modellen indlæses. Du kan gemme modellen når som helst, ved at vælge punktet Gem i menuen Fil, eller ved at klikke på knappen Gem i programværktøjslinjen. Hvis du behøver at gemme modellen under et andet navn, kan du bruge punktet Gem som i menuen Fil. Af bekvemmelighedsgrunde, tilbyder &umbrello; også muligheden for at gemme arbejdet automatisk efter en vis tidsperiode. Du kan indstille om du vil aktivere denne funktion, samt tidsintervallet, i &umbrello;s Opsætning. Du kan vælge punktet Åbn i menuen Fil for at indlæse en eksisterende model, eller klikke på ikonen Åbn i programværktøjslinjen. De senest brugte modeller er også tilgængelige i undermenuen Åbn nyeste i menuen Fil, for at gøre adgangen til de oftest bruge modeller hurtigere. &umbrello; kan kun arbejde med en model af gangen, så hvis du beder programmet indlæse en model for dig, og den nuværende model er ændret siden du sidst gemte den, spørger &umbrello; om ændringerne skal gemmes for at forhindre at arbejdet går tabt. Du kan starte to eller flere udgaver af &umbrello; på et vilkårligt tidspunkt, du kan også kopiere og indsætte mellem udgaver. I &umbrello; findes der to grundlæggende måder at redigere elementer i modellen. Redigér modelelement direkte via trævisningen Redigér modelelement direkte via et diagram Ved brug af den sammenhængsafhængige menu i trævisningen, kan du tilføje, fjerne, og ændre næsten alle elementer i modellen. Højreklik på mapperne i trævisningen for at vise valgmulighederne for at oprette forskellige slags diagrammer, samt - afhængig af om mappen er en Brugstilfældevisning eller en Logisk visning - aktører, brugstilfælde, klasser osv. Når du har tilføjet elementer til modellen, kan du også redigere dem ved brug af deres egenskabsdialoger, som du finder ved at vælge punktet Egenskaber i den sammenhængsafhængige menu som vises ved et højreklik på elementerne i trævisningen. Du kan også redigere modellen ved at oprette eller ændre elementer via diagrammer. Mere information om hvordan dette gøres, får du i følgende afsnit. ¨-modellen består af et sæt ¨-elementer og sammenhænge mellem dem. Man kan dog ikke se modellen direkte, men man bruger Diagrammer til at kigge på den. For at oprette et nyt diagram i modellen, vælges helt enkelt diagramtypen du behøver i undermenuen Ny fra menuen Diagram, og den gives et navn. Diagrammet oprettes, og gøres aktivt, og du ser det med det samme i trævisningen. Husk at &umbrello; i stor udstrækning bruger sammenhængsafhængige menuer: du kan også højreklikke på en mappe i trævisningen, og vælge en passende diagramtype i undermenuen Ny fra den sammenhængsafhængige menu. Bemærk at du kun kan oprette brugstilfældediagrammer i brugstilfældemapper, og at de øvrige typer diagrammer kun kan oprettes i mapper for logiske visninger. Skulle du behøve at fjerne et diagram fra modellen, kan du gøre det ved at gøre det aktivt og vælge Fjern i menuen Diagram. Du kan også opnå dette ved at vælge Slet i den sammenhængsafhængige menu for diagrammet i trævisningen. Eftersom at fjerne et diagram er noget alvorligt, som kunne forårsage at arbejde går tabt, hvis det gøres ved en fejl, beder &umbrello; om at du bekræfter en sletningshandling inden diagrammet virkelig fjernes. Så snart et diagram er taget bort, og filen er gemt, er der ingen måde at fortryde handlingen. Hvis du vil skifte navn på et eksisterende diagram, kan du let gøre det ved at vælge punktet Omdøb i den sammenhængsafhængige menu i trævisningen. En anden måde at omdøbe et diagram er via dets egenskabsdialog, som du opnår ved at vælge Egenskaber fra den sammenhængsafhængige menu, eller ved at dobbeltklikke på det i trævisningen. Mens du arbejder med et diagram, forsøger &umbrello; at lede dig rette ved at bruge nogle enkle regler om hvilke elementer er gyldige i forskellige slags diagrammer, samt hvilke forhold som kan eksistere mellem dem. Hvis du er ekspert på ¨, kommer du formodentlig ikke til endog bemærke dette, men det er til hjælp for nybegyndere for at oprette diagram som følger standarden. Så snart du har oprettet diagrammerne er det tiden at begynde redigere dem. Bemærk her (den for nybegyndere subtile) forskel mellem at redigere et diagram, og at redigere modellen. Som du allerede ved til, er diagrammer visninger af modellen. Hvis du for eksempel laver en klasse ved at redigere et klassediagram, redigerer du i virkeligheden både diagrammet og modellen. Hvis du ændrer farve eller andre visningspunkter for en klasse i klassediagrammet, redigerer du kun diagrammet, men ingenting ændres i modellen. En af de første ting du gør når du redigerer et nyt diagram, er at indsætte elementer i det (klasser, aktører, brugstilfælde, osv.). Der er to grundlæggende måder at gøre dette: Træk eksisterede elementer til modellen fra trævisningen Opret nye elementer i modellen, og tilføj dem til diagrammet samtidigt, ved at bruge et af redigeringsværktøjerne i arbejdsværktøjslinjen. For at indsætte elementer som allerede findes i modellen, trækkes de blot fra trævisningen og slippes der hvor du ønsker at de skal være i diagrammet. Du kan altid flytte element rundt i diagrammet med markeringsværktøjet. Den anden måde at tilføje elementer til diagrammet er at bruge arbejdsværktøjslinjens redigeringsværktøj (observér at dette også tilføjer elementerne til modellen). Arbejdsværktøjslinjen var normalt placeret længst til højre for programvinduet, men &umbrello; 1.2 har flyttet den længst op i vinduet. Du kan dokke den på den anden side, eller lade den flyde omkring hvis du foretrækker det. Værktøjerne som er tilgængelige på denne værktøjslinjen (knapperne du ser på den) ændres afhængig af hvilket diagram du arbejder med for øjeblikket. Knappen for værktøjet som er valgt lige nu er aktiveret i værktøjslinjen. Du kan skifte til markeringsværktøjet ved at trykke på Esc-tasten. Når du har valgt et redigeringsværktøj i arbejdsværktøjslinjen (for eksempel værktøjet til at indsætte klasser), ændres musemarkøren til et kryds, og du kan indsætte elementer i modellen ved at enkeltklikke i diagrammet. Bemærk at element i ¨ skal have et entydigt navn. Så hvis du har en klasse i et diagram som hedder KlassA, og senere bruger værktøjet til at indsætte en klasse i et andet diagram, kan du ikke også give den nye klassen navnet KlassA. Hvis det er meningen at de to skal være forskellige elementer, skal du give dem entydige navne. Hvis du forsøger at tilføje samme element til diagrammet, er værktøjet for at indsætte klasser ikke det rette værktøj til dette. Du skal i stedet trække og slippe klassen fra trævisningen. Du kan slette et hvilket som helst element, ved at vælge punktet Slet i dets sammenhængsafhængige menu. Igen det er stor forskel mellem at fjerne et objekt fra diagrammet, og at fjerne et objekt fra modellen. Hvis du fjerner et objekt indefra et diagram, tager du det kun væk fra dette diagram: elementet er stadigvæk en del af modellen og hvis der er andre diagrammer som bruger samme element, vil de ikke lide nogen ændring. På den anden side, hvis du fjerner elementet i trævisningen, tager du i virkeligheden elementet væk fra modellen. Eftersom elementet ikke længere eksisterer i modellen, tages det også automatisk væk fra alle diagrammer det vises i. Du kan redigere de fleste ¨-elementer i model og diagrammer ved at åbne dets egenskabsdialog og vælge passende punkter. For at redigere egenskaberne for et objekt, vælges Egenskaber i dets sammenhængsafhængige menu (højreklik). Hvert element har en dialog som består af flere sider hvor du kan indstille valgmulighederne som har med dette element at gøre. For visse elementer, såsom aktører, kan du kun angive et fåtal muligheder, såsom objektnavn og dokumentation, mens for andre elementer, såsom klasser, kan du redigere dets attribut og operationer, vælge hvad du vil vise i diagrammet (hel operationsunderskriften eller kun operationsnavn, osv.) og til og med farverne du vil bruge for linjer og udfyldningen af klassens repræsentation i et diagram. For de fleste ¨-elementer kan du også åbne egenskabsdialogen ved at dobbeltklikke på det, hvis du bruger markeringsværktøjet (pilen). En undtagelse fra dette er associationer, hvor et dobbeltklik laver et ankerpunkt. For associationer skal du bruge den sammenhængsafhængige menu som vises med højreklik, til at få egenskabsdialogen frem. Bemærk at du også kan vælge punktet egenskaber i den sammenhængsafhængige menu for elementer i trævisningen. Dette lader dig også redigere egenskaber for diagrammer, såsom at indstille om gitteret skal vises eller ej. Selv om redigering af egenskaber for alle objekter allerede er afdækket i foregående afsnit, fortjener klasser et særligt afsnit, eftersom de er noget mere komplicerede, og har flere valgmuligheder end de fleste andre ¨-elementer. I klassens egenskabsdialog kan du indstille alting, fra farven den bruger til operationerne og attributten den har. Siden med generelle klasseindstillinger i egenskabsdialogen er selvforklarende. Her kan du ændre klassens navn, synlighed, dokumentation, osv. Denne side er altid tilgængelig. På siden for indstillinger af attribut, kan du tilføje, redigere eller fjerne attributter (variabler) for klassen. Du kan flytte attributter op og ned i listen ved at trykke på piletasterne langs kanten. Denne side er altid tilgængelig. På lignende måde som for indstillinger af klasseattribut, kan du tilføje, redigere eller fjerne operationer for klassen på siden for indstillinger af klasseoperationer. Når du tilføjer eller redigerer en klasseoperation, indskriver du de grundlæggende data i dialogen Operationsegenskaber. Hvis du vil tilføje parametre til operationerne, skal du klikke på knappen Ny parameter, som viser dialogen Parameteregenskaber. Denne side er altid tilgængelig. Denne side lader dig tilføje klasseskabeloner som er uspecificerede klasser eller datatyper. I Java 1.5 kommer de til at hedde Generics. Siden Klasseassociationer viser alle klassens associationer i det nuværende diagram. Et dobbeltklik på en association viser dens egenskaber, og afhængig af type af association, kan du ændre visse parametre her, såsom at indstille mangfoldighed og rollenavn. Hvis associationerne ikke tillader at sådanne punkter ændres, er dialogen for associationsegenskaber kun læsbar, og du kan kun ændre dokumentationen som hører sammen med associationen. Denne side er kun tilgængelig hvis du åbner klasseegenskaberne inde i et diagram. Hvis du vælger klasseegenskaber fra den sammenhængsafhængige menu i trævisningen, er denne side ikke tilgængelig. På siden Visningstilvalg, kan du indstille hvad der skal vises i diagrammet. En klasse kan vises som kun en rektangel med klassenavnet i (nyttigt hvis du har mange klasser i diagrammet, eller for øjeblikket ikke er interesseret i detaljerne for hver klasse), eller så fuldstændige at pakke, stereotyper, attributter og operationer vises med fuldstændig underskrift og synlighed. Afhængig af mængden af information som du vil se, kan du vælge tilsvarende tilvalg på denne side. Ændringarne du laver her gælder kun visningsvalgmulighederne for diagrammet. Det betyder at skjulen af klassens operationer kun gør at de ikke vises i diagrammet, men operationerne er fortsat der som en del af modellen. Dette er kun tilgængeligt hvis du vælger klasseegenskaberne inde i et diagram. Hvis du åbner klasseegenskaberne fra trævisningen, mangler denne side, eftersom sådanne visningsegenskaber ikke giver mening i dette tilfælde. På siden Komponentfarve kan du indstille farverne som du vil have for linjer og udfyldning af kontrollen. Dette giver naturligvis kun mening for klasser som vises i diagrammer, og mangler hvis du åbner klassens egenskabsdialog i trævisningen. Associationer relaterer to ¨-objekter til hinanden. Normalt defineres associationer mellem to klasser, men visse typer af associationer kan også findes mellem brugstilfælde og aktører. For at oprette en association, vælges passende værktøj i arbejdsværktøjslinjen (generel association, generalisering, aggregering, osv.), og enkeltklik på det første element som indgår i associationen. Enkeltklik derefter på det andet element som indgår. Bemærk at dette er to klik, et på hvert af elementerne som indgår i associationen. Det er ikke et træk fra et objekt til et andet. Hvis du forsøger bruge associationer på en måde som ikke tillades af ¨-specifikationen, nægter Umbrello at oprette associationen og du får en fejlmeddelelse. Dette vil indtræffe, hvis for eksempel en generalisering findes fra klasse A til klasse B, og du derefter forsøger at oprette en ny generalisering fra klasse B til klasse A. Et højreklik på en association viser en sammenhængsafhængig menu med handlinger som du kan anvende på den. Hvis du behøver at slette en association, vælges Fjern i den sammenhængsafhængige menu. Du kan også vælge Egenskaber, og afhængig af associationens type, redigere attributter såsom roller og mangfoldighed. Associationer tegnes, som standard, som en lige linje der forbinder de to objekter i diagrammet. Du kan tilføje ankerpunkter til at bøje en association ved at dobbeltklikke et sted langs associationslinjen. Dette indsætter et ankerpunkt (som vises som et blåt punkt hvor associationslinjen er markeret), som du kan flytte omkring for at give associationen sin form. Hvis du behøver fjerne en ankerpunkt, dobbeltklik på den igen for at fjerne den. Bemærk at den eneste måde at redigere en associationsegenskab er via den sammenhængsafhængige menu. Hvis du forsøger at dobbeltklikke på den som med andre ¨-objekter, indsættes blot et ankerpunkt. Noter, tekstlinjer og felter er elementer som kan findes i alle slags diagrammer, og har ingen virkelig semantisk værdi, men er meget hjælpsomme for at tilføje ekstra kommentarer eller forklaringer, som kan gøre diagrammet lettere at forstå. For at tilføje en note eller tekstlinje, vælges tilsvarende værktøj i arbejdsværktøjslinjen, og så enkeltklikkes på diagrammet hvor du vil placere kommentaren. Du kan redigere teksten ved at åbne elementet via dets sammenhængsafhængige menu, eller for noter, også ved at dobbeltklikke på dem. Ankre bruges for til at linke noter og et andet ¨-element sammen. Normalt bruger du for eksempel en note til at forklare eller give en kommentar om en klasse eller en vis association, og i så tilfælde kan du bruge ankeret til at gøre det klart at noten hører til netop dette element. Anvend ankerværktøjet i arbejdsværktøjslinjen, for at tilføje et anker mellem en note og et andet ¨-element. Først skal du klikke på noten, og derefter klikke på ¨-elementet som du vil at noten skal linkes til.