SET WEB SERVICE PARAMETER

4D - Documentation   Français   English   German   4th Dimension 2004, Command Theme List   4th Dimension 2004, Command Alphabetical List   4th Dimension 2004, Constant Theme List   Back   Previous   Next

version 2003


SET WEB SERVICE PARAMETER (name; value{; soapType})

ParameterTypeDescription
nameStringName of parameter to include in SOAP request
valueVariable4D variable containing the value of the parameter
soapTypeStringSOAP type of the parameter

Description

The SET WEB SERVICE PARAMETER command enables the definition of a parameter used for a client SOAP request. Call this command for each parameter in the request (the number of times the command is called depends on the number of parameters).

In name, pass the name of the parameter as it must appear in the SOAP request.

In value, pass the 4D variable containing the value of the parameter. In the case of proxy methods, this variable is generally $1, $2, $3, etc., corresponding to a 4D parameter passed to the proxy method when it was called. It is, however, possible to use intermediary variables.

Note: Each 4D variable or array used must first be declared using the commands of the "Compiler" and "Arrays" themes.

By default, 4th Dimension automatically determines the most appropriate SOAP type for the name parameter according to the content of value. The indication of the type is included in the request.

However, you may want to "force" the definition of the SOAP type of a parameter. In this case, you can pass the optional soapType parameter using one of the following character strings (primary data types):

soapTypeDescription
stringString
intLongint
booleanBoolean
float32-bit real
decimalReal with decimal
double64-bit real
durationDuration in years, months, days, hours, minutes, seconds, for example
P1Y2M3DT10H30M
datetimeDate and time in ISO8601 format, for example 2003-05-31T13:20:00
time Time, for example 13:20:00
date Date, for example 2003-05-31
gyearmonthYear and month (Gregorian calender), for example 2003-05
gyearYear (Gregorian calender), for example 2003
gmonthdayMonth and day (Gregorian calender), for example --05-31
gday Day (Gregorian calender), for example ---31
gmonthMonth (Gregorian calender), for example --10--
hexbinaryValue expressed in hexadecimal
base64binaryBLOB
anyuriUniform Resource Identifier (URI), for example
http://www.company.com/page
qnameQualified XML name (namespace and local part)
notationNotation attribute

Note: For more information about XML data types, refer to the URL http://www.w3.org/TR/xmlschema-2/

Example

This example defines two parameters:

   C_TEXT($1)
   C_TEXT($2)
   SET WEB SERVICE PARAMETER("city";$1)
   SET WEB SERVICE PARAMETER("country";$2)

See Also

CALL WEB SERVICE, GET WEB SERVICE RESULT.


4D - Documentation   Français   English   German   4th Dimension 2004, Command Theme List   4th Dimension 2004, Command Alphabetical List   4th Dimension 2004, Constant Theme List   Back   Previous   Next