Atualização Taf

02. Atualização Atualização - Módulo Protheus / Segregado Versão 11 Skip to end o !etadata • • •

"reated #$ %usta&o %ar#elotti 'ueda( 'ueda( last !odiied #$ )u**as +randino "ur*io on Sep 1,( 201,

%o to start o !etadata

ntrodução esta pgina ire!os de!onstrar *o!o realizar a atualização do Protheus para utilização do !ódulo S%AA na &ersão 11  3ispon4&el a partir do release '1 5.  Antes de seguir seguir *o! o pro*esso pro*esso de atualização atualização tenha *erteza *erteza 6ue o seu a!#iente a!#iente do Protheus atenda os pr7-re6uisitos  esta#ele*idos( *aso *ontrrio a*esse 8n*ontre a  Ar6uitetura ideal de !plantação !plantação e &erii6ue os passos ne*essrios para a utilização do A de a*ordo *o! seu *enrio. )e!#rando 6ue *aso o *liente tenha interesse e! gerar o 8-So*ial pelo A o#rigatoria!ente ele pre*isar realizar a instalação do SS seguindo o link Instalação e Configuração do TSS. TSS . ATENÇÃO: Este procedimento de atualiação de!er" ser realiado a cada !irada de release do TA# para garantir $ue o am%iente sempre este&a atualiado.

nor!aç9es !portantes Para &erii*ar 6uais são as atualizaç9es 6ue serão realizadas na #ase de dados &erii6ue o do*u!ento release notes 6ue 7 se!pre li#erado :unto *o! o release  Protheus - 'elease otes 5. otes  5. ; i!pres*ind4&el 6ue as atualizaç9es do A se:a! realizadas a toda li#eração de releases da <VS( dessa or!a garante-se 6ue o produto se!pre estar atualizado *o! as no&as un*ionalidades desen&ol&idas. odas as etapas da atualização de&e! ser realizadas SE' E(CEÇÃO( E(CEÇÃO( os pro*essos são dependentes dependen tes entre si. ) imprescind*!el ser aplicado tam%+m o pacote da ,ltima -I do /rot0eus dispon*!el no /ortal.

8etuando a Atua Atualização lização 1. Acessar a p"gina de suporte da TOT2S:

3. Acessar a p"gina de 4o5nloads e Atualiaç6es:

8etuando a Atua Atualização lização 1. Acessar a p"gina de suporte da TOT2S:

3. Acessar a p"gina de 4o5nloads e Atualiaç6es:

7. 8tiliar o seguinte camin0o do menu:

8! =)ista de Produto= sele*ionar =Protheus=>

