Changes for page Upgrading Build Numbers

Summary

• Page properties (3 modified, 0 added, 0 removed)

Details

Page properties

Title

...	...	@@ -1,1 +1,1 @@
1		-novice-emagiz-store-importing-store-items-design
	1	+novice-lifecycle-management-upgrading-build-numbers

Parent

...	...	@@ -1,1 +1,1 @@
1		-Main.eMagiz Academy.Microlearnings.Novice.eMagiz Store.WebHome
	1	+Main.eMagiz Academy.Microlearnings.Novice.Lifecycle Management.WebHome

Content

...	...	@@ -1,61 +1,78 @@
1	1	{{container}}
2	2	{{container layoutStyle="columns"}}
3	3	(((
4		-In this microlearning, we will learn how you can import store items from the eMagiz store in Design after finding the one for you. This microlearning aims to get you acquainted with the various options of importing a store item in the Design phase of eMagiz.
	4	+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)
5	5
6	6	Should you have any questions, please get in touch with [[academy@emagiz.com>>mailto:academy@emagiz.com]].
7	7
8		-* Last update: April 5th, 2021
	8	+* Last update: May 14th, 2021
9	9	* Required reading time: 5 minutes
10	10
11	11	== 1. Prerequisites ==
12	12
13	13	* Basic knowledge of the eMagiz platform
	14	+* Basic knowledge of the build number component within the eMagiz Platform
14	14
15	15	== 2. Key concepts ==
16	16
17		-The eMagiz Store is a concept in the eMagiz platform that allows users to import reusable content into a specific ILM phase. The Store has elements for each of the model phases Capture, Design, and Create, and is focused on expediting the delivery of integrations for users.
	18	+This microlearning is about cleaning up a captured integration.
18	18
19		-== 3. eMagiz Store - Introduction ==
	20	+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)
20	20
21		-=== 3.1 Store for Create ===
	22	+There are four essential considerations before cleaning up a captured integration:
22	22
23		-The eMagiz store for the Create phase allows users to drag & drop flow fragments into the flow that requires editing. A flow fragment is a combination of 1 or more model components that together can execute a certain piece of work inside that flow. For example, a file pickup that includes an archive option and specific file filters. Or the required components that are needed to send a message to a REST/JSON web service that is secured with OAuth2.0.
	24	+* Is the integration/flow not mentioned anymore in any alerting in Manage?
	25	+* Is the integration removed from all releases?
	26	+* Is the integration removed from Create?
	27	+* Is the eMagiz data model (i.e., CDM, API Gateway Data model) cleaned?
24	24
25		-The Store for the Create phase can be found in the left-hand panel of the Flow designer - at the same location as where you select the model components.
	29	+== 3. Cleanup a captured integration ==
26	26
27		-=== 3.2 Store for Design ===
	31	+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)
28	28
29		-The eMagiz store for the Design phase allows selecting specific operations from available systems such as Exact online, or Salesforce. So these are more datamodel-oriented items and more target/source system oriented. The general idea is that you import store content whilst defining your data model message and System definitions. At that moment, you can select to import one or more message definitions. eMagiz will then guide the user to import the system message definition, as well as to import the mapping between the data model and message definition. A reusable merge definition can be created between the existing data model (CDM, Gateway model, or Event model) and the system definition so that the data model can be updated in a proper way.
	33	+There are four essential considerations before cleaning up a captured integration:
30	30
31		-Please note that when the Store item is selected in this phase, the associated flow fragments for the Create phase are automatically attached to the integration. That means when the integration is transferred to Create these flow fragments will automatically be generated into the appropriate flows. eMagiz considers putting these flow fragments into the right flow depending on the type of flow fragment.
	35	+* Is the integration/flow not mentioned anymore in any alerting in Manage?
	36	+* Is the integration removed from all releases?
	37	+* Is the integration removed from Create?
	38	+* Is the eMagiz data model (i.e., CDM, API Gateway Data model) cleaned?
