Actor Lineage - NEW! 🚀

In Data One, actor lineage refers to the process of tracing the configured complete flows of data from a source actor to one or more destination actors. As the level of detail increases, the actor lineage offers a comprehensive perspective on the flow, showing the complete configuration, and covering all contracts and protocols configured within them.

This feature is particularly useful for simplifying troubleshooting and data analysis since the lineage always shows the full path, from a source actor to a destination actor or actors and there will never be a flow in the configured path that starts from an actor and stops in the middle of the mediation.

In a setup involving two Data One actors, the configuration includes these key components:

• A source actor, with an input configuration that can be either an input contract or a connection contract.
• One or more mediation contracts that manage the interaction between the source and destination actor.
• A destination actor, with an output configuration that is either an output contract or a connection contract.

The lineage goes down to an increasing level of detail. It starts with a general view of the source actor and the destination actors to which it is connected. From there, users can access more details showing the flow. Finally, more information is displayed with all the details, from the template used to the individual configurations chosen when creating the flow.

📘

Important note about mediation contracts

Only mediation contracts that use "sourceVirtualPath" as the variable name containing the starting virtual path are considered to identify the complete flow. Any mediations with virtual path variables with a custom name (not a system name) will not be considered in the extraction of complete flows and consequently will not be represented as lineage.

Accessing the actor lineage

To access the Actor lineage functionality, go to Actors, click the 3 dots button on the actor row, and select the Lineage option. A specific license is needed to see this menu.

After selecting the Lineage option, a screen will show the source actor and its single or multiple destinations. In this latter case, an arrow starts from the source and goes to each destination. Each arrow represents a distinct action toward one of the destinations, creating a one-to-one correspondence between the source of the arrows and the destinations to which they are directed.

Clicking on a single source or destination, details are displayed in a panel appearing on the right. This is the information shown:

• Actor: name of the actor involved
• Type: type of actor, i.e. Application or Partner
• Description: description of the actor, entered upon its creation
• Last update: if applicable, the date of the last update is given

Read the following pages for the details about Actor Lineage:

• Aggregation of flows by protocol
• Lineage with connection contracts
• Lineage with input, mediation and output contracts
• Lineage with any contract type

Exporting diagrams

All diagrams can be exported in SVG format by clicking on the icon in the upper right corner.