Remove flows from Create

Last modified by Erik Bakker on 2024/08/26 12:02

In this microlearning, we’ll cover the process of removing flows from the Create phase in eMagiz. This action is crucial for managing your integration lifecycle, whether you're cleaning up outdated flows or correcting mistakes. We’ll walk you through how to remove flows, what to consider before doing so, and how to ensure a smooth process.

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

1. Prerequisites

  • Basic knowledge of the eMagiz platform

2. Key concepts

This microlearning centers around removing flows from Create.
With removing from Create, we mean: Throwing away all previous work out of Create without keeping track of the history of the flow

  • The action removes the flows from the Create overview without containing the history
  • The action is a prerequisite for removing the integration in Capture (after it was already Created once)
  • Before you execute the action ensure that all references to the old flows are removed from Deploy

3. Remove flows from Create

In this microlearning, we will focus on how to remove flows from Create and what things to consider before you remove your flows from Create. Whether you want to remove a flow for ever as it has become outdated as part of your lifecycle management or whether you want to temporarily remove and later re-add your flow you can do so with the help of this functionality. 

Key parts with regards to this functionality are:

  • The action removes the flows from the Create overview without containing the history
  • The action is a prerequisite for removing the integration in Capture (after it was already Created once)
  • Before you execute the action ensure that all references to the old flows are removed from Deploy

As you can imagine there is a need to be able to remove flows from Create after they have previously build. The main reason would be that the system that was once connected to your integration landscape is no longer used or has become out dated. As part of the lifecycle management of your integration landscape we advice to remove those integrations from the Create phase. This functionality helps you with that. Do note that removing a flow from Create is a prerequisite of removing the integration (line) in Capture and Design. So to do proper lifecycle management you start at Manage and work your way back to Capture to correctly and completely remove the solution from your integration landscape.

Warning

Note that to remove a flow from Create that has been deployed before you first need to remove the flow from all Releases in Deploy before you can remove the flow in question. For more information please check out this microlearning (Explanation)

Another potential use case for this functionality is when you have made a mistake in Design or Capture with regards to directionality or naming. In those cases you can also remove the flows from Create and re-add it on a later moment in time when those aspects are configured properly. Do note that not all configuration changes in Design or Capture need to be preceeded by removing the flows from Create. In general most of what is in Design and Capture can be changed after an integration has been moved to Create. The exceptions to this rule are:

  • Technical name of the system and/or integration
  • Directionality (does eMagiz send data to the system or does it receive data from the system)
  • The chosen integration pattern (i.e. Event Streaming, API Gateway or Messaging)
  • Whether the integration is synchronous or asynchronous

All in all, there are various reasons why you might consider to remove flows from Create. To remove flows from Create you navigate to the Create phase and press on the button located at the left-hand bottom of the screen called Add integrations. This action will lead you to the following overview

novice-flow-management-remove-flows-from-create--add-integrations-overview-create.png

In this overview you can see which integrations have not yet been added (indicated by the empty box with a green line) and you can see which integrations have been added to Create (indicated by the blue box with the checkmark). Those integrations that have been added previously are candidates for removal. You can remove the integration from Create by clicking on it. The widget will indicate the intended action by turning the blue box with the checkmark to a red box with a cross in the middle.

novice-flow-management-remove-flows-from-create--add-integrations-overview-candidate-for-removal.png

The moment you are satisfied with your choices you should press the Save selection button, located on the left-hand bottom of the screen. As a result eMagiz will notify you whether the removal has been succesfull or not. This way you now whether your action was succesful. Afterwards you can go back to the Create overview by clicking on the Go to Create option.

novice-flow-management-remove-flows-from-create--add-integrations-removal-conformation-pop-up.png

Now you have learned how to remove a flow from Create. As always think before you start to randomly remove stuff from Create as you cannot get it back anymore.

4. Key takeaways

A (deployment) package consists of three parts:

  • The action removes the flows from the Create overview without containing the history
  • The action is a prerequisite for removing the integration in Capture (after it was already Created once)
  • Before you execute the action ensure that all references to the old flows are removed from Deploy

5. Suggested Additional Readings