Partilhar via

Como criar tabelas de sequência do módulo de mesclagem

  • Artigo

Inclua as tabelas MergeModuleSequence no arquivo .msm se o módulo de mesclagem precisar modificar as tabelas de sequência de ações do arquivo .msi de destino. A mesclagem não adiciona essas tabelas ao arquivo .msi. Essas tabelas só ocorrem em módulos de mesclagem.

Se uma das tabelas ModuleSequence estiver presente em um arquivo .msm, uma cópia vazia da tabela de sequência do instalador correspondente também precisará ser criada no módulo de mesclagem. Por exemplo, se um módulo de mesclagem contiver uma tabela ModuleAdminExecuteSequence, o módulo de mesclagem também precisará incluir uma tabela AdminExecuteSequence vazia. Durante uma mesclagem, essas tabelas vazias fornecem as diretrizes de esquema necessárias à ferramenta de mesclagem.

Ao usar ações padrão em tabelas de sequência de módulo de mesclagem, o valor na coluna Sequence deve ser o número de sequência de ação recomendado para a ação padrão. Confira as sequências de ação sugeridas fornecidas abaixo para obter os números de sequência recomendados em cada tabela de sequência. Se o número de sequência na tabela de sequência do módulo de mesclagem for diferente do número de sequência para a mesma ação no arquivo .msi, a ferramenta de mesclagem usará o número de sequência do arquivo .msi durante a mesclagem.

Tabela MergeModuleSequence Sequências de ação recomendadas
ModuleAdminUISequence AdminUISequence sugerida
ModuleAdminExecuteSequence AdminExecuteSequence sugerida
ModuleAdvtUISequence AdvtUISequence sugerida
ModuleAdvtExecuteSequence AdvtExecuteSequence sugerida
ModuleInstallUISequence InstallUISequence sugerida
Tabela ModuleInstallExecuteSequence InstallExecuteSequence sugerida

 

Se uma ação padrão for usada na coluna Action de uma tabela de sequência do módulo de mesclagem, as colunas BaseAction e After desse registro precisarão ser nulas.

Se uma caixa de diálogo ou uma ação personalizada for inserida na coluna Action, a coluna Sequence precisará ser Null.

Se uma ação que retorna um sinalizador de término for inserida na coluna Action, a coluna Sequence precisará conter o valor negativo para esse sinalizador e as colunas BaseAction e After desse registro precisarão ser Null. Os valores negativos a seguir indicam que a ação será chamada se o instalador retornar o sinalizador de término.

Sinalizador de término Valor Descrição
msiDoActionStatusSuccess -1 Conclusão bem-sucedida.
msiDoActionStatusUserExit -2 O usuário encerra a instalação.
msiDoActionStatusFailure -3 A saída fatal é encerrada.
msiDoActionStatusSuspend -4 A instalação é suspensa.

 

A coluna BaseAction pode conter uma ação padrão, uma ação personalizada especificada na tabela de ação personalizada do módulo de mesclagem ou uma caixa de diálogo especificada na tabela de diálogo do módulo. A coluna BaseAction é uma chave da coluna Action dessa tabela. Ela não pode ser uma chave estrangeira em outra tabela de mesclagem ou uma tabela no arquivo .msi. Isso significa que cada ação padrão, ação personalizada ou caixa de diálogo listada na coluna BaseAction também precisa ser listada na coluna Action de outro registro nessa tabela.