[WC-3209]: mark Any Chart pages as deprecated and refresh Charts configuration docs - #11719
Open
rahmanunver wants to merge 2 commits into
Open
[WC-3209]: mark Any Chart pages as deprecated and refresh Charts configuration docs#11719rahmanunver wants to merge 2 commits into
rahmanunver wants to merge 2 commits into
Conversation
leonardomendix
approved these changes
Aug 12, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #10764
What
Any Chart deprecation visibility (WC-3209)
deprecated: truefront matter to the three Any Chart pages in the Mendix 9 and 10 guides, so they show the DEPRECATED badge in the sidebar like their Mendix 11 counterparts.Charts configuration refresh (#10764)
charts-dynamic-series.md: retitled to Create a Multiple Series Chart and rewritten against the current widget. The old page described a Dynamic series tab, a separateSeriesentity, and aValue_Seriesassociation; the widget now takes one data source and splits it with a Group by attribute. The page URL is unchanged, so no inbound links break.charts-basic-create.md: corrected the property navigation for the current widget.charts-basic-rest.md: rewritten around a microflow. The old page told readers to select a REST endpoint data source and enter a REST URL; the widget has no such option, so the page now consumes the service and returns its results from a microflow, which the chart uses as its data source._index.md: corrected the Line chart configuration steps, the Pie chart property list, and the advanced configuration instructions.Why
Any Chart is already marked deprecated in the Mendix 11 guide, but the 9 and 10 guides gave no signal at all — a reader landing on those pages could not tell the widget was deprecated or that Custom Chart superseded it.
The Mendix 10 alert reuses the Mendix 11 wording. The Mendix 9 alert is worded differently on purpose: there is no React Client page in the Mendix 9 guide to link to, and Custom Chart requires Charts 6.0+, which needs Studio Pro 10 or above — so pointing Mendix 9 readers at the React client migration would be a dead link and unactionable advice.
Scope for the deprecation change is deliberately limited to visibility. Removing Any Chart references throughout the docs is a much larger change and should wait until Any Chart support is actually dropped.
The Charts pages had drifted far from the widget. Property names in the docs (Chart properties tab, Data points tab, Dynamic series tab, Data entity, X-axis data attribute) do not exist in the widget any more, and the multiple-series mechanism changed shape entirely. Every replacement label in this PR was taken from the widget XML in
mendix/web-widgets(Charts 6.3.2).Notes for reviewers
Group bycannot follow an association. The chart attribute properties do not setisPath, which defaults tonoincustom_widget.xsd, so the grouping attribute must live on the entity the data source returns. This is why the rewritten how-to uses a single entity with a grouping attribute rather than the oldSeriesentity plus association.groupDataSourceItemstakes the series name from the first data point in the group, andgetExpressionValueevaluates the color expressions against the first data point too, applying the result to the whole series.datasourceproperty offers Database, Microflow, Nanoflow, and Association, per Pluggable Widget Property Types. That is whycharts-basic-rest.mdnow routes the REST call through a microflow, and why the Line chart steps in_index.mdno longer list a REST option.refguide,refguide9, andrefguide10chart-widgets pages still call the page "How to Create a Dynamic Series Chart". Those pages document the legacy Charts widget and are left alone here.