Changes for page 216 - Hack Heaven
Last modified by CarlijnKokkeler on 2024/04/18 13:04
From version 88.1
edited by eMagiz
on 2023/02/28 13:18
on 2023/02/28 13:18
Change comment:
There is no comment for this version
To version 423.1
edited by Erik Bakker
on 2024/03/12 14:01
on 2024/03/12 14:01
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 -1 93-FanOut1 +216 - Hack Heaven - Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki.e Magiz1 +XWiki.ebakker - Content
-
... ... @@ -1,87 +1,138 @@ 1 1 {{container}} 2 -{{container layoutStyle="columns"}}((( 2 +{{container layoutStyle="columns"}} 3 +((( 3 3 [[image:Main.Images.Release Blog.WebHome@release-blog-intro.png]] 4 4 5 -**Hi there, eMagiz developers!** Inthe lastcoupleofweeks, weworkedhardon API improvementsand3rd generationimprovementsfor youall tosee. Amongstthe API improvementswenowintroducetheoption to defineREST/XML structures in yourAPI gatewayforyourAPI callerstocall. Thisbringsmore optionsto theusercommunity in setting up theAPI Gatewaystructurein accordancewiththeneedsanddesires ofthe client. On top of that wehave released several 3rd generationimprovements. Amongst thesewewill add WS-Securityfunctionality to the runtimeand improvementson viewingreleaseproperties.Furthermore wehavereleasednew cloudtemplates toimprove securityinour currentruntimeandimprovetheauto-healingfor 3rdgenerationruntime cloudslots.Last butnot leastwereleasethe first adaptationof "Stategeneration" thatcanbe implementedwiththehelpof us inyour model. Inthe upcoming montswe will gatherfeedbackfromactual client casesandimprove onthisfunctionality.6 +**Hi there, eMagiz developers!** As part of our alignment week, we also had a hackathon event focusing on a wide array of reported feedback on the portal. The majority of the release blog will be focused on this. On top of that, we launch new functionality that makes it easier to transform to JSON, select infra flows in a release, and deploy multiple agents to a single machine that adheres to specific conditions. But before we dive into all that has changed, we will publish several announcements via this release blog (and other channels) to prepare your model for upcoming major changes. 6 6 7 -== ** RESTXMLforAPI Gateway** ==8 +== ** Announcement - TLS versions deprecated** == 8 8 9 - {{warning}}Note that adecision needs to bemade to selectXMLorJSONasdefault formatforall your operationshostedinyourAPI Gateway.{{/warning}}10 +As eMagiz, we continuously validate our best practices configuration on security to the industry-wide standards in the fields of security to uphold our reputation as a reliable and secure integration platform. As a result of our latest evaluation, we decided to follow the industry-wide standard to **not** support the following TLS versions anymore in our **[[current runtime>>doc:Main.eMagiz Academy.Fundamentals.fundamental-runtime-generation3.WebHome||target="blank"]]** architecture for outgoing connections from eMagiz to external systems as of April 11th, 2024. 10 10 11 -To enhance your options when developing an API gateway that can be called by others we now introduce the option to select XML as the default message format on your API Gateway pattern. You can do this under Design -> Settings -> API Management. In here you can select and edit the settings. 12 +* TLSv1.0 13 +* TLSv1.1 12 12 13 - [[image:Main.Images.Release Blog.WebHome@193-release-blog--rest-xml-default-setting.png]]15 +{{info}}Text{{/info}} 14 14 15 - Everyoperationmade after this decisionwill default toXML (or JSON which is still thedefault). Should you wanttosupport JSON on some operationsandXML on others you can select a default and manually correct the mediaType for the requests and responses to which it matters.17 +== **Announcement - Spring 6** == 16 16 17 -[[im age:Main.Images.ReleaseBlog.WebHome@193-release-blog--rest-xml-change-media-type-setting.png]]19 +We will release a major version of our [[current runtime>>doc:Main.eMagiz Academy.Fundamentals.fundamental-runtime-generation3.WebHome||target="blank"]] base image for all our clients running on the **[[current runtime>>doc:Main.eMagiz Academy.Fundamentals.fundamental-runtime-generation3.WebHome||target="blank"]]** architecture in our release that will be released on April 11th, 2024. This image moves the eMagiz stack from Java 8 to Java 17 and from Spring Framework 5 to Spring Framework 6. Although eMagiz will try to make the transition as smooth as possible, we recommend that you start with the following preparations. 18 18 19 -==**Cloud Template update** == 21 +{{warning}} 22 +* Make sure that your release is running on the **latest** flow versions. After the release of the new image, eMagiz will push new flow versions of components that have changed. These new flow versions must be included in the subsequent release. Having your release already on the **latest** flow versions makes this less affecting. 23 +* To help you identify which flow versions are essential here, you can consider all flows that contain any of the following components: 24 +** Simple job launcher (data pipelines) 25 +** Job explorer (data pipelines) 26 +** HTTP components message sender (support object) 27 +** Web service outbound gateway (with a 'message sender' attribute specified) 28 +** SFTP session factory (support object) 29 +** API gateways with OAuth2 as security mechanism. 30 +* We recommend identifying flows with (advanced) custom Groovy scripts. As our Java and Spring versions change, this may affect the availability of the libraries on the classpath and, therefore, the validity of import statements. You can already test the Groovy script using the flow testing functionality, as flow testing is already running on the Java 17 and Spring Framework 6 baseline. 31 +** Additionally, the Groovy version has been moved from 3.0.19 to 4.0.18. These changes may affect your scripts as well. [[These release notes >>https://groovy-lang.org/releasenotes/groovy-4.0.html||target="blank"]] will specify the changes in more detail. 32 +* The code handling SFTP file transfer has been overhauled completely. Although this should not affect you, we encourage you to test your SFTP integrations before deploying to Production. {{/warning}} 20 20 21 -We have released several new Cloud templates which will be installed via the auto-upgrade settings of your model (or manually in case not set). 22 - 23 -====Cloud Template R23 - Single Lane ==== 34 +== **Infra flow selection** == 24 24 25 -This release i ntroducesanewcloudtemplateforallour customers runningina single-lane setupinthe2nd generationruntime. This cloudtemplatewill updatesomespecific securitysettingson thesecloudslots.Thecompletereleasenotesonthecloudtemplate canbefound[[here>>doc:Main.Release Information.CloudTemplates.WebHome||target="blank"]]36 +This release will include a significant update to our release functionality, which allows you to configure your release. Presently, eMagiz will allow you to see changes on the infra-flow level visually. 26 26 27 - ====CloudTemplateR6-Single Lane ====38 +[[image:Main.Images.Release Blog.WebHome@release-216-hack-heaven--infra-flow-comparison.png]] 28 28 29 - Thisreleaseintroducesa new cloudtemplatefor all ourcustomers runningin asingle-lanesetupinthe3rd generationruntime. This cloud templatewill improvetheauto-healingfunctionality of thesecloudslots. The complete release notes onthecloudtemplatecanbe found[[here>>doc:Main.ReleaseInformation.Cloud Templates.WebHome||target="blank"]]40 +In edit mode, you can select a new version via the right-click option, which you already use for other flows. 30 30 31 - ====Cloud TemplateR6 - DoubleLane====42 +[[image:Main.Images.Release Blog.WebHome@release-216-hack-heaven--infra-flow-selection.png]] 32 32 33 - This releaseintroducesanewcloud template for all our customersrunning inadouble-lanesetupinthe3rd generationruntime. Thiscloudtemplatewill improve theauto-healingfunctionalityofthesecloudslots. The completereleasenotesonthecloudtemplate canbe found [[here>>doc:Main.ReleaseInformation.CloudTemplates.WebHome||target="blank"]]44 +We have also added a title to each context menu that specifies the flow type (e.g., exit connector, container infra, connector infra) for additional clarity while constructing your release. 34 34 35 - == **WS-Security onthe3rdgenerationruntime** ~*~* ==46 +[[image:Main.Images.Release Blog.WebHome@release-216-hack-heaven--context-menu-title.png]] 36 36 37 - Tofurtherimproveour offering on the 3rd generationruntimewenow also have addedthe necessaryfunctionality to allow you to call SOAP endpointswhileutilizing WS-Security as well as securing your hosted SOAP endpointthrough WS-Security protocols. Please make sure to create a new release that will trigger the image creation process which will included this feature when necessary.48 +== **Multiple environments selection** == 38 38 39 -== **State Generation ~*~* == 50 +{{warning}}The following is only applicable under the following conditions: 51 + * Windows 2022 server 52 + * At least one port opened (as a consequence of a hosted web service){{/warning}} 40 40 41 -W iththis release we introduceourfirst "State Generation"functionalitytoouruser community.After rigorous internaltestingandusewehave nowmade a stridetoalsomake itavailabletothe user communityon specific use case.Inthefollowingmonths wewill gatherfeedbackonthistofurther improve andreleaseit ina simplerandmoreuser friendlywaytotheuser community.54 +When configuring your Deploy Agent, you now have an additional option that the user can activate. This checkbox unlocks the possibility of stability when running multiple deploy agents on one machine. 42 42 43 - {{info}}Should you beinterestedin this functionalityor want tolearn morepleasecontact usatproductmanagement@emagiz.com{{/info}}56 +[[image:Main.Images.Release Blog.WebHome@release-216-hack-heaven--multiple-environments.png]] 44 44 45 -== **Feedback items ** == 58 +== **Feedback Items** == 59 +//__Easier component selection in flow designer__// 60 +The area selector through which you can select one or more components has improved to allow for an easier selection of said components when displayed close to the edge of the canvas. Expanding the area allows you to select these components, which will become much easier. 46 46 47 -//__ RemovedODataasoptionforan API Gatewayoperation__//48 - With thisrelease,wehaveremovedtheOData operationoptionasitwasnot used andwasnotfullysupportedanymore by the platform.62 +//__Improved handling of optionality in JSON on lists__// 63 +Previously, eMagiz always created a JSON array if your data model expected a list. This led to unexpected and undesirable behavior of the message, as empty arrays are not always accepted by external parties. 49 49 50 -//__Changes in API Gateway operation paths is automatically updated in Create__// 51 -When you change your path on a hosted API Gateway we will now automatically update the accompanying component in your Create (all-)entry. 65 +With this release, we have changed the way in which we generate the JSON output should there be an empty list. Consequently, the empty list will **not** be part of the output anymore, as desired. 52 52 53 -{{warning}}Make sure to check the changes and create a new version afterward to deploy the changes.{{/warning}} 67 +//__Loading bar when searching for log entries__// 68 +To indicate to the user that eMagiz is still busy retrieving log entries, we have added a loading bar to the log entry overview upon pressing search. 54 54 55 -== **Bug fixes ** == 70 +//__Improved feedback when deleting elements from Capture__// 71 +To better specify to the user which integration or system the user intends to delete, we have improved the text in the confirmation pop-up. This way, we can provide more information to the user to avoid mistakes. 56 56 57 -//__ Prevent endlessloopin Deploy -> UserManagement__//58 -With this release, we have changed thewayweupdatepropertieswhenusermanagementisupdatedforanAPI gatewayusingtheAPI Key securitymechanisms.Thiswillpreventthe endlessloopthatcouldnowhappenonoccasion.73 +//__Enhanced filter options in Manage__// 74 +With this release, we have added filter options on both the Alerting tab and the Trigger configuration pop-up. This allows users to filter on Status (Alerting) and Queues, Topics, Recipients, and more (Trigger configuration pop-up) in these places. 59 59 60 -{{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}} 76 +//__Copy property names from Create__// 77 +This release unlocks the possibility of easily copying the name of a property placeholder so it can be used while deploying. 61 61 62 -//__ Update errorhandlingduring migration to the3rd generationruntime__//63 - Asofnowthe errorhandlingofallflowsiscorrectlyupdatedwhilstmigratingto the3rdgenerationruntimeconfiguration.79 +//__Improved feedback during migration to the current runtime architecture__// 80 +Should you try to migrate the JMS before any other runtime under Create -> Settings, we have improved the feedback. This feedback will tell you why you cannot migrate in this order. 64 64 82 +//__Block user from making changes to their cloud while another upgrade is still in progress__// 83 +We now block users from changing their cloud configuration when another upgrade is ongoing. 84 + 85 +//__Cron trigger validation__// 86 +We have added a validation check upon saving a cron expression in the Flow Designer to avoid flows not starting due to a misconfigured cron expression. 87 + 88 +== **Bug Fixes** == 89 +//__Making Edit (and View) the default action when configuring parameters__// 90 +We have made the Edit (and View) button the default action when configuring parameters in a transformation. 91 + 92 +//__Property configuration pop-up resized__// 93 +We have resized the property configuration overviews to make the property value better readable. 94 + 95 +//__Alphabetically sorted components in the flow designer__// 96 +As of this release, we now sort the components alphabetically in the flow designer. 97 + 98 +//__Improved sorting on runtime overview__// 99 +As of this release, we now sort the runtimes in the runtime overview correctly by time. This means that the runtime with a changed status, closest to the current date and time, is shown at the top of the list. This should reduce the chance of overlooking a critical mistake. 100 + 101 +//__Improved sorting on catalog overview__// 102 +As of this release, we now sort the topics in the catalog by name. 103 + 104 +//__Styling fix on rich text editors__// 105 +Rich text editors are used in various parts of the portal. This release fixes a broken styling configuration that made it difficult to fill in information in these editors. 106 + 107 +//__Styling fix on release edit__// 108 +As of this release, the correct icon (green) will be shown when wanting to add a second API operation under the same "header." 109 + 110 +//__Removed false-positive alerts on transformations__// 111 +When transforming a string to a non-empty string, eMagiz would also show an alert even if the user made a check to avoid an empty string as output. This behavior is now corrected. This will significantly reduce the number of alerts you will see as a user within the context of your transformation. 112 + 113 +//__Event Streaming Graphs - view thirty days back__// 114 +Just like the other views, we now also provide the user with a default thirty-day window to analyze relevant statistics related to event streaming further. 115 + 116 +//__Improved helptext__// 117 +We have improved various help texts across the portal to indicate better what should be filled in for specific fields. 118 + 65 65 == **Fancy Forum Answers** == 66 66 67 67 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: 68 68 69 -* [[Access Spring ApplicationContext within Groovy Script>>https://my.emagiz.com/p/question/172825635703325469||target="blank"]] 70 -* [[Configuration problem: Failed to locate '$autoCreateChannelCandidates'>>https://my.emagiz.com/p/question/172825635703312551||target="blank"]] 71 -* [[503 on SOAP Webservice hosted in eMagiz>>https://my.emagiz.com/p/question/172825635703325386||target="blank"]] 123 +* [[XSD is only partially imported into eMagiz (xmlStat.xsd)>>https://my.emagiz.com/p/question/172825635703773349||target="blank"]] 72 72 73 -== **Key takeaways** ==125 +== **Key Takeaways** == 74 74 75 -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:127 +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: 76 76 77 77 * If you have questions surrounding our Program Increment Planning, please get in touch with [[productmanagement@emagiz.com>>mailto:academy@emagiz.com]] 78 78 * If you have feedback or ideas for us, talk to the Platypus 79 -* Please inform us of new additions to the store ([[productmanagement@emagiz.com>>mailto:academy@emagiz.com]]) so we can all benefit from these. 131 +* Please inform us of new additions to the store ([[productmanagement@emagiz.com>>mailto:academy@emagiz.com]]) so we can all benefit from these. 80 80 * Clear your browser cache (Ctrl + Shift + Del) 81 81 * Check out the release notes [here] 82 82 * Start thinking about how the license tracker can aid your development 83 83 * Start thinking about major, minor, and patch 84 -* Upgrade to the latest build number 85 85 * Keep making great integrations 86 86 87 87 Let's stay in touch and till next time! ... ... @@ -89,6 +89,11 @@ 89 89 {{info}} 90 90 ~* Indicates a Beta feature. If you would like to get access to this beta feature, please contact [[productmanagement@emagiz.com>>mailto:academy@emagiz.com]] 91 91 92 -~*~* Indicates a GEN3-only feature. 93 -{{/info}})))((({{toc/}}))){{/container}} 143 +{{/info}} 144 +))) 145 + 146 +((( 147 +{{toc/}} 148 +))) 94 94 {{/container}} 150 +{{/container}}