Preview. Generated from the NewsML-G2 2.36 XML Schema by tools/xsdref. This layout is a harness for reviewing structure and content — it is not the published site.

<remoteContent>

A rendition of the content using a reference/link to a resource representing the content data at a remote location

Declared locally only; it is not a valid document root.

Note

Usage note

User Note: To identify the remote resource either the residref attribute or the href attribute MUST be set, optionally both MAY be used in parallel. The residref attribute identifies a managed remote resource by its globally unique identifier (if the resource has such an identifier), while the href attribute identifies the location of the remote resource in e.g. a (remote) file system. If the remote resource is managed like an Item and consequently residref is used, a version attribute MAY indicate the resource’s version; in the absence of version information, the remote resource is the latest version available.

A provider MAY explicitly express the format of residref using the residerefformat attribute with a QCode (or as a URI using its sibling residrefformaturi) in conjunction with the recommended IPTC Value Format NewsCodes (recommended scheme alias "valfmt") at http://cv.iptc.org/newscodes/valueformat/.

The width and height may be specified when appropriate to the target resource, and MAY be accompaied by a dimensionunit that takes the following values, taken from an IPTC defined controlled vocabulary: lines, pixels, points (more units are defined by this CV, check the most recent version).

Mandatory IPTC NewsCodes: http://cv.iptc.org/newscodes/dimensionunit/

If dimensionunit is absent, the default units for each content type are:

Content Type

Height Unit (default)

Width Unit (default)

Picture

pixels

Graphic: Still / Animated

points

Video (Analog)

lines

pixels

Video (Digital)

pixels

Content model

These, in this order:

<channel> — 0..∞
<altId> — 0..∞
<altLoc> — 0..∞
<hash> — 0..∞
<signal> — 0..∞
<remoteContentExtProperty> — 0..∞

Also accepts elements from other namespaces (extension point).

Attributes

Attribute Type Use Description

Attribute	Type	Use	Description
Declared on this element
`language`	`language`	optional	The language of the remote content
From newsContentAttributes
`id`	`ID`	optional	The local identifier of the element which MUST be persistent for all versions of the item, i.e. for its entire lifecycle.
`creator`	`QCodeType`	optional	If the property value is not defined, specifies which entity (person, organisation or system) will edit the property - expressed by a QCode. If the property value is defined, specifies which entity (person, organisation or system) has edited the property.
`creatoruri`	`IRIType`	optional	If the property value is not defined, specifies which entity (person, organisation or system) will edit the property - expressed by a URI. If the property value is defined, specifies which entity (person, organisation or system) has edited the property.
`modified`	`DateOptTimeType`	optional	The date (and, optionally, the time) when the property was last modified. The initial value is the date (and, optionally, the time) of creation of the property.
`custom`	`boolean`	optional	If set to true the corresponding property was added to the G2 Item for a specific customer or group of customers only. The default value of this property is false which applies when this attribute is not used with the property.
`how`	`QCodeType`	optional	Indicates by which means the value was extracted from the content - expressed by a QCode
`howuri`	`IRIType`	optional	Indicates by which means the value was extracted from the content - expressed by a URI
`why`	`QCodeType`	optional	Why the metadata has been included - expressed by a QCode
`whyuri`	`IRIType`	optional	Why the metadata has been included - expressed by a URI
`rendition`	`QCodeType`	optional	The specific rendition of content this component represents - expressed by a QCode
`renditionuri`	`IRIType`	optional	The specific rendition of content this component represents - expressed by a URI
`generator`	`string`	optional	The name and version of the software tool used to generate the content
`generated`	`DateOptTimeType`	optional	The date (and, optionally, the time) when the content was generated
`hascontent`	`boolean`	optional	Indicates if the digital data of this rendition is available or not.
From targetResourceAttributes
`href`	`IRIType`	optional	The locator of the target resource.
`residref`	`string`	optional	The provider’s identifier of the target resource.
`residrefformat`	`QCodeType`	optional	The format of the provider’s identifier of the target resource - expressed by a QCode. The recommended CV to be used is http://cv.iptc.org/newscodes/valueformat/.
`residrefformaturi`	`IRIType`	optional	The format of the provider’s identifier of the target resource - expressed by a URI. The recommended CV to be used is http://cv.iptc.org/newscodes/valueformat/.
`version`	`positiveInteger`	optional	The version of the target resource. By default, the latest revision is retrieved when the link is activated.
`persistidref`	`string`	optional	Points to an element inside the target resource which must be identified by an ID attribute having a value which is persistent for all versions of the target resource, i.e. for its entire lifecycle. (added NAR 1.8)
`contenttype`	`string`	optional	The IANA (Internet Assigned Numbers Authority) Media Type of the target resource.
`contenttypestandardversion`	`string`	optional	Version of the standard identified by contenttype.
`contenttypevariant`	`string`	optional	A refinement of a generic content type (i.e. IANA Media Type) by a literal string value.
`contenttypevariantstandardversion`	`string`	optional	Version of the standard identified by contenttypevariant.
`format`	`QCodeType`	optional	A refinement of a generic content type (i.e. IANA Media Type) by a value from a controlled vocabulary - expressed by a QCode
`formaturi`	`IRIType`	optional	A refinement of a generic content type (i.e. IANA Media Type) by a value from a controlled vocabulary - expressed by a URI
`formatstandardversion`	`string`	optional	Version of the standard identified by the format.
`size`	`nonNegativeInteger`	optional	The size in bytes of the target resource.
`title`	`string`	optional	A short natural language name for the target resource.
From timeValidityAttributes
`validfrom`	`DateOptTimeType`	optional	The date (and, optionally, the time) before which a relationship is not valid.
`validto`	`DateOptTimeType`	optional	The date (and, optionally, the time) after which a relationship is not valid.
From newsContentCharacteristics
`charcount`	`nonNegativeInteger`	optional	The count of characters of textual content.
`wordcount`	`nonNegativeInteger`	optional	The count of words of textual content.
`linecount`	`nonNegativeInteger`	optional	The count of lines of textual content
`pagecount`	`nonNegativeInteger`	optional	The count of pages of the content
`width`	`nonNegativeInteger`	optional	The image width for visual content.
`widthunit`	`QCodeType`	optional	If present defines the width unit for the width - expressed by a QCode
`widthunituri`	`IRIType`	optional	If present defines the width unit for the width - expressed by a URI
`height`	`nonNegativeInteger`	optional	The height of visual content.
`heightunit`	`QCodeType`	optional	If present defines the height unit for the heigth - expressed by a QCode
`heightunituri`	`IRIType`	optional	If present defines the height unit for the heigth - expressed by a URI
`orientation`	`nonNegativeInteger`	optional	The orientation of the visual content of an image in regard to the standard rendition of the digital image data
`layoutorientation`	`QCodeType`	optional	Indicates whether the human interpretation of the top of the image is aligned to its short or long side - expressed by a QCode
`layoutorientationuri`	`IRIType`	optional	Indicates whether the human interpretation of the top of the image is aligned to its short or long side - expressed by a URI
`colourspace`	`QCodeType`	optional	The colour space of an image - expressed by a QCode
`colourspaceuri`	`IRIType`	optional	The colour space of an image - expressed by a URI
`colourindicator`	`QCodeType`	optional	Indicates whether the still or moving image is coloured or black and white. The recommended vocabulary is the IPTC Colour Indicator NewsCodes http://cv.iptc.org/newscodes/colourindicator/ - expressed by a QCode
`colourindicatoruri`	`IRIType`	optional	Indicates whether the still or moving image is coloured or black and white. The recommended vocabulary is the IPTC Colour Indicator NewsCodes http://cv.iptc.org/newscodes/colourindicator/ - expressed by a URI
`colourdepth`	`nonNegativeInteger`	optional	The bit depth defining the spread of colour data within each sample.
`resolution`	`positiveInteger`	optional	The recommended printing resolution for an image in dots per inch
`duration`	`string`	optional	The clip duration in time units defined by durationUnit. The default time unit is seconds. Applies to audio-visual content.
`durationunit`	`QCodeType`	optional	If present it defines the time unit for the duration attribute. Only codes for integer value time units of the recommended CV (available at http://cv.iptc.org/newscodes/timeunit/ ) must be applied - expressed by a QCode
`durationunituri`	`IRIType`	optional	If present it defines the time unit for the duration attribute. Only codes for integer value time units of the recommended CV (available at http://cv.iptc.org/newscodes/timeunit/ ) must be applied - expressed by a URI
`audiocodec`	`QCodeType`	optional	The applicable codec for audio data - expressed by a QCode
`audiocodecuri`	`IRIType`	optional	The applicable codec for audio data - expressed by a URI
`audiobitrate`	`positiveInteger`	optional	The audio bit rate in bits per second
`audiovbr`	`boolean`	optional	An indication that the audio data is encoded with a variable bit rate
`audiosamplesize`	`positiveInteger`	optional	The number of bits per audio sample
`audiosamplerate`	`positiveInteger`	optional	The number of audio samples per second, expressed as a sampling frequency in Hz
`audiochannels`	`QCodeType`	optional	The audio sound system - expressed by a QCode
`audiochannelsuri`	`IRIType`	optional	The audio sound system - expressed by a URI
`videocodec`	`QCodeType`	optional	The applicable codec for video data - expressed by a QCode
`videocodecuri`	`IRIType`	optional	The applicable codec for video data - expressed by a URI
`videoavgbitrate`	`positiveInteger`	optional	The video average bit rate in bits per second. Used when the bit rate is variable
`videovbr`	`boolean`	optional	An indication that video data is encoded with a variable bit rate
`videoframerate`	`decimal`	optional	The number of video frames per second, i.e. the rate at which the material should be shown in order to achieve the intended visual effect
`videoscan`		optional	The video scan technique, progressive or interlaced
`videoaspectratio`	`g2normalizedString`	optional	The video aspect ratio
`videosampling`	`g2normalizedString`	optional	The video sampling method
`videoscaling`	`QCodeType`	optional	Indicates how the original content was scaled to this format - expressed by a QCode. The recommended vocabulary is the IPTC Video Scaling NewsCodes http://cv.iptc.org/newscodes/videoscaling/
`videoscalinguri`	`IRIType`	optional	Indicates how the original content was scaled to this format - expressed by a URI. The recommended vocabulary is the IPTC Video Scaling NewsCodes http://cv.iptc.org/newscodes/videoscaling/
`videodefinition`	`QCodeType`	optional	Indicates which video definition is applied to this rendition of video content - expressed by a QCode - but it does not imply any particular technical characteristics of the video.The recommended vocabulary is the IPTC Video Definition NewsCodes http://cv.iptc.org/newscodes/videodefinition/
`videodefinitionuri`	`IRIType`	optional	Indicates which video definition is applied to this rendition of video content - expressed by a URI - but it does not imply any particular technical characteristics of the video.The recommended vocabulary is the IPTC Video Definition NewsCodes http://cv.iptc.org/newscodes/videodefinition/

Declared on this element

language

optional

The language of the remote content

From newsContentAttributes

id

ID

optional

The local identifier of the element which MUST be persistent for all versions of the item, i.e. for its entire lifecycle.

creator

QCodeType

optional

If the property value is not defined, specifies which entity (person, organisation or system) will edit the property - expressed by a QCode. If the property value is defined, specifies which entity (person, organisation or system) has edited the property.

creatoruri

IRIType

optional

If the property value is not defined, specifies which entity (person, organisation or system) will edit the property - expressed by a URI. If the property value is defined, specifies which entity (person, organisation or system) has edited the property.

modified

DateOptTimeType

optional

The date (and, optionally, the time) when the property was last modified. The initial value is the date (and, optionally, the time) of creation of the property.

custom

boolean

optional

If set to true the corresponding property was added to the G2 Item for a specific customer or group of customers only. The default value of this property is false which applies when this attribute is not used with the property.

how

QCodeType

optional

Indicates by which means the value was extracted from the content - expressed by a QCode

howuri

IRIType

optional

Indicates by which means the value was extracted from the content - expressed by a URI

why

QCodeType

optional

Why the metadata has been included - expressed by a QCode

whyuri

IRIType

optional

Why the metadata has been included - expressed by a URI

rendition

QCodeType

optional

The specific rendition of content this component represents - expressed by a QCode

renditionuri

IRIType

optional

The specific rendition of content this component represents - expressed by a URI

generator

string

optional

The name and version of the software tool used to generate the content

generated

DateOptTimeType

optional

The date (and, optionally, the time) when the content was generated

hascontent

boolean

optional

Indicates if the digital data of this rendition is available or not.

From targetResourceAttributes

href

IRIType

optional

The locator of the target resource.

residref

string

optional

The provider’s identifier of the target resource.

residrefformat

QCodeType

optional

The format of the provider’s identifier of the target resource - expressed by a QCode. The recommended CV to be used is http://cv.iptc.org/newscodes/valueformat/.

residrefformaturi

IRIType

optional

The format of the provider’s identifier of the target resource - expressed by a URI. The recommended CV to be used is http://cv.iptc.org/newscodes/valueformat/.

version

positiveInteger

optional

The version of the target resource. By default, the latest revision is retrieved when the link is activated.

persistidref

string

optional

Points to an element inside the target resource which must be identified by an ID attribute having a value which is persistent for all versions of the target resource, i.e. for its entire lifecycle. (added NAR 1.8)

contenttype

string

optional

The IANA (Internet Assigned Numbers Authority) Media Type of the target resource.

contenttypestandardversion

string

optional

Version of the standard identified by contenttype.

contenttypevariant

string

optional

A refinement of a generic content type (i.e. IANA Media Type) by a literal string value.

contenttypevariantstandardversion

string

optional

Version of the standard identified by contenttypevariant.

format

QCodeType

optional

A refinement of a generic content type (i.e. IANA Media Type) by a value from a controlled vocabulary - expressed by a QCode

formaturi

IRIType

optional

A refinement of a generic content type (i.e. IANA Media Type) by a value from a controlled vocabulary - expressed by a URI

formatstandardversion

string

optional

Version of the standard identified by the format.

size

nonNegativeInteger

optional

The size in bytes of the target resource.

title

string

optional

A short natural language name for the target resource.

From timeValidityAttributes

validfrom

DateOptTimeType

optional

The date (and, optionally, the time) before which a relationship is not valid.

validto

DateOptTimeType

optional

The date (and, optionally, the time) after which a relationship is not valid.

From newsContentCharacteristics

charcount

nonNegativeInteger

optional

The count of characters of textual content.

wordcount

nonNegativeInteger

optional

The count of words of textual content.

linecount

nonNegativeInteger

optional

The count of lines of textual content

pagecount

nonNegativeInteger

optional

The count of pages of the content

width

nonNegativeInteger

optional

The image width for visual content.

widthunit

QCodeType

optional

If present defines the width unit for the width - expressed by a QCode

widthunituri

IRIType

optional

If present defines the width unit for the width - expressed by a URI

height

nonNegativeInteger

optional

The height of visual content.

heightunit

QCodeType

optional

If present defines the height unit for the heigth - expressed by a QCode

heightunituri

IRIType

optional

If present defines the height unit for the heigth - expressed by a URI

orientation

nonNegativeInteger

optional

The orientation of the visual content of an image in regard to the standard rendition of the digital image data

layoutorientation

QCodeType

optional

Indicates whether the human interpretation of the top of the image is aligned to its short or long side - expressed by a QCode

layoutorientationuri

IRIType

optional

Indicates whether the human interpretation of the top of the image is aligned to its short or long side - expressed by a URI

colourspace

QCodeType

optional

The colour space of an image - expressed by a QCode

colourspaceuri

IRIType

optional

The colour space of an image - expressed by a URI

colourindicator

QCodeType

optional

Indicates whether the still or moving image is coloured or black and white. The recommended vocabulary is the IPTC Colour Indicator NewsCodes http://cv.iptc.org/newscodes/colourindicator/ - expressed by a QCode

colourindicatoruri

IRIType

optional

colourdepth

nonNegativeInteger

optional

The bit depth defining the spread of colour data within each sample.

resolution

positiveInteger

optional

The recommended printing resolution for an image in dots per inch

duration

string

optional

The clip duration in time units defined by durationUnit. The default time unit is seconds. Applies to audio-visual content.

durationunit

QCodeType

optional

If present it defines the time unit for the duration attribute. Only codes for integer value time units of the recommended CV (available at http://cv.iptc.org/newscodes/timeunit/ ) must be applied - expressed by a QCode

durationunituri

IRIType

optional

audiocodec

QCodeType

optional

The applicable codec for audio data - expressed by a QCode

audiocodecuri

IRIType

optional

The applicable codec for audio data - expressed by a URI

audiobitrate

positiveInteger

optional

The audio bit rate in bits per second

audiovbr

boolean

optional

An indication that the audio data is encoded with a variable bit rate

audiosamplesize

positiveInteger

optional

The number of bits per audio sample

audiosamplerate

positiveInteger

optional

The number of audio samples per second, expressed as a sampling frequency in Hz

audiochannels

QCodeType

optional

The audio sound system - expressed by a QCode

audiochannelsuri

IRIType

optional

The audio sound system - expressed by a URI

videocodec

QCodeType

optional

The applicable codec for video data - expressed by a QCode

videocodecuri

IRIType

optional

The applicable codec for video data - expressed by a URI

videoavgbitrate

positiveInteger

optional

The video average bit rate in bits per second. Used when the bit rate is variable

videovbr

boolean

optional

An indication that video data is encoded with a variable bit rate

videoframerate

decimal

optional

The number of video frames per second, i.e. the rate at which the material should be shown in order to achieve the intended visual effect

videoscan

optional

The video scan technique, progressive or interlaced

videoaspectratio

g2normalizedString

optional

The video aspect ratio

videosampling

g2normalizedString

optional

The video sampling method

videoscaling

QCodeType

optional

Indicates how the original content was scaled to this format - expressed by a QCode. The recommended vocabulary is the IPTC Video Scaling NewsCodes http://cv.iptc.org/newscodes/videoscaling/

videoscalinguri

IRIType

optional

Indicates how the original content was scaled to this format - expressed by a URI. The recommended vocabulary is the IPTC Video Scaling NewsCodes http://cv.iptc.org/newscodes/videoscaling/

videodefinition

QCodeType

optional

Indicates which video definition is applied to this rendition of video content - expressed by a QCode - but it does not imply any particular technical characteristics of the video.The recommended vocabulary is the IPTC Video Definition NewsCodes http://cv.iptc.org/newscodes/videodefinition/

videodefinitionuri

IRIType

optional

Indicates which video definition is applied to this rendition of video content - expressed by a URI - but it does not imply any particular technical characteristics of the video.The recommended vocabulary is the IPTC Video Definition NewsCodes http://cv.iptc.org/newscodes/videodefinition/

This element is an extension point: properties from other XML namespaces may be added.

Used by

<contentSet> — 0..∞, in any order (choice)