Event

<< Click to Display Table of Contents >>

Navigation:  Support > Reconfigurable Rulebook > Definition Objects >

Event

Description

In the Reconfigurable Rulebook Events are defined using the well known Composite Pattern. An Event is either a composite Event, that is made up of child Events, or it is a singular Event that is a leaf. Within a COURSE OF FIRE Composite events are defined separately from Singular Events.

Definition

Name

Value Type

Description

EventName

String

A unique name given to this Event.

String interpolation may be used, e.g. "PR {}" for defining multiple similarly named Events at a time. The values are filled in using the Values field.

Required and may not be blank.

EventType

String

The type of event. Must be one of the following:

EVENT (MUST have ONE EVENT, and it must be the top level Event)

STAGE (MUST have AT LEAST ONE STAGE)

SERIES

STRING

SINGULAR

NONE

Not required, defaults to NONE.

Children

List of strings or a EventChildInterpolation

The children of this event identified by the EventName. The score for this event is added together from the scores of the children.

Required and must have at least one name. Events are not allowed to be descendents of themselves.

Calculation

String

The method to use to calculate the score of this event from the children. Must be one of the following:

SUM: Sums the value of I (integer), D (decimal), and X (inner tens) based on the corresponding values of the children.

SUM( [special summation] ): Where 'special summation' is a comma separated lists of 'i', 'd', 'x', 's'. There should be one character in the list for each child. This function sums the integer, decimal, inner tens, or special summation, respectively, values from the children. For example 'SUM(i, d)' to sum the integer values of the first child plus the decimal values of the second child.

Not required, defaults to "SUM" if not included of if it is the wrong format.

ScoreFormat

String

The name of the Score Format to use when displaying the Event during a match.

Must be one of the options defined in the SCORE FORMAT COLLECTION ScoreFormats

StageStyle

Removed, replaced with StageStyleMapping

String formatted as a Set Name.

The StageStyle that this Event represents, and is assigned in the resulting ResultCOF, if any.

Not required. May only be included on and Event with EventType = "STAGE." May not be listed if StageStyleSelection is included.

StageStyleMapping

EventStageStyleMapping.

On Events that have a EventType == STAGE, the StageStyleMapping determines how the resulting Result COF is mapped to a STAGE STYLE.

Required when EventType == STAGE. Should be null otherwise.

EventStyle

Removed, replaced with EventStyleMapping

String formatted as a Set Name.

The EventStyle that this Event represents, and is assigned in the resulting ResultCOF, if any.

Not required. May only be included on and Event with EventType = "EVENT." May not be listed if EventStyleSelection is included.

EventStyleMapping

EventStageStyleMapping

On Events that have a EventType == EVENT, the EventStyleMapping determines how the resulting Result COF is mapped to a EVENT STYLE.

Required when EventType == EVENT. Should be null otherwise.

ResultListFormatDef

String formatted as a Set Name.

The suggested Result List Format definition to use when displaying result lists for this Event. 

 

Not required, but recommended.

RankingRuleDef

Removed, replaced with RankingRuleMapping.

String formatted as a Set Name.

The suggested Ranking Rule definition to use when sorting participants for this Event.

 

Not required, but recommended.

RankingRuleMapping

Dictionary, key is a string, value is a string formatted as a Set Name.

Key is a ScoreConfigName or the value "DefaultDef".

 

Value is the Ranking Rule Definition to use with this ScoreConfigName.

 

If a ScoreConfigName is not listed, the Ranking Rule Definition specified with "DefaultDef" is used instead.

Values

String formatted as a Value Series.

 

Comment

String

Internal documentation comments. All text is ignored by the system.

Example Events for a 40 shot Air Pistol match

{

    "Calculation": "SUM",

    "Children": {

        "EventName": "ST {}",

        "Values": "1..40"

    },

    "EventName": "Qualification",

    "EventType": "STAGE",

    "ScoreFormat": "Events",

    "StageStyleMapping": {

        "DefaultDef": "v1.0:usas:Air Pistol Qualification",

        "StageAppellation": "Qualification"

    }

},

{

    "Calculation": "SUM",

    "Children": {

        "EventName": "S{}",

        "String": 10

    },

    "EventName": "ST {}",

    "EventType": "SERIES",

    "ScoreFormat": "Events",

    "Values": "1..40"

},

{

    "Calculation": "SUM",

    "Children": [

        "Qualification"

    ],

    "EventName": "Top Level",

    "EventStyleMapping": {

        "DefaultDef": "v1.0:usas:Air Pistol",

        "EventAppellation": "Qualification"

    },

    "EventType": "EVENT",

    "ScoreFormat": "Events"

}

Example for Events in a Three-Position 3x10 Air Rifle match

{

    "Calculation": "SUM",

    "Children": [

        "Kneeling",

        "Prone",

        "Standing"

    ],

    "EventName": "Qualification",

    "EventStyleMapping": {

        "DefaultDef": "v1.0:ntparc:Three-Position Sporter Air Rifle",

        "EventAppellation": "Qualification3P"

    },

    "EventType": "EVENT",

    "ScoreFormat": "Events"

},

{

    "Calculation": "SUM",

    "Children": [

        "PR 1"

    ],

    "EventName": "Prone",

    "EventType": "STAGE",

    "ScoreFormat": "Events",

    "StageStyleMapping": {

        "DefaultDef": "v1.0:ntparc:Sporter Air Rifle Prone",

        "StageAppellation": "Prone"

    }

},

{

    "Calculation": "SUM",

    "Children": [

        "ST 1"

    ],

    "EventName": "Standing",

    "EventType": "STAGE",

    "ScoreFormat": "Events",

    "StageStyleMapping": {

        "DefaultDef": "v1.0:ntparc:Sporter Air Rifle Standing",

        "StageAppellation": "Standing"

    }

},

{

    "Calculation": "SUM",

    "Children": [

        "KN 1"

    ],

    "EventName": "Kneeling",

    "EventType": "STAGE",

    "ScoreFormat": "Events",

    "StageStyleMapping": {

        "DefaultDef": "v1.0:ntparc:Sporter Air Rifle Kneeling",

        "StageAppellation": "Kneeling"

    }

},

{

    "Calculation": "SUM",

    "Children": [

        "P1",

        "P2",

        "P3",

        "P4",

        "P5",

        "P6",

        "P7",

        "P8",

        "P9",

        "P10"

    ],

    "EventName": "PR 1",

    "EventType": "SERIES",

    "ScoreFormat": "Events"

},

{

    "Calculation": "SUM",

    "Children": [

        "S1",

        "S2",

        "S3",

        "S4",

        "S5",

        "S6",

        "S7",

        "S8",

        "S9",

        "S10"

    ],

    "EventName": "ST 1",

    "EventType": "SERIES",

    "ScoreFormat": "Events"

},

{

    "Calculation": "SUM",

    "Children": [

        "K1",

        "K2",

        "K3",

        "K4",

        "K5",

        "K6",

        "K7",

        "K8",

        "K9",

        "K10"

    ],

    "EventName": "KN 1",

    "EventType": "SERIES",

    "ScoreFormat": "Events"

}

 


 

Note:

The Reconfigurable Rulebook and functionality will be implemented with the release of Orion Scoring System v. 3.0 (TBA)