ManualMagicDraw

IngenieroenInformtica.FacultaddeInformtica.Arquitecturadel Software.Prcticas.2006/2007.

Seminario de Magic DrawMiguelngelOrenesFernndez PedroLuisMateoNavarro

______________________________________________________________________ GuadeMagicDraw Pgina1

ndiceObjetivos...........................................................................................................................3 Consejosparaelusodeestagua......................................................................................4 Desarrollo..........................................................................................................................5 ElproyectodeMagicDraw..........................................................................................5 Crearunproyectonuevo...............................................................................................5 DiagramasUML................................................................................................................6 DiagramadeCasosdeUso...........................................................................................6 Elementosmsimportantesdeestetipodediagrama..............................................6 Pasosparallevaracabolarealizacindeldiagrama...............................................7 DiagramadeClases....................................................................................................10 Elementosmsimportantesdeestetipodediagrama............................................10 Pasosparallevaracabolarealizacindeldiagrama.............................................11 Modeloconceptual......................................................................................................13 Elementosmsimportantesdeestetipodediagrama............................................13 Pasosparallevaracabolarealizacindeldiagrama.............................................14 DiagramadeSecuencia...............................................................................................17 Elementosmsimportantesdeestetipodediagrama............................................17 Pasosparallevaracabolarealizacindeldiagrama.............................................19 DiagramadeColaboracin.........................................................................................25 Elementosmsimportantesdeestetipodediagrama............................................25 Pasosparallevaracabolarealizacindeldiagrama.............................................26 DiagramadeEstados..................................................................................................29 Elementosmsimportantesdeestetipodediagrama............................................29 Pasosparallevaracabolarealizacindeldiagrama.............................................31 DiagramadeActividades............................................................................................34 Elementosmsimportantesdeestetipodediagrama............................................34 Pasosparallevaracabolarealizacindeldiagrama.............................................35 GenerarCdigo...............................................................................................................36 GenerarInformes.............................................................................................................37 Referencias......................................................................................................................40


Objetivos

AprenderamanejarlosfundamentosdeMagicDraw,laherramientadesoporteal modeladoconUMLquevamosautilizarenprcticas. ComprenderlaestructuradeunmodeloUMLenMagicDraw CrearloselementosdelosmodelosydiagramasdeUML Estructurarloselementosanterioresatravsdepaquetes Generarcdigoautomticamenteapartirdelosmodelos


Consejos para el uso de esta guaEnestaguaseexplicaeldesarrollodelosdiferentesdiagramasUMLutilizandola herramientademodeladoMagicDraw. Paracadaunodelosdiferentestiposdediagramas,encontraremoslasiguiente informacin:

pasosinicialesparalacreacindeldiagrama elementosmsimportantesqueapareceneneldiagrama(cabesealarqueeneste apartadosolamentehemosincluidoloselementosmsimportantes,aunquela herramientaMagicDraw,enlamayoradelasocasiones,proporcionaunabanico msamplioparalarealizacindelosmismos) creacindeundiagramadeejemplo,enelqueseexplicanlospasosms importantes

Alfinaldelagua,encontraremosdosapartadosfinales,correspondientesconla generacindeinformesylageneracindecdigo.


DesarrolloElproyectodeMagicDrawTodalainformacindelproyectoseguardaenunnicofichero. Elnuevoproyectocreadoestarformadoporlossiguientespaquetes: Paquetededatosinicialmentevaco,queguardartodosloselementosdel modelo. Paquetedevisualizacindelasvistas(FileView)quecontendrloselementos creadosdurantelaimplementacindelcdigo.Bsicamentecontendrlos ficherosfuente. UMLStandardProfilecontienelosestereotiposquesonnecesariopara trabajarconMagicDraw,tiposdedatosprimitivos,ysusrestricciones,queson delestndardeUML,yloselementosdelmetamodelodeUML2.0.

ParautilizarMagicDrawYempezaratrabajarconlaherramienta,esnecesariocrearun proyectosobreelqueiremostrabajando.

