No Assistente de Soluções de Pacote do Access, o campo UpgradeCode é usado principalmente para dar suporte a atualizações principais, embora atualizações pequenas e secundárias possam usar o UpgradeCode para validação de produtos. Durante as principais atualizações, as ações FindRelatedProducts, MigrateFeatureStates e RemoveExistingProducts detectam , migram e removem versões anteriores do produto. A ação LocalizarProdutosRelacionados procura produtos usando critérios baseados em UpgradeCode, ProductLanguage e ProductVersion. Esses critérios são especificados na tabela Upgrade.
De acordo com os critérios usados pela ação FindRelatedProducts , o UpgradeCode pode ser o mesmo para diferentes idiomas e versões de um único produto. Isto deve-se ao facto de a tabela Atualizar permitir diferenciar os produtos de acordo com as linhas de versão e idioma.
Em diferentes versões do mesmo produto, talvez você nunca precise alterar o UpgradeCode. Cada produto autónomo deve ter o seu próprio UpgradeCode. Um pacote de produtos também deve ter seu próprio UpgradeCode. Isso permite que o pacote atualize versões anteriores do pacote ou produtos autônomos usando 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, ProductVersion e UpgradeCode. O Produto A e o Produto B têm Códigos de Produto diferentes. Como os produtos receberam o mesmo UpgradeCode, a tabela Upgrade não pode ser criada para diferenciar a versão mais antiga do Produto A da versão mais antiga do Produto B. Neste caso, não conseguirá 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 ProductLanguages e ProductCodes diferentes. Embora as versões em inglês e francês compartilhem o mesmo UpgradeCode, é possível criar a tabela de atualização de modo que apenas a versão mais antiga em inglês seja detectada e atualizada e a versão mais antiga em francês ignorada. Versões de idiomas diferentes de um produto podem usar o mesmo UpgradeCode.