This page describes how to add/update/delete the structure and display metadata values for a PDS document list.
A PDS document list (aka PDS list object) is a content type designed to represent large (>5000 pages), multivolume and smaller page-turned objects of a serial nature. The PDS document list consists of a list of links to PDS documents with identifying and descriptive information for each document and descriptive information for the list overall. PDS Document Lists are delivered in a separate application, called ListView.
PDS document lists and the PDS objects to which they point are created using the Batch Builder desktop client. There are batch workflows in which the component PDS objects are deposited first followed by a PDS document list that points to them. There are other batch workflows in which the PDS document list is deposited empty (no pointers) and links are added to the list in Web Admin.
If you need to add more than 5 PDS object links, consider adding links in bulk using a CSV file.
To use this procedure, you'll need a unique identifier (owner supplied name, DRS object ID, or URN) for each target PDS object.
Use the Upload CSV option to insert a list of PDS object links into a list object structure. The uploaded list will be inserted at the end after any existing list entries.
The csv file should be plain text with a .csv or .txt extension. File name can be any alphanumeric string. Each line of the file corresponds to a single PDS object link and includes comma-separated values for unique identifier (OSN, URN, or DRS object ID) of a PDS object and display label text:
The following csv file will add 3 PDS links plus display labels to a list object. Note that display label text should be enclosed in quotes:
The following csv file will also add 3 PDS links, but includes only the DRS IDs and omits display labels:
In either case, the order of lines in the file will match the order of links added to the list object. If the csv file does not specify a display label, Web Admin will use text from the PDS object's METS label (if one exists).
Here is the procedure for uploading the PDS list csv file:
The list of PDS objects can be rearranged by clicking and dragging individual rows. Mouse over one of the first 3 columns of a row, click and drag it to a new position. Remember to click the Save Changes button to save this change.
Using choices on the Action menu, you can suppress the display of individual list entries or remove an entry from the list object's structure. Rows that are suppressed or removed will not appear in the ListView delivery application. Note: a row that points to a deleted PDS object will be suppressed by default.
The screenshot below shows row #1 being suppressed:
The screenshot below shows the aftermath, with suppressed row highlighted in light grey. Note also row #4 is crossed out, indicating the associated PDS object has been deleted.
Each entry in a PDS document list has a descriptive label that will display along with the link in the ListView delivery application. By default, text from the PDS object's METS label will be appear here. You can use the METS label as-is or add custom text as needed. If the object has no METS label, the label in the list object will be empty.
In the screenshot below, the curator has inserted some custom text (highlighted in yellow).
At any point, you can populate the label with the PDS object's current METS label. From the Action menu select Retrieve label from PDS document. This will replace the existing label with text from the PDS object's METS label.
In the screenshot below, the curator decided not to keep the custom text. She uses the Action menu to retrieve the METS label which will replace text already there.
Remember to click the Save changes button to save these changes.
ListView is the service that displays PDS document list objects to end users. This topic describes how options in the ListView user interface can be controlled by making changes to a PDS document list object's metadata in DRS Web Admin.
In the following ListView public interface screenshot, the highlighted options are controlled by PDS document list object metadata.