diff --git a/docs/img/va-parmap-banner.png b/docs/img/va-parmap-banner.png index da8420a..c810365 100644 Binary files a/docs/img/va-parmap-banner.png and b/docs/img/va-parmap-banner.png differ diff --git a/docs/img/va-parmap-filtered.png b/docs/img/va-parmap-filtered.png index 03f5965..d8d3482 100644 Binary files a/docs/img/va-parmap-filtered.png and b/docs/img/va-parmap-filtered.png differ diff --git a/docs/img/va-parmap-transform.png b/docs/img/va-parmap-transform.png deleted file mode 100644 index be4421b..0000000 Binary files a/docs/img/va-parmap-transform.png and /dev/null differ diff --git a/docs/img/va-report-filter-line.png b/docs/img/va-report-filter-line.png deleted file mode 100644 index 59d7bfb..0000000 Binary files a/docs/img/va-report-filter-line.png and /dev/null differ diff --git a/docs/img/va-report-filters.png b/docs/img/va-report-filters.png index 705d3d5..3569cf4 100644 Binary files a/docs/img/va-report-filters.png and b/docs/img/va-report-filters.png differ diff --git a/docs/visual-analytics.md b/docs/visual-analytics.md index b8c24dc..856e6c9 100644 --- a/docs/visual-analytics.md +++ b/docs/visual-analytics.md @@ -50,7 +50,7 @@ VA pushes a JSON payload to the iframe via `window.postMessage` whenever the sel If VA sends an empty / unmatched message the editor falls back to the unfiltered view but stays in VA mode. -The applied filter is shown above the grid, so what the report did to the editor is visible without touching it. In the report below, two report parameters - `SOME_DROPDOWN` and `SOME_DATE` - reach one Data Controller object, and the editor shows both the combined filter and the single row it matches: +In the report below, two report parameters - `SOME_DROPDOWN` and `SOME_DATE` - reach one Data Controller object, and the editor shows both the combined filter and the rows it matches: ![A value and a date parameter filtering the embedded editor](img/va-report-filters.png) @@ -73,7 +73,7 @@ Repeat the parameter to add mappings. A report with two tabs, each holding its | Tab 1 | `...?embed=va&va_parmap=REGION_TAB1-REGION` | | Tab 2 | `...?embed=va&va_parmap=REGION_TAB2-REGION` | -The applied filter is visible in the editor, above the grid - here the parameter `DROPDOWN_TAB1` filtering `SOME_DROPDOWN`, which is not its name: +The applied filter is visible in the editor, above the grid - here the parameter `DROPDOWN_TAB1` filtering `SOME_DROPDOWN`, which is not its name (the date parameter beside it is name-matched, which is the default): ![A va_parmap mapping filtering a column](img/va-parmap-filtered.png) @@ -120,11 +120,7 @@ A mapping can resolve the parameter value through a **named date anchor** before https://yourserver/DC/#/editor//?embed=va&va_parmap=SELECTED_DATE-D_DATE:ADD(QUARTER_START,-1) ``` -A report that sends `SELECTED_DATE = 27FEB1961` then filters `D_DATE` on 1961-02-27 **and** 1960-10-01 - the selected date, plus the same point one quarter earlier: - -In the screenshot below the mapping is `SELECTED_DATE-SOME_DATE:ADD(QUARTER_START,-1)` against the demo table, and the parameter sends 27FEB1961: - -![A date anchor applied to the filter](img/va-parmap-transform.png) +A report that sends `SELECTED_DATE = 27FEB1961` then filters `D_DATE` on 1961-02-27 **and** 1960-10-01 - the selected date, plus the same point one quarter earlier. The clause carries both values, so the row for the selected date and the row for the previous quarter are both included. @@ -184,9 +180,11 @@ The mapping lives entirely in the URL of the report object, so the job is to get FILTER : ( ( REGION = 'Europe' ) ) ``` - A date parameter arrives as a display date and is rendered as a SAS date literal, the same as a date filter built inside Data Controller - `'12FEB1960'd` below, over the row it matches: + A date parameter arrives as a display date and is rendered as a SAS date literal, the same as a date filter built inside Data Controller: - ![A date parameter rendered as a SAS date literal](img/va-report-filter-line.png) + ```text + FILTER : ( ( SOME_DROPDOWN = 'Option 1' AND SOME_DATE BETWEEN '01JAN1960'd AND '31MAR1960'd ) ) + ``` Something wrong shows the banner instead, with the cause and the fix - see [When a mapping cannot be used](#when-a-mapping-cannot-be-used) above.