Skip to content

Validate element

Sets information in the patch transform that determines if the transform applies to an installed product and what errors should be ignored when applying the patch transform.

Attributes

IgnoreAddExistingRow

yesno

Ignore errors when adding existing rows. The default is ‘yes’.

IgnoreAddExistingTable

yesno

Ignore errors when adding existing tables. The default is ‘yes’.

IgnoreChangingCodePage

yesno

Ignore errors when changing the database code page. The default is ‘no’.

IgnoreDeleteMissingRow

yesno

Ignore errors when deleting missing rows. The default is ‘yes’.

IgnoreDeleteMissingTable

yesno

Ignore errors when deleting missing tables. The default is ‘yes’.

IgnoreUpdateMissingRow

yesno

Ignore errors when updating missing rows. The default is ‘yes’.

ProductId

yesno

Requires that the installed ProductCode match the target ProductCode used to create the transform. The default is ‘yes’.

ProductLanguage

yesno

Requires that the installed ProductLanguage match the target ProductLanguage used to create the transform. The default is ‘no’.

ProductVersion

Determines how many fields of the installed ProductVersion to compare. See remarks for more information. The default is ‘Update’. This attribute’s value must be one of the following:

  • Major: Checks the major version.
  • Minor: Checks the major and minor versions.
  • Update: Checks the major, minor, and update versions.

ProductVersionOperator

Determines how the installed ProductVersion is compared to the target ProductVersion used to create the transform. See remarks for more information. The default is ‘Equal’. This attribute’s value must be one of the following:

  • Lesser: Installed ProductVersion < target ProductVersion.
  • LesserOrEqual: Installed ProductVersion <= target ProductVersion.
  • Equal: Installed ProductVersion = target ProductVersion.
  • GreaterOrEqual: Installed ProductVersion >= target ProductVersion.
  • Greater: Installed ProductVersion > target ProductVersion.

UpgradeCode

yesno

Requires that the installed UpgradeCode match the target UpgradeCode used to create the transform. The default is ‘yes’.

Parents

PatchBaseline

Remarks

A transform contains the differences between the target product and the upgraded product. When a transform or a patch (which contains transforms) is applied, the following properties of the installed product are validated against the properties of the target product stored in a transform.

  • ProductCode
  • ProductLanguage
  • ProductVersion
  • UpgradeCode Windows Installer simply validates that the ProductCode, ProductLanguage, and UpgradeCode of an installed product are equivalent to those propeties of the target product used to create the transform; however, the ProductVersion can be validated with a greater range of comparisons.

You can compare up to the first three fields of the ProductVersion. Changes to the fourth field are not validated and are useful for small updates. You can also choose how to compare the target ProductVersion used to create the transform with the installed ProductVersion. For example, while the default value of ‘Equals’ is recommended, if you wanted a minor upgrade patch to apply to the target ProductVersion and all older products with the same ProductCode, you would use ‘LesserOrEqual’.