02.

Atualizao - Mdulo Protheus / Segregado Verso 11

Skip to end of metadata

Created by Gustavo Garbelotti Rueda, last modified by Luccas Brandino Curcio on Sep 15, 2015

Go to start of metadata

Introduo
Nesta pgina iremos demonstrar como realizar a atualizao do Protheus para utilizao
do mdulo SIGATAF na verso 11 ( Disponvel a partir do release R1 ).
Antes de seguir com o processo de atualizao tenha certeza que o seu ambiente do
Protheus atenda os pr-requisitos estabelecidos, caso contrrio acesse Encontre a
Arquitetura ideal de Implantao e verifique os passos necessrios para a utilizao do
TAF de acordo com seu cenrio.
Lembrando que caso o cliente tenha interesse em gerar o E-Social pelo TAF
obrigatoriamente ele precisar realizar a instalao do TSS seguindo o link Instalao e
Configurao do TSS.
ATENO: Este procedimento de atualizao dever ser realizado a cada virada de
release do TAF para garantir que o ambiente sempre esteja atualizado.

Informaes Importantes
Para verificar quais so as atualizaes que sero realizadas na base de dados verifique o
documento release notes que sempre liberado junto com o release ( Protheus - Release
Notes ).
imprescindvel que as atualizaes do TAF sejam realizadas a toda liberao de
releases da TOTVS, dessa forma garante-se que o produto sempre estar atualizado com
as novas funcionalidades desenvolvidas.
Todas as etapas da atualizao devem ser realizadas SEM EXCEO, os processos so
dependentes entre si.
imprescindvel ser aplicado tambm o pacote da ltima LIB do Protheus
disponvel no Portal.

Efetuando a Atualizao
1. Acessar a pgina de suporte da TOTVS:

2. Acessar a pgina de Downloads e Atualizaes:

3. Utilizar o seguinte caminho do menu:

Em "Lista de Produto" selecionar "Protheus";

Em "Software", selecionar MICROSIGA PROTHEUS VERSO 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 Repositrio de Dados:

 Na instalao padro o repositrio de dados est disponvel em um diretrio

chamado APO, podendo ser diferente conforme a instalao do produto na
empresa.
II. Realizar Backup do Dicionrio de Dados e Layout de Integrao:
Na instalao padro o dicionrio de dados e o layout de integrao esto
disponveis em um diretrio chamado SYSTEM, podendo ser diferente conforme
a instalao do produto na empresa.

III. Importante:
Todo o processo de atualizao de ambiente deve ser realizado pelo analista
de sistemas responsvel 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 Atualizao do Ambiente:

I. Atualizar o layout de Integrao:
O layout de integrao utilizado para que todo o mecanismo de integrao do
TAF funcione corretamente, sendo assim atualizado sempre que ocorrem
melhorias ou implementaes no produto.
Para realizar a atualizao do layout de integrao copie o
arquivo LAYOUT.DEF existente no pacote de atualizao e copie-o para o
diretrio padro SYSTEM (O nome do diretrio pode ter sido alterado na
instalao do TAF) de seu ambiente, conforme abaixo:

II. Atualizar o Menu:

Por decorrncia de novas funcionalidades que so criadas para melhoria do
produto TAF necessrio realizar a atualizao 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 atualizao.
Colar o Arquivo SIGATAF.XNU no diretrio padro SYSTEM (O nome do
diretrio pode ter sido alterado na instalao do TAF).

III. Atualizar o repositrio de dados:

O repositrio de dados utilizado para armazenar todas as funcionalidades
desenvolvidas para o TAF, sendo assim atualizado sempre que ocorrem
melhorias ou implementaes no produto.
Para realizar a atualizao do repositrio de dados necessrio copiar o
arquivo com extenso . PTM contido no pacote de atualizao e aplic-lo no
ambiente do produto TAF, conforme abaixo:
Abra o TDS (Totvs Developer Studio) e selecione o boto Aplicar Patch, para
mais detalhes sobre o TDS acesse Como Instalar o Totvs Developer Studio :

 Indique o servidor, ambiente e o diretrio onde se encontra o arquivo com

extenso . PTM:

 Aps selecionar o arquivo selecione o boto avanar:

 Na prxima tela sero exibidos todos os programas que sero atualizados

no repositrio de dados, selecione o boto concluir e a atualizao ser
realizada:

Deve ser aplicado tambm o pacote da ltima LIB do Protheus

disponvel no Portal.
A LIB outro pacote .ptm que deve seguir o mesmo processo de atualizao
comentado neste tpico.

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

O arquivo compactado de autocontidas utilizado popular as tabelas do TAF que
so pr-definidas pelo Governo, e que sero utilizadas como contra-domnio em
outras tabelas, como consultas por exemplo.
Para realizar a atualizao deste arquivo compactado, copie a pasta para
dentro do "rootpath", pois somente na execuo do "Wizard de Configurao"
ela ser utilizada.

V. Atualizar arquivo de layouts MILE:

