FindRelatedProducts Action

Die Aktion FindRelatedProducts durchläuft jeden Datensatz der Tabelle Upgrade nacheinander und vergleicht den Upgradecode, die Produktversion und die Sprache in jeder Zeile mit Produkten, die auf dem System installiert sind. Wenn FindRelatedProducts eine Übereinstimmung zwischen den Upgradeinformationen und einem installierten Produkt erkennt, fügt es den Produktcode an die Eigenschaft an, die in der Spalte ActionProperty der UpgradeTable angegeben ist.

Die Aktion FindRelatedProducts wird nur ausgeführt, wenn das Produkt zum ersten Mal installiert wird. Die Aktion FindRelatedProducts wird während des Wartungsmodus oder der Deinstallation nicht ausgeführt.

Abgefragte Datenbanktabellen

Diese Aktion fragt die folgende Tabelle ab:

Tabelle Upgrade

Verwendete Eigenschaften

Die Aktion FindRelatedProducts verwendet die Eigenschaft UpgradeCode und die Versions- und Sprachinformationen, die in der Tabelle Upgrade erstellt wurden, um installierte Produkte zu erkennen, die vom ausstehenden Upgrade betroffen sind. Sie fügt den Produktcode der erkannten Produkte an die Eigenschaft in der Spalte ActionProperty der UpgradeTable an.

FindRelatedProducts erkennt nur vorhandene Produkte, die mithilfe von Windows Installer installiert wurden, mit einer .msi, die eine Eigenschaft UpgradeCode, eine Eigenschaft ProductVersion und einen Wert für die Eigenschaft ProductLanguage definiert, die eine der Sprachen ist, die in der Eigenschaft Vorlagenzusammenfassung aufgeführt sind.

Beachten Sie, dass FindRelatedProducts die von MsiGetProductInfo zurückgegebene Sprache verwendet. Damit FindRelatedProducts ordnungsgemäß funktioniert, muss der Paketautor sicher sein, dass die Eigenschaft ProductLanguage in der Tabelle Property auf eine Sprache festgelegt ist, die auch in der Eigenschaft Vorlagenzusammenfassung aufgeführt ist. Siehe Vorbereiten einer Anwendung für zukünftige größere Upgrades.

Sequenzeinschränkungen

FindRelatedProducts sollte in den Tabellen InstallUISequence und InstallExecuteSequence erstellt werden. Das Installationsprogramm verhindert, dass FindRelated Products in InstallExecuteSequence ausgeführt wird, wenn die Aktion bereits in InstallUISequence ausgeführt wurde. Die Aktion FindRelatedProducts muss vor der Aktion MigrateFeatureStates und der Aktion RemoveExistingProducts stehen.

ActionData Messages

FindRelatedProducts sendet eine ActionData Message für jedes verwandte Produkt, das auf dem System erkannt wird.