Documentation

Create a Relationship

Introduction

In this topic you learn multiple ways to create Relationships between Entities and Entity Classes:

  • Data Dashboard
    The preferred way to add relationships. In this topic two methods are demonstrated.
  • Architecture Repository
    By manually creating the relationship.
  • Visual Designer
    By drawing a relationship and editing a relationship and its attributes.
  • Import
    By importing a JSON, XML, Excel or CSV file containing the relationship information .

If you want to create a model or a meta model, you need to create a relationship between entities. On Dragon1 relationships are stored as seperate managable and reusable objects in the repository.

Data Dashboard #1: Quick and Easy

In order to create a relationship between data items on Dragon1 the easy way, do the following:

  • Log in.
  • Go to the Data Dashboard.
  • Click on a Data Item in the Data Dashboard.
    A screen with the Data List (list of Data Items) will open.
  • Click on a Entity in the Data List.
  • In the top of the screen, click on the "Add Relationship" button.
    An Add Relationship Dialog appears, in which the new relationship can be created.
  • Select a Model by using the "Browse Models" button.
  • Select the Source Class and Source Name.
  • Select the Target Class and Target Name.
  • Click on the "Add" button.
  • Refresh the page you are on.
  • Click on the "View Model" button.
  • Now you can see the model, including the newly created Relationship.
  • A next step would be to link the model to a Visualization.
Add Relationship Dialog

Add Relationship Dialog - Click image to enlarge

Data Dashboard #2: More structured

The Data Dashboard is an overview of all repository objects on Dragon1 presented as tiles. Per tile a counter is shown in which the number of objects is presented. Once the number of objects per tile rises, the color of the tile will change.

A Relationship can be created in via the Data Dasboard, by following the steps below:

  • Log in.
  • Click "Collaboration" on the left side menu.
    The Collaboration menu opens, showing the "Data Dashboard" menu option.
  • Click the "Data Dashboard" menu option.
Use the Data Dashboard to create a Relationship

Click image to enlarge

  • Inside the Data Dashboard, locate the tile "Relationships".
  • Click the "Relationships" tile.
    A list with all defined Relationships show up. Per relationship record, detailed information is shown (such as description, in which model it is used etcetera). In the right bottom of the screen you can navigate between pages using the page navigation buttons.
Detailed list of all Relationships in the Repository

Click image to enlarge

  • Press the "Add" button to add a new relationship.
  • A screen shows up in which the Relationship can be defined.
    Pay special attention to the fields in the red rectangle. These fields will determine in which Model the relationship will appear and what Entity Classes should be related to each other (source and target).
    Per source/target pair the both Entity Type (e.g. Application) and the name of the Entity Class (e.g. Barney) have to be defined. By clicking the "Browse" behind the input fields, a dropdown list will appear in which the available types and names can be located. By using the search box on top of the dropdown, a quick look-up can be done.
  • Click the "Save" button.
    The Relationship will be created and appears inside the list with Relationships.
Add a new Relationship

Click image to enlarge

Predefined types of Relationships

The Dragon1 platform predefines UML relationships, BPMN relationships and Dragon1 method relationships, allowing you to work with the types you are familiar with:

UML relationships

UML Relationships

BPMN relationships

UML Relationships

Dragon1 relationships

UML Relationships

Create Relationship in the Architecture Repository

A Relationship can be created manually in the Architecture Repository, by following the steps below:

  • Log in.
  • Click "Architecture Repository" on the left side menu.
  • Enter two entities, for instance, an Application and a Process.
  • Create a folder called "Relationships"
  • Select the new folder.
  • Choose from the "Entities menu" the menu item "Insert Relationship".
    A dialog appears in which the Relationshhip can be created.
  • Select as Source Class "Application", as Source Name choose the name of the Application class that was created earlier.
  • Select as Target Class "Process", as Target Name choose the name of the Process class that was created earlier.
  • Select a Relationship type, e.g. "Parent/Child".
  • Click on the "Make" button.
    The Relationship will be created and appears in the Explorer Tree View inside the folder "Relationships".
Create a Relationship in the Architecture Repository

Click image to enlarge

Create Relationship in the Visual Designer

Creating a Relationship inside the Visual Designer is much more intuitive than creating a Relationship inside the Architecture Repository. It is as easy as drawing a line between entities.

  • Log in.
  • Click on "Visual Designer"in the left side menu.
    The Visual Designer will open.
  • Select a Folder.
  • Create or select a Model or Visualization in the folder.
  • Drag two entities onto the canvas.
  • Draw a relationship between the entities.
  • The Relationship appears in the tree view at the left as a data object.
  • After selecting the Relationship in the tree view, its attributes can be edited in the property pane on the right side of the screen.
Create Relationship in Visual Designer

Click image to enlarge

Create Relationship via Importing a File

The Dragon1 import application supports importing excel sheets (saved as CSV files) contain relationship data.

To import an Excel Sheet with relationship data:

  • Create an Excel Sheet with the following columns:

    • relationshipid
    • sourceentityid
    • targetentityid
    • relationshiptype
    • relationshiptext
       
  • Fill the Excel Sheet with the Ids, type and text information.
  • Save the Excel Sheet as a CSV file.
  • Go to the Dragon1 website and log in.
  • Click "Import" in the left side bar. The Import web application will open.
  • Select the local CSV file (containing the Excel Sheet) on your computer.
  • Select a Cabinet, Dossier and Folder as the location for the import.
  • Click on the "Import" button. The data will be imported.
  • Click on Architecture Repository in the left side menu. This will open up the Architecture Repository.
  • Open the the Cabinet, Dossier and Folder in which the data was imported.
  • The imported relationships will appear in the Explorer Tree View.