Como executar a ferramenta UPDBATCH

Como visto no artigo, aplicando pacotes em lote no Protheus, a ferramenta UPDBATCH simplifica muito o processo execução das atualizações dentro do Protheus, mas como é feita a sua execução?

• Digite UPDBATCH como Programa Inicial no SmartClient.

• Faça o login de Administrador do Protheus.

• Na tela principal são exibidos os Artefatos e Conjuntos de atualização. Não é permito que no conjunto haja mais de um artefato do mesmo tipo.

Por exemplo: não podem haver 2 arquivos SDF, ou 2 arquivos de Help para o mesmo país no conjunto. Pode haver apenas 1 SDF e arquivo de Help por país.

Artefato é cada um dos arquivos atualizáveis que compõem um pacote, como por exemplo o SDFBRA.TXT e o HLPDFPOR.TXT.

Conjunto é o agrupamento de artefatos de um mesmo pacote, como por exemplo o pacote de expedição continua do RH.

• O 1º Conjunto já vem previamente criado e para começar, clique em Adiciona artefato, navegue até a pasta onde está o arquivo, selecione e clique em Abrir, e então será exibida uma mensagem informando que o Artefato foi incluído com sucesso.

Obs.: a partir da LIB versão 20220905, a tela de seleção de artefatos passa a ter a possibilidade de seleção múltipla de objetos, com a caixa de diálogo de arquivos do sistema operacional. Caso utilize a versão WebApp, é necessário que este seja da versão 7.0.2 ou superior.

• Para adicionar o próximo arquivo de atualização, é necessário criar um novo Conjunto já que é obrigatório inserir apenas 1 pacote de atualização (Artefato) por Conjunto. Para isso, clique em Adicionar conjunto e um novo Conjunto será adicionado abaixo do anterior.

• Em seguida navegue até a pasta onde está o próximo arquivo de atualização, selecione e clique em Abrir. O arquivo será adicionado ao segundo Conjunto e para prosseguir, clique em Confirmar.

• Agora insira a Descrição deste Lote, e selecione quais parâmetros de log devem ser armazenados durante a atualização. Algumas opções são obrigatórias e bloqueadas na atualização em lote, é possível também visualizar as informações de metadados do arquivo de atualização, como Release, descrição do pacote, entre outras. Para isso, clique no botão Outras Ações > Metadados.

• Para iniciar a atualização em lote, clique em Confirmar e será exibida uma janela de confirmação.

• Durante a atualização, o Conjunto que estiver sendo atualizado no momento, aparecerá com status Em processamento, e os próximos ficarão com status Em espera. Quando concluir um lote, este ficará com status Concluído com sucesso. Note que na barra de status Mensagem, no rodapé da página, são exibidas informações sobre o andamento da atualização, como “Tempo de processamento SX3”, por exemplo. Cada passo da atualização será exibido, mostrando o tempo que levou para aquela operação ser concluída. (Mensagens de tempo de processamento disponíveis a partir da LIB versão 20220905)

• Ao final, serão apresentados os botões Log de atualização e Sair. Se quiser conferir o log das atualizações efetuadas pelo UPDBATCH, clique no botão Log de atualização, e o log será apresentado.

Obs.: melhoria do Log de atualização disponível a partir da LIB versão 20220905.

Se ocorrer algum erro durante a migração, e esta for interrompida, ao reiniciar o UPDBATCH será apresentada uma janela informando que existe uma migração em lote não finalizada, podendo escolher em parar a migração anterior e começar uma nova, ou prosseguir com a migração existente.

Lembre-se que em ambos os casos, o que já tinha sido atualizado antes, não será desfeito, a atualização será feita novamente por cima da anterior. Caso decida prosseguir com a migração, o programa irá reiniciar a atualização do lote que foi interrompido e continuar com os próximos, e mantém o que já tinha sido completado