atualização
Novo processo de atualização dos add-ons TaxPlus Docs. Eletrônicos
Como atualizar o add-on e o serviço do TaxPlus Docs. Eletrônicos com um hotfix pela nova tela de Atualização, sem precisar substituir DLLs manualmente.
Resumo rápido
- No add-on: Configuração > Atualização do TaxPlus NF-e (no DF-e, Atualização do TaxPlus DF-e; na NFS-e, Atualização do TaxPlus NFS-e) > selecione o hotfix mais recente > Atualizar esta estação;
- Pare e inicie o add-on;
- Se o hotfix altera o serviço: Monitor de Serviços > aba Atualização > Atualizar o serviço;
- Feche e abra novamente o Monitor de Serviços e reinicie os serviços;
- Repita em cada servidor do ambiente.
O que muda em relação ao processo manual
O add-on passa a listar os hotfixes publicados para a versão instalada, mostra o que mudou em cada um e faz a troca dos arquivos sozinho, guardando um backup. O serviço é atualizado da mesma forma, pelo Monitor de Serviços.
| Processo manual (como era) | Novo processo (como fica) |
|---|---|
| DLL enviada pelo ticket | Hotfix baixado direto pela tela do add-on |
| Localizar a pasta da instalação no Windows | A tela mostra a versão e a pasta da estação |
| Renomear a DLL antiga para "_old" e colar a nova | Troca automática, com backup dos arquivos atuais |
| Repetir a troca na pasta dos serviços | Atualização do serviço pelo Monitor de Serviços |
| Para desfazer, renomear os arquivos de volta | Botão Voltar para a versão original ou reaplicar um hotfix anterior |
| Sem registro do que foi feito | Histórico por máquina: data, usuário, versões e status |
Importante: os hotfixes são cumulativos. Cada um é gerado sobre a versão original instalada e já traz todas as correções dos hotfixes anteriores dessa versão. O quadro O que mudou mostra só o que entrou naquele hotfix; para ter tudo, basta aplicar o mais recente.
Produtos atendidos
TaxPlus NF-e / NFC-e TaxPlus DF-e TaxPlus NFS-eDemais add-ons: Em Breve
Os demais add-ons TaxPlus Docs. Eletrônicos receberão o recurso nas próximas versões e, até lá, continuam com o processo manual. Os exemplos deste artigo usam o TaxPlus NF-e; no TaxPlus DF-e e no TaxPlus NFS-e o processo é o mesmo, pelo menu do próprio produto (Atualização do TaxPlus DF-e e Atualização do TaxPlus NFS-e).
→ Histórico de Releases - TaxPlus Docs. Eletrônicos Clique aqui para consultar as versões ativas de cada add-onPré-requisitos
- Quem executa: o responsável pela atualização do ambiente, geralmente o parceiro ou o próprio cliente;
- Permissão: usuário administrador do Windows, na estação do add-on e no servidor dos serviços;
- Versão: o add-on precisa estar numa versão que já tenha a opção Atualização do TaxPlus NF-e (ou Atualização do TaxPlus DF-e / Atualização do TaxPlus NFS-e) no menu. Se ainda não tiver, siga antes a Primeira atualização, logo abaixo.
⚠️
Atenção: a atualização é por estação/servidor. Se o cliente possuir mais de um servidor (TS ou instalação local), o processo deve ser executado e validado em cada um deles.
Primeira atualização — habilite a nova tela
Para ter a tela de Atualização, o add-on precisa estar na versão ativa, que já traz o recurso. Esse procedimento é feito uma única vez, em cada estação e servidor. Os exemplos abaixo usam o TaxPlus NF-e / NFC-e, versão 26.9.1.735.
1
Acesse o Release Note da versão ativa do add-on
Consulte a versão ativa do add-on (NF-e / NFC-e, DF-e ou NFS-e) no Histórico de Releases e abra o Release Note dessa versão. Em Hotfix com Correções Implementadas para a Versão, localize a linha do add-on e clique em DLL.
Consulte a versão ativa do add-on (NF-e / NFC-e, DF-e ou NFS-e) no Histórico de Releases e abra o Release Note dessa versão. Em Hotfix com Correções Implementadas para a Versão, localize a linha do add-on e clique em DLL.
2
Baixe o pacote de DLLs do add-on
O pacote vem compactado com todas as DLLs do add-on. Exemplo: release_versao_26.9.1.735_NFe.zip.
O pacote vem compactado com todas as DLLs do add-on. Exemplo: release_versao_26.9.1.735_NFe.zip.
3
Atualize os arquivos nas pastas do add-on e dos serviços
Substitua os arquivos na pasta de instalação do add-on e na pasta dos serviços, como no processo manual (veja o passo a passo).
Substitua os arquivos na pasta de instalação do add-on e na pasta dos serviços, como no processo manual (veja o passo a passo).
Pronto! A partir de agora, as atualizações já podem ser realizadas por dentro do próprio add-on, como mostrado nas Partes 1 e 2.
Parte 1 — Atualizar o add-on
1
Abra a tela de atualização
No SAP Business One, acesse Módulos > TaxPlus NF-e / NFC-e > Configuração > Atualização do TaxPlus NF-e. No DF-e e na NFS-e, acesse a opção Atualização do TaxPlus DF-e ou Atualização do TaxPlus NFS-e no menu do próprio produto.
No SAP Business One, acesse Módulos > TaxPlus NF-e / NFC-e > Configuração > Atualização do TaxPlus NF-e. No DF-e e na NFS-e, acesse a opção Atualização do TaxPlus DF-e ou Atualização do TaxPlus NFS-e no menu do próprio produto.
2
Conheça a tela
| Área | O que mostra |
|---|---|
| Esta estação | Versão em uso, versão registrada no SAP e pasta da instalação |
| Hotfix - Atualizações disponíveis | Hotfixes publicados para a versão instalada: versão, data, tamanho e situação |
| O que mudou | Tarefas e descrição das correções do hotfix selecionado |
| Aviso laranja | Indica que o hotfix também altera o serviço (veja a Parte 2) |
| Botões | Verificar atualizações, Atualizar esta estação e Voltar para a versão original |
| Histórico de atualizações | Todas as atualizações e reversões feitas, por máquina |
3
Escolha o hotfix
Selecione o hotfix na lista (normalmente o mais recente, no topo) e confira no quadro O que mudou se a correção esperada está incluída.
Selecione o hotfix na lista (normalmente o mais recente, no topo) e confira no quadro O que mudou se a correção esperada está incluída.
4
Clique em Atualizar esta estação
Confira na mensagem a versão atual, a versão nova e o tamanho do pacote, e clique em Sim. O instalador é baixado e os arquivos são trocados na hora, mesmo com o add-on em uso; os arquivos atuais ficam numa pasta de backup dentro da instalação.
Confira na mensagem a versão atual, a versão nova e o tamanho do pacote, e clique em Sim. O instalador é baixado e os arquivos são trocados na hora, mesmo com o add-on em uso; os arquivos atuais ficam numa pasta de backup dentro da instalação.
5
Aguarde a mensagem Atualização aplicada
A barra Aplicando o hotfix... mostra o andamento. Ao final, clique em Ok. Se o hotfix também altera o serviço, a mensagem traz esse aviso. O histórico passa a mostrar a atualização com o status Aguardando reinício.
A barra Aplicando o hotfix... mostra o andamento. Ao final, clique em Ok. Se o hotfix também altera o serviço, a mensagem traz esse aviso. O histórico passa a mostrar a atualização com o status Aguardando reinício.
6
Pare e inicie o add-on
⚠️
Atenção: a nova versão só entra em uso depois que o add-on é parado e iniciado. Até lá, a estação continua executando a versão anterior.
Parte 2 — Atualizar o serviço
Quando o hotfix altera o serviço do TaxPlus Docs. Eletrônicos (emissão de notas, download de XML etc.), a tela do add-on exibe o aviso "Este hotfix também altera o serviço TaxPlus NF-e". O serviço não é atualizado automaticamente e sempre acompanha a versão do add-on, por isso atualize primeiro o add-on e depois o serviço.
1
Abra o Monitor de Serviços, aba Atualização
No servidor do serviço, abra o Monitor de Serviços e acesse a aba Atualização. A tela mostra a versão em execução no servidor e a versão do add-on. Quando são diferentes, aparece um aviso em laranja informando o hotfix em que o add-on está e a versão em que o servidor está.
No servidor do serviço, abra o Monitor de Serviços e acesse a aba Atualização. A tela mostra a versão em execução no servidor e a versão do add-on. Quando são diferentes, aparece um aviso em laranja informando o hotfix em que o add-on está e a versão em que o servidor está.
2
Clique em Atualizar o serviço para <versão>
Confirme com Sim. Os arquivos do serviço são trocados e os arquivos atuais vão para uma pasta de backup dentro da instalação (old_ seguido da data e hora). Nada é removido ou recriado no Windows, e os documentos em processamento são retomados quando os serviços voltarem.
Confirme com Sim. Os arquivos do serviço são trocados e os arquivos atuais vão para uma pasta de backup dentro da instalação (old_ seguido da data e hora). Nada é removido ou recriado no Windows, e os documentos em processamento são retomados quando os serviços voltarem.
3
Clique em OK na mensagem final
4
Feche e abra novamente o Monitor de Serviços e reinicie os serviços
⚠️
Atenção: após a atualização, é obrigatório reiniciar os serviços. A janela do Monitor de Serviços que fez a atualização continua rodando os arquivos da versão anterior, inclusive a versão mostrada no título, até ser reaberta. Feche o monitor, abra-o novamente e reinicie os serviços para que a nova versão entre em uso.
Como confirmar que a atualização foi aplicada
| No add-on (após parar e iniciar) | No serviço (após reabrir o monitor e reiniciar os serviços) |
|---|---|
| ✔ Versão em uso mostra a versão do hotfix aplicado | ✔ Hotfix aplicado e título com a nova versão |
| ✔ Coluna Situação = Já aplicada | ✔ Mensagem verde "O serviço já está na mesma versão do add-on. Nada a fazer." |
| ✔ Etiqueta verde já aplicado nesta estação | ✔ Nenhum hotfix pendente para este serviço |
| ✔ Histórico com status Concluída | ✔ Histórico com componente Serviço e status Concluída |
Observação: é normal o campo Registrada no SAP e o nome da Pasta continuarem com a versão original. O hotfix aplicado aparece entre parênteses, junto com a data e a hora da aplicação. A versão que vale é a de Versão em uso.
Como voltar para um hotfix anterior
Se um hotfix foi aplicado e for necessário voltar para um hotfix anterior, basta reaplicá-lo:
1
Na lista de hotfixes, selecione a linha do hotfix que deseja reaplicar. A linha do hotfix em uso aparece como Já aplicada.
2
Clique em Atualizar esta estação e confirme com Sim.
3
Pare e inicie o add-on. Se o hotfix altera o serviço, atualize-o pelo Monitor de Serviços e reinicie os serviços (Parte 2).
Como voltar para a versão original
Para retirar todos os hotfixes e voltar à versão instalada originalmente:
1
Na tela Atualização do TaxPlus NF-e, clique em Voltar para a versão original.
2
Confirme com Sim. Os arquivos originais são recolocados no lugar, e o hotfix removido fica guardado numa pasta revertido_....
3
Pare e inicie o add-on.
Importante: o serviço não tem a opção de voltar para a versão original, pois ele sempre acompanha o add-on. Depois de voltar o add-on (para a versão original ou para um hotfix anterior), abra o Monitor de Serviços, aba Atualização, clique em Atualizar o serviço para deixá-lo compatível e reinicie os serviços.
Perguntas frequentes
Preciso aplicar todos os hotfixes da lista, um por um?
Não. Os hotfixes são cumulativos: aplicando o mais recente, a estação recebe todas as correções anteriores daquela versão.
Atualizei, mas a correção ainda não funciona. O que verificar?
- Se o add-on foi parado e iniciado (o histórico não pode estar em Aguardando reinício);
- Se a correção envolve o serviço: ele também precisa ser atualizado, o Monitor de Serviços reaberto e os serviços reiniciados;
- Se o processo foi feito em todos os servidores do ambiente.
Apliquei um hotfix e quero voltar para o anterior. É possível?
Sim. Selecione na lista a linha do hotfix desejado e clique em Atualizar esta estação. Depois, pare e inicie o add-on e, se for o caso, atualize e reinicie os serviços.
Quem pode executar a atualização?
O responsável pela atualização do ambiente, geralmente o parceiro ou o cliente, com usuário administrador do Windows.
O que é atualizado nesse processo?
Os arquivos do add-on (DLLs). Por isso, se o cliente possuir mais de um servidor, o add-on deve ser iniciado em todos os servidores após a atualização.
É feita alguma alteração no banco de dados?
Sim. A atualização pode alterar a estrutura do banco de dados, por exemplo com a criação de campos, tabelas e procedures.
Preciso executar o "Criar Campos" após a atualização?
Sim. Recomendamos executar o processo Criar Campos no Cadastro de Entidades após a atualização.
Onde ficam os arquivos substituídos?
Numa pasta de backup dentro da própria instalação do add-on ou do serviço (no serviço, old_ seguido da data e hora). Não é preciso renomear nem apagar arquivos manualmente.
Quando o processo manual ainda vale
O processo manual de substituição de DLL continua funcionando. Use-o nos add-ons TaxPlus Docs. Eletrônicos que ainda não receberam o novo processo e nas versões do TaxPlus NF-e / NFC-e, do TaxPlus DF-e e do TaxPlus NFS-e que ainda não têm a opção de atualização no menu.
→ TaxPlus - Como substituir uma DLL para correção pontual de um erro? Clique aqui para ver o passo a passo do processo manualDúvidas ou Solicitações
Entre em contato com o time de atendimento, abrindo um ticket, para obter orientações sobre a atualização do seu ambiente.