BEA Logo BEA WLI Release 2.1

  BEA Home  |  Events  |  Solutions  |  Partners  |  Products  |  Services  |  Download  |  Developer Center  |  WebSUPPORT

 

   WLI Doc Home   |   B2B Topics   |   B2B Console Help   |   Previous Topic   |   Next Topic   |   Contents   |   Index   |   View as PDF

Configuring Trading Partners

 

This topic includes the following sections:

 


Introduction to Configuration of Trading Partners

One of the basic building blocks of B2B e-commerce is the trading partner. A trading partner's identity must be defined in the context of the business purpose of the e-community. In the WebLogic Integration environment, a trading partner is understood as an entity that has an agreement with another entity to participate in a specific business exchange, or conversation, by playing a predefined role.

The WebLogic Integration B2B Console allows you to create, configure, and modify trading partners. This topic provides instructions for basic configuration of trading partners. Instructions for advanced configuration of trading partners are available in Using Advanced Trading Partner Configuration Options.

 


Creating a Trading Partner

To create a trading partner:

  1. Click the Trading Partners node in the navigation tree. The Trading Partners page is displayed.

  2. Click the Create a new Trading Partner link at the top of the list. The display is modified to allow you to define a new trading partner.

  3. Enter new values or modify the default values shown in the fields. No other tabs are activated until you enter the required information.

    Table 3-1 Fields on the Trading Partner Tab

    Field

    Description

    Name

    Name of the trading partner you want to create or modify. Once an instance is created, this field is read-only. (Limit is 254 characters.)

    Description

    Brief description of the trading partner. (Limit is 254 characters.) (Optional)

    Type

    Choose local or remote. Indication of whether the trading partner is local (that is, running on the same machine as the B2B engine) or remote (that is, running on a machine other than the host machine for the B2B engine).

    Address

    Address for the trading partner. (Limit is 254 characters.) (Optional)

    Email

    E-mail address for the trading partner. (Limit is 254 characters.) (Optional)

    Phone

    Phone number for the trading partner. (Limit is 254 characters.) (Optional)

    Fax

    Fax number for the trading partner. (Limit is 254 characters.) (Optional)

    WLS User Name

    Name of the WebLogic Server users to whom the trading partner certificate should be mapped when messages are sent by that trading partner. When this field is populated, a WebLogic Server user account is created. The default password is the username.

    This setting affects client-side security setting especially in relation to connections from remote trading partners.

    For complete information about security in WebLogic Server and B2B integration, see Configuring Security in Implementing Security with B2B Integration.

    Encoding


    Natural language to be used for communications with this trading partner. Messages sent by this trading partner are encoded in the language specified here. (Optional) The default is UTF-8 (English). For more information, see A Note About Trading Partner Encoding in Administering B2B Integration

    Status


    Field in which you can specify whether you want the trading partner to be active or inactive.

    Active

    Trading partner is active and available for use by B2B integration users.

    Inactive

    Trading partner is inactive and unavailable for use.


     

  4. Click Create. If the name of the trading partner is invalid, an error message is displayed. You must complete all required fields before you can create a new trading partner.

After you create a new trading partner, the General tab is refreshed and the information you entered is displayed. The other configuration tabs are also activated and the Create option is replaced by two new options: Apply and Reset. You can now configure additional elements for the trading partner. The new trading partner is displayed in the list of all trading partners.

 


Modifying a Trading Partner

To modify an existing trading partner:

  1. Do one of the following:

    The Trading Partner page is displayed.

  2. Select a trading partner. The configuration fields on the page for that trading partner are populated.

  3. Select the tab containing the information you want to modify. For more information, see Creating a Trading Partner.

  4. Click Add/Apply. The General tab is refreshed with the new information you entered. You can now modify elements on other configuration tabs, as needed.

 


Removing a Trading Partner

Note: A trading partner cannot be removed from the repository when an active collaboration agreement is using the party ID for that trading partner.

To remove a trading partner from the repository:

  1. Click the Trading Partners node in the navigation tree. The Trading Partners page is dsplayed.

  2. Select one or more trading partners.

  3. At the bottom of the window, select Remove.

 


Configuring a Trading Partner Party ID