32	32
33		-* Connectivity flow fragments will be imported in exit gates, entry flow, event processors, and exit flows
34		-* Processing flow fragments will be imported in exit gates, event processors, offramp flows, and onramp flows
35		-* Universal flows can be imported into any flow
	40	+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.
36	36
37		-=== 3.3 Store for Capture ===
	42	+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:
38	38
39		-The eMagiz Store will be expanded to the Capture phase in upcoming quarters. The current idea is to allow the selection of systems and integrations on level up so that the work on Design and Create becomes even easier. Once we have made that step, we'll update this section with the right positioning.
	44	+[[image:Main.Images.Microlearning.WebHome@novice-lifecycle-management-cleanup-a-captured-integration--not-able-to-remove.png]]
40	40
41		-=== 3.4 Content Management for Store items ===
	46	+To remove an integration in Capture, access the context menu (via a right-mouse click) and select Delete integration.
42	42
43		-At this moment, the Store content is provided by the eMagiz team only. The concept of a company or private store is under consideration, and for now, intra-company content can be moderated by the Copy-Paste functionality in the Create phase. Suggestions for new content can be sent to [[productmanagement@emagiz.com>>mailto:productmanagement@emagiz.com]] / questions can be asked via the QA forum which may include feedback on a store item.
	48	+[[image:Main.Images.Microlearning.WebHome@novice-lifecycle-management-cleanup-a-captured-integration--delete-integration.png]]
44	44
45		-=== 3.5 Licensing Store ===
	50	+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.
46	46
47		-Store content can be imported by any user except for store items that are licensed. For instance, the Data Sink is a licensed feature, and the Store item for Data Sink can only be imported in case this license is granted in the integration model.
	52	+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.
48	48
49		-The disclaimer for using Store content can be found here:
	54	+[[image:Main.Images.Microlearning.WebHome@novice-lifecycle-management-cleanup-a-captured-integration--delete-system.png]]
50	50
	56	+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.
	57	+
	58	+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>>doc:Main.eMagiz Academy.Microlearnings.Advanced Level.Lifecycle Management.advanced-lifecycle-management-cleanup-a-deployed-runtime.WebHome||target="blank"]]. Make note that is an advanced action that only a bus 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.
	59	+
	60	+Armed with this knowledge, you can make the correct decision in cases where you consider cleaning up the captured integration.
	61	+
51	51	== 4. Assignment ==
52	52
53		-There is no assignment for this microlearning. Please refer to the next microlearning in this module so that you can experience it properly.
	64	+Determine whether you can clean up a captured integration within your project. If so, execute the cleanup.
	65	+This assignment can be completed with the help of the (Academy) project that you have created/used in the previous assignment.
54	54
55	55	== 5. Key takeaways ==
56	56
57		-* Each phase in eMagiz holds store items that will aid you in building your solution in eMagiz
58		-* eMagiz Store Content will be managed by eMagiz.
	69	+* There are four essential considerations before cleaning up a captured integration:
	70	+ * Is the integration/flow not mentioned anymore in any alerting in Manage?
	71	+ * Is the integration removed from all releases?
	72	+ * Is the integration removed from Create?
	73	+ * Is the eMagiz data model (i.e., CDM, API Gateway Data model) cleaned?
	74	+* Before deletion, eMagiz will ask for confirmation
	75	+* Deletion means that you cannot get it back anymore
59	59
60	60	== 6. Suggested Additional Readings ==
61	61
...	...	@@ -63,7 +63,9 @@
63	63
64	64	== 7. Silent demonstration video ==
65	65
66		-There is no demonstration video of this functionality.)))
	83	+This video demonstrates how you could have handled the assignment and gives you some context on what you have just learned
67	67
	85	+{{video attachment="novice-lifecycle-management-cleanup-a-captured-integration.mp4" reference="Main.Videos.Microlearning.WebHome"/}})))
	86	+
68	68	((({{toc/}}))){{/container}}
69	69	{{/container}}