=========================================== NewsML Schema Version 1.1. This Schema represents the same document structure as the NewsML DTD version 1.1. In addition is provides control over element and attribute content in accordance with the NewsML Specification. =========================================== International Press Telecommunications Council 11 October 2002 Copyright (c) IPTC, 2001, 2002 All rights reserved NewsML is a trademark of IPTC ====================================== DO NOT REMOVE THESE LICENCE CONDITIONS ====================================== LICENCE OF THE IPTC NewsML TRADEMARK TO NON-MEMBERS OF THE IPTC From: http://www.iptc.org/site/NewsML/DTD/NewsMLv1.1.xsd Use of the IPTC trademark shall be licensed by the IPTC ("the Licensor") to a Non-Member ("the Licensee") in consideration of the following obligations undertaken by the Licensee under the terms of this contract. 1. The Licensee recognises the Licensor as the sole owner of the intellectual property protected by the trademark. 2. The Licensee recognises that the Licensor has the right to grant licenses of the intellectual property protected by the trademark and has agreed to grant such a licence to the Licensee in the terms set out in this contract. 3. The Licensee shall not during the subsistence of this contract or at any future time register to use in its own name as proprietor any of the intellectual property protected by the trademark. 4. The Licensee shall not claim any right title or interest in the intellectual property or any part of it save as is granted by this contract. 5. The Licensee shall immediately call to the attention of the Licensor the use of any part of the intellectual property by any third party or any activity of any third party which might in the opinion of the Licensee amount to infringement of the rights protected by the trademark. 6. The Licensee shall not assign the benefit of this contract or grant any sub-licence without the prior written consent of the Licensor. 7. Use of the IPTC trademark is licensed only to those Licensees who comply with the requirements of the official published description of NewsML. 8. The Licensee promises to respect the integrity and quality standard of the trademark and shall refrain from all acts and omissions which threaten the integrity of the trademark as a mark of quality. 9. The Licensee shall communicate immediately to the IPTC any instances of actual or suspected misuse or non-compliance with the official published description of NewsML which come to the attention of the Licensee. 10. The Licensee shall, at the request of the IPTC Management Committee acting unanimously, accede to any reasonable request of the IPTC to inspect the address of the Licensee to verify compliance and each Licensee shall afford to the IPTC such assistance as is requested by the IPTC in response to the latter's reasonable enquiries in instances of suspected non-compliance with the official published description of NewsML requirements. The Licensee shall from time to time provide the IPTC with the full address of its place of business and that place will be deemed the Licensee's address. The IPTC reserves the right to terminate the use of the trademark by the Licensee at any time without notice or without the need to give reasons to the Licensee for such termination. This contract shall be governed and construed in accordance with the laws of England and Wales whose courts shall be courts of competent jurisdiction. ================ NOTE ON SPELLING ================ NewsML element and attribute names use US-English spellings. With this exception, this DTD and its accompanying specification use British English spellings. ============================= PARAMETER ENTITY DECLARATIONS ============================= ================================================================================ Attribute sets ================================================================================ ================================== assignment ================================== AssignedBy ========== 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. Importance ========== 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. Confidence ========== 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. HowPresent ========== 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. DateAndTime =========== The date and (optionally) time at which a piece of metadata was assigned. Uses the format CCYYMMDDTHHMMSS{+or-}HHMM (century, year, month, day, time separator, hours, minutes, seconds, timezone separator, hours, minutes). If only the Date is needed, then the substring from T onwards may be omitted. This is the Basic Format defined by ISO 8601. CCYY is a 4-digit year number. MM is a 2-digit month number. DD is a 2-digit day number. T is the letter 'T'. HH is a 2-digit hour number (using a 24-hour clock). MM is a 2 digit minute number. (Note that midnight may be represented as 240000 on the date of the day that is ending, or as 000000 on the date of the day that is beginning.) {+or-} is the '+' character or the '-' character, and the following HHMM are hours and minutes of offset from Universal Co-ordinated Time (UTC) as defined by ISO 8601. If the time is being expressed in UTC, then the timezone offset may be '+0000' or '-0000' or 'Z'. If the time is behind UTC, the timezone separator is '-'. If the time is ahead of UTC the timezone separator is '+'. Example: 10:27 p.m. in New York on 31 December 2000 would be expressed as "20001231T222700-0500" as New York is five hours behind UTC in winter. At the same moment in London, the date and time would be expressed as "20010101T032700+0000" or as "20010101T032700Z" because in London it is now 3:27 a.m. on 1 January 2001. At the same moment in Paris,the date and time would be expressed as "20010101T042700+0100", because Paris is one hour ahead of UTC in winter and it is now 4:27 a.m. on 1 January 2001. ================================================================================ ================================================================================ Simple Type patterns for datetime and xml:lang ================================================================================ ================================= formalname =================================== FormalName ========== A string of characters whose meaning is determined by a controlled vocabulary. Vocabulary ========== The Vocabulary attribute, if present, provides a pointer to a TopicSet which is the controlled vocabulary that can be used to resolve the meaning of the FormalName. The value of the Vocabulary attribute is an http URL or a NewsML URN, or the # character followed by the value of the Duid attribute of the a TopicSet in the current document. If there is no Vocabulary attribute, then the controlled vocabulary to be used is located by the following algorithm: - Proceed to the parent of the current element. - If it has a Catalog element as its immediate child, see whether that Catalog contains a Resource element whose DefaultVocabularyFor child contains an XPath pattern that is matched by the current element. If so, then the controlled vocabulary is the resource identified by that Resource element. - If the parent does not meet the above condition, proceed to its parent and check the same condition. - Continue until a vocabulary is found, or no further parent elements are available because the root element has been reached and it too fails to meet the condition. If there is no Vocabulary attribute and the above algorithm fails to identify a resource that serves as the controlled vocabulary, there is an error, which the NewsML system may signal to the user. The NewsML system may also signal an error if a vocabulary is successfully identified, but it contains no item that matches the value of the FormalName whose meaning is sought. Scheme ====== The Scheme attribute, if present, serves to distinguish which of possibly multiple naming schemes in the controlled vocabulary is the one that governs this FormalName. For a match to be obtained within the controlled vocabulary, the rule is that the FormalName and the Scheme must both match. If there is a Scheme attribute on the current element, then both the FormalName and the Scheme in the controlled vocabulary must match. The controlled vocabulary will be located either through the Vocabulary attribute (if present) or through the appropriate Catalog entry where the Context matches the current element. If a Vocabulary attribute is present that points to a TopicSet then the FormalName may be resolved using this TopicSet. This overrides any relevant Catalog entry. If there is no Scheme attribute on the current element and no Vocabulary attribute then a Scheme may be assigned through as follows: If the Catalog, within the instance or externally referenced from the instance, contains a Resource element with a DefaultVocabularyFor child element with a Context attribute that matches the current element and a Scheme attribute with a value declared, then this Scheme may be applied when resolving the current element FormalName. If the DefaultVocabularyFor has no Scheme value then a match will be to an item in the vocabulary that has the current FormalName and no Scheme. ================================================================================ =================================== localid ==================================== Duid ==== 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. Euid ==== 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. ================================================================================ ===================================== data ===================================== Where data is included, it may be directly in the form of a DataContent element, or in the form of DataContent wrapped in an Encoding element, or by reference through an Href attribute. In the latter case an empty Encoding element may be present. ================================================================================ ========================= ELEMENT TYPE DECLARATIONS ========================= ============================ AdministrativeMetadata ============================ Information about the provenance of a NewsComponent. ================================================================================ ================================ AssociatedWith ================================ A reference to a NewsItem with which this one is associated (for example, a series of articles, or a collection of photos, of which it is a part). The NewsItem attribute identifies the relevant NewsItem. Its value can be an http URL or a NewsML URN as described in the comment to PublicIdentifier. The Comment can be used to indicate the nature of the association. FormalName attribute structure added in version 1.1 ================================================================================ ================================ BasisForChoice ================================ 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 extrac 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. ================================================================================ ==================================== ByLine ==================================== A natural-language statement of the author/creator information. ================================================================================ ==================================== ByLineTitle ==================================== A natural-language statement of the title of author/creator of the information. (version 1.1) ================================================================================ =================================== Catalog ==================================== A container for Resource and TopicUse elements. Resource elements map URNs to URLs and indicate default vocabularies which apply to the formal names of certain elements within the subtree that begins with the immediate parent of the Catalog element. TopicUse elements indicate where in the NewsML document certain Topics are used. The optional Href attribute provides a pointer to a Catalog element elsewhere in this or another document. Its value consists of a # character followed by the value of the Duid attribute of the referenced Catalog element and preceded, if the referenced Catalog is not in the current document, by an http URL or a NewsML URN identifying the document or NewsItem in which the Catalog appears. If the Href attribute is present on a Catalog element, then that element should be empty. If it contains subelements, the NewsML system may signal an error. ================================================================================ =============================== Characteristics ================================ Information about the physical characteristics of a ContentItem. ================================================================================ =================================== Comment ==================================== A natural-language description of, or statement about, the current element. The optional TranslationOf attribute is a pointer to another Comment element, of which this one is a direct translation. The FormalName and associated attributes added for Version 1.1 ================================================================================ ================================= ContentItem ================================== A news object that carries or identifies content intended for presentation to humans. ================================================================================ ================================= Contributor ================================== An individual and/or company or organisation that modified or enhanced a news object after its creation. ================================================================================ ================================== Copyright =================================== The copyright that pertains to a news object. ================================================================================ ================================ CopyrightDate ================================= A natural-language statement of the copyright date. ================================================================================ =============================== CopyrightHolder ================================ A natural-language statement indicating who owns the copyright. ================================================================================ ================================ CopyrightLine ================================= A natural-language statement of the copyright information. ================================================================================ =================================== Creator ==================================== An individual and/or company or organisation that created a news object. ================================================================================ ================================== CreditLine ================================== A natural-language statement of credit information. ================================================================================ ================================= DataContent ================================== The data that carries the content of a ContentItem. ================================================================================ ================================= DateAndTime ================================== A formal representation of a date and, optionally, time, expressed in ISO 8601 Basic Format, as described in the comment to the DateAndTime attribute within the assignment ENTITY declaration above. ================================================================================ ==================================== DateId ==================================== A date identifier of a NewsItem in short ISO 8601 Basic Format (CCYYMMDD), as described in the comment to the DateAndTime attribute within the assignment ENTITY 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. ================================================================================ ================================== DateLabel =================================== A string representation of a date or date and time, used by human users to help identify a NewsItem. ================================================================================ =================================== DateLine =================================== A natural-language statement of the date and/or place of creation. ================================================================================ =================================== DateLineDate =================================== A logical equivalent of the date of creation. ISO8601 Basic Format ================================================================================ ============================ DefaultVocabularyFor ============================== An indication that the parent Resource provides the default vocabulary that determines the meanings and permitted values of the data occurring in a particular part of a NewsML document subtree. The Context attribute is an XPath pattern identifying the data to which the default vocabulary applies. If the XPath pattern is one that matches elements, then it is the value of the FormalName attribute of that element that is designated. If the XPath pattern is one that matches attributes, then it is the value of that attribute itself that is designated. The optional Scheme attribute identifies the relevant naming scheme if the Resource contains more than one naming scheme. If the Resource is a NewsML TopicSet, then the meaning of the data identified by the Context is provided by the Topic whose FormalName subelement matches that data. If the Resource is not a NewsML TopicSet, then the way in which it is interpreted in order to provide a meaning for the data is not defined by NewsML but by the authority that governs whatever format the Resource uses. ================================================================================ ==================================== Delete ==================================== An instruction to delete an element within a NewsItem. The NewsItem is the previous revision of the current one, and the element to be deleted is the one whose Duid value is equal to the value of the Delete element's DuidRef attribute. ================================================================================ ================================= DerivedFrom ================================== A reference to an NewsItem from which this one is derived. The NewsItem attribute identifies the relevant NewsItem. Its value can be an http URL or a NewsML URN as described in the comment to PublicIdentifier. FormalName structure added in version 1.1 ================================================================================ ================================= Description ================================== 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. ================================================================================ ============================= DescriptiveMetadata ============================== Information describing the content of a NewsComponent. Multiple appearance for the child element Genre, new elements DateLineDate and Location were introduced in version 1.1 of the DTD. ================================================================================ =================================== Encoding =================================== The encoding of the data comprising the content of a ContentItem. ================================================================================ =================================== EndDate ==================================== A natural-language statement of the date at which specified usage rights come to an end. ================================================================================ =================================== FileName =================================== The suggested or actual storage file name for a NewsItem. ================================================================================ ================================= FirstCreated ================================= The date and, optionally, time at which a NewsItem was first created, expressed in ISO 8601 Basic Format, as described in the comment to the DateAndTime attribute within the assignment ENTITY declaration above. ================================================================================ ================================= FormalName =================================== 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. ================================================================================ ==================================== Format ==================================== An indication of the format of a ContentItem. The value of the FormalName attribute is a formal name for the Format. Its meaning and permitted values are determined by a controlled vocabulary as described in the comment to the formalname ENTITY declaration above. ================================================================================ ================================= FutureStatus ================================= An indication of the status a NewsItem will have at a specified future date. The value of the FormalName attribute is a formal name for the FutureStatus. Its meaning is determined by a controlled vocabulary as described in the comment to the formalname ENTITY declaration above. ================================================================================ ==================================== Genre ===================================== 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 ENTITY declaration above. ================================================================================ ================================== Geography =================================== A natural-language statement of the geographical area or areas to which specified usage rights apply. ================================================================================ =================================== HeadLine =================================== A displayable headline. ================================================================================ ================================ Identification ================================ Identification information for the NewsItem. ================================================================================ ================================= InsertAfter ================================== An instruction to insert content after a designated element within a NewsItem. The content to be inserted is the content of the InsertAfter element. The NewsItem into which it is to be inserted is the previous revision of the current one, and the element after which it is to be inserted is the one whose Duid value is equal to the value of the InsertAfter element's DuidRef attribute. ================================================================================ ================================= InsertBefore ================================= An instruction to insert content before a designated element within a NewsItem. The content to be inserted is the content of the InsertBefore element. The NewsItem into which it is to be inserted is the previous revision of the current one, and the element before which it is to be inserted is the one whose Duid value is equal to the value of the InsertBefore element's DuidRef attribute. ================================================================================ ================================= Instruction ================================== An instruction from a news provider to the recipient of a NewsItem. A special case of Instruction is an indication of the effect the current revision of a NewsItem has on the status of any previous revisions of the NewsItem that may still be on the recipient's system. In this case, it will contain one or more RevisionStatus elements. Otherwise, the value of the FormalName attribute is a formal name for the Instruction, and its meaning is determined by a controlled vocabulary as described in the comment to the formalname ENTITY declaration above. ================================================================================ ================================= KeywordLine ================================== A displayable set of keywords relevant to a news object. This can be used by a NewsML system to assist manual or automated searches. ================================================================================ ==================================== Label ===================================== A human-readable label for a NewsItem. ================================================================================ =================================== LabelText ================================== The text that constitutes a Label of a given LabelType. ================================================================================ ================================= LabelType ==================================== A user-defined type of label. The value of the FormalName attribute is a formal name for the LabelType. Its meaning and permitted values are determined by a controlled vocabulary as described in the comment to the formalname ENTITY declaration above. ================================================================================ =================================== Language =================================== 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 ENTITY declaration above. ================================================================================ ================================= Limitations ================================== A natural-language statement of the terms and conditions that apply to the specified usage rights. ================================================================================ =========================== Location (version 1.1)============================= An indication of the location somehow relevant to the NewsItem. Type of the location (the nature of its relation to the NewsItem) is specified using the HowPresent attribute that is part of the %assignment; entity (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 ================================================================================ ================================== MediaType =================================== An indication of the media type of a ContentItem. The value of the FormalName attribute is a formal name for the MediaType. Its meaning and permitted values are determined by a controlled vocabulary as described in the comment to the formalname ENTITY declaration above. ================================================================================ =================================== Metadata =================================== An container for a user-defined type of metadata. ================================================================================ =============================== MetadataType =================================== An indication of the type of metadata that is represented by the Property elements within this Metadata element. The value of the FormalName attribute is a formal name for the MetadataType. Its meaning and permitted values are determined by a controlled vocabulary as described in the comment to the formalname ENTITY declaration above. ================================================================================ =================================== MimeType =================================== An indication of the MIME-type of a ContentItem. The value of the FormalName attribute is a formal name for the MimeType. Its meaning and permitted values are determined by a controlled vocabulary as described in the comment to the formalname ENTITY declaration above. ================================================================================ ================================== NameLabel =================================== A string used by human users as a name to help identify a NewsItem. Its form is determined by the provider. It might be identical to the textual content of the SlugLine element, for example, but even if this is so, the system should not process the NameLabel as a slugline. Nothing can be assumed about the nature of the string within NameLabel beyond the fact that it can help to identify the NewsItem to humans. ================================================================================ ================================ NewsComponent ================================= 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 ================================================================================ ================================= NewsEnvelope ================================= Information about the transmission of one or more NewsItems as a NewsML document. ================================================================================ ================================ NewsIdentifier ================================ A globally unique identifier for a NewsItem. ================================================================================ =================================== NewsItem =================================== A managed set of information representing a point of view, at a given time, on some event or events. Its Identification and NewsManagement provide manageability. It may contain either a NewsComponent, or one or more Updates that modify aspects of a previous Revision of the same NewsItem, or a TopicSet. ================================================================================ ================================== NewsItemId ================================== An identifier for the NewsItem. The combination of NewsItemId and 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 NewsItemId to a controlled vocabulary, which is invoked by the Vocabulary attribute. The value ofthe 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. ================================================================================ ================================= 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. ================================================================================ ================================= NewsItemType ================================= An indication of the type of a NewsItem. The value of the FormalName attribute is a formal name for the NewsItemType. Its meaning and permitted values are determined by a controlled vocabulary as described in the comment to the formalname ENTITY declaration above. ================================================================================ =================================== NewsLine =================================== A newsline of a type not included in the NewsML specification. ================================================================================ =================================== NewsLineText =================================== The text of a NewsLine of user-defined type. ================================================================================ ================================ NewsLineType ================================== An indication of a user-defined NewsLine type. The value of the FormalName attribute is a formal name for the NewsLineType. Its meaning and permitted values are determined by a controlled vocabulary as described in the comment to the formalname ENTITY declaration above. ================================================================================ ================================== NewsLines =================================== A container for all the NewsLines that a NewsComponent has. Made an "or" group and ByLineTitle added in version 1.1 ================================================================================ ================================ NewsManagement ================================ Information relevant to the management of a NewsItem. Multiple StatusWillChange introduced in version 1.1 ================================================================================ ==================================== NewsML ==================================== A NewsML document, which must contain a NewsEnvelope and one or more NewsItems, and may include a Catalog element and a TopicSet element. The Version attribute, introduced in version 1.1, is used to signify the version of NewsML that the instance is validated against. It should always be used if the version is above 1.0. ================================================================================ ================================= NewsProduct ================================== An identifier for a product to which all the NewsItems in a NewsML document belong. The value of the FormalName attribute is a formal name for the NewsProduct. Its meaning and permitted values are determined by a controlled vocabulary as described in the comment to the formalname ENTITY declaration above. ================================================================================ ================================= NewsService ================================== An identifier for a service to which all the NewsItems in a NewsML document belong. The value of the FormalName attribute is a formal name for the NewsService. Its meaning and permitted values are determined by a controlled vocabulary as described in the comment to the formalname ENTITY declaration above. ================================================================================ =================================== Notation =================================== An indication of the notation of a ContentItem. The value of the FormalName attribute is a formal name for the Notation. Its meaning and permitted values are determined by a controlled vocabulary as described in the comment to the formalname ENTITY declaration above. ================================================================================ ================================= OfInterestTo ================================= 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 ENTITY declaration above. ================================================================================ ==================================== Origin ==================================== A wrapper for all or part of the text of a piece of text, which provides a pointer to an item of data corresponding formally to what is being described here in natural language. The Href attribute identifies the relevant data, and may be an http URL or a NewsML URN as described in the comment to PublicIdentifier, optionally including a fragment identifier. Alternatively, it can be a simple fragment identifier consisting of a # character followed by the value of the Duid of an element in the current document. ================================================================================ =================================== Party ====================================== An indication of the person, company or organisation that has a particular relationship to this NewsItem in the news workflow. The value of the FormalName attribute is a formal name for the Party. Its meaning and permitted values are determined by a controlled vocabulary as described in the comment to the formalname ENTITY declaration above. 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. The Property child element was added in version 1.1 to eliminate the need for creation of ad-hoc topics for volatile information internal to a NewsML document (eg the name of the person involved in editing of the story, which is usually internal information to the provider). ================================================================================ =================================== Priority =================================== An indication of the priority notation of a NewsItem. The value of the FormalName attribute is a formal name for the Priority. Its meaning and permitted values are determined by a controlled vocabulary as described in the comment to the formalname ENTITY declaration above. ================================================================================ =================================== Property =================================== A property of a NewsItem, NewsComponent, ContentItem, Topic, Location or Party. The property has a name and either a simple Value or a complex value consisting of a set of further properties. The property has a name and either a simple Value or a complex value consisting of a set of further properties. Value ===== A string representation of the value of a Property. ValueRef ======== A pointer to the value of the Property. This might be a Topic in a TopicSet, or any other piece of data. If both Value and ValueRef are provided, then ValueRef identifies the actual value of the property, with Value simply providing a string representation or mnemonic for it. AllowedValues ============= The AllowedValues attribute, if present, is a pointer to a controlled vocabulary that delimits the set of allowed values for the property. This may be an http URL, or a NewsML URN, or a fragment identifier consisting of a # charactger followed by the Duid of an element in the current document. The pointer must reference either a Resource element that designates an external controlled vocabulary, or a TopicSet element, that is itself the controlled vocabulary. AllowedScheme (added in Version 1.1) ============= The AllowedScheme attribute, if present, distinguishes the Scheme in a controlled vocabulary that delimits the set of allowed values for the property. For a match to be obtained within the controlled vocabulary both the AllowedScheme must match the Scheme in the vocabulary and the Value must match the FormalName in the vocabulary. The use of the AllowedScheme attribute serves to indicate that the Value data is drawn from a controlled vocabulary rather that being an uncontrolled entry. ================================================================================ =================================== Provider =================================== An individual and/or company or organisation that released a news object for publication. ================================================================================ ================================== ProviderId ================================== 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. ================================================================================ =============================== PublicIdentifier =============================== 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 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 represented as a % character followed by the sequence of one to six bytes of its UTF-8 encoding, represented in their hexadecimal form. Thus, for example, the space character in a URN would appear as %20, and the % character itself would appear as %25. This mechanism does not cater for all Unicode or UTF-16 characters. Therefore, it is important not to include characters in a NewsItemId that cannot be encoded in UTF-8. 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. ================================================================================ ================================== Relevance =================================== An indication of the relevance of a NewsItem to a given target audience. The value of the FormalName attribute is a formal name for the Relevance. Its meaning and permitted values are determined by a controlled vocabulary as described in the comment to the formalname ENTITY declaration above. ================================================================================ =================================== Replace ==================================== An instruction to replace a designated element within a NewsItem. The element that is to replace the designated element is the content of the Replace element. The NewsItem within which the replacement takes place is the previous revision of the current one, and the element to be replaced is the one whose Duid value is equal to the value of the Replace element's DuidRefattribute. ================================================================================ ================================== Resource ==================================== An indication where a given resource can be found, and whether it is to be used as the default vocabulary for certain formal names within the current subtree of a NewsML document. The Urn attribute provides a NewsML URN for the res urce. THe Url attribute(s) provide(s) a location or locations where the resource may be found. The DefaultVocabularyFor element contains an XPath pattern. The identified resource acts as default vocabulary for any element within the subtree whose root is the parent of the current Catalog, that matches this XPath pattern. ================================================================================ =============================== RevisionHistory ================================ A pointer to a file containing the revision history of the NewsItem. ================================================================================ ================================== RevisionId ================================== 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. ================================================================================ ================================ RevisionStatus ================================ Indicates the status that previous revisions now has as a result of the release of the current revision. The optional Revision attribute is an integer, equal to the RevisionId of the revision in question. If it is not present, then the status applies to ALL previous revisions, without exception. ================================================================================ ================================= RightsHolder ================================= A string of text indicating who has the usage rights, optionally enriched with pointers to further information about the relevant people, companies or organisations. ================================================================================ ================================== RightsLine ================================== A displayable version of rights information. Note that this is distinct from copyright information. Copyright information is about who owns a news object; rights information is about who is allowed to use it, in what way and under what circumstances. ================================================================================ ================================ RightsMetadata ================================ Information about the rights pertaining to a NewsComponent. ================================================================================ ===================================== Role ===================================== 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 ENTITY declaration above. ================================================================================ =================================== SentFrom =================================== An individual and/or company or organisation from whom the NewsML document is being sent. ================================================================================ ==================================== SentTo ==================================== An individual and/or company or organisation to whom the NewsML document is being sent. ================================================================================ ================================== SeriesLine ================================== A displayable version of information about a news object's place in a series. ================================================================================ ================================== SizeInBytes ================================= The exact size in bytes of a ContentItem's inline or referenced data object. ================================================================================ =================================== SlugLine =================================== A string of text, possibly embellished by hyperlinks and/or formatting, used to display a NewsItem's slug line. (Note that the meaning of the term "slug line", and the uses to which it is put, are a matter for individual providers to define within their own workflow and business practice.) ================================================================================ ==================================== Source ==================================== An individual and/or company or organisation that provided source material for a news object. The optional NewsItem attribute must be present in the case of a syndicated NewsItem. It provides the URN of the NewsItem that is being syndicated. Note that a sequence of Source elements can be used to indicate the sequence of syndicators through which a NewsItem has passed. ================================================================================ ================================== StartDate =================================== A natural-language statement of the date at which specified usage rights come into effect. ================================================================================ ==================================== Status =================================== An indication of the Status of a NewsItem. The value of the FormalName attribute is a formal name for the Status. Its meaning and permitted values are determined by a controlled vocabulary as described in the comment to the formalname ENTITY declaration above. ================================================================================ =============================== StatusWillChange =============================== Advance notification of a status change that will automatically occur at the specified date and time. For example, an item with a Status of "embargoed" might have a StatusWillChange element stating that the status will become "usable" at a specified time. This is equivalent to announcing in advance the time at which the embargo will end and the item will be released. ================================================================================ ================================= SubHeadLine ================================== A displayable subsidiary headline. ================================================================================ =================================== Subject ==================================== An indication of the Subject of a NewsItem. The value of the FormalName attribute is a formal name for the Subject. Its meaning and permitted values are determined by a controlled vocabulary as described in the comment to the formalname ENTITY declaration above. ================================================================================ ================================= SubjectCode ================================== 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. ================================================================================ ================================ SubjectDetail ================================= An indication of the SubjectDetail of a NewsItem. The value of the FormalName attribute is a formal name for the SubjectDetail. Its meaning and permitted values are determined by a controlled vocabulary as described in the comment to the formalname ENTITY declaration above. ================================================================================ ================================ SubjectMatter ================================= An indication of the SubjectMatter of a NewsItem. The value of the FormalName attribute is a formal name for the SubjectMatter. Its meaning and permitted values are determined by a controlled vocabulary as described in the comment to the formalname ENTITY declaration above. ================================================================================ =============================== SubjectQualifier =============================== An indication of the SubjectQualifier of a NewsItem. The value of the FormalName attribute is a formal name for the SubjectQualifier. Its meaning and permitted values are determined by a controlled vocabulary as described in the comment to the formalname ENTITY declaration above. ================================================================================ =============================== SystemIdentifier =============================== A system identifier (in the sense defined by the XML 1,0 Specification) for a NewsItem. ================================================================================ ============================= ThisRevisionCreated ============================== The date and, optionally, time at which the current revision of a NewsItem was created, expressed in ISO 8601 Basic Format, as described in the comment to the DateAndTime attribute within the assignment ENTITY declaration above. ================================================================================ ==================================== 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. ================================================================================ =============================== TopicOccurrence ================================ 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. ================================================================================ ================================== TopicSet ==================================== A container for Topics. The value of the FormalName attribute is a formal name for the TopicSet. Its meaning and permitted values are determined by a controlled vocabulary as described in the comment to the formalname ENTITY declaration above. ================================================================================ ================================= TopicSetRef ================================== A pointer to a TopicSet that is to be merged with the current one. The TopicSet attribute is a pointer to the relevant TopicSet. 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 TopicSet in the current document. The presence of a TopicSetRef child in a TopicSet has the effect that all the Topics in the referenced TopicSet are included by reference within the current TopicSet. When this merging results in there exising two FormalName grandchildren of the same TopicSet that have the same content and the same Scheme attribute value, then the Topics whose children are in fact the same topic, and are deemed to be merged. The merging of Topics need not be performed physically by the system, but the meaning of the data is exactly the same as if the merging were actually performed. Merging two Topcis consists of creating a single Topic that contains all the children of both, and eliminating duplicates. ================================================================================ ================================== TopicType =================================== 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 ENTITY declaration above. ================================================================================ ================================== TopicUse ==================================== An indication of where a particular Topic is used in a NewsML document. The value of the Topic attribute must consist of a # character followed by the value of the Duid of a Topic in the current document. The value of the Context attribute is an XPath pattern indicating the context where the referenced topic is used within the subtree to which the current Catalog applies. If the Context attribute is not present, the TopicUse element simply states that this topic is present somewhere in the subtree. ================================================================================ ================================ TransmissionId ================================ An identifier for the NewsML document transmission. This should be unique among all distinct transmissions from the same publisher. If a transmission is repeated (perhaps because the sender is not confident that it was successfully received) then the same TransmissionId content may be used, but a Repeat attribute should be provided to distinguish the second transmission from the first. The form that the value of the Repeat attribute takes is determined by the provider. Likewise, the format for the TransmissionId itself is for the provider to decide. It could for example consist of a channel identifier followed by a sequence number. ================================================================================ ==================================== Update ==================================== A modification to an existing NewsItem. This can be an insertion, replacement or deletion. Note that the Update element cannot be used to modify the NewsManagement or Identification element, or any of their descendants. Modifications to these parts of the NewsItem can be made by issuing the NewsItem under the current revision number, with only the Identification and NewsManagement elements present. These will replace the previous Identification and NewsManagement elements in their totality. ================================================================================ =================================== Urgency ==================================== An indication of the urgency of a NewsItem. The value of the FormalName attribute is a formal name for the Urgency. Its meaning and permitted values are determined by a controlled vocabulary as described in the comment to the formalname ENTITY declaration above. ================================================================================ ===================================== Url ====================================== A URL that can be used to locate a Resource. ================================================================================ ===================================== Urn ====================================== A URN that provides a global identifier for a resource. This will typically (but not necessarily) be a NewsML URN as described in the comment to PublicIdentifier. ================================================================================ ================================= UsageRights ================================== Information about the usage rights pertaining to a NewsComponent. ================================================================================ ================================== UsageType =================================== A natural-language indication of the type of usage to which the rights apply. ================================================================================