IssuedCertificateListViewModel

Class in Oadm.Sdk.Client.Controls · Oadm.Sdk.Client.dll

The list of certificates (SDK 0.4.0; the PKI Certificates tab: its CA list and its certificate list): newest first, read from the server one page at a time with the filters (state, use, issued by) and the search (it waits for the typing to stop), the grid’s selection in one step, View certificate. Shown by IssuedCertificateList; the first read shows the overlay, later ones the progress row.

public class IssuedCertificateListViewModel : ObservableObject

Inherits ObservableObject

Constructors

IssuedCertificateListViewModel

IssuedCertificateListViewModel(IIssuedCertificateSource source, TimeProvider? time = null)

A list that reads from source; time for the search delay (tests).

Properties

CanGroup

bool CanGroup { get; init; }

Whether the list offers Group by (a source that groups on the server, the PKI page); false: the select is hidden and the rows have no group headers.

Dialogs

IIssuedCertificateListDialogs? Dialogs { get; set; }

The certificate window (the view).

EmptyText

string? EmptyText { get; }

One line when the list is empty: what to do first, or that nothing matches.

Error

string? Error { get; set; }

“Cannot read the certificates: …” directly below the table; null after a good read.

GroupBy

IssuedCertificateGroupChoice GroupBy { get; set; }

The chosen grouping; a change reads the first page again.

GroupChoices

IReadOnlyList<IssuedCertificateGroupChoice> GroupChoices { get; }

“Group by type” (the default), “Group by issuer”, “No groups”.

GroupTitles

IReadOnlyList<string> GroupTitles { get; private set; }

The group headers of the shown page in their order (the view rebuilds its groups when they change).

HasError

bool HasError { get; }

IssuedCertificateListViewModel.Error is set.

HasPages

bool HasPages { get; }

More rows than one page: Previous and Next show.

IsGrouped

bool IsGrouped { get; private set; }

The rows have group headers (IssuedCertificateRow.GroupTitle).

IsLoading

bool IsLoading { get; set; }

The first read (the overlay over the grid).

IsReloading

bool IsReloading { get; set; }

A later read (filter, page, change on the server): the progress row above the grid.

IsWorking

bool IsWorking { get; }

A write of the page runs (IssuedCertificateListViewModel.WorkText): its buttons stay off.

NextPageCommand

IAsyncRelayCommand NextPageCommand { get; }

Gets an IAsyncRelayCommand instance wrapping IssuedCertificateListViewModel.NextPageAsync.

NextText

string NextText { get; }

“Next 500”.

NoRowsText

string NoRowsText { get; init; }

The empty list without filters: what to do first (default IssuedCertificateTexts.NoCertificates).

Offset

int Offset { get; set; }

The first row of the shown page.

PageSize

int PageSize { get; init; }

Rows of one page.

PageText

string PageText { get; }

“1-500 of 12,345”; empty without rows.

PreviousPageCommand

IAsyncRelayCommand PreviousPageCommand { get; }

Gets an IAsyncRelayCommand instance wrapping IssuedCertificateListViewModel.PreviousPageAsync.

PreviousText

string PreviousText { get; }

“Previous 500”.

ProgressText

string ProgressText { get; }

The text of the progress row: the write while one runs, else “Reading the certificates”.

Rows

RangeObservableCollection<IssuedCertificateRow> Rows { get; }

The rows of the shown page, newest first (bound to the grid).

Search

string? Search { get; set; }

Text in any column, the device’s host name or serial, or the certificate’s serial; read 300 ms after the last key.

SearchDelay

TimeSpan SearchDelay { get; init; }

Wait after typing in the search before the server is asked.

Selected

IReadOnlyList<IssuedCertificateRow> Selected { get; }

The chosen rows (the grid’s selection).

ShowsFilters

bool ShowsFilters { get; init; }

The filters show (default); false for a short list such as the PKI page’s CAs (the search always shows).

ShowsProgress

bool ShowsProgress { get; }

The progress row above the grid shows: a later read or a write of the page.

ShowsUsedIn

bool ShowsUsedIn { get; init; }

A CA list (the PKI page’s): the Used in column shows (the policies that use each CA) and the Type column is wider (the OADM CA’s badges); false by default.

SourceChoices

RangeObservableCollection<IssuedCertificateFilter> SourceChoices { get; }

“Issued by any” and the CAs the server lists, or Task and EST when it lists none.

SourceFilter