CrearunproyectonuevoParacrearlo,seguiremoslossiguientespasos: 1. crearemosunacarpetaconelnombrequequeramos.staserlacarpeta contenedoradenuestroproyecto 2. conlaherramientayaabierta,haremosclicenlaopcinFile>NewProject. Laaplicacinprocederacrearunnuevoproyecto 3. unavezterminedecrearelproyecto,usaremoslaopcinFile>SaveProject As...paraguardarlo.Seleccionaremoslacarpetacontenedoraquehemoscreado enelpaso1,pondremosunnombrealproyectoypulsaremoselbotnde Save. Yatendremoscreadounproyectovacosobreelcualpodertrabajar.


DiagramasUMLDiagramadeCasosdeUsoParacrearunnuevodiagramadeestetipo,haremosclicconelbotnderechosobrela carpetaDatasituadaenelContainmentTree,yseleccionaremoslaopcinNew Diagram>UseCaseDiagram.

Elementosmsimportantesdeestetipodediagrama

ActorRepresentalosrolesquejueganlosusuariosenelsistema

CasodeUsoEspecificauncomportamientoenparticulardelsistema

AsociacinParticipacindeunactorenuncasodeuso

Generalizacin


Pasosparallevaracabolarealizacindeldiagrama1Aadirelementosaldiagrama Paraaadirunnuevoelementoaldiagramadebemoshacerclicderechosobrela carpetaDatadelrboldecontenidos(Containmenttree)yseleccionar"New Element>X",dondeXserelelementoquequeramoscrear(actor,casode uso,...).Leasiganaremosunnombrenico. Deestemodoseaadiralalistadelrboldecontenidoselnuevoelemento creado.

Elrestodeloselementosquecompondrneldiagramaloscrearemosdela mismaforma. Unavezcreadostodosloselementosqueparticiparneneldiagrama,los aadiremossimplementehaciendoclicconelbotnizquierdosobreellosy arrastrndoloshaciaelgriddeldiagrama. Comoyahabrsobservado,enlaparteinferiorizquierdadelavistadel diagramadecasosdeusoaparecenlossmbolosdelosdiferenteselementosque sepuedencrear.Serecomiendaquesecreendelamaneravistaanteriormente, yaquenosdarlaseguridaddetenersloloselementosnecesariosparanuestro diagrama. Alahoradeborrarunelementodeldiagramasedebesercauto,yaquesilo eliminasdelavistagrafica,nodesaparecedelmodelo,esdecir,loquitamosdel diagramaperonodeloselementosqueformanelproyecto.Paraeliminar cualquierelementodelproyectohabrquehacerclicderechosobredicho


elementoendelrboldecontenidos(Containmenttree)yselecionarlaopcin eliminar(delete). 2Establecerrelacionesentreloselementosdeldiagrama

Podemosobservarcomocuandoseleccionamosunelemento(enestecasoun actor)aparecenasuderechalossmbolosdelasposiblesrelacionesenlasque puedeparticipar,loquenosdarlafacilidaddenotenerqueirabuscarlasauna paletadeherramientas,yaqueconslohacerclicsobrelarelacin,podremos establecerlasimplementearrastrandoelpunterodelratnhaciaelelemento destino. EjemplodediagramadeCasosdeUso:


ParaguardareldiagramasimplementetendremosquehacerclicsobreelmenFile> Saveproject,yelnuevodiagramaquehemoscreadoquedarguardadoennuestro proyecto.


DiagramadeClasesParacrearunnuevodiagramadeestetipo,haremosclicconelbotnderechosobrela carpetaDatasituadaenelContainmentTree,yseleccionaremoslaopcinNew Diagram>ClassDiagram.


Clase

Enumeracin

Interfaz

Paquete

Generalizacin

Asociacin

Relacindeimplementacinconinterfaz


