From NSDLWiki

Jump to: navigation, search

Tutorial: OnRamp Usage

Reference Materials


Start Here

to OnRamp
Pre-Tutorial Setup Process


Content Management

Advanced Content Management

Distribution System

Lesson: Removing Uploaded Files

In this lesson, you are going to make some mistakes on purpose to illustrate how those mistakes can occur and for some how they can be fixed. The fixing process doesn't occur in this lesson, but don't worry, we'll get to it in just a little while.

Edit the Record

You learned how to edit records in a previous lessons, Editing a Saved Record and Viewing and Editing a Saved Record. If you need a refresher, jump back to one of those lessons, and then come back here.

Modify Fields

  1. Update the Abstract/Summary field by typing including information about OnRamp after the existing text in this field.
  2. Go to the end of the edit form and see that the uploaded files are listed here in the section titled Attached Files.
  3. Click [ purge ] beside the file with name OnRamp_logo_standard.jpg (Yes, this is the file that the publisher said to keep. Don't worry, we'll fix this later.)
  4. In response to the message This action will permanently delete the selected datastream, click the OK button.

Image:Warning_32.gif WARNING: The file is permanently deleted from this record. There is no way to recover the file from OnRamp. Abandoning the workflow through the Abandon Workflow button will not abandon the purge of the uploaded file. It is already permanently deleted.

The edit workflow did not complete with the purge of the file, so you are still editing the record.

Something Unexpected and Undesirable

  1. Go back up toward the top and check out the Abstract/Summary field's value. Notice that the changes you made to that field are gone.

Image:Caution_32b.gif Caution: Purging a file does not save changes to metadata fields. Any changes made to the record between the start of the current edit workflow and the point at which the purge was made are lost. If you make changes to any area of the record, be sure to Save and begin a new edit workflow before purging a file. After the purge, you can edit the record as you normally would and exit using one of the buttons at the top and bottom of the edit form to save or abandon these changes. Remember if you Abandon Workflow, the purge won't be abandoned, but all other changes since the purge will be abandoned.

Abandon Workflow

This is an excellent opportunity to make use of the Abandon Workflow that you've been hearing so much about. There aren't any changes to be saved. The purge of the file is complete and irreversible. So let's go ahead and with abandon click the Abandon Workflow button.

  1. Click the Abandon Workflow button at either the top or bottom of the form.

Now, that wasn't too bad. Your friends and co-workers will thank you for your diligent use of the Abandon Workflow button.

I know you thought for a moment I wasn't going to say it, but I keep thinking of the people who jumped straight to this topic because they just had to know about removing uploaded files and may have missed why Abandon Workflow is so important. So here it goes again.

Image:Important_32.gif IMPORTANT: If at any point you decide to stop editing a record, DO NOT navigate away from the creation page using the Back button or one of the navigation links. Instead select the Abandon Workflow button. Otherwise, the new record hangs around in limbo. See Releasing a Locked Record for more information on what to do if you forget to Abandon Workflow.

Previous Next

  Note: If you came to this page by clicking a link other than Previous or Next, then you are outside the normal flow of the tutorial and you should either...
  • use the Back button to return to the page you were viewing prior to this page
  • OR select a topic from the table of contents at the left.

Personal tools