DescriptiveMetadata

Multiple appearance for the child element Genre, new elements DateLineDate and Location were introduced in  version 1.1

Element information

Namespace: http://iptc.org/std/NewsML/2003-10-10/

Schema document: NewsML_1.2.xsd

Type: Anonymous

Properties: Local, Qualified

Content

Sequence [1..1]
1. Catalog [0..1]
2. Language [0..*] An indication of the, or a, language used in a content item. The value of the FormalName attribute is a formal name for the Language. Its meaning and permitted values are determined by a controlled vocabulary as described in the comment to the formalname attribute group declaration above.
3. Genre [0..*] An indication of the Genre of a NewsComponent. The value of the FormalName attribute is a formal name for the Genre. Its meaning and permitted values are determined by a controlled vocabulary as described in the comment to the formalname attribute group declaration above.
4. SubjectCode [0..*] A container for the IPTC Subject Codes that indicate the subject of a NewsItem, as defined in the IPTC Information Interchange Model. It consists of one more Subject, SubjectMatter and SubjectDetail elements, optionally amplified by one or more SubjectQualifier elements.
5. OfInterestTo [0..*] An indication of the target audience of a NewsItem. The value of the FormalName attribute is a formal name for the target audience. Its meaning and permitted values are determined by a controlled vocabulary as described in the comment to the formalname attribute group declaration above.
6. DateLineDate [0..1] A logical equivalent of the date of creation. ISO8601 Basic Format
7. Location [0..*] An indication of the location somehow relevant to the NewsItem. The type of the location (the nature of its relation to the NewsItem) is specified using the HowPresent attribute that is part of the assignment attribute group (e.g. DateLine, Event, etc). Logical components of the location's definition (eg Country) are specified using the Property child elements with the FormalName attributes taken from the IPTC normative controlled vocabulary. In addition, if the location in question exists as a single Topic, the optional Topic attribute may be used as a direct pointer to that Topic. The pointer may take the form of an http URL or a NewsML URN, or a # character followed by the value of the Duid attribute of a Topic element in the current document
8. TopicOccurrence [0..*] An indication that a particular topic occurs within the content of a NewsComponent. The optional HowPresent attribute indicates the nature of that topic's occurrence. The value of the Topic attribute must consist of a # character followed by the value of the Duid attribute of a Topic in the current document.
9. Property [0..*]

Attributes

Name	Occ	Type	Description	Notes
Duid	[0..1]	xsd:ID	Duid is a "Document-unique Identifier". It must satisfy the rules for XML ID attributes: it must only contain name characters, and it must start with a name-start character (not a digit). Its value must be unique within any NewsML document. Every NewsML element type has Duid as an optional attribute. Combined with the Identifier element, providing a value for the Duid of any element in a NewsML document makes the element globally identifiable. The Identifier element gives global identification to the document, and the Duid provides local identification for the element within the document.	from group localid
Euid	[0..1]	xsd:string	Euid is an "Element-unique Identifier". Its value must be unique among elements of the same element-type and having the same parent element. Use of Euid attribute makes it possible to identify any NewsML element within the context of its local branch of the NewsML document tree. This makes it possible to copy, or include by reference, subtrees into new combinations in ways that would break the uniqueness of Duids (thereby forcing new Duids to be allocated), but still being able to retain the identity of each element. If Euids are maintained at every level, it is possible to identify, for example "The ContentItem whose Euid is abc within the NewsComponent whose Euid is def". Such identification patterns would be preserved even after "pruning and grafting" of subtrees.	from group localid
AssignedBy	[0..1]	xsd:string	An identifier for the party assigning a piece of metadata. This can be a string that designates the party informally (for example, a person's name), or a pointer in the form a fragment identifier consisting of a # character followed by the Duid of a Topic corresponding to the party.	from group assignment
Importance	[0..1]	xsd:string	An indication of the importance the party assigning a piece of metadata attaches to it. The value of the Importance attribute is a formal name for a level of importance. Its meaning and permitted values are determined by a controlled vocabulary.	from group assignment
Confidence	[0..1]	xsd:string	An indication of the confidence with which a piece of metadata has been assigned. The value of the Confidence attribute is a formal name for a degree of confidence. Its meaning and permitted values are determined by a controlled vocabulary.	from group assignment
HowPresent	[0..1]	xsd:string	An indication of the way in which a piece of metadata applies. The value of the HowPresent attribute is a formal name for the way the metadata applies. Its meaning and permitted values are determined by a controlled vocabulary.	from group assignment
DateAndTime	[0..1]	NewsMLDateTime	The date and (optionally) time at which a piece of metadata was assigned.	from group assignment

Used in

Type NewsComponentType (Element NewsComponent)

Sample instance

<DescriptiveMetadata>
   <Catalog>
      <Resource>
         <Urn>string</Urn>
         <Url>string</Url>
         <DefaultVocabularyFor Context="string"/>
      </Resource>
      <TopicUse Topic="string" Context="string"/>
   </Catalog>
   <Language FormalName="string"/>
   <Genre FormalName="string"/>
   <SubjectCode>
      <Subject FormalName="string"/>
      <SubjectQualifier FormalName="string"/>
   </SubjectCode>
   <OfInterestTo FormalName="string">
      <Relevance FormalName="string"/>
   </OfInterestTo>
   <DateLineDate>string</DateLineDate>
   <Location>
      <Property FormalName="string">
         <Property FormalName="string">...
         </Property>
      </Property>
   </Location>
   <TopicOccurrence/>
   <Property FormalName="string">
      <Property FormalName="string">
         <Property FormalName="string">...
         </Property>
      </Property>
   </Property>
</DescriptiveMetadata>