Documentation for SportsML/Ice Hockey

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

Description

SportsML Plug-in for Ice Hockey.

Root elements

Element index

action-ice-hockey-assisting-player Player who assisted with a score.
action-ice-hockey-other A custom action.
action-ice-hockey-penalty Action describing a penalty.
action-ice-hockey-score Data about a score in ice-hockey.
action-ice-hockey-score-attempt Used to record shots that are NOT made.
action-ice-hockey-scored-on-players Player who was on the ice playing for the side that was scored upon.
action-ice-hockey-scoring-players Player who was on the ice playing for the side that scored a goal.
action-ice-hockey-substitution Description of a substitution.
action-ice-hockey-timeout Description of a timeout.
all-specific-elements A placeholder, to help isolate sport-specific elements.
event-actions-ice-hockey Event actions specific to ice-hockey.
event-metadata-ice-hockey Metadata about the event itself.
player-metadata-ice-hockey Metadata for a player.
player-stats-ice-hockey Stats for a player specific to ice-hockey.
stats-ice-hockey-defensive Defensive stats for the team.
stats-ice-hockey-offensive Offensive stats for one team.
team-metadata-ice-hockey Metadata about one team.
team-stats-ice-hockey Stats about one team.

Element descriptions

action-ice-hockey-assisting-player

Player who assisted with a score. Generally, a player who passed the puck to the player who scored.

Attributes

