Back Forward Connect EJB form
Completing the Remote tab

 Contents About Connect EJB rules

Use the Remote tab to specify the data values that the remote system passes as input parameters to the remote method of the EJB client stub. Process Commander maps the data from the clipboard to parameter values of the remote method.

NoteIf you've completed the data fields of the Service tab earlier, Process Commander fills in the list of parameters and their data types on this tab automatically.

Parameters

Field

Description
Data Type

zzz SmartPromptThis column contains the external Java data type of each parameter of the remote method. Both primitive Java types (int, boolean, char, String, and so on) and arrays of primitive types are supported.

Map From

SmartPromptSelect how the system creates the request parameter values. The choice you make for this field depends on the Data Type:

  • Clipboard — The system maps the data value to the scalar property specified by the Map From key.
  • Constant — The system sends a fixed value.
  • HTML Stream — The system composes a stream of HTML text formatted according to an HTML rule.

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

SmartPromptEnter a source for the Map From value:

Map From

Instructions
Clipboard Enter the property name from which the data is to be mapped.
Constant Enter a literal text string. To include blank spaces in your text string surround the string with double quotes.
HTML Stream Enter the Stream Name key part of HTML rule that is to generate the data stream. The system uses the Applies To class of this Connect EJB rule as the Applies To class of the HTML rule.
a Rule-Utility-Function from a MapFrom library Either select the property that holds the value to be processed by the function or leave this field blank, as appropriate for the function.

Return Value

Field

Description
Data Type

zzz SmartPromptThis field contains the external Java data type of the return value, or void. Both primitive Java types (int, boolean, char, String, and so on) and arrays of primitive types are supported.

You can map complex return values/ For example, the return value may have data type:

com.sun.j2ee.blueprints.shoppingcart.cart.model.ShoppingCartModel
Map To

SmartPromptSelect how the system creates the response parameter values. The choice you make for this field depends on the Data Type:

  • Clipboard — The system maps the data value from the scalar property specified by the Map To key.
  • XML ParseRule — Indicates that the incoming data value is a stream of XML that can be parsed using the data mappings specified in a rule of the Rule-Parse-XML rule type.
  • HTML PostData — Indicates that the incoming data value is a stream of data posted from an HTML form that contains property key/value pairs.

If more choices appear, they identify a custom function rule in a MapTo library. Review the function rule to determine what it does.
Map To Key
  • If the Map To value is Clipboard, enter the name of the property name to map the data to.
  • If the Map To value is XML Parse Rule, enter the Namespace name (second key part) and the Element Name name — third key part — of the appropriate XML parse rule. Separate the Namespace from the Element name with a space. That is, use the syntax "NamespaceName ElementName" and not "NamespaceName.ElementName." The system uses the Applies To class of this connector rule as the first key part of the parse rule.

    OldTo maintain backward compatibility for connector rules created in releases before V5.2, you can specify a data mapping with only a Namespace value. In that case, the system at runtime determines the Element Name key from the root element of the incoming XML document. However, this mapping works only if the Parser Type of the XML parse rule is set to DOM and validation is not enabled. As a best practice, specify both the Namespace Name and the Element Name of the rule.
  • If the Map To value is HTML PostData, leave this field blank.

zzz About Connect EJB rules