Korzystanie z programu UpgradeCode

UpgradeCode jest używana głównie do obsługi głównych aktualizacji, chociaż drobne poprawki aktualizacji mogą używać UpgradeCode do weryfikacji produktu. Podczas głównych uaktualnień akcje FindRelatedProducts, MigrateFeatureStatesi RemoveExistingProducts wykrywają, migrują i usuwają poprzednie wersje produktu. Akcja FindRelatedProducts wyszukuje produkty przy użyciu kryteriów opartych na UpgradeCode, ProductLanguagei ProductVersion. Te kryteria są określone w tabeli Upgrade.

Biorąc pod uwagę kryteria używane w akcji FindRelatedProducts, UpgradeCode może być takie samo dla różnych języków i wersji pojedynczego produktu. Dzieje się tak, ponieważ tabela uaktualnień umożliwia różnicowanie produktów według wersji i języka.

W różnych wersjach tego samego produktu może się zdarzyć, że nigdy nie trzeba zmieniać UpgradeCode. Każdy produkt autonomiczny powinien mieć własny UpgradeCode. Pakiet produktów powinien również mieć własny UpgradeCode. Dzięki temu pakiet może uaktualnić poprzednie wersje pakietu lub produktów autonomicznych przy użyciu wielu wierszy w tabeli Upgrade.

Poniższe dwa scenariusze ilustrują użycie UpgradeCode.

• Produkt A i Produkt B zostały dostarczone z tym samym ProductLanguage, ProductVersioni UpgradeCode. Produkty A i Produkt B mają różne ProductCodes. Ponieważ produkty zostały przypisane ten sam UpgradeCode, nie można utworzyć tabeli uaktualnienia , aby odróżnić starszą wersję produktu A od starszej wersji produktu B. W takim przypadku nie będzie możliwe przeprowadzenie instalacji uaktualnienia produktu A, ignorującej produkt B. Ponieważ były to różne produkty, każdy z nich powinien mieć przypisany inny UpgradeCode.
• Angielskie i francuskie wersje produktu A zostały dostarczone z tymi samymi ProductVersion i UpgradeCode. Zarówno angielska, jak i francuska wersja produktu A mają różne ProductLanguages oraz ProductCodes. Mimo że wersje języka angielskiego i francuskiego mają taką samą UpgradeCode, można utworzyć tabelę Upgrade, tak aby tylko starsza wersja języka angielskiego została wykryta i uaktualniona, a starsza wersja francuska została zignorowana. Różne wersje językowe produktu mogą używać tego samego UpgradeCode.