Diagrams

You can either start building your model in the Diagrams view, or, if you have provided classes, properties, forms and fields already, your model will be automatically visualized in the Diagrams view.

In the diagram, classes are blue, implicit classes are gray, forms are green and relations with fields are symbolized as arrows. Green forms connected to a class is shown on top of the underlying blue class. Implicit classes are classes that are outside of the model, but are referred to by classes or properties inside the model.

Create diagram¶

If you have an empty diagram, you can start by adding classes and forms to it in Edit view and clicking the plus buttons to create classes and forms.

If you have already provided classes and properties, and/or forms and fields, an unnamed diagram is automatically created to your model by default.

List diagrams¶

You can see the complete list of diagrams belonging to a model by clicking the arrow next to the diagram name. You can also create a new diagram by clicking "Create new diagram" at the bottom of the menu.

This will open up the Create new diagram dialog.

Zoom, center and fit, full size¶

On the top right you can use zoom icons to zoom in and out, center and fit the diagram, or show it in fullsize mode.

See details¶

You can click on an item in the diagram to see details for the item. There is also a link to the overview page where you have more options to review and edit.

First, you get the general detailed information about the item. There you can click on the link to get to the overview page.

In the overview you can review and edit more through the button menu.

Edit diagram¶

To edit your diagram, click the edit pen on the top right. The diagram then opens in edit mode.

Hide or show items¶

The tree view panel on the left shows your classes, forms, and relations where you can click to hide or show parts of the diagram. If you want to see your diagram in fullscreen, you can hide or show the tree view panel by clicking on the three lines at the top left.

Create classes and forms¶

You can easily create new classes and forms in your model via the plus buttons in the tree view panel on the left side.

You can also create a form based on a class in edit mode, by clicking on a class to open the right side panel and then click on the "Create form" button.

Remove classes and forms¶

To remove a class or a form, click on the class or form in the diagram to open the right side panel, then click on the three-point menu and choose "Remove".

Draw arrows (relations)¶

You can create relation fields between two forms by drawing an arrow. Just select a form and click on the plus symbol and then drag the arrowhead to the item you want the arrow to point at. By doing this you create a relation field.

Rearrange items¶

In edit mode, you can click and drag boxes and arrows around to rearrange the diagram. Arrows will automatically follow boxes when they move.

You can also double click an arrow until a black dot appears, to create an arrow turn. Then click and drag the arrow through the black dot to where you want it. You can create multiple arrow turns by creating several black dots. To delete a black dot, double click it.

Edit diagram information¶

The three-point-menu on the top right opens up options to edit the diagram information, set diagram as default diagram, choose which label type you want to use or remove the diagram completely.

If you click on "Edit diagram information" you can change the title and description of the diagram, and add titles and descriptions in other languages.

With the Label type options you can choose which input field (Title, Label or URI) to display on the forms, classes and relations in the diagram.

To change the label text on forms and classes, click on the form/class boxes in the diagram to open up a side panel. There you can reach the edit dialog by clicking on the edit pen.

Then you can choose whether to change the title text or the label text further down.

To edit label text for fields, hover the cursor over the field name in the side panel and then click on the edit pen.

Then you change the title text or the label text further down.

Create, add and edit fields and properties¶

The quick way to add fields to a form is to click the plus button next to "Fields" in the right side panel.

You can also manage fields by clicking the pen icon.

This opens up the Manage fields dialog where you can add a field by clicking the plus button, edit field, or remove a field by clicking the three-point-menu and choose "Remove".

If you hover over individual field names in the right side panel, action icons will appear on the right side. You can view detailed information, edit the field through the edit pen or click the three-points menu for more options.

You can access the Edit attributes dialog or Preview your field through the three-point menu.

Remove or disconnect fields and properties¶

You can also remove or disconnect the field through the three-point menu.

The same action icons also appear for properties if you hover their names, with the exception that it's only possible to remove the property, not disconnect it from a class.

Save or Undo changes¶

You can also undo changes in your diagram and restore to the last saved version (meaning you undo all the latest visible changes within the diagram) by clicking the undo changes icon. You save your diagram by clicking the save icon.

Go back to main view¶

To close edit mode and go back to main view, click on the Back button next to the diagram title up on the left.

When in edit mode, you can share your diagram with others by copying and sharing the URL in the browser.

Export diagram¶

If you want, you can export your diagram as a png or svg image. Read more about exporting diagrams under Resources.

Remove diagram¶

To remove your diagram, click on the three-point menu and choose "Remove".