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
 

8 Managing Business Protocols

This chapter describes the tasks required to manage business protocols. You assign support for business protocols to the remote trading partner. The host trading partner is automatically assigned support for all business protocols in Oracle Application Server Integration B2B.

This chapter contains the following topics:

Business Protocol Management Overview

Each trading partner must have support for a business protocol. The business protocol identifies the implementation guidelines to use for the reliable transport of messages between trading partners. You use the OracleAS Integration B2B user interface tool to create operational capability and communication capabilities for the selected business protocol of the trading partner. Trading partners define their operational capabilities by the support for a business action (for any EDI, HL7, or Custom Document business protocol) or collaboration (for the RosettaNet over RNIF business protocol).

The business protocol is comprised of three protocols: document, exchange, and process (of which business actions and collaborations are a part). Figure 8-1 shows the business protocol format. Figure 8-2 shows a specific example of the type of process, document, and exchange protocol details that can display for a business protocol (in this example, RosettaNet over RNIF). This format is reflected in the layout of the OracleAS Integration B2B user interface tool (and shown throughout this chapter).

Figure 8-1 Business Protocol Format

Description of Figure 8-1  follows
Description of "Figure 8-1 Business Protocol Format"

Figure 8-2 Business Protocol Format: RosettaNet Example

Description of Figure 8-2  follows
Description of "Figure 8-2 Business Protocol Format: RosettaNet Example"


Note:

Figure 8-2 shows a .dtd file as the document definition file with RosettaNet over RNIF. You can also specify .xsd files as the document definition file. OracleAS Integration B2B enables you to either import standard .dtd files downloaded from the RosettaNet Web site or import .xsd or .dtd files created with the OracleAS Integration B2B - Document Editor. At run time, the payload must conform to the document definition file type you use.

See "Supported Protocols" for more information.

Collaborations and Business Actions Overview

Figure 8-1 and Figure 8-2 show that collaborations and business actions appear as part of the process protocol for a business protocol. Collaborations and business actions describe the business documents and their movement between trading partners. Trading partners define their operational capabilities by the collaborations and business actions they support. When you create a remote trading partner with the Create Trading Partner wizard, you assign it either support for a collaboration (for the RosettaNet over RNIF business protocol) or business action (for any EDI, HL7, or Custom Document business protocol). The host trading partner is automatically assigned a business action or collaboration that is compatible with the selection for the remote trading partner.

Collaborations and business actions can be bidirectional. When you create support for a collaboration or business action of a trading partner, you also specify whether the trading partner initiates or responds to the collaboration.

The OracleAS Integration B2B user interface tool provides two methods for creating support for collaborations and business actions. Table 8-1 describes these methods:

Table 8-1 Methods for Creating Support for Collaborations and Business Actions

Method Description

Import through a file

The following frequently used collaborations, transaction sets, and standards are automatically installed with OracleAS Integration B2B. You can import them into the design-time repository. This enables you to see and use them in the OracleAS Integration B2B user interface tool.

  • Approximately 25 RosettaNet collaborations. See Table 3-2, "RosettaNet PIPs Supported in OracleAS Integration B2B" for a list.

  • EDI X12, document protocol revision 4010 with transaction sets 850 purchase order, 855 purchase order acknowledgment, and 997 functional acknowledgment

  • EDI EDIFACT, document protocol revision D98A with transaction sets ORDERS purchase order message and ORDRSP purchase order response message, and document protocol revision D3 with transaction set CONTRL syntax and service report message

  • HL7, document protocol revision 2.3.1 with document type A01

  • UCCnet, document protocol revision 2.3.1 (available under Custom Document support)

An EDI transaction set maps to a document type of a business action in the OracleAS Integration B2B user interface tool.

After importing these files by clicking Administration, then Management, and then Import, the business actions and collaborations display in the Process Protocol Revision Details page. (See Figure 8-7 and Figure 8-8, respectively.) You can then assign support for collaborations and business actions to a remote trading partner with the Create Trading Partner wizard.

Create through wizards

You can create your own support for collaborations and business actions with the Create Collaboration wizard and Create Business Action wizard, respectively. Use of both wizards is described in this chapter.

For example, if you want to use a RosettaNet collaboration that is not included in the import file described previously, you can use the Create Collaboration wizard.

Once complete, you can assign support for collaborations and business actions to a remote trading partner.


See the following for more information:

OracleAS Integration B2B - Document Editor Overview

When you use the Create Business Action and Create Collaboration wizards, you are prompted to import document definition files. You can use OracleAS Integration B2B - Document Editor to create these files for EDI X12, EDI EDIFACT, HL7 and RosettaNet documents. OracleAS Integration B2B - Document Editor is an integrated guideline creation and implementation application for creating business-to-business (B2B) electronic commerce.

You can use OracleAS Integration B2B - Document Editor library of templates to create EDI X12 and EDI EDIFACT .ecs files and RosettaNet and HL7 .xsd and .dtd files that you then import into the OracleAS Integration B2B user interface tool with the Create Business Action wizard and Create Collaboration wizard. This enables you to create configurations with OracleAS Integration B2B trading partners that use EDI X12, EDI EDIFACT, HL7, and RosettaNet.

The OracleAS Integration B2B - Document Editor is also compatible with older files. Older .ecs files are upgraded (if you confirm to upgrade when prompted) before they are read. If you want to read an older version of a .xsd file, the output is Import, then Importing the file, then Convert from XML Schema (XSD).


Note:

OracleAS Integration B2B - Document Editor requires .NET 1.1 to be installed.

You can install OracleAS Integration B2B - Document Editor from the root of the OracleAS Integration B2B CD-ROM.

See the following for more information:

  • Oracle Application Server Integration B2B Installation Guide for instructions on installing OracleAS Integration B2B - Document Editor

  • The online Help included with the OracleAS Integration B2B - Document Editor for instructions on using the library templates to create .ecs, .xsd, and .dtd files

Viewing Business Protocols

The OracleAS Integration B2B user interface tool enables you to view the business protocols. The remote trading partner must add support for a business protocol before doing anything else.

  1. Click Partners, then Protocols.

    The Business Protocols page displays the business protocols available with OracleAS Integration B2B. The Description column describes the contents of the business protocol.

    Description of tab_protocols.gif follows
    Description of the illustration tab_protocols.gif

    Continuation of the protocols tab
    Description of the illustration tab_protocols_more.gif

  2. Click a specific business protocol to access the Business Protocol Details page. This page shows details about the document, exchange, and process protocols of the business protocol. The management tasks you can perform are described in detail in the remaining sections of this chapter.

