Changes for page 207 - Aligned State

Last modified by Carlijn Kokkeler on 2024/04/18 13:10

From 71.1 to 70.1 From 104.1 to 103.1

From version 103.1

edited by Erik Bakker
on 2023/04/13 14:29

Change comment: There is no comment for this version

To version 71.1

edited by Erik Bakker
on 2023/01/18 11:11

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (2 modified, 0 added, 0 removed)

Details

Page properties

Title

@@ -1,1 +1,1 @@
--195 - Easter Party
++190 - Fast Forward

Content

@@ -2,98 +2,117 @@
  {{container layoutStyle="columns"}}(((
  [[image:Main.Images.Release Blog.WebHome@release-blog-intro.png]]
--**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.
++**Hi there, eMagiz developers!** It has been a while since our last deployment on the 9th of December. As a result, we have finished up a lot of new improvements to our 3rd generation runtime offering and fixed a variety of annoying bugs and some minor enhancements. This release is characterized by the significant steps we took to release several major features on our 3rd generation runtime, including the queue browser and message redelivery functionality.
--== **Release properties** ==**
++== **Queue Browser** ~*~* ==
--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"]].
++{{warning}}Note that this functionality only works when your JMS server is running on the 3rd generation runtime{{/warning}}
--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).
++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 the "Queue browser." You can access this functionality via the "Explore" menu in Manage. Then, with the help of the queue browser, you can browse your queue as the name suggests.
--{{video attachment="release-blog-easter-party--release-properties.mp4" reference="Main.Videos.Microlearning.WebHome"/}}
++To do so, we offer two options within this functionality. First, 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 the current data in the queue. Then, when choosing the Wiretap functionality, you automatically wiretap your queue and are presented with copies (on a particular queue) of your actual message that passes through the queue from the moment you press the Wiretap button.
--{{info}}The following considerations need to be taken into account when using this functionality:
--* This functionality works from the moment one runtime is running on the 3rd generation runtime architecture
--* This functionality can only change property values. Functional changes need a seperate release that needs to be promoted
--* In comparison to standard releases a property release can be created on each environment (as the property value is linked to a specific environment).
--* 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.
--* The auto-clean release functionality is unaffected by this change, ‘property’ releases will not be counted as a release.
--* There is a maximum of 26 ‘property’ releases. (26 letters of the alphabet)
--* 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}}
++[[image:Main.Images.Release Blog.WebHome@190-release-blog--queue-browser-overview.png]]
--== **API improvements** ==
++After selecting the queue and choosing the option, eMagiz will show you the list of messages (oldest first) that are currently on the queue (Explore option), or that passed the queue since the moment you activate the option (Wiretap option). For each message, you have various options at your disposal.
--//__Improved auto-generated error handling__//
--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.
++* Delete the message from the queue (Explore option)
++  ** This means throwing away live data, which can be helpful in a test or acceptance environment where you inadvertently put many messages on a queue.
++* Clear message from the wiretap queue (Wiretap option)
++  ** Once you are done with the analysis of a specific message in the wiretap functionality, you can clear it from the overview so it does not clutter the view anymore
++* Refresh messages list (both options)
++  ** By pressing this button, you can refresh the list of messages displayed to you. Note that the list is sorted in such a way that the oldest messages are shown first
++* Save as test message
++  ** 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.
++* Download
++  ** By pressing this button, you can download the message and use it outside of the tooling should that be needed.
--//__Switch default message format__//
--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.
++[[image:Main.Images.Release Blog.WebHome@190-release-blog--queue-browser-explore-overview.png]]
--//__Re-using elements in gateway message__//
--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.
++[[image:Main.Images.Release Blog.WebHome@190-release-blog--queue-browser-wiretap-overview.png]]
--//__Improved naming of API operations when adding integrations to Create__//
--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.
++== **Message Redelivery ** ~*~* ==
--== **3rd generation improvements** ==
++{{warning}}Note that this functionality only works when your JMS server is running on the 3rd generation runtime, and the functionality is enabled for your environment.{{/warning}}
--//__Update of the static alerting engine__//
--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.
++[[image:Main.Images.Release Blog.WebHome@190-release-blog--message-redelivery-overview.png]]
--//__Add "Data pipeline" functionality__//
--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.
++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 under the "Explore" option in Manage. When selecting the message redelivery option, you will see all messages that currently need to be redelivered (as an error occurred).
--//__Fix related to the debugger__//
--This release introduces a fix that allows users to debug a flow once the toggle "Send error messages to eMagiz" is activated.
++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.
--{{warning}}To make use of this bug fix, you need to be on the latest runtime image{{/warning}}
++On top of that, we have added some additional functionality.
--//__Improved migration process__//
--This release introduced a fix that allows a user to migrate event processors with custom error handling without manual intervention.
++* Search option
++  ** Original queue name
++  ** Original message ID (which can be found as a header called jms_messageid in the error message view)
++* Save as test message
++  ** By pressing this button, you can save the message and use it in our flow testing functionality in Create.
++* Download
++  ** By pressing this button, you can download the message and use it outside of the tooling should that be needed.
--//__Deployment plan change__//
--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.
++[[image:Main.Images.Release Blog.WebHome@190-release-blog--message-redelivery-detail-overview.png]]
--{{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}}
++== **3rd generation runtime bolstering** ==
--== **Feedback items ** ==
++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.
--//__License Tracker improvements__//
--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.
++//__Define memory settings for on-premise runtimes from Deploy Architecture__//
++With this release, you can now define the memory settings (and, therefore, the memory limits) of your on-premise runtimes in the same manner as cloud runtimes. In all cases, you can now define and change the memory settings via Deploy Architecture. In contrast to how these values are actualized for cloud runtimes, you need to create a new release and deploy it to actualize the changes on-premise.
--//__Ability to view the message definition for a topic__//
--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.
++//__Empty runtime feedback when deploying a release (or setting the release as active)__//
++To prevent you are not being able to deploy a release to your environment due to a mismatch between what is in your release and Deploy Architecture, we have now added a feedback pop-up when deploying a release that notifies you for which runtimes there is a mismatch between your release and Deploy Architecture.
--//__Restricted access for uploading custom certificates to endpoints__//
--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.
++//__Auto-fill namespaces for SOAP hosted webservices__//
++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.
--== **Bug fixes ** ==
++//__Updated H2 database setting__//
++As of this release, we have improved the configuration of our H2 databases used within eMagiz. This new setting will ensure the runtime controls when the H2 database is shut down.
--//__Improved deletion behavior for enumerations__//
--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.
++{{warning}}If you already migrated your runtime, you should execute a "Reset" action on the infra flow to get these changes in your model{{/warning}}
--//__Prevent "async" api operations__//
--With this release, we have removed the ability to select the "async" option when the default message format is API Management.
++//__Runtime settings option added to context menu on runtime level Deploy Architecture__//
++As a replacement for the current HTTP settings context menu, we added a new menu item called runtime settings. On top of being able to configure your HTTP settings (which you need to define for a hosted web service), you now also can define whether the control bus needs to work for this runtime.
--//__Importing a response definition broke the request definition__//
--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.
++//__Deploy Agent option added to context menu on machine level Deploy Architecture__//
++With this release, we have added a context menu item allowing users to deploy the agent needed to run your 3rd generation architecture on-premise. For more information on installing this, please check out this [[microlearning>>doc:Main.eMagiz Academy.Microlearnings.Expert Level.Solution Architecture.expert-solution-architecture-onpremises-installguide.WebHome||target="blank"]]
--//__Removing a flow does not update the API "all-entry" anymore__//
--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.
++//__Performance improvement creating a release__//
++With this release, we have improved the performance of creating a release.
--//__Stop deployment plan when a property is missing__//
--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.
++== **Feedback items ** ==
--//__Cap stack trace of error messages and log entries__//
--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.
++We have also solved other feedback items besides the flow designer's critical updates.
++//__Sensitive information stored in properties is masked __//
++We have made how we display sensitive information across the portal similar for various parts of the portal.
++
++//__Importing "Private" store content to which you do not have access__//
++We have improved the user feedback a user will get when trying to import a "Private" store item unavailable to the user.
++
++
++== **Bug fixes ** ==
++
++//__Fix the possibility that allowed you to break the system message when dealing with the "Order matters" functionality__//
++We have fixed the possibility you had that would break your system message upon validating it in Create when using the "Order matters" functionality.
++
++//__Synchronization of Event Streaming topic states__//
++We fixed synchronization issues that could occur when several changes were executed on a model that uses a fast amount of topics.
++
++//__Copy and paste default support objects__//
++With this release, you can now copy and paste components without worrying that additional support objects already existing in your target flow are copied over and over into the same flow.
++
++//__Fix editability of properties when importing store items__//
++With this release, you can once again change property names upon importing a store item.
++
  == **Fancy Forum Answers** ==
  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:
--* [[Entry stops polling occasionally since generation 3>>https://my.emagiz.com/p/question/172825635703376768||target="blank"]]
--* [[Invalid datetime>>https://my.emagiz.com/p/question/172825635703389326||target="blank"]]
--* [[Paging with a queue -16>>https://my.emagiz.com/p/question/172825635703389781||target="blank"]]
++* [[Can I change my 2FA secret, eg. move to another authenticator?>>https://my.emagiz.com/p/question/172825635703274697||target="blank"]]
++* [[Webrequest header 'SOAPAction'>>https://my.emagiz.com/p/question/172825635703274615||target="blank"]]
++* [[XPathException on XPATH router>>https://my.emagiz.com/p/question/172825635703274295||target="blank"]]
++* [[Change property with new release in generation 3 runtimes>>https://my.emagiz.com/p/question/172825635703274441||target="blank"]]
  == **Key takeaways** ==

Changes for page 207 - Aligned State

Summary

Details

Navigation