TUTORIAL PAPYRUS EN ESPAOL Proyecto Tutorial para el uso de perfil en el Papiro ntroduccin 2 La creacin del perfil 2 Perfil de aplicacin de 7 Aadiendo propiedades a los estereotipos de 10 Utilizacin de los iconos de perfil 14 Elija la apariencia de los estereotipos y las propiedades 16 Perfiles de uso en relacin con otras 20 personas ncrustar perfil de plug-in 26 Crear un perfil esttico 34 . Introduccin Este documento es un tutoriaI dando consejos para utiIizar eI perfiI ms comn en papiro. creacin de perfiIes Crear un nuevo perfiI (botn derecho deI ratn + nuevo Figure 1 Create a new profile Select the creation to Ior Stereotype in the palette: $eleccione la creacin de estereotipos que en la paleta $eleccione la creacin de estereotipos que en la paleta $eleccione la creacin de estereotipos que en la paleta Seleccione la creacion deestereotipos en la paleta: Figure 2 Select "Stereotype" creation tool Aadir un Nuevo estereotipo en el diagram y darle un nombre: Figure 3 Create a stereotype Seleciona la herramienta 'Metaclass import creationen la paleta: Figure 4 Select "MetaClass" import creation tool reaunmetaclass import en el diagram. Una ventana de seleccion aparece permitiendo elegir UML metaclasses para reIerenciar en el perIil: Figure 5 Select the UML metaclass to reference Seleciona la herramienta creacion para aadir el enlace Extension entreStereotype yt Metaclass: Figure 6 Select "Extension" creation tool in the palette: rea una Extension entre Stereotype yMetaclass en el diagrama: Figure 7 Add Extension link between Stereotype and Metaclass uarda el modelo. Una ventana de dialogo aparece para decidir si deIines o no el perIil. La deIinicion en obligatoria para usar el perIil (except para perIiles estaticos), ver wiki Eclipse UML2 y/o newsgroups para mas detalles: Figure 8 Define the profile Una ventana aparece para aadir numero de versione diversa inIormacion en la deIinicion del perIil ( esta inIormacion puede ser vista usando el editor de arbol UML2): Figure 9 Add profile version number and meta information Validar para Iinalizar la deIinicion del perIil. El perIil puede ahora ser usado en tus modelos. ApIicacin PerfiI !ara probar tu perIil, inicia creando un Nuevo modelo: Figure 10 Create a new model Seleciona el Modelo(or !aquete (!ackage)),luego, en vista de la propiedad Papiro seleccione la pestaa de perfil. Haga clic en "Aplicar perfil Figure 11 Click the "Apply profile" button Una ventana de seleccion se abre para seleccionar el Iichero*.umldel perIil a aplicar: Figure 12 Select the profile to apply Ahora, con el perfil aplicado, es posible aplicarestereotipo a elementos UML. Para poner a prueba "Mi Perfil",( 'My!roIile), crear una clase(lass),seleccionala y haga clic en "Aplicar estereotipo" botn en la ficha perfil(profile): Figure 13 Apply stereotype Seleciona el/los Estereotipo(s) a aplicar en la ventana de seleccion y validarlas: Figure 14 Selection window for stereotype to apply Aadir propiedades a Ios estereotipos En esta parte el perfil de la muestra se ha modificado para aadir una propiedad en el estereotipo My$tereotype. Para ello, vuelva a abrir el perfil con Papyrus. Aadir una propiedad ael estereotipo, ya sea mediante la seleccin de la herramienta dedicada a la paleta o haga clic en el botn emergente "Aadir propiedad"directamente en el diagrama Figure 15 Add property Para establecer el nombre de la propiedad y el tipo hay dos posibilidades: $eleccione la Propiedad y modificar sus parmetros en la vista de la propiedad Usar tecla "F2" para abrir el Asistente edicin inteligente y establecer el nombre y tipo. De esta manera,la combinacin de teclas "ctrl + espacio"permite la terminacin. Figure 16 Set property name and type Para probar el perfil modificado, es necesario definir el perfil de nuevo (guardael modelo y responde"s" en la ventana de dilogo preguntando por la definicin del perfil). Una vez hecho esto, abra el modelo utilizado para probar el perfil y volver a aplicar el perfil. $eleccione la clase de estereotipada "My$tereotype" y vaya a la pestaa perfil para ver neuvamentela propiedad recin agregada. Para dar un valor a la propiedad, haga clic en el botn "+":. Figure 17 See stereotype property En la caja de dialogo, introducer el valor deseado para la propiedad: Figure 18 Valuate property !odemos ver el valor aadido en la pestaa perIil: Figure 19 Property with value Utilizacin deiconos en el perfil Los iconos pueden ser asociados al estereotipo con el fin de mejorar la presentacin de los elementos estereotipados en los diagramas. Para asociar un icono a cualquier estereotipo, abra el modelo de perfil y seleccionar un estereotipo. En la pestaa "General" de la ventana de propiedades, haga clic en el botn "+" en la parte de definicin icono Figure 20 Click the add icon button Luego selecciona un icono (varios Iormatos de imagen son soportados): Figure 21 Select icon . A continuacinen la parte "icono"de la pestaa"General", una forma puede ser asociado al estereotipo. Proceda como antes para seleccionar una imagen parala forma. Un icono anota el elemento de UML en el diagrama, la forma se utiliza de manera diferente, ya que reemplaza totalmente la forma esquemtica de un elemento estereotipado. $e dan ejemplos en la siguiente parte de este tutorial Figure 22 Click select shape icon button . Una vez que los iconos y / o formas que se hayan especificado son seleccionados y definido el perfilpodemos probarlosen la siguiente parte del tutorial Figure 23 Stereotype with icon and shape specified EIija Ia apariencia de Ios estereotipos y Ias propiedades En esta parte se describe cmo el icono / formas definidas en un estereotipo puede ser mostrado en los diagramas. Tambin ilustran cmo se puede mostrar las propiedades de un estereotipo en un diagrama. Abra el modelo de ejemplo y volver a aplicar el perfil. $eleccione la claseestereotipada y vaya a la ficha de perfil en la ventana de propiedades. En esta pestaa seleccione el estereotipo (s) y haga clic en el botn "Mostrar"(Display) para ocultar / mostrar el estereotipo en el diagrama Figure 24 Display/mask Stereotype in diagram Lo mismo se puede hacer con las propiedades de los estereotipos Figure 25 Show/Mask stereotype properties Una propiedad estereotipo se muestra en el diagrama aparece en una nota de texto que se adjunta al elemento estereotipado: Figure 26 Property representations in the diagram $i el icono y / o forma se han asociado con el estereotipo en el modelo de perfil, la presentacin de los elementos estereotipados pueden pasar a hacer uso de estos. Para este asunto, seleccione el elemento estereotipado, y vaya a la pestaa "Apariencia"(Apperance) en la ventana de propiedades : Figure 27 Change sterotype presentation Un combo box da4 posibilidades de presentacion: 1.%exto : la representacion por deIecto 2.Icono (mostrado debajo) 3.%exto e Icono (mostrado debajo) 4.Forma(Shape) (mostrado debajo) Use profiIes reIated to others In this part we show an example where a proIile in used by another one. A stereotype is created that inheritates Irom a Stereotype deIined in the reIerenced proIile. %o begin with, create a new proIile that will be reIerenced (simply create a Stereotype and save/deIine the proIile): Uso deperfiles relacionados con otros En esta parte se muestra un ejemplo donde un perfil en uso por otro. Un estereotipo es creado que herede de un estereotipo definido en el perfil de referencia(do). En primer lugar, crear un nuevo perfil que ser referenciado(basta con crear un estereotipo y guardar / definir el perfil): Figure 28 Create a profile that will be referenced Abra el perfil de "Mi Perfil"('My!roIile ) e importar el perfil recin creado. Para ello haz click derecho sobre el elemento de perfil y elegir la opcin "mportar paquete / paquete de importacin de los modelos de espacio de trabajo"( workspace models): Figure 29 Import profile En la ventana de dilogo introduzca las primeras letras del archivo *. uml y seleccione el perfil para importar Figure 30 Select the profile to import En el editor de rbol (esquema Papiro)( !apyrus outline), abre "importaciones" (mports) y recuperar el estereotipo que desea utilizar en el perfil. A continuacin, arrastre el estereotipo en el diagrama Figure 31 Import the stereotype Para crear un enlace generalizacin entre un estereotipo y un estereotipo de otro perfil, seleccione la herramienta de creacin de la generalizacin de la paleta Figure 32 Select "Generalization" creation tool rea una generalizacion entre estereotipos: Figure 33 Create a Generalization Guardar y definir el perfil, y abrir un modelo para la prueba. Volver a aplicar el perfil y probar el estereotipo. En la pestaa de perfil, la propiedad heredada del perfil referenciado aparecer: Figure 34 Inherited properties of a stereotype Incrustar perfiI en pIug-in Para faciIitar Ia impIementacin de perfiI y su uso en Papiro, eI perfiI puede ser embebido en EcIipse pIug-in. En esta parte se describen Ios pasos a seguir para crear taI pIug-ins. Comience por crear un nuevo pIug-in con eI asistente de creacin de (nuevos / otros) pIug-ins: Figure 35 Create a new plug-in En la ventana de creacion plug-in, introduce un nombre para el plug-in: Figure 36 Give a name to the plug-in Elige siguiente y rellena la inIormacion opcional, si es necesario: Figure 37 Optional information Elegir Iinish para completer el proceso de creacion del plug-in. En el plug-in creado, aadir una carpeta 'model y copiar el perIil en esta carpeta: Figure 38 Copy the profile in the plug-in Ahora tenemos que configurar el plug-in. La configuracin de Plug-in se realiza principalmente en el archivo "plugin.xml" , abrirlo, un editor dedicado debera aparecer. Vaya a la pestaa de dependencias. Aadir las siguientes dependencias (que son necesarias para poder utilizar el punto de extensin ms adelante): Oorg.eclipse.emI.ecore Ocom.cea.papyrus.extensionpoints.uml2 Figure 39 Add dependencies Ir a la pestaa 'Extension. Aadir un Nuevo 'org.eclipse.emI.ecore.urimapping: Figure 40 Select "uri_mapping" extension point Rellena la inIormacion de Extensions como en la Iigura de debajo: Figure 41 uri_mapping information Esta extensin define un alias UR que ser resuelto automticamente por la plataforma Eclipse, cuando sea necesario (que es una especie de carpeta virtual que tiene el mismo nombre en cualquier instalacin de Eclipse, pero la ubicacin del sistema es diferente). A continuacin, agregar una nueva extensin: "com.cea.papyrus.extensionpoints.uml2.UMLProfile": Figure 42 Add Papyrus related extension Rellena inIormacion para la extension UML!roIile (ver Iigura de debajo). Solo nombre y path son obligatorios. Figure 43 UMLProfile extension Esta extensin es utilizada por Papiro para saber qu perfiles son instalados y embebidos en plug-in de el Eclipse de la instalacin local. Para probar el plug-in, una mesa de trabajo de pruebas (testing workbench ) debe ser iniciado. Para ello,elegir la opcin"de dilogo Open Run" del menu Ejecutar (Run): Figure 44 Open run dialog rea un banco de pruebas Eclipse ( test workbench)(doble-click en 'Eclipse Application y'Run): Figure 45 Create Eclipse application test workbench Para probar el perfil, crear un nuevo proyecto y agregar el modelo UML. $elecciona un paquete, vaya a la pestaa Perfil en la vista propiedad(property view) y haga clic en el botn "Aplicar perfil registrado" ('Apply registered proIile ) : Figure 46 Apply registered profile El perIil embebido apareceria en la ventana de seleccion: Figure 47 Profile selection window Validar la seleccion.!uedes usar ahora el perIil exactamente igual que antes.: Figure 48 Use the profile as usual Crear un perfil esttico EI proyecto EcIipse UML2 ha definido nueva caracterstica denominada "PerfiIes estticos" ("Static ProfiIes ) que hacen posibIe eI uso de estereotipos a travs de cIases Java generadas en Iugar de Ias definiciones de perfiI (ver wiki EcIipse UML2 i para ms informacin). Esta caracterstica puede ser tiI aadir eI comportamiento en eI perfiI. En este tutoriaI se utiIizapara Ia funcin de prestar apoyo a Ias propiedades derivadas.. Una propiedad derivada es un tipo particuIar de propiedad quese supone que no es vaIorado por eI usuario, sinoautomticamente se deduce deI contexto donde se apIica eI estereotipo. En primer Iugar crear un nuevo perfiI, un estereotipo y aadir una propiedad derivada. En este ejempIo, eI vaIor esperado de "cIassName" es eI nombre de Ia cIase en Ia que se apIica MyStereotype. En generaI, estas propiedades se espera que sean de sIo Iectura. Figure 49 Stereotype with derived property Perfilesestticosdebenestarintegradosenunplug-in.Crear unproyectoestndar de Java, agregue una carpeta "modelo" (model)y colocar el perfil en l Figure 50 Create a 1ava project Abrir el perIil y aplicar el perIil Ecore (puede ser encontrado via dialogo seleccion 'Apply registered proIil ): Figure 51 Apply Ecore profile Aplicar el estereotipo E!ackage al modelo: Figure 52 Apply EPackage stereotype ntroduzca el valor para la propiedad estereotipo EPackage. En el ejemplo, los valores son los siguientes: PackageName = "Mi Perfil" nsPrefix = "Mi Perfil" nsUR = "http://Papyrus/MyProfile/1" ("1" representa la versin del perfil) prefix = Mi Perfil Esta informacin se utiliza para generar cdigo para el perfil. Adems, en la mayora de los casos, las propiedades derivadas se aplican en EMF como transitorio y voltil. Esta informacin se aade en el modelo de UML con el estereotipo de EReference o EAttribute (de perfil Ecore). Figure 53 EPackage stereotype property values uarda el perIil. Definicin del perfil no sirve para nada con los perfiles estticos Figure 54 Save the profile Abrir el archivo *.uml del perIil con Eclipse UML2 editor:

Figure 55 Open with UML2 tree editor convertir el modelo a un Iichero ecore: Figure 56 Convert profile to Ecore Luego, crear un Nuevo EMF en tu proyecto: Figure 57 Create an EMF model $eguir el modelo de asistente de creacinEMF. Nombra el modelo Figure 58 Give a name (`.genmodel) Elegir importar modelo Ecore: Figure 59 Choose Ecore importer seleccionar la version ecore del perIil:And select the ecore version oI the proIile: Figure 60 Select `.ecore version of the profile El archivo creado *. genmodelse debe abrir en sueditor dedicado. Haga clic derecho y generar cdigo para el modo Figure 61 Generate model code Cdigo debe ser generado enla carpeta "src", y "plugin.xml" debe ser inicializado con algunas extensiones definidas. Una parte de el archivo "plugin.xml"an no se ha completado con la mano. Para este tema tenemos que recuperar el "id" del perfil. Este id se puede encontrar abriendo el perfilarchivo *. uml con el editor de texto Figure 62 Profile id En el archivo plugin.xml, vaya a la pestaa de extensin y agregar una nueva extensinorg.eclipse.uml2.uml.generated_package . Los detalles de esta extensin son las siguientes: UR: http://papyrus/MyProfile/1 (esta es la UR especificada en la propiedad nsUR del estereotipo EPackage) Ubicacin: Plataforma: / plugin / MyProfilePlugin / modelo / MyProfile.profile.uml # package_id, donde "MyProfilePlugin" es el nombre del proyecto, "MyProfile.profile.uml" el nombre del archivo de perfil, y "package_id" es supone que se sustituye por el D de perfil encontrado justo antes. O Figure 63 org.eclipse.uml2.uml.generated_package extension Luego aadir extension relacionada !apyrus igual como vimo antes (): Figure 64 Papyrus related extensions Con el fin de calcular automticamente el valor de la propiedad "className", el cdigo generado en "src" tiene que ser completado. Abra la clase java class MyProfile.impl.My$tereotypempl.java y aadir un poco de cdigo en los mtodos GetClassName / setClassName Figure 65 Add 1ava code after generation El codigo seria el siguiente: /