Developer Guide


	Corporate Info \| News \| Solutions \| Products \| Partners \| Services \| Events \| Download \| How To Buy
	http://www.oracle.com/technology/documentation/index.html \| Search \| PDF Files \| Contact \| Glossary

WebLogic Collaborate Doc Home \| Developer Guide \| Previous Topic \| Next Topic \| Contents \| Index

Welcome to the BEA WebLogic Collaborate Developer Guide.

This document describes how to develop and deploy applications that run in the WebLogic Collaborate^TM system. This document describes how to develop the following kinds of WebLogic Collaborate applications:

Workflow and c-enabler applications that run on c-enabler nodes and provide for the fast, reliable exchange of business messages among trading partners in a c-space.
Logic plug-ins that run on c-hubs and perform specialized processing of business messages as the messages pass through the c-hub.
C-hub and c-enabler management applications that monitor run-time activities in a c-space, such as message traffic and conversation statistics.

Introduction

Messaging Applications

Management Applications

Using Workflows to Exchange Business Messages

About Using Workflows

About This WebLogic Process Integrator Version

Architectural Overview

Architecture Diagram

WebLogic Process Integrator Components in WebLogic Collaborate

Workflows, Workflow Templates, and Workflow Template Definitions

Conversations, Conversation Definitions, and Business Messages

Initiators and Participants

Sent and Received Business Messages

Run-Time Prerequisites

Summary of Workflow Integration Tasks

Administrative Tasks

Programming Tasks

Designing Workflows for Exchanging Business Messages

Using Workflow Templates Created in Other WebLogic Process Integrator Versions

Exporting Workflow Template Definitions

Importing Workflow Template Definitions

Defining Conversation Properties

Opening Workflow Template Definitions

Linking Workflows to Conversations

Defining the Quality of Service for Message Delivery at the Template Level

Linking C-Enabler Session Names to a Workflow Template Definition

Defining Start Actions

Defining the Start for a Conversation Initiator Workflow

Defining the Start for a Conversation Participant Workflow

Defining Conversation Termination

Defining the Termination of Conversation Initiator Workflows

Defining the End of Conversation Participant Workflows

Defining WebLogic Process Integrator Variables for Workflows

Associations Between WebLogic Process Integrator Variables and Java Data Types

Rules for Defining WebLogic Process Integrator Variables

Defining Input Variables

Defining Output Variables

Working with Business Messages

About Business Messages

Summary of Prerequisite Tasks for Exchanging Business Messages

Defining Variables and Manipulating Business Messages

Defining WebLogic Process Integrator Variables for Business Messages

Defining Manipulate Business Message Actions

Writing Business Operations to Manipulate Business Messages

Creating and Defining Messages to Send

Steps for Creating Business Messages

Defining Send Business Message Actions

Defining the Quality of Service for Message Delivery for a Send Business Message Action

Assigning Message Token Information to WebLogic Process Integrator Variables

Defining the Workflow to Receive Business Messages

Defining the Business Message Start for Conversation Participant Workflows

Defining Business Message Receive Events

Steps for Receiving Business Messages

Developing Applications That Start Conversation Initiator Workflows

WebLogic Process Integrator Integration API

Creating Workflow C-Enabler Sessions

Programming Steps for Accessing Conversation Initiator Workflows

Step 1: Import the Necessary Packages

Step 2: Initialize Input Variables

Step 3: Establish a Workflow C-Enabler Session

Step 4: Create a Workflow Instance for a Specific Workflow Template

Step 5: Start a Workflow Instance

Step 6: Wait for the Workflow Instance to Complete

Step 7: Handle Results in Output Variables

Step 8: Handling Exceptions

Using XOCP C-Enabler Applications to Exchange Business Messages

About XOCP C-Enabler Applications

Architectural Overview

XOCP C-Enabler Applications

C-Enabler Class Library

Conversations and Conversation Definitions

XOCP Business Messages and Message Envelopes

Conversation Initiators and Participants

Conversation Coordinators

Trading Partner States

Secure Messaging

Key Tasks for C-Enabler Applications

Joining a C-Space

Registering for a Role in a Conversation

Engaging in Conversations with Trading Partners

Shutting Down a C-Enabler Session to Leave a C-Space

Run-Time Information Flow

Information Flow Diagram

Steps in the Information Flow

Programming Steps for C-Enabler Applications

Step 1: Import Packages

Step 2: Implement the ConversationHandler Interface

Step 3: Create a C-Enabler Session

Step 4: Register a Conversation Handler

Step 5: Initiate or Participate in a Conversation

Step 6: Exchange Business Messages

Step 7: End the Conversation

Participant Leaves a Conversation

Initiator Terminates a Conversation

Step 8: Shut Down the C-Enabler Session

Sending XOCP Business Messages

Step 1: Create the Business Message

Importing the Required Packages

Creating Payload Parts

Creating the XOCP Business Message and Adding Payload Parts

Step 2: Specify the Recipients of the Business Message

Specifying a Particular Trading Partner

Using C-Enabler XPath Expressions to Specify Message Recipient Criteria

Step 3: Specify the Quality of Service for Message Delivery

Automatic Quality of Service Features

QualityOfService Class

Setting the Message Delivery Confirmation Level

Setting Message Durability

Setting the Message Timeout

Setting the Number of Delivery Retry Attempts

Setting the Correlation ID for a Business Message

Step 4: Send the XOCP Business Message

Synchronous Message Delivery

Deferred Synchronous Message Delivery

Step 5: Check the Delivery Status of the Business Message

Delivery Status Tracking

Message Tracking Locations

Receiving XOCP Business Messages

About Receiving XOCP Business Messages

Receiving an XOCP Business Message

Tasks Performed

Developing Logic Plug-Ins

About Logic Plug-Ins

What Are Logic Plug-Ins?

Logic Plug-In Architecture

Logic Plug-In Processing Tasks

Business Messages and Message Envelopes

System and Custom Logic Plug-Ins

Logic Plug-In API

Rules and Guidelines for Logic Plug-Ins

Creating and Adding Logic Plug-Ins

Programming Steps for Logic Plug-Ins

Step 1: Import the Necessary Packages

Step 2: Implement the PlugIn Interface

Step 3: Specify the Exception Processing Model

Step 4: Implement the Process Method

Step 5: Get the Business Message from the Message Envelope

Step 6: Validate the Business Message

Step 7: Get Business Message Properties

Step 8: Process the Business Message as Needed

Administrative Tasks

Developing Management Applications

About Management Applications

MBeans and the MBean Server

MBean Server Implementation

C-Enabler MBeans

Configuration Requirements

Programming Steps for Management Applications

Step 1: Import the Necessary Packages

C-Enabler Example

Step 2: Get a Reference to the MBean Server Object

Step 3: Construct an ObjectName Object

Object Name Expressions

Step 4: Query the MBean Server

C-Enabler Code Example

Step 5: Read the Attributes of the MBean

C-Enabler Example

Step 6: Navigate Across MBeans

Step 7: Handle Exceptions

Writing to the Log

Severity Levels

Writing Messages to the Log

Importing the Logging Package

Writing a Log Message with an INFO Severity Level

Writing a Message With a Specific Severity Level

Copyright © 2001 BEA Systems, Inc. All rights reserved.
Required browser: Netscape 4.0 or higher, or Microsoft Internet Explorer 4.0 or higher.