12 Rules for the communication of resource files
The following rules shall apply to the communication of resource files:
Resource availability (no pre-order releases)
When communicating a release for which no pre-order deal is available, the record company or distributor shall ensure that for all resources the location of each resource file is communicated to the DSP before the release is to be made available to consumers.
For the avoidance of doubt, it is sufficient that the location of each resource file is communicated via aNewReleaseMessage
, sufficiently well before the release is to "go live" to allow the DSP to meet the "go live" date.
It is, however, preferred that the locations of all resources are communicated together.Resource availability (pre-order releases)
When communicating a release for which a pre-order deal is available, the record company or distributor shall ensure that for all resources the location of each resource file is communicated to the DSP before it is to be made available to consumers as part of the release.
For the avoidance of doubt, it is sufficient that the location of each resource file is communicated via aNewReleaseMessage
, sufficiently well before the resource is to "go live" to allow the DSP to meet the "go live" date.
It is, however, preferred that the locations of all resources are communicated together.Signalling resource file availability
When communicating that a resource file is available, the record company or distributor shall include a
TechnicalDetails
composite with theIsProvidedInDelivery
flag set totrue
in the relevant resource composite in theNewReleaseMessage
. However, the presence of just aTechnicalDetails
composite is not an indication that a resource file is available.When updating metadata of a resource, the record company or distributor is not obliged to re-send the related resource file. However, if, when updating resource metadata, the
IsProvidedInDelivery
flag in theTechnicalDetails
composite is set to true, this indicates that a new version of the resource file is available.When the record company or distributor wishes to provide a new version of a resource file, the record company or distributor shall include a
TechnicalDetails
composite with theIsProvidedInDelivery
flag set to true in the relevantResource
composite in theNewReleaseMessage
.While it is permissible to update resource metadata without sending
TechnicalDetails
, this may lead to existingDeals
becoming “orphaned” if they reference aTechnicalDetails
composite which does not contain any data.
Primary and Secondary Resources
If the record company or distributor needs to provide a new version of one (or more) Primary Resource file(s), all Primary Resource files that have the same
SoundRecordingEdition
orSoundRecordingType
as the file to be updated must also be updated. This does not mean that any Secondary Resource file(s) need to be updated.If the record company or distributor needs to provide a new version of one (or more) Secondary Resource file(s), all Secondary Resource files must be updated. This does not mean that any Primary Resource file(s) need to be updated.
In the context of a pre-order release, the term “all” in the above sentences is to be understood as all resources that are (or are to be made) available. This may well be a subset of the complete set.
Optimising resource delivery (informative)
The provisions of the rules 1-4 above prioritise simplicity of implementation over reducing data traffic. There are, however, means to reduce the data traffic.
When a DSP receives aNewReleaseMessage
containing a number ofTechnicalDetails
composites with theIsProvidedInDelivery
flag set totrue
, the DSP knows that for eachTechnicalDetails
composite, one resource file will be available. Assuming the record company or distributor includes a hash sum for the resource file (as part ofFile
in theTechnicalDetails
composite), the DSP can decide whether to ingest the new resource file or to use the resource file it already has received in the past. This is especially useful when the release delivery process is based on web services (rather than cloud-based storage).