|Creator:||DCMI Usage Board|
|Description of Document:||This document is the result of a September 2008 review by the DCMI Usage Board of the "Scholarly Works Application Profile".|
The Usage Board reviews application profiles for conformance with formal review criteria . This review of the Scholarly Works Application Profile (SWAP) was discussed at a Usage Board meeting in September 2008 and finalized for publication in March 2009. The materials reviewed, raw review notes, and discussion are available in the meeting archive  and minutes. The review of the SWAP description set profile (below) refers to the state of the profile as captured in an archived snapshot  that incorporates some editorial corrections made in response to discussion in September 2008. The latest version of SWAP can be found on the UKOLN Web site .
The formal criteria used for this review are based in large part on a draft specification "Description Set Profiles: A constraint language for Dublin Core Application Profiles" by Mikael Nilsson of 31 March 2008 .
The Scholarly Works Application Profile (SWAP)  was developed in order to provide a method for describing eprints, alternatively referred to as scholarly works, research papers or scholarly research texts. A Scholarly Work is a distinct intellectual or artistic scholarly creation. SWAP defines an eprint to be a scientific or scholarly research text, for example a peer-reviewed journal article, a preprint, a working paper, a thesis, a book chapter, or a report.
The purpose of SWAP was to offer a solution to metadata issues identified in Eprints UK, a JISC funded research project, and to provide a richer metadata profile for the Intute repository search service to use to aggregate content from digital repositories.
(The reviewers note that none of the SWAP documentation describes the objectives of SWAP itself, although the statement about the background to the development of the profile provided on the SWAP wiki  gives what are essentially the objectives of the profile . The description above also uses information from an article in Ariadne  and a 2006 presentation by J. Allinson and A. Powell .)
The audience for the profile is described in the background statement  as the JISC repositories search service and other parts of the JISC repositories programme; and the eprints repositories community in the UK, especially those running live eprints repositories, and those about to establish such repositories. The target user group for SWAP is defined as: Implementers of UK Institutional Repositories search service; Managers and administrators of UK eprint repositories; Implementers of the Prospero interim repository. 
Use cases for SWAP are set out in the description of each of the functional requirements for the profile -- they are too long to list here individually. 
The descriptions provided for in SWAP allow the description of the range of eprints/scholarly works typically produced by academics and researchers. While SWAP describes a large number of functional requirements, descriptions made using the profile are principally designed to :
The domain model used by SWAP is based on the Functional Requirements for Bibliographic Records (FRBR) model, issued by the International Federation of Library Associations (IFLA) in 1998 . FRBR models the bibliographic world using 4 key entities - 'Work', 'Expression', 'Manifestation' and 'Item' -- which are the subject of bibliographic descriptions. The SWAP model includes a fifth entity,
agent, which embodies the FRBR supporting entities of
The SWAP documentation includes both a diagrammatic description of the domain model and a natural language expression of the diagram :
To summarize, the SWAP materials meet the review criteria by describing:
The reviewers compared the templates and constraints used in the SWAP description set profile with the templates and constraints defined in the draft specification "Description Set Profiles" according to equivalences listed in the Appendix (see below).
According to the review criteria, "the header or introduction of a Description Template" should provide one piece of mandatory information: "the class (or classes) of which resources described in this description may be an instance". In the Scholarly Works Application Profile, the description templates are clearly marked with section headings such as "Description of the eprint as a Scholarly Work". As explained in the section "Entity typing" (near the end of the document), the Descriptions are explicitly "typed" using dc:type statements with one of the value URIs taken from the Eprints Entity Type Vocabulary Encoding Scheme:
The two constraints "6.3. Type Constraint" and "6.4.1. Property List Constraint" are provided in all cases. In some cases, maximum and minimum times that the given kind of Statement may appear in the enclosing Description are also provided.
Three of the five optional constraints defined for Literal Value Surrogates are used -- correctly and consistently, as far as the reviewers can see.
Five of the possible constraints defined for Non-Literal Value Surrogates are used -- correctly and consistently, as far as the reviewer can see.
The reviewers find:
The terms used are part of the vocabularies:
Terms from the FOAF Vocabulary Specification 0.91 (with base URI http://xmlns.com/foaf/0.1/) along with a Syntax Encoding Scheme info:ofi/fmt:kev:mtx:.
The reviewers found a discrepancy between the SWAP profile and the DSP specification with implications for "conformance".
The DSP working draft (2008-08-31) defines an approach to describing the structure of a description set in terms of a set of constraints against which an individual description set can be "matched" -- i.e. analyzed to test whether the description set satisfies those constraints or not.
Section 3 of the DSP draft describes how that matching process works. The process has three stages:
The version of SWAP submitted for review provides a DSP containing five description templates.
The "Expression" description template contains sixteen statement templates. Of these sixteen statement templates, two templates (the template labeled "Entity Type" and the template labeled "Type") use an identical Property Constraint -- a Property List Constraint referring to a single property http://purl.org/dc/elements/1.1/type. The consequence of this is that when a statement using the dc:type property is analyzed, it will always result in matches against two statement templates, i.e. it is impossible for step 2 of the process above to complete successfully; it will always fail to match the statement to a single statement template.
In light of this discrepancy, the Usage Board was obliged to conclude that the review criteria do not match the reviewed application profile on this point, and that SWAP therefore cannot be said to conform with the criteria.
Possible revisions to SWAP which might have resolved the discrepancy, such as combining the two statement templates into one single, "weaker" statement, or changing one of the statement templates to use a different property list constraint (e.g., by using rdf:type for one of the two) were, in the end, considered to be outside the boundaries of "minor editorial correction" and more properly an issue for the SWAP maintenance community. Indeed, it was suggested that the matching algorithm defined in the draft DSP specification itself be re-evaluated in light of the SWAP example -- a task for the DCMI Architecture Forum. While the Usage Board review did not produce a "positive" result, it had the effect of uncovering an issue of more general significance for the automated processing of metadata.
DSP constraints and equivalent SWAP labels
|DSP constraint||SWAP label|
|5.5. Resource Class Membership Constraint||Reflected in SWAP section headings as described below|
|6.6.1. Description Template Reference||Labeled "Description"|
|6.1. Minimum occurrence constraint||Labeled "Min occurrence"|
|6.2. Maximum occurrence constraint||Labeled "Max occurrence"|
|6.3. Type constraint||Labeled "Literal?"|
|6.4.1. Property list constraint||Labeled "Property"|
|6.5.2. Literal language constraint||Labeled "Language constraint - Occurrence"|
|6.5.4. SES constraint||Labeled "SES constraint - Occurrence"|
|6.5.5. SES list constraint||Labeled "SES constraint - Choose from"|
|6.3.1. Value URI constraint||Labeled "Value URI constraint - Occurrence"|
|126.96.36.199. Value URI List Constraint||Labeled "Value URI constraint - Choose from"|
|188.8.131.52. VES occurrence constraint||Labeled "VES constraint - Occurrence"|
|184.108.40.206. VES list constraint||Labeled "VES constraint - Choose from"|
|220.127.116.11. Maximum occurrence constraint||Labeled "Value string constraint - Max occur"|