ESS:Authors

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

"Authors" definition

Once an event is completely described in an ESS Document it should be signed by authors and participants. As defined in ESS Document, a proper ESS Feed should be served by the same domain name defined within <authors> (ess:authors) XML section. ESS processors should validate and rate authors by saving the unique ess:id author ID and confirming the issuing source according to <authors> (ess:authors) XML section.
Events authors are defined in ESS by two <item> element "type" attributes :

event author icon event contributor icon

FEED AUTHOR

FEED CONTRIBUTOR

Define the specific event feed writing issuer.

Define the event feed writing contributor.




ESS <authors> 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 is the responsibility of another <ess> feed to describe this event parameter.
Example: every <prices> items must be valid and applicable to every <dates> and <places> items within the same <ess> feed.

<authors> XML element (ess:authors) should be defined within ESS Documents, but it is not a mandatory ESS XML element.
This section describes the event feed writers. <authors> (ess:authors) XML element, if it is defined, must be composed by, at least, one <item> (ess:item) XML element.
Only one <item> XML element with type="author" attribute value should be define in an ESS Document.



Authors <item @attibutes>


Name Description Type Required
type The "type" attribute can take two values: "author" or "contributor" to defined the event feed writer or contributor. ESS Processors should consider that "author" is the default attribute if it is not specified. String TRUE
priority The "priority" attribute refer to the order and the preference to applied to each <item> XML element. ESS processors should consider the natural position as the priority if this attribute is not defined. Number FALSE




Authors <item> childs elements


Name Description Type Required
<name> Language-sensitive ESS author name. Should not be longer then 64 characters. String TRUE
<uri> Define URI where more information is available about the author. IRI RFC2396 TRUE
<firstname> Define author first name. Should not be longer then 128 characters. String FALSE
<lastname> Define author last name. Should not be longer then 128 characters. String FALSE
<organization> Define the organization name. If an organization name is defined ESS processors should consider that current the author is a structurized organization (association, group, company). Should not be longer then 256 chars. String FALSE
<address> Define the complete address: street name, street number, building number. Should not be longer then 512 chars. String FALSE
<city> Define city location name. Should not be longer then 128 characters String FALSE
<zip> Define the postal code. Common international structure is five numbers. String FALSE
<state> Define event's region, state or department name. Should not be longer then 128 chars. String FALSE
<state_code> Define event's region, state or department code name (should be 2 chars). String FALSE
<country> Define event's country name. (e.g. : United States of Americas) String FALSE
<country_code> Define event's country code in the international format (should be 2 chars). String ISO3166 FALSE
<email> Define representative email. Email RFC822 FALSE
<phone> Define representative phone. String FALSE




ESS authors sample

DTD description http://eventstandardsyndication.org/history/0.9

<?xml version="1.0" encoding="UTF-8"?>
<ess xmlns="http://eventstandardsyndication.org/history/0.9" version="0.9" lang="en">
   ...
   <authors>
 
      <!-- 1 | Event organization author --> 
      <item type="author">
         <name>Event author</name>
         <uri>http://example.org/index.html</uri>
         <firstname>John</firstname>
         <lastname>Doe</lastname>
         <organization>Sample ltd.</organization>
         <address>123, 5th ave / 45st E - #504</address>
         <city>New York</city>
         <zip>10012</zip>
         <state>New York</state>
         <state_code>NY</state_code>
         <country>United States of Americas</country>
         <country_code>US</country_code>
         <email>contact@example.org</email>
         <phone>1 (646) 255 9999</phone>
      </item>
 
      <!-- 2 | Event author contributor --> 
      <item type="contributor">
         <name>Event writer contributor</name>
         <firstname>Janette</firstname>
         <lastname>Doe</lastname>
      </item>
 
   </authors>
   ...
</ess>






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)


IF EVENTS MATTER TO YOU

Spread the news about ESS
Personal tools
Actions
Standard


Developers


Communication