6.7.2 - Atualização do Ambiente - Versão 12

Nesta página demonstraremos como realizar a atualização do TAF - TOTVS Automação Fiscal na versão 12.

Lembrando que caso o cliente tenha interesse em gerar o E-Social pelo TAF obrigatoriamente ele precisará realizar a instalação do TSS seguindo o link Instalação e Configuração do TSS.

Este procedimento de atualização deverá ser realizado a cada virada de release do TAF para garantir que o ambiente sempre esteja atualizado.

Informações Importantes

Para a versão 12 o TAF possui o modelo de atualização por meio do pacote específico do produto TAF disponibilizado no Portal. 

Para verificar quais são as atualizações que serão realizadas na base de dados verifique o documento release notes que é sempre liberado junto com o release (Novidades do Release).

 

É imprescindível ser aplicado também o pacote da última LIB do Protheus disponível no Portal.

Atualização por meio de um pacote do TAF - TOTVS Automação Fiscal


1. Acessar a página de suporte da TOTVS:

2. Acessar a página de Downloads e Atualizações:

 

3. Utilizar o seguinte caminho do menu:

Em "Lista de Produto" selecionar "Protheus";

 

Em "Software", selecionar "Todos";

 

No campo de "pesquisa" digite atualizador_taf e clique em pesquisar:

 

Em "Arquivo", selecionar o Atualizador do TAF ( PACOTE DE CORREÇÃO ) de acordo com o release do seu ambiente:

 

4. Realizar Backup do Ambiente:

I. Realizar o Backup do Repositório de Dados:

II. Realizar Backup do Dicionário de Dados:

III. Realizar Backup da base de dados:

IV. Importante:

TODOS OS PROCEDIMENTOS CITADOS ACIMA DEVEM SER REALIZADOS COM AMBIENTE EM MODO EXCLUSIVO!


5. Realizar Atualização do Ambiente:

 I. Atualizar o Menu:

Por decorrência de novas funcionalidades que são criadas para melhoria do produto TAF é necessário realizar a atualização de Menu caso ele esteja contido no pacote disponibilizado, para isso basta seguir os dois passos abaixo:

 

II. Atualizar o repositório de dados:



 

 

 

Deve ser aplicado também o pacote da última LIB do Protheus disponível no Portal.

A LIB é outro pacote .ptm que deve seguir o mesmo processo de atualização comentado neste tópico.


III. Atualizar o Dicionário de Dados (UPDTAF):

Na atualização do dicionário de dados do TAF deve ser utilizada a rotina UPDTAF, conforme demonstrado abaixo:

Após executar a aplicação, o sistema fará uma varredura no ambiente e, se necessário, antes de fornecer as opções disponíveis de atualização, deverão ser adotados procedimentos de atualização de dicionário de dados utilizando o UPDDISTR, conforme demonstrado abaixo:

O UPDDISTR é a ferramenta padrão de compatibilização da TOTVS (entenda mais em Atualizador de dicionário e base de dados - UPDDISTR.) e a carga de informações básicas do sistema são realizadas por meio desta aplicação.

 

O procedimento abaixo deve ser feito para cada arquivo diferencial de dicionário disponibilizado no pacote do TAF.

Ou seja, é possível que em determinados pacotes o procedimento de atualização do dicionário de dados deva ser executado mais de uma vez.

Como saber se devo executa mais de uma vez?

O pacote será dividido em "partes". A atualização deverá ser realizada impreterivelmente na ordem das "partes" disponíveis. Exemplo:

Neste caso deve-se aplicar o procedimento de atualização com os arquivos da parte 1, em seguida aplicar o mesmo procedimento com os arquivos da parte 2.

É obrigatória a execução e verificação dos logs do UPDDISTR, procedimentos efetuados de forma incorreta podem comprometer o funcionamento do produto.

Os procedimentos que devem ser adotados são:

      1. sdfbra.txt: arquivo que possui o dicionário de dados completo do TAF.
      2. hlpdfpor/hlpdfeng/hlpdfspa.txt: arquivos que possuem o help de campos completo do TAF.
      3. sx2.unq: arquivo que valida duplicidade de registros no ambiente ( pode ser solicitado ou não ).

I. Verifique se o arquivo de trava do UPDDISTR (mpupddistri.tsk) está na pasta appserver. Caso esteja, precisa ser excluído para que o atualizador seja executado corretamente.

II. Verifique se os arquivos de dicionário de todos os grupos de empresas existem na pasta \system (ou correspondente).

Perguntas Frequentes sobre o UPDDISTR:

    • Por que devo executar o compatibilizador UPDDISTR?
      O UPDDISTR é responsável por criar todo o dicionário de dados do TAF, incluindo tabelas, campos, gatilhos, etc.

    • Devo executar o compatibilizador UPDDISTR em todo pacote do TAF que é disponibilizado?
      Não, o UPDDISTR deve ser executado apenas uma vez a cada release.

    • Como saber se ainda devo executar o UPDDISTR para poder acessar o TAF?
      Na inicialização de algumas rotinas do TAF será exibido um alerta exigindo a execução do compatibilizador:


      Exemplo de mensagem apresentada em novas rotinas:

      "Inconsistência:

      O ambiente do TAF está com o dicionário de dados incompatível com a versão dos fontes existentes no repositório de dados, este problema ocorre devido a não execução dos compatibilizadores do produto.

      Será necessário executar o UPDDISTR com o último arquivo diferencial ( SDFBRA ) disponível no portal do cliente.

      Siga as instruções do link abaixo para realizar a atualização: Atualização do Ambiente - Versão 12

      Após seguir os passos acima o acesso ao TAF será liberado!"




      Exemplo de mensagem apresentada em rotinas já existentes que possuem criação de novos componentes:

      "O sistema identificou a ausência de componentes neste ambiente que influenciam no resultado final do processo. Para mais informações sobre a atualização de ambiente acesse: Atualização do Ambiente - Versão 12

      Campos:

      C1H_RAMO(Cadastro de Participantes)"





    • Apliquei o UPDDISTR e está com as seguintes ocorrências de erros ( critical error ):
      - O campo da chave de índice não existe no SX3 da empresa.
      - Índice duplicado.
      Como proceder?
      Entre em contato com o suporte para entendimento das inconsistências do ambiente.

 

 

 

 

 

 

 



 






Neste momento, ao concluir a execução desta atualização, deve ser avaliado a necessidade de nova execução do UPDTAF, conforme informado no início do tópico III. Atualizar o Dicionário de Dados ( UPDTAF)

 

VIII. Segunda etapa de atualização de dicionário de dados



IX. Atualizar as Tabelas Auto-Contidas e Componentes de Integração:

Trata-se do processo de atualização de funcionalidades internas do TAF. Para mais detalhes sobre como utilizar a Wizard de Configuração, acesse: Wizard de Configuração.