Overview

This is a description of the procedure to manually create a batch of Still Image objects from template in BB). This method is a good choice when creating a batch with a small number of objects. To create a batch with many objects (over 10), the automatic object creation procedure may be more efficient.

Procedure summary:

1. Create a new project.
2. Enter DRS deposit settings.
3. Create object template.
4. Add directories to object template.
5. Create a new batch and objects.
6. Move/copy files into corresponding directories on disk.
7. Process the batch.
8. Upload the batch to your dropbox
9. Check load report in email

What you need before you start:

• Prepare several digital images and put them in a directory of your choice somewhere on local hard disk or network drive. If you have more than one file per image (e.g.: an archival master and a deliverable or an archival master, a deliverable and a thumbnail) make sure file names match (e.g.: image-1.tif, image-1.jp2 and image-1.jpg). Consult Section 3 Naming rules for files, objects and directories of this Guide for more information.
• Decide what you will use for owner supplied names for image objects and the digital image files they consist of. For instance, you could use local classification or local accession numbers. Consult Section 3 Naming rules for files, objects and directories of this Guide for more information.

Procedure:

Start at Step 5 if you are reusing a project to generate a new batch.

1. Create new project in Batch Builder
   
   1. From main menu select Project > New
   2. Enter project data:
      Project Name: enter a name for your project (used for internal tracking only).
      Project Directory: select the directory where project will be saved (click ellipsis button to browse for or create a directory).
      TIP: use 'project' as part of the directory name to make it easier to identify later. (e.g. museum_slide_project)
      Content Model: select the "still image" value from the dropdown.
      Project Description (optional): Any information relevant to the project – will only remain locally.
   3. Click OK to continue.
      
      
2. Enter DRS deposit settings:
   
   1. Click on "Deposit Settings" in Project Panel tree.
   2. Enter deposit data in the form:
      Batch Name Pattern: default - {owner}{batchDir}{yyyy}{mo}{dd}_{hh24}{mm}{ss}
   3. (This is the name for a batch that appears on DRS deposit reports. Batch name must be at least 3 characters long.)
   4. Success Email: type email and press enter. 
   5. Failure Email: type email and press enter. 
   6. Success Method: choose how you will receive load report. 
   7. Deposit Agent: type your HUID.
      Deposit Agent Email: type your official Harvard email address.
      
      
3. Create object template:
   Metadata added at this level will be applied to every object in a batch, unless overridden by specific object metadata that you define in later steps.
   
   1. Click on "Object Template" in Project Panel tree:
   2. Enter required object metadata in the form:
      Owner Code: your owner code (use all caps).
      Billing Code: your billing code (use all caps).
      File Access Flags : the DRS access flag. At this level, select the least restrictive value if the batch will contain a mix of public and restricted files.
      URN Authority Path: your NRS authority path. Use all caps. Look up your Path here if needed: http://nrs.harvard.edu/urn-3:hul.ois:nrsstatusprod.
      File URN Resource Name Pattern: use default value {n} to generate a unique number.
   3. Switch to "optional" tab to enter any optional metadata (for example, descriptive metadata, roles and relationships that will apply to your objects). For more about optional metadata see Sections9. Adding Relationships, 10. Adding Descriptive Metadata, 11. Adding Supporting Content.
      
      
4. Add directories to template:
   
   For one image file per object:
   
   Add directory:
   
   1. Right click on "OBJECT TEMPLATE" in the Project Panel on the left and select the "Add Directory…" menu option.
   2. Type in a name for your directory in the text box . The directory name will start with "image" but the name you type will be appended to it. Tip: to make it easier to read, start your directory name with an underscore (_) So, typing '_tifs_and_jpegs' will result in a directory called 'image_tifs_and_jpegs'
   3. In the Project Panel on the left select the directory you just created.
   4. In the Content Panel on the right, choose "yes" from the dropdown list for the field "First Generation in DRS".
   5. Choose "HIGHUSE" for Usage Class.\
      
      
   Add additional metadata (optional tab):
   
   1. Select the new directory in the Project Panel on the left
   2. In the Content Panel, select the 'optional' tab.
   3. Scroll down to "Still Image File Metadata"
   4. Enter any file level optional metadata in the form
      Role: use Ctrl Click to select ARCHIVAL_MASTER and DELIVERABLE roles. Note that in order to get a delivery URN on deposit a file needs to have a role DELIVERABLE set in BB.
      
      
   For multiple image files per object (e.g.: a file for archival master and a separate file for deliverable) you need to create a directory for the master file and a nested sub-directory for each derivative file. (This is needed for BB to determine the derivative relationship).
   
   Add a master directory:

