Add New Operation

Operations are added to a specific version. Each version can contain the same or different operation sets.
  1. To add a new operation to a version, click icon (icon is displayed after you hover the mouse on version) and select one operation from the list.
  2. Configure the selected operation from the list:
  3. Click Add.

New Notify Operation

To configure the New Notify Operation, the following tabs are used:

  • Notify Operation Tab
  • Notify Request Action Tab
Notify Operation Tab
In the Notify Operation tab, enter information according to Table 4.
Table 4 Notify Operation Tab
Field Enter/Select
Name Name of the operation (required).
Description Brief description for the operation.
Inbound
Validate Message When selected, any inbound messages (either request or response), are validated. This should be selected in the following cases:
  • If the Initiator needs the response from the partner to be validated.
  • If the Responder needs the request to be validated.
Outbound
Validate Message When selected, either the request or response is validated. This check box should be selected in the following cases:
  • The initiator needs that the request to the partner be validated.
  • The responder needs that the response be validated.

Click Add.

In the Request Action tab, enter information according to Table 5.

Table 5 Request Action Tab
Field Enter/Select
Name Name of the request action.
Description Brief description for the request action.
Direction Initiator to Responder (pre-defined).
Validation Schema Name Either XSD or DTD schema can be defined. The file selected here should match the validation type selected in the field XML Document Validation.

To select a schema document:

  1. Click the change link.
  2. On the Change File page, select one of the following two from the Type list:

    • File Reference If you select File Reference, enter the path to the .xsd file you want to use.

    • Uploaded File If you select Uploaded File:
      1. Click Browse and navigate to the schema file. In this tutorial, it is located in the directory BC_HOME\protocols\ezcomm\samples\sampleXML\xsd.

        Note: The Services Plug-in supports XSD and DTD schema validation. In this tutorial, the XSD validation is used.
      2. Click Open.
      3. Click OK.
Require Digital Signature Used for both HTTP and HTTPS transports. If selected, this option signs the outgoing messages and force the incoming messages to be signed.
Require Content Encryption Used for both HTTP and HTTPS transports. If selected, this option encrypts the outgoing messages and force the incoming messages to be encrypted.
Wait time for Response (seconds) This field is available only for the asynchronous Request-Response operation. The default is 3600 seconds.
For BC Palette use only
XML Document Validation Select XSD or DTD from the XML Document Validation list.
Root XML Element Name Root XML element name, which is the top-level XML element in the document. It is only required if you are going to use the TIBCO BusinessConnect palette.

Click Add.

Synchronous/Asynchronous Request-Response Operation

The two operations are configured in a similar way, with small differences that are pointed out in the instructions.

To configure the Synchronous Request-Response operation, the following tabs are used:
  • Synchronous/Asynchronous Request-Response Operation Tab
  • Request Action Tab
  • Response Action Tab

Synchronous/Asynchronous Request-Response Operation Tab

In the Synchronous Request-Response Operation tab, enter information according to Table 6.
Table 6 Synchronous/Asynchronous Request-Response Operation Tab
Field Enter/Select
Name Name of the operation (required).
Description Brief description for the operation.
Inbound
Validate Message When selected, any inbound messages (either request or response), are validated. This should be selected in the following cases:
  • If the Initiator needs the response from the partner to be validated.
  • If the Responder needs the request to be validated.
Outbound
Validate Message When selected, either the request or response is validated. This check box should be selected in the following cases:
  • Initiator needs that the request to the partner be validated.
  • Responder needs that the response be validated.

Click Add.

Request Action Tab

In the Request Action tab, enter information according to Table 7.

Table 7 Request Action Tab
Field Enter/Select
Name Name of the request action.
Description Brief description for the request action.
Direction Initiator to Responder (pre-defined).
Validation Schema Name Either XSD or DTD schema can be defined. The file selected here should match the validation type selected in the field XML Document Validation.

To select a schema document:

  1. Click the change link.
  2. On the Change File page, select one of the following two from the Type list:

    File Reference If you select File Reference, enter the path to the .xsd file you want to use.

    Uploaded File If you select Uploaded File:

    1. Click Browse and navigate to the schema file. In this tutorial, it is located in the directory BC_HOME\protocols\ezcomm\samples\sampleXML\xsd.

      Note: The Services Plug-in supports XSD and DTD schema validation. In this tutorial, the XSD validation is used.
    2. Click Open.
    3. Click OK.
Require Digital Signature Used for both HTTP and HTTPS transports. If selected, this option signs the outgoing messages and force the incoming messages to be signed.
Require Content Encryption Used for both HTTP and HTTPS transports. If selected, this option encrypts the outgoing messages and force the incoming messages to be encrypted.
Wait time for Response (seconds) This field is available only for the asynchronous Request-Response operation. The default is 3600 seconds.
For BC Palette use only
XML Document Validation Select XSD or DTD from the XML Document Validation list.
Root XML Element Name Root XML element name, which is the top-level XML element in the document. It is only required if you are going to use the TIBCO BusinessConnect palette.

Click Add.

Response Action Tab

Note: This tab is not available for the Notify operation.

On the Edit Operation page, enter information according to Table 8.

Table 8 Response Action Tab
Field Enter/Section
Name Name of the response action.
Description Brief description for the response action.
Direction Responder to Initiator (pre-defined).
Validation Schema Name Either XSD or DTD schema can be defined. File selected here must match the validation type selected in the field XML Document Validation.

For more information about how to select the schema document, see Validation Schema Name

Require Digital Signature Used for both HTTP and HTTPS transports. If selected, this option signs the outgoing messages and force the incoming messages to be signed.
Require Content Encryption Used for both HTTP and HTTPS transports. If selected, this option encrypts the outgoing messages and force the incoming messages to be encrypted.
Private Process Wait (seconds) Specifies the amount of time that the Responder waits for the response from the private process.

The default is 3600 seconds (60 minutes).

For BC Palette use only

XML Document Validation

Select XSD or DTD from the XML Document Validation list.

Root XML Element Name

Root XML element name, which is the top-level XML element in the document. It is only required if you are going to use the TIBCO BusinessConnect palette.

Click Add.