Trata-se de arquivos contendo todos os layouts TOTVS utilizados para
integrao via MILE.
Para realizar a atualizao 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 execuo do
"Wizard de Configurao" ela ser utilizada.

VI. Configurao do TOPMEMOMEGA:

Trata-se de uma chave do appserver.ini para habilitar processamento de campos
textos de grandes tamanhos.
Para realizar a configurao desta chave, acesse a pasta onde se encontra
o appserver e edite o arquivo .ini para incluir dentro do ambiente.

VII. Atualizar o Dicionrio de Dados ( UPDDISTR ):

Para atualizao do dicionrio de dados completo do TAF deve ser utilizada a
ferramenta padro de compatibilizao da TOTVS UPDDISTR.
Faa a cpia dos seguintes arquivos para a pasta Systemload:
1.
a.

sdfbra.txt: arquivo que possui o dicionrio de dados completo do TAF.

Devido as regras de atualizao do UPDDISTR ( veja mais detalhes em Regras para
atualizao do dicionrio SX3 - UPDDISTR e migrador de verso. ) algumas
alteraes de dicionrio no podem ser realizadas neste processo. Esses ajustes
sero feitos atravs do UPDTAF ( ver no passo V desta pgina ).

b.

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 excludo para que o atualizador seja
executado corretamente.
Verifique se os arquivos de dicionrio 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 responsvel por criar todo o dicionrio de dados
do TAF, incluindo tabelas, campos, gatilhos, etc.

Devo executar o compatibilizador UPDDISTR em todo pacote

do TAF que disponibilizado?
No. 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 inicializao do TAF ser exibido um alerta exigindo a
execuo do compatibilizador:
"Inconsistncia:
O ambiente do TAF est com o dicionrio de dados incompatvel
com a verso dos fontes existentes no repositrio de dados, este

problema ocorre devido a no execuo dos compatibilizadores

do produto.
Ser necessrio executar o UPDDISTR e em seguida o UPDTAF
com o ltimo arquivo diferencial ( SDFBRA ) disponvel no portal
do cliente.
Siga as instrues do Link abaixo para realizar a atualizao:
http://tdn.totvs.com.br/pages/releaseview.action?
pageId=187534210
Aps seguir os passos acima o acesso ao TAF ser liberado!"

Realize a execuo do compatibilizador pelo SmartClient conforme abaixo:

 Nas telas iniciais sero exibidas as informaes de ambiente e o propsito

do compatibilizador, selecione o boto Avanar:

 Aps o processamento do compatibilizador o dicionrio do TAF estar

atualizado:

Para verificar se houve alguma inconsistncia durante a atualizao do

dicionrio de dados, clique em "Consulta LOG":

Ento 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 atualizao foi
efetivada no ambiente. Neste caso o UPDDISTR no tem autonomia para
corrigir e os ajustes devem ser realizados pelo Administrador do Sistema.

Para maiores detalhes de utilizao da ferramenta UPDDISTR

acesse Atualizador de dicionrio e base de dados - UPDDISTR.

VIII. Atualizar o Dicionrio de dados ( UPDTAF ):

No prximo passo se faz necessrio a execuo do Update do TAF UPDTAF - para tratar ajustes pontuais que no so realizados pelo
UPDDISTR.

Basta executar atravs do smartclient o Programa UPDTAF, conforme

abaixo:

Ao executar, sero apresentadas as opes de atualizao disponveis, e

atravs da coluna STATUS possvel verificar a necessidade de execuo
de determinado item:

Ao final do processamento ser apresentada uma tela de LOG com todas as

alteraes que foram realizadas no ambiente:

Mais informaes sobre o UPDTAF podem ser encontradas no boletim da

rotina, atravs do Link UPDTAF.

IX. Atualizar as Tabelas Auto-Contidas e Layout de Integrao:

O processo de atualizao de tabelas auto-contidas e layout deve ser

realizado atravs da Wizard de Configurao:

A Wizard de Configurao do TAF tem como objetivo realizar a atualizao

do ambiente do TAF, ser sempre executado no primeiro acesso do usurio
aps a atualizao do sistema. Caso a Wizard no seja iniciada no primeiro
acesso, ainda existe a possibilidade de execut-la atravs do Menu do TAF:

O processo da Wizard obrigatrio, pois existem alguns processos internos

especficos que no so tratados no Atualizador de dicionrio e base de

dados - UPDDISTR, devido a isso aps realizar a virada de release

necessria a atualizao do TAF via Wizard de Configurao.
Apenas usurios configurados como administrador do sistema podem
executar os procedimentos da Wizard. Enquanto o processo no for
executado nenhum usurio ter possibilidade de acessar o sistema.
Durante o processo de execuo da Wizard as seguintes informaes sero
atualizadas:

Tabelas de Controle Interno do TAF.

Tabelas Auto-Contidas. ( Atualizao de Tabelas Auto-Contidas )

Mecanismo de Integrao do TAF ( Manual de Integrao )

Ateno ao preenchimento dos parmetros:

