Changes for page 216 - Hack Heaven

Last modified by CarlijnKokkeler on 2024/04/18 13:04

From version 80.1
edited by Erik Bakker
on 2023/02/09 08:53
Change comment: There is no comment for this version
To version 417.1
edited by Erik Bakker
on 2024/03/11 15:16
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -191 - Fifty Fifty
1 +216 - Hack Heaven
Content
... ... @@ -1,150 +1,136 @@
1 1  {{container}}
2 -{{container layoutStyle="columns"}}(((
2 +{{container layoutStyle="columns"}}
3 +(((
3 3  [[image:Main.Images.Release Blog.WebHome@release-blog-intro.png]]
4 4  
5 -**Hi there, eMagiz developers!** In the last couple of weeks we had our quarterly "hackathon" in which we fixed a series of annoying bugs and introduced many small improvements. On top of that we also finished several additional features for our 3rd generation runtime that will make your life while running on the 3rd generation runtime easier and better manageable. Among the additional features we have the dynamic alerting and the debugger functionality.
6 +**Hi there, eMagiz developers!** As part of our alignment week, we also had a hackathon event focusing on a wide array of reported feedback on the portal. The majority of the release blog will be focused on this. On top of that, we launch new functionality that makes it easier to transform to JSON, select infra flows in a release, and deploy multiple agents to a single machine that adheres to specific conditions. But before we dive into all that has changed, we will publish several announcements via this release blog (and other channels) to prepare your model for upcoming major changes.
6 6  
7 -== **Dynamic Alerts** ~*~* ==
8 +== ** Announcement - TLS versions deprecated** ==
8 8  
9 -{{warning}}Note that depending on the alert this functionality will only work when your JMS server is running on the 3rd generation runtime{{/warning}}
10 +Placeholder for info from Bas
10 10  
11 -To enhance the observability of your integration landscape while running in the 3rd generation runtime architecture, we have added a new feature to our Manage phase called "Dynamic Alerts." You can access this functionality via the "Alerting" menu in Manage. Then, with the help of the "Trigger" overview, you can view all triggers on your environment. On the top of the list you will see all "static" alerts as defined by eMagiz. Below that you will see all "dynamic" alerts that you and your fellow teammembers (with sufficient rights) can view, edit and delete.
12 +{{info}}Text{{/info}}
12 12  
13 -We offer alerting on five types.
14 +== **Announcement - Spring 6** ==
14 14  
15 -* Error message
16 -* Log message
17 -* Queue consumers
18 -* Messages in queue
19 -* Queue throughput
16 +In the next release, we expect to release a major version of our current runtime base image. This image moves the eMagiz stack from Java 8 to Java 17, and from Spring Framework 5 to Spring Framework 6. Although eMagiz will try to make the transition as smooth as possible, we recommend that you start with the following preparations.
20 20  
21 -[[image:Main.Images.Release Blog.WebHome@191-release-blog--dynamic-alert-trigger-options.png]]
18 +{{warning}}
19 +* Make sure that your release is running on the **latest** flow versions. After the release of the new image, eMagiz will push new flow versions of components that have changes. These new flow versions must be included in the subsequent release. Having your release already on the **latest** flow versions makes this less affecting
20 +* To help you identify which flow versions are especially important here, you can consider all flows that contain any of the following components:
21 +** Simple job launcher (data pipelines)
22 +** Job explorer (data pipelines)
23 +** HTTP components message sender (support object)
24 +** Web service outbound gateway (with a 'message sender' attribute specified)
25 +** SFTP session factory (support object)
26 +** API gateways with OAuth2 as security mechanism.
27 +* We recommend identifying flows with (advanced) custom Groovy scripts. As our Java version changes and the Spring version changes, this may affect the availability of the libraries on the classpath, and therefore the validity of import statements. You can already test the Groovy script using the flow testing functionality as flow testing is already running on the Java 17 and Spring Framework 6 baseline.
28 +** In addition, the groovy version used has been moved from version 3.0.19 to 4.0.18. These changes may affect your scripts as well. These release notes outline the major changes
29 +* The code handling SFTP file transfer has been overhauled completely. Although this should not affect you, we encourage you to test your SFTP integrations before deploying to Production.{{/warning}}
22 22  
23 -These five options give you the option to configure more or less the same as you are currently used to when configuring triggers. Once you make a choice for a type you can press the "Next" button to fill in the details of the trigger. One example of how this can look is shown below.
24 24  
25 -[[image:Main.Images.Release Blog.WebHome@191-release-blog--dynamic-alert-trigger-input.png]]
32 +== **Infra flow selection** ==
26 26  
27 -Once the trigger tab is filled in you can navigate to the "Output" tab to select the recipients for the trigger you are configuring. On top of that you can reduce the number of message at which congestion control is enabled if ten is too high for you.
34 +This release will include a significant update to our release functionality, which allows you to configure your release. Presently, eMagiz will allow you to see changes on the infra-flow level visually.
28 28  
29 -[[image:Main.Images.Release Blog.WebHome@191-release-blog--dynamic-alert-trigger-output.png]]
36 +[[image:Main.Images.Release Blog.WebHome@release-216-hack-heaven--infra-flow-comparison.png]]
30 30  
31 -== **Debugger ** ~*~* ~* ==
38 +In edit mode, you can select a new version via the right-click option, which you already use for other flows.
32 32  
33 -{{warning}}Note that this functionality only works when the following criteria are met.
34 -* Your JMS server is running on the 3rd generation runtime
35 -* The store item called "3rd generation debugger" is imported in the infra flow of each runtime for which you want the ability to debug
36 -* A new release is created that includes the flow changes and this release is deployed to the environment(s){{/warning}}
40 +[[image:Main.Images.Release Blog.WebHome@release-216-hack-heaven--infra-flow-selection.png]]
37 37  
38 -As with our current offering, we now offer a functionality with which you can debug channels and see them via the eMagiz portal. As stated above to get to this point you need to execute several steps to get your model ready to be "debugged". Once you have done this you can activate the "debug" mode, via Deploy -> Containers for **one** specific flow **per** runtime that is of particular interest to you. Once you have done this you will see a pop-up telling you whether the "debug" mode was indeed activated or not.
42 +We have also added a title to each context menu that specifies the flow type (e.g., exit connector, container infra, connector infra) for additional clarity while constructing your release.
39 39  
40 -[[image:Main.Images.Release Blog.WebHome@191-release-blog--debugger-action-success.png]]
44 +[[image:Main.Images.Release Blog.WebHome@release-216-hack-heaven--context-menu-title.png]]
41 41  
42 -[[image:Main.Images.Release Blog.WebHome@191-release-blog--debugger-action-failure.png]]
46 +== **Multiple environments selection** ==
43 43  
44 -Assuming it was activated correctly you can navigate to Manage -> Explore -> Queue browser and select the emagiz.debug queue to see the messages coming through.
48 +{{warning}}The following is only applicable under the following conditions:
49 + * Windows 2022 server
50 + * At least one port opened (as a consequence of a hosted web service){{/warning}}
45 45  
46 -[[image:Main.Images.Release Blog.WebHome@191-release-blog--debugger-output-queue-browser.png]]
52 +When configuring your Deploy Agent, you now have an additional option that the user can activate. This checkbox unlocks the possibility of stability when running multiple deploy agents on one machine.
47 47  
48 -{{info}}Note the following limitations when working with the debugger.
49 - * Your entire model needs to be migrated to the 3rd generation runtime
50 - * Only **one** flow **per** runtime can be debugged **per** environment
51 - * There is only **one** overview in which **all** debugged messages are shown
52 - * Message payload in excess of 100KB are not shown in the queue browser as they constitute a "large message"
53 - * The debug functionality works for a period of five minutes in which you can use the refresh button to see new messages coming in.
54 - ** After five minutes the debug functionality will be shutdown automatically under water.
55 - ** To see new messages after the five minutes you will have to access the debug functionality again from scratch.{{/info}}
54 +[[image:Main.Images.Release Blog.WebHome@release-216-hack-heaven--multiple-environments.png]]
56 56  
57 -== **Volume mapping - Network Share** ==
56 +== **Feedback Items** ==
57 +//__Easier component selection in flow designer__//
58 +The area selector through which you can select one or more components has improved to allow for an easier selection of said components when displayed close to the edge of the canvas. Expanding the area allows you to select these components, which will become much easier.
58 58  
59 -This release will introduce an additional functionality within our [[volume mapping>>doc:Main.eMagiz Academy.Microlearnings.Novice.File based connectivity.novice-file-based-connectivity-volume-mapping-on-premise||target="blank"]] offering. With this additional configuration option you can configure a network share and configure it to create a mapping between a network share and a docker volume.
60 +//__Improved handling of optionality in JSON on lists__//
61 +Previously, eMagiz always created a JSON array if your data model expected a list. This led to unexpected and undesirable behavior of the message, as empty arrays are not always accepted by external parties.
60 60  
61 -[[image:Main.Images.Release Blog.WebHome@191-release-blog--volume-mapping-network-share-overview.png]]
63 +With this release, we have changed the way in which we generate the JSON output should there be an empty list. Consequently, the empty list will **not** be part of the output anymore, as desired.
62 62  
63 -[[image:Main.Images.Release Blog.WebHome@191-release-blog--volume-mapping-network-share-detail.png]]
65 +//__Loading bar when searching for log entries__//
66 +To indicate to the user that eMagiz is still busy retrieving log entries, we have added a loading bar to the log entry overview upon pressing search.
64 64  
65 -== **Feedback items ** ==
68 +//__Improved feedback when deleting elements from Capture__//
69 +To better specify to the user which integration or system the user intends to delete, we have improved the text in the confirmation pop-up. This way, we can provide more information to the user to avoid mistakes.
66 66  
67 -We have also solved other feedback items besides the flow designer's critical updates.
71 +//__Enhanced filter options in Manage__//
72 +With this release, we have added filter options on both the Alerting tab and the Trigger configuration pop-up. This allows users to filter on Status (Alerting) and Queues, Topics, Recipients, and more (Trigger configuration pop-up) in these places.
68 68  
69 -//__Show status on machine level under Deploy Architecture__//
70 -With this release we are now able to show the status of the machine when opening the "Details" overview on machine level in Deploy -> Architecture.
74 +//__Copy property names from Create__//
75 +This release unlocks the possibility of easily copying the name of a property placeholder so it can be used while deploying.
71 71  
72 -//__Improved validation feedback on non-supported WSS4J interceptor __//
73 -We have improved the validation feedback when someone tries to implement a specific WSS4J interceptor implementation.
77 +//__Improved feedback during migration to the current runtime architecture__//
78 +Should you try to migrate the JMS before any other runtime under Create -> Settings, we have improved the feedback. This feedback will tell you why you cannot migrate in this order.
74 74  
75 -//__Improve help text in flow testing on Java classes__//
76 -We have improved the helptext when you are adding headers to your test message. In this helptext we explain the top five Java classes and how to note them down to make it work in the flow testing functionality and in eMagiz in general.
80 +//__Block user from making changes to their cloud while another upgrade is still in progress__//
81 +We now block users from changing their cloud configuration when another upgrade is ongoing.
77 77  
78 -//__Improved readibility of notification when trying to delete a runtime__//
79 -When you have forgotten one or more steps when deleting a runtime you will be notified by the system on this. With this release we have improved the readibility of the notification.
83 +//__Cron trigger validation__//
84 +We have added a validation check upon saving a cron expression in the Flow Designer to avoid flows not starting due to a misconfigured cron expression.
80 80  
81 -//__Improved sorting of missing properties overview__//
82 -We have improved the sorting on the missing properties overview you will encounter when activating the "check properties" option.
86 +== **Bug Fixes** ==
87 +//__Making Edit (and View) the default action when configuring parameters__//
88 +We have made the Edit (and View) button the default action when configuring parameters in a transformation.
83 83  
84 -//__Improved notification when error message cannot be found__//
85 -We have improved the notification when an error message cannot be found from the message redelivery overview in our 3rd generation runtime.
90 +//__Property configuration pop-up resized__//
91 +We have resized the property configuration overviews to make the property value better readable.
86 86  
87 -//__Additional lifecycle management overview__//
88 -We have added an additional lifecycle management overview to the portal in which users with enough permissions can get an overview of the lifecycle "state" of all customer models.
93 +//__Alphabetically sorted components in the flow designer__//
94 +As of this release, we now sort the components alphabetically in the flow designer.
89 89  
90 -//__Improved feedback when memory settings are negative__//
91 -We have added an additional check that validates whether memory settings on a specific container are of a negative value. In these cases you will be blocked from applying the changes to the environment as this won't lead to a working solution.
96 +//__Improved sorting on runtime overview__//
97 +As of this release, we now sort the runtimes in the runtime overview correctly by time. This means that the runtime with a changed status, closest to the current date and time, is shown at the top of the list. This should reduce the chance of overlooking a critical mistake.
92 92  
93 -//__Auto upgrade for a cloud template default to "ON"__//
94 -For each new cloud slot we will toggle the "automtatic cloud template update" to "Yes".
99 +//__Improved sorting on catalog overview__//
100 +As of this release, we now sort the topics in the catalog by name.
95 95  
96 -//__Removed an irrelevant refresh button on a flow designer component__//
97 -We have removed an irrelevant refresh button on the standard filter component.
102 +//__Styling fix on rich text editors__//
103 +Rich text editors are used in various parts of the portal. This release fixes a broken styling configuration that made it difficult to fill in information in these editors.
98 98  
99 -//__Notification list shows all notifications on default__//
100 -When navigating to the Notification overview in Manage under Alerting you will now see all notifications instead of a filtered list on a specific state.
105 +//__Styling fix on release edit__//
106 +As of this release, the correct icon (green) will be shown when wanting to add a second API operation under the same "header."
101 101  
102 -== **Bug fixes ** ==
108 +//__Removed false-positive alerts on transformations__//
109 +When transforming a string to a non-empty string, eMagiz would also show an alert even if the user made a check to avoid an empty string as output. This behavior is now corrected. This will significantly reduce the number of alerts you will see as a user within the context of your transformation.
103 103  
104 -//__Keep selection when copying properties__//
105 -We have fixed the bug that prevented you from easily copying properties from one runtime to another based on the runtime list.
111 +//__Event Streaming Graphs - view thirty days back__//
112 +Just like the other views, we now also provide the user with a default thirty-day window to analyze relevant statistics related to event streaming further.
106 106  
107 -//__Check on security header improved for API Gateway__//
108 -We improved the check in the API Gateway through which we validate whether an API caller is authenticated when using the API Key method to secure the API Gateway.
114 +//__Improved helptext__//
115 +We have improved various help texts across the portal to indicate better what should be filled in for specific fields.
109 109  
110 -//__Don't show systems with only "external" flows in Design__//
111 -We fixed a bug that caused systems to appear in Design in cases where there should be none.
112 -
113 -//__Fix styling of mendix login in some occurences__//
114 -When navigating to a specific URL the default Mendix login page would be shown. With this release we have fixed this behavior.
115 -
116 -//__Change timing of wake-up of cloud slots on Friday__//
117 -To prevent timing issues of waking up cloud slots on the Friday of our deployment we have changed the timing of when the cloud slots are woken up on Friday.
118 -
119 -//__Fixed a typo in the Topic statistics overview__//
120 -We fixed a typo in the topic statistics overview.
121 -
122 -//__Fixed a typo in the HTTP statistics overview__//
123 -We fixed a typo in the HTTP statistics overview.
124 -
125 -//__Activatation of release history when executing a deployment__//
126 -We ensured that the release history is activated when executing a deployment.
127 -
128 128  == **Fancy Forum Answers** ==
129 129  
130 130  As always, this is a gentle reminder to ask questions via the Q&A forum. The Q&A forum is available in the eMagiz iPaaS portal, so we can all benefit from the knowledge within the community. For some inspiration, take a look at these forum answers:
131 131  
132 -* [[Characters transformed to � when retrieving from DataSink>>https://my.emagiz.com/p/question/172825635703287019||target="blank"]]
133 -* [[Can I test my API Gateway locally?>>https://my.emagiz.com/p/question/172825635703236592||target="blank"]]
134 -* [[Deploy stops when updating connector-infra>>https://my.emagiz.com/p/question/172825635703299903||target="blank"]]
121 +* [[XSD is only partially imported into eMagiz (xmlStat.xsd)>>https://my.emagiz.com/p/question/172825635703773349||target="blank"]]
135 135  
136 -== **Key takeaways** ==
123 +== **Key Takeaways** ==
137 137  
138 -Thanks to all that helped build and those who tested and gave feedback to improve the product. To end this post, here are some key takeaways for you:
125 +Thanks to all who helped build and those who tested and gave feedback to improve the product. To end this post, here are some key takeaways for you:
139 139  
140 140  * If you have questions surrounding our Program Increment Planning, please get in touch with [[productmanagement@emagiz.com>>mailto:academy@emagiz.com]]
141 141  * If you have feedback or ideas for us, talk to the Platypus
142 -* Please inform us of new additions to the store ([[productmanagement@emagiz.com>>mailto:academy@emagiz.com]]) so we can all benefit from these.
129 +* Please inform us of new additions to the store ([[productmanagement@emagiz.com>>mailto:academy@emagiz.com]]) so we can all benefit from these.
143 143  * Clear your browser cache (Ctrl + Shift + Del)
144 144  * Check out the release notes [here]
145 145  * Start thinking about how the license tracker can aid your development
146 146  * Start thinking about major, minor, and patch
147 -* Upgrade to the latest build number
148 148  * Keep making great integrations
149 149  
150 150  Let's stay in touch and till next time!
... ... @@ -152,6 +152,11 @@
152 152  {{info}}
153 153  ~* Indicates a Beta feature. If you would like to get access to this beta feature, please contact [[productmanagement@emagiz.com>>mailto:academy@emagiz.com]]
154 154  
155 -~*~* Indicates a GEN3-only feature.
156 -{{/info}})))((({{toc/}}))){{/container}}
141 +{{/info}}
142 +)))
143 +
144 +(((
145 +{{toc/}}
146 +)))
157 157  {{/container}}
148 +{{/container}}