Cleanup a captured integration
In this microlearning, we’ll cover the final step of cleaning up a captured integration. A captured integration refers to the detailed setup of data traffic between a system and eMagiz. We'll walk you through the crucial considerations to ensure a thorough cleanup, including checking its status across various phases and verifying that all related data models are up to date. By following these steps, you can ensure that the integration is fully and effectively removed from your eMagiz environment.
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:
To remove an integration in Capture, access the context menu (via a right-mouse click) and select Delete integration.
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.
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