IssuedCertificateFilter SourceFilter { get; set; }

The chosen source; a change reads the first page again.

StateChoices

IReadOnlyList<IssuedCertificateFilter> StateChoices { get; }

“All states” and every state a row can have: Valid, Expires soon, Expired (decision 2026-10-25: no Replaced, the list holds only each camera’s current certificates; decision 2026-10-26: no Revoked, a certificate no longer accepted is not listed).

StateFilter

IssuedCertificateFilter StateFilter { get; set; }

The chosen state; a change reads the first page again.

Time

TimeProvider Time { get; }

Protected: for classes that derive from it

The clock of the search delay and the certificate window.

Total

int Total { get; set; }

How many certificates match the filters and the search.

UseChoices

IReadOnlyList<IssuedCertificateFilter> UseChoices { get; }

“All uses” and every use.

UseFilter

IssuedCertificateFilter UseFilter { get; set; }

The chosen use; a change reads the first page again.

ViewCertificateCommand

IAsyncRelayCommand ViewCertificateCommand { get; }

Gets an IAsyncRelayCommand instance wrapping IssuedCertificateListViewModel.ViewCertificateAsync.

ViewRowCommand

IAsyncRelayCommand<IssuedCertificateRow?> ViewRowCommand { get; }

Gets an IAsyncRelayCommand<T> instance wrapping IssuedCertificateListViewModel.ViewRowAsync.

WorkText

string? WorkText { get; protected set; }

The text of a write the page runs on the list (“Deleting the certificates”); null while none runs. The progress row shows it above the grid.

Methods

ActionsOf

virtual IReadOnlyList<IssuedCertificateAction> ActionsOf(IssuedCertificateRow row)

Protected: for classes that derive from it

The actions of one row: View by default; a page adds its own (everyday ones first, a separator, the red ones last).

LoadAsync

Task LoadAsync(CancellationToken ct = default)

Reads the page at IssuedCertificateListViewModel.Offset with the filters (the first time with the overlay).

MenuOf

IReadOnlyList<IssuedCertificateAction> MenuOf(IssuedCertificateRow row)

The actions menu of a row (its ⋯ button and its right-click menu): the row’s own actions, or, when the row is one of several chosen rows, what the page does with all of them (IssuedCertificateListViewModel.SelectionActions) when it offers something.

MoreStatesOf

virtual IReadOnlyList<IssuedCertificateStatus> MoreStatesOf(IssuedCertificateInfo row)

Protected: for classes that derive from it

Statuses the page adds below the type of a row (the OADM CA’s trust); none by default.

OnGroupingChanged

virtual void OnGroupingChanged(IssuedCertificateGrouping grouping)

Protected: for classes that derive from it

After the user chose another grouping (a page keeps the choice).

OnSelectionChanged

virtual void OnSelectionChanged()

Protected: for classes that derive from it

After every change of IssuedCertificateListViewModel.Selected (commands of a derived list).

OnWorkChanged

virtual void OnWorkChanged()

Protected: for classes that derive from it

After every change of IssuedCertificateListViewModel.WorkText (commands of a derived list stay off while a write runs).

RefreshRows

void RefreshRows()

Protected: for classes that derive from it

Builds the rows of the shown page again (the page’s IssuedCertificateListViewModel.MoreStatesOf changed); the selection stays.

SelectionActions

virtual IReadOnlyList<IssuedCertificateAction> SelectionActions()

Protected: for classes that derive from it

The actions for several chosen rows; none by default (the menu then shows the row’s own).

SetSelection

void SetSelection(IEnumerable<IssuedCertificateRow> rows)

The grid’s selection changed (one step for many rows).

ShowMessageAsync

virtual Task ShowMessageAsync(string title, string message)

Protected: for classes that derive from it

A message to the user (the page’s message window).

ViewAsync

Task ViewAsync(IssuedCertificateRow row)

Protected: for classes that derive from it

Shows row in the shared certificate window (or why it cannot be shown).

WarningDaysFor

int WarningDaysFor(IssuedCertificateRow row, DateTime nowUtc)

The warning days of the certificate window: the server’s (PKI’s setting) when the page said, else what makes the window agree with the row’s state (Expires soon or Valid), else the default.

Events

GroupsChanged

event EventHandler? GroupsChanged

The groups of the shown page changed (another grouping, other counts): the view groups the rows again.

SelectionRestored

event EventHandler? SelectionRestored

The rows were replaced and the selection kept: the view selects them again in the grid.