See the following for more information:

Managing Document Protocols

The OracleAS Integration B2B user interface tool enables you to perform the document protocol management tasks shown in Figure 8-4 through Figure 8-6. These tasks are described in detail in this section. The document protocol defines the document type of the message payload.

Business protocols can have multiple document protocols. Document protocols follow the hierarchy shown in Figure 8-3. A document protocol can consist of multiple document protocol revisions. A document protocol revision can consist of multiple document types. A document type can consist of multiple document definitions, because you can start with one document definition and customize it for different trading partners. In this example, the document definition file is a .xsd file.

Figure 8-3 Document Protocol Hierarchy

Description of Figure 8-3  follows
Description of "Figure 8-3 Document Protocol Hierarchy"

Figure 8-4 Document Protocol Management Tasks (Part 1 of 3)

Description of Figure 8-4  follows
Description of "Figure 8-4 Document Protocol Management Tasks (Part 1 of 3)"

Clicking Details in the Document Protocol Revisions section of Figure 8-4 causes the Document Protocol Revision Details page shown in Figure 8-5 to appear.

Figure 8-5 Document Protocol Management Tasks (Part 2 of 3)

Description of Figure 8-5  follows
Description of "Figure 8-5 Document Protocol Management Tasks (Part 2 of 3)"

Clicking a specific document type (850 for this example) in the Name column of the Document Types section of Figure 8-5 causes the Document Type Details page shown in Figure 8-6 to appear. A document type consists of multiple document definitions, because you can start with one document definition and customize it for different trading partners.

Figure 8-6 Document Protocol Management Tasks (Part 3 of 3)

Description of Figure 8-6  follows
Description of "Figure 8-6 Document Protocol Management Tasks (Part 3 of 3)"

Table 8-2 identifies the document protocol management tasks shown in Figure 8-4 through Figure 8-6 and provides references to procedures for performing these tasks.

Table 8-2 Document Protocol Management Tasks

Page Elements Management Task See Section...

Create button in Document Protocol Revisions section of Figure 8-4

Create a document protocol revision

"Creating a Document Protocol Revision"


Details column in Document Protocol Revisions section of Figure 8-4

View details about a document protocol revision

"Viewing a Document Protocol Revision"


Update column in Document Protocol Revisions section of Figure 8-4

Update a document protocol revision

"Updating a Document Protocol Revision"


Delete column in Document Protocol Revisions section of Figure 8-4

Delete a document protocol revision

"Deleting a Document Protocol Revision"


Create button in Document Types section of Figure 8-5

Create a document type

"Creating a Document Type"


Name column in Document Types section of Figure 8-5

View details about a document type

"Viewing a Document Type"


Update column in Document Types section of Figure 8-5

Update a document type

"Updating a Document Type"


Delete column in Document Types section of Figure 8-5

Delete a document type

"Deleting a Document Type"


Name column in Document Definitions section of Figure 8-6

View details about a document definition

"Viewing a Document Definition of a Document Type"


Update column in Document Definitions section of Figure 8-6

Update a document definition

"Updating a Document Definition of a Document Type"




Note:

RosettaNet document protocol support is provided for only version 2.0. Regardless of the collaboration (PIP) version you create or import, the supported document protocol revision version is 2.0.

See "Document Protocols" for more information.

Creating a Document Protocol Revision

The Create Business Action and Create Collaboration wizards enable you to create a document protocol revision as part of a single wizard session. You can also individually create a document protocol revision without using the wizards. Follow these instructions to individually create a document protocol revision. Once created, you can use the wizards to select this document protocol revision to be part of support for a business action or collaboration.

  1. Click Partners, then Protocols.

  2. Select a specific business protocol in the Name column of the Business Protocols section.

    The Business Protocol Details page appears.

  3. Click Create in the Document Protocol Revisions section.

    The Create Document Protocol Revision page appears.

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

    Field Value
    Name * Enter a unique and recognizable name for the document protocol revision.
    Description Enter a description of the document protocol revision.
    Revision * Enter a revision number for the document protocol revision.
    Translation Enabled Select No or Yes.
    Validation Enabled Select No or Yes.

    If you enable validation outside of the OracleAS Integration B2B user interface tool (for example, in EDI X12 or EDI EDIFACT), performance is impacted.

    Document Protocol Parameters

    Note: This field only displays for EDI or Custom Document business protocols.

    Enter specific values in the Override Value fields. You can also import interchange or group .ecs files that can optionally be created with the OracleAS Integration B2B - Document Editor.

  5. Click Apply.

    The document protocol revision is created and the new Document Protocol Revision Details page appears.

Viewing a Document Protocol Revision

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

  1. Click Partners, then Protocols.

  2. Select a specific business protocol in the Name column of the Business Protocols section.

    The Business Protocol Details page appears.

  3. Select a specific document protocol revision to view in the Details column of the Document Protocol Revisions section.

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

  1. View specific details about the document protocol revision:

    • The business protocol and document protocol for this document protocol revision

    • The document protocol revision description, revision number, and status of translation and validation (in the Details section)

    • The document types and revisions of this document protocol revision

    • The document protocol parameters and their default and override values for this document protocol revision

    See Figure 8-5 for an example of the Document Protocol Revision Details page.

    This page, as with the Business Protocol Details page shown in Figure 8-4, enables you to delete or update the document protocol revision (except for RosettaNet).

Updating a Document Protocol Revision

You can update all document protocol revisions with the exception of RosettaNet. Follow these instructions to update a document protocol revision:

  1. Click Partners, then Protocols.

  2. Select a specific business protocol in the Name column of the Business Protocols section.

    The Business Protocol Details page appears.

  3. Select a specific document protocol revision to update in the Update column of the Document Protocol Revisions section.

    The Update Document Protocol Revision page appears.

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

    Field Value
    Name * Update with a unique and recognizable name for the document protocol revision.
    Description Update the description of the document protocol revision.
    Revision * Update the revision number for the document protocol revision.
    Translation Enabled Select No or Yes.
    Validation Enabled Select No or Yes.

    If you enable validation outside of the OracleAS Integration B2B user interface tool (for example, in EDI X12 or EDI EDIFACT), performance is impacted.

    Document Protocol Parameters Make appropriate updates to specific values in the Override Value fields. You can import .ecs files.

  5. Click Apply.

    The document protocol revision is updated and the Document Protocol Revision Details page appears.

