Objects and relationships are the foundation of BlueDolphin. There are different types of objects and relationships. A relationship connects two objects with each other. There are certain rules as to which objects you can connect with which type of relationship for a landscape or process description that fits within the ArchiMate specification.
​

An object is an application, a process, a data object or similar. In your own environment, you have many objects that you will want to add and use to map your landscape. In order to create your own environment, enter the objects and specify their type. We already make object definitions available, but you can also create your own object definitions and name them accordingly.

Go to Admin > Configuration > Object definitions.

Here you will find all active object definitions within ArchiMate, BPMN, and Data dictionary categories.

You can choose to have an object definition created, but leave it disabled for a while. End users won't be able to use a disabled object definition yet. However, if you want end users to be able to use this object definition, make sure you enable it. We will explain how this works.
​
In the list of definitions, you will see the headings Enabled and Disabled. It is therefore possible to have a number of object definitions that are enabled (for everyone to use) or disabled (not usable in the environment). Before you add a new object definition, be sure to check within the disabled object definitions if there is already one that is suitable for your object.

Is the definition that you need not yet included? Add an object definition by clicking.

Choose a name for your definition and what object definition it is based on (inherits from). A newly added definition must be based on one of the existing object definitions. Also, you can select the roles for which you want the definition to be added to their personal view. Click OK to save changes.

When you add an object definition, it is enabled by default.
If you want to disable it (for example, because you don't want everyone to use the definition for their objects yet), perform the following steps:

To delete an object definition, you need to disable it first. Then, from the list of disabled object definitions, select Delete object and confirm your choice by clicking Yes, delete.

Go to the object definition you would like to know more about. On the first tab, you will find general information, such as the name and object properties that you want to track for the objects of this object definition.

You will find the name of the object definition and its properties, such as the version and similar.

You can also use Delete all related objects here. Do you have an object definition that you don't want to be used anymore, and you want to delete it (and all its occurrences) completely? You can do that with this function. All associated objects will be deleted. Be careful with using this feature, as it is not reversible and it has many consequences for your environment (see here).

With this button, you can add properties that you want to apply to all objects that are occurrences of this object definition.

With a questionnaire, you can display the information about the object in a more specific way.
You can add a questionnaire that you have created here.

You can also allow combinations per object definition through relationships. The combinations that BlueDolphin offers in the default convention model are according to the ArchiMate guidelines. Defining the object combinations is done in Admin > Configuration > Object definitions.

Example
User-created object definition 'AC1' (which is based on the object definition Application Component) does not yet have any object combinations. We are going to add them now.

In the tab Object combinations, we can define which combinations of this object definition can be made with other object definition(s) and which relationship types they have.

Click the add icon within the blue bar. We will create a relationship combination according to the object definition Application component_1. The type of relationship is a Uses relationship. The target object definition is AC1.

You have to enable it in order to be able to use it. Enable the combination by deselecting the checkbox Add the combination in disabled modus. After you have selected the combination, click Save.

In the examples above you can see that you have a 'type/type' relationship, in this case a 'uses' relationship.

BlueDolphin inherits a label for the relationship definition in both directions: 'uses' (from object to AC1) and 'is used by' (from AC1 to the other object). You can choose to change that label to some text that better describes this particular combination of object and relationship definitions.

Think in terms of 'sends to' or 'is driven by', 'indicates information' or 'gets information from'. Anything is possible and allowed here. Users will see this label immediately when you add an object combination.

Changing the label in a specific object combination does not affect the label set in the relationship definition. To reflect the changes from the relationship definition, click the Reset Settings to Original State option.

You can choose to enable a combination immediately and thus make it usable for everyone or to disable it. Disabled means that the combination cannot yet be used and can only be seen by the administrator.

You can do this by checking or unchecking the box Add the combination in disabled modus.

An object combination only becomes available to end users when an admin has enabled it. You can do that during creation, as explained above, or you can do it afterwards.

Did you choose to disable the combination when created? You can then enable the object combination later as follows.

Now that you've enabled the object combination, you can also find it under allowed combinations within relationship definitions, where the enabled object combinations for this relationship definition are displayed as read-only.

In this example, we have allowed a 'used by' relationship combination between AC1 and AC1.

In the object definition, you can view and manage the source connections that exist for the specific object definition.

A source connection describes an external file definition that can be used to create or update instances of the object definition in BlueDolphin.

Just like the UI only allows you to create content that conforms to the convention model, the content that is created or updated based on reading a source also adheres to the convention model as you have configured with the instructions above.
So you can use a source connection to configure how to create or update relationships between objects.

Example

For the below object definition, no source has been linked yet.

To add a source connection to this object definition, click Add source connection and fill in the pop-up below:

When you change object definitions and combinations, this may have an effect on existing content. The UI can only show the content that conforms to the convention model. So if you remove a combination, instances of that combination are no longer visible in the UI.

However, the content is not deleted from the repository - you can still report on it, and when you re-enable the combination, the content will be visible in the UI again.
Below is a schematic description of the implications of model changes for the content that you should take into account.

What happens to the content when you change relationship combinations?

Relationship definitions do not support the disable/enable functionality.