Skip to main content

Versioning of messages

Versioning of messages

Major versions

Versioning of XML instance documents is implemented through the last part of the namespace with prefix rsm in the root element.  This will contain the major version of the message.  

Any changes to messages that breaks backward compatibility requires a new major version, ie. a new namespace.

A major version of an Elhub message constitutes significant non-backward compatible changes.
If any XML instance document based on an older major version of an Elhub message attempts validation against a newer version, it may experience validation errors.
A new major version will be produced whenever non-backward changes occur.  This will include the following changes:

  • Changing of element names, type names and attribute names
  • Changes to the message structure or sequence
  • Deleting or adding mandatory elements or attributes
  • Changing cardinality from optional to mandatory 

Minor versions

 Minor versions represent changes to Elhub messages within a major version which do not break backward compatibility, ie.:

  • Adding, removing or changing values in enumerations
  • Add optional elements 
  • Optional extensions 

Minor versions will be declared using the xsd:version attribute of the XML schema definition (XSD) file. 



Attribute in the root element to reference the XML schema the XML instance document is based on.   The attibute is constructed of two elements separated by a space: Namespace and filename.   Example: xmlns:xsi =" " xsi:schemaLocation ="urn:no:elhub:emif:market:RequestStartOfSupply:v1  RequestStartOfSupply.xsd">

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.