Skip to content

[WC-3209]: mark Any Chart pages as deprecated and refresh Charts configuration docs - #11719

Open
rahmanunver wants to merge 2 commits into
mendix:developmentfrom
rahmanunver:wc-3209
Open

[WC-3209]: mark Any Chart pages as deprecated and refresh Charts configuration docs#11719
rahmanunver wants to merge 2 commits into
mendix:developmentfrom
rahmanunver:wc-3209

Conversation

@rahmanunver

@rahmanunver rahmanunver commented Aug 12, 2026

Copy link
Copy Markdown
Contributor

Closes #10764

What

Any Chart deprecation visibility (WC-3209)

  • Adds deprecated: true front 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.
  • Adds a deprecation alert to those pages and to the Any Chart section of the Charts landing page in both guides.

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 separate Series entity, and a Value_Series association; 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.
  • Removed screenshots of property dialogs that no longer exist. The steps now describe the current UI in text.

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 by cannot follow an association. The chart attribute properties do not set isPath, which defaults to no in custom_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 old Series entity plus association.
  • Series names and colors are resolved per group, not per data point. groupDataSourceItems takes the series name from the first data point in the group, and getExpressionValue evaluates the color expressions against the first data point too, applying the result to the whole series.
  • Screenshots are not replaced. The removed figures showed property dialogs from an older widget version. New screenshots need Studio Pro and are not included here.
  • No REST data source exists any more. A datasource property offers Database, Microflow, Nanoflow, and Association, per Pluggable Widget Property Types. That is why charts-basic-rest.md now routes the REST call through a microflow, and why the Line chart steps in _index.md no longer list a REST option.
  • Inbound link text is not updated. Six references in the refguide, refguide9, and refguide10 chart-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.

@ConnorLand ConnorLand self-assigned this Aug 12, 2026
@rahmanunver rahmanunver changed the title [WC-3209]: mark Any Chart pages as deprecated in Studio Pro 9 and 10 guides [WC-3209]: mark Any Chart pages as deprecated and refresh Charts configuration docs Aug 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

create-a-dynamic-series-chart : contents are so obsolete

3 participants