Changes for page 210 - Deployment Delights
Last modified by Carlijn Kokkeler on 2024/04/18 13:08
From version 95.1
edited by Erik Bakker
on 2023/04/11 09:30
on 2023/04/11 09:30
Change comment:
There is no comment for this version
To version 63.1
edited by Erik Bakker
on 2023/01/18 10:13
on 2023/01/18 10:13
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
Details
- Page properties
-
- Title
-
... ... @@ -1,1 +1,1 @@ 1 -19 5-EasterParty1 +190 - Fast Forward - Content
-
... ... @@ -2,81 +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!** I nthelastfew weeks,wehavefocused on wrapping up theprevious quarterandstartingthenewone.Whenthishappens, we gosilentfora few weeksto planforthepcomingquarterduring our PI rituals. This timewe addedthe famous"Hackathon"toheendofthePIweeksowe couldstarttheEasterbreak with excellentspiritaftersolvingseveralsmallerfeedbackitemsandbugsreportedby you. Severalof thosestorieswillbeincluded inhisand the upcomingrelease.Ontopofthat,weintroducevariousimprovementstoourAPI Gateway patternandour 3rd generation runtime architecture.Subsequently, wewillrelease aewruntimeimagesupporting themultiple improvements.5 +**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 as well as some small improvements. This release is characterized by the major steps we took to release several major features on our 3rd generation runtime among which are the queue browser and message redelivery functionality. 6 6 7 -== ** APIimprovements** ==7 +== **Queue Browser** == 8 8 9 -//__Improved auto-generated error handling__// 10 -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. 9 +{{warning}}Note that this functionality only works when your JMS server is running on the 3rd generation runtime{{/warning}} 11 11 12 -//__Switch default message format__// 13 -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. 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 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. 14 14 15 -//__Re-using elements in gateway message__// 16 -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. 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. 17 17 18 -//__Improved naming of API operations when adding integrations to Create__// 19 -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. 15 +[[image:Main.Images.Release Blog.WebHome@190-release-blog--queue-browser-overview.png]] 20 20 21 - == **3rd generation improvements**==17 +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. 22 22 23 -//__Update of the static alerting engine__// 24 -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. 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. 25 25 26 -//__Add "Data pipeline" functionality__// 27 -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. 30 +[[image:Main.Images.Release Blog.WebHome@190-release-blog--queue-browser-explore-overview.png]] 28 28 29 -//__Fix related to the debugger__// 30 -This release introduces a fix that allows users to debug a flow once the toggle "Send error messages to eMagiz" is activated. 32 +[[image:Main.Images.Release Blog.WebHome@190-release-blog--queue-browser-wiretap-overview.png]] 31 31 32 - {{warning}}Tomakeuse of thisbugfix, you needto beon thelatest runtimeimage{{/warning}}34 +== **Message Redelivery ** == 33 33 34 -//__Improved migration process__// 35 -This release introduced a fix that allows a user to migrate event processors with custom error handling without manual intervention. 36 +{{warning}}Note that this functionality only works when your JMS server is running on the 3rd generation runtime and the functionality is enabled for you environment.{{/warning}} 36 36 37 -//__Deployment plan change__// 38 -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. 38 +[[image:Main.Images.Release Blog.WebHome@190-release-blog--message-redelivery-overview.png]] 39 39 40 - {{warning}}Shouldyoubeinterestedinmigratingyour model to ournew3rd generation architecture,don'thesitate tocontactusat[[productmanagement@emagiz.com>>mailto:productmanagement@emagiz.com]]orreadour[[documentation>>doc:Main.eMagizAcademy.Fundamentals.fundamental-runtime-generation3||target="blank"]]onthesubject.{{/warning}}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). 41 41 42 - ==**Feedbackitems**==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. 43 43 44 -//__License Tracker improvements__// 45 -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. 44 +On top of that we have added some additional functionality. 46 46 47 -//__Ability to view the message definition for a topic__// 48 -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. 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. 49 49 50 -//__Restricted access for uploading custom certificates to endpoints__// 51 -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. 54 +[[image:Main.Images.Release Blog.WebHome@190-release-blog--message-redelivery-detail-overview.png]] 52 52 53 -== ** Bugfixes** ==56 +== **3rd generation runtime bolstering** == 54 54 55 -//__Improved deletion behavior for enumerations__// 56 -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. 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. 57 57 58 -//__ Prevent"async"api operations__//59 -With this release, we h averemoved theability to select the"async"option when thedefaultmessage formatisAPIManagement.60 +//__Define memory settings for on-premise runtimes from Deploy Architecture__// 61 +With this release, you are now able to 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. 60 60 61 -//__ Importing a responsedefinitionbrokethe request definition__//62 - Currently,importing aresponsedefinitionbreaks therequest definition.With this release,we havechangedthisbehavior,ensuring thatonlytheresponsedefinitionischangedwhenimportingandnot the requestdefinition.63 +//__Empty runtime feedback when deploying a release (or setting the release as active)__// 64 +To prevent that you are not being able to deploy a release to your environment due to a mismatch between what is in your release and in 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. 63 63 64 -//__ Removing aflowdoesnot updatetheAPI"all-entry"anymore__//65 - When you removedaflowfrom Create,theAPI Gateway all-entry receiveda newversion ofthe flow. Withthis release,wehavehangedthisbehavior so that thisonlyhappens whenthe flowyouremoveisanAPI-related flow andnotwhenit is amessaging oreventstreaming flow.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. 66 66 67 -//__Stop deployment plan when a property is missing__// 68 -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. 69 +{{warning}}If you already migrated your JMS flow, you should execute a "Reset" action on the JMS level to get these changes in your model{{/warning}} 69 69 70 -//__ Capstacktraceoferrormessagesandlog entries__//71 - Toprevent thatenormousstack tracesoferrormessagesandlogentriesneed tobeprocessedby varioussystems, we havenowlimitedwhatiskeptsoonlythe relevant information isshowntothe user.71 +//__Removed the ability to add "Debug components" to a flow running in the 3rd generation runtime architecture__// 72 +As of this release, you can no longer add debug components on a flow already migrated to the 3rd generation runtime. This functionality will not work in the 3rd generation runtime and would break your flow. 72 72 74 +//__Deployment plan is updated correctly when completly migrated to the 3rd generation runtime architecture__// 75 +We have fixed a bug that generated an incorrect default deployment plan once you were fully migrated to the 3rd generation runtime. 76 + 77 +//__Correct property generation for Event Streaming flows using the 3rd generation runtime architecture__// 78 +With this release, the properties generated for Event Streaming flows running in the 3rd generation runtime are configured correctly to mimic the ones in the image. 79 + 80 +//__Added "Reset" functionality__// 81 +With this release, a new functionality has been added for 3rd generation runtimes that allows you to combine several steps into one action, called "Reset runtime." The effect of this action is the same as it currently is in the legacy runtime. 82 + 83 +== **Feedback items ** == 84 + 85 +We have also solved other feedback items besides the flow designer's critical updates. 86 + 87 +//__Improved naming convention on Store related pages__// 88 +We have improved various display names using the merge functionality within our store offering. 89 + 90 +//__Update security protocols for our internal architecture__// 91 +Parts of our internal infrastructure (i.e., docs.emagiz.com) have been updated to adhere to the latest security standards. 92 + 93 +//__Improved read-only description for "if exists" constructions in Transformations__// 94 +To make it clear what the "if exists" check does while not being in "Start Editing" mode, we have improved the description so users without edit rights or without wanting to enter the "Start Editing" mode can read and interpret what the check does. 95 + 96 + 97 +== **Bug fixes ** == 98 + 99 +//__Decent validation feedback when not filling in the property value__// 100 +We have fixed the validation feedback you get when not filling in the property value using the "Check properties" functionality. 101 + 102 +//__Incorrect resource locations__// 103 +We have fixed several instances where the resource location was not generated correctly in the 3rd generation runtime. 104 + 105 +//__Apply to environment in User Management performance improvement__// 106 +We have improved the performance of updating User Management on your environment. This way, the update functionality is more stable and faster. 107 + 73 73 == **Fancy Forum Answers** == 74 74 75 75 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: 76 76 77 -* [[Entry stops polling occasionally since generation 3>>https://my.emagiz.com/p/question/172825635703376768||target="blank"]] 78 -* [[Invalid datetime>>https://my.emagiz.com/p/question/172825635703389326||target="blank"]] 79 -* [[Paging with a queue -16>>https://my.emagiz.com/p/question/172825635703389781||target="blank"]] 112 +* [[Is eMagiz able to read XSD attributes>>https://my.emagiz.com/p/question/172825635703236146||target="blank"]] 113 +* [[Does eMagiz use ActiveMQ?>>https://my.emagiz.com/p/question/172825635703235780||target="blank"]] 114 +* [[Tool for test messages to eMagiz Queues>>https://my.emagiz.com/p/question/172825635703236227||target="blank"]] 115 +* [[How to Remove Cloud Container>>https://my.emagiz.com/p/question/172825635703236460||target="blank"]] 80 80 81 81 == **Key takeaways** == 82 82