Editing PDS Document List Structure

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. 

Adding links manually

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.

1. In Web Admin, display the PDS document list summary page and select the Structure menu option. 
2. Add the PDS object link. 
   1. In the blue bar, select the identifier type (owner supplied name, DRS object ID or URN) and enter the PDS object identifier.
   2. Specify the insertion point in the list (beginning, end, or enter a specific position number).
   3. Click the Add button. 
      
      A new PDS object link will display.
3. (Optional) Customize the Label if needed. The METS label of the target PDS object displays by default.
4. Click the Save Changes button to commit this change.
    
5. To add more links, repeat from Step 1 or select "Add PDS document" from the Action menu.

Adding links by CSV upload

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:

[unique_ID],[optional_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:

1. Create a csv file containing a list of PDS links.
2. In Web Admin, display the PDS document list summary page and select the Structure menu option. 
3. Upload the csv file: 
   1. In the blue bar, click the Upload CSV button.  
   2. Select the identifier type (owner supplied name, DRS object ID or URN).
   3. Click the Choose File button. Navigate your file system and select the csv.l
   4. Click the Upload button. 
      
      The links will be added to the list object's structure. 
4. (Optional) Customize display labels if needed. 
5. Click the Save Changes button to commit this change. 

Reordering links

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.

Suppressing and deleting links

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.

Editing the descriptive label

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.

Controlling ListView Display Options

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.

1. Document list label: This label is populated with the PDS document list object's METS label (a short descriptive label stored with descriptive metadata). See Updating the METS label for details. If a METS label is not defined, ListView will use the MODS title (if available). If descriptive metadata is not available, the object's owner supplied name will display.
2. Title, author, publisher: This data is pulled from MODS descriptive metadata in the PDS document list object. If MODS data is not available, these fields are suppressed. 
3. ID: This is the owner supplied name of the PDS document list object. 
4. Related Links: This option is powered by links to related information associated with the PDS document list. In DRS, both the Harvard Metadata and Related Links fields in object descriptive metadata contribute to the Related Links display. 
5. Full Text Search: This option lets the user search full text across linked PDS documents in the list. This option is powered by the presence of plain text files associated with PDS documents in the list.