Fazer o upgrade ou downgrade de uma solução

A opção Upgrade/Downgrade permite que você execute as seguintes alterações:

• Atualizar sua solução para uma versão mais recente;
• Downgrade your solution to an older version (similar to a rollback to an older version). Downgrading a solution does not delete entities, choice sets, and webhooks.

Para atualizar uma solução, siga as seguintes etapas:

1. Atualize seu pacote da solução com as alterações que você deseja incluir na nova versão. Para obter detalhes, consulte Editar uma versão do pacote da solução.

   Observação:

   Se um componente com o mesmo nome já existir no tenant, suas opções são as seguintes:

   • Mantenha o componente existente e não crie um adicional.
   • Mantenha o componente existente e adicione novos campos a partir da solução. Observe que essa opção não altera campos existentes.
   • Renomeie o recurso conflitante no respectivo serviço (por exemplo, Orchestrator, Action Center) no tenant de destino.
   • Renomeie o recurso na implantação da solução, se possível.

2. Selecione a guia Soluções no nível do tenant.

3. Na guia Implantações , selecione o menu de três pontos correspondente ao pacote de destino e, em seguida, escolha Atualizar / Downgrade.

4. In the Upgrade / Downgrade window, indicate the package version you want to upgrade or downgrade your solution to, then select Continue. A new screen opens, providing a summary of the changes introduced by the upgrade operation. The following details are provided on the changes the new version introduces:

   • Componentes recém-adicionados: marcados com um ícone de mais (+).

     Observação:

     Esses componentes serão criados no ambiente de destino após a atualização, portanto, certifique-se de revisar suas propriedades.

   • Componentes removidos: marcados com um ícone de menos (-).

     Observação:

     Esses componentes serão removidos do ambiente de destino após a atualização da solução, a menos que sejam referenciados por outras soluções. Nesse caso, os componentes permanecerão dentro do ambiente, mas serão removidos da solução.

   • Componentes editados: marcados com um ícone de asterisco (*). O painel Comparar diferenças de propriedades destaca todas as alterações nas propriedades do componente.

     Observação:

     Components that only have alterations to their configurable properties are not marked as edited. Edited components retain the existing configurations for their configurable properties by default, but you can switch to using the package configuration. In both cases, if needed, you can update the configurable properties in place. To get an overview of all property changes, check the Compare property differences panel.

5. Opcionalmente, edite quaisquer propriedades de componente configuráveis que desejar.

6. Save your changes as a draft, validate them, and/or deploy them. After performing an upgrade, you can check the operation status in the Deployments tab. For details, refer to Checking the deployment status.

   Observação:

   O status de uma solução recém-atualizada é Inactive. Certifique-se de ativar manualmente a implantação para que a solução funcione.

Importante:

Os gatilhos são sempre desabilitados durante uma atualização da solução. Depois de reativar a implantação por meio de Soluções, os gatilhos são restaurados para seu estado pré-atualização — mas apenas se a implantação tiver sido ativada anteriormente por meio de Soluções.

Se os gatilhos foram habilitados manualmente diretamente no Orchestrator (fora das Soluções), esses estados não são preservados e os gatilhos permanecerão desabilitados após a atualização. Para garantir que os estados do gatilho sejam restaurados corretamente após atualizações futuras, sempre ative implantações por meio de Soluções.