Prezado cliente, Bem Vindo !

Versão 12: Todas as evoluções de produto e correções liberadas até a data de Julho/2024 estão contempladas na atualização abaixo, siga o procedimento de atualização descritos de acordo com o seu ERP Os procedimentos abaixo devem ser realizados para atualização do pacote PREMIUM do eSocial , para os produtos / Reinf - Produtos TAF e TSS.

Este pacote também inclui as implementações das Notas Técnicas (NTs) do eSocial até a versão 04/2024, referentes ao layout 1.2.

Clientes Microsiga Protheus e/ou Clientes que não podem utilizar o novo atualizador devido a sua arquitetura de ambiente

Clientes Microsiga Protheus

Arquivos recebidos:

Image Removed

Descompactar e utilizar no passo a passo de atualização:

Image Removed

Acessar a página de Downloads e Atualizações, e selecionar a linha de produto TAF:

Image Removed

1. Selecionar a opção correspondente ao release que está utilizando e o tipo de atualização que deseja fazer.

1.1. Atualizações Periódicas: Contém o pacote de atualização do repositório de objetos (fontes):

Image Removed

1.2. Dicionário de dados: Contém o pacote de atualização do metadados do sistema:

Image Removed

1.3. Help de Campos: Contém o pacote de atualização dos arquivos de help de campos do sistema (F1):

Image Removed

1.4. Menus: Contém o menu atualizado do sistema

Image Removed

ATENÇÃO!

Avaliar se o Filtro está para apresentar "Todos Pacotes Disponíveis", e utilizar o ultimo pacote de atualização disponível;

Image Removed

• 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 :

Image Removed

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

Image Removed

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

Image Removed

• 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:

Image Removed

• 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 DevStudio localizado na pasta \bin\smartclient\ no diretório de instalação do sistema:

Image Removed

Clique na opção Configurações em Arquivo, e depois em Adicionar, para criar novo ambiente de atualização:

Image Removed

Na tela de criação, dê um nome ao ambiente através do campo Descrição. No campo Ambiente informe o ambiente criado na instalação e a respectiva conexão do Client ao Server (padrão: ambiente = TAF e conexão = TCP):

Image Removed

Clique em OK e verfique se o ambiente foi criado com sucesso:

Image Removed

Selecione o ambiente criado conforme imagem abaixo:

Image Removed

Clique na opção Atualização de Repositório em Ferramentas:

Image Removed

Informe o usuário e senha do administrador:

Image Removed

Selecione o patch (*.ptm) para aplicação. Observe que o arquivo de extensão .ptm precisa estar em alguma pasta no diretório de instalação do sistema:

Image Removed

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

.

Clientes DATASUL e RM

Clientes DATASUL e RM

Arquivos recebidos:

Image Removed

Descompactar e utilizar no passo a passo de atualização:

Image Removed

Expandir
title Obtendo os arquivos de atualização via Portal do Cliente TOTVS (clique para expandir)
Obtendo o atualizador no portal do cliente Acessar a página de Downloads e Atualizações, e selecionar a linha de produto TAFe-Social conforme figura abaixo: Image RemovedImage Added 1. Selecionar a opção correspondente ao release que está utilizando e o tipo de atualização que deseja fazer. 1.1. Repositórios: Contém o pacote de atualização do repositório de objetos (fontes): Image RemovedImage Removed 1.2. Dicionário de dados: Contém o pacote de atualização do metadados do sistema: Image Removed 1.3. Help de Campos: Contém o pacote de atualização dos arquivos de help de campos do sistema (F1): Image Removed 1.4. Menus: Contém o menu atualizado do sistema Image Removed Atualmente a maioria dos clientes estão na versão 12.1.33 do produto TAF, por este motivo o atualizador se encontra no link desta versão: Image Added Informações title Release 12.1.33 O Atualizador só atualiza ambientes que estão na versão 12.1.33 do protheus. ATENÇÃO! Avaliar se o Filtro está para apresentar "Todos Pacotes Disponíveis", e utilizar o ultimo pacote de atualização disponível;

