Skip Headers
Oracle® Application Server Integration B2B User's Guide
10g Release 2 (10.1.2.0.2)
B19370-01
  Go To Table Of Contents
Contents
Go To Documentation Library
Home
Go To Product List
Solution Area
Go To Index
Index

Previous
Previous
Next
Next
 

10 Managing Trading Partners

This chapter describes the tasks required to manage trading partners, support for their business protocols, and their business protocol operational and communication capabilities.

This chapter contains the following topics:

See Chapter 9, "Creating Trading Partners" for instructions on creating trading partners, assigning support for business protocols, and creating business protocol operational and communication capabilities.

Trading Partner Management Overview

In Chapter 9, "Creating Trading Partners" you created the remote trading partner, assigned support for the business protocol to the remote trading partner, created business protocol operational capability for the remote trading partner, and created business protocol communication capabilities for the host and remote trading partners. You can now perform additional trading partner management tasks (for example, viewing, updating, deleting, adding, and removing details). The following sections provide a brief overview of the pages from which you perform these tasks:

Trading Partner Details Page

Both trading partners have a Trading Partner Details page similar to that shown in Figure 10-1. A remote trading partner is shown for this example; the page for the host trading partner differs only in that you cannot manage a certificate; instead a method for managing a wallet password is provided.

You access the Trading Partner Details page by clicking Partners, then Trading Partners, and then trading_partner_name_in_the_Name_column. Four sections display at the top of the Trading Partner Details page: General, Organization, Users, and Capabilities.

Figure 10-1 Trading Partner Details Page

Description of Figure 10-1  follows
Description of "Figure 10-1 Trading Partner Details Page"

These four sections enable you to access pages from which to perform management tasks. Table 10-1 describes the tasks you can access from these sections and provides references for more details.

Table 10-1 Trading Partner Details Page Management Tasks

Section Management Task Description See Section...

General

This is the default page that displays when you first access the Trading Partner Details page shown in Figure 10-1. This page enables you to manage the following details:



  • Trading Partner Identifications

    Enables you to manage the method for uniquely identifying a trading partner (for example, a Data Universal Numbering System (DUNS) number)

"Managing Trading Partner Identification"



"Managing Trading Partner Agreements of Trading Partners"



  • Certificates (for remote trading partners only)

    Enables you to securely bind an identity such as a remote trading partner to a public key

"Managing Remote Trading Partner Certificates"



  • Wallet passwords (for the host trading partner only)

    Enables you to store and manage a wallet password

Note: Wallet password management tasks do not display in Figure 10-1, which is an example of a Trading Partner Details page for a remote trading partner. Instead, see Figure 10-8.

"Managing the Host Trading Partner Wallet Password"


Organization

Clicking this section displays a page for managing the contact information for persons (for example, an e-mail address). (See Figure 10-9 for an example of this page.)

"Managing Trading Partner Contact Information for Persons and Organizations"


Users

Clicking this section displays a page for managing OracleAS Integration B2B persons. Persons consist of Oracle Application Server Integration B2B user interface tool users and persons who can optionally review trading partner details (for example, the business protocol and operational and communication capabilities assigned to a trading partner). (See Figure 10-10 for an example of this page.)

"Managing Trading Partner Persons"


Capabilities

Clicking this section displays a page for managing the business protocol of a trading partner. You can also access a page to manage the operational and communication capabilities of the business protocol. (See Figure 10-2.) For the host trading partner, internal delivery channels can also be managed from this page.

"Managing Trading Partner Business Protocols"



Capabilities Page

Clicking Capabilities on the Trading Partner Details page displays the Capabilities page shown in Figure 10-2. This page enables you to manage the business protocol associated with the trading partner and access a page for managing the operational and communication capabilities of the business protocol. The Capabilities page that displays in this example is for a remote trading partner; only business protocols that you have explicitly assigned to the remote trading partner appear. The Capabilities page for a host trading partner displays all business protocols available with OracleAS Integration B2B. This is because the host trading partner is automatically assigned support for all business protocols and operational capabilities. This simplifies the user experience. (See Figure 10-12 for the Capabilities page of the host trading partner.)

Figure 10-2 Capabilities Page

Description of Figure 10-2  follows
Description of "Figure 10-2 Capabilities Page"

See "Managing Trading Partner Business Protocols" for additional details about the Capabilities pages for both host and remote trading partners.

Business Protocol Details Page

Clicking the business protocol name in the Name column in Figure 10-2 (for this example, RosettaNet over RNIF) enables the Business Protocol Details page shown in Figure 10-3 to appear.

Figure 10-3 Business Protocol Details Page

Description of Figure 10-3  follows
Description of "Figure 10-3 Business Protocol Details Page"

Management tasks on the Business Protocol Details page are divided into two sections: Operational Capabilities and Communication Capabilities. Table 10-2 describes the tasks you can access from these sections and provides references for more details.

Table 10-2 Business Protocol Details Page Management Tasks

Section Management Task Description See Section...

Operational Capabilities

This section enables you to manage the following operational capabilities:



  • Support for collaborations (these display if you are using the RosettaNet over RNIF business protocol)

    Enables you to manage the collaborations used between trading partners

"Managing Business Protocol Collaborations"



  • Support for business actions (these display if you are using any EDI or Custom Document business protocol)

    Enables you to manage the business actions used between trading partners

"Managing Business Protocol Business Actions"


Communication Capabilities

This section enables you to manage the following communication capabilities:



  • Delivery Channels

    Enables you to manage security characteristics such as nonrepudiation of origin and receipt, acknowledgment mode, time to acknowledge, retry count, transport security, encryption, and file compression

"Managing Business Protocol Delivery Channels"



  • Document Exchanges

    Enables you to manage the capabilities for exchanging messages with a trading partner

"Managing Business Protocol Document Exchanges"



  • Transports

    Enables you to manage transport protocols, modes, servers, and endpoints

"Managing Business Protocol Transports"



  • Transport Servers

    Enables you to manage the endpoint server of the trading partner

"Managing Business Protocol Transport Servers"



  • Endpoints

    Enables you to manage the endpoint address (typically a URI) of a trading partner

"Managing Business Protocol Endpoints"



The remaining sections of this chapter provide specific details on managing trading partners, support for their business protocols, and the operational and communication capabilities of the business protocols.

Managing Trading Partners

The OracleAS Integration B2B user interface tool enables you to perform the remote and host trading partner management tasks shown in Figure 10-4. These tasks are described in detail in this section. The remote trading partner is the party outside of the enterprise of the host trading partner (and its installation of OracleAS Integration B2B). The host trading partner is identified by the word (Host) that displays in the Trading Partners page shown in Figure 10-4.

Figure 10-4 Trading Partner Management Tasks

Description of Figure 10-4  follows
Description of "Figure 10-4 Trading Partner Management Tasks"

Table 10-3 identifies the trading partner management tasks shown in Figure 10-4 and provides references to procedures for performing these tasks.

Table 10-3 Trading Partner Management Tasks

Page Elements Management Task See Section...

Shortcut section in Trading Partners page of Figure 10-4

Take a shortcut to create a trading partner agreement

"Managing Trading Partner Agreements"


Create button of Trading Partners page of Figure 10-4

Create a remote trading partner (the host trading partner is automatically created)

"Trading Partner Creation Overview"


Name column of Trading Partners page of Figure 10-4

View details about a host or remote trading partner

"Viewing a Host or Remote Trading Partner"


Update column of Trading Partners page of Figure 10-4

Update a host or remote trading partner

"Updating a Host or Remote Trading Partner"


Delete column of Trading Partners page of Figure 10-4

Delete a remote trading partner (you cannot delete the host trading partner)

"Deleting a Remote Trading Partner"



Viewing a Host or Remote Trading Partner

Follow these instructions to view details about a host or remote trading partner:

  1. Click Partners, then Trading Partners.

  1. Select a specific trading partner to view in the Name column.

    The Trading Partner Details page for the selected trading partner appears.

  1. View specific details, including the following:

    • Trading partner identification type and value (for example, a DUNS number, EDI location code, or AS2 Identifier) of the trading partner

    • Trading partner agreements and their current state (for example, Draft) with which this trading partner is associated

    • Remote trading partner certificate name and location (The host trading partner uses a wallet password instead of a certificate.)

    See Figure 10-5 for an example of the Trading Partner Details page. The Trading Partner Details page, as with the Trading Partners page shown in Figure 10-4, enables you to delete or update a remote trading partner and update the host trading partner.

    Links to the General, Organization, Users, and Capabilities sections also display at the top of the page.

  2. Click Return to List to return to the Trading Partners page.

See the following for more information:

Updating a Host or Remote Trading Partner

The remote trading partner name is the name you entered when creating a remote trading partner in Chapter 9, "Creating Trading Partners". The host trading partner is automatically named MyCompany after installation. You can change the host name to one that more accurately reflects your organization or company (for example, ipdev, which appears in Figure 10-4). Follow these instructions to update the name (or description) of a host or remote trading partner.

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner name to update in the Update column.

    The Update Trading Partner page appears.

  3. Make appropriate changes to the name (or description) of the trading partner.

  4. Click Apply.

    The trading partner is updated and the Trading Partners Details page appears.

Deleting a Remote Trading Partner

Follow these instructions to delete a remote trading partner:


Note:

You cannot delete the host trading partner. Only remote trading partners can be deleted.

  1. Click Partners, then Trading Partners.

  2. Select a specific remote trading partner to delete in the Delete column.

  3. Click Yes when prompted to delete a remote trading partner.

    The remote trading partner is deleted and the Trading Partners page appears.

Managing Trading Partner Identification

The OracleAS Integration B2B user interface tool enables you to perform the trading partner identification management tasks shown in Figure 10-5. These tasks are described in detail in this section. The trading partner identification value is separate from the trading partner name and provides an additional method to uniquely identify a trading partner. Trading partner identification consists of a type and a value and is required to create a trading partner agreement. A trading partner identification type called Name with a value of MyCompany is automatically created for the host trading partner. When you create a remote trading partner, a trading partner identification type called Name with a value of the remote trading partner's name is also automatically created.

Figure 10-5 Trading Partner Identification Management Tasks

Description of Figure 10-5  follows
Description of "Figure 10-5 Trading Partner Identification Management Tasks"

Table 10-4 identifies the trading partner identification management tasks shown in Figure 10-5 and provides references to procedures for performing these tasks.

Table 10-4 Trading Partner Identification Management Tasks

Page Elements Management Task See Section...

Create button in Trading Partner Identifications section of Figure 10-5

Create trading partner identification

"Creating Trading Partner Identification"


Details column in Trading Partner Identifications section of Figure 10-5

View details about trading partner identification

"Viewing a Trading Partner Identification"


Update column in Trading Partner Identifications section of Figure 10-5

Update trading partner identification

"Updating a Trading Partner Identification"


Delete column in Trading Partner Identifications section of Figure 10-5

Delete trading partner identification

"Deleting a Trading Partner Identification"




Note:

The trading partner identification type and value also display in the Trading Partner Identification Type and Value columns, respectively, of the Trading Partner Identifications section. (See Figure 10-5.)

Creating Trading Partner Identification

