Introdução

Nesta página iremos demonstrar como realizar a atualização do Protheus para utilização do módulo SIGATAF na versão 12 ( Disponível a partir do release 12.1.1 ).

Antes de seguir com o processo de atualização tenha certeza que o seu ambiente atenda os pré-requisitos estabelecidos, caso contrário acesse Encontre a Arquitetura ideal de Implantação e verifique os passos necessários para a utilização do TAF de acordo com seu cenário.

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.

ATENÇÃO: 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 dois modelos de atualização:

• Através da expedição de novos releases do sistema Microsiga Protheus ( Release Incremental )
• Através de 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 que as atualizações do TAF sejam realizadas a toda liberação de releases da TOTVS, dessa forma garante-se que o produto sempre estará atualizado com as novas funcionalidades desenvolvidas.

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

Atualização através do Release Incremental - Microsiga Protheus

Para a atualização através do release incremental do Microsiga Protheus, todo o processo de atualização do sistema na versão 12 deve ser feito de acordo com os procedimentos de atualização padrões. Trata-se de um processo adotado para todos os produtos desenvolvidos na arquitetura Microsiga Protheus, inclusive para o TAF - TOTVS Automação Fiscal.

Mais detalhes sobre os procedimentos podem ser encontrados nos links abaixo:

• Procedimento de Migração de Versão - Protheus 11 para Protheus 12
• Quais são os Erros Críticos mais comuns durante a migração de versão?
• Release incremental do Protheus 12
• Atualizador de dicionário e base de dados - UPDDISTR

Atualização através de pacotes do 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 MICROSIGA PROTHEUS VERSÃO 11;

Em "Software", selecionar "Todos";

Em "Categoria", selecionar "Instalador";

Em "Arquivo", selecionar o Atualizador do TAF;

4. Realizar Backup do Ambiente:

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

• Na instalação padrão o repositório de dados está disponível em um diretório chamado APO, podendo ser diferente conforme a instalação do produto na empresa.

II. Realizar Backup do Dicionário de Dados e Layout de Integração:

• Na instalação padrão o dicionário de dados e o layout de integração estão disponíveis em um diretório chamado SYSTEM, podendo ser diferente conforme a instalação do produto na empresa.

III. Importante:

• Todo o processo de atualização de ambiente deve ser realizado pelo analista de sistemas responsável pelo gerenciamento do ambiente do TAF, procedimentos realizados de forma incorreta podem comprometer o correto funcionamento do produto.

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

5. Realizar Atualização do Ambiente:

I. Atualizar o layout de Integração:

• O layout de integração é utilizado para que todo o mecanismo de integração do TAF funcione corretamente, sendo assim é atualizado sempre que ocorrem melhorias ou implementações no produto.

• Para realizar a atualização do layout de integração copie o arquivo LAYOUT.DEF existente no pacote de atualização e copie-o para o diretório padrão SYSTEM (O nome do diretório pode ter sido alterado na instalação do TAF) de seu ambiente, conforme abaixo:

II. 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 o mesmo esteja contido no pacote disponibilizado, para isso basta seguir os dois passos abaixo:

• Copiar o Arquivo SIGATAF.XNU contido no pacote de atualização.

• Colar o Arquivo SIGATAF.XNU no diretório padrão SYSTEM (O nome do diretório pode ter sido alterado na instalação do TAF).

III. Atualizar o repositório de dados:

• O repositório de dados é utilizado para armazenar todas as funcionalidades desenvolvidas para o TAF, sendo assim é atualizado sempre que ocorrem melhorias ou implementações no produto.

• Para realizar a atualização do repositório de dados é necessário copiar o arquivo com extensão “. PTM” contido no pacote de atualização e aplicá-lo no ambiente do produto TAF, conforme abaixo:

• Abra o TDS (Totvs Developer Studio) e selecione o botão “Aplicar Patch”, para mais detalhes sobre o TDS acesse Como Instalar o Totvs Developer Studio :

• Indique o servidor, ambiente e o diretório onde se encontra o arquivo com extensão “. PTM”:

• Após selecionar o arquivo selecione o botão avançar:

• Na próxima tela serão exibidos todos os programas que serão atualizados no repositório de dados, selecione o botão concluir e a atualização será realizada:

 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.

IV. Atualizar arquivo de autocontidasv????.taf:

O arquivo compactado de autocontidas é utilizado popular as tabelas do TAF que são pré-definidas pelo Governo, e que serão utilizadas como contra-domínio em outras tabelas, como consultas por exemplo.

• Para realizar a atualização deste arquivo compactado, copie a pasta para dentro do "rootpath", pois somente na execução do "Wizard de Configuração" ela será utilizada.

V. Atualizar arquivo de layouts MILE:

Trata-se de arquivos contendo todos os layouts TOTVS utilizados para integração via MILE.

• Para realizar a atualização destes arquivos, crie uma pasta dentro do "rootpath" com o nome "Layout_TAF", e copie os 3 arquivos( layouts.dbf, layouts.dtc e layouts.fpt ) para dentro desta pasta criada; na execução do "Wizard de Configuração" ela será utilizada.

VI. Configuração do TOPMEMOMEGA:

Trata-se de uma chave do appserver.ini para habilitar processamento de campos textos de grandes tamanhos.

• Para realizar a configuração desta chave, acesse a pasta onde se encontra o appserver e edite o arquivo .ini para incluir dentro do ambiente.

VII. Atualizar o Dicionário de Dados ( UPDDISTR ):

• Para atualização do dicionário de dados completo do TAF deve ser utilizada a ferramenta padrão de compatibilização da TOTVS UPDDISTR.

• Faça a cópia dos seguintes arquivos para a pasta Systemload:

1. 1. sdfbra.txt: arquivo que possui o dicionário de dados completo do TAF. Devido as regras de atualização do UPDDISTR ( veja mais detalhes em Regras para atualização do dicionário SX3 - UPDDISTR e migrador de versão. ) algumas alterações de dicionário não podem ser realizadas neste processo. Esses ajustes serão feitos através do UPDTAF ( ver no passo V desta página ).
   2. hlpdfpor/hlpdfeng/hlpdfspa.txt: arquivos que possuem o help de campos completo do TAF.

 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.

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

     

ATENÇÃO: É obrigatória a execução e verificação dos logs do UPDDISTR antes de executar o UPDTAF, procedimentos efetuados de forma incorreta podem comprometer o funcionamento do produto.

• Realize a execução do compatibilizador pelo SmartClient conforme abaixo: 

• Nas telas iniciais serão exibidas as informações de ambiente e o propósito do compatibilizador, selecione o botão “Avançar”:

• Após o processamento do compatibilizador o dicionário do TAF estará atualizado:

Para verificar se houve alguma inconsistência durante a atualização do dicionário de dados, clique em "Consulta LOG":

Então clique em "Filtrar" e selecione o campo "Tipo do evento" como "Critical Error".

Caso o filtro retorne algum evento de "Critical Error", significa que foram encontrados problema na base de dados e nenhuma atualização foi efetivada no ambiente. Neste caso o UPDDISTR não tem autonomia para corrigir e os ajustes devem ser realizados pelo Administrador do Sistema.

 • Para maiores detalhes de utilização da ferramenta UPDDISTR acesse Atualizador de dicionário e base de dados - UPDDISTR.

VIII. Atualizar o Dicionário de dados ( UPDTAF ):

No próximo passo se faz necessário a execução do Update do TAF - UPDTAF - para tratar ajustes pontuais que não são realizados pelo UPDDISTR.

Basta executar através do smartclient o Programa UPDTAF, conforme abaixo:

Ao executar, serão apresentadas as opções de atualização disponíveis, e através da coluna STATUS é possível verificar a necessidade de execução de determinado item:

Ao final do processamento será apresentada uma tela de LOG com todas as alterações que foram realizadas no ambiente:

Mais informações sobre o UPDTAF podem ser encontradas no boletim da rotina, através do Link UPDTAF.

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

Trata-se do processo de atualização de funcionalidades internas do TAF. Para maiores detalhes sobre como utilizar a Wizard de Configuração, clique aqui.