Tab-delimited patron data bulk delete

This documentation provides the requirements for creating a tab-delimited bulk delete file, including how to format and submit the file.

Bulk patron delete allows you to remove patron accounts from your system in bulk. Follow the guidelines below to create and submit a tab-delimited text file for bulk deletion of patron data.

Filename

The bulk patron delete file name must meet the following criteria:

Example: [OCLCsymbol]patronsdelete.txt

Bulk patron delete tab-delimited text file criteria

The tab-delimited text file data must meet the following criteria:

 Note: If you are using a WorldShare Analytics report to build your delete file, please avoid using sourceSystem/idAtSource values as they are concatenated in the report. We recommend you use the barcode instead.

File examples

institutionId barcode sourceSystem idAtSource illId
127941 811702497      

 

institutionId barcode sourceSystem idAtSource illId
127941   urn:mace:oclc:idm:ocwms boblbiobgxx  

 

institutionId barcode sourceSystem idAtSource illId
127941       12345

 

institutionId barcode sourceSystem idAtSource illId
127941 811702497 urn:mace:oclc:idm:ocwms boblbiobgxx 12345

Sample file

TestDelete.txt

Send bulk patron delete file

Send your bulk patron delete file via SFTP with your OCLC file exchange account.

If your library has not been turned on for automation:

  1. Place your initial delete file for validation review in the patron delete test directory: /xfer/wms/test/in/pdelete
  2. Email your regional OCLC Support office.
  3. Include in your email message:
    • Subject: [OCLC Symbol] 'Patron Delete File for Review'
    • Body: Include contact information and state if you would like the delete file processed and patron records deleted from WMS and Tipasa
    • If errors are found in the file, we will contact you to request a resubmission. If there are no errors, we will send you the results.

If your library has been turned on for automation, place your delete files in the /xfer/wms/in/pdelete folder.

Patron data file processing reports

Patron data reports are available in the wms/reports directory. This table shows the directories for downloading files and reports.

File type SFTP file directory location Note
Patron Exception Report /xfer/wms/reports Lists patron records that were not deleted from WMS and also the failure reason. The exception report will only run if at least one patron record failed to be deleted from WMS within a patron file.

 Note: Patrons with outstanding checkouts and fines will not be deleted using a bulk delete file.

Patron Summary Report /xfer/wms/reports Runs after a bulk delete patron file is processed and tells how many patrons in the file were deleted from WMS and if any exceptions.