Skip to Content

Changes for page 213 - Joyful Journeys

Last modified by Carlijn Kokkeler on 2024/04/18 13:07
From version 189.1
edited by Carlijn Kokkeler
on 2023/10/23 14:49
Change comment: There is no comment for this version
To version 104.1
edited by Erik Bakker
on 2023/04/13 14:30
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -207 - Aligned State
1 +195 - Easter Party
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.CarlijnKokkeler
1 +XWiki.ebakker
Content
... ... @@ -2,105 +2,106 @@
2 2  {{container layoutStyle="columns"}}(((
3 3  [[image:Main.Images.Release Blog.WebHome@release-blog-intro.png]]
4 4  
5 -**Hi there, eMagiz developers!** We have done much work for state generation, so that you can derive more information from your data! Examples are enrichment, aggregation, change detection and duplicate detection. State generation functionality is only accessible for models with an add-on state generation license. Next to state generation, several improvements regarding the alignment of components have been made. Moreover, performance improvements and bug fixes have been implemented. Lastly, a change in the metrics storage duration has been performed.
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 6  
7 -== **State Generation** ==
7 +== **Release properties** ==**
8 8  
9 -//__New components__//
10 -The following components have been added:
11 -* Aggregator: reverse of the splitter, used to combine multiple messages into a single one.
12 -* Infinispan metadata outbound channel adapter: Used to (temporarily) store metadata, which can be used to enrich messages, or make decisions in filters or scripts.
13 -* Content enricher: used to add properties to the payload of messages, similar to what the header enricher can do for headers.
14 -* Duplicate detector: Support object used to detect duplicate messages for a certain key on an inbound channel of a flow component. Duplicates can be marked or discarded.
15 -* Infinispan support objects, supporting the aggregator, metadata outbound channel adapter and content enricher.
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-generation3||target= "blank"]].
16 16  
17 -//__SpEL functions & JSON__//
18 -Added SpEL functions for:
19 -* Encoding & decoding Base64, Hex and hmac.
20 -* Date retrieval (currentDateTime, currentEpochMilli, currentEpochSecond).
21 -* Date conversion (DateTime to Epoch, Epoch to DateTime, DateTime formatter and DateTime parser).
11 +As of now you can not only view all property values related to a specific release by pressing the wrench icon. You can also create what we call a "property release" on each of the three environment that allows you to quickly change one or more property values and deploy the changes to your environment. When deploying such a release eMagiz will check on which runtimes the properties are used and only execute the deploy actions for the machines to which said runtime(s) belong(s).
22 22  
23 -Added support for SpEL property accessors for XML and JSON, meaning that you can read message payloads in SpEL expressions easily. For example, to retrieve the value for 'id' in the following JSON String: `{"id":"123"}`, this SpEL expression suffices: `payload.id`.
13 +{{video attachment="release-blog-easter-party--release-properties.mp4" reference="Main.Videos.Microlearning.WebHome"/}}
24 24  
25 -Added support for `#JsonPath` usage in SpEL expressions.
15 +{{info}}The following considerations need to be taken into account when using this functionality:
16 +* This functionality works from the moment one runtime is running on the 3rd generation runtime architecture
17 +* This functionality can only change property values. Functional changes need a seperate release that needs to be promoted
18 +* In comparison to standard releases a property release can be created on each environment (as the property value is linked to a specific environment).
19 +* While changing a property in a ‘property’ release, users also have the option to alter the value in the Deploy-Properties list. By default, this is set to Yes, because when a new release is created, the values of Deploy-Properties will be used and not properties of an earlier release. When a user closes the screen for editing a property, the change will immediately be implemented.
20 +* The auto-clean release functionality is unaffected by this change, ‘property’ releases will not be counted as a release.
21 +* There is a maximum of twenty-six ‘property’ releases. (twenty-six letters of the alphabet)
22 +* Only the latest release can be edited. This can be identified by checking the suffix. The suffix with the latest letter of the alphabet is editable.{{/info}}
26 26  
27 -//__New image version 2.0.0__//
28 -The above functionality are features of the new image version 2.0.0. Important to note is that the library used for Code Mappings has been changed. Changed the library used for Code Mappings. Any customer with Gen3 runtimes and code mappings is required to reset their infra flows prior to deploying on image 2.0.0.
24 +== **API improvements** ==
29 29  
26 +//__Improved auto-generated error handling__//
27 +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.
30 30  
31 -== **Metrics Storage Duration** ==
32 -
33 -
34 -
29 +//__Switch default message format__//
30 +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.
35 35  
36 -== **Feedback Items** ==
32 +//__Re-using elements in gateway message__//
33 +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.
37 37  
38 -//__Alerting manual pause__//
39 -A few releases ago we changed the behavior of alerting in the deployment plan. Now each time when a deployment plan is executed the alerting will be automatically re-enabled when the deployer closes the deployment plan or closes the web browser. The majority of the users are happy with the new behavior, but there are some use cases that you do not want start the alerting immediately. With this release, if alerting has been paused manually, this will not be activated automatically after a release deployment.
35 +//__Improved naming of API operations when adding integrations to Create__//
36 +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.
40 40  
41 -//__Ordering of graphs in Manage__//
42 -The graphs in Manage are now ordered according to importance. This means that runtime statistics are sorted by "Process CPU usage" (highest first), queue statistics are sorted by "Messages in queue" (highest first), and HTTP statistics are sorted by "Unsuccessful requests" (highest first).
38 +== **3rd generation improvements** ==
43 43  
44 -//__UTC times in Grafana panels__//
45 -All Grafana panels now show UTC times, which are normally used in eMagiz, instead of local (browser) time zones. This way, it is easier to match graphs with logging events or alerts.
40 +//__Update of the static alerting engine__//
41 +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.
46 46  
47 -//__Update flow designer version__//
48 -The framework used in the flow designer has been updated, improving performance.
43 +//__Add "Data pipeline" functionality__//
44 +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.
49 49  
50 -//__Carwash track TLS versions in logging__//
51 -A new logging feature will be released, enabling us to make better choices in deprecating old encryption standards.
46 +//__Fix related to the debugger__//
47 +This release introduces a fix that allows users to debug a flow once the toggle "Send error messages to eMagiz" is activated.
52 52  
53 -//__Moving channels in the flow designer__//
54 -Moving already attached channels in the flow designer has been made sligthly easier.
49 +{{warning}}To make use of this bug fix, you need to be on the latest runtime image{{/warning}}
55 55  
56 -//__Topic sizes description change__//
57 -In the change description (and History) when altering the topic size of a topic the new and old value were switched around creating confusion, this has been resolved.
51 +//__Improved migration process__//
52 +This release introduced a fix that allows a user to migrate event processors with custom error handling without manual intervention.
58 58  
59 -//__Password change notification__//
60 -When an account password change request is made, even when this fails, a mail is sent to the account owner to inform the owner about the action.
54 +//__Deployment plan change__//
55 +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.
61 61  
62 -//__Password comparison__//
63 -When changing a password, it is compared to a list of known database breaches for security. A warning is shown when the password corresponds with a password in the database.
57 +{{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}}
64 64  
65 -//__Inactive user alerting__//
66 -Inactivated users are now removed from all alert settings (included “disabled“ settings) to avoid undesirable notifications.
59 +== **Feedback items ** ==
67 67  
68 -//__Alphabetical sorting on user level in HTTP statistics__//
69 -Variables in the 3rd generation runtimes HTTP statistics detail pages are now sorted case insensitive.
61 +//__License Tracker improvements__//
62 +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.
70 70  
64 +//__Ability to view the message definition for a topic__//
65 +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.
71 71  
72 -== **Bug Fixes** ==
67 +//__Restricted access for uploading custom certificates to endpoints__//
68 +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.
73 73  
74 -//__Flow designer styling__//
75 -The styling of the flow designer's left component panel has been restructured, solving a rare bug which would break the styling of certain functionalities.
70 +== **Bug fixes ** ==
76 76  
77 -//__Partial search for messages__//
78 -It is now possible to search on messages partially in Manage Monitoring. For example, a search for Uptime can be done by searching for "up" "time" "ptim".
72 +//__Improved deletion behavior for enumerations__//
73 +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.
79 79  
80 -//__Disk usage after cloud template update__//
81 -In the last cloud template update there was an issue with disk performance. This has been resolved in this release. You can manually upgrade your cloud template, or rely on automatic updates.
75 +//__Prevent "async" api operations__//
76 +With this release, we have removed the ability to select the "async" option when the default message format is API Management.
82 82  
83 -//__Error handling migration__//
84 -If there is no custom error handling, when migrating to Gen3, the error channel to “errorChannel” is only created for the first inbound in an entry flow. This has been fixed by adding a migration step, where we set the error channel of all inbounds in a flow to “errorChannel” if the custom error handling is set to false.
78 +//__Importing a response definition broke the request definition__//
79 +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.
85 85  
81 +//__Removing a flow does not update the API "all-entry" anymore__//
82 +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.
83 +
84 +//__Stop deployment plan when a property is missing__//
85 +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.
86 +
87 +//__Cap stack trace of error messages and log entries__//
88 +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.
89 +
86 86  == **Fancy Forum Answers** ==
87 87  
88 88  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:
89 89  
90 -* [[JSON Web Tokens (JWT authentication)>>https://my.emagiz.com/p/question/172825635703606919||target="blank"]]
91 -* [[Determining container sizes & reading architecture pages>>https://my.emagiz.com/p/question/172825635703594204||target="blank"]]
92 -* [[SFTP connectivity - supported algorithms>>https://my.emagiz.com/p/question/172825635703607141||target="blank"]]
93 -* [[Deploy property release results in missing flows in runtime>>https://my.emagiz.com/p/question/172825635703607354||target="blank"]]
94 -* [[MessageDeliveryException: Dispatcher has no subscribers>>https://my.emagiz.com/p/question/172825635703619797||target="blank"]]
94 +* [[Entry stops polling occasionally since generation 3>>https://my.emagiz.com/p/question/172825635703376768||target="blank"]]
95 +* [[Invalid datetime>>https://my.emagiz.com/p/question/172825635703389326||target="blank"]]
96 +* [[Paging with a queue -16>>https://my.emagiz.com/p/question/172825635703389781||target="blank"]]
95 95  
96 -
97 97  == **Key takeaways** ==
98 98  
99 -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:
100 +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:
100 100  
101 101  * If you have questions surrounding our Program Increment Planning, please get in touch with [[productmanagement@emagiz.com>>mailto:academy@emagiz.com]]
102 102  * If you have feedback or ideas for us, talk to the Platypus
103 -* Please inform us of new additions to the store ([[productmanagement@emagiz.com>>mailto:academy@emagiz.com]]) so we can all benefit from these.
104 +* Please inform us of new additions to the store ([[productmanagement@emagiz.com>>mailto:academy@emagiz.com]]) so we can all benefit from these.
104 104  * Clear your browser cache (Ctrl + Shift + Del)
105 105  * Check out the release notes [here]
106 106  * Start thinking about how the license tracker can aid your development
... ... @@ -113,6 +113,6 @@
113 113  {{info}}
114 114  ~* Indicates a Beta feature. If you would like to get access to this beta feature, please contact [[productmanagement@emagiz.com>>mailto:academy@emagiz.com]]
115 115  
116 -~*~* Indicates a next-generation-architecture only feature.
117 +~*~* Indicates a GEN3-only feature.
117 117  {{/info}})))((({{toc/}}))){{/container}}
118 118  {{/container}}