Expandir
title Passo a passo de atualização (clique para expandir) Instalação das aplicações via Software Instalador (Passo a Passo)
Expandir title Requisitos - Pré Configurações Para instalação dos produtos TAF e TSS são necessários os produtos abaixo: 2 bancos  de dados (1 para cada aplicação) seguindo as especificações dos documentos abaixo:              Banco Microsoft SQL:              Collation e versões suportadas: http://tdn.totvs.com/x/tSuLFQ              Banco Oracle:              Collation e versões suportadas: http://tdn.totvs.com/x/cpRc Servidor de Licenças: http://tdn.totvs.com/x/lPKRDg  Expandir title Execução do Instalador 1. Após a instalação descompactar o arquivo e executar o arquivo TOTVS.PackManager: Image Added 2. Selecionar quais aplicações devem ser instaladas, para  a transmissão do e-Social/Reinf é necessário que sejam selecionadas as opções TAF e TSS. Image Added → Próximo 3. Definir um diretório para a instalação:  Image Added→ Próximo 4. Informar o endereço do Servidor de Licenças: Image Added Informações title IP No campo 'Endereço do License Server', deve ser inserido o endereço IP onde o License Server está instalado, pois nomes de hostname não são aceitos → Próximo 5. Clicar em Parâmetros da Instalação, será exibida a interface descrita no passo 5: Image Added *Parâmetros de Instalação  6 - Realizar a definição do banco de dados: Informar os parâmetros relacionados ao banco de dados criado para a instalação do TAF:  Image Added Informar os parâmetros relacionados ao banco de dados criado para a instalação do TSS:  Image Added Após a parametrização dos do banco de dados os ícones em vermelho mudarão para verde permitindo o prosseguimento da instalação: Image Added → Próximo 7 - Informar as portas que serão utilizadas para o servidor de mensageiria  (TSS - Totvs Service SOA) e o servidor de integração entre TAF x ERP (REST). Image Added→ Próximo 8 - Neste momento o Instalador irá realizar a extração,cópia e configuração dos arquivos necessários para a instalação do TAF/TSS. Image Added Após o termino da instalação será exibido a interface abaixo Image Added Expandir title Configuração pós instalação 1 - Logo após a instalação será aberto uma interface para login, por default na instalação é criado o usuário "admin" sem senha. Image Added → Entrar 2 -  Selecione se a estrutura do ambiente será para um empresa teste ou para uma empresa real (produção). Image Added → Selecionar 3 - Caso seja selecionado a criação de um ambiente com empresa real, será exibido uma interface para a criação da empresa "start" (inicial)  No exemplo abaixo está sendo criado uma empresa com as seguintes características:              - Grupo de Empresas utilizando o código 01, abaixo do grupo podemos ter Empresas, Unidades de Negócios e Filiais              - Leiaute EEFFFF, foi definido que neste grupo serão criadas empresas com até 2 dígitos e filiais com até 4 dígitos EE = Empresas , FFFF = Filiais: Nota E - 0-9 (Somente números entre 0 e 9) E - 5-9 (Somente números entre 5 e 9) U - A-Z (Somente caracteres entre A e Z) U - X-Z (Somente caracteres entre X e Z) F - !-! (Qualquer dígito numérico ou alfanumérico) F - A,B,5,9 (Somente caracteres entre A,B,5 e 9) F - 0-9 (Somente números entre 0 e 9) F - A-Z (Somente caracteres entre A e Z) Saiba mais sobre cadastros de empresas em : http://tdn.totvs.com/x/TMwpE               - Empresa utilizando o código 01 respeitando o que foi especificado na máscara do layout (EE)              - Filial utilizando o código 0001 respeitando o que foi especificado na máscara do layout (FFFF), o código da filial sempre é composto pelo código da empresa + o código da filial, por este motivo para controle interno o sistema utilizará 010001. Image Added → Confirmar  4 - Após a configuração da empresas "start" será exibido uma interface com os parâmetros relacionados a empresa recém criada.: Image Added → Entrar 5 - Selecionar a localização, para a utilização do TAF a mesma deve ser sempre "Brasil":  Image Added → Ok 6 - Selecionar o diretório de arquivo de dados, escolha Servidor: Image Added → Abrir 7 - O Sistema iniciará a criação dos dicionários de dados, esse processo pode levar alguns minutos: Image Added Expandir title Atualização e Parametrização Inicial 1 - Após a criação dos dicionários é necessário é necessário realizar o de/para de códigos de empresas entre ERP x TAF: Image Added → Avançar  2 - Clicar em amarração dos Estabelecimentos:  Image Added 3 - Ao clicar 2x no campo Código complementar o sistema sugere o código a ser utilizado no ERP utilizando o Grupo de Empresas  + Código da Empresa + Código da Filial, este código deve ser cadastrado no ERP caso não exista: Image Added → Finalizar 4 - Após o cadastrado o sistema é fechado e é necessário um novo acesso para continuação da parametrização:  Image Added 5 - Acessar o modulo pelo menu recém criado:  Aviso Os ambientes são criados dinamicamente, por este motivo as ultimas 5 letras existentes na descrição dos itens são variáveis, no exemplo abaixo as letras correspondem a "CULAK". Image Added 6 - Na abertura do módulo será exibido uma interface para criação das tabelas autocontidas, essas tabelas são utilizadas pelo módulo para suporte as tabelas utilizadas pelo RET (Layout e-Social - Anexo I - Tabelas) e demais tabelas referentes a obrigações acessórias:  Image Added → Avançar Image Added → Avançar 7 - Selecionar o Item referente ao Grupo de empresa: Informações Será necessário a execução deste processo cada vez que 1 grupo de empresas for criado. Image Added → Avançar 8 - Marcar a opção de integração, para o e-Social marcar sempre a opção "Layout TOTVS ou Web Service", se o sistema for utilizado também para a entrega do REINF a opção "Layout TOTVS ou Tabela Compartilhada no SGDB" também deve ser marcada, caso contrario Não marcar esta opção: Image Added → Avançar 9 - Indique a porta que deverá ser utilizada pelo serviço REST para comunicação entre ERPs x TAF: Image Added → Avançar 10 - Clicar em "Processar as configurações realizadas neste assistente" para o inicio da criação das tabelas autocontidas e parametrização do serviço REST:  Image Added 11 - Ao final será exibido um log das operações realizadas: Image Added → Finalizar 13 - O sistema é encerrado para que as configurações sejam de fato efetivadas: Image Added → Finalizar 14 - O próximo passo é migrar o dicionário do TAF para a ultima versão, para isso é necessário executar o Atualizador de Dicionários (UPDDISTR):  Image Added 15 - Ao clicar no ícone exibido na imagem anterior, será exibido uma nova Wizard com orientações para a migração do dicionario, o instalador já inclui o arquivo sdfbra.txt no diretório correto, por este motivo só é necessário clicar em "Avançar": Image Added → Avançar Image Added → Avançar Image Added → Avançar 15 - Na primeira utilização do produto não é necessário a realização de backup no banco de dados e arquivo de dicionários por ainda não conter dados referentes as obrigações acessórias, porem o backup facilita a restauração do sistema em caso de falhas críticas: Image Added → Avançar Image Added → Avançar Image Added → Avançar 16 - A atualização de dicionários só pode ser realizadas pelo usuário Administrador, este usuário foi recém criado na instalação como já citado nos itens anteriores, desta forma clique na tecla "Tab" 2x para mudar o foco dos campos usuário e senha que neste momento ainda está em branco e clique em avançar:  Image Added → Avançar Image Added → Avançar Image Added → Avançar Informações Marcar a opção "Corrigir erros automaticamente" Image Added → Avançar Image Added → Avançar Image Added → Avançar Image Added

