Cleanup a captured integration

Last modified by Erik Bakker on 2023/06/19 08:04

In this microlearning, we will focus on the last step of cleaning up your integration. As we learned in previous microlearnings, the lifecycle management process starts in Manage and ends in Capture. Following that logic, the last step of the process is to remove the integration from Capture (and potentially the system)

Should you have any questions, please get in touch with academy@emagiz.com.

1. Prerequisites

  • Basic knowledge of the eMagiz platform
  • Basic knowledge of the build number component within the eMagiz Platform

2. Key concepts

This microlearning is about cleaning up a captured integration.

By captured integration, we mean: A line that symbolizes data traffic between a system and eMagiz for which the specific information is filled in (i.e., captured)

There are four essential considerations before cleaning up a captured integration:

  • Is the integration/flow not mentioned anymore in any alerting in Manage?
  • Is the integration removed from all releases?
  • Is the integration removed from Create?
  • Is the eMagiz data model (i.e., CDM, API Gateway Data model) cleaned?

3. Cleanup a captured integration

In this microlearning, we will focus on the last step of cleaning up your integration. As we learned in previous microlearnings, the lifecycle management process starts in Manage and ends in Capture. Following that logic, the last step of the process is to remove the integration from Capture (and potentially the system)

There are four essential considerations before cleaning up a captured integration:

  • Is the integration/flow not mentioned anymore in any alerting in Manage?
  • Is the integration removed from all releases?
  • Is the integration removed from Create?
  • Is the eMagiz data model (i.e., CDM, API Gateway Data model) cleaned?

As you can see, a theme starts to develop itself. Each of the considerations focuses on a particular phase within eMagiz. We begin at Manage, move to Deploy, Create and Design before we end up in Capture. Removing integrations in the advised way will ensure that the deletion of the integration and everything that accompanies it will be successful.

However, there is no check done on all these aspects when you want to delete the integration. Therefore it is up to you to uphold the quality. There is one exception to this: the integration needs to be removed from Create before you can clean it up (i.e., delete) in Capture. If the integration is not yet removed from Create, you will see the following pop-up:

novice-lifecycle-management-cleanup-a-captured-integration--not-able-to-remove.png

To remove an integration in Capture, access the context menu (via a right-mouse click) and select Delete integration.

novice-lifecycle-management-cleanup-a-captured-integration--delete-integration.png

When selecting this option, eMagiz will ask for confirmation to make sure that you know what you are doing. Confirming that you want to delete the integration means throwing away all captured information, including attached documents. Furthermore, it means that all message mappings, system messages, and design configurations are also gone, except for entities and attributes on the eMagiz data model (CDM, API GW, EVS) level as they are shared.

In cases where the integration you have just cleaned up is the last integration tying a system to eMagiz, you should also delete the system itself. To do so, access the context menu on the system level and select the option Delete system.

novice-lifecycle-management-cleanup-a-captured-integration--delete-system.png

Once again, you will receive a confirmation pop-up. Confirming, in this case, means deleting all captured information on the system level and removing all designed information on the system level.

One last consideration to consider when removing the system is to determine whether your captured system was already part of the Create and Deploy phase of eMagiz. If that was the case, additional measures are needed to properly clean up the system and all related information in the Deploy phase of eMagiz. In that case, you need to Delete your runtime in Deploy on all three environments. More on how to do so can be found in this microlearning. Make note that is an advanced action that only a model owner can perform within your project. If you did not yet transfer the integration and the system to the Create phase, this action is unnecessary as the runtime does not exist in the Deploy phase.

Armed with this knowledge, you can make the correct decision in cases where you consider cleaning up the captured integration.

4. Key takeaways

  • There are four essential considerations before cleaning up a captured integration:
  • Is the integration/flow not mentioned anymore in any alerting in Manage?
  • Is the integration removed from all releases?
  • Is the integration removed from Create?
  • Is the eMagiz data model (i.e., CDM, API Gateway Data model) cleaned?
  • Before deletion, eMagiz will ask for confirmation
  • Deletion means that you cannot get it back anymore

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.