A Collective Agent is defined as "A gathering or organization of persons bearing a particular name and capable of acting as a unit" Library Reference Model

Examples of Collective Agents are corporations, musical or artist groups, governments, families and other organizations. A group is considered a Collective Agent if it is organized in such a way that its members can produce or approve joint statements or creations, such as when a corporation approves a report, a music group releases an album, or a government ratifies a law.

Movements or categories of people that are not organized such that they can speak for the whole of the group, such as for example the Black Lives Matter movement, the Preraphaelite artist movement, religious or ethnic groups, are not considered Collective Agents.

interface CollectiveAgent {
    _cordataVersion?: string;
    _origin?: Origin;
    _signatures?: string[];
    _sourceReferences?: string[];
    _supplementaryOrigins?: Origin[];
    _transformWarnings?: CordataTransformWarning[];
    _updatedAt?: string;
    _version?: string;
    alternativeNames: LanguageMapList;
    collectiveAgentType: string;
    identifiers: AgentIdentifiers;
    name: LanguageMap;
    nationality: Nationality[];
    ordinal?: string;
    place?: string;
    scopeNote?: string;
    specification?: string;
    unstructuredDate?: string;
}

Hierarchy

  • CordataEntityV2
    • CollectiveAgent

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.

alternativeNames: LanguageMapList

Variant spellings and non-preferred names, e.g. "Aha" for "A-ha" (music group), or "Danish National Symphony Orchestra" for "DR SymfoniOrkesteret".

collectiveAgentType: string

The type of Collective Agent. Currently only the values "Family", "Corporation" and "Conference" are in use. Will be extended in later iterations. TODO: Convert this to Enum instead of string

identifiers: AgentIdentifiers

Map of identifiers for matching records in external systems.

The preferred name of the Collective Agent.

nationality: Nationality[]

A Nationality associated with the Collective Agent. Currently only in use for collectiveAgentType "Family".

ordinal?: string

Currently only used when the Collective Agent is of type "Conference", to specify the order in a series of conferences. Example: The Olympic Winter Games in Lillehammer (1994) was the 17th Olympic Winter Game, so the ordinal would be "17".

place?: string

Currently only used when the Collective Agent is of type "Conference", to specify where the conference took place. Temporary as string, will be replaced with a Place type in a later iteration.

scopeNote?: string

Internal note on the entity. Used for identifying and differentiating entities with similar names.

specification?: string

Currently only used when the Collective Agent is of type "Conference", to further describe the type of conference. Example: The Conference "Arif på Munch" has the specification "utstilling".

unstructuredDate?: string

Currently only used when the Collective Agent is of type "Conference", to specify when the conference took place. Temporary as string, will be replaced with a Date type in a later iteration.