Specify the data types to provide a mapping from the
external SOAP type onto the internal Process Commander type.
You can also map values from or to the parameter page.
If SOAP is to return data to the client after the service
activity executes, specify a value in the Return
Value fields. If the Return fields
are blank, the DLL response contains no clipboard data.
Field
|
Description
|
| In/Out
|
 Select whether the parameter
passes data from the client application to Process
Commander, from Process Commander back to the
client application, or both:
In — The parameter passes data
to Process Commander in the request message sent by the
client application. Process Commander then maps the
data to the clipboard using the Map To
and Map To Key values. When selected,
the Map From and Map From
Key values are ignored.Out — The parameter passes data
to the client application in the response message sent
by Process Commander. Process Commander then maps the
data from the clipboard using the Map
From and Map From Key values.
When selected, the Map To and
Map To Key values are ignored.In/Out — The parameter passes
data to Process Commander in the request message sent
by the client application, then passes data back to the
client application in the response message sent by
Process Commander. Process Commander maps this data to
the clipboard using the Map To and
Map To Key values, and then maps the
data from the clipboard using the Map
From and Map From Key
values.
|
| Data
Type
|
Select the external
data type of the parameter value: String,
Boolean, Long, or
Double.
|
| Name
|
Enter the external name of the parameter.
|
| Map
To
|
Select how the
system creates the input parameter values. The choice you
make for this field depends on what you select for
Data Type:
Clipboard — The system maps the
data value to the scalar property specified by the
Map ToKey.Username — The system
authenticates the user name using the value
provided.Password — The system
authenticates the password using the value
provided.XML ParseRule — Indicates that
the incoming data value is a stream of XML that can be
parsed using the data mappings specified in a Parse XML
rule.HTML PostData — Indicates that
the incoming data value is a stream of data posted from
an HTML form that contains property key/value pairs in
POST format.
If more choices appear, they each identify a custom
function rule in a MapTo library. Review the function
rule to determine what it does.
|
| Map To
Key
|
Identify a target
for the choice you made in the Map To
field:
- If the Map To value is
Clipboard, enter the property name to
which the data is to be mapped. Use the form
Param.name parameter name to set a
parameter value on the parameter page of the service
activity.
- If the Map To value is
HTML
PostData, Username, or
Password, leave this field blank.
-
If the Map To value is XML
ParseRule, enter the
Namespace key part of the Parse-XML
rule that the system uses to parse the data in the
Map To Key field. The system uses
the Page Class entered on the
Service tab as the first
key part, the Applies To key of the
parse rule. The system determines the Element
Name part of the parse rule key at runtime
from the name of the root element of the arriving XML
document.
- If the Map To value is
HTML
PostData, leave this field blank. The name/value
pairs in the string will be mapped to the parameter
page of the service activity rather than the primary
page.
|
| Map
From
|
If
In/Out is Out or both
In / Out, select how the output data maps
from the clipboard data:
Clipboard — The system maps the
data value from the scalar property specified by the
Map From key.Constant — The system returns a
fixed value.XML Stream — The system composes
a stream of XML data formatted by to an XML Stream rule.HTML Stream — The system
composes a stream of HTML text formatted by an HTML
rule.HTML Frame — The system returns
a stream of HTML text generated by the service
activity.
If more choices appear, they identify a custom
function rule in a MapFrom library. Review
the function rule to determine what it does.
|
| Map From
Key
|
Select a source for
the choice you made in the Map From
field:
- If the Map From value is
Clipboard, enter the property name to
which the data is to be mapped.
- If the Map From value is
Constant, enter a literal string. To
include blank spaces in your text string, surround the
string with double quotes.
- If the Map From value is
XML
Stream, enter the Stream Name
key part of the XML Stream rule that is to generate the data.
The system uses the Primary Page Class
of the service as the Applies To key
part.
- If the Map From value is
HTML Stream, enter the Stream
Name key part of the HTML rule that is
generate the data stream. The system uses the
Primary Page Class of the service as
the Applies To key part.
- If the Map From value is
HTML Frame, enter the name of the Frame
specified in the Show-HTML step of the service
activity. Use this to return data from activities that
were originally written for interactive browser clients
and contain calls to the Show-HTML method.
- If the Map From value is a
Rule-Utility-Function from a
MapFrom
library, enter or select the property that holds the
value to be passed to the custom function.
|
Service COM
form