A Work is defined as "The intellectual or artistic content of a distinct creation" (Library Reference Model)

It is the top level and most abstract entity in the WEMI stack (Work, Expression, Manifestation, Item), and serves to cluster all expressions of what one could consider "the same book" (or e.g. same play, film, game, etc.) in different formats and languages.

While the work is an abstract entity, convention is to assign it a title, language and year in order to aid with identifying the work.

interface Work {
    _cordataVersion?: string;
    _origin?: Origin;
    _signatures?: string[];
    _sourceReferences?: string[];
    _supplementaryOrigins?: Origin[];
    _transformWarnings?: CordataTransformWarning[];
    _updatedAt?: string;
    _version?: string;
    accessibleContentFeature?: AccessibleContentFeature;
    ageGroups: AgeGroup[];
    contents?: ContentsEntry[];
    contributors: Contributor[];
    countriesOfOrigin?: Place[];
    expressions?: Expression[];
    id: string;
    identifiers: {
        bibbiAuthorityId?: string;
        deichmanWorkId?: string;
        nbWorkId?: string;
    };
    isFiction?: boolean;
    isMachineGenerated?: boolean;
    languages: Language[];
    title: Title | UniformTitleMusic;
    variantTitles: Title[];
    workForm?: string;
    workYear?: number;
}

Hierarchy

  • CordataEntityV2
    • Work

Properties

_cordataVersion?: string

Version of Cordata used to build this entity.

_origin?: Origin

The source that the entity originates from.

_signatures?: string[]

Signatures for this entity that can be used to match it with entities from other sources.

_sourceReferences?: string[]

References to entities in the source system that the entity was built from. These are used to track when the entity should be re-built. TODO: Rename to indicate that this is Promus only and consider incorporating in _origin

_supplementaryOrigins?: Origin[]

List of additional records that have been used to supplement the entity with e.g. additional identifiers for matching.

_transformWarnings?: CordataTransformWarning[]

Warnings from the Cordata transformation process.

_updatedAt?: string

Date-time when the entity last changed.

_version?: string

Version hash that changes whenever the entity changes.

accessibleContentFeature?: AccessibleContentFeature

Whether the work has been created or adapted for users with special needs.

ageGroups: AgeGroup[]

The recommended age group(s) for the work as assigned by Biblioteksentralen according to a controlled vocabulary.

Typically, multiple consecutive age groups are assigned to a work, e.g. "mu" (13-16) and "vu" (16-18) for young adult fiction, or "vu" (16-18) and "v" (Adults) for fiction suited for older teens and adults.

Both fiction and non-fiction are assigned age groups based on interest level; Biblioteksentralen does not assign reading level age groups.

contents?: ContentsEntry[]

Less structured information about the work's contents. Example: song titles for musical works (parsed from 740$a with ind2 == "2" in MARC21)

contributors: Contributor[]

List of contributors to the work in the form of agents (persons or organizations) and their roles in the creation of the work.

Work contributors include authors for books, editors for edited works, composers for music, directors and screenwriters for films, etc., but not contributors that played a role in the creation of a specific expression (e.g. translators, illustrators, etc.) or manifestation (e.g. illustrators, cover designers, etc.).

countriesOfOrigin?: Place[]

List of countries where work is made, firstly used for movies.

expressions?: Expression[]

List of expressions of this work.

id: string

Cordata work ID.

identifiers: {
    bibbiAuthorityId?: string;
    deichmanWorkId?: string;
    nbWorkId?: string;
}

Map of identifiers for matching records in external datasets:

Type declaration

  • Optional bibbiAuthorityId?: string

    Identifier assigned by Biblioteksentralen for authority records. Unique for all authorities independent of type.

  • Optional deichmanWorkId?: string

    Identifier for an equivalent work in Deichman's catalogue.

  • Optional nbWorkId?: string

    Identifier for a work in the National Library of Norway's (abandonded) registry of works.

isFiction?: boolean

Whether the Work is a work of fiction.

isMachineGenerated?: boolean

Whether the Work is machine generated without manual review.

languages: Language[]

The language of the representative expression of the work.

Preferred title of work.

Typically this will be the title the work was assigned at its first publication or release. Exceptions are made if:

  • the work is significantly more well known under a later or abbreviated form of the title; e.g. "Hamlet", not "The tragedy of Hamlet, prince of Denmark".
  • the work is known under a uniform title - applies to works created prior to 1501.
  • there are other significant reasons for preferring a later title.

For works where the first publication has two main titles separated by "or" (subsequent main title), only the first title is registered as the preferred title for the work, e.g. "The hobbit", not "The hobbit, or, There and back again".

Classical music works without titles in the traditional sense will instead get a generic uniform title, synthesized from key information about the work, such as "Symphonies, no. 6, op. 6, F major". In these cases, the title is of type UniformTitleMusic.

variantTitles: Title[]

Variant titles which aid in identifying a manifestation as belonging to a work.

Variant titles are typically registered if:

  • there is more than one title in the original language of the work, e.g. "The golden compass" for "Northern lights" / Philip Pullman.
  • there are established longer or shorter forms of the title, e.g. "The tragedy of Hamlet, prince of Denmark" for "Hamlet".
  • The uniform title differs from the title in the original language, e.g. "Alf laylah wa-laylah" for "Tusen og en natt".

See Title for individual components of title.

workForm?: string

Temporary

Deprecated

workYear?: number

The year in which the representative expression of the work was published or released.