Documentation for SportsML/Soccer

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

Description

SportsML Plug-in for Soccer

Root elements

all-specific-elements

Element index

action-soccer-assisting-player	Player assisting to score a goal.
action-soccer-foul	When a player commits an infraction against the rules, which may or may not result in a penalty.
action-soccer-offside	When an offside occurs.
action-soccer-other	A custom action.
action-soccer-penalty	Results from a foul.
action-soccer-score	When a team scores a goal.
action-soccer-score-attempt	Only used if the attempt is not also a goal.
action-soccer-substitution	Substition of a person involved in a game.
action-soccer-timeout	A timeout is called.
all-specific-elements	A placeholder, to help isolate sport-specific elements.
event-actions-soccer	Action specific to soccer.
event-metadata-soccer	Soccer-specific metadata for events.
player-metadata-soccer	Player metadata specific to soccer.
player-stats-soccer	Player statistics that are specific to soccer.
stats-soccer-defensive	Defensive stats specific to soccer.
stats-soccer-foul	Stats specific to fauls, cautions, and ejections.
stats-soccer-offensive	Offensive stats specific to soccer.
team-metadata-soccer	Soccer specific metadata for one team.
team-stats-soccer	Soccer specific stats for one team.
time-adjustment	Record time added by referee.

Element descriptions

action-soccer-assisting-player

Player assisting to score a goal. Pointer or identification of player assisting in scoring a goal.

Attributes