Deleting a Document Protocol Revision

You can delete all document protocol revisions with the exception of RosettaNet. Follow these instructions to delete a document protocol revision:

  1. Click Partners, then Protocols.

  2. Select a specific business protocol in the Name column of the Business Protocols section.

    The Business Protocol Details page appears.

  3. Select a specific document protocol revision to delete in the Delete column of the Document Protocol Revisions section.

  4. Click Yes when prompted to delete a document protocol revision.

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

Creating a Document Type

The Create Business Action and Create Collaboration wizards enable you to create a document type as part of a single wizard session. You can also individually create a document type without using the wizards. Follow these instructions to individually create a document type. Once created, you can use the wizards to select the document type of a specific document protocol revision. This provides support for a business action or collaboration.

  1. Click Partners, then Protocols.

  2. Select a specific business protocol in the Name column of the Business Protocols section.

    The Business Protocol Details page appears.

  3. Select a specific revision in the Details column of the Document Protocol Revisions section.

  4. Click Create in the Document Types section.

    The Create Document Type page appears.

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

    Field Value
    Details
    • Name *
    Enter a unique and recognizable name for the document type.
    • Description
    Enter a description of the document type.
    • Revision *
    Enter a revision number for the document type.
    Document Definition
    • Name *
    Enter a unique and recognizable name for the document definition.
    • Description
    Enter a description of the document definition.
    • Translation Enabled
    Select No or Yes.
    • Validation Enabled
    Select No or Yes.

    Note: If you are using globalization support with OracleAS Integration B2B, do not select Yes.

    • Definition
    Click Browse to select a document definition file.
    • Starting XSD File Path
    Click Browse to select the root XSD file name if the document definition file is a ZIP file.
    • Document Type Parameters

      Note: This section only appears for an EDI or Custom Document business protocol.

    Enter values in the Override Value fields or click Browse to select a .ecs transaction set file that can optionally be created with the OracleAS Integration B2B - Document Editor.

  6. Click Apply.

    The document type is created and the new Document Type Details page appears.

    You can now select this document type in the Create Business Action wizard. To do this, you must perform the following steps:

    1. Select the specific document protocol revision of which this document type is a part on the Create Business Action: Document Protocol Revision page (page two of four).

    2. Select Use Existing from the Create Mode list on the Create Business Action: Document Type page (page three of four). The page refreshes to display a Document Type list from which you can select this document type. While the document protocol revision can include multiple document types, only a single type can be selected. The EDI and Custom Document business protocols enable you to select only a single document type for a document protocol revision.

    You can now include this document type in a collaboration in the Create Collaboration wizard. To do this, you must perform the following steps:

    1. Select the specific document protocol revision of which this document type is a part on the Create Collaboration: General page (page one of five). This document protocol revision can include multiple document types. RosettaNet enables you to have multiple document types included with a single document protocol revision.

See the following for more information:

Viewing a Document Type

  1. Click Partners, then Protocols.

  2. Select a specific business protocol in the Name column of the Business Protocols section.

    The Business Protocol Details page appears.

  3. Select a specific document protocol revision in the Details column of the Document Protocol Revisions section.

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

  1. Select a specific document type to view in the Name column of the Document Types section.

    The Document Type Details page for the selected document type appears.

  2. View specific details about the document type:

    • The business protocol and its associated document protocol and document protocol revision for this document type

    • The document definitions and values of this document type. You can also manage the document definitions for this document type.

    See Figure 8-6 for an example of the Document Type Details page.

    This page, as with the Document Protocol Revision Details page shown in Figure 8-5, enables you to delete or update the document type.

Updating a Document Type

Follow these instructions to update a document type:

  1. Click Partners, then Protocols.

  2. Select a specific business protocol in the Name column of the Business Protocols section.

    The Business Protocol Details page appears.

  3. Select a specific document protocol revision in the Details column of the Document Protocol Revisions section.

    The Document Protocol Revision Details page appears.

  4. Select a specific document type to update in the Update column of the Document Types section.

    The Update Document Type page appears.

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

    Field Value
    Name * Update with a unique and recognizable name for the document type.
    Description Update the description of the document type.
    Revision * Update the revision number for the document type.

    Note: If this document type is for the RosettaNet over RNIF business protocol, this number must match the document type revision number. If they do not match, you receive an error after deployment. If you imported the predefined RosettaNet collaborations, both revision numbers automatically match.

    See "Updating a Collaboration" for more information.

    Document Definition * Select a document definition from the list.

  6. Click Apply.

    The document type is updated and the Document Type Details page appears.

Deleting a Document Type

Follow these instructions to delete a document type:

  1. Click Partners, then Protocols.

  2. Select a specific business protocol in the Name column of the Business Protocols section.

    The Business Protocol Details page appears.

  3. Select a specific document protocol revision in the Details column of the Document Protocol Revisions section.

    The Document Protocol Revision Details page appears.

  4. Select a specific document type to delete in the Delete column of the Document Types section.

  5. Click Yes when prompted to delete a document type.

    The document type is deleted and the Document Protocol Revision Details page appears.

Viewing a Document Definition of a Document Type

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

  1. Click Partners, then Protocols.

  2. Select a specific business protocol in the Name column of the Business Protocols section.

    The Business Protocol Details page appears.

  3. Select a specific document protocol revision in the Details column of the Document Protocol Revisions section.

    The Document Protocol Revision Details page appears.

  1. Select a specific document type in the Name column of the Document Types section.

    The Document Type Details page appears.

  2. Select a specific document definition to view in the Name column of the Document Definitions section.

    The Document Definition Details page for the selected document definition appears.

  3. View specific details about the document definition:

    • The business protocol and its document protocol and document protocol revision for the document definition

    • The document definition description and the statuses of document definition translation and validation (in the Details section)

    • The document parameters and values of this document definition

    This page, as with the Document Type Details page shown in Figure 8-6, enables you to update the document definition.

Updating a Document Definition of a Document Type

