System Views Refactor Task List (DVTables)

Last updated: 2025-12-14

Goal

Standardize Dataverse grid system views so that:

System views are defined in the relevant *GridColumns class via public static function getSystemViews(array $options = []): array.
Controllers retrieve system views from GridColumns and pass them into processDataverseGrid([... 'systemViews' => ...]).
System view configs use config['columns'] (not visibleColumns).

Conventions

Always call GridColumns::getSystemViews([]) (or with contextual options), even if options are empty.
System view IDs are unique per grid.
Dynamic date/time-based views are computed inside getSystemViews().

Current migration status

Repository scan (2025-12-14) indicates:

All controllers that pass systemViews are now sourcing them from *GridColumns::getSystemViews($options).
No remaining controller-owned system view arrays or get*SystemViews() helper methods were found.
All 11 GridColumns with custom system views have been audited:
- Correct signature: getSystemViews(array $options = []): array
- Using config['columns'] (not visibleColumns)
- Controllers properly call GridColumns::getSystemViews([...]) and pass to processDataverseGrid
Remaining work: Decide/add new system views for grids that currently run without any.

Completed migrations (system views now live in GridColumns)

Remaining controller + GridColumns audits (no system views currently wired)

These controllers call processDataverseGrid(...) but do not currently provide systemViews. For each, decide whether to (A) add system views or (B) explicitly keep none.

GridColumns status (custom `getSystemViews()`)

Has custom system views now

No custom system views (simple lookups - intentionally no views)

Per-item definition of done

For any row you decide should have system views:

Add getSystemViews(array $options = []): array to the GridColumns class.
Controller uses GridColumns::getSystemViews([...]) and passes it as 'systemViews' => $systemViews.
Pick a defaultSystemView.
Ensure system view config uses config['columns'].

System Views Refactor Task List (DVTables)

Goal

Conventions

Current migration status

Completed migrations (system views now live in GridColumns)

Remaining controller + GridColumns audits (no system views currently wired)

Core app (app/src)

Activities plugin (app/plugins/Activities)

Awards plugin (app/plugins/Awards)

Officers plugin (app/plugins/Officers)

GridColumns status (custom getSystemViews())

Has custom system views now

No custom system views (simple lookups - intentionally no views)

Per-item definition of done

Core app (`app/src`)

Activities plugin (`app/plugins/Activities`)

Awards plugin (`app/plugins/Awards`)

Officers plugin (`app/plugins/Officers`)

GridColumns status (custom `getSystemViews()`)