Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • name
    The name of the dynamic variable to refer to it from panels, in variable substitution and so on. Since dynamic variables are saved like a normal variable (as $INSTALL_PATH), they can be accessed like any other variable from within an IzPack installer.
  • checkonce:= "true" | "false" (optional, defaults to "false")
    Mark the dynamic variable to be evaluated just once, either when the installation starts or as soon as an optional condition gets true. This makes it behave like a normal variable, although with enhanced capabilities to gather a value.
    Values gathered by a dynamic variable definition with checkonce="true" can be overridden, if there is another dynamic variable with the same key (and different conditions ) defined, which gets true later.
  • ignorefailure:= "true" | "false" (optional, defaults to "false")
    Might be used to allow the installation to continue or abort if an error occurred during gathering the value for a certain dynamic variable.
  • condition (optional)
    The assignment of a dynamic variable itself can be made dependent on a certain condition, using the condition attribute, which refers to the ID of condition defined in the installer description elsewhere.

 

Note

Although As dynamic variables almost completely integrate with static IzPack variables, which means they are mapped to a normal IzPack variable, be aware of using them they can be used as direct variables in user input fields. Even on using Be aware of having stable evaluation conditions after the user entered a value or use checkonce="true" they always refresh to the previous value matching the original dynamic variable definition of the according dynamic variable and override the "normal" IzPack variable after leaving a panel. Thus, user input field variables which are also defined as dynamic variable will not have the user input as effective value, but the value they had when entering for this purpose to not override the user value after leaving the panel.

Lifecycle of Dynamic Variables

...