Documentation for SportsML

Version: 0.7
Creator: IPTC
PublicId: -//IPTC//SportsML DTD 0.7//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

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 A medal, ribbon, placement, or other type of award.
career-phase A description of where a player is playing, or has previously played.
catalog A reference to the document listing externally-supplied controlled vocabularies.
event-actions event-actions.
event-actions-for-specific-sport Not an actual SportsML element.
event-metadata Background information about a game.
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 referree.
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.
rank How a team is doing in comparison to other teams or players.
rating A judged value placed on the team or individual.
schedule A series of games.
schedule-metadata Background information about the schedule.
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-property An extensible property.
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 A table that generally compares the performance of teams or players.
statistic-metadata Identifies which teams are being covered.
status-change Identifies which teams are being covered.
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 General information about the division of this tournament.
tournament-metadata Background data about a tournament.
tournament-metadata-for-specific-sport Not an actual SportsML element.
tournament-round Sub-component of tournament-division.

Element descriptions

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. Sport-specific controlled vocabulary:
CDATA (#IMPLIED )
position-source The source of the controlled-vocabulary for position.
CDATA (#IMPLIED )

Parents

associate

Content model

(name* , home-location? , sports-property* , (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

(rating* , (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

A medal, ribbon, placement, or other type of award. Can be assigned to an event, a team, or a player.

Attributes

Name Description
Type (Declaration) Default
award-type Type of award. (Controlled vocabulary.)
CDATA (#IMPLIED )
class An open placeholder for categorization.
CDATA (#IMPLIED )
currency The units of currency for the value attribute.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
name Displayable name. For NHL Hockey, could be first-star, second-star, etc.
CDATA (#IMPLIED )
place The place for which this prize is offered. For example, place=1 means the first-place prize.
CDATA (#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 )
total Total number of these such awards given to the player or team. Can be used to count medals for each country.
CDATA (#IMPLIED )
value The amount of money earned by the player who came in this place.
CDATA (#IMPLIED )

Parents

player-stats sports-event team-stats tournament-division-metadata tournament-metadata

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 ended this phase in the career, generally normalized to ISO 8601: YYYYMMDDTHHMMSS+HHMM (preferred) YYYYMMDDTHHMMSSZ (alternative). Use YYYYMMDD000000+HHMM when no time is available.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
name Name of the team or college, for example.
CDATA (#IMPLIED )
phase-type Value can be college or professional, etc. (Controlled vocabulary.)
CDATA (#IMPLIED )
start-date When the player started this phase in the career, generally normalized to ISO 8601: YYYYMMDDTHHMMSS+HHMM (preferred) YYYYMMDDTHHMMSSZ (alternative). Use YYYYMMDD000000+HHMM when no time is available.
CDATA (#IMPLIED )

Parents

player-metadata

Content model

EMPTY

catalog

A reference to the document listing externally-supplied controlled vocabularies. The catalog file is in NewsML.

Attributes

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

Parents

sports-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

Background information about a game. Where, when, and what an event is.

Attributes

Name Description
Type (Declaration) Default
alignment-scope Indicates that the included statistics apply only to events played either at home or away. (Controlled vocabulary.)
CDATA (#IMPLIED )
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division. (Controlled vocabulary.)
CDATA (#IMPLIED )
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season. (Controlled vocabulary.)
CDATA (#IMPLIED )
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
CDATA (#IMPLIED )
duration The length of time the event took place. Generally in YYYYMMDDTHHMMSS format.
CDATA (#IMPLIED )
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime. (Controlled vocabulary.)
CDATA (#IMPLIED )
end-date-time Time the game ends, normalized to ISO 8601: YYYYMMDDTHHMMSS+HHMM (preferred) YYYYMMDDTHHMMSSZ (alternative). Use YYYYMMDD000000+HHMM when no time is available.
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 The ranked position this event had among other events.
CDATA (#IMPLIED )
event-source The maintainer of the controlled vocabulary for the key.
CDATA (#IMPLIED )
event-status The stage of the event, describing whether it has started, is in progress, etc. (Controlled vocabulary.)
CDATA (#IMPLIED )
event-style Indicates whether competitors are trying to defeat each other or just outdo one another. (Controlled vocabulary.)
CDATA (#IMPLIED )
heat-number The ranked position this heat had among other heats.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
postponement-note A displayable notice as to why an event was postponed.
CDATA (#IMPLIED )
postponement-status Either none, weather-delay, or other. (Controlled vocabulary.)
CDATA (#IMPLIED )
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low. (Controlled vocabulary.)
CDATA (#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, normalized to ISO 8601: YYYYMMDDTHHMMSS+HHMM (preferred) YYYYMMDDTHHMMSSZ (alternative). Use YYYYMMDD000000+HHMM when no time is available.
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. (Controlled vocabulary.)
CDATA (#IMPLIED )
team-coverage Indicates whether the item contains information about one team, or many teams. (Controlled vocabulary.)
CDATA (#IMPLIED )

Parents

sports-event

Content model

(sports-content-codes? , sports-property* , (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. For people, should be the given name. Also, if person has only one name, like Pele or Ronaldo, use this one.
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 last name referred to. For people, should be the surname.
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 referree. 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 The symbol or identifying key for the official.
CDATA (#IMPLIED )
official-source The maintainer of the controlled vocabulary for the key.
CDATA (#IMPLIED )
position A code for the position of the official. Sport-specific controlled vocabulary:
CDATA (#IMPLIED )
position-source The source of the controlled-vocabulary for position.
CDATA (#IMPLIED )

Parents

official

Content model

(name* , home-location? , sports-property* , (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

(rating* , (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. (Controlled vocabulary.)
CDATA (#IMPLIED )
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division. (Controlled vocabulary.)
CDATA (#IMPLIED )
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season. (Controlled vocabulary.)
CDATA (#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. (Controlled vocabulary.)
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
losses Number of losses.
CDATA (#IMPLIED )
points-difference The final calculated difference between points-scored-for and points-scored-against. Possibly takes into account other scoring aspects, such as penalties and differences in score-values.
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 )
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low. (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. Localized to the coverage-attributes.
CDATA (#IMPLIED )
stats-coverage A relative indication of how many statistics are included in the item. (Controlled vocabulary.)
CDATA (#IMPLIED )
team-coverage Indicates whether the item contains information about one team, or many teams. (Controlled vocabulary.)
CDATA (#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, normalized to ISO 8601: YYYYMMDDTHHMMSS+HHMM (preferred) YYYYMMDDTHHMMSSZ (alternative). Use YYYYMMDD000000+HHMM when no time is available.
CDATA (#IMPLIED )
gender Male or female.
['male', 'female'] (#IMPLIED )
health An indication of the health of the player. (Controlled vocabulary.)
CDATA (#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 )
nationality Your country of citizinship.
CDATA (#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 plays. Sport-specific controlled vocabulary:
CDATA (#IMPLIED )
position-source The source of the controlled-vocabulary for position-regular and position-event.
CDATA (#IMPLIED )
status Whether a player starts playing at the beginning of a sports-event, joins mid-game, or is not available to participate. (Controlled vocabulary.)
CDATA (#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* , sports-property* , (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
alignment-scope Indicates that the included statistics apply only to events played either at home or away. (Controlled vocabulary.)
CDATA (#IMPLIED )
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division. (Controlled vocabulary.)
CDATA (#IMPLIED )
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season. (Controlled vocabulary.)
CDATA (#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. (Controlled vocabulary.)
CDATA (#IMPLIED )
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-standing-points How many new points were earned as a result of the outcome of this particular event.
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 )
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low. (Controlled vocabulary.)
CDATA (#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. External controlled vocabulary.
CDATA (#IMPLIED )
score Final or current score of the team or player.
CDATA (#IMPLIED )
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 )
score-attempts-on-goal A subset of score-attempts. Only counts those attempts that were on-goal.
CDATA (#IMPLIED )
score-attempts-on-goal-opposing Final or current number of attempts to score by an opposing team or player that were on-goal.
CDATA (#IMPLIED )
score-attempts-opposing Final or current number of attempts to score by an opposing team or player.
CDATA (#IMPLIED )
score-opposing Final or current score of the opposing team or player.
CDATA (#IMPLIED )
score-percentage Percentage of attempted scores that reached their mark.
CDATA (#IMPLIED )
score-percentage-opposing Percentage of attempted scores by opposing team or player that reached their mark.
CDATA (#IMPLIED )
score-units Describes how the score and score-opposing is valued. (Controlled vocabulary.)
CDATA (#IMPLIED )
stats-coverage A relative indication of how many statistics are included in the item. (Controlled vocabulary.)
CDATA (#IMPLIED )
team-coverage Indicates whether the item contains information about one team, or many teams. (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* , rating* , (player-stats-for-specific-sport)? , sports-property*)

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

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. (Controlled vocabulary.)
CDATA (#IMPLIED )
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division. (Controlled vocabulary.)
CDATA (#IMPLIED )
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season. (Controlled vocabulary.)
CDATA (#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. (Controlled vocabulary.)
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low. (Controlled vocabulary.)
CDATA (#IMPLIED )
stats-coverage A relative indication of how many statistics are included in the item. (Controlled vocabulary.)
CDATA (#IMPLIED )
team-coverage Indicates whether the item contains information about one team, or many teams. (Controlled vocabulary.)
CDATA (#IMPLIED )
value The value of the rank.
CDATA (#IMPLIED )

Parents

player-stats team-stats

Content model

EMPTY

rating

A judged value placed on the team or individual. Often used in British soccer.

Attributes

Name Description
Type (Declaration) Default
id An XML-specific identifier for the element.
ID (#IMPLIED )
rating-maximum The maximum value for the rating.
CDATA (#IMPLIED )
rating-type A classification for the rating.
CDATA (#IMPLIED )
rating-value The value of the rating.
CDATA (#IMPLIED )

Parents

associate-stats official-stats 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

Background information about the schedule. Describes the time period which the schedule covers, and which teams or events may be covered.

Attributes

Name Description
Type (Declaration) Default
alignment-scope Indicates that the included statistics apply only to events played either at home or away. (Controlled vocabulary.)
CDATA (#IMPLIED )
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division. (Controlled vocabulary.)
CDATA (#IMPLIED )
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season. (Controlled vocabulary.)
CDATA (#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. (Controlled vocabulary.)
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low. (Controlled vocabulary.)
CDATA (#IMPLIED )
stats-coverage A relative indication of how many statistics are included in the item. (Controlled vocabulary.)
CDATA (#IMPLIED )
team-coverage Indicates whether the item contains information about one team, or many teams. (Controlled vocabulary.)
CDATA (#IMPLIED )

Parents

schedule

Content model

(sports-content-codes? , sports-property*)

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

Must appear as the root element.

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, what 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. (Controlled vocabulary.)
CDATA (#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
gender One specific gender or mixed. (Controlled vocabulary.)
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
maximum-age Highest age for participants, in years. Examples: 8, 65, 120.
CDATA (#IMPLIED )
minimum-age Lowest age for participants, in years. Examples: 0, 14, 21.5.
CDATA (#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. Can be school-oriented, age-oriented, or group names, like Firefighters. (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. (Controlled vocabulary.)
CDATA (#IMPLIED )
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division. (Controlled vocabulary.)
CDATA (#IMPLIED )
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season. (Controlled vocabulary.)
CDATA (#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, normalized to ISO 8601: YYYYMMDDTHHMMSS+HHMM (preferred) YYYYMMDDTHHMMSSZ (alternative). Use YYYYMMDD000000+HHMM when no time is available
CDATA (#IMPLIED )
doc-id The often-unique ID of the document, tracked by publishers.
CDATA (#REQUIRED )
document-class A category code for the fixture-key. Equals news, standings, schedules, statistics, event-summary, event-action, dynamic-resource-file
CDATA (#IMPLIED )
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime. (Controlled vocabulary.)
CDATA (#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. (Controlled vocabulary.)
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 )
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low. (Controlled vocabulary.)
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. (Controlled vocabulary.)
CDATA (#IMPLIED )
team-coverage Indicates whether the item contains information about one team, or many teams. (Controlled vocabulary.)
CDATA (#IMPLIED )

Parents

sports-content

Content model

(catalog? , sports-title , advisory? , sports-content-codes? , sports-property*)

sports-property

An extensible property. Like in NewsML.

Attributes

Name Description
Type (Declaration) Default
allowed-values Points to a controlled vocabulary that delimits the set of allowed values for the property.
CDATA (#IMPLIED )
formal-name The code or key for the property.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
scheme Distinguishes which of possibly multiple naming schemes in the controlled vocabulary is the one that governs this formal-name.
CDATA (#IMPLIED )
value The value of the property. For example, if formal-name equals favorite-color, then value might equal blue.
CDATA (#IMPLIED )
vocabulary Provides a pointer to a Topic Set which is the controlled vocabulary that can be used to resolve the meaning of the formal-name.
CDATA (#IMPLIED )

Parents

associate-metadata event-metadata official-metadata player-metadata player-stats schedule-metadata sports-metadata sports-property standing-metadata statistic-metadata team-metadata team-stats tournament-metadata

Content model

(sports-property*)

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 A displayable label describing this standing.
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. (Controlled vocabulary.)
CDATA (#IMPLIED )
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division. (Controlled vocabulary.)
CDATA (#IMPLIED )
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season. (Controlled vocabulary.)
CDATA (#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. (Controlled vocabulary.)
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low. (Controlled vocabulary.)
CDATA (#IMPLIED )
stats-coverage A relative indication of how many statistics are included in the item. (Controlled vocabulary.)
CDATA (#IMPLIED )
team-coverage Indicates whether the item contains information about one team, or many teams. (Controlled vocabulary.)
CDATA (#IMPLIED )

Parents

standing

Content model

(sports-content-codes? , sports-property*)

statistic

A table that generally compares the performance of teams or players. The fixture-key can identify which regulary-running statistics are being presented.

Attributes

Name Description
Type (Declaration) Default
alignment-scope Indicates that the included statistics apply only to events played either at home or away. (Controlled vocabulary.)
CDATA (#IMPLIED )
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division. (Controlled vocabulary.)
CDATA (#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. (Controlled vocabulary.)
CDATA (#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. (Controlled vocabulary.)
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low. (Controlled vocabulary.)
CDATA (#IMPLIED )
stats-coverage A relative indication of how many statistics are included in the item. (Controlled vocabulary.)
CDATA (#IMPLIED )
team-coverage Indicates whether the item contains information about one team, or many teams. (Controlled vocabulary.)
CDATA (#IMPLIED )
type The type of statistic.
CDATA (#IMPLIED )

Parents

sports-content

Content model

(statistic-metadata , team* , player* , status-change*)

statistic-metadata

Identifies which teams are being covered. Also indicates the date ranges for which these stats cover.

Attributes

Name Description
Type (Declaration) Default
alignment-scope Indicates that the included statistics apply only to events played either at home or away. (Controlled vocabulary.)
CDATA (#IMPLIED )
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division. (Controlled vocabulary.)
CDATA (#IMPLIED )
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season. (Controlled vocabulary.)
CDATA (#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. (Controlled vocabulary.)
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low. (Controlled vocabulary.)
CDATA (#IMPLIED )
stats-coverage A relative indication of how many statistics are included in the item. (Controlled vocabulary.)
CDATA (#IMPLIED )
team-coverage Indicates whether the item contains information about one team, or many teams. (Controlled vocabulary.)
CDATA (#IMPLIED )

Parents

statistic

Content model

(sports-content-codes? , sports-property*)

status-change

Identifies which teams are being covered. Also indicates the date ranges for which these stats cover.

Attributes

Name Description
Type (Declaration) Default
alignment-scope Indicates that the included statistics apply only to events played either at home or away. (Controlled vocabulary.)
CDATA (#IMPLIED )
changer-idref A pointer to the player or team that has undergone the status change.
IDREF (#REQUIRED )
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division. (Controlled vocabulary.)
CDATA (#IMPLIED )
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season. (Controlled vocabulary.)
CDATA (#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. (Controlled vocabulary.)
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
new-idref Generally, a pointer to the new team that the player in changer-idref is now affiliated with.
CDATA (#IMPLIED )
new-status What the new status of the player or team is. Examples are active, inactive, disabled-list.
CDATA (#IMPLIED )
original-idref Generally, a pointer to the original team that the player in changer-idref was affiliated with.
CDATA (#IMPLIED )
original-status What the original status of the player or team was. Examples are active, inactive, disabled-list.
CDATA (#IMPLIED )
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low. (Controlled vocabulary.)
CDATA (#IMPLIED )
stats-coverage A relative indication of how many statistics are included in the item. (Controlled vocabulary.)
CDATA (#IMPLIED )
status-change-type What type of change was made in the status of a player or team. Examples are injury, trade, cut. (Controlled vocabulary.)
CDATA (#REQUIRED )
team-coverage Indicates whether the item contains information about one team, or many teams. (Controlled vocabulary.)
CDATA (#IMPLIED )

Parents

statistic

Content model

EMPTY

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. A reference to the catalog file, which holds the URL for the topic set in which the team-key is listed.
CDATA (#IMPLIED )

Parents

team

Content model

(name* , home-location? , sports-content-code* , sports-property* , (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
alignment-scope Indicates that the included statistics apply only to events played either at home or away. (Controlled vocabulary.)
CDATA (#IMPLIED )
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division. (Controlled vocabulary.)
CDATA (#IMPLIED )
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season. (Controlled vocabulary.)
CDATA (#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. (Controlled vocabulary.)
CDATA (#IMPLIED )
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-standing-points How many new points were earned as a result of the outcome of this particular event.
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 )
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low. (Controlled vocabulary.)
CDATA (#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: sportsml-vocabulary-core.result-effect
CDATA (#IMPLIED )
score Final or current score of the team or player.
CDATA (#IMPLIED )
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 )
score-attempts-on-goal A subset of score-attempts. Only counts those attempts that were on-goal.
CDATA (#IMPLIED )
score-attempts-on-goal-opposing Final or current number of attempts to score by an opposing team or player that were on-goal.
CDATA (#IMPLIED )
score-attempts-opposing Final or current number of attempts to score by an opposing team or player.
CDATA (#IMPLIED )
score-opposing Final or current score of the opposing team or player.
CDATA (#IMPLIED )
score-percentage Percentage of attempted scores that reached their mark.
CDATA (#IMPLIED )
score-percentage-opposing Percentage of attempted scores by opposing team or player that reached their mark.
CDATA (#IMPLIED )
score-units Describes how the score and score-opposing is valued. (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 )
stats-coverage A relative indication of how many statistics are included in the item. (Controlled vocabulary.)
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 )
team-coverage Indicates whether the item contains information about one team, or many teams. (Controlled vocabulary.)
CDATA (#IMPLIED )

Parents

team

Content model

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

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

General information about the division of this tournament. Where and when this division is competing.

Attributes

Name Description
Type (Declaration) Default
division-key The symbol or identifying key for the division.
CDATA (#IMPLIED )
division-name A displayable name for the key.
CDATA (#IMPLIED )
division-source The maintainer of the controlled vocabulary for the key.
CDATA (#IMPLIED )
end-date-time Generally normalized to ISO 8601: YYYYMMDDTHHMMSS+HHMM (preferred) YYYYMMDDTHHMMSSZ (alternative). Use YYYYMMDD000000+HHMM when no time is available.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#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 Generally normalized to ISO 8601: YYYYMMDDTHHMMSS+HHMM (preferred) YYYYMMDDTHHMMSSZ (alternative). Use YYYYMMDD000000+HHMM when no time is available.
CDATA (#IMPLIED )

Parents

tournament-division

Content model

(sports-content-qualifier? , award* , (tournament-division-for-specific-sport)? , )

tournament-metadata

Background data about a tournament. Where and when the this tournament took place.

Attributes

Name Description
Type (Declaration) Default
alignment-scope Indicates that the included statistics apply only to events played either at home or away. (Controlled vocabulary.)
CDATA (#IMPLIED )
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division. (Controlled vocabulary.)
CDATA (#IMPLIED )
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season. (Controlled vocabulary.)
CDATA (#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. (Controlled vocabulary.)
CDATA (#IMPLIED )
end-date-time Generally normalized to ISO 8601: YYYYMMDDTHHMMSS+HHMM (preferred) YYYYMMDDTHHMMSSZ (alternative). Use YYYYMMDD000000+HHMM when no time is available.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low. (Controlled vocabulary.)
CDATA (#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 Generally normalized to ISO 8601: YYYYMMDDTHHMMSS+HHMM (preferred) YYYYMMDDTHHMMSSZ (alternative). Use YYYYMMDD000000+HHMM when no time is available.
CDATA (#IMPLIED )
stats-coverage A relative indication of how many statistics are included in the item. (Controlled vocabulary.)
CDATA (#IMPLIED )
team-coverage Indicates whether the item contains information about one team, or many teams. (Controlled vocabulary.)
CDATA (#IMPLIED )
tournament-key The symbol or identifying key for the tournament.
CDATA (#IMPLIED )
tournament-name A displayable name for the key.
CDATA (#IMPLIED )
tournament-source The maintainer of the controlled vocabulary for the key.
CDATA (#IMPLIED )

Parents

tournament

Content model

(sports-content-codes? , sports-property* , award* , (tournament-metadata-for-specific-sport)? , )

tournament-metadata-for-specific-sport

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

Attributes

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

Parents

tournament-metadata

Content model

EMPTY

tournament-round

Sub-component of tournament-division. All teams might participate in each round, or only the winners might progress. Not always sequential.

Attributes

Name Description
Type (Declaration) Default
end-date-time Generally normalized to ISO 8601: YYYYMMDDTHHMMSS+HHMM (preferred) YYYYMMDDTHHMMSSZ (alternative). Use YYYYMMDD000000+HHMM when no time is available.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
round-key The symbol or identifying key for the round.
CDATA (#IMPLIED )
round-name A displayable name for the key.
CDATA (#IMPLIED )
round-number The number of the round.
CDATA (#IMPLIED )
round-source The maintainer of the controlled vocabulary for the key.
CDATA (#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 Generally normalized to ISO 8601: YYYYMMDDTHHMMSS+HHMM (preferred) YYYYMMDDTHHMMSSZ (alternative). Use YYYYMMDD000000+HHMM when no time is available.
CDATA (#IMPLIED )

Parents

tournament-division

Content model

(sports-event* | team* | player*)
Produced by dtddoc.py, using xmlproc.