Use trading partner party IDs to specify the business entities that take part in a business conversation. A trading partner can have a number of party IDs to identify parties in different collaboration agreements. For example, company XYZ could create a trading partner named XYZTradingPartner; this trading partner could participate in a number of conversations, say, a request for a quote and a purchase order requisition.

Creating a New Party ID

A party ID is a character string that is used, with a name, to identify a trading partner in the context of a collaboration agreement. You can use party IDs to define elements unique to your business. For example, you might want to enter a Dun and Bradstreet (DUNS) number as a party ID for a specific trading partner.

To create a new party ID:

  1. Do one of the following:

    The Trading Partner page is displayed.

  2. Select the Configuration tab, and then the Party IDs tab. The following fields are displayed on the Party ID tab:
     

  3. Modify the appropriate fields, as necessary.

  4. Click Add/Apply. Your new party ID is added to the list of available party IDs.

Modifying a Party ID

To modify an existing party ID:

  1. Do one of the following:

    The Trading Partner page is displayed.

  2. Select the Configuration tab, then select the Party ID tab if it is not active. Any available party IDs are listed.

  3. Select the party ID you want to modify. The configuration fields for that ID are populated.

  4. Modify the required fields.

  5. Click Add/Apply.

Removing a Party ID

To remove a party ID:

  1. Do one of the following:

    The Trading Partner page is displayed.

  2. Select the Configuration tab. Select the Party ID tab if it is not active. A list of available party IDs is displayed.

  3. Select the party IDs you want to delete.

  4. Click Remove.

 


Configuring a Security Certificate for a Trading Partner

WebLogic Integration supports the use of digital security certificates to make transactions among trading partners secure. These certificates, along with private keys, are used for three different purposes in B2B integration:

Use the Certificates tab to define digital certificate information for use in a collaboration agreement. You can define one or more certificates for each collaboration agreement. You can add, modify, and remove certificates.

For complete information about security in WebLogic Server and B2B integration, see Configuring Security in Implementing Security with B2B Integration.

Creating a Certificate

To create a certificate:

  1. Do one of the following:

    The Trading Partner page is displayed.

  2. Select the Configuration tab. Select the Certificates tab if it is not active. The following fields are displayed on the Certificates tab:
     

  3. Modify the appropriate fields as necessary.

Modifying a Certificate

To modify an existing certificate:

  1. Do one of the following:

    The Trading Partner page is displayed.

  2. Select the Configuration tab. Select the Certificates tab if it is not active. A list of available certificates is displayed.

  3. Select the certificate you want to modify. The configuration fields for that certificate are populated.

  4. Modify the required fields and click Add/Apply.

Removing a Certificate

To remove a certificate:

  1. Do one of the following:

    The Trading Partner page is displayed.

  2. Select the Configuration tab. Select the Certificates tab if it is not active. A list of available certificates is displayed.

  3. Select the certificates you want to delete and click Remove.

 


Configuring a Document Exchange for a Trading Partner

Use the Document Exchange tab for a specified trading partner to define the business protocol binding information that the parties in a collaboration agreement use when exchanging documents.

Depending on the binding you choose from the Business Protocol Binding drop-down list, the remaining options on the page change: RosettaNet 1.1, RosettaNet 2.0, XOCP 1.1, and cXML 1.1.

To create a trading partner document exchange:

  1. Do one of the following:

    The Trading Partner page is displayed.

  2. Select the Configuration tab. Select the Doc Exchange tab if it is not active.

  3. Select a Business Protocol Binding. The remainder of this procedure depends on your selection. For more information, see the following sections:

For complete information about using certificates in document exchange IDs, see Configuring Security in Implementing Security with B2B Integration.

Configuring cXML for a Document Exchange

To create a trading partner document exchange ID using the cXML 1.1 binding:

  1. Do one of the following:

    The Trading Partner page is displayed.

  2. Select the Configuration tab, then select the Doc Exchange tab.

  3. In the Business Protocol Binding field, select cXML 1.1. The cXML values are shown in the following table.
     

  4. When you finish adding or updating the document exchange, click Add/Apply.

Configuring RosettaNet 1.1 for a Document Exchange