1. 1. Right click on "OBJECT TEMPLATE" in the Project Panel on the left and select the "Add Directory…" menu option.
   2. Type "-archival_master" or a similar suffix that describes the role for your directory in the text box. The directory name will start with "image" but the name you type will be appended to it. So, typing '-archival_master' will result in a directory called 'image-archival_master'
   3. In the Project Panel on the left select the directory you just created.
   4. In the Content Panel on the right, choose "yes" from the dropdown list for the field "First Generation in DRS".
   5. Choose "LOWUSE" for Usage Class.
      
      
   Add additional metadata (optional):

1. 1. Select the new directory in the Project Panel on the left
   2. In the Content Panel, select the 'optional' tab.
   3. Scroll down to "Still Image File Metadata"
   4. Enter any file level optional metadata in the form
      Role: select ARCHIVAL_MASTER.
      
      
   Add a nested directory for derivative (e.g. a directory for deliverable images):

1. 1. Right click on the directory you just created in the Project Panel on the left and select the 'add a directory…" menu option.
   2. Type "-deliverable" or a similar suffix that describes the role for your directory in the text box. The directory name will start with "image" but the name you type will be appended to it. So, typing '-deliverable' will result in a directory called 'image-deliverable'
   3. In the Project Panel on the left select the directory you just created.
   4. In the Content Panel on the right, choose "no" from the dropdown list for the field "First Generation in DRS".
   5. Choose "HIGHUSE" for Usage Class.
      
      
   Add additional metadata for this derivative subdirectory (optional):

1. 1. Select the new directory in the Project Panel on the left
   2. In the Content Panel, select the 'optional' tab.
   3. Scroll down to "Still Image File Metadata "
   4. Enter any file level optional metadata in the form
      Role: select appropriate value for derivative (e.g., DELIVERABLE). Note that in order to get a delivery URN on deposit a file needs to have a role DELIVERABLE set in BB
   5. Repeat steps 3 and 4 to create additional nested directories if you have more files derived from the current one.
   6. Save your work (Project > Save on main menu).

     5.  Create new batch with objects:
          Metadata added at this level can be applied to a specific object, or specific file directory.

1. 1. Create new batch: select "Batch > New" from the main menu. Enter a name for the batch (will be used as the batch directory name on disk). Click OK.
      Tip: including the word "batch" in the name will help you remember the directory's purpose on the file system.
   2. Select the batch (with the red letter B) in the Project Panel
   3. From the main menu select Object > New; leave Content Model at default (FROM TEMPLATE) and enter a unique name for the object (Object Owner Supplied Name) and click OK.
   4. Click on the "+" next to the Batch icon to expand it – it will show the icon for the new object (blue letter O)
   5. (Optional) Select the object icon of your new object in the Project Panel and switch to "optional" tab in the Content Panel to enter any optional metadata (for example descriptive metadata, roles or/and relationships that will apply to your objects). For more about optional metadata see Sections9. Adding Relationships, 10. Adding Descriptive Metadata, 11. Adding Supporting Content. Note: any metadata entered at the object level will override metadata entered at the template level.
   6. Repeat b-e if you have more than object.
   7. Save your project (Project > Save on main menu).

     6.  Copy image files into batch object directories on disk (can be done outside Batch Builder).

Note: if you need to check where the batch/object directories are on disk, click on "Deposit Settings" in the Project Panel tree and look at the Project Path field at bottom.
** Quick way to copy content files: you can drag files from your file system onto the object directories in the Batch Builder project panel.
** If using mapping.txt, this is when you should copy it to the auxiliary object path in the project.
** If including external MODS descriptive metadata, this is when you should copy it to the auxiliary object path in the project.

     7.  Process the batch:

1. 1. In the Project Panel tree, right click on the batch you want to process (batch icon with a red letter B) and select "Create descriptors and batch.xml." Processing messages will appear in the messages pane.
   2. When the batch is successfully processed you will see the following message: FINISHED Creation of batch.xml and descriptors complete for batch:

     8.  Upload batch to dropbox.

1. 1. Open your SFTP client and log into your DRS2 dropbox account.
   2. Change to the "incoming" directory.
   3. Upload the batch: copy the entire batch directory to the "incoming" directory.
   4. Close the SFTP client. Batch processing will start.

     9.  Check load report in email.

1. 1. Open your email inbox.
   2. Look for message from "drs2-support" with subject "DRS LOAD REPORT …"
   3. For a more readable report, open the attached text file in Excel, or just copy the file listing and paste into Excel. If you see any error messages, remedy the errors and re-process the batch.