Data Fields – Relationships

EIDR supports four optional lightweight relationships, in addition to the relationships implicit in Derived Types:

  • IsAlternateContentFor – for alternate or additional content that in synchronized to the main asset, such as audio or an alternate camera angle. (This should not be used for translations, which are handled by Manifestations.)
  • IsPackagingOf – for creating a collection of assets that are released together.
  • IsPromotionFor – for promotional objects such as trailers.
  • IsSupplementTo – for ancillary material that might be bundled with other assets, such as outtakes or behind-the-scenes featurette.

These have two purposes:

  • To aid in locating related assets.
  • To guide disambiguation.

These relationships are called “lightweight” because they do not support data inheritance between the source of the relationship and its target.

In general, these are applied to Abstraction records. So, for example, an Abstraction record for a trailer would have an IsPromotionOf relationship to the Abstraction record for the feature film it promotes, but the trailer’s child Edits and Manifestations would not have any relationships to the feature.[1]

All of them have two required fields: an ID for the target of the relationship and an enumerated descriptor (a relationship-specific class element), both of which can be queried by value. These relationships can also be modified and deleted as described in the Registry Technical Overview.

Alternate Content

This can be applied to all Referent Types except Series and Season and can point to any EIDR Content record.

The Extra Object Metadata for an IsAlternateContentFor Relationship is contained within AlternateContentInfo:

Field NameTypeCardinalityExplanatory Notes
IDEIDR Content ID: e.g., 10.5240/B5FE-987F-3A25-0DC9-F56E-9   <xs:element name=”ID” type=”eidr:assetDOIType”/>1 RequiredThe EIDR Content ID of the target of the relationship.
AlternateContentClassEnumeration: Descriptive Audio, Camera Angle, Alternate Scene, Parental Control, Censored, Commentary (Director), Commentary (Other), Sing Along, Trivia Track, Other   <xs:element name=”AlternateContentClass” type=”eidr:alternateContentClassType”/>1 RequiredThe type of Alternate Content.

Here is sample XML for the Extra Object Metadata for an Alternate Content relationship:

ExtraObjectMetadata>	
	…
  <AlternateContentInfo>
    <ID>10.5240/B5FE-987F-3A25-0DC9-F56E-9</ID>
    <AlternateContentClass>Descriptive Audio</AlternateContentClass>
  </AlternateContentInfo>
	…
<ExtraObjectMetadata>

Packaging

The Extra Object Metadata for an IsPackagingOf Relationship is contained within PackagingInfo:

Field NameTypeCardinalityExplanatory Notes
IDEIDR Content ID: e.g., 10.5240/E334-70A8-9B50-4084-6F8C-0   <xs:element name=”ID” type=”eidr:assetDOIType”/>1 RequiredThe EIDR Content ID of the target of the relationship.
PackagingClassEnumeration: DVD, BD, HD, SD, Streaming, Streaming (Web), Streaming (Mobile), Download (Web), Download (Mobile), VOD, Broadcast, Digital Cinema, Other   <xs:element name=”PackagingClass” type=”eidr:packagingClassType”/>1 RequiredThe type of Packaging.

Here is sample XML for the Extra Object Metadata for a Packaging relationship:

<ExtraObjectMetadata>
	…
  <PackagingInfo>
    <ID>10.5240/E334-70A8-9B50-4084-6F8C-0</ID>
    <PackagingClass>Streaming</PackagingClass>
  </PackagingInfo>
	…
</ExtraObjectMetadata>

Promotion

The Extra Object Metadata for an IsPromotionFor is contained within PromotionInfo:

Field NameTypeCardinalityExplanatory Notes
IDEIDR Content ID: e.g., 10.5240/E334-70A8-9B50-4084-6F8C-0   <xs:element name=”ID” type=”eidr:assetDOIType”/>1 RequiredThe EIDR Content ID of the target of the relationship.
PromotionClassEnumeration: Broadcast Ad, Theatrical Trailer, Infomercial, EPK, DVD Trailer, Web, Mobile, UGC Site, Radio Spot, Preview, Sizzle Reel, Teaser, Other   <xs:element name=”PromotionClass” type=”eidr:promotionClassType”/>1 RequiredThe type of Promotion.

Here is sample XML for the Extra Object Metadata for a Promotion relationship:

<ExtraObjectMetadata>
	…
  <PromotionInfo>
    <ID>10.5240/1212-3434-5656-7878-0000-Q</ID>
    <PromotionClass>Theatrical Trailer</PromotionClass>
  </PromotionInfo>
	…
</ExtraObjectMetadata>

Supplemental

This can be applied to all Referent Types except Series and Season and can point to any EIDR Content record.

The Extra Object Metadata for an IsSupplementTo Relationship is contained within SupplementalInfo:

Field NameTypeCardinalityExplanatory Notes
IDEIDR Content ID: e.g., 10.5240/0CFA-101D-A652-ABDE-02FA-T   <xs:element name=”ID” type=”eidr:assetDOIType”/>1 RequiredThe EIDR Content ID of the target of the relationship.
SupplementalContentClassEnumeration: Interactivity, Outtake, Making Of, Interview, Music, Music Video, Deleted Scene, Behind the scenes, B-roll, Featurette, Selected Clips, Screen Test, Other   <xs:element name=”SupplementalContentClass” type=”eidr:supplementalContentClassType”/>1 RequiredThe type of Supplemental Content.

Here is sample XML for the Extra Object Metadata for a Supplemental relationship:

<ExtraObjectMetadata>
	…
  <SupplementalContentInfo>
    <ID>10.5240/0CFA-101D-A652-ABDE-02FA-T</ID>
    <SupplementalContentClass>Outtake</SupplementalContentClass>
  </SupplementalContentInfo>
	…
</ExtraObjectMetadata>


[1] There would still be implicit inheritance relationships between the Manifestation and the Edit, and between the Edit and the trailer Title record. Traversing these links would eventually lead to the promoted feature film’s Title record.

Updated on April 11, 2021

Was this article helpful?