Topic

This element provides information about a thing (Topic) named by a formal name or occurring in a NewsComponent. A Topic must have one or more TopicType subelements, which state what type of Topic it is. The optional Details attribute provides a pointer, in the form of a URL or URN, to additional information about the Topic.

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. Comment [0..*]
2. Catalog [0..1]
3. TopicType [1..*] An indication of the type of a Topic. The value of the FormalName attribute is a formal name for the TopicType. Its meaning and permitted values are determined by a controlled vocabulary as described in the comment to the formalname attribute group declaration above.
4. FormalName [0..*] A string of characters whose meaning is determined by a naming scheme within a controlled vocabulary. The controlled vocabulary may (but is not required to) take the form of a NewsML TopicSet. The optional Scheme attribute determines which naming scheme applies, when several exist within the same controlled vocabulary.
5. Description [0..*] A description that identifies a Topic, thereby indicating the meaning of a formal name associated with that Topic. The xml:lang attribute indicates what language the description is in. The optional Variant attribute allows multiple descriptions to be given in the same language, and meaningfully distinguished from one another.
6. 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
Details	[0..1]	xsd:string

Used in

Type TopicSetType (Element TopicSet)

Sample instance

<Topic>
   <Comment>string</Comment>
   <Catalog>
      <Resource>
         <Urn>string</Urn>
         <Url>string</Url>
         <DefaultVocabularyFor Context="string"/>
      </Resource>
      <TopicUse Topic="string" Context="string"/>
   </Catalog>
   <TopicType FormalName="string"/>
   <FormalName>string</FormalName>
   <Description>string</Description>
   <Property FormalName="string">
      <Property FormalName="string">
         <Property FormalName="string">...
         </Property>
      </Property>
   </Property>
</Topic>