Changes for page 213 - Joyful Journeys
Last modified by Carlijn Kokkeler on 2024/04/18 13:07
From version 70.1
edited by Erik Bakker
on 2023/01/18 11:05
on 2023/01/18 11:05
Change comment:
There is no comment for this version
To version 209.1
edited by Carlijn Kokkeler
on 2023/10/24 11:24
on 2023/10/24 11:24
Change comment:
There is no comment for this version
Summary
-
Page properties (3 modified, 0 added, 0 removed)
Details
- Page properties
-
- Title
-
... ... @@ -1,1 +1,1 @@ 1 - 190 -FastForward1 +207 - Aligned State - Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. ebakker1 +XWiki.CarlijnKokkeler - Content
-
... ... @@ -2,125 +2,117 @@ 2 2 {{container layoutStyle="columns"}}((( 3 3 [[image:Main.Images.Release Blog.WebHome@release-blog-intro.png]] 4 4 5 -**Hi there, eMagiz developers!** Ithas beena while since our lastdeployment on the9th ofDecember.Asresultwehavefinished upalotof newimprovements toour3rd generation runtime offeringandfixed a varietyofannoying bugsas wellassome small improvements. This releaseis characterized by themajor steps wetookto release several major featuresonour3rdgenerationruntimeamongwhicharethequeue browser andmessageredelivery functionality.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. 6 6 7 - ==**QueueBrowser**~*~* ==7 +{{warning}}State generation functionality is only accessible for models with an add-on state generation license.{{/warning}} 8 8 9 - {{warning}}Note that thisfunctionalityonlyworkswhenyourJMS server isrunningon the3rdgenerationruntime{{/warning}}9 +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. 10 10 11 - Toenhancethe observability of your integrationlandscapewhile running in the3rd generationruntime architecture we have added a new feature to our Manage phase called the "Queue browser". You can access this functionality via the "Explore" menu option in Manage. With the help of the queue browser you can, as the name suggests, browse your queue.11 +== **State Generation~*~*** == 12 12 13 -To do so, we offer two options within this functionality. We have the Explore function and we have the Wiretap function. When selecting a queue and opting for the Explore option you get a live view of what data is currently present on the queue. When selecting the Wiretap functionality you automatically wiretap your queue and are presented with copies (on a special queue) of your actual message that pass through the queue from the moment you pressed the Wiretap button. 13 +//__New components__// 14 +The following components have been added: 15 +* Aggregator: reverse of the splitter, used to combine multiple messages into a single one. 16 +* Infinispan metadata outbound channel adapter: used to (temporarily) store metadata, which can be used to enrich messages, or make decisions in filters or scripts. 17 +* Content enricher: used to add properties to the payload of messages, similar to what the header enricher can do for headers. 18 +* 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. 19 +* Infinispan support objects, supporting the aggregator, metadata outbound channel adapter and content enricher. 14 14 15 -[[image:Main.Images.Release Blog.WebHome@190-release-blog--queue-browser-overview.png]] 21 +//__SpEL functions & JSON__// 22 +Added SpEL functions for: 23 +* Encoding & decoding Base64, Hex and hmac. 24 +* Date retrieval (currentDateTime, currentEpochMilli, currentEpochSecond). 25 +* Date conversion (DateTime to Epoch, Epoch to DateTime, DateTime formatter and DateTime parser). 16 16 17 -A fterselectingthequeueandchoosingtheoption eMagizwill showyouthelist ofmessages(oldestfirst)thatarecurrently onthequeue (Exploreoption)orhat passedthequeuesincethemoment you activatetheoption(Wiretapoption).Foreach message you have variousoptions atyourdisposal.27 +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`. 18 18 19 -* Delete the message from the queue (Explore option) 20 - ** This means throwing away live data which can be helpful in a test or acceptance environment where you inadvertedly put a lot of messages on a queue. 21 -* Clear message from the wiretap queue (Wiretap option) 22 - ** Once you are done with the analysis of a certain message in the wiretap functionality you can clear it from the overview so it does not clutter the view anymore 23 -* Refresh messages list (both options) 24 - ** By pressing this button you can refresh the list of messages that are displayed to you. Note that the list is sorted in such a way that the oldest messages are shown first 25 -* Save as test message 26 - ** By pressing this button you can save the message and use it in our flow testing functionality in Create. Note that we link the message to the corresponding flow if we can. Should we not be able to do so we link the message to your model so you can still use it in the flow testing functionality. 27 -* Download 28 - ** By pressing this button you can download the message and use it outside of the tooling should that be needed. 29 +Added support for `#JsonPath` usage in SpEL expressions. 29 29 30 - [[image:Main.Images.ReleaseBlog.WebHome@190-release-blog--queue-browser-explore-overview.png]]31 +{{info}}The components are all configurable from the Flow Designer in Create and are accompanied by a help text explaining the use cases and the various technical configurations. Note that to make the components work in your model, a new release containing the latest image (2.0.0) needs to be deployed.{{/info}} 31 31 32 -[[image:Main.Images.Release Blog.WebHome@190-release-blog--queue-browser-wiretap-overview.png]] 33 +== **Metrics Storage Duration** == 34 +We will change the retention of monitoring data of different environments. For minute level data, it will be kept for test, acceptance and production environments for 7, 14 and 30 days respectively. Then the minute level data will be reduced to hour level data then will be stored for test, acceptance and production for 3, 6 and 12 months respectively. 33 33 34 - == **MessageRedelivery ** ~*~* ==36 +[[image:Main.Images.Release Blog.WebHome@release-blog-207-aligned-state-metrics-storage.png]] 35 35 36 - {{warning}}Notethat this functionality only works when your JMS server is running on the 3rdgenerationruntimeand the functionality isenabled for you environment.{{/warning}}38 +== **Feedback Items** == 37 37 38 -[[image:Main.Images.Release Blog.WebHome@190-release-blog--message-redelivery-overview.png]] 40 +//__Import from store__// 41 +The button 'Import from Store' in Design will directly open the store instead of showing a pop asking whether the store should be opened. 39 39 40 -Just as with our current offering we now offer our message redelivery functionality for our 3rd generation architecture. To enhance the user experience we have placed this functionality as well under the "Explore" option in Manage. When selecting the message redelivery option you will see all messages that are currently in need to be redelivered (as an error occurred). 43 +//__Save and cancel buttons placement__// 44 +The save and cancel buttons have been placed slightly further apart from each other to avoid misclicking. 41 41 42 -Just as in the current functionality you can select a specific message and retry (or delete) it. The same can be done for all messages at once. Following that you can still see the linked error message as you could before. 46 +//__User session times__// 47 +The user session times for 3rd generation runtime dashboards have been extended, so that the user is not thrown out of the model when using the Manage phase for longer than an hour. 43 43 44 -On top of that we have added some additional functionality. 49 +//__Cancel and next buttons order__// 50 +The order of the cancel and next buttons when creating a new trigger has been changed to increase alignment across the platform. Now, all cancel buttons are placed on the right of a 'next' or 'save' button. 45 45 46 -* Search option 47 - ** Original queue name 48 - ** Original message ID (which can be found as a header called jms_messageid in the error message view) 49 -* Save as test message 50 - ** By pressing this button you can save the message and use it in our flow testing functionality in Create. 51 -* Download 52 - ** By pressing this button you can download the message and use it outside of the tooling should that be needed. 52 +//__Data sink page__// 53 +The data sink page has been moved to the “Explore” tab. 53 53 54 -[[image:Main.Images.Release Blog.WebHome@190-release-blog--message-redelivery-detail-overview.png]] 55 +//__Unused images removal__// 56 +When a release is removed, the related unused images in the on-premises machines will be removed as well. 55 55 56 -== **3rd generation runtime bolstering** == 58 +//__Flow Designer performance__// 59 +Performance improvements for the Flow Designer have been implemented. 57 57 58 -This release will introduce various improvements for our 3rd generation runtime. Below you will find the most noteworthy enhancements we made to the 3rd generation runtime and its interaction with the portal. 61 +//__Properties with special characters__// 62 +When a user would migrate to gen3 and deploy their release containing properties with special characters, certain flows could not find the correct values to properties anymore or could not find the properties altogether. With this release, special characters such as a backslash do not break properties after deployment. 59 59 60 -//__ Definememory settingsforon-premiseruntimesfrom Deploy Architecture__//61 -W iththis release, you arenowable to define thememory settings(andthereforethememorylimits)ofyouron-premiseruntimesinthe samemanneras cloud runtimes. Inall cases you can now defineandchangethe memorysettingsviaDeployArchitecture.Incontrasttohow thesevalues are actualized for cloud runtimesyouneedtocreatea new release and deploy it to actualize the changes on-premise.64 +//__Hidden flow fragements__// 65 +When importing items from the store, flow fragments that are hidden in design will be listed under the versions in create. 62 62 63 -//__ Empty runtimefeedback whendeployingarelease (orsetting the release as active)__//64 - To preventthatyouare notbeing abletodeploya release toyournvironmentdue to a mismatchbetween whatisin yourreleaseand in Deploy Architecturewehave nowaddedafeedbackpop-upwhen deploying a releasethatnotifiesyou forwhich runtimesthere ismismatchbetweenyourreleaseand Deploy Architecture.67 +//__Resources disappearances__// 68 +Resources would disappear in the flow designer when pressing Cancel on selecting a new resource. With this release, resources without a name will not trigger error messages when users select components. 65 65 66 -//__Auto-fill namespaces for SOAP hosted webservices__// 67 -Based on your configuration in Design eMagiz will now auto-fill the namespace when you host a SOAP web service. This avoids any potential problems in validating messages. 70 +//__Error channel for all inbounds__// 71 +If there is no custom error handling, Gen3 migration would set the error channel to “errorChannel” only for the first inbound in an entry flow. 72 +We added a migration step, such that the error channel is set to “errorChannel” of all inbounds in a flow if the custom error handling is set to false. 68 68 69 -//__ UpdatedH2 database setting__//70 - As of this release,we have improved the configuration ofour H2 databases that are used within eMagiz. This new settingwillensurethattheruntime controls whenhe H2 databaseisshutdown.74 +//__Highlighting resources__// 75 +The performance of highlighting resources of selected components is improved in Read only mode. 71 71 72 - {{warning}}Ifyoualready migratedyour runtime, you should execute a "Reset"action on the infra flow to get these changes in your model{{/warning}}77 +== **Bug Fixes** == 73 73 74 -//__ Runtime settingsoptionaddedto context menu on runtime level Deploy Architecture__//75 - As a replacementof thecurrentHTTPsettingscontextmenuwehaveaddedanew menu itemcalledruntime settings.Ontop ofbeingableto configureyour HTTPsettings (whichyouneedtodefine forahostedweb service)you nowalso canefinewhether the control bus needstoworkforthis runtime.79 +//__Topic and event-processor names__// 80 +The styling of the event streaming canvas in the Create and Deploy phases has been altered slightly to make topic and event-processor names more readable. 76 76 77 -//__ DeployAgentoption added to contextmenuon machinelevel Deploy Architecture__//78 - With thisrelease,we have added acontextmenuitem that allowsuser to deploytheagent that isneededto runyour3rd generation architectureon-premise.Formoreinformation onhowtoinstallthispleasecheckoutthis[[microlearning>>doc:Main.eMagiz Academy.Microlearnings.ExpertLevel.SolutionArchitecture.expert-solution-architecture-onpremises-installguide.WebHome||target="blank"]]82 +//__System alignment__// 83 +The positioning of Systems across Design, Create and Deploy phases are now synchronized to the position of their respective System in the Capture phase. So, systems are aligned regarding positioning across all phases. 79 79 80 -//__ Performanceimprovementcreatinga release__//81 - Withthisrelease,wehave improved theperformanceofcreatingarelease.85 +//__Error checking__// 86 +Besides checking error header, the error trigger is now configured to check if an error message contains a term. 82 82 83 -== **Feedback items ** == 88 +//__Alerting__// 89 +For gen3 models, you will no longer receive alert messages for every error message, every log message of 'level' ERROR, and for memory usage above 80%. 90 +For gen3 models with event streaming, the threshold to receive the 'Topic approaching maximum size' alert has been increased from 95% of configured size used to 110%. 91 +The gen3 configurable trigger for error messages has been extended with the option to check whether the 'last-exception' message contained a certain text. This can be combined with the header-value match. 84 84 85 -We have also solved other feedback items besides the flow designer's critical updates. 93 +//__Unused containers__// 94 +Containers are set inactive when they are unused and removed in Design. 86 86 87 -//__ Sensitive informationstoredin propertiesismasked__//88 -We havemadehow we displaysensitiveinformationacrosstheportalinthesamemannerfor variouspartsoftheportal.96 +//__Error popups when promoting a release version__// 97 +We fixed an issue that a lot of error popups were shown when you promoted a release version to a next environment. 89 89 90 -//__Importing "Private" store content to which you do not have access__// 91 -We have improved the user feedback a user will get when trying to import a "Private" store item that is not available to the user. 92 - 93 - 94 -== **Bug fixes ** == 95 - 96 -//__Fix possibility that allowed you to break the system message when dealing with the "Order matters" functionality__// 97 -We have fixed the possibility you had that would break your system message upon validating it in Create when using the "Order matters" functionality. 98 - 99 -//__Synchronization of Event Streaming topic states__// 100 -We have fixed synchronization issues that could occur when several changes were executed on a model that uses a fast amount of topics. 101 - 102 -//__Copy and paste default support objects__// 103 -With this release you can now copy and paste components without having to worry that additional support objects that already exist in your target flow are copied over and over into the same flow. 104 - 105 -//__Fix editability of properties when importing store items__// 106 -With this release you can once again change property names upon importing a store item. 107 - 108 108 == **Fancy Forum Answers** == 109 109 110 110 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: 111 111 112 -* [[ Can I changemy 2FA secret, eg. movetoanotherauthenticator?>>https://my.emagiz.com/p/question/172825635703274697||target="blank"]]113 -* [[ Webrequestheader'SOAPAction'>>https://my.emagiz.com/p/question/172825635703274615||target="blank"]]114 -* [[ XPathException onXPATHrouter>>https://my.emagiz.com/p/question/172825635703274295||target="blank"]]115 -* [[ Changepropertywith newreleaseingeneration3 runtimes>>https://my.emagiz.com/p/question/172825635703274441||target="blank"]]103 +* [[Message Redelivery blank error message>>https://my.emagiz.com/p/question/172825635703619933||target="blank"]] 104 +* [[Timeout error kafka batch creation>>https://my.emagiz.com/p/question/172825635703620012||target="blank"]] 105 +* [[SFTP Connectivity: Transfering a whole folder structure>>https://my.emagiz.com/p/question/172825635703632587||target="blank"]] 106 +* [[3rd generation runtime with dynamic file pickup / filedrop>>https://my.emagiz.com/p/question/172825635703632732||target="blank"]] 116 116 108 + 117 117 == **Key takeaways** == 118 118 119 -Thanks to all thathelped build and those who tested and gave feedback to improve the product. To end this post, here are some key takeaways for you:111 +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: 120 120 121 121 * If you have questions surrounding our Program Increment Planning, please get in touch with [[productmanagement@emagiz.com>>mailto:academy@emagiz.com]] 122 122 * If you have feedback or ideas for us, talk to the Platypus 123 -* Please inform us of new additions to the store ([[productmanagement@emagiz.com>>mailto:academy@emagiz.com]]) so we can all benefit from these. 115 +* Please inform us of new additions to the store ([[productmanagement@emagiz.com>>mailto:academy@emagiz.com]]) so we can all benefit from these. 124 124 * Clear your browser cache (Ctrl + Shift + Del) 125 125 * Check out the release notes [here] 126 126 * Start thinking about how the license tracker can aid your development ... ... @@ -133,6 +133,6 @@ 133 133 {{info}} 134 134 ~* Indicates a Beta feature. If you would like to get access to this beta feature, please contact [[productmanagement@emagiz.com>>mailto:academy@emagiz.com]] 135 135 136 -~*~* Indicates a GEN3-only feature.128 +~*~* Indicates a next-generation-architecture only feature. 137 137 {{/info}})))((({{toc/}}))){{/container}} 138 138 {{/container}}