Name	Description
Name	Type (Declaration)	Default
id	An XML-specific identifier for the element.
id	ID (#IMPLIED )
player-idref	idref pointing to the player attempting to score.
player-idref	IDREF (#REQUIRED )

Parents

action-soccer-score

Content model

EMPTY

action-soccer-foul

When a player commits an infraction against the rules, which may or may not result in a penalty. Records what happens (or not happens) when a player commits a foul. Cautions and ejections are recorded under penalty.

Attributes

Name	Description
Name	Type (Declaration)	Default
comment	Textual comment regarding the penalty.
comment	CDATA (#IMPLIED )
foul-name	The name of the foul was committed. (Controlled vocabulary.)
foul-name	CDATA (#IMPLIED )
foul-result	(Controlled vocabulary.)
foul-result	CDATA (#IMPLIED )
fouled-player-idref	idref pointing to the player beeing fouled.
fouled-player-idref	IDREF (#IMPLIED )
fouled-team-idref	idref pointing to the team beeing fouled.
fouled-team-idref	IDREF (#IMPLIED )
fouling-player-idref	idref pointing to the player causing the foul.
fouling-player-idref	IDREF (#IMPLIED )
fouling-team-idref	idref pointing to the team causing the foul.
fouling-team-idref	IDREF (#IMPLIED )
id	An XML-specific identifier for the element.
id	ID (#IMPLIED )
period-minute-elapsed	The time elapsed but only given as whole minutes.
period-minute-elapsed	CDATA (#IMPLIED )
period-time-elapsed	Detailed time MMSS that has elapsed.
period-time-elapsed	CDATA (#IMPLIED )
period-time-remaining	Detailed time in MMSS format showing remaining time of period.
period-time-remaining	CDATA (#IMPLIED )
period-value	Identifier for which period of a game. (1, 2 for first and second halfs, 3 for first overtime, etc. shootout also allowed value.).
period-value	CDATA (#IMPLIED )

Parents

event-actions-soccer

Content model

EMPTY

action-soccer-offside

When an offside occurs. Records the event of an offside in a game.

Attributes

Name	Description
Name	Type (Declaration)	Default
comment	Textual comment regarding the offside.
comment	CDATA (#IMPLIED )
id	An XML-specific identifier for the element.
id	ID (#IMPLIED )
period-minute-elapsed	The time elapsed but only given as whole minutes.
period-minute-elapsed	CDATA (#IMPLIED )
period-time-elapsed	Detailed time MMSS that has elapsed.
period-time-elapsed	CDATA (#IMPLIED )
period-time-remaining	Detailed time in MMSS format showing remaining time of period.
period-time-remaining	CDATA (#IMPLIED )
period-value	Identifier for which period of a game. (1, 2 for first and second halfs, 3 for first overtime, etc. shootout also allowed value.).
period-value	CDATA (#IMPLIED )
player-offside-idref	idref pointing to the player the lineman indicated was offisde.
player-offside-idref	IDREF (#IMPLIED )
player-passing-idref	idref pointing to the player passing the ball when offside was called.
player-passing-idref	IDREF (#IMPLIED )
team-idref	idref pointing to the team causing the offside.
team-idref	IDREF (#IMPLIED )

Parents

event-actions-soccer

Content model

EMPTY

action-soccer-other

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

Attributes

Name	Description
Name	Type (Declaration)	Default
action-source	The name of the controlled-vocabulary for the action-type attribute.
action-source	CDATA (#IMPLIED )
action-type	A selection from a controlled-vocabulary list maintained by the publisher.
action-type	CDATA (#IMPLIED )
comment	Textual comment about the action.
comment	CDATA (#IMPLIED )
id	An XML-specific identifier for the element.
id	ID (#IMPLIED )
period-minute-elapsed	The time elapsed but only given as whole minutes.
period-minute-elapsed	CDATA (#IMPLIED )
period-time-elapsed	Detailed time that has elapsed. In MMSS format.
period-time-elapsed	CDATA (#IMPLIED )
period-time-remaining	Detailed time showing remaining time of period. In MMSS format.
period-time-remaining	CDATA (#IMPLIED )
period-value	Identifier for which period of a game. (1, 2 for first and second halfs, 3 for first overtime, etc. shootout also allowed value.).
period-value	CDATA (#IMPLIED )

Parents

event-actions-soccer

Content model

EMPTY

action-soccer-penalty

Results from a foul. Details of a penalty that a foul resulted in.

Attributes

Name	Description
Name	Type (Declaration)	Default
caller-idref	idref pointing to who called the penalty.
caller-idref	IDREF (#IMPLIED )
caution-value	Used to indicate what value, if any, the penalty adds to the caution-total of the player.
caution-value	CDATA (#IMPLIED )
comment	Textual comment regarding the penalty.
comment	CDATA (#IMPLIED )
id	An XML-specific identifier for the element.
id	ID (#IMPLIED )
penalty-level	(Controlled vocabulary.)
penalty-level	CDATA (#IMPLIED )
penalty-type	(Controlled vocabulary.)
penalty-type	CDATA (#IMPLIED )
period-minute-elapsed	The time elapsed but only given as whole minutes.
period-minute-elapsed	CDATA (#IMPLIED )
period-time-elapsed	Detailed time MMSS that has elapsed.
period-time-elapsed	CDATA (#IMPLIED )
period-time-remaining	Detailed time in MMSS format showing remaining time of period.
period-time-remaining	CDATA (#IMPLIED )
period-value	Identifier for which period of a game. (1, 2 for first and second halfs, 3 for first overtime, etc. shootout also allowed value.).
period-value	CDATA (#IMPLIED )
recipient-idref	idref pointer to the person suffering the penalty.
recipient-idref	IDREF (#IMPLIED )
recipient-type	What type of person or team that got the penalty.
recipient-type	['team', 'player', 'auxilliary', 'official'] (#IMPLIED )

Parents

event-actions-soccer

Content model

EMPTY

action-soccer-score

When a team scores a goal. Records by whom, how and when a goal was scored and the standing after the goal.

Attributes

Name	Description
Name	Type (Declaration)	Default
comment	Textual comment about the score.
comment	CDATA (#IMPLIED )
id	An XML-specific identifier for the element.
id	ID (#IMPLIED )
period-minute-elapsed	The time elapsed but only given as whole minutes.
period-minute-elapsed	CDATA (#IMPLIED )
period-time-elapsed	Detailed time MMSS that has elapsed.
period-time-elapsed	CDATA (#IMPLIED )
period-time-remaining	Detailed time in MMSS format showing remaining time of period.
period-time-remaining	CDATA (#IMPLIED )
period-value	Identifier for which period of a game. (1, 2 for first and second halfs, 3 for first overtime, etc. shootout also allowed value.).
period-value	CDATA (#IMPLIED )
player-idref	idref pointing to the player attempting to score.
player-idref	IDREF (#IMPLIED )
score-attempt-method	How the player attempted to score. Using head, left leg, right leg etc.
score-attempt-method	CDATA (#IMPLIED )
score-attempt-type	What type of attempt. Values in external controlled vocabulary: sportsml-vocabulary-specific-soccer.score-attempt-type (Note that the same attribute names are used as in score-attempt to avoid the need for duplicated vocabularies.)
score-attempt-type	CDATA (#IMPLIED )
score-team	The current score for the scoring team after the score is counted.
score-team	CDATA (#IMPLIED )
score-team-opposing	The current score for the opposing team after the score is counted.
score-team-opposing	CDATA (#IMPLIED )
team-idref	idref pointing to the team for which the player attempting to score.
team-idref	IDREF (#IMPLIED )

Parents

event-actions-soccer

Content model

(action-soccer-assisting-player*)

action-soccer-score-attempt

Only used if the attempt is not also a goal. When a player attempts to score a goal but it does not result in a goal.

Attributes

Name	Description
Name	Type (Declaration)	Default
comment	Textual comment regarding this score-attempt.
comment	CDATA (#IMPLIED )
id	An XML-specific identifier for the element.
id	ID (#IMPLIED )
period-minute-elapsed	The time elapsed but only given as whole minutes.
period-minute-elapsed	CDATA (#IMPLIED )
period-time-elapsed	Detailed time MMSS that has elapsed.
period-time-elapsed	CDATA (#IMPLIED )
period-time-remaining	Detailed time in MMSS format showing remaining time of period.
period-time-remaining	CDATA (#IMPLIED )
period-value	Identifier for which period of a game. (1, 2 for first and second halfs, 3 for first overtime, etc. shootout also allowed value.).
period-value	CDATA (#IMPLIED )
player-idref	idref pointing to the player attempting to score.
player-idref	IDREF (#IMPLIED )
score-attempt-method	How the player attempted to score. Using head, left leg, right leg etc. (Controlled vocabulary.)
score-attempt-method	CDATA (#IMPLIED )
score-attempt-result	What the attempt resulted in Values in external controlled vocabulary: sportsml-vocabulary-specific-soccer.score-attempt-result
score-attempt-result	CDATA (#IMPLIED )
score-attempt-type	What type of attempt. (Controlled vocabulary.)
score-attempt-type	CDATA (#IMPLIED )
team-idref	idref pointing to the team for which the player attempting to score.
team-idref	IDREF (#IMPLIED )

Parents

event-actions-soccer

Content model

EMPTY

action-soccer-substitution

Substition of a person involved in a game. Substitution of one person for another in a given position in a game. Not limited to players.

Attributes

Name	Description
Name	Type (Declaration)	Default
comment	Textual comment regarding this substitution.
comment	CDATA (#IMPLIED )
id	An XML-specific identifier for the element.
id	ID (#IMPLIED )
period-minute-elapsed	The time elapsed but only given as whole minutes.
period-minute-elapsed	CDATA (#IMPLIED )
period-time-elapsed	Detailed time MMSS that has elapsed.
period-time-elapsed	CDATA (#IMPLIED )
period-time-remaining	Detailed time in MMSS format showing remaining time of period.
period-time-remaining	CDATA (#IMPLIED )
period-value	Identifier for which period of a game. (1, 2 for first and second halfs, 3 for first overtime, etc. shootout also allowed value.).
period-value	CDATA (#IMPLIED )
person-original-idref	A pointer to the person beeing replaced.
person-original-idref	IDREF (#IMPLIED )
person-original-position	Position the replaced person held. (Controlled vocabulary.)
person-original-position	CDATA (#IMPLIED )
person-replacing-idref	A pointer to the person replacing.
person-replacing-idref	IDREF (#IMPLIED )
person-replacing-position	Position the substitute will take up. (Controlled vocabulary.)
person-replacing-position	CDATA (#IMPLIED )
person-type	What position the person beeing replaced held.
person-type	['player', 'associate', 'official'] (#IMPLIED )
substitution-reason	Text explaining the reason for the substitute.
substitution-reason	CDATA (#IMPLIED )
team-idref	A pointer to the team doing the substitution.
team-idref	IDREF (#IMPLIED )

Parents

event-actions-soccer

Content model

EMPTY

action-soccer-timeout

A timeout is called. How, when and what type of timeout was called.

Attributes

Name	Description
Name	Type (Declaration)	Default
caller	Who called the timeout, either team or official.
caller	['team', 'official'] (#IMPLIED )
caller-idref	If caller is team, say, an idref pointer to the team element.
caller-idref	IDREF (#IMPLIED )
comment	Textual comment about the timeout.
comment	CDATA (#IMPLIED )
id	An XML-specific identifier for the element.
id	ID (#IMPLIED )
period-minute-elapsed	The time elapsed but only given as whole minutes.
period-minute-elapsed	CDATA (#IMPLIED )
period-time-elapsed	Detailed time MMSS that has elapsed.
period-time-elapsed	CDATA (#IMPLIED )
period-time-remaining	Detailed time in MMSS format showing remaining time of period.
period-time-remaining	CDATA (#IMPLIED )
period-value	Identifier for which period of a game. (1, 2 for first and second halfs, 3 for first overtime, etc. shootout also allowed value.).
period-value	CDATA (#IMPLIED )
timeout-duration	The duration of the timeout.
timeout-duration	CDATA (#IMPLIED )

Parents

event-actions-soccer

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
Name	Type (Declaration)	Default
id	An XML-specific identifier for the element.
id	ID (#IMPLIED )

Parents

Must appear as the root element.

Content model

(event-metadata-soccer , event-actions-soccer , team-metadata-soccer , team-stats-soccer , player-metadata-soccer , player-stats-soccer)

event-actions-soccer

Action specific to soccer. Actions that are specific to soccer.

Attributes

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

Parents

all-specific-elements

Content model

event-metadata-soccer

Soccer-specific metadata for events. Metadata that is specific to soccer for events.

Attributes

Name	Description
Name	Type (Declaration)	Default
id	An XML-specific identifier for the element.
id	ID (#IMPLIED )
kick-off-team-idref	Pointer to the team doing the kick-off for the period covered.
kick-off-team-idref	IDREF (#IMPLIED )
period-minute-elapsed	The time elapsed, but only given as whole minutes.
period-minute-elapsed	CDATA (#IMPLIED )
period-time-elapsed	Detailed time MMSS that has elapsed.
period-time-elapsed	CDATA (#IMPLIED )
period-time-remaining	Detailed time in MMSS format showing remaining time of period.
period-time-remaining	CDATA (#IMPLIED )
period-value	Identifier for which period of a game. (1, 2 for first and second halfs, 3 for first overtime, etc. shootout also allowed value.).
period-value	CDATA (#IMPLIED )

Parents

all-specific-elements

Content model

(time-adjustment*)

player-metadata-soccer

Player metadata specific to soccer. Metadata for one player, specific to soccer.

Attributes

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

Parents

all-specific-elements

Content model

EMPTY

player-stats-soccer

Player statistics that are specific to soccer. Soccer specific statistic information about a player.

Attributes

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

Parents

all-specific-elements

Content model

(stats-soccer-offensive? , stats-soccer-defensive? , stats-soccer-foul?)

stats-soccer-defensive

Defensive stats specific to soccer. Defensive stats for one team, specific to soccer.

Attributes

Name	Description
Name	Type (Declaration)	Default
catches-punches	Situations when the goalie catches or punches the ball. Not a save attempt.
catches-punches	CDATA (#IMPLIED )
goals-against-average	Average goals against per game for the given period.
goals-against-average	CDATA (#IMPLIED )
goals-penalty-shot-allowed	Total number of goals allowed as penalty shots.
goals-penalty-shot-allowed	CDATA (#IMPLIED )
id	An XML-specific identifier for the element.
id	ID (#IMPLIED )
save-percentage	Percentage of saves compared to score-attempts on goal.
save-percentage	CDATA (#IMPLIED )
saves	Score attempts that were saved by the goal-keeper.
saves	CDATA (#IMPLIED )
shots-blocked	Score attempts that was blocked by someone else than the goal-keeper.
shots-blocked	CDATA (#IMPLIED )
shots-penalty-shot-allowed	Total number of penalty-shots allowed from other teams.
shots-penalty-shot-allowed	CDATA (#IMPLIED )
shots-shootout-allowed	Goals allowed during shootout.
shots-shootout-allowed	CDATA (#IMPLIED )
shots-shootout-total	Total number of attempts to score during shootout.
shots-shootout-total	CDATA (#IMPLIED )
shutouts	Number of games when you did not allow the other team to score.
shutouts	CDATA (#IMPLIED )

Parents

player-stats-soccer team-stats-soccer

Content model

EMPTY

stats-soccer-foul

Stats specific to fauls, cautions, and ejections. Could occur while players are on the offense, the defense, or even the bench.

Attributes

Name	Description
Name	Type (Declaration)	Default
caution-points-pending	Number of caution points that could result in a game suspension.
caution-points-pending	CDATA (#IMPLIED )
caution-points-total	Total amount of caution points. Can occur over various games in a season.
caution-points-total	CDATA (#IMPLIED )
cautions-pending	Number of cautions that could result in a game suspension.
cautions-pending	CDATA (#IMPLIED )
cautions-total	Total number of cautions recieved.
cautions-total	CDATA (#IMPLIED )
ejections-total	Total number of ejections.
ejections-total	CDATA (#IMPLIED )
fouls-commited	Total number of fouls commited. Generally a defensive foul.
fouls-commited	CDATA (#IMPLIED )
fouls-suffered	Total number of fouls the player has suffered. Generally an offensive foul.
fouls-suffered	CDATA (#IMPLIED )
id	An XML-specific identifier for the element.
id	ID (#IMPLIED )

Parents

player-stats-soccer team-stats-soccer

Content model

EMPTY

stats-soccer-offensive

Offensive stats specific to soccer. Offensive stats for one team, specific to soccer.

Attributes

Name	Description
Name	Type (Declaration)	Default
assists-game-tying	Assists to goals that meant tying a game.
assists-game-tying	CDATA (#IMPLIED )
assists-game-winning	Assists to goals that meant winning a game.
assists-game-winning	CDATA (#IMPLIED )
assists-overtime	Assists made on goals scored during overtime.
assists-overtime	CDATA (#IMPLIED )
assists-total	Number of assists.
assists-total	CDATA (#IMPLIED )
corner-kicks	Total number of corner kicks performed.
corner-kicks	CDATA (#IMPLIED )
giveaways	When you play bad so the other team gets hold of the ball/puck.
giveaways	CDATA (#IMPLIED )
goals-game-tying	Goals that meant tying a game.
goals-game-tying	CDATA (#IMPLIED )
goals-game-winning	Goals that meant winning a game.
goals-game-winning	CDATA (#IMPLIED )
goals-overtime	Goals scored during overtime.
goals-overtime	CDATA (#IMPLIED )
goals-shootout	Goals scored during shootout.
goals-shootout	CDATA (#IMPLIED )
hat-tricks	A record of the number of times a player scored three or more goals in a game. Sometimes, the rules that govern the assignment of a hat-trick varies.
hat-tricks	CDATA (#IMPLIED )
id	An XML-specific identifier for the element.
id	ID (#IMPLIED )
offsides	Total number of offsides.
offsides	CDATA (#IMPLIED )
points	Sum of goals and assists.
points	CDATA (#IMPLIED )
shots-penalty-shot-missed	Total number of attempts to score as penalty-shot that did not result in a goal.
shots-penalty-shot-missed	CDATA (#IMPLIED )
shots-penalty-shot-percentage	Percentage of penalty shots scored. Could be calculated from above values.
shots-penalty-shot-percentage	CDATA (#IMPLIED )
shots-penalty-shot-scored	Goals scored as penalty-shots.
shots-penalty-shot-scored	CDATA (#IMPLIED )
shots-penalty-shot-taken	Total number of attempts to score as penalty-shot.
shots-penalty-shot-taken	CDATA (#IMPLIED )
shots-shootout-missed	Goals missed during shootout.
shots-shootout-missed	CDATA (#IMPLIED )
shots-shootout-percentage	Percentage of shootout goals scored.
shots-shootout-percentage	CDATA (#IMPLIED )
shots-shootout-scored	Goals scored during shootout.
shots-shootout-scored	CDATA (#IMPLIED )
shots-shootout-taken	Total number of attempts to score during shootout.
shots-shootout-taken	CDATA (#IMPLIED )

Parents

player-stats-soccer team-stats-soccer

Content model

EMPTY

team-metadata-soccer

Soccer specific metadata for one team. The team-metadata that is specific for soccer and does not apply in all sports.

Attributes

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

Parents

all-specific-elements

Content model

EMPTY

team-stats-soccer

Soccer specific stats for one team. Team-stats that is specific to soccer and does not apply to all sports.

Attributes

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

Parents

all-specific-elements

Content model

(stats-soccer-offensive? , stats-soccer-defensive? , stats-soccer-foul?)

time-adjustment

Record time added by referee. Holds values for the time added by the referee and how much extra time was actually played.

Attributes

Name	Description
Name	Type (Declaration)	Default
id	An XML-specific identifier for the element.
id	ID (#IMPLIED )
period-extra-time-added	How many minutes the referee has decided to add to the period.
period-extra-time-added	CDATA (#IMPLIED )
period-extra-time-elapsed	How much time exactly MMSS that was actually elapsed in the period.
period-extra-time-elapsed	CDATA (#IMPLIED )
period-minute-elapsed	The time elapsed but only given as whole minutes.
period-minute-elapsed	CDATA (#IMPLIED )
period-time-elapsed	Detailed time MMSS that has elapsed.
period-time-elapsed	CDATA (#IMPLIED )
period-time-remaining	Detailed time in MMSS format showing remaining time of period.
period-time-remaining	CDATA (#IMPLIED )
period-value	Identifier for which period of a game. (1, 2 for first and second halfs, 3 for first overtime, etc. shootout also allowed value.).
period-value	CDATA (#IMPLIED )

Parents

event-metadata-soccer

Content model

EMPTY

Produced by dtddoc.py, using xmlproc.