Configuring Siebel EAI Workflows

Beta

Part No: 8212601 December 2011

Copyright 2008, 2011, Oracle and/or its affiliates. All rights reserved. This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited. The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing. If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable: U.S. GOVERNMENT RIGHTS. Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle America, Inc., 500 Oracle Parkway, Redwood City, CA 94065. This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications. Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners. Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group. This software or hardware and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.

120126@25097

Contents

Configuring Siebel EAI Workflows ...................................................................................................... 5 Installing the Siebel Web Server Extension .........................................................................................5 To Install Siebel Web Server Extension (SWSE) .........................................................................5 To Verify SWSE Operation for Siebel 7 ........................................................................................7 Sample Siebel Workflow Templates .....................................................................................................8 Viewing Sample Siebel EAI Workflow Templates .............................................................................9 Modifying Siebel Workflow Templates ............................................................................................ 13 To Modify a SeeBeyond Workflow Template .......................................................................... 13 Setting Up SeeBeyond Workflow Processes ..................................................................................... 14 To set Up the Business Service To Execute the Workflow ...................................................... 14 Creating a Subsystem for a Deployed Workflow ............................................................................. 18 To Create a Subsystem For a Deployed Workflow .................................................................. 18

Configuring Siebel EAI Workflows

This document provides conceptual information that provides instructions on how to configure Siebel EAI workflows. Specifically, it provides an overview of how to install Siebel Web Server extensions, and how to view, import, modify, and configure Workflow templates. Additionally, it describes how to create a subsystem for a deployed workflow. It includes the following topics:

Installing the Siebel Web Server Extension on page 5 Viewing Sample Siebel EAI Workflow Templates on page 9 Sample Siebel Workflow Templates on page 8 Modifying Siebel Workflow Templates on page 13 Setting Up SeeBeyond Workflow Processes on page 14 Creating a Subsystem for a Deployed Workflow on page 18

Installing the Siebel Web Server Extension

Use the following procedure to install the Siebel Web Server Extension.

To Install Siebel Web Server Extension (SWSE)

From the Siebel installation media, run \eappweb\setup.exe, which invokes the installation wizard. Follow the instructions presented by the wizard. Use the naming conventions for your Siebel EAI Application Server. For Connection Protocol, specify the default port for an HTTP server, which is 80. Do not use any encryption or compression methods.
5

3 4

Installing the Siebel Web Server Extension

5 6

For Anonymous Employee and Anonymous Contact login and password, use SADMIN. For Error Level for Logging, enter All Errors and Warnings. You can change this once correct system operation has been verified.

In the \bin directory where you have installed the Siebel Web Server Extension, open the eapps.cfg file and note the following (typical values are shown):
[defaults] AnonUserName = SADMIN AnonPassword = SADMIN AnonUserPool = 10 StatsPage = _stats.swe [/eai] ConnetString = siebel.TCPIP.none.none://MyGatewayServer:2320/ MyEnterpriseServer/eaiObjMgr/MyAppServerEnableExtServiceOnly = TRUE

After modifying these files, stop and then restart the following services:

Siebel Server World Wide Web Publishing Service

Log in to Siebel 7 and follow the Screens menu path: Ctrl+Shift+A Server Administration Enterprise Configuration Enterprise Component Groups

10

Select the following items, and then click Enable:

Enterprise Application Integration Workflow Management Communication Management

11 12

Open the browser and type yourservername/module (for example, 10.1.3.135/eai). Click Enter. Make sure that your Siebel Server ODBC data source is configured. You can verify which one you are using by examining the Siebel Server log directoryit contains a file listing all the parameters.

Configuring Siebel EAI Workflows December 2011 (Beta)

Installing the Siebel Web Server Extension

To Verify SWSE Operation for Siebel 7

Verify that the Server Request Processor is running correctly. If you need to synchronize the Server Request Components with the Gateway Server, follow this menu/command path: Enterprise Configuration Batch Components Admin Synchronize

Verify that the EAI Object Manager is running correctly.

Follow the path: Server Admin Servers Server Components Under Assignment Components, select EAI Object Manager.

For Windows installations only, verify that the .swe file is associated with sweiis.dll in the web site. Use the following procedure to set the association: a. Run the IIS 4.0 Management Console application. b. Right-click on your Web site entry in the tree display, and select Properties. c. Select the Home Directory tab. d. In the Application Settings box, select Configuration. e. On the App Mappings tab, select Add. f. Type swe, select sweiis.dll, and click OK to save the association.

