Required Data Fields – Abstraction

Contents

These are root records with a ReferentType of Movie, Short, TV, Web, or Supplemental, sometimes called “title” records. The StructuralType is always “Abstraction”. For “title” Abstraction records that are episodes of a series, see the Series section, below.

Element NameMaximum CardinalityData Requirements
Required
StructuralType1“Abstraction”
Mode1“AudioVisual” (Silent films are “Visual”; Radio programs are “Audio”)
ReferentType1“Movie”, “TV”, “Short”, “Web”, “Supplemental”
ResourceName1The work’s original release title in mixed case without trailing articles.
[email protected]1A valid BCP 47 written language code. Use “und” if not known.
[email protected]1Skip if not known. When present, most often “release”, “regional”, or “AKA”. Other values are possible, including “working” or “internal”.
OriginalLanguage32A valid BCP 47 spoken language code. Use “und” if not known, “zxx” if no language content is present. (Silent films typically use Visual language codes.)
[email protected]1“Audio” (Silent films are “Visual”)
[email protected]1Usually skipped. Include if there are languages that require clarifications.
ReleaseDate1Preferably the full date (yyyy-mm-dd) of the original commercial release or else a 4-digit year (yyyy).
CountryOfOrigin322-character ISO 3166-1 country code or 4-character ISO 3166-3 former country code (DOI obsolete country code). Use “XX” if not known.
Status1“valid” (in most cases)
ApproximateLength1In hours and minutes (or just minutes). Do not include seconds in an Abstract Title’s Approximate Length unless seconds are relevant to identification.
Administrators/Registrant1The EIDR Party ID of the entity that created the record.
Conditionally Required[1]
AssociatedOrg16The companies associated with the Abstract, preferably the production companies.
AssociatedOrg/DisplayName1Required only if an organizationID is not provided.
[email protected]1“EIDRPartyID” Required only if an Organization ID is provided.
[email protected]1The EIDR Party ID of the Associated Org. Required only if a DisplayName is not provided.
[email protected]1Most often “producer”.
Credits/Director/DisplayName2The names(s) of the director(s) in natural name order (not “last, first”)
Credits/Actor/DisplayName4The names(s) of the top billed actors(s) in natural name order (not “last, first”)
Optional, But Recommended
AlternateResourceName128Additional names by which the work is also known. Include as many as possible.
[email protected]1Same as for Resource Name.
[email protected]1Same as for Resource Name.
AlternateIDIDs associated with the Abstraction other than the EIDR ID (IMDb, ISAN, house IDs, etc.). Include as many as possible.
[email protected]1Common IDs have their own type (“IMDB” for IMDb IDs, etc.). Others use the type “Proprietary” with an identifying domain.
[email protected]1Identifies the organization that issued the Alternate ID. Required when type is “Proprietary”.
[email protected]1“IsSameAs” (in most cases) If not present, “IsSameAs” is assumed. The relation value describes how the EIDR ID relates to the Alternate ID. For example, “ContainsAllOf” would indicate that the EIDR Abstraction record includes all of the material identified by the Alternate ID.

Notes

The Required elements are always required for every record. In root Abstraction records, they must be provided directly.

The Optional elements are always optional (but always encouraged) – the more descriptive metadata provided, the more accurate the de-duplication process is – both for the initial registration and in the future when others match or try to register the same thing, perhaps as a foreign release in a different territory. We both encourage registrants to provide the optional data and to fill in multiple values when they are available and allowed.

The Conditionally Required elements follow the rule that at least one of the following Participant data values must be provided (more are welcome, but each record must meet at least one):

  • An Associated Org (preferably, a producer)

OR

  • A Director

OR

  • 4 Actors

Finally, some attributes are required when their XML tag is present, and others are optional. The optional attributes are marked with italics.

See Also


[1] See Conditionally Required notes below.

Updated on April 6, 2021

Was this article helpful?

Related Articles