Sei sulla pagina 1di 40

Introduction

Welcome!.....................................................................................2
Architecture and Components .....................................................3
The Global Sporting Goods Case Study......................................3

webMethods BroadVision Adapter Tutorial VERSION 1.2 n n n 1


Introduction

W el co m e!
The goal of this tutorial is to teach you how to install, configure, and manage the
webMethods BroadVision Adapter to solve a business problem of a fictional
sporting goods distributor named Sporting Goods Distributors (SGD). In this
tutorial, you will assume the role of the SGD developer who solves this problem.

Currently, SGD uses a BroadVision Server to maintain its inventory and handle its
purchasing processes (for example, generating purchase orders). SGD now needs to
expand the breadth of its system by implementing an integration solution with its
suppliers. That is, it needs to exchange business information over the Internet.

To prepare for implementing this solution, SGD has already installed the
webMethods Integration Server. You will now add the BroadVision Adapter to the
server so that data can flow to and from SGD’s existing system.

System Requirements
You must have the following software installed before you perform the tutorial:
g webMethods Integration Server version 3.5 or higher
g webMethods Developer version 3.5 or higher
g webMethods BroadVision Adapter Version 1.0 installed on a Solaris or HP-UX
platform

Prerequisite Skills
You should have a basic understanding of the following software before you use the
tutorial:
g webMethods Integration Server
g webMethods Developer
g JavaScript
g BroadVision One-To-One Enterprise application
g HTML and XML

2 n n n webMethods BroadVision Adapter Tutorial VERSION 1.2


Architecture and Components

Typographical Conventions

Convention Example

Procedures are described as a series of 1. On the Activity menu, select the File
numbered steps. command.

Terms that identify elements, options, The Properties tab specifies the name of the
selections, and commands on the screen requested service in the Service field.
are shown in bold.

Characters that you must type exactly are Type: setup


shown in a typewriter (courier) font. and then press ENTER.

Variable information that you must type Type: ServerDirectory\setup


based on your specific situation or and then press ENTER.
environment is shown in italics.

A rch i t ect u re an d C o m p o n en t s
An Integration Server-BroadVision application system consists of a BroadVision server
and a webMethods Integration Server with the BroadVision Adapter.

The Global Sporting Goods Case Study


Sporting Goods Distributors (SGD) is a sporting goods distributor that buys goods from
wholesale suppliers and sells them to retailers. In order to do this, SGD must maintain
inventory and pricing information.

The Problem
Currently, SGD uses a BroadVision server to maintain inventory and pricing information.
This BroadVision server enables SGD employees to both add and update information.

SGD now needs to implement an integration solution with one of its suppliers—a
snowboard manufacturer named Snowboard Suppliers—while still leveraging its
BroadVision server architecture. That is, it needs to enable SGD and Snowboard
Suppliers to send and receive business information through SGD’s BroadVision server
and over the Internet.

webMethods BroadVision Adapter Tutorial VERSION 1.2 n n n 3


Introduction

The Solution
This tutorial provides a JavaScript page from which you (the SGD user) can execute a
predefined Flow service (getCatalog) to request information about catalog items from
Snowboard Suppliers. Since this service executes in your webMethods Integration Server
to request information from Snowboard Supplier’s webMethods Integration Server, the
request is handled by the outbound (BroadVision-to-Integration Server) adapter.

After Snowboard Suppliers returns the requested catalog item to your JavaScript page,
your application must query your back-end system to find out whether the catalog item
already exists in your system. To accomplish this, the application includes the
BroadVision runtime service BVI_ContentManager.

If Snowboard Suppliers returns a catalog item that does not exist in your back-end
system, you must be able to add it to the system. To do this, you create a Flow service
named insertProduct, which is handled by the inbound (Integration Server-to-
BroadVision) adapter. This service must include the following entities that we provide:
g The CORBA interface method insert_content

To implement this method, you use the inbound (Integration Server-to-BroadVision)


adapter’s user interface to generate the method to produce a Flow service. This
generated service represents the method.
g The Java service insert_content_attributes

In addition, you must generate another Flow service for deleting products you added with
insertProduct. The tutorial provides a CORBA interface method—
delete_content_by_key—that you generate the same way you generate insert_content.