Follow these instructions to update a document definition:

  1. Click Partners, then Protocols.

  2. Select a specific business protocol in the Name column of the Business Protocols section.

    The Business Protocol Details page appears.

  3. Select a specific revision in the Details column of the Document Protocol Revisions section.

    The Document Protocol Revision Details page appears.

  4. Select a specific document type in the Name column of the Document Types section.

    The Document Type Details page appears.

  5. Select a specific document definition to update in the Update column of the Document Definitions section.

    The Update Document Definition page appears.

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

    Field Value
    Name * Update with a unique and recognizable name for the document definition.
    Description Update the description of the document definition.
    Translation Enabled Select No or Yes.
    Validation Enabled Select No or Yes.

    Note: If you are using globalization support with OracleAS Integration B2B, do not select Yes.

    Definition Click Browse to select a document definition file (typically a .xsd file).
    Parameters Make appropriate updates to specific values in the Override Value fields. You can also import specific files for EDI or Custom Document business protocols as needed.

  7. Click Apply.

    The document definition is updated and the Document Definition Details page appears.

Configuring the XPath Expression for a Custom XML Document

The XPath expression identifies a custom XML document. You configure the XPath expression when you specify the document type parameters. See Chapter 7, "Custom XML Document Tutorial" for an example.

You have the following options when configuring an XPath expression:

  • Specify the XPath and matching value

    Assuming that the transaction ID is 12345, set the parameters as follows:

    Field Value
    Identification Value 12345
    Identification Expression //*[local-name() = 'TransactionID']/text()

    OracleAS Integration B2B compares the value of Identification Expression in the payload to the value specified in Identification Value. If the values match, then the document is identified successfully.

  • Check for the existence of a node

    Assume that you are checking for the existence of a node called registerCommand. Set the parameters as follows:

    Field Value
    Identification Value Leave blank.
    Identification Expression /*[local-name()='envelope']/body/transaction/command/*[local-name()='registerCommand']

    When the Identification Value field is left blank, OracleAS Integration B2B checks for the node identified in Identification Expression. If a node in the payload matches, then the document is identified successfully.

  • Check the value of an attribute

    Assume that the value of the country attribute is US. Set the parameters as follows:

    Field Value
    Identification Value US
    Identification Expression //*/@country

    OracleAS Integration B2B compares the value of the country attribute to the Identification Value. If the values match, then the document is identified successfully.

Example: Creating a UCCNet Custom Document

  1. Click Partners, then Protocols.

  2. Click Custom Document over ebMS.

  3. From Shortcut, click Create Business Action.

  4. On the Create Business Action: General page, provide the following information and click Next.

    Field Value
    Name Process registerCommand
    Revision 1.0

  5. On the Create Business Action: Document Protocol Revision page, provide the following information and click Next.

    Field Value
    Name UCCnet
    Revision 2.4

  6. On the Create Business Action: Document Type page, provide the following information and click Next.

    General Field Value
    Name registerCommand DocType
    Revision 1.0

    Document Definition Field Value
    Name registerCommand DocumentDefinition
    Definition Upload the ZIP file containing the UCCnet schemas.
    Starting XSD File Path Enter the path in the ZIP file to Envelope.xsd.

  7. After entering the preceding parameters, specify the Identification Value and Identification Expression() for the XML document.

Viewing Exchange Protocols

The OracleAS Integration B2B user interface tool enables you to view exchange protocol details. The exchange protocol defines the headers, acknowledgments, and packaging that puts the headers and payload together (the message exchange mechanism). The exchange protocol also defines exchange-level security—signing and encryption—and transport protocols for the exchange.

Follow these instructions to view exchange protocol revision details:

  1. Click Partners, then Protocols.

  2. Select a specific business protocol in the Name column of the Business Protocols section.

    The Business Protocol Details page appears.

  3. Select a specific exchange protocol revision to view in the Details column of the Exchange Protocol Revisions section. (See Figure 8-4.)

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

  4. View specific details about the following:

    • The Details section, which shows revision, description, status or nonrepudiation of origin and receipt, number of retries allowed, time to acknowledge, status of request retry messages, implementation class, packaging protocol, and packaging identification

      From the Exchange Protocol Revision Details page, you can click the Packaging Id value to see the Packaging Id Details page, which describes the packaging for the protocol you selected.

      From the Exchange Protocol Revision Details page, you can also click the Packaging Protocol value to see the Packaging Protocol Details page, which lists the packaging IDs for the packaging protocol you are using.

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

    • The Protocol Elements section, which shows message header details such as preamble header, delivery header, and service header, whether these details can be encrypted, and their datatypes.

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

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

    • The Parameters section, which shows the supported parameters for this version

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


Note:

  • The Exchange Protocol Revision Details page can also be accessed by clicking Partners, then Trading Partners, then trading_partner_name_in_Name_column, then Capabilities, then business_protocol_name_in_Name_column, and then exchange_protocol_revision_name_in_Exchange_Protocol_Revision_column (in Document Exchanges section).

  • Support is not provided for remote trading partner-to-remote trading partner message routing. Messages are always exchanged with the host trading partner. If you must route messages from one remote trading partner to another remote trading partner, you must do so outside of the OracleAS Integration B2B user interface tool.


See "Exchange Protocols" for more information.

Managing Process Protocols

The OracleAS Integration B2B user interface tool enables you to perform the process protocol management tasks shown in Figure 8-7 and Figure 8-8. These tasks are described in detail in this section. OracleAS Integration B2B provides a single process protocol named B2B Process. This process protocol is included with all business protocols supported by OracleAS Integration B2B. The process protocol defines the business actions (for any EDI, HL7, or Custom Document (such as UCCnet) business protocols) and the collaborations (for the RosettaNet over RNIF business protocol) that are associated with specific document types.

Figure 8-7 Process Protocol Management Tasks for any EDI, HL7, or Custom Document Business Protocol

Description of Figure 8-7  follows
Description of "Figure 8-7 Process Protocol Management Tasks for any EDI, HL7, or Custom Document Business Protocol"

Figure 8-8 Process Protocol Management Tasks for RosettaNet over RNIF Business Protocol

Description of Figure 8-8  follows
Description of "Figure 8-8 Process Protocol Management Tasks for RosettaNet over RNIF Business Protocol"

Table 8-3 identifies the process protocol management tasks shown in Figure 8-7 and Figure 8-8 and provides references to procedures for performing these tasks.

Table 8-3 Process Protocol Management Tasks

Page Elements Management Task See Section...

Create button in Business Actions section of Figure 8-7

Create a business action

"Creating a Business Action"


Details column in Business Actions section of Figure 8-7

View details about a business action

"Viewing a Business Action"


Update column in Business Actions section of Figure 8-7

Update a business action

"Updating a Business Action"


Delete column in Business Actions section of Figure 8-7

Delete a business action

"Deleting a Business Action"


Create button in Collaborations section of Figure 8-8

Create a collaboration

"Creating a Collaboration"


