The Delete Harvest Set Service

The Delete Harvest Set Service lets people (and computer programs) delete sets of records that have been created through the Remote iVia Service Interface once they are no longer needed. Sets of records are identified by their harvest tag. In other words, you can delete ever record that shares a particular harvest tag.

When RiSI is enabled, a form is provided for submitting URLs to the Metadata Assignment service on the iVia Adders' Homepage.

For example, if you created a set with the Expert Guided Crawl Service and give it the harvest tag bestbugs, as is described on the Expert-Guided Crawl page. Later you decide you want to delete the collection and start again. You can use the Delete Harvest Set service to delete the old collection. This process is described below.

Step 1: Set the Parameters

We start by opening the Web form for Deleting Harvest Sets. This form is very simple. The harvest tag must be supplied, and is used to choose the records to delete. You should only delete sets corresponding to harvest tags that you yourself have created. In this example, we will enter the harvest tag bestbags.

The second option is the dummy mode check box. If you set this, then no no records will be deleted, but the details of the operation will be displayed. The verbosity option controls the level of logging; there is little reason to change this from it's default setting of 3 (normal output), as this service produces relatively little output anyway. Finally, the Email Notification Address field can be used to request an email be sent to you wen the task is complete.

Note that this service will always be run in the background.

Step 2: Launch the Task

Once we have configured the parameters as described above, we start the task by clicking on the Submit Query button. This action launches the task in the background background task, and displays a summary screen. From this summary screen, we click on the Log link to see the task log file.

The task log file will first display the task parameters, and then the task activity, which is preceded by the boldface line Remote iVia Service Interface: Delete Harvest Set: Starting. It will be followed by a series of messages describing the status of the task. The final line will report how many records were removed from the harvest set (and whether any these records then belonged to no harvest set, and were deleted).

At this point, the task is complete, and the bestbugs harvest set is no longer associated with any records in the database.