To create a trading partner document exchange ID using the RosettaNet 1.1 binding:

  1. Do one of the following:

    The Trading Partner page is displayed.

  2. Select the Configuration tab. Select the Doc Exchange tab if it is not active.

  3. In the Business Protocol Binding field, select RosettaNet 1.1. The default values for all the fields on the Doc Exchange tab are shown in the following table.

    Table 3-5 RosettaNet 1.1 Fields on the Doc Exchange Tab

    Field

    Description

    Document Exchange Name

    Unique name for the document exchange ID. This ID is used to associate business protocol binding information.

    Business Protocol Binding

    Select RosettaNet 1.1 from the drop-down list. You can associate one business protocol with each document exchange ID. The chosen protocol is bound to the trading partner document exchange name specified in the Document Exchange Name field.

    Business Protocol Definition

    Business protocol associated with the business protocol binding specified in the previous field.

    Digital Signature (Nonrepudiation)


    Type of digital signature to be used: signature certificate, nonrepudiation protocol, hash function, or signature algorithm. Select the desired type from the drop-down list provided with this field. (Required)

    Signature Certificate

    Select the type of signature certificate from the drop-down list. This is an optional field. The list in this field is generated from the Certificates tab. (Optional)

    Nonrepudiation Protocol

    Business protocol associated with the signature certificate. If Signature Certificate is selected, the value is PKCS7, otherwise the value is empty string. For complete information about nonrepudiation, see Nonrepudiation in Implementing Security with B2B Integration. (Read only)

    Hash Function

    Function used for encrypting passwords exchanged by trading partners. If Signature Certificate is selected, the value is SHA1, otherwise the value is null. The hash function used by both the RosettaNet and XOCP protocols in B2B integration is SHA1. (Read only)

    Signature Algorithm

    Algorithm used for encrypting the signature certificates exchanged by trading partners. If Signature Certificate is selected, the value is RSA, otherwise the value is null. The signature algorithm used by both the RosettaNet and XOCP protocols in B2B integration is RSA. (Read only)

    Available Document Exchanges

    List of available document exchanges.


     

  4. Click Add/Apply.

Configuring RosettaNet 2.0 for a Document Exchange

To create a trading partner document exchange ID using the RosettaNet 2.0 binding:

  1. Do one of the following:

    The Trading Partner page is displayed.

  2. Select the Configuration tab, then select the Doc Exchange tab.

  3. In the Business Protocol Binding field, select RosettaNet 2.0. The default values for all the fields on the Doc Exchange tab are shown in the following table.
     

    Table 3-6 RosettaNet 2.0 Fields on the Doc Exchange Tab

    Field

    Description

    Document Exchange Name

    Enter a unique name for the document exchange ID. This ID is used to associate business protocol binding information.

    Business Protocol Binding

    Select RosettaNet 2.0 from the drop-down list. You can associate one business protocol with each document exchange ID. The chosen protocol is bound to the trading partner document exchange name specified in the Document Exchange Name field.

    Business Protocol Definition

    The business protocol associated with the business protocol binding specified in the previous field.

    Encryption


    Encryption values.

    Encryption Certificate

    Certificate required for each trading partner when business message encryption is configured. Encryption support is available only with the RosettaNet protocols.

    Encryption Level

    If Encryption Certificate is selected, you can specify the parts of a business message that you want to have encrypted.

    Choose PAYLOAD if you want to encrypt only the XML business document(s) part of the message.

    Choose ENTIRE_PAYLOAD if you want to encrypt the business documents and all attachments in the message.

    Cipher Strength

    If Encryption Certificate is selected, you can select 56- or 128-bit cipher strength. Note that 128-bit encryption is not available in all countries.

    Cipher Algorithm

    Read-only field containing the name of the algorithm. B2B Integration Release 2.1 supports only RSA.

    Digital Signature (Nonrepudiation)


    Type of digital signature that is required. For complete information about nonrepudiation, see Nonrepudiation in Implementing Security with B2B Integration.

    Signature Certificate

    Type of signature certificate from the drop-down list. The list in this field is generated from the Certificates tab. (Optional)

    Nonrepudiation Protocol

    Business protocol associated with the signature certificate. If Signature Certificate is selected, the value is PKCS7; otherwise, the value is an empty string. (Read-only)

    Hash Function

    Function used for encrypting passwords exchanged by trading partners. If Signature Certificate is selected, the value is SHA1; otherwise, the value is null. The hash function used by both the RosettaNet and XOCP protocols in B2B integration is SHA1. (Read-only)

    Signature Algorithm

    Algorithm used for encrypting the signature certificates exchanged by trading partners. If Signature Certificate is selected, the value is RSA; otherwise, the value is null. The signature algorithm used by both the RosettaNet and XOCP protocols in B2B integration is RSA. (Read-only)

    Available Document Exchanges

    List of existing document exchanges.


     

  4. Click Add/Apply.

