ESS structure

From ESS
Jump to: navigation, search
Format ESS
Ess-feed-icon.png
.ess, .xml
application/ess+xml
version 0.9

Contents

ESS Structure

ESS Document is an XML (Extensible Markup Language) standard format RFC 3076 inherited from Atom/ RSS Feeds Standard RFC 4287 as explained in sections ESS History and ESS Document. "ess:feed" element is the Feed Document, acting as a container for metadata and data associated with the feed. Its child elements consist of metadata elements that describe Events.




The


Name Description Type Required
xmlns Define the main XMLNS name for the current ESS Document. This value must be http://essfeed.org/history/0.9 String TRUE
version Define the current ESS feed encoding version. ESS processors should consider the last version as the one used to encode the current ESS Document. The current version id 0.9 String TRUE
lang Define a unique feed IRI ID. ESS processors should consider en (English) as the default language if the attribute is not specified. String ISO6391 TRUE



The XML child elements


Name Description Type Required
Define the language-sensitive feed title. Should not be longer then 128 characters String TRUE
Define the feed URL. Must be a valid URL Constructor. ESS processors should validate the feed origine with XML element (ess:people). URL RFC3986 TRUE
Define a unique ESS feed IRI ID. ESS processors should use the value to generate a unique IRI ID value. The value should start with: ESSID:. IRI RFC3987 TRUE
Define the Feed publishing Date. Date RFC3339 TRUE
Define the Feed updating Date. Date RFC3339 FALSE
Define the Feed generator (script library, ESS CMS module, portal name), more details in ESS libraries and ESS generator. Should not be longer then 64 chars. String FALSE
Define the Feed proprietary rights. Should not be longer then 512 chars. String FALSE



The XML child elements


Name Description Type Required
Define the language-sensitive feed title. Should not be longer then 128 characters String TRUE
Define a unique Event page URL. Must be a valid URL. URL RFC3986 FALSE
Define a unique Event ID. ESS processors should use the value to generate a unique IRI ID value. The value should start with: EVENTID:. ESS processors should save and record ess IDs during feed live to link it with other IDs defined in XML section (ess:relations). IRI RFC3987 TRUE
Define the Feed publishing Date. Date RFC3339 TRUE
Define the Feed updating Date. Date RFC3339 FALSE
Define if the event have a public access. The value can only be PUBLIC or PRIVATE. String TRUE
Event Feed description. This XML element contain the main event's description. ESS processors should use this content as the only event description. Using HTML inside this section is possible but should be limited to minimum necessary because ESS processors could use this information in an environment that can not read HTML (iCalendar format, mobile devices). String TRUE
XML structure that numerates an infinite number of XML childs elements with keywords content. ESS processors should use those keywords to specify the correct category that match with the event purpose. XML RFC3076 FALSE



Structure sample

DTD description [http://essfeed.org/history/0.9 ]

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

 xmlns="http://essfeed.org/history/0.9" version="0.9" lang="en">
   >
      >Football Stadium Events>
      >http://sample.com/feeds/sample.ess>
      >ESSID:3578:870970:76433:999>
      >2012-12-13T08:29:29:00Z>
      >2012-12-13T18:30:02Z>
      >ess:php:generator:version:0.91>
      >Copyright (c) 2012, John Doe>
 
      >
          >Football match of saturday>
          >EVENTID:53578:857509570:7564533:979797>
          >http://sample.com/events/specific-and-unique-event-page/>
          >2012-12-13T08:29:29:00Z>
          >2012-12-13T18:30:02Z>
          >PUBLIC>
          >
              
                  Welcome to my first football game.
                  This game is crucial.
                  Our team is up against the main league competitor. 
                  I hope to see you there! 
               ]]>
          >
          >
              >Sport> 
              >Football> 
              >Match> 
          >
 
           />  
           />      
           />       
           />      
           />      
           />       
           />   
 
       >
   >
>




Structure

XML Name Description Type Required
XML section that defines event categories through one or various XML elements. items structure is defined in section. This XML element is mandatory, it must be present in a valid ESS document. ess:item RFC3076 TRUE
XML section that defines event dates through one or various XML elements. items structure is defined in section. This XML element is mandatory, it must be present in a valid ESS document. ess:item RFC3076 TRUE
XML section that define event places through one or various XML elements. items structure is defined in section. This XML element is mandatory, it must be present in a valide ESS document. ess:item RFC3076 TRUE
XML section that define event prices categories through one or various XML elements. items structure is defined in section. This XML element is not mandatory, ESS:Processors should consider the event as type="free" if it is not defined. ess:item RFC3076 FALSE
XML section that defines interaction between event and people through one or various XML elements. items structure is defined in section. ess:item RFC3076 FALSE
XML section that defined Event Feed categories through one or various XML elements. items structure is defined in section. ess:item RFC3076 FALSE
XML section that defined Event Feed categories through one or various XML elements. items structure is defined in section. ess:item RFC3076 FALSE



Structure sample

DTD description [http://essfeed.org/history/0.9 ]

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

 xmlns="http://essfeed.org/history/0.9" version="0.9" lang="en">
 >
   >
      ...
      >
         type="xxxx">...>
      >
 
      >
         type="xxxx">...>
      >
 
      >
         type="xxxx">...>
      >
 
      >
         type="xxxx" mode="xxxx">...>
      >
 
      >
         type="xxxx">...>
      >
 
      >
         type="xxxx">...>
      >
 
      >
         type="xxxx">...>
      >
       ...
   >
 >
>







External documentation

Ietf logo.png

ESS standard under RFC validation process: RFC ESS Draft

  • RFC 3076 : Canonical XML Version 1.0
  • RFC 3339 : Date and Time on the Internet: Timestamps
  • RFC 3986 : Uniform Resource Identifier (URI): Generic Syntax
  • RFC 3987 : Internationalized Resource Identifiers (IRIs)
  • RFC 4287 : The Atom Syndication Format


IF EVENTS MATTER TO YOU

Spread the news about ESS!
Personal tools
Actions
Standard

 


Developers

 


Communication