An HTTP Request Argument is a child definition to the XML via HTTP step definition, defining the data values passed as arguments to the parent step’s defined URL. Included in the request argument definition is the type of request and the property value or other data value in scope for the step to be passed as the argument. Request arguments also have a data type, which specifies the source for the argument’s data.
A request argument is defined for the parent step only when it is necessary to pass arguments to the step’s defined URL request. The request allows for access to the property values of the definition for which the step was defined, as well as values at the user or application level via the SDML. A fixed string value may also be defined to passed as the argument.
The values accessed via the SDML can be contained in either a small or large markup value. Both allow for the use of HTML markup text. The difference between these two items is the manner in which the markup is stored. For a small markup argument, a single field that can contain one line of markup text is available within the request argument.
Each of these data sources is a different data type within the request argument. A data type is selected first within the definition, followed by the specific value of that type.
The argument itself also has a type. This may be one of CGI Argument, Cookie, HTTP Header, or XML Body. The selection of the argument type specifies how the data for the request argument is passed to the URL defined in the parent step definition.
A given XML via HTTP step can contain multiple arguments. All arguments are listed within the Properties View of the parent step definition. Within this list, the position of each request argument definition specifies the order in which the arguments will be passed to the URL request. This order can be changed by moving the arguments up or down within the list.
where ServerDirectory is the installation location for the development server. This path may be changed, relative to this location, though this is rarely necessary for this definition type.