Map your LeanIX data to SAP Signavio

The second section of the tab Basic Configuration, called Glossary Category Mappings, allows you to map data between LeanIX Fact Sheets and Glossary Items in SAP Signavio.

The most common use case for this is to map the applications and their business context from LeanIX to a Glossary Category.

πŸ‘

Best Practice

To guarantee single sources of truth for your data in IT it is common sense to not only sync your processes with LeanIX but also use the applications mastered in LeanIX in your SAP Signavio solution.

This section of the integration configuration can consist of multiple mappings. Also, these mappings may either be from LeanIX to SAP Signavio or the other way around.

1. Active

For any of the Glossary Category mappings, you may activate/deactivate the synchronisation. This is especially helpful if you want to test out new mappings and improve the duration of the synchronisation.

2. Source

As already mentioned, this part of the integration is bi-directional. For each of the Glossary Category mappings, you may choose whether LeanIX or SAP Signavio is the source.

3. Fact Sheet Type

Specify the fact sheet type or category that you want to read from or write to (depending on which system is the source). The list will offer you any Fact Sheet type that has a external ID for SAP Signavio configured. If you miss a Fact Sheet type, please approach your Customer Success Manager.

4. Glossary Category Name

In this dropdown, you may choose any of the Glossary Categories that exist in your SAP Signavio workspace. The Fact Sheets will either be written as Glossary Items into this directory or read from Glossary Items out of this directory.

5. LeanIX Relation

If a relation is provided, links from a SAP Signavio Process to a glossary item of the current type will be mapped to this relation.

Let's walk through a detailed example to better understand how these relations work:

  1. Assume that you already mapped all your processes from SAP Signavio into Process Fact Sheets within LeanIX.
  2. Also, assume that you already mapped all your applications from LeanIX into SAP Signavio Glossary Items.
  3. Now, whenever you use one of these applications within a process, SAP Signavio knows that the app and the process are related.
  4. The integration can leverage this information to also create a relation between the Application Fact Sheet and the Process Fact Sheet within LeanIX, it only needs to know which type of relation. In our default data model, relations between Applications and Processes can be required or required by, but of course, you could model your own relations and use them here.

Setting up these relations also works, if you map Glossary Items from SAP Signavio to LeanIX (e.g. because it is some part of your modeling that is actually maintained within SAP Signavio). We will still know the processes that use these items and can create the relation to the respective Process Fact Sheet within LeanIX.

🚧

For the LeanIX Relation, SAP Signavio is always the source!

No matter whether you create the Glossary Items based on Fact Sheets or Fact Sheets based on Glossary Items, SAP Signavio will always be the system of record when it comes to the linkage of these Glossary Items to Processes. So even if Fact Sheets of type Application are written from LeanIX to a Glossary Category in SAP Signavio, the integration will create relations between these Applications and Process Fact Sheets based on the linkage between these Glossary Items and the respective Processes within SAP Signavio.

🚧

Relation sync is always strict

Relationship sync between LeanIX and SAP Signavio is strict which means that the existing relationship data for that specific relation will be maintained by the interface, and hence any manually created relationships will be deleted from the target system.

6. Strict

If this option is checked, it implies that missing elements on the source side will be removed from the target side. For example, if LeanIX is the source, Fact Sheets no longer existent in LeanIX will be removed from the SAP Signavio Glossary Category.

7. Filter

When LeanIX is selected as a source, a small filter icon is offered in the Actions column of the configuration row. Clicking the icon will open a dialog similar to the LeanIX Inventory. It allows you to filter the Fact Sheets that will be mapped into Glossary Items. This way you could for example map applications from different departments into different Glossary Categories.

9. Edit Field Mappings

You can click the button ...to open a new dialog that allows you to configure the field mappings for the given Glossary Category mapping. These fields mappings define how the attributes of your SAP Signavio Glossary Item are synchronised with the values on the LeanIX Fact Sheet. This will obviously depend on which system you have chosen as the source for the given Glossary Category mapping (see step 2).

Use the Documentation field on top to describe the intention of your field mappings for later reference.

After that, you may add multiple field mappings, each having a reference to LeanIX and SAP Signavio.

πŸ“˜

Default Mapping

In case no mappings are specified in the Edit Field Mappings dialog, the integration will synchronise the name and the description of the Fact Sheet with the Glossary Item in SAP Signavio.

In the list of references to the LeanIX Fact Sheet, you will find:

  • Fields on the Fact Sheet, e.g. scalar fields (text, number...) but also single & multi-select fields
  • Subscriptions and Subscription Roles
  • Tags and Tag Groups

In the list of references to the SAP Signavio Glossary Item you will find:

  • Fields on the Glossary Item, e.g. scalar fields (text, number...) but also single & multi-select fields

In case of single & multi-select fields, tags and tag groups, you will need to use the Value Mapping dialog to specify which value on the LeanIX side is used for which value on the Signavio side.

10. Save and run the integration

Once you have filled in all the required information and saved them, you can click on Sync Now to start the synchronisation with SAP Signavio.

All applications from LeanIX will be displayed and synchronised to SAP Signavio. To get an overview about your sync and if everything is working fine you can check the Sync Logging in the administration area in LeanIX for more information. If there is an error message when synchronising the applications to the glossary, please check if there are no duplicates for the display name. Maybe an Application already exists in another glossary. There are two options to solve the issue, you can move the Application to the correct glossary or delete the Application in the old glossary and make a new sync.

To see all Applications from LeanIX in SAP Signavio please click on "Dictionary" in the left panel at SAP Signavio.

All applications are synchronised to the dictionary you selected in the basic settings. Usually, the Applications should be synced to the Dictionary "IT-Systems". Select "IT-Systems" at the right menu bar to get an overview of all the LeanIX Applications.