Verify that the configuration files are set up properly. If LDAP is not used, comment out all LDAP-related parameters in the configuration files (for example, eai.cfg and siebel.cfg):
;[SecurityAdapters] ;LDAP = LDAP ;[LDAP] ;DllName = sscfldap.dll ;ServerName = ;Port = 389 ;BaseDN = ;UsernameAttributeType = uid ;PasswordAttributeType = userPassword ;CredentialsAttributeType = credentials ;RolesAttributeType = roles ;SslDatabase =

Configuring Siebel EAI Workflows

Sample Siebel Workflow Templates

Note The LDAP configuration may differ in your Siebel system depending on your version of

Siebel and your installed options. For more information on disabling LDAP in your Siebel system, consult your Siebel user documentation.
5

After modifying these files, stop and then restart the following services:

Siebel Server World Wide Web Publishing Service

Sample Siebel Workflow Templates

Sample Siebel EAI workflow templates are provided on the Java CAPS samples site. Before you can work with the samples, you need to download the workflow samples and configure Java CAPS as described in Configuring Your System Before Creating the OTD in Developing OTDs for Oracle Java CAPS Application Adapters. If you have not already downloaded the sample workflows, they are located at http://java.net/projects/javacaps-samples/ pages/ApplicationAdapterSamples. You can import the workflows to Siebel Sales in the Siebel EAI Client by following the menu path: Ctrl+Shift+A Siebel Workflow Administration Workflow Processes You need to configure Siebel for the workflows, as described below.

In the file SWEApp\eapps.cfg, verify that the following section is specified correctly:
[/eai_enu] onnectString = siebel.TCPIP.none.none://<Your Gateway Server>:2320/ <Your_Enterprise_Server>/EAIObjMgr_enu/<Your_App Server> EnableExtServiceOnly = TRUE WebPublicRootDir=c:<Your_Siebel_Dir>\SWEApp\public\enu WebUpdatePassword=<Your_Password>

If you are using the SiebelEAI_jcdUpsert sample project, add the following sections in the file siebsrvr\bin\ENU\eai.cfg:
[HTTP Services] ... SEEBEYOND_HTTP_DELETE = SB_HTTP_DELETE SEEBEYOND_HTTP_QUERY = SB_HTTP_QUERY SEEBEYOND_HTTP_UPDATE = SB_HTTP_UPDATE SEEBEYOND_HTTP_EXECUTE = SB_HTTP_EXECUTE [SB_HTTP_DELETE] Mode = Document Service = SeeBeyond HTTP Delete Method = RunProcess

Configuring Siebel EAI Workflows December 2011 (Beta)

Viewing Sample Siebel EAI Workflow Templates

[SB_HTTP_QUERY] Mode = Document Service = SeeBeyond HTTP Query Method = RunProcess [SB_HTTP_UPDATE] Mode = Document Service = SeeBeyond HTTP Update Method = RunProcess [SB_HTTP_EXECUTE] Mode = Document Service = SeeBeyond HTTP Execute Method = RunProcess

Viewing Sample Siebel EAI Workflow Templates

Use the following procedure to view Siebel EAI workflow templates. Following the Screens menu path shown below displays the installed Workflow templates, as shown in Figure 1. Siebel Workflow Administration Workflow Processes All Processes

FIGURE 1

Java CAPS Workflow Processes

Clicking the process name to invoke a Workflow Process Designer display for that process, such as shown in the figures below.

Configuring Siebel EAI Workflows

Viewing Sample Siebel EAI Workflow Templates

FIGURE 2

DELETE Workflow Template

FIGURE 3

QUERY Workflow Template

10

Configuring Siebel EAI Workflows December 2011 (Beta)

Viewing Sample Siebel EAI Workflow Templates

FIGURE 4

INSERT/UPDATE Workflow Template

FIGURE 5

EXECUTE Workflow Template

Configuring Siebel EAI Workflows

11

Viewing Sample Siebel EAI Workflow Templates

FIGURE 6

SEND Workflow Template

FIGURE 7

SEND/RECEIVE Workflow Template

12

Configuring Siebel EAI Workflows December 2011 (Beta)

Modifying Siebel Workflow Templates

FIGURE 8

POST Workflow Template

Modifying Siebel Workflow Templates

Use the following procedure to modify Siebel EAI workflow templates.

1 2