Follow these instructions to create trading partner identification for the host or remote trading partner. The Create Trading Partner wizard also enables you to create an identification for the remote trading partner. Trading partner identification is required to create a trading partner agreement. A default trading partner identification type called Name is automatically provided for host and remote trading partners.

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Click Create in the Trading Partner Identifications section.

    The Create Trading Partner Identification page displays the fields for creating trading partner identification.

  4. Enter the following details to create trading partner identification. An asterisk (*) indicates a required field. Additional identification types can display here if you created them by clicking Administration, then Design, then Trading Partner Identification Types, and then Create.

    Field Value
    Trading Partner Identification Type* Select a type from the available values.
    • DUNS

      DUNS (data universal numbering system) known formally as a D-U-N-S Number, is a unique, sequentially-generated, nine-digit number that you obtain from Dun and Bradstreet.

    • EDI Location Code

      Provides a unique identification of all locations relevant to the EDI transaction.

    • AS2 Identifier

      An alias for the service address (specified by the AS2-from field) inside an AS2 transaction.

    • Generic Identifier

      The Internet Protocol (IP) address to use for identifying trading partners if you are using the generic exchange protocol (EDI X12 over Generic Exchange, EDI EDIFACT over Generic Exchange, or Custom Document over Generic Exchange) with the HTTP or HTTPS transport protocol. Do not enter the hostname.

    Value * Enter a value for the selected type. For example, if DUNS is your type, enter the DUNS number.
    Description Provide an optional description.

  5. Click Apply.

    Trading partner identification is created and the new Trading Partner Identification Details page appears.

See "Page 2: Identification Page" for an alternative method of creating trading partner identification for a remote trading partner with the Create Trading Partner wizard.

Viewing a Trading Partner Identification

Follow these instructions to view details about a specific trading partner identification:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Select a specific trading partner identification to view in the Details column of the Trading Partner Identifications section.

    The Trading Partner Identification Details page for the selected trading partner identification appears.

  1. View specific details about the trading partner identification type and value (for example, a DUNS number, EDI location code, or AS2 identifier value).

    This page, as with the Trading Partner Details page shown in Figure 10-5, enables you to delete or update a trading partner identification that you created. You cannot delete the default type of Name.

Updating a Trading Partner Identification

Follow these instructions to update trading partner identification that you created. A trading partner identification type called Name that is automatically provided for the host and remote trading partners cannot be updated.

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Select a specific trading partner identification to update in the Update column of the Trading Partner Identifications section.

    The Update Trading Partner Identification page appears.

  1. Make appropriate changes. (See Step 4 for a list of fields you can update.)

  2. Click Apply.

    The trading partner identification is updated and the Trading Partner Identification Details page appears.

Deleting a Trading Partner Identification

Follow these instructions to delete trading partner identification that you created. A trading partner identification called Name that is automatically provided for the host and remote trading partners cannot be deleted.

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Select a specific trading partner identification to delete in the Delete column of the Trading Partner Identifications section.

  4. Click Yes when prompted to delete trading partner identification.

    The trading partner identification is deleted and the Trading Partner Details page appears.

Managing Trading Partner Agreements of Trading Partners

The OracleAS Integration B2B user interface tool enables you to perform the trading partner associated agreement management tasks shown in Figure 10-6. The associated agreement is the trading partner agreement of which the trading partner is a part. This agreement defines the behavior that trading partners agree to follow when engaging in a business transaction.

Figure 10-6 Trading Partner Associated Agreement Management Tasks

Description of Figure 10-6  follows
Description of "Figure 10-6 Trading Partner Associated Agreement Management Tasks"

Table 10-5 identifies the trading partner associated agreement management tasks shown in Figure 10-6 and provides references to procedures for performing these tasks.

Table 10-5 Trading Partner Associated Agreement Management Tasks

Page Elements Management Task See Section...

Name column in Associated Agreements section of Figure 10-6

View the trading partner agreement with which a trading partner is associated

"Viewing a Trading Partner Agreement"


Update column in Associated Agreements section of Figure 10-6

Update the trading partner agreement with which a trading partner is associated

"Updating a Trading Partner Agreement"


Delete column in Associated Agreements section of Figure 10-6

Delete the trading partner agreement with which a trading partner is associated

"Deleting a Trading Partner Agreement"




Note:

The State column of the Associated Agreements section shown in Figure 10-6 displays the current state of the trading partner agreement.

Managing Remote Trading Partner Certificates

The OracleAS Integration B2B user interface tool enables you to perform the remote trading partner certificate management tasks shown in Figure 10-7. These tasks are described in detail in this section. A certificate securely binds an identity such as a trading partner to a public key. A certificate is created when a trading partner's public key is signed by a trusted identity known as a certificate authority (CA). This certificate ensures that the trading partner's partner data is correct and that the public key actually belongs to that trading partner during business transactions.

The host trading partner does not use a certificate. Instead, the host trading partner uses a wallet password for security.

Figure 10-7 Remote Trading Partner Certificate Management Tasks

Description of Figure 10-7  follows
Description of "Figure 10-7 Remote Trading Partner Certificate Management Tasks"


Note:

The Create button in the Certificates section displays only for remote trading partners. Host trading partners create a wallet password and specify a directory location on the Trading Partner Details page of the host trading partner.

Table 10-6 identifies the remote trading partner certificate management tasks shown in Figure 10-7 and provides references to procedures for performing these tasks.

Table 10-6 Remote Trading Partner Certificate Management Tasks

Page Elements Management Task See Section...

Create button in Certificates section of Figure 10-7

Create a remote trading partner certificate

"Creating a Remote Trading Partner Certificate"


Name column in Certificates section of Figure 10-7

View details about a remote trading partner certificate

"Viewing a Remote Trading Partner Certificate"


Update column in Certificates section of Figure 10-7

Update a remote trading partner certificate

"Updating a Remote Trading Partner Certificate"


Delete column in Certificates section of Figure 10-7

Delete a remote trading partner certificate

"Deleting a Remote Trading Partner Certificate"




Note:

The certificate file name displays in the Certificate Location column of the Certificates section. (See Figure 10-7.)

See "Managing the Host Trading Partner Wallet Password" for instructions on managing the wallet password for the host trading partner.

Creating a Remote Trading Partner Certificate

Follow these instructions to create a remote trading partner certificate. You can then assign nonrepudiation and enable encryption to this certificate by clicking Partners, then Trading Partners, then trading_partner_name_in_the_Name_column, then Capabilities, then business_protocol_name_in_Name_column, and then Create Communication Capabilities. On the Delivery Channel page that appears, enable nonrepudiation of origin, nonrepudiation of receipt, or encryption. On the Document Exchange page that follows, select Use Existing in the Signing Credential section. The remote trading partner certificate created in this section appears in the Certificate list.

The Create Trading Partner wizard also enables you to create and assign a certificate to a remote trading partner during a single wizard session.

  1. Click Partners, then Trading Partners.

  2. Select a specific remote trading partner in the Name column.

  3. Click Create in the Certificates section.

    The Create Certificate page appears.

  4. Enter the following details to create a remote trading partner certificate. An asterisk (*) indicates a required field.

    Field Value
    Name * Enter a unique and recognizable name for the remote trading partner certificate.
    Certificate File * Click Browse to select the remote trading partner certificate file.

  5. Click Apply.

    The remote trading partner certificate is created and the new Certificate Details page appears.

See "Page 4: Delivery Channel Page" and "Page 5: Document Exchange Page" for an alternative method of creating a remote trading partner certificate with the Create Trading Partner wizard.

Viewing a Remote Trading Partner Certificate

Follow these instructions to view details about a specific remote trading partner certificate:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Select a specific certificate to view in the Name column of the Certificates section.

    The Certificate Details page for the selected certificate appears.

  1. View the certificate file name.

    This page, as with the Trading Partner Details page shown in Figure 10-7, enables you to delete or update the selected certificate.

  2. Click Return to List to return to the Trading Partner Details page.

Updating a Remote Trading Partner Certificate

Follow these instructions to update a remote trading partner certificate:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Select a specific certificate to update in the Update column of the Certificates section.

    The Update Certificate page appears.

  1. Make appropriate changes. (See Step 4 for a list of fields you can update.) Note that the Certificate File field is empty. You must upload the file again.

  2. Click Apply.

    The remote trading partner certificate is updated and the Certificate Details page appears.

Deleting a Remote Trading Partner Certificate

Follow these instructions to delete a remote trading partner certificate. You cannot delete a remote trading partner certificate that you created in "Creating a Remote Trading Partner Certificate" and assigned to a remote trading partner under Create Communication Capability. You must first delete the delivery channel associated with that document exchange. Then you can delete it.

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Select a specific remote trading partner certificate to delete in the Delete column of the Certificates section.

  4. Click Yes when prompted to delete a remote trading partner certificate.

    The remote trading partner certificate is deleted and the Trading Partner Details page appears.

Managing the Host Trading Partner Wallet Password

The OracleAS Integration B2B user interface tool enables you to perform the host trading partner wallet password management tasks shown in Figure 10-8. These tasks are described in detail in this section. A wallet is a container in which certificates and trusted certificates are stored and managed. These data structures securely store a user private key, a user certificate, and a set of trusted certificates. A wallet password opens the user's wallet.

When you create or update the wallet password on a previously validated Trading Partner Details page (that is, the State section displays as Approved), the state reverts to Draft and the Validate button reappears. You must revalidate the host trading partner by clicking Validate.

A remote trading partner does not use a wallet password. Instead, the remote trading partner uses a remote certificate for security.

Figure 10-8 Host Trading Partner Wallet Password Management Tasks

Description of Figure 10-8  follows
Description of "Figure 10-8 Host Trading Partner Wallet Password Management Tasks"

Table 10-7 identifies the host trading partner wallet password management tasks shown in Figure 10-8 and provides references to procedures for performing these tasks.

Table 10-7 Host Trading Partner Wallet Password Management Tasks

Page Elements Management Task See Section...

Create button to the right of Wallet Password in the Details section of Figure 10-8

Create a wallet password

"Creating a Host Trading Partner Wallet Password"


Update button of Figure 10-8

Note: This button displays to the right of Wallet Password in the Details section only after the wallet password has been created.

Update a wallet password

"Updating a Host Trading Partner Wallet Password"



See "Managing Remote Trading Partner Certificates" for instructions on managing the certificate for the remote trading partner.

Creating a Host Trading Partner Wallet Password

An Oracle Wallet is automatically created during installation in Oracle_Home/Apache/Apache/conf/ssl.wlt/default/ewallet.p12 on your Oracle Application Server middle tier. The initial password is welcome. Perform the following tasks in Oracle Wallet Manager:

  • Change the initial password

  • Export the Oracle Wallet

  • Name the file ora_wallet.txt

After that, you can create a host trading partner wallet password on the Trading Partner Details page of the host trading partner. This password must match the Oracle Wallet password. Follow these instructions to create a host trading partner wallet password:

  1. Click Partners, then Trading Partners.

  2. Select the host trading partner in the Name column. The host trading partner is identified by the word (Host).

  3. Click Create to the right of Wallet Password in the Details section.

    The Create Host Wallet Password page appears.

  4. Enter the following details to create a wallet password. An asterisk (*) indicates a required field.

    Field Value
    New Wallet Password Enter the same wallet password that you created in Oracle Wallet Manager.
    Confirm New Password Enter the same wallet password a second time.

  5. Click Apply. The password is stored in encrypted format.

    The Create button to the right of Wallet Password in the Details section now always displays as the Update button.

  6. Go to Oracle Enterprise Manager 10g Application Server Control Console and specify the directory for the wallet location with the OracleAS Integration B2B Wallet Location configuration parameter (for example, Oracle_Home/Apache/Apache/conf/ssl.wlt/default/ora_wallet.txt).

See the following for more information:

Updating a Host Trading Partner Wallet Password

If you later update the wallet password in Oracle Wallet Manager, you must also update the password with the same value in the OracleAS Integration B2B user interface tool. Follow these instructions to update a host trading partner wallet password:


Note:

You cannot update the wallet password in the OracleAS Integration B2B user interface tool without first updating it in Oracle Wallet Manager.

  1. Click Partners, then Trading Partners.

  2. Select the host trading partner in the Name column.

  3. Click Update to the right of Wallet Password in the Details section.

    The Update Host Wallet Password page appears.

  4. Make appropriate changes. (See Step 4 of "Creating a Host Trading Partner Wallet Password" for a list of fields that you can update.) Ensure that the password matches the one you first specified in Oracle Wallet Manager.

  5. Click Apply.

    The host trading partner wallet password is updated and the Trading Partner Details page appears.

