COMPONENETES

Estruturao
Reviso: 22/02/2005
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 8.11 Verses Anteriores
A estrutura de diretrios do Advanced Protheus
A estrutura e iret!rios o Avance "rot#eus e$ene a verso insta%aa.
Verso AP5
&iret!rio 'onte(o
)a$5)
&iret!rio inicia% o "rot#eus. * a $artir este iret!rio +ue o siste,a ir-
%oca%i.ar os ca,in#os in/or,aos e, $ar0,etros1 custo,i.a2es1 etc.
)a$5)a$o) &iret!rio one sero %oca%i.aos os ar+uivos e re$osit!rio e A"34s.
)a$5)bin)
&iret!rio one so %oca%i.aos os ar+uivos o n(c%eo o "rot#eus:
e5ecut-veis1 bib%iotecas e carga in0,ica 6&774s8 e ar+uivos e
con/igura2o o siste,a.
)a$5)sigaav)
9i,i%ar ao )9:;AA&V) as verses Avance 2.05/<.05. * o iret!rio
one se encontra, os ar+uivos e con/igura2o o siste,a =R"
Avance1 ar+uivos e ,enus1 etc. * ta,b>, o iret!rio inicia% e
e5ecu2o no Re,ote.
)a$5)aosav)
9i,i%ar ao )&A&39A&V) as verses Avance 2.05/<.05. * o iret!rio
one se %oca%i.a, os ar+uivos e base e aos $ara verses no 9?7.
)a$5)re%ato)
9i,i%ar ao )R=7A@3) as verses Avance 2.05/<.05. &iret!rio $ara
grava2o e ar+uivos e i,$resso e, isco.
)a$5)c$rova)
9i,i%ar ao )'"R3VA) as verses Avance 2.05/<.05. &iret!rio $ara
grava2o e ar+uivos e contabi%i.a2o.
)a$5)i5b$a)
&iret!rio e %oca%i.a2o e $rogra,as e e5e,$%o escritos e, Av"%1
nos $ares e/inios $e%a Aicrosiga 9o/tBare 9.A.
)a$5)inc%ue)
&iret!rio e ar+uivos e inc%uso $aro 6e5tenso .'C8 necess-rios
$ara a co,$i%a2o e $rogra,as escritos e, Av"%.
)a$5)uti%) &iret!rio e /erra,entas aicionais o "rot#eus.
Verso AP6
&iret!rio 'onte(o
)a$6)
&iret!rio inicia% o "rot#eus. * a $artir este iret!rio +ue o siste,a ir-
%oca%i.ar os ca,in#os in/or,aos e, $ar0,etros1 custo,i.a2es1 etc.
)a$6)a$o) &iret!rio one sero %oca%i.aos os ar+uivos e re$osit!rio e A"34s.
)a$6)bin)server)
&iret!rio one so %oca%i.aos os ar+uivos o n(c%eo o "rot#eus
9erver: e5ecut-veis1 bib%iotecas e carga in0,ica 6&774s8 e ar+uivos
e con/igura2o.
)a$6)bin)re,ote)
&iret!rio one so %oca%i.aos os ar+uivos as a$%ica2es c%ientes
6Re,ote1 :&=1 Aonitor1 etc8: e5ecut-veis1 bib%iotecas e carga
in0,ica 6&774s8 e ar+uivos e con/igura2o.
)a$6)sigaav)
9i,i%ar ao )9:;AA&V) as verses Avance 2.05/<.05. * o iret!rio
one se encontra, os ar+uivos e con/igura2o o siste,a =R"
Avance1 ar+uivos e ,enus1 etc. * ta,b>, o iret!rio inicia% e
e5ecu2o no Re,ote.
)a$6)aosav)
9i,i%ar ao )&A&39A&V) as verses Avance 2.05/<.05. * o
iret!rio one se %oca%i.a, os ar+uivos e base e aos $ara verses
no 9?7.
)a$6)re%ato)
9i,i%ar ao )R=7A@3) as verses Avance 2.05/<.05. &iret!rio $ara
grava2o e ar+uivos e i,$resso e, isco.
)a$6)c$rova)
9i,i%ar ao )'"R3VA) as verses Avance 2.05/<.05. &iret!rio $ara
grava2o e ar+uivos e contabi%i.a2o.
)a$6)i5b$a)
&iret!rio e %oca%i.a2o e $rogra,as e e5e,$%o escritos e, Av"%1
nos $ares e/inios $e%a Aicrosiga 9o/tBare 9.A.
)a$6)inc%ue)
&iret!rio e ar+uivos e inc%uso $aro 6e5tenso .'C8 necess-rios
$ara a co,$i%a2o e $rogra,as escritos e, Av"%.

