From 57e8a6e97544cb282abea9e8604b35d25fbec60f Mon Sep 17 00:00:00 2001 From: dc-bot Date: Thu, 3 Sep 2026 19:50:31 +0000 Subject: [PATCH] docs: improve formula examples, fix roadmap structure, add trailing newline - dcc-validations: add MATCH() example showing why spaces matter around column names; document that new rows are 'A' from creation - roadmap: move delivered Frontend Formulae and Regex Rules to Delivered Features section; reword 'necessary' heading - deploy-viya: add trailing newline --- docs/dcc-validations.md | 4 ++-- docs/deploy-viya.md | 2 +- docs/roadmap.md | 17 ++++++++++------- 3 files changed, 13 insertions(+), 10 deletions(-) diff --git a/docs/dcc-validations.md b/docs/dcc-validations.md index 401e8ec..9f7977d 100644 --- a/docs/dcc-validations.md +++ b/docs/dcc-validations.md @@ -60,7 +60,7 @@ Formulas use column names, not cell references, so there is no need to know the Each row calculates its own result - the PRICE in row 1 is multiplied by the VOLUME in row 1, the PRICE in row 2 by the VOLUME in row 2, and so on. !!! note - Each column name in the formula must be surrounded by spaces (eg ` PRICE ` not `PRICE`) so it is recognised as a column reference rather than part of a function name. Text inside quotes is left as-is. + Each column name in the formula must be surrounded by spaces (eg ` PRICE ` not `PRICE`) so it is recognised as a column reference rather than part of a function name. For example, `=MATCH( PRICE )` resolves the column reference, but `=MATCH(PRICE)` does not - PRICE is left unrecognised and the formula will error rather than using the column's value. Text inside quotes is left as-is. ### HARDFORMULA vs SOFTFORMULA @@ -77,7 +77,7 @@ Each row calculates its own result - the PRICE in row 1 is multiplied by the VOL Formulas can reference three special values that are resolved at runtime: -* `DC.ROW_STATUS` - the current state of the row: `M` (Modified), `A` (Added), `D` (Deleted), or `U` (Unchanged). +* `DC.ROW_STATUS` - the current state of the row: `M` (Modified), `A` (Added), `D` (Deleted), or `U` (Unchanged). A newly-added row is `A` from the moment it is created - there is no transient state before that. * `DC.USER_NAME` - the logged-in user id. * `DC.ORIG_VALUE` - the original cell value before the current edit. diff --git a/docs/deploy-viya.md b/docs/deploy-viya.md index 7cdedfc..27af1aa 100644 --- a/docs/deploy-viya.md +++ b/docs/deploy-viya.md @@ -175,4 +175,4 @@ It is possible to embed a Data Controller table within SAS Visual Analytics by s To make the portlet more visually appealing, the Data Controller title bar can be removed by adding `?embed=true` to the URL. When opening in a new window, the title bar will be gone. -For a deeper VA integration - where report row selections drive filters and column visibility in the Data Controller editor - append `?embed=va` instead. See the [SAS Visual Analytics Embed](/embed-va/) page for details on filter modes, configuration, and debugging. \ No newline at end of file +For a deeper VA integration - where report row selections drive filters and column visibility in the Data Controller editor - append `?embed=va` instead. See the [SAS Visual Analytics Embed](/embed-va/) page for details on filter modes, configuration, and debugging. diff --git a/docs/roadmap.md b/docs/roadmap.md index 2630c75..590cf7f 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -26,12 +26,7 @@ The following features are currently requested: ### Additional Validations -The following additional features are necessary: - -* ~~Frontend Formulae~~ - **Delivered** in v7.13.0. See [Formula Rules](/dcc-validations/#formula-rules). -* Regex Rules - **Delivered**. See [Regex Rules](/dcc-validations/#regex-rules). - -The above rules will apply only at frontend, and will be configurable in the MPE_VALIDATIONS table. The values will appear as part of the [editors/getdata](https://code.datacontroller.io/getdata_8sas_source.html) service response in the `dqrules` object. +The following additional features are under consideration: **Frontend Formulae** @@ -236,4 +231,12 @@ It is now possible to restore any change by heading to the particular staged dat This will submit a NEW change (which must first be approved) that will revert the table to state it was in just prior to the selected upload. -Note that Data Controller can only track (and revert) changes that are made using the Data Controller tool itself! It does not / cannot track changes made externally to a table, by other tools. \ No newline at end of file +Note that Data Controller can only track (and revert) changes that are made using the Data Controller tool itself! It does not / cannot track changes made externally to a table, by other tools. + +### Frontend Formulae + +Delivered in v7.13.0. Formula columns (HARDFORMULA / SOFTFORMULA) are computed live in the editor using HyperFormula, with variable-name references resolved to row-relative cell references. See [Formula Rules](/dcc-validations/#formula-rules). + +### Regex Rules + +Delivered. HARDREGEX (blocking) and SOFTREGEX (warning) rules validate cell values against a Perl-style regular expression. See [Regex Rules](/dcc-validations/#regex-rules). \ No newline at end of file