Hi Simon,

It doesn't say *that* in so many words, it's just a consequence of the 
nesting of the soap:headerfault within the soap:header element with which it 
is associated. If I've defined header extension <foo>  for use in a request 
message, and a result of processing <foo>  may be the generation of a fault 
message header entry <foo_fault> , then the <foo_fault> declaration will be 
contained within the <foo>  declaration (found in the <input> element). It's 
just a way of saying "if <foo>  processing results in a fault by the recipient, 
then expect to see a header entry in the fault message (response) called 
<foo_fault>  which will contain the relevant details for consideration by the 
client". In this way the mapping between header entries in request 
messages and their corresponding fault header entries can be neatly 
represented in the WSDL. The WSDL spec says [1]:
"The SOAP specification states that errors pertaining to headers must be 
returned in headers, and this mechanism allows specification of the 
format of such headers."

Of course these fault headers would be contained in the fault reponse 
message. The <output>  element contains header and body declarations for 
the normal response message case, as opposed to the fault message case.

Does this make sense?

RC

[1] http://www.w3.org/TR/wsdl#_soap:header

>  Hi Bob.
>  Where does the WSDL spec say that a soap:headerfault will be "contained
>  within the <input>element in the binding"?
>  Did I overlook something?
>  
>  In sections http://www.w3.org/TR/wsdl#_soap:header and
>  http://www.w3.org/TR/wsdl#_how-s, the WSDL spec shows that a
>  soap:headerfault element can be present within soap:header elements defined
>  within a /wsdl:definitions/wsdl:binding/wsdl:operation/wsdl:input or a
>  /wsdl:definitions/wsdl:binding/wsdl:operation/wsdl:output.
>  
>  Because a soap:headerfault is describing part of the message that will go
>  back as output, then could it be argued that it should be contained within
>  the <output>element in the binding?
>  
>  Si.
>  
>  ----- Original Message -----
>  From: "Bob Cunnings" <cunnings@[...].com>
>  To: <wsdl@[...].com>
>  Sent: Thursday, December 06, 2001 4:20 PM
>  Subject: Re: [wsdl] Where to put headerfaults in the SOAP Binding
>  
>  
>  > Hi,
>  >
>  > Yes, the fault header entries are declared using soap:faultheader
>  > elements nested within the request header declaration with which
>  > they are associated, so this will all be contained within the <input>
>  > element in the binding. Here is an example:
>  >
>  > http://www.whitemesa.net/wsdl/std/soapauthtest.wsdl
>  >
>  > RC
>  >
>  > >
>  > > I have a web service which accepts some information in the SOAP header
>  and
>  > > may return some errors based on these values. I want to describe this
>  using
>  > > WSDL.
>  > >
>  > > I can describe the SOAP header using a <soap:header> element within the
>  > > <input> element of the SOAP Binding. However, the implications of the
>  > > following text from the spec seem a little strange:
>  > >
>  > > The optional headerfault elements which appear inside soap:header
>  > > and have the same syntax as soap:header) allows specification of
>  > > the header type(s) that are used to transmit error information
>  > > pertaining to the header defined by the soap:header. The SOAP
>  > > specification states that errors pertaining to headers must be
>  > > returned in headers, and this mechanism allows specification of
>  > > the format of such headers.
>  > >
>  > > If the headerfaults must be defined within the header that they relate
>  to,
>  > > does this mean that the errors returned by the web service should be
>  defined
>  > > within the <soap:header> element of the request message? That would
>  imply
>  > > that the header faults that may appear in the output message are defined
>  > > within the <input> element.
>  > >
>  > > James.
>  > >
>  > >
>  > > Cape Clear Software Limited.
>  > > 61 Fitzwilliam Lane
>  > > Dublin 2
>  > > Ireland
>  > >
>  > > Email : james.pasley@[...].com
>  > > Switchboard  : + 353 (1) 2419900
>  > > Direct line  : + 353 (1) 2419957
>  > > Fax          : + 353 (1) 2419901
>  > > www          : www.capeclear.com
>  > >
>  > >
>  > >
>  > >
>  > > To unsubscribe from this group, send an email to:
>  > > wsdl-unsubscribe@[...].com
>  > >
>  > >
>  > >
>  > > Your use of Yahoo! Groups is subject to
>  http://docs.yahoo.com/info/terms/
>  > >
>  >
>  >
>  >
>  > To unsubscribe from this group, send an email to:
>  > wsdl-unsubscribe@[...].com
>  >
>  >
>  >
>  > Your use of Yahoo! Groups is subject to http://docs.yahoo.com/info/terms/
>  >
>  >
>  
>  
>  
>  
>  
>  
>  To unsubscribe from this group, send an email to:
>  wsdl-unsubscribe@[...].com
>  
>   
>  
>  Your use of Yahoo! Groups is subject to http://docs.yahoo.com/info/terms/ 
>  



------------------------ Yahoo! Groups Sponsor ---------------------~--> 
Break free. Great
American Smokeout
http://us.click.yahoo.com/3vN8tD/.pSDAA/ySSFAA/W6uqlB/TM
---------------------------------------------------------------------~-> 

To unsubscribe from this group, send an email to:
wsdl-unsubscribe@[...].com

 

Your use of Yahoo! Groups is subject to http://docs.yahoo.com/info/terms/