NewsComponent

Element information

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

Properties: Local, Qualified

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 in

Type NewsComponentType (Element NewsComponent)
Type NewsItemType (Element NewsItem)

Sample instance

<NewsComponent>
   <Comment>string</Comment>
   <Catalog>
      <Resource>
         <Urn>string</Urn>
         <Url>string</Url>
         <DefaultVocabularyFor Context="string"/>
      </Resource>
      <TopicUse Topic="string" Context="string"/>
   </Catalog>
   <TopicSet FormalName="string">
      <Comment>string</Comment>
      <Catalog>
         <Resource>...
         </Resource>
         <TopicUse Topic="string" Context="string"/>
      </Catalog>
      <TopicSetRef>
         <Comment>string</Comment>
      </TopicSetRef>
      <Topic>
         <Comment>string</Comment>
         <Catalog>...
         </Catalog>
         <TopicType FormalName="string"/>
         <FormalName>string</FormalName>
         <Description>string</Description>
         <Property FormalName="string">...
         </Property>
      </Topic>
   </TopicSet>
   <Role FormalName="string"/>
   <BasisForChoice>string</BasisForChoice>
   <NewsLines>
      <HeadLine>Any text, intermingled with:
         <Origin>Any text, intermingled with:...
         </Origin>
      </HeadLine>
      <SubHeadLine>Any text, intermingled with:
         <Origin>Any text, intermingled with:...
         </Origin>
      </SubHeadLine>
   </NewsLines>
   <AdministrativeMetadata>
      <Catalog>
         <Resource>...
         </Resource>
         <TopicUse Topic="string" Context="string"/>
      </Catalog>
      <FileName>string</FileName>
      <SystemIdentifier>string</SystemIdentifier>
      <Provider>
         <Comment>string</Comment>
         <Party FormalName="string">...
         </Party>
      </Provider>
      <Creator>
         <Comment>string</Comment>
         <Party FormalName="string">...
         </Party>
         <Contribution FormalName="string"/>
      </Creator>
      <Source>
         <Comment>string</Comment>
         <Party FormalName="string">...
         </Party>
      </Source>
      <Contributor>
         <Comment>string</Comment>
         <Party FormalName="string">...
         </Party>
         <Contribution FormalName="string"/>
      </Contributor>
      <Property FormalName="string">
         <Property FormalName="string">...
         </Property>
      </Property>
   </AdministrativeMetadata>
   <RightsMetadata>
      <Catalog>
         <Resource>...
         </Resource>
         <TopicUse Topic="string" Context="string"/>
      </Catalog>
      <Copyright>
         <Comment>string</Comment>
         <CopyrightHolder>Any text, intermingled with:...
         </CopyrightHolder>
         <CopyrightDate>Any text, intermingled with:...
         </CopyrightDate>
      </Copyright>
      <UsageRights>
         <UsageType>Any text, intermingled with:...
         </UsageType>
         <Geography>Any text, intermingled with:...
         </Geography>
         <RightsHolder>Any text, intermingled with:...
         </RightsHolder>
         <Limitations>Any text, intermingled with:...
         </Limitations>
         <StartDate>Any text, intermingled with:...
         </StartDate>
         <EndDate>Any text, intermingled with:...
         </EndDate>
      </UsageRights>
      <Property FormalName="string">
         <Property FormalName="string">...
         </Property>
      </Property>
   </RightsMetadata>
   <DescriptiveMetadata>
      <Catalog>
         <Resource>...
         </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>
      </Location>
      <TopicOccurrence/>
      <Property FormalName="string">
         <Property FormalName="string">...
         </Property>
      </Property>
   </DescriptiveMetadata>
   <Metadata>
      <Catalog>
         <Resource>...
         </Resource>
         <TopicUse Topic="string" Context="string"/>
      </Catalog>
      <MetadataType FormalName="string"/>
      <Property FormalName="string">
         <Property FormalName="string">...
         </Property>
      </Property>
   </Metadata>
   <NewsItem>
      <Comment>string</Comment>
      <Catalog>
         <Resource>...
         </Resource>
         <TopicUse Topic="string" Context="string"/>
      </Catalog>
      <Identification>
         <NewsIdentifier>...
         </NewsIdentifier>
         <NameLabel>string</NameLabel>
         <DateLabel>string</DateLabel>
         <Label>...
         </Label>
      </Identification>
      <NewsManagement>
         <NewsItemType FormalName="string"/>
         <FirstCreated>string</FirstCreated>
         <ThisRevisionCreated>string</ThisRevisionCreated>
         <Status FormalName="string"/>
         <StatusWillChange>...
         </StatusWillChange>
         <Urgency FormalName="string"/>
         <RevisionHistory Href="string"/>
         <DerivedFrom>...
         </DerivedFrom>
         <AssociatedWith>...
         </AssociatedWith>
         <Instruction FormalName="string">...
         </Instruction>
         <Property FormalName="string">...
         </Property>
      </NewsManagement>
      <NewsComponent>
         <Comment>string</Comment>
         <Catalog>...
         </Catalog>
         <TopicSet FormalName="string">...
         </TopicSet>
         <Role FormalName="string"/>
         <BasisForChoice>string</BasisForChoice>
         <NewsLines>...
         </NewsLines>
         <AdministrativeMetadata>...
         </AdministrativeMetadata>
         <RightsMetadata>...
         </RightsMetadata>
         <DescriptiveMetadata>...
         </DescriptiveMetadata>
         <Metadata>...
         </Metadata>
         <NewsItem>...
         </NewsItem>
      </NewsComponent>
   </NewsItem>
</NewsComponent>