Changes for page 216 - Hack Heaven

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

From version 98.1
edited by Erik Bakker
on 2023/04/13 08:47
Change comment: There is no comment for this version
To version 422.1
edited by BoukeReitsma
on 2024/03/12 07:59
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -195 - Easter Party
1 +216 - Hack Heaven
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.ebakker
1 +XWiki.BoukeReitsma
Content
... ... @@ -1,99 +1,135 @@
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 few weeks, we have focused on wrapping up the previous quarter and starting the new one. When this happens, we go silent for a few weeks to plan for the upcoming quarter during our PI rituals. This time we added the famous "Hackathon" to the end of the PI week so we could start the Easter break with excellent spirit after solving several smaller feedback items and bugs reported by you. Several of those stories will be included in this and the upcoming release. On top of that, we introduce various improvements to our API Gateway pattern and our 3rd generation runtime architecture. Subsequently, we will release a new runtime image supporting the multiple improvements.
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 -== **Release properties** ==**
8 +== ** Announcement - TLS versions deprecated** ==
8 8  
9 -With this release we bring an improved version of the release properties functionality. With the introduction of the 3rd generation runtime the way properties can be updated and when they need to be available for the solution to start up has changed compared to the current runtime architecture. More on that can be found [[here>>Main.eMagiz Academy.Fundamentals.fundamental-runtime-generation.WebHome||target= "blank"]]
10 +Placeholder for info from Bas
10 10  
11 -== **API improvements** ==
12 +{{info}}Text{{/info}}
12 12  
13 -//__Improved auto-generated error handling__//
14 -When you create a new operation in your API gateway, eMagiz will now automatically generate the correct schemas, HTTP codes, and examples for this operation based on industry standards.
14 +== **Announcement - Spring 6** ==
15 15  
16 -//__Switch default message format__//
17 -We have improved the logic when you switch the message format of your gateway message from XML to JSON or vice versa. As a result, the Swagger file will be changed accordingly. Once you update the relevant flow in Create and deploy the solution, the Swagger UI will automatically match the expected result.
16 +We expect to release a major version of our current runtime base image for all our clients running on the **current runtime** architecture in the next release. 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.
18 18  
19 -//__Re-using elements in gateway message__//
20 -This release improves how the examples and schemas in Swagger and the Flow Testing functionality are generated when certain elements repeatedly appear in different places within one specific gateway message.
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 changed. 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 essential 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 and Spring versions change, 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 +** Additionally, the Groovy version has been moved from 3.0.19 to 4.0.18. These changes may affect your scripts as well. [[These release notes >>https://groovy-lang.org/releasenotes/groovy-4.0.html||target="blank"]] will specify the changes in more detail.
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}}
21 21  
22 -//__Improved naming of API operations when adding integrations to Create__//
23 -Previously when you added API operations to the Create phase, the HTTP operation (i.e., POST, PUT, GET) was not visible to a user. As a result, it became tough for a user to discern between specific operations once multiple of them were used on one resource (i.e., Order, Invoice, Lead). To clarify this for the user, the display name defined in Design (instead of Capture) is now used within this overview for these operations.
31 +== **Infra flow selection** ==
24 24  
25 -== **3rd generation improvements** ==
33 +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.
26 26  
27 -//__Update of the static alerting engine__//
28 -In this release, we have updated the static alerting engine that determines when one of the static alerts, as defined by eMagiz, should be triggered (or not). This change will improve the performance of the solution and will ensure that the alerts are activated correctly.
35 +[[image:Main.Images.Release Blog.WebHome@release-216-hack-heaven--infra-flow-comparison.png]]
29 29  
30 -//__Add "Data pipeline" functionality__//
31 -This release introduces the "data pipeline" functionality to the 3rd generation runtime. This removes another blockage for models waiting on this before migrating to the 3rd generation runtime.
37 +In edit mode, you can select a new version via the right-click option, which you already use for other flows.
32 32  
33 -//__Fix related to the debugger__//
34 -This release introduces a fix that allows users to debug a flow once the toggle "Send error messages to eMagiz" is activated.
39 +[[image:Main.Images.Release Blog.WebHome@release-216-hack-heaven--infra-flow-selection.png]]
35 35  
36 -{{warning}}To make use of this bug fix, you need to be on the latest runtime image{{/warning}}
41 +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.
37 37  
38 -//__Improved migration process__//
39 -This release introduced a fix that allows a user to migrate event processors with custom error handling without manual intervention.
43 +[[image:Main.Images.Release Blog.WebHome@release-216-hack-heaven--context-menu-title.png]]
40 40  
41 -//__Deployment plan change__//
42 -In this release, the prepare release step will not start automatically anymore. This prevents the user from waiting for this action to be finished before they can continue deploying the solution to their environment.
45 +== **Multiple environments selection** ==
43 43  
44 -{{warning}}Should you be interested in migrating your model to our new 3rd generation architecture, don't hesitate to contact us at [[productmanagement@emagiz.com>>mailto:productmanagement@emagiz.com]] or read our [[documentation>>doc:Main.eMagiz Academy.Fundamentals.fundamental-runtime-generation3||target="blank"]] on the subject.{{/warning}}
47 +{{warning}}The following is only applicable under the following conditions:
48 + * Windows 2022 server
49 + * At least one port opened (as a consequence of a hosted web service){{/warning}}
45 45  
46 -== **Feedback items ** ==
51 +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 -//__License Tracker improvements__//
49 -With this release, we have added several new features available to purchase. On top of that, additional information on the license, such as adding notes and seeing the data sink packets, is now available.
53 +[[image:Main.Images.Release Blog.WebHome@release-216-hack-heaven--multiple-environments.png]]
50 50  
51 -//__Ability to view the message definition for a topic__//
52 -Currently, you can easily navigate to the message definition of a topic via the context menu in Design, even if there is no event processor linked to the topic.
55 +== **Feedback Items** ==
56 +//__Easier component selection in flow designer__//
57 +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.
53 53  
54 -//__Restricted access for uploading custom certificates to endpoints__//
55 -To improve our cloud offerings' general security and prevent users from uploading the wrong certificates, we have now restricted access to this view to ensure that only the administrator can execute this change. This allows for a discussion between the team implementing the solution and eMagiz before actions are taken.
59 +//__Improved handling of optionality in JSON on lists__//
60 +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.
56 56  
57 -== **Bug fixes ** ==
62 +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.
58 58  
59 -//__Improved deletion behavior for enumerations__//
60 -To prevent that eMagiz will incorrectly delete enumeration lists when you press a "Cancel" button, we have improved the deletion behavior when viewing enumerations in the Create phase of eMagiz.
64 +//__Loading bar when searching for log entries__//
65 +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.
61 61  
62 -//__Prevent "async" api operations__//
63 -With this release, we have removed the ability to select the "async" option when the default message format is API Management.
67 +//__Improved feedback when deleting elements from Capture__//
68 +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.
64 64  
65 -//__Importing a response definition broke the request definition__//
66 -Currently, importing a response definition breaks the request definition. With this release, we have changed this behavior, ensuring that only the response definition is changed when importing and not the request definition.
70 +//__Enhanced filter options in Manage__//
71 +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.
67 67  
68 -//__Removing a flow does not update the API "all-entry" anymore__//
69 -When you removed a flow from Create, the API Gateway all-entry received a new version of the flow. With this release, we have changed this behavior so that this only happens when the flow you remove is an API-related flow and not when it is a messaging or event streaming flow.
73 +//__Copy property names from Create__//
74 +This release unlocks the possibility of easily copying the name of a property placeholder so it can be used while deploying.
70 70  
71 -//__Stop deployment plan when a property is missing__//
72 -Currently, the execution of your deployment plan continues when eMagiz notices a missing property. As this is confusing for a user and not desirable, we have updated the logic to ensure that when this happens, the execution stops. This allows you to fill in the properties, and once filled in, you can continue with the remainder of the deployment plan.
76 +//__Improved feedback during migration to the current runtime architecture__//
77 +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.
73 73  
74 -//__Cap stack trace of error messages and log entries__//
75 -To prevent that enormous stack traces of error messages and log entries need to be processed by various systems, we have now limited what is kept so only the relevant information is shown to the user.
79 +//__Block user from making changes to their cloud while another upgrade is still in progress__//
80 +We now block users from changing their cloud configuration when another upgrade is ongoing.
76 76  
82 +//__Cron trigger validation__//
83 +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.
84 +
85 +== **Bug Fixes** ==
86 +//__Making Edit (and View) the default action when configuring parameters__//
87 +We have made the Edit (and View) button the default action when configuring parameters in a transformation.
88 +
89 +//__Property configuration pop-up resized__//
90 +We have resized the property configuration overviews to make the property value better readable.
91 +
92 +//__Alphabetically sorted components in the flow designer__//
93 +As of this release, we now sort the components alphabetically in the flow designer.
94 +
95 +//__Improved sorting on runtime overview__//
96 +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.
97 +
98 +//__Improved sorting on catalog overview__//
99 +As of this release, we now sort the topics in the catalog by name.
100 +
101 +//__Styling fix on rich text editors__//
102 +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.
103 +
104 +//__Styling fix on release edit__//
105 +As of this release, the correct icon (green) will be shown when wanting to add a second API operation under the same "header."
106 +
107 +//__Removed false-positive alerts on transformations__//
108 +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.
109 +
110 +//__Event Streaming Graphs - view thirty days back__//
111 +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.
112 +
113 +//__Improved helptext__//
114 +We have improved various help texts across the portal to indicate better what should be filled in for specific fields.
115 +
77 77  == **Fancy Forum Answers** ==
78 78  
79 79  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:
80 80  
81 -* [[Entry stops polling occasionally since generation 3>>https://my.emagiz.com/p/question/172825635703376768||target="blank"]]
82 -* [[Invalid datetime>>https://my.emagiz.com/p/question/172825635703389326||target="blank"]]
83 -* [[Paging with a queue -16>>https://my.emagiz.com/p/question/172825635703389781||target="blank"]]
120 +* [[XSD is only partially imported into eMagiz (xmlStat.xsd)>>https://my.emagiz.com/p/question/172825635703773349||target="blank"]]
84 84  
85 -== **Key takeaways** ==
122 +== **Key Takeaways** ==
86 86  
87 -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:
124 +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:
88 88  
89 89  * If you have questions surrounding our Program Increment Planning, please get in touch with [[productmanagement@emagiz.com>>mailto:academy@emagiz.com]]
90 90  * If you have feedback or ideas for us, talk to the Platypus
91 -* Please inform us of new additions to the store ([[productmanagement@emagiz.com>>mailto:academy@emagiz.com]]) so we can all benefit from these.
128 +* Please inform us of new additions to the store ([[productmanagement@emagiz.com>>mailto:academy@emagiz.com]]) so we can all benefit from these.
92 92  * Clear your browser cache (Ctrl + Shift + Del)
93 93  * Check out the release notes [here]
94 94  * Start thinking about how the license tracker can aid your development
95 95  * Start thinking about major, minor, and patch
96 -* Upgrade to the latest build number
97 97  * Keep making great integrations
98 98  
99 99  Let's stay in touch and till next time!
... ... @@ -101,6 +101,11 @@
101 101  {{info}}
102 102  ~* Indicates a Beta feature. If you would like to get access to this beta feature, please contact [[productmanagement@emagiz.com>>mailto:academy@emagiz.com]]
103 103  
104 -~*~* Indicates a GEN3-only feature.
105 -{{/info}})))((({{toc/}}))){{/container}}
140 +{{/info}}
141 +)))
142 +
143 +(((
144 +{{toc/}}
145 +)))
106 106  {{/container}}
147 +{{/container}}