Cleaning up the CDM

Last modified by Eva Torken on 2023/08/08 17:11

In this microlearning, we will focus on how you can clean up your CDM elements. It is necessary to understand how you can clean up your CDM elements to ensure that your CDM keeps being a good representation of which entities and attributes are actually used within your eMagiz solution. We have kept this part as a separate microlearning as cleaning up the CDM is not a trivial manner and should only be done after careful consideration.

Should you have any questions, please contact academy@emagiz.com.

1. Prerequisites

  • Basic knowledge of the eMagiz platform

2. Key concepts

In this microlearning, we will focus on how you can clean up your CDM elements.
With CDM elements we mean: Entities and attributes that make up the Canonical Data Model
With clean up we mean: Remove the entities and attributes that are not used anymore within the eMagiz solution

It is necessary to understand how you can clean up your CDM elements to ensure that your CDM keeps being a good representation of which entities and attributes are actually used within your eMagiz solution. We have kept this part as a separate microlearning as cleaning up the CDM is not a trivial manner and should only be done after careful consideration.

  • Removed on CDM level means removed in Create (for all definitions and transformations)
  • Removed on CDM level means removed in all CDM messages in Design
  • Removed on CDM level means removed in all message transformations

3. Cleaning up the CDM

As we learned in our previous microlearnings there are easy ways to define which entities and attributes on CDM level are not used anymore. As a reminder, there are three separate selection views you can use to control the usage of CDM elements

  • Not assigned to any message types
  • Not mapped in any message mappings
  • Not present in Create phase integrations

In this microlearning we will use these selection views to identify which entities and attributes can be removed from our CDM. It is necessary to understand how you can clean up your CDM elements to ensure that your CDM keeps being a good representation of which entities and attributes are actually used within your eMagiz solution. We have kept this part as a separate microlearning as cleaning up the CDM is not a trivial manner and should only be done after careful consideration.

  • Removed on CDM level means removed in Create (for all definitions and transformations)
  • Removed on CDM level means removed in all CDM messages in Design
  • Removed on CDM level means removed in all message transformations

3.1 Removal of entities and attributes

To remove entities and attributes you first need to navigate to the CDM in Design. In this overview you will see your CDM. When you press Start Editing you can start removing entities and attributes.

intermediate-defining-your-message-structures-cleaning-up-the-cdm--cdm-overview-start-editing.png

To do so simply navigate with your mouse to the entity and/or attribute that you want to revome and open the context menu via a right-mouse click. If you right-mouse click above the line you can remove the entity. If you right-click below the line you can delete a specific attribute.

intermediate-defining-your-message-structures-cleaning-up-the-cdm--remove-entity-context-menu.png

intermediate-defining-your-message-structures-cleaning-up-the-cdm--remove-attribute-context-menu.png

Before you actually press the button ensure that you really want to delete the entity and/or attribute because deleting something on this level, as specified before, comes with grave consequences. To really ensure that the user is aware what he/she is doing you cannot remove anything from the CDM without reading the confirmation pop-up and pressing Yes within this pop-up. Only after you have confirmed your action eMagiz will remove the selected entity or attribute from the CDM.

intermediate-defining-your-message-structures-cleaning-up-the-cdm--remove-confirmation-pop-up.png

As a gentle reminder, once more, this also means the following:

  • Removed on CDM level means removed in Create (for all definitions and transformations)
  • Removed on CDM level means removed in all CDM messages in Design
  • Removed on CDM level means removed in all message transformations

4. Key takeaways

  • It is necessary to understand how you can clean up your CDM elements to ensure that your CDM keeps being a good representation of which entities and attributes are actually used within your eMagiz solution. We have kept this part as a separate microlearning as cleaning up the CDM is not a trivial manner and should only be done after careful consideration.
  • Removed on CDM level means removed in Create (for all definitions and transformations)
  • Removed on CDM level means removed in all CDM messages in Design
  • Removed on CDM level means removed in all message transformations
  • Before removal you need to confirm your action via the conformation pop-up

5. Suggested Additional Readings

If you are interested in this topic and want more information on it please read the help text provided by eMagiz.