Colen at 16:12, 21 May 2017

2017-05-21T16:12:43Z

← Older revision		Revision as of 16:12, 21 May 2017
Line 13:		Line 13:
	\|-		\|-
	\|onlyonce		\|onlyonce
	\|(Optional) Boolean – Indicates whether the pre-requisite should only be reported to the user a single time if it fails. This is important for situations where the pre-requisite is assigned to a thing that is added to a container multiple times, such as class levels within the d20 System~~. This attribute is only applicable to pre-requisites specified directly on individual things~~. Default: "no".		\|(Optional) Boolean – Indicates whether the pre-requisite should only be reported to the user a single time if it fails. This is important for situations where the pre-requisite is assigned to a thing that is added to a container multiple times, such as class levels within the d20 System. Default: "no".
	\|-		\|-
	\|issilent		\|issilent

Rob: /* The "prereq" Element */

2008-12-16T11:33:51Z

The "prereq" Element

← Older revision		Revision as of 11:33, 16 December 2008
Line 6:		Line 6:

	:{\| class="infotable"		:{\| class="infotable"
	\|message		\|class="leftnormal"\|message
	\|Text – Specifies the error message displayed to the user within the validation report when the pre-requisite is not satisfied.		\|Text – Specifies the error message displayed to the user within the validation report when the pre-requisite is not satisfied.
	\|-		\|-

Rob: /* The "Validate" Element{{anchor|validate}} */

2008-12-01T04:16:46Z

The "Validate" Element{{anchor|validate}}

← Older revision		Revision as of 04:16, 1 December 2008
Line 55:		Line 55:
	\|}		\|}

	==The "~~Validate~~" Element{{anchor\|validate}}==		==The "validate" Element{{anchor\|validate}}==

	The "validate" element defines the [[Validate Script\|Validate script]] that determines whether the pre-requisite is satisfied. The script is applied against the container, and the pre-requisite is considered valid if the script reports the container as valid. The complete list of attributes for this element is below.		The "validate" element defines the [[Validate Script\|Validate script]] that determines whether the pre-requisite is satisfied. The script is applied against the container, and the pre-requisite is considered valid if the script reports the container as valid. The complete list of attributes for this element is below.

Rob: New page: {{contextmulti|Kit Reference}} ==The "prereq" Element== You can establish dependencies wherein certain things require specific conditions to be satisfied by their prospective container i...

2008-11-29T05:14:56Z

New page: {{contextmulti|Kit Reference}} ==The "prereq" Element== You can establish dependencies wherein certain things require specific conditions to be satisfied by their prospective container i...

New page

{{contextmulti|Kit Reference}}

==The "prereq" Element==

You can establish dependencies wherein certain things require specific conditions to be satisfied by their prospective container in order to be added. These conditions are referred to as [[Pre-Requisites]] and are always tested against the prospective container for a thing. Each pre-requisite is specified through the use of a "prereq" element. The complete list of attributes for this element is below.

:{| class="infotable"
|message
|Text – Specifies the error message displayed to the user within the validation report when the pre-requisite is not satisfied.
|-
|iserror
|(Optional) Boolean – Indicates whether the failing the pre-requisite is considered to an error or merely a warning. This only applies if the user chooses to ignore a failed pre-requisite and add the thing to the container anyways. Default: "yes".
|-
|onlyonce
|(Optional) Boolean – Indicates whether the pre-requisite should only be reported to the user a single time if it fails. This is important for situations where the pre-requisite is assigned to a thing that is added to a container multiple times, such as class levels within the d20 System. This attribute is only applicable to pre-requisites specified directly on individual things. Default: "no".
|-
|issilent
|(Optional) Boolean – Indicates whether the pre-requisite should report an error message to the user if failed. In some cases, you'll simply want to properly highlight picks as invalid within the interface without reporting individual errors. In such cases, you can have the pre-requisite perform its tests and mark picks as invalid, but suppress any actual message. Default: "no".
|-
|}

The "prereq" element also possesses child elements that pertain to the handling of the requirement. The list of these child elements is below and must appear in the order shown. Click on the link to access the details for each element.

:{| class="infotable"
|class="leftnormal"|[[#match|match]]
|An optional "match" element may appear as defined by the given link. This element defines a [[Match Tag Expression]] that must be satisfied in order for the pre-requisite to be assigned to each thing. If omitted, the pre-requisite is applied to all derived things.
{{important}}This element is only applicable when the pre-requisite is defined within a component. In all other cases, this element may not be specified.
|-
|class="leftnormal"|[[#test|test]]
|An optional "test" element may appear as defined by the given link. This element defines a [[Container Tag Expression]] that determines whether the pre-requisite is satisfied. If omitted, the pre-requisite is assumed to satisfy this test.
|-
|class="leftnormal"|[[#validate|validate]]
|An optional "valid" element may appear as defined by the given link. This element defines a [[Validate Script]] that determines whether the pre-requisite is satisfied. If omitted, the pre-requisite is assumed to satisfy this test.
|-
|}

==The "match" Element{{anchor|match}}==

The "match" element defines the [[Match Tag Expression|Match tag expression]] that determines whether a particular thing is assigned the pre-requisite. The tag expression is applied against each thing derived from the component, and the pre-requisite is only assigned to things that satisfy the tag expression. The complete list of attributes for this element is below.

:{| class="infotable"
|class="leftnormal"|PCDATA
|TagExpr – Specifies the code comprising the Match tag expression.
|-
|}

==The "test" Element{{anchor|test}}==

The "test" element defines the [[Container Tag Expression|Container tag expression]] that determines whether the pre-requisite is satisfied. The tag expression is applied against all the tags of the container, and the pre-requisite is considered valid if the tag expression is satisfied. The complete list of attributes for this element is below.

:{| class="infotable"
|class="leftnormal"|PCDATA
|TagExpr – Specifies the code comprising the Container tag expression.
|-
|}

==The "Validate" Element{{anchor|validate}}==

The "validate" element defines the [[Validate Script|Validate script]] that determines whether the pre-requisite is satisfied. The script is applied against the container, and the pre-requisite is considered valid if the script reports the container as valid. The complete list of attributes for this element is below.

:{| class="infotable"
|class="leftnormal"|PCDATA
|Script – Specifies the code comprising the Validate script.
|-
|}

==Example==

The following example demonstrates what an "prereq" element might look like. All default values are assumed for optional attributes.

<pre>
<prereq message="Requirement Failed.">
<valid>
@valid = 1
</valid>
</prereq>
</pre>

PreReq Element (Data) - Revision history

Colen at 16:12, 21 May 2017

Rob: /* The "prereq" Element */

Rob: /* The "Validate" Element{{anchor|validate}} */

Rob: New page: {{contextmulti|Kit Reference}} ==The "prereq" Element== You can establish dependencies wherein certain things require specific conditions to be satisfied by their prospective container i...