5.2 File server organisation
On the server the NewReleaseMessage
relating to a single release shall be placed into a separate folder for that release. The name of the folder shall be made up of the following elements:
A priority/non-priority indicator (see below), followed by;
An underscore character, followed by;
The ReleaseId of the release to which the
NewReleaseMessage
and resource files relate, followed by; An underscore character, followed by;The date/time of when the XML file containing the
NewReleaseMessage
is placed on the server.
The date/time is in the form YYYYMMDDhhmmssnnn
with:
YYYY
indicating the year in which the XML file is placed on the file server;MM
indicating the month in which the XML file is placed on the file server;DD
indicating the day on which the XML file is placed on the file server;hh
indicating the hour (in 24 hours) during which the XML file is placed on the file server; mm indicating the minute during which the XML file is placed on the file server;ss
indicating the second during which the XML file is placed on the file server; and nnn indicating the millisecond during which the XML file is placed on the file server.
The resource files for the release shall be placed into a subfolder of the release folder called resources/
. The value for the priority indicator may be either:
P
to indicate the release is deemed to be a priority delivery for ingestion by the DSP;N
to indicate the release is deemed to be a non-priority delivery; andL
to indicate the release is deemed to be a low-priority delivery.
The meaning of priority in this context is determined by the bilateral agreement between the record company or distributor and the DSP. Mixing non-priority and priority releases in the same delivery is likely to cause confusion on the part of the DSP, especially when no acknowledgements are used. This approach is therefore not recommended.
Once the DSP has downloaded the XML file containing the NewReleaseMessage
and the relevant resource files, the NewReleaseMessage
shall be placed into a subfolder of the release folder called acknowledgements/
.