Last modified by Danniar Firdausy on 2024/09/18 14:37

From version 1.1
edited by eMagiz
on 2022/05/17 09:09
Change comment: There is no comment for this version
To version 5.1
edited by Erik Bakker
on 2022/08/29 14:52
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,0 +1,1 @@
1 +Making clear what you changed (auditability)
Parent
... ... @@ -1,0 +1,1 @@
1 +WebHome
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.marijn
1 +XWiki.ebakker
Default language
... ... @@ -1,0 +1,1 @@
1 +en
Content
... ... @@ -1,20 +1,8 @@
1 -{{html wiki="true"}}
2 -<div class="ez-academy">
3 - <div class="ez-academy_body">
4 -
5 -<div class="doc">
6 -
7 -
8 -
9 -= Making clear what you changed (auditability) =
10 -
1 +{{container}}{{container layoutStyle="columns"}}(((
11 11  As you can imagine, there is a need to know what has changed when working with software tooling. By knowing you can assess the impact of your planned changes within the context of the integration data model. In this microlearning, we will look at what you can do to clarify what you changed within the eMagiz platform.
12 12  
13 -Should you have any questions, please contact academy@emagiz.com.
4 +Should you have any questions, please contact [[academy@emagiz.com>>mailto:academy@emagiz.com]].
14 14  
15 -* Last update: August 4th, 2021
16 -* Required reading time: 6 minutes
17 -
18 18  == 1. Prerequisites ==
19 19  
20 20  * Basic knowledge of the eMagiz platform
... ... @@ -26,24 +26,22 @@
26 26  Auditability is defined as follows: A history trail that depicts who changed what at which moment in time containing an explanation of what has been changed
27 27  
28 28  * The key aspects are:
29 - * The description is your way of communicating the history of the flow
30 - * Using vague descriptions (or placing a dot as description) hurts the auditability
31 - * For all things versioned in eMagiz it is crucial that you supply the correct description
32 - * eMagiz provides audit trails on Architectural overviews (Design and Deploy architecture) including a description
33 - * eMagiz provides audit trails on message definitions and transformations including a description
17 + ** The description is your way of communicating the history of the flow
18 + ** Using vague descriptions (or placing a dot as description) hurts the auditability
19 + ** For all things versioned in eMagiz it is crucial that you supply the correct description
20 + ** eMagiz provides audit trails on Architectural overviews (Design and Deploy architecture) including a description
21 + ** eMagiz provides audit trails on message definitions and transformations including a description
34 34  
35 -
36 -
37 37  == 3. Making clear what you changed (auditability) ==
38 38  
39 39  As you can imagine, there is a need to know what has changed when working with software tooling. By knowing you can assess the impact of your planned changes within the context of the integration data model. In this microlearning, we will look at what you can do to clarify what you changed within the eMagiz platform.
40 40  
41 41  * The key aspects are:
42 - * The description is your way of communicating the history of the flow
43 - * Using vague descriptions (or placing a dot as description) hurts the auditability
44 - * For all things versioned in eMagiz it is crucial that you supply the correct description
45 - * eMagiz provides audit trails on Architectural overviews (Design and Deploy architecture) including a description
46 - * eMagiz provides audit trails on message definitions and transformations including a description
28 + ** The description is your way of communicating the history of the flow
29 + ** Using vague descriptions (or placing a dot as description) hurts the auditability
30 + ** For all things versioned in eMagiz it is crucial that you supply the correct description
31 + ** eMagiz provides audit trails on Architectural overviews (Design and Deploy architecture) including a description
32 + ** eMagiz provides audit trails on message definitions and transformations including a description
47 47  
48 48  === 3.1 Versioning by users ===
49 49  
... ... @@ -74,8 +74,6 @@
74 74  
75 75  In all cases, you will find a History button on the page in question that will guide you to the history (audit trail) of what has changed by whom at which point in time.
76 76  
77 -===== Practice =====
78 -
79 79  == 4. Assignment ==
80 80  
81 81  Check out the history of (one of) your eMagiz data models, one of your flows, and your releases to see if you can determine how they have changed over time.
... ... @@ -83,14 +83,12 @@
83 83  == 5. Key takeaways ==
84 84  
85 85  * The key aspects are:
86 - * The description is your way of communicating the history of the flow
87 - * Using vague descriptions (or placing a dot as description) hurts the auditability
88 - * For all things versioned in eMagiz it is crucial that you supply the correct description
89 - * eMagiz provides audit trails on Architectural overviews (Design and Deploy architecture) including a description
90 - * eMagiz provides audit trails on message definitions and transformations including a description
70 + ** The description is your way of communicating the history of the flow
71 + ** Using vague descriptions (or placing a dot as description) hurts the auditability
72 + ** For all things versioned in eMagiz it is crucial that you supply the correct description
73 + ** eMagiz provides audit trails on Architectural overviews (Design and Deploy architecture) including a description
74 + ** eMagiz provides audit trails on message definitions and transformations including a description
91 91  
92 -
93 -
94 94  == 6. Suggested Additional Readings ==
95 95  
96 96  If you are interested in this topic and want more information please check out the help texts provided by eMagiz.
... ... @@ -97,11 +97,4 @@
97 97  
98 98  == 7. Silent demonstration video ==
99 99  
100 -As this is a more theoretical microlearning we have no video for this.
101 -
102 -</div>
103 -
104 -</div>
105 -</div>
106 -
107 -{{/html}}
82 +As this is a more theoretical microlearning we have no video for this.)))((({{toc/}}))){{/container}}{{/container}}