Pasosparallevaracabolarealizacindeldiagrama1Aadirelementosaldiagrama Crearemosloselementosdelamismaformaqueseexplicenelapartado anterior. Paraaadirunnuevoelementoaldiagramadebemoshacerclicderechosobrela carpetaDatadelrboldecontenidos(Containmenttree)yseleccionar"New Element>X",dondeXserelelementoquequeramoscrear(clase, interfaz,...).Leasiganaremosunnombrenico. Unavezcreadostodosloselementosqueparticiparneneldiagrama,los aadiremoshaciendoclicconelbotnizquierdosobreellosyarrastrndolos haciaelgriddeldiagrama. Yatendremoseldiagramapreparadoparaestablecertodaslasrelaciones necesarias. 2Establecerrelacionesentreloselementosdeldiagrama Unavezquetengamostodosloselementoscolocadoseneldiagrama, empezaremosaestablecerlasrelacionesentreellos.Paraello,seguiremosel mismomtodoexplicadoantes:hacerclicconelbotnizquierdosobreel elemento,seleccionarlarelacinquequeramosestableceryarrastrarelpuntero delratnhastaelelementodestinodelarelacin. 3Insertarmtodosyatributosalasclases Parainsertarnuevosmtodosaunaclase/interfaz,haremosclicconelbotn derechosobreelelementoobjetivoyseleccionaremosenelmencontextualla opcinInsertNewOperation.Introduciremoselnombrecorrespondientey aceptaremospulsandolateclaintro.Yatendremosaadidounnuevomtodo paraesaclaseointerfaz. Parainsertarnuevosatributosprocederemosdelamismaforma,aunquelo haremosseleccionandolaopcinInsertNewAtribute


Ejemplodediagramadeclases:


ModeloconceptualParacrearunnuevodiagramadeestetipo,haremosclicconelbotnderechosobrela carpetaDatasituadaenelContainmentTree,yseleccionaremoslaopcinNew Diagram>ClassDiagram(notarqueelmodeladoconceptualtambinconsisteenun diagramadeclases,perountantoespecial).


Clase

Asociacin

Notas


PasosparallevaracabolarealizacindeldiagramaLaformadellevaracabolarealizacindeestadiagramaessimilaraladeldiagramade clases,perocabeaadirlaformaenqueintroduciremoslascardinalidadesentrelas clasesquecomponennuestromodeladoconceptual. Unavezcreadastodaslasclases,comenzaremosacreartodaslasrelaciones. Paracrearrelaciones,alasqueposteriormenteaadiremoscardinalidades,usaremosel tipoderelacinsindireccin . Paraaadircardinalidadesalasasociaciones,haremosclicconelbotnderechodel ratonsobrelalineaquerepresentalaasociacin,aparecindonoselsiguientemen contextual:

Lasdosopcionesdeabajocorrespondenconlascardinalidadesaambosextremosdela relacin,queenesteejemplosetratandelasclasesVentayLineadeVenta.Si ahorasituamoselpunterodelratnsobrealgunadelasdosopciones,senosaparecer otromencontextualenelquepodremoselegirlacardinalidadquedeseemos.


Comopodemosobservar,enelmendelaizquierda,enlapartedeabajo,encontramos lascardinalidadesdisponibles. Paraseleccionarunadeellas,simplementeharemosclicconelbotnizquierdosobre unadelasopcionesdisponiblesyautomticamenteseaadiraldiagramaqueestamos creando,comosemuestraenlaimagenacontinuacin:

Elrestodelascardinalidadeslasintroduciremossiguiendolosmismospasos. ______________________________________________________________________ GuadeMagicDraw Pgina15

Porltimo,enestostiposdediagramasesmuycomnaadirnotasparaaclararlos conceptos. Paraello,simplementeaadiremosunanuevanotaaldiagramahaciendoclicsobreel botn yhaciendoclicdenuevoenlazonadeldiagramadondequeramos aadirla. Introduciremoseltextocorrespondienteportecladoyllevaremosacabolaasociacin delanotaconelelementoalqueserefiere.Haremosclicsobrelanotaqueacabamosde crear,ysenospresentarlasiguientesituacin:

