Commit Graph
26 Commits
Author SHA1 Message Date
dc 76b8c5fb07 docs(derived): publish the page, and the images for the computed-column styling
The screenshots were taken on the mocked estate, before setvars began marking
computed columns with an fx badge, a tinted header and a left edge where the
derived block starts.  They are re-taken against a real SAS backend, so the
images show what ships, and the page describes the marking.

The draft banner comes off both pages, the (draft) suffix off both nav entries,
and the roadmap gains its Delivered Features entry - all held until the release
lands.
2026-10-27 23:50:22 +00:00
dc f08c2dff0e docs(derived): the label rule - any text, one line, 256 characters
VAR_LABEL is free text in any script and the quotes are escaped when the
statement is built, but it is a column label: control characters, line breaks and
over 256 characters are refused, the last of those because the engine would cut
the value down silently.
2026-10-26 09:53:55 +00:00
dc de47b25e11 docs(7.19): the RLS restriction on derived variables, and the startup Show log button
Two gaps found reviewing the pages against the code that is shipping:

- A derived variable cannot be named by an active row level security rule of
  any scope - mpe_derived_postedit.sas rejects it, because rules are validated
  against the physical table where a derived column does not exist. Neither the
  derived variables page nor row-level-security.md said so.

- The startup failure modal's Show log button (#356, in this release) was not
  documented anywhere. Added to troubleshooting, with why the browser request
  is what gets the log on Viya.
2026-10-26 08:44:27 +00:00
dc 2076eddd1b docs(derived): say circular references rather than a cycle 2026-10-21 22:25:50 +00:00
dc 94bf510010 docs(derived): shorten the dependency rule 2026-10-21 22:24:55 +00:00
dc d6065826fb docs(derived): tighten the collision rule 2026-10-21 22:24:05 +00:00
dc e9d48594d7 docs(derived): shorten the collision rule to the rule itself 2026-10-21 22:22:24 +00:00
dc 64c3fb51aa docs(derived): correct the collision rule
TX_FROM, TX_TO and PROCESSED_DTTM are the default names of the metadata
columns rather than reserved names - they are physical columns, refused by the
collision check whatever MPE_TABLES calls them.  The only name refused outright
is the delete marker.  The code now matches: the hard-coded list is gone.
2026-10-21 22:20:04 +00:00
dc 3e4e741f75 docs(derived): drop the retired 'defined earlier' wording
There is no earlier: dependencies are declared in VAR_DEPS and checked in both
directions, so the rejection is an undeclared reference. Both sentences now say
so.
2026-10-21 22:15:07 +00:00
dc c25686c77b docs(derived): mark the page as draft so it can merge before the release
A warning banner on both pages, and '(draft)' in the navigation title, so a
reader is not surprised when the feature is not in their installed version.
Remove both when the release carrying derived variables goes out.

mkdocs build passes; the banner and all four images render.
2026-10-21 22:13:56 +00:00
dc 57edfe5478 docs(derived): include the MPE_DERIVED configuration, recapture at full page
The screenshots now show the whole page rather than a cropped viewport, and the
configuration table is included so the three variables in the grid can be
traced to the three rows that define them.
2026-10-21 15:10:17 +00:00
dc a70daf1789 docs(derived): show the feature, and why it needs a view
Three screenshots from the EDIT screen: the derived columns in the grid, a
filter on a character derived column, and a filter on a numeric one.  Plus a
short 'how it works' explaining that the statements go into a DATA step view
because a WHERE cannot see a variable created in the same step.
2026-10-21 14:36:51 +00:00
dc ac48b91bf4 docs(config): optional VAR_LABEL 2026-10-21 08:14:55 +00:00
dc 617007bbbd revert(config): a derived variable may not reuse a column name 2026-10-20 23:00:13 +00:00
dc d96453ad42 docs(config): a derived variable may shadow a physical column 2026-10-20 22:25:21 +00:00
dc cddf39e58c docs(config): VAR_DEPS 2026-10-20 18:33:30 +00:00
dc 710463ce06 docs(config): VAR_DEPENDENCIES replaces VAR_ORDER
Each row lists every input the expression uses, physical columns and derived
variables alike.  No sequence number to maintain; statements are emitted in
dependency order and a cycle is rejected.
2026-10-20 16:51:13 +00:00
dc 926299f2ee docs(config): the label is <VAR_NM>=<expression> 2026-10-20 11:52:03 +00:00
dc 98e41dbbd7 docs(config): duplicate names are caught by the loader, not the hook 2026-10-20 09:56:57 +00:00
dc 3d5090d49d docs(config): validation rules on MPE_DERIVED 2026-10-20 09:01:58 +00:00
dc 9d27f37ad2 docs(config): MPE_DERIVED is validated at submit time 2026-10-20 08:20:56 +00:00
dc b9f7300708 docs(config): VAR_* column names in MPE_DERIVED
Matches dc/dc: VAR_NM, VAR_ORDER, VAR_TYPE, VAR_LEN, VAR_FMT, VAR_LOGIC.
2026-10-20 07:57:59 +00:00
dc e233f508b6 docs(config): scope the configuration-error claim to what is actually reported
Only the config checks name the variable; a syntax error or an unknown
column fails later in the view build and the abort names the table.
2026-10-20 02:49:34 +00:00
dc 42ffc63009 docs(config): VARIABLE_ORDER and chained derived variables
A derived variable can now be built on one with a lower VARIABLE_ORDER, so
the pages describe the order column, the ordered rule (replacing the
self-contained one) and a chained example.
2026-10-20 02:09:46 +00:00
dc 2272f55162 docs(config): fix the editor anchor and the full reserved-name list
Review follow-up: /dc-userguide/#editor (the heading is 'Editor'), the
reserved names include VAR_TXFROM/VAR_TXTO/VAR_PROCESSED, and derived
columns are not shown in VIEW or downloads though a saved filter on one
still applies there.
2026-10-20 01:24:59 +00:00
dc 183037c4d3 docs(config): derived variables in the EDIT screen
New Configuration page explaining derived (computed) variables: what they
are, how to configure them in MPE_DERIVED, how filtering works, the rules
and limits (expressions only, self-contained, read-only, not stored), and
the data-exposure and performance notes.

New MPE_DERIVED table page, registered in the Table Guide nav.
2026-10-19 23:20:18 +00:00