Use source data to create relationships – BlueDolphin

There are a couple of reasons to use a datasource in BlueDolphin:

This article will describe how to automatically create relationships between objects.

First, follow the article Import data into BlueDolphin to make your local datasource available in BlueDolphin.

In this article I'll explain the steps you need to take to automatically create relationships between objects based on a loaded datasource, in this case being "Source_Relations_ApplicationComponent_Node".

Before executing the steps, make sure you:

have a valid BlueDolphin environment
are Administrator in the environment
have installed the required relationship definition.

I imported the datasource containing the relationship information into BlueDolphin and it has the following layout:

The source contains the ApplicationId, which we look up using the UniqueId property, and the Workstation name, which we look up using the object title. In this case we cover both methods we can use to identify objects for relationship creation.

Go to the Object definitions section of the Admin module and select the definition for which you want to automatically create relationships. Let's say I want to create a Used By relationship between Application components and Business Processes. Go to the Object definition for Application and select the Object Combinations tab:

Because we want to create relationships based on a datasource, click on the three dots on the right side of an object combination. In this case, we'll choose the Used By relationship connected to Business Process:

Select Edit source connection. A screen similar to the one below will appear:

I gave the source connection configuration a logical name so I can easily find it in the source connection list. After that I selected the datasource which contains the relationship information.

The pop-up has two parts, the "From" and "To" part, where you make configurations matching the relationship direction you require. I want a Used By relationship from Application Components to Business Processes so we get a relationship like:

App A == used by == Process X
Process X == uses == App A

After closing the pop-up dialog using OK, you see the newly added source connection configuration in the list. You can now click Close.

The hyperlink icon will appear on the right side of the object combination, indicating there are source connections set up for that object combination:

Relationships are automatically created during BlueDolphin scheduled actions and they are run around midnight CET, but if you cannot wait you can force the relationship detection manually. Go to the Relationships general tab, select the correct relationship type (in this case being Used By) and click Detect relationships:

Relationship detection will be started, and depending on the amount of data in the datasource, it will take some time. When the process is finished, go to the Object view and open an Application Component.

In the figure below I opened the application component "AFAS HRM".

When opening the relationships tab, you will see the relationship(s).

When clicking on the object link "Deliver HR services" in the relationship table, the object will be opened. Below you can see that the Business Process "Deliver HR services" has two relationships:

Related articles