Managing Trading Partner Contact Information for Persons and Organizations

The OracleAS Integration B2B user interface tool enables you to perform the person and organization contact information management tasks shown in Figure 10-9. These tasks are described in detail in this section. Contact information is the method by which to contact a user or organization (such as an e-mail address or phone number).

Figure 10-9 Person and Organization Contact Information Management Tasks

Description of Figure 10-9  follows
Description of "Figure 10-9 Person and Organization Contact Information Management Tasks"

Table 10-8 identifies the person and organization contact information management tasks shown in Figure 10-9 and provides references to procedures for performing these tasks.

Table 10-8 Person and Organization Contact Information Management Tasks

Page Elements Management Task See Section...

Create button of Contact Information section of Figure 10-9

Create contact information for a person or organization

"Creating Contact Information for a Trading Partner Person or Organization"


Contact Type column of Contact Information section of Figure 10-9

View details about contact information for a person or organization

"Viewing Contact Information for a Trading Partner Person or Organization"


Contact Type column of Contact Information section of Figure 10-9 (to access the page to update contact information for a person or organization)

Update contact information for a person or organization

"Updating Contact Information for a Trading Partner Person or Organization"


Contact Type column of Contact Information section of Figure 10-9 (to access the page to delete contact information for a person or organization)

Delete contact information for a person or organization

"Deleting Contact Information for a Trading Partner Person or Organization"




Note:

The contact information value (for example, an e-mail address) displays in the Value column of the Contact Information section. (See Figure 10-9.)

Creating Contact Information for a Trading Partner Person or Organization

Follow these instructions to create contact information for a specific trading partner person or organization:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Perform the following steps based on the type of contact information to create:

    To Create Contact Information For... Perform These Steps...
    A person
    1. Click Users at the top of the Trading Partner Details page.
    2. Select a specific person in the Name column of the People section.

    3. Click Create in the Contact Information section.

    An organization
    1. Click Organization at the top of the Trading Partner Details page.
    2. Click Create in the Contact Information section.


    The Create Contact Information page appears.

  4. Enter the following details to create person or organization contact details. An asterisk (*) indicates a required field.

    Field Value
    Contact Type * Select one of the automatically available contact types (Contact Name, Email, Fax, or Phone)
    Value Enter a value for the selected contact type. For example, if you select Phone as the contact type, enter a phone number in this field.


    Note:

    Contact type creation does not cause a person to be automatically contacted when a specific condition occurs, such as the need to review a trading partner agreement. You must manually contact a person through the selected contact type method.

  5. Click Apply.

    The Contact Information Details page appears.

Viewing Contact Information for a Trading Partner Person or Organization

Follow these instructions to view details about contact information for a specific trading partner person or organization:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Perform the following steps based on the type of contact information to view:

    To View Contact Information For... Perform These Steps...
    A person
    1. Click Users at the top of the Trading Partner Details page.
    2. Select a specific person for which to view contact information in the Name column of the People section.

    3. Click a specific contact type in the Contact Type column of the Contact Information section.

    An organization
    1. Click Organization at the top of the Trading Partner Details page.
    2. Click a specific contact type in the Contact Type column of the Contact Information section.


    The Contact Information Details page appears.

  4. View specific details about the contact type and method for contacting the person.

  5. Click Return to List.

Updating Contact Information for a Trading Partner Person or Organization

Follow these instructions to update contact information for a specific trading partner person or organization:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Perform the following steps based on the type of contact information to update:

    To Update Contact Information For... Perform These Steps...
    A person
    1. Click Users at the top of the Trading Partner Details page.
    2. Select a specific person for which to update contact information in the Name column of the People section.

    3. Select the contact information to update in the Contact Type column of the Contact Information section.

    4. Click Update on the Contact Information Details page.

    An organization
    1. Click Organization at the top of the Trading Partner Details page.
    2. Select the contact information to update in the Contact Type column of the Contact Information section.

    3. Click Update on the Contact Information Details page.


    The Update Contact Information page appears.

  4. Make appropriate changes to the contact type (for example, Contact Name, E-mail, Fax, or Phone) or value.

  5. Click Apply.

    The contact information is updated and the Contact Information Details page appears.

Deleting Contact Information for a Trading Partner Person or Organization

Follow these instructions to delete contact information for a specific trading partner person or organization:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Perform the following steps based on the type of contact information to update:

    To Delete Contact Information For... Perform These Steps...
    A person
    1. Click Users at the top of the Trading Partner Details page.
    2. Select a specific person for which to delete contact information in the Name column of the People section.

    3. Select the contact information to delete in the Contact Type column of the Contact Information section.

    4. Click Delete on the Contact Information Details page.

    An organization
    1. Click Organization at the top of the Trading Partner Details page.
    2. Select the contact information to delete in the Contact Type column of the Contact Information section.

    3. Click Delete on the Contact Information Details page.


  4. Click Yes when prompted to delete the contact information.

  5. Click Apply.

    The contact information is deleted.

Managing Trading Partner Persons

The OracleAS Integration B2B user interface tool enables you to perform the person management tasks shown in Figure 10-10. These tasks are described in detail in this section. A person can be an OracleAS Integration B2B user interface tool user or a reviewer of trading partner and trading partner agreement details.

Figure 10-10 Person Management Tasks

Description of Figure 10-10  follows
Description of "Figure 10-10 Person Management Tasks"

You can create two person types in the People section:

These two person types have different capabilities, as shown in Table 10-9.

Table 10-9 Person Capabilities

Capability Host Trading Partner Person Remote Trading Partner Person

Use the OracleAS Integration B2B user interface tool to:

  • Manage (create, view, update, and delete) partner data

  • Deploy and administer a configuration

  • Create reports

Note: The Administrator role must be assigned to a host trading partner person before they can use the OracleAS Integration B2B user interface tool. This role provides the user with access to the functionality of the entire user interface tool. The Reports role can be assigned to users who require access to only the functionality of the Reports tab of the user interface tool.

A person created for a remote trading partner cannot use the OracleAS Integration B2B user interface tool.

Yes

No

Can add user roles and use cases (privileges) to the person type

Yes

No


Table 10-10 identifies the person management tasks shown in Figure 10-10 and provides references to procedures for performing these tasks.

Table 10-10 Person Management Tasks

Page Elements Management Task See Section...

Create button in People section of Figure 10-10

Create a person for a trading partner

"Creating a Trading Partner Person"


Name column in People section of Figure 10-10

View details about a person of a trading partner and update the person password

"Viewing a Trading Partner Person and Updating the Person Password"


Update column in People section of Figure 10-10

Update a person of a trading partner

"Updating a Trading Partner Person"


Delete column in People section of Figure 10-10

Delete a person of a trading partner

"Deleting a Trading Partner Person"


Name column in People section of Figure 10-10 (to access the page to assign a user role)

Assign a user role to a host trading partner person

"Assigning a User Role to a Host Trading Partner Person"


Name column in People section of Figure 10-10 (to access the page to remove a user role)

Remove a user role from a host trading partner person

"Removing a User Role from a Host Trading Partner Person"


Name column in People section of Figure 10-10 (to access the page to view user roles and use case groups)

View user roles and use case groups

"Viewing User Roles and Use Case Group Details"



Creating a Trading Partner Person

Follow these instructions to create a trading partner person. This person can be a reviewer of trading partner agreement details. If this person is created for the host trading partner, they can also use the OracleAS Integration B2B user interface tool.

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Click Users at the top of the Trading Partner Details page.

    The Users page for the selected trading partner appears.

  1. Click Create in the People section.

  2. Enter the following details to create a trading partner person. An asterisk (*) indicates a required field.

    Field Value
    Name * Enter a unique and recognizable person name.
    Password * Enter a password.

    Note: If you are creating a remote trading partner person, then you can ignore this field. If you are creating a host trading partner person, enter a password if you want to later add the following user roles:

    • The Administrator role for persons requiring access to the functionality of the entire OracleAS Integration B2B user interface tool

    • The Reports role for persons (such as business analysts) requiring access to the functionality of only the Reports tab of the user interface tool

    Description Provide an optional description.

  3. Click Apply.

    The trading partner person is created and the Person Details page appears. At this point, this person cannot use the OracleAS Integration B2B user interface tool. They must now be assigned a user role.

  4. Click Return to List to return to the Users page.

See the following for more information:

Viewing a Trading Partner Person and Updating the Person Password

Follow these instructions to view details about a specific trading partner person and update the person password of a host trading partner:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Click Users at the top of the Trading Partner Details page.

    The Users page for the selected trading partner appears.

  4. Select a specific trading partner person to view in the Name column of the People section.

    The Person Details page for the selected trading partner person appears.

  5. View specific details, including the method for contacting the person (for example, an e-mail address).

  6. If you want to update the trading partner person password, click Update in the Details section.

    The Update Person Password page appears.

  7. Enter the following details to update a person password.

    Field Value
    New Password Enter a new password.
    Confirm New Password Enter the new password a second time.

  8. Click Apply.

    The Person Details page appears.

  9. Click Return to List to return to the Users page.

Updating a Trading Partner Person

Follow these instructions to update a trading partner person:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Click Users at the top of the Trading Partner Details page.

    The Users page for the selected trading partner appears.

  4. Select a specific trading partner person to update in the Update column of the People section.

    The Update Person page appears.

  5. Make appropriate changes to the name or description.

  6. Click Apply.

    The trading partner person is updated and the Person Details page appears.

Deleting a Trading Partner Person

Follow these instructions to delete a trading partner person:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Click Users at the top of the Trading Partner Details page.

    The Users page for the selected trading partner appears.

  4. Select a specific trading partner person to delete in the Delete column of the People section.

  5. Click Yes when prompted to delete a trading partner person.

    The trading partner person is deleted and the Trading Partner Details page appears.

Assigning a User Role to a Host Trading Partner Person

You can add a user role to a host trading partner person, but not to a remote trading partner person. A user role is the group of related use cases (privileges) that permit a person to connect to and perform tasks with the OracleAS Integration B2B user interface tool. Follow these instructions to add a user role to a person:

  1. Click Partners, then Trading Partners.

  2. Select the host trading partner in the Name column.

  3. Click Users at the top of the Trading Partner Details page.

    The Users page for the host trading partner appears.

  4. Select a specific person in the Name column.

    The Person Details page appears.

  5. Click Add in the User Roles section to add a user role to the host trading partner person.

    The Create User Role Enrollment page appears.

  6. Select one of the following roles from the User Role list:

    • The Administrator role for persons requiring access to the functionality of the entire OracleAS Integration B2B user interface tool (that is, the Partners, Deployment, Reports, and Administration tabs)

    • The Reports role for persons (such as business analysts) requiring access to only the functionality of the Reports tab of the OracleAS Integration B2B user interface tool

  7. Click Apply.

    The user role is added and the Person Details page appears. If the person does not have a password, you receive an error and the user role is not added.

  8. Click Apply.

    The Person Details page appears.

See "Viewing a Trading Partner Person and Updating the Person Password" if you need to add a password to the host trading partner person.

Removing a User Role from a Host Trading Partner Person

You can remove a user role from a host trading partner person that you created, but not from a remote trading partner person (they have none). You cannot remove the Administrator role from the default host trading partner user of admin. Follow these instructions to remove a user role from a person:


Caution:

If you remove a user role from a host trading partner person that you created, that person no longer has privileges to use the Oracle Application Server Integration B2B user interface tool.

  1. Click Partners, then Trading Partners.

  2. Select the host trading partner in the Name column.

  3. Click Users at the top of the Trading Partner Details page.

    The Users page for the host trading partner appears.

  4. Select a specific person in the Name column.

    The Person Details page appears.

  5. Select a user role to remove in the Remove column of the User Roles section.

  6. Click Yes when prompted to remove the user role.

    The user role is removed and the Person Details page appears.

