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".

","nestedContent":{"type":"doc","content":[{"type":"table","attrs":{"layout":"default","localId":"6999e255-e4a1-4aa0-a479-40fcd8d53577"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[259.0]},"content":[{"type":"paragraph","content":[{"text":"listview","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1052.0]},"content":[{"type":"paragraph","content":[{"text":"To set the default landing page, you can choose between the participant list view or the specimen list view.","type":"text"}]},{"type":"paragraph","content":[{"text":"By default, the participant list view is selected unless specified otherwise in the data property.","type":"text"}]},{"type":"paragraph","content":[{"text":"To make the specimen list view the default, configure it as follows: ","type":"text"},{"text":"\"listView\": \"cp-specimens\"","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]}]}]}],"version":1},"adf":"{\"type\":\"doc\",\"content\":[{\"type\":\"table\",\"attrs\":{\"layout\":\"default\",\"localId\":\"6999e255-e4a1-4aa0-a479-40fcd8d53577\"},\"content\":[{\"type\":\"tableRow\",\"content\":[{\"type\":\"tableCell\",\"attrs\":{\"colspan\":1,\"rowspan\":1,\"colwidth\":[259.0]},\"content\":[{\"type\":\"paragraph\",\"content\":[{\"text\":\"listview\",\"type\":\"text\"}]}]},{\"type\":\"tableCell\",\"attrs\":{\"colspan\":1,\"rowspan\":1,\"colwidth\":[1052.0]},\"content\":[{\"type\":\"paragraph\",\"content\":[{\"text\":\"To set the default landing page, you can choose between the participant list view or the specimen list view.\",\"type\":\"text\"}]},{\"type\":\"paragraph\",\"content\":[{\"text\":\"By default, the participant list view is selected unless specified otherwise in the data property.\",\"type\":\"text\"}]},{\"type\":\"paragraph\",\"content\":[{\"text\":\"To make the specimen list view the default, configure it as follows: \",\"type\":\"text\"},{\"text\":\"\\\"listView\\\": \\\"cp-specimens\\\"\",\"type\":\"text\",\"marks\":[{\"type\":\"strong\"}]},{\"text\":\".\",\"type\":\"text\"}]}]}]}]}],\"version\":1}","reason":"A table in a table cell can't be created or edited in the new editor."}}},{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"nested-table","text":"","parameters":{"cxhtml":"

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.

","nestedContent":{"type":"doc","content":[{"type":"table","attrs":{"layout":"default","localId":"53c28808-9ac6-40cf-be7d-aae8302acac1"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[268.0]},"content":[{"type":"paragraph","content":[{"text":"columns","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1043.0]},"content":[{"type":"paragraph","content":[{"text":"Columns to be displayed in list view.","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"edb87247-5937-48ab-a76f-415e25b86229"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[107.0]},"content":[{"type":"paragraph","content":[{"text":"expr","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[918.0]},"content":[{"type":"paragraph","content":[{"text":"The properties of an object that can be displayed in a list include:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For example: ","type":"text"},{"text":"Participant.ppid","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"Specimen.label","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"paragraph","content":[{"text":"You can also specify a combination of two fields as shown below:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"concat(Participant.firstName, \" \", Participant.lastName)","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"years_between(current_date(), Participant.dateOfBirth)","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Additionally, for details on adding different attribute types, refer to ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://openspecimen.atlassian.net/wiki/x/YAAIBg"}},{"text":" wiki page","type":"text"}]}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[107.0]},"content":[{"type":"paragraph","content":[{"text":"caption","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[918.0]},"content":[{"type":"paragraph","content":[{"text":"The caption for the column that will appear in the table header.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[107.0]},"content":[{"type":"paragraph","content":[{"text":"metainfo","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[918.0]},"content":[{"type":"paragraph","content":[{"text":"Meta information regarding the column or field to be displayed is as follows:","type":"text"}]},{"type":"paragraph","content":[{"text":"For example, setting ","type":"text"},{"text":"\"showLink\": \"true\"","type":"text","marks":[{"type":"code"}]},{"text":" will enable a hyperlink on the field, allowing users to redirect to the corresponding object.","type":"text"}]}]}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[268.0]},"content":[{"type":"paragraph","content":[{"text":"criteria","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1043.0]},"content":[{"type":"paragraph","content":[{"text":"To display records in a list, specific criteria must be met.","type":"text"}]},{"type":"paragraph","content":[{"text":"For example, \"","type":"text"},{"text":"Participant.id","type":"text","marks":[{"type":"link","attrs":{"href":"http://Participant.id"}}]},{"text":" exists\" indicates that only records with a valid participant ID will be shown.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[268.0]},"content":[{"type":"paragraph","content":[{"text":"orderBy","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1043.0]},"content":[{"type":"table","attrs":{"layout":"default","localId":"04a66761-27dd-4bcb-85d4-ba79cfa02ed7"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[152.0]},"content":[{"type":"paragraph","content":[{"text":"expr","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[873.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the property in the object. Ex: Participant.regDate","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[152.0]},"content":[{"type":"paragraph","content":[{"text":"direction","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[873.0]},"content":[{"type":"paragraph","content":[{"text":"You can order the results in either ascending or descending order. ","type":"text"},{"type":"hardBreak"},{"text":"For example, use ","type":"text"},{"text":"desc","type":"text","marks":[{"type":"code"}]},{"text":" to sort in descending order. ","type":"text"},{"type":"hardBreak"},{"text":"If no order is specified, the default will be ascending order.","type":"text"}]}]}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[268.0]},"content":[{"type":"paragraph","content":[{"text":"filters","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1043.0]},"content":[{"type":"paragraph","content":[{"text":"To configure the filters on which the filtering of data should be performed.","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"f80b6261-b5d6-438d-a6aa-a4d6176f0ddc"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[205.0]},"content":[{"type":"paragraph","content":[{"text":"expr","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[820.0]},"content":[{"type":"paragraph","content":[{"text":"The property of an object that will be displayed in the list includes attributes such as:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Participant.ppid","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Specimen.label","type":"text","marks":[{"type":"code"}]}]}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[205.0]},"content":[{"type":"paragraph","content":[{"text":"caption","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[820.0]},"content":[{"type":"paragraph","content":[{"text":"The caption for the column that will appear in the table header.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[205.0]},"content":[{"type":"paragraph","content":[{"text":"metainfo","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[820.0]},"content":[{"type":"paragraph","content":[{"text":"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.","type":"text"}]}]}]}]}]}]}]}],"version":1},"adf":"{\"type\":\"doc\",\"content\":[{\"type\":\"table\",\"attrs\":{\"layout\":\"default\",\"localId\":\"53c28808-9ac6-40cf-be7d-aae8302acac1\"},\"content\":[{\"type\":\"tableRow\",\"content\":[{\"type\":\"tableCell\",\"attrs\":{\"colspan\":1,\"rowspan\":1,\"colwidth\":[268.0]},\"content\":[{\"type\":\"paragraph\",\"content\":[{\"text\":\"columns\",\"type\":\"text\"}]}]},{\"type\":\"tableCell\",\"attrs\":{\"colspan\":1,\"rowspan\":1,\"colwidth\":[1043.0]},\"content\":[{\"type\":\"paragraph\",\"content\":[{\"text\":\"Columns to be displayed in list view.\",\"type\":\"text\"}]},{\"type\":\"table\",\"attrs\":{\"layout\":\"default\",\"localId\":\"edb87247-5937-48ab-a76f-415e25b86229\"},\"content\":[{\"type\":\"tableRow\",\"content\":[{\"type\":\"tableCell\",\"attrs\":{\"colspan\":1,\"rowspan\":1,\"colwidth\":[107.0]},\"content\":[{\"type\":\"paragraph\",\"content\":[{\"text\":\"expr\",\"type\":\"text\"}]}]},{\"type\":\"tableCell\",\"attrs\":{\"colspan\":1,\"rowspan\":1,\"colwidth\":[918.0]},\"content\":[{\"type\":\"paragraph\",\"content\":[{\"text\":\"The properties of an object that can be displayed in a list include:\",\"type\":\"text\"}]},{\"type\":\"bulletList\",\"content\":[{\"type\":\"listItem\",\"content\":[{\"type\":\"paragraph\",\"content\":[{\"text\":\"For example: \",\"type\":\"text\"},{\"text\":\"Participant.ppid\",\"type\":\"text\",\"marks\":[{\"type\":\"code\"}]},{\"text\":\" or \",\"type\":\"text\"},{\"text\":\"Specimen.label\",\"type\":\"text\",\"marks\":[{\"type\":\"code\"}]}]}]}]},{\"type\":\"paragraph\",\"content\":[{\"text\":\"You can also specify a combination of two fields as shown below:\",\"type\":\"text\"}]},{\"type\":\"bulletList\",\"content\":[{\"type\":\"listItem\",\"content\":[{\"type\":\"paragraph\",\"content\":[{\"text\":\"concat(Participant.firstName, \\\" \\\", Participant.lastName)\",\"type\":\"text\",\"marks\":[{\"type\":\"code\"}]}]}]},{\"type\":\"listItem\",\"content\":[{\"type\":\"paragraph\",\"content\":[{\"text\":\"years_between(current_date(), Participant.dateOfBirth)\",\"type\":\"text\",\"marks\":[{\"type\":\"code\"}]},{\"type\":\"hardBreak\"},{\"text\":\"Additionally, for details on adding different attribute types, refer to \",\"type\":\"text\"},{\"type\":\"inlineCard\",\"attrs\":{\"url\":\"https://openspecimen.atlassian.net/wiki/x/YAAIBg\"}},{\"text\":\" wiki page\",\"type\":\"text\"}]}]}]}]}]},{\"type\":\"tableRow\",\"content\":[{\"type\":\"tableCell\",\"attrs\":{\"colspan\":1,\"rowspan\":1,\"colwidth\":[107.0]},\"content\":[{\"type\":\"paragraph\",\"content\":[{\"text\":\"caption\",\"type\":\"text\"}]}]},{\"type\":\"tableCell\",\"attrs\":{\"colspan\":1,\"rowspan\":1,\"colwidth\":[918.0]},\"content\":[{\"type\":\"paragraph\",\"content\":[{\"text\":\"The caption for the column that will appear in the table header.\",\"type\":\"text\"}]}]}]},{\"type\":\"tableRow\",\"content\":[{\"type\":\"tableCell\",\"attrs\":{\"colspan\":1,\"rowspan\":1,\"colwidth\":[107.0]},\"content\":[{\"type\":\"paragraph\",\"content\":[{\"text\":\"metainfo\",\"type\":\"text\"}]}]},{\"type\":\"tableCell\",\"attrs\":{\"colspan\":1,\"rowspan\":1,\"colwidth\":[918.0]},\"content\":[{\"type\":\"paragraph\",\"content\":[{\"text\":\"Meta information regarding the column or field to be displayed is as follows:\",\"type\":\"text\"}]},{\"type\":\"paragraph\",\"content\":[{\"text\":\"For example, setting \",\"type\":\"text\"},{\"text\":\"\\\"showLink\\\": \\\"true\\\"\",\"type\":\"text\",\"marks\":[{\"type\":\"code\"}]},{\"text\":\" will enable a hyperlink on the field, allowing users to redirect to the corresponding object.\",\"type\":\"text\"}]}]}]}]}]}]},{\"type\":\"tableRow\",\"content\":[{\"type\":\"tableCell\",\"attrs\":{\"colspan\":1,\"rowspan\":1,\"colwidth\":[268.0]},\"content\":[{\"type\":\"paragraph\",\"content\":[{\"text\":\"criteria\",\"type\":\"text\"}]}]},{\"type\":\"tableCell\",\"attrs\":{\"colspan\":1,\"rowspan\":1,\"colwidth\":[1043.0]},\"content\":[{\"type\":\"paragraph\",\"content\":[{\"text\":\"To display records in a list, specific criteria must be met.\",\"type\":\"text\"}]},{\"type\":\"paragraph\",\"content\":[{\"text\":\"For example, \\\"\",\"type\":\"text\"},{\"text\":\"Participant.id\",\"type\":\"text\",\"marks\":[{\"type\":\"link\",\"attrs\":{\"href\":\"http://Participant.id\"}}]},{\"text\":\" exists\\\" indicates that only records with a valid participant ID will be shown.\",\"type\":\"text\"}]}]}]},{\"type\":\"tableRow\",\"content\":[{\"type\":\"tableCell\",\"attrs\":{\"colspan\":1,\"rowspan\":1,\"colwidth\":[268.0]},\"content\":[{\"type\":\"paragraph\",\"content\":[{\"text\":\"orderBy\",\"type\":\"text\"}]}]},{\"type\":\"tableCell\",\"attrs\":{\"colspan\":1,\"rowspan\":1,\"colwidth\":[1043.0]},\"content\":[{\"type\":\"table\",\"attrs\":{\"layout\":\"default\",\"localId\":\"04a66761-27dd-4bcb-85d4-ba79cfa02ed7\"},\"content\":[{\"type\":\"tableRow\",\"content\":[{\"type\":\"tableCell\",\"attrs\":{\"colspan\":1,\"rowspan\":1,\"colwidth\":[152.0]},\"content\":[{\"type\":\"paragraph\",\"content\":[{\"text\":\"expr\",\"type\":\"text\"}]}]},{\"type\":\"tableCell\",\"attrs\":{\"colspan\":1,\"rowspan\":1,\"colwidth\":[873.0]},\"content\":[{\"type\":\"paragraph\",\"content\":[{\"text\":\"Name of the property in the object. Ex: Participant.regDate\",\"type\":\"text\"}]}]}]},{\"type\":\"tableRow\",\"content\":[{\"type\":\"tableCell\",\"attrs\":{\"colspan\":1,\"rowspan\":1,\"colwidth\":[152.0]},\"content\":[{\"type\":\"paragraph\",\"content\":[{\"text\":\"direction\",\"type\":\"text\"}]}]},{\"type\":\"tableCell\",\"attrs\":{\"colspan\":1,\"rowspan\":1,\"colwidth\":[873.0]},\"content\":[{\"type\":\"paragraph\",\"content\":[{\"text\":\"You can order the results in either ascending or descending order. \",\"type\":\"text\"},{\"type\":\"hardBreak\"},{\"text\":\"For example, use \",\"type\":\"text\"},{\"text\":\"desc\",\"type\":\"text\",\"marks\":[{\"type\":\"code\"}]},{\"text\":\" to sort in descending order. \",\"type\":\"text\"},{\"type\":\"hardBreak\"},{\"text\":\"If no order is specified, the default will be ascending order.\",\"type\":\"text\"}]}]}]}]}]}]},{\"type\":\"tableRow\",\"content\":[{\"type\":\"tableCell\",\"attrs\":{\"colspan\":1,\"rowspan\":1,\"colwidth\":[268.0]},\"content\":[{\"type\":\"paragraph\",\"content\":[{\"text\":\"filters\",\"type\":\"text\"}]}]},{\"type\":\"tableCell\",\"attrs\":{\"colspan\":1,\"rowspan\":1,\"colwidth\":[1043.0]},\"content\":[{\"type\":\"paragraph\",\"content\":[{\"text\":\"To configure the filters on which the filtering of data should be performed.\",\"type\":\"text\"}]},{\"type\":\"table\",\"attrs\":{\"layout\":\"default\",\"localId\":\"f80b6261-b5d6-438d-a6aa-a4d6176f0ddc\"},\"content\":[{\"type\":\"tableRow\",\"content\":[{\"type\":\"tableCell\",\"attrs\":{\"colspan\":1,\"rowspan\":1,\"colwidth\":[205.0]},\"content\":[{\"type\":\"paragraph\",\"content\":[{\"text\":\"expr\",\"type\":\"text\"}]}]},{\"type\":\"tableCell\",\"attrs\":{\"colspan\":1,\"rowspan\":1,\"colwidth\":[820.0]},\"content\":[{\"type\":\"paragraph\",\"content\":[{\"text\":\"The property of an object that will be displayed in the list includes attributes such as:\",\"type\":\"text\"}]},{\"type\":\"bulletList\",\"content\":[{\"type\":\"listItem\",\"content\":[{\"type\":\"paragraph\",\"content\":[{\"text\":\"Participant.ppid\",\"type\":\"text\",\"marks\":[{\"type\":\"code\"}]}]}]},{\"type\":\"listItem\",\"content\":[{\"type\":\"paragraph\",\"content\":[{\"text\":\"Specimen.label\",\"type\":\"text\",\"marks\":[{\"type\":\"code\"}]}]}]}]}]}]},{\"type\":\"tableRow\",\"content\":[{\"type\":\"tableCell\",\"attrs\":{\"colspan\":1,\"rowspan\":1,\"colwidth\":[205.0]},\"content\":[{\"type\":\"paragraph\",\"content\":[{\"text\":\"caption\",\"type\":\"text\"}]}]},{\"type\":\"tableCell\",\"attrs\":{\"colspan\":1,\"rowspan\":1,\"colwidth\":[820.0]},\"content\":[{\"type\":\"paragraph\",\"content\":[{\"text\":\"The caption for the column that will appear in the table header.\",\"type\":\"text\"}]}]}]},{\"type\":\"tableRow\",\"content\":[{\"type\":\"tableCell\",\"attrs\":{\"colspan\":1,\"rowspan\":1,\"colwidth\":[205.0]},\"content\":[{\"type\":\"paragraph\",\"content\":[{\"text\":\"metainfo\",\"type\":\"text\"}]}]},{\"type\":\"tableCell\",\"attrs\":{\"colspan\":1,\"rowspan\":1,\"colwidth\":[820.0]},\"content\":[{\"type\":\"paragraph\",\"content\":[{\"text\":\"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.\",\"type\":\"text\"}]}]}]}]}]}]}]}],\"version\":1}","reason":"A table in a table cell can't be created or edited in the new editor."}}}]}]}]}]},{"type":"paragraph"}],"version":1}