Haremosclicsobreelbotnquenosaparecesituadoaladerechadelanotay arrastraremoshastaelelementoconelcualqueramosrelacionarla. Elresultadoeselsiguiente:


DiagramadeSecuenciaParacrearunnuevodiagramadeestetipo,haremosclicconelbotnderechosobrela carpetaDatasituadaenelContainmentTree,yseleccionaremoslaopcinNew Diagram>SequenceDiagram. Unavezcreadoaparecercomopartedelcasodeuso,ylonicoquetenemosquehacer escambiarleelnombre:


Lineadevidadeunobjeto

Mensaje

Automensaje

MensajeRecursivo


MensajeDiagonal


PasosparallevaracabolarealizacindeldiagramaUnavezcreadoeldiagramadesecuenciaparaelcasodeusoRealizarVenta,debemos decrearlaclaseSistema.ParaellohacemosclicderechosobrelacarpetaDatadel ContainmenttreeyseleccionamosNewElement>Class. Unavezcreadalaclase,procedemosaintroducirelactorCajeroylaclaseSistemaen eldiagramadesecuenciacreado.Paraellolosarrastraremosconelratn:

Comosepuedeobservarenlaparteizquierdadelavistadeldiagramadesecuencia, aparecenloselementosparaestetipodediagrama. Ahoraproseguimosintroduciendolosmensajes.Paraelloseleccionamoselelemento Message:


YhacemosclicsobrelalneadetiempodelCajeroyseguidamentesobrelaclase sistema.

Podemosobservarquehemoscreadounnuevomensajeentrelosdoselementosque acabbamosdeintroducir. Unavezechoesto,haremosclicderechosobreelnuevomensajecreadoy seleccionamosSpecification:

Ynosaparecerlasiguienteventana,dondeaparecentodaslaspropiedades relacionadasconelmensajequeacabamosdecrear:


Tendremosquerealizarlossiguientepasos: ElcampoMessageTypecontendreltipo"SendMessage". EnelcampoName,introduciremoselnombredelmensajecorrespondiente,en nuestrocasointroducirItem. PulsarCloseparaconfirmarloscambios. Comosepuedeobservar,elmensajeaparecerahoraconnombre:

Enelcasodequealmensajecreadoqueramosaadirleparmetros,debemoshacerlo siguiente: 1 Volvemosaabrirlaespecificacin(clicderechoyseleccionamos Specification). 2 SeleccionamoslaopcinArgumentsqueapareceenlaparteizquierdadela ventana. 3 PulsarCreate


4 Enelmenquesedespliega,seleccionamoslaopcinquequeramos.,en nuestrocasoelegiremosElementValue,yaquequeremospasarledos enteroscomoparmetros.Eltipotendremosquebuscarloentrelos predefinidosporUML.

5 BuscamoslaclaseintenlaventanaqueapareceyhacemosclicsobreOK:

Repetiremoselprocesoparaaadirotroparmetroentero.


Laventanadeargumentosquedardelasiguientemanera:

SeleccionamosCloseparaconfirmarloscambiosynosquedarelsiguiente diagramadesecuencias:


Ahorasolamentenosquedarcrearotrosdosmensajes(terminarVenta()y realizarPago())deigualformaqueacabamosdecrearestemensaje, quedndonoseldiagramacomosemuestraenlasiguienteimagen:


DiagramadeColaboracinParacrearunnuevodiagramadeestetipo,haremosclicconelbotnderechosobrela carpetaDatasituadaenelContainmentTree,yseleccionaremoslaopcinNew Diagram>CommunicationDiagram.


Objetoparticipante

Conector

Autoconector

Mensajealaderecha

Mensajealaizquierda

Mensajedellamadaaladerecha

Mensajedellamadaalaizquierda


PasosparallevaracabolarealizacindeldiagramaParailustrarcomosecreanestetipodediagramas,vamosrealizareldiagramade colaboracindelaoperacindelsistemaIntroducirItem. Seguiremoslossiguientespasos:

