dc
856e57173f
Review 431: dc-overview.md still said "Up to 500 rows can be edited (in the web editor) at one time" - the wrong number (DC_MAXOBS_WEBEDIT ships at 250) and, once dc/dc#352 lands, the wrong behaviour (an over-limit selection is served truncated with a warning, not refused or capped at a count). It now names both limits, whichever binds first, and links to the options that set them. Sweeping for the same stale figure turned up dcu-tableviewer.md, which says 500 twice and uses 500 in its worked example of the row count above the grid. DC_MAXOBS_WEBVIEW has been 2000 since 20261003_row_and_cell_limits.sas (the migration records 500 -> 2000), and mpe_makedata seeds 2000, so those three places were two releases out of date. Fixed here, and flagged in the PR reply as VIEW rather than EDIT in case it belongs in its own change. Checked: no "500 rows" or stale abort wording left in docs/, and the two anchors the overview now links to (dc_maxobs_webedit, dc_maxcells_webedit) exist on the published options page.
57 lines
3.7 KiB
Markdown
57 lines
3.7 KiB
Markdown
# Data Controller for SAS: Viewer
|
|
|
|
The viewer screen provides a raw view of the underlying table.
|
|
Choose a library, then a table, and click view to see the first rows - up to the `DC_MAXOBS_WEBVIEW` limit, 2,000 rows by default.
|
|
A filter option is provided should you wish to view a different section of rows.
|
|
|
|
The following libraries will be visible:
|
|
|
|
* All libraries available on startup (session autoexec)
|
|
* Any libraries configured in the `services/public/[Data_Controller_Settings/settings]` Stored Process / Viya Job
|
|
* All libraries available to the logged in user in metadata (SAS 9 only)
|
|
|
|
Row and Column level security can also be applied in VIEW mode, as can additional table-level permissions (MPE_SECURITY table).
|
|
|
|
## Full Table Search
|
|
|
|
A single search box can be used to make a full table search on any character or numeric value, using this [macro](https://core.sasjs.io/mp__searchdata_8sas.html).
|
|
|
|
The search covers **every** column of the table at once, so you do not need to know which column holds the value you are looking for:
|
|
|
|
- **Character search** (the default) is a case sensitive CONTAINS match against every character column, so `Smith` finds `Smithson` and `smith` finds `Goldsmith`, but `smith` will not find `Smithson`.
|
|
- **Numeric search** (tick the Numeric box) is an exact match against every numeric column, so `42` will not find `420` or `4210`.
|
|
- If a filter is applied, the search runs within the filtered rows rather than the whole table.
|
|
- The grid is capped by the [`DC_MAXOBS_WEBVIEW`](/dcc-options/#dc_maxobs_webview) option (2,000 rows by default).
|
|
- For a search, the cap applies to the row count as well: a search that matches more rows than the cap returns 2,000 of them, and the count shown next to the table name is the number of rows returned, not the total number of matches.
|
|
- Without a search, the count shown next to the table name is the full number of rows in the filtered view, so it can be higher than the number of rows displayed - a table of 5,000 rows reports `5,000 rows` above a grid holding the first 2,000.
|
|
- A search that matches nothing shows a "No data found with given conditions" panel rather than an empty grid.
|
|
|
|
|
|
|
|
<iframe width="560" height="315" src="https://www.youtube.com/embed/i27w-xq85WQ" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
|
|
|
|
## Options
|
|
|
|
This button shows a range of options. If the table is editable, you will also see a EDIT option.
|
|
|
|
### Download
|
|
The Download button gives several options for obtaining the current view of data:
|
|
|
|
1) CSV. This provides a comma delimited file.
|
|
|
|
2) Excel. This provides a tab delimited file.
|
|
|
|
3) SAS Datalines. This provides a SAS program with data as datalines, so that the data can be rebuilt as a SAS table.
|
|
|
|
4) SAS DDL. A download of a DDL file using SAS flavoured syntax.
|
|
|
|
5) TSQL DDL. A DDL download using SQL Server flavoured syntax.
|
|
|
|
Note - if the table is registered in Data Controller as being TXTEMPORAL (SCD2) then the download option will prefilter for the _current_ records and removes the valid from / valid to variables. This makes the CSV suitable for DC file upload, if desired.
|
|
|
|
Note that all the above items are exported from backend. There is also a _frontend_ context menu that can be used in the VIEW screen (right click menu) for quick export into CSV or Excel formats.
|
|
|
|
### Web Query URL
|
|
|
|
This option gives you a URL that can be used to import data directly into third party tools such as Power BI or Microsoft Excel (as a "web query"). You can set up a filter, eg for a particular month, and refresh the query on demand using client tooling such as VBA.
|