266x Filetype XLSX File size 0.71 MB Source: movielabs.com
Sheet 1: Movies
Top Level Element | Sub-Element | Required/Optional | Definition | Field Type | Value Type | Accepted Value(s) | Mapping to XML Document | |
in XML and spreadsheet spec | in XML and spreadsheet spec | for each avail and line item | Description of field and expected contents | Freeform - no restrictions Controlled - restrictions on characters and/or syntax Standardized - defined by external standard ENUMERATED - defined by EMA avails spec |
String - text Date - Y=year, M=month, D=day Time - H=hour, M=minute, S=second Number - #, #.## |
Freeform - examples Controlled - permitted characters and syntax Standardized - examples Enumerated - all accepted values |
||
Avail | DisplayName | REQUIRED | The name of your company. | Freeform | String | Rockstar Films | //Licensor/DisplayName | |
AvailTrans | AssetLanguage | Optional | Content provider intends to provide at least assets with this language (not contractual). Language shall be encoded in accordance with RFC 5646, Tags for Identifying Languages. The subtags that are available for use with RFC 5646 are available from the Internet Assigned Numbers Authority (IANA) at [ http://www.iana.org/assignments/language-subtag-registry ] |
Standardized | String | EN, DE, FR | //Transaction/AssetLanguage | |
AvailTrans | Territory | REQUIRED | ISO 3166-1 alpha-2 country code for the country or territory of this avail. [ http://www.iso.org/obp/ui/#search ] |
Standardized | String | US, CA, GB | //Transaction/Territory | |
AvailAsset | WorkType | REQUIRED | Work type as enumerated in Common Metadata. Should use "Movie" for any feature length films, and "Short" for any films that would not be consdered a full-length feature. Exact length is not specified, but some use 40 minutes as a threshold. 'Collection' is used exclusivly for bundles and BundleALID should be populated. | ENUMERATED | String | Movie, Short, Collection | //Asset/WorkType | |
Disposition | EntryType | REQUIRED | "Full Extract" - means that all avail entries provided for an edit of a movie (e.g., Theatrical and Director's Cut are two different edits) within a territory should overwrite all previous avail entries for that edit within that territory. “Full Extract” should include all known current and future avails for an edit within a territory. “Full Delete” - means all rights to an edit within a territory are lost. The studio would provide "Full Delete" and that would remove all avail entries for that edit within that territory. |
ENUMERATED | String | Full Extract, Full Delete | //Disposition/EntryType | |
AvailMetadata | TitleInternalAlias | REQUIRED | Title used by involved parties to refer to this content. | Freeform | String | First Dance, The | //Asset/Metadata/TitleInternalAlias | |
AvailMetadata | TitleDisplayUnlimited | Optional | Display title, no length limit. Same as TitleDisplayUnliminted in Common Metadata. | Freeform | String | The First Dance | //Asset/Metadata/TitleDisplayUnlimited | |
AvailMetadata | LocalizationType | Optional | Distinguishes products that are offered based on whether the offering is localized with dubbed audio track or a language subtitle track. Titles must have these components when offered to the consumer. Valid values are: • ‘sub’ – offering must include subtitles • ‘dub’ – offering must include dubbed audio • ‘subdub’ – offering must include both subtitles and dubbed audio. • ‘any’ – offering can have any combination of subtitles and dubbed audio (whatever is available) ‘any’ is the default and is assumed if this term is not included. |
ENUMERATED | String | sub, dub, subdub, any | //Asset/Metadata/LocalizationOffering | |
AvailMetadata | CompanyDisplayCredit | Optional | Information about grouping content into storefronts based on organizations such as studio or broadcaster. Equivalent to CompanyDisplayCredits in Media Entertainment Core (MEC). | Freeform | String | Fox Searchlight | //Asset/Metadata/CompanyDisplayCredit | |
AvailTrans | LicenseType | REQUIRED | Type of transaction. For pre-order EST, use "POEST" | ENUMERATED | String | EST, VOD, SVOD, AVOD, POEST, Pre-release | //Transaction/LicenseType | |
AvailTrans | LicenseRightsDescription | Optional | Description of License or Rights granted. | ENUMERATED | String | "POD" for Publish On Delivery. Other values are acceptable although not defined by this specification. | //Transaction/LicenseRightsDescription | |
AvailTrans | FormatProfile | REQUIRED | Indicates the format profile covered by the transaction. | ENUMERATED | String | HD, SD, UHD, 3D, 3DSD, 3DHD, 3DUHD | //Transaction/FormatProfile | |
AvailTrans | HDR | Optional | Indicates whether High Dynamic Range is included. If absent, dynamic range associated with the FormatProfile and bilateral agreements is assumed. | ENUMERATED | String | "True","False", "DV" (DolbyVision), "HDR10" | ||
AvailTrans | WCG | Optional | Indicates whether Wide Color Gamut is included. If absent, color gamut associated with the FormatProfile and bilateral agreements is assumed. | ENUMERATED | String | "True" or "False" | ||
AvailTrans | HFR | Optional | Indicates whether High Frame Rate is included. If absent, frame rate associated with the FormatProfile and bilateral agreements is assumed. | ENUMERATED | String | "True" or "False" | ||
AvailTrans | NGAudio | Optional | Indicates whether next generation audio is included. If absent, audio profile associated with FormatProfile and bilateral agreement is assumed. | ENUMERATED | String | "True", "False", "Atmos", "DTS:X", "Auro3D" | ||
AvailTrans | Start | REQUIRED | Start of term in YYYY-MM-DD or ISO Date+Time format. | Controlled, Standardized, ENUMERATED | Date, Date+Time | YYYY-MM-DD or ISO 8601 Date+Time. For date only YYYY-MM-DD format. 00:00:00 in first time zone in geo is assumed. For date and time, YYYY-MM-DDTHH:MM:SS. Time zone is allowed. "Z" (UTC) is default. If time is absent, T00:00:00 is assumed. |
//Transaction/Start or StartCondition | |
AvailTrans | End | REQUIRED | End of term in YYYY-MM-DD format, ISO Date+Time format, "Open" if no end date is available or, for preorders, "ESTStart" if that's when the pre-order avail ends (most cases for pre-orders). | Controlled, Standardized, ENUMERATED | Date, Date+Time | YYYY-MM-DD or ISO 8601 Date+Time. For date only YYYY-MM-DD format. 00:00:00 in first time zone in geo is assumed. For date and time, YYYY-MM-DDTHH:MM:SS. Time zone is allowed. "Z" (UTC) is default. If time is absent, T23:59:59 is assumed. "Open" is used if no end date. "ESTStart" is used for pre-orders to indicate that this Avail ends at the EST start date+time. "Immediate" means end as soon as reasonbly possible. |
//Transaction/End or EndCondition | |
AvailTrans | PriceType | REQUIRED | Type of pricing that should be applied to this avail based on how you classify them. | ENUMERATED | String | Tier, WSP, DMRP, SMRP, Category, LicenseFee or NA. Also, for temporary price reductions, use TPR-xxx where xxx is any other. "NA" means pricing is not applicable to this Avail. | //Transaction/Term@termName | |
AvailTrans | PriceValue | REQUIRED | Value to be applied to the pricing type. | Controlled | String or Number | NR, 2, 10, 4.99, New Release (examples of Tier as string, Tier as number, WSP, SRP, and Category, respectively). When PriceType is "NA", PriceValue must also be "NA" | For Tier, Category: //Transaction/Term/Text For WSP, SRP: //Transaction/Term/Money |
|
AvailTrans | PriceCurrency | Optional | Currency associated with PriceValue | Standardized | String | ISO 4217 Currency Alphabetic Code (e.g., USD, EUR). If absent, currency is assumed to be from bilateral agreement. In the absense of bilateral agreement, currency is local currency. | //Transaction/Term/Money/@currency | |
AvailTrans | SRP | Optional | Suggested retail price in local currency. | Controlled | Number | #.##, ##.##, ... | //Transaction/Term@termName="SRP" //Transaction/Term/Money |
|
AvailTrans | Description | Optional | A free-form description of the transaction. | Freeform | String | "Box office info. Significant digital home entertainment release campaign planned." | //Transaction/Description | |
AvailTrans | OtherTerms | Optional | Any additional monetary terms. | Freeform | String | "Eligible for promo discount if bundled with prequel. Please contact marketing team for details if interested." | N/A | |
AvailTrans | OtherInstructions | Optional | Any additional instructions, such as studio information for either studio page collections or channel collections. | Freeform | String | RS Films, RockStarChannel | //Transaction/OtherInstructions | |
AvailAsset | TitleID | Optional | Title (Abstraction) Identifier. Abstraction level EIDR or equivalent. | Standardized | String | EIDR IDs shall be encoded using standard format (i.e., 10.5240/xxxx-xxxx-xxxx-xxxx-xxxx-y) non-EIDR IDs shall use only valid URN characters in accordance with RFC 3986. non-EIDR IDs should conform to Common Metadata ID format (Common Metadata, Section 2.1) with <type> "titleid" 10.5240/1489-49A2-3956-4B2D-FE16-5 md:titleid:org:mpm.craigsmovies.com:20938 |
//Asset/Metadata/TitleEIDR-URN | |
AvailAsset | EditID | Optional | Asset Identifier. This should be the Edit Level EIDR. | Standardized | String | Same as TitleID, except <type> is editid | //Asset/Metadata/EditEIDR-URN | |
Metadata | AltID | Optional | Use is defined bilaterally (sender and receiver). When used, it will tyipcally carry "Cut ID", "Custom ID" or "Vendor ID". | Freeform | String | In accordance with bilateral agreement. For example: 1234567-123456, T0ALT |
//Asset/Metadata/AltIdentifier | |
AvailAsset | ContentID | REQUIRED | Content identifier. This identifier is used primarly to reference metadata. | Standardized | String | Preferred encoding is Common Metadata's Content ID, defined in Section 2.2.1. md:cid:eidr-s:1489-49A2-3956-4B2D-FE16-5 |
//Asset@contentID | |
Avail | AvailID | Optional | Avail Identifier. This should be unique to the avail window/entry. | Freeform | String | 34530345-ABD-WE-1 | //Transaction/@TransactionID | |
Avail | UV_ID | Optional | DECE/UltraViolet enttitlement ID associated with Avail. This ID is posted to the Rights Token when the entitlement is acquired. | Standardized | String | DECE ALID in accordance with DECE specifications. | //Avail/SharedEnttilement/EcosystemID, @ecosystem="UVVU" | |
Avail | DMA_ID | Optional | Disney Moves Anywhere ID associated with Avail | Standardized | String | Entitlement identifier in accordance with DMA specifications. | //Avail/SharedEnttilement/EcosystemID, @ecosystem="DMA" | |
Avail | ReportingID | Optional | This identifier, if provided, should be used for reporting. Note that any identifier can be used for reporting as agreed upon bilaterally. This column is here in case an additional ID is needed, or if its more practical to always retrieve the reporting ID from a single location. | Freform | String | In accordance with bilateral agreement. | //Transaction/ReportingID | |
AvailAsset | Metadata | Optional | Metadata describing Asset. | Freeform | String | Fully localized, Multi-language | N/A | |
Avail | ALID | REQUIRED | Logical Asset ID (ALID) for the content associated with the Avail. On 'Full Extract', all existing Avails associated with this ALID will be replaced with all Avails in the spreadsheet with the same ALID. |
Freeform | String | Any unique string can be used. However, recommened format is using the identifier structure defined in Common Metadata, Section 2.1 with <type> "alid". For example, md:alid:eidr-s:1489-49A2-3956-4B2D-EG76-6 md:alid:org:mpm.craigsmovies.com:2130583 |
//Avail/ALID | |
AvailTrans | SuppressionLiftDate | Optional, but REQUIRED for pre-orders. | REQUIRED for pre-orders. First date a title could be publically announced as becoming available at a specific future date in territory of avail. *Not* the avail start date or pre-order start date. Format is YYYY-MM-DD. For pre-orders, this would be the date on which we can display the earliest EST start date. Use "N/A" if no SuppressionLiftDate exists, and the earliest EST start date can be displayed on the service as soon as it's available. | Standardized | Date | YYYY-MM-DD | //Transaction/Term@termName="SuppressionLiftDate" //Transaction/Term/Event | |
AvailTrans | SpecialPreOrderFulfillDate | Optional for pre-orders. | Optional for preorders. Should be blank for all other license types. The date that a pre-ordered video can be released to the consumer for viewing *if* different from the earliest EST start date. | Standardized | Date | YYYY-MM-DD | //Transaction/Term@termName="PreOrderFulfillDate" //Transaction/Term/Event |
|
AvailTrans | AnnounceDate | Optional for pre-orders. | Date when the retailer is permitted to announce the availability start date of the title within the available territory. If expressed as a date, the time is assumed to be 12:00AM in the availability territory. | Standardized | Date | YYYY-MM-DD | //Transaction/Term@termName="AnnounceDate" //Transaction/Term/Event | |
AvailMetadata | ReleaseYear | Optional | Release year of title in earliest released territory. Highly recommended for disambiguation of title releases e.g., "Footloose" 1984 vs. 2011. | Controlled | Date | YYYY | //Asset/Metadata/ReleaseDate | |
AvailMetadata | ReleaseHistoryOriginal | Optional | First date of distribution for a title, typically theatrical release date. If available for territory of avail, otherwise first theatrical release date WW (e.g., US) would suffice. Format is YYYY-MM-DD. | Standardized | Date | YYYY-MM-DD | //Asset/Metadata/ReleaseHistory/Date (ReleaseType = 'original') | |
AvailMetadata | ReleaseHistoryPhysicalHV | Optional | Release date for initial physical home video release. If available for territory of avail, otherwise first physical home video release date WW (e.g., US) would suffice. Format is YYYY-MM-DD. | Standardized | Date | YYYY-MM-DD | //Asset/Metadata/ReleaseHistory/Date (ReleaseType = 'DVD') | |
Avail | ExceptionFlag | Optional | Yes/No flag to be applied to an avail for it to require human review before applying. E.g., flag to retailer signaling that an avail is exclusive to retailer or similar. | ENUMERATED | String | Yes, No | //ExceptionsFlag | |
AvailMetadata | RatingSystem | Optional | Rating system applied to the edit of title within territory of avail. Rating systems should be formatted as per [ http://www.movielabs.com/md/ratings/ ] | Standardized | String | MPAA, CHVRS | //Asset/Metadata/Ratings/Rating/System | |
AvailMetadata | RatingValue | Optional | Value representing the rating within the specified RatingSystem. Ratings should be formatted as per [ http://www.movielabs.com/md/ratings/ ] | Standardized | String | G, PG, PG-13, R | //Asset/Metadata/Ratings/Rating/Value | |
AvailMetadata | RatingReason | Optional | Value representing the rating reason (if available) that provides details on why this film was assigned the rating value. Rating reasons should be formatted as per [ http://www.movielabs.com/md/ratings/ ] and comma-separated for inclusion of multiple reasons. |
Standardized | String | L,S,V | //Asset/Metadata/Ratings/Rating/Reason (split into separate elements) | |
AvailTrans | RentalDuration | Optional | Duration of rental period in hours. 720 hours = 30 days. | Controlled | Number | ##, ###, ... | //Transaction/Term@termName="RentalDuration" //Transaction/Term/Duration |
|
AvailTrans | WatchDuration | Optional | Duration or playback period after playback start, in hours. | Controlled | Number | ##, ###, ... | //Transaction/Term@termName="WatchDuration" //Transaction/Term/Duration |
|
AvailMetadata | CaptionIncluded | REQUIRED* | *Required in US. Communicating if captions are required or not. Non-US territories may be left blank. | ENUMERATED | String | Yes, No | N/A | |
AvailMetadata | CaptionExemption | REQUIRED* | *Required in US for episodes if captions are *not* included. Communicating an exempt category as defined by FCC regulations. It is not required for non-US avails. Code number should be used for reason. Here are a list of code numbers and corresponding reason: 1 - The content has never aired on television in the United States. 2 - The content has only aired on television in the United States without captions. 3 - The content has not aired on television in the United States with captions since September 30, 2012. 4 - The content does not consist of full-length video programming. 5 - The content does not fall within a category of online programming that requires captions under FCC regulations (49 C.F.R. § 79.4(b)). 6 - The FCC and/or U.S. Congress has granted an exemption from captioning requirements for this content. |
ENUMERATED | Number | 1, 2, 3, 4, 5, 6 | //Asset/Metadata/USACaptionsExemptionReason | |
AvailMetadata | Any | Optional | Any other element. | Freeform | String | "Free if combined with bundle. Contact marketing team if interested." | N/A | |
AvailTrans | ContractID | Optional | An identifier referencing any contract information relevant to this avail entry between the studio and retailer. | Freeform | String | UB1238 | //Transaction/ContractID | |
Avail | ServiceProvider | Optional | The service provider (usually a post production house) that will be delivering assets. Recommended when multiple post production houses service a studio. | Freeform | String | Digital Works Post | //ServiceProvider | |
AvailMetadata | TotalRunTime | Optional | Total run time as HH:MM:SS. | Controlled | Time | HH:MM:SS | //Asset/Metadata/RunLength | |
AvailTrans | HoldbackLanguage | Optional | Language(s) that must be excluded from distribution, whether subtitled or dubbed. Comma-separated for multiple languages. This shall not be present if HoldbackExclusionLanguage is present. Language shall be encoded in accordance with RFC 5646, Tags for Identifying Languages. The subtags that are available for use with RFC 5646 are available from the Internet Assigned Numbers Authority (IANA) at [ http://www.iana.org/assignments/language-subtag-registry ]. |
Standardized | String | ES, DE | //Transaction/HoldbackLanguage | |
AvailTrans | AllowedLanguages | Optional | Languages that retailer may fulfill against this Avail. If absent, any language can be fulfilled in accordance with bilateral agreements ("any"). Multiple instances can be included, separated by commas. Language shall be encoded in accordance with RFC 5646, Tags for Identifying Languages. The subtags that are available for use with RFC 5646 are available from the Internet Assigned Numbers Authority (IANA) at [ www.iana.org/assignments/language-subtag-registry ] |
Standardized | String | EN, FR | //Transaction/AllowedLanguage | |
Avail | BundledALIDs | Optional | List of ALIDs associated with this bundle | Standardized | String | List of ALIDs separated by semicolons (';'). WorkType must be "Collection" | //Asset/BundledAsset/BundledALID | |
AvailMetadata | RetailerID1, RetailerID2, RetailerID3 | Optional | Optional identifiers for bilaterally defined identifiers | Freeform | as defined bilaterally | as defined bilaterally | //Asset/AssetMetadata/AltIdentifier | |
Avail | RetailerSpare1, RetailerSpare2, RetailerSpare3 | Optional | Optional columns for bilaterally defined fields | Freeform | as defined bilaterally | as defined bilaterally | no mapping. If used, automatic translation will be impossible. |
no reviews yet
Please Login to review.