Merge pull request 'docs(viewer): document full table search semantics with a screenshot' (#5) from docs/full-table-search into main

Reviewed-on: #5 Reviewed-by: Allan <allan@4gl.io>
2026-09-17 09:49:11 +00:00
parent 94b27628aa 85f200c724
commit cd47d0e442
2 changed files with 10 additions and 0 deletions
@@ -16,6 +16,16 @@ Row and Column level security can also be applied in VIEW mode, as can additiona

 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 result set is capped by the [`DC_MAXOBS_WEBVIEW`](/dcc-options/#dc_maxobs_webview) option (500 rows by default). The row count shown next to the table name is the number of rows the search matched, which can be higher than the number of rows displayed.
+- A search that matches nothing shows a "No data found with given conditions" panel rather than an empty grid.
+
+![Full table search](img/full-table-search.png)
+
 <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