NewsIdentifier

A globally unique identifier for a NewsItem.

Element information

Content

• Sequence [1..1]
  1. ProviderId [1..1]    An identifier for the news provider that produced the NewsItem. The provider's ID is specified in the element content. This should be an Internet domain name that is owned by the provider at the date identified by the DateId subelement of the NewsIdentifier. Because the domain name "iptc.org" was owned on 1 October 2000 by the International Press Telecommunications Council (IPTC) and no-one else, it is certain that IPTC is the provider in this case.
  2. DateId [1..1]    A date identifier of a NewsItem in short ISO 8601 Basic Format (YYYYMMDD), as described in the comment to the NewsMLDateTime simple type declaration above. The DateId is part of the formal identification of the NewsItem, and must remain the same through successive revisions of the same NewsItem.
  3. NewsItemId [1..1]    An identifier for the NewsItem. The combination of a NewsItemId and a DateId must be unique among NewsItems that emanate from the same provider. Within these constraints, the NewsItemId can take any form the provider wishes. It may take the form of a name for the NewsItem that will be meaningful to humans, but this is not a requirement. The provider may optionally relate the values of a NewsItemId to a controlled vocabulary, which is invoked by the Vocabulary attribute. The value of the Vocabulary attribute may be an http URL, a NewsML URN, or the # character followed by the value of the Duid attribute of a TopicSet in the current document. The Scheme attribute, if present, serves to distinguish which of possibly multiple naming schemes in the controlled vocabulary is the one that governs the NewsItemId.
  4. RevisionId [1..1]    A positive integer indicating which Revision of a given NewsItem this is. Any positive integer may be used, but it must always be the case that of two instances of a NewsItem that have the same ProviderId, DateId and NewsItemId, the one whose RevisionId has the larger value must be the more recent revision. A RevisionId of 0 is not permitted. The PreviousRevision attribute must be present, and its value must be equal to the content of the RevisionId element of the NewsItem's previous revision, if there is one, and 0 if the NewsItem has no previous revision. If the NewsItem contains an Update element or elements, then the Update attribute must be set to U. If the NewsItem consists only of a replacement set of NewsManagement data, then the Update attribute must be set to A. If neither of these is the case, then the Update attribute must be set to N.
  5. PublicIdentifier [1..1]     A public identifier (in the sense defined by the XML 1,0 Specification) for a NewsItem. This is the NewsML URN, and must be constructed as follows: urn:newsml:{ProviderId}:{DateId}:{NewsItemId}:{RevisionId}{RevisionId@Update} where {x} means "the content of the x subelement of the NewsIdentifier" and {x@y} means "the value of the y attribute of the x subelement of the NewsIdentifier", with the exception that if the Update attribute of the RevisionId element has its default value of N, it is omitted from the URN. Note that the set of characters that can be directly included within a URN is limited. The allowed characters are specified by the Internet Engineering Task Force (IETF) in its Request For Comments (RFC) number 2141. This document is available at http://www.ietf.org/rfc/rfc2141.txt. Any character that is not within the permitted URN character set must be converted to a sequence of legal characters as described in RFC 2141. Note that the existence of this URN enables the NewsItem to be referenced unambiguously by pointers from other XML elements or resources. Within such pointers, if the RevisionId, its preceding : character and its following Update qualifier are omitted, then the pointer designates the most recent revision at the time it is resolved. Version 1.1.2 Pattern corrected for Date component

Attributes

None

Used in

• Anonymous type of element Identification

Sample instance

<NewsIdentifier>
   <ProviderId>string</ProviderId>
   <DateId>string</DateId>
   <NewsItemId>string</NewsItemId>
   <RevisionId>1</RevisionId>
   <PublicIdentifier>string</PublicIdentifier>
</NewsIdentifier>