Viewing User Roles and Use Case Group Details

User roles consist of use case groups that include the use cases (privileges) that permit a person to perform tasks with the OracleAS Integration B2B user interface tool.


Note:

You cannot create, delete, or update user roles or use case groups.

Follow these instructions to view the user role and its associated use case group details:

  1. Click Partners, then Trading Partners.

  2. Select the host trading partner in the Name column.

  3. Click Users at the top of the Trading Partner Details page.

    The Users page for the host trading partner appears.

  4. Select a specific person in the Name column.

    The Person Details page appears.

  5. Select the Administrator or Reports role in the Name column of the User Roles section.

    The User Role Details page appears.

  6. View specific details, including a description of the user role, the state of the role, and the use case group of the role.

  7. Click the use case group in the Name column of the Use Case Groups section.

  8. View the specific use cases assigned to the use case group of the role.

  9. Click Return to List to return to the User Role Details page.

  10. Click Return to List to return to the Person Details page.

Managing Trading Partner Business Protocols

The OracleAS Integration B2B user interface tool enables you to perform the business protocol management tasks shown in Figure 10-11 and Figure 10-12. These tasks are described in detail in this section. The business protocol identifies the implementation guidelines for the reliable transport of business document messages between trading partners. Each trading partner must have support for a business protocol with operational and communication capabilities. A business protocol consists of the following three protocols:

Figure 10-11 shows a business protocol for a remote trading partner (RosettaNet over RNIF in this example). You must use the OracleAS Integration B2B user interface tool to assign support for a business protocol to a remote trading partner.

Figure 10-11 Business Protocol Management Tasks (Remote Trading Partner)

Description of Figure 10-11  follows
Description of "Figure 10-11 Business Protocol Management Tasks (Remote Trading Partner)"

Figure 10-12 shows the business protocols for the host trading partner. Support for all business protocols in the OracleAS Integration B2B user interface tool is automatically assigned to the host trading partner. These business protocols cannot be removed.

Figure 10-12 Business Protocol Management Tasks (Host Trading Partner)

Description of Figure 10-12  follows
Description of "Figure 10-12 Business Protocol Management Tasks (Host Trading Partner)"

Table 10-11 identifies the business protocol management tasks shown in Figure 10-11 and Figure 10-12 and provides references to procedures for performing these tasks.

Table 10-11 Business Protocol Management Tasks

Page Elements Management Task See Section...

Add button in Figure 10-11 (for remote trading partners)

Note: The host trading partner is automatically assigned support for all business protocols. (See Figure 10-12.)

Add a business protocol to a remote trading partner

"Assigning a Business Protocol"


Name column of Figure 10-11 or Figure 10-12

View details about a business protocol

"Viewing a Business Protocol"


Exchange Protocol column of Figure 10-11 or Figure 10-12

View details about the exchange protocol of a business protocol

"Viewing an Exchange Protocol"


Document Protocol column of Figure 10-11 or Figure 10-12

View details about the document protocol of a business protocol

"Viewing a Document Protocol"


Remove column of Figure 10-11

Note: The business protocol supported by the host trading partner cannot be removed. (See Figure 10-12.)

Remove support for a business protocol from a remote trading partner

"Removing a Business Protocol from a Remote Trading Partner"


Name column of Figure 10-11 or Figure 10-12 (for accessing a page to select the B2B process protocol)

View details about the process protocol of a business protocol

"Viewing a Process Protocol"



Assigning a Business Protocol

The procedural tasks to follow to assign a business protocol are different for a remote or host trading partner. The remote trading partner assigns support for a business protocol either during or separate from a session of the Create Trading Partner wizard. The host trading partner is automatically assigned support for all business protocols. Table 10-12 identifies each task and provides references to procedures for performing these tasks.

Table 10-12 Adding a Business Protocol to Remote and Host Trading Partners

Task See Section...

For Remote Trading Partners:


  • Create the trading partner and assign support for the business protocol and all its operational and communication capabilities during a single Create Trading Partner wizard session

"Creating and Assigning All Capabilities During a Single Wizard Session"


  • Add the business protocol during a separate Create Trading Partner wizard session

Note: You can assign multiple business protocols to a remote trading partner.

"Creating and Defining All Capabilities During Separate Wizard Sessions"


For the Host Trading Partner:


The host trading partner is automatically assigned support for all business protocols, as shown in Figure 10-12.

Chapter 9, "Creating Trading Partners"



Viewing a Business Protocol

Follow these instructions to view details about a specific business protocol:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Click Capabilities at the top of the Trading Partner Details page.

    The Capabilities page for the selected trading partner appears.

  4. Select a specific business protocol to view in the Name column.

    The Business Protocol Details page for the selected business protocol appears.

  5. View specific details, including the associated document, exchange, and process protocols listed in the Details section near the top. In addition, the following sections display on this page. (See Figure 10-15 for an example.)

    Section Subsection See Section...
    Operational Capabilities
    • Supported Collaborations (for the RosettaNet over RNIF business protocol)


    • Supported Business Actions (for any EDI or Custom Document business protocols)

    Communication Capabilities
    • Delivery Channels


    • Document Exchanges


    • Transports


    • Transport Servers


    • Endpoints


  6. Click Return to List to return to the Capabilities page.

Viewing an Exchange Protocol

Follow these instructions to view details about a specific exchange protocol of a business protocol:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Click Capabilities at the top of the Trading Partner Details page.

    The Capabilities page for the selected trading partner appears.

  4. Select a specific exchange protocol to view in the Exchange Protocol column.

    The Exchange Protocol Details page for the selected exchange protocol appears.

  5. View specific details about the following:

    • The Business Signals section shows the exception messages and the acknowledgment signals to exchange to confirm receipt of messages.

    • The Supported Transport Protocols section shows the supported transports for this version.

    • The Supported Security Specifications section shows the supported signing and encryption features.

    • The Parameters section shows the supported parameters for this version.

  6. Click Return to List to go to the Business Protocol Details page.

See "Viewing Exchange Protocols" for more information.

Viewing a Document Protocol

Follow these instructions to view details about a specific document protocol of a business protocol:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Click Capabilities at the top of the Trading Partner Details page.

    The Capabilities page for the selected trading partner appears.

  4. Select a specific document protocol to view in the Document Protocol column.

    The Document Protocol Details page for the selected document protocol appears.

  5. View specific details about a document protocol revision. You can manage (view, update, and delete) the revision from this page (unless it is RosettaNet, which can only be viewed).

  6. Click Return to List to return to the Business Protocol Details page.

See "Viewing a Document Protocol Revision" for more information.

Viewing a Process Protocol

OracleAS Integration B2B includes a single process protocol called the B2B process. Follow these instructions to view details about the B2B process:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Click Capabilities at the top of the Trading Partner Details page.

    The Capabilities page for the selected trading partner appears.

  4. Select a specific business protocol in the Name column.

  5. Click B2B to the right of Process Protocol in the Details section.

    The Process Protocol Details page for the selected process protocol appears.

  6. View specific details about process protocol revisions and supported document protocols.

  7. Click the process protocol revision in the Details column.

    The Process Protocol Revision Details page appears.

  8. View specific details about support for collaborations (if the RosettaNet over RNIF business protocol is selected) or business actions (if any EDI or Custom Document business protocol is selected) associated with this process protocol.

  9. Click Return to List to return to the Business Protocol Details page.

See "Managing Process Protocols" for more information.

Removing a Business Protocol from a Remote Trading Partner

Follow these instructions to remove a business protocol from a remote trading partner:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Click Capabilities at the top of the Trading Partner Details page.

    The Capabilities page for the selected trading partner appears.

  4. Select a specific business protocol to remove in the Remove column.

  1. Click Yes when prompted to remove a business protocol.

    The business protocol is removed and the Business Protocol Details page appears.

Managing Internal Delivery Channels

The host application of the trading partner is the ultimate source and destination for sending and receiving messages. The OracleAS Integration B2B user interface tool enables you to create an internal delivery channel for the host application of the host trading partner. This internal delivery channel provides the communication interface between the host application and OracleAS Integration B2B (See Figure 10-13).

You select an internal delivery channel for the host trading partner when you create a trading partner agreement. The internal delivery channel operates only within the enterprise of the host trading partner, and differs from the "external" delivery channel that enables host and remote trading partners in different enterprises to communicate.

The OracleAS Integration B2B user interface tool enables you to perform the internal delivery channel management tasks shown in Figure 10-14. These tasks are described in detail in this section. OracleAS Integration B2B provides four predefined internal delivery channels for use with Oracle Application Server Integration InterConnect and Oracle E-Business Suite:

You can also create your own internal delivery channels to use with the host trading partner host application, including separate internal delivery channels for sending and responding (acknowledgment) messages. An example of this is an environment in which your business transaction with a remote trading partner requires an acknowledgment (for example, RosettaNet Partner Interface Process (PIP) 3A4), and you want to use two separate internal delivery channels for these messages (one for inbound and the other for outbound). When you create a trading partner, select Yes from the Is acknowledgement handled By Integration B2B? list on the Create Trading Partner - Operational Capability page or Create Supported Collaboration Role page. When you create a trading partner agreement for the business protocol of this trading partner, you can select both internal delivery channels.

Figure 10-13 provides an example of a host application that includes two internal delivery channels:

Figure 10-14 Internal Delivery Channel Management Tasks

Description of Figure 10-14  follows
Description of "Figure 10-14 Internal Delivery Channel Management Tasks"


Note:

Do not update any parameters available under the Transport Parameter column in Figure 10-14. If you must update the XML Gateway Inbound or Outbound internal delivery channel endpoint names, click Partners, then Trading Partners, then host_trading_partner_name_in_the_Name_column, then Capabilities, and then business_protocol_name_in_Name_column. Then, click Update in the Endpoints section for the internal delivery channel endpoint to update.

Table 10-13 identifies the internal delivery channel management tasks shown in Figure 10-14 and provides references to procedures for performing these tasks.

Table 10-13 Internal Delivery Channel Management Tasks

Page Elements Management Task See Section...

Create button in Internal Delivery Channels section of Figure 10-14

Create an internal delivery channel

"Creating an Internal Delivery Channel"

"Example: Creating an Internal Delivery Channel Using the JMS Transport Protocol"


Transport Parameter column in Internal Delivery Channels section of Figure 10-14

View details about a transport used with an internal delivery channel. Do not update any transport parameters on this page or any pages available under it. These pages are for viewing only.

"Viewing a Business Protocol Transport"


Transport Server column in Internal Delivery Channels section of Figure 10-14

View details about a transport server used with an internal delivery channel.

"Viewing a Business Protocol Transport Server"


Delete column in Internal Delivery Channels section of Figure 10-14

Delete an internal delivery channel that you created.

"Deleting an Internal Delivery Channel"




Note:

The Is Inbound column describes the direction in which the internal delivery channel communicates. The direction is always from the perspective of the host trading partner. If the host initiates a business transaction with a remote trading partner, the direction is outbound. If the host is the recipient of a business transaction initiated by a remote trading partner, the direction is inbound.

See the following for more information:

Creating an Internal Delivery Channel

Follow these instructions to create an internal delivery channel:

Page 1: General Page

  1. Click Partners, then Trading Partners.

  2. Select the host trading partner in the Name column.

  3. Click Capabilities at the top of the Trading Partner Details page.

    The Capabilities page for the host trading partner appears.

  4. Click Create in the Internal Delivery Channels section.

    The Create Internal Delivery Channel - General page appears.

  5. Enter the following details. An asterisk (*) indicates a required field.

    Field Value
    Name * Enter a unique and recognizable name for the internal delivery channel.
    Is Inbound * Select Yes if the internal delivery channel is used for receiving an inbound message sent to OracleAS Integration B2B from a remote trading partner. Otherwise, select No for outbound messages sent from OracleAS Integration B2B to a remote trading partner.

  6. Click Next.

    The Create Internal Delivery Channel - Transport page appears.

