SOAP_CALLIN_POST
Operation that is called after the target web service operation has executed.
operation SOAP_CALLIN_POST params string Envelope: INOUT ; or IN endparams Your Code here ... end; operation SOAP_CALLIN_POST
Parameters
Envelope—content of the SOAP envelope.
Return Values
| Value | Meaning |
|---|---|
| 0 | Operation succeeded and processing can
continue. The Envelope parameter contains a valid SOAP envelop that Uniface can
successfully parse and understand. If SOAP_CALLIN_POST returns success but still returns a SOAP fault envelope, the fault is returned as an HTTP 200 status message. |
| <0 | Operation failed to successfully process the SOAP envelope. A SOAP fault is returned in an HTTP status 500 message, and the call-in procedure stops. |
For more information, see SOAP Faults.
Description
You can implement the SOAP_CALLIN_POST operation in the web service itself or in a separate Uniface service. It is only called if the assignment file of the Uniface Server handling SOAP requests (by default the wasv.asn file) includes the $SOAP_CALLIN_CB setting.
If you are only using SOAP_CALLIN_POST to validate the SOAP envelope, you can specify the first parameter as an IN parameter instead of an INOUT parameter.
The names of the parameters are optional. Any other change to the interface, such as additional parameters or a different operation name, cause the operation to fail.
For information on generating SOAP faults when an error is detected, see SOAP Faults in Web Services Call-In.
