diff --git a/docs/derived-variables.md b/docs/derived-variables.md index 03f7cb0..b18d8e0 100644 --- a/docs/derived-variables.md +++ b/docs/derived-variables.md @@ -6,11 +6,6 @@ description: Derived variables are computed columns that appear in the EDIT scre # Derived Variables -!!! warning "Draft - not in a release yet" - This page describes a feature that is in development. It is published early so - the wording and the screenshots can be reviewed; the behaviour described here - ships in the next release. - A derived variable is a column that does not exist in the target table, but is computed when the table is loaded into the [EDIT screen](/dc-userguide/#editor). It is read-only, it appears after the physical columns, and it can be filtered on like any other column. Derived variables are useful when users need to work with a value that is a function of the stored data - a banding, a concatenation, a calculation - without changing the table, the load process, or the ETL. @@ -23,6 +18,8 @@ The table below is shown in the EDIT screen. `LINE_VALUE` is `QTY * PRICE` and ` ![](./img/derived-grid.png) +The computed columns are marked apart from the physical ones: a tinted header with an `fx` badge, tinted italic cells, and a left edge where the derived block begins. They are read-only, and the marking says so - a column that is locked by a rule or by column level security is dimmed instead, which is a different message from "computed here". Hovering a header shows the variable's label, or its name and expression where no label was configured. + Because the derived columns are created before the filter is applied, they can be filtered like any other column. Here `REGION = 'West'` selects the two western states, and the filter bar names the derived variable: ![](./img/derived-filter-region.png) diff --git a/docs/img/derived-config.png b/docs/img/derived-config.png index 436be74..1e13fc4 100644 Binary files a/docs/img/derived-config.png and b/docs/img/derived-config.png differ diff --git a/docs/img/derived-filter-region.png b/docs/img/derived-filter-region.png index 178af7a..81fb1b8 100644 Binary files a/docs/img/derived-filter-region.png and b/docs/img/derived-filter-region.png differ diff --git a/docs/img/derived-filter-value.png b/docs/img/derived-filter-value.png index e7ea281..bc31cc7 100644 Binary files a/docs/img/derived-filter-value.png and b/docs/img/derived-filter-value.png differ diff --git a/docs/img/derived-grid.png b/docs/img/derived-grid.png index 88e0b1a..f19bb8e 100644 Binary files a/docs/img/derived-grid.png and b/docs/img/derived-grid.png differ diff --git a/docs/roadmap.md b/docs/roadmap.md index 6c50ae6..dcab4ef 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -177,4 +177,8 @@ Delivered in v7.13.0. Formula columns (HARDFORMULA / SOFTFORMULA) are computed ### 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 +Delivered. HARDREGEX (blocking) and SOFTREGEX (warning) rules validate cell values against a Perl-style regular expression. See [Regex Rules](/dcc-validations/#regex-rules). + +### Derived Variables + +Computed columns can be configured per table, so the EDIT screen shows values that are not stored anywhere - a banding from a code, a multiplication of two columns - and they can be filtered on like any other column. The configuration lives in [MPE_DERIVED](/tables/mpe_derived/), and the grid marks the computed columns with an `fx` badge. See [docs](/derived-variables) \ No newline at end of file diff --git a/docs/tables/mpe_derived.md b/docs/tables/mpe_derived.md index aab1b23..25faec4 100644 --- a/docs/tables/mpe_derived.md +++ b/docs/tables/mpe_derived.md @@ -6,11 +6,6 @@ description: The MPE_DERIVED table is used to configure computed columns that ap # MPE_DERIVED -!!! warning "Draft - not in a release yet" - This page describes a feature that is in development. It is published early so - the wording and the screenshots can be reviewed; the behaviour described here - ships in the next release. - The MPE_DERIVED table is used to configure derived (computed) variables - columns that are created when a table is loaded into the EDIT screen, so that they can be displayed and filtered on without being stored. More details are available in the [user guide](/derived-variables/) The table is itself registered in [MPE_TABLES](/tables/mpe_tables/), so it is maintained through the EDIT screen with the usual review and approve workflow. diff --git a/mkdocs.yml b/mkdocs.yml index 260c64b..b94d9f7 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -33,7 +33,7 @@ nav: - MPE_DATASTATUS_TABS: tables/mpe_datastatus_tabs.md - MPE_DATADICTIONARY: tables/mpe_datadictionary.md - MPE_DATALOADS: tables/mpe_dataloads.md - - MPE_DERIVED (draft): tables/mpe_derived.md + - MPE_DERIVED: tables/mpe_derived.md - MPE_EMAILS: tables/mpe_emails.md - MPE_EXCEL_CONFIG: tables/mpe_excel_config.md - MPE_FILTERANYTABLE: tables/mpe_filteranytable.md @@ -60,7 +60,7 @@ nav: - CAS Tables: cas-tables.md - Column Level Security: column-level-security.md - Dates / Datetimes: dcc-dates.md - - Derived Variables (draft): derived-variables.md + - Derived Variables: derived-variables.md - Dynamic Cell Dropdown: dynamic-cell-dropdown.md - Emails: emails.md - Excel: excel.md