MWN hub profile
This hub profile describes what data is to be included in MWN 1.1 messages sent to a hub. Its rules therefore only apply to parties such as record companies and music publishers communicating with a hub and may or may not apply when these parties communicate directly.
The hub profile has been compiled based on the rules used by MDX. It consists of three sets of rules:
General rules, which apply to all MWN messages;
Claim request rules, which apply to
MusicalWorkClaimRequestMessages
sent by record companies to a hub; andClaim notification rules, which apply to
MusicalWorkClaimNotificationMessages
sent by publishers to a hub.
The hub profile is expected to become a standard for the next version of the MWN Standard.
General Rules
The hub must be among the recipients of the message (MessageRecipient
in the MessageHeader
).
The actual name of the message file must be given in MessageFileName
in the MessageHeader
.
MessageControlType
in the MessageHeader
must not be TestMessage
(unless the message is a test message agreed with the hub).
The SoundRecordingId/ISRC
of each SoundRecording
in the ResourceList
and VideoId/ISRC
of each Video
in the ResourceList
must be given.
The Title/TitleText
of each SoundRecording
and Video
in the ResourceList
must not be a blank string.
The Title/TitleText
of each MusicalWork
in the WorkList
must not be a blank string.
The PartyName/FullName
of each Party
in the PartyList
must not be a blank string.
If an IpiNameNumber
is given as a PartyId
for a Party
, the value must be exactly 11 digits.
Claim Request Rules
Each Request
in the RequestList
must have a RequestId
that is unique for the record company (i.e. not only in this message).
If right share specific information is requested using Request/MusicalWorkShareRequest
, the RightsControllerRequestId
must have a value that is unique across all requests in the message (i.e. not only within the Request
).
For each MusicalWork
in the WorkList
, at least one SoundRecording
or Video
in the ResourceList
must be given.
For each MusicalWork
in the WorkList
, at least one Release
in the ReleaseList
must be given. Each of these Releases
is linked to the MusicalWork
via a SoundRecording
or Video
in the ResourceList
.
The Title/TitleText
of each Release
in the ReleaseList
must not be a blank string.
If both a StartDate
and an EndDate
are given for a Condition/ValidityPeriod
of a Request in the RequestList
, the StartDate
must not be later or equal to the EndDate
.
Claim Notification Rules
If a RightShare
's XML attribute IsNetPublisherShare
is set to true
, the XML elements IsFollowerInTitleOf
and HasOriginalPublisherShare
are not allowed.
For any RightShare
with RightShareType
=MusicalWorkCollectionShare
whose XML attribute IsNetPublisherShare
is missing or false, the XML element IsFollowerInTitleOf
is required.
If both a StartDate
and an EndDate
are given for a ValidityPeriod
of a RightShare
in the RightShareList
, the StartDate
must not be later or equal to the EndDate
.
If a RightSharePercentage
is given for a RightShare
that is a MusicalWorkManuscriptShare
, a MusicalWorkCollectionShare
, or an OriginalPublisherShare
referenced by a MusicalWorkCollectionShare
, the value must be greater than 0 and less or equal to 100.