Introduction

The pages mentioned below have records displayed in lists. These can be configured using a JSON file.

There are 2 levels where the configurations can be done

CP Level

System Level

What can be configured?

Columns
Sorting order
Filters (on the right-hand side)
Conditional data display: Fixed criteria can be set to display only specific participants and specimens. For example, display only aliquots.

JSON Attributes and Uses

Attribute	Usage

Attribute

Usage

name

Name of the list configuration.
Ex: participant-list-view or specimen-list-view, or common.

data

listview

To set the default landing page, you can choose between the participant list view or the specimen list view.

By default, the participant list view is selected unless specified otherwise in the data property.

To make the specimen list view the default, configure it as follows: "listView": "cp-specimens".

columns

Columns to be displayed in list view.

expr

The properties of an object that can be displayed in a list include:

For example: Participant.ppid or Specimen.label

You can also specify a combination of two fields as shown below:

concat(Participant.firstName, " ", Participant.lastName)
years_between(current_date(), Participant.dateOfBirth)
Additionally, for details on adding different attribute types, refer to https://openspecimen.atlassian.net/wiki/x/YAAIBg wiki page

caption

The caption for the column that will appear in the table header.

metainfo

Meta information regarding the column or field to be displayed is as follows:

For example, setting "showLink": "true" will enable a hyperlink on the field, allowing users to redirect to the corresponding object.

criteria

To display records in a list, specific criteria must be met.

For example, "Participant.id exists" indicates that only records with a valid participant ID will be shown.

orderBy

expr	Name of the property in the object. Ex: Participant.regDate
direction	You can order the results in either ascending or descending order. For example, use `desc` to sort in descending order. If no order is specified, the default will be ascending order.

filters

To configure the filters on which the filtering of data should be performed.

expr

The property of an object that will be displayed in the list includes attributes such as:

Participant.ppid
Specimen.label

caption

The caption for the column that will appear in the table header.

metainfo

Metadata regarding the column or field used for filters. For example: "phi":"true" — this setting will conceal this field from users who do not have access to phi.

OpenSpecimen

List View Configuration

Introduction

What can be configured?

JSON Attributes and Uses