4 n n n webMethods BroadVision Adapter Tutorial VERSION 1.2


Installing the Tutorial

Installing the BroadVision Adapter...............................................6


Setting up the BroadVision Adapter Tutorial................................6

webMethods BroadVision Adapter Tutorial VERSION 1.2 n n n 5


Installing the Tutorial

I n st al l i n g t h e B r o ad V i si o n A d ap t er an d T u t o ri al
To perform this tutorial, you must install the webMethods BroadVision Adapter package
(BroadVision55) and the tutorial package (WmBVExample) on a Solaris, HP-UX, or
Windows 2000 platform. Specifically, you must install the following:
g The inbound (Integration Server-to-BroadVision) adapter
g The outbound (BroadVision-to-Integration Server) adapter
g The example package WmBVExample, which you install when you install the
inbound adapter
g The tutorial’s JavaScripts, which you install when you install the outbound adapter

For the installation procedures, see the webMethods BroadVision Adapter Installation
Guide.

S et t i n g u p t h e B ro ad V i si o n A d ap t er T u t o ri al
The tutorial file provides the following JavaScript page and .html files that are needed to
complete the exercises.
g start.html
g start.jsp
g listsuppliers.jsp
g listitems.jsp
g verifyitem.jsp

You must copy these files into newly-created directories as follows:

To copy the example JavaScript page and .html files

Enter the following commands:


1. cd $BV1TO1_VAR/script_root

2. mkdir webmethods

3. cd webmethods

4. mkdir scripts

5. cd scripts

6 n n n webMethods BroadVision Adapter Tutorial VERSION 1.2


Setting up the BroadVision Adapter Tutorial