8! =Sot?are=( sele*ionar M"'

8! =Sot?are=( sele*ionar =odos=>

8! ="ategoria=( sele*ionar =nstalador=>

8! =Ar6ui&o=( sele*ionar o Atualiador  do A>

9. ealiar ac;up do Am%iente: I. ealiar o ac;up do eposit
C a instalação padrão o repositório de dados est dispon4&el e! u! diretório *ha!ado AP<( podendo ser dierente *onor!e a instalação do produto na e!presa. II. ealiar ac;up do 4icion"rio de 4ados e -a=out de Integração: C a instalação padrão o di*ionrio de dados e o la$out de integração estão dispon4&eis e! u! diretório *ha!ado SDS8M( podendo ser dierente *onor!e a instalação do produto na e!presa.

III. Importante: C odo o pro*esso de atualização de a!#iente de&e ser realizado pelo analista de siste!as respons&el pelo geren*ia!ento do a!#iente do A( pro*edi!entos realizados de or!a in*orreta pode! *o!pro!eter o *orreto un*iona!ento do produto.

TO4OS OS /OCE4I'ENTOS CITA4OS ACI'A 4E2E' SE EA-I>A4OS CO' A'IENTE E' 'O4O E(C-8SI2O?

@. ealiar Atualiação do Am%iente: I. Atualiar o la=out de Integração: C < la$out de integração 7 utilizado para 6ue todo o !e*anis!o de integração do A un*ione *orreta!ente( sendo assi! 7 atualizado se!pre 6ue o*orre! !elhorias ou i!ple!entaç9es no produto. C Para realizar a atualização do la$out de integração *opie o ar6ui&o -AO8T.4E# eEistente no pa*ote de atualização e *opie-o para o diretório padrão SDS8M < no!e do diretório pode ter sido alterado na instalação do A5 de seu a!#iente( *onor!e a#aiEoF

II. Atualiar o 'enu: Por de*orrGn*ia de no&as un*ionalidades 6ue são *riadas para !elhoria do produto A 7 ne*essrio realizar a atualização de Menu *aso o !es!o este:a *ontido no pa*ote disponi#ilizado( para isso #asta seguir os dois passos a#aiEoF C "opiar o Ar6ui&o S%AA.H *ontido no pa*ote de atualização. C "olar o Ar6ui&o S%AA.H no diretório padrão SDS8M < no!e do diretório pode ter sido alterado na instalação do A5.

III. Atualiar o reposit
C ndi6ue o ser&idor( a!#iente e o diretório onde se en*ontra o ar6ui&o *o! eEtensão I. PMJF

C Após sele*ionar o ar6ui&o sele*ione o #otão a&ançarF

C a próEi!a tela serão eEi#idos todos os progra!as 6ue serão atualizados no repositório de dados( sele*ione o #otão *on*luir e a atualização ser realizadaF

4e!e ser aplicado tam%+m o pacote da ,ltima -I do /rot0eus dispon*!el no /ortal.  A LIB é outro pacote .ptm que deve seguir o mesmo processo de atualização comentado neste tópico.

I2. Atualiar ar$ui!o de autocontidas!BBBB.taf: < ar6ui&o *o!pa*tado de auto*ontidas 7 utilizado popular as ta#elas do A 6ue são pr7-deinidas pelo %o&erno( e 6ue serão utilizadas *o!o *ontra-do!4nio e! outras ta#elas( *o!o *onsultas por eEe!plo. C Para realizar a atualização deste ar6ui&o *o!pa*tado( copie a pasta para dentro do rootpat0( pois so!ente na eEe*ução do =Kizard de "oniguração= ela ser utilizada.

2. Atualiar ar$ui!o de la=outs 'I-E: rata-se de ar6ui&os *ontendo todos os la$outs <VS utilizados para integração &ia M)8. C Para realizar a atualização destes ar6ui&os( crie uma pasta dentro do rootpat0 com o nome -a=outDTA#( e copie os 7 ar$ui!os la$outs.d#( la$outs.dt* e la$outs.pt 5 para dentro desta pasta *riada> na eEe*ução do =Kizard de "oniguração= ela ser utilizada.

2I. Configuração do TO/'E'O'EA: rata-se de u!a *ha&e do appser&er.ini para ha#ilitar pro*essa!ento de *a!pos teEtos de grandes ta!anhos. C Para realizar a *oniguração desta *ha&e( acesse a pasta onde se en*ontra o appser!er  e edite o ar6ui&o .ini para in*luir dentro do a!#iente.

2II. Atualiar o 4icion"rio de 4ados F 8/44IST G: C Para atualização do di*ionrio de dados *o!pleto do A de&e ser utilizada a erra!enta padrão de *o!pati#ilização da <VS P33S'. C aça a *ópia dos seguintes ar6ui&os para a pasta Systemload F 1. a.

sdf%ra.tHtF ar6ui&o 6ue possui o di*ionrio de dados *o!pleto do A. 3e&ido as regras de atualização do P33S'  &e:a !ais detalhes e! 'egras para atualização do di*ionrio SHL - P33S' e !igrador de &ersão.  5 algu!as alteraç9es de di*ionrio não pode! ser realizadas neste pro*esso. 8sses a:ustes serão eitos atra&7s do 8/4TA#  &er no passo V desta pgina 5.

#.

0lpdfpor0lpdfeng0lpdfspa.tHtF ar6ui&os 6ue possue! o help de *a!pos *o!pleto do A.

 Verii6ue se o ar6ui&o de tra&a do P33S'  mpupddistri.tsk 5 est na pasta appserver . "aso este:a( precisa ser eHclu*do para $ue o atualiador se&a eHecutado corretamente.  Verii6ue se os ar6ui&os de di*ionrio de todos os grupos de e!presas eEiste! na pasta \system  ou *orrespondente 5. 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 ca!pos gatil"os etc#

•

Devo executar o compatibilizador UPDDISTR em todo pacote do TAF que é disponibilizado?  $%o# O UPDDISTR deve ser e&ecutado apenas u!a ve' a cada release#

•

omo saber se ainda devo executar o UPDDISTR para poder acessar o TAF?  $a iniciali'a(%o do TAF será e&ibido u! alerta e&igindo a e&ecu(%o do co!patibili'ador:

"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 exec!ão dos compatibiliadores do prodto# $erá necessário exectar o %&''I$T( e em se)ida o %&'TAF com o *ltimo ar+ivo diferencial  $'F-(A . disponível no portal  do cliente# $i)a as instr!/es do 0in1 abaixo para realiar a atalia!ão: 2ttp:33tdn#totvs#com#br3pa)es3releasevie4#action5  pa)eId6789;<=7>  Após se)ir os passos acima o acesso ao TAF será liberado?" 

C 'ealize a eEe*ução do *o!pati#ilizador pelo S!art"lient *onor!e a#aiEoF

C as telas ini*iais serão eEi#idas as inor!aç9es de a!#iente e o propósito do *o!pati#ilizador( sele*ione o #otão IA&ançarJF

C Após o pro*essa!ento do *o!pati#ilizador o di*ionrio do A estar atualizadoF

Para &erii*ar se hou&e algu!a in*onsistGn*ia durante a atualização do di*ionrio de dados( *li6ue e! ="onsulta )<%=F

8ntão *li6ue e! =iltrar= e sele*ione o *a!po =ipo do e&ento= *o!o ="riti*al 8rror=.

"aso o iltro retorne algu! e&ento de ="riti*al 8rror=( signii*a 6ue ora! en*ontrados pro#le!a na #ase de dados e nen0uma atualiação foi efeti!ada no am%iente. este *aso o P33S' não te! autono!ia para *orrigir e os a:ustes de&e! ser realizados pelo Ad!inistrador do Siste!a.

 C Para !aiores detalhes de utilização da erra!enta P33S' a*esse Atualizador de di*ionrio e #ase de dados - P33S'.

2III. Atualiar o 4icion"rio de dados F 8/4TA# G: o próEi!o passo se az ne*essrio a eEe*ução do pdate do A P3A - para tratar a:ustes pontuais 6ue não são realizados pelo P33S'.

+asta eEe*utar atra&7s do s!art*lient o Progra!a P3A( *onor!e a#aiEoF

 Ao eEe*utar( serão apresentadas as opç9es de atualização dispon4&eis( e atra&7s da *oluna SAS 7 poss4&el &erii*ar a ne*essidade de eEe*ução de deter!inado ite!F

 Ao inal do pro*essa!ento ser apresentada u!a tela de )<% *o! todas as alteraç9es 6ue ora! realizadas no a!#ienteF

Mais inor!aç9es so#re o P3A pode! ser en*ontradas no #oleti! da rotina( atra&7s do )ink P3A.

I(. Atualiar as Ta%elas AutoJContidas e -a=out de Integração:

< pro*esso de atualização de ta#elas auto-*ontidas e la$out de&e ser realizado atra&7s da Kizard de "oniguraçãoF

 A Kizard de "oniguração do A te! *o!o o#:eti&o realizar a atualização do a!#iente do A( ser se!pre eEe*utado no pri!eiro a*esso do usurio após a atualização do siste!a. "aso a Kizard não se:a ini*iada no pri!eiro a*esso( ainda eEiste a possi#ilidade de eEe*ut-la atra&7s do Menu do AF

< pro*esso da Kizard 7 o#rigatório( pois eEiste! alguns pro*essos internos espe*4i*os 6ue não são tratados no Atualizador de di*ionrio e #ase de

dados - P33S'( de&ido a isso após realizar a &irada de release 7 ne*essria a atualização do A &ia Kizard de "oniguração.  Apenas usurios *onigurados *o!o ad!inistrador do siste!a pode! eEe*utar os pro*edi!entos da Kizard. 8n6uanto o pro*esso não or eEe*utado nenhu! usurio ter possi#ilidade de a*essar o siste!a. 3urante o pro*esso de eEe*ução da Kizard as seguintes inor!aç9es serão atualizadasF •

•

a#elas de "ontrole nterno do A.

•

a#elas Auto-"ontidas.  Atualização de a#elas Auto-"ontidas 5

•

Me*anis!o de ntegração do A  Manual de ntegração 5

Atenção ao preenc0imento dos parKmetros: •

•

•

•

'2DTA#LI> F indica se a Liard de!e ser eHecutada J .T. J ou não J .#. G '2DTA#2E F indica a ,ltima !ersão de atualiação do TA#. /ara $ue a Liard se&a processada de!e estar uma !ersão anterior a atual ou em %ranco G. '2DTA#INT F indica se o am%iente de!e ser configurado para a integração ancoJaJ%anco G. Todos os parKmetros são criados na etapa de processamento do 8/44IST.

 Atenção aos detalhes a#aiEoF •

•

•

< ar6ui&o la=out.def  pre*isa estar o#rigatoria!ente no diretório s$ste!. Caso contr"rio não ser" poss*!el prosseguir com a atualiação.
•

•

3es!ar*ar a opção "Somente Leitura"  de todos os ar6ui&os. Caso contr"rio não ser" poss*!el prosseguir com a atualiação. < ar6ui&o auto*ontidas.ta pre*isa estar o#rigatoria!ente e! u! diretório dentro do 'ootPath. Caso contr"rio não ser" poss*!el prosseguir com a atualiação.

Verii6ue se os ar6ui&os de di*ionrio de todos os grupos de e!presas eEiste! na pasta \system  ou *orrespondente 5.

 Após realizar a atualização do siste!a e a*essar o SIATA# pela pri!eira &ez ser a#erta a tela a#aiEoF

!bserva"#o: )aso ten"a ocorrido algu!a inconsist*ncia durante a atuali'a(%o do dicionário de dados será apresentada a tela abai&o:

 $este caso será necessário re+a'er o processo de atuali'a(%o desde a e&ecu(%o do co!patibili'ador UPDDISTR atentando,se as poss-veis +al"as durante o processa!ento#

 A opção 4iagn
 Ainda na opção de diagnósti*o( 7 poss4&el eEtrair as inor!aç9es para u! ar6ui&o teEto. "li6ue e! EHportar e o ar6ui&o ser eEtra4do na pasta s$ste!  ou *orrespondente 5F

 Após *li*ar e! A!ançar ( sele*ione os5 grupos5 de e!presas5 6ue dese:a pro*essarF

 A pri!eira atualização realizada 7 a ta#ela HHO( utilizada para a integração &ia ar6ui&o teEto  M)8 5. Atenção a utiliação da c0a!e Top'emo'ega no am%iente. /ara mais informaç6es acesse o #AM do TA#.

a tela a#aiEo de&e ser indi*ado o lo*al onde o ar6ui&o de ta#elas auto-*ontidas .A5 se en*ontra  Para !aiores detalhes *onsulte  Atualização de a#elas  Auto-"ontidas 5F

Atenção Para ganho de peror!an*e no pro*essa!ento de !ulti e!presas( utilizar o par!etro MVNA"M( li!itando-se ao preen*hi!ento da 6uantidade de threads e! ,.

 Após a atualização das ta#elas auto*ontidas( 7 realizada a atualização das ta#elas próprias do A utilizadas na integração e geração das o#rigaç9es is*ais. Para !ais inor!aç9es so#re essas ta#elas a*esse a#elas AuEiliares.

 o passo seguinte de&er ser *onigurado o or!ato de integração utilizado no AF

Importante

.sta etapa é +unda!ental para o rebuild das tabelas de controle do TAF# )aso e&ista algu!a diverg*ncia da estrutura das tabelas no banco de dados co! a estrutura esperada pela integra(%o n%o será per!itida a abertura da tabela e por consequ*ncia n%o será poss-vel e&ecutar o processo de integra(%o#  @xemplo: A inte)ra!ão espera +e a tabela TAF$T7 possa  índices# Baso no banco de dados exista apenas  índices, no momento em +e as rotinas de inte)ra!ão validam esta estrtra, impedem de prosse)ir com o processo de inte)ra!ão em decorrência da diver)ência encontrada# @ssa valida!ão ocorre normalmente nas rotinas de extra!ão  extratores fiscais, extratores contábeis### ., no  processo de cópia dos dados da TAF$T7 para TAF$T=  Cob > . o no processo de inte)ra!ão  Cob = .# Aten"#o ao preenc"i!ento do par/!etro $%&TAFI'T , "abilita a para!etri'a(%o  para cone&%o e rebuild da tabela TAFST0#

A estrutura das tabelas pode ser encontrada e!: Tabelas Au&iliares#

nor!e se a *oniguração da integração #an*o-a-#an*o de&e ser eita neste !o!ento. A seleção desta pergunta altera o *onteQdo do par!etro '2DTA#INT. "aso sele*ione =1 - Si!=( o par!etro ser setado *o!o ..( *aso sele*ione =2 - ão= o par!etro ser setado *o!o ... !a &ez *onigurado *o!o ..( essa tela não ser !ais apresentada durante a eEe*ução da Kizard at7 6ue o *onteQdo se:a restaurado para ..

nor!e os dados para *riação da ta#ela AS1  ta#ela de integração 6ue i*ar no do!4nio do 8'P 5. < preen*hi!ento dessas perguntas altera o *onteQdo dos par!etros *onor!e indi*ado na própria Kizard  MVNAA)( MVNA3+ e MVNAP<' 5.

3epois 6ue preen*her os dados para *riação da ta#ela AS1( o siste!a ar u!a &alidação de *oneEão *o! o #an*o de dados. "aso se:a identii*ado algu! pro#le!a( ser alertado e o usurio ter a opção de preen*her no&a!ente os par!etros de *oneEão.