Utilizar um Código de Atualização

OUpgradeCodeé usado principalmente para dar suporte a atualizações maiores, embora patches de atualização pequenos e menores possam usar o UpgradeCode para validação de produtos. Durante as principais atualizações, as ações FindRelatedProducts, MigrateFeatureStatese RemoveExistingProducts detetam, migram e removem versões anteriores do produto. A ação FindRelatedProducts procura produtos usando critérios baseados no UpgradeCode, ProductLanguagee ProductVersion. Esses critérios são especificados na tabela Upgrade.

Dado o critério utilizado pela ação FindRelatedProducts, o UpgradeCode pode ser o mesmo para diferentes idiomas e versões de um único produto. Isso ocorre porque a tabela Upgrade permite diferenciar os produtos ao longo das linhas de versão e idioma.

Em diferentes versões do mesmo produto, talvez nunca seja necessário alterar o UpgradeCode. Cada produto independente deve ter seu próprio UpgradeCode. Um pacote de produtos também deve ter o seu próprio UpgradeCode. Isso permitirá que a suite atualize versões anteriores da suite ou produtos independentes, utilizando várias linhas na tabela Upgrade.

Os dois cenários a seguir ilustram o uso do UpgradeCode.

• O Produto A e o Produto B foram enviados com o mesmo ProductLanguage, ProductVersione UpgradeCode. O Produto A e o Produto B têm diferentes ProductCodes. Como os produtos receberam a mesma UpgradeCode, a tabela Atualização não pode ser criada para diferenciar a versão mais antiga do Produto A da versão mais antiga do Produto B. Nesse caso, você não poderá ter uma instalação de atualização do Produto A que ignore o Produto B. Como se tratava de produtos diferentes, cada um deles deveria ter recebido um UpgradeCode diferente.
• As versões em inglês e francês do Produto A foram enviadas com o mesmo ProductVersion e UpgradeCode. As versões inglesa e francesa do Produto A têm diferentes LínguasDoProduto e CódigosDoProduto. Embora as versões em inglês e francês compartilhem o mesmo UpgradeCode, é possível criar a tabela Upgrade de modo que apenas a versão mais antiga em inglês seja detetada e atualizada e a versão francesa mais antiga ignorada. Versões de idiomas diferentes de um produto podem usar o mesmo UpgradeCode.