Page 2: Transport Page

  1. Select Create New or Use Existing.

  2. Go to the following section based on your selection:

    If You Selected... Go To...
    Create New "Creating a New Transport"
    Use Existing "Using an Existing Transport"

Creating a New Transport

Follow these instructions to create a new transport for the internal delivery channel.

  1. Enter a unique and recognizable name for the transport in the Name field.

  2. Select the transport protocol to use from the Transport Protocol list.

    Selection Description
    AQ Enables applications to communicate asynchronously with OracleAS Integration B2B over a reliable, scalable, and secure communication channel. Oracle advanced queuing (AQ) provides an extremely flexible mechanism for bidirectional, asynchronous communication. Application location is transparent, using any number of Oracle's connectivity options, including OCI, JDBC, or PL/SQL. Both XML and non-XML message payloads are supported.
    JMS Enables applications to send and receive messages to and from the queues and topics administered by any Java Message Service (JMS) provider; the Oracle JMS (OJMS) and MQSeries JMS (IBM) providers can be used with OracleAS Integration B2B.
    File Enables files to be copied between applications.
    FTP Enables files to be passed with FTP between applications.

    The page refreshes based on your selection.

  3. Select Use Existing or Create New in the Transport Server section.

  4. Go to the following step based on your selection:

    If You Selected... Go To...
    Create New Step 5
    Use Existing Step 6

  5. If you selected Create New in Step 4, perform Steps 5a through 5c.

    1. Enter the following transport server details for the internal delivery channel. An asterisk (*) indicates a required field.

      Field Value
      Name * Enter a unique and recognizable name for the transport server.
      Description Enter a description for the transport server.
      Host Name * Enter the hostname of the transport server.

      Note: If using a generic exchange protocol (EDI X12 over Generic Exchange, EDI EDIFACT over Generic Exchange, or Custom Document over Generic Exchange) with the HTTP or HTTPS transport protocol, enter the IP address to use for identifying trading partners. Do not enter the hostname.

      IP Address Enter the IP address of the transport server.
      Username Enter the username for logging into the transport server.
      Password Enter the password of the username.

    2. Enter appropriate transport parameter values in the Current Value column of the Parameters section. If you select File or FTP, other parameters appear.

      Transport Protocol Field Value
      AQ Hostname Enter the name of the host on which the application database is installed.

      Port Enter the application database port number.

      SID Enter the application database system identifier (SID).

      Consumer Enter the consumer queue name. The name can be from 1 to 30 characters in length. The application that writes to the queue uses a consumer name to indicate that OracleAS Integration B2B must pick up a message.

      Leave this field blank if the queues AQ connects to on the application database side are single consumer queues. If any of the queues are multiconsumer queues, specify a consumer name.


      Recipient Enter the recipient queue name. The name can be from 1 to 30 characters in length. The application that writes to the queue uses a recipient name to indicate that OracleAS Integration B2B sent a message.

      Leave this field blank if the queues AQ connects to on the application database side are single recipient queues. If any of the queues are multirecipient queues, specify a recipient name.


      Polling Interval Enter the time interval in milliseconds during which OracleAS Integration B2B polls the server for inbound messages.
      JMS Connection Factory Location Enter the JNDI location or Java class name for the connection factory.

      Factory Provider Properties Enter the JMS vendor-specific properties to pass to the connection factory.

      Destination Provider Properties Enter the JMS vendor-specific properties to pass to the destination.

      isTopic Enter False or True to indicate if JMS is communicating with a topic. The JMS can communicate with either a topic or a queue.

      Subscriber ID Enter the subscriber ID. This is required if JMS is communicating with a topic.

      Polling Interval Enter the time interval in milliseconds during which OracleAS Integration B2B polls the server for inbound messages.

    3. Go to Step 7.

  6. If you selected Use Existing in Step 4, perform Steps 6a through 6b.

    1. Select a transport server from the Transport Server list. Note that all delivery channels appear in this list. Do not select any delivery channels used for communication between host and remote trading partners. Only delivery channels that enable communication between the host application and the host trading partner can be selected. Of the predefined internal delivery channels that appear, only XML Gateway Inbound and XML Gateway Outbound can be customized. B2B Inbound and B2B Outbound cannot be customized.

    2. Go to Step 7.

  7. Enter the following endpoint details. An asterisk (*) indicates a required field.

    Field Value
    URI * (default name) Select either of the following:
    • Create New to enter a new endpoint in the URI field.

    • Use Existing to refresh the page and display the Endpoint list for selecting an existing URI.


  8. Click Next.

    The Create Internal Delivery Channel: Review page appears and displays details about the type of internal delivery channel to create.

  9. Go to "Page 3: Review Page".

Using an Existing Transport

Follow these instructions to use an existing transport.

  1. Make a selection from the Transport Parameter list. See "Managing Internal Delivery Channels" for definitions of the predefined channels.

    • B2B Inbound

    • B2B Outbound

    • XML Gateway Inbound

    • XML Gateway Outbound

    • Internal delivery channels you previously created

  2. Click Next.

    The Create Internal Delivery Channel: Review page appears and displays details about the type of internal delivery channel to create.

  3. Go to "Page 3: Review Page".

Page 3: Review Page

  1. Review the internal delivery channel details.

    • To modify these details, click the Back button of the Create Internal Delivery Channel wizard to return to the previous pages. When you complete modifications, click Next until you access the review page; then click Finish. Do not use the Back and Forward buttons of your Web browser.

    • If you are satisfied with these details, click Finish.

    The internal delivery channel is created and the Capabilities page of the host trading partner appears. The internal delivery channel can now be selected when you create a trading partner agreement.

Example: Creating an Internal Delivery Channel Using the JMS Transport Protocol

This section provides an example of creating an internal delivery channel using the transport protocol.


Note:

Sample scripts to create JMS queues and send and receive sample JMS messages are located in Oracle_Home/tip/adapter/b2b/transport/test/jms.

  1. Open the Oracle_Home/home/config/application.xmlfile.

  2. Define the resource provider by adding the following lines immediately before the </orion-application tag. For example:

    <resource-provider class="oracle.jms.OjmsContext" name="JMS_b2b"> 
         <description>OJMS Context using thin JDBC</description> 
         <property name="url" value="jdbc:oracle:thin:sunbox2005:1521:b2bdev" /> 
         <property name="username" value="b2b" /> 
         <property name="password" value="b2b" /> 
     </resource-provider> 
    
    
    Where... Is...
    Hostname sunbox2005

    Note: This is the host on which the database with OJMS is installed.

    Port 1521
    SID b2bdev
    Username b2b
    Password b2b

  3. Enter values appropriate to your environment.

  4. If Oracle Application Server Java Authentication and Authorization Service (JAAS) Provider (JAZN) security is activated in the application.xml file, disable the following line with comment markers:

    <!-- jazn.provider="XML" location="./jazn-data.xml"/ --> 
    
    
  5. Open the Oracle_Home/home/config/principals.xml file.

  6. Activate the admin user by removing deactiviated="true" from the end of the following line.

    <user username="admin" password="welcome">
    
    
  7. Disable the following line with comment markers:

    <!-- server host="myhost" port="1089" username="admin" password="welcome" /--> 
    
    
  8. Identify the remote method invocation (RMI) port value in the Oracle_Home/home/config/rmi.xml file. This value is required for the java.naming.provider.url value in the Destination Provider Properties field of Step 10c.

  9. Place the application-client.xml file in the classes/META-INF/ directory. The application-client.xml file must be empty between the start and end tags:

    <application-client> 
    </application-client> 
    
    
  10. Create an internal delivery channel in the OracleAS Integration B2B user interface tool.


    Note:

    Specific examples are provided for some of the fields of the Create Internal Delivery Channel wizard. You must also provide appropriate values for other fields.

    1. Select JMS from the Transport Protocol list.

    2. Enter the following endpoint details in the Transport Server section:

      Field Value Example
      Username This value maps to the jms.sender.destination_username property b2b
      Password This value maps to the jms.sender.destination_password property b2b

    3. Enter appropriate transport parameter values in the Current Value column of the Parameters section.

      Field Value Example
      Connection Factory Location This value maps to jms.sender.jndi_connection_factory_location java:comp/resource/JMS_b2b/QueueConnectionFactories/qcf
      Factory Provider Properties This value maps to jms.sender.factory_provider_properties java.naming.factory.initial=com.evermind.server.rmi.RMIInitialContextFactory;java.naming.security.credentials=welcome;java.naming.security.principal=admin;java.naming.provider.url=opmn:ormi://144.25.141.184:6004
      Destination Provider Properties This value maps to jms.sender.destination_provider_properties java.naming.factory.initial=com.evermind.server.rmi.RMIInitialContextFactory;java.naming.security.credentials=welcome;java.naming.security.principal=admin;java.naming.provider.url=opmn:ormi://144.25.141.184:6004

      In the case of the Factory Provider Properties field, specify the java.naming.provider.url value based on the OC4J status:

      If OC4J Is a... Then...
      Standalone installation The value takes the form:

      ormi://myhost:1089, where 1089 is the RMI port in the rmi.xml file.

      Middle-tier installation The value takes the form:

      opmn:ormi://myhost:6004, where 6004 is the request port defined in Oracle_Home/opmn/conf/opmn.xml.


    4. Enter the name of the destination location in the URI field of the Endpoints section. This maps to the jms.sender.jndi_destination_location property. For example:

      java:comp/resource/JMS_b2b/Queues/B2B_JMS_INQUEUE
      
      

      where JMS_b2b is the resource provider defined in application.xml and B2B_JMS_INQUEUE is the name of the JMS queue.


      Note:

      Do not prefix this value with jms://; this is automatically added.

Troubleshooting the JMS Internal Delivery Channel

  • Ensure that Oracle_Home/dms/diagnostics/lib/ojdl.jar is in the CLASSPATH.

  • Check if OC4J is a standalone or middle-tier installation. The JNDI naming URL value is different in both cases.

  • Ensure that OC4J is running.

  • Ensure that the admin user is not deactivated. Check the principals.xml file.

  • Ensure that the RMI port is correct. Check the rmi.xml file.

  • Ensure that the jazn-xml line is commented out in the application.xml file (or user admin is activated in the jazn-data.xml file).

  • Restart OC4J after making any changes to the application.xml and principals.xml files.

Example: Creating File/FTP Internal Delivery Channels

To create a File internal delivery channel using the OracleAS Integration B2B user interface tool:


Note:

Fields and checkboxes for which you should accept default values, or leave blank, are omitted in the following steps.

  1. Click Partners, then Trading Partners.

  2. Click the name of the host trading partner.

  3. Click Capabilities.

  4. Under Internal Delivery Channels, click Create.

  5. On the Create Internal Delivery Channel - General page, provide the following information and click Next.

    Field Value
    Name File Outbound
    Is Inbound No

  6. On the Create Internal Delivery Channel - Transport page, provide the following information and click Next.

    1. Select Create New and provide the following information:

      General Field Value
      Name File Outbound Transport

      Transport Protocol Field Value
      Transport Protocol File

    2. Select Create New and provide the following information:

      Transport Server Field Value
      Name File Outbound Server
      Host Name local_hostname

      The transport server exchanging messages at the host trading partner site.


    3. Select Create New and provide the following information:

    Endpoint Field Value
    URI /private/GlobalChips

    For inbound messages, the endpoint is the directory where you want the file to be placed.


  7. Review the data and click Finish, or make changes using Back.

    You should see Internal Delivery Channel created successfully at the top of the page.

