DynamicInstallerRequirementValidator

Owned by Former user (Deleted)
Last updated: May 06, 2016 by Tom HelpstoneVersion comment
2 min read

Usage

The DynamicInstallerRequirementValidator is an implicit data validator for checking a set of conditions on each panel change (forward only, not backward).

Therefore it is not required to add a <validator> element for the DynamicInstallerRequirementValidator to any of the panels and you should not even do so!

This validator applies just in case there are defined Dynamic Installer Requirements on the top level of the installation specification.

Common Example
<dynamicinstallerrequirements>
  <installerrequirement severity="ERROR"
                        condition="this.condition.must.be.valid"
                        messageid="this.condition.must.be.valid.translation.id"/>
  <installerrequirement severity="WARNING"
                        condition="this.condition.should.be.valid"
                        messageid="this.condition.should.be.valid.translation.id"/>
  ...
</dynamicinstallerrequirements>

If one of the conditions is false, this is counted as an error or warning respectively.

<installerrequirement> - Attributes

AttributeDescriptionDefaultRequired
severity
The severity the validator should apply in case of the condition gets false.

Possible values: "WARNING" | "ERROR"

Unfortunately the behaviour does depend on the modus of the installer :

  • "WARNING"
    • installer in graphical mode
      A messagebox is shown; after closing it, the next panel is shown.
    • installer in text mode
      The message is shown and you are asked, whether to proceed with the installation.
  • "ERROR"
    •  installer in graphical mode
      A messagebox is shown and you remain on the actual panel.
      If the failing condition depends on the user input on the panel, you may proceed the installation after providing an appropriate input.
    • installer in text mode
      The message is shown and the installer ends with status code 1.


noneyes
condition
A valid condition ID defined within the <conditions/> element.noneyes
messageid
A valid message ID from the appropriate translation file.
If it can't be found the mentioned ID itself is displayed instead of the translated text.		noneyes