To Modify a SeeBeyond Workflow Template

Log in to Siebel Client 7.0, designating the appropriate Siebel server. Follow the menu path: Ctrl+Shift+A Siebel Workflow Administration Workflow Processes

3 4 5 6

Highlight the SeeBeyond Workflow Process template you want to modify. Right-click and select Copy Record. Rename the copied Process. Specify the Business Object to which you want to apply the template, and any other fields that may be necessary (for example, Description). After modifying a Workflow template you must create the Business Service to execute it, using the supplied Workflow processes as templates. This procedure is described in the following section.
Configuring Siebel EAI Workflows 13

Setting Up SeeBeyond Workflow Processes

A new Services section should be added to your siebsrvr\bin\ENU\eai.cfg file, as shown in the preceding section. For example, if you have a Business Service named Employee Execute, you should add the following lines to the eai.cfg file:
[HTTP Services] ... EMPLOYEE_EXECUTE = EE [EE] Mode = Document Service = Employee Execute Method = RunProcess

Setting Up SeeBeyond Workflow Processes

The Workflow processes invoked by the SeeBeyond Workflow Templates must be set up in Siebel Business Services.
Note The names entered in the last step above are used to set up the Business Service for the sample program supplied with the Adapter. You should use them as templates to create new processes corresponding to the Workflows you create for your own system.

To set Up the Business Service To Execute the Workflow

Make sure the following services are running:

Siebel Gateway Server Siebel Server World Wide Web Publishing Service

Log in to Siebel Sales 7.0.

14

Configuring Siebel EAI Workflows December 2011 (Beta)

Setting Up SeeBeyond Workflow Processes

Follow the Screens menu path: Server Administration Servers

4 5

Make sure that Workflow Management is Online and Enabled. Log in to Siebel Tools 7.0 and designate the server as the database by entering sadmin, sadmin, server. In Object Explorer, go to Siebel Objects Project and lock the Project (see the figure below).

Configuring Siebel EAI Workflows

15

Setting Up SeeBeyond Workflow Processes

In Object Explorer, go to Business Service, make a copy of Workflow Process Manager (menu path Edit Copy Record).

Type the Process Name into the Name and Display Names fields, as shown below (this name is specified in the eai.cfg file). For the SiebelEAI_jcdUpsert project, perform this step for the following:

SeeBeyond HTTP Delete SeeBeyond HTTP Execute SeeBeyond HTTP Query SeeBeyond HTTP Update

16

Configuring Siebel EAI Workflows December 2011 (Beta)

Setting Up SeeBeyond Workflow Processes

In Object Explorer, go to Business Service > Business Service Method: a. Type ProcessName into the Name field. b. Type the actual Process Name into the Value field (see the figure below). For SiebelEAI_jcdUpsert project, perform this step for:

SeeBeyond HTTP Delete SeeBeyond HTTP Execute SeeBeyond HTTP Query SeeBeyond HTTP Update

Configuring Siebel EAI Workflows

17

Creating a Subsystem for a Deployed Workflow

Creating a Subsystem for a Deployed Workflow

Use the following procedure to create a subsystem for a deployed workflow.

1 2

To Create a Subsystem For a Deployed Workflow

Log in to Siebel Client 7.7, designating the appropriate Siebel server. Click the Site Map in the Siebel Client home page.
Administration - Server Configuration

FIGURE 9

Click the Administration - Server Configuration link. The Administration - Server Configuration page appears.

18

Configuring Siebel EAI Workflows December 2011 (Beta)

Creating a Subsystem for a Deployed Workflow

FIGURE 10

Administration - Profile Configuration

4 5 6

Click the Profile Configuration link. In the Profile Configuration page, create the Named Subsystem (SEEBEYOND_HTTP_UPDATE). Set the Workflow Process to Execute parameter for SEEBEYOND_HTTP_UPDATE to SeeBeyond HTTP Update. Set the Service Method to Execute parameter for SEEBEYOND_HTTP_UPDATE to RunProcess. For this example, SEEBEYOND_HTTP_UPDATE is the name of the Named Subsystem. SeeBeyond HTTP Update is the Business Service that invokes the SeeBeyond HTTP Update Workflow. .

Configuring Siebel EAI Workflows

19

Creating a Subsystem for a Deployed Workflow

FIGURE 11

SEEBEYOND_HTTP_UPDATE Named Subsystem

20

Configuring Siebel EAI Workflows December 2011 (Beta)