Primeros pasos con Gaphor

Gaphor es más que un editor de diagramas: es un entorno de modelado. Mientras que los editores de diagramas sencillos como Microsoft Visio y draw.io permiten crear imágenes, Gaphor realiza un seguimiento de los elementos que se añaden al modelo. En Gaphor puede crear diagramas para seguir y visualizar diferentes aspectos del sistema que está desarrollando.

Dejémonos de cháchara, empecemos.

You can find installers for Gaphor on the Gaphor Website. Gaphor can be installed on Linux (Flatpak), Windows, and macOS.

Una vez que se inicia Gaphor, aparece una pantalla de bienvenida. En ella se muestran los modelos y plantillas de modelos abiertos anteriormente.

Gaphor's welcome screen showing recently opened models and model templates.

Puede seleccionar una plantilla para empezar.

  • Genérico: un modelo en blanco para empezar

  • UML: Una plantilla del Lenguaje Unificado de Modelado para modelar un sistema de software

  • SysML: Una plantilla del Lenguaje de Modelado de Sistemas para modelar una amplia gama de sistemas y sistemas de sistemas

  • RAAML: Una plantilla para el Lenguaje de Modelado de Análisis y Evaluación de Riesgos para análisis de seguridad y fiabilidad

  • C4 Model: A template for Context, Containers, Components, and Code which is for lean modeling of software architecture

Una vez cargada la interfaz del modelo, verá la interfaz de modelado.

The Gaphor main window, with numbers refering to parts of the UI.

La disposición de la interfaz Gaphor se divide en cuatro secciones:

  1. Modelo de navegador

  2. Caja de herramientas de elementos de diagrama

  3. Diagramas

  4. Editor de propiedades

Cada sección tiene su función específica.

Modelo de navegador

La sección Navegador de modelos de la interfaz muestra una vista jerárquica de su modelo. Cada elemento del modelo que cree se insertará en el Navegador de modelos. Esta vista actúa como un árbol en el que puede expandir y contraer diferentes elementos de su modelo. Esto proporciona una manera fácil de ver los elementos de su modelo desde una perspectiva elidida. Es decir, puede contraer aquellos elementos del modelo que son irrelevantes para la tarea que está realizando.

En la figura anterior, verá que hay dos elementos en el Navegador de modelos. El elemento raíz, Modelo nuevo es un paquete. Observe la pequeña flecha al lado de Modelo nuevo que apunta hacia abajo. Esto indica que el elemento está expandido. También observará que los dos subelementos están ligeramente sangrados con respecto a Modelo nuevo. El elemento principal es un diagrama.

En la vista del Navegador de modelos, también puede hacer clic con el botón derecho del ratón en los elementos del modelo para obtener un menú contextual. Este menú contextual le permite averiguar en qué diagrama se muestran los elementos del modelo, añadir nuevos diagramas y paquetes, y eliminar un elemento.

Haciendo doble clic en un elemento del diagrama se mostrará en la sección Diagrama. Los elementos como clases y paquetes pueden arrastrarse desde la vista en árbol a los diagramas.

Caja de herramientas

La caja de herramientas se usa para añadir elementos nuevos a un diagrama. Seleccione el elemento que desea añadir haciendo clic sobre él. Al hacer clic en el diagrama, se crea el elemento seleccionado. La flecha vuelve a estar seleccionada, por lo que el elemento puede manipularse.

Las herramientas pueden seleccionarse simplemente haciendo clic con el botón izquierdo del ratón sobre ellas. Por defecto, la herramienta puntero se selecciona después de cada colocación de un elemento. Esto puede cambiarse desactivando la opción «Restablecer herramienta» en la ventana de Preferencias. Las herramientas también pueden seleccionarse mediante atajos del teclado. El atajo del teclado puede mostrarse como información sobre la herramienta pasando el ratón por encima del botón de la herramienta en la caja de herramientas. Por último, también es posible arrastrar elementos sobre el Diagrama desde la caja de herramientas.

