FindRelatedProducts-Aktion
Die FindRelatedProducts-Aktion durchläuft jeden Datensatz der Upgrade-Tabelle sequenziiert und vergleicht den Upgradecode, die Produktversion und die Sprache in jeder Zeile mit produkten, die auf dem System installiert sind. Wenn FindRelatedProducts eine Korrespondenz zwischen den Upgradeinformationen und einem installierten Produkt erkennt, fügt sie den Produktcode an die in der Spalte "ActionProperty" der UpgradeTable angegebene Eigenschaft an.
Die FindRelatedProducts-Aktion wird nur ausgeführt, wenn das Produkt zum ersten Mal installiert wird. Die FindRelatedProducts-Aktion wird während des Wartungsmodus oder der Deinstallation nicht ausgeführt.
Datenbanktabellen abgefragt
Diese Aktion fragt die folgende Tabelle ab:
Verwendete Eigenschaften
Die FindRelatedProducts-Aktion verwendet die UpgradeCode-Eigenschaft sowie die Versions- und Sprachinformationen, die in der Upgrade-Tabelle erstellt wurden, um installierte Produkte zu erkennen, die von dem ausstehenden Upgrade betroffen sind. Er fügt den Produktcode der erkannten Produkte an die Eigenschaft in der Spalte "ActionProperty" der UpgradeTable an.
FindRelatedProducts erkennt nur vorhandene Produkte, die mithilfe des Windows Installer mit einer .msi installiert wurden, die eine UpgradeCode-Eigenschaft, eine ProductVersion- eigenschaft und einen Wert für die ProductLanguage-Eigenschaft definiert, die eine der sprachen ist, die in der Template Summary Property aufgeführt sind.
Beachten Sie, dass FindRelatedProducts die von MsiGetProductInfozurückgegebene Sprache verwendet. Damit FindRelatedProducts ordnungsgemäß funktioniert, muss der Paketautor sicherstellen, dass die ProductLanguage-Eigenschaft in der Eigenschaftentabelle auf eine Sprache festgelegt ist, die auch in der Template Summary-Eigenschaft aufgeführt ist. Weitere Informationen finden Sie unter Vorbereiten einer Anwendung für zukünftige Hauptupgrades.
Sequenzeinschränkungen
FindRelatedProducts sollte in der InstallUISequence-Tabelle und InstallExecuteSequence Tabellen erstellt werden. Das Installationsprogramm verhindert, dass FindRelated Products in InstallExecuteSequence ausgeführt wird, wenn die Aktion bereits in InstallUISequence ausgeführt wurde. Die FindRelatedProducts-Aktion muss vor der MigrateFeatureStates-Aktion und der RemoveExistingProducts-Aktion.
ActionData-Nachrichten
FindRelatedProducts sendet eine Aktionsdatenmeldung für jedes verwandte Produkt, das im System erkannt wird.