Partilhar via

Ação RemoveExistingProducts

  • Artigo

A ação RemoveExistingProducts passa pelos códigos de produto listados na coluna ActionProperty da tabela Upgrade e remove os produtos em sequência invocando instalações simultâneas. Para cada instalação simultânea, o instalador define a propriedade ProductCode como o código do produto e define a propriedade REMOVE como o valor no campo Remover da tabela Upgrade. Se o campo Remover estiver em branco, seu valor será padronizado como ALL e o instalador removerá todo o produto.

O instalador executa apenas a ação RemoveExistingProducts na primeira vez que instala um produto. Ele não executa a ação durante uma instalação de manutenção ou desinstalação.

Restrições de sequências

A ação RemoveExistingProducts deve ser agendada na sequência de ações em um dos locais a seguir.

  • Entre a ação InstallValidate e a ação InstallInitialize. Nesse caso, o instalador remove totalmente os aplicativos antigos antes de instalar os novos aplicativos. Esse é um posicionamento ineficiente para a ação porque todos os arquivos reutilizados precisam ser recopiados.
  • Após a ação InstallInitialize e antes de qualquer ação que gere o script de execução.
  • Entre a ação InstallExecute ou a ação InstallExecuteAgain e a ação InstallFinalize. Geralmente, as três últimas ações são agendadas umas após as outras: InstallExecute, RemoveExistingProducts e InstallFinalize. Nesse caso, os arquivos atualizados são instalados primeiro e, em seguida, os arquivos antigos são removidos. No entanto, se a remoção do aplicativo antigo falhar, o instalador reverterá a remoção do aplicativo antigo e a instalação do novo aplicativo.
  • Após a ação InstallFinalize. Esse é o posicionamento mais eficiente para a ação. Nesse caso, o instalador atualiza os arquivos antes de remover os aplicativos antigos. Somente os arquivos que estão sendo atualizados são instalados durante a instalação. Se a remoção do aplicativo antigo falhar, o instalador reverterá apenas a desinstalação do aplicativo antigo.

Mensagens ActionData

Campo Descrição dos dados de ação
 [1] Produto removido.

 

Comentários

O Windows Installer define a propriedade UPGRADINGPRODUCTCODE quando executa essa ação.