> Using Integration Controls > TPM Control

Using Integration Controls

     Previous  Next    Open TOC in new window  Open Index in new window  View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

TPM Control

Note: The TPM control is available in BEA WorkSpace Studio only if you are licensed to use WebLogic Integration.

The TPM (trading partner management) control provides BEA WorkSpace Studio business processes and web services with query (read-only) access to trading partner and service information stored in the TPM repository.

All BEA WorkSpace Studio controls follow a consistent model. Many aspects of using TPM controls are identical or similar to using other BEA WorkSpace Studio controls.

 

Topics Included in This Section

Overview: TPM Control

Describes the TPM control.

Creating a TPM Control

Describes how to create a TPM control.

Using a TPM Control

Describes how to use an existing TPM control from within a business process or web service.

Example: TPM Control

Provides an example of how to use the TPM control.

Related Topics

Introducing Trading Partner Integration

Trading Partner Management

Interface TPMControl

 

Overview: TPM Control

The TPM control allows BEA WorkSpace Studio business processes and web services to obtain the following trading partner and service information stored in the TPM repository:

Note: Access to the TPM repository is restricted to active trading partners and active profile services only. To learn about activating trading partners and services, see the WebLogic Integration Administration Console Online Help.

You use methods on the TPM control to retrieve information stored in the TPM repository. These methods return XML documents that conform to the TPM schema associated with importing and exporting trading partner data in the WebLogic Integration Administration Console and the Bulk Loader command line utility.

The TPM control provides read-only access to the TPM repository. Therefore, you cannot use TPM controls to modify trading partner and service information. Instead, you must use the WebLogic Integration Administration Console to modify trading partner and service information. To learn more about modifying the TPM repository, see Trading Partner Management in Using the WebLogic Integration Administration Console.

TPM controls cannot initiate transactions. To learn more about transactions in business processes, see Transaction Boundaries.

For initiator business processes that use RosettaNet or ebXML to exchange business messages, you can retrieve certain information from the TPM repository—settings for process time-out, retry count, and retry interval—using methods on the RosettaNet or ebXML control instead of the TPM control. To learn about these methods, see RosettaNet Control and ebXML Control.

 

Creating a TPM Control

This topic describes how to create a new TPM control.

To create a new TPM control
  1. In the Package Explorer pane, double-click the business process (Process.java file) to which you want to add the TPM control. The business process is displayed in the Design view.
  2. Click on the Data Palette and from the drop-down list select Integration Controls to display the list of controls used for integrating applications.
    3. Note: If the Data Palette view is not visible in BEA WorkSpace Studio, click Windows > Show View > Data Palette from the menu bar.
  3. Select TPM.

    4. The Insert control: TPM dialog box appears (see Figure 15-1).

    Figure 15-1 Insert control:TPM


    Insert control:TPM

  4. In the Insert control: TPM dialog box enter the following details:
    • In the Field Name, type the variable name used to access the new TPM control instance from your business process. The name you enter must be a valid Java identifier.
    • In the Insertion point: from the drop-down list select the insertion node, you want to add the control.
    • Decide whether you want to make this a control factory and select or clear the Make this a control factory that can create multiple instances at runtime check box.
    • Click Finish.

      • A TPM control instance is displayed in the Controls tab.

 

Using a TPM Control

After you have added a TPM control to a business process or web service, you can use methods on the control to retrieve information in the TPM repository. For a description of the methods available in the TPM control interface, see the Interface TPM Control.

To use methods in a TPM control
  1. Verify that your application contains a schema project that includes the TPM.xsd file, and that the schema is already built.
  2. In the Design view, expand the node for the TPM control in the Data Palette to expose its methods.
  3. Drag and drop any methods you want onto the business process.

    4. Each method you add becomes a Control Send with Return node, which will perform a synchronous query request on the TPM repository.

  4. Extract the values you want by creating a query (in the XQuery language) using the mapper functionality of WebLogic Workshop. To learn about creating queries with the mapper functionality, see Transforming Data Using XQuery Mapper.

Example: TPM Control

For an example of how to use the TPM Control, see “Step 7: Using the TPM Control and Callbacks” in Tutorial: Building ebXML Solutions, which is located at the following URL:

http://download.oracle.com/docs/cd/E13214_01/wli/docs102/tptutorial/ebxml.html


  Back to Top       Previous  Next