Name Description
Type (Declaration) Default
id An XML-specific identifier for the element.
ID (#IMPLIED )
player-idref A pointer to a player who assisted in the score.
IDREF (#REQUIRED )

Parents

action-ice-hockey-score

Content model

EMPTY

action-ice-hockey-other

A custom action. For use when none of the pre-build actions apply.

Attributes

Name Description
Type (Declaration) Default
action-source The name of the controlled-vocabulary for the action-type attribute.
CDATA (#IMPLIED )
action-type A selection from a controlled-vocabulary list maintained by the publisher.
CDATA (#IMPLIED )
comment Textual comment about the action.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
period-time-elapsed The time elapsed in the period.
CDATA (#IMPLIED )
period-time-remaining The time remaining in the period.
CDATA (#IMPLIED )
period-value Identifier for which period of a game. (1,2,3 for main periods, 4 for first overtime, etc. shootout also allowed value.)
CDATA (#IMPLIED )

Parents

event-actions-ice-hockey

Content model

EMPTY

action-ice-hockey-penalty

Action describing a penalty. Includes who caused and who called the penalty. One element is used per penalized player.

Attributes

Name Description
Type (Declaration) Default
caller-idref A pointer to the official who called the penalty.
IDREF (#IMPLIED )
comment A textual comment.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
penalty-length In minutes:seconds. Not necessarily the time actually served.
CDATA (#IMPLIED )
penalty-level (Controlled vocabulary.)
CDATA (#IMPLIED )
penalty-name (Controlled vocabulary.)
CDATA (#IMPLIED )
penalty-status Whether this action indicates the start of a penalty, or the end of a penalty.
['start', 'end'] (#IMPLIED )
period-time-elapsed The time elapsed in the period.
CDATA (#IMPLIED )
period-time-remaining The time remaining in the period.
CDATA (#IMPLIED )
period-value Identifier for which period of a game. (1,2,3 for main periods, 4 for first overtime, etc. shootout also allowed value.)
CDATA (#IMPLIED )
recipient-idref A pointer to the receiver of the penalty.
IDREF (#IMPLIED )
recipient-type Whether the receiver of the penalty was the team, the player, a coach, a ref, etc.
['team', 'player', 'auxilliary', 'official'] (#REQUIRED )
served-by-idref A pointer to the player that served the penalty.
IDREF (#IMPLIED )

Parents

event-actions-ice-hockey

Content model

EMPTY

action-ice-hockey-score

Data about a score in ice-hockey. Includes elements detailing who was on the ice during the score.

Attributes

Name Description
Type (Declaration) Default
comment A textual comment.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
period-time-elapsed The time elapsed in the period.
CDATA (#IMPLIED )
period-time-remaining The time remaining in the period.
CDATA (#IMPLIED )
period-value Identifier for which period of a game. (1,2,3 for main periods, 4 for first overtime, etc. shootout also allowed value.)
CDATA (#IMPLIED )
player-idref A pointer to the player that scored the goal.
IDREF (#IMPLIED )
score-attempt-type The type of shot. Called attempt because it shares the same values as score-attempt element. (Controlled vocabulary.)
CDATA (#IMPLIED )
score-team After this action took place, the score of the team that team-idref points to.
CDATA (#IMPLIED )
score-team-opposing After this action took place, the score of the team opposing that listed in team-idref.
CDATA (#IMPLIED )
skaters-on-ice The number of non-goalie skaters on the ice when the team that did the shooting shot the puck.
CDATA (#IMPLIED )
skaters-on-ice-opposing The number of non-goalie skaters on the ice for the team that was shot upon.
CDATA (#IMPLIED )
team-idref A pointer to the team that scored the goal.
IDREF (#IMPLIED )

Parents

event-actions-ice-hockey

Content model

(action-ice-hockey-assisting-player* , action-ice-hockey-scoring-players* , action-ice-hockey-scored-on-players*)

action-ice-hockey-score-attempt

Used to record shots that are NOT made. If the shot was made, use the action-ice-hockey-score.

Attributes

Name Description
Type (Declaration) Default
comment A textual comment.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
period-time-elapsed The time elapsed in the period.
CDATA (#IMPLIED )
period-time-remaining The time remaining in the period.
CDATA (#IMPLIED )
period-value Identifier for which period of a game. (1,2,3 for main periods, 4 for first overtime, etc. shootout also allowed value.)
CDATA (#IMPLIED )
player-idref A pointer to the player that attempted to score.
IDREF (#REQUIRED )
score-attempt-result The result of the shot. (Controlled vocabulary.)
CDATA (#IMPLIED )
score-attempt-type The type of shot. (Controlled vocabulary.)
CDATA (#IMPLIED )
skaters-on-ice The number of non-goalie skaters on the ice when the team that did the shooting shot the puck.
CDATA (#IMPLIED )
skaters-on-ice-opposing The number of non-goalie skaters on the ice for the team that was shot upon.
CDATA (#IMPLIED )
team-idref A pointer to the team that attempted to score.
IDREF (#IMPLIED )

Parents

event-actions-ice-hockey

Content model

EMPTY

action-ice-hockey-scored-on-players

Player who was on the ice playing for the side that was scored upon. One element is used for each player who was on the ice when the score was made.

Attributes

Name Description
Type (Declaration) Default
id An XML-specific identifier for the element.
ID (#IMPLIED )
player-idref A pointer to a player who was on ice when a score was made.
IDREF (#REQUIRED )

Parents

action-ice-hockey-score

Content model

EMPTY

action-ice-hockey-scoring-players

Player who was on the ice playing for the side that scored a goal. One element is used for each player who was on the ice when a score was made.

Attributes

Name Description
Type (Declaration) Default
id An XML-specific identifier for the element.
ID (#IMPLIED )
player-idref A pointer to a player on ice during a score.
IDREF (#REQUIRED )

Parents

action-ice-hockey-score

Content model

EMPTY

action-ice-hockey-substitution

Description of a substitution. Describes who substituted for whom, and why.

Attributes

Name Description
Type (Declaration) Default
comment A textual comment.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
period-time-elapsed The time elapsed in the period.
CDATA (#IMPLIED )
period-time-remaining The time remaining in the period.
CDATA (#IMPLIED )
period-value Identifier for which period of a game. (1,2,3 for main periods, 4 for first overtime, etc. shootout also allowed value.)
CDATA (#IMPLIED )
person-original-idref A pointer to the player who left the ice.
IDREF (#IMPLIED )
person-original-position The position of the player who left the ice. Could be a goalie. (Controlled vocabulary.)
CDATA (#IMPLIED )
person-replacing-idref A pointer to the player who now went on the ice.
IDREF (#IMPLIED )
person-replacing-position The position of the player who went on the ice. If original player was a goalie, and this value is a forward, than the goalie has been pulled. (Controlled vocabulary.)
CDATA (#IMPLIED )
person-type The type of person who is substituting, for example: a player, a coach, a referree.
['player', 'auxilliary', 'official'] (#IMPLIED )
substitution-reason The reason why a substitution was made.
CDATA (#IMPLIED )

Parents

event-actions-ice-hockey

Content model

EMPTY

action-ice-hockey-timeout

Description of a timeout. Includes the duration of the timeout, and who called for the timeout.

Attributes

Name Description
Type (Declaration) Default
caller Who called the timeout, either team or official.
['team', 'official'] (#IMPLIED )
caller-idref If caller is team, say, a pointer to the team element.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
period-time-elapsed The time elapsed in the period.
CDATA (#IMPLIED )
period-time-remaining The time remaining in the period.
CDATA (#IMPLIED )
period-value Identifier for which period of a game. (1,2,3 for main periods, 4 for first overtime, etc. shootout also allowed value.)
CDATA (#IMPLIED )
timeout-duration How long a timeout was called for.
CDATA (#IMPLIED )

Parents

event-actions-ice-hockey

Content model

EMPTY

all-specific-elements

A placeholder, to help isolate sport-specific elements. Just helps the documentation. Not part of SportsML.

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

(event-metadata-ice-hockey , event-actions-ice-hockey , team-metadata-ice-hockey , team-stats-ice-hockey , player-metadata-ice-hockey , player-stats-ice-hockey)

event-actions-ice-hockey

Event actions specific to ice-hockey. Include scores, penalties, timeouts, etc.

Attributes

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

Parents

all-specific-elements

Content model

(action-ice-hockey-substitution | action-ice-hockey-score-attempt | action-ice-hockey-score | action-ice-hockey-penalty | action-ice-hockey-timeout | action-ice-hockey-other)*

event-metadata-ice-hockey

Metadata about the event itself. Specific to ice-hockey.

Attributes

Name Description
Type (Declaration) Default
id An XML-specific identifier for the element.
ID (#IMPLIED )
period-time-elapsed The time elapsed in the period.
CDATA (#IMPLIED )
period-time-remaining The time remaining in the period.
CDATA (#IMPLIED )
period-value Identifier for which period of a game. (1,2,3 for main periods, 4 for first overtime, etc. shootout also allowed value.)
CDATA (#IMPLIED )

Parents

all-specific-elements

Content model

EMPTY

player-metadata-ice-hockey

Metadata for a player. Specific to ice-hockey. Reserved for future use.

Attributes

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

Parents

all-specific-elements

Content model

EMPTY

player-stats-ice-hockey

Stats for a player specific to ice-hockey. Includes the same offensive and defensive stats available for a team.

Attributes

Name Description
Type (Declaration) Default
id An XML-specific identifier for the element.
ID (#IMPLIED )
plus-minus Number of times player was on ice when own team scored minus the number of times player was on ice when opponent scored.
CDATA (#IMPLIED )

Parents

all-specific-elements

Content model

(stats-ice-hockey-offensive? , stats-ice-hockey-defensive?)

stats-ice-hockey-defensive

Defensive stats for the team. Specific to ice-hockey, including saves and shots allowed.

Attributes

Name Description
Type (Declaration) Default
goals-against-average Average number of goals per game allowed by the team.
CDATA (#IMPLIED )
goals-penalty-shot-allowed Total number of goals allowed as penalty-shots.
CDATA (#IMPLIED )
goals-power-play-allowed Total number of goals allowed while the opposing team has a power-play.
CDATA (#IMPLIED )
hits Number of body checks made against an opposing player.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
minutes-penalty-killing Total number of minutes played short-handed, while the other team had a power-play.
CDATA (#IMPLIED )
penalty-killing-amount Number of penalty-killing sessions, aka number of short-handed sessions.
CDATA (#IMPLIED )
penalty-killing-percentage Equals goals-penalty-allowed divided by penalty-killing-amount.
CDATA (#IMPLIED )
save-percentage Percentage of saves compared to total number of shots.
CDATA (#IMPLIED )
saves Total number of saves.
CDATA (#IMPLIED )
shots-blocked Number of shots that were blocked. This statistic is generally tracked for non-goalies.
CDATA (#IMPLIED )
shots-penalty-shot-allowed Total number of shots allowed as penalty-shots.
CDATA (#IMPLIED )
shots-power-play-allowed Total number of shots on goal allowed during power-play.
CDATA (#IMPLIED )
shutouts Total number of games where the opposing team did not score.
CDATA (#IMPLIED )
takeaways Number of intercepted passes. A judgment call whose exact conditions vary.
CDATA (#IMPLIED )

Parents

player-stats-ice-hockey team-stats-ice-hockey

Content model

EMPTY

stats-ice-hockey-offensive

Offensive stats for one team. Specific to ice-hockey, including stats on shots, goals, and faceoffs.

Attributes

Name Description
Type (Declaration) Default
assists Total number of assists.
CDATA (#IMPLIED )
faceoff-losses Total number of lost faceoffs.
CDATA (#IMPLIED )
faceoff-win-percentage Percentage of faceoffs that were won.
CDATA (#IMPLIED )
faceoff-wins Total number of won faceoffs.
CDATA (#IMPLIED )
giveaways Number of times that passes were attempted but intercepted. A judgment call whose exact conditions vary.
CDATA (#IMPLIED )
goals-empty-net Goals scored on an empty goal, with the opposing goalie pulled from the net.
CDATA (#IMPLIED )
goals-even-strength Goals scored while the teams were at even strength.
CDATA (#IMPLIED )
goals-game-tying Goals that caused the game to be tied.
CDATA (#IMPLIED )
goals-game-winning Goals that provided the winning margin in a game.
CDATA (#IMPLIED )
goals-overtime Goals scored during overtime.
CDATA (#IMPLIED )
goals-penalty-shot Goals scored as penalty shots.
CDATA (#IMPLIED )
goals-power-play Goals scored while the team was having a power-play.
CDATA (#IMPLIED )
goals-shootout Goals scored during a shootout.
CDATA (#IMPLIED )
goals-short-handed Goals scored while the team was playing short-handed.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
minutes-power-play Total number of minutes played in a power-play.
CDATA (#IMPLIED )
points Total number of points, with a score and an assist generally counted as one point each.
CDATA (#IMPLIED )
power-play-amount Number of power-play opportunities a team has had.
CDATA (#IMPLIED )
power-play-percentage Measure of success at power plays. Figured by dividing goals-power-play by power-play-amount.
CDATA (#IMPLIED )
scoring-chances Total number of qualified chances to score.
CDATA (#IMPLIED )
shots-penalty-shot-missed Total number of penalty shots missed by a shooting player.
CDATA (#IMPLIED )
shots-penalty-shot-percentage Percentage of penalty shots that resulted in goals.
CDATA (#IMPLIED )
shots-penalty-shot-taken Total number of penalty shots taken by a shooting player.
CDATA (#IMPLIED )

Parents

player-stats-ice-hockey team-stats-ice-hockey

Content model

EMPTY

team-metadata-ice-hockey

Metadata about one team. Specific to ice-hockey.

Attributes

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

Parents

all-specific-elements

Content model

EMPTY

team-stats-ice-hockey

Stats about one team. Specific to ice-hockey.

Attributes

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

Parents

all-specific-elements

Content model

(stats-ice-hockey-offensive? , stats-ice-hockey-defensive?)
Produced by dtddoc.py, using xmlproc.