Upgrade (tabla)

  • Artículo

La tabla Upgrade contiene la información que se necesita durante las actualizaciones principales. Para habilitar todas las funcionalidades de actualización del instalador, cada paquete debe tener una propiedad UpgradeCode y una tabla Upgrade. Cada registro de la tabla Upgrade proporciona una combinación característica del código de actualización, la versión del producto y la información de idioma que se usa para identificar un conjunto de productos afectados por la actualización. Cuando la acción FindRelatedProducts detecta un producto afectado instalado en el sistema, anexa el código de producto a una propiedad especificada en la columna ActionProperty. La acción RemoveExistingProducts y la acción MigrateFeatureStates solo quitan o migran los productos enumerados en la columna ActionProperty.

La tabla Upgrade contiene las columnas que se muestran en la tabla siguiente.

Columna Tipo Clave Nullable
UpgradeCode GUID Y No
VersionMin Texto Y Y
VersionMax Texto Y Y
Idioma Texto Y Y
Atributos Entero Y No
Quitar Con formato No Y
ActionProperty Identificador No No

 

Columnas

UpgradeCode

La propiedad UpgradeCode de esta columna especifica el código de actualización de todos los productos que la acción FindRelatedProducts va a detectar.

VersionMin

Límite inferior del intervalo de versiones de producto detectadas por FindRelatedProducts. Escriba msidbUpgradeAttributesVersionMinInclusive en Attributes para incluir VersionMin en el intervalo. Si VersionMin es igual a una cadena vacía (""), se evalúa igual que 0. Si VersionMin es null, FindRelatedProducts omite msidbUpgradeAttributesVersionMinInclusive y detecta todas las versiones anteriores. VersionMin y VersionMax no deben ser null.

VersionMin debe ser una versión de producto válida como se describe para la propiedad ProductVersion. Tenga en cuenta que Windows Installer usa solo los tres primeros campos de la versión del producto. Si incluye un cuarto campo en la versión del producto, el instalador lo omite.

VersionMax

Límite superior del intervalo de versiones de producto detectadas por la acción FindRelatedProducts. Escriba msidbUpgradeAttributesVersionMaxInclusive en Attributes para incluir VersionMax en el intervalo. Si VersionMax es igual a una cadena vacía (""), se evalúa igual que 0. Si VersionMax es null, FindRelatedProducts omite msidbUpgradeAttributesVersionMaxInclusive y detecta todas las versiones de producto mayores que, o mayores o iguales que, el límite inferior especificado en VersionMin y msidbUpgradeAttributesVersionMinInclusive. VersionMin y VersionMax no deben ser null.

VersionMax debe ser una versión de producto válida como se describe para la propiedad ProductVersion. Tenga en cuenta que Windows Installer usa solo los tres primeros campos de la versión del producto. Si incluye un cuarto campo en la versión del producto, el instalador lo omite.

Language

Conjunto de idiomas detectados por FindRelatedProducts. Escriba una lista de identificadores de idioma (LANGID) numéricos separados por comas. Escriba msidbUpgradeAttributesLanguagesExclusive en Attributes para detectar todos los idiomas exclusivos de los enumerados en Language. Si Language es null o una cadena vacía (""), FindRelatedProducts omite msidbUpgradeAttributesLanguagesExclusive y detecta todos los idiomas.

Attributes

Esta columna contiene marcas de bits que especifican atributos de la tabla Upgrade.

Nombre de marca de bits Decimal Hexadecimal Atributo
msidbUpgradeAttributesMigrateFeatures 1 0x001 Migra los estados de características habilitando la lógica en la acción MigrateFeatureStates.
msidbUpgradeAttributesOnlyDetect 2 0x002 Detecta productos y aplicaciones, pero no los quita.
msidbUpgradeAttributesIgnoreRemoveFailure 4 0x004 Continúa la instalación tras un error al quitar un producto o una aplicación.
msidbUpgradeAttributesVersionMinInclusive 256 0x100 Detecta el intervalo de versiones, incluido el valor de VersionMin.
msidbUpgradeAttributesVersionMaxInclusive 512 0x200 Detecta el intervalo de versiones, incluido el valor de VersionMax.
msidbUpgradeAttributesLanguagesExclusive 1024 0x400 Detecta todos los idiomas, excepto los idiomas enumerados en la columna Language.

 

Remove

El instalador establece la propiedad REMOVE en las características especificadas en esta columna. Las características que se van a quitar se pueden determinar en tiempo de ejecución. La cadena Con formato especificada en este campo debe evaluarse como una lista delimitada por comas de nombres de características. Por ejemplo: [Característica1],[Característica2],[Característica3]. No se quitan características si el campo contiene texto con formato que se evalúa como una cadena vacía (""). El instalador establece REMOVE=ALL solo si el campo Remove está vacío. Observe la diferencia entre una cadena vacía y un campo vacío. Si el campo está vacío, es null.

ActionProperty

Cuando la acción FindRelatedProducts detecta un producto relacionado instalado en el sistema, anexa el código de producto a la propiedad especificada en este campo. La propiedad especificada en esta columna debe ser una propiedad pública y el autor del paquete debe agregar la propiedad a la propiedad SecureCustomProperties. Cada fila de la tabla Upgrade debe tener un valor ActionProperty único. Después de FindRelatedProducts, el valor de esta propiedad es una lista de códigos de producto, separados por punto y coma (;), detectados en el sistema.

Validación

ICE03
ICE06
ICE46
ICE61
ICE66