Expandir
title Passo a passo de atualização (clique para expandir)
Expandir title Atualização do TAF/TSS (clique para expandir) Para clientes que possuem a instalação do TAF segregado em seu ERP o processo de atualização deverá realizado através do novo atualizador do TAF/TSS, esse novo atualizador realiza de forma automática todos os processos necessários para a correta utilização do produto. Segue link com o passo a passo de como realizar o procedimento de atualização: https://tdn.totvs.com/x/zRePI  O documento contido no link acima já possui algumas respostas de dúvidas mais comuns encontrados pelos clientes Expandir title Atualização do repositório de objetos (clique para expandir) Substituir o arquivo tttp120.rpo na pasta \apo\ do diretório de instalação do sistema Image Removed Expandir title Atualização do dicionário de dados (clique para expandir) a) Copiar os arquivos sdfbra.txt e sx2.unq para a pasta \systemload\ do diretório de instalação do sistema b) Executar o compatibilizar de dicionário de dados (UPDDISTR) Image Removed Será solicitado a seleção dos Grupos de Empresa que devem ser atualizados: Image Removed • Nas telas iniciais serão exibidas as informações de ambiente e o propósito do compatibilizador, selecione o botão “Avançar”: Image Removed Image Removed Image Removed Image Removed Image Removed • Após o processamento do compatibilizador o dicionário do TAF estará atualizado: Image Removed Image Removed • Para verificar se houve alguma inconsistência durante a atualização do dicionário de dados, clique em "Consulta LOG": Image Removed • Então clique em "Filtrar" e selecione o campo "Tipo do evento" como "Critical Error". Image Removed Image Removed • 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. Image Removed  • Para maiores detalhes de utilização da ferramenta UPDDISTR acesse Atualizador de dicionário e base de dados - UPDDISTR. Nova execução 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 ) Segunda etapa de atualização de dicionário de dados • Após finalizar a execução dos pacotes atualizados pelo UPDDISTR, deve-se executar novamente o UPDTAF para realizar demais ajustes de ambiente: Image Removed • Quando a varredura do sistema identificar que não há necessidade de execução do UPDDISTR, será apresentada uma lista de ajustes que devem ser realizados no ambiente, conforme demonstrado abaixo: Image Removed • Selecione as atualizações, por release, que devem ser realizadas. Status A coluna 'Status' informa quais atualizações ainda são necessárias. Caso todas estejam com o Status "Executado", este procedimento pode ser ignorado. • Após realizar a seleção, clique em 'Processar' e aguarde o término da execução. • No final do processamento serão apresentadas os ajustes realizados no ambiente, conforme demonstrado abaixo: Image Removed