NewsML-G2 Quick Reference Guide
NewsML-G2 Quick Reference Guide
REFERENCE GUIDE
This document contains information proprietary to Thomson Reuters and may not be reproduced, disclosed, or used in whole or part without the express
written permission of Thomson Reuters.
Any Software, including but not limited to, the code, screen, structure, sequence, and organization thereof, and Documentation are protected by national
copyright laws and international treaty provisions. This manual is subject to U.S. and other national export regulations.
Nothing in this document is intended, nor does it, alter the legal obligations, responsibilities or relationship between yourself and Thomson Reuters as set
out in the contract existing between us.
Chapter 1 Introduction 5
Chapter 2 Overview 6
2.1 General Structure of NML2 6
2.2 Types of Items 9
2.3 Types of Feeds 11
2.3.1. Processing OLR Feeds 11
2.4 Summary of GUIDs & IDs 12
newsMessage
header Message Header
date, sender, transmitId, priority, destination, channel, etc.
itemSet
packageItem
newsItem
. Item Set:
Combination of
. Primary Items
newsItem
newsItem
Item Set – The itemSet serves as a wrapper for one or more packageItems and newsItems.
The packageItem and newsItem are the two main constructs that Reuters uses. The number of packageItems
and newsItems will be different for different types of NML2.
packageItem – It contains the overall details of the XML file and is used to package related newsItems.
Example: You can see in the Broadcast Video example below how the group element in packageItem
groups all the references to the related newsItems, which are referenced by their unique identifiers (guid).
newsItem – Each item contains i) an inline text, or ii) references to external picture, graphic, audio or video
assets.
The following example shows the newsItem of Text type.
Linked List - This provides a Reuters-prioritized list of packageItems. This is also called a Super News
Event Package (SNEP).
Note A SNEP always points to other NEPs.
The XPaths used to identify different types of Reuters NML2 items are listed here. The ‘type’ of an NML2 item can
be identified based on the signal and subject elements as follows:
LinkedList (SNEP)
Package (NEP)
Text
Pictures
Graphics
Videos
Example: Snippets of two items are given below. Since each item is a revision of the same story, the guid
attribute is same for both items. The version attribute is clearly different indicating they are different revisions.
Additionally, versionCreated for Revision B is newer than Revision A indicating that Revision B is the latest
version of this story.
Also note that rtr:versionedId captures both guid and version in it and is unique for each revision of the same
story.
Story – Revision A
<newsMessage>
<header> … </header>
<itemSet>
<newsItem conformance="power" guid="tag:reuters.com,0000:newsml_LDE6AG1RR"<!--Same GUID-->
standard="NewsML-G2" standardversion="2.1" version="705441750"<!--Different version-->
xml:lang="en">
<catalogRef href="http://www.iptc.org/std/catalog/catalog.IPTC-G2-Standards_3.xml"/>
<rightsInfo> … </rightsInfo>
<itemMeta>
…
<versionCreated>2010-11-17-T17:58:31.000Z</versionCreated><!--Original version date-->
<firstCreated>2010-11-17T17:58:31.000Z</firstCreated>
…
<fileName>2010-11-17T175831Z_705441750_LDE6AG1RR_RTRMADT_0_SOCCER-EURO-FINLAND-
LATEST.XML</fileName>
…
<rtr:versionedId guid="tag:reuters.com,0000:newsml_LDE6AG1RR:705441750"/><!--Unique ID
for this particular revision of story-->
</itemMeta>
<contentMeta> … </contentMeta>
<contentSet> … </contentSet>
</newsItem>
</itemSet>
</newsMessage>
<newsMessage>
<header> … </header>
<itemSet>
<newsItem conformance="power" guid="tag:reuters.com,0000:newsml_LDE6AG1RR"<!--Same GUID-->
standard="NewsML-G2" standardversion="2.1" version="1649358288"<!--Different version-->
xml:lang="en">
<catalogRef href="http://www.iptc.org/std/catalog/catalog.IPTC-G2-Standards_3.xml"/>
<rightsInfo> … </rightsInfo>
<itemMeta>
…
<versionCreated>2010-11-17-T18:02:56.000Z</versionCreated><!--Newer version date-->
<firstCreated>2010-11-17T17:58:31.000Z</firstCreated>
…
<fileName>2010-11-17T180256Z_1649358288_LDE6AG1RR_RTRMADT_0_SOCCER-EURO-FINLAND-
LATEST.XML</fileName>
…
<rtr:versionedId guid="tag:reuters.com,0000:newsml_LDE6AG1RR:1649358288"/><!--Unique ID
for this particular revision of story-->
</itemMeta>
<contentMeta> … </contentMeta>
<contentSet> … </contentSet>
</newsItem>
</itemSet>
</newsMessage>
3.1.1. Structure
3.1.2. Example
<newsMessage xmlns="http://iptc.org/std/nar/2006-10-01/"
xmlns:rtr="http://www.reuters.com/ns/2003/08/content"
xmlns:x="http://www.w3.org/1999/xhtml" xmlns:xsi="http://www.w3.org/2001/XMLSchema-
instance">
<header>
<sent>2010-11-13T18:35:35.000Z</sent>
<sender>reuters.com</sender>
<transmitId>tag:reuters.com,0000:newsml_LDE6AC0B2:1465321805</transmitId>
<priority>3</priority>
<destination>RNP</destination>
<destination>DNP</destination>
<channel>TXT</channel>
</header>
<itemSet>
<newsItem conformance="power" guid="tag:reuters.com,0000:newsml_LDE6AC0B2"
standard="NewsML-G2" standardversion="2.1" version="1465321805" xml:lang="en">
<catalogRef href="http://www.iptc.org/std/catalog/catalog.IPTC-G2-
Standards_3.xml"/>
<rightsInfo>
<copyrightHolder literal="Reuters"/>
<copyrightNotice xml:lang="en">(c) Copyright Thomson Reuters 2010. Click For
Restrictions - http://about.reuters.com/fulllegal.asp</copyrightNotice>
</rightsInfo>
<itemMeta>
<itemClass qcode="icls:text" rtr:msgType="S"/>
<provider literal="reuters.com"/>
<versionCreated>2010-11-13T18:35:35.000Z</versionCreated>
<firstCreated>2010-11-13T18:35:35.000Z</firstCreated>
<pubStatus qcode="stat:usable"/>
<role qcode="itemRole:N"/>
3.2.1. Structure
3.2.2. Example
<newsMessage xmlns="http://iptc.org/std/nar/2006-10-01/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:rtr="http://www.reuters.com/ns/2003/08/content"
xmlns:x="http://www.w3.org/1999/xhtml">
<header>
<sent>2010-11-16T10:43:09.000Z</sent>
<sender>reuters.com</sender>
<transmitId>tag:reuters.com,0000:newsml_GM1E6BG1FZ901:1150025305</transmitId>
<priority>4</priority>
<destination>RONL</destination>
<destination>SPTS</destination>
<channel>PIX</channel>
</header>
<itemSet>
<newsItem guid="tag:reuters.com,0000:newsml_GM1E6BG1FZ901" version="1150025305"
standard="NewsML-G2" standardversion="2.1" conformance="power" xml:lang="en">
<catalogRef href="http://www.iptc.org/std/catalog/catalog.IPTC-G2-
Standards_3.xml" />
<rightsInfo>
<copyrightHolder literal="REUTERS" />
<copyrightNotice>(c) Copyright Thomson Reuters 2010. Click For Restrictions -
http://about.reuters.com/fulllegal.asp</copyrightNotice>
</rightsInfo>
<itemMeta>
3.3.1. Structure
3.3.2. Example
<newsMessage xmlns="http://iptc.org/std/nar/2006-10-01/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:rtr="http://www.reuters.com/ns/2003/08/content"
xmlns:x="http://www.w3.org/1999/xhtml">
<header>
<sent>2010-11-16T19:35:53.000Z</sent>
<sender>reuters.com</sender>
<transmitId>tag:reuters.com,0000:newsml_TM1E6BG14EV01:1759228905</transmitId>
<priority>4</priority>
<destination>ZENGLI</destination>
<destination>ZARC</destination>
<channel>NGS</channel>
</header>
<itemSet>
<newsItem guid="tag:reuters.com,0000:newsml_TM1E6BG14EV01" version="1759228905"
standard="NewsML-G2" standardversion="2.1" conformance="power" xml:lang="en">
<catalogRef href="http://www.iptc.org/std/catalog/catalog.IPTC-G2-
Standards_3.xml" />
<rightsInfo>
<copyrightHolder literal="Reuters" />
<copyrightNotice>(c) Copyright Thomson Reuters 2010. Click For Restrictions -
http://about.reuters.com/fulllegal.asp</copyrightNotice>
<usageTerms>1 of 1</usageTerms>
</rightsInfo>
3.4.1.1. Structure
newsMessage
header
date, sender, transmitId, priority, destination, channel, etc.
itemSet
packageItem
newsItem (text)
contentSet
inlineXML
newsItem (video)
contentSet
remoteContent
remoteContent
.
. Item Set:
. Combination of
remoteContent Primary Items
newsItem (audio)
contentSet
remoteContent
newsItem (picture)
contentSet
remoteContent
remoteContent
remoteContent
3.4.2.1. Structure
3.4.2.2. Example
<newsMessage xmlns="http://iptc.org/std/nar/2006-10-01/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:rtr="http://www.reuters.com/ns/2003/08/content"
xmlns:x="http://www.w3.org/1999/xhtml">
<header>
<sent>2010-11-16T19:43:54.000Z</sent>
<sender>reuters.com</sender>
<transmitId>LWN_2010-11-16_38792</transmitId>
<priority>4</priority>
<destination>VISP</destination>
<destination>VISM</destination>
<destination>RSPO</destination>
<channel>VID</channel>
</header>
<itemSet>
<packageItem guid="tag:reuters.com,2010:newsml_WNE6AFTXJ" version="1"
standard="NewsML-G2" standardversion="2.1" conformance="power" xml:lang="en">
<catalogRef href="http://www.iptc.org/std/catalog/catalog.IPTC-G2-
Standards_3.xml" />
<rightsInfo>
3.5.1. Structure
newsMessage
header
date, sender, transmitId, priority, destination, channel, etc.
itemSet
newsItem
contentSet
html
body
Primary Item
3.5.2. Example
<newsMessage xmlns="http://iptc.org/std/nar/2006-10-01/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:rtr="http://www.reuters.com/ns/2003/08/content"
xmlns:x="http://www.w3.org/1999/xhtml">
<header>
<sent>2010-12-06T17:20:54.000Z</sent>
<sender>reuters.com</sender>
<transmitId>tag:reuters.com,0000:newsml_TRE6B53VG:625075634</transmitId>
<priority>4</priority>
<destination>OUSBS</destination>
<channel>TXT</channel>
</header>
<itemSet>
<newsItem guid="tag:reuters.com,0000:newsml_TRE6B53VG" version="625075634"
standard="NewsML-G2" standardversion="2.1" conformance="power" xml:lang="en-US">
<catalogRef href="http://www.iptc.org/std/catalog/catalog.IPTC-G2-
Standards_3.xml" />
<rightsInfo>
<copyrightHolder literal="Reuters" />
<copyrightNotice xml:lang="en-GB">(c) Copyright Thomson Reuters 2010. Check for
restrictions at: http://about.reuters.com/fulllegal.asp</copyrightNotice>
</rightsInfo>
<itemMeta>
<itemClass qcode="icls:text" rtr:msgType="S" />
<provider literal="reuters.com" />
3.6.1. Structure
newsMessage
header
date, sender, transmitId, priority, destination, channel, etc.
itemSet
packageItem
groupSet
group id = main
newsItem (picture) -
optional
3.6.2. Example
<newsMessage xmlns="http://iptc.org/std/nar/2006-10-01/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:rtr="http://www.reuters.com/ns/2003/08/content"
xmlns:x="http://www.w3.org/1999/xhtml">
<header>
<sent>2010-12-06T16:43:40.000Z</sent>
<sender>reuters.com</sender>
<transmitId>tag:reuters.com,0000:newsml_TRE6B531W-OUSBS-
BTRE6B51AGP00:5675664</transmitId>
<priority>4</priority>
<destination>OUSBS</destination>
<channel>TXT</channel>
</header>
<itemSet>
<packageItem guid="tag:reuters.com,0000:newsml_TRE6B531W-OUSBS-BTRE6B51AGP00"
version="5675664" standard="NewsML-G2" standardversion="2.1" conformance="power"
xml:lang="en-US">
<catalogRef href="http://www.iptc.org/std/catalog/catalog.IPTC-G2-
Standards_3.xml" />
<rightsInfo>
<copyrightHolder literal="Reuters" />
<copyrightNotice xml:lang="en-GB">(c) Copyright Thomson Reuters 2010. Check for
restrictions at: http://about.reuters.com/fulllegal.asp</copyrightNotice>
3.7.1. Structure
3.7.2. Example
<newsMessage xmlns="http://iptc.org/std/nar/2006-10-01/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:rtr="http://www.reuters.com/ns/2003/08/content"
xmlns:x="http://www.w3.org/1999/xhtml">
<header>
<sent>2010-12-06T16:43:40.000Z</sent>
<sender>reuters.com</sender>
<transmitId>tag:reuters.com,0000:newsml_TRE6B53MT:284360198</transmitId>
<priority>4</priority>
<destination>OUSBS</destination>
<channel>TXT</channel>
</header>
<itemSet>
<packageItem guid="tag:reuters.com,0000:newsml_TRE6B53MT" version="284360198"
standard="NewsML-G2" standardversion="2.1" conformance="power" xml:lang="en-US">
<catalogRef href="http://www.iptc.org/std/catalog/catalog.IPTC-G2-
Standards_3.xml" />