Seaadenlasclasesnecesarias(quefueroncreadasyaconeldiagramadeclases)y elactor(creadoalhacereldiagramadecasosdeuso)aldiagramaarrastrndolos desdeelContainmentTree.SinoestncreadascreamoslasclasesTPV,Venta, LineaVenta,CatalogoProductoyproducto;yelactorcajero. Ahorapasamosacrearlosmensajes.Paraelloprimeroesnecesariocrearun conectorentrelosdoselementosquesecomunican,queloharemoshaciendoclic sobreelicono queapareceenlaventanadeldiagramadecolaboracin. HaremosclicsobreelactorCajeroyarrastraremoshastalaclaseTPV,porloqueya quedarnconectados,comosemuestraenlaimagen:

Unavezconectados,aadiremosunnuevomensajehaciendoclicsobreelicono yposteriormentehaciendoclicsobreelconectorqueacabamosdecrear,conelfin deasociarelmensajequenosdisponemosacrearconelconectorquecreamos anteriormente.Elresultadoeselsiguiente:


Introducimoselnombrecorrespondientealmensaje,yparaaadirleargumentoslo haremosdelmismomodoquelohicimosparaeldiagramadesecuencias. Trasaadirleunnombreyloscorrespondientesargumentosalmensaje,su especificacinquedaradelasiguientemanera:


AceptaremosloscambioshaciendoclicsobreelbotnClose,siendoelresultadoel siguiente:

Dondepodemosapreciardoselementos: elconectorqueasociaaCajeroyaTPV elmensajequerepresentalacomunicacinentreellos Ahora,continuaremosintroduciendoelrestodeconectoresymensajesdelmismomodo queacabamosdeexplicar,siendoelresultadoelsiguiente:


DiagramadeEstadosParacrearunnuevodiagramadeestetipo,haremosclicconelbotnderechosobrela carpetaDatasituadaenelContainmentTree,yseleccionaremoslaopcinNew Diagram>StateDiagram.


Estado

Estadocompuesto

Estadoortogonal

EstadoInicial

Estadofinal

Puntodeentrada

Puntodesalida

Transicindeestado ______________________________________________________________________ GuadeMagicDraw Pgina29

Autotransicin

Unin/divisindetransiciones


PasosparallevaracabolarealizacindeldiagramaComenzaremosintroduciendolosestadosinicialyfinal,quesiempredebendeestar presentesenundiagramadeestado(tambinenlosestadoscompuestos).Paraello, primeroharemosclicenlosiconoscorrespondientesyluegocliceneldiagrama,enla posicinenlaquequeramosinsertarlos. Paraaadirlesunnombrequelosidentifique,haremosdobleclicsobreellos,conloque nosaparecerlasiguienteventana:

Introduciremoselnombrequequeramosenelcamponameyconfirmaremoslos cambioshaciendoclicsobreelbotnClose.Elnombreseaadiraldiagramade formaautomtica.


Elrestodeloselementoslosintroduciremosdelamismaforma. Cabedestacaruntipodeelementoespecial,quesonlosestadoscompuestos.Los estadoscompuestospodramosconsiderarloscomosubdiagramasdeestadoquese incluyenenunStateChart. Paracrearunestadocompuesto(enelejemploseincluyeuno),simplementelo crearemoscomounelementonormaldeldiagrama,sloquedentrodeestepodremos insertarnuevoselementos,comoporejemploestados,flujos,agregacionesdeflujos,... Todoestadocompuestoposeeunoomsestadosinicialesyunoomsestadosfinales;y serelacionarconotroselementosdeldiagramacomosideunelementobsicose tratara.

