ESS:People

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

"People" definition

An event is comprised of different concepts, one of the most important is to describe the people involved in the event. The number of people involved in the organization of an event depends upon the size and scale of the event. While organizing a small party may require only one or two people, organizing a very large event like the Olympics may require several thousand people.
Events have three main people components, which are represented in ESS by three "type" attributes within <item> (ess:item) XML elements :


Event organizer icon Event performer icon Event attendee icon Event social networks icon event author icon event contributor icon

ORGANIZER

PERFORMER

ATTENDEES

SOCIAL NETWOK

FEED AUTHOR

CONTRIBUTOR

People who work behind the scenes of the event.

People who work onstage or perform durring the event.

People who visit the event, event audience.

Defines the social medias used to promote, rate and share the event.

Defines the specific event feed writing issuer.

Defines the event contributor: assistant, special thanks...



ESS <people> structure

ESS documents are composed by various main XML elements. ESS processors must consider each and every element's descriprion as valid and applicable to each and every other XML element within the same ESS document feed (ess:feed). If it is not the case, it belong to an other XML <feed> element to describe this event parameter.
Example: every <prices> items must be valid and applicable to every <dates> and <places> items within the same <feed> element.

<people> XML element (ess:people) must be defined within ESS Documents, it is a mandatory ESS XML element. This section describe the interaction between ESS events and people. <people> (ess:people) XML element.
Several <item> elements can be defined within <people> XML structure to represent the various types of people involved in the event.
Organizer section can be in relation with <item type="author"> XML section but event organizer is not necessary event feed publisher.




People <item @attibutes>


Name Description Type Required
type The "type" attribute can take five values: "organizer", "performer", "attendee", "social", "author" or "contributor" to represent each people involved in the event as actors of the event, the promotion or as an attendee. ESS Processors should consider that "organizer" 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



People <item> childs element


Name Description Type Required
<name> Language-sensitive names should not be longer then 128 chars String TRUE
<id> Unique and universal person identifier in a specific taxonomy, ESS processors should use the same value across all ESS document. IRI RFC3987 FALSE
<firstname> Define current person first name. Should not be longer then 128 characters. String FALSE
<lastname> Define current person 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 element is a structured organization (association, group, company). Should not be longer then 256 chars. String FALSE
<logo> Define a URL that points to a large image representation of current individual or company. Image should be web readable (jpg, gif, png, ...) and should not be smaller then 64px (width and height). ESS processors may used this value to represent current individual or company. URI RFC2396 FALSE
<icon> Define a URL that point to a small icon representation of current individual or company. Image should be web readable (jpg, gif, png, ico, ...) and should not be larger then 64px (width and height). ESS processors may used this value in search engine icon results or detail representation. URI RFC2396 FALSE
<uri> Defines a URL that point to a complete individual or organisation description URI RFC2396 FALSE
<address> Defines the complete address: street name, street number, building number. Should not be longer then 512 chars. String FALSE
<city> Defines city location name. Should not be longer then 128 chars String FALSE
<zip> Defines postal code. Common international structure is a five number sequence. String FALSE
<state> Defines event's region, state or department name. Should not be longer then 128 chars. String FALSE
<state_code> Defines event's region, state or department code name (should be 2 chars). String FALSE
<country> Defines event's country name. (e.g. : United States of Americas) String FALSE
<country_code> Defines event's country code in the international format (should be 2 chars). String ISO3166 FALSE
<email> Defines current person email. Email RFC822 FALSE
<phone> Defines current person phone. String FALSE
<minpeople> Only available for item type="attendee". Defines the minimum amount of attendees for this event. If it is not present, ESS processors should consider that 0 is the default value. Number FALSE
<maxpeople> Only available for item type="attendee". Defines the maximum amount of attendees for this event. If it is not present, ESS processors should consider that UNLIMITED is the default value. Number FALSE
<minage> Only available for item type="attendee". Defines the age minimum of attendees for this event. If it is not present, ESS processors should consider that 0 is the default value. Number FALSE
<restriction> Only available for item type="attendee". Defines the list of rules that the attendee should be aware of before attending the event. Number FALSE
<description> This optional XML element contains the specific person description (artist biography, organizer summary...). 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 people sample

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

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE ess PUBLIC "-//ESS//DTD" "http://essfeed.org/history/0.9/index.dtd">
<ess xmlns="http://essfeed.org/history/0.9" version="0.9" lang="en">
   ...
   <people>
 
      <!-- 1 |  Event organizer -->
      <item type="organizer">
         <id>LJLFKJ4687EUYIA46@IUME67176BE7</id>
         <name>Event organizer name</name>
         <firstname>John</firstname>
         <lastname>Doe</lastname>
         <organization>Sample Ltd.</organization>
         <address>123, 5th ave / 49st 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>
         <logo>http://sample.org/img/organizer/logo.jpg</logo>
         <icon>http://sample.org/img/organizer/icon.jpg</icon>
         <uri>http://sample.org/img/organizer/index.html</uri>
         <email>contact@sample.org</email>
         <phone>1 (646) 290 8899</phone>
      </item>
 
      <!-- 2 |  Event performer -->
      <item type="performer">
         <id>LJLFKJ4687EUYIA46@IUME67176BE7</id>
         <name>Event performer name</name>
         <firstname>Janine</firstname>
         <lastname>Madonna</lastname>
         <organization>Madonna llc.</organization>
         <logo>http://madonna.com/logo.jpg</logo>
         <icon>http://madonna.com/icon.jpg</icon>
         <uri>http://madonna.com/index.html</uri>
      </item>
 
      <!-- 3 |  Event attendees -->
      <item type="attendee">
         <name>Event attendees description</name>
         <minpeople>0</minpeople>
         <maxpeople>500</maxpeople>
         <minage>0</minage>
         <restriction>Smoking is not allowed in the stadium</restriction>
      </item>
 
      <!-- 4 | ESS Feed Social Network --> 
      <item type="social">
         <name>Social rating API to rate or share the event</name>
         <uri>http://mySocialNetwork.org/api/get-and-set-rating/</uri>
      </item>
 
      <!-- 5 | ESS Feed author --> 
      <item type="author">
         <name>ESS Feed Powered by MyEventPromotionTool.com</name>
         <uri>http://example.org/index.html</uri>
         <icon>http://example.com/images/icon.png</icon>
         <email>contact@example.org</email>
         <phone>1 (646) 255 9999</phone>
      </item>
 
      <!-- 6 | ESS Feed contributor --> 
      <item type="contributor">
         <name>Janette Doe</name>
      </item>  
 
   </people>
   ...
</ess>



Discussions

ESS Forum Discussion > People

Could not find wordpress article with a title like home







External documentation

Ietf logo.png

ESS standard under RFC validation process: RFC ESS Draft

  • RFC 2396 : Uniform Resource Identifiers (URI): Generic Syntax
  • RFC 3023 : XML Media Types
  • RFC 3987 : Internationalized Resource Identifiers (IRIs)
  • ISO 3166 : ISO 3166

IF EVENTS MATTER TO YOU

Spread the news about ESS
Personal tools
Actions
Standard


Developers


Communication