Versions Compared

Key

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

Usage

Dynamic variables behave like "normal" static variables defined by the <variable> tag, except that they are evaluated on each panel change. They are maintained as normal variables in an installation process, but in comparison to them dynamic variables have been enhanced by many more facilities. You can set dynamic variables values from the following sources on the target computer:

...

  • 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")
    Might be added to assign a dynamic variable only one time at the beginning of the installation process, which makes it behave as a normal variable, although with enhanced capabilities to gather a value.
  • 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 dynamic variables almost completely integrate with static IzPack variables, which means they are mapped to a normal IzPack variable, be aware of using them as direct variables in user input fields. Even on using checkonce="true" they always refresh to the previous value 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 value, but the value when entering the panel.

 

Types of Dynamic Variable Assignments

...