To create an FTP internal delivery channel using the OracleAS Integration B2B user interface tool:

  1. Click Partners, then Trading Partners.

  2. Click the name of the host trading partner.

  3. Click Capabilities.

  4. Under Internal Delivery Channels, click Create.

  5. On the Create Internal Delivery Channel - General page, provide the following information and click Next.

    Field Value
    Name FTP Outbound
    Is Inbound No

  6. On the Create Internal Delivery Channel - Transport page, provide the following information and click Next.

    1. Select Create New and provide the following information:

      General Field Value
      Name FTP Outbound Transport

      Transport Protocol Field Value
      Transport Protocol FTP

    2. Select Create New and provide the following information:

      Transport Server Field Value
      Name FTP Transport Server
      Host Name local_hostname

      The transport server exchanging messages at the host trading partner site.


    3. Select Create New and provide the following information:

    Endpoint Field Value
    URI /private/Acme

    For outbound messages, the endpoint is the directory on the host server that is polled.


  7. Review the data and click Finish, or make changes using Back.

    You should see Internal Delivery Channel created successfully at the top of the page.

File Name Restrictions

The outbound message file name must provide the following information to OracleAS Integration B2B:

Field Value (Using EDI X12 as an Example)
To Trading Partner Name Acme
Doc Type X12 - 850 Purchase Order
DocType Revision X12 - 4010
MessageType 1 - Request

2 - Response

3 - Acknowledgment

4 - Error

MessageId A unique number
ReplyToMsgId Optional
extension Any string

Outbound file name format required from source:

<ToTP>
<DocType>
<DocTypeRevision>
<MessageType>
<MessageId>
<ReplyToMsgId>
<extension>

Example:

GlobalChips_850_4010_1_12345.xml

Inbound file name format generated by OracleAS Integration B2B:

<FromTP>
<DocType>
<DocTypeRevision>
<MessageType>
<MessageId>
<ReplyToMsgId>
<extension>

Example:

Acme_855_4010_1_54321.xml

Deleting an Internal Delivery Channel

You can only delete internal delivery channels that you created. Follow these instructions to delete an internal delivery channel:

  1. Click Partners, then Trading Partners.

  2. Select the host trading partner in the Name column.

  3. Click Capabilities at the top of the Trading Partner Details page.

    The Capabilities page for the host trading partner appears.

  4. Select a specific internal delivery channel to delete in the Delete column of the Internal Delivery Channels section.

  5. Click Yes when prompted to delete an internal delivery channel.

    The internal delivery channel is deleted and the Capabilities page for the host trading partner appears.

Managing Business Protocol Collaborations

The OracleAS Integration B2B user interface tool enables you to perform the collaboration management tasks for the RosettaNet over RNIF business protocol shown in Figure 10-15. These tasks are described in detail in this section. Collaborations consist of a set of partner interface processes (PIPs) that define the capabilities of a trading partner in a business transaction (such as buyer and seller). Collaborations apply only to the RosettaNet over RNIF business protocol, and not to any EDI or Custom Document business protocols. In the OracleAS Integration B2B user interface tool, trading partners define their operational capabilities by the collaborations they support.

Figure 10-15 Business Protocol Collaboration Management Tasks

Description of Figure 10-15  follows
Description of "Figure 10-15 Business Protocol Collaboration Management Tasks"

Table 10-14 identifies the business protocol collaboration management tasks shown in Figure 10-15 and provides references to procedures for performing these tasks.

Table 10-14 Business Protocol Collaboration Management Tasks

Page Elements Management Task See Section...

Create Operational Capability button of Figure 10-15

Note: The host trading partner is automatically assigned a collaboration that is compatible with the selection for the remote trading partner.

Select support for a collaboration (which includes a PIP) and a collaboration role (for example, buyer or seller) for the RosettaNet over RNIF business protocol (trading partners define their operational capabilities by the collaborations they support)

Chapter 9, "Creating Trading Partners"


Details column in Supported Collaborations section of Figure 10-15

View details about support for a collaboration

"Viewing a Business Protocol Collaboration"


Update column in Supported Collaborations section of Figure 10-15

Update support for a collaboration

"Updating a Business Protocol Collaboration"


Delete column in Supported Collaborations section of Figure 10-15

Delete support for a collaboration

"Deleting a Business Protocol Collaboration"




Note:

You must have already created or imported support for a collaboration for it to display in the Business Protocol Details page.

Viewing a Business Protocol Collaboration

Follow these instructions to view details about a specific collaboration for the RosettaNet over RNIF business protocol:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Click Capabilities at the top of the Trading Partner Details page.

    The Capabilities page for the selected trading partner appears.

  4. Select the RosettaNet over RNIF business protocol in the Name column.

  5. Select a specific collaboration to view in the Details column of the Supported Collaborations section.

    The Supported Collaboration Role Details page for the selected collaboration appears.

  6. View specific details, including the following:

    • Collaboration role (for example, buyer or seller)

    • Collaboration (for example, PIP 3A4)

    • Version (for example, V02.00)

    • If acknowledgment is handled by OracleAS Integration B2B

    • The time to perform the collaboration

    • If any validation rules are associated with the business protocol collaboration

    This page, as with the Business Protocol Details page shown in Figure 10-15, enables you to delete or update the selected collaboration.

  7. Click Return to List to return to the Capabilities page.

Updating a Business Protocol Collaboration

Follow these instructions to update a collaboration for the RosettaNet over RNIF business protocol:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Click Capabilities at the top of the Trading Partner Details page.

    The Capabilities page for the selected trading partner appears.

  4. Select the RosettaNet over RNIF business protocol in the Name column.

  5. Select a specific collaboration to update in the Update column of the Supported Collaborations section.

    The Update Supported Collaboration Role page appears.

  6. Make appropriate updates:

    Field Value
    Collaboration Role Select an appropriate update from the list. The following list is an example of what can appear. The collaboration roles that display are based upon those that you imported or created. Each selection combines a role (for example, Buyer), a collaboration (for example, PIP 3A4), and a version (for example, V02.00).
    • Buyer - 3A4 - V02.00

    • Buyer - 3A6 - V02.00

    • Buyer - 3A7 - V02.00

    • Buyer - 3A8 - V02.00

    • Failure Report Administrator - 0A1 - V02.00

    • PIP Report Administrator - 0A1 - V02.00

    • Receiver - 3B2 - V01.00

    • Seller - 3A4 - V02.00

    • Seller - 3A6 - V02.00

    • Seller - 3A7 - V02.00

    • Seller - 3A8 - V02.00

    • Shipper - 3B2 - V01.00

    Is acknowledgement handled by Integration B2B? Select No or Yes.

    If Yes is selected, OracleAS Integration B2B handles acknowledgment. If No is selected, the application handles acknowledgment.

    Time To Perform Update the time in minutes in which to process the support for a collaboration. This value overrides the value defined by the collaboration.

  7. Click Apply.

    The business protocol collaboration is updated and the Collaboration Role Details page appears.

Deleting a Business Protocol Collaboration

Follow these instructions to delete support for a collaboration for the RosettaNet over RNIF business protocol:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Click Capabilities at the top of the Trading Partner Details page.

    The Capabilities page for the selected trading partner appears.

  4. Select the RosettaNet over RNIF business protocol in the Name column.

  5. Select a specific collaboration to delete in the Delete column of the Supported Collaborations section.

  1. Click Yes when prompted to delete a collaboration.

    The collaboration is deleted and the Business Protocol Details page appears.

Managing Business Protocol Business Actions

The OracleAS Integration B2B user interface tool enables you to perform the business action management tasks shown in Figure 10-16. These tasks are described in detail in this section. Business actions define the roles played in a configuration between trading partners in a business transaction (such as initiator and responder). Business actions apply to any EDI or Custom Document business protocols, and not to the RosettaNet over RNIF business protocol. In the OracleAS Integration B2B user interface tool, trading partners define their operational capabilities by the business actions they support.

Figure 10-16 Business Protocol Business Action Management Tasks

Description of Figure 10-16  follows
Description of "Figure 10-16 Business Protocol Business Action Management Tasks"

Table 10-15 identifies the business protocol business action management tasks shown in Figure 10-16 and provides references to procedures for performing these tasks.

Table 10-15 Business Protocol Business Action Management Tasks

Page Elements Management Task See Section...

Create Operational Capability button of Figure 10-16

Note: The host trading partner is automatically assigned a business action that is compatible with the selection for the remote trading partner.

Select support for a business action for an EDI or Custom Document business protocol (trading partners define their operational capabilities by the business actions they support)

Chapter 9, "Creating Trading Partners"


Name column in Supported Business Actions section of Figure 10-16

View details about support for a business action

"Viewing a Business Protocol Business Action"


Update column in Supported Business Actions section of Figure 10-16

Update support for a business action

"Updating a Business Protocol Business Action"


Delete column in Supported Business Actions section of Figure 10-16

Delete support for a business action

"Deleting a Business Protocol Business Action"




Note:

You must have already created or imported support for a business action for it to display in the Business Protocol Details page.

Viewing a Business Protocol Business Action

Follow these instructions to view details about a specific business action of an EDI or Custom Document business protocol:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Click Capabilities at the top of the Trading Partner Details page.

    The Capabilities page for the selected trading partner appears.

  4. Select a specific EDI or Custom Document business protocol in the Name column.

  5. Select a specific business action to view in the Name column of the Supported Business Actions section.

    The Supported Business Action Details page for the selected business action appears.

  6. View specific details, including support for the business action, initiator status, functional acknowledgment, and if acknowledgment is handled by OracleAS Integration B2B. You can also view document information, such as the document protocol, document protocol revision, document type, document definition, and document protocol parameter settings.

    This page, as with the Business Protocol Details page shown in Figure 10-16, enables you to delete or update the selected business action.

  7. Click Return to List to return to the Business Protocol Details page.

Updating a Business Protocol Business Action

Follow these instructions to update support for a business action of an EDI or Custom Document business protocol:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Click Capabilities at the top of the Trading Partner Details page.

    The Capabilities page for the selected trading partner appears.

  4. Select a specific EDI or Custom Document business protocol in the Name column.

  5. Select a specific business action to update in the Update column of the Supported Business Actions section.

    The Update Supported Business Action page appears.

  6. Make appropriate updates.

    Field Value
    Is Initiator * Select False or True.
    Functional acknowledgement required? * Select No or Yes.
    Is acknowledgement handled by Integration B2B? * Select No or Yes.

    If Yes is selected, OracleAS Integration B2B handles acknowledgment. If No is selected, the application handles acknowledgment.

    Use Existing Document Definition Deselect to change the default settings.
    Use Default Document Definition Select to change the default settings.
    Document Protocol Parameters Override values in the New Value column. You can also import interchange or group .ecs files.

    Note: .ecs files are only applicable to the EDI business protocol.


  7. Click Apply.

    The business action is updated and the Supported Business Action Details page appears.

Deleting a Business Protocol Business Action

Follow these instructions to delete support for a business action of an EDI or Custom Document business protocol:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Click Capabilities at the top of the Trading Partner Details page.

    The Capabilities page for the selected trading partner appears.

  4. Select a specific EDI or Custom Document business protocol in the Name column.

  5. Select a specific business action to delete in the Delete column of the Supported Business Actions section.

  1. Click Yes when prompted to delete a business action.

    The business action is deleted and the Business Protocol Details page appears.

Managing Business Protocol Delivery Channels

The OracleAS Integration B2B user interface tool enables you to perform the delivery channel management tasks shown in Figure 10-17. These tasks are described in detail in this section. The delivery channel describes whether security characteristics such as nonrepudiation of origin and receipt, acknowledgment mode, time to acknowledge, retry count, transport security, encryption, and file compression are required. The delivery channel also includes the following:

A business protocol can have multiple delivery channels. To create a trading partner agreement, you must create a delivery channel. When you create a trading partner agreement, you can assign only one delivery channel to the agreement.

In the OracleAS Integration B2B user interface tool, delivery channels are part of the communication capabilities of the supported business protocol.