6. cp $BV1TO1/wmbvsn55/scripts/*.jsp

7. Copy the file start.html to your web server directory. For example, if you
are running an Apache server on Solaris, you would copy start.html to
the apache/htdocs directory.

8. Ensure that your webMethods Integration Server, BroadVision server,


and BroadVision Interaction Manager are running.

webMethods BroadVision Adapter Tutorial VERSION 1.2 n n n 7


LESSON

Managing Alias Settings

Objectives..................................................................................10
Background................................................................................10
Lesson 1 Exercise .....................................................................10

webMethods BroadVision Adapter Tutorial VERSION 1.2 n n n 9


Lesson 1 Managing Alias Settings

Objectives
In this lesson, you will create and test a BroadVision server alias.

Background
To enable webMethods to open a session with your BroadVision server, you must
provide webMethods with alias setting information—that is, a collection of configuration
parameters about your BroadVision server. We provide you with the parameters for an
alias.

For more information about managing the BroadVision server alias, see the webMethods
BroadVision Adapter User Guide, Chapter3, “Implementing the Inbound Adapter”.

L esso n 1 Exerci se
Defining a BroadVision Server Alias

Caution: You must have administrator privileges on the webMethods Integration Server to perform the
following procedure.

To define an alias

1. Start the webMethods Integration Server and the webMethods


Integration Server Administrator. See the webMethods Integration Server
Administrator’s Guide for the procedures to do this.

2. In the Adapters menu in the navigation area, select BroadVision55.

The BroadVision55 child window is displayed.

3. In the BroadVision55 menu in the navigation area, select Alias Settings.

The Alias Settings window is displayed.

4. Click the Add Alias Settings button.

The Add Alias Settings window is displayed.

Complete the following fields. You may need to ask your BroadVision
server administrator for the values for these fields.

10 n n n webMethods BroadVision Adapter Tutorial VERSION 1.2


Lesson 1 Exercise

Note: All entries are case sensitive!

In this field… Specify…

Alias Name A unique name for this alias. (This is the name by which Services will
reference this alias.)
For this exercise, type:

Tutorial

Description Text that describes the alias. Optional.


IT_NAMES_SERVER The machine on which you want to connect to the NamingService
_HOST when you call resolve_initial_references.

Type:

hostName.companyName.com

For example:

odin.east.webmethods.com

IT_NS_PORT The port number at which the Names Server can be contacted.

For this exercise, type:

1221

IT_NAMES_SERVER The name with which the Names Server is registered in the
Implementation repository. This name is usually NS.

For this exercise, type:

bv1to1/bvconf_srv_a

IT_LOCAL_DOMAIN The local DNS domain name. Optional.

For example:

east.webmethods.com

IT_DAEMON_PORT The port number for the Orbix daemon.

For this exercise, type:

1221

5. Click Save.

The webMethods Integration Server Administrator saves the values to

webMethods BroadVision Adapter Tutorial VERSION 1.2 n n n 11


Lesson 1 Managing Alias Settings

the Repository under the specified alias name. The Alias Settings
window is re-displayed, showing the alias name you created. Using this
window, you can edit, test, or delete the alias. If you receive an error
message when you click Save, verify that the settings you specified are
correct.

Testing the Alias


You can perform a simple “health-check” to test the alias you just created. When you test
an alias, the webMethods Integration Server tries to open and close a connection with the
BroadVision Server referenced by the alias. It then displays a message that will tell you
about the status of your alias.

To test your new alias

Test the newly created BroadVision Server alias by clicking the Test
Connection icon in the Alias Settings List screen next to the alias.

If the test is successful, you will see the following message: “tutorial alias
setting tested successfully.” If you did not successfully open a session with the
BroadVision Server, verify the connection information and retry.

End of Lesson 1
The next lesson will show you how to create and test the insertProduct service.

12 n n n webMethods BroadVision Adapter Tutorial VERSION 1.2


LESSON

Creating and Testing the Flow service insertProduct

Objectives..................................................................................14
Background................................................................................14
Lesson 2 Exercise .....................................................................14

webMethods BroadVision Adapter Tutorial VERSION 1.2 n n n 13


Lesson 1 Creating and Testing the Flow service insertProduct

O b j ecti ves
In this lesson, you will create the Flow service insertProduct, which will enable you to
update your inventory list with Snowboard Supplier product information. Then, you will
test the service, using the webMethods Developer.

Background
After you execute the predefined Flow service getCatalog, Snowboard Suppliers returns
the requested catalog item to your JavaScript page. Then, the BroadVision runtime
service BVI_ContentManager queries your back-end system to find out whether the
catalog item already exists in your system.

If Snowboard Suppliers returns a catalog item that does not exist in your back-end
system, you must be able to add it to the system. To do this, you create a Flow service
named insertProduct, which is handled by the inbound (Integration Server-to-
BroadVision) adapter. This service must include the following entities that we provide:
g The CORBA interface method insert_content

To implement this method, you use the inbound (Integration Server-to-BroadVision)


adapter’s user interface to generate the method to produce a Flow service. This
generated service represents the method.
g The Java service insert_content_attributes

Before you create insertProduct, you must enable your BroadVision Interface Repository
(IFR) and then add to the IFR the IDL file associated with a CORBA server that we
provide.

L esso n 2 Exerci se
Adding the Example IDL File to the Interface Repository
This tutorial provides the CORBA server CntMgmt/CntDB/cntdb1 and its associated .idl
file cntdb. In this part of the exercise, you must first enable your BroadVision Interface
Repository (IFR). Then, to make this CORBA server available to the inbound adapter,
you must add the server’s IDL file to your IFR.

To enable the IFR and to add the example IDL file

1. Enable your BroadVision Interface Repository (IFR) by running the


following commands on the BroadVision Server:

14 n n n webMethods BroadVision Adapter Tutorial VERSION 1.2


Lesson 2 Exercise

putit IFR /opt/bv1to1/orbix/bin/ifr


chmodit IFR i+all

2. Run the following Orbix command to give the client “invoke and launch”
permissions to the IFR:

chmodit IFR l+all

3. To add IDL file cntdb.idl, run the following Orbix command:

putidl –I /opt/bv1to1/include/idl/
/opt/bv1to1/include/idl/bv/cntdb.idl

Generating the CORBA Method insert_content for the Flow


service insertProduct
In this part of the exercise, you will use the adapter’s user interface to generate the
CORBA interface method insert_content, which you will include in the Flow service
insertProduct. Generating insert_content produces a Flow service that represents it.

To generate the insert_content method

1. In the BroadVision55 menu in the navigation area, select CORBA


Servers.

The Select Alias window is displayed.


2. Select your alias name from the Select an alias field’s drop-down list and
click the Continue button.

The BroadVision CORBA Servers from the Names Server window is


displayed. This window displays all CORBA servers that exist in your
BroadVision naming service.
3. Select the CORBA server CntMgmt/CntDB/cntdb1.

The list of the server’s interfaces is displayed.


4. Select the interface BV_ContentDB from the list.

A list of the interface’s methods and their return types are displayed.
5. Select the method insert_content from the list.

webMethods BroadVision Adapter Tutorial VERSION 1.2 n n n 15


Lesson 1 Creating and Testing the Flow service insertProduct

The method’s parameters are displayed along with flow information


fields.
6. Complete the following flow information fields to specify where to store
the Flow service that you will generate for the CORBA method:
In this field… Specify…

Package The package in which to store the generated Flow service. For this
exercise, type Default.
Folder The folder in which to store the generated Flow service. For this
exercise, type Tutorial.
Service The Flow service name. Use the default name, which is the CORBA
method name.
Description Text that describes the Flow service. Optional.

7. Click the Generate Flow Service button. The adapter generates the
Flow service and stores it in the location you specified.

Creating the Flow service insertProduct


In this part of the exercise, you will use the webMethods Developer to create
insertProduct. When you create insertProduct, you will include the service insert_content
that you just generated. In addition, you will copy the provided Java service
insert_content_attributes that insert_content needs.

To create the insertProduct service

1. Start the webMethods Developer.


2. Click on the Tutorial folder in the Default package.
3. Click the New icon on the Service Browser toolbar.
4. Select the Flow Service option and click Next.
5. Assign the name insertProduct to the new flow service and click
Next.
6. Ensure that the Empty Flow option is selected and click Finish.
7. Click on the Flow Pane (the top pane).
8. Click the (Insert) icon on the toolbar in the Flow Pane.
9. Select Browse from the pull-down menu.
10. Select the insert_content_attributes service from the
BroadVisionExample folder in the WmBVExample package and click OK.
11. Click the (Insert) icon again and select Browse from the pull-
down menu.

16 n n n webMethods BroadVision Adapter Tutorial VERSION 1.2


Lesson 2 Exercise

12. Select the insert_content service from the Tutorial folder in the Default
package and click OK.
13. Click on the insert_content_attributes service.
14. Highlight the PROD_ID, NAME, and PRICE fields in Pipeline In, right-
click on them, and select Copy.
15. Click the Input/Output tab at the bottom of the pane.
16. Paste the copied fields in the Input section of the pane.
17. Click the Flow tab at the bottom of the pane.
18. Click on insert_content_attributes.
19. Click on the PROD_ID field in Pipeline In, click on the OID field in Service
In, and map these fields to each other.
20. Save the flow service.
21. Click on the OID, PROD_ID, NAME, and PRICE fields in Pipeline Out
and click on the Drop icon to drop these fields. The completed service
should look like this:

webMethods BroadVision Adapter Tutorial VERSION 1.2 n n n 17


Lesson 1 Creating and Testing the Flow service insertProduct

22. Click on insert_content in the Flow pane (the top pane).


23. Map attrList in Pipeline In to attrList in Service In.
24. Click on the ALIASNAME field in Service In and click the Set Value icon
to assign an input value for the field.
25. In the dialog box that is displayed, type the input value Tutorial and
click OK.
26. Assign the following values for the following fields in Service In:
Field Value

store_id 90
cnt_type 0
user_id 0
27. Save the flow service.
28. In Pipeline Out, drop the fields ALIASNAME, attr_list, and attrList. The
completed flow service should look like this:

18 n n n webMethods BroadVision Adapter Tutorial VERSION 1.2


Lesson 2 Exercise

Testing the Flow service insertProduct


In the final part of the exercise, you will use the webMethods Developer to test
insertProduct. Since this service is executed in your (SGD’s) webMethods Integration
Server, the request is handled by the inbound (Integration Server-to-BroadVision)
adapter.

To test the insertProduct service

1. In the webMethods Developer window, expand the Default package.

2. Expand the Tutorial folder.

3. Select the insertProduct service in the folder.

4. Click the (Run) icon on the Service Browser toolbar to run the
service. A pop-up dialog box is displayed, prompting you for input values
for the flow service’s purchase order.

5. Type the following values in the dialog box and click OK.

Field Value

PROD_ID 111111
NAME Deluxe Snowboard
PRICE 999.97

If the service was successfully executed, your webMethods Developer screen should
display the results shown on the next page:

webMethods BroadVision Adapter Tutorial VERSION 1.2 n n n 19


Lesson 1 Creating and Testing the Flow service insertProduct

End of Lesson 2
The next lesson will show you how to create and test the delete_content_by_key service.

20 n n n webMethods BroadVision Adapter Tutorial VERSION 1.2


LESSON

Creating and Testing the Flow service


delete_content_by_key

Objectives..................................................................................22
Background................................................................................22
Lesson 3 Exercise .....................................................................22

webMethods BroadVision Adapter Tutorial VERSION 1.2 n n n 21


Lesson 5 Creating and Testing the Flow service delete_content_by_key

O b j ecti ves
In this lesson, you will create the Flow service delete_content_by_key, which you will use
to delete the products you added with insertProduct. Then, you will test the service, using
the webMethods Developer.

Background
The tutorial provides a CORBA interface method named delete_content_by_key. You
implement this method the same way you implemented insert_content. That is, you use
the inbound (Integration Server-to-BroadVision) adapter’s user interface to generate the
method to produce a Flow service that represents the method.

L esso n 3 Exerci se
Generating the delete_content_by_key Service
In this part of the exercise, you will use the BroadVision Adapter to generate the
delete_content_by_key method to produce the flow service delete_content_by_key.

To generate the delete_content_by_key method

1. In the BroadVision55 menu in the navigation area, select CORBA


Servers.

The Select Alias window is displayed.


2. Select your alias name from the Select an alias field’s drop-down list and
click the Continue button.

The BroadVision CORBA Servers from the Names Server window is


displayed. This window displays all CORBA servers that exist in your
BroadVision naming service.
3. Select the CORBA server CntMgmt/CntDB/cntdb1.

The list of the server’s interfaces is displayed.


4. Select the interface BV_ContentDB from the list.

A list of the interface’s methods and their return types are displayed.
5. Select the method delete_content_by_key from the list.

The method’s parameters are displayed along with flow information


fields.

22 n n n webMethods BroadVision Adapter Tutorial VERSION 1.2


Lesson 3 Exercise

6. Complete the following flow information fields to specify where to store


the Flow service that you will generate for the CORBA method:
In this field… Specify…

Package The package in which to store the generated Flow service. For this
exercise, type Default.
Folder The folder in which to store the generated Flow service. For this
exercise, type Tutorial.
Service The Flow service name. Use the default name, which is the CORBA
method name.
Description Text that describes the Flow service. Optional.

7. Click the Generate Flow Service button. The adapter generates the
Flow service and stores it in the location you specified.

Testing the delete_content_by_key Service


In this part of the exercise, you will use the webMethods Developer to test the
delete_content_by_key service. Since this service is executed in your (SGD’s)
webMethods Integration Server, the request is handled by the inbound (Integration
Server-to-BroadVision) adapter.

To test the delete_content_by_key service

1. In the webMethods Developer window, expand the Default package.

2. Expand the Tutorial folder.

3. Select the delete_content_by_key service in the folder.

4. Click the (Run) icon on the Service Browser toolbar to run the
service. A pop-up dialog box is displayed, prompting you for input values
for the flow service’s purchase order.

5. Type the following values in the dialog box and click OK.

Field Value

ALIASNAME Tutorial
store_id 90
cnt_type 0

Key Enter the PROD_ID value that you used to add the product
with the insertProduct service. For example, if you entered
the PROD_ID value 111111 to add the Deluxe Snowboard,
enter the key value 111111 to delete it.

webMethods BroadVision Adapter Tutorial VERSION 1.2 n n n 23


Lesson 5 Creating and Testing the Flow service delete_content_by_key

Field Value

User_id 0

End of Lesson 3
The next lesson will show you how to run the tutorial in your web browser.

24 n n n webMethods BroadVision Adapter Tutorial VERSION 1.2


LESSON

Running the Tutorial

Objectives..................................................................................26
Lesson 4 Exercise .....................................................................26

webMethods BroadVision Adapter Tutorial VERSION 1.2 n n n 25


Lesson 5 Running the Tutorial

O b j ecti ves
In this lesson, you will run the tutorial in your web browser.

L esso n 4 Exerci se

To run the tutorial in your web browser

1. In your web browser, specify the following URL:

http://hostNameOfBroadVisionServer/start.html

where you substitute hostNameOfBroadVisonServer with your host name.


This html page redirects to the JavaScript page start.jsp.

2. On the start.jsp page that is displayed, login to the tutorial by completing


the following fields and clicking the Login button:
In this field… Type…

Host Your IP address.


Port Your host’s port number.

Username Your user name.

Password Your password.

3. Select the supplier Snowboard Supplier.

4. Select the product Deluxe Snowboard to determine whether it exists in


your BroadVision back-end system.

A message should be displayed, stating that this product exists in the


system.

5. Click the Back button on your browser.

6. Select the product Economy Snowboard to determine whether it exists


in your BroadVision back-end system.

A message should be displayed, stating that this product does not exist
in the system.

7. To add the Economy Snowboard to the back-end system, display the


webMethods Developer.

8. Expand the Default package.

26 n n n webMethods BroadVision Adapter Tutorial VERSION 1.2


Lesson 4 Exercise

9. Expand the Tutorial folder.

10. Click the Flow service insertProduct.

11. Click the (Run) icon on the Service Browser toolbar to run the
service.

A dialog box is displayed, prompting you to enter input values for the
service.

12. Enter the following input values and click OK:

Field Value

PROD_ID 222222
PRICE 599.97

NAME Economy Snowboard

13. Click your browser’s Back button to return to the previous page.

14. Select Economy Snowboard again. A message should be displayed,


stating that the Economy Snowboard has been found in the system.

15. To delete Economy Snowboard, follow the procedure on the JavaScript


page.

End of Lesson 4
The next lesson will show you how to use a session portal interface, which executes the
tutorial’s JavaScript pages in your BroadVision Interaction Manager’s JavaScript engine,
without going through a web server.

webMethods BroadVision Adapter Tutorial VERSION 1.2 n n n 27


LESSON

Using a Session Portal Interface

Objectives..................................................................................30
Lesson 5 Exercise .....................................................................30

webMethods BroadVision Adapter Tutorial VERSION 1.2 n n n 29


Lesson 8 Using a Session Portal Interface

O b j ecti ves
In this lesson, you will configure and test a session portal interface, which executes the
tutorial’s JavaScript pages in your BroadVision Interaction Manager’s JavaScript engine,
without going through a web server.

L esso n 5 Exerci se
Verifying and Enabling the Installation of the Session Portal
Piece of the Inbound (Integration Server-to-BroadVision) Adapter
Before you can create a session portal interface, first verify that the proper supporting
files were installed. Use the appropriate Windows or UNIX procedure for doing this.

To verify the session portal installation on a Windows platform

1. Ensure that the BroadVisiondll directory in your webMethods Integration


Server directory contains the following DLL files:
• bvcore.dll

• bvidl.dll

• callin.dll

• itglm301.dll

• itlmm301.dll

• itm_m301.dll

• itolm301.dll

• libscfg.dll

• libsmgr_util.dll

• mny204d.dll

• remoteSession.dll

• tls704d.dll

• wmSessionPortal.dll

2. Ensure that your registry entry for BroadVision points to the configuration
file bvsm.cfg, as follows:
a. Type regedit in a command line prompt to display the Registry Editor.

b. In the Registry Editor, expand the following directories:

30 n n n webMethods BroadVision Adapter Tutorial VERSION 1.2


Lesson 5 Exercise

HKEY_LOCAL_MACHINE\SOFTWARE\BroadVision\One-To-One
Application System\5.5\Interaction
Manager\default\export

c. Double click on the value name BV1TO1_SESSION_CFG in the export


directory and ensure that its value is the following path:

c:\bv1to1_var\BVSNsmgr\BroadVisionDll\bvsm.cfg

d. Double click on the value name Default and ensure that its value is
identical to that of BV1TO1_SESSION_CFG.

Note: Your system administrator should give you the bvsm.cfg file. This file pertains to your default
Interaction Manager (IM). However, if a named IM is running on your BroadVision server, you should copy
that configuration file instead of bvsm.cfg. If you want to change your configuration file, shut down your
webMethods Integration Server first.

To verify the session portal installation on a Solaris or HP-UX platform

Note: If you are installing on HP-UX, in the instructions below, replace the file suffix .so with the suffix .sl.

1. Verify that the file libwmSessionPortal.so appears in your webMethods


Integration Server’s lib directory.
2. Copy the files libsessionHandle.so.1 and libbvcCallin.so.1 from
/opt/bv1to1/lib to ServerDirectory/lib.
3. Make sure you have execute permissions on the following files:

libsessionHandle.so.1
libbvcCallin.so.1
libRemoteSession.so
4. Create the following directory in your system:

/etc/opt/BVSNsmgr
5. Copy the file bvsm.cfg from your BroadVision Server’s
/etc/opt/BVSNsmgr directory to your /etc/opt/BVSNsmgr.

Note: Your system administrator should give you the bvsm.cfg file. This file pertains to your default
Interaction Manager (IM). However, if a named IM is running on your BroadVision server, you should copy
that configuration file instead of bvsm.cfg. If you want to change your configuration file, shut down your
webMethods Integration Server first.

webMethods BroadVision Adapter Tutorial VERSION 1.2 n n n 31


Lesson 8 Using a Session Portal Interface

Configuring the Session Portal Interface


To create the session portal interface, you use the webMethods BroadVision Adapter.

To configure the session portal interface

1. Start the webMethods Integration Server and the webMethods


Integration Server Administrator. See the webMethods Integration Server
Administrator’s Guide for the procedures to do this.
2. In the Adapters menu in the navigation area, select BroadVision55.

The BroadVision55 child window is displayed.


3. In the BroadVision55 menu in the navigation area, select Session
Portal.

The Execute JavaScript Page window is displayed.


4. Complete the following fields to provide the parameters for the session
portal interface.
Field Description

BroadVision The name of your BroadVision application. For this exercise, type
Application Name default (if using a Windows platform) or bvsm (if using a UNIX
platform).
JavaScript File The name of the JavaScript file, starting with the directory relative to
the script root defined in your BroadVision installation. To provide
access to the tutorial’s listsuppliers.jsp (which displays the list of
suppliers), type:

webmethods/scripts/listsuppliers.jsp

Input String The values to input to your JavaScripts. For this exercise, type:

username=Administrator&password=manage&ho
st=yourHost&port=yourPort

where you replace yourHost and yourPort with your actual host and
port values.
Size of the Output Specify a size of the result, if you expect to receive a result. For this
exercise, type 0.
5. Click the Execute JSP button.

The ExecuteJSP service executes the JavaScript page in the Interaction


Manager and returns a status message.

32 n n n webMethods BroadVision Adapter Tutorial VERSION 1.2


Lesson 5 Exercise

Testing the Session Portal Interface


To test the session portal interface, you use the webMethods Developer.

To test a session portal interface

1. Start the webMethods Developer.

2. Expand the Default package.

3. Expand the Tutorial folder.

4. Click the Tutorial folder.

5. Click the New icon on the Service Browser toolbar.

6. Select the Flow Service option and click Next.

7. Assign the name sessionPortal t o the new flow service and click
Next.

8. Ensure that the Empty Flow option is selected and click Finish.

9. Click on the Flow Pane (the top pane).

10. Click the (Insert) icon on the toolbar in the Flow Pane.

11. Select Browse from the pull-down menu.

12. Select the Java service ExecuteJSP from the directory


BroadVision55\wm\broadvision55\corba\BroadvisionAdmin.

13. Copy the fields APPNAME, SCRIPTNAME, INPUT, and SIZE from
Service In.

14. Click the Input/Output tab and paste the copied fields into the input
pane.

15. Click the Flow tab.

16. Click the (Insert) icon again and select stringToDocument from
the pull-down list.

17. Click on stringToDocument and map the OUTPUT field in Pipeline In to


the xmldata field in Service In.

18. Click the isXML field in Service In and click the Set Value icon on the
Pipeline toolbar.

19. Set the value of isXML to false.

20. Click the (Insert) icon again and select documentToRecord


from the pull-down list.

webMethods BroadVision Adapter Tutorial VERSION 1.2 n n n 33


Lesson 8 Using a Session Portal Interface

21. Click the sessionPortal service name.

22. Click the (Run) icon on the Service Browser toolbar to run the
service. A pop-up dialog box is displayed, prompting you for input values
for the flow service’s purchase order.

23. Type the following values in the dialog box and click OK.

Field Value

APPNAME default (if using Windows) or bvsm (if using UNIX)


SCRIPTNAME webmethods\scripts\listsuppliers.jsp
INPUT username=Administrator&password=manag
e&host=yourHost&port=yourPort

where you replace yourHost and yourPort with your actual


host and port values.
SIZE 0

The results that are displayed should show the value of the xmldata field
as the html page List of Suppliers.

End of Lesson 5
Congratulations! You have completed the tutorial.

34 n n n webMethods BroadVision Adapter Tutorial VERSION 1.2


webMethods BroadVision Adapter
Tutorial

VERSION 1.2

webMethods, Inc.
3930 Pender Drive
Fairfax, VA 22030
USA
703.460.2500
http://www.webmethods.com
webMethods for Trading Networks, webMethods for Partners, webMethods Developer, webMethods Integration Server,
webMethods EDI Adapter, and the webMethods logo are trademarks of webMethods, Inc. “webMethods” is a registered trademark of
webMethods, Inc. All other marks are the property of their respective owners.

Copyright © 2001 by webMethods, Inc. All rights reserved including the right of reproduction in whole or in part in any form.

webM-BroadVision-Tutorial-20010719
CONTENTS

Introduction.....................................................................................................................................1
Welcome! ............................................................................................................................................................... 2
System Requirements..................................................................................................................................... 2
Prerequisite Skills............................................................................................................................................ 2
Architecture and Components................................................................................................................................ 3
The Global Sporting Goods Case Study ................................................................................................................ 3
The Problem.................................................................................................................................................... 3
The Solution.................................................................................................................................................... 4

Installing the Tutorial .....................................................................................................................5


Installing the BroadVision Adapter and Tutorial ..................................................................................................... 6
Setting up the BroadVision Adapter Tutorial .......................................................................................................... 6

Managing Alias Settings ................................................................................................................9


Objectives............................................................................................................................................................. 10
Background .......................................................................................................................................................... 10
Lesson 1 Exercise................................................................................................................................................ 10
Defining a BroadVision Server Alias ............................................................................................................. 10
Testing the Alias............................................................................................................................................ 12

Creating and Testing the Flow service insertProduct ...............................................................13


Objectives............................................................................................................................................................. 14
Background .......................................................................................................................................................... 14
Lesson 2 Exercise................................................................................................................................................ 14
Adding the Example IDL File to the Interface Repository.............................................................................. 14
Generating the CORBA Method insert_content for the Flow service insertProduct ...................................... 15
Creating the Flow service insertProduct........................................................................................................ 16
Testing the Flow service insertProduct ......................................................................................................... 19

Creating and Testing the Flow service delete_content_by_key ...............................................21


Objectives............................................................................................................................................................. 22
Background .......................................................................................................................................................... 22

n n n i
Lesson 3 Exercise.................................................................................................................................................22
Generating the delete_content_by_key Service ............................................................................................22
Testing the delete_content_by_key Service ..................................................................................................23

Running the Tutorial.....................................................................................................................25


Objectives .............................................................................................................................................................26
Lesson 4 Exercise.................................................................................................................................................26

Using a Session Portal Interface .................................................................................................29


Objectives .............................................................................................................................................................30
Lesson 5 Exercise.................................................................................................................................................30
Verifying and Enabling the Installation of the Session Portal Piece of the Inbound (Integration Server-to-
BroadVision) Adapter.....................................................................................................................................30
Configuring the Session Portal Interface .......................................................................................................32
Testing the Session Portal Interface..............................................................................................................33

ii n n n