CP List Page

Overview

The screenshot below is the CP list page that shows all collection protocols created in the system. This is accessible via the 'Collection Protocols' menu. You can configure the fields displayed on the CP list page under the section ‘cp-list-view’. If the user has not configured the ‘cp-list-view’ in the system workflow, then OpenSpecimen uses the default configuration.

Default Configuration

This is the default configuration for the specimen list view shipped with OpenSpecimen.

	{
      "name": "cp-list-view",
      "data": {
          "columns": [
              {
                  "expr": "CollectionProtocol.shortTitle",
                  "caption": "Title",
                  "metainfo": {
                      "showLink": "true"
                  }
              },
              {
                  "expr": "CollectionProtocol.principalInvestigator.investigatorName",
                  "caption": "Principal Investigator"
              },
              {
                  "expr": "CollectionProtocol.startDate",
                  "caption": "Start Date"
              },
              {
                  "expr": "CollectionProtocol.endDate",
                  "caption": "End Date"
              },
              {
                "expr": "CollectionProtocol.customFields.cPCustomField.type",
                "caption": "CP Type"
              }

          ],
          "criteria": "CollectionProtocol.id exists",
          "orderBy": [
              {
                  "expr": "CollectionProtocol.shortTitle",
                  "direction": "asc"
              }
          ],
          "filters": [
              {
                  "expr": "CollectionProtocol.shortTitle",
                  "caption": "Title",
                  "searchType": "contains"
              },
              {
                  "expr": "CollectionProtocol.Title",
                  "caption": "Long Title",
                  "searchType": "contains"
              },
              {
                  "expr": "CollectionProtocol.principalInvestigator.investigatorName",
                  "caption": "Principal Investigator"
              },
              {
                  "expr": "CollectionProtocol.cpSites.siteName",
                  "caption": "Repository"
              }
          ]
      }
  	},

Customise List View

The specimen list view is customizable to your needs through JSON configurations. By adjusting columns, sorting orders, filtering options, and conditional criteria, you can optimise the way specimen data is displayed. You can modify the list view to add

Default CP Fields

Field	JSON Code

Field	JSON Code
Collection Protocol Code in list view page(Supported from v9.0)	`{ "expr": "CollectionProtocol.code", "caption": "CP Code" },`
Institute of PI	`{ "expr": "CollectionProtocol.principalInvestigator.institute", "caption": "PI Institute" }`
Institute of Coordinator	`{ "expr": "CollectionProtocol.coordinator.institute", "caption": "Coordinator Institute" }`

Custom Fields

Field	JSON Code

Field

JSON Code

Custom Field:

In 'expr', 'cPCustomFields' is a Form Name, 'type' is an attribute name.

{
  "expr": "CollectionProtocol.customFields.cPCustomField.type",
  "caption": "CP Type"
}