ESS:Authors

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

Contents

"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 (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 (ess:authors) XML section.
Events authors are defined in ESS by two element "type" attributes :

FEED AUTHOR

FEED CONTRIBUTOR

Define the specific event feed writing issuer.

Define the event feed writing contributor.




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



Authors


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 XML element. ESS processors should consider the natural position as the priority if this attribute is not defined. Number FALSE




Authors childs elements


Name Description Type Required
Language-sensitive ESS author name. Should not be longer then 64 characters. String TRUE
Define URI where more information is available about the author. IRI RFC2396 TRUE
Define author first name. Should not be longer then 128 characters. String FALSE
Define author last name. Should not be longer then 128 characters. String FALSE
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
Define the complete address: street name, street number, building number. Should not be longer then 512 chars. String FALSE
Define city location name. Should not be longer then 128 characters String FALSE
Define the postal code. Common international structure is five numbers. String FALSE
Define event's region, state or department name. Should not be longer then 128 chars. String FALSE
Define event's region, state or department code name (should be 2 chars). String FALSE
Define event's country name. (e.g. : United States of Americas) String FALSE
Define event's country code in the international format (should be 2 chars). String ISO3166 FALSE
Define representative email. Email RFC822 FALSE
Define representative phone. String FALSE




ESS authors sample

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

 version="1.0" encoding="UTF-8"?>
 xmlns="https://eventstandardsyndication.org/history/0.9" version="0.9" lang="en">
   ...
   >
 
       
       type="author">
         >Event author>
         >http://example.org/index.html>
         >John>
         >Doe>
         >Sample ltd.>
         
>
123, 5th ave / 45st E - #504> >New York> >10012> >New York> >NY> >United States of Americas> >US> >[email protected]> >1 (646) 255 9999> >   type="contributor"> >Event writer contributor> >Janette> >Doe> >   > ... >






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