Copyright © TIBCO Software Inc. All Rights Reserved

Configuring Services Plug-in Operations

To configure a Services Plug-in operation:

1.	Start TIBCO Administrator.

2.	Click BusinessConnect > Operations Editor.

On the Operations Editor page, group the available installed protocols (plug-ins) by Plug-in or None.

Figure 13 Configure New Operation for the Services Plug-in

Using this page to:

−	Import a new operation by clicking Import.

−	Export the existing operations, by selecting the radio button next to the plug-in and clicking Export.

Add New Category

Category is used to group operations based on their type.

1.	Click the EZComm link.

The Edit Operations: EZComm page is displayed.

2.	Click New Category.

3.	On the New Category page:

−	In the Name field, type a category name (required).

−	In the Description field, type a brief description for this category (optional).

4.	Click Save.

Add New Version

Version is used to allow various subgroups of operations, such as Notify only, or Notify and Synchronous Request Response, and so on.

1.	Click New Version with the category selected.

2.	On the New Version page:

−	In the Name field, type a version name (required)

−	In the Description field, type a brief description for this version (optional).

3.	Click Save.

Add New Operation

Operations are added to a specific version. Each version can contain the same or different operation sets.

1.	Click New Operation with the a version selected.

The New Operation page is displayed.

Figure 14 New Operation Dialog

2.	Select one operation from the Operation Type list:

−	Synchronous/Asynchronous Request-Response Operation Tab

−

Notify

3.

Click OK.

Synchronous/Asynchronous Request-Response Operation

The two operations are configure 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 10.

Table 10 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 Save.

Request Action Tab

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

Table 11 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: a. 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. b. Click Open. c. 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 Save.

Response Action Tab

This tab is not available for the Notify operation.

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

Table 12 Response Action Tab

Field	Enter/Select
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 Save.

Notify Operation

To configure the 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 13.

Table 13 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 Save.

Notify Request Action Tab

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

Table 14 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 the schema document: 1. Click the change link. 2. On the Change File page, select one of the following from the Type list: • File Reference   If you select File Reference, enter the path to the .xsd file you wish to use. • Uploaded File   If you select Uploaded File: a. Click Browse and navigate to the schema file. In this tutorial, it is located in the BC_HOME\protocols\ezcomm\samples\sampleXML\xsd directory. Note: The Services Plug-in supports XSD and DTD schema validation. In this tutorial, the XSD validation is used. b. Click Open. c. Clock 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 Save.

Copyright © TIBCO Software Inc. All Rights Reserved