Reads the registered col_filters from the metadata tables of the connected
database. Returns a nested list keyed by table type and table key (code type
or mapping pair). This reflects the registered defaults, not the active
session pins — use codeminer_status() to inspect the currently pinned state.
Value
A codeminer_col_filters object (a list with entries for
lookup, mapping, and relationship). Each entry is a named list
keyed by code type (or "from > to" for mappings), containing either:
If
defaults_only = TRUE: a flatlist(col = c(default_values))If
defaults_only = FALSE: a fulllist(col = list(values = ..., defaults = ..., description = ..., value_labels = ...))
The defaults_only = TRUE form is the shape accepted by the
col_filters argument on query functions (see CODES()),
codeminer_set_col_filters(), and with_col_filters() — amend it with
plain assignment and pass it back. Each column's default is its applied
value set (a column included in full by default lists all of its values),
so passing the output back unchanged reproduces the default query exactly.
Narrow a column by assigning a subset (e.g.
cf$lookup[["SNOMED CT"]]$moduleId_concept <- "999000011000001104"), drop
a column's filter with NA, or clear a whole table with NA. Returns an
empty object if no database is connected.