Documentation for SportsML

Version: 0.5
Creator: IPTC
PublicId: -//IPTC//SportsML DTD 0.5//EN

Description

SportsML aims to be a global XML standard for the interchange of sports data. Designed to be as easy to understand and implement as possible, SportsML allows for the exchange of sports scores, schedules, standings, and statistics for a wide variety of competitions. Its extensibility allows for the easy accommodation of many sports from around the globe. It cooperates with current IPTC standards NewsML and NITF to enable publishers to package sports statistics alongside edited coverage of sports.

Root elements

Element index

ContentItem A placeholder container.
advisory A short textual message to editors receiving the document.
article Holds either an article or a reference to an article.
associate Manager or coach or jockey, etc.
associate-metadata Metadata that describes an associate
associate-metadata-for-specific-sport Not an actual SportsML element.
associate-stats Statistics that capture values about the participation of an associate during one or more sports-events.
associate-stats-for-specific-sport Not an actual SportsML element.
award TBD.
career-phase A description of where a player is playing, or has previously played.
event-actions event-actions.
event-actions-for-specific-sport Not an actual SportsML element.
event-metadata TBD.
event-metadata-for-specific-sport Not an actual SportsML element.
event-record A world, national, state, or school record.
event-sponsor A sponsor for an event.
highlight A textual highlight.
home-location A location.
name Name of a player, official, associate, team, etc.
official Also referred to as umpire or referre.
official-metadata Metadata about the official.
official-metadata-for-specific-sport Not an actual SportsML element.
official-stats Statistics about the official.
official-stats-for-specific-sport Not an actual SportsML element.
officials A set of officials.
outcome-totals A report on the number of wins, losses, etc., the team or player had during a particular time period.
penalty-stats Statistics that detail the number of each type of penalty.
player A competitor.
player-metadata Metadata that describes a player.
player-metadata-for-specific-sport Not an actual SportsML element.
player-stats Statistics that capture how a player has performed.
player-stats-for-specific-sport Not an actual SportsML element.
prize TBD.
rank How a team is doing in comparison to other teams or players.
schedule A series of games.
schedule-metadata TBD.
sports-content Metadata and coverage of sporting news.
sports-content-code An individual code that describes an entity one may want to filter for.
sports-content-codes A container for content-codes.
sports-content-qualifier Further refinement/elaboration of a sports-content-code.
sports-event A sporting competition.
sports-metadata Metadata for the document being published.
sports-title A short textual description of the document.
standing A series of team or individual records.
standing-metadata A series of team or individual records.
statistic TBD.
statistic-metadata A series of team or individual records.
sub-score Statistics that detail the score for a particular period or inning.
sub-score-attempts Statistics that detail the scoring attempts for a particular period or inning.
team A team participating in a sporting event.
team-metadata Info about the team. Properties of a team that are not based on their competitive performance.
team-metadata-for-specific-sport Not an actual SportsML element.
team-stats Statistics that apply to the team as a whole.
team-stats-for-specific-sport Not an actual SportsML element.
tournament A structured series of competitions within one sport.
tournament-division A tournament subcategory, often with its own trophy and prize.
tournament-division-for-specific-sport Not an actual SportsML element.
tournament-division-metadata TBD.
tournament-metadata TBD.
tournament-metadata-for-specific-sport Not an actual SportsML element.
tournament-round Sub-component of tournament-division.

Element descriptions

ContentItem

A placeholder container. Can be used to group examples. Also can show how sports-content fits within NewsML.

Attributes

