Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

 

Examples for New Release Messages from v3.7 onwards

Examples for New Release Messages before v3.7

U2 are listed as the only artist, they are therefore communicated with the MainArtist role.  “U2” is also the Display Artist Name string, so it is communicated in the DisplayArtistName composite.

Expand
codelanguage
<SoundRecordingDetailsByTerritory>
  ...
  <DisplayArtist SequenceNumber="1">
    <PartyName>
      <FullName>U2</FullName>
    </PartyName>
    <PartyId Namespace="...">123</PartyId>
    <ArtistRole>MainArtist</ArtistRole>
  </DisplayArtist>
  ...
  <DisplayArtistName>U2</DisplayArtistName>
  ...
</SoundRecordingDetailsByTerritory>
Code Block
languagexml
titleXML Sample
collapse
true
html/xml

U2 are listed as the only artist, they are therefore communicated with the MainArtist role.  “U2” is also the Display Artist Name string, so it is communicated with the Artist role.

Expand
titleXML Sample
Code Block
languagehtml/xml
 <SoundRecordingDetailsByTerritory>
  ...
  <DisplayArtist>                    
    <PartyName>
      <FullName>U2</FullName>
    </PartyName>
    <ArtistRole>Artist</ArtistRole>
  </DisplayArtist>
 
  <DisplayArtist SequenceNumber="1">
    <PartyName>
      <FullName>U2</FullName>
    </PartyName>
    <PartyId Namespace="...">123</PartyId>
    <ArtistRole>MainArtist</ArtistRole>
  </DisplayArtist>
  ...
</SoundRecordingDetailsByTerritory>

Since Paul McCartney and Michael Jackson are both listed as artists with equal weight, they are both communicated with the MainArtist role.  Note also the use of the SequenceNumber on the DisplayArtist composite to ensure that the artists remain in the same order as on the Display Artist Name string. Please also note the "escaping" of the ampersand.

Expand
titleXML Sample
Code Block
languagehtml/xml
<SoundRecordingDetailsByTerritory>
  ...
  <DisplayArtist SequenceNumber="1">
    <PartyName>
      <FullName>Paul McCartney</FullName>
    </PartyName>
    <PartyId Namespace="...">123</PartyId>
    <ArtistRole>MainArtist</ArtistRole>
  </DisplayArtist>
 
  <DisplayArtist SequenceNumber="2">
    <PartyName>
      <FullName>Michael Jackson</FullName>
    </PartyName>
    <PartyId Namespace="...">123</PartyId>
    <ArtistRole>MainArtist</ArtistRole>
  </DisplayArtist>
  ...
  <DisplayArtistName>
   Paul McCartney &amp; Michael Jackson
  </DisplayArtistName>
  ...
</SoundRecordingDetailsByTerritory>

Since Paul McCartney and Michael Jackson are both listed as artists with equal weight, they are both communicated with the MainArtist role.  Note also the use of the SequenceNumber on the DisplayArtist composite to ensure that the artists remain in the same order as on the Display Artist Name string. Please also note the "escaping" of the ampersand.

Expand
titleXML Sample
Code Block
languagehtml/xml
 <SoundRecordingDetailsByTerritory>
  ...
  <DisplayArtist>                    
    <PartyName>
      <FullName>
        Paul McCartney &amp; Michael Jackson
      </FullName>
    </PartyName>
    <ArtistRole>Artist</ArtistRole>
  </DisplayArtist>
 
  <DisplayArtist SequenceNumber="1">
    <PartyName>
      <FullName>Paul McCartney</FullName>
    </PartyName>
    <PartyId Namespace="...">123</PartyId>
    <ArtistRole>MainArtist</ArtistRole>
  </DisplayArtist>
  <DisplayArtist SequenceNumber="2">
    <PartyName>
      <FullName>Michael Jackson</FullName>
    </PartyName>
    <PartyId Namespace="...">123</PartyId>
    <ArtistRole>MainArtist</ArtistRole>
  </DisplayArtist>
  ...
</SoundRecordingDetailsByTerritory>

Jay-Z is listed as the main artist and is therefore communicated with the MainArtist role. Alicia Keys however is a featured artist on the recording, and is therefore is communicated with the FeaturedArtist role.

Expand
titleXML Sample
Code Block
languagehtml/xml
 <SoundRecordingDetailsByTerritory>
  ...
  <DisplayArtist SequenceNumber="1">
    <PartyName>
      <FullName>Jay-Z</FullName>
    </PartyName>
    <PartyId Namespace="...">123</PartyId>
    <ArtistRole>MainArtist</ArtistRole>
  </DisplayArtist>

  <DisplayArtist SequenceNumber="2">
    <PartyName>
      <FullName>Alicia Keys</FullName>
    </PartyName>
    <PartyId Namespace="...">456</PartyId>
    <ArtistRole>FeaturedArtist</ArtistRole>
  </DisplayArtist>
  ...
  <DisplayArtistName>Jay-Z feat. Alicia Keys</DisplayArtistName>
  ...
</SoundRecordingDetailsByTerritory>

Jay-Z is listed as the main artist and is therefore communicated with the MainArtist role.  Alicia Keys however is a featured artist on the recording, and is therefore is communicated with the FeaturedArtist role.

Expand
titleXML Sample
Code Block
languagehtml/xml
 <SoundRecordingDetailsByTerritory>
  ...
  <DisplayArtist>                    
    <PartyName>
      <FullName>Jay-Z feat. Alicia Keys</FullName>
    </PartyName>
    <ArtistRole>Artist</ArtistRole>
  </DisplayArtist>
 
  <DisplayArtist SequenceNumber="1">
    <PartyName>
      <FullName>Jay-Z</FullName>
    </PartyName>
    <PartyId Namespace="...">123</PartyId>
    <ArtistRole>MainArtist</ArtistRole>
  </DisplayArtist>
  <DisplayArtist SequenceNumber="2">
    <PartyName>
      <FullName>Alicia Keys</FullName>
    </PartyName>
    <PartyId Namespace="...">456</PartyId>
    <ArtistRole>FeaturedArtist</ArtistRole>
  </DisplayArtist>
  ...
</SoundRecordingDetailsByTerritory>

Robin Thicke is listed as the main artist and is therefore communicated with the MainArtist role.  T.I. and Pharrell are a featured artists on the recording, and are therefore is communicated with the FeaturedArtist role.  Note again the use of the SequenceNumber to ensure that the featured artists remain in the correct order. Please also note the "escaping" of the ampersand.

Expand
titleXML Sample
Code Block
languagehtml/xml
 <SoundRecordingDetailsByTerritory>
  ...
  <DisplayArtist SequenceNumber="1">
    <PartyName>
      <FullName>Robin Thicke</FullName>
    </PartyName>
    <PartyId Namespace="...">123</PartyId>
    <ArtistRole>MainArtist</ArtistRole>
  </DisplayArtist>

  <DisplayArtist SequenceNumber="2">
    <PartyName>
      <FullName>T.I.</FullName>
    </PartyName>
    <PartyId Namespace="...">456</PartyId>
    <ArtistRole>FeaturedArtist</ArtistRole>
  </DisplayArtist>

  <DisplayArtist SequenceNumber="3">
    <PartyName>
      <FullName>Pharrell</FullName>
    </PartyName>
    <PartyId Namespace="...">789</PartyId>
    <ArtistRole>FeaturedArtist</ArtistRole>
  </DisplayArtist>
  ...
  <DisplayArtistName>
    Robin Thicke feat. T.I. &amp; Pharrell
  </DisplayArtistName>
  ...
</SoundRecordingDetailsByTerritory>

Robin Thicke is listed as the main artist and is therefore communicated with the MainArtist role.  T.I. and Pharrell are a featured artists on the recording, and are therefore is communicated with the FeaturedArtist role.  Note again the use of the SequenceNumber to ensure that the featured artists remain in the correct order. Please also note the "escaping" of the ampersand.

Expand
titleXML Sample
Code Block
languagehtml/xml
<SoundRecordingDetailsByTerritory>
  ...
  <DisplayArtist>                    
    <PartyName>
      <FullName>
        Robin Thicke feat. T.I. &amp; Pharrell
      </FullName>
    </PartyName>
    <ArtistRole>Artist</ArtistRole>
  </DisplayArtist>
 
  <DisplayArtist SequenceNumber="1">
    <PartyName>
      <FullName>Robin Thicke</FullName>
    </PartyName>
    <PartyId Namespace="...">123</PartyId>
    <ArtistRole>MainArtist</ArtistRole>
  </DisplayArtist>
  <DisplayArtist SequenceNumber="2">
    <PartyName>
      <FullName>T.I.</FullName>
    </PartyName>
    <PartyId Namespace="...">456</PartyId>
    <ArtistRole>FeaturedArtist</ArtistRole>
  </DisplayArtist>
  <DisplayArtist SequenceNumber="3">
    <PartyName>
      <FullName>Pharrell</FullName>
    </PartyName>
    <PartyId Namespace="...">789</PartyId>
    <ArtistRole>FeaturedArtist</ArtistRole>
  </DisplayArtist>
  ...
</SoundRecordingDetailsByTerritory> 

Our final example illustrates use of a collaboration that doesn’t use the usual “&” or “feat.” joiners.

Expand
titleXML Sample
Code Block
languagehtml/xml
 <SoundRecordingDetailsByTerritory>
  ...
  <DisplayArtist SequenceNumber="1">
    <PartyName>
      <FullName>Yo-Yo Ma</FullName>
    </PartyName>
    <PartyId isISNI="true">0000000109615907</PartyId>
    <ArtistRole>MainArtist</ArtistRole>
  </DisplayArtist>

  <DisplayArtist SequenceNumber="2">
    <PartyName>
      <FullName>London Symphony Orchestra</FullName>
    </PartyName>
    <PartyId Namespace="...">456</PartyId>
    <ArtistRole>MainArtist</ArtistRole>
  </DisplayArtist>
  ...
  <DisplayArtistName>
    Yo-Yo Ma with the London Symphony Orchestra
  <DisplayArtistName>
  ...
</SoundRecordingDetailsByTerritory>

Our final example illustrates use of a collaboration that doesn’t use the usual “&” or “feat.” joiners.

Expand
titleXML Sample
Code Block
languagehtml/xml
 <SoundRecordingDetailsByTerritory>
  ...
  ...
  <DisplayArtist>                    
    <PartyName>
      <FullName>
        Yo-Yo Ma with the London Symphony Orchestra
      </FullName>
    </PartyName>
    <ArtistRole>Artist</ArtistRole>
  </DisplayArtist>
 
  <DisplayArtist SequenceNumber="1">
    <PartyName>
      <FullName>Yo-Yo Ma</FullName>
    </PartyName>
    <PartyId isISNI="true">0000000109615907</PartyId>
    <ArtistRole>MainArtist</ArtistRole>
  </DisplayArtist>
  <DisplayArtist SequenceNumber="2">
    <PartyName>
      <FullName>London Symphony Orchestra</FullName>
    </PartyName>
    <PartyId Namespace="...">456</PartyId>
    <ArtistRole>MainArtist</ArtistRole>
  </DisplayArtist>
  ...
</SoundRecordingDetailsByTerritory>

...