From ESS
Jump to: navigation, search
Format ESS
.ess, .xml
version 0.9


"Relations" definition

Once an event is completely described in an ESS Document it can have relations with other ESS Event Feeds. Event relations are defined in ESS by three element "type" attributes :




Event with one or more general similarities between the two events
(same date, place, price, category...).

Event with one or more specific similarities that complements the two events
(same performer, sub-category, happened before or after ...).

Event in the same real enclosure or conceptual enclosure
(list of other event feeds in a city on the 4th of July).

ESS structure

ESS documents are composed of various main XML elements. ESS processors must consider each and every element's description as valid and applicable to each and every other XML element within the same ESS document. If it is not the case, it belong to an other feed to describe this event parameter.
Example: every items must be valid and applicable to every and items within the same feed.

XML element (ess:relations) should be defined within ESS Documents, but it is not a mandatory ESS XML element.
This section describe the interaction between various events through ESS Feeds. (ess:relations) XML element, if it is defined, must be composed of at least one (ess:item) XML element.
Several elements can defined within XML structure to describe various event relations.


Name Description Type Required
type The "type" attribute can take three values: "alternative", "related" or "enclosure" to represent each type of relation between one event with another. ESS Processors should consider that "related" is the default attribute if it is not specified. String TRUE
priority The "priority" attribute refers to the order and the preference applied to each XML element. ESS processors should consider the natural position as the priority if this attribute is not defined. Number FALSE

Relations child elements

Name Description Type Required
Unique and universal ESS feed (ess:id) identifier. Must be the same then the one defined within distant ESS Document. IRI RFC3987 TRUE
Language-sensitive ESS Feed name. Should not be longer then 64 characters. Should be the same then the distant one (ess:name) String TRUE
Define distant URI where is placed ESS Feed Document. IRI RFC2396 TRUE
This optional XML element contains the specific event relation description (short summary of the relation). Using HTML tags inside this XML element is possible but should be reduced to the minimum because ESS processors could use this information in an environment that can not read HTML. String FALSE

ESS relations sample

DTD description

 version="1.0" encoding="UTF-8"?>

 xmlns="" version="0.9" lang="en">
         >Related Event>
         >This is an alternative event>
         >Same environment event>

External documentation

Ietf logo.png

ESS standard under RFC validation process: RFC ESS Draft

  • RFC 2396 : Uniform Resource Identifiers (URI)
  • RFC 3076 : Canonical XML Version 1.0
  • RFC 3987 : Internationalized Resource Identifiers (IRIs)


Spread the news about ESS!
Personal tools