Diagramas

La sección de diagramas contiene diagramas del modelo y es la que ocupa más espacio en la interfaz de usuario porque es donde se realiza la mayor parte del modelado. Los diagramas constan de elementos colocados en el diagrama. Hay dos tipos principales de elementos:

  1. Elementos

  2. Relaciones

Se pueden abrir varios diagramas a la vez: se muestran en pestañas. Las pestañas se pueden cerrar pulsando Ctrl+w o haciendo clic con el botón izquierdo del ratón en la x de la pestaña del diagrama.

Elementos

Los elementos son las formas que se añaden a un diagrama y, junto con las Relaciones, permiten construir un modelo.

Para cambiar el tamaño de un elemento del diagrama, haga clic con el botón izquierdo del ratón en el elemento para seleccionarlo y, a continuación, arrastre los tiradores de cambio de tamaño que aparecen en cada esquina.

Para mover un elemento en el diagrama, arrastre el elemento donde desee colocarlo manteniendo pulsado el botón izquierdo del ratón y moviendo el ratón antes de soltar el botón.

Relaciones

Relations are line-like items that form relationships between elements in the diagram. Each end of a relation is in one of two states:

  1. Conectado a un elemento y la manilla se vuelve roja

  2. Desconectado de un elemento y la manilla se vuelve verde

Si ambos extremos de una relación están desconectados, la relación puede desplazarse haciendo clic con el botón izquierdo del ratón y arrastrándola.

Se puede añadir un nuevo segmento en una relación haciendo clic con el botón izquierdo del ratón en la relación para seleccionarla y, a continuación, pasando el ratón por encima. Aparecerá un asa verde en medio de los segmentos de línea existentes. Arrastre el asa para añadir otro segmento. Por ejemplo, cuando se crea una nueva relación, ésta sólo tendrá un segmento. Si arrastra el asa del segmento, ahora tendrá dos segmentos con la rodilla de los dos segmentos donde estaba el asa.

Copy and Paste

As stated before, Gaphor is a modeling environment. This means that every item in a diagram is backed by a model element found in the model browser. This means that you can show the same model element in different diagrams.

  • Ctrl+v is used to paste only the presentation element.

  • Ctrl+Shift+v is used to paste a new presentation with a new model element.

Importante

Ctrl+v does a «shallow» paste. Ctrl+Shift+v does a «deep» paste.

Deshacer y rehacer

Para deshacer un cambio pulse Ctrl+z o haga clic con el botón izquierdo del ratón en la flecha para deshacer situada en la parte superior del Editor de Propiedades. Para rehacer un cambio, pulse Ctrl+Mayús+z o pulse la flecha de rehacer en la parte superior del Editor de propiedades.

Editor de propiedades

The Property Editor is present on the right side of the diagrams. When no item is selected in the diagram, it shows you some tips and tricks. When an item is selected on the diagram, it contains the item details like name, attributes and stereotypes. It can be opened with F9 and the Icon for showing and hiding the Property Editor. icon in the header bar.

Las propiedades que se muestran dependen del elemento seleccionado.

Preferencias del modelo

The Property Editor also contains model preferences: Click the Document with wrench icon for model specific configuration. button.

Reset Tool Automatically

By default, the pointer tool is selected after an element is placed from the toolbox. If this option is turned off, the same type of element will be placed by clicking in the diagram until another element is selected in the toolbox.

Remove Unused Elements

By default, elements that are not part of any diagram in the model will be removed. If this option is turned off, elements remain in the model and may be found in the model browser.

Diagram Language

The diagram language modifier is only applicable to the loaded model and how it is shown in the diagram. The diagram language setting is saved as part of the model and defaults to English.

The UI language of Gaphor is controlled by the operating system.

Nota

Gaphor considers the LANG environment variable on Linux, Windows and macOS.

On Windows and macOS it can be set independently of the operating system’s language settings to a different language.

Style Sheet

The style sheet allows to change the visual appearance of diagrams and model elements.