For complete information about using certificates in document exchange IDs, see Configuring Security in Implementing Security with B2B Integration.

Configuring XOCP 1.1 for a Document Exchange

To create a trading partner document exchange ID using the XOCP binding:

  1. Do one of the following:

    The Trading Partner page is displayed.

  2. Select the Configuration tab. Select the Doc Exchange tab if it is not active.

  3. In the Business Protocol Binding field, select XOCP 1.1. The default values for all the fields on the Doc Exchange tab are shown in the following table.
     

    Table 3-7 XOCP Fields on the Doc ExchangeTab

    Field

    Description

    Document Exchange Name

    Unique name for the document exchange ID. This ID is used to associate business protocol binding information.

    Business Protocol Binding

    Select XOCP 1.1 from the drop-down list. You can associate one business protocol with each document exchange ID. The chosen protocol is bound to the trading partner document exchange name specified in the Document Exchange Name field.

    Business Protocol Definition

    Business protocol associated with the business protocol binding specified in the previous field.

    End Point Type

    Type of connection to be used between this trading partner and other B2B integration instances. For more information, see Configuration Requirements in Administering B2B Integration.

    Confirmed Delivery


    Select this option if you want the system to return a receipt whenever a selected message delivery type (hub_receipt, hub_routed, or destination) is confirmed.

    Note: When active, this feature affects the run-time performance of the B2B engine.

    For more information, see Configuration Requirements in Administering B2B Integration.

    hub_receipt

    Sender receives confirmation when the hub receives the message.

    hub_routed

    Sender receives confirmation when the message is routed on the hub.

    destination

    Sender receives confirmation when the message is sent to the designated recipient.

    Message History

    Stores old messages so the system can compare new messages and determine whether they should be resent. For more information, see the description of the Retries field. Valid values are 0-99. The default is 0.

    Note: When active, this feature affects the run-time performance of the B2B engine.

    Retries


    Enter a value in the text field for the desired retry values. For more information, see Setting Preferences.

    Default Retry Value

    Number of times you want WebLogic Integration to try to send a message. The default is 3.

    Default retry interval

    The amount of time you allow to elapse between attempts to send the same message. The default is 5000 milliseconds.

    Default timeout value

    Amount of time a transaction remains valid (in days, hours, minutes, and seconds). After this interval, WebLogic Integration terminates the transaction even if outstanding messages remain. The default is 5000 milliseconds. (Optional)

    Digital Signature (Nonrepudiation)


    Select a type of digital signature. For details, see Nonrepudiation in Implementing Security with B2B Integration.

    Signature Certificate

    The type of signature certificate to be used. A choice of valid types is presented on a drop-down list that is generated from the Certificates tab. If none is selected, the related fields (Nonrepudiation Protocol, Hash Function, and Signature Algorithm) are not visible. (Optional)

    Nonrepudiation Protocol

    The business protocol associated with the signature certificate. (Read-only)

    Hash Function

    The function used for encrypting passwords exchanged by trading partners. The hash function used by both the RosettaNet and XOCP protocols for B2B integration is SHA1. (Read-only)

    Signature Algorithm

    The algorithm used for encrypting the signature certificates exchanged by trading partners. The signature algorithm used by both the RosettaNet and XOCP protocols for B2B integration is RSA. (Read-only)

    Available Document Exchanges

    List of available document exchanges.


     

  4. Click Add/Apply.

For complete information about using certificates in document exchange IDs, see Configuring Security in Implementing Security with B2B Integration.

Removing a Document Exchange

To remove a trading partner document exchange:

  1. Do one of the following:

    Note: The second option is available only if the Display entities on the navigation tree option is selected on the Preferences tab, as described in Displaying Entities in the Navigation Tree.)

    The Trading Partner page is displayed.

  2. Select the Configuration tab and then, if it is not active, select the Doc Exchange tab. A list of the available document exchanges is displayed.

  3. Select the document exchange you want to delete. Click Remove.

    Note: You may remove multiple document exchanges simultaneously by selecting more than one before clicking Remove.

 