MV_TAFWIZ ( indica se a Wizard deve ser executada - .T. - ou no - .F. )

MV_TAFVER ( indica a ltima verso de atualizao do TAF. Para que a

Wizard seja processada deve estar uma verso anterior a atual ou em branco ).

MV_TAFINT ( indica se o ambiente deve ser configurado para a

integrao Banco-a-banco ).
Todos os parmetros so criados na etapa de processamento do
UPDDISTR.

Ateno aos detalhes abaixo:

O arquivo layout.def precisa estar obrigatoriamente no diretrio

\system. Caso contrrio no ser possvel prosseguir com a atualizao.

Os arquivo layouts.dbf/fpt/dtc precisam estar obrigatoriamente no

diretrio \Layout_TAF. Caso contrrio no ser possvel prosseguir com a
atualizao.

Desmarcar a opo "Somente Leitura" de todos os arquivos. Caso

contrrio no ser possvel prosseguir com a atualizao.

O arquivo autocontidas.taf precisa estar obrigatoriamente em um diretrio

dentro do RootPath. Caso contrrio no ser possvel prosseguir com a
atualizao.

Verifique se os arquivos de dicionrio de todos os grupos de empresas

existem na pasta \system ( ou correspondente ).

Aps realizar a atualizao do sistema e acessar o SIGATAF pela primeira vez

ser aberta a tela abaixo:

Observao: Caso tenha ocorrido alguma inconsistncia durante a

atualizao do dicionrio de dados, ser apresentada a tela abaixo:

Neste caso ser necessrio refazer o processo de atualizao desde a

execuo do compatibilizador UPDDISTR, atentando-se as possveis falhas
durante o processamento.

A opo Diagnstico far uma validao do ambiente e dos pr-requisitos para

utilizao do TAF. Para mais informaes acesse a pgina Diagnstico de
Ambiente e Sistema

Ainda na opo de diagnstico, possvel extrair as informaes para um

arquivo texto. Clique em Exportar e o arquivo ser extrado na pasta \system
( ou correspondente ):

Aps clicar em Avanar, selecione o(s) grupo(s) de empresa(s) que deseja

processar:

A primeira atualizao realizada a tabela XXJ, utilizada para a integrao via

arquivo texto ( MILE ).
Ateno a utilizao da chave TopMemoMega no ambiente. Para mais
informaes 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 Atualizao de Tabelas
Auto-Contidas ):

Ateno
Para ganho de performance no processamento de multi empresas, utilizar o
parmetro MV_AUTCMT, limitando-se ao preenchimento da quantidade de
threads em 5.

Aps a atualizao das tabelas autocontidas, realizada a atualizao das

tabelas prprias do TAF utilizadas na integrao e gerao das obrigaes
fiscais. Para mais informaes sobre essas tabelas acesse Tabelas Auxiliares.

No passo seguinte dever ser configurado o formato de integrao utilizado no

TAF:

Importante
Esta etapa fundamental para o rebuild das tabelas de controle do TAF. Caso exista
alguma divergncia da estrutura das tabelas no banco de dados com a estrutura
esperada pela integrao, no ser permitida a abertura da tabela e por consequncia
no ser possvel executar o processo de integrao.
Exemplo: A integrao espera que a tabela TAFST1 possua 6 ndices. Caso no
banco de dados exista apenas 5 ndices, no momento em que as rotinas de
integrao validam esta estrutura, impedem de prosseguir com o processo de
integrao em decorrncia da divergncia encontrada. Essa validao ocorre
normalmente nas rotinas de extrao ( extratores fiscais, extratores contbeis... ), no
processo de cpia dos dados da TAFST1 para TAFST2 ( job 0 ) ou no processo de
integrao ( job 2 ).
Ateno ao preenchimento do parmetro MV_TAFINT - habilita a parametrizao
para conexo e rebuild da tabela TAFST1.
A estrutura das tabelas pode ser encontrada em: Tabelas Auxiliares.

Informe se a configurao da integrao banco-a-banco deve ser feita neste

momento. A seleo desta pergunta altera o contedo do
parmetro MV_TAFINT. Caso selecione "1 - Sim", o parmetro ser setado como
.T., caso selecione "2 - No" o parmetro ser setado como .F.. Uma vez
configurado como .F., essa tela no ser mais apresentada durante a execuo
da Wizard at que o contedo seja restaurado para .T.

Informe os dados para criao da tabela TAFST1 ( tabela de integrao que

ficar no domnio do ERP ). O preenchimento dessas perguntas altera o
contedo dos parmetros conforme indicado na prpria Wizard ( MV_TAFTALI,
MV_TAFTDB e MV_TAFPORT ).

Depois que preencher os dados para criao da tabela TAFST1, o sistema far
uma validao de conexo com o banco de dados. Caso seja identificado algum
problema, ser alertado e o usurio ter a opo de preencher novamente os
parmetros de conexo.

Caso a conexo seja feita com sucesso, ser feito o acesso ao mdulo SIGATAF.