Figure 10-17 Delivery Channel Management Tasks

Description of Figure 10-17  follows
Description of "Figure 10-17 Delivery Channel Management Tasks"

Table 10-16 identifies the delivery channel management tasks shown in Figure 10-17 and provides references to procedures for performing these tasks.

Table 10-16 Delivery Channel Management Tasks

Page Elements Management Task See Section...

Create Communication Capability button of Figure 10-17

Starts the Create Trading Partner wizard to guide you through creation of a delivery channel, document exchange, transport, transport server, and endpoint (pages 4 through 7 of the wizard)

"Creating Business Protocol Communication Capabilities for the Host and Remote Trading Partners"


Name column in Delivery Channels section of Figure 10-17

View details about a delivery channel (including the associated document exchange and transport)

"Viewing a Business Protocol Delivery Channel"


Update column in Delivery Channels section of Figure 10-17

Update a delivery channel

"Updating a Business Protocol Delivery Channel"


Delete column in Delivery Channels section of Figure 10-17

Delete a delivery channel

"Deleting a Business Protocol Delivery Channel"




Note:

The transport and document exchange associated with the delivery channel display in the Document Exchange and Transport columns of the Delivery Channels section. (See Figure 10-17.)

Viewing a Business Protocol Delivery Channel

Follow these instructions to view details about a specific delivery channel:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Click Capabilities at the top of the Trading Partner Details page.

    The Capabilities page for the selected trading partner appears.

  4. Select a specific business protocol in the Name column.

  5. Select a specific delivery channel in the Name column of the Delivery Channels section.

    The Delivery Channel Details page for the selected delivery channel appears.

  1. View specific details, including the delivery channel name, document exchange (with a link to that details page), transport (with a link to that details page), acknowledgment mode, global usage code, nonrepudiation of receipt or origin support, encryption support, transport security support, time to acknowledgment value, and retry count value.

    This page, as with the Business Protocol Details page shown in Figure 10-17, enables you to delete or update the selected delivery channel.

  2. Click Return to List to return to the Business Protocol Details page.

Updating a Business Protocol Delivery Channel

Follow these instructions to update a delivery channel:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Click Capabilities at the top of the Trading Partner Details page.

    The Capabilities page for the selected trading partner appears.

  4. Select a specific business protocol in the Name column.

  5. Select a specific delivery channel to update in the Update column of the Delivery Channels section.

    The Update Delivery Channel page appears.

  6. Make appropriate updates. An asterisk (*) indicates a required field.

    Field Value
    Name * Enter a unique and recognizable name for the delivery channel.
    Document Exchange Select a document exchange to use with this delivery channel.
    Transport Select a transport to use with this delivery channel.
    Acknowledgement Mode Select Async, None, or Sync for the mode in which the trading partner receives messages.
    Global Usage Code Select Production or Test.

    This specifies the usage of the delivery channel. If set to Test, the delivery channel is used only for testing purposes. If set to Production, it is used only for production purposes. This parameter is used mainly with RNIF.

    Is Non-Repudiation of Receipt Required Cannot be updated on this page. You must create a new delivery channel to update this value.
    Is Non-Repudiation of Origin Required Cannot be updated on this page. You must create a new delivery channel to update this value.
    Encryption Enabled Cannot be updated on this page. You must create a new delivery channel to update this value.
    Transport Security Enabled Select No or Yes.

    If you select Yes, a secure transport protocol, security specification, and remote trading partner certificate are necessary. You must update these details on the Update Transport page.

    Compression Enabled Select No or Yes.

    This field applies only to the AS2 exchange protocol. By default, OracleAS Integration B2B signs the message before encrypting it.

    Time To Acknowledgement Enter a value in minutes. This value specifies the time in which an acknowledgment message must be received. If an acknowledgment is not received, an error message is returned.
    Retry Count Enter a value. This value specifies the number of times to retry.

  7. Click Apply.

    The delivery channel is updated and the Delivery Channel Details page appears.

Deleting a Business Protocol Delivery Channel

Follow these instructions to delete a delivery channel:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Click Capabilities at the top of the Trading Partner Details page.

    The Capabilities page for the selected trading partner appears.

  4. Select a specific business protocol in the Name column.

  5. Select a specific delivery channel to delete in the Delete column of the Delivery Channels section.

  1. Click Yes when prompted to delete a delivery channel.

    The delivery channel is deleted and the Business Protocol Details page appears.

Managing Business Protocol Document Exchanges

The OracleAS Integration B2B user interface tool enables you to perform the document exchange management tasks shown in Figure 10-18. These tasks are described in detail in this section. The document exchange describes the supported exchange protocol revision (such as RosettaNet 01.10) and, if being used, credential encryptions, signing credentials, digital envelopes, digital signatures, and validation support. The document exchange uses these capabilities to exchange messages with a trading partner.

In the OracleAS Integration B2B user interface tool, document exchanges are part of the communication capabilities of the business protocol. A document exchange is associated with a delivery channel that you assign to a trading partner agreement.

Figure 10-18 Document Exchange Management Tasks

Description of Figure 10-18  follows
Description of "Figure 10-18 Document Exchange Management Tasks"

Table 10-17 identifies the document exchange management tasks shown in Figure 10-18 and provides references to procedures for performing these tasks.

Table 10-17 Document Exchange Management Tasks

Page Elements Management Task See Section...

Create Communication Capability button of Figure 10-18

Starts the Create Trading Partner wizard to guide you through creation of a delivery channel, document exchange, transport, transport server, and endpoint (pages 4 through 7 of the wizard)

"Creating Business Protocol Communication Capabilities for the Host and Remote Trading Partners"


Name column in Document Exchanges section of Figure 10-18

View details about a document exchange

"Viewing a Business Protocol Document Exchange"


Exchange Protocol Revision column in Document Exchanges section of Figure 10-18

View details about an exchange protocol revision

"Viewing Exchange Protocols"


Update column in Document Exchanges section of Figure 10-18

Update a document exchange

"Updating a Business Protocol Document Exchange"


Name column in Document Exchanges section of Figure 10-18 (to access a page to delete a document exchange)

Delete a document exchange

"Deleting a Business Protocol Document Exchange"




Note:

The exchange protocol revision of this document exchange displays in the Exchange Protocol Revision column of the Document Exchanges section. (See Figure 10-18.)

Viewing a Business Protocol Document Exchange

Follow these instructions to view details about a specific document exchange:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Click Capabilities at the top of the Trading Partner Details page.

    The Capabilities page for the selected trading partner appears.

  4. Select a specific business protocol in the Name column.

  5. Select a specific document exchange to view in the Name column of the Document Exchanges section.

    The Document Exchange Details page for the selected document exchange appears.

  1. View specific details, including exchange protocol parameters, exchange protocols, digital envelopes, encryption credentials, digital signatures, signing credentials, and validation support in the Details section at the top of the page.

    This page, as with the Business Protocol Details page shown in Figure 10-18, enables you to update the selected document exchange. You can also delete the document exchange from this page.

  2. Click Return to List to return to the Business Protocol Details page.

Updating a Business Protocol Document Exchange

Follow these instructions to update a document exchange:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Click Capabilities at the top of the Trading Partner Details page.

    The Capabilities page for the selected trading partner appears.

  4. Select a specific business protocol in the Name column.

  5. Select a specific document exchange to update in the Update column of the Document Exchanges section.

    The Update Document Exchange page appears.

  1. Make appropriate updates. An asterisk (*) indicates a required field.

    Field Value
    Exchange Protocol Revision * Select the exchange protocol revision to use. The revisions that appear are based on the exchange protocol you are using:
    • If using RNIF, select RosettaNet - 01.10 or RosettaNet - V02.00.

    • If using Generic Exchange, select Generic 1.0.

    • If using AS, select AS2 - 1.1

    Exchange Protocol Parameters Change appropriate exchange protocol parameters values.

    If you are using the AS2 exchange protocol, the parameter Signed and Compressed equals true means that OracleAS Integration B2B by default signs the message before compressing it.


  2. Click Apply.

    The document exchange is updated and the Document Exchange Details page appears.

Deleting a Business Protocol Document Exchange

Follow these instructions to delete a document exchange:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Click Capabilities at the top of the Trading Partner Details page.

    The Capabilities page for the selected trading partner appears.

  4. Select a specific business protocol in the Name column.

  5. Select a specific document exchange to delete in the Name column of the Document Exchanges section.

    The Document Exchange Details page appears.

  6. Click Delete to delete the document exchange.

  1. Click Yes when prompted to delete the document exchange.

    The document exchange is deleted and the Business Protocol Details page appears.

Managing Business Protocol Transports

The OracleAS Integration B2B user interface tool enables you to perform the transport management tasks shown in Figure 10-19. These tasks are described in detail in this section. The transport defines the properties specific to a given usage of a protocol endpoint. The transport is responsible for message delivery using the selected transport protocol (such as HTTP 1.1), mode (synchronous or asynchronous), server, and protocol endpoint address (trading partner address, such as a URI).

In the OracleAS Integration B2B user interface tool, transports are part of the communication capabilities of the business protocol. A transport is associated with a delivery channel that you assign to a trading partner agreement.

Figure 10-19 Transport Management Tasks

Description of Figure 10-19  follows
Description of "Figure 10-19 Transport Management Tasks"

Table 10-18 identifies the transport management tasks shown in Figure 10-19 and provides references to procedures for performing these tasks.

Table 10-18 Transport Management Tasks

Page Elements Management Task See Section...

Create Communication Capability button of Figure 10-19

Starts the Create Trading Partner wizard to guide you through creation of a delivery channel, document exchange, transport, transport server, and endpoint (pages 4 through 7 of the wizard)

"Creating Business Protocol Communication Capabilities for the Host and Remote Trading Partners"


Name column in Transports section of Figure 10-19

View details about a transport

"Viewing a Business Protocol Transport"


Update column in Transports section of Figure 10-19

Update a transport

"Updating a Business Protocol Transport"


Name column in Transports section of Figure 10-19 (to access a page to delete a transport)

Delete a transport

"Deleting a Business Protocol Transport"




Note:

The transport server and URI for this transport also display in the Transport Server and URI columns, respectively, of the Transports section. (See Figure 10-19.)

Viewing a Business Protocol Transport

Follow these instructions to view details about a specific transport:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Click Capabilities at the top of the Trading Partner Details page.

    The Capabilities page for the selected trading partner appears.

  4. Select a specific business protocol in the Name column.

  5. Select a specific transport to view in the Name column of the Transports section.

    The Transport Details page for the selected transport appears.

  1. View specific details about the transport protocol (for example, HTTP), transport server name, URI (trading partner endpoint address), and transport parameters (such as the port number and additional transport headers).

    If you selected a transport server for a predefined internal delivery channel, the URI is the specific internal endpoint to which it applies.

    This page, as with the Business Protocol Details page shown in Figure 10-19, enables you to update the selected transport. You can also delete the transport from this page.

  2. Click Return to List to return to the Business Protocol Details page.

See "Viewing a Business Protocol Endpoint" for the internal endpoints that apply to each internal delivery channel.

Updating a Business Protocol Transport

Follow these instructions to update a transport:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Click Capabilities at the top of the Trading Partner Details page.

    The Capabilities page for the selected trading partner appears.

  4. Select a specific business protocol in the Name column.

  5. Select a specific transport to update in the Update column of the Transports section.

    The Update Transport Parameter page appears.

  1. Make appropriate updates. An asterisk (*) indicates a required field.

    Field Value
    Transport Protocol Select a transport protocol (for example, HTTP).
    Transport Server Select a transport server.
    Endpoint Select an endpoint. All endpoints in the OracleAS Integration B2B user interface tool display for selection.

  2. Click Apply.

    The transport is updated and the Transport Details page appears.

Deleting a Business Protocol Transport

