Compile Time Changes

class GlobalPartAdjustmentSum

The compatibility interfaces added for 16.5 were removed in 17.0.

Old: extend public str displayName()
New: extend public str displayName(bool showSummationLabel=true)

Old: extend public void setCells(GridWindow gw, int row, int last, Space space)
New: extend public void setCells(GridWindow gw, int row, int last, Space space, bool showSummationLabel=true)

If you override or extend these methods on custom GlobalPartAdjustmentSum classes, update your signatures to include the new showSummationLabel argument and use it when rendering the sum line label.

Summary line helpers

The following overloads for getSummaryLines were changed in 17.0 (cm/core/calc/globalPartAdjustment.cm).

Most call sites can continue to omit the new argument because it has a default value. If your code depended on the removed two-argument overloads as distinct interfaces, update it to call the three-argument version instead.

Old: public SummaryLine[] getSummaryLines(Space space, SummaryPriceInfo pInfo)
New: public SummaryLine[] getSummaryLines(Space space, SummaryPriceInfo pInfo, bool showSummationLabels=true)

Old: public SummaryLine[] getSummaryLines(AdditionalGlobalPartAdjustment[] items, SummaryPriceInfo pInfo)
New: public SummaryLine[] getSummaryLines(AdditionalGlobalPartAdjustment[] items, SummaryPriceInfo pInfo, bool showSummationLabels=true)

Runtime/Behavior Changes

New standard-special behavior in Calculations

CET 17.0 introduces a new standard-special system in cm.core.part. Standard specials are internal specials rather than user-created specials, so part rows that only contain standard specials are not highlighted as user-special rows in Calculations.

This follows the new Part.containsAnySpecials(ignoreStandardSpecial=true) behavior used by calculation row highlighting. Implementers should treat that as part of the intended standard-special behavior, not as a loss of ordinary special highlighting.

New setting for summation label on summary sum lines

Calculations now has support for showing or hiding summation type labels on summary sum lines in 17.0. This affects calculation summaries, summary templates, article view preview, and printouts.

Sum lines now use a user-facing summary setting to decide whether labels such as Sell, Buy, List, or Profit are appended to the sum name. For 17.0, this setting defaults to enabled so existing summaries and printouts will continue to show summation labels unless explicitly turned off.

This behavior is controlled through ArticleViewSummarySettings.enabledSettings using the key cSumLabelSettingKey ("summationLabels"). Older saved summary settings that do not contain this field load successfully and use the 17.0 default of true.

If you have custom code that compares summary labels literally, parses printed summary text, or depends on the exact displayed name of a GlobalPartAdjustmentSum, verify that it still works when summation labels are shown or when users disable them.

Miscellaneous

New standard-special behavior in Calculations

CET 17.0 introduces a new standard-special system in cm.core.part. Standard specials are internal specials rather than user-created specials, so part rows that only contain standard specials are not highlighted as user-special rows in Calculations.

This follows the new Part.containsAnySpecials(ignoreStandardSpecial=true) behavior used by calculation row highlighting. Implementers should treat that as part of the intended standard-special behavior, not as a loss of ordinary special highlighting.

New setting for summation label on summary sum lines

Summary templates now persist enabled/disabled summary settings in addition to the summary adjustment sequence. When creating a new summary template from a view, the summationLabels setting is copied into the saved template.