NewsComponentType

A container for news objects, used to identify the role of news objects in relation to one another, and to ascribe metadata to them. The Essential attribute indicates whether the provider considers that this NewsComponent is essential to the meaning of the NewsComponent within which it is contained. The EquivalentsList attribute indicates whether or not the NewsItems or NewsItemRefs, NewsComponents or ContentItems contained within this one are equivalent to one another in content and/or meaning

Complex type information

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

Schema document: NewsML_1.2.xsd

Content

Sequence [1..1]
1. Comment [0..*]
2. Catalog [0..1]
3. TopicSet [0..*]
4. Role [0..1] An identifier of the role played by a NewsComponent within a NewsComponent that contains it. The outermost NewsComponent within a NewsItem need not specify a Role attribute value. The value of the FormalName attribute is a formal name for the Role. Its meaning and permitted values are determined by a controlled vocabulary as described in the comment to the formalname attribute group declaration above.
5. BasisForChoice [0..*] The content of this element is an XPath statement or element-type name identifying information within each NewsComponent or ContentItem that can be used as a basis for choice between equivalent NewsComponents or ContentItems. If the XPath pattern begins with a . character, this represents the 'root' of the XPath and corresponds to the NewsComponent or ContentItem itself. By applying the XPath pattern to each NewsComponent or ContentItem in turn within the set of equivalents, the system can extract the data on the basis of which a choice between the items can be made. If multiple matches to the XPath pattern are present within the subtree that begins at the 'root', only the first match found in document order is significant. The optional Rank attribute allows providers to place a numerical order on the importance they think should be attached to the different bases for choice. Smaller numbers represent higher importance.
6. NewsLines [0..1] A container for all the NewsLines that a NewsComponent has. Made an "or" group and ByLineTitle added in version 1.1
7. AdministrativeMetadata [0..1] Information about the provenance of a NewsComponent.
8. RightsMetadata [0..1] Information about the rights pertaining to a NewsComponent.
9. DescriptiveMetadata [0..1] Multiple appearance for the child element Genre, new elements DateLineDate and Location were introduced in version 1.1
10. Metadata [0..*] An container for a user-defined type of metadata.
11. Choice [0..1]
  - Choice [1..*]
    - NewsItem
    - NewsItemRef A pointer to a NewsItem that is deemed to replace the NewsItemRef element. The NewsItem attribute is a pointer to the relevant NewsItem. Its value can be an http URL, or a NewsML URN as described in the comment to PublicIdentifier, or a fragment identifier consisting of a # character followed by the Duid of a NewsItem in the current document.
  - NewsComponent [1..*]
  - ContentItem [1..*] A news object that carries or identifies content intended for presentation to humans.

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
Essential	[0..1]	Anonymous		Default value is "no".
EquivalentsList	[0..1]	Anonymous		Default value is "no".
xml:lang	[0..1]	Anonymous

Used by

Element NewsComponent