Nesta página iremos demonstrar como realizar a atualização do Protheus para utilização do módulo SIGATAF na versão 11 ( Disponível a partir do release R5 - 11.5 ).
Antes de seguir com o processo de atualização tenha certeza que o seu ambiente do Protheus 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.
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 ( Protheus - Release Notes ).
É 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.
Todas as etapas da atualização devem ser realizadas SEM EXCEÇÃO, os processos são dependentes entre si.
É imprescindível ser aplicado também o pacote da última LIB do Protheus disponível no Portal.
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:
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 ).
Perguntas Frequentes sobre o UPDDISTR:
|
• 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:
O processo de atualização de tabelas auto-contidas e layout deve ser realizado através da Wizard de Configuração:
A Wizard de Configuração do TAF tem como objetivo realizar a atualização do ambiente do TAF, será sempre executado no primeiro acesso do usuário após a atualização do sistema. Caso a Wizard não seja iniciada no primeiro acesso, ainda existe a possibilidade de executá-la através do Menu do TAF:
O processo da Wizard é obrigatório, pois existem alguns processos internos específicos que não são tratados no Atualizador de dicionário e base de dados - UPDDISTR, devido a isso após realizar a virada de release é necessária a atualização do TAF via Wizard de Configuração.
Apenas usuários configurados como administrador do sistema podem executar os procedimentos da Wizard. Enquanto o processo não for executado nenhum usuário terá possibilidade de acessar o sistema.
Durante o processo de execução da Wizard as seguintes informações serão atualizadas:
Atenção ao preenchimento dos parâmetros:
Todos os parâmetros são criados na etapa de processamento do UPDDISTR.
Atenção aos detalhes abaixo:
Verifique se os arquivos de dicionário de todos os grupos de empresas existem na pasta \system ( ou correspondente ).
Após realizar a atualização do sistema e acessar o SIGATAF pela primeira vez será aberta a tela abaixo:
Observação: Caso tenha ocorrido alguma inconsistência durante a atualização do dicionário de dados, será apresentada a tela abaixo: Neste caso será necessário refazer o processo de atualização desde a execução do compatibilizador UPDDISTR, atentando-se as possíveis falhas durante o processamento. |
A opção Diagnóstico fará uma validação do ambiente e dos pré-requisitos para utilização do TAF. Para mais informações acesse a página Diagnóstico de Ambiente e Sistema
Ainda na opção de diagnóstico, é possível extrair as informações para um arquivo texto. Clique em Exportar e o arquivo será extraído na pasta \system ( ou correspondente ):
Após clicar em Avançar, selecione o(s) grupo(s) de empresa(s) que deseja processar:
A primeira atualização realizada é a tabela XXJ, utilizada para a integração via arquivo texto ( MILE ).
Atenção a utilização da chave TopMemoMega no ambiente. Para mais informações acesse o FAQ do TAF.
Na tela abaixo deve ser indicado o local onde o arquivo de tabelas auto-contidas (.TAF) se encontra ( Para maiores detalhes consulte Atualização de Tabelas Auto-Contidas ):
Após a atualização das tabelas autocontidas, é realizada a atualização das tabelas próprias do TAF utilizadas na integração e geração das obrigações fiscais. Para mais informações sobre essas tabelas acesse Tabelas Auxiliares.
No passo seguinte deverá ser configurado o formato de integração utilizado no TAF:
Informe se a configuração da integração banco-a-banco deve ser feita neste momento. A seleção desta pergunta altera o conteúdo do parâmetro MV_TAFINT. Caso selecione "1 - Sim", o parâmetro será setado como .T., caso selecione "2 - Não" o parâmetro será setado como .F.. Uma vez configurado como .F., essa tela não será mais apresentada durante a execução da Wizard até que o conteúdo seja restaurado para .T.
Informe os dados para criação da tabela TAFST1 ( tabela de integração que ficará no domínio do ERP ). O preenchimento dessas perguntas altera o conteúdo dos parâmetros conforme indicado na própria Wizard ( MV_TAFTALI, MV_TAFTDB e MV_TAFPORT ).
Depois que preencher os dados para criação da tabela TAFST1, o sistema fará uma validação de conexão com o banco de dados. Caso seja identificado algum problema, será alertado e o usuário terá a opção de preencher novamente os parâmetros de conexão.
Caso a conexão seja feita com sucesso, será feito o acesso ao módulo SIGATAF.