Details column in Collaborations section of Figure 8-8

View details about a collaboration

"Viewing a Collaboration"


Update column in Collaborations section of Figure 8-8

Update a collaboration

"Updating a Collaboration"


Delete column in Collaborations section of Figure 8-8

Delete a collaboration

"Deleting a Collaboration"




Note:

The revision for each business action and collaboration displays in the Revision column of the Business Actions and Collaborations sections. (See Figure 8-7 and Figure 8-8.)

See "Process Protocols" for more information.

Creating a Business Action

You can import some of the most frequently used EDI EDIFACT and EDI X12 transaction sets and UCCnet standards into the OracleAS Integration B2B user interface tool by clicking Administration, then Management, and then Import.

For transaction sets not included in the import file, OracleAS Integration B2B provides a Create Business Action wizard that enables you to create additional business actions for any EDI, HL7, or Custom Document business protocol. Use of this wizard is described in this section. You can use the OracleAS Integration B2B - Document Editor to create the .ecs files that you are prompted to import when creating a business action with this wizard.

Regardless of whether you use the import or create business action method, you can then assign support for a business action to a remote trading partner in either of two ways. Trading partners define their operational capabilities by the business actions they support.

  • With the Create Trading Partner Wizard (on the Create Trading Partner: Operational Capability page when you initially create the remote trading partner)

  • Through the Create Operational Capability button of the Business Protocol Details page for the business protocol assigned to the remote trading partner you previously created

The Create Business Action wizard provides a series of pages that guide you through business action creation. Table 8-4 provides an overview of the wizard pages that appear and the types of questions for which you are prompted to provide details. Before using this wizard, review the information shown in Table 8-4.

Table 8-4 Create Business Action Wizard Pages

Page Description

Page 1: General Page

Prompts you to define the following general business action details:

  • Business action name, description, and revision number

  • Retry count and time to acknowledge values

  • If nonrepudiation of receipt and nonrepudiation of origin are required

  • Acknowledgment mode

Page 2: Document Protocol Revision

Prompts you to define the following document protocol revision details:

  • Document protocol revision name, description, and revision number

  • If document protocol revision translation and validation are to be performed by OracleAS Integration B2B

  • Document protocol parameter values

You can also import interchange or group .ecs files created with the OracleAS Integration B2B - Document Editor.

Page 3: Document Type

Prompts you to define the following document type details:

  • Document type name, description, and revision number

  • Document definition name and description

  • If document type translation and validation are to be performed by OracleAS Integration B2B

  • Document definition file to import

  • Document protocol parameter values

You can also import the document definition file.

Page 4: Review

Prompts you to review details about the following selections you made on the previous pages:

  • Business action name and revision

  • Document protocol revision name and revision

  • Document type and definition


Follow these tasks to create a business action with the Create Business Action wizard:

See Chapter 9, "Creating Trading Partners" for instructions on assigning support for a business action to a remote trading partner.

Page 1: General Page

Follow these instructions to create and define the details of a business action:

  1. Click Partners, then Protocols.

  2. Click a specific EDI or Custom Document business protocol in the Name column of the Business Protocols section.

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

  3. Start the Create Business Action wizard in either of two ways:

    1. Click Create Business Action in the Shortcut section.

      or

    1. Click Details in the Process Protocol Revisions section.

    2. Click Create in the Business Actions section.

    The Create Business Action: General page appears and displays the selected business protocol and its process protocol and process protocol revision in the top left part of the page. These details appear on each remaining page of the wizard.

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

    Field Value
    Name * Enter a unique and recognizable name for the business action.
    Description Enter a description of the business action.
    Revision * Enter a revision number for the business action.
    Retry Count Enter a value. This value specifies the amount of time to wait before retrying.
    Time To Acknowledge 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.
    Is Non-Repudiation of Receipt Required Select No or Yes.

    You can override this selection when you create the delivery channel (the communication capabilities) for the trading partner.

    Is Non-Repudiation of Origin Required Select No or Yes.

    You can override this selection when you create the delivery channel (the communication capabilities) for the trading partner.

    Acknowledgement Mode Select Async, None, or Sync.

  5. Click Next.

    The Create Business Action: Document Protocol Revision page appears.

See Chapter 9, "Creating Trading Partners" for instructions on creating a delivery channel (the communication capabilities).

Page 2: Document Protocol Revision

Follow these instructions to create a document protocol revision. An example of a document protocol revision is revision 4010 if you are using an EDI X12 business protocol or revision D98A or D3 if you are using an EDI EDIFACT business protocol.

  1. If this business protocol already includes a document protocol revision, the Create Mode list appears. Select Use Existing or Create New. Otherwise, go to Step 3.

  2. Go to the following step based on your mode selection:

    If You Selected... Go To...
    Create New Step 3
    Use Existing Step 4

  3. If you selected Create New or the Create Mode list did not appear, perform Steps 3a through 3b.

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

      Field Value
      Name * Enter a unique and recognizable name for the document protocol revision.
      Description Enter a description of the document protocol revision.
      Revision * Enter a revision number for the document protocol.
      Translation Enabled Select No or Yes. This enables OracleAS Integration B2B to perform translation.
      Validation Enabled Select No or Yes.

      This enables OracleAS Integration B2B to perform validation. If you enable validation outside of the OracleAS Integration B2B user interface tool (for example, in EDI X12 or EDI EDIFACT), performance is impacted.

      Note: If you are using globalization support with OracleAS Integration B2B, do not select Yes.

      See Oracle Application Server Integration B2B Installation Guide for additional globalization issues.

      Document Protocol Parameters Enter specific values for parameters in the Override Value fields or import appropriate interchange or group .ecs parameter files that can optionally be created with the OracleAS Integration B2B - Document Editor.

      Note: You can override the values you specify or the files you import when you create a trading partner in "Page 3: Operational Capability Page".


    2. Go to Step 5.

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

    1. Select a document protocol revision from the Document Protocol Revision list.

    2. Go to Step 5.

  1. Click Next.

    The Create Business Action: Document Type page appears.

Page 3: Document Type

