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