Versions Compared

Old Version 4

changes.mady.by.user Former user

Saved on

compared with

New Version Current

changes.mady.by.user Tom Helpstone

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: documentation adapted to actual behaviour of IzPack

...

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

Note

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.

Code Block
languagehtml/xml
titleCommon Example
<dynamicinstallerrequirements>
  <installerrequirement severity="errorERROR"
                        condition="this.condition.must.notbe.happenvalid"
                        messageid="this.condition.must.notbe.happenvalid.translation.id"/>
  <installerrequirement severity="errorWARNING"
                        condition="this.condition.should.maybe.happenvalid"
                        messageid="this.condition.should.maybe.happenvalid.translation.id"/>
  ...
</dynamicinstallerrequirements>

If a condition applies, a messagebox is shown with the appropriate content from translation. Depending on the value of severity attribute the installation might be continued or is aborted:

...

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
true
false.

Possible values: "

warning" | "error"

WARNING" | "ERROR"

Note

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
foundm
found the mentioned ID itself is displayed instead of the translated text.noneyes