Implementar atividades de pré-upgrade em uma instância de produção

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 9 min. de leitura
  • Conclua as tarefas de pré-upgrade para obter uma experiência de upgrade bem-sucedida em sua instância de produção.

    Antes de Iniciar

    Nota:
    Para cada etapa, você terá a opção de ignorar a etapa ou marcar como concluída e somente depois passar para a próxima etapa de upgrade assistida.

    Função necessária: administrador

    Procedimento

    1. Escolha um plano de upgrade.
      Há duas opções para escolher seu plano de upgrade.
      • Selecione um existente: Você pode importar conjuntos de atualizações para aplicar ou mesclar planos de upgrade para seus upgrades. Essa opção é selecionada por padrão.
        Para aplicar um plano de upgrade existente, você tem as seguintes opções:
        • Conjuntos de atualizações de importação: Você deve primeiro importar conjuntos de atualizações antes de selecionar um plano de upgrade existente.
          1. Selecione Conjuntos de atualizações de importação para importar um conjunto de atualizações. A lista Recuperar conjuntos de atualizações é exibida.
          2. Selecione o link relacionado Importar conjunto de atualizações do XML para selecionar o conjunto de atualizações a ser importado. A página Importar XML é exibida.
          3. Selecione um conjunto de atualizações já existente usando Escolha o arquivo e, em seguida, selecione Upload .

            O conjunto de atualizações selecionado é carregado no plano de upgrade atual. O plano de upgrade atual aparece na lista Recuperar conjuntos de atualizações.

          4. Selecione o plano na lista Recuperar conjuntos de atualizações. O formulário Recuperar conjunto de atualizações é exibido com todas as atualizações de cliente associadas.
          5. Selecione Visualizar Conjunto para atualização. O modal Visualização do conjunto de atualizações é exibido.
          6. Quando a visualização do conjunto de atualizações for concluída com sucesso, selecione Confirmar conjunto de atualizações . O modal Confirmar conjunto de atualizações é exibido.
            Nota:
            Esta opção só fica visível após a conclusão bem-sucedida da visualização do conjunto de atualizações.
        • Selecione um plano de upgrade existente: Você pode exibir os planos importados para escolher ou pode selecionar vários planos ou mesclá-los em um plano.
          Nota:
          Essa opção reduz consideravelmente o retrabalho com um plano de upgrade, mantém a precisão e torna o processo de upgrade perfeito.

          Você verá o modal a seguir quando selecionar Selecionar plano de upgrade. Em seguida, você pode selecionar um plano de upgrade ou vários planos a serem mesclados e aplicados ao upgrade atual.

          Nota:
          . Aplicar a opção fica visível somente quando você seleciona um plano de upgrade a ser aplicado ao upgrade atual.

          Nota:
          . Mesclar e aplicar a opção ficará visível somente se você tiver selecionado vários planos de upgrade. O nome do plano de upgrade muda de acordo com a seleção de planos de upgrade.

          Ao mesclar vários planos de upgrade, os itens do plano de upgrade que aparecem em mais de um plano são usados no plano mesclado por sua versão mais alta. Isso garante consistência e evita conflitos de versão no plano mesclado resultante.

      • Crie um novo plano: Você pode começar a criar um novo plano para o upgrade da instância.
        • Criar um plano de upgrade: Selecione Crie um plano para começar a criar o novo plano de upgrade. Selecione o link Plano de upgrade na faixa de mensagem de sucesso para exibir o plano de upgrade criado.
          Nota:
          A faixa de mensagem de sucesso é gerada imediatamente após a criação do plano de upgrade selecionando Crie um plano e permanece visível até que a página seja recarregada.

          Se você selecionar Crie um plano novamente após criar um plano, você verá a seguinte mensagem.

          Nota:
          Somente o plano de upgrade mais recente sem itens do plano de upgrade é mantido. Por exemplo, se o plano de upgrade mais recente for criado sem itens do plano de upgrade, ele substituirá automaticamente qualquer plano de upgrade anterior que também não tenha itens do plano de upgrade. Pode haver mais de um plano de upgrade com itens do plano de upgrade.
          Na lista Planos de upgrade, pode haver vários planos de upgrade com itens do plano de upgrade e somente o plano de upgrade recente sem itens do plano de upgrade.
          Nota:
          Uma instância pode ter apenas um plano de upgrade ativo por vez, independentemente de o plano incluir itens do plano de upgrade. Apenas o plano de upgrade mais recente está no estado ativo, pois ele é aplicado automaticamente ao upgrade atual.
        • Exibir plano de upgrade gerado: Esta é uma maneira alternativa de exibir o plano de upgrade criado recentemente. Esta opção é útil quando você recarrega a página e a faixa de mensagem de sucesso desaparece.
          Nota:
          Esta opção fica visível somente após a criação do plano de upgrade.
      Quando o plano de upgrade for finalmente selecionado, o. Selecione o plano de upgrade e. Crie um novo as opções estão desabilitadas.
    2. Visualizar upgrades da aplicação.

      Você pode visualizar todas as aplicações da loja com suas atualizações para sua instância. Se a geração da visualização do upgrade estiver em andamento, você poderá rastreá-la usando o link Rastreador de execução.

      • Apps selecionados: Você pode revisar as seguintes informações
        • Apps personalizados: Número de apps que foram personalizados
        • Novos apps a serem instalados: Número total de novos apps a serem instalados para o upgrade
        • Apps a serem atualizados: Número total de apps existentes cuja versão precisa ser atualizada
          Nota:
          Se você tiver desabilitado Fazer upgrade de aplicações da loja para a versão mais recente anteriormente, o valor de Apps a serem atualizados dependerá da seleção manual da seção Fazer upgrade de aplicações da loja.
      • Fazer upgrade de aplicações da Store
        • Aplicação: Nome da aplicação
        • Versão atual: A versão atual da aplicação na instância
        • Versão mais recente: A versão mais recente disponível da aplicação
        • Versão de upgrade: A versão selecionada da aplicação para a qual você deseja fazer upgrade
        • Estado: Estado da aplicação com base na versão selecionada para o upgrade. Ele exibe um dos dois Compatível ou Verifique a compatibilidade com base na versão selecionada, se for compatível ou não.
        • Mensagem de status: Fornece mais informações sobre a compatibilidade do app se houver falhas após a execução Verifique a compatibilidade do app .
          Nota:
          Se você tiver selecionado anteriormente a opção de upgrade automático, as aplicações serão atualizadas para a versão mais recente por padrão.

          Se você não tiver selecionado a opção de upgrade automático anteriormente, você terá a opção de selecionar a versão da aplicação para a qual deseja fazer upgrade.

        O número de apps a serem atualizados é atualizado dependendo da seleção manual dos apps para as versões selecionadas. Por exemplo, se você selecionar Defina tudo como a versão mínima Para todas as aplicações, o número de aplicações a serem atualizadas permanece inalterado. Selecione Defina tudo como mais recente se você quiser atualizar todas as aplicações para a versão mais recente disponível. Certifique-se de verificar a compatibilidade dos apps depois de selecionar suas versões selecionando Verifique a compatibilidade do app . Se uma aplicação não for compatível, modifique a versão para torná-la compatível antes de passar para a próxima etapa.
        Nota:
        Você pode prosseguir para a próxima etapa do processo de upgrade somente depois de verificar a compatibilidade das aplicações.

        Selecione Exibir plano de upgrade Na seção Aplicativos selecionados para ver todos os itens junto com as versões selecionadas que estão sendo adicionadas ao plano de upgrade no final desta etapa.

        Agora, você pode editar esta etapa selecionando Editar etapa mesmo depois de marcá-lo como concluído.
        Nota:
        . Editar etapa a opção está disponível somente quando você marca esta etapa como concluída e antes de programar ou iniciar qualquer upgrade. Depois de selecionar Editar etapa , A próxima etapa no processo de pré-upgrade é redefinida. Novamente, você pode prosseguir para a próxima etapa do processo de upgrade somente depois de verificar a compatibilidade das aplicações.

      Se o upgrade automático não tiver sido aceito, você poderá selecionar manualmente as versões das aplicações a serem atualizadas. Selecione Defina tudo como mais recente se você quiser atualizar todas as aplicações para a versão mais recente disponível. Certifique-se de verificar a compatibilidade dos apps depois de selecionar suas versões selecionando Verifique a compatibilidade do app . Se uma aplicação não for compatível, modifique a versão para torná-la compatível antes de passar para a próxima etapa.

    3. Revise os registros ignorados previstos.
      Os registros ignorados ocorrem quando as personalizações na sua instância impedem que determinados arquivos sejam atualizados automaticamente durante um upgrade.
      • Visualização do upgrade: Você pode exibir a versão atual e a versão de visualização do upgrade nesta seção. Você também pode ver se há algum upgrade agendado.
      • Resumo do registro ignorado: Você pode exibir as seguintes informações.

        • Total de registros alterados: Fornece o número total de registros que foram alterados desde o último upgrade. Selecione o link Revisar mudanças para ver a lista de registros que foram alterados.
        • Total de registros ignorados: Mostra o número de registros ignorados que foram resolvidos, o total de registros ignorados que precisam ser revisados e o número de registros ignorados que já foram revisados.
        • Registros ignorados sem testes: Informa o número total de registros ignorados que têm testes. O link Testar vinculado na seção Registros ignorados aponta para a lista de testes dos registros ignorados que têm testes associados.
      • Registros ignorados previstos: Mostra o número total de registros ignorados previstos
        • Nome: Nome do registro ignorado
        • Produto: Nome do registro ao qual o registro ignorado pertence
        • Prioridade:
        • Status: Status do registro ignorado se ele tiver sido resolvido, revisado ou precisar ser revisado
        • Disposição de previsão: Ação prevista para ser executada no registro ignorado durante o upgrade selecionado.
          • Inserção prevista: O sistema está previsto para inserir um novo registro.
          • Atualização prevista: O sistema está previsto para atualizar este registro.
          • Revertido: Este registro foi revertido para a versão base e não será ignorado no próximo upgrade.
          • Ignorar previsto: O sistema não mudará este registro para preservar personalizações.
          • Ignorar previsto (mesclagem manual): O sistema não mudará este registro porque atualizá-lo requer intervenção manual.
          • Ignorar previsto (aplicar uma vez): O sistema deve ignorar este registro porque já aplicou uma atualização de um arquivo xml na pasta Aplicar uma vez.
        • Plug-in: O ID do app em que o registro ignorado é encontrado
      • Editor de regras de registro ignorado: Use o editor de regras de registro ignorado para criar regras de registro ignoradas com base nas condições definidas para definir personalizações após um upgrade.
        Nota:
        Esta etapa foi concluída na etapa Revisar registros ignorados previstos.

        Captura de tela mostrando o editor de regras de registro ignorado em uma instância de produção

        Os registros ignorados que correspondem às condições definidas no editor de regras de registro ignorados executam as ações selecionadas anteriormente. Selecione Exibir o histórico de upgrades mais recente para determinar as ações e condições a serem definidas dependendo dos upgrades anteriores.
        As regras de registro ignoradas mostram a lista de regras de registro ignoradas na instância.
        • Nome: O nome da regra
        • Ativo: Informa se a regra está ativa ou não
        • Condições: Condições definidas pela regra para filtrar os registros ignorados
        • Ação: Ação escolhida anteriormente para a regra específica
        • Ordem: A ordem em que as regras são classificadas

        Selecione Criar regra se você quiser criar regras de registro ignoradas adicionais.

      Você pode fazer o seguinte nesta atividade de pré-upgrade.
      • Revise a lista de registros ignorados previstos no módulo Visualização e decida quais versões dos arquivos serão mantidas.
      • Você pode escolher algumas personalizações para serem revertidas para a versão base, permitindo que elas passem por todo o processo de upgrade sem serem ignoradas.
      • Certifique-se de revisar e atualizar a lista de registros ignorados após o upgrade.
      • Após concluir a revisão dos registros ignorados, conclua as próximas atividades necessárias no processo de pré-upgrade.