Advpl - WebServices Com Protheus

Web Services com Protheus
Reviso: 27/04/2004
Abrangncia
Verso 7.10 Verso 8.11
O Protheus a !artir "a verso AP7 !ossui #erra$entas nativas e integra"as co$ a %&'
"e &n#ra()strutura "o )RP !ara "esenvo*vi$ento "e a!*ica+,es -.*iente- e -/erver-
uti*i0an"o a tecno*ogia "os 1eb /ervices. Para $e*hor co$!reenso "o assunto os
t2!icos re*aciona"os a a$bos #ora$ "i"atica$ente se!ara"os e$ A!*ica+,es /erver e
A!*ica+,es .*iente res!ectiva$ente. 3os t2!icos -.o$an"os- e -4un+,es- so aborta"as
res!ectiva$ente as "iretivas e #un+,es "a %ib "e &n#ra(estrutura "o )RP "is!onibi*i0a"as
!ara o "esenvo*vi$ento "e a$bas as a!*ica+,es .*iente e /erver. 3o t2!ico -)5e$!*os
A"v!*- so "e$onstra"os os e5e$!*os -at6$icos- "e uso "as #un+,es e co$an"os.
COMANDOS - ENDWSCLIENT
Reviso: 22/04/2004
Abrangncia
/inta5e
)371/.%&)38 9 se*# :
Par;$etros
Argu$ento 8i!o 7escri+o
se*# <3=%O> )sta instru+o no recebe nenhu$ !ar;$etro.
7escri+o
Atrav?s "esta instru+o encerra(se a "ec*ara+o "e u$a c*asse -.*ient- "e 1eb /ervices
inicia"a co$ o statement 1/.%&)38.
)sta instru+o "e "ec*ara+o ? uti*i0a"a e5c*usiva$ente @uan"o "a gera+o "e u$ #onte
-.*iente- "e 1eb /ervices atrav?s "o assistente -Aerar .*iente 1eb/ervices...- "o &7).
Observao : A uti*i0a+o "este co$an"o e5ige a "ec*ara+o "o #include
'APWEBSRV.CH' no #onte A"v!*.
COMANDOS - ENDWSSE!ICE
Reviso: 22/04/2004
Abrangncia
/inta5e
)371//)RV&.) 9 se*# :
Par;$etros
se*# <3=%O> )sta instru+o no recebe nenhu$ !ar;$etro.
7escri+o
Atrav?s "esta instru+o encerra(se a "ec*ara+o "e u$a c*asse -/erver- "e 1eb /ervices
inicia"a co$ o statement 1//)RV&.).
O no(#echa$ento "a "ec*ara+o "a c*asse ocasiona B#a*ha "e co$!i*a+oB no #onte.
COMANDOS - ENDWSST"CT
Reviso: 22/04/2004
Abrangncia
/inta5e
)371//8R=.8 9 se*# :
Par;$etros
se*# <3=%O> )sta instru+o no recebe !ar;$etros
7escri+o
Atrav?s "esta instru+o encerra(se a "ec*ara+o "e u$a estrutura a ser uti*i0a"a e$ u$
1eb /ervice inicia"a co$ o statement 1//8R=.8.
O no(#echa$ento "a "ec*ara+o "a estrutura ocasiona #a*ha "e co$!i*a+o no #onte.
COMANDOS - WSCLIENT
Reviso: 22/04/2004
Abrangncia
/inta5e
1/.%&)38 c.*ient3a$e
Par;$etros
c.*ient3a$e .aracter
c.*ient3a$e corres!on"e -a c*asse "o 1eb /ervice a ser
gera"a.
7escri+o
Atrav?s "esta instru+o inicia(se a "ec*ara+o u$a c*asse -.*iente- "e 1eb /ervices e$
A"v!*. )sta instru+o "e "ec*ara+o ? uti*i0a"a e5c*usiva$ente @uan"o "a gera+o "e
u$ #onte -.*iente- "e 1eb /ervices atrav?s "o assistente -Aerar .*iente 1eb/ervices...-
"is!onCve* no Protheus &7).
Para encerrar a "ec*ara+o "a c*asse ? uti*i0a"a a instru+o )371/.%&)38.
COMANDOS - WSDATA
Reviso: D0/04/2004
Abrangncia
/inta5e
1/7A8A cVar3A$e A/ 9 ARRAE O4 : cVar8F!e 9 OP8&O3A% :
Par;$etros
cVar3A$e .aracter cVar3a$e corres!on"e ao no$e "a !ro!rie"a"e a "ec*arar.
A/ .aracter /e!ara"or !ara in"icar o ti!o "a !ro!rie"a"e.
ARRAE O4 .aracter
cVar8F!e corres!on"e a u$ 8i!o /oa! / co$!atCve* "e
variGve* a ser uti*i0a"o no servi+o. VeHa os ti!os su!orta"os
abai5o na 8abe*a A ( 8i!os "e 7a"os
cVar8F!e .aracter
cVar8F!e corres!on"e a u$ 8i!o /oa! / co$!atCve* "e
variGve* a ser uti*i0a"o no servi+o. VeHa os ti!os su!orta"os
abai5o na 8abe*a A ( 8i!os "e 7a"os
OP8&O3A% .aracter
.aso es!eci#ica"o "e#ini$os @ue esta !ro!rie"a"e ?
o!ciona* no conte5to "o 1eb /ervice .
7escri+o
=ti*i0a(se esta instru+o !ara "ec*arar u$a !ro!rie"a"e "e u$a c*asse !ara
1eb/ervices -.*iente- ou -/erver-.
=$a !ro!rie"a"e obrigatoria$ente "eve ter "e#ini"a seu no$e e ti!o e o!ciona*$ente
!o"e$os "e#inir @ue a $es$a terG trata$ento "e arraF e/ou trata$ento o!ciona*.
COMANDOS - WSMET#OD
Reviso: 22/04/2004
Abrangncia
Verso 7.10
/inta5e
1/I)8JO7 cIetho"3a$e 9 1/R).)&V) K!ara$Lin...M : 9 1//)37
K!ara$LoutM : 9 1//)RV&.) KserviceLna$eM :
Par;$etros
cIetho"3a$e .aracter
cIetho"3a$e corres!on"e -ao no$e "o $?to"o "o 1eb
/ervice.
1/R).)&V)
K!ara$Lin...M
.aracter
Atrav?s "esta instru+o "ec*ara$os @uais so o<s>
!ara$etro<s> @ue este $?to"o recebe se!ara"os !or
vCrgu*as. .aso u$ $?to"o no receba !ar;$etros
"eve$os "ec*arar @ue o $es$o recebe o !ar;$etro
reserva"o 3=%%PARAI.
1//)37
K!ara$LoutM
.aracter
Atrav?s "esta instru+o "ec*ara$os u$ e a!enas u$
!ar;$etro "e retorno "e u$ 1eb /ervice .
1//)RV&.)
KserviceLna$eM
.aracter
c/ervice3a$e corres!on"e ao no$e "a c*asse "o servi+o
ao @ua* o $?to"o atua* !ertence.
7escri+o
Atrav?s "esta instru+o incia(se a "ec*ara+o "e u$ $?to"o "e u$ 1eb /ervice (
-.*iente- e/ou -/erver- e$ A"v!* . =ti*i0a$os esta instru+o e$ "ois $o$entos no
"esenvi*vi$ento :
3a "ec*ara+o "a c*asse -/erver- e/ou -.*iente- "o servi+o.
3a "e#ini+o "o #onte "o $?to"o -!ro!ria$ente "ito- "o res!ectivo 1eb/ervice.
Ao uti*i0ar$os a instru+o 1/I)8JO7 "entro "a "ec*ara+o "e u$a c*asse
1//)RV&.) in#or$a$os a!enas o !ri$eiro !ar;$etro < cIetho"3a$e > . Por?$ ao
"ec*arar o #onte !ro!ria$ente "ito "o $?to"o to"os os !ar;$etros "esta instru+o so
obrigat2rios.
COMANDOS - WSSE!ICE
Reviso: 22/04/2004
Abrangncia
/inta5e
1//)RV&.) c/ervice3a$e 9 7)/.R&P8&O3 Kc7escrM : 9 3AI)/PA.)
Kc.*s3/M :
Par;$etros
c/ervice3a$e .aracter
c/ervice3a$e corres!on"e No no$e "o /ervi+o < .*asse
e$ A"v!* > @ue serG "ec*ara"o / cria"o. A no$enc*atura "e
u$ 1eb /ervice segue a regra "e no$enc*atura "e #un+,es
A"v!* .
7)/.R&P8&O3
Kc7escrM
.aracter
c7escr corres!on"e N "escri+o "o /ervi+o $ostra"a na
te*a "e Cn"ice "e servi+os e #orneci"a ta$b?$ Honto "o
1/7% gera"o !e*o servi"or Protheus !ara o servi+o
es!eci#ica"o.
3AI)/PA.)
Kc.*s3/M
.aracter
c.*s3/ corres!on"e No 3a$e/!ace sob o @ua* este servi+o
"eve ser !ub*ica"o.
7escri+o
Atrav?s "esta instru+o inicia$os a "ec*ara+o u$a c*asse -/erver- "e 1eb/ervices e$
A"v!*.
7entro "a estrutura "e u$a .*asse -/erver- "e 1eb /ervices "eve$os "ec*arar os
$?to"os "is!onibi*i0a"os "a c*asse e "ec*ara$os to"as as !ro!rie"a"es !ar;$etros e
retornos uti*i0a"os !or esta c*asse "evi"a$ente es!eci#ica"as uti*i0an"o as instru+,es
1/I)8JO7 e 1/7A8A res!ectiva$ente.
Para encerrar a "ec*ara+o "a c*asse uti*i0a$os a instru+o )371//)RV&.)..
A "ec*ara+o "e u$a c*asse -/erver- "e 1eb /ervices "eve tr a seguinte estrutura bGsica
:
WSSERVICE <cSvcName> DESCRIPI!N <cDesc"> NA#ESPACE <cClsNS>
WSDAA <$DataName> AS <$Data%&e>
'... demais &"(&"iedades) &a"*met"(s e "et("n(s ...+
WS#EH!D <#et,(dName>
'... demais m-t(d(s da classe ...+
ENDWSSSERVICE
'... .(nte's+ d('s+ m-t(d('s+s desta classe ...+
COMANDOS - WSST"CT
Reviso: 22/04/2004
Abrangncia
/inta5e
1//8R=.8 c/ruct3a$e
Par;$etros
c/ruct3a$e .aracter
c/truct3a$e corres!on"e ao no$e "a estrutura a ser
cria"a. Obe"e+e -as regras "e no$enc*atura "e #un+,es
A"v!*.
7escri+o
Atrav?s "esta instru+o inicia$os a "ec*ara+o "e u$a estrutura a ser utii*0a"a !or
u$ 1eb /ervice -/erver- e$ A"v!* . 7entro "e u$a estrutura "eve$os a!enas "ec*arar
as !ro!rie"a"es @ue a $es$a cont?$ atrav?s "a instru+o 1/7A8A. 7eve$os
#ina*i0ar a "ec*ara+o "a estrutura uti*i0an"o o co$an"o )371//8R=.8.

E$em%&o 'e uso 'a (u)o
*ETWSCEO
Reviso: 22/04/2004
Abrangncia
3o e5e$!*o abai5o ? i*ustra"o o trata$ento "e erro sugeri"o !ara u$a cha$a"a "e u$
$?to"o atrav?s "e u$ !rogra$a -.*ient- "esenvo*vi"o e$ A"v!*.
#include 'Protheus.ch'
#include 'ApWebSrv.ch'
User Function TstService
Local oService , cSvcError , cSoapFCode ,cSoapFescr
!! Cria u"a inst#ncia do servi$o Cliente
oService %& WSTeste'(%)e*'(
!! +eali,a a cha"ada do "-todo .ello'( do servi$o.
/0 oService%.ello'(
!! 1-todo e2ecutado co" sucesso.
1s3Stop''E2ecu$4o 56'(
Else
!! Caso o "-todo retorne .F. , deve"os identi0icar e tratar a
ocorr7ncia
cSvcError %& 8etWSCError'( !! +esu"o do erro
cSoapFCode %& 8etWSCError'9( !! Soap Fault Code
cSoapFescr %& 8etWSCError':( !! Soap Fault escription
/0 ;e"pt<'cSoapFCode(
!! Caso a ocorr7ncia de erro este=a co" o 0ault>code
preenchido ,
!! a "es"a teve rela$4o co" a cha"ada do servi$o .
1s3Stop'cSoapFescr,cSoapFCode(
Else
!! Caso a ocorr7ncia n4o tenha o soap>code preenchido
!! Ela est? relacionada a u"a outra 0alha ,
!! provavel"ente local ou interna.
1s3Stop'cSvcError,'FAL.A /)TE+)A E E@ECUCA5 5
SE+A/B5'(
Endi0
Endi0
oService %& )/L
+eturn
*ETWSC!E
Reviso: 22/04/2004
Abrangncia
3o e5e$!*o abai5o obte$os a verso "a %ib -.*iente- "e 1eb /ervices co$!i*a"a no
re!osit2rio atua*.
User Function Sho*Aersions'(
Local cCliAers %& 8etWSCAer'(
1s3Stop'cCliAers(
+eturn
*ETWSS!E
Reviso: 22/04/2004
Abrangncia
3o e5e$!*o abai5o obte$os a verso "a %ib -/erver- "e 1eb /ervices co$!i*a"a no
re!osit2rio atua*.
User Function Sho*Aersion'(
Local cSrvAers %& 8ETWSSAE+'(
1s3Stop'cSrvAers(
+eturn
SETSOAP+A"LT
Reviso: D0/04/2004
Abrangncia
3o e5e$!*o 01 !artin"o "e u$ $?to"o "e u$ 1eb/ervices -/erver- caso u$
!ar;$etro no aten"a a #ai5a "e "a"os necessGria o servi+o retorna ao .*ient so*icitante
u$ S(a&/0ault in"ican"o a ocorrncia "e erro.
3o e5e$!*o 02 retorna$os u$ S(a&/0ault in"ican"o @ue no estava "is!onCve* u$
recurso no servi"or !ara o !rocessa$ento re@uisita"o. 3este retorna$os @ue o 4au*t
.o"e ? -/OAP4A=%8LR).)&V)R- !ois o !acote no #oi !rocessa"o no !or ter a*gu$
conteO"o invG*i"o $as si$ !or a*gu$a ra0o *iga"a No a$biente "o servi"or.
Por "e#au*t o 0ault/C(de "e u$ S(a&/0ault ? -/OAP4A=%8L/)37)R- o @ue in"ica
@ue o servi+o no #oi !rocessa"o !or a*gu$a ra0o *iga"a No !acote "e "a"os envia"osP
e in"ica ao c*ient @ue o !acote "eve ser re($onta"o !ara @ue o servi+o seHa e5ecuta"o.

E2e"plo CD
'...(
/0 %%/ndice E DC9F
SetSoapFault''Ar3u"ento /nv?lido','5 Gndice n4o pode ser "aior Hue
DC9F.'(
+eturn .0.
Endi0
'...(
E2e"plo C9
'...(
/0 ;File''Ie2trasI"odelo.c03'(
SetSoapFault''Servi$o /ndisponGvel','',S5APFAULT>+ECE/AE+(
+eturn .0.
Endi0
'...(
+u),es - *ETWSCEO
Reviso: 22/04/2004
Abrangncia
Verso 7.10
/inta5e
A)81/.)RROR < 9 n&n#o : > ((M 5)rror&n#o
Par;$etros
n&n#o 3u$?rico
n&n#o es!eci#ica @ua* in#or$a+o !ertinente ao erro "eve
ser retorna"a !o"en"o ser :
1 ( Retorna u$a /tring conten"o o Resu$o "o )rro
.OIP%)8O <7)4A=%8>
2 Q Retorna u$a /tring conten"o o soa!:#au*tLco"e caso
"is!onCve* .
D Q Retorna u$a /tring conten"o o soa!:#au*tL/tring
caso "is!onCve* .
4 Q Retorna u$ ObHeto RI% conten"o os no"es
co$!*etos co$ as in#or$a+,es "o erro a!enas caso o erro
seHa u$ soa!L4au*t.
Retorno
8i!o 7escri+o
<Sua*@uer>
Retorna a in#or$a+o "o erro so*icita"a atrav?s "o !ar;$etro n&n#o . .aso
n&n#o seHa 1 2 ou D o retorno ? "o ti!o /tring . .aso seHa ti!o 4 serG
retorna"o u$ ObHeto RI%.
7escri+o
=ti*i0a"a no "esenvo*vi$ento "e u$a a!*ica+o -.*ient- "e 1eb/ervices atrav?s "esta
#un+o ? !ossCve* recu!erar as in#or$a+,es !ertinentes N u$a ocorrncia "e erro "e
!rocessa$ento "e u$ $?to"o -.*ient- a!2s a e5ecu+o "o $es$o.
.aso a e5ecu+o "e u$ $?to"o -.*ient- "e 1eb /ervices retorne .4. "eve ser uti*i0a"a a
#un+o Aet1/.)rror<> !ara i"enti#icar a orige$ "a ocorrncia. 7urante u$a o!era+o
"e e5ecu+o "e u$ $?to"o -.*ient- "e 1eb/ervices so !ossCveis ocorrncias "e erro
"as seguintes nature0as e$ $o$entos es!ecC#icos :
1 ( Antes "o !acote -/OAP-co$ os !ar;$etros e "a"os !ertinentes N re@uisi+o ser
envia"o.
7urante a $ontage$ "o !acote /OAP !ara envio "os !ar;$etros "o $?to"o so*icita"o
No servi"or ? rea*i0a"a u$a consistncia "o<s> !ar;$etro<s> a sere$ envia"os tais
co$o a obrigatorie"a"e "o !ar;$etro e o ti!o A"v!* co$ o @ua* o !ar;$etro #oi
a*i$enta"o. /e e so$ente se os !ar;$etros in#or$a"os seHa$ vG*i"os o !acote /OAP
$onta"o ? !osta"o no servi"or "e 1eb/ervices.
2 ( Ao !ostar o !acote -/OAP- !ara o res!ectivo 1eb/ervice
Ao !ostar o !acote caso o ,(st "o 1eb /ervice uti*i0a"o ou o servi"or re#erente No
$es$o no #oi *oca*i0a"o ou no esteHa no ar.
D ( A!2s o envio "o !acote e obten+o "o "evi"o retorno "o /erver.
=$a ve0 envia"o ao /erver a inter#ace c*ient entra e$ $o"o -stan"(bF- aguar"an"o !or
u$ !acote "e retorno /OAP "o /erver. A!2s a !ortage$ caso o !acote "evo*vi"o no
esteHa e$ con#or$i"a"e co$ a "ec*ara+o "o servi+o ou o servi"or "evo*veu u$ ht$*
ao inv?s "e u$ 5$* -/OAP-.
4 ( )rro &nterno "e e5ecu+o : Sua*@uer ocorrncia "e erro #ata* seHa antes ou "e!ois "o
envio "a re@uisi+o cuHa orige$ no seHa trata"a ou !revista !e*as rotinas -.*ient- "o
/ervi+o co$o !or e5e$!*o u$ retorno "e u$ !acote RI% co$ erro "e sinta5e ou
estrutura*$ente invG*i"o .
+u),es - *ETWSC!E
Reviso: 22/04/2004
Abrangncia
/inta5e
A)81/.V)R < > ((M cVersion
Retorno
8i!o 7escri+o
.aracter
cVersion corres!on"e N verso "o 'ui*" "a %ib -.*iente- "e 1eb/ervices
co!$!i*a"a no re!osit2rio e$ uso atua*$ente.
7escri+o
=ti*i0a"a no "esenvo*vi$ento "e u$a a!*ica+o -.*iente- "e 1eb /ervices atrav?s
"esta #un+o ? !ossCve* obter a string conten"o a in"enti#ica+o "a verso "e 'ui*" "a
%&' "e &n#ra()strutura "o 1eb /ervices -.*iente-.
+u),es - *ETWSS!E
Reviso: 22/04/2004
Abrangncia
/inta5e
A)81//V)R < > ((M cVersion
Retorno
8i!o 7escri+o
.aracter
cVersion corres!on"e N verso "o 'ui*" "a %ib -/erver- "e 1eb/ervices
co$!i*a"a no re!osit2rio e$ uso atua*$ente.
7escri+o
=ti*i0a"a no "esenvo*vi$ento "e u$a a!*ica+o -/erver- "e 1eb /ervices atrav?s "esta
#un+o ? !ossCve* obter a string conten"o a in"enti#ica+o "a verso "e 'ui*" "a %&' "e
&n#ra()strutura "o 1eb /ervices -/erver-.
+u),es - SETSOAP+A"LT
Reviso: D0/04/2004
Abrangncia
/inta5e
/)8/OAP4A=%8 < K c)rror M K c/tring M 9 n4.o"e : 9 c4actor : 9 c47etai* : >
((M .8.
Par;$etros
c)rror .aracter
Atrav?s "e c)rror "eve ser es!eci#ica"a u$a "escri+o
re"u0i"a re#erin"o(se ao ti!o "o erro !or e5e$!*o : )rro
"e argu$ento Para$etro &nva*i"o 4a*ha "e Ar@uivo ...
c/tring .aracter
)$ c/tring "eve(se es!eci#icar u$ "eta*he $aior "a
ocorrncia no e5ata$ente u$ "eta*he t?cnico !or?$
u$a es!eci#ica+o obHetiva "a ocorrncia. Por e5e$!*o :
Para$etro RRRRR #ora "a #ai5a vG*i"a "e "a"os
co$!reen"i"a entre $$$ e nnn ...
n4.o"e 3u$?rico
4au*t .o"e : Atrav?s "este !ara$etro ? !ossCve*
es!eci#icar a orige$ "a ocorrncia "a /oa! 4au*t .
/egun"o a "ocu$enta+o "o /OAP Verso 1.2 < !ub*ica"a
na 1D. > #ora$ "e#ini"os T c2"igos "e ocorrncias
stan"ar" "e erro "eta*ha"os na 8abe*a A. .aso no seHa
es!eci#ica"o !or "e#au*t ? assu$i"o o c2"igo U < /en"er >
c4actor .aracter
Atrav?s "e .4Actor ? !ossCve* es!eci#icar e5!*icita$ente
@ua* no"e / atributo "o RI% / /oa! @ue no #oi
!rocessa"o e/ou ocasionou a #a*ha . 7eve ser uti*i0a"o o
#or$ato anF=R& < re# na$es!ace
htt!://VVV.VD.org/2001/RI%/che$a > !ara es!eci#car o
no"e / atributo @ue ocasionou a #a*ha.
c47etai* .aracter
Atrav?s "e c47etai* ? !ossCve* es!eci#icar !ara #ins
internos "e !rocessa$ento $aiores "eta*hes sobre u$a
ocorrncia "e erro es!eci#ica$ente re*aciona"a No
!rocessa$ento "o cor!o <Bbo"FB> "e u$ !acote /OAP.
Retorno
8i!o 7escri+o
%2gico )sta #un+o se$!re retorna .8. <true>
7escri+o
=ti*i0a"a no "esenvo*vi$ento "e u$a a!*ica+o -/erver- "e 1eb/ervices atrav?s "esta
#un+o ? !ossCve* setar u$a ocorrncia "e erro trata"a re#erente N e5ecu+o "o servi+o
ou i$!ossibi*i"a"e "e e5ecu+o "o $?to"o "urante a e5ecu+o "o $es$o.
7entre as ra0,es !e*as @uais este trata$ento ? uti*i0a"o !o"e$os citar ocorrncias
re*aciona"as a va*i"a"e "os "a"os recebi"os no !acote "e !ara$etros envia"os !e*o
-.*iente- co$o !ar;$etros inva*i"os ou #ora "a #ai5a "e "a"os !er$iti"a !e*a rotina ou
ocorrncias re*aciona"as ao -/erver- co$o a #a*ta "e u$ "eter$ina"o recurso no server
!ara o !rocessa$ento co$o u$a #a*ha "e acesso a base "e "a"os ou @ua*@uer outra
ra0o i$!*e$enta"a no servi+o.
Tabela A - FAULT CODES
n4.o"e .onstante 7escri+o
1 /OAP4A=%8LV)R/&O3I&/IA8.J 3a$e/!ace invG*i"o
encontra"o no !rocessa$ento
"o /oa!:'o"F
2 /OAP4A=%8LI=/8=37)R/8A37 Re#ere(se a #a*ha "e
inter!reta+o "e u$ no"e /
atributo conti"o no
/oa!:Jea"er es!eci#ica"o
co$ o atributo
$ust=n"erstan" seta"o !ara
-true-
D /OAP4A=%8L7873O8/=PPOR8)7 A /tring /oa! envia"a co$o
!ar;$etro continha u$ 787
<7ocu$ent 8F!e 7e#inition>.
4 /OAP4A=%8L7A8A)3.O7&3A=3W3O13 O J)a"er ou o 'o"F "o
!acote /OAP estG uti*i0an"o
u$ enco"ing(tF!e no
su!orta"o !e*o server.
U /OAP4A=%8L/)37)R Re#ere(se a u$a ocorrncia "e
erro e/ou #a*ha "e
!rocessa$ento "a a+ao !or
a*gu$ ti!o "e inconsistncia
re*aciona"a a #a*ta "e u$ ou
$ais "a"os necessGrios ao
!rocessa$ento. &n"ica u$a
ocorrncia @ue re@uer @ue o
!acote /OAP seHa re$onta"o
!ara @ue seHa rea*i0a"a u$a
nova tentativa "e acesso.
T /OAP4A=%8LR).)&V)R Re#ere(se a u$a ocorrncia "e
erro e/ou #a*ha "e
!rocessa$ento !or ra0,es @ue
no esto es!eci#ica$ente
re*aciona"as ao conteu"o "o
!acote /OA! e/ou !ara$etros
recebi"os !or?$ re*aciona"os
-a u$a #a*ha no Rece!tor "o
/ervi+o co$o !or e5e$!*o o
servi"or estar b*o@uea"o !ara
$anuten+o. )ste ti!o "e
ocorrncia no in"ica @ue
e5iste #a*ha no !acote envia"o
$as cosu$a(se uti*i0ar !ara
in"icar u$a ocorrncia
re*aciona"a na@ue*e instante
"e te$!o P !ossive*$ente
estan"o "is!onCve*
!osterior$ente .

Observao : Para uti&i.armos os m)em/)icos0 ao i)v1s 'os )2meros0 )os co'i3os
'e erro0 %recisamos 'ec&arar )o (o)te A'v%& a uti&i.ao 'o I)c&u'e 4A%WebSrv5ch4
+u),es - SOAPDT*ETD
Reviso: 22/04/2004
Abrangncia
Verso 8.11
/inta5e
/OAP78A)87 < K c7ate8i$e M > ((M "7ate
Par;$etros
c7ate8i$e .aracter /tring no #or$ato B/oa!B 7ate8i$e a ser consi"era"a.
Retorno
8i!o 7escri+o
7ata Retorna a "ata i"enti#ica"a na /tring c7ate8i$e
7escri+o
A !artir "e u$a string A"v!* conten"o u$a "ata no #or$ato 's(a&' Dateime a #un+o
/oa!7tAet7<> retorna a "ata corres!on"ente e$ A"v!* co$o u$ conteO"o "o ti!o 'D'
Date.
+u),es - SOAPDT*ETT
Reviso: 22/04/2004
Abrangncia
Verso 8.11
/inta5e
/OAP78A)88 < K c7ate8$ie M > ((M c8i$e
Par;$etros
c7ate8$ie .aracter /tring no #or$ato B/oa!B 7ate8i$e a ser consi"era"a.
Retorno
8i!o 7escri+o
.aracter Retorna o horGrio i"enti#ica"o no #or$ato JJ:II://
7escri+o
A !artir "e u$a string A"v!* conten"o u$a "ata no #or$ato 's(a&' Dateime a #un+o
/oa!7tAet7<> retorna o horGrio corres!on"ente e$ A"v!* co$o u$ conteO"o "o ti!o
'C' C,a"acte") no #or$ato JJ:II://
+u),es - SOAPDTMO"NT
Reviso: 22/04/2004
Abrangncia
Verso 8.11
/inta5e
/OAP78IO=38 < K "7ata M K c8$ie M > ((M c7ate8$ie
Par;$etros
"7ata 7ata 7ata a ser consi"era"a !ara a $ontage$ "o -7ate8i$e-
c8$ie .aracter
JorGrio no #or$ato hh:$$:ss a ser consi"era"o !ara a
$ontage$ "o -7ate8i$e-
Retorno
8i!o 7escri+o
.aracter
/tring -/OAP- corres!on"en"o N 7ata e JorGrios es!eci#ica"os no
#or$ato 7A8)8&I).
7escri+o
A !artir "e u$a 7ata e$ A"v!* e u$ horGrio es!eci#ica"o co$o string a #un+o
/oa!7tIount<> retorna a "ata e horGrio es!eci#ica"os co$o u$a string no #or$ato
-/oa!- Dateime.
+u),es - WSCLASSNEW
Reviso: 27/04/2004
Abrangncia
/inta5e
1/.%A//3)1 < K c/rv/truct M > ((M o3eV/truct
Par;$etros
c/rv/truct .aracter
)s!eci#i@ue o no$e "a estrutura B/erverB "e 1ebservices
!ara a cria+o "o ObHeto.
Retorno
8i!o 7escri+o
ObHeto
A #un+o retorna u$a re#erncia N u$a nova inst;ncia "a estrutura !assa"a
co$o !ar;$etro.
.aso a estrutura no e5ista a #un+o retornarG 3&%.
7escri+o
Atrav?s "a #un+o 1/.*ass3eV<> ? !ossCve* criar u$a nova inst;ncia "e u$a estrutura
<1//8R=.8> "e 1eb/ervices cria"a !ara ser uti*i0a"a co$o u$a estrutura -/erver-. A
uti*i0a+o "esta instu+o !ara criar inst;$cias "e u$a estrutura usa"a nu$a a!*ica+o
-/erver- "e 1eb/ervices e$ A"vP* evi"a a necessi"a"e "e cria+o "e u$ $?to"o -3)1-
!ara ca"a estrutura.
Observao : )$bora seHa !ossCve* no se "eve uti*i0ar esta instru+o !ara inicia*i0ar
u$a estrutura cria"a e$ u$ #onte -.*ient- e$ A"v!*P !ois as estruturas c*ient !ossue$ as
"e#ini+,es "o $?to"o 3)1<> "e ca"a u$a co$ as "evi"as inicia*i0a+,es "e !ar;$etros
inetrentes ao servi+o.
+u),es - WSDLD6*LE!EL
Reviso: 22/04/2004
Abrangncia
/inta5e
1/7%7'A%)V)% < K n%eve* M > ((M 3&%
Par;$etros
n%eve* 3u$?rico
Atrav?s "e n%eve* "e#ini$os @ua* o nCve* "e in#or$a+,es
a ser $ostra"o : 0 <"e#au*t > Q se$ in#or$a+,es
a"icionais 1 Q A!enas !acote "e retorno e 2 Q
&n#or$a+,es e !acote "e )nvio e Retorno .
Obs: 7eve$os cha$ar esta #un+ao a!os inicia*i0a"o o
ObHeto -.*iente- "o 1eb /ervice.
Retorno
8i!o 7escri+o
<3=%O> )sta #un+o se$!re retorna 3&%
7escri+o
=ti*i0a"a !ara "e!ura+o "e u$a a!*ica+o -.*iente- "e 1eb /ervices e$ A"v!* .
Atrav?s "esta #un+o ? !ossCve* setar e$ te$!o "e e5ecu+o u$ -echo- "e in#or$a+,es
a"icionais !ertinentes N e5ecu+o "e u$ $?to"o -.*ient- "e 1eb /ervices a ser
$ostra"o no conso*e "o servi"or Protheus < caso habi*ita"o > !er$itin"o ain"a
!ara$etri0ar u$ nCve* "e "eta*ha$ento "as in#or$a+,es a sere$ $ostra"as.
Observa,es
O va*or in#or$a"o na cha$a"a "esta #un+o serG $anti"o e consi"era"o !or
to"os os $?to"os "e servi+os -.*ient- e$ A"v!* e5ecuta"os a !artir "e ento
nesta ,"ead) at? @ue a a!*ica+o seHa #ina*i0a"a ou esta #un+o seHa cha$a"a
nova$ente.
)sta #un+o "eve ser uti*i0a"a Onica e e5c*usiva$ente !ara #ins "e "e!ura+o
!ois a $es$a onera a &e".("mance "a a!*ica+o -.*ient-.
A%&ica,es 4Server4 em A'v%&
Reviso: 22/04/2004
Abrangncia
3este t2!ico e !osteriores "ocu$entos so "eta*ha"as as atribui+,es e #unciona*i"a"es
"e u$a a!*ica+o -/erver- "e 1eb /ervices uti*i0an"o o Protheus "es"e a cria+o "a
a!*ica+o at? as con#igura+,es necessGrias !ara a !ub*ica+o "o 1eb /ervice.
A cria+o "e u$ -/erver- "e 1eb /ervices e$ A"v!* consiste na $ontage$ "e u$a
c*asse A"v!* es!ecia* cha$a"a WSSE!ICE on"e ca"a $?to"o "a c*asse ? u$a a+o
"o 1eb /ervice. .aberG aos #ontes "esta c*asse o !rocessa$ento "e u$a re@uisi+o e a
gera+o "o res!ectivo retorno caben"o ento N %ib "e 1eb /ervices "a &n#ra()strutura
"o )RP a ca$a"a "e troca "e "a"os rece!+o !r?(va*i"a+o e trata$ento "o !acote
/OAP as convers,es "e "a"os cabCveis "o RI% !ara as !ro!rie"a"es "e !ar;$etro "a
c*asse A"v!* e a $ontage$ "o !acote /OAP a !artir "as !ro!rie"a"es "e retorno seta"as
!e*o $?to"o e5ecuta"o e retornG(*o ao -.*ient- so*icitante "o !roessa$ento a*?$ "e
!rover No -.*iente- o "ocu$ento 1/7% re#erente N<s> c*asse<s> -/erver- co$!i*a"a<s> no
re!osit2rio "e obHetos e$ uso e con#igura"o !ara aten"er Ns re@uisi+,es "e
!rocessa$ento.
)ste $?to"o "e !rogra$a+o e$ ca$a"as !er$ite enca!su*ar on trata$entos internos
e$ se tratan"o "e !rotoco*o J88P /OAP e 1/7% tornan"o re*ativa$ente #Gci* a
$isso "e criar u$ 1eb /ervi+e -/erver- uti*i0an"o(se "o Protheus. 'asta escrever u$a
c*asse @ue receba nenhu$ u$ ou $ais @ue u$ !ar;$etro e "evo*va obrigatoria$ente
u$ retornoP con#igurar o Protheus /erver !ara habi*itar a inter#ace J88P e os 1eb
/ervices @ue a %ib #a0 to"o o resto.
785 WebServices 4Server4 - Co)(i3urao
Reviso: 27/04/2004
Abrangncia
O Servidor Protheus como 'SERVER' de ebServices
=$ 1eb/ervice e$ A"v!* uti*i0a(se "e 1orXing 8hrea"s <YY> !ara aten"er as
so*icita+,es "e !rocessa$ento atrav?s "o !rotoco*o J88P.
)5iste$ "uas $aneiras "e habi*itar o 1eb/ervice : Atrav?s "a cria+o "a se+o
91)'/)RV&.)/: no ar@uivo "e con#igura+o "o servi"or ou atrav?s "a con#igura+o
$anua* "e u$ a$biente "e 1orXing 8hrea"s )5ten"e" < 1)')R > ta$b?$ no
inicia*i0a"or. A "i#eren+a entre a$bas ? @ue a segun"a o!+o !er$ite es!eci#icar
$aiores "eta*hes "o a$biente "e e5ecu+o "o servi+o !er$ite a con#igura+o "e
servi+os e 1eb /ites si$u*tanea$ente e ta$b?$ aten"i$ento "i#erencia"o "e
!rocessa$ento !ara $ais "e u$ host e "iret2rios virtuais. Suan"o uti*i0a$os o Protheus
8 "eve$os uti*i0ar o novo assistente "e con#igura+o "o servi"or Protheus (
IP81&ZAR7 !ara insta*ar e con#igurar o $2"u*o "e 1eb/ervices.
/egue abai5o u$ e5e$!*o "ocu$enta"o "e co$o con#igurar o servi"or Protheus !ara
1eb/ervices uti*i0an"o a chave 91)'/)RV&.)/:.
Observao : )sta con#igura+o e5ige @ue a se+o J88P no esteHa con#igura"a no
servi"or Protheus. )sta con#igura+o irG interna$ente habi*itar o servi+o "e J88P e
con#igurar o !rocesso "e res!osta !ara 1eb/ervices.
91)'/)RV&.)/:
)nab*eQ1 P < Obrigat2rio > &n"ica se o service estG habi*ita"o <1> ou no <0>.
)nviron$entQ)3V8)/8) P < Obrigat2rio > &n"ica @ua* environ$ent "o /erver
@ue irG aten"er as re@uisi+,es
.onoutQ0 P < O!ciona* > Per$ite a e5ibi+o "e in#or$a+,es "os status internos "o
servi+o < "e#au*t Q 0 : "esabi*ita"o > . =ti*i0a"o AP)3A/ !ara "e!ura+o e$ casos
es!ecC#icos !ois !reHu"ica signi#icativa$ente a !er#or$ance "o<s> servi+o<s>.
8raceQ0 P < O!ciona* > Jabi*ita a grava+o "e u$ ar@uivo "e *og < Vsstrace.*og >
conten"o as in#or$a+,es sobre to"as as cha$a"as e status "o 1eb /ervice < "e#au*t Q
0 >
Pre!are&nQ0101 P <Obrigat2rio> Per$ite es!eci#icar @ua* a e$!resa e #i*ia* "o
)RP sero uti*i0a"os !ara a $ontage$ "o a$biente "e !rocessa$ento "as re@uisi+,es.
3a$e/!ace Q htt!://*oca*host P < O!ciona* > Per$ite es!eci#icar o no$e "o
na$es!ace -"e#au*t- uti*i0a"o !e*o<s> servi+o<s> co$!i*a"o<s> se$ a "e#ini+o "e
-3a$e/!ace-. < "e#au*t Q host atua*$ente uti*i0a"o >
=R%%ocation Q htt!://*oca*host P < O!ciona* > Per$ite es!eci#icar a ur*
res!onsGve* !e*o aten"i$ento Ns so*icita+,es "e !rocessa$ento "o<s> servi+o<s> < "e#au*t
Q host atua*$ente uti*i0a"o >
Para con#igurar o 1eb/ervice $anua*$ente "eve ser inicia*$ente habi*ita"o o
servi+o "e J88P "o servi"or Protheus con#igurar u$ !rocesso 1)')R a!ontan"o
!ara #un+,es internas "e !rocessa$ento "os 1eb /ervices e con#igurar u$ host atrav?s
"o @ua* as re@uisi+oes !rocessa$ento sero aten"i"as. VeHa no e5e$!*o abai5o :
9J88P: PP .on#igura+o "o !rotoco*o J88P
)nab*eQ1
PortQ80
PathQc:[A!7[Jtt!
9*oca*host: PP A tCtu*o "e e5e$!*o con#igura$os o host "a esta+o *oca*.
7e#au*t!ageQVsin"e5.a!V
Res!onse\obQ1/8)/8)
91/8)/8): P .on#iguracao "o Hob !ara aten"er Nos 1eb/ervices
8EP)Q1)')R PP < Obrigat2rio > 8i!o "o \ob !ara 1eb /ervices "eve ser
1)')R
O3/8AR8QLL1//8AR8 PP < Obrigat2rio > con#igura+o #i5a !ara 1eb
/ervices
O3.O33).8QLL1/.O33).8 PP < Obrigat2rio > con#igura+o #i5a !ara 1eb
/ervices
)nviron$entQ)3V8)/8) PP )s!eci#i@ue @ua* a$biente <envi"(nment>"o
servi"or Protheus @ue irG aten"er Nos 1eb/ervices.
&3/8A3.)/Q2U PP < Obrigat2rio > &n"ica @ua* a @uanti"a"e $ini$a <"e#au*t > e
$G5i$a "e !rocessos < ,"eads > @ue sero co*oca"os na $e$2ria !ara aten"er Ns
so*icita+,es "e !rocessa$ento "o<s> servi+o<s> !ub*ica"o<s>.
.onoutQ0 PP < O!ciona* > Per$ite a e5ibi+o "e in#or$a+,es "os status internos
"o servi+o < "e#au*t Q 0 : "esabi*ita"o > . =ti*i0a"o AP)3A/ !ara "e!ura+o e$ casos
es!ecC#icos !ois !reHu"ica signi#icativa$ente a !er#or$ance "o<s> servi+o<s>.
8raceQ1 PP <O!ciona*> Jabi*ita a greva+o "e u$ ar@uivo "e *og < Vsstrace.*og >
conten"o as in#or$a+,es sobre to"as as cha$a"as e status "o 1eb /ervice < "e#au*t Q
0 >
Pre!are&nQ0101 P <Obrigat2rio> Per$ite es!eci#icar @ua* a e$!resa e #i*ia* "o
)RP sero uti*i0a"os !ara a $ontage$ "o a$biente "e !rocessa$ento "as re@uisi+,es.
3a$e/!ace Q htt!://*oca*host/ PP < O!ciona* > Per$ite es!eci#icar o no$e "o
na$es!ace -"e#au*t- uti*i0a"o !e*o<s> servi+o<s> co$!i*a"o<s> se$ a "e#ini+o "e
-3a$e/!ace-. < "e#au*t Q host atua*$ente uti*i0a"o >
=R%%ocation Q htt!://*oca*host/ PP < O!ciona* > Per$ite es!eci#icar a ur*
res!onsGve* !e*o aten"i$ento Ns so*icita+,es "e !rocessa$ento "o<s> servi+o<s> < "e#au*t
Q host atua*$ente uti*i0a"o >
S!"DE# - $%dice de Servi&os
=$a ve0 habi*ita"a a con#igura+o !ara 1eb /ervices obte$os o acesso a u$a
inter#ace J88P "e consu*ta ao Cn"ice "e servi+os !ub*ica"os. Para ta* basta re(iniciar o
servi"or Protheus a!2s a con#igura+o ser rea*i0a"a abrir u$ 1eb 'roVser < !or
e5e$!*o o &nternet )5!*orer > e acessar o *inX htt!://Kservi"orM/Vsin"e5.a!V . 3o caso
"o e5e$!*o "e con#igura+o aci$a basta "igitar$os htt!://*oca*host/Vsin"e5.a!V e
nos serG a!resenta"a a inter#ace "e consu*ta Go Cn"ice "os servi+os.
Por e5e$!*o caso o host con#igura"i !ara os Vehservices #io o host *oca* <*oca*host>
"eve$os acessar o *inX htt!://*oca*host/Vsin"e5.a!V . =ti*i0an"o o Protheus8 serG
$ostra"a u$a te*a se$e*hante N vista abai5o:
3esta inter#ace so $ostra"os to"os os servi+os co$!i*a"os e "is!onibi*i0a"os no
reo!sit2rio "e obHetos e$ uso no a$biente con#igura"o. Atrav?s "e*a ? !ossCve* obter
$aiores "eta*hes sobre ca"a u$ "os servi+os co$!i*a"os.
.a"a servi+o ativo ? u$ *inX !ara u$a !Ggina on"e so $ostra"os to"os os $?to"os "o
servi+o e on"e ? a!resenta"o ta$b?$ u$ *inX atrav?s "o @ua* o servi"or Protheus
#ornecerG a "escri+o "o servi+o <1/7%>. %ogo abai5o ? $ostra"o o e5e$!*o "a te*a "e
"eta*hes "o servi+o .4A8A'%).
O %inX !ara a obten+o "o 1/7% encontra(se aci$a e$ -.4A8A'%).a!V]1/7%-.
'asta c*icar neste *inX @ue u$a nova Hane*a "o 'roVser serG aberta $ostran"o o
"ocu$ento 1/7% "este servi+o.
.a"a $?to"o "o servi+o "is!onibi*i0a"o ta$b?$ ? u$ *inX !ara u$a !Ggina on"e so
$ostra"os os e5e$!*os "e !acotes /OAP @ue este $?to"o es!eci#ica$ente es!era !ara
rece!+o "e !ar;$etros e o $o"e*o "o !acote "e retorno "o servi+o.
.aso o #onte(.*ient A"v!* "este servi+o seHa gera"o e esteHa co$!i*a"o no re!osit2rio
atua* a inte#ace "e consu*ta habi*ita a #unciona*i"a"e "e teste "o 1eb/ervice atrav?s "a
inter#ace htt! $ostran"o no #ina* "a te*a o boto BtestarB. Ao c*icar neste ? $onta"a
u$a te*a e$ J8I% !ara @ue os !ar;$etros "o servi+o seHa$ !reenchi"os. A!2s os
!ar;$etros !reenchi"os e sub$eti"os o !acote "e retorno "o servi+o e seu res!ectivo
status ? retorna"o no 'roVse.
795 Cria)'o um WebService 4Server4 com
o Protheus
Reviso: 2D/04/2004
Abrangncia
Para criar$os u$ 1eb/ervice -/erver- uti*i0an"o o Protheus !ri$eiro "eveve$os
habi*itar o servi"or Protheus co$o servi"or "e 1eb/ervices. Para ta* veHa o "ocu$ento
-con#iguran"o o servi"or Protheus !ara 1eb/ervices. -
=$a ve0 con#igura"o e habi*ita"o os 1eb/ervices no servi"or Protheus "eve ser
inicia*$ente "eter$ina"os os $?to"os aos @uais o servi+o se "estinaP !ara ento
"eter$inar os !ar;$etros e retorno "e ca"a $?to"o. =$a ve0 "eter$ina"as estas
in#or$a+,es "eve ser co"i#ica"a u$a c*asse es!ecia* e$ A"v!* cha$a"a
1//)RV&.) @ue constituirG o servi+o !ro!ria$ente "ito.
Por?$ antes "e !artir !ara a co"i#ica+o ? #orte$ente reco$en"a"o @ue seHa$ *i"os os
"ocu$entos "este t2!ico on"e so aborta"os e$ "eta*hes a in#ra(estrutura envo*vi"a
co$ os 1eb/ervices seu #unciona$ento e as !articu*ari"a"es "e co$!orta$ento "a
c*asse "e 1eb/ervices.
7:5 e3ras %ara co'i(icao 'e um
WebService
Reviso: D0/04/2004
Abrangncia
Vis'o (eral
Para a co"i#ica+o "e u$ Vebservice #ora$ cria"as e$ A"v!* instru+,es es!eciais "e
"ec*ara+o "e c*asse es!ecC#icas !ara 1eb/ervices @ue su!orta$ no$es -*ongos- no
no$e "a c*asse $?to"os e !ro!rie"a"es. A uti*i0a+o "estes co$an"os e5ige a
"ec*ara+o "o înc*u"e -a!Vebsrv.ch- no to!o "o c2"igo(#onteP e e5ige ta$b?$ a
aten+o e$ a*guns !ontos e !articu*ari"a"es a iniciar !e*a no$enc*atura "o servi+o
estruturas $?to"os e !ro!rie"a"es.
Caracter)sticas o*eracio%ais do ambie%te
7eve$os estar atentos ao "esenvo*ver os $?to"os "e 1eb/ervices "evi"o Ns
caracteristicas o!eracionais "o a$biente "e -1orXing 8hrea"s- uti*i0a"o !e*o 1eb
/ervices. Ao e5ecutar u$ $?to"o "o 1eb/ervices o a$biente serG $anti"o no ar
aguar"an"o u$a nova re@uisi+o "e !rocessa$ento "e @ua*@uer servi+o ou $?to"o e
"e @ua*@uer c*iente. 7e $o"o @ue ao "esenvo*ver u$ servi+o no "eve$os "ei5ar
abertos as BSuerFsB uti*i0a"as no $?to"o #i*tros seta"os e$ tabe*as !rinci!ais eu
con#igura+,es es!ecC#icas no(!a"ro "o a$biente rea*i0a"as !ara o !rocessa$ento "e
u$ $?to"o es!ecC#icoP !ois isto !o"e causar i$!acto no #unciona$ento "e to"os os
1eb/ervices co$!i*a"os e ativos neste servi"or co$ e#eitos i$!revisCveis.
"ome%clatura dos Servi&os
O no$e "e u$a c*asse !ara 1eb/ervices "eve ser inicia"o !or u$ caractere a*#ab?tico
e "eve conter a!enas os caracteres a*#ab?ticos co$!reen"i"os entre A e Z os caracteres
nu$?ricos co$!reen"i"os entre 0 e _ !o"en"o ta$b?$ ser uti*i0a"o o caracter `La
<un"er*ine > . =$ servi+o no !o"e ter u$ no$e "e u$a !a*avra reserva"a A"v!* e no
!o"e ter o no$e igua* a u$ ti!o bGsico "e in#or$a+o.
"ome%clatura de Estruturas
O no$e "a"o N u$a estrutura obe"ece as $es$as regras "e no$enc*atura "e /ervi+osP
no !o"en"o haver u$a estrutura co$ o $es$o no$e "e u$ servi+o "ec*ara"o.
7eve$os estar atentos ta$b?$ No #ato "e u$a estrutura no estar "ireta$ente *iga"a No
servi+o e$ @uesto "e $o"o @ue no !o"e$os co$!i*ar "uas estruturas "e $es$o
no$e no $es$o re!osit2rio.
=$a estrutura contitui u$ agru!a$ento "e "a"os cria"o co$o u$a c*asse es!ecia*
<1//8R=.8> e$ A"v!*. 7eve$os criar "e u$a estrutura !ara u$ servi+o @uan"o ?
necessGrio agru!ar u$ conHunto "e "a"os bGsicos e/ou outras estruturas e$ u$ Onivo
ti!o "e in#or$a+o @ue serG uti*i0a"a co$o !ar;$etro e/ou retorno e$ u$ ou $ais
$?to"os "o servi+o.
"ome%clatura das *ro*riedades - *ar+metros e retor%o
.a"a !ar;$etro e retorno "e to"os os $?to"os "e u$ servi+o "eve$ ser "ec*ara"os
co$o u$a !ro!rie"a"e "a c*asse "o /ervi+o. Para "ar no$e a estes so vG*i"as as
$es$as regras "e no$enc*atura "e /ervi+os no !o"en"o haver u$ "a"o co$ o $es$o
no$e "e u$ servi+o ou estrutura HG "ec*ara"os anterior$ente.
7;5 Ti%os 6<sicos 'e Da'os - 4Server4
Reviso: 2D/04/2004
Abrangncia
Suan"o escreve$os u$ 1eb/ervice -/erver- "eve$os es!ec#iicar o ti!o "a in#or$a+o
"e ca"a !ar;$etro e retorno e$ con#or$i"a"e co$ a es!eci#ica+o -/OAP- uti*i0a"a
nos !acotes RI% "e troca "e "a"os.
/o consi"era"os e su!orta"os !e*o Protheus @uan"o "a "ec*ara+o "os !ar;$etros e
retorno os seguintes ti!os bGsicos :
String Dado Advpl do tipo String.
Date Dado Advpl do tipo Data.
Integer Dado Advpl do Tipo numrico (apenas numeros
inteiros.)
Float Dado Advpl do Tipo numrico (pode conter numeros
inteiros e no-inteiros.)
Boolean Dado Advpl do Tipo Booleano ( lgico ) .
Base64Bina
ry
Dado Advpl do Tipo String Binria , aceitando todos os
aracteres da Ta!ela AS"" , de #$(%) a #$(&'')
Observa&,es
Ao "ec*arar$os u$a !ro!rie"a"e co$o sen"o "o ti!o B/tringB no !o"e$os
es!eci#icar a !a*avra B/tringB e$ *etras $aiOscu*as. A !a*avra /8R&3A escrita
"esta $aneira ? inter!reta"a !e*o !r?(co$!i*a"or "o Protheus co$o sen"o u$a
constante ocasionan"o erro "e sinta5e "a co$!i*a+o "o 1eb/ervice.
7=5 Estruturas - Ti%os com%&e$os
Reviso: 2D/04/2004
Abrangncia
De-i%i&'o de Estrutura
=$a estrutura < ta$b?$ conheci"a !or C(m&le$ %&e > constitui u$a c*asse es!ecia* "o
A"v!* cha$a"a 1//8R=.8 cria"a es!eci#ica$ente !ara 1eb/ervices. 7eve$os criar
u$a estrutura @uan"o te$os a necessi"a"e "e agru!ar $ais "e u$a in#or$a+o
inc*uin"o ti!os bGsicos e/ou outras estruturas.
Ao criar$os u$ servi+o @ue "everG receber co$o !ar;$etro u$ gru!o "e in#or$a+,es
"e#ini"o !or e5e$!*o os "a"os ca"astrais "e u$ c*iente "eve$os criar u$a estrutura
!ara agru!ar estes "a"os. Va*e ressa*tar @ue a "ec*ara+o "e u$a estrutura no a$arra a
$es$a No servi+o e$ @uesto "e $o"o @ue a $es$a estrutura !o"e ser uti*i0a"a !ara
$ais "e u$ servi+o co$!i*a"o no re!osit2rio. .aso a estrutura cria"a seHa es!ecC#ica
!ara o servi+o e$ @uesto ? reco$en"a"o @ue seHa "a"o u$ no$e N $es$a @ue etnha a
ver co$ o servi+o No @ua* e*a !erten+a !ois no ? !ossCve* co$!i*ar $ais "e u$a
estrutura "e $es$o no$e no re!osit2rio.
7>5 M1to'os 4Server4 em A'v%& -
Caracter?sticas
Reviso: 2T/04/2004
Abrangncia
De-i%i&'o
=$ $?to"o "e u$ 1eb/ervice consiste e$ u$a a+o a ser "is!onibi*i0a"a no servi+o.
7a$os a e*a u$ no$e !ara i"enti#ica+o "ec*ara$os a $es$a na estrutura "a c*asse "o
/ervi+o be$ co$o seus !ar;$etros e res!ectivo retorno.
Par+metros
Ao "ec*arar o #onte "e u$ $?to"o o $es$o !o"e receber u$ ou $ais !ar;$etros "e
ti!o bGsico e/ou estruturas e inc*usive !o"e no receber !ar;$etro a*gu$. 3este caso
"eve$os es!eci#icar @ue o !ar;$etro recebi"o serG 3=%%PARAI ou seHa nenhu$
!ar;$etro.
Retor%o
=$ $?to"o "e 1eb/ervices "eve obrigatoria$ente tr u$a !ro!rie"a"e "e retorno. 3o
#a0 !arte "a es!eci#ica+o "e 1eb/ervices a cria+o "e u$ $?to"o @ue no !ossua
retorno.
Codi-ica%do o m.todo em Adv*l
.o$o visto anterior$ente tanto os !ar;$etros @uanto o retorno "e u$ $?to"o "e
1eb/ervices "eve ser "ec*ara"o co$o u$ "a"o "a c*asse < atrav?s "a instru+o
1/7A8A >.
Suan"o escreve$os u$ $?to"o "e u$ 1eb/ervice e o $es$o recebe u$a so*icita+o
"e !rocessa$ento as !ro!rie"a"es "ec*ara"as co$o !ar;$etros "o $?to"o so
a*i$enta"as e o $?to"o ? e5ecuta"o. Por tratare$(se "e !ro!rie"a"es o c2"igo #onte
A"v!* "everG interagir co$ estas !ro!rie"a"es !re#i5an"o(as co$ -::- "ois !ontos
segui"os> ou -se*#:- sen"o isto vG*i"o tanto !ara os !ar;$etros "o $?to"o co$o !ara a
!ro!rie"a"e "e retorno.
7a"a a e5istncia "e u$a %&' "e &n#ra()strutura @ue rea*i0a a ca$a"a "e co$unica+o
va*i"a+o $ontage$ e "es$ontage$ "e !acotesP ao co"i#icar u$ $?to"o "e
1eb/ervice e5iste$ se$!re "ois retornos : A !ro!rie"a"e "e retorno "o $?to"o e o
retorno e#etivo "o $?to"o ao #ina* "o !rocessa$ento.
O retorno e#etivo "o $?to"o "eve ser u$ va*or boo*eano : /e retorna"o .8. <"ue> isto
in"ica N %&' @ue o $?to"o #oi e5ecuta"o co$ sucesso e conse@uente$ente a
!ro!rie"a"e "e retorno #oi a*i$enta"a. %ogo o !acote -/OAP- "e retorno "o $?to"o
serG $onta"o !e*a %&' e "evo*vi"a auto$atica$ente No -.*ient- @ue so*icitou a
cha$a"a "e !rocessa$ento.
.aso o retorno e#etivo "o $?to"o seHa .4. <0alse> isto in"ica N %&' @ue !or a*gu$a
ra0o trata"a no #onte "o $?to"o no #oi !ossCve* a e5ecu+o "o $?to"o. 3este caso
"eve$os es!eci#icar antes "o retorno atrav?s "a #un+o /et/oa!4au*t<> a causa "a
i$!ossibi*i"a"e "e !rocessa$ento.
E/em*lo
1/I)8JO7 Aet7ate 1/R).)&V) 3=%%PARAI 1//)37 Jorario 1//)RV&.)
/erver8i$e
&# "oV<"ate<>>Q1
// /eta u$ soa!L#au*t in#or$an"o @ue este servi+o no ? "is!onCve* aos "o$ingos
/et/oa!4au*t<-Ieto"o no "is!onCve*--)ste servi+o no #unciona aos 7o$ingos.->
// e retorna .4. in"ican"o @ue o servi+o no #oi !rocessa"o co$ sucesso.
Return .#.
)n"i#
// a*i$enta a !ro!rie"a"e "e retorno
::Jorario :Q ti$e<>
// ) retorna .8. in"ican"o !rocessa$ento "o $?to"o co$ sucesso
Return .8.
Ate%&'o 0
/e$!re @ue o retorno e#etivo "o $?to"o ? ver"a"eiro <.8. > a !ro!rie"a"e "e
retorno "eve ser !reenchi"a. .aso e*a no seHa !reenchi"a a %&' irG retornar No
c*ient so*icitante u$ !acote "e /OAP 4au*t in"ican"o @ue houve u$ erro no
!rocessa$ento "o servi+o e registrar u$ error.*og na esta+o servi"ora. /erG
gera"o ta$b?$ u$a ocorrncia "e erro caso o $?to"o retorne .8. !or?$ a
#un+o /et/oa!4au*t<> tenha si"o cha$a"a "urante a e5ecu+o "o $?to"o. A
ocorrncia gera"a ? @SE!ICOA : @METODOA ET"N 5T5 WIT# SOAP
+A"LT EBCEPTION NOT EMPTC5
/e$!re @ue o retorno e#etivo "o $?to"o ? #a*so <.4.> a #un+o /et/oa!4au*t<>
"eve ser cha$a"a !ara @ue a %&' gere u$ !acote co$ o $otivo "o erro !ara o
-.*ient- @ue so*icitou o $?to"o. .aso o retorno e#etivo seHa .4. e a #un+o
/et/oa!4au*t<> no tenha si"o cha$a"a ? "evo*vi"o N esta+o -.*ient- so*icitante
"o !rocessa$ento u$ /oa!:4au*t co$ a ocorrncia "e erro @SE!ICOA :
@METODOA ET"N 5+5 WIT# SOAP +A"LT EBCEPTION EMPTC5
7D5 Tratame)to 'e Erro 'os WebServices
Reviso: 27/04/2004
Abrangncia
7a"a a in#ra(estrutura envo*vi"a no !rocessa$ento "os 1eb/ervices a rotina "e
trata$ento "e erro "a a!*ica+o 1eb/ervices -/erver- !rev o trata$ento "e ocorrncias
"es"e a"vertncia "e carga "os servi+os at? #a*has "e inicia*i0a+o "e a$biente
!assan"o !or erros @ue inva*i"a$ u$ "eter$ina"o servi+o co$!i*a"o at? as ocorrncias
"e inconsistncias "e !ar;$etros "e cha$a"a "o servi+o inconsistncias "e retorno
ocorrncias "e erro #ata* "e !rocessa$ento na a!*ica+o e ocorrncias "e
!rocessa$ento @ue no constitua$ u$ erro #ata* !or?$ "eve$ retornar u$ !acote "e
ocorrncia "e erro conheci"o !or S!AP 0A12 .
Os trata$entos a!*ica"os Ns ocorrncias re!ro"u5i"as no $o$ento "a carga "o
a$biente "e 1eb/ervices esto re*aciona"os no t2!ico B4a*has "e .arga "os /ervi+osB
os re*aciona"os N ocorrncias "e erro #ata* "e e5ecu+o "os servi+os esto e$
BOcorrncias "e )rro 4ata*B e a "iscr$ina+o "a uti*i0a+o "o /oa! 4au*t estG estG
"escrita e$ B=ti*i0a+o "o /OAP 4A=%8B.
7E5 "ti&i.ao 'o SOAP +A"LT
Reviso: D0/04/2004
Abrangncia
Suan"o "esenvo*ve$os u$ servi+o e te$os a necessi"a"e "e retornar ao -.*ient-
so*icitante "o !rocessa$ento u$a ocorrncia "e #a*ha no(#ata* "e u$ "eter$ina"o
!rocessa$ento "eve ser retorna"o ao $es$o u$ !acote /OAP @ue in"ica a causa "a
#a*ha. )ste !acote ? conheci"o !or -S!AP 0A12-. A rotina "e trata$ento "e erro #ata*
"e e5ecu+io "o 1eb/ervice @uan"o "a ocorrncia "e ta* gera auto$atica$ente u$
-S!AP 0A12- co$ a "escri+o resu$i"a "a ocorrncia No c*ient so*icitante.
7a"o @ue a ca$a"a "a *ib res!onsGve* !e*a inter!reta+o "o !acote /OAP recebi"o
!e*o servi+o HG se encarrega "e va*i"ar o #or$ato "o !acote e conteO"os obrigat2rios
u$ 1eb /ervice escrito e$ A"v!* "eve antes "e rea*i0ar o !rocessa$ento !ro!osto
va*i"ar se o conteO"o "os !ar;$etros estG "entro "a #ai5a "e "a"os es!era"a e
con"i0entes co$ o es!era"oP !ara ento rea*i0ar o !rocessa$ento e retornar No c*ient
so*icitante.
Para inserir as e5cess,es "e e5ecu+o co$ /oa!(4au*t e$ u$ servi+o -/erver-
uti*i0a$os a #un+o /et/oa!4aut<>.
Soa*-Faults *adr'o do Servidor Protheus de ebServices
A ca$a"a "e co$unica+o "a in#ra(estruruta "e 1eb/ervices rea*i0a auto$atica$ente
os trata$entos "e !rotoco*o #or$ato "o !acote /OAP e !ar;$etros obrigat2rios. .aso
e5ista a*gu$a inconsistncia na cha$a"a "e u$ servi+o @ue incorra e$ a*gu$a "estas
e5cess,es o servi+o so*icita"o no ? cha$a"o e o servi"or Protheus "evo*ve
auto$atica$ente No c*ient so*icitante u$ S(a&/0ault in"ican"o o @ue aconteceu.
)stas ocorrncias "e S(a&/0ault so $ostra"as no conso*e "o servi"or Protheus e so
ar$a0ena"as ta$b?$ no ar@uivo error.*og "o a$biente uti*i0a"o.
Soa*-Faults *adr'o a*1s *rocessame%to do servi&o
A ca$a"a "e co$unica+o "a in#ra(estruruta "e 1eb/ervices va*i"a ta$b?$ a
$ontage$ "o !acote "e retorno. .aso e5ista a*gu$a !ro!rie"a"e "e retorno obrigat2rio
"o servi+o @ue no esteHa a*i$enta"a "e #or$a correta o servi"or Protheus "evo*ve
auto$atica$ente No c*ient so*icitante u$ S(a&/0ault in"ican"o @ue ocorreu u$ erro
interno no servi"or "e 1eb/ervices.
7F5 Servio 'e E$em%&o : SE!ETIME
Reviso: 27/04/2004
Abrangncia
&nicia*$ente o e5e$!*o !ro!osto t$ o obHetivo "e $ontar u$ 1eb/ervice @ue retorne
o horGrio no servi"or Protheus. Para ta* serG cria"o u$ servi+o co$ a!enas
<inicia*$ente> u$ $?to"o. A este servi+o "are$os a e*e o no$e "e /)RV)R8&I). )
ao $?to"o "e buscar o horGrio no servi"or "are$os o no$e "e A)8/)RV)R8&I).
A o!era+o "e buscar o horGrio atua* no servi"or no necessita "e nenhu$ !ar;$etro
!ara a e5ecu+o. Por?$ e*a terG u$ retorno : O horGrio atua* no #or$ato -hh:$$:ss-. A
es!eci#ica+o "e u$ 1eb/ervices !er$ite @ue u$ servi+o seHa "ec*ara"o "e $o"o a no
receber nenhu$ !ar;$etro !or?$ e5ige @ue o 1eb/ervice se$!re !ossua u$ retorno.
Codi-ica%do o Servi&o
Para co"i#icar u$ servi+o "eve$os uti*i0ar o Protheus &7) e criar u$ novo ar@uivo "e
!rogra$a e ne*e escrever o servi+o. A nu$era+o "is!osta N es@uer"a "o c2"igo(#onte
? $era$ente i*ustrativa no "even"o ser "igita"a. )*a ? uti*i0a"a $ais abai5o on"e este
c2"igo ? "eta*ha"o *inha a *inha.
1 #INCLUDE 'PROTHEUS.CH'
2 #INCLUDE 'APWEBSRV.CH'
3
4 WSSERVICE SERVERTIME
5 WSDATA Horario a S!ri"#
$ WSMETHOD %&!S&r'&rTi(&
) ENDWSSERVICE
*
+ WSMETHOD %&!S&r'&rTi(& WSRECEIVE NULLPARAM WSSEND Horario
WSSERVICE SERVERIN,O
1- ..Horario ./ TIME01
11 R&!2r" .T.
%inha 1 b es!eci#ica"a a uti*i0a+o "o &nc*u"e `Protheus.cha conten"o as "e#ini+,es
"os co$an"os A7VP% e "e$ais constantes
%inha 2 8a$b?$ es!eci#ica$os a o &nc*u"e À!1eb/rv.cha @ue cont?$ as "e#ini+,es
"e co$an"os e constantes uti*i0a"os nas "ec*ara+oes "e estruturas e $?to"os
"os We3 Se"vices. )*e ? obrigat2rio !ara o "esenvo*vi$ento "e 1eb/ervices.
%inha 4 .o$ esta instru+o ? "e#ini"o o inicio "a c*asse "o servi+o !rinci!a* ao @ua*
"e$os o no$e "e /)RV)R8&I)
%inha U 7entro "a estrutura "este servi+o ? in#or$a"o @ue u$ "os !ara$etros
uti*i0a"os cha$a(se horGrio e serG "o ti!o /tring
%inha T 7entro "a estritura "este servi+o ? in#or$a"o @ue u$ "os $?to"os "o servi+o
cha$a(se Aet/erver8i$e .
%inha 7 .o$o n;o so necessGrias $ais !ro!rie"a"es ou $eto"os neste servi+o a
estrutura "o servi+o ? #echa"a co$ esta instru+o..
%inha _ A@ui ? "ec*ara"o o #onte "o I?to"o Aet/erver8i$e @ue no receberG
!ara$etro nenhu$ < $as !ara e#eitos "e "ec*ara+o "eve ser in#or$a"o @ue e*e
receberG o !ara$etro 3=%%PARAI > e ? in#or$a"o @ue seu retorno serG o
"a"o Jorario < "ec*ara"o na c*asse "o servi+o co$o u$a !ro!rie"a"e "o ti!o
/tring > .
%inha 10 b atribuC"o na !ro!rie"a"e ::Jorario "a c*asse "este servi+o o retorno "a
#un+o A"v!* 8i$e<> @ue retorna a hora atua* no servi"or no #or$ato
JJ:II://. 7eve$os uti*i0ar o -::- !ara a*i$entar$os a !ro!rie"a"e "a c*asse
atua*
%inha 11 O $?to"o Aet/erver8i$e ? #ina*i0a"o nesta *inha retornan"o .8. <true>
in"ican"o @ue o servi+o #oi e5ecuta"o co$ sucesso.
A!2s co$!i*a"o o servi+o "eve ser acessa"a nova$ente a !Ggina "e Cn"ice "e servi+os
<Vsin"e5.a!V> e veri#icar se o novo servi+o co$!i*a"o *G se encontra.
Testa%do o Servi&o
Ao acessar a !Ggina "e Cn"ice e constatar$os a e5istncia "o servi+o "eve$os obter o
*inX atrav?s "o @ua* o 1/7% "este servi+o estG sen"o #orneci"o e uti*i0ar$os "e u$a
#erra$enta !ara gerar u$ -.*ient- @ue !ossibi*ite o uso "este servi+o. b !ossCve*
inc*usive uti*i0ar o Protheus &7) !ara gerar o #onte -.*ient- !ara testar o servi+oP !or?$
e5iste a necessi"a"e "e criar u$a #un+o !ara instanciar a c*asse -.*ient- gera"a
a*i$entar os !ar;$etros e testar o servi+o.
A !artir "a verso Protheus 8 !o"e$os a!enas gerar u$ #onte -.*ient- "esta c*asse e
co$!i*G(*o no $es$o re!osit2rio "o a$biente uti*i0a"o !e*o 1eb/ervices -/erver- @ue
a !r2!ria inter#ace "e cn"ice "e /ervi+os irG !er$itir o teste "o $es$o.
+a&has 'e Car3a 'os Servios
Reviso: 0T/0U/2004
Abrangncia
3este t2!ico so abor"a"as as $ensagens "e ocorrncias re*aciona"as N carga "os
servi+os.
7urante a inicia*i0a+o "o en4ine "e 1eb /ervices os servi+os co$!i*a"os so
va*i"a"os e u$ a$biente ? $onta"o !or t,"ead !ara o aten"i$ento "e so*icita+,es "e
!rocessa$ento. 3este !rocesso e5iste$ ocorrncias re*aciona"as N $ontage$ "o
a$biente @ue !o"e$ i$!ossibi*itar a o!era+o "os 1eb/ervices co$o u$ to"oP e
ocorrncias @ue !o"e$ inva*i"ar a!enas u$ servi+o e$ caso e" inconsistncia "a
"ec*ara+o "o $es$o.
Erro 'e Estrutura : AAC O+ em
%arametro 'e e)555
Reviso: 27/04/2004
Abrangncia
### 0 Erro de Estrutura 0 ARRA2 OF em *arametro de e%trada direto %ao
su*ortado3
7urante a eta!a "e va*i"a+o "os servi+os na carga "os 1eb/ervices esta ocorrncia ?
re!ro"u0i"a @uan"o u$ !ar;$etro 9RRR: #oi uti*i0a"o co$o !ar;$etro "e entra"a
"ireto "e u$ 1eb/ervice !or?$ o $es$o #oi "ec*ara"o co$ trata$ento "e -ArraF O#-.
3o ? su!orta"o receber "ireta$ente u$ arraF co$o !ar;$etro "e u$ $?to"o "e
1eb/ervices -/erver-.
Veri#i@ue e corriHa o c2"igo(#onte e crie u$a estrutura inter$e"iGria !ara enca*su*ar o
!ar;$etro @ue "eve ter trata$ento "e ArraF.
Erro 'e Estrutura : Estrutura
I)'e(i)i'a5
Reviso: 27/04/2004
Abrangncia
4###5 0 Erro de Estrutura 0 Estrutura !%de-i%ida3
re!ro"u0i"a @uan"o u$a !ro!rie"a"e "a c*asse server #oi es!eci#ica"o co$o sen"o u$a
estrutura < ti!o no(bGsico> !or?$ a "ec*ara+o "a estrutura no #oi *oca*i0a"a.
Veri#i@ue e corriHa o c2"igo(#onte e !roce"a co$ a "ec*ara+o "a re#eri"a estrutura.
Erro 'e Estrutura : Nome 'e Estrutura
I)v<&i'o 555
Reviso: 27/04/2004
Abrangncia
4###5 Erro de Estrutura 0 "ome de Estrutura !%v6lido - Ti*o b6sico co%-lita%te3
re!ro"u0i"a @uan"o o no$e "e u$a "eter$ina"a estrutura 56667 #oi es!eci#ica"o co$
u$ no$e igua* a u$ ti!o bGsico "e in#or$a+o. )sta ocorrncia inva*i"a a!enas o
servi+o @ue uti*i0a a "eter$ina"a estrutura.
Veri#i@ue e corriHa o c2"igo(#onte e a "ec*ara+o "o ti!o "a estrutura.
Erro 'e M1to'o : Estrutura 'e E)tra'a
)o e)co)555
Reviso: 27/04/2004
Abrangncia
4###5 0 42225 0 Erro de 7.todo 0 Estrutura de E%trada %'o e%co%trada3
re!ro"u0i"a @uan"o u$ "eter$ina"o $?to"o 9RRR: #oi es!eci#ica"o co$ a*gu$
!ar;$etro "e entra"a 9EEE: cuHa "ec*ara+o no #oi encontra"a co$o u$a !ro!rie"a"e
no #onte construtor "o servi+o.
Veri#i@ue e corriHa o c2"igo(#onte e "ec*are o !ar;$etro EEE co$o u$a !ro!rie"a"e
"a c*asse RRR
Erro 'e M1to'o : Estrutura 'e etor)o
)o e)co)555
Reviso: 27/04/2004
Abrangncia
4###5 0 42225 0 Erro de 7.todo 0 Estrutura de Retor%o %'o e%co%trada3
re!ro"u0i"a @uan"o u$ "eter$ina"o $?to"o 9RRR: #oi es!eci#ica"o co$ u$a estrutura
9EEE: cuHa "ec*ara+o no #oi encontra"a co$o u$a !ro!rie"a"e no #onte construtor
"o servi+o.
Veri#i@ue e corriHa o c2"igo(#onte e "ec*are a !ro!rie"a"e EEE co$o u$a !ro!rie"a"e
"a c*asse RRR
Erro 'e M1to'o : Estrutura 'e etor)o
)o %o'e 555
Reviso: 27/04/2004
Abrangncia
4###5 0 42225 0 Erro de 7.todo 0 Estrutura de Retor%o %'o *ode ser recebida como
*ar+metro3
re!ro"u0i"a @uan"o u$ "eter$ina"o $?to"o 9RRR: #oi "ec*ara"o !ara receber u$a
estrutura 9EEE: e retornar a $es$a estrutura 9EEE: . &sto no ? su!orta"o !e*os
1eb/ervices "o Protheus.
Veri#i@ue e corriHa o c2"igo(#onte.
Erro 'e M1to'o : M1to'o GBBBH 'o
Servio GCCCH 555
Reviso: 27/04/2004
Abrangncia
Erro de 7.todo 0 7.todo 4###5 do Servi&o 42225 %'o declarado %o Servi&o3
re!ro"u0i"a @uan"o u$ "eter$ina"o $?to"o 56667 re#erente No servi+o 58887 #oi
co"i#ica"o !or?$ no #oi "ec*ara"o no construtur "o 1eb /ervice. )sta ocorrncia
inva*i"a a!enas o servi+o @ue uti*i0a a "eter$ina"a estrutura.
Veri#i@ue e corriHa o c2"igo(#onte e !roce"a co$ a "ec*ara+o "o $?to"o no construtor
"o servi+o.
Erro 'e M1to'o : Nome 'e M1to'o
I)v<&i'o - Ti%o555
Reviso: 27/04/2004
Abrangncia
4###5 Erro de 7.todo 0 "ome de 7.todo !%v6lido - Ti*o b6sico co%-lita%te3
re!ro"u0i"a @uan"o o no$e "e u$a "eter$ina"a $?to"o 56667 #oi es!eci#ica"o co$
u$ no$e igua* a u$ ti!o bGsico "e in#or$a+o. )sta ocorrncia inva*i"a a!enas o
servi+o @ue uti*i0a o "eter$ina"o $?to"o.
Veri#i@ue e corriHa o c2"igo(#onte e a "ec*ara+o "o no$e "o $?to"o.
Erro 'e Estrutura : e'u)'a)cia 'e
Estruturas
Reviso: 27/04/2004
Abrangncia
re!ro"u0i"a @uan"o te$os u$a ca"eia "e estruturas co$!ostas !or ti!os bGsicos e
outras estruturas e a "ec*ara+o "as estruturas entre e$ re"un";ncia. Por e5e$!*o
"ec*ara$os a estrutura KAM @ue te$ "entro "e*a u$a outra !ro!rie"a"e @ue ? "o ti!o
KAM ou a estrutura KAM t$ u$a !ro!rie"a"e "e ti!o K'M e K'M !or sua ve0 te$ u$a
!ro!rie"a"e "o 8i!o KAM.
Veri#i@ue e corriHa o c2"igo(#onte e corriHa a "ec*ara+o "as estruturas envo*vi"as.
WSDL Server ONLOAD EO -
+a&ha I)ter)a )a 555
Reviso: 27/04/2004
Abrangncia
SDL Server O"LOAD ERROR - Falha !%ter%a %a Car8a do ebService
)sta ocorrencia ? a!resenta"a na te*a "e Cn"ice "os 1eb/ervices < Vsin"e5.a!V >
@uan"o a*gu$ erro #ata* ocorra na carga "os 1eb/ervices. Os "eta*hes sobre a
ocorrncia #ata* so $ostra"os no conso*e "o servi"or Protheus e grava"os no ar@uivo
error.*og "o a$biente e$ uso.
OcorrI)cias 'e Erro +ata& - A"TOMATIC
"LLOCATION +AILED
Reviso: 22/04/2004
Abrangncia
Ao con#igurar$os u$ 1eb/ervice -/erver- "eve$os es!eci#icar atrav?s "a chave
=R%%O.A8&O3 a ur* es!ecC#ica !ara o acesso Nos servi+os.
Suan"o no "e#ini$os esta =R% a *ib "e 1eb/ervices i"enti#ica auto$atica$ente sob
@ua* ,(st o servi+o #oi acessa"o. )sta o!era+o no ? !ossCve* @uan"o o ,eade" HP
"o !acote in#or$e u$a o!era+o "i#erente "e BA)8B ou BPO/8B ou o servi"or Protheus
estG sen"o e5ecu"a"o e$ sua verso &/AP& e$ conHunto co$ o Iicroso#t <R>
&n#or$ation /ervice.
.aso no seHa !ossCve* i"enti#icar o ,(st sob o @ua* a cha$a"a #oi rea*i0a"a o
1eb/ervice no ? !rocessa"o e o !rocessa$ento ? aborta"o co$ a ocorrncia "e erro
aci$a.
OcorrI)cias 'e Erro +ata& - 6"ILD GBBBH
"SIN* WE6SE!ICES #TTPS NOT
S"PPOTED
Reviso: 22/04/2004
Abrangncia
Suan"o "a carga inicia* "os 1eb/ervices -/erver- a con#igura+o =R%%O.A8&O3 ?
critica"a !e*a %ib. .aso seHa es!eci#ica"o @ue o acesso serG rea*i0a"o via -HPS- e o
bui*" atua* "o servi"or Protheus uti*i0a"o ain"a no su!orta a uti*i0a+o "o 1eb/ervice
sob o !rotoco*o HPS.
IN!ALID "LLOCATION GBBBH ON
GCCCH
Reviso: 22/04/2004
Abrangncia
Suan"o "a con#igura+o "o servi"or Protheus !ara 1eb/ervices caso es!eci#ica"a a
con#igura+o =R%%O.A8&O3 !or?$ a $es$a no seHa es!eci#ica"a co$ u$a sinta5e
vG*i"a o !rocessa$ento ? aborta"o na subi"a "as W("9in4 ,"eads "o servi"or co$
esta ocorrncia "e erro #ata* in"ican"o e$ 9RRR: a ur* in#or$a"a e e$ 9EEE: o no$e
"o ar@uivo "e con#igura+o "o servi"or Protheus.
=$a ur* ? consi"era"a invG*i"a caso e*a no seHa inicia"a co$ -htt!://- ou -htt!s://- seHa
#ina*i0a"a co$ u$ caractere no(a*#anu$?rico ou "i#erente "e -/- ou !ossua caracteres
acentua"os ou es!a+os. /o consi"era"os vG*i"os a!enas caracteres a*#anu$?ricos e os
caracteres -:- <"ois !ontos> -.- <!onto> -/- <barra> e -(- <hC#en>.
)sta va*i"a+o #oi i$!*e$enta"a na &n#ra()strutura "e 1eb /ervices a !artir "a verso
"e in#ra(estrutura -A7VP% 1/7% /erver 1.0D120_-
OcorrI)cias 'e Erro +ata& - EJ"IED
etur) %ro%ertK GBH AS AAC O+
GCH IS 55
Reviso: 2D/04/2004
Abrangncia
RE9U!RED Retur% *ro*ert: 4#5 AS ARRA2 OF 425 !S E7PT2
)sta ocorrncia "e erro ? re!ro"u0i"a @uan"o "o t?r$ino "o !rocessa$ento "e u$
$?to"o "e u$ 1eb/ervices na ca$a"a "a %&' @uan"o "a gera+o "o !acote -/OAP- "e
retorno No -.*ient- so*icitante "o servi+o.
Suan"o "a i"enti#ica+o "a !ro!rie"a"e 9R: "e retorno obrigat2rio "o $?to"o a
$es$a "everia ser u$ -ArraF- A"v!* conten"o no $Cni$o u$ e*e$entoP !or?$ o arraF
no continha nenhu$ e*e$ento.
Veri#i@ue o $?to"o so*icita"o e certi#i@ue(se @ue a !ro!rie"a"e "e retorno esteHa sen"o
a*i$enta"a.
OcorrI)cias 'e Erro +ata& - EJ"IED
etur) %ro%ertK GBH TK%e GCH
")e$%ect 555
Reviso: 2D/04/2004
Abrangncia
RE9U!RED Retur% *ro*ert: 4#5 T:*e 425 U%e/*ected Valt:*e 4;5
Suan"o "a i"enti#ica+o "a !ro!rie"a"e obri3atLria 9R: "e retorno "o $?to"o a
$es$a "everia ser a*i$enta"a co$ u$ conteO"o A"v!* "o ti!o 9E: !or?$ ao inv?s
"este e*a continha u$ va*or "o ti!o A"v!* 9Z:.
Veri#i@ue o $?to"o so*icita"o e certi#i@ue(se @ue a !ro!rie"a"e "e retorno esteHa
a*i$enta"a co$ u$ conteO"o "o ti!o 9E: e$ con#or$i"a"e co$ a "ec*ara+o "a
!ro!rie"a"e no servi+o.
OcorrI)cias 'e Erro +ata& - etur)
%ro%ertK GBH AS AAC TK%e GCH
")e$%ecte'55
Reviso: 2D/04/2004
Abrangncia
Retur% *ro*ert: 4#5 AS ARRA2 T:*e 425 U%e/*ected Valt:*e 4;5
Suan"o "a i"enti#ica+o "a !ro!rie"a"e 9R: "e retorno "o $?to"o a $es$a "everia
ser u$ -ArraF- A"v!* conten"o e*e$entos "o tF!o 9E: !or?$ ao inv?s "a !ro!rie"a"e
ser u$ "o 8i!o A <ArraF> e*a continha u$ va*or "o ti!o A"v!* 9Z:.
a*i$enta"a co$ u$ arraF
%ro%ertK GBH AS O6MECT TK%e GCH
")e$%ect 55
Reviso: 2D/04/2004
Abrangncia
Retur% *ro*ert: 4#5 AS O<=ECT T:*e 425 U%e/*ected Valt:*e 4;5
ser u$a )strutura < 8i!o A"v!* -O- ( ObHeto > A"v!* "o tF!o 9E: !or?$ a !ro!rie"a"e
"e retorno continha u$ va*or "o ti!o A"v!* 9Z:.
Veri#i@ue o $?to"o so*icita"o e certi#i@ue(se @ue a !ro!rie"a"e "e retorno seHa
a*i$enta"a co$ a res!ectiva estrutura e$ con#or$i"a"e co$ a "ec*ara+o "a
!ro!ri"a"e "a c*asse "o servi+o.
%ro%ertK GBH TK%e GCH ")e$%ecte'
!a&tK%e 55
Reviso: 2D/04/2004
Abrangncia
Retur% *ro*ert: 4#5 T:*e 425 U%e/*ected Valt:*e 4;5
ser a*i$enta"a co$ u$ conteO"o A"v!* "o ti!o 9E: !or?$ ao inv?s "este e*a continha
u$ va*or "o ti!o A"v!* 9Z:.
a*i$enta"a co$ u$ conteO"o "o ti!o 9E: e$ con#or$i"a"e co$ a "ec*ara+o "a
!ro!rie"a"e no servi+o.
OcorrI)cias 'e Erro +ata& - "NNNOW
EO : EMPTC #TTP ET"N
Reviso: 2_/04/2004
Abrangncia
Suan"o "o !rocessa$ento "e u$a re@uisi+o "e u$ $?to"o "e 1eb/ervices -/erver-
so e5ecuta"as consistncias "e !r?(!rocessa$ento e !2s(!rocessa$ento. 8o"as as
consistncias internas rea*i0a"as t$ u$a $ensage$ "e retorno. Suan"o "o #ina* "a
e5ecu+o "o servi+o in"e!en"ente$ente "e ocorrer u$ !rocessa$ento co$ sucesso ou
co$ #a*ha < S(a&0ault > ? veri#ica"o se o trata$ento e#etua"o gerou u$ !acote co$ a
$ensage$ "e retorno.
.aso esta ocorrncia seHa re!ro"u0i"a e*a in"ica @ue ocorreu u$a #a*ha no trata"a ou
u$a i$!ossibi*i"a"e "e gera+o "o !acote "e retorno. At? o $o$ento esta ocorrncia
no #oi re!ro"u0i"a sob nenhu$a con"i+o.

OcorrI)cias 'e Erro +ata& - GS!CH :
GMET#ODH as GBH : Ti%o I)es%era'o
'e et55
Reviso: 0T/0U/2004
Abrangncia
4SVC5 0 47ET>OD5 as 4#5 0 Ti*o !%es*erado de Retor%o do 7.todo3
A ocorrncia "e erro aci$a ? re!ro"u0i"a @uan"o "o t?r$ino "a e5ecu+o "e u$
$?to"o "e u$a c*asse -/erver- "e 1eb/ervices. A %&' es!era u$ va*or boo*eano < .8. ou
.4. > "e retorno e#etivo "o $?to"o. .aso o retorno e#etivo no seHa boo*eano o
!rocessa$ento ? aborta"o co$ a ocorrncia aci$a i"enti#ican"o o servi+o cha$a"o e$
9SVC: o $?to"o e$ 9#EH!D: e o ti!o "o retorno e#etivo retorna"o e$ 9R:.
Veri#i@ue o c2"igo(#onte "o $?to"o "o servi+o e certi#i@ue(se @ue o retorno e#etivo "o
$?to"o seHa se$!re .. ou .0.
A%&ica,es Protheus 4C&ie)t4 'e
WebServices
Reviso: D0/04/2004
Abrangncia
De-i%i&'o de Clie%t
Suan"o u$ 1eb /ervice -/erver- ? cria"o e "is!onibi*i0a"o Hunto "e*e ta$b?$ ?
"is!onibi*i0a"a a "e#ini+o "o servi+o seus argu$entos estruturas e retornos <1/7%> .
Para a uti*i0a+o "e u$ 1eb /ervice ? necessGrio $ontar u$ !rogra$a dec*ientf @ue
seHa ca!a0 "e $ontar u$ ènve*o!ea /OAP co$ os "a"os necessGrios ao !rocessa$ento
"o /ervi+o rea*i0ar a cha$a"a e tratar o !acote "e retorno "o servi+o e suas res!ectivas
e5cess,es.
)$bora e5ista$ 1eb /ervices @ue !o"e$ ser acessa"os via Jtt! `"iretoa a!enas
!assan"o !ar;$etros via =R% o ec*ientf "e 1eb /ervices "o Protheus t$ seu #oco e
recursos "ireciona"os a!enas a servi+os @ue !ossua$ inter#ace "e co$unica+o @ue
rea*i0e PO/8 "e !acotes "e "a"os RI% e$ #or$ato /OAP. O Protheus !ossui
#erra$entas e in#ra(estrutura incor!ora"as @ue !er$ite$ esta integra+o.
(era&'o do Clie%t em Adv*l
=ti*i0an"o o &7) encontra(se "is!onCve* no $enu -4erra$entas- a o!+o !ara @ue
atrav?s "e u$ *inX !ara a obten+o "o "ocu$ento 1/7% "e u$ servi+o o Protheus gere
auto$atica$ente e$ A"v!* u$a c*asse -.*ient- !ara a co$unica+o e uti*i0a+o "o
$es$o.
Para ta* basta obter$os o en"ere+o internet < 1R2 > "o 1/7% "eseHa"o criar u$ novo
ar@uivo(#onte e acessar o $enu -4erra$entas (M Aerar .*iente 1eb/ervices...-. Para
ca"a servi+o @ue se tenha a necessi"a"e "e gera+o "e u$ #onte c*ient reco$en"a(se
#orte$ente @ue ca"a #onte c*ient seHa gera"o e$ u$ ar@uivo in"e!en"ente e e5c*usivo
!ara este #i$ e @ue "e #or$a a*gu$a este #onte gera"o !e*o assistente seHa a*tera"o.
Re?uisitos b6sicos *ara a (era&'o do Clie%t em Adv*l
O !rocesso "e gera+o "e #onte ? "is!ara"o atrav?s "o &7) !or?$ ? o servi"or
Protheus @ue irG buscar o "ocu$ento 1/7% so*icita"o. 7e $o"o @ue a esta+o
servi"ora uti*i0a"a no a$biente "eve ter acesso Go en"ere+o so*icita"o.
A%&ica,es Protheus 4C&ie)t4 'e WebServices
- *erao 'e C&ie)t em A'v%& - Passo 78
Reviso: D0/04/2004
Abrangncia
Passo @ 0 Determi%ar como obter o SDL do servi&o deseAado
A $aioria "as "e#ini+,es 1/7% "os servi+os "is!oniveis na 1)' so acessa"os atrav?s
"e u$a =R% e$ gera* a!ontan"o !ara o servi"or on"e o servi+o estG !ub*ica"o
conten"o o no$e "o servi+o na ur* e u$ su#i5o ]1/7% ou .1/7% na =r*. 3;o hG
!a"ro "e#ini"o !ara ta* "e $o"o @ue ca"a servi"or !o"e "is!onibi*i0ar < ou no > o
1/7% "e u$a $aneira "i#erente . O 1/7% "e a*guns servi+os restritos < co$o !or
e5e$!*o o servi+o "e busca na base "e "a"os "o Aoog*e > so "is!onibi*i0a"os e$
ar@uivo A/.&& envia"os !or e($ai* a!os u$ ca"astro no site e autori0a+o "a e$!resa
!ara o uso "o servi+o !or e*e !rovi"o.
3o nosso e5e$!*o i*ustrativo a "e#ini+o "o servi+o ? obti"a "ireta$ente via htt!
atrav?s "o *inX htt!://*oca*host//)RV)R8&I).a!V]1/7% .aso este *inX seHa
acessa"o atrav?s "e u$ 1eb 'roVser < &nternet .)5!*orer. !or e5e$!*o > serG e5ibi"o
no broVse u$ "ocu$ento RI% corres!on"en"o a "e#ini+o "o servi+o.
- *erao 'e C&ie)t em A'v%& - Passo 79
Reviso: D0/04/2004
Abrangncia
Passo 9 : *erar o +o)te A'vP& 'o Oclie%tB usa)'o o Assiste)te 'o IDE
Ao ser gera"o u$ #onte :client; !ara u$ We3 Se"vice este #onte conterG as
"e#ini+,es "os $eto"os "o servi+o a<s> estrutura<s> uti*i0a"a<s> no $es$o e a<s>
c*asse<s> inter$e"iGria<s> "e uso interno !ara $ontage$ e "es$ontage$ "a<s>
estrutura<s> P visan"o o enca!su*a$ento "e to"os os trata$entos "e envio e recebi$ento
"e "a"os atrav?s "e !acotes /OAP.
O 4onte gera"o atrav?s "o assistente "e cria+o "e #onte "eve !re#erencia*$ente
ser gera"o e co$!i*a"o e$ u$ ar@uivo e5c*usivo "estina"o unica e e5c*usiva$ente a
este c2"igo. ) !or tratar(se "e u$a c*asse A"v!* gera"a a !artir "a "e#ini+o "e u$
servi+o no "eve ser inseri"a e/ou a*tera"a nenhu$a "as "e#ini+,es gera"as !e*o
assistente !ois as $es$as sero !er"i"as caso o #onte seHa gera"o nova$ente .
Para gera+o "o #onte :client; e$ A"v!* !ara uti*i0ar este servi+o ? necessGrio
criar u$ novo ar@uivo .PRR no &7) es!eci#ica$ente !ara conter as c*asses "este
servi+o . )nto "eve ser acessa"o o $enu `4erra$entasa o!+o Àerar .iente
1ebservicesa . 3este $o$ento serG $ostra"o na te*a u$ !o!(u! se$e*hante ao
$ostra"o abai5o :
3o ca$!o "e entra"a "e "a"os "eve ser "igita"a a =R% "e on"e o servi"or irG
obter a "e#ini+o "o 1eb/)rvice. < no nosso caso htt!://*oca*host//)RV)R8&I).a!V]
1/7% > . A!2s a con#ir$a+o "a Hane*a aci$a caso o !rocessa$ento ocorra co$
suicesso na Hane*a "e $ensagens "o &"e serG $ostra"o u$ te5to se$e*hante ao abai5o :
(sta!elecendo cone)o com o server...
*or +avor aguarde. ,!tendo descri-o do .e!Service...
/inali0ando cone)o com o server...
,1
) na Hane*a "o novo ar@uivo cria"o "everG ser cria"o u$ c2"igo(#onte
se$e*hante ao $ostra"o abai5o :
#INCLUDE 'PROTHEUS.CH'
#INCLUDE 'APWEBSRV.CH'
--- header do servio ---
34
////////////////////////////////////////////////////////
///////////////////////
WSDL Lo5a!io" 6!!7.338o5a86o!3SERVERTIME.a79:WSDL
%&ra;o &( 1233-3-2 1).21.2+
O<&r'a=>& C?;i#o@,o"!& #&ra;o 7or ADVPL WSDL C8i&"! 1.-2121) B
A8!&ra=>& "&!& arA2i'o 7o;&( 5a2ar B2"5io"a(&"!o i"5orr&!o
& &rCo 7&r;i;a 5ao o 5?;i#o@Bo"!& &Da #&ra;o "o'a(&"!&.
////////////////////////////////////////////////////////
/////////////////////// 43
34 @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
WSDL S&r'i5& WSSERVERTIME
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ 43
--- declarao da Classe client do WebService, co etodos e !ro!riedades
"tili#adas ---
WSCLIENT WSSERVERTIME
WSMETHOD NEW
WSMETHOD %ETSERVERTIME
WSDATA EURL AS S!ri"#
WSDATA 5%ETSERVERTIMERESULT AS !ri"#
ENDWSCLIENT
--- declarao do $todo %&W, !ara a criao do 'b(eto ) Servio ---
WSMETHOD NEW WSCLIENT WSSERVERTIME
..EURL ./ NIL
..5%ETSERVERTIMERESULT ./ ''
R&!2r" S&8B
34 @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
WSDL M&!6o; %ETSERVERTIME oB S&r'i5& WSSERVERTIME
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ 43
--- De*nio do $todo, +"e recebe os !ar,etros de chaada, e-ec"ta o servio
e alienta as !ro!riedades de retorno do etodo, contendo os enca!s"laentos
necess.rios !ara trataento de e-cess/es ---
WSMETHOD %ETSERVERTIME WSSEND NULLPARAM WSRECEIVE 5%ETSERVERTIMERESULT
WSCLIENT WSSERVERTIME
Lo5a8 5Soa7 ./ ''F oG(8R&!
BE%IN WSMETHOD
DE,AULT ..EURL ./ '6!!7.338o5a86o!3SERVERTIME.a79'
5Soa7 H/ 'I%ETSERVERTIME J(8"/'6!!7.338o5a86o!3'K'
5Soa7 H/ 'I3%ETSERVERTIMEK'
oG(8R&! ./ S'5Soa7Ca880 S&8BF5Soa7FL
'6!!7.338o5a86o!3%ETSERVERTIME'FL
'DOCUMENT'F'6!!7.338o5a86o!3'F1
..5%ETSERVERTIMERESULT ./ J%&!I"Bo0 oG(8R&!F
'E%ETSERVERTIMERESPONSE.E%ETSERVERTIMERESULT.TEGT'F '' 1
END WSMETHOD
oG(8R&! ./ NIL
R&!2r" .T.
O #onte aci$a constitui u$a .*asse e$ A"v!* gera"a !ara rea*i0ar a inter#ace
co$ a c*asse origina* !ub*ica"a no /erver HG rea*i0an"o os trata$entos a"e@ua"os !ara
rea*i0ar a co$unica+o via htt! co$ o servi"or on"e o servi+o estG !ub*ica"o. Va*e
obvervar @ue as *inhas e$ negrito no #onte aci$a n;o #ora$ inseri"as !e*o assistente "o
&7) $as acrescenta"as a este "ocu$ento !ara #ins "i"Gticos.
O cabe+a*ho "o #onte cont?$ in#or$a+,es sobre a *oca*i0a+o "o 1/7%
uti*i0a"o !ara a gera+o "o #onte "ata e hora "e gera+o e verso "o engine "e We3
Se"vices uti*i0a"o . %ogo abai5o a "ec*ara+o "e u$a c*asse :client; "e We3 Se"vices
< 1/.%&)38 1//)RV)R8&I) > co$ o $?to"o neV<> !ara inicia*i0a+o "as
!ro!rie"a"es a"v!* "a c*asse . ) e$ segui"a a "ec*ara+o "o $?to"o "e busca "e
JorGrio < 1/I)8JO7 A)8/)RV)R8&I) > @ue no envia !ar;$etro a*gu$ e
retorna o horGrio atua* "o server e$ :: cA)8/)RV)R8&I)R)/=%8 co$ to"os os
trata$entos necessGrios e$buti"os.
- *erao 'e C&ie)t em A'v%& - Passo 7:
Reviso: 22/04/2004
Abrangncia
Passo : : Criar um (o)te Pue uti&i.e esta c&asse %ara uti&i.ao 'o WebService5
Agora ? necessGrio criar u$ novo ar@uivo no &7) e $ontar u$a #un+o !ara
uti*i0ar a c*asse "e We3 Se"vices :client; !ara obter o horGrio no servi"or.
1 #INCLUDE 'PROTHEUS.CH'
2
3 U&r ,2"5!io" T&!C8i&"!01
4 Lo5a8 oS'5 ./ NIL
5
$ oS'5 ./ WSSERVERTIME01.N&901
)
* IB oS'5.%ETSERVERTIME01
+ a8&r!0'HorMrio "o S&r'i;or . 'H oS'5.5%ETSERVERTIMERESULT1
1- E8&
11 a8&r!0'Erro ;& EJ&52=Co . 'H%&!WSCError011
12 E";iB
13
14 R&!2r"
%inha 1 b "ec*ara"a a uti*i0a+o "o &nc*u"e `Protheus.cha conten"o as "e#ini+,es "os
co$an"os A7VP% e "e$ais constantes
%inha D &nicia(se a "e#ini+o "a =ser 4unction !ara uti*i0ar o We3 Se"vice
%inha 4 =$a variGve* *oca* ? "ec*ara"a !ara conter o ObHeto "o We3 Se"vice :client;
%inha T =ti*i0an"o(se "o servi+o a variGve* o/vc ? a*i$enta"a co$ u$a onva inst;ncia
"o We3 Se"vices :client; obti"a atrav?s "a sinta5e
K3OI)L7OL/)RV&.OM<>:3eV<>
%inha 8 b e5ecuta"o o $?to"o Aet/erver8i$e a !artir "o ObHeto "o servi+o o/rv se$
!assar @ua*@uer !ara$etro. O retorno "e u$ $?to"o "o :client; !o"e ser .8.
<true> e$ caso "e e5ecu+o co$ sucesso ou .4. <#a*se> e$ caso "e #a*ha "e
e5ecu+o .
%inha _ .aso o servi+o tenha si"o e5ecuta"o co$ sucesso o retorno es!era"o ?
a*i$enra"o na !ro!rie"a"e cAet/erver8i$eResu*t "o obHeto "o servi+o.
%inha 11 .aso contrGrio < retorno .4. > ocorreu a*gu$a #a*ha na cha$a"a "o servi+o
co$o !or e5e$!*o o servi"or no estava no ar "e$orou $uito !ra res!on"er
< ti$e(out > entre outras. Para ser !ossCve* recu!erar $aiores "eta*hes sobre a
ocorrncia "e erro "eve ser uti*i0a"a a #un+o Aet1/.error<> @ue retorna u$a
string co$ o resu$o "a ocorrncia .
%inha 1D O !rogra$a "e teste ? #ina*i0a"o co$ u$ Return
- *erao 'e C&ie)t em A'v%& - Passo 7;
Reviso: 22/04/2004
Abrangncia
Passo ; : E$ecutar o %ro3rama 'e testes
Abra u$a nova inst;ncia "o A! Re$ote e e5ecute a #un+o =L8)/8.%&)38 .
.aso o We3 Se"vice esteHa no ar e #uncionan"o e o #onte :client; seHa "evi"a$ente
co$!i*a"o e se$ erros o resu*ta"o es!era"o ? u$a Hane*a se$e*hante a $ostra"a
abai5o:
3o a$biente $onta"o !ara teste o /ervi"or "e We3 Se"vices e o :client; est;o no
Protheus co$!i*a"os no $es$o Re!osit2rio "e ObHetos . Para #ins "i"Gticos ? !ossCve*
si$u*ar u$a ocorrncia "e #a*ha no :client; ao "esabi*itar o /erver J88P "o Protheus
<co*ocan"o enab*eQ0 na chave 9htt!: "o ar@uivo "e consigura+o "o servi"or> re(iniciar
o /erver Protheus e e5ecutar o !rogra$a :client; nova$ente . 7eve ser obti"a u$a te*a
se$e*hante a e5e$!*i#ica"a abai5o :
- *erao 'e C&ie)t em A'v%& - Passo 7=
Reviso: 22/04/2004
Abrangncia
Passo = : Obte)'o i)(orma,es 'e Q'ebu3R
Visto at? o !asso 4 u$ e5e$!*o co$!*eto "e u$ :client; #uncionan"o
!er#eita$ente . Agora ? !ossCve* i$aginar @ue "urante o "esenvo*vi$ento e testes "o
:client; "o servi+o #a+a$(se necessGrias "eter$ina"as in#or$a+,es internas as rotinas
"e e5ecu+o "o servi+o no :client; A"v!* . Para ta* #oi cria"a u$a #un+o @ue !er$ite
"e#inir e$ te$!o "e e5ecu+o u$ nCve* "e "eta*ha$ento "e in#or$a+,es a"icionais
re*aciona"as ao We3 Se"vice P in#or$a+,es estas @ue sero $ostra"as no .onso*e "o
/erver Protheus < caso habi*ita"o > . a 4un+o !ara "e#inir o nCve* "e "eta*he cha$a(se
1/7%7bg%eve*<> e recebe u$ nO$ero co$o !ar;$etro :
% ( de+ault ) Sem in+orma-2es adicionais.
3 Apenas String S,A* de retorno do Server.
& Strings Soap de (nvio e $etorno.
)nto na *inha 7 ? acrescenta"a a instru+o 1/7%7bg%eve*<2> !ara ativar o
nCve* $ais co$!*eto "e in#or$acoes a"icionais e ? !ossCve* observar no conso*e "o
servi"or as $ensagens a!resenta"as "urante a e5ecu+o "o #onte "e testes "o :client; .
7eve ser obti"o u$ echo no conso*e "o server se$e*hante ao e5e$!*o abai5o :
Iniciando 0hread 1siga2344, 560'75%8999
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
S'5Soa7Ca88 !o 6!!7.33a2!o(a".*---39&<&r'i5&3SERVERTIME.a79 3
DOCUMENT
Na(&S7a5& 6!!7.33a2!o(a".*---39&<&r'i5&3
Soa7A5!io" 6!!7.33a2!o(a".*---39&<&r'i5&3%ETSERVERTIME
Ca88&; Bro( %ETSERVERTIME 0 13)1
Ca88&; Bro( UETESTCLIENT 0 1-1
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ SOAPSEND @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
I:J(8 '&rio"/'1.-' &"5o;i"#/'2!B@*':K
Ioa7.E"'&8o7& J(8".Ji/'6!!7.33999.93.or#32--13GMLS56&(a@
i"!a"5&' J(8".J;/'
6!!7.33999.93.or#32--13GMLS56&(a'
J(8".oa7/'6!!7.3356&(a.J(8oa7.or#3oa73&"
'&8o7&3'K Ioa7.Bo;NK
I%ETSERVERTIME J(8"/'6!!7.33a2!o(a".*---39&<&r'i5&3'K
I3%ETSERVERTIMEK I3oa7.Bo;NK
I3oa7.E"'&8o7&K
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ POST RETURN @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
I:J(8 '&rio"/'1.-' &"5o;i"#/'2!B@*':KIoa7.E"'&8o7&
J(8".Ji/'6!!7.33999.93.or
#32--13GMLS56&(a@i"!a"5&'
J(8".J;/'6!!7.33999.93.or#32--13GMLS56&(a' J(8".o
a7/'6!!7.3356&(a.J(8oa7.or#3oa73&"'&8o7&3'KIoa7.Bo;NKI%ET
SERVERTIMERESPONSE

J(8"/'6!!7.33a2!o(a".*---39&<&r'i5&3'KI%ETSERVERTIMERESULT
K1-.3).1-I3%ETSERVE
RTIMERESULTKI3%ETSERVERTIMERESPONSEKI3oa7.Bo;NKI3oa7.E
"'&8o7&K
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
Fi 0hread 1siga2344, 560'75%8 BytesIn :; Bytes'"t :<
O te5to $arca"o e$ a0u* c*aro so as $ensagens in#or$ativas a res!eito "a
cha$a"a "o 1eb/ervice in#or$an"o a =R% cha$a"a o esti*o soa! "e troca "e "a"os <
'ocume)t > o 3a$e/!ace e o /oa!Action uti*i0a"os. O 8e5to $arca"o e$ ver"e
</OAP/)37> in#or$a o conteu"o "o !acote /oa! @ue #oi envia"o < !osta"o > ao
/ervi"or e o conteu"o e$ a$are*o < PO/8 R)8=R3 > in#or$a o conteO"o "o !acote
/oa! "evo*vi"o !e*o /erver re#erente a esta so*icita+o.
Suan"o ocorre u$ erro @ua*@uer re*aciona"o ea e5ecu+o "o :client; We3
Se"vices o $?to"o cha$a"o retorna .4. e o erro !o"e ser recu!era"o atrav?s "a #un+o
Aet1/.error<> vista anterior$ente . Para ca"a e5cesso !revista no :client; e5iste u$
c2"igo "e erro corres!on"ente to"os e*es !re#i5a"os co$ 1/.)RR . A $aioria "as
ocorrncias estG re*aciona"a ea gera+o "o .2"igo #onte "o :client; A"v!* uti*i0a"o(se o
&7). 8o"as as ocorrenctas "e e5cesso trata"as !e+o We3 Se"vices :client; A"v!* esto
re*aciona"as no 82!ico We3 Se"vices :client; d .2"igos "e )rro .
- Ti%os 'e 'a'os su%orta'os - 4C&ie)t4
Reviso: 22/04/2004
Abrangncia
At? o $o$ento so su!orta"as as gera+,es "e c2"igo A"v!* !ara 1eb/ervices -.*ient-
@ue uti*i0a$ os ti!os bGsicos "e "a"os *ista"os abai5o. Para !er$itir a $ani!u*a+o "e
ca"a ti!o uti*i0an"o variGveis A"v!* so uti*i0a"os os ti!os bGsicos "o A"v!* !ara
tratar si$u*tanea$ente $ais "e u$ ti!o "e "a"o "os !acotes -/OAP- "os 1eb/ervices.
Os ti!os abai5o so "is!onibi*i0a"os e$ A"v!* atrav?s "e u$a variGve* "e ti!o -3-
3u$?rica
&38
&38)A)R
'E8)
4%OA8
7O='%)
=3/&A3)7%O3A
=3/&A3)7&38
7).&IA%
%O3A
Os ti!o abai5o ? "is!onibi*i0a"o e$ A"v!* atrav?s "e u$a variGve* "e ti!o -7- 7ata
7A8)
Os ti!os abai5o so "is!onibi*i0a"os e$ A"v!* atrav?s "e u$a variGve* "e ti!o -.-
.haracter
/8R&3A
7A8)8&I)
.JAR <YY>
'A/)T4'&3ARE
<YY> O ti!o .JAR corres!on"e N u$a string conten"o o nO$ero "o caractere
corres!on"ente N tabe*a A/.&&
Os ti!o abai5o ? "is!onibi*i0a"o e$ A"v!* atrav?s "e u$a variGve* "e ti!o -%- %ogica
'OO%)A3
WSCE777 S WSDL )o su%orta'o5
E$iste mais 'e 55
Reviso: 22/04/2004
Abrangncia
Verso 8.11
GWSDL )o su%orta'o5 E$iste mais 'e um servio 'ec&ara'o5H
)sta ocorrncia "e erro ? re!ro"u0i"a @uan"o "a gera+o "e u$ #onte "e 1eb/ervices
-.*ient- uti*i0an"o o Protheus &7). Por "e#ini+o u$ 1/7% "eve conter u$ e a!enas
u$ servi+o "ec*ara"o co$ u$ ou $ais $?to"os . .aso seHa$ i"enti#ica"os $ais "e u$
servi+o no $es$o 1/7% no $o$ento "a gera+o "o #onte o !rocesso ? aborta"o o
1/7% ? consi"era"o invG*i"o e o #onte c*ient no ? gera"o.
WSCE778 S No h<
SOAP:6INDIN*S %ara a 3erao 55
Reviso: 22/04/2004
Abrangncia
Verso 8.11
WSCE778 S No h< SOAP:6INDIN*S %ara a 3erao 'o Servio5
7urante a gera+o "o co"igo(#onte !ara ec*ientf A"v!* a !artir "e u$a "e#ini+o "e
servi+o <1/7%> u$a ve0 i"enti#ica"o o servi+o o gera"or "e c2"igo !rocura a
"ec*ara+o "os '&37&3A/ no 1/7%. .aso esta "ec*ara+o no esteHa !resente a rotina
consi"era o 1/7% inco$!*eto e aborta o !rocesso "e gera+o "e c2"igo co$ esta
$ensage$.
WSCE77: S GBBB S CCCH
E)umeratio) )o su%orta'o
Reviso: 22/04/2004
Abrangncia
Verso 8.11
WSCE77: S GBBB S CCCH E)umeratio) )o su%orta'o
-.*ient- uti*i0an"o o Protheus &7). 3o !rocesso "e gera+o so ana*isa"os to"os os
!ar;$etros e estruturas uti*i0a"as !e*os $?to"os "o servi+o. Suan"o encontra"a u$a
estrutura bGsica < Sim&le%&e > on"e #oi es!eci#ica"o u$ -enume"ati(n- < *ista "e
!ara$etros vG*i"os !r?("eter$ina"a > so su!orta"os os seguintes ti!os bGsicos "e
!ar;$etros *ista"os abai5o :
/8R&3A
4%OA8
7O='%)
7).&IA%
&38
&38)A)R
%O3A
=3/&A3)7&38
=3/&A3)7%O3A
.aso o 1/7% contenha u$ -enume"ati(n- uti*i0an"o u$ ti!o "e "a"o "i#erente "os
"ec*ara"os aci$a o !rocesso "e gera+o "e #onte ? aborta"o co$ a ocorrncia "e erro
aci$a on"e o -enu$eration- no su!orta"o ? i"enti#ica"o e$ KRRRM e KEEEM
corres!on"en"o No no$e "o !ar;$etro e ti!o uti*0ia"o res!ectiva$ente.

WSCE77; S NAO IMPLEMENTADO
T 778@BA S @NA S 555
Reviso: 22/04/2004
WSCE77; S NAO IMPLEMENTADO T 778@BA S @NA S WSDLTCPEUNAME V
!ar;$etros e estruturas uti*i0a"as !e*os $?to"os "o servi+oat? @ue to"as as estruturas
uti*i0a"as seHa$ !rocessa"as.
Suan"o "este !rocessa$ento u$a estrutura contenha u$ "eter$ina"o e*e$ento @ue
a!onte !ara u$a outra estrutura e esta no seHa encontra"a no 1/7% < ocorrncia KRM
Q A > ou seHa encontra"a ( !or?$ registra"a no co$o u$a estrutura <c(m&le$t%&e>(
< ocorrncia KRM Q ' > o 1/7% ? consi"era"o invG*i"o e o !rocesso "e gera+o ?
aborta"o co$ a $ensage$ aci$a i"enti#ican"o a estrutura !en"ente e$
K1/7%8EP)L3AI)M.
WSCE77> S WSDL i)v<&i'o ou )o
su%orta'o5
Reviso: 22/04/2004
Abrangncia
Verso 8.11
WSCE77> S WSDL i)v<&i'o ou )o su%orta'o5
Suan"o "este !rocessa$ento u$ !ar;$etro "e !ri$eiro nCve* <$essage> "o 1/7% #or
es!eci#ica"o se$ no$e o 1/7% ? consi"era"o invG*i"o e o !rocesso "e gera+o ?
aborta"o co$ a $ensage$ aci$a.
WSCE77D S WSDL i)v<&i'o ou )o
su%orta'o5
Reviso: 22/04/2004
Abrangncia
Verso 8.11
WSCE77D S WSDL i)v<&i'o ou )o su%orta'o5
Suan"o "este !rocessa$ento u$ !ar;$etro "e !ri$eiro nCve* <$essage> "o 1/7% #or
es!eci#ica"o se$ "e#ini+o "e ti!o o 1/7% ? consi"era"o invG*i"o e o !rocesso "e
gera+o ? aborta"o co$ a $ensage$ aci$a.
WSCE77E S etor)o N"LLPAAM
i)v<&i'o5
Reviso: 22/04/2004
Abrangncia
Verso 8.11
WSCE77E S etor)o N"LLPAAM i)v<&i'o5
Suan"o "este !rocessa$ento u$ !ar;$etro "e retorno "o 1/7% seHa i"enti#ica"o
co$o -retorno nu*o- o 1/7% ? consi"era"o invG*i"o e o !rocesso "e gera+o ?
WSCE77F S INTENAL EO TBV
Reviso: 2_/04/2004
WSCE77F S INTENAL EO TBV
)sta ? u$a ocorrncia "e erro interna "o -engine- "e gera+o "e c2"igo(#onte A"v!* no
re!ro"u0i"a at? o $o$ento. Suan"o "o !rocessa$ento "e u$ 1/7% os !ar;$etros e
$ensagens es!eci#ica"as no 1/7% so i"enti#ica"os interna$ente co$o !ar;$etros "e
entra"a !ar;$etro "e saC"a ou entra"a e sai"a. .aso a!2s a anG*ise inicia* "e
!ar;$etros a*gu$ !ar;$etro no seHa en@ua"ra"o nestas "e#ini+,es o !rocessa$ento
"e gera+o ? aborta"o co$ a ocorrncia aci$a.
WSCE787 S GST"CTUTCPEH
Estrutura S Ti%o i)c 555
Reviso: 22/04/2004
Abrangncia
Verso 8.11
WSCE787 S GST"CTUTCPEH Estrutura S Ti%o i)com%&eto
!ar;$etros e estruturas uti*i0a"as !e*os $?to"os "o servi+o at? @ue to"as as estruturas
Suan"o "este !rocessa$ento caso u$a estrutura co$!*e5a no contenha a
es!eci#ica+o "e seus e*e$entos internos e a $es$a no contenha nenhu$a re#erncia
ao /.J)IA ou N outra estrutura o 1/7% ? consi"era"o invG*i"o e o !rocesso "e
gera+o ? aborta"o co$ a $ensage$ aci$a in#or$an"o e$ 9/8R=.8L8EP): o no$e
"a estrutura inco$!*eta.
WSCE788 S etor)o N"LLPAAM
i)v<&i'o5
Reviso: 22/04/2004
Abrangncia
Verso 8.11
WSCE788 S etor)o N"LLPAAM i)v<&i'o5
Suan"o "este !rocessa$ento u$ !ar;$etro "e retorno "o 1/7% seHa i"enti#ica"o
co$o -retorno nu*o- o 1/7% ? consi"era"o invG*i"o e o !rocesso "e gera+o ?
Observao : )sta ocorrncia ? se$e*hante N ocorrncia 1/.)RR008 !or?$ esta
ocorrncia <011> re#ere(se N u$a sub(estrutura "o servi+o e a !ri$eira <008> re#ere(se N
u$ !ar;$etro / estrutura "e !ri$eiro nCve* "o servi+o.
WSCE789 S INTENAL EO TBV
Reviso: 2_/04/2004
Abrangncia
WSCE789 S INTENAL EO TBV
)sta ? u$a ocorrncia "e erro interna "o -engine- "e gera+o "e c2"igo(#onte A"v!* no
re!ro"u0i"a at? o $o$ento. Suan"o "o !rocessa$ento "e u$ 1/7% os !ar;$etros e
$ensagens es!eci#ica"as no 1/7% so i"enti#ica"os interna$ente co$o !ar;$etros "e
entra"a !ar;$etro "e saC"a ou entra"a e sai"a. .aso a!2s a anG*ise inicia* "e
!ar;$etros a*gu$ !ar;$etro no seHa en@ua"ra"o nestas "e#ini+,es o !rocessa$ento
"e gera+o ? aborta"o co$ a ocorrncia aci$a.
Observa+o : )sta ocorrncia ? se$e*hante N 1/.)RR00_ !ore$ esta in"ica u$a
#a*ha e$ outro !onto "a rotina interna "e anG*ise.
WSCE78: S GSOAPUTCPEH
"NEBPECTED TCPE5
Reviso: 22/04/2004
WSCE78: S GSOAPUTCPEH "NEBPECTED TCPE5
Suan"o "este !rocessa$ento u$ !ar;$etro "e ti!o bGsico no se encontre entre os
ti!os bGsicos su!orta"os !e*o engine -.*ient- "e 1eb/ervices "o Protheus a gera+o "o
#onte ? aborta"a co$ esta ocorrncia in"ican"o e$ /OAPL8EP) o ti!o no su!orta"o.

WSCE78; S IN!ALID N"LLPAAM
INIT
Reviso: 28/04/2004
Abrangncia
SCERRC@D E !"VAL!D "ULLPARA7 !"!T
Suan"o "este !rocessa$ento !ara ca"a !ro!rie"a"e "a estrutura "o servi+o so
$onta"as as rotinas "e inicia*i0a+o "e ca"a u$a "e*as. .aso a rotina "e gera+o "e
#onte receba a instru+o "e inicia*i0ar a !ro!rie"a"e reserva"a -3=%%PARAI- o
!rocessa$ento ? aborta"o co$ esta ocorrncia.
)sta ocorrncia !o"eria ser causa"a !or u$a #a*ha na va*i"a+o inicia* "o 1/7% ou
!e*a "ec*ara+o "e u$a !ro!rie"a"e "o ti!o -3=%%PARAI-P e at? o $o$ento no #oi
re!ro"u0i"a.
WSCE78= S No'e GBBBH as GCCCH o)
SOAP es% 555
Reviso: 28/04/2004
Abrangncia
SCERRC@F E "ode 4###5 as 42225 o% SOAP Res*o%se %ot -ou%d3
)sta ocorrncia ? re!ro"u0i"a @uan"o "a uti*i0a+o "e u$ #onte .*ient "e 1eb/ervices
no $o$ento @ue o c*ient estG "es$ontan"o o !acote /OAP retorna"o !e*o servi+o.
.aso o servi+o uti*i0e u$ s(a&/st%le RP. e o no"e 56667 corres!on"ente ao retorno
es!era"o "o ti!o 58887 no #or encontra"o no !acote o !rocessa$ento "o !acote "e
retorno ? aborta"o co$ esta ocorrncia.
)sta ocorrncia ? ca!tura"a !e*o !r2!rio #onte "o $?to"o sen"o @ue o $?to"o -.*ient-
cha$a"o retornarG .4. <#a*so> e a "escri+o "a ocorrncia "eve ser recu!era"a atrav!?s
"a #un+o Aet1/.)rror<>

WSCE78> S ePuisio #TTPS )o
su%orta'a 555
Reviso: 28/04/2004
Abrangncia
SCERRC@G E Re?uisi&'o >TTPS %'o su*ortada %este <uild3 4###5
-.*ient- uti*i0an"o o Protheus &7). Suan"o in#or$a"a u$a =R% !ara buscar a "e#ini+o
"o servi+o <1/7%> uti*i0an"o o !rotoco*o HPSP !or?$ o 'ui*" "o Protheus atua*
no su!orta o trata$ento "e Vebservices e$ HPS a gera+o "o c2"igo(#onte ?
aborta"a co$ esta ocorrncia "e erro.
Para gerar u$ #onte -.*ient- "e 1eb/ervices @ue uti*i0e o !rotoco*o HPS o 'ui*" "o
Protheus "eve ser atua*i0a"o.
WSCE78D S #TTPGSH etuisio
retor)ou GNILH
Reviso: 28/04/2004
Abrangncia
SCERRC@H E >TTP4S5 Re?uisi&'o retor%ou 4"!L5
"o servi+o <1/7%> uti*i0an"o o !rotoco*o HP (u HPSP e no #oi !ossCve* buscar
o *inX so*icita"o o !rocessa$ento ? aborta"o co$ a ocorrncia aci$a.
7entre as !ossCveis causas !ara esta ocorrncia !o"e$os consi"erar :
/inta5e "a =R% invG*i"a
/ervi"or invG*i"o ine5istente ou 734 no "is!onCve*
/ervi"or #ora "o ar
Veri#i@ue a =R% "igita"a e rea*i0e a re@uisi+o "a $es$a atrav?s "e u$ 1eb 'roVser
!ara certi#icar(se @ue a $es$a ? vG*i"a e @ue a "e#ini+o 1/7% estG rea*$ente
!ub*ica"a e acessCve* sob o *inX in#or$a"o.
WSCE78E S #TTPGSH ePuisio
retor)ou GEMPTCH
Reviso: 28/04/2004
Abrangncia
SCERRC@I E >TTP4S5 Re?uisi&'o retor%ou 4E7PT25
"o servi+o <1/7%> uti*i0an"o o !rotoco*o HP (u HPSP e no #oi !ossCve* buscar
o *inX so*icita"o o !rocessa$ento ? aborta"o co$ a ocorrncia aci$a.
7i#erente$ente "a ocorrncia 1/.)RR017 esta ocorrncia #oi re!ro"u0i"a @uan"o o
servi"or "e 1eb/ervices @ue #ornece o "ocu$ento 1/7% #oi *oca*i0a"o a re@uisi+o
#oi #eita co$ sucesso !or?$ o servi"or Protheus recebeu co$o retorno u$ !acote
J88P inco$!*eto ou invG*i"o.
Veri#i@ue a =R% "igita"a e rea*i0e a re@uisi+o "a $es$a atrav?s "e u$ 1eb 'roVser
!ara certi#icar(se @ue a $es$a ? vG*i"a e @ue a "e#ini+o 1/7% estG rea*$ente
!ub*ica"a e acessCve* sob o *inX in#or$a"o.
WSCE78F S TBBBV ArPuivo )o
e)co)tra'o5
Reviso: 28/04/2004
Abrangncia
SCERRC@J E K###L Ar?uivo %'o e%co%trado3
"o servi+o <1/7%> a!ontan"o !ara u$ ar@uivo no "iscoP !or?$ o ar@uivo no #oi
encontra"o o !rocessa$ento ? aborta"o co$ a ocorrncia aci$a.
7iret2rio no e5istente ou invG*i"o.
Ar@uivo no e5istente ou invG*i"o.
4a*ta "e !er$isso "e acesso No ar@uivo so*icita"o.
WSCE797 S T BBB S +EO CCC V
+a&ha 'e Abertura
Reviso: 28/04/2004
Abrangncia
1/.)RR020 / < RRR / 4)RROR EEE > 4a*ha "e Abertura.
"o servi+o <1/7%> a!ontan"o !ara u$ ar@uivo no "iscoP !or?$ houve u$a
i$!ossibi*i"a"e "e acesso No ar@uivo.
Ar@uivo aberto e$ $o"o e5c*usivo !or outra esta+o
4a*ha "e !er$isso / "ireito "e abertura "o ar@uivo
Veri#i@ue as !ro!rie"a"es e "ireitos "o ar@uivo so*icita"o e re!ita a o!era+o.

WSCE798 S GIN+OH WSDL Parsi)3
GPASEUWANIN*H
Reviso: 28/04/2004
Abrangncia
SCERRCM@ E 4!"FO5 SDL Parsi%8 4PARSERNAR"!"(5
"o servi+o <1/7%> a!2s o "ocu$ento 1/7% ser recu!era"o caso seHa "etecta"a
a*gu$a inconsistncia consi"era"a !e*o !arser interno "e 5$* "o Protheus co$o u$a
a"vertncia <<a"nin4> no "ocu$ento RI% o 1/7% ? consi"era"o invG*i"o e a
gera+o "o #onte ? cance*a"a co$ esta ocorrncia. )$ PAR/)RL1AR3&3A ?
"iscri$ina"a a $ensage$ "e a"vertncia "o !arser internoP e e$ 9&34O: ? es!eci#ica"o
o "ocu$ento / o!era+o @ue a!resentou a inconsistncia.

WSCE799 S GIN+OH WSDL Parsi)3
GPASEUEOH
Reviso: 28/04/2004
Abrangncia
SCERRCMM E 4!"FO5 SDL Parsi%8 4PARSERNERROR5
"o servi+o <1/7%> a!2s o "ocu$ento 1/7% ser recu!era"o caso seHa "etecta"a
a*gu$a inconsistncia consi"era"a !e*o !arser interno "e 5$* "o Protheus co$o erro
no "ocu$ento RI% o 1/7% ? consi"era"o invG*i"o e a gera+o "o #onte ? cance*a"a
co$ esta ocorrncia. )$ 9PARSER=ERR!R7 ? "iscri$ina"a a ocorrncia "e erro "o
!arser internoP e e$ 9IN0!: ? es!eci#ica"o o "ocu$ento / o!era+o @ue a!resentou a
inconsistncia.
WSCE79: S GIN+OH +AL#A
INESPEADA AO IMPOTA 55
Reviso: 28/04/2004
Abrangncia
SCERRCMO E 4!"FO5 FAL>A !"ESPERADA AO !7PORTAR SDL
"o servi+o <1/7%> a!2s o "ocu$ento 1/7% ser recu!era"o caso o "ocu$ento tenha
!assa"o !e*a eta!a "e va*i"a+o "o RI% on"e o "ocu$ento retorna"o constitui u$
RI% sinatica$ente vG*i"o !or?$ o !arser no i"enti#i@ue nenhu$a estrutura re#erente
a u$ "ocu$ento 1/7% o "ocu$ento ? consi"era"o invG*i"o e a gera+o "o #onte ?
cance*a"a co$ esta ocorrncia. )$ 9&34O: ? es!eci#ica"o o "ocu$ento / o!era+o @ue
a!resentou a inconsistncia.

WSCE79; S GMS*UIN+OH
MESSA*E )o e)co)tra'a5
Reviso: 28/04/2004
Abrangncia
SCERRCMD E 47S(N!"FO5 7ESSA(E %'o e%co%trada3
Suan"o "este !rocessa$ento caso u$a se+o "e $ensagens < messa4e > seHa
es!eci#ica"o !ara u$a o!era+o !or?$ no seHa encontra"o no 1/7% o $es$o ?
consi"era"o invG*i"o e o !rocesso "e gera+o ? aborta"o co$ a $ensage$ aci$a
i"enti#ican"o a $ensage$ no encontra"a e$ 9I/AL&34O:. .aso a in#or$a+o
9I/AL&34O: estiver va0ia o "ocu$ento 1/7% no es!eci#icou a*gu$a $ensage$ "e
!ar;$etro ou retorno na se+o K!ort8F!eM "a *ista "e $?to"os "o 1/7%.
WSCE79= S G6INDUIN+OH 6i)'i)3
)o E)co)tra'o5
Reviso: 28/04/2004
Abrangncia
SCERRCMF E 4<!"DN!"FO5 <i%di%8 %'o E%co%trado3
Suan"o "este !rocessa$ento caso u$a se+o "e as$arra+o < 3indin4 > no seHa
*oca*i0a"o !ara u$a o!era+o es!eci#ica"a no 1/7% e a $es$a no seHa encontra"a
no 1/7% o $es$o ? consi"era"o invG*i"o e o !rocesso "e gera+o ? aborta"o co$ a
$ensage$ aci$a i"enti#ican"o a $ensage$ no encontra"a e$ 9'&37L&34O:.
WSCE79> S TA*ETNAMESPACE
)o 'e(i)i'o )o WSDL5
Reviso: 28/04/2004
Abrangncia
SCERRCMG E TAR(ET"A7ESPACE %'o de-i%ido %o SDL3
Suan"o ? inicia"o este !rocessa$ento ? veri#ica"o se o "ocu$ento 1/7% cont?$ a
"e#ini+o "o NameS&ace "e "estino < a"4etNameS&ace > uti*i0a"o. .aso este no seHa
*oca*i0a"o o 1/7% ? consi"era"o invG*i"o e o !rocesso "e gera+o ? aborta"o co$ a
$ensage$ aci$a.
WSCE79D S GOPEUIN+OH
6IND:OPEATION )o e)c 555
Reviso: 28/04/2004
Abrangncia
SCERRCMH E 4OPERN!"FO5 <!"D0OPERAT!O" %'o e%co%trado3
Suan"o "este !rocessa$ento caso u$a o!era+o / $?to"o "o 1eb/ervice no seHa
encontra"a na se+o "e a$arra+o < 3indin4 > o "ocu$ento 1/7% ? consi"era"o
invG*i"o e o !rocesso "e gera+o ? aborta"o co$ a $ensage$ aci$a i"enti#ican"o a
o!era+o no encontra"a e$ 9!PER=IN0!:.
WSCE79E S GPOTUIN+OH PortTK%e
)o E)co)tra'o 55
Reviso: 28/04/2004
Abrangncia
SCERRCMI E 4PORTN!"FO5 PortT:*e %'o E%co%trado em aPort3
Suan"o "este !rocessa$ento caso u$a o!era+o / $?to"o "o 1eb/ervice no seHa
encontra"a na se+o "e !ortas "o 1/7% < P("t%&e > o "ocu$ento 1/7% ?
i"enti#ican"o a !orta no encontra"a e$ 9P!R=IN0!:.
WSCE79F S GPOTUIN+OH PortTK%e
)o co)t1m o%er55
Reviso: 28/04/2004
Abrangncia
SCERRCMJ E 4PORTN!"FO5 PortT:*e %'o co%t.m o*era&,es3
Suan"o "este !rocessa$ento caso u$a o!era+o / $?to"o "o 1eb/ervice no contenha
a "e#ini+o "as o!era+,es na se+o "e !ortas "o servi+o < P("t%&e > o "ocu$ento
1/7% ? consi"era"o invG*i"o e o !rocesso "e gera+o ? aborta"o co$ a $ensage$
aci$a i"enti#ican"o a !orta se$ "e#ini+o e$ 9POR8L&34O:.
WSCE7:8 S GSCT"CTUNAMEH Ti%o
sem NAMESPACE5
Reviso: 28/04/2004
Abrangncia
WSCE7:8 S GSCT"CTUNAMEH Ti%o sem NAMESPACE5
Suan"o "este !rocessa$ento caso i$a "eter$ina"a estrutura seHa i"enti#ica"a co$o
sen"o e5terna ao 1/7% atua* re#erencia"a !or u$ I#P!R ou RE0> se a estrutura
estiver "ec*ara"a no WSD2 se$ o re#eri"o na$es!ace o WSD2 ? consi"era"o invG*i"o
e o !rocesso "e gera+o ? aborta"o co$ a $ensage$ aci$a i"enti#ican"o a estrutura
inco$!*eta e$ 9SR1C=NA#E:
WSCE7:9 S GS#OTUNSH
NAMESPACE )o e)co)tra'o5
Reviso: 28/04/2004
Abrangncia
SCERRCOM E 4S>ORTN"S5 "A7ESPACE %'o e%co%trado3
Suan"o "o !rocessa$ento "e estruturas !en"entes i"enti#ica"as co$o sen"o e5ternas
ao 1/7% atua* es!eci#ica"as !or u$ I#P!R ou RE0 o na$es!ace "a $es$a "eve
estar "ec*ara"o no hea"er "o 1/7%. .aso e*e no seHa encontra"o o 1/7% ?
i"enti#ican"o o na$es!ace no encontra"o e$ 9/JOR8L3/:.
WSCE7:: S GLON*UNSH NameS%ace
sem Im%ort 'ec& 55
Reviso: 28/04/2004
Abrangncia
SCERRCOO E 4LO"(N"S5 "ameS*ace sem !m*ort declarado
.o$!*e$entar ao erro WSCE7:9 este ? re!ro"u0i"o @uan"o o na$es!ace
i"en#iica"o !ara o !ar;$etro seHa e5terno ao 1/7% !or?$ a =R% !ara !rocessa$ento
"o $es$o no seHa es!eci#ica"a atrav?s "e u$ Im&("t no 1/7% . 3este caso o 1/7%
? consi"era"o invG*i"o e o !rocesso "e gera+o ? aborta"o co$ a $ensage$ aci$a
i"enti#ican"o o na$es!ace no encontra"o e$ 92!N?=NA#ESPACE: .
WSCE7:; S GIN+OUNSH
NAMESPACE sem LOCATION 555
Reviso: 28/04/2004
Abrangncia
SCERRCOD E 4!"FON"S5 "A7ESPACE sem LOCAT!O" i%-ormado3
.o$!*e$entar ao erro 1/.)RR0DD este ? re!ro"u0i"o @uan"o a "ec*ara+o "a =R% /
%ocation "o NameS&ace e5terno no esteHa "ec*ara"o no KI#P!R...M "o 1/7% .
3este caso o "ocu$ento ? consi"era"o invG*i"o e o !rocesso "e gera+o ? aborta"o
co$ a $ensage$ aci$a i"enti#ican"o o na$es!ace inco$!*eto e$ 9&34OL3/: .
WSCE7:= S GTCPEH Ti%o i)'e(i)i'o5
Reviso: 28/04/2004
Abrangncia
SCERRCOF E 4T2PE5 Ti*o i%de-i%ido3
Suan"o "o !rocessa$ento "e estruturas !en"entes i"enti#ica"as co$o sen"o e5ternas
ao 1/7% atua* es!eci#ica"as !or u$ I#P!R ou RE0 o na$es!ace "a $es$a ?
i"enti#ica"o e i$!orta"o e to"o o 1/7% ? re(!rocessa"o. 3o re!rocessa$ento caso o
!ar;$etro / estrutura !en"ente no seHa encontra"o o 1/7% ? consi"era"o invG*i"o e o
!rocesso "e gera+o ? aborta"o co$ a $ensage$ aci$a i"enti#ican"o a estrutura
!en"ente e$ 58PE7
WSCE7:> S De(i)io )o su%orta'a5
Reviso: 28/04/2004
Abrangncia
SCERRCOG E De-i%i&'o %'o su*ortada3
!ar;$etros e estruturas uti*i0a"as !e*os $?to"os "o servi+o at? @ue to"as as estruturas
Suan"o "a va*i"a+o "e estruturas co$!*e5as caso a $es$a no !ossua ti!o "e#ini"o e
no seHa u$a re#erncia e5terna ao 1/7% e*a "eve ser u$a re#erncia ao !r2!rio
/.J)IA. .aso seHa es!eci#ica"a @ua*@uer outro ti!o "e re#erncia o 1/7% no ?
su!orta"o e o !rocesso "e gera+o ? aborta"o co$ a $ensage$ aci$a.
WSCE7:D S GTCPEH Estrutura
I)ter)a I)es%era'a5
Reviso: 28/04/2004
Abrangncia
SCERRCOH E 4T2PE5 Estrutura !%ter%a !%es*erada3
Suan"o "a va*i"a+o "e estruturas co$!*e5as caso a $es$a tenha !assa"o !or to"as as
inter!reta+,es cabCveis a u$a estrutura e $es$o assi$ no #oi !ossCve* i"enti#icG(*a o
aci$a i"enti#ican"o a estrutura e$ 98EP):.
WSCE7:E S GPAAMH WSDL
i)v<&i'o ou )o su%orta'o
Reviso: 28/04/2004
Abrangncia
SCERRCOI E 4PARA75 SDL i%v6lido ou %'o su*ortado3
Suan"o "a va*i"a+o "e estruturas co$!*e5as caso a $es$a tenha !assa"o !or to"as as
inter!reta+,es cabiveis "e u$a estrutura !or?$ seu no$e interno no #oi "ec*ara"o o
aci$a i"enti#ican"o o !ar;$etro "e orige$ "a $es$a e$ 9PARAI:.
WSCE7:F S ")e$%ecte' Dum%TK%e
GBH
Reviso: 28/04/2004
Abrangncia
SCERRCOJ E U%e/*ected Dum*T:*e 4#5
Suan"o "a uti*i0a+o "a #un+o RI%7ata/et !ara a inter!reta+o "e u$ obHeto "e
retorno RI% e$ #or$ato 7ata/et caso no seHa !assa"o u$ obHeto A"v!* "e ti!o
vG*i"o < ObHeto RI% ou ArraF > o !rocessa$ento ? aborta"o $ostran"o a $ensage$
aci$a i"enti#ican"o o ti!o "e !ar;$etro recebi"o e$ 9R:
Veri#i@ue o c2"igo(#onte "a a!*ica+o e ceriti#u@ue(se "e se$!re !assar u$ ObHeto
RI% ou ArraF !ara a #un+o RI%7ata/et<>
WSCE7;7 S ")e$%ecte' SC#EMA
TK%e GBH
Reviso: 28/04/2004
Abrangncia
SCERRCDC E U%e/*ected SC>E7A T:*e 4#5
Suan"o "a uti*i0a+o "a #un+o RI%7ata/che$a !ara "eter$inar os "a"os recebi"os
!or u$ retorno "e u$ 1eb /ervice @ue retorna u$a re#erncia ao /che$a e no seHa
!assa"o a #un+o u$ ObHeto A"v!* "e 8i!o VG*i"o < ObHeto R$* ou ArraF > o
!rocessa$ento ? aborta"o $ostran"o a $ensage$ aci$a i"enti#ican"o o ti!o "e
!ar;$etro recebi"o e$ 9R:
Veri#i@ue o c2"igo(#onte "a a!*ica+o e ceriti#u@ue(se "e se$!re !assar u$ ObHeto
RI% ou ArraF !ara a #un+o RI%7ata/che$a<>
WSCE7;8 S GNOTNILUMESSA*EH
Reviso: 28/04/2004
Abrangncia
SCERRCD@ E 4"OT"!LN7ESSA(E5
no $o$ento @ue o c*ient estG "es$ontan"o o !acote /OAP retorna"o !e*o servi+o.
7urante a "es$ontage$ "o !acote "e retorno "e u$ 1eb /ervice caso a*gu$
!ar;$etro obrigat2rio "o servi+o no esteHa !resente no !acote "e retorno o
!rocessa$ento ? aborta"o co$ a $ensage$ aci$a i"enti#ican"o e$
5N!NI2=#ESSA?E7 o !ar;$etro / !ro!rie"a"e @ue no veio !reenchi"a.
WSCE7;9 S "L LOCATION )o
es%eci(ica'a5
Reviso: 2_/04/2004
Abrangncia
SCERRCDM E URL LOCAT!O" %'o es*eci-icada3
antes "o envio "o !acote /OAP co$ o<s> !ar;$etro<s> "G a+o / $?to"o so*icita"o.
3o $o$ento "e !ostar o !acote /OAP "e !ar;$etros !ara u$ 1eb /ervice ? veri#ica"a
a !ro!rie"a"e reserva"a L=R% "o obHeto "o /ervi+o @ue cont?$ a =R% !ara !ostage$
"o !acote ao servi"or. .aso a $es$a esteHa va0ia o !rocessa$ento ? aborta"o co$ a
$ensage$ aci$a antes "a !ostage$ "os "a"os.
Veri#i@ue o c2"igo(#onte e certi#i@ue(se @ue caso a !ro!rie"a"e L=R% esteHa sen"o
re"e#ini"a a $es$a no esteHa va0ia. )sta !ro!rie"a"e HG ? a*i$enta"a auto$atica$ente
!e*o en4ine c*ient "e Vebservices "e acor"o co$ as in#or$a+,es !ara !ostage$ obti"as
no 1/7% uti*i0a"o !ara a gera+o "o #onte c*ient.
WSCE7;: S GSOAPUSTCLEH
SOAPSTCLE Desco)heci'o5
Reviso: 2_/04/2004
Abrangncia
SCERRCDO E 4SOAPNST2LE5 SOAPST2LE Desco%hecido3
antes "o envio "o !acote /OAP co$ o<s> !ar;$etro<s> "a a+o / $?to"o so*icita"o.
3o $o$ento "e !ostar o !acote /OAP "e !ar;$etros !ara u$ 1eb /ervice ?
veri#ica"o o #or$ato "o !acote /OAP a ser envia"o No c*ient. )sta !ro!rie"a"e ?
"e#ini"a e$ #onte no $o$ento "a gera+o "o #onte(c*ient e no "eve ser a*tera"a. .aso
a $es$a seHa a*tera"a $anua*$ente e no esteHa nu$ #or$ato vG*i"o o !rocessa$ento
? aborta"o co$ a $ensage$ aci$a antes "a !ostage$ "os "a"os in"ican"o e$
9/OAPL/8E%): o soa! stF*e invG*i"o in#or$a"o..
Veri#i@ue o c2"igo(#onte e certi#i@ue(se @ue o $es$o no #oi a*tera"o auto$atica$ente
!e*o engine c*ient "e Vebservices "e acor"o co$ as in#or$a+,es !ara !ostage$ obti"as
no 1/7% uti*i0a"o !ara a gera+o "o #onte c*ient.
WSCE7;; S No (oi %oss?ve& POST :
"L G"PUPOSTH
Reviso: 2_/04/2004
Abrangncia
SCERRCDD E "'o -oi *oss)vel POST 0 URL 4URPNPOST5
ao enviar o !acote /OAP co$ o<s> !ar;$etro<s> "a a+o / $?to"o so*icita"o.
A!2s $onta"o o !acote "e envio !ara a so*icita+o "e !rocessa$ento "o servi+o o
!acote ? !osta"o no servi"or in"ica"o na =R% es!ec#iica"a no servi+o. .aso o servi"or
"e "estino "o !acote no seHa *oca*i0a"o no 73/ ou no esteHa no ar o !rocessa$ento ?
aborta"o co$ a $ensage$ aci$a e a ur* "e "estino ? es!eci#iaca"a e$ 9=R%LPO/8:
WSCE7;= S etor)o !AWIO 'e POST
: "L @"LA 555
Reviso: 2_/04/2004
Abrangncia
SCERRCDF E Retor%o VA;!O de POST 0 URL PURLQ 4>EADERNRET5
ao enviar o !acote /OAP co$ o<s> !ar;$etro<s> "G a+o / $?to"o so*icita"o.
A!os $onta"o o !acote "e envio !ara a so*icita+o "e !rocessa$ento "o servi+o o
!acote ? envia"o a ur* "iscri$ina"a no servi+o. g
7i#erente$ente "a ocorrncia 1/.)RR014 esta ocorrncia !o"e ser re!ro"u0i"a
@uan"o o servi"or "e 1eb/ervices @ue aten"eu N re@uisi+o #oi *oca*i0a"o a re@uisi+o
#oi #eita co$ sucesso !or?$ o servi"or Protheus recebeu co$o retorno u$ !acote
J88P inco$!*eto ou invG*i"o ou ocorreu u$ erro interno no servi"or re#erencia"o no
hea"er "o !acote J88PP nestes casos o !rocessa$ento ? aborta"o co$ a ocorrncia
aci$a in#or$an"o e$ K=R%M o en"ere+o "o servi"or on"e o "a"o #oi !osta"o e se
"is!onCve* e$ J)A7)RLR)8 ? in#or$a"o o conteO"o "o Jea"er "e Retorno "o
J88P.
WSCE7;> S BML War)i)3
GBMLUWANIN*H T POST em 55
Reviso: 2_/04/2004
Abrangncia
SCERRCDG E #7L ar%i%8 4#7LNAR"!"(5 K POST em PURLQ L
ao !rocessar o !acote /OAP recebi"o co$o retorno "a a+o / $?to"o so*icita"o.
A!os $onta"o e envia"o o !acote "e envio !ara a so*icita+o "e !rocessa$ento "o
servi+o o !acote /OAP retorna"o !e*o servi+o ? ana*i0a"o !ara a a*i$enta+o "os
!ar;$etros A"v!* . .aso seHa "etecta"a a*gu$a inconsistncia consi"era"a !e*o !arser
interno "e 5$* "o Protheus co$o u$a a"vertncia <Varning> no "ocu$ento RI% o
!acote /OAP "e retorno ? consi"era"o invG*i"o e o !rocessa$ento ? aborta"o co$ esta
ocorrncia in#or$an"o e$ RI%L1AR3&3A a $ensage$ "e a"vertncia "o !arser
internoP e e$ K=R%M o servi"or "e 1eb/ervices @ue retornou o !acote.
WSCE7;D S BML Error
GBMLUEOH T POST em 555
Reviso: 2_/04/2004
Abrangncia
SCERRCDH E #7L Error 4#7LNERROR5 K POST em PURLQ L
A!os $onta"o e envia"o o !acote "e envio !ara a so*icita+o "e !rocessa$ento "o
servi+o o !acote /OAP retorna"o !e*o servi+o ? ana*i0a"o !ara a a*i$enta+o "os
!ar;$etros A"v!* . .aso seHa "etecta"a a*gu$a inconsistncia consi"era"a !e*o !arser
interno "e 5$* "o Protheus co$o u$ erro "e sinta5e no RI% o !acote /OAP "e
retorno ? consi"era"o invG*i"o e o !rocessa$ento ? aborta"o co$ esta ocorrncia
in#or$an"o e$ RI%L)RROR a $ensage$ "e erro "o !arser internoP e e$ K=R%M o
servi"or "e 1eb/ervices @ue retornou o !acote.
"a #un+o Aet1/.)rror<>. VeHa $aiores "eta*hes na #un+o Aet1/.)rror<> !ois
e*a o#erece a !ossibi*i"a"e "e recu!erar os e*e$entos !rinci!ais "e retorno "e u$ !acote
/OAPL4A=%8 iso*a"a$ente.
WSCE7;E S SOAP +A"LT
G+A"LTUCODEH T POST em 555
Reviso: 2_/04/2004
Abrangncia
SCERRCDI E SOAP FAULT 4FAULTNCODE5 K POST em PURLQ L 0
4FAULTNSTR!"(5
Ao ana*i0ar o !acote /OAP retorna"o !e*o servi+o !ara a a*i$enta+o "os !ar;$etros
A"v!* caso o !acote "e retorno contenha u$a e5cesso "o ti!o S!AP 0A12 isto
in"ica @ue houve u$a #a*ha "e !rocessa$ento "o servi+o no servi"or.
O !rocessa$ento ? aborta"o co$ esta ocorrncia in#or$an"o e$ 94A=%8L.O7): o
c2"igo "a e5cesso /OAP e$ K=R%M o servi"or "e 1eb/ervices @ue retornou o
!acote e e$ 4A=%8L/8R&3A $aiores "eta*hes sobre a ocorrncia.
WSCE7;F S SOAP ESPONSE
TPCV NOT +O"ND5
Reviso: 2_/04/2004
Abrangncia
SCERRCDJ E SOAP RESPO"SE KRPCL "OT FOU"D3
A"v!* caso o servi+o uti*i0e u$ s(a&St%le @ RPC e o no"e "e res!osta no seHa
encontra"o no !acote o !acote "e res!osta ? consi"era"o invG*i"o e o !rocessa$ento ?
cha$a"o retornarG .4. <#a*so> e a "escri+o "a ocorrncia "eve ser recu!era"a atrav?s "a
#un+o Aet1/.)rror<>
WSCE7=7 S SOAP ESPONSE E+
@NODEUE+A TPCV 555
Reviso: 2_/04/2004
Abrangncia
SCERRCFC E SOAP RESPO"SE REF P"ODENREFQ KRPCL "OT FOU"D3
A"v!* caso o servi+o uti*i0e u$ soa!/tF*e Q RP. e o no"e "e res!osta a!onte !ara un
outro no"e via re#erncia e este novo no"e no seHa encontra"o no !acote o !acote ?
consi"era"o invG*i"o e o !rocessa$ento ? aborta"o co$ a $ensage$ aci$a $ostran"o
o i"enti#ica"or "e re#erncia nao encontra"o e$ KN!DE=RE0M
#un+o Aet1/.)rror<>

WSCE7=8 S SOAP ESPONSE
ET"N TPCV NOT +O"ND5
Reviso: 2_/04/2004
Abrangncia
SCERRCF@ E SOAP RESPO"SE RETUR" KRPCL "OT FOU"D3
A"v!* caso o servi+o uti*i0e u$ s(a&St%le @ RPC e o no"e "e retorno no a!onte !ara
nenhu$a re#erncia o retorno "eve estar "entro "o RI% no nCve* "o no"e "e res!osta .
.aso o no"e "e retorno no seHa encontra"o neste nCve* o !acote "e retorno ?
consi"era"o invG*i"o e o !rocessa$ento ? aborta"o co$ a $ensage$ aci$a .
#un+o Aet1/.)rror<>
WSCE7=9 S E)umeratio) +AILED o)
GST"CTUTCPEH
Reviso: 2_/04/2004
Abrangncia
SCERRCFM E E%umeratio% FA!LED o% 4STRUCTNT2PE5
Antes "a $ontage$ "o !acote /OAP os !ar;$etros "o $?to"o / ac+o so*icita"a "o
servi+o so ana*i0a"os e va*i"a"os. .aso u$ !ar;$etro contiver u$a "e#ini+o "e
ènume"ati(na obti"a no 1/7% e #or a*i$enta"o !e*o #onte ec*ientf co$ u$ va*or @ue
no conste na *ista "e !ar;$etros vG*i"os o !rocessa$ento ? aborta"o co$ a $ensage$
aci$a i"enti#ican"o o !ar;$etro envo*vi"o e$ 5SR1C=8PE7
Veri#i@ue o c2"igo(#onte c*ient gera"o e$ a"v!* !ara obter a *ista "e !ar;$etros vG*i"oP
e certi#i@ue(se @ue o !ar;$etro es!eci#ica"o estG a*i$enta"o "e #or$a correta.
WSCE7=: S WSPC*etNo'e
TObXectV )ot (ou)'5
Reviso: 2_/04/2004
Abrangncia
SCERRCFO E SRPC(et"ode KObAectL %ot -ou%d3
A"v!* caso o servi+o uti*i0e u$ s(a&St%le @ RPC no $o$ento "e anG*ise "e u$
retorno "e u$a estrutura co$!*e5a caso o no"e corres!on"ente a estrutura no seHa
*oca*i0a"o no !acote "e retorno o $es$o ? consi"era"o invG*i"o e o !rocessa$ento ?
#un+o Aet1/.)rror<>
WSCE7=; S 6i)'i)3 SOAP )o
&oca&i.a'o )o WSDL5
Reviso: 2_/04/2004
Abrangncia
SCERRCFD E <i%di%8 SOAP %'o localiRado %o SDL3
-.*ient- uti*i0an"o o Protheus &7).
7urante a gera+o "o #onte u$a ve0 i"enti#ica"o o servi+o o gera"or "e c2"igo !rocura
a "ec*ara+o "as a$arra+,es "o servi+o <BINDIN?SL no 1/7%. 7entre as a$arra+,es
encontra"as a!enas so !rocessa"as a@ue*as @ue es!eci#ica$ o trans!orte "e "a"os !ara
o servi+o no #or$ato S!AP.
.aso no e5ista nenhu$a a$arra+o no servi+o @ue es!eci#i@ue a uti*i0a+o "o /OAP
o !rocesso "e gera+o "o #onte ec*ientf ? aborta"o retornan"o esta ocorrncia . A in#ra(
estrutura .*ient "e 1eb/ervices "o Protheus no su!orta a gera+o "e #ontes(c*ient "e
servi+os @ue no uti*i0e$ !acotes 6#2 / S!AP !ara a troca "e in#or$a+,es.
WSCE7== S I)va&i' Pro%ertK TK%e
TBV (or GPAAMH
Reviso: 2_/04/2004
Abrangncia
SCERRCFF E !%valid Pro*ert: T:*e K#L -or 4PARA75 K2L
Antes "a $ontage$ "o !acote /OAP os !ar;$etros "o $?to"o / a+o so*icita"a "o
servi+o so ana*i0a"os e va*i"a"os. As !ro!rie"a"es "a c*asse uti*i0a"as co$o
!ar;$etros "eve$ ser a*i$enta"as co$ os ti!os A"v!* a!ro!ria"os "e acor"o co$ sua
"e#ini+o. .aso u$a "eter$ina"a !ro!rie"a"e 5PARA#7 "o obHeto -.*ient- "o servi+o
esteHa a*i$enta"a co$ u$ ti!o "e "a"o A"v!* 567 !or?$ o ti!o es!era"o era 587 o
!rocessa$ento ? aborta"o co$ a ocorrncia "e erro aci$a.
Veri#i@ue o c2"igo(#onte c*ient gera"o e$ a"v!* e certi#i@ue(se @ue o !ar;$etro
es!eci#ica"o estG sen"o a*i$enta"o "e #or$a correta co$ o ti!o a!ro!ria"o.
WSCE7=> S I)va&i' BML-Soa%
Server es%o)se : 555
Reviso: 2_/04/2004
Abrangncia
SCERRCFG E !%valid #7L-Soa* Server Res*o%se 0 soa*-e%velo*e %ot -ou%d3
ao iniciar o !rocessa$ento "o !acote /OAP recebi"o co$o retorno "a a+o / $?to"o
so*icita"o.
Ao ana*i0ar o !acote /OAP retorna"o !e*o servi+o caso o $es$o no contenha u$
enve*o!e < s(a&/Envel(&e > "e res!osta o retorno ? consi"era"o inv!a*i"o e o
!rocessa$ento ? aborta"o co$ a $ensage$ aci$a .
#un+o Aet1/.)rror<>
WSCE7=D S I)va&i' BML-Soa%
Reviso: 2_/04/2004
Abrangncia
SCERRCFH E !%valid #7L-Soa* Server Res*o%se 0 soa*-e%velo*e em*t:3
so*icita"o.
Ao ana*i0ar o !acote /OAP retorna"o !e*o servi+o caso no seHa !ossCve* "eter$inar o
!re#i5o "o /OAP )nve*o!e uti*i0a"o o retorno ? consi"era"o invG*i"o e o
!rocessa$ento ? aborta"o co$ a $ensage$ aci$a .
#un+o Aet1/.)rror<>
WSCE7=E S I)va&i' BML-Soa%
Reviso: 2_/04/2004
Abrangncia
SCERRCFI E !%valid #7L-Soa* Server Res*o%se 0 !%valid soa*-e%velo*e
4SOAPNE"V5 obAect as valt:*e 4#5
so*icita"o.
Ao ana*i0ar o !acote /OAP retorna"o !e*o servi+o caso o s(a&/envel(&e "eter$ina"o
5S!AP=ENV7 es!era"o co$o u$ ObHeto #oi recebi"o co$ u$ ti!o A"v!* 567. &sto
inva*i"a o !acote soa! recebi"o sen"o o !rocessa$ento aborta"o co$ a ocorrncia
aci$a.
#un+o Aet1/.)rror<>
WSCE7=F S I)va&i' BML-Soa%
Reviso: 2_/04/2004
Abrangncia
SCERRCFJ E !%valid #7L-Soa* Server Res*o%se 0 soa*-bod: %ot -ou%d3
so*icita"o.
/e$e*hante a ocorrncia 1/.)RR0UT esta ocorrncia in"ica @ue no #oi !ossCve*
"eterr$inar o cor!o <s(a&/3(d%> "o !acote /OAP retorna"o !e*o servi+oP o @ue inva*i"a
o !acote "e retorno sen"o o !rocessa$ento aborta"o co$ esta ocorrncia "e erro.
#un+o Aet1/.)rror<>
WSCE7>7 S I)va&i' BML-Soa%
Reviso: 2_/04/2004
Abrangncia
SCERRCGC E !%valid #7L-Soa* Server Res*o%se 0 soa*-bod: e%velo*e em*t:3
so*icita"o.
/e$e*hante a ocorrncia 1/.)RR0U7 esta ocorrncia in"ica @ue !acote /OAP
retorna"o no #oi !ossCve* "eter$inar o !re#i5o "o coro! <s(a&/3(d%> uti*i0a"oP o @ue
inva*i"a o !acote "e retorno sen"o o !rocessa$ento aborta"o co$ esta ocorrncia "e
erro.
#un+o Aet1/.)rror<>
Reviso: 2_/04/2004
Abrangncia
SCERRCG@ E !%valid #7L-Soa* Server Res*o%se 0 !%valid soa*-bod: 4<OD25
obAect as valt:*e 4T2PE5
so*icita"o.
/e$e*hante a ocorrncia 1/.)RR0U8 esta ocorrncia in"ica @ue no S!AP retorna"o
o cor!o <s(a&/3(d%> "eter$ina"o 5B!D87 es!era"o co$o u$ ObHeto #oi recebi"o
co$o u$ ti!o A"v!* 58PE7 P o @ue inva*i"a o !acote "e retorno sen"o o
!rocessa$ento aborta"o co$ esta ocorrncia "e erro.
#un+o Aet1/.)rror<>
Reviso: 2_/04/2004
Abrangncia
SCERRCGM E !%valid #7L-Soa* Server Res*o%se 0 U%able to determi%e Soa*
Pre-i/ o- E%velo*e 4SOAPNE"V5
ao iniciar o !rocessa$ento "o !acote S!AP recebi"o co$o retorno "a a+o / $?to"o
so*icita"o.
)sta ocorrncia in"ica @ue no S!AP retorna"o o enve*o!e <s(a&/envel(&e>
"eter$ina"o 5S!AP=ENV7 no estG e$ u$ #or$ato @ue seHa !ossCve* "eter$inar o
no$e "o enve*o!eP o @ue inva*i"a o !acote "e retorno sen"o o !rocessa$ento aborta"o
co$ esta ocorrncia "e erro.
#un+o Aet1/.)rror<>
WSCE7>: S Ar3ume)t error : Missi)3
(ie&' GNODEH
Reviso: 2_/04/2004
Abrangncia
SCERRCGO E Ar8ume%t error 0 7issi%8 -ield 4"ODE5 as 4T2PE5
ao iniciar a $ontage$ "o !acote /OAP co$ os !ar;$etros !ara a cha$a"a "o servi+o.
)sta ocorrncia in"ica @ue o !ar;$etro obrigat2tio "eter$ina"o e$ 93O7): co$ o
ti!o 98EP): no #oi a*i$enta"o !ara a cha$a"a "a #un+o ec*ientf. )sta ocorrncia
inva*i"a a $ontage$ "o !acote "e envio abortan"o o !rocessa$ento antes "o envio "o
!acote co$ esta ocorrncia.
#un+o Aet1/.)rror<>

WSCE7>; S I)va&i' Co)te)t-TK%e
retur) T#TTPU#EAD
Reviso: 2_/04/2004
Abrangncia
SCERRCGD E !%valid Co%te%t-T:*e retur% K>TTPN>EADL -rom PURLQ
ao !rocessar o !acote /OAP recebi"o co$o retorno "a a+o / $?to"o so*icita"o. A!2s
$onta"o e envia"o o !acote "e envio !ara a so*icita+o "e !rocessa$ento "o servi+o o
!acote /OAP retorna"o !e*o servi+o ? ana*i0a"o !ara a a*i$enta+o "os !ar;$etros
A"v!* .
)sta ocorrncia in"ica @ue o hea"er J88P "e retorno "o servi+o !osta"o e$ K=R%M
veio co$ o conteO"o "o hea"er J88P retorna"o !e*o servi"or in"ica o uso "e c(ntent/
t%&e "i#erente "e 6#2 o @ue inva*i"a o !rocessa$ento "o retorno. =$ 1eb /ervice
ec*ientf se$!re es!era !or u$ !acote "e retorno co$ u$ -C(ntent/t%&eA te$tB$ml- "e u$
1eb /ervices /)RV)R.
#un+o Aet1/.)rror<>
)sta ocorrncia nor$a*$ente ? re!ro"u0i"a @uan"o u$ "eter$ina"o 1eb/ervice no
estG $ais !ub*ica"o no en"ere+, es!eci#ica"o !or?$ a ur* ain"a ? vG*i"a. 7e $o"o @ue
ao receber a re@uisi+o o servi"or "evo*ve u$a !Ggina H#2 co$ u$a $ensage$ "o
ti!o -Pa4e n(t 0(und-.
WSCE7>= S EMPTC Co)te)t-TK%e
retur) T#EADEV 555
Reviso: 2_/04/2004
Abrangncia
SCERRCGF E E7PT2 Co%te%t-T:*e retur% K>EADERL -rom PURLQ
/e$e*hante a ocorrncia 1/.)RR0T4 esta ocorrncia in"ica @ue a!2s a !ostage$ "e
u$ !acote /OAP ao servi"or "e "estino "o 1eb/ervice e$ K=R%M o conteO"o "o
hea"er Jtt! retorna"o <J)A7)R> retorna"o !e*o servi"or no !ossuCa a i"enti#ica+o
"o C(ntent/%&e) o @ue inva*i"a o !rocessa$ento "e retorno. O c*ient A"v!* se$!re
es!era !or u$ !acote "e res!osta co$ u$ c(ntent/t%&eA te$tB$ml co$o retorno.
#un+o Aet1/.)rror<>
WSCE7>> S I)va&i' IN!ALID WSDL
Co)te)t-TK%e T555
Reviso: 2_/04/2004
Abrangncia
SCERRCGG E !%valid !"VAL!D SDL Co%te%t-T:*e K>TTPN>EADL -rom PURLQ
)sta ocorrncia in"ica @ue o hea"er J88P "e retorno "a re@uisi+o "o 1/7%
so*icita"o no en"ere+o K=R%M veio i"enti#ican"o u$ ti!o "e "ocu$ento <c(ntent/t%&e>
"i#erente "e te5t!/!*ain ou te5t/5$* o @ue inva*i"a o !rocessa$ento "o retorno. =$
1eb /ervice ec*ientf se$!re es!era !or u$ !acote "e retorno co$ u$ -.ontent(tF!e:
te5t/5$*- ou -te5t/!*ain- "e u$ 1eb /ervices /)RV)R.
)sta ocorrncia nor$a*$ente ? re!ro"u0i"a @uan"o u$ "eter$ina"o 1eb/ervice no
estG $ais !ub*ica"o no en"ere+o es!eci#ica"o !or?$ o servi+o "e htt! ain"a estG ativo
no servi"or so*icita"o. 7e $o"o @ue ao receber a re@uisi+o o servi"or "evo*ve u$a
!Ggina J8I% co$ u$a $ensage$ "o ti!o -Page not 4oun"-.
WSCE7>D S EMPTC WSDL Co)te)t-
TK%e T#TTPU#EADV
Reviso: 2_/04/2004
Abrangncia
SCERRCGH E E7PT2 SDL Co%te%t-T:*e K>TTPN>EADL -rom PURLQ
)sta ocorrncia in"ica @ue o hea"er J88P "e retorno "o 1/7% so*icita"o atrav?s "o
*inX K=R%M veio co$ o conteO"o "o hea"er J88P se$ a in#or$a+o "o ti!o "e
conteO"o "o "ocu$ento <c(ntent/t%&e>. =$ "ocu$ento 1/7% "eve ser retorna"o !e*o
servi"or "e 1eb/ervices in#or$an"o no hea"er J88P u$ ti!o "e "ocu$ento <c(ntent/
t%&e> "e#ini"o co$o te$tB&lain ou te$tB$ml
WSCE7>E S NOT BML SO"CE
(rom @"LA
Reviso: 2_/04/2004
Abrangncia
SCERRCGI E "OT #7L SOURCE -rom PURLQ
)sta ocorrncia in"ica @ue o "ocu$ento retorna"o !e*o servi"or "e Vebservices no se
trata "e u$ RI% vG*i"o !ara ser ana*i0a"o. O "ocu$ento 1/7% "eve se$!re iniciar
co$ o no"e "a "ec*ara+o "o RI% < PS#7L ...> . .aso no !ossua esta in#or$a+o o
!ri$eiro no"e "eve obrigatoria$ente ser a "e#ini+o "o servi+o < PDEF!"!T!O"S >. /e
o "ocu$ento 1/7% retorna"o no aten"er N estes re@uisitos o !rocessa$ento ?
WSCE7>F S 6CE+ GPAAMH WIT#
NO INP"T A*"MENT :
Reviso: 2_/04/2004
Abrangncia
SCERRCGJ E <2REF 4PARA75 !T> "O !"PUT AR(U7E"T 0
U"SUPPORTED E<SERV!CE
Suan"o "a gera+o "o #onte caso o 1/7% retorna"o in#or$e u$ $?to"o "e 1eb
/ervices @ue !ossua $ais "e u$ !ar;$etro "e retorno isto caracteri0a u$ $?to"o @ue
traba*ha co$ !ar;$etros !or re#erncia <B8RE0>. 3este caso a!2s o cru0a$ento "os
retornos "o $?to"o co$ os !ar;$etros "eve restar no $G5i$o u$ retorno. .aso
$es$o assi$ reste $ais "e u$ retorno o 1/7% ? consi"era"o invG*i"o sen"o o
!rocesso "e gera+o aborta"o co$ a $ensage$ "e erro aci$a in#or$an"o e$
9PARAI: o retorno e5ce"ente @ue "everia ser *oca*i0a"o nos !ar;$etros.
WSCE7D7 S ePuisio #TTPS )o
su%orta'a )este55
Reviso: 2_/04/2004
Abrangncia
SCERRCHC E Re?uisi&'o >TTPS %'o su*ortada %este <U!LD
4PROT>EUSN<U!LD5
3o $o$ento "e !ostar o !acote /OAP "e !ar;$etros !ara u$ 1eb /ervice ?
veri#ica"o se o !rotoco*o e$ uso ? o J88P/P e se o $es$o HG ? su!orta"o !e*o 'ui*"
atua* "o servi"or Protheus e$ uso.
Veri#i@ue o c2"igo(#onte e certi#i@ue(se @ue caso a !ro!rie"a"e L=R% esteHa sen"o
re"e#ini"a a $es$a no esteHa sen"o re"e#ini"a !ara u$ en"ere+, uti*i0an"o J88P/.
.aso a !ro!rie"a"e L=R% no esteHa sen"o re("e#ini"a e o servi+o so*icita"o e5iga o
envio "os "a"os atrav?s "e J88P/ o bui*" "o servi"or Protheus "eve ser atua*i0a"o.
WSCE7D8 S IN!ALID #TTP
#EADE T#TTP#EADV (rom555
Reviso: 2_/04/2004
Abrangncia
SCERRCH@ E !"VAL!D >TTP >EADER K>TTP>EADL -rom PURLQ
Suan"o "a gera+o "e .2"igos #onte A"v!* caso o servi"or in#or$a"o acessa"o via
=R% retorne u$ !acote J88P co$ u$ hea"er "e retorno @ue no seHa i"enti#ica"o
co$o J88P o !rocesso "e gera+o ? aborta"o co$ a ocorrncia aci$a in#or$an"o e$
<,tt&,ead> o hea"er in#or$a"o e e$ <u"l> o en"ere+o in#or$a"o !ara a so*icita+o
"o 1/7%.
7entre as !ossCveis causas !o"e$os consi"erar @ue a =R% in#or$a"a no corres!on"e
a u$ servi"or J88P ou "e 1)' /)RV&.)/. Para certiticar(se "a ocorrncia abra a
=R% es!eci#ica"a uti*i0an"o u$ 1eb 'roVser.
WSCE7D9 S #TTP EJ"EST
EO T#EADEV (rom @"LA
Reviso: 2_/04/2004
Abrangncia
SCERRCHM E >TTP RE9UEST ERROR K>EADERL -rom PURLQ
Suan"o "a gera+o "e .2"igos #onte A"v!* caso o servi"or in#or$a"o acessa"o via
=R% retorne u$ !acote J88P co$ u$ hea"er "e retorno J88P !or?$ co$ u$ satus
"i#erente "e 200 <OW> o !rocesso "e gera+o ? aborta"o co$ a ocorrncia aci$a
in#or$an"o e$ KHEADERM a !ri$eira *inha "o cabe+a*ho J88P retorna"o e e$ Kur*M
o en"ere+o in#or$a"o !ara a so*icita+o "o 1/7%.
7entre as !rovGveis causas !o"e$os consi"erar os status "e retorno -40D 4orbi""en-
retorna"os !or Pro5Fs @ue re@uere$ autenti0a+o ou no !er$ite$ o acesso N ur*
es!eci#ica"a o -U00 &nterna* /erver )rror- @ue in"ica u$a ocorrncia interna "e erro no
servi"or @ue i$!ossibi*itou o retorno "o 1/7%.
WSCE7D: S 6ui&' T6"ILDV BML
I)ter)a& Error
Reviso: 2_/04/2004
Abrangncia
SCERRCHO E <uild K<U!LDL #7L !%ter%al Error
O !acote /OAP retorna"o !e*o servi+o ? ana*i0a"o !ara a a*i$enta+o "os !ar;$etros
A"v!*. e$ !ri$eiro $o$ento so rea*i0a"as as consistncias "e cabe+a+ho "e
!rotoco*o <hea"er> e e$ segui"a o !acote /OAP ? "es$onta"o !or u$ !arser interno
"o Protheus on"e ? veri#ica"a a sinta5e "o "ocu$ento RI% < VeHa ocorrncias
1/.)RR04T e 1/.)RR047 > e a resu*tante "este !rocesso serG u$ obHeto
inter$e"iGrio.
/e e so$ente se o conteO"o /OAP retorna"o !e*o servi+o contenha u$ erro estrutura*
ou sintGtico @ue no seHa "etecta"o !e*o !arser interno co$o u$ erro ou
a"vertncia este obHeto inter$e"iGrio no ? gera"o o @ue i$!ossibi*ita a rotina "e
!rosseguir o !rocessa$ento. )sta ocorrncia HG #oi re!ro"u0i"a anterior$ente e$ bui*"s
"o Protheus anteriores N 7e0e$bro/200D. )$ re*eases !osteriores a este o trata$ento
"os !acotes "e retorno "o servi+o #oi revisa"oP "es"e ento esta ocorrncia no $ais #oi
re!ro"u0i"a.
WSCEINT S
GEOUDESCIPTIONH
Reviso: 2_/04/2004
Abrangncia
SCERR!"T E 4ERRORNDESCR!PT!O"5
Suan"o e5ecuta"o u$ $?to"o -.*ient- "e 1eb/ervices as ocorrncias "e #a*ha "entro
"estas Vorinas so !rotegi"as !or u$ trata$ento "e erro e5c*usivo @ue in#or$a
"eta*hes "a ocorrncia.
/e e so$ente se o trata$ento "e erro #or aciona"o !or u$a ocorrncia ines!era"a e$
a*gu$ !onto "o !rocessa$ento "o $?to"o "a c*asse .*ient a "escri+o "a ocorrncia "e
erro ? ca!tura"a e $ostra"a e$ K)RRORL7)/.R&P8&O3M e a ocorrncia ?
!re#i5a"a co$ o c2"igo 1/.)RR&38 < We3 Se"vices Client Inte"nal E""(" >
.aso seHa re!ro"u0i"a esta ocorrncia veri#i@ue os !ar;$etros in#or$a"os No $?to"o
cha$a"o e certi#i@ue(se @ue o c2"igo #onte "a c*asse -.*ient- e$ A"v!* no so#reu
nenhu$a a*tera+o $anua* a!2s a gera+o "o !r2!rio.
Termi)o&o3ias S *&oss<rio
Reviso: 28/04/2004
Abrangncia
WSDL : < We3 Se"vices Desc"i&ti(n 2an4ua4e > : 8rata(se "e u$ "ocu$ento e$
#or$ato "e acor"o co$ as "e#ini+,es "e 1eb /ervices atrav?s "o @ua* u$ !rove"or "e
u$ servi+o !rov a "iscri$ina+o "eta*ha"a "as #unciona*i"a"es "e u$ servi+o. )ste
"ocu$ento e$ gera* ? #orneci"o atrav?s "e u$a =R% a!ontan"o !ara o servi"or @ue
!rov o servi+o. =ti*i0an"o este "ocu$ento o Protheus ? ca!a0 "e gerar
auto$atica$ente u$ -4onte .*ient- !ara estabe*ecer a cone5o e uti*i0a+o "o servi+o
atrav?s "a gera+o "e u$a c*asse -.*ient- e$ A"v!*.
Web Service 4C&ie)t4 : A!*ica+o "esenvo*vi"a N !artir "e u$a "e#ini+o <1/7%>
!ub*ica"a e "is!onibi*i0a"a !or u$a a!*ica+o -/erver-.
Web Service 4Server4 : A!*ica+o "esenvo*vi"a !ara tornar "is!onCve* u$ recurso
!rocessa$ento ou in#or$a+o Hunta$ente co$ sua "e#ini+o <1/7%> !ara tornar
!ossCve* o "esenvo*vi$ento "e u$a a!*ica+o -.*iente- @ue irG so*icitar a e5ecu+o "a
a!*ica+o e$ si.
4+o)te C&ie)t4 : .2"igo #onte A"v!* gera"o !e*a #erra$enta "o &7) -Aerar .*iente
1eb/ervices...- a !artir "e u$a "e#ini+o 1/7% !ub*ica"a e$ u$ servi"or J88P ou
"is!onibi*i0a"a e$ u$ ar@uivo .1/7%.
4Ti%o b<sico4 : /o cha$a"os "e ti!os bGsicos u$a *ista "e ti!os "e
in#or$a+,es -nativa- i$!*e$enta"a na "e#ini+o "os 1eb/ervices.
4Estrutura4 : b cha$a"a "e estrutura u$a c*asse inter$e"iGria "e "a"os !ara 1eb
/ervices cuHa #un+o ? "e#inir u$a in#or$a+o @ue consiste no agru!a$ento "e outras
in#or$a+,es e/ou estruturas.

Advpl - WebServices Com Protheus

Enviado por

Dados do documento

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Advpl - WebServices Com Protheus

Enviado por

Direitos autorais:

Formatos disponíveis

Web Services com Protheus

Você também pode gostar