Follow these instructions to delete a transport:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Click Capabilities at the top of the Trading Partner Details page.

    The Capabilities page for the selected trading partner appears.

  4. Select a specific business protocol in the Name column.

  5. Select a specific transport to delete in the Name column of the Transports section.

    The Transport Details page appears.

  6. Click Delete to delete the transport.

  7. Click Yes when prompted to delete the transport.

    The transport is deleted and the Business Protocol Details page appears.

Managing Business Protocol Transport Servers

The OracleAS Integration B2B user interface tool enables you to perform the transport server management tasks shown in Figure 10-20. These tasks are described in detail in this section. The transport server is the endpoint server name for the trading partner.

In the OracleAS Integration B2B user interface tool, transport servers are part of the communication capabilities of the business protocol. A transport server is associated with a delivery channel that you assign to a trading partner agreement.

Figure 10-20 Transport Server Management Tasks

Description of Figure 10-20  follows
Description of "Figure 10-20 Transport Server Management Tasks"

Table 10-19 identifies the transport server management tasks shown in Figure 10-20 and provides references to procedures for performing these tasks.

Table 10-19 Transport Server Management Tasks

Page Elements Management Task See Section...

Create Communication Capability button of Figure 10-20

Starts the Create Trading Partner wizard to guide you through creation of a delivery channel, document exchange, and transport (pages 4 through 7 of the wizard)

"Creating Business Protocol Communication Capabilities for the Host and Remote Trading Partners"


Name column in Transport Servers section of Figure 10-20

View details about a transport server

"Viewing a Business Protocol Transport Server"


Update column in Transport Servers section of Figure 10-20

Update a transport server

"Updating a Business Protocol Transport Server"


Name column in Transport Servers section of Figure 10-20 (to access a page to delete a transport server)

Delete a transport server

"Deleting a Business Protocol Transport Server"




Note:

The transport protocol and the server host name for this transport server also display in the Transport Protocol and Host Name columns, respectively, of the Transport Servers section. (See Figure 10-20.)

Viewing a Business Protocol Transport Server

Follow these instructions to view a transport server:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Click Capabilities at the top of the Trading Partner Details page.

    The Capabilities page for the selected trading partner appears.

  4. Select a specific business protocol in the Name column.

  5. Select a specific transport server to view in the Name column of the Transport Servers section.

    The Transport Server Details page for the selected transport server appears.

  1. View specific details about the trading partner name, server name, server protocol used (for example, HTTP), IP address, server username, server password, and transport protocol parameter values (such as the port number of the server and additional transport headers).

    This page, as with the Business Protocol Details page shown in Figure 10-20, enables you to update the selected transport server. You can also delete the transport server from this page.

  2. Click Return to List to return to the Business Protocol Details page.

Updating a Business Protocol Transport Server

Follow these instructions to update a transport server:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Click Capabilities at the top of the Trading Partner Details page.

    The Capabilities page for the selected trading partner appears.

  4. Select a specific business protocol in the Name column.

  5. Select a specific transport server to update in the Update column of the Transport Servers section.

    The Update Transport Server page appears.

  6. Make appropriate updates. An asterisk (*) indicates a required field.


    Note:

    Any updates that you make on this page must always include updating the password. If you update any other field, but do not update the password, you receive an error at run time. The password you enter can be the same one you previously specified.

    Field Value
    Description Update a description for the transport server.
    Host Name * Update the hostname of the transport server.
    IP Address Update the IP address of the transport server.
    Username Update the username for logging into the transport server.
    Password Update the password of the username.
    Transport Parameter Values Update appropriate parameters. The parameters that appear are based on the transport protocol you are using: HTTP 1.0, HTTP 1.1, Email 1.0, FTP 1.0, or File 1.0. For example, if you are using HTTP 1.0 or 1.1, you can update the following parameters:
    • HTTP port number of the server

    • The additional transport headers, which store name and value pairs. A valid setting for this parameter takes the format name1=value1;name2=value2;...name_n=value_n, where name1 through name_n equals the header name, and value1 through value_n equals the header value of the HTTP protocol.


  7. Update appropriate parameter values in the Transport Parameter Values section.

  8. Click Apply.

    The transport is updated and the Transport Server Details page appears.

Deleting a Business Protocol Transport Server

Follow these instructions to delete a transport server:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Click Capabilities at the top of the Trading Partner Details page.

    The Capabilities page for the selected trading partner appears.

  4. Select a specific business protocol in the Name column.

  5. Select a specific transport server to delete in the Name column of the Transport Server section.

    The Transport Server Details page appears.

  6. Click Delete to delete the transport server.

  7. Click Yes when prompted to delete the transport server.

    The transport server is deleted and the Business Protocol Details page appears.

Managing Business Protocol Endpoints

The OracleAS Integration B2B user interface tool enables you to perform the endpoint management tasks shown in Figure 10-21. These tasks are described in detail in this section. Endpoints are trading partner addresses (typically a URI). An endpoint includes a protocol endpoint, which is a combination of a specific endpoint address (such as http://server.partner.com:5555/submit/rnmsg) and transport protocol (such as HTTP 1.1). Endpoints are global to all trading partners.

In the OracleAS Integration B2B user interface tool, endpoints are part of the communication capabilities of the business protocol. An endpoint is associated with a delivery channel that you assign to a trading partner agreement.

Figure 10-21 Endpoint Management Tasks

Description of Figure 10-21  follows
Description of "Figure 10-21 Endpoint Management Tasks"

Table 10-20 identifies the endpoint management tasks shown in Figure 10-21 and provides references to procedures for performing these tasks.

Table 10-20 Endpoint Management Tasks

Page Elements Management Task See Section...

Create Communication Capability button of Figure 10-21

Starts the Create Trading Partner wizard to guide you through creation of a delivery channel, document exchange, transport, transport server, and endpoint (pages 4 through 7 of the wizard)

"Creating Business Protocol Communication Capabilities for the Host and Remote Trading Partners"


URI column in Endpoints section of Figure 10-21

View details about an endpoint

"Viewing a Business Protocol Endpoint"


Update column in Endpoints section of Figure 10-21

Update an endpoint

"Updating a Business Protocol Endpoint"


Delete column in Endpoints section of Figure 10-21

Delete an endpoint

"Deleting a Business Protocol Endpoint"


URI column in Endpoints section of Figure 10-21

View details about a protocol endpoint of a business protocol endpoint

"Viewing a Protocol Endpoint of a Business Protocol Endpoint"


URI column in Endpoints section of Figure 10-21 (to access a page for updating a protocol endpoint)

Update a protocol endpoint of a business protocol endpoint

"Updating a Protocol Endpoint of a Business Protocol Endpoint"


URI column in Endpoints section of Figure 10-21 (to access a page for deleting a protocol endpoint)

Delete a protocol endpoint of a business protocol endpoint

"Deleting a Protocol Endpoint of a Business Protocol Endpoint"



Viewing a Business Protocol Endpoint

Follow these instructions to view details about a specific endpoint:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Click Capabilities at the top of the Trading Partner Details page.

    The Capabilities page for the selected trading partner appears.

  4. Select a specific business protocol in the Name column.

  5. Select a specific endpoint to view in the URI column of the Endpoints section. OracleAS Integration B2B includes four predefined, internal endpoints that cannot be deleted. Each endpoint is associated with a specific internal delivery channel to enable communication between the host application and the host trading partner's installation of OracleAS Integration B2B.

    • apps.ECX_INBOUND

      Associated with the XML Gateway Inbound internal delivery channel. You can update the URI of this internal delivery channel.

    • apps.ECX_OUTBOUND

      Associated with the XML Gateway Outbound internal delivery channel. You can update the URI of this internal delivery channel.

    • b2b.IP_IN_QUEUE

      Associated with the B2B Inbound internal delivery channel

    • b2b.IP_OUT_QUEUE

      Associated with the B2B Outbound internal delivery channel

    The Endpoint Details page for the selected endpoint appears.

  6. View specific details about the URI endpoint address and the transport protocol used. You can also manage the protocol endpoint of the business protocol endpoint from this page.

    This page, as with the Business Protocol Details page shown in Figure 10-21, enables you to delete or update the selected endpoint.

  7. Click Return to List to return to the Business Protocol Details page.

    See the following for more information:

Updating a Business Protocol Endpoint

Follow these instructions to update an endpoint:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Click Capabilities at the top of the Trading Partner Details page.

    The Capabilities page for the selected trading partner appears.

  4. Select a specific business protocol in the Name column.

  5. Select a specific endpoint to update in the Update column of the Endpoints section.

    The Update Endpoints page appears.

  6. Make appropriate changes to the URI (endpoint address) and description.

  7. Click Apply.

    The endpoint is updated and the Endpoint Details page appears.

Deleting a Business Protocol Endpoint

Follow these instructions to delete an endpoint:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Click Capabilities at the top of the Trading Partner Details page.

    The Capabilities page for the selected trading partner appears.

  4. Select a specific business protocol in the Name column.

  5. Select a specific endpoint to delete in the Delete column of the Endpoints section.

  6. Click Yes when prompted to delete an endpoint.

    The endpoint is deleted and the Business Protocol Details page appears.

Viewing a Protocol Endpoint of a Business Protocol Endpoint

Follow these instructions to view details about a specific protocol endpoint of a business protocol endpoint:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Click Capabilities at the top of the Trading Partner Details page.

    The Capabilities page for the selected trading partner appears.

  4. Select a specific business protocol in the Name column.

  5. Select a specific endpoint to view in the URI column of the Endpoints section.

    The Endpoint Details page for the selected endpoint appears.

  6. Select a specific protocol endpoint to view in the Details column of the Protocol Endpoints section.

    The Protocol Endpoint Details page for the selected endpoint appears.

  7. View specific details about the endpoint and transport protocol that comprise this protocol endpoint.

    This page, as with the Endpoint Details page, enables you to delete or update the selected protocol endpoint.

  8. Click Return to List to return to the Endpoint Details page.

  9. Click Return to List to return to the Business Protocol Details page.

Updating a Protocol Endpoint of a Business Protocol Endpoint

Follow these instructions to update a protocol endpoint of a business protocol endpoint:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Click Capabilities at the top of the Trading Partner Details page.

    The Capabilities page for the selected trading partner appears.

  4. Select a specific business protocol in the Name column.

  5. Select a specific endpoint in the URI column of the Endpoints section.

    The Endpoint Details page for the selected endpoint appears.

  6. Select a specific protocol endpoint to update in the Update column of the Protocol Endpoints section.

    The Update Protocol Endpoint page appears.

  7. Make appropriate updates. An asterisk (*) indicates a required field.

    Field Value
    Endpoint * Update the endpoint used with this endpoint.
    Transport Protocol Update the transport endpoint used with this endpoint.

  8. Click Apply.

    The protocol endpoint is updated and the Protocol Endpoint Details page appears.

Deleting a Protocol Endpoint of a Business Protocol Endpoint

Follow these instructions to delete a protocol endpoint of a business protocol endpoint:

  1. Click Partners, then Trading Partners.

  2. Select a specific trading partner in the Name column.

  3. Click Capabilities at the top of the Trading Partner Details page.

    The Capabilities page for the selected trading partner appears.

  4. Select a specific business protocol in the Name column.

  5. Select a specific endpoint in the URI column of the Endpoints section.

    The Endpoint Details page for the selected endpoint appears.

  6. Select a specific protocol endpoint to delete in the Delete column of the Protocol Endpoints section.

  7. Click Yes when prompted to delete a protocol endpoint.

    The protocol endpoint is deleted and the Endpoint Details page appears.

Common User Errors

Chapter Summary

This chapter first describes how to manage trading partners and their business protocol operational and communication capabilities that you previously created. This chapter begins with a brief overview of the main management pages in the OracleAS Integration B2B user interface tool (Trading Partner Details page, Capabilities page, and Business Protocol Details page). The remaining sections describe the specific tasks you can perform from these pages.