Utilizzo di un UpgradeCode

Il UpgradeCode viene usato principalmente per supportare gli aggiornamenti principali, anche se le patch di aggiornamento di piccole e piccole dimensioni possono usare UpgradeCode per la convalida del prodotto. Durante gli aggiornamenti principali, le azioni FindRelatedProducts, MigrateFeatureStatese RemoveExistingProducts rilevano, eseguono la migrazione e rimuovono le versioni precedenti del prodotto. L'azione FindRelatedProducts cerca i prodotti usando criteri basati sull'UpgradeCode, ProductLanguagee ProductVersion. Questi criteri vengono specificati nella tabella Upgrade.

Dato i criteri usati dall'azione FindRelatedProducts, ilUpgradeCode può essere lo stesso per lingue e versioni diverse di un singolo prodotto. Ciò è dovuto al fatto che la tabella di aggiornamento consente di differenziare i prodotti secondo le versioni e le linee linguistiche.

In versioni diverse dello stesso prodotto, potrebbe non essere necessario modificare il UpgradeCode. Ogni prodotto autonomo deve avere un proprio UpgradeCode. Una famiglia di prodotti deve avere anche un proprio UpgradeCode. In questo modo, la suite potrà aggiornare le versioni precedenti del gruppo o i prodotti autonomi usando più righe nella tabella di aggiornamento .

I due scenari seguenti illustrano l'uso del UpgradeCode.

• Prodotto A e Prodotto B sono stati forniti con la stessa ProductLanguage, ProductVersione UpgradeCode. Il prodotto A e il prodotto B hanno codici ProductCodediversi. Poiché ai prodotti è stato assegnato lo stesso UpgradeCode, non è possibile creare la tabella aggiornamento per differenziare la versione precedente del Prodotto A dalla versione precedente del Prodotto B. In questo caso, non sarà possibile installare un aggiornamento del prodotto A che ignora il prodotto B. Poiché si tratta di prodotti diversi, ognuno di essi dovrebbe essere stato assegnato a un UpgradeCode diverso.
• Le versioni inglese e francese del prodotto A sono state fornite con lo stessoProductVersione UpgradeCode. Sia la versione inglese che quella francese del Prodotto A hanno differenti ProductLanguages e ProductCodes. Anche se entrambe le versioni in lingua inglese e francese condividono lo stesso UpgradeCode, è possibile creare la tabella di aggiornamento in modo che venga rilevata e aggiornata solo la versione precedente della lingua inglese e la versione precedente del francese ignorata. Diverse versioni di lingua di un prodotto possono usare lo stesso UpgradeCode.