Verso Protheus8
\Protheus8 (Ncleo)
Diretrio onde armazenado o ncleo (kernel) do Protheus 8. Toda a parte de
tecnologia Protheus 8.
\Protheus8\P!
Diretrio onde s"o encontrados os repositrios de P!s.
\Protheus8\#$N\%&'(&'
) nele *ue s"o encontrados os ar*ui+os e,ecut-+eis. dll/s e ar*ui+os de
con0igura1"o do sistema *ue de+em ser e,ecutados no %er+idor.
\Protheus8\#$N\'&2!T&
) nele *ue s"o encontrados os ar*ui+os e,ecut-+eis. dll/s e ar*ui+os de
con0igura1"o do sistema para acesso ao 3lient.
\Protheus8\$N345D&
*ui est"o as 6i6liotecas necess-rias para a compila1"o de programas D(P4.
\Protheus8\27P'!8&3T%
&ste diretrio sugerido para armazenar pro9etos e 0ontes das customiza1:es do
cliente.
\Protheus8\5PDT&%
&ste diretrio sugerido para armazenar as atualiza1:es do sistema.
\Protheus8;Data\%7%T&24!D
3ontm o dicion-rio de dados em 0ormato T<T. respons-+el pela gera1"o dos
ar*ui+os customizadores (%<s). con0orme a localiza1"o de pa=s de0inida pelo
usu-rio na entrada do sistema.
\Protheus8;Data\%7%T&2
3ontm os ar*ui+os de menus e os customizadores (%<s) gerados a partir do
%7%T&24!D.
\Protheus8;Data\DT
3ontm a 6ase de dados do cliente.
\Protheus8;Data\%P!!4
Neste diretrio s"o gra+ados os relatrio gerados em disco.
\Protheus8;Data\%2P4&%
Neste diretrio. est"o os programas de e,emplo e ar*ui+os D(P4 padr:es da
2icrosiga.
=stas so as estruturas $ara u,a insta%a2o $aro o "rot#eus e acoro co, a verso
uti%i.aa. "or>, a %oca%i.a2o e insta%a2o $oe variar e acoro co, o %oca% e
insta%a2o.
Apicativos do Advanced Protheus
3 Avance "rot#eus $ossui1 basica,ente1 +uatro a$%icativos uti%i.aos co, i/erentes
/ina%iaes. 9o e%es:
"rot#eus
9erver
@rataDse o servior e a$%ica2o o Avance "rot#eus esta > a $arte o
siste,a +ue ser- e5ecutaa no 9ervior e ser- res$ons-ve% $e%a co,unica2o
entre o '%iente1 a Ease e &aos e o Re$osit!rio e A$oFs. 3 no,e o
e5ecut-ve% e$ene a verso e siste,a o$eraciona% uti%i.aos1 $or e5e,$%o:
A"59RV.=G= ou A"69RVH:I.=G=.
Re,ote
* o Re,ote +ue uti%i.a,os $ara interagir co, too o siste,a1 e%e $oer- ser
insta%ao e uas ,aneiras1 no servior ou na $r!$ria esta2o e traba%#o. 3
no,e o e5ecut-ve% e$ene a verso uti%i.aa1 $or e5e,$%o:
A"5RA@.=G= ou A"6RA@.=G=.
:&= @rataDse o a,biente e esenvo%vi,ento integrao o Avance "rot#eus. *
atrav>s este a$%icativo +ue toos os acessos aos re$osit!rios e A$oFs
6co,$i%a2o e custo,i.a2es1 visua%i.a2o e /un2es e5istentes etc.8 so
e/etuaos1 e ta,b>, > a /erra,enta $ara esenvo%vi,ento e e$ura2o e
a$%ica2es/custo,i.a2es. 3 no,e o e5ecut-ve% e$ene a verso uti%i.aa1
$or e5e,$%o: A"5:&=.=G= ou A"6:&=.=G=.
Aonitor
=sta /erra,enta $er,ite a intera2o co, os usu-rios conectaos ao siste,a:
Ana%isar os $rogra,as e, uso1 errubar cone5es $enentes1 enviar
,ensagens ao usu-rios etc. 3 no,e o e5ecut-ve% e$ene a verso
uti%i.aa1 $or e5e,$%o: A"5A3I:@.=G= ou A"6A3I:@.=G=
A%e, estas a$%ica2es1 o 9iga Avance "rot#eus conta aina co, outros uti%it-rios
iversos1 co,o o &i// 6uti%i.ao $ara co,$ara2o e ar+uivos te5to8 e &u,$ 6uti%i.ao
$ara ei2o e ar+uivos bin-rios8.
No!encaturas "tii#adas
=stas so as $rinci$ais no,ec%aturas uti%i.aas no Avance "rot#eus:
$uid% Verso co,$%eta o siste,a co, seus e5ecut-veis1 &%%Fs e R"3
co,$%eto. A bui% o siste,a $oe ser ienti/icao atrav>s a o$2o Aisce%0neas
J 9obre entro os ,!u%os o siste,a.
&PO% * o ar+uivo bin-rio e re$osit!rio e A"3Fs1 co, o c!igo Av"%.
Patch% Ar+uivo bin-rio se,e%#ante ao re$osit!rio conteno a$enas atua%i.a2es
e A"3Fs1 corre2es is$onibi%i.aas $e%a Aicrosiga 9o/tBare 9.A.1 +ue ser-
a$%icao no re$osit!rio atrav>s o :&=.
Verso Master% Aes,a e/ini2o e bui% $or>, neste caso a verso ser-
uti%i.aa co,o re/erncia $ara a gera2o e atua%i.a2es o siste,a 6$atc#Fs8.
?uano geraa1 a verso > enca,in#aa a toos os envo%vios e, $rocessos e
i,$%anta2o/uti%i.a2o o siste,a via correio ou is$onibi%i.aa no site e K@"
o "rot#eus.
A e/ini2o os no,es os ar+uivos os re$osit!rios e A"3Ls e "atc#4s segue, o
,es,o $aro 6i/erencianoDse a$enas na e5tenso "atc#M."A@ e re$osit!rioMR"38 e
> e/etuaa a seguinte ,aneira A"12N<5.R"3:
"osi2o 'onte(o
1 6&8b/1 6@8o$1 6A8s1 6E8trieve1 6'8@reeO
2 6"8ortuguese1 6=8ng%is#1 698$anis#O
N VersoO
< VersoO
5 VersoO
"or e5e,$%o1 A"A"710.R"3 ser- u, re$osit!rio e A"3Ls $ara base e aos A&91
iio,a "ortugus e verso 710
'(E ) 'nte*rated (eveop!ent
Environ!ent
Reviso: 22/02/2005
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verso 8.11
3 :&= 6:ntegrate &eve%o$,ent =nviron,ent8 > u,a /erra,enta e ei2o1 co,$i%a2o
e e$ura2o e erros. * atrav>s o :&= +ue o siste,a =R" 9iga Avance >
esenvo%vio. @a,b>, > atrav>s o :&= +ue os ana%istas a Aicrosiga e os usu-rios o
"rot#eus $oe, criar e ,anter suas rotinas es$ecP/icas. 3 :&= > o (nico ,oo e
co,$i%ar os ar+uivos e $rogra,as escritos e, Av"% $ara a gera2o os A"3Ls no
re$osit!rio.
'o,o /erra,enta e ei2o e e$ura2o1 eng%oba toos os recursos is$onPveis nas
,e%#ores /erra,entas e esenvo%vi,ento o ,ercao.
Caracter+sticas do '(E
"ara a e5ecu2o o :&= no > necess-rio conectarDse ao "rot#eus 9erver1 e5ceto
nas o$era2es e atua%i.a2o ou consu%ta e u, re$osit!rio 6co,$i%a2o1
obten2o o Aa$a e 3bQetos1 a$%ica2o e $atc#4s1 etc8 e urante o $rocesso e
e$ura2o.
Io > aconse%#-ve% e5ecutar o :&= re,ota,ente 6via :nternet ou via ,oe,81
$ois a cone5o o :&= ao "rot#eus 9erver > ,ais %enta.
Passos para (esenvovi!ento
3s $assos $ara o esenvo%vi,ento e $rogra,as e, Av"% uti%i.ano o :&= so:
'ria2o o c!igo atrav>s o eitor. Ia %inguage, Av"%1 os ana%istas e os
usu-rios o "rot#eus t, toos os recursos is$onPveis $ara o esenvo%vi,ento
e suas rotinas. = i/erente,ente o antigo R&AAR=1 no > ,ais u,a
%inguage, inter$retaa. "or isso1 a $er/or,ance as rotinas es$ecP/icas > e.
ve.es ,aior o +ue era nos R&AAR=s antigos.
Aontage, o ;ru$o e "roQetos. 3 ;ru$o e "roQetos > u, gerenciaor
e5istente entro o :&=1 one o usu-rio $oe ,anter os ar+uivos e c!igo
se$araos $or $roQetos e $astas. 'o, u, gru$o e $roQetos os ar+uivos $oe,
ser organi.aos e u,a /or,a %!gica1 e, $roQetos e $astas.
'o,$i%a2o. &urante a co,$i%a2o1 os ar+uivos so enviaos ao "rot#eus
9erver. @oa a co,$i%a2o e a grava2o no re$osit!rio so e/etuaas no servior.
&e$ura2o. 3 :&= $er,ite aos usu-rios e$urar as rotinas criaas1 e5ecutanoD
as %in#a a %in#a ou e, ,oo e ani,a2o. "er,ite visua%i.ar in/or,a2es co,o
vari-veis e, i/erentes esco$os1 $i%#a e c#a,aas1 %ista e breaS $oints1 etc.
=5ata,ente co,o as ,e%#ores /erra,entas e esenvo%vi,ento e5istentes no
,ercao. Io :&= $oeDse e$urar $ontos e entraa si,$%es,ente co%ocanoDse
u, $onto e $araa 6breaS $oint8 e, u,a %in#a +ua%+uer o c!igo o $onto e
entraaO
Monitor
Reviso: 22/02/2005
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verso 8.11
3 Aonitor > uti%i.ao $ara ,onitorar as cone5es e ter,inais ao "rot#eus 9erver.
Atrav>s e%e $oeDse:
Veri/icar as cone5es ativas.
=nviar ,ensagens $ara u,a ou ,ais cone5es.
&esabi%itar novas cone5es. :sto > (ti% +uano se $recisa e/etuar a%gu,a
,anuten2o e se $recisa evitar +ue outros usu-rios se conecte,.
'n,or!a-es $.sicas das Cone/-es
"su.rio0 * o no,e o usu-rio na ree %oca%. "ara cone5es re,otas este no,e
est- e, branco.
Co!putador0 Io,e a ,-+uina one o Re,ote est- seno e5ecutao.
Cone/o0 :nica a ata e #ora e inPcio a cone5o o Re,ote.
Te!po de "so0 :nica o te,$o e, #oras1 ,inutos e segunos ese +ue o
Re,ote se conectou.
Pro*ra!a 'nicia0 * o no,e o $rogra,a inicia% 6A"38 co, o +ua% o Re,ote
iniciou a e5ecu2o.
Environ!ent0 Io,e o a,biente seno uti%i.ao $e%o ter,ina%.
Siste!as Operacionais e Pata,or!as
Reviso: 2N/02/2005
Abrangncia
Verso 6.09 Verso 7.10 Verso 8.11
Siste!as Operacionais e Pata,or!as 1verso AP6 e posteriores2
3 "rot#eus 9erver /oi esenvo%vio e, AI9: 'TT e 1 $ortanto1 ine$ene e A":Ls
es$ecP/icas $ara /uncionar. ;ra2as a isso1 o n(c%eo o "rot#eus $oe ser reco,$i%ao e,
toos os siste,as o$eracionais e $%ata/or,as +ue su$orte, AI9: 'TT.
3utra $reocu$a2o urante o esenvo%vi,ento o "rot#eus /oi garantir tota%
co,$atibi%iae os re$osit!rios e obQetos o "rot#eus 6R"3Ls8 e as corre2es os
re$osit!rios 6"atc#Ls8 entre os siste,as o$eracionais e $%ata/or,as.
Pata,or!as e SO3s suportados
HinoBs e 7inu5 :nte%1
HinoBs :A6< e 7inu5 :A6<1
9un 9o%aris 6 R:9' 81
C" UG 6 R:9' 81
:EA A:G 6 "oBer "' e R9/6000 81
O Protheus &e!ote pode ser e/ecutado%
HinoBs e 7inu5 :nte%
3 9.3$eraciona% o 9ervior no e$ene a verso o Re,ote.
"oe,os ,esc%ar nu,a ,es,a insta%a2o verses HinoBs e 7inu5 o Re,ote.
Io $oe,os ,esc%ar 9erviores "rot#eus e i/erentes 9.3$eracionais1 se uti%i.ar,os
HinoBs toos os serviores eve, estar e, HinoBs.

Topoo*ia de &ede
Reviso: 28/08/200N
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verso 8.11
Verses Anteriores
&evio V sua iviso e, ca,aas1 a tecno%ogia "rot#eus $er,ite ,ontar o a,biente e
e5ecu2o co, i/erentes to$o%ogias1 $riori.ano a e5ecu2o1 o tr-/ego e ree ou os
recursos iniviuais as ,-+uinas e5istentes1 o +ue torna o $rocessa,ento istribuPo.
=ssa > u,a as granes vantagens a tecno%ogia "rot#eus.
Caracter+sticas e Possi4iidades de Topoo*ias de &ede
"oeDse ,anter u, ou ,ais serviores e a$%ica2o o "rot#eus 6"rot#eus
9erver8.
U, "rot#eus 9erver $oe estar na ,es,a ,-+uina +ue o gerenciaor e banco
e aos.
A-+uinas ,e%#ores ou co, ,ais recursos $oe, ter u, "rot#eus 9erver seno
e5ecutao %oca%,ente 6na esta2o8 visano $riori.ar o $rocessa,ento %oca%.
"or>, #- u, au,ento o tr-/ego e ree entre o gerenciaor e banco e aos
e o "rot#eus 9erver %oca%.
&o ,es,o ,oo1 $oeDse e5ecutar serviores re,ota,ente $riori.ano o
$rocessa,ento e u,a ou ,ais esta2es.
Uti%i.a2o o $rotoco%o @'"D:" $ara as cone5es. Ia verso A"5 $oeDse
uti%i.ar ta,b>, o $rotoco%o IAA=& ":"=9.
"oeDse is$onibi%i.ar cone5es via :nternet atrav>s a ,ontage, e u, Heb
9erver na e,$resa ou atrav>s e $roveores e acesso 6co,o a U37 e o WAW8.
Ieste caso1 o "rot#eus 9erver $oe ser e5ecutao no $roveor ou na e,$resa
uti%i.ano u,a 7" $ara a cone5o ao $roveor e acesso.
A :nternet > uti%i.aa a$enas co,o o ,eio e co,unica2o1 ou seQa1 a cone5o
@'"D:" entre o Re,ote e o "rot#eus 9erver. A%>, a seguran2a o/erecia $e%o
siste,a Avance1 a seguran2a ever- ser o/erecia $e%a cone5o. "or isso1 >
aconse%#-ve% +ue a ,-+uina one o servior Heb esteQa seno e5ecutao no
seQa o ,es,o o servior a banco e aos.
3 "rot#eus 9erver ta,b>, $oe ser e5ecutao co,o u, servior :nternet1
C@@" e/ou K@".
"oeDse ,anter u,a $-gina $ara o oBn%oa o Re,ote1 e ,oo +ue os
usu-rio re,otos $ossa, e/etuar o oBn%oa $ara conectarDse e uti%i.ar o siste,a.
Ia verso A"6 $oeDse con/igurar o Re,ote $ara se atua%i.ar auto,atica,ente a
$artir o "rot#eus 9erver seno e5ecutao co,o u, servior K@".
(ica %
A e/ini2o a ,e%#or to$o%ogia $ara e5ecu2o > u, $asso i,$ortante a
i,$%e,enta2o a tecno%ogia "rot#eus1 $ois in/%uenciar- tota%,ente na $er/or,ance. 3
,aior tr-/ego e ree est- %oca%i.ao entre o "rot#eus 9erver e o Eanco e &aos1 Q-
+ue o tr-/ego entre o "rot#eus 9erver e o Re,ote %i,itaDse Vs in/or,a2es $ara
,ontage, e te%as e contro%e e tec%ao e ,ouse. &esta /or,a1 e$eneno o ti$o e a
ve%ociae a cone5o1 $oe se tornar invi-ve% ,anter u, "rot#eus 9erver e, u,a
ciae conectao ao banco e aos e, outra. "or outro %ao1 caso e5ista, ,uitas
cone5es nesta outra ciae1 ou caso estas cone5es e5ecute, $rocessa,entos $esaos1
$riori.ar o $rocessa,ento is$onibi%i.ano u, "rot#eus 9erver $ara ser e5ecutao
%oca%,ente nesta ciae $oe ser u,a boa so%u2o.