Name Description
Type (Declaration) Default
id TBD.
ID (#IMPLIED )

Parents

Must appear as the root element.

Content model

((sports-content)+ )

advisory

A short textual message to editors receiving the document. Not generally published through to end-users.

Attributes

Name Description
Type (Declaration) Default
id An XML-specific identifier for the element.
ID (#IMPLIED )

Parents

sports-metadata

Content model

(#PCDATA)*

article

Holds either an article or a reference to an article. Recommended format is NITF.

Attributes

Name Description
Type (Declaration) Default
article-ref URL or system identifier (or IDREF?) to an externally-located news article.
CDATA (#IMPLIED )
class An open placeholder for categorization.
CDATA (#IMPLIED )
format Format for the included content.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
style An open placeholder for reference by an external stylesheet.
CDATA (#IMPLIED )

Parents

sports-content

Content model

ANY

associate

Manager or coach or jockey, etc. An individual or a group that assists a team or player, and functions in a supporting capacity.

Attributes

Name Description
Type (Declaration) Default
id An XML-specific identifier for the element.
ID (#IMPLIED )

Parents

player team

Content model

(associate-metadata , associate-stats?)

associate-metadata

Metadata that describes an associate Generally does not change over the course of a sports-events.

Attributes

Name Description
Type (Declaration) Default
associate-key The symbol for the associate.
CDATA (#IMPLIED )
associate-source The maintainer of the controlled vocabulary for the key.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
position A displayable name for the key.
CDATA (#IMPLIED )

Parents

associate

Content model

(name* , home-location? , (associate-metadata-for-specific-sport)? , )

associate-metadata-for-specific-sport

Not an actual SportsML element. This is where a plug-in element, such as associate-metadata-ice-hockey, would fit in.

Attributes

Name Description
Type (Declaration) Default
id The XML ID.
ID (#IMPLIED )

Parents

associate-metadata

Content model

EMPTY

associate-stats

Statistics that capture values about the participation of an associate during one or more sports-events. Generally does change over the course of a sports-event.

Attributes

Name Description
Type (Declaration) Default
id An XML-specific identifier for the element.
ID (#IMPLIED )

Parents

associate

Content model

(associate-stats-for-specific-sport)?

associate-stats-for-specific-sport

Not an actual SportsML element. This is where a plug-in element, such as associate-stats-ice-hockey, would fit in.

Attributes

Name Description
Type (Declaration) Default
id The XML ID.
ID (#IMPLIED )

Parents

associate-stats

Content model

EMPTY

award

TBD. TBD.

Attributes

Name Description
Type (Declaration) Default
award-name Displayable name. For NHL Hockey, could be first-star, second-star, etc.
CDATA (#IMPLIED )
award-type Type of award. Controlled vocabulary.
CDATA (#IMPLIED )
class An open placeholder for categorization.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
player-or-team-idref Reference to the player or team that received the award.
IDREF (#IMPLIED )
style An open placeholder for reference by an external stylesheet.
CDATA (#IMPLIED )

Parents

player-stats sports-event team-stats

Content model

EMPTY

career-phase

A description of where a player is playing, or has previously played. Can be used to state where the player went to college. Can also list previous teams of the player.

Attributes

Name Description
Type (Declaration) Default
duration In lieu of a start-date and end-date. Generally in years. Could hold the number of years that a player was a pro.
CDATA (#IMPLIED )
end-date When the player started this phase in the career. Could hold a year of graduation.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
name Name of the team or college, for example.
CDATA (#IMPLIED )
start-date When the player started this phase in the career.
CDATA (#IMPLIED )
type Value can be college or professional, etc. Controlled vocabulary.
CDATA (#IMPLIED )

Parents

player-metadata

Content model

EMPTY

event-actions

event-actions. event-actions.

Attributes

Name Description
Type (Declaration) Default
id An XML-specific identifier for the element.
ID (#IMPLIED )

Parents

sports-event

Content model

(event-actions-for-specific-sport)?

event-actions-for-specific-sport

Not an actual SportsML element. This is where a plug-in element, such as event-actions-ice-hockey, would fit in.

Attributes

Name Description
Type (Declaration) Default
id The XML ID.
ID (#IMPLIED )

Parents

event-actions

Content model

EMPTY

event-metadata

TBD. TBD.

Attributes

Name Description
Type (Declaration) Default
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
['events-home', 'events-away'] (#IMPLIED )
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
['division', 'division-opposing', 'conference', 'conference-opposing', 'league', 'top-25'] (#IMPLIED )
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
['period', 'event', 'tournament', 'tournament-pool', 'tournament-seed', 'recent-ten-events', 'hourly', 'daily', 'weekly', 'monthly', 'season-exhibition', 'season-regular', 'season-playoffs', 'season-full'] (#IMPLIED )
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
CDATA (#IMPLIED )
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
['events-overtime', 'events-shootout', 'events-most-recent-10'] (#IMPLIED )
end-date-time Time the game ends.
CDATA (#IMPLIED )
end-weekday Day of the week in which the game ends.
['sunday', 'monday', 'tuesday', 'wednesday', 'thursday', 'friday', 'saturday'] (#IMPLIED )
event-key The symbol for the identified sports-event.
CDATA (#IMPLIED )
event-name A displayable name for the key.
CDATA (#IMPLIED )
event-number TBD.
CDATA (#IMPLIED )
event-source The maintainer of the controlled vocabulary for the key.
CDATA (#IMPLIED )
event-status pre-event, mid-event, post-event.
['pre-event', 'mid-event', 'post-event'] (#IMPLIED )
event-style Indicates whether competitors are trying to defeat each other - head-to-head - or just outdo one another - ranked.
['head-to-head', 'ranked'] (#IMPLIED )
heat-number TBD.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
postponement-note TBD.
CDATA (#IMPLIED )
postponement-status TBD.
['none', 'weather-delay', 'other'] (#IMPLIED )
site-alignment Whether the site is neutral with respect to the competitors, or is the often-used site of the home team.
['home', 'neutral'] (#IMPLIED )
site-attendance How many spectators attended during the event.
CDATA (#IMPLIED )
site-capacity How many spectators can fill the site.
CDATA (#IMPLIED )
site-city City in which the site is located.
CDATA (#IMPLIED )
site-country Country in which the site is located. Generally, a two-letter ISO code.
CDATA (#IMPLIED )
site-county County in which the site is located.
CDATA (#IMPLIED )
site-key The symbol for the site at which the event is played.
CDATA (#IMPLIED )
site-name A displayable name for the key.
CDATA (#IMPLIED )
site-source The maintainer of the controlled vocabulary for the key.
CDATA (#IMPLIED )
site-state State or province in which the site is located.
CDATA (#IMPLIED )
site-style Whether it is an indoor or outdoor site. Controlled vocabulary.
CDATA (#IMPLIED )
site-surface Describes the surface upon which events are played. For example, in tennis, could be hard-court or grass or clay. Controlled vocabulary.
CDATA (#IMPLIED )
site-temperature Temperature of the event recorded during the competition.
CDATA (#IMPLIED )
site-temperature-units Units of the temperature value.
CDATA (#IMPLIED )
site-weather-label Additional comment about the weather.
CDATA (#IMPLIED )
site-weather-wind Wind reading of the event recorded during the competition.
CDATA (#IMPLIED )
start-date-time Time the game starts. Generally in 20011116T152300 format.
CDATA (#IMPLIED )
start-weekday Day of the week in which the game starts.
['sunday', 'monday', 'tuesday', 'wednesday', 'thursday', 'friday', 'saturday'] (#IMPLIED )
stats-coverage A relative indication of how many statistics are included in the item.
['compact', 'standard', 'expanded'] (#IMPLIED )
team-coverage Indicates whether the item contains information about one team, or many teams.
['single-team', 'multi-team'] (#IMPLIED )

Parents

sports-event

Content model

(sports-content-codes? , (event-metadata-for-specific-sport)? , event-sponsor*)

event-metadata-for-specific-sport

Not an actual SportsML element. This is where a plug-in element, such as event-metadata-ice-hockey, would fit in.

Attributes

Name Description
Type (Declaration) Default
id The XML ID.
ID (#IMPLIED )

Parents

event-metadata

Content model

EMPTY

event-record

Attributes

Name Description
Type (Declaration) Default
previous-record The score value of the previously-held record.
CDATA (#IMPLIED )
type The type or record.
CDATA (#IMPLIED )

Parents

player-stats team-stats

Content model

EMPTY

event-sponsor

A sponsor for an event. Events can have more than one sponsor.

Attributes

Name Description
Type (Declaration) Default
id An XML-specific identifier for the element.
ID (#IMPLIED )
name The name of the sponsor.
CDATA (#IMPLIED )
type Could be main, supporting, etc.
CDATA (#IMPLIED )

Parents

event-metadata

Content model

EMPTY

highlight

A textual highlight. Can hold plain text, or could hold NITF.

Attributes

Name Description
Type (Declaration) Default
class An open placeholder for categorization.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
style An open placeholder for reference by an external stylesheet.
CDATA (#IMPLIED )

Parents

sports-event

Content model

ANY

home-location

Attributes

Name Description
Type (Declaration) Default
city The city.
CDATA (#IMPLIED )
country The country. Generally, an ISO two-letter country-code.
CDATA (#IMPLIED )
county The county.
CDATA (#IMPLIED )
state The state or province.
CDATA (#IMPLIED )

Parents

associate-metadata official-metadata player-metadata team-metadata

Content model

EMPTY

name

Name of a player, official, associate, team, etc. Sometimes a person is referred-to by different names, depending upon the language in which the document is displayed.

Attributes

Name Description
Type (Declaration) Default
first The first name refered to.
CDATA (#IMPLIED )
full The entire name.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
language A language code in which it is appropriate to display this name.
CDATA (#IMPLIED )
last The first name referred to.
CDATA (#IMPLIED )
middle The middle name refered to.
CDATA (#IMPLIED )
nickname A nickname ascribed to the person or team.
CDATA (#IMPLIED )

Parents

associate-metadata official-metadata player-metadata team-metadata

Content model

EMPTY

official

Also referred to as umpire or referre. Ensures that the sports-event is played according to its rules.

Attributes

Name Description
Type (Declaration) Default
id An XML-specific identifier for the element.
ID (#IMPLIED )

Parents

officials

Content model

(official-metadata , official-stats?)

official-metadata

Metadata about the official. Generally does not change over the course of a sports-events.

Attributes

Name Description
Type (Declaration) Default
id An XML-specific identifier for the element.
ID (#IMPLIED )
official-key TBD.
CDATA (#IMPLIED )
official-source TBD.
CDATA (#IMPLIED )
position TBD.
CDATA (#IMPLIED )

Parents

official

Content model

(name* , home-location? , (official-metadata-for-specific-sport)? , )

official-metadata-for-specific-sport

Not an actual SportsML element. This is where a plug-in element, such as official-metadata-ice-hockey, would fit in.

Attributes

Name Description
Type (Declaration) Default
id The XML ID.
ID (#IMPLIED )

Parents

official-metadata

Content model

EMPTY

official-stats

Statistics about the official. Generally does change over the course of a sports-events..

Attributes

Name Description
Type (Declaration) Default
id An XML-specific identifier for the element.
ID (#IMPLIED )

Parents

official

Content model

(official-stats-for-specific-sport)?

official-stats-for-specific-sport

Not an actual SportsML element. This is where a plug-in element, such as official-stats-ice-hockey, would fit in.

Attributes

Name Description
Type (Declaration) Default
id The XML ID.
ID (#IMPLIED )

Parents

official-stats

Content model

EMPTY

officials

A set of officials. May hold zero or more.

Attributes

Name Description
Type (Declaration) Default
id An XML-specific identifier for the element.
ID (#IMPLIED )

Parents

sports-event

Content model

(official*)

outcome-totals

A report on the number of wins, losses, etc., the team or player had during a particular time period. Can also be scoped with various coverage qualifications, such as just events played at home.

Attributes

Name Description
Type (Declaration) Default
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
['events-home', 'events-away'] (#IMPLIED )
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
['division', 'division-opposing', 'conference', 'conference-opposing', 'league', 'top-25'] (#IMPLIED )
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
['period', 'event', 'tournament', 'tournament-pool', 'tournament-seed', 'recent-ten-events', 'hourly', 'daily', 'weekly', 'monthly', 'season-exhibition', 'season-regular', 'season-playoffs', 'season-full'] (#IMPLIED )
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
CDATA (#IMPLIED )
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
['events-overtime', 'events-shootout', 'events-most-recent-10'] (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
losses Number of losses.
CDATA (#IMPLIED )
points-scored-against The number of points scored against a team by its opponents during an extended time period.
CDATA (#IMPLIED )
points-scored-for The number of points a team has scored against its opponents during an extended time period.
CDATA (#IMPLIED )
standing-points A quantity used to rank teams, usually within a division, in order to decide who comes in first at the end of a season. Localized to the coverage-attributes.
CDATA (#IMPLIED )
stats-coverage A relative indication of how many statistics are included in the item.
['compact', 'standard', 'expanded'] (#IMPLIED )
team-coverage Indicates whether the item contains information about one team, or many teams.
['single-team', 'multi-team'] (#IMPLIED )
ties Number of ties.
CDATA (#IMPLIED )
undecideds Number of events that were started, but ended up undecided.
CDATA (#IMPLIED )
winning-percentage The winning percentage. Generally, wins divided by total events completed.
CDATA (#IMPLIED )
wins Number of wins.
CDATA (#IMPLIED )

Parents

player-stats team-stats

Content model

EMPTY

penalty-stats

Statistics that detail the number of each type of penalty. Can be recorded for either a team or a player.

Attributes

Name Description
Type (Declaration) Default
count The number of that type of penalities for this team or player.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
type Could be a numeric value like 2, 5 or 10 for ice hockey, or yellow-card or red-card for soccer etc.
CDATA (#IMPLIED )

Parents

player-stats team-stats

Content model

EMPTY

player

A competitor. Their athletic talents help them decide who wins a sports-event.

Attributes

Name Description
Type (Declaration) Default
id An XML-specific identifier for the element.
ID (#IMPLIED )

Parents

sports-event standing statistic team tournament-round

Content model

(player-metadata , player-stats? , associate*)

player-metadata

Metadata that describes a player. Generally does not change over the course of a sports-events.

Attributes

Name Description
Type (Declaration) Default
date-of-birth The day on which a player was born. Generally in ISO format.
CDATA (#IMPLIED )
health An indication of the health of the player. Values will probably be moved to a separate controlled vocabulary.
['injured', 'fine'] (#IMPLIED )
height Height of the player. Generally in cm.
CDATA (#IMPLIED )
home-page-url The fully-qualified URL for the official home page of the team.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
player-key The symbol for the player.
CDATA (#IMPLIED )
player-source The maintainer of the controlled vocabulary for the key.
CDATA (#IMPLIED )
position-event The code for the position played by the player at this particular sports-event. Sport-specific controlled vocabulary.
CDATA (#IMPLIED )
position-regular The code for the typical position at which this player playes. Sport-specific controlled vocabulary.
CDATA (#IMPLIED )
status Whether a player starts playing at the beginning of a sports-event, joins mid-game, or is not available to participate.
['starter', 'bench', 'scratched'] (#IMPLIED )
team-idref A reference to the team for which this player competes.
IDREF (#IMPLIED )
uniform-number The number currently displayed on the uniform or jersey of the player.
CDATA (#IMPLIED )
weight Weight of a player. Generally in kg.
CDATA (#IMPLIED )

Parents

player

Content model

(name* , home-location? , career-phase* , (player-metadata-for-specific-sport)? , )

player-metadata-for-specific-sport

Not an actual SportsML element. This is where a plug-in element, such as player-metadata-ice-hockey, would fit in.

Attributes

Name Description
Type (Declaration) Default
id The XML ID.
ID (#IMPLIED )

Parents

player-metadata

Content model

EMPTY

player-stats

Statistics that capture how a player has performed. Generally does change over the course of a sports-event.

Attributes

Name Description
Type (Declaration) Default
event-odds The odds that this team or player would win the event.
CDATA (#IMPLIED )
event-outcome Whether the competitor won, lost, or tied.
['win', 'loss', 'tie', 'undecided'] (#IMPLIED )
event-points How many new points were earned as a result of the outcome of this particular event.
CDATA (#IMPLIED )
event-rank Rank of the team or player amidst its competitors.
CDATA (#IMPLIED )
event-score Final or current score of the team or player.
CDATA (#IMPLIED )
event-score-attempts Final or current number of attempts to score by a team or player. Example: in ice hockey, would represent total shots on goal.
CDATA (#IMPLIED )
event-score-percentage Percentage of attempted scores that reached their mark.
CDATA (#IMPLIED )
event-score-units Describes how the score is valued. Controlled vocabulary: time-absolute, time-relative, below-par.
CDATA (#IMPLIED )
events-played Number of sports-events the player has participated in.
CDATA (#IMPLIED )
events-started Number of sports-events the player has played in since the start of the event.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
result-effect Describes the effect that the result of the event or rank changing has had on the team. Example: Whether or not a team has qualified for the playoffs, or has been promoted or demoted to a different division. Values kept in controlled vocabulary.
CDATA (#IMPLIED )
time-played-event Value for the amount of time played by this player in a particular sports-event.
CDATA (#IMPLIED )
time-played-total Value for the amount of time played by the player over the course particular time-span, such as a season.
CDATA (#IMPLIED )

Parents

player

Content model

(sub-score* , sub-score-attempts* , penalty-stats* , outcome-totals* , award* , event-record* , rank* , (player-stats-for-specific-sport)? , )

player-stats-for-specific-sport

Not an actual SportsML element. This is where a plug-in element, such as player-stats-ice-hockey, would fit in.

Attributes

Name Description
Type (Declaration) Default
id The XML ID.
ID (#IMPLIED )

Parents

player-stats

Content model

EMPTY

prize

TBD. TBD.

Attributes

Name Description
Type (Declaration) Default
currency The units of currency for the value attribute.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
place The place for which this prize is offered. For example, place=1 means the first-place prize.
CDATA (#IMPLIED )
value The amount of money earned by the player who came in this place.
CDATA (#IMPLIED )

Parents

tournament-division-metadata

Content model

EMPTY

rank

How a team is doing in comparison to other teams or players. May be qualified, so that one ranks teams or players according to, say, how they play at home, or within their division.

Attributes

Name Description
Type (Declaration) Default
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
['events-home', 'events-away'] (#IMPLIED )
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
['division', 'division-opposing', 'conference', 'conference-opposing', 'league', 'top-25'] (#IMPLIED )
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
['period', 'event', 'tournament', 'tournament-pool', 'tournament-seed', 'recent-ten-events', 'hourly', 'daily', 'weekly', 'monthly', 'season-exhibition', 'season-regular', 'season-playoffs', 'season-full'] (#IMPLIED )
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
CDATA (#IMPLIED )
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
['events-overtime', 'events-shootout', 'events-most-recent-10'] (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
stats-coverage A relative indication of how many statistics are included in the item.
['compact', 'standard', 'expanded'] (#IMPLIED )
team-coverage Indicates whether the item contains information about one team, or many teams.
['single-team', 'multi-team'] (#IMPLIED )
value The value of the rank.
CDATA (#IMPLIED )

Parents

player-stats team-stats

Content model

EMPTY

schedule

A series of games. A series of games.

Attributes

Name Description
Type (Declaration) Default
content-label Displayable label that describes what events this schedule includes.
CDATA (#IMPLIED )
date-label Displayable label that describes what dates this schedule covers.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )

Parents

sports-content

Content model

(schedule-metadata , sports-event*)

schedule-metadata

TBD. TBD.

Attributes

Name Description
Type (Declaration) Default
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
['events-home', 'events-away'] (#IMPLIED )
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
['division', 'division-opposing', 'conference', 'conference-opposing', 'league', 'top-25'] (#IMPLIED )
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
['period', 'event', 'tournament', 'tournament-pool', 'tournament-seed', 'recent-ten-events', 'hourly', 'daily', 'weekly', 'monthly', 'season-exhibition', 'season-regular', 'season-playoffs', 'season-full'] (#IMPLIED )
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
CDATA (#IMPLIED )
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
['events-overtime', 'events-shootout', 'events-most-recent-10'] (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
stats-coverage A relative indication of how many statistics are included in the item.
['compact', 'standard', 'expanded'] (#IMPLIED )
team-coverage Indicates whether the item contains information about one team, or many teams.
['single-team', 'multi-team'] (#IMPLIED )

Parents

schedule

Content model

(sports-content-codes?)

sports-content

Metadata and coverage of sporting news. Good for scores, schedules, standings, statistics, etc.

Attributes

Name Description
Type (Declaration) Default
id An XML-specific identifier for the element.
ID (#IMPLIED )

Parents

ContentItem

Content model

(sports-metadata , (sports-event | tournament | schedule | standing | statistic | article)* , )

sports-content-code

An individual code that describes an entity one may want to filter for. Describes what sports, leagues, teams, etc., are covered.

Attributes

Name Description
Type (Declaration) Default
code-key The symbol for the identified content.
CDATA (#IMPLIED )
code-name A displayable name for the code.
CDATA (#IMPLIED )
code-source The maintainer of the controlled vocabulary for the code.
CDATA (#IMPLIED )
code-type What type of item is being described. May be moved to an external controlled vocabulary.
['sport-class', 'sport-category', 'sport', 'sport-competition', 'league', 'conference', 'division', 'team', 'special-event', 'site'] (#REQUIRED )
id An XML-specific identifier for the element.
ID (#IMPLIED )

Parents

sports-content-codes team-metadata

Content model

(sports-content-qualifier)*

sports-content-codes

A container for content-codes. Can hold as many codes as needed to describe all contents at this level and below.

Attributes

Name Description
Type (Declaration) Default
id An XML-specific identifier for the element.
ID (#IMPLIED )

Parents

event-metadata schedule-metadata sports-metadata standing-metadata statistic-metadata tournament-metadata

Content model

(sports-content-code)*

sports-content-qualifier

Further refinement/elaboration of a sports-content-code. If the document covers more than one of these, additional sports-content-qualifier elements may be used.

Attributes

Name Description
Type (Declaration) Default
age-group If the events covered are limited to a specific age-range. (controlled vocabulary)
CDATA (#IMPLIED )
gender One specific gender or mixed. (controlled vocabulary)
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
participant-count Number of participants playing on a team or side in the events covered. (controlled vocabulary)
CDATA (#IMPLIED )
professional-status The professional-status of the events covered. (controlled vocabulary)
CDATA (#IMPLIED )
special-group If the events covered are for special groups. The samples listed here are school-oriented but it could be things like the firefighters world championships. (controlled vocabulary)
CDATA (#IMPLIED )
special-needs Events for persons with special-needs. (controlled vocabulary)
CDATA (#IMPLIED )

Parents

sports-content-code tournament-division-metadata

Content model

EMPTY

sports-event

A sporting competition. A contest that generally ends with a winner.

Attributes

Name Description
Type (Declaration) Default
id An XML-specific identifier for the element.
ID (#IMPLIED )

Parents

schedule sports-content sports-event tournament-round

Content model

(event-metadata? , (team+ | player+) , officials? , event-actions? , highlight* , award* , sports-event*)

sports-metadata

Metadata for the document being published. Holds metadata applying to the document as a whole.

Attributes

Name Description
Type (Declaration) Default
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
['events-home', 'events-away'] (#IMPLIED )
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
['division', 'division-opposing', 'conference', 'conference-opposing', 'league', 'top-25'] (#IMPLIED )
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
['period', 'event', 'tournament', 'tournament-pool', 'tournament-seed', 'recent-ten-events', 'hourly', 'daily', 'weekly', 'monthly', 'season-exhibition', 'season-regular', 'season-playoffs', 'season-full'] (#IMPLIED )
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
CDATA (#IMPLIED )
date-time Date-timestamp for the document. Final format TBD.
CDATA (#IMPLIED )
doc-id The often-unique ID of the document, tracked by publishers. Final format TBD.
CDATA (#REQUIRED )
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
['events-overtime', 'events-shootout', 'events-most-recent-10'] (#IMPLIED )
feature-name A publisher-created subset of the fixture-key.
CDATA (#IMPLIED )
fixture-key A consistent key for the type of regularly-published document being transmitted.
CDATA (#IMPLIED )
fixture-name A displayable name for the fixture-key.
CDATA (#IMPLIED )
fixture-source The maintainer of the controlled-vocabulary of fixture-keys.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
language The default language of the document. May be overridden via xml:lang. In ISO format - example: en-US.
CDATA (#IMPLIED )
publisher Publisher of the data.
CDATA (#IMPLIED )
slug A keyword used by editors to refer to the document.
CDATA (#IMPLIED )
stats-coverage A relative indication of how many statistics are included in the item.
['compact', 'standard', 'expanded'] (#IMPLIED )
team-coverage Indicates whether the item contains information about one team, or many teams.
['single-team', 'multi-team'] (#IMPLIED )

Parents

sports-content

Content model

(sports-title , advisory? , sports-content-codes?)

sports-title

A short textual description of the document. Can show up in search results.

Attributes

Name Description
Type (Declaration) Default
id An XML-specific identifier for the element.
ID (#IMPLIED )

Parents

sports-metadata

Content model

(#PCDATA)*

standing

A series of team or individual records. A series of team or individual records.

Attributes

Name Description
Type (Declaration) Default
content-label TBD.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )

Parents

sports-content

Content model

(standing-metadata , (team* | player*) , )

standing-metadata

A series of team or individual records. A series of team or individual records.

Attributes

Name Description
Type (Declaration) Default
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
['events-home', 'events-away'] (#IMPLIED )
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
['division', 'division-opposing', 'conference', 'conference-opposing', 'league', 'top-25'] (#IMPLIED )
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
['period', 'event', 'tournament', 'tournament-pool', 'tournament-seed', 'recent-ten-events', 'hourly', 'daily', 'weekly', 'monthly', 'season-exhibition', 'season-regular', 'season-playoffs', 'season-full'] (#IMPLIED )
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
CDATA (#IMPLIED )
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
['events-overtime', 'events-shootout', 'events-most-recent-10'] (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
stats-coverage A relative indication of how many statistics are included in the item.
['compact', 'standard', 'expanded'] (#IMPLIED )
team-coverage Indicates whether the item contains information about one team, or many teams.
['single-team', 'multi-team'] (#IMPLIED )

Parents

standing

Content model

(sports-content-codes?)

statistic

TBD. TBD.

Attributes

Name Description
Type (Declaration) Default
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
['events-home', 'events-away'] (#IMPLIED )
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
['division', 'division-opposing', 'conference', 'conference-opposing', 'league', 'top-25'] (#IMPLIED )
content-label Displayable label that describes what content this statistic covers.
CDATA (#IMPLIED )
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
['period', 'event', 'tournament', 'tournament-pool', 'tournament-seed', 'recent-ten-events', 'hourly', 'daily', 'weekly', 'monthly', 'season-exhibition', 'season-regular', 'season-playoffs', 'season-full'] (#IMPLIED )
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
CDATA (#IMPLIED )
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
['events-overtime', 'events-shootout', 'events-most-recent-10'] (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
stats-coverage A relative indication of how many statistics are included in the item.
['compact', 'standard', 'expanded'] (#IMPLIED )
team-coverage Indicates whether the item contains information about one team, or many teams.
['single-team', 'multi-team'] (#IMPLIED )
type The type of statistic.
CDATA (#IMPLIED )

Parents

sports-content

Content model

(statistic-metadata , (team* | player*) , )

statistic-metadata

A series of team or individual records. TBD.

Attributes

Name Description
Type (Declaration) Default
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
['events-home', 'events-away'] (#IMPLIED )
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
['division', 'division-opposing', 'conference', 'conference-opposing', 'league', 'top-25'] (#IMPLIED )
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
['period', 'event', 'tournament', 'tournament-pool', 'tournament-seed', 'recent-ten-events', 'hourly', 'daily', 'weekly', 'monthly', 'season-exhibition', 'season-regular', 'season-playoffs', 'season-full'] (#IMPLIED )
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
CDATA (#IMPLIED )
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
['events-overtime', 'events-shootout', 'events-most-recent-10'] (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
stats-coverage A relative indication of how many statistics are included in the item.
['compact', 'standard', 'expanded'] (#IMPLIED )
team-coverage Indicates whether the item contains information about one team, or many teams.
['single-team', 'multi-team'] (#IMPLIED )

Parents

statistic

Content model

(sports-content-codes?)

sub-score

Attributes

Name Description
Type (Declaration) Default
period-value Could be quarter-1, period-2, inning-5, etc.
CDATA (#IMPLIED )
score The score for that period.
CDATA (#IMPLIED )

Parents

player-stats team-stats

Content model

EMPTY

sub-score-attempts

Attributes

Name Description
Type (Declaration) Default
period-value Could be quarter-1, period-2, inning-5, etc.
CDATA (#IMPLIED )
score-attempts The score for that period.
CDATA (#IMPLIED )

Parents

player-stats team-stats

Content model

EMPTY

team

A team participating in a sporting event. Holds code and names for team.

Attributes

Name Description
Type (Declaration) Default
id An XML-specific identifier for the element.
ID (#IMPLIED )

Parents

sports-event standing statistic tournament-round

Content model

(team-metadata , team-stats? , player* , associate*)

team-metadata

Info about the team. Properties of a team that are not based on their competitive performance. An included sports-content-code element can hold what division it is in, etc.

Attributes

Name Description
Type (Declaration) Default
alignment Home or visiting.
['home', 'away', 'none'] (#IMPLIED )
home-page-url The fully-qualified URL for the official home page of the team.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
team-idref Optional reference to a team in which this team is a member. Example: The U.S. Davis Cup team consists of many sub-teams.
IDREF (#IMPLIED )
team-key A unique identifier for the team.
CDATA (#IMPLIED )
team-source The maintainer of the controlled vocabulary for the team-key.
CDATA (#IMPLIED )

Parents

team

Content model

(name* , home-location? , sports-content-code* , (team-metadata-for-specific-sport)? , )

team-metadata-for-specific-sport

Not an actual SportsML element. This is where a plug-in element, such as team-metadata-ice-hockey, would fit in.

Attributes

Name Description
Type (Declaration) Default
id The XML ID.
ID (#IMPLIED )

Parents

team-metadata

Content model

EMPTY

team-stats

Statistics that apply to the team as a whole. Not all stats are used in every sport.

Attributes

Name Description
Type (Declaration) Default
event-odds The odds that this team or player would win the event.
CDATA (#IMPLIED )
event-outcome Whether the competitor won, lost, or tied.
['win', 'loss', 'tie', 'undecided'] (#IMPLIED )
event-points How many new points were earned as a result of the outcome of this particular event.
CDATA (#IMPLIED )
event-rank Rank of the team or player amidst its competitors.
CDATA (#IMPLIED )
event-score Final or current score of the team or player.
CDATA (#IMPLIED )
event-score-attempts Final or current number of attempts to score by a team or player. Example: in ice hockey, would represent total shots on goal.
CDATA (#IMPLIED )
event-score-percentage Percentage of attempted scores that reached their mark.
CDATA (#IMPLIED )
event-score-units Describes how the score is valued. Controlled vocabulary: time-absolute, time-relative, below-par.
CDATA (#IMPLIED )
events-played The number of sports-events in which this team has already participated.
CDATA (#IMPLIED )
games-back A number used to measure how behind one team is from first place. The first place team is 0 games back.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
result-effect Describes the effect that the result of the event or rank changing has had on the team. Example: Whether or not a team has qualified for the playoffs, or has been promoted or demoted to a different division. Values kept in controlled vocabulary.
CDATA (#IMPLIED )
standing-points A quantity used to rank teams, usually within a division, in order to decide who comes in first at the end of a season.
CDATA (#IMPLIED )
streak A value used to say how many events in a row the team has most recently won or lost. Format is win-3 or loss-4 or tie-1.
CDATA (#IMPLIED )

Parents

team

Content model

(sub-score* , sub-score-attempts* , penalty-stats* , outcome-totals* , award* , event-record* , rank* , (team-stats-for-specific-sport)? , )

team-stats-for-specific-sport

Not an actual SportsML element. This is where a plug-in element, such as team-stats-ice-hockey, would fit in.

Attributes

Name Description
Type (Declaration) Default
id The XML ID.
ID (#IMPLIED )

Parents

team-stats

Content model

EMPTY

tournament

A structured series of competitions within one sport. Generally organized by a particular sponsoring body. Can happen all in one day, or be spread out - like the Davis Cup in tennis.

Attributes

Name Description
Type (Declaration) Default
id An XML-specific identifier for the element.
ID (#IMPLIED )

Parents

sports-content

Content model

(tournament-metadata? , tournament-division*)

tournament-division

A tournament subcategory, often with its own trophy and prize. Like Mens 30k Nordic Skiing, Womens Doubles.

Attributes

Name Description
Type (Declaration) Default
id An XML-specific identifier for the element.
ID (#IMPLIED )

Parents

tournament

Content model

(tournament-division-metadata? , tournament-round*)

tournament-division-for-specific-sport

Not an actual SportsML element. This is where a plug-in element, such as tournament-division-ice-hockey, would fit in.

Attributes

Name Description
Type (Declaration) Default
id The XML ID.
ID (#IMPLIED )

Parents

tournament-division-metadata

Content model

EMPTY

tournament-division-metadata

TBD. TBD.

Attributes

Parents

tournament-division

Content model

(sports-content-qualifier? , prize* , (tournament-division-for-specific-sport)? , )
Name Description
Type (Declaration) Default
division-key TBD.
CDATA (#IMPLIED )
division-name TBD.
CDATA (#IMPLIED )
division-source TBD.
CDATA (#IMPLIED )
end-date-time TBD.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )