Changes for page 208 - Controlled State
Last modified by Carlijn Kokkeler on 2024/04/18 13:10
From version 36.1
edited by Erik Bakker
on 2022/11/07 16:06
on 2022/11/07 16:06
Change comment:
There is no comment for this version
To version 81.1
edited by Erik Bakker
on 2023/02/13 14:00
on 2023/02/13 14:00
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 -1 87-IntegrationSponsor1 +192 - Small Step - Content
-
... ... @@ -2,150 +2,144 @@ 2 2 {{container layoutStyle="columns"}}((( 3 3 [[image:Main.Images.Release Blog.WebHome@release-blog-intro.png]] 4 4 5 -**Hi there, eMagiz developers!** Withthis releasewewillreleaseseveralimpactful features andenablerstoour community. Amongothersthenext phaseofthe eMagizStorewill becomepubliclyavailable.Thismeansthat youcan nowimportdatamodelsandtransformationon top ofsystem messagesinDesignandacceleratorsinCreate.Furthermore,wewill launchaew Betafunctionalitythrough some of our clientsthatwill enableyoutorestore yourflowtoapreviousversion.5 +**Hi there, eMagiz developers!** In the last couple of weeks we worked hard on building several major things that will be released later this Q. On top of that we finished an additional features for our 3rd generation runtime that give you chirurgical precision when doing maintenance on a model. Among the additional features we have the dynamic alerting and the debugger functionality. 6 6 7 -== **St ore - Nexthase** ==7 +== **Start/Stop Flows** ~*~* == 8 8 9 - This releasewill introduce the next phase oftheStore to our wholecommunity.Withthisnewfunctionalityyou can nowmport data modelmessages (i.e. CDM, API Gateway Data model or Event Streaming data model)and transformations.Thisway connectingto standardized systems such as Exact Online, MicrosoftGraph,Salesforceand otherswill become eveneasier.Formore information on theStore please check out this [[course>>doc:Main.eMagizAcademy.Microlearnings.NoviceLevel.eMagiz Store.WebHome||target="blank"]]. As a reminderyou can find all documentationon all available Store content published by eMagiz [[here>>doc:Main.eMagiz Store.WebHome||target="blank"]].9 +{{warning}}Note that depending on the alert this functionality will only work when your JMS server is running on the 3rd generation runtime{{/warning}} 10 10 11 - ==**Flow version restore**==~*11 +To enhance the options you have when running into problems or when maintaining your solution in a Production environment, we have added a new feature to our Deploy phase called "Start/Stop Flows". You can access this functionality via the "Deploy Architecture" overview in Deploy. On runtime level you can open the context menu and select the option called "Start/Stop Flows". 12 12 13 - On top of that wewillalso launchanew Beta featuretothecommunity that allowsyoutorestore yourflowto a previousversion. This way youcan quickly undochangesmadethat were incorrect.13 +[[image:Main.Images.Release Blog.WebHome@192-release-blog--start-stop-flows-context-menu.png]] 14 14 15 -{{warning}}Note, that the following restrictions apply when restoring to a previous version: 16 - * Changes made on definition and transformation level are **not** restored 17 - * You will not be able to restore to any flow version that was created before October 17th, 2022 18 - * You will not be able to restore your flow to the original version created by eMagiz. You can use the reset function if you want this state back{{/warning}} 15 + 16 +{{info}}Only in "Start Editing" mode you can actually start and stop specific flows{{/info}} 17 + 18 + 19 + observability of your integration landscape while running in the 3rd generation runtime architecture, we have added a new feature to our Manage phase called "Dynamic Alerts." You can access this functionality via the "Alerting" menu in Manage. Then, with the help of the "Trigger" overview, you can view all triggers on your environment. On the top of the list you will see all "static" alerts as defined by eMagiz. Below that you will see all "dynamic" alerts that you and your fellow teammembers (with sufficient rights) can view, edit and delete. 19 19 20 - ==**Academyimprovements** ==21 +We offer alerting on five types. 21 21 22 -On top of that, we have added various microlearnings to our academy offering available on docs.emagiz.com related to the new runtime architecture. You can identify these microlearnings by looking at the following icon in front of a microlearning. 23 +* Error message 24 +* Log message 25 +* Queue consumers 26 +* Messages in queue 27 +* Queue throughput 23 23 24 -[[image:Main.Images.Release Blog.WebHome@1 86-release-blog--gen3-microlearnings-icon.png]]29 +[[image:Main.Images.Release Blog.WebHome@191-release-blog--dynamic-alert-trigger-options.png]] 25 25 26 - ==**FlowDesignerImprovements**==31 +These five options give you the option to configure more or less the same as you are currently used to when configuring triggers. Once you make a choice for a type you can press the "Next" button to fill in the details of the trigger. One example of how this can look is shown below. 27 27 28 -//__See last changed date and changed by on resource level__// 29 -This release will reinstate the ability to see who changed a resource last and when it was changed for the last time. You can find this information by double-clicking on a resource or viewing its details via the view button. 33 +[[image:Main.Images.Release Blog.WebHome@191-release-blog--dynamic-alert-trigger-input.png]] 30 30 31 - [[image:Main.Images.ReleaseBlog.WebHome@186-release-blog--change-info.png]]35 +Once the trigger tab is filled in you can navigate to the "Output" tab to select the recipients for the trigger you are configuring. On top of that you can reduce the number of message at which congestion control is enabled if ten is too high for you. 32 32 33 -//__See on which other flows a resource is used__// 34 -This release will reinstate the ability to see whether a resource is used in other flows within your model or not. This will help to determine the impact of a specific change. 37 +[[image:Main.Images.Release Blog.WebHome@191-release-blog--dynamic-alert-trigger-output.png]] 35 35 36 - [[image:Main.Images.ReleaseBlog.WebHome@186-release-blog--resource-used-in-other-configs.png]]39 +== **Debugger ** ~*~* ~* == 37 37 38 -//__Toggle option to see the generated resource by default__// 39 -Upon request, we have made the toggle for the generated resources in the new flow designer user-dependent. This means that you, as a user, can determine that the toggle should also be on. This means that the generated resources will be shown to you when opening any flow in eMagiz. When you switch the toggle off, this will mean that you will **not** see the generated resources by default. 41 +{{warning}}Note that this functionality only works when the following criteria are met. 42 +* Your JMS server is running on the 3rd generation runtime 43 +* The store item called "3rd generation debugger" is imported in the infra flow of each runtime for which you want the ability to debug 44 +* A new release is created that includes the flow changes and this release is deployed to the environment(s){{/warning}} 40 40 41 - ==**Feedbackitems **==46 +As with our current offering, we now offer a functionality with which you can debug channels and see them via the eMagiz portal. As stated above to get to this point you need to execute several steps to get your model ready to be "debugged". Once you have done this you can activate the "debug" mode, via Deploy -> Containers for **one** specific flow **per** runtime that is of particular interest to you. Once you have done this you will see a pop-up telling you whether the "debug" mode was indeed activated or not. 42 42 43 - We haveosolvedotherfeedback itemsbesides the flowdesigner'scriticalupdates.48 +[[image:Main.Images.Release Blog.WebHome@191-release-blog--debugger-action-success.png]] 44 44 45 -//__Redirect to the Manage Dashboard from your model home page__// 46 -Directly navigating to the Manage phase (of any environment) will automatically redirect you to the error message Dashboard, as that is the landing page of the Manage phase. 50 +[[image:Main.Images.Release Blog.WebHome@191-release-blog--debugger-action-failure.png]] 47 47 48 -//__Readable entry of a SpEL expression in a flow component__// 49 -As of now, the input field for your SpEL expression in certain flow components will dynamically expand when you enter a large SpEL expression. This will improve the readability of your solution and will make it easier to enter and validate your SpEL expressions. 52 +Assuming it was activated correctly you can navigate to Manage -> Explore -> Queue browser and select the emagiz.debug queue to see the messages coming through. 50 50 51 -[[image:Main.Images.Release Blog.WebHome@1 86-release-blog--spel-expression-readible.png]]54 +[[image:Main.Images.Release Blog.WebHome@191-release-blog--debugger-output-queue-browser.png]] 52 52 53 -//__Keep Create and the Create Phase release in sync__// 54 -Previously the Create and the Create Phase release might have become out of sync. As a result, comparing a release to the Create Phase release could yield confusing results. With this release, we have made several improvements to prevent this from happening. 56 +{{info}}Note the following limitations when working with the debugger. 57 + * Your entire model needs to be migrated to the 3rd generation runtime 58 + * Only **one** flow **per** runtime can be debugged **per** environment 59 + * There is only **one** overview in which **all** debugged messages are shown 60 + * Message payload in excess of 100KB are not shown in the queue browser as they constitute a "large message" 61 + * The debug functionality works for a period of five minutes in which you can use the refresh button to see new messages coming in. 62 + ** After five minutes the debug functionality will be shutdown automatically under water. 63 + ** To see new messages after the five minutes you will have to access the debug functionality again from scratch.{{/info}} 55 55 56 -//__Mask password values in the unused properties overview__// 57 -All property values of the type password can be masked in the properties overview screen. However, this behavior was different when pressing the unused properties overview. With this release, we have corrected this behavior to ensure that passwords are also masked in this overview. 65 +== **Volume mapping - Network Share** == 58 58 59 -//__Press Enter to Search for properties__// 60 -With this release, we have added functionality that makes it possible to press **Enter** when searching for properties in the property overview. 67 +This release will introduce an additional functionality within our [[volume mapping>>doc:Main.eMagiz Academy.Microlearnings.Novice.File based connectivity.novice-file-based-connectivity-volume-mapping-on-premise||target="blank"]] offering. With this additional configuration option you can configure a network share and configure it to create a mapping between a network share and a docker volume. 61 61 62 -//__Styling update on tag selection on integration level__// 63 -With this release, we have improved the styling of tags displayed on the integration and system level. This way, the tag is better readable, and the icon to remove a selected tag is completely shown to the user instead of partly. 69 +[[image:Main.Images.Release Blog.WebHome@191-release-blog--volume-mapping-network-share-overview.png]] 64 64 65 -//__Enter to close automated flow testing pop-up__// 66 -Upon your requests, we have made the pop-up detailing your automated flow test results to be closable by pressing the Enter key on your keyboard. This saves you the hassle of grabbing your mouse and clicking the button. 71 +[[image:Main.Images.Release Blog.WebHome@191-release-blog--volume-mapping-network-share-detail.png]] 67 67 68 -//__Improved naming of downloaded Event Streaming keystore__// 69 -When downloading a Keystore that an Event Streaming client needs to access a topic, the name now includes the client name **and** the environment so you can easily discern the difference between the keystores when distributing them to your client. 73 +== **Feedback items ** == 70 70 71 -//__Pop out on the Traces tab within Flow Testing__// 72 -In line with the improvements we made before within the Flow Testing functionality, we have now added the pop-out functionality to all results shown in the traces tab. This will make it easier to analyze what happens between the start and the end of your flow. 75 +We have also solved other feedback items besides the flow designer's critical updates. 73 73 74 -//__So rtingUserManagement__//75 - Asofthis release,theusermanagement overviewin Deployforusersand roleswill besorted alphabeticallyto makeiteasiertofindaspecific useror rolewithinthis overview.77 +//__Show status on machine level under Deploy Architecture__// 78 +With this release we are now able to show the status of the machine when opening the "Details" overview on machine level in Deploy -> Architecture. 76 76 77 -//__Improved warningonpassthroughAPIoperation__//78 - Most usersforgetto configurea backendAPI operation or switchto thetransformationoption when configuring an API operation in CaptureandDesignbefore moving to Create. This is then blocked,leavingusers confused about what to donext.Therefore we introducean additionalwarning in the Designphase thatlets you knowthatyour configurationof an API operation is not yetfinished. This way, youcancorrectit**before**tryingtomoveit to Create.80 +//__Improved validation feedback on non-supported WSS4J interceptor __// 81 +We have improved the validation feedback when someone tries to implement a specific WSS4J interceptor implementation. 79 79 80 -//__Improve dupdatefunctionalityofSwagger filewhenchangingdatamodel__//81 - Before,therewere specific scenariosin whichtheSwagger file wasnotupdatedaccordingto changes made to yourAPI datamodel.Withthisrelease,wehavemade a firststepin improvingthis behavior.Then,whenyouchange theorderofattributesinyourdatamodel,theSwaggerfilewillbe updatedaccordingly.83 +//__Improve help text in flow testing on Java classes__// 84 +We have improved the helptext when you are adding headers to your test message. In this helptext we explain the top five Java classes and how to note them down to make it work in the flow testing functionality and in eMagiz in general. 82 82 83 -{{info}}Note that just as with any resource that is changed from the Design phase, a version bump of your flow in Create is still necessary to deploy the changes to your environment(s){{/info}} 86 +//__Improved readibility of notification when trying to delete a runtime__// 87 +When you have forgotten one or more steps when deleting a runtime you will be notified by the system on this. With this release we have improved the readibility of the notification. 84 84 85 -//__ "Disapproveandgoenvironment"__//86 - Followingthe"Approveandgoto environment" functionality, wehavenow expandedthatbyadding the "Disapproveand goto environment"functionality.89 +//__Improved sorting of missing properties overview__// 90 +We have improved the sorting on the missing properties overview you will encounter when activating the "check properties" option. 87 87 88 -//__Improve readabilityofAPI Gateway operationsinCreate andDeploy__//89 -W henyouhavea lengthy name foryourAPI Gatewayoperation,it becomestough to discernthevariousAPI Gateway operations inyour landscape.Toalleviate this problem,wehaveaddeda tooltip functionalitythat will show thefull display namehenhoveringovertheAPI Gateway operation.92 +//__Improved notification when error message cannot be found__// 93 +We have improved the notification when an error message cannot be found from the message redelivery overview in our 3rd generation runtime. 90 90 91 -//__Add Topic Storageinformationto LicenseTracker__//92 - Ontop of theinformationreadyshownin theLicenseTracker, wehaveaddedStorageinformationfor theEvent Streaming pattern. Thisway, youcan easily seetheamountof GB you haveassignedandtheamount ofGBthatwas contractuallyagreedupon betweenyou andMagiz.95 +//__Additional lifecycle management overview__// 96 +We have added an additional lifecycle management overview to the portal in which users with enough permissions can get an overview of the lifecycle "state" of all customer models. 93 93 94 -[[image:Main.Images.Release Blog.WebHome@186-release-blog--topic-storage-info.png]] 98 +//__Improved feedback when memory settings are negative__// 99 +We have added an additional check that validates whether memory settings on a specific container are of a negative value. In these cases you will be blocked from applying the changes to the environment as this won't lead to a working solution. 95 95 96 -//__Ad dCompatibilitycheckwhen importingstoreitems__//97 - Wehavedded acompatibility checkto theplatformtopreventyou fromimportingstoreitemsthatdonotwork onaspecificruntimerchitecturetoprevent this fromhappening.101 +//__Auto upgrade for a cloud template default to "ON"__// 102 +For each new cloud slot we will toggle the "automtatic cloud template update" to "Yes". 98 98 99 -//__ Showdependencies betweensupportobjects__//100 - Asof now, whenyou click on a supportobject,allrelatedsupport objectswill alsobe highlightedin the same overview. This makes iteasierto see the relationship between supportobjects and components and among support objects.104 +//__Removed an irrelevant refresh button on a flow designer component__// 105 +We have removed an irrelevant refresh button on the standard filter component. 101 101 102 -//__ Improve rendering ofvalidationdefinitionwhen usingmultiplenamespaces__//103 -W iththis release,we haveimprovedhowwe renderthevalidationdefinition(XSD) when usingmultiplenamespaces.Thiswillprevent youfromrunningintovalidationerrorswhile everythingseemsconfiguredcorrectlyonyourend.107 +//__Notification list shows all notifications on default__// 108 +When navigating to the Notification overview in Manage under Alerting you will now see all notifications instead of a filtered list on a specific state. 104 104 105 -//__Improved help texts on next-generation runtime functionality across the portal__// 106 -With this release, we have improved several help texts on functionality related to the next-generation runtime that help you while migrating to the next-generation runtime. 110 +== **Bug fixes ** == 107 107 108 -== **Bug Fixes** == 112 +//__Keep selection when copying properties__// 113 +We have fixed the bug that prevented you from easily copying properties from one runtime to another based on the runtime list. 109 109 110 -//__ Providerrectfeedback whena flowis transferredto Deployforthefirsttime__//111 -W ith this release,we have made severalimprovementsto whatfeedback is given to theuser whenmovingaflow from Createto Deploy forthefirst(upon creating yourfirstdefinitiveversion). Thiswillensurethat no confusingpop-ups will be shownthatareincorrectand onlyconfuse theuserfurther.115 +//__Check on security header improved for API Gateway__// 116 +We improved the check in the API Gateway through which we validate whether an API caller is authenticated when using the API Key method to secure the API Gateway. 112 112 113 -//__ ShowinformationintheExceptionoferror messagesoverview__//114 -W iththis release,we haveresolved thebugplaguingthispage.Asa result,youwillagainseeinformationon this page whenthereisinformationtoshow.118 +//__Don't show systems with only "external" flows in Design__// 119 +We fixed a bug that caused systems to appear in Design in cases where there should be none. 115 115 116 -//__ Improvestyling ofcrontriggerconfigurationpop-up__//117 - Thestyling of thispop-up madeitvery hardtoconfigurea crontrigger. Wehaveredesignedthestyling to make thepop-up readablegain.121 +//__Fix styling of mendix login in some occurences__// 122 +When navigating to a specific URL the default Mendix login page would be shown. With this release we have fixed this behavior. 118 118 119 -//__ Prevent floweditinglocksinspecificsituations__//120 -T herewerespecificsituationswhenswitchingbetweenDesignandCreatethat couldleadto unexpectedbehavior in theCreate phase.This ledto a flow editinglockwarningto the user.We havesolvedthisprobleminthisrelease.124 +//__Change timing of wake-up of cloud slots on Friday__// 125 +To prevent timing issues of waking up cloud slots on the Friday of our deployment we have changed the timing of when the cloud slots are woken up on Friday. 121 121 122 -//__ Generatepropertyvalue emptiestheruntimeselection__//123 -W ith this release,we havefixedthe bug thatemptiedtheruntimeselection upon generatinga propertyvalue (i.e., password).127 +//__Fixed a typo in the Topic statistics overview__// 128 +We fixed a typo in the topic statistics overview. 124 124 125 -//__ Makesurenothingof a systemmessageiseditablefrom yourexit__//126 - Before, you couldchangepartofyoursystem message from your exit (butnoteverything).Thisled to confusion. As a result, we have now made sure you cannotedit anything on thesystem message level from your exit to keep itconsistentwithour design choices.130 +//__Fixed a typo in the HTTP statistics overview__// 131 +We fixed a typo in the HTTP statistics overview. 127 127 128 -//__ Preventuserswithoutviewrightsfrom seeing aweirdscreeninthose phases__//129 -W ith this release,wehave introduceda consistent approachtowards whatwe show a userthat has no viewrights on a complete phase.Thismeansthatyou willalways seethesameinformationconsistently.133 +//__Activatation of release history when executing a deployment__// 134 +We ensured that the release history is activated when executing a deployment. 130 130 131 -//__Name of starting point of the flow test is incorrect__// 132 -With this release, we have ensured that the name of the starting point of your flow test you see in the "Results" tab is correct. 133 - 134 -//__Audit Trail on User Management could break__// 135 -When performing many changes to user management in Deploy at once, there was a chance the audit trail functionality would give an error blocking you from continuing your update. With this release, we have solved that issue. 136 - 137 -//__Progress bar in the license tracker is shown twice__// 138 -With this release, we have fixed a bug that showed the progress bar twice in the license tracker. 139 - 140 -//__Compare flows with support objects in the new flow designer__// 141 -We have fixed a bug related to support objects that prevented you from comparing two flows when one was built in the latest, and the difference was constructed in the old flow designer. 142 - 143 143 == **Fancy Forum Answers** == 144 144 145 145 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: 146 146 147 -* [[How to translate CDATA>>https://my.emagiz.com/p/question/172825635703158962||target="blank"]] 148 -* [[SwaggerUI not found>>https://my.emagiz.com/p/question/172825635703171813||target="blank"]] 140 +* [[Characters transformed to � when retrieving from DataSink>>https://my.emagiz.com/p/question/172825635703287019||target="blank"]] 141 +* [[Can I test my API Gateway locally?>>https://my.emagiz.com/p/question/172825635703236592||target="blank"]] 142 +* [[Deploy stops when updating connector-infra>>https://my.emagiz.com/p/question/172825635703299903||target="blank"]] 149 149 150 150 == **Key takeaways** == 151 151