Changes for page 210 - Deployment Delights
Last modified by Carlijn Kokkeler on 2024/04/18 13:08
From version 86.1
edited by eMagiz
on 2023/02/28 11:57
on 2023/02/28 11:57
Change comment:
There is no comment for this version
To version 61.1
edited by Erik Bakker
on 2023/01/18 09:52
on 2023/01/18 09:52
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 -19 3- Fan Out1 +190 - Fast Forward - Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki.e Magiz1 +XWiki.ebakker - Content
-
... ... @@ -2,71 +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 nthelastcoupleof weeks,weworkedhard on APIimprovementsand 3rd generationimprovementsforyou all tosee. AmongsttheAPI improvementswe now introducetheoptiontodefineREST/XML structures in your API gateway foryourAPI callersto call.This brings moreoptionsotheusercommunity inttingupthe API Gatewaystructurein accordanceiththe needs and desiresof theclient.Ontopof that we havereleasedseveral3rd generationimprovements. Amongst thesewewilladdWS-Security functionalitytotheruntime andimprovementson viewingreleaseproperties.Furthermorewehavereleasednewcloudtemplatesto improve securityinourcurrentruntime and improvethe auto-healingfor 3rd generation runtimecloud slots. Last but notleastwe release the first adaptation of "State generation" thatcan beimplemented withthehelp ofusin yourmodel. In the upcoming montswewill gatherfeedbackfromactual client casesndimproveon thisfunctionality.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 -== ** RESTXML forAPI Gateway** ==7 +== **Queue Browser** == 8 8 9 -{{warning}}Note that a decisionneedstobe madeto selectXMLor JSONasdefaultformatforallyouroperationshosted in yourAPI Gateway.{{/warning}}9 +{{warning}}Note that this functionality only works when your JMS server is running on the 3rd generation runtime{{/warning}} 10 10 11 -To enhance your options whendevelopinganAPIgatewaythatcanbecalledby otherswenowintroducetheoption toselectXMLas the defaultmessageformat onyourAPI Gatewaypattern. You candothis underDesign-> Settings->APIManagement.Inhere you can selectandeditthesettings.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. 12 12 13 - [[image:Main.Images.ReleaseBlog.WebHome@193-release-blog--rest-xml-default-setting.png]]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 of your actual message that pass through the queue from the moment you pressed the Wiretap button. 14 14 15 - Every operationdeafter thisdecision will default to XML (or JSON which isstill thedefault).Should you want to support JSON on someoperations and XML on others you can selectadefault and manually correct the mediaType for the requests and responses towhich it matters.15 +[[image:Main.Images.Release Blog.WebHome@190-release-blog--queue-browser-overview.png]] 16 16 17 - [[image:Main.Images.ReleaseBlog.WebHome@193-release-blog--rest-xml-change-media-type-setting.png]]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. 18 18 19 -==**Cloud Template update** == 20 - 21 -===Cloud Template R23 - Single Lane === 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. 22 22 23 - This release introduces a new cloud templateforall our customers running inasingle-lanesetup in the 2nd generation runtime.This cloud templatewill updatesomespecific security settings on these cloud slots.Thecompletereleasenotes on the cloud template can be found [[here>>doc:Main.ReleaseInformation.Cloud Templates.WebHome||target="blank"]]30 +[[image:Main.Images.Release Blog.WebHome@190-release-blog--queue-browser-explore-overview.png]] 24 24 25 - ===CloudTemplateR6-SingleLane===32 +[[image:Main.Images.Release Blog.WebHome@190-release-blog--queue-browser-wiretap-overview.png]] 26 26 27 - Thisrelease introducesnew cloud template for all our customers runningin a single-lanesetup in the 3rdgeneration runtime. This cloud template will improvethe auto-healing functionalityofthese cloud slots. The complete release notes on the cloud template can be found [[here>>doc:Main.Release Information.Cloud Templates.WebHome||target="blank"]]34 +== **Message Redelivery ** == 28 28 29 - ===CloudTemplateR6-DoubleLane===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}} 30 30 31 - This release introduces a new cloud template for all our customers runningin a double-lane setupinthe 3rd generation runtime.This cloud templatewill improvethe auto-healing functionality of thesecloud slots.Thecompletereleasenotes on the cloud templatecan befound [[here>>doc:Main.Release Information.Cloud Templates.WebHome||target="blank"]]38 +[[image:Main.Images.Release Blog.WebHome@190-release-blog--message-redelivery-overview.png]] 32 32 33 - ==**WS-Security on the3rdgeneration runtime**~*~*==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). 34 34 35 - To furtherimproveour offeringonthe3rd generationruntimewe nowalsohave addedthe necessaryfunctionalitytoallow youtocallSOAP endpointswhileutilizingWS-SecurityaswellassecuringyourhostedSOAPendpoint through WS-Security protocols.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. 36 36 37 - ==**StateGeneration~*~* ==44 +On top of that we have added some additional functionality. 38 38 39 -With this release we introduce our first "State Generation" functionality to our user community. After rigorous internal testing and use we have now made a stride to also make it available to the user community on specific use case. In the following months we will gather feedback on this to further improve and release it in a simpler and more user friendly way to the user community. 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. 40 40 41 - {{info}}Should you beterestedin this functionalityor want tolearn morepleasecontact ust productmanagement@emagiz.com{{/info}}54 +[[image:Main.Images.Release Blog.WebHome@190-release-blog--message-redelivery-detail-overview.png]] 42 42 56 +== **3rd generation runtime bolstering** == 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. 59 + 60 +//__SOAP and REST web services migration, including splitting them__// 61 +With this release, we have released the migration process that will allow you to migrate SOAP and REST web services to the 3rd generation runtime. At the same time, you can directly split the all-entry to eliminate that construction. A specific migration path for this will be published in the documentation portal. 62 + 63 +//__Changing SSL settings for 3rd generation runtime models works__// 64 +As with the current runtime architecture, you can change the SSL settings if needed for a model running in the 3rd generation runtime. 65 + 66 +//__Improved migration for JMS flows__// 67 +This release will improve the migration of JMS flows when migrating to the 3rd generation runtime. 68 + 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}} 70 + 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. 73 + 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 + 43 43 == **Feedback items ** == 44 44 45 -//__Removed OData as option for an API Gateway operation__// 46 -With this release, we have removed the OData operation option as it was not used and was not fully supported anymore by the platform. 85 +We have also solved other feedback items besides the flow designer's critical updates. 47 47 48 -//__ ChangesinAPI Gatewayoperationpathsis automaticallyupdatedin Create__//49 -W henyou changeyourpathon a hostedAPI Gateway we will now automaticallyupdate theaccompanying component inyourCreate(all-)entry.87 +//__Improved naming convention on Store related pages__// 88 +We have improved various display names using the merge functionality within our store offering. 50 50 51 -{{warning}}Make sure to check the changes and create a new version afterward to deploy the changes.{{/warning}} 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. 52 52 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 + 53 53 == **Bug fixes ** == 54 54 55 -//__ PreventendlessloopinDeploy -> UserManagement__//56 -W ith this release,wehavechanged theway we updatepropertieswhenusermanagementisupdatedfor an API gatewayusing theAPI Key securitymechanisms. This willpreventtheendlessloop that couldnow happen on occasion.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. 57 57 58 -{{warning}}Any operation that is incorrectly deleted from Deploy while still end up in the logic and could cause issue so pay attention when removing API Gateway operations.{{/warning}} 102 +//__Incorrect resource locations__// 103 +We have fixed several instances where the resource location was not generated correctly in the 3rd generation runtime. 59 59 60 -//__ Updateerrorhandling duringmigrationto the3rdgenerationruntime__//61 - Asofnowthe errorhandlingofallflowsis correctlyupdated whilstmigratingto the3rdgenerationruntimeconfiguration.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. 62 62 63 63 == **Fancy Forum Answers** == 64 64 65 65 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: 66 66 67 -* [[Access Spring ApplicationContext within Groovy Script>>https://my.emagiz.com/p/question/172825635703325469||target="blank"]] 68 -* [[Configuration problem: Failed to locate '$autoCreateChannelCandidates'>>https://my.emagiz.com/p/question/172825635703312551||target="blank"]] 69 -* [[503 on SOAP Webservice hosted in eMagiz>>https://my.emagiz.com/p/question/172825635703325386||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"]] 70 70 71 71 == **Key takeaways** == 72 72