Unavezhayamosincluidoynombradotodosloselementosqueformarnpartedel diagramadeestado,tendremosqueincluirtodaslasrelaciones,querepresentarnel posiblecambiodeunestadoaotro. Paraello,seguiremoselmismoprocesoquehemosseguidohastaelmomento: 1. haremosclicizquierdosobreelelementoorigendelflujo 2. cuandoaparezcaeliconodelaasociacinasuderecha,haremosclicsobrely loarrastraremoshaciaelelementoqueserelextremofinaldelamisma.


Repetiremoselprocesoparacadaunadelasasociacionesquequeramosestablecer, siendoelresultadoelsiguiente:


DiagramadeActividadesParacrearunnuevodiagramadeestetipo,haremosclicconelbotnderechosobrela carpetaDatasituadaenelContainmentTree,yseleccionaremoslaopcinNew Diagram>ActivityDiagram.


Accin

Llamada

Objeto

Flujodecontrol

Nodoinicial

Nodofinal

Nododecisin

Unin/divisindeflujodecontrol


PasosparallevaracabolarealizacindeldiagramaLacreacindeldiagramadeactividadesesdirectaapartirdelabarradeherramientas, salvoenundetalle: Siqueremosqueelflujodecontrolvayadesdeunaaccinhaciaotraaccin, tendremosquehacerclicenelicono delabarradeherramientas Mientrasquesiqueremosqueseaunflujodeobjetos,larelacinseaaccin objeto,objetoaccinuobjetoobjetotendremosquehacerclicsobre .

Noobstanteparamayorfacilidad,sihacemosclicsobreunaaccin,enlapartederecha delaaccinnosaparecernlosposibleselementosquepuedenhacerreferencia,aligual quesisehaceclicsobreunobjeto: Accin: Objeto:

Realizamosundiagramadeactividadesdeejemplo:


GenerarCdigoParagenerarcdigoseguiremoslossiguientespasos: 1. enelmencorrespondientealasopcionesdecdigo,seleccionaremoslaopcin Generate,ynosaparecereldilogodeOpcionesdegeneracindecdigo, mostradoenlasiguienteimagen:

2. definiremosenestedilogolasopcionesdelageneracin,seleccionandolas correspondientes.EntreellaspodemosencontrarlaopcinOutputDirectory, correspondientealdirectoriodondeseguardarnlosficherosgenerados. 3. haremosclicenelbotnOK. 4. siqueremosmodificarelcdigogenerado,podemosutilizarlaopcinEdit Sourceenelmencorrespondientealasopcionesdecdigo.


GenerarInformesParagenerarinformesseguiremoslossiguientespasos: 1. SeleccionaremoslaopcindelmenTools>Report,conloquesenosabrir eldilogocorrespondienteconlaeleccindeinforme:

2. PestaaTemplateManagement.Enelrbolqueestsituadoaladerecha escogeremoslaplantillacorrespondientealtipodeinformequequeramos generar.EnelcampoDescriptionaparecerunadescripcinconlas caractersticasmsimportantesdecadaunadelasplantillasqueaparecen. 3. EnlapestaaSelectPackagespodremosescogerelmbitoqueabarcarel informequenosdisponemosagenerar.Paraelloseleccionaremoslospaquetes queestimemosconveniente,ylaopcinGenerateRecursivelysiqueremos activarunageneracinrecursivadelinforme.


4. EnlapestaaSelectDiagramsseleccionaremoslosdiagramasqueabarcarel informe.


5. Porltimo,enlapestaaOutputsOptionsseleccionaremoslasopciones finalesdelinforme,comoporejemploeldirectoriodesalida,formatosdesalida, ...

6. seleccionaremoslaopcinGenerate.


ReferenciasParalaelaboracindeestaguahemosutilizadolosrecursosdisponiblesenlapgina weboficialdelaherramientaMagicDraw(www.magicdraw.com),basndonos principalmenteen:

DocumentoMagicDrawTutorials DocumentoMagicDrawUserManual Ejemplosdediagramas

Paracualquierduda,omisinoerrorsobreestagua,serecomiendalaconsultadeeste material.


ManualMagicDraw

Documents

Transcript of ManualMagicDraw