Version Española

Transcript

FEATURE MODELING TOOL MANUALES INDICE Instalación .................................................................................................................................................... 3 Procedimiento de instalación ................................................................................................................... 3 Desinstalación .......................................................................................................................................... 4 Guía de Uso .................................................................................................................................................. 4 Elementos gráficos del editor ................................................................................................................... 5 Creación de un proyecto .......................................................................................................................... 8 Abrir un modelo ....................................................................................................................................... 9 Crear un modelo ....................................................................................................................................... 9 Restricciones........................................................................................................................................... 11 Validación ............................................................................................................................................... 12 Configuración del modelo ...................................................................................................................... 13 Generar proyecto ................................................................................................................................... 14 Exportar el modelo ................................................................................................................................. 15 Importar un modelo externo .................................................................................................................. 16 Reorganizar el diagrama ......................................................................................................................... 16 Zoom....................................................................................................................................................... 18 Copiar, Cortar y Pegar ............................................................................................................................ 18 Exportar la imagen del diagrama ............................................................................................................ 18 2 INSTALACIÓN Requisitos previos   Windows XP o Windows Vista. Cualquier edición de Visual Studio 2008 exceptuando Visual Studio Express. Unas notas sobre la instalación Se proporcionan varios ficheros para la instalación del plug-in.     Un fichero ProductLinesDSL.msi que contiene el instalador en sí. Un fichero DSLElevatedInstaller.exe que invoca al instalador en formato MSI. Un fichero Readme.htm que se muestra cuando finaliza el proceso de instalación. Un fichero Manual-es.pdf que contiene este manual. Figura 1: Ficheros de instalación para el plug-in El motivo de proporcionar el segundo ejecutable es el nuevo sistema de control de cuentas de usuario (UAC) presente a partir de los sistemas Windows posteriores a Windows Vista. Por desgracia, el instalador MSI generado por DSL Tools no solicita automáticamente elevación de privilegios por lo que no es posible ejecutarlo de forma sencilla cuando UAC está activado. DSLElevatedInstaller.exe es por tanto un simple envoltorio que se encarga de solicitar la elevación de privilegios y lanza el instalador MSI como un proceso elevado. PROCEDIMIENTO DE INSTALACIÓN   En Windows XP: lanzar cualquiera de los dos ejecutables suministrados En Windows Vista: se debe lanzar DSLElevatedInstaller.exe Una vez lanzado el instalador, basta seguir las instrucciones que se muestran. El único punto donde el usuario debe intervenir es cuando se le solicita una ruta para la instalación. A modo de referencia a continuación se muestran las capturas del proceso completo de instalación. 3 Tabla 1: Pasos a seguir en la instalación DESINSTALACIÓN El plug-in se registra como cualquier aplicación Windows de manera que su desinstalación se puede realizar desde el Panel de Control de Windows. GUÍA DE USO Los modelos de características se dibujan sobre la superficie del diagrama que es la parte central de la figura. A los lados podemos ver otros elementos que enmarcan el diagrama. Estos elementos se pueden situar de la manera más conveniente para el diseñador del modelo de características, ya que son elementos flotantes de Visual Studio. Distinguimos cinco elementos flotantes alrededor del diagrama: caja de herramientas, propiedades, explorador de características, configurador de características y ventana de errores. Pasamos a continuación a describir estos elementos. 4 ELEMENTOS GRÁFICOS DEL EDITOR Figura 2: elementos del editor de características 1. Caja de herramientas Los nodos se pueden añadir tanto desde el menú contextual del diagrama como desde la caja de herramientas. La caja de herramientas que en el ejemplo está situada en la esquina superior izquierda, incluye los elementos que se pueden arrastrar al diagrama tales como: una característica (feature), un grupo de características (feature group), una restricción tipo implica (implies) o tipo excluye (excludes). 2. Propiedades Cada nodo del diagrama tiene serie de propiedades modificables. El nombre de un nodo se puede cambiar directamente desde la superficie del diagrama, pero el resto de propiedades sin embargo deben cambiarse desde la ventana de propiedades que en el ejemplo está situada en la parte lateral izquierda. Las propiedades de un nodo varían en función de su tipo. Así, un nodo tipo característica tiene, además de nombre y multiplicidad, un valor y un tipo que se puede elegir desde un menú desplegable (ver Figura 3). 5 Figura 3: Ventana de propiedades 3. Ventana de errores Situada en el ejemplo en la parte inferior muestra los errores que se han cometido en el diseño del modelo de características. Se validará el modelo automáticamente al cargar un modelo o al importarlo, y durante la construcción del modelo de características se podrá utilizar manualmente la opción del menú contextual “Validate Model”. 4. Explorador de características Se compone de un árbol con la jerarquía del modelo de características dibujado sobre la superficie del diagrama. Además introduce la posibilidad de añadir un nodo debajo del seleccionado o borrar el nodo seleccionado mediante un menú contextual. Figura 4: Detalle de menú contextual sobre el explorador de características 5. Configurador de características Visualmente es parecido al explorador de características pero añade la opción de poder seleccionar o deseleccionar las características para la configuración del modelo, esto es posible gracias a las casillas de selección (checkbox) asociadas a cada característica. Además, el configurador incluye un botón que permite la generación del proyecto correspondiente a la configuración realizada. 6 Figura 5: Ventana del configurador de características Cualquiera de los elementos gráficos anteriores comparte una serie de propiedades comunes a todos los elementos flotantes estándar en Visual Studio. En caso de que se cierre la ventana correspondiente, el entorno ocultará la ventana, y pueden recuperarse mediante las entradas situadas en el menú View de Visual Studio. Las ventanas correspondientes al explorador y al configurador de características se encuentran en un submenú denominado Other Windows. Figura 6: Menú para recuperar elementos flotantes 7 CREACIÓN DE UN PROYECTO Para empezar a trabajar deberemos crear un nuevo proyecto (File  New  Project). Figura 7: Crear proyecto Después marcaremos un nuevo proyecto de Visual C# con la plantilla Feature Modeling Project y pulsaremos OK. Figura 8: Diálogo desde el que seleccionar la plantilla de “Feature Modeling Project” Después debemos elegir el tipo de proyecto que vamos a crear, para el ejemplo usaremos un proyecto tipo Generic empty Project y pulsamos Create Project. Figura 9: Creación de un nuevo proyecto 8 Así se creará el editor de modelos siguiente compuesto por el cuadro de herramientas y dos elementos flotantes: el explorador y el configurador. ABRIR UN MODELO Para abrir un proyecto existente se deberá marcar tal y como muestra la siguiente figura la opción del menú Project/Solution (File  Open  Project/Solution). Figura 10: Abrir un proyecto existente Se elige el proyecto a abrir con extensión “.sln” y se recupera el proyecto que contiene el modelo de características. Figura 11: Recuperar un modelo de características CREAR UN MODELO Para crear un modelo primero se crear una característica que sea la raíz del modelo y después se añaden las características o grupos que se precisen. La característica raíz no puede ser nunca un grupo de características y la herramienta no lo permite.  Crear característica en el modelo Se puede crear una característica de tres formas distintas pero equivalentes: desde el cuadro de herramientas, desde el menú contextual en el diagrama o desde el explorador de características. 9 La figura siguiente se corresponde con el cuadro de herramientas. Para crear una característica desde el cuadro de herramientas pulsaremos sobre el icono de característica y la arrastraremos al diagrama hasta la característica o grupo de características padre. Figura 12: Cuadro de herramientas, detalle de característica La segunda forma de crear una característica es mediante el menú contextual de la característica, lo que nos permitirá crear una característica hija, disponible al seleccionar una característica y pulsar sobre el botón derecho. Figura 13: Menú contextual de una característica en el diagrama, detalle opción “Add new Feature” La tercera forma de crear una característica es mediante el menú contextual del explorador de características. El menú aparece al seleccionar la característica padre y pulsar el botón derecho. La nueva característica será hija de la que se esté seleccionando. Figura 14: Menú de una característica en el explorador de características Dependiendo de la multiplicidad una característica puede ser obligatoria u opcional. La representación de la característica se modifica automáticamente al cambiar las propiedades de multiplicidad para reflejar su estado de forma visual. Una característica opcional tendrá multiplicidad [0,1] y tendrá la forma: 10 Figura 15: Representación de una característica opcional en el diagrama Mientras que en una característica obligatoria la multiplicidad será [1, 1] y tendrá la siguiente forma: Figura 16: Representación de una característica obligatoria en el diagrama  Crear un grupo de características en el modelo Existe una restricción sobre los grupos de características que impide que sean padres de otro grupo de características. Crear un grupo de características es similar a crear una sola característica. Se puede hacer desde el explorador, desde el cuadro de herramientas o desde el menú contextual. Existen dos tipos de grupos de características grupo OR y grupo XOR.  Un grupo XOR tiene por multiplicidad <1,1> y se representa: Figura 17: Representación de un grupo de características tipo XOR  Un grupo OR tiene por multiplicidad <1, k> siendo k el número de hijos que tiene y se dibuja de la siguiente forma: Figura 18: Representación de un grupo de características tipo OR RESTRICCIONES Se pueden introducir dos tipos de restricciones en el modelo: implica y excluye. Estas relaciones sólo pueden establecerse entre características. Una de las características servirá como origen de la restricción, y la otra será la característica destino. Implica significa que cuando se seleccione una característica en la configuración necesariamente se tendrá que elegir la característica implicada. Los pasos para realizar una conexión tipo implica son: 1. Seleccionar el botón Implies en la Caja de herramientas 2. Pinchar sobre la característica origen de la implicación 11 3. Pinchar sobre la característica destino de la implicación Figura 19: Cuadro de herramientas, detalle de botón “implies” Como resultado aparecerá una fecha azul punteada direccionada de origen a destino entre ambas. Figura 20: Relación implica sobre dos características La operación Excluye significa que hace que una vez seleccionada una de las dos características en la configuración del modelo, la otra debe rechazarse. La conexión entre las características se realiza de la misma manera que en el caso anterior. El resultado esta vez se representa mediante una fecha punteada roja doblemente direccionada al origen y al destino. Figura 21: Relación excluye entre dos características VALIDACIÓN Existe la opción de validar el modelo o un fragmento del modelo. Para validar el modelo completo se introduce la opción Validate All en el menú contextual del diagrama, mientras que validar una parte del modelo implica seleccionar los nodos y después seleccionar la opción Validate. Figura 22: Menú contextual del diagrama de la aplicación, detalle validación Se mostrarán los errores encontrados en el modelo en la ventana Error List tal y como se puede ver en el dibujo. Haciendo doble-click el error, la herramienta selecciona en el diagrama los elementos no válidos. 12 Mientras la estructura del modelo sea inválida, no se podrán configurar las características como puede verse en la ventana Feature Configurator de la Figura 23. Figura 23: Ejemplo de validación de un modelo CONFIGURACIÓN DEL MODELO La configuración es el proceso por el que se eligen las características deseadas del modelo para que estén presentes en el producto final. Si la estructura del modelo no es válida, no se permitirá configurar el modelo. La configuración se realiza desde el Configurador de características. Para seleccionar una característica hay que marcar la casilla correspondiente en el árbol. La característica puede eliminarse de la configuración desmarcando de nuevo la casilla. La herramienta seleccionará o eliminará automáticamente de la configuración aquellos nodos que sea vean afectados por el cambio, sombreando sus casillas correspondientes indicando que su estado se ha fijado de forma automática y no puede cambiarse directamente. La herramienta también tiene en cuenta si se rebasa la multiplicidad del grupo o si existen relaciones de exclusión/implicación sobre la característica que se marca. 13 . Figura 24: Ejemplo de uso del configurador de características GENERAR PROYECTO Una vez realizada la configuración del modelo, y siempre que el modelo sea válido, se puede generar un proyecto desde el configurador pulsando el botón Generate Project. Esta acción realiza lo siguiente: Para cada característica opcional del modelo se genera un paquete representado por una carpeta, tanto en el Solution Explorer de Visual Studio como en disco. Si la carpeta ya existía no se sobrescribe, de modo que la herramienta nunca realiza acciones destructivas en disco. Si la característica opcional estaba seleccionada en el configurador entonces dicha carpeta forma parte del proyecto en Visual Studio y será incluida en la compilación de dicho proyecto. En caso contrario, se excluirá del proyecto y todos los artefactos fuente incluidos en dicho paquete no serán compilados. Nota: para que los paquetes correspondientes a características no seleccionadas puedan ser visibles en Visual Studio, debe estar activada la opción Show All Files del IDE. La herramienta se encarga de activar este botón de forma automática una vez se ha generado el proyecto. Figura 25 : Detalle de botón Mostrar Todo (“Show All Files”) 14 Figura 26: Detalle de paquetes generados EXPORTAR EL MODELO La herramienta permite exportar el modelo a otros formatos para que posteriormente pueda ser importado con otras herramientas. Esto se logrará pulsando Export Model del menú contextual que se obtiene al pinchar con el botón derecho en la superficie del diagrama. Figura 27: Menú contextual del diagrama, detalle del exportador de modelo El segundo paso será elegir el formato al que queremos exportar el Seleccionamos del menú desplegable de la figura el formato deseado: 15 modelo de características. Figura 28: Opciones de exportación IMPORTAR UN MODELO EXTERNO Es posible importar un modelo generado con otra herramienta, por ejemplo, con la herramienta FMP creada para la plataforma Eclipse a través de su fichero XML de intercambio. Para ello, se dispone de la opción Import Model en el menú contextual. Figura 29: Menú contextual del diagrama, detalle del importador de modelo A continuación se debe elegir el formato de entrada para la importación. Figura 30: Opciones de importación de modelos REORGANIZAR EL DIAGRAMA Usaremos la opción en el menú contextual Lay out Diagram para que agrupe automáticamente los elementos del diagrama en forma de árbol. 16 Figura 31: Menú contextual del diagrama de la aplicación, detalle opción “Layout Diagram” 17 ZOOM Se puede hacer zoom sobre el diagrama para acercar o alejar los elementos, pulsando: CTRL + SHIFT + botón izquierdo/derecho o bien usando CTRL + mover la ruleta del ratón. COPIAR, CORTAR Y PEGAR Se permiten acciones de copiar y pegar nodos en el diagrama, para lo que se usarán los botones del menú Edit estándar de Visual Studio, aunque también se puede utilizar el menú contextual del diagrama. Esto puede ser útil para crear de forma rápida una nueva sub-rama basada en otra ya existente (si se utiliza copy), o bien para mover una sub-rama del modelo de características entre padres distintos (si se elige cut). Figura 32: Menú contextual sobre un nodo de modelo, detalle de opciones para cortar, copiar y pegar Para realizar esto, el procedimiento es como sigue: 1. 2. 3. 4. Seleccionar en el diagrama el nodo que se desea copiar/cortar Activar el comando deseado (Cut o Copy) mediante el método que se considere más apropiado. Por ejemplo, para copiar el subárbol cuyo padre es el nodo elegido, puede usarse el comando Copy situado en el menú Edit, o bien usar su atajo de teclado: CTRL-C Seleccionar en el diagrama el nodo que servirá como padre de la subrama que se ha copiado. Activar el comando Paste para confirmar la copia del subárbol. La herramienta no permitirá acciones que no tengan sentido. Por ejemplo, si el nodo origen del subárbol que se copia es un grupo de características, no dejará que el subárbol se pegue tomando como destino otro grupo, puesto que un grupo no puede ser hijo de un grupo. EXPORTAR LA IMAGEN DEL DIAGRAMA Se permite exportar el diagrama generado como modelo de características a una imagen en formato Windows Metafile (WMF) que se corresponde con la extensión “.wmf”. Se permite exportar el diagrama completo o exportar una selección de elementos. Para exportar todo el modelo seleccionaremos la opción “Save Diagram as Image” del menú contextual del diagrama. 18 Figura 33: Menú contextual del diagrama, detalle de exportador de imagen Si se desea exportar sólo una selección de elementos, seleccionaremos los elementos a exportar y el menú contextual correspondiente tendrá la opción “Save Selection as Image”. Figura 34: Menú contextual para la selección, detalle de exportador de imagen 19