Configuring a Trading Partner Transport

A trading partner transport defines the business protocol binding information to be used by the parties to a collaboration agreement when they exchange documents. Transports are included in the delivery channels for each trading partner. This information includes the transport protocol and security parameters for the relevant business transaction. Each transport is assigned a unique ID.

For more information, see Configuring a Delivery Channel for a Trading Partner

Creating a New Transport

When you configure a transport for a trading partner, you bind the trading partner's transport to a transport security protocol.

To create a new transport:

  1. Do one of the following:

    Note: The second method is available only if the Display entities on the navigation tree option is selected on the Preferences tab in the B2B Console, as described in Displaying Entities in the Navigation Tree.)

    The Trading Partner page is displayed in the right pane.

  2. Select the Configuration tab, and then select the Transport tab.

  3. On the Transport tab, enter data in the fields required, as specified in the following table.
     
     

    For complete information about using certificates in document exchange IDs, see Configuring Security in Implementing Security with B2B Integration.

  4. When you finish modifying the transport protocol configuration, click Add/Apply.

Modifying a Transport

To modify an existing transport:

  1. Select a trading partner by performing one of the following steps:

    Note: The second method is available only if the Display entities on the navigation tree option is selected on the Preferences tab in the B2B Console, as described in Displaying Entities in the Navigation Tree.)

    The Trading Partner page is displayed in the right pane.

  2. Select the Configuration tab. Select the Transport tab if it is not active. A list of available transports is displayed.

  3. Select the transport protocol ID you want to modify. The configuration fields for the ID of the specified protocol are displayed and populated.

  4. Modify the required fields and click Add/Apply.

Removing a Transport

To remove a new transport:

  1. Select a trading partner by performing one of the following steps:

    Note: The second method is available only if the Display entities on the navigation tree option is selected on the Preferences tab in the B2B Console, as described in Displaying Entities in the Navigation Tree.)

    The Trading Partner page is displayed in the right pane.

  2. Select the Configuration tab, then select the Transport tab. A list of available transports is displayed.

  3. Select the transport protocol you want to delete. Click Remove.

    Note: You may remove multiple transport protocols simultaneously by selecting more than one before clicking Remove.

 


Configuring a Delivery Channel for a Trading Partner

A delivery channel is a definition of how a trading partner sends and receives messages. It is configured by referencing the transport and document exchange elements. For more information, see Configuring a Document Exchange for a Trading Partner and Configuring a Trading Partner Transport.

To create a new delivery channel:

  1. Select a trading partner by performing one of the following steps:

    Note: The second method is available only if the Display entities on the navigation tree option is selected on the Preferences tab in the B2B Console, as described in Displaying Entities in the Navigation Tree.)

    The Trading Partner page is displayed in the right pane.

  2. Select the Configuration tab, then select the Delivery Channels tab.

  3. On the Delivery Channels tab, enter data in the fields required, as specified in the following table.
     

  4. Click Add/Apply.

Modifying a Delivery Channel

To modify an existing delivery channel:

  1. Select a trading partner by performing one of the following steps:

    Note: The second method is available only if the Display entities on the navigation tree option is selected on the Preferences tab in the B2B Console, as described in Displaying Entities in the Navigation Tree.)

    The Trading Partner page is displayed in the right pane.

  2. Select the Configuration tab, then select the Delivery Channels tab. A list of available delivery channels is displayed.

  3. Select the delivery channel you want to modify. The configuration fields for the protocol associated with the specified ID are populated.

  4. Modify the required fields and click Add/Apply.

Removing a Delivery Channel

To remove a delivery channel:

  1. Select a trading partner by performing one of the following steps:

    Note: The second method is available only if the Display entities on the navigation tree option is selected on the Preferences tab in the B2B Console, as described in Displaying Entities in the Navigation Tree.)

    The Trading Partner page is displayed in the right pane.

  2. Select the Configuration tab, then select the Delivery Channels tab. A list of available delivery channels is displayed.

  3. Select the ID of the delivery channel you want to delete. Click Remove.

 

back to top previous page next page