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.

<role>

The schema defines this element differently in each context it is declared in.

As a document root: The role of the Item in the editorial workflow.
In <type:partMetaPropType>: The role in the overall content stream.

Note	Usage note User Note: This property may indicate the `role` of the content part in a piece of streaming media. Examples (video): “sting”, “slate”, etc.

Note	Usage note User Note: Among other possibilities this property may indicate the importance of the Item in a feed by concepts like “flash”, “bulletin”, “alert”, “urgent”, “newsbreak”, and so on.

Declared in 2 contexts

The content model is the same in each context.

inside <itemMeta> — 0..1
inside <partMeta> — 0..1

Content model (global)

Any of these, in any order, each 0..∞:

<name>
<hierarchyInfo>

Also accepts elements from other namespaces (extension point).

Attributes (global)

Attribute Type Use Description

Attribute	Type	Use	Description
Inherited from `QCodePropType`
`qcode`	`QCodeType`	optional	A concept identifier expressed as a string of the form sss:ccc, where sss is a scheme alias and ccc is a code. Either the qcode or the uri attribute MUST be used
`uri`	`IRIType`	optional	A URI which identifies a concept - either the qcode or the uri attribute MUST be used
From commonPowerAttributes
`id`	`ID`	optional	The local identifier of the property.
`creator`	`QCodeType`	optional	If the property value is not defined, specifies which entity (person, organisation or system) will edit the property value - expressed by a QCode. If the property value is defined, specifies which entity (person, organisation or system) has edited the property value.
`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
`pubconstraint`	`QCodeListType`	optional	One or many constraints that apply to publishing the value of the property - expressed by a QCode. Each constraint applies to all descendant elements.
`pubconstrainturi`	`IRIListType`	optional	One or many constraints that apply to publishing the value of the property - expressed by a URI. Each constraint applies to all descendant elements.
From i18nAttributes
`xml:lang`		optional	Specifies the language of this property and potentially all descendant properties. xml:lang values of descendant properties override this value. Values are determined by Internet BCP 47.
`dir`		optional	The directionality of textual content (enumeration: ltr, rtl)

Inherited from QCodePropType

qcode

QCodeType

optional

A concept identifier expressed as a string of the form sss:ccc, where sss is a scheme alias and ccc is a code. Either the qcode or the uri attribute MUST be used

uri

IRIType

optional

A URI which identifies a concept - either the qcode or the uri attribute MUST be used

From commonPowerAttributes

id

ID

optional

The local identifier of the property.

creator

QCodeType

optional

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

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

pubconstraint

QCodeListType

optional

One or many constraints that apply to publishing the value of the property - expressed by a QCode. Each constraint applies to all descendant elements.

pubconstrainturi

IRIListType

optional

One or many constraints that apply to publishing the value of the property - expressed by a URI. Each constraint applies to all descendant elements.

From i18nAttributes

xml:lang

optional

Specifies the language of this property and potentially all descendant properties. xml:lang values of descendant properties override this value. Values are determined by Internet BCP 47.

dir

optional

The directionality of textual content (enumeration: ltr, rtl)

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

Content model (type:partMetaPropType)

Any of these, in any order, each 0..∞:

<name>
<hierarchyInfo>

Also accepts elements from other namespaces (extension point).

Attributes (type:partMetaPropType)

Attribute Type Use Description

Attribute	Type	Use	Description
Inherited from `QCodePropType`
`qcode`	`QCodeType`	optional	A concept identifier expressed as a string of the form sss:ccc, where sss is a scheme alias and ccc is a code. Either the qcode or the uri attribute MUST be used
`uri`	`IRIType`	optional	A URI which identifies a concept - either the qcode or the uri attribute MUST be used
From commonPowerAttributes
`id`	`ID`	optional	The local identifier of the property.
`creator`	`QCodeType`	optional	If the property value is not defined, specifies which entity (person, organisation or system) will edit the property value - expressed by a QCode. If the property value is defined, specifies which entity (person, organisation or system) has edited the property value.
`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
`pubconstraint`	`QCodeListType`	optional	One or many constraints that apply to publishing the value of the property - expressed by a QCode. Each constraint applies to all descendant elements.
`pubconstrainturi`	`IRIListType`	optional	One or many constraints that apply to publishing the value of the property - expressed by a URI. Each constraint applies to all descendant elements.
From i18nAttributes
`xml:lang`		optional	Specifies the language of this property and potentially all descendant properties. xml:lang values of descendant properties override this value. Values are determined by Internet BCP 47.
`dir`		optional	The directionality of textual content (enumeration: ltr, rtl)

Inherited from QCodePropType

qcode

QCodeType

optional

A concept identifier expressed as a string of the form sss:ccc, where sss is a scheme alias and ccc is a code. Either the qcode or the uri attribute MUST be used

uri

IRIType

optional

A URI which identifies a concept - either the qcode or the uri attribute MUST be used

From commonPowerAttributes

id

ID

optional

The local identifier of the property.

creator

QCodeType

optional

creatoruri

IRIType

optional

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

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

pubconstraint

QCodeListType

optional

One or many constraints that apply to publishing the value of the property - expressed by a QCode. Each constraint applies to all descendant elements.

pubconstrainturi

IRIListType

optional

One or many constraints that apply to publishing the value of the property - expressed by a URI. Each constraint applies to all descendant elements.

From i18nAttributes

xml:lang

optional

Specifies the language of this property and potentially all descendant properties. xml:lang values of descendant properties override this value. Values are determined by Internet BCP 47.

dir

optional

The directionality of textual content (enumeration: ltr, rtl)

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