RosettaNet PIP Templates

 

WebLogic Integration includes two PIP templates with which you can immediately implement RosettaNet-based solutions. This section includes descriptions of both the contents of each PIP template and the information required to implement the PIP. Versions of both PIPs are provided for both RNIF 1.1 and RNIF 2.0.

 

---

Importing a RosettaNet Template

The following XML template files are located in the WLI_HOME/lib/templates/rosettanet directory.

• PIP0A1_Admin_RN1.xml

• PIP0A1_Admin_RN2.xml

• PIP0A1_Notifier_RN1.xml

• PIP0A1_Notifier_RN2.xml

• PIP3A2_Customer.xml

• PIP3A2_Customer_RN2.xml

• PIP3A2_Customer_RN2_R02_00.xml

• PIP3A2_Supplier.xml

• PIP3A2_Supplier_RN2.xml

• PIP3A2_Supplier_RN2_R02_00.xml

To use one of the templates provided:

1. Start Studio as described in "Starting the Studio" in WebLogic Integration Administration and Design Tools in Starting, Stopping, and Customizing BEA WebLogic Integration.

2. In the right pane, right-click the Templates node.

3. Select Create Template from the shortcut menu.

4. Enter the name of the template. (This is typically the same name as the template definition to be imported.)

5. Click OK.

   An entry is added to the tree for the new template.

6. Right-click the new entry, and then select Import Template Definition.

7. Locate the required RosettaNet template, then click Open to import the definition.

   A message such as the following is displayed when the template has been successfully imported.

   Figure 3-1 Import Successful Message

   
    

 

---

RosettaNet Business Operations

In addition to the templates, WebLogic Integration incudes the RNBusinessOP.jar file. This file is a workflow package that contains business operations used in RosettaNet workflows. You should import this package as described in Importing and Exporting Workflow Packages in Using the WebLogic Integration Studio.

This package contains the Get RN timestamp business operation, an operation that returns a timestamp in a RN specific format. It is used to populate the service content for the PIP0A1 message. See the Start Notification of Failure task of the Customer workflow for more details.

 

---

PIP0A1: Notification of Failure

This PIP is a system-level RosettaNet PIP required for all implementations. It is used to transmit information in the event a process failure occurs. Normally, it does not require significant customization. Rather, data is passed to it from calling PIP workflows. For this reason, the appropriate workflow variables must be set in the calling workflow before the PIP0A1 workflow is called. Specifically, the variables described in RosettaNet Workflow Variables must be set and imported to the PIP0A1_Admin template. All input variables must be initialized when the workflow is called.

 

---

PIP3A2: Query Price and Availability

PIP3A2 is provided in template form as an example of how to implement a PIP. There are two versions of this PIP (one implemented for RNIF 1.1, and one for RNIF 2.0), and each version is modeled for both the sender and receiver roles. Use the PIP template version appropriate for the version of RosettaNet that you are using.

When implementing PIP3A2, you must set the mandatory input variables, all of which are listed RosettaNet Workflow Variables. These variables can be set from within the PIP workflow, or they can be set by a calling workflow. All input variables must be initialized when the workflow is called.

 

---

Modeling Other PIPs

The PIP3A2 templates are provided to demonstrate how RosettaNet PIPs are supported in WebLogic Integration. Because of the complexity of the PIP, BEA recommends that when creating a new PIP, you copy the PIP3A2 source files and modify the copies to create your new PIP.

You should note the following points when modeling other PIPs:

• Use input and output workflow variables to transport data between this PIP and other processes. Use input variables for the PIP to receive data from another workflow, and use output variables to send data to another workflow. You must remember to initialize all mandatory input variables when you start a PIP workflow.

• Other workflows may initiate a PIP workflow. To configure this type of initiation, choose Actions—>B2B Integration—>Start Public Workflow. Use this method when you are the trading partner initiating a PIP transaction. When you use this method, remember that you must manually enter all the PIP workflow variables listed in RosettaNet Workflow Variables.

• PIP workflows may initiate other workflows, such as private workflows. To configure this type of initiation, choose Actions—>Start Workflow. Use this method when you are the trading partner receiving a PIP transaction, and you want to pass that data to a private workflow. Use the private workflow to connect, for example, to a back-end ERP system.