Follow these instructions to create a document type under a document protocol revision that defines the business document. A document type maps to a transaction set in an EDI EDIFACT or X12 transaction set (for example, document type 850 or 855 for EDI X12 document protocol revision 4010). This page also enables you to import definition and .ecs files that define document type parameters.

  1. If the document protocol revision you selected in "Page 2: Document Protocol Revision" already includes a document type, the Create Mode list appears. Select Use Existing or Create New. Otherwise, go to Step 3.

  2. Go to the following step based on your mode selection:

    If You Selected... Go To...
    Create New Step 3
    Use Existing Step 4

  3. If you selected Create New or the Create Mode list did not appear, perform Steps 3a through 3b.

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

      Field Value
      General
      • Name *
      Enter a unique and recognizable name for the document type. This must be a correct document type name, such as 850 or 997 for EDI X12 or ORDERS or ORDRSP for EDI EDIFACT.
      • Description
      Enter a description of the document type.
      • Revision *
      Select a revision number for the document type.
      Document Definition
      • Name *
      Enter a unique and recognizable name for the document definition.
      • Description
      Enter a description of the document definition.
      • Translation Enabled
      Select Yes or No.
      • Validation Enabled
      Select Yes or No.

      Note: If you are using globalization support with OracleAS Integration B2B, do not select Yes.

      • Definition
      Click Browse to select a document definition file created with the OracleAS Integration B2B - Document Editor. (typically a .xsd file).
      • Starting XSD File Path
      Click Browse to select the root XSD file name if the document definition file is a ZIP file.
      Document Type Parameters Make appropriate updates to specific values in the Override Value fields or import appropriate transaction set .ecs parameter files created with the OracleAS Integration B2B - Document Editor. If the parameter is a string, you can enter a value of up to 100 characters.

      Note: You can override the values you specify or the files you import when you create a trading partner in "Page 3: Operational Capability Page".


    2. Go to Step 5.

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

    1. Select a document type from the Document Type list.

    2. Go to Step 5.

  1. Click Next.

    The Create Business Action: Review page appears and displays your selections from the previous pages.

Page 4: Review

  1. Review the business action details.

    • To modify these details, click the Back button of the Create Business Action 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 business action is created and the new Business Action Details page appears.

    You can now assign support for this business action to a remote trading partner as follows:

    • On the Operational Capability page of the Create Trading Partner wizard (page three of seven)

    • On the Operational Capability page, which is accessible from the Create Operational Capability button of the Business Protocol Details page for any EDI, HL7, or Custom Document business protocol assigned to the trading partner. (Click Partners, then Trading Partners, then trading_partner_name_in_Name_column, then Capabilities, and then business_protocol_name_in_Name_column.)

  2. Click Return to List to return to the Process Protocol Revision Details page.

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

See Chapter 9, "Creating Trading Partners" for instructions on assigning support for a business action to a remote trading partner.

Viewing a Business Action

Follow these instructions to view a business action:

  1. Click Partners, then Protocols.

  2. Click a specific EDI or Custom Document business protocol in the Name column of the Business Protocols section.

  3. Click Details in the Process Protocol Revisions section.

    The Process Protocol Revision Details page appears.

  4. Select the specific business action to view in the Details column of the Business Actions section.

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

  5. View specific details, including the following:

    • The business protocol and its process protocol and process protocol revision

    • The description, revision, retry count, time to acknowledge, nonrepudiation of origin and receipt statuses, and acknowledgment mode (in the Details section)

    • The document type, which you can manage (remove and view) from this page

    This page, as with the Process Protocol Revision Details page shown in Figure 8-7, enables you to delete or update the business action.

  6. Click Return to List to return to the Process Protocol Revision Details page.

Updating a Business Action

Follow these instructions to update a business action:

  1. Click Partners, then Protocols.

  2. Click a specific EDI or Custom Document business protocol in the Name column of the Business Protocols section.

  3. Click Details in the Process Protocol Revisions section.

    The Process Protocol Revision Details page appears.

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

    The Update Business Action page appears.

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

    Field Value
    Name * Update with a unique and recognizable name for the business action.
    Description Update the description of the business action.
    Revision * Update the revision number for the business action.
    Retry Count Update the retry count value for the business action.
    Time To Acknowledge Update the time limit for performing this business action.
    Is Non-Repudiation of Receipt Required Select No or Yes.
    Is Non-Repudiation of Origin Required Select No or Yes.
    Acknowledgement Mode Select Async, None, or Sync.

  6. Click Apply.

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

Deleting a Business Action

Follow these instructions to delete a business action:

  1. Click Partners, then Protocols.

  2. Click a specific EDI or Custom Document business protocol in the Name column of the Business Protocols section.

  3. Click Details in the Process Protocol Revisions section.

    The Process Protocol Revision Details page appears.

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

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

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

Creating a Collaboration

You can import approximately 25 of the most frequently used RosettaNet collaborations (for example, RosettaNet Partner Interface Process (PIP) 3A4) into the OracleAS Integration B2B user interface tool by clicking Administration, then Management, and then Import.

For collaborations not included in the import file, OracleAS Integration B2B provides a Create Collaboration wizard that enables you to create additional collaborations for the RosettaNet over RNIF business protocol. Use of this wizard is described in this section.

You must first perform the following tasks before you can use the Create Collaboration wizard. The tasks to perform are based on the method by which you are creating the RosettaNet collaboration:

  • Download from the RosettaNet Web site:

    1. Go to www.rosettanet.org.

    2. Download a zip file of the appropriate PIP. This zip file includes the document definition file (.dtd file) that you import when using the Create Collaboration wizard. This file also includes the specification that describes the details to enter into the Create Collaboration wizard fields (for example, the collaboration name, revision, code, initiating role name, accepting role name, and so on).

  • Use the OracleAS Integration B2B - Document Editor:

    1. Install the OracleAS Integration B2B - Document Editor, as described in the Oracle Application Server Integration B2B Installation Guide

    2. See the online Help included with the OracleAS Integration B2B - Document Editor for instructions on exporting RosettaNet guidelines to .xsd or .dtd files.

Regardless of whether you use the import or create collaboration method, you can then assign support for a collaboration to a remote trading partner in either of two ways:

  • With the Create Trading Partner Wizard (on the Create Trading Partner: Operational Capability page when you initially create the remote trading partner)

  • Through the Create Operational Capability button of the Business Protocol Details page for the business protocol assigned to the remote trading partner you previously created

The Create Collaboration wizard provides a series of pages that guide you through collaboration creation. Table 8-5 provides an overview of the wizard pages that appear and the types of questions for which you are prompted to provide details. Before using this wizard, review the information shown in Table 8-5.

Table 8-5 Create Collaboration Wizard Pages

Page Description

Page 1: General Page

Prompts you to define the following general collaboration details:

  • Collaboration name, description, and revision number

  • Collaboration code

  • The time in which to perform the collaboration

  • Initiating role name and description

  • Accepting role name and description

Page 2: Business Transaction Page

Prompts you to define the following business transaction details:

  • Business transaction name, description, and revision number

  • The time in which to perform the transaction

Page 3: Requesting Business Action

Prompts you to define the following requesting business action details:

  • Protocol action name

  • Response Mode (asynchronous or synchronous)

  • Requesting business action name, description, and revision number

  • Amount of time to wait before retrying

  • Time in which an acknowledgment message must be received

  • Acknowledgment mode

  • Document type name, description, and revision number

  • Document definition name and description

  • If RosettaNet Business Dictionary validation is enabled

  • The document definition file to import

Page 4: Responding Business Action (Optional)

Note: This page appears if you selected Sync or Async from the Response Mode list in Page 3: Requesting Business Action.

Prompts you to define the following responding business action details:

  • Protocol action name

  • Responding business action name, description, and revision number

  • Document protocol revision name and revision

  • Document type and definition

  • Amount of time to wait before retrying

  • Time in which an acknowledgment message must be received

  • Document type name, description, and revision number

  • Document definition name and description

  • If RosettaNet Business Dictionary validation is enabled

  • The document definition file to import

Page 5: Review

Prompts you to review details about the following selections you made on the previous pages:

  • Collaboration name, revision, and initiating and accepting role names

  • Business transaction name

  • Requesting business action details (protocol action name, response mode, business action, revision, acknowledge mode, document type, and document definition)

  • Responding business action details (protocol action name, business action, revision, document type, and document definition)


Follow these tasks to create a collaboration with the Create Collaboration wizard:


Note:

Ensure that you carefully enter collaboration details into the Create Collaboration wizard. The naming and case conventions described in the downloaded RosettaNet PIP specification must be explicitly followed.

Chapter 9, "Creating Trading Partners" for instructions on assigning support for a collaboration to a remote trading partner.

Page 1: General Page

Follow these instructions to create the collaboration (for this example, PIP 7B1) and its initiating and accepting roles (for example, buyer and seller) for the RosettaNet over RNIF business protocol:

  1. Click Partners, then Protocols.

  2. Click the RosettaNet over RNIF business protocol in the Name column of the Business Protocols section.

    The Business Protocol Details page for the RosettaNet over RNIF business protocol appears.

  3. Start the Create Collaboration wizard in either of two ways:

    1. Click Create Collaboration in the Shortcut section.

      or

    1. Click Details in the Process Protocol Revisions section.

    2. Click Create in the Collaborations section.

    The Create Collaboration: General page appears and displays the selected business protocol and its process protocol and process protocol revision in the top left part of the page. These details appear on each remaining page of the wizard.

  4. Enter the following details. An asterisk (*) indicates a required field. An example of the details to enter for PIP 7B1 is provided for the first three pages of this wizard.

    Field Value Example
    General

    • Document Protocol Revision
    Select the document protocol revision to use. This list only displays if more than one document protocol revision exists. Not applicable for this example
    • Name *
    Enter a unique and recognizable name for the collaboration (the RosettaNet PIP). 7B1
    • Description
    Enter a description of the collaboration. Distributes status information about the manufacture or assembly of a product
    • Revision *
    Enter a revision number for the collaboration. V01.00 (for RosettaNet Implementation Framework (RNIF) version 1.0)

    Note: This number must match the document type revision number you enter on the Create Collaboration: Requesting Business Action and Responding Business Action pages.

    • Code
    Enter a code for the collaboration. Work in Process Notification
    • Time To Perform
    Enter the time limit in minutes for performing this collaboration. You can override this value when you create your trading partner. 120
    Initiating Role

    • Name *
    Enter a unique and recognizable name for the initiating role in this business transaction. Solution Provider
    • Description
    Enter a description for the initiating role. Party that architects, configures, engineers, sells, and determines the fulfillment of the configured solution to partners
    Accepting Role

    • Name *
    Enter a unique and recognizable name for the accepting role in this business transaction. Solution Requester
    • Description
    Enter a description for the accepting role. Party that creates a demand for a product or service, or has contracted with a solution provider for the manufacture or fulfillment of a product

  5. Click Next.

    The Create Collaboration: Business Transaction page appears.

Page 2: Business Transaction Page

Follow these instructions to create the business transaction for the RosettaNet over RNIF business protocol. When complete, the business transaction includes the requesting and responding actions.

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

Field Value Example
Name * Enter a unique and recognizable name for the business transaction. Work in Process Notification
Description Enter a description of the business transaction. Work in Process Notification
Revision * Enter a revision number for the business transaction. V01.00
Time To Perform Enter the time limit in minutes for performing this transaction. 120

  1. Click Next.

    The Create Collaboration: Requesting Business Action page appears.

Page 3: Requesting Business Action

Follow these instructions to create the requesting business action. The requesting business action is initiated by the initiating role you created in the Create Collaboration: General page (page 1) of this wizard.

  1. Enter the unique and recognizable name in the Protocol Action Name field (for this example, Work in Process Notification Request Action).


    Note:

    The name you specify must exactly match that shown in the Business Action in FSV column of the Business Action - Business Document Mapping table of the RosettaNet specification for the PIP you are using.

  2. Select Async, None, or Sync from the Response Mode list (for this example, select None for PIP 7B1). Your selection determines the wizard page that appears after you complete the remaining details on this wizard page and click Next.

  3. Select Use Existing or Create New from the Create Mode list (for this example, select Create New).

  4. Go to the following step based on your mode selection in Step 3:

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

  5. If you selected Create New, perform Steps 5a through 5b.

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

      Field Value Example
      Name * Enter a unique and recognizable name for the requesting business action. Work in Process Notification Action
      Description Enter a description of the requesting business action. Work in Process Notification Action
      Revision * Enter a revision number for the requesting business action. V01.00
      Retry Count Enter a value. This value specifies the amount of time to wait before retrying. 3
      Time To Acknowledge 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. 120
      Acknowledge Mode Select Async, None, or Sync
      Document Type

      • Name *
      Enter a unique and recognizable name for the document type. A document type maps to a RosettaNet business document. Work in Process Notification
      • Description
      Enter a description of the document type. Work in Process Notification
      • Revision *
      Enter a revision number for the document type. V01.00

      Note: This number must match the collaboration revision number you enter on the Create Collaboration: General page.

      Document Definition

      • Name *
      Enter a unique and recognizable name for the document definition. Work in Process Notification
      • Description
      Enter a description of the document definition. Work in Process Notification
      • Validation Enabled
      Select No or Yes. Selecting Yes enables RosettaNet Business Dictionary validation. If you enable validation outside of the OracleAS Integration B2B user interface tool, performance is impacted. No
      • Definition *
      Click Browse to select a document definition file (typically a .dtd file).

      Note: You can either import standard .dtd files downloaded from the RosettaNet Web site (as shown in this example) or import .xsd or .dtd files created with the OracleAS Integration B2B - Document Editor.

      7B1_MS_V01_00_WorkinProcessNotification.dtd
      • Starting XSD File Path
      Click Browse to select the root XSD file name if the document definition file is a ZIP file. -

    2. Go to Step 7.

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

    1. Select an existing business action from the Business Action list.

    2. Go to Step 7.

  1. Click Next.

    The Create Collaboration: Responding Business Action page appears.

Page 4: Responding Business Action (Optional)

This wizard page appears if you selected Async or Sync from the Response Mode list in Step 2 of "Page 3: Requesting Business Action". Follow these instructions to create the responding (accepting) business action. The responding business action is initiated by the accepting role you created in the Create Collaboration: General page (page 1) of this wizard.

  1. Enter a name in the Protocol Action Name field.


    Note:

    The name you specify must exactly match that shown in the Business Action in FSV column of the Business Action - Business Document Mapping table of the RosettaNet specification for the PIP you are using.

  2. Select Create New or Use Existing from the Create Mode list.

  3. Go to the following step based on your mode selection in Step 2:

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

  4. If you selected Create New, perform Step 4a through Step 4b.

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

      Field Value
      Name * Enter a unique and recognizable name for the responding business action.
      Description Enter a description of the responding business action.
      Revision * Enter a revision number for the responding business action.
      Retry Count Enter a value. This value specifies the amount of time to wait before retrying.
      Time To Acknowledge 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.
      Document Type
      • Name *
      Enter a unique and recognizable name for the document type.
      • Description
      Enter a description of the document type.
      • Revision *
      Enter a revision number for the document type.

      Note: This number must match the collaboration revision number you enter on the Create Collaboration: General page.

      Document Definition
      • Name *
      Enter a unique and recognizable name for the document definition.
      • Description
      Enter a description of the document definition.
      • Validation Enabled
      Select Yes or No.
      • Definition *
      Click Browse to select a definition file (typically a .dtd file).

      Note: You can either import standard .dtd files downloaded from the RosettaNet Web site (as shown in this example) or import .xsd or .dtd files created with the OracleAS Integration B2B - Document Editor.

      • Starting XSD File Path
      Click Browse to select the root XSD file name if the document definition file is a ZIP file.

    2. Go to Step 6.

  1. If you selected Use Existing, perform Step 5a through Step 5b.

    1. Select an existing business action from the Business Action list.

    2. Go to Step 6.

  2. Click Next.

    The Create Collaboration: Review page appears and displays your selections from the previous pages.

Page 5: Review

  1. Review the collaboration details.

    • To modify these details, click the Back button of the Create Collaboration 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 collaboration is created and the new Collaboration Details page appears.

    You can now assign support for this collaboration to a remote trading partner as follows:

    • On the Operational Capability page of the Create Trading Partner wizard (page three of seven)

    • On the Create Supported Collaboration Role page, which is accessible from the Create Operational Capability button of the Business Protocol Details page for the RosettaNet over RNIF business protocol assigned to the trading partner. (Click Partners, then Trading Partners, then trading_partner_name_in_Name_column, then Capabilities, and then RosettaNet over RNIF.)

  2. Click Return to List to return to the Process Protocol Revision Details page.

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

See Chapter 9, "Creating Trading Partners" for instructions on assigning support for a collaboration to a remote trading partner.

Viewing a Collaboration

Follow these instructions to view a collaboration:

  1. Click Partners, then Protocols.

  2. Click the RosettaNet over RNIF business protocol in the Name column of the Business Protocols section.

  3. Click Details in the Process Protocol Revisions section.

    The Process Protocol Revision Details page appears.

  4. Select the specific collaboration to view in the Details column of the Collaborations section.

    The Collaboration Details page for the selected collaboration appears.

  5. View specific details, including the following:

    • The business protocol and its process protocol and process protocol revision

    • The description, revision, code, time to perform, initiating role, accepting role, and business transaction (in the Details section). Depending upon the collaboration selected, you can also access pages for updating the initiating role, accepting role, business transaction, requesting action, and responding action.

    This page, as with the Process Protocol Revision Details page shown in Figure 8-8, enables you to delete or update the collaboration.

  6. Click Return to List to return to the Process Protocol Revision Details page.

Updating a Collaboration

Follow these instructions to update a collaboration:

  1. Click Partners, then Protocols.

  2. Click the RosettaNet over RNIF business protocol in the Name column of the Business Protocols section.

  3. Click Details in the Process Protocol Revisions section.

    The Process Protocol Revision Details page appears.

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

    The Update Collaboration page appears.

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

    Field Value
    Name * Update with a unique and recognizable name for the collaboration.
    Description Update the description of the collaboration.
    Revision * Update the revision number for the collaboration.

    Note: This number must match the document type revision number. If they do not match, you receive an error after deployment. If you imported the predefined RosettaNet collaborations, both revision numbers automatically match.

    See "Updating a Document Type" for more information.

    Code Update the code for the collaboration.
    Time To Perform Update the time limit in minutes for performing this collaboration.

  6. Click Apply.

    The collaboration is updated and the Collaboration Details page appears.

Deleting a Collaboration

Follow these instructions to delete a collaboration:

  1. Click Partners, then Protocols.

  2. Click the RosettaNet over RNIF business protocol in the Name column of the Business Protocols section.

  3. Click Details in the Process Protocol Revisions section.

    The Process Protocol Revision Details page appears.

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

  5. Click Yes when prompted to delete a collaboration.

    The collaboration is deleted and the Process Protocol Revision Details page appears.

Common User Errors

If you use OracleAS Integration B2B in conjunction with the B2B WSIL Browser in Oracle BPEL Process Manager, note the following:

See "The B2B WSIL Browser" for more information.

Chapter Summary

This chapter describes the tasks required to manage the three protocols that comprise the business protocol: document, exchange, and process. The process protocol consists of business actions and collaborations. This chapter also describes how to create a business action with the Create Business Action wizard and a collaboration with the Create Collaboration wizard.