Architecture Overview

Works and Work Versions

Works are the primary unit of content in ScholarSphere. A Work consist of metadata and a series of Versions, each of which includes additional descriptive metadata (title, publication date, creators, etc.) and uploaded files.

A Work Version exists in one of three states:

• Draft: Versions are created in the Draft state: files and metadata may be modified by the Work's creator or repository administrators only. A Work can have only one Version in the Draft state at a time.
• Published: files and metadata may be accessed according to the access settings of the Work the Version belongs to. Metadata and files of Published versions may only be modified by repository administrators; updates to the metadata or files should be made by creating a new Version.
• Withdrawn: metadata (but not files) may be accessed according to the access settings of the Work the Version belongs to. Metadata and files may only be modified by repository administrators. Only repository administrators can set a Version to the Withdrawn state.

In addition, the current Version of a Work (the Version presented to users who access the Work) is the most recently Published or Withdrawn Version.

The following table describes how metadata fields are stored (at the Work or Version-level) and indicates fields that may or may not change between Versions.

[tk]