|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
===========================================
|
|
Packit Service |
a31ea6 |
NewsML Document Type Definition Version 1.0
|
|
Packit Service |
a31ea6 |
===========================================
|
|
Packit Service |
a31ea6 |
International Press Telecommunications Council
|
|
Packit Service |
a31ea6 |
6 October 2000
|
|
Packit Service |
a31ea6 |
Copyright (c) IPTC, 2000
|
|
Packit Service |
a31ea6 |
All rights reserved
|
|
Packit Service |
a31ea6 |
NewsML is a trademark of IPTC
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
======================================
|
|
Packit Service |
a31ea6 |
DO NOT REMOVE THESE LICENCE CONDITIONS
|
|
Packit Service |
a31ea6 |
======================================
|
|
Packit Service |
a31ea6 |
LICENCE OF THE IPTC NewsML TRADEMARK TO NON-MEMBERS OF THE IPTC
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
Use of the IPTC trademark shall be licensed by the IPTC ("the Licensor") to a
|
|
Packit Service |
a31ea6 |
Non-Member ("the Licensee") in consideration of the following obligations
|
|
Packit Service |
a31ea6 |
undertaken by the Licensee under the terms of this contract.
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
1. The Licensee recognises the Licensor as the sole owner of the intellectual
|
|
Packit Service |
a31ea6 |
property protected by the trademark.
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
2. The Licensee recognises that the Licensor has the right to grant licenses
|
|
Packit Service |
a31ea6 |
of the intellectual property protected by the trademark and has agreed to
|
|
Packit Service |
a31ea6 |
grant such a licence to the Licensee in the terms set out in this contract.
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
3. The Licensee shall not during the subsistence of this contract or at any
|
|
Packit Service |
a31ea6 |
future time register to use in its own name as proprietor any of the
|
|
Packit Service |
a31ea6 |
intellectual property protected by the trademark.
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
4. The Licensee shall not claim any right title or interest in the
|
|
Packit Service |
a31ea6 |
intellectual property or any part of it save as is granted by this contract.
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
5. The Licensee shall immediately call to the attention of the Licensor the use
|
|
Packit Service |
a31ea6 |
of any part of the intellectual property by any third party or any activity
|
|
Packit Service |
a31ea6 |
of any third party which might in the opinion of the Licensee amount to
|
|
Packit Service |
a31ea6 |
infringement of the rights protected by the trademark.
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
6. The Licensee shall not assign the benefit of this contract or grant any
|
|
Packit Service |
a31ea6 |
sub-licence without the prior written consent of the Licensor.
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
7. Use of the IPTC trademark is licensed only to those Licensees who comply
|
|
Packit Service |
a31ea6 |
with the requirements of the official published description of NewsML.
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
8. The Licensee promises to respect the integrity and quality standard of the
|
|
Packit Service |
a31ea6 |
trademark and shall refrain from all acts and omissions which threaten the
|
|
Packit Service |
a31ea6 |
integrity of the trademark as a mark of quality.
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
9. The Licensee shall communicate immediately to the IPTC any instances of
|
|
Packit Service |
a31ea6 |
actual or suspected misuse or non-compliance with the official published
|
|
Packit Service |
a31ea6 |
description of NewsML which come to the attention of the Licensee.
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
10. The Licensee shall, at the request of the IPTC Management Committee acting
|
|
Packit Service |
a31ea6 |
unanimously, accede to any reasonable request of the IPTC to inspect the
|
|
Packit Service |
a31ea6 |
address of the Licensee to verify compliance and each Licensee shall afford
|
|
Packit Service |
a31ea6 |
to the IPTC such assistance as is requested by the IPTC in response to the
|
|
Packit Service |
a31ea6 |
latter's reasonable enquiries in instances of suspected non-compliance with
|
|
Packit Service |
a31ea6 |
the official published description of NewsML requirements.
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
The Licensee shall from time to time provide the IPTC with the full address of
|
|
Packit Service |
a31ea6 |
its place of business and that place will be deemed the Licensee's address.
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
The IPTC reserves the right to terminate the use of the trademark by the
|
|
Packit Service |
a31ea6 |
Licensee at any time without notice or without the need to give reasons to the
|
|
Packit Service |
a31ea6 |
Licensee for such termination.
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
This contract shall be governed and construed in accordance with the laws of
|
|
Packit Service |
a31ea6 |
England and Wales whose courts shall be courts of competent jurisdiction.
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================
|
|
Packit Service |
a31ea6 |
NOTE ON SPELLING
|
|
Packit Service |
a31ea6 |
================
|
|
Packit Service |
a31ea6 |
NewsML element and attribute names use US-English spellings. With this
|
|
Packit Service |
a31ea6 |
exception, this DTD and its accompanying specification use British English
|
|
Packit Service |
a31ea6 |
spellings.
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=============================
|
|
Packit Service |
a31ea6 |
PARAMETER ENTITY DECLARATIONS
|
|
Packit Service |
a31ea6 |
=============================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
Attribute sets
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================== assignment ==================================
|
|
Packit Service |
a31ea6 |
AssignedBy
|
|
Packit Service |
a31ea6 |
==========
|
|
Packit Service |
a31ea6 |
An identifier for the party assigning a piece of metadata. This can be a
|
|
Packit Service |
a31ea6 |
string that designates the party informally (for example, a person's name),
|
|
Packit Service |
a31ea6 |
or a pointer in the form a fragment identifier consisting of a # character
|
|
Packit Service |
a31ea6 |
followed by the Duid of a Topic corresponding to the party.
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
Importance
|
|
Packit Service |
a31ea6 |
==========
|
|
Packit Service |
a31ea6 |
An indication of the importance the party assigning a piece of metadata
|
|
Packit Service |
a31ea6 |
attaches to it. The value of the Importance attribute is a formal name for a
|
|
Packit Service |
a31ea6 |
level of importance. Its meaning and permitted values are determined by a
|
|
Packit Service |
a31ea6 |
controlled vocabulary.
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
Confidence
|
|
Packit Service |
a31ea6 |
==========
|
|
Packit Service |
a31ea6 |
An indication of the confidence with which a piece of metadata has been
|
|
Packit Service |
a31ea6 |
assigned. The value of the Confidence attribute is a formal name for a
|
|
Packit Service |
a31ea6 |
degree of confidence. Its meaning and permitted values are determined by a
|
|
Packit Service |
a31ea6 |
controlled vocabulary.
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
HowPresent
|
|
Packit Service |
a31ea6 |
==========
|
|
Packit Service |
a31ea6 |
An indication of the way in which a piece of metadata applies. The value of
|
|
Packit Service |
a31ea6 |
the HowPresent attribute is a formal name for the way the metadata applies.
|
|
Packit Service |
a31ea6 |
Its meaning and permitted values are determined by a controlled vocabulary.
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
DateAndTime
|
|
Packit Service |
a31ea6 |
===========
|
|
Packit Service |
a31ea6 |
The date and (optionally) time at which a piece of metadata was assigned.
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
Uses the format CCYYMMDDTHHMMSS{+or-}HHMM (century, year, month, day, time
|
|
Packit Service |
a31ea6 |
separator, hours, minutes, seconds, timezone separator, hours, minutes). If
|
|
Packit Service |
a31ea6 |
only the Date is needed, then the substring from T onwards may be omitted.
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
This is the Basic Format defined by ISO 8601. CCYY is a 4-digit year number.
|
|
Packit Service |
a31ea6 |
MM is a 2-digit month number. DD is a 2-digit day number. T is the letter 'T'.
|
|
Packit Service |
a31ea6 |
HH is a 2-digit hour number (using a 24-hour clock). MM is a 2 digit minute
|
|
Packit Service |
a31ea6 |
number. (Note that midnight may be represented as 2400 or 240000 on the date
|
|
Packit Service |
a31ea6 |
of the day that is ending, or as 0000 or 000000 on the date of the day that is
|
|
Packit Service |
a31ea6 |
beginning.)
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
{+or-} is the '+' character or the '-' character, and the following HHMM are
|
|
Packit Service |
a31ea6 |
hours and minutes of offset from Universal Co-ordinated Time (UTC) as defined
|
|
Packit Service |
a31ea6 |
by ISO 8601. If the time is being expressed in UTC, then the timezone offset
|
|
Packit Service |
a31ea6 |
may be '+0000' or '-0000'. If the time is behind UTC, the timezone separator
|
|
Packit Service |
a31ea6 |
is '-'. If the time is ahead of UTC the timezone separator is '+'.
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
Example: 10:27 p.m. in New York on 31 December 2000 would be expressed as
|
|
Packit Service |
a31ea6 |
"20001231T222700-0500" as New York is five hours behind UTC in winter.
|
|
Packit Service |
a31ea6 |
At the same moment in London, the date and time would be expressed as
|
|
Packit Service |
a31ea6 |
time would be expressed as "20010101T032700+0000" or as , "20010101T00+0000", as
|
|
Packit Service |
a31ea6 |
in London, it is now 3:27 a.m. on 1 January 2001. At the same moment in Paris,
|
|
Packit Service |
a31ea6 |
the date and time would be expressed as "20010101T042700+0100", as Paris is one
|
|
Packit Service |
a31ea6 |
hour ahead of UTC in winter, and it is now 4:27 a.m. on 1 January 2001.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
Importance CDATA #IMPLIED
|
|
Packit Service |
a31ea6 |
Confidence CDATA #IMPLIED
|
|
Packit Service |
a31ea6 |
HowPresent CDATA #IMPLIED
|
|
Packit Service |
a31ea6 |
DateAndTime CDATA #IMPLIED">
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================= formalname ===================================
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
FormalName
|
|
Packit Service |
a31ea6 |
==========
|
|
Packit Service |
a31ea6 |
A string of characters whose meaning is determined by a controlled vocabulary.
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
Vocabulary
|
|
Packit Service |
a31ea6 |
==========
|
|
Packit Service |
a31ea6 |
The Vocabulary attribute, if present, provides a pointer to a TopicSet which is
|
|
Packit Service |
a31ea6 |
the controlled vocabulary that can be used to resolve the meaning of the
|
|
Packit Service |
a31ea6 |
FormalName. The value of the Vocabulary attribute is an http URL or a NewsML
|
|
Packit Service |
a31ea6 |
URN, or the # character followed by the value of the Duid attribute of the a
|
|
Packit Service |
a31ea6 |
TopicSet in the current document.
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
If there is no Vocabulary attribute, then the controlled vocabulary to be used
|
|
Packit Service |
a31ea6 |
is located by the following algorithm:
|
|
Packit Service |
a31ea6 |
- Proceed to the parent of the current element.
|
|
Packit Service |
a31ea6 |
- If it has a Catalog element as its immediate child, see whether that Catalog
|
|
Packit Service |
a31ea6 |
contains a Resource element whose DefaultVocabularyFor child contains an XPath
|
|
Packit Service |
a31ea6 |
pattern that is matched by the current element. If so, then the controlled
|
|
Packit Service |
a31ea6 |
vocabulary is the resource identified by that Resource element.
|
|
Packit Service |
a31ea6 |
- If the parent does not meet the above condition, proceed to its parent and
|
|
Packit Service |
a31ea6 |
check the same condition.
|
|
Packit Service |
a31ea6 |
- Continue until a vocabulary is found, or no further parent elements are
|
|
Packit Service |
a31ea6 |
available because the root element has been reached and it too fails to meet
|
|
Packit Service |
a31ea6 |
the condition.
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
If there is no Vocabulary attribute and the above algorithm fails to identify
|
|
Packit Service |
a31ea6 |
a resource that serves as the controlled vocabulary, there is an error, which
|
|
Packit Service |
a31ea6 |
the NewsML system may signal to the user.
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
The NewsML system may also signal an error if a vocabulary is successfully
|
|
Packit Service |
a31ea6 |
identified, but it contains no item that matches the value of the FormalName
|
|
Packit Service |
a31ea6 |
whose meaning is sought.
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
Scheme
|
|
Packit Service |
a31ea6 |
======
|
|
Packit Service |
a31ea6 |
The Scheme attribute, if present, serves to distinguish which of possibly
|
|
Packit Service |
a31ea6 |
multiple naming schemes in the controlled vocabulary is the one that governs
|
|
Packit Service |
a31ea6 |
this FormalName. For a match to be obtained within the controlled vocabulary,
|
|
Packit Service |
a31ea6 |
the rule is that the FormalName and the Scheme must both match. If there is
|
|
Packit Service |
a31ea6 |
no Scheme attribute on the current element, the match will be to an item in
|
|
Packit Service |
a31ea6 |
the vocabulary that has the current formal name and no scheme. If there is a
|
|
Packit Service |
a31ea6 |
Scheme attribute on the current element, then both the formal name and the
|
|
Packit Service |
a31ea6 |
scheme in the controlled vocabulary must match.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
Vocabulary CDATA #IMPLIED
|
|
Packit Service |
a31ea6 |
Scheme CDATA #IMPLIED">
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=================================== localid ====================================
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
Duid
|
|
Packit Service |
a31ea6 |
====
|
|
Packit Service |
a31ea6 |
Duid is a "Document-unique Identifier". It must satisfy the rules for XML ID
|
|
Packit Service |
a31ea6 |
attributes: it must only contain name characters, and it must start with a
|
|
Packit Service |
a31ea6 |
name-start character (not a digit). Its value must be unique within any NewsML
|
|
Packit Service |
a31ea6 |
document.
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
Every NewsML element type has Duid as an optional attribute. Combined with the
|
|
Packit Service |
a31ea6 |
Identifier element, providing a value for the Duid of any element in a NewsML
|
|
Packit Service |
a31ea6 |
document makes the element globally identifiable. The Identifier element gives
|
|
Packit Service |
a31ea6 |
global identification to the document, and the Duid provides local
|
|
Packit Service |
a31ea6 |
identification for the element within the document.
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
Euid
|
|
Packit Service |
a31ea6 |
====
|
|
Packit Service |
a31ea6 |
Euid is an "Element-unique Identifier". Its value must be unique among elements
|
|
Packit Service |
a31ea6 |
of the same element-type and having the same parent element.
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
Use of Euid attribute makes it possible to identify any NewsML element within
|
|
Packit Service |
a31ea6 |
the context of its local branch of the NewsML document tree. This makes it
|
|
Packit Service |
a31ea6 |
possible to copy, or include by reference, subtrees into new combinations in
|
|
Packit Service |
a31ea6 |
ways that would break the uniqueness of Duids (thereby forcing new Duids to be
|
|
Packit Service |
a31ea6 |
allocated), but still being able to retain the identity of each element. If
|
|
Packit Service |
a31ea6 |
Euids are maintained at every level, it is possible to identify, for example
|
|
Packit Service |
a31ea6 |
"The ContentItem whose Euid is abc within the NewsComponent whose Euid is def".
|
|
Packit Service |
a31ea6 |
Such identification patterns would be preserved even after "pruning and
|
|
Packit Service |
a31ea6 |
grafting" of subtrees.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
Euid CDATA #IMPLIED">
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
Content Models
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
===================================== data =====================================
|
|
Packit Service |
a31ea6 |
Where data is included, it may be directly in the form of a DataContent element,
|
|
Packit Service |
a31ea6 |
or in the form of DataContent wrapped in an Encoding element, or by reference
|
|
Packit Service |
a31ea6 |
through an Href attribute, in which case neither a DataContent nor an Encoding
|
|
Packit Service |
a31ea6 |
element will be present.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
| DataContent )?">
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
==================================== party =====================================
|
|
Packit Service |
a31ea6 |
Person, organisation or company playing a specific role in the
|
|
Packit Service |
a31ea6 |
news workflow. The role being played is determined by the parent element. More
|
|
Packit Service |
a31ea6 |
information about it can be provided in the optional Comment subelements.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
, Party+ )">
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=========================
|
|
Packit Service |
a31ea6 |
ELEMENT TYPE DECLARATIONS
|
|
Packit Service |
a31ea6 |
=========================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
============================ AdministrativeMetadata ============================
|
|
Packit Service |
a31ea6 |
Information about the provenance of a NewsComponent.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================ AssociatedWith ================================
|
|
Packit Service |
a31ea6 |
A reference to a NewsItem with which this one is associated (for example, a
|
|
Packit Service |
a31ea6 |
series of articles, or a collection of photos, of which it is a part). The
|
|
Packit Service |
a31ea6 |
NewsItem attribute identifies the relevant NewsItem. Its value can be an
|
|
Packit Service |
a31ea6 |
http URL or a NewsML URN as described in the comment to PublicIdentifier. The
|
|
Packit Service |
a31ea6 |
Comment can be used to indicate the nature of the association.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
NewsItem CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================ BasisForChoice ================================
|
|
Packit Service |
a31ea6 |
The content of this element is an XPath statement or element-type name
|
|
Packit Service |
a31ea6 |
identifying information within each NewsComponent or ContentItem that can be
|
|
Packit Service |
a31ea6 |
used as a basis for choice between equivalent NewsComponents or ContentItems.
|
|
Packit Service |
a31ea6 |
The root of the XPath corresponds to the NewsComponent or ContentItem itself.
|
|
Packit Service |
a31ea6 |
The optional Rank attribute allows providers to place a numerical order on the
|
|
Packit Service |
a31ea6 |
importance they think should be attached to the different bases for choice.
|
|
Packit Service |
a31ea6 |
Smaller numbers represent higher importance.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
Rank CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
==================================== ByLine ====================================
|
|
Packit Service |
a31ea6 |
A natural-language statement of the author/creator information.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
xml:lang CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=================================== Catalog ====================================
|
|
Packit Service |
a31ea6 |
A container for Resource and TopicUse elements. Resource elements map URNs to
|
|
Packit Service |
a31ea6 |
URLs and indicate default vocabularies which apply to the formal names of
|
|
Packit Service |
a31ea6 |
certain elements within the subtree that begins with the immediate parent of
|
|
Packit Service |
a31ea6 |
the Catalog element. TopicUse elements indicate where in the NewsML document
|
|
Packit Service |
a31ea6 |
certain Topics are used. The optional Href attribute provides a pointer to
|
|
Packit Service |
a31ea6 |
a Catalog element elsewhere in this or another document. Its value consists of
|
|
Packit Service |
a31ea6 |
a # character followed by the value of the Duid attribute of the referenced
|
|
Packit Service |
a31ea6 |
Catalog element and preceded, if the referenced Catalog is not in the current
|
|
Packit Service |
a31ea6 |
document, by an http URL or a NewsML URN identifying the document or NewsItem
|
|
Packit Service |
a31ea6 |
in which the Catalog appears. If the Href attribute is present on a Catalog
|
|
Packit Service |
a31ea6 |
element, then that element should be empty. If it contains subelements, the
|
|
Packit Service |
a31ea6 |
NewsML system may signal an error.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
Href CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=============================== Characteristics ================================
|
|
Packit Service |
a31ea6 |
Information about the physical characteristics of a ContentItem.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=================================== Comment ====================================
|
|
Packit Service |
a31ea6 |
A natural-language description of, or statement about, the current element. The
|
|
Packit Service |
a31ea6 |
optional TranslationOf attribute is a pointer to another Comment element, of
|
|
Packit Service |
a31ea6 |
which this one is a direct translation.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
xml:lang CDATA #IMPLIED
|
|
Packit Service |
a31ea6 |
TranslationOf IDREF #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================= ContentItem ==================================
|
|
Packit Service |
a31ea6 |
A news object that carries or identifies content intended for presentation to
|
|
Packit Service |
a31ea6 |
humans.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
Href CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================= Contributor ==================================
|
|
Packit Service |
a31ea6 |
An individual and/or company or organisation that modified or enhanced a news
|
|
Packit Service |
a31ea6 |
object after its creation.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================== Copyright ===================================
|
|
Packit Service |
a31ea6 |
The copyright that pertains to a news object.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%assignment; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================ CopyrightDate =================================
|
|
Packit Service |
a31ea6 |
A natural-language statement of the copyright date.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
xml:lang CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=============================== CopyrightHolder ================================
|
|
Packit Service |
a31ea6 |
A natural-language statement indicating who owns the copyright.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
xml:lang CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================ CopyrightLine =================================
|
|
Packit Service |
a31ea6 |
A natural-language statement of the copyright information.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
xml:lang CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=================================== Creator ====================================
|
|
Packit Service |
a31ea6 |
An individual and/or company or organisation that created a news object.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================== CreditLine ==================================
|
|
Packit Service |
a31ea6 |
A natural-language statement of credit information.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
xml:lang CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================= DataContent ==================================
|
|
Packit Service |
a31ea6 |
The data that carries the content of a ContentItem.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================= DateAndTime ==================================
|
|
Packit Service |
a31ea6 |
A formal representation of a date and, optionally, time, expressed in ISO 8601
|
|
Packit Service |
a31ea6 |
Basic Format, as described in the comment to the DateAndTime attribute within
|
|
Packit Service |
a31ea6 |
the assignment ENTITY declaration above.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
==================================== DateId ====================================
|
|
Packit Service |
a31ea6 |
A date identifier of a NewsItem in short ISO 8601 Basic Format (CCYYMMDD), as
|
|
Packit Service |
a31ea6 |
described in the comment to the DateAndTime attribute within the assignment
|
|
Packit Service |
a31ea6 |
ENTITY declaration above. The DateId is part of the formal identification of the
|
|
Packit Service |
a31ea6 |
NewsItem, and must remain the same through successive revisions of the same
|
|
Packit Service |
a31ea6 |
NewsItem.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================== DateLabel ===================================
|
|
Packit Service |
a31ea6 |
A string representation of a date or date and time, used by human users to help
|
|
Packit Service |
a31ea6 |
identify a NewsItem.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=================================== DateLine ===================================
|
|
Packit Service |
a31ea6 |
A natural-language statement of the date and/or place of creation.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
xml:lang CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
============================ DefaultVocabularyFor ==============================
|
|
Packit Service |
a31ea6 |
An indication that the parent Resource provides the default vocabulary that
|
|
Packit Service |
a31ea6 |
determines the meanings and permitted values of the data occurring in a
|
|
Packit Service |
a31ea6 |
particular part of a NewsML document subtree. The Context attribute is an
|
|
Packit Service |
a31ea6 |
XPath statement identifying the data to which the default vocabulary applies.
|
|
Packit Service |
a31ea6 |
The optional Scheme attribute identifies the relevant naming scheme if the
|
|
Packit Service |
a31ea6 |
Resource contains more than one naming scheme. If the Resource is a NewsML
|
|
Packit Service |
a31ea6 |
TopicSet, then the meaning of the data identified by the Context is provided
|
|
Packit Service |
a31ea6 |
by the Topic whose FormalName subelement matches that data. If the Resource is
|
|
Packit Service |
a31ea6 |
not a NewsML TopicSet, then the way in which it is interpreted in order to
|
|
Packit Service |
a31ea6 |
provide a meaning for the data is not defined by NewsML but by the authority
|
|
Packit Service |
a31ea6 |
that governs whatever format the Resource uses.
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
Example:
|
|
Packit Service |
a31ea6 |
<DescriptiveMetadata>
|
|
Packit Service |
a31ea6 |
<Catalog>
|
|
Packit Service |
a31ea6 |
<Resource Duid="resource1">
|
|
Packit Service |
a31ea6 |
<Urn>urn:newsml:iptc.org:20001006:Ranking:1</Urn>
|
|
Packit Service |
a31ea6 |
<Url>www.iptc.com/vocabularies/iptc-rank.xml</Url>
|
|
Packit Service |
a31ea6 |
<DefaultVocabularyFor Context="@Confidence"/>
|
|
Packit Service |
a31ea6 |
<DefaultVocabularyFor Context="@Importance"/>
|
|
Packit Service |
a31ea6 |
</Resource>
|
|
Packit Service |
a31ea6 |
<Resource Duid="resource2">
|
|
Packit Service |
a31ea6 |
<Urn>urn:newsml:iptc.org:20001006:TopicTypes:1</Urn>
|
|
Packit Service |
a31ea6 |
<Url>www.iptc.com/vocabularies/iptc-topictype.xml</Url>
|
|
Packit Service |
a31ea6 |
<DefaultVocabularyFor Context="TopicType@FormalName"/>
|
|
Packit Service |
a31ea6 |
</Resource>
|
|
Packit Service |
a31ea6 |
</Catalog>
|
|
Packit Service |
a31ea6 |
<TopicSet>
|
|
Packit Service |
a31ea6 |
<Topic Duid="topic1">
|
|
Packit Service |
a31ea6 |
<TopicType FormalName="Person">
|
|
Packit Service |
a31ea6 |
<Description Variant="Name">Bill Clinton</Description>
|
|
Packit Service |
a31ea6 |
<Description Variant="Position">President of the USA</Description>
|
|
Packit Service |
a31ea6 |
</Topic>
|
|
Packit Service |
a31ea6 |
</TopicSet>
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
AssignedBy="Desk Editor"
|
|
Packit Service |
a31ea6 |
Confidence="High"
|
|
Packit Service |
a31ea6 |
HowPresent="principal subject"
|
|
Packit Service |
a31ea6 |
Topic="#topic1"/>
|
|
Packit Service |
a31ea6 |
</DescriptiveMetadata>
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
Context CDATA #REQUIRED
|
|
Packit Service |
a31ea6 |
Scheme CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
==================================== Delete ====================================
|
|
Packit Service |
a31ea6 |
An instruction to delete an element within a NewsItem. The NewsItem is
|
|
Packit Service |
a31ea6 |
the previous revision of the current one, and the element to be deleted is the
|
|
Packit Service |
a31ea6 |
one whose Duid value is equal to the value of the Delete element's DuidRef
|
|
Packit Service |
a31ea6 |
attribute.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
DuidRef CDATA #REQUIRED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================= DerivedFrom ==================================
|
|
Packit Service |
a31ea6 |
A reference to an NewsItem from which this one is derived. The NewsItem attribute
|
|
Packit Service |
a31ea6 |
identifies the relevant NewsItem. Its value can be an http URL or a NewsML URN
|
|
Packit Service |
a31ea6 |
as described in the comment to PublicIdentifier.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
NewsItem CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================= Description ==================================
|
|
Packit Service |
a31ea6 |
A description that identifies a Topic, thereby indicating the meaning of a
|
|
Packit Service |
a31ea6 |
formal name associated with that Topic. The xml:lang attribute indicates what
|
|
Packit Service |
a31ea6 |
language the description is in. The optional Variant attribute allows multiple
|
|
Packit Service |
a31ea6 |
descriptions to be given in the same language, and meaningfully distinguished
|
|
Packit Service |
a31ea6 |
from one another.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
xml:lang CDATA #IMPLIED
|
|
Packit Service |
a31ea6 |
Variant CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
============================= DescriptiveMetadata ==============================
|
|
Packit Service |
a31ea6 |
Information describing the content of a NewsComponent.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%assignment; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=================================== Encoding ===================================
|
|
Packit Service |
a31ea6 |
The encoding of the data comprising the content of a ContentItem.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
Notation CDATA #REQUIRED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=================================== EndDate ====================================
|
|
Packit Service |
a31ea6 |
A natural-language statement of the date at which specified usage rights come
|
|
Packit Service |
a31ea6 |
to an end.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
xml:lang CDATA #IMPLIED
|
|
Packit Service |
a31ea6 |
%assignment; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=================================== FileName ===================================
|
|
Packit Service |
a31ea6 |
The suggested or actual storage file name for a NewsItem.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================= FirstCreated =================================
|
|
Packit Service |
a31ea6 |
The date and, optionally, time at which a NewsItem was first created, expressed
|
|
Packit Service |
a31ea6 |
in ISO 8601 Basic Format, as described in the comment to the DateAndTime
|
|
Packit Service |
a31ea6 |
attribute within the assignment ENTITY declaration above.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================= FormalName ===================================
|
|
Packit Service |
a31ea6 |
A string of characters whose meaning is determined by a naming scheme within a
|
|
Packit Service |
a31ea6 |
controlled vocabulary. The controlled vocabulary may (but is not required to)
|
|
Packit Service |
a31ea6 |
take the form of a NewsML TopicSet. The optional Scheme attribute determines
|
|
Packit Service |
a31ea6 |
which naming scheme applies, when several exist within the same controlled
|
|
Packit Service |
a31ea6 |
vocabulary.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
Scheme CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
==================================== Format ====================================
|
|
Packit Service |
a31ea6 |
An indication of the format of a ContentItem. The value of the FormalName
|
|
Packit Service |
a31ea6 |
attribute is a formal name for the Format. Its meaning and permitted values are
|
|
Packit Service |
a31ea6 |
determined by a controlled vocabulary as described in the comment to the
|
|
Packit Service |
a31ea6 |
formalname ENTITY declaration above.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%formalname; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================= FutureStatus =================================
|
|
Packit Service |
a31ea6 |
An indication of the status a NewsItem will have at a specified future date. The
|
|
Packit Service |
a31ea6 |
value of the FormalName attribute is a formal name for the FutureStatus. Its
|
|
Packit Service |
a31ea6 |
meaning is determined by a controlled vocabulary as described in the comment
|
|
Packit Service |
a31ea6 |
to the formalname ENTITY declaration above.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%formalname; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
==================================== Genre =====================================
|
|
Packit Service |
a31ea6 |
An indication of the Genre of a NewsComponent. The value of the FormalName
|
|
Packit Service |
a31ea6 |
attribute is a formal name for the Genre. Its meaning and permitted values are
|
|
Packit Service |
a31ea6 |
determined by a controlled vocabulary as described in the comment to the
|
|
Packit Service |
a31ea6 |
formalname ENTITY declaration above.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%formalname;
|
|
Packit Service |
a31ea6 |
%assignment; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================== Geography ===================================
|
|
Packit Service |
a31ea6 |
A natural-language statement of the geographical area or areas to which
|
|
Packit Service |
a31ea6 |
specified usage rights apply.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
xml:lang CDATA #IMPLIED
|
|
Packit Service |
a31ea6 |
%assignment; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=================================== HeadLine ===================================
|
|
Packit Service |
a31ea6 |
A displayable headline.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
xml:lang CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================ Identification ================================
|
|
Packit Service |
a31ea6 |
Identification information for the NewsItem.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================= InsertAfter ==================================
|
|
Packit Service |
a31ea6 |
An instruction to insert content after a designated element within a NewsItem.
|
|
Packit Service |
a31ea6 |
The content to be inserted is the content of the InsertAfter element. The
|
|
Packit Service |
a31ea6 |
NewsItem into which it is to be inserted is the previous revision of the current
|
|
Packit Service |
a31ea6 |
one, and the element after which it is to be inserted is the one whose Duid
|
|
Packit Service |
a31ea6 |
value is equal to the value of the InsertAfter element's DuidRef attribute.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
DuidRef CDATA #REQUIRED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================= InsertBefore =================================
|
|
Packit Service |
a31ea6 |
An instruction to insert content before a designated element within a NewsItem.
|
|
Packit Service |
a31ea6 |
The content to be inserted is the content of the InsertBefore element. The
|
|
Packit Service |
a31ea6 |
NewsItem into which it is to be inserted is the previous revision of the current
|
|
Packit Service |
a31ea6 |
one, and the element before which it is to be inserted is the one whose Duid
|
|
Packit Service |
a31ea6 |
value is equal to the value of the InsertBefore element's DuidRef attribute.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
DuidRef CDATA #REQUIRED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================= Instruction ==================================
|
|
Packit Service |
a31ea6 |
An instruction from a news provider to the recipient of a NewsItem. A special
|
|
Packit Service |
a31ea6 |
case of Instruction is an indication of the effect the current revision of a
|
|
Packit Service |
a31ea6 |
NewsItem has on the status of any previous revisions of the NewsItem that may
|
|
Packit Service |
a31ea6 |
still be on the recipient's system. In this case, it will contain one or more
|
|
Packit Service |
a31ea6 |
RevisionStatus elements. Otherwise, the value of the FormalName attribute is a
|
|
Packit Service |
a31ea6 |
formal name for the Instruction, and its meaning is determined by a controlled
|
|
Packit Service |
a31ea6 |
vocabulary as described in the comment to the formalname ENTITY declaration
|
|
Packit Service |
a31ea6 |
above.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%formalname; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================= KeywordLine ==================================
|
|
Packit Service |
a31ea6 |
A displayable set of keywords relevant to a news object. This can be used by a
|
|
Packit Service |
a31ea6 |
NewsML system to assist manual or automated searches.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
xml:lang CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
==================================== Label =====================================
|
|
Packit Service |
a31ea6 |
A human-readable label for a NewsItem.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=================================== LabelText ==================================
|
|
Packit Service |
a31ea6 |
The text that constitutes a Label of a given LabelType.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================= LabelType ====================================
|
|
Packit Service |
a31ea6 |
A user-defined type of label. The value of the FormalName attribute is a formal
|
|
Packit Service |
a31ea6 |
name for the LabelType. Its meaning and permitted values are determined by a
|
|
Packit Service |
a31ea6 |
controlled vocabulary as described in the comment to the formalname ENTITY
|
|
Packit Service |
a31ea6 |
declaration above.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%formalname; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=================================== Language ===================================
|
|
Packit Service |
a31ea6 |
An indication of the, or a, language used in a content item. The value of the
|
|
Packit Service |
a31ea6 |
FormalName attribute is a formal name for the Language. Its meaning and
|
|
Packit Service |
a31ea6 |
permitted values are determined by a controlled vocabulary as described in the
|
|
Packit Service |
a31ea6 |
comment to the formalname ENTITY declaration above.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%formalname;
|
|
Packit Service |
a31ea6 |
%assignment; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================= Limitations ==================================
|
|
Packit Service |
a31ea6 |
A natural-language statement of the terms and conditions that apply to the
|
|
Packit Service |
a31ea6 |
specified usage rights.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
xml:lang CDATA #IMPLIED
|
|
Packit Service |
a31ea6 |
%assignment; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================== MediaType ===================================
|
|
Packit Service |
a31ea6 |
An indication of the media type of a ContentItem. The value of the FormalName
|
|
Packit Service |
a31ea6 |
attribute is a formal name for the MediaType. Its meaning and permitted values
|
|
Packit Service |
a31ea6 |
are determined by a controlled vocabulary as described in the comment to the
|
|
Packit Service |
a31ea6 |
formalname ENTITY declaration above.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%formalname; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=================================== Metadata ===================================
|
|
Packit Service |
a31ea6 |
An container for a user-defined type of metadata.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=============================== MetadataType ===================================
|
|
Packit Service |
a31ea6 |
An indication of the type of metadata that is represented by the Property
|
|
Packit Service |
a31ea6 |
elements within this Metadata element. The value of the FormalName attribute is
|
|
Packit Service |
a31ea6 |
a formal name for the MetadataType. Its meaning and permitted values are
|
|
Packit Service |
a31ea6 |
determined by a controlled vocabulary as described in the comment to the
|
|
Packit Service |
a31ea6 |
formalname ENTITY declaration above.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%formalname; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=================================== MimeType ===================================
|
|
Packit Service |
a31ea6 |
An indication of the MIME-type of a ContentItem. The value of the FormalName
|
|
Packit Service |
a31ea6 |
attribute is a formal name for the MimeType. Its meaning and permitted values
|
|
Packit Service |
a31ea6 |
are determined by a controlled vocabulary as described in the comment to the
|
|
Packit Service |
a31ea6 |
formalname ENTITY declaration above.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%formalname; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================== NameLabel ===================================
|
|
Packit Service |
a31ea6 |
A string used by human users as a name to help identify a NewsItem. Its form is
|
|
Packit Service |
a31ea6 |
determined by the provider. It might be identical to the textual content of
|
|
Packit Service |
a31ea6 |
the SlugLine element, for example, but even if this is so, the system should not
|
|
Packit Service |
a31ea6 |
process the NameLabel as a slugline. Nothing can be assumed about the nature of
|
|
Packit Service |
a31ea6 |
the string within NameLabel beyond the fact that it can help to identify the
|
|
Packit Service |
a31ea6 |
NewsItem to humans.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================ NewsComponent =================================
|
|
Packit Service |
a31ea6 |
A container for news objects, used to identify the role of news objects in
|
|
Packit Service |
a31ea6 |
relation to one another, and to ascribe metadata to them. The Essential
|
|
Packit Service |
a31ea6 |
attribute indicates whether the provider considers that this NewsComponent
|
|
Packit Service |
a31ea6 |
is essential to the meaning of the NewsComponent within which it is contained.
|
|
Packit Service |
a31ea6 |
The EquivalentsList attribute indicates whether or not the NewsItems or
|
|
Packit Service |
a31ea6 |
NewsItemRefs, NewsComponents or ContentItems contained within this one are
|
|
Packit Service |
a31ea6 |
equivalent to one another in content and/or meaning
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
Essential (yes | no ) 'no'
|
|
Packit Service |
a31ea6 |
EquivalentsList (yes | no ) 'no'
|
|
Packit Service |
a31ea6 |
xml:lang CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================= NewsEnvelope =================================
|
|
Packit Service |
a31ea6 |
Information about the transmission of one or more NewsItems as a NewsML
|
|
Packit Service |
a31ea6 |
document.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================ NewsIdentifier ================================
|
|
Packit Service |
a31ea6 |
A globally unique identifier for a NewsItem.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=================================== NewsItem ===================================
|
|
Packit Service |
a31ea6 |
A managed set of information representing a point of view, at a given time, on
|
|
Packit Service |
a31ea6 |
some event or events. Its Identification and NewsManagement provide
|
|
Packit Service |
a31ea6 |
manageability. It may contain either a NewsComponent, or one or more Updates
|
|
Packit Service |
a31ea6 |
that modify aspects of a previous Revision of the same NewsItem, or a
|
|
Packit Service |
a31ea6 |
TopicSet.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
xml:lang CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================== NewsItemId ==================================
|
|
Packit Service |
a31ea6 |
An identifier for the NewsItem. The combination of NewsItemId and DateId must
|
|
Packit Service |
a31ea6 |
be unique among NewsItems that emanate from the same provider. Within these
|
|
Packit Service |
a31ea6 |
constraints, the NewsItemId can take any form the provider wishes. It may take
|
|
Packit Service |
a31ea6 |
the form of a name for the NewsItem that will be meaningful to humans, but this
|
|
Packit Service |
a31ea6 |
is not a requirement. The provider may optionally relate the values of
|
|
Packit Service |
a31ea6 |
NewsItemId to a controlled vocabulary, which is invoked by the Vocabulary
|
|
Packit Service |
a31ea6 |
attribute. The value ofthe Vocabulary attribute may be an http URL, a NewsML
|
|
Packit Service |
a31ea6 |
URN, or the # character followed by the value of the Duid attribute of a
|
|
Packit Service |
a31ea6 |
TopicSet in the current document. The Scheme attribute, if present, serves to
|
|
Packit Service |
a31ea6 |
distinguish which of possibly multiple naming schemes in the controlled
|
|
Packit Service |
a31ea6 |
vocabulary is the one that governs the NewsItemId.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
Scheme CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================= NewsItemRef ==================================
|
|
Packit Service |
a31ea6 |
A pointer to a NewsItem that is deemed to replace the NewsItemRef element. The
|
|
Packit Service |
a31ea6 |
NewsItem attribute is a pointer to the relevant NewsItem. Its value can be an
|
|
Packit Service |
a31ea6 |
http URL, or a NewsML URN as described in the comment to PublicIdentifier, or a
|
|
Packit Service |
a31ea6 |
fragment identifier consisting of a # character followed by the Duid of a
|
|
Packit Service |
a31ea6 |
NewsItem in the current document.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
NewsItem CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================= NewsItemType =================================
|
|
Packit Service |
a31ea6 |
An indication of the type of a NewsItem. The value of the FormalName attribute
|
|
Packit Service |
a31ea6 |
is a formal name for the NewsItemType. Its meaning and permitted values are
|
|
Packit Service |
a31ea6 |
determined by a controlled vocabulary as described in the comment to the
|
|
Packit Service |
a31ea6 |
formalname ENTITY declaration above.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%formalname; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=================================== NewsLine ===================================
|
|
Packit Service |
a31ea6 |
A newsline of a type not included in the NewsML specification.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=================================== NewsLineText ===================================
|
|
Packit Service |
a31ea6 |
The text of a NewsLine of user-defined type.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
xml:lang CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================ NewsLineType ==================================
|
|
Packit Service |
a31ea6 |
An indication of a user-defined NewsLine type. The value of the FormalName
|
|
Packit Service |
a31ea6 |
attribute is a formal name for the NewsLineType. Its meaning and permitted
|
|
Packit Service |
a31ea6 |
values are determined by a controlled vocabulary as described in the comment
|
|
Packit Service |
a31ea6 |
to the formalname ENTITY declaration above.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%formalname; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================== NewsLines ===================================
|
|
Packit Service |
a31ea6 |
A container for all the NewsLines that a NewsComponent has.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================ NewsManagement ================================
|
|
Packit Service |
a31ea6 |
Information relevant to the management of a NewsItem.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
==================================== NewsML ====================================
|
|
Packit Service |
a31ea6 |
A NewsML document, which must contain a NewsEnvelope and one or more NewsItems,
|
|
Packit Service |
a31ea6 |
and may include a Catalog element and a TopicSet element.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================= NewsProduct ==================================
|
|
Packit Service |
a31ea6 |
An identifier for a product to which all the NewsItems in a NewsML document
|
|
Packit Service |
a31ea6 |
belong. The value of the FormalName attribute is a formal name for the
|
|
Packit Service |
a31ea6 |
NewsProduct. Its meaning and permitted values are determined by a controlled
|
|
Packit Service |
a31ea6 |
vocabulary as described in the comment to the formalname ENTITY declaration
|
|
Packit Service |
a31ea6 |
above.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%formalname; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================= NewsService ==================================
|
|
Packit Service |
a31ea6 |
An identifier for a service to which all the NewsItems in a NewsML document
|
|
Packit Service |
a31ea6 |
belong. The value of the FormalName attribute is a formal name for the
|
|
Packit Service |
a31ea6 |
NewsService. Its meaning and permitted values are determined by a controlled
|
|
Packit Service |
a31ea6 |
vocabulary as described in the comment to the formalname ENTITY declaration
|
|
Packit Service |
a31ea6 |
above.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%formalname; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=================================== Notation ===================================
|
|
Packit Service |
a31ea6 |
An indication of the notation of a ContentItem. The value of the FormalName
|
|
Packit Service |
a31ea6 |
attribute is a formal name for the Notation. Its meaning and permitted values
|
|
Packit Service |
a31ea6 |
are determined by a controlled vocabulary as described in the comment to the
|
|
Packit Service |
a31ea6 |
formalname ENTITY declaration above.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%formalname; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================= OfInterestTo =================================
|
|
Packit Service |
a31ea6 |
An indication of the target audience of a NewsItem. The value of the FormalName
|
|
Packit Service |
a31ea6 |
attribute is a formal name for the target audience. Its meaning and permitted
|
|
Packit Service |
a31ea6 |
values are determined by a controlled vocabulary as described in the comment to
|
|
Packit Service |
a31ea6 |
the formalname ENTITY declaration above.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%formalname;
|
|
Packit Service |
a31ea6 |
%assignment; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
==================================== Origin ====================================
|
|
Packit Service |
a31ea6 |
A wrapper for all or part of the text of a piece of text, which provides a
|
|
Packit Service |
a31ea6 |
pointer to an item of data corresponding formally to what is being described
|
|
Packit Service |
a31ea6 |
here in natural language. The Href attribute identifies the relevant data, and
|
|
Packit Service |
a31ea6 |
may be an http URL or a NewsML URN as described in the comment to
|
|
Packit Service |
a31ea6 |
PublicIdentifier, optionally including a fragment identifier. Alternatively, it
|
|
Packit Service |
a31ea6 |
can be a simple fragment identifier consisting of a # character followed by the
|
|
Packit Service |
a31ea6 |
value of the Duid of an element in the current document.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%assignment;
|
|
Packit Service |
a31ea6 |
Href CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=================================== Party ======================================
|
|
Packit Service |
a31ea6 |
An indication of the person, company or organisation that has a particular
|
|
Packit Service |
a31ea6 |
relationship to this NewsItem in the news workflow. The value of the FormalName
|
|
Packit Service |
a31ea6 |
attribute is a formal name for the Party. Its meaning and permitted values
|
|
Packit Service |
a31ea6 |
are determined by a controlled vocabulary as described in the comment to the
|
|
Packit Service |
a31ea6 |
formalname ENTITY declaration above.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%formalname;
|
|
Packit Service |
a31ea6 |
Topic CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=================================== Priority ===================================
|
|
Packit Service |
a31ea6 |
An indication of the priority notation of a NewsItem. The value of the
|
|
Packit Service |
a31ea6 |
FormalName attribute is a formal name for the Priority. Its meaning and
|
|
Packit Service |
a31ea6 |
permitted values are determined by a controlled vocabulary as described in
|
|
Packit Service |
a31ea6 |
the comment to the formalname ENTITY declaration above.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%formalname; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=================================== Property ===================================
|
|
Packit Service |
a31ea6 |
A property of a NewsComponent or of a Topic. The property has a name and either
|
|
Packit Service |
a31ea6 |
a simple Value or a complex value consisting of a set of further properties.
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
Value
|
|
Packit Service |
a31ea6 |
=====
|
|
Packit Service |
a31ea6 |
A string representation of the value of a Property.
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
ValueRef
|
|
Packit Service |
a31ea6 |
========
|
|
Packit Service |
a31ea6 |
A pointer to the value of the Property. This might be a Topic in a TopicSet, or
|
|
Packit Service |
a31ea6 |
any other piece of data. If both Value and ValueRef are provided, then ValueRef
|
|
Packit Service |
a31ea6 |
identifies the actual value of the property, with Value simply providing a
|
|
Packit Service |
a31ea6 |
string representation or mnemonic for it.
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
Example:
|
|
Packit Service |
a31ea6 |
<Catalog>
|
|
Packit Service |
a31ea6 |
<Resource Duid="resource1">
|
|
Packit Service |
a31ea6 |
<Urn>urn:newsml:reuters.com:20001001:Physical Characteristics:3</Urn>
|
|
Packit Service |
a31ea6 |
<Url>www.reuters.com/vocabs/physical.xml</Url>
|
|
Packit Service |
a31ea6 |
<Url>www.iptc.com/vocabularies/memberdefined/reuters/physical.xml</Url>
|
|
Packit Service |
a31ea6 |
<DefaultVocabularyFor Scheme="short" Context="Metadata/Property[@FormalName='Width']"/>
|
|
Packit Service |
a31ea6 |
</Resource>
|
|
Packit Service |
a31ea6 |
</Catalog>
|
|
Packit Service |
a31ea6 |
<Property FormalName="Width" Vocabulary="#resource1">
|
|
Packit Service |
a31ea6 |
<Property FormalName="Unit" ValueRef="urn:newsml:iptc.org:20001006:units:1#cm"/>
|
|
Packit Service |
a31ea6 |
<Property FormalName="Quantity" Value="7.5"/>
|
|
Packit Service |
a31ea6 |
</Property>
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
AllowedValues
|
|
Packit Service |
a31ea6 |
=============
|
|
Packit Service |
a31ea6 |
The AllowedValues attribute, if present, is a pointer to a controlled vocabulary
|
|
Packit Service |
a31ea6 |
that delimits the set of allowed values for the property. This may be an http
|
|
Packit Service |
a31ea6 |
URL, or a NewsML URN, or a fragment identifier consisting of a # charactger
|
|
Packit Service |
a31ea6 |
followed by the Duid of an element in the current document. The pointer must
|
|
Packit Service |
a31ea6 |
reference either a Resource element that designates an external controlled
|
|
Packit Service |
a31ea6 |
vocabulary, or a TopicSet element, that is itself the controlled vocabulary.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%formalname;
|
|
Packit Service |
a31ea6 |
%assignment;
|
|
Packit Service |
a31ea6 |
Value CDATA #IMPLIED
|
|
Packit Service |
a31ea6 |
ValueRef CDATA #IMPLIED
|
|
Packit Service |
a31ea6 |
AllowedValues CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=================================== Provider ===================================
|
|
Packit Service |
a31ea6 |
An individual and/or company or organisation that released a news object for
|
|
Packit Service |
a31ea6 |
publication.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================== ProviderId ==================================
|
|
Packit Service |
a31ea6 |
An identifier for the news provider that produced the NewsItem. The
|
|
Packit Service |
a31ea6 |
provider's ID is specified in the element content. This should be an Internet
|
|
Packit Service |
a31ea6 |
domain name that is owned by the provider at the date identified by the DateId
|
|
Packit Service |
a31ea6 |
subelement of the NewsIdentifier, or the name for the Provider drawn from a
|
|
Packit Service |
a31ea6 |
controlled vocabulary identified by a URN specified in the Vocabulary attribute.
|
|
Packit Service |
a31ea6 |
This will ensure that the identity of the provider can be inferred unambiguously
|
|
Packit Service |
a31ea6 |
from the full NewsIdentifier.
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
Example:
|
|
Packit Service |
a31ea6 |
<NewsIdentifier>
|
|
Packit Service |
a31ea6 |
<ProviderId>iptc.org</ProviderId>
|
|
Packit Service |
a31ea6 |
<DateId>20001001</DateId>
|
|
Packit Service |
a31ea6 |
<NewsItemId>NewsML version 1.0</NewsItemId>
|
|
Packit Service |
a31ea6 |
<RevisionId>1
|
|
Packit Service |
a31ea6 |
</NewsIdentifier>
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
Because the domain name "iptc.org" was owned on 1 October 2000 by the
|
|
Packit Service |
a31ea6 |
International Press Telecommunications Council (IPTC) and no-one else, it is
|
|
Packit Service |
a31ea6 |
certain that IPTC is the provider in this case.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=============================== PublicIdentifier ===============================
|
|
Packit Service |
a31ea6 |
A public identifier (in the sense defined by the XML 1,0 Specification) for a
|
|
Packit Service |
a31ea6 |
NewsItem. This is the NewsML URN, and must be constructed as follows:
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
If the ProviderId is a domain name
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
urn:newsml:{ProviderId}:{DateId}:{NewsItemId}:{RevisionId}{RevisionId@Update}
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
If the ProviderId is name drawn from a controlled vocabulary
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
urn:newsml:|{ProviderId@Vocabulary}|{ProviderId}|:{DateId}:{NewsItemId}:{RevisionId}{RevisionId@Update}
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
where {x} means "the content of the x subelement of the NewsIdentifier" and
|
|
Packit Service |
a31ea6 |
{x@y} means "the value of the y attribute of the x subelement of the
|
|
Packit Service |
a31ea6 |
NewsIdentifier", with the exception that if the Update attribute of the
|
|
Packit Service |
a31ea6 |
RevisionId element has its default value of N, it is omitted from the URN, and
|
|
Packit Service |
a31ea6 |
that the Vocabulary attribute of the ProviderId element is stripped of the
|
|
Packit Service |
a31ea6 |
substring "urn:" with which it begins. The Vocabulary attribute of ProviderId
|
|
Packit Service |
a31ea6 |
necessarily begins with the characters "urn:" because, as stated in the
|
|
Packit Service |
a31ea6 |
comment to the ProviderId element above, it must take the form of a URN
|
|
Packit Service |
a31ea6 |
identifying a controlled vocabulary.
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
Note that the existence of this URN enables the NewsItem to be referenced
|
|
Packit Service |
a31ea6 |
unambiguously by pointers from other XML elements or resources. Within such
|
|
Packit Service |
a31ea6 |
pointers, if the RevisionId, its preceding : character and its following Update
|
|
Packit Service |
a31ea6 |
qualifier are omitted, then the pointer designates the most recent revision at
|
|
Packit Service |
a31ea6 |
the time it is resolved.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================== Relevance ===================================
|
|
Packit Service |
a31ea6 |
An indication of the relevance of a NewsItem to a given target audience. The
|
|
Packit Service |
a31ea6 |
value of the FormalName attribute is a formal name for the Relevance. Its
|
|
Packit Service |
a31ea6 |
meaning and permitted values are determined by a controlled vocabulary as
|
|
Packit Service |
a31ea6 |
described in the comment to the formalname ENTITY declaration above.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%formalname;
|
|
Packit Service |
a31ea6 |
%assignment; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=================================== Replace ====================================
|
|
Packit Service |
a31ea6 |
An instruction to replace a designated element within a NewsItem. The element
|
|
Packit Service |
a31ea6 |
that is to replace the designated element is the content of the Replace element.
|
|
Packit Service |
a31ea6 |
The NewsItem within which the replacement takes place is the previous revision
|
|
Packit Service |
a31ea6 |
of the current one, and the element to be replaced is the one whose Duid
|
|
Packit Service |
a31ea6 |
value is equal to the value of the Replace element's DuidRef attribute.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
DuidRef CDATA #REQUIRED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================== Resource ====================================
|
|
Packit Service |
a31ea6 |
An indication where a given resource can be found, and whether it is to be used
|
|
Packit Service |
a31ea6 |
as the default vocabulary for certain formal names within the current subtree
|
|
Packit Service |
a31ea6 |
of a NewsML document. The Urn attribute provides a NewsML URN for the resource.
|
|
Packit Service |
a31ea6 |
THe Url attribute(s) provide(s) a location or locations where the resource may
|
|
Packit Service |
a31ea6 |
be found. The DefaultVocabularyFor element contains an XPath pattern. The
|
|
Packit Service |
a31ea6 |
identified resource acts as default vocabulary for any element within the
|
|
Packit Service |
a31ea6 |
subtree whose root is the parent of the current Catalog, that matches this XPath
|
|
Packit Service |
a31ea6 |
pattern.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=============================== RevisionHistory ================================
|
|
Packit Service |
a31ea6 |
A pointer to a file containing the revision history of the NewsItem.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
Href CDATA #REQUIRED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================== RevisionId ==================================
|
|
Packit Service |
a31ea6 |
A positive integer indicating which Revision of a given NewsItem this is. Any
|
|
Packit Service |
a31ea6 |
positive integer may be used, but it must always be the case that of two
|
|
Packit Service |
a31ea6 |
instances of a NewsItem that have the same ProviderId, DateId and NewsItemId,
|
|
Packit Service |
a31ea6 |
the one whose RevisionId has the larger value must be the more recent revision.
|
|
Packit Service |
a31ea6 |
A RevisionId of 0 is not permitted. The PreviousRevision attribute must be
|
|
Packit Service |
a31ea6 |
present, and its value must be equal to the content of the RevisionId element
|
|
Packit Service |
a31ea6 |
of the NewsItem's previous revision, if there is one, and 0 if the NewsItem has
|
|
Packit Service |
a31ea6 |
no previous revision. If the NewsItem contains an Update element or elements,
|
|
Packit Service |
a31ea6 |
then the Update attribute must be set to U. If the NewsItem consists only of a
|
|
Packit Service |
a31ea6 |
replacement set of NewsManagement data, then the Update attribute must be set
|
|
Packit Service |
a31ea6 |
to A. If neither of these is the case, then the Update attribute must be set
|
|
Packit Service |
a31ea6 |
to N.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
Update CDATA #REQUIRED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================ RevisionStatus ================================
|
|
Packit Service |
a31ea6 |
Indicates the status that previous revisions now has as a result of the release
|
|
Packit Service |
a31ea6 |
of the current revision. The optional Revision attribute is an integer, equal to
|
|
Packit Service |
a31ea6 |
the RevisionId of the revision in question. If it is not present, then the
|
|
Packit Service |
a31ea6 |
status applies to ALL previous revisions, without exception.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
Revision CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================= RightsHolder =================================
|
|
Packit Service |
a31ea6 |
A string of text indicating who has the usage rights, optionally enriched with
|
|
Packit Service |
a31ea6 |
pointers to further information about the relevant people, companies or
|
|
Packit Service |
a31ea6 |
organisations.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
xml:lang CDATA #IMPLIED
|
|
Packit Service |
a31ea6 |
%assignment; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================== RightsLine ==================================
|
|
Packit Service |
a31ea6 |
A displayable version of rights information. Note that this is distinct from
|
|
Packit Service |
a31ea6 |
copyright information. Copyright information is about who owns a news object;
|
|
Packit Service |
a31ea6 |
rights information is about who is allowed to use it, in what way and under
|
|
Packit Service |
a31ea6 |
what circumstances.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
xml:lang CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================ RightsMetadata ================================
|
|
Packit Service |
a31ea6 |
Information about the rights pertaining to a NewsComponent.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%assignment; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
===================================== Role =====================================
|
|
Packit Service |
a31ea6 |
An identifier of the role played by a NewsComponent within a NewsComponent
|
|
Packit Service |
a31ea6 |
that contains it. The outermost NewsComponent within a NewsItem need not
|
|
Packit Service |
a31ea6 |
specify a Role attribute value. The value of the FormalName attribute is a
|
|
Packit Service |
a31ea6 |
formal name for the Role. Its meaning and permitted values are determined by
|
|
Packit Service |
a31ea6 |
a controlled vocabulary as described in the comment to the formalname ENTITY
|
|
Packit Service |
a31ea6 |
declaration above.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%formalname; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=================================== SentFrom ===================================
|
|
Packit Service |
a31ea6 |
An individual and/or company or organisation from whom the NewsML document is
|
|
Packit Service |
a31ea6 |
being sent.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
==================================== SentTo ====================================
|
|
Packit Service |
a31ea6 |
An individual and/or company or organisation to whom the NewsML document is
|
|
Packit Service |
a31ea6 |
being sent.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================== SeriesLine ==================================
|
|
Packit Service |
a31ea6 |
A displayable version of information about a news object's place in a series.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
xml:lang CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================== SizeInBytes =================================
|
|
Packit Service |
a31ea6 |
The exact size in bytes of a ContentItem's inline or referenced data object.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=================================== SlugLine ===================================
|
|
Packit Service |
a31ea6 |
A string of text, possibly embellished by hyperlinks and/or formatting, used to
|
|
Packit Service |
a31ea6 |
display a NewsItem's slug line. (Note that the meaning of the term "slug line",
|
|
Packit Service |
a31ea6 |
and the uses to which it is put, are a matter for individual providers to
|
|
Packit Service |
a31ea6 |
define within their own workflow and business practice.)
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
xml:lang CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
==================================== Source ====================================
|
|
Packit Service |
a31ea6 |
An individual and/or company or organisation that provided source material for
|
|
Packit Service |
a31ea6 |
a news object. The optional NewsItem attribute must be present in the case of
|
|
Packit Service |
a31ea6 |
a syndicated NewsItem. It provides the URN of the NewsItem that is being
|
|
Packit Service |
a31ea6 |
syndicated. Note that a sequence of Source elements can be used to indicate the
|
|
Packit Service |
a31ea6 |
sequence of syndicators through which a NewsItem has passed.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
NewsItem CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================== StartDate ===================================
|
|
Packit Service |
a31ea6 |
A natural-language statement of the date at which specified usage rights come
|
|
Packit Service |
a31ea6 |
into effect.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
xml:lang CDATA #IMPLIED
|
|
Packit Service |
a31ea6 |
%assignment; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
==================================== Status ===================================
|
|
Packit Service |
a31ea6 |
An indication of the Status of a NewsItem. The value of the FormalName
|
|
Packit Service |
a31ea6 |
attribute is a formal name for the Status. Its meaning and permitted values
|
|
Packit Service |
a31ea6 |
are determined by a controlled vocabulary as described in the comment to the
|
|
Packit Service |
a31ea6 |
formalname ENTITY declaration above.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%formalname; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=============================== StatusWillChange ===============================
|
|
Packit Service |
a31ea6 |
Advance notification of a status change that will automatically occur at the
|
|
Packit Service |
a31ea6 |
specified date and time. For example, an item with a Status of "embargoed" might
|
|
Packit Service |
a31ea6 |
have a StatusWillChange element stating that the status will become "usable" at
|
|
Packit Service |
a31ea6 |
a specified time. This is equivalent to announcing in advance the time at which
|
|
Packit Service |
a31ea6 |
the embargo will end and the item will be released.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================= SubHeadLine ==================================
|
|
Packit Service |
a31ea6 |
A displayable subsidiary headline.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
xml:lang CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=================================== Subject ====================================
|
|
Packit Service |
a31ea6 |
An indication of the Subject of a NewsItem. The value of the FormalName
|
|
Packit Service |
a31ea6 |
attribute is a formal name for the Subject. Its meaning and permitted values
|
|
Packit Service |
a31ea6 |
are determined by a controlled vocabulary as described in the comment to the
|
|
Packit Service |
a31ea6 |
formalname ENTITY declaration above.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%formalname;
|
|
Packit Service |
a31ea6 |
%assignment; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================= SubjectCode ==================================
|
|
Packit Service |
a31ea6 |
A container for the IPTC Subject Codes that indicate the subject of a NewsItem,
|
|
Packit Service |
a31ea6 |
as defined in the IPTC Information Interchange Model. It consists of one more
|
|
Packit Service |
a31ea6 |
Subject, SubjectMatter and SubjectDetail elements, optionally amplified by one
|
|
Packit Service |
a31ea6 |
or more SubjectQualifier elements.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%assignment; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================ SubjectDetail =================================
|
|
Packit Service |
a31ea6 |
An indication of the SubjectDetail of a NewsItem. The value of the FormalName
|
|
Packit Service |
a31ea6 |
attribute is a formal name for the SubjectDetail. Its meaning and permitted
|
|
Packit Service |
a31ea6 |
values are determined by a controlled vocabulary as described in the comment
|
|
Packit Service |
a31ea6 |
to the formalname ENTITY declaration above.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%formalname;
|
|
Packit Service |
a31ea6 |
%assignment; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================ SubjectMatter =================================
|
|
Packit Service |
a31ea6 |
An indication of the SubjectMatter of a NewsItem. The value of the FormalName
|
|
Packit Service |
a31ea6 |
attribute is a formal name for the SubjectMatter. Its meaning and permitted
|
|
Packit Service |
a31ea6 |
values are determined by a controlled vocabulary as described in the comment to
|
|
Packit Service |
a31ea6 |
the formalname ENTITY declaration above.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%formalname;
|
|
Packit Service |
a31ea6 |
%assignment; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=============================== SubjectQualifier ===============================
|
|
Packit Service |
a31ea6 |
An indication of the SubjectQualifier of a NewsItem. The value of the FormalName
|
|
Packit Service |
a31ea6 |
attribute is a formal name for the SubjectQualifier. Its meaning and permitted
|
|
Packit Service |
a31ea6 |
values are determined by a controlled vocabulary as described in the comment to
|
|
Packit Service |
a31ea6 |
the formalname ENTITY declaration above.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%formalname;
|
|
Packit Service |
a31ea6 |
%assignment; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=============================== SystemIdentifier ===============================
|
|
Packit Service |
a31ea6 |
A system identifier (in the sense defined by the XML 1,0 Specification) for a
|
|
Packit Service |
a31ea6 |
NewsItem.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
============================= ThisRevisionCreated ==============================
|
|
Packit Service |
a31ea6 |
The date and, optionally, time at which the current revision of a NewsItem was
|
|
Packit Service |
a31ea6 |
created, expressed in ISO 8601 Basic Format, as described in the comment to the
|
|
Packit Service |
a31ea6 |
DateAndTime attribute within the assignment ENTITY declaration above.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
==================================== Topic =====================================
|
|
Packit Service |
a31ea6 |
This element provides information about a thing (Topic) named by a formal
|
|
Packit Service |
a31ea6 |
name or occurring in a NewsComponent. A Topic must have one or more TopicType
|
|
Packit Service |
a31ea6 |
subelements, which state what type of Topic it is. The optional Details
|
|
Packit Service |
a31ea6 |
attribute provides a pointer, in the form of a URL or URN, to additional
|
|
Packit Service |
a31ea6 |
information about the Topic.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
Details CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=============================== TopicOccurrence ================================
|
|
Packit Service |
a31ea6 |
An indication that a particular topic occurs within the content of a
|
|
Packit Service |
a31ea6 |
NewsComponent. The optional HowPresent attribute indicates the nature of that
|
|
Packit Service |
a31ea6 |
topic's occurrence. The value of the Topic attribute must consist of a #
|
|
Packit Service |
a31ea6 |
character followed by the value of the Duid attribute of a Topic in the current
|
|
Packit Service |
a31ea6 |
document.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%assignment;
|
|
Packit Service |
a31ea6 |
Topic CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================== TopicSet ====================================
|
|
Packit Service |
a31ea6 |
A container for Topics. The value of the FormalName attribute is a formal name
|
|
Packit Service |
a31ea6 |
for the TopicSet. Its meaning and permitted values are determined by a
|
|
Packit Service |
a31ea6 |
controlled vocabulary as described in the comment to the formalname ENTITY
|
|
Packit Service |
a31ea6 |
declaration above.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%formalname; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================= TopicSetRef ==================================
|
|
Packit Service |
a31ea6 |
A pointer to a TopicSet that is to be merged with the current one. The TopicSet
|
|
Packit Service |
a31ea6 |
attribute is a pointer to the relevant TopicSet. Its value can be an http URL,
|
|
Packit Service |
a31ea6 |
or a NewsML URN as described in the comment to PublicIdentifier, or a fragment
|
|
Packit Service |
a31ea6 |
identifier consisting of a # character followed by the Duid of a TopicSet in the
|
|
Packit Service |
a31ea6 |
current document. The presence of a TopicSetRef child in a TopicSet has the
|
|
Packit Service |
a31ea6 |
effect that all the Topics in the referenced TopicSet are included by reference
|
|
Packit Service |
a31ea6 |
within the current TopicSet. When this merging results in there exising two
|
|
Packit Service |
a31ea6 |
FormalName grandchildren of the same TopicSet that have the same content and
|
|
Packit Service |
a31ea6 |
the same Scheme attribute value, then the Topics whose children are in fact the
|
|
Packit Service |
a31ea6 |
same topic, and are deemed to be merged. The merging of Topics need not be
|
|
Packit Service |
a31ea6 |
performed physically by the system, but the meaning of the data is
|
|
Packit Service |
a31ea6 |
exactly the same as if the merging were actually performed. Merging two
|
|
Packit Service |
a31ea6 |
Topcis consists of creating a single Topic that contains all the children of
|
|
Packit Service |
a31ea6 |
both, and eliminating duplicates.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
TopicSet CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================== TopicType ===================================
|
|
Packit Service |
a31ea6 |
An indication of the type of a Topic. The value of the FormalName attribute is
|
|
Packit Service |
a31ea6 |
a formal name for the TopicType. Its meaning and permitted values are determined
|
|
Packit Service |
a31ea6 |
by a controlled vocabulary as described in the comment to the formalname ENTITY
|
|
Packit Service |
a31ea6 |
declaration above.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%formalname; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================== TopicUse ====================================
|
|
Packit Service |
a31ea6 |
An indication of where a particular Topic is used in a NewsML document. The
|
|
Packit Service |
a31ea6 |
value of the Topic attribute must consist of a # character followed by the
|
|
Packit Service |
a31ea6 |
value of the Duid of a Topic in the current document. The value of the Context
|
|
Packit Service |
a31ea6 |
attribute is an XPath pattern indicating the context where the referenced topic
|
|
Packit Service |
a31ea6 |
is used within the subtree to which the current Catalog applies. If the Context
|
|
Packit Service |
a31ea6 |
attribute is not present, the TopicUse element simply states that this topic is
|
|
Packit Service |
a31ea6 |
present somewhere in the subtree.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
Context CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================ TransmissionId ================================
|
|
Packit Service |
a31ea6 |
An identifier for the NewsML document transmission. This should be unique among
|
|
Packit Service |
a31ea6 |
all distinct transmissions from the same publisher. If a transmission is
|
|
Packit Service |
a31ea6 |
repeated (perhaps because the sender is not confident that it was successfully
|
|
Packit Service |
a31ea6 |
received) then the same TransmissionId content may be used, but a Repeat
|
|
Packit Service |
a31ea6 |
attribute should be provided to distinguish the second transmission from the
|
|
Packit Service |
a31ea6 |
first. The form that the value of the Repeat attribute takes is determined by
|
|
Packit Service |
a31ea6 |
the provider. Likewise, the format for the TransmissionId itself is for the
|
|
Packit Service |
a31ea6 |
provider to decide. It could for example consist of a channel identifier
|
|
Packit Service |
a31ea6 |
followed by a sequence number.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
Repeat CDATA #IMPLIED >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
==================================== Update ====================================
|
|
Packit Service |
a31ea6 |
A modification to an existing NewsItem. This can be an insertion, replacement
|
|
Packit Service |
a31ea6 |
or deletion. Note that the Update element cannot be used to modify the
|
|
Packit Service |
a31ea6 |
NewsManagement or Identification element, or any of their descendants.
|
|
Packit Service |
a31ea6 |
Modifications to these parts of the NewsItem can be made by issuing the
|
|
Packit Service |
a31ea6 |
NewsItem under the current revision number, with only the Identification and
|
|
Packit Service |
a31ea6 |
NewsManagement elements present. These will replace the previous Identification
|
|
Packit Service |
a31ea6 |
and NewsManagement elements in their totality.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
=================================== Urgency ====================================
|
|
Packit Service |
a31ea6 |
An indication of the urgency of a NewsItem. The value of the FormalName
|
|
Packit Service |
a31ea6 |
attribute is a formal name for the Urgency. Its meaning and permitted values
|
|
Packit Service |
a31ea6 |
are determined by a controlled vocabulary as described in the comment to the
|
|
Packit Service |
a31ea6 |
formalname ENTITY declaration above.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%formalname; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
===================================== Url ======================================
|
|
Packit Service |
a31ea6 |
A URL that can be used to locate a Resource.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
===================================== Urn ======================================
|
|
Packit Service |
a31ea6 |
A URN that provides a global identifier for a resource. This will typically (but
|
|
Packit Service |
a31ea6 |
not necessarily) be a NewsML URN as described in the comment to PublicIdentifier.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================= UsageRights ==================================
|
|
Packit Service |
a31ea6 |
Information about the usage rights pertaining to a NewsComponent.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
%assignment; >
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
================================== UsageType ===================================
|
|
Packit Service |
a31ea6 |
A natural-language indication of the type of usage to which the rights apply.
|
|
Packit Service |
a31ea6 |
================================================================================
|
|
Packit Service |
a31ea6 |
-->
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
|
|
Packit Service |
a31ea6 |
xml:lang CDATA #IMPLIED
|
|
Packit Service |
a31ea6 |
%assignment; >
|