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.

<group>

A mixed set of group references and references to items or Web resources

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

Note

Usage note

User Note: Group Mode: By default the group is “complementary and unordered”. The following modes are supported:

Complementary and Unordered: To be used for any kind of supporting content that does not require a sequence to be specified.
Complementary and Ordered: The group starts with the first child of the group. To be used for any kind of content which must be displayed or consumed in a particular sequence, expressed by the order of the child elements of the group. The semantics of the role attribute value determine the required processing.
Alternatives: To be used if a group contains equivalent pieces of content (e.g. translations of the same news story into different languages). The recipient may pick one or more of these.
Group References and Item References: Can be included in any order, and this order may be relevant or not, depending the value of the mode attribute. Each link aggregates an external resource (Item or Web resource) to the package. Optionally, it indicates the relationship between the group and the target resource plus some additional hints about the resource itself.

Content model

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

<groupRef>
<itemRef>
<conceptRef>
<title>
<signal>
<edNote>
<groupExtProperty>

Also accepts elements from other namespaces (extension point).

Attributes

Attribute Type Use Description

Attribute	Type	Use	Description
Declared on this element
`role`	`QCodeType`	optional	The part this group plays within its container - expressed by a QCode / either the role or the roleuri attribute MUST be used
`roleuri`	`IRIType`	optional	The part this group plays within its container - expressed by a URI / either the role or the roleuri attribute MUST be used
`mode`	`QCodeType`	optional	An indication whether the elements in the group are complementary and unordered, complementary and ordered or a set of alternative elements - expressed by a QCode
`modeuri`	`IRIType`	optional	An indication whether the elements in the group are complementary and unordered, complementary and ordered or a set of alternative elements - expressed by a URI
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)

Declared on this element

role

QCodeType

optional

The part this group plays within its container - expressed by a QCode / either the role or the roleuri attribute MUST be used

roleuri

IRIType

optional

The part this group plays within its container - expressed by a URI / either the role or the roleuri attribute MUST be used

mode

QCodeType

optional

An indication whether the elements in the group are complementary and unordered, complementary and ordered or a set of alternative elements - expressed by a QCode

modeuri

IRIType

optional

An indication whether the elements in the group are complementary and unordered, complementary and ordered or a set of alternative elements - expressed by a URI

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.

Used by

<groupSet> — 1..∞