P. 1
Web Methods Broad Vision Adapter Tutorial V1

Web Methods Broad Vision Adapter Tutorial V1

|Views: 232|Likes:
Published by api-3747380

More info:

Published by: api-3747380 on Oct 15, 2008
Copyright:Attribution Non-commercial

Availability:

Read on Scribd mobile: iPhone, iPad and Android.
download as PDF, TXT or read online from Scribd
See more
See less

10/08/2014

pdf

text

original

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 g g

webMethods Integration Server version 3.5 or higher webMethods Developer version 3.5 or higher 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 g g g g

webMethods Integration Server webMethods Developer JavaScript BroadVision One-To-One Enterprise application HTML and XML

2 n n n

webMethods BroadVision Adapter Tutorial VERSION 1.2

Architecture and Components

Typographical Conventions
Convention Procedures are described as a series of numbered steps. Terms that identify elements, options, selections, and commands on the screen are shown in bold. Characters that you must type exactly are shown in a typewriter (courier) font. Variable information that you must type based on your specific situation or environment is shown in italics. Example 1. On the Activity menu, select the File command. The Properties tab specifies the name of the requested service in the Service field. Type: setup and then press ENTER. Type: ServerDirectory\setup and then press ENTER.

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-toBroadVision) 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 g g

The inbound (Integration Server-to-BroadVision) adapter The outbound (BroadVision-to-Integration Server) adapter The example package WmBVExample, which you install when you install the inbound adapter The tutorial’s JavaScripts, which you install when you install the outbound adapter

g

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 g g g g

start.html start.jsp listsuppliers.jsp listitems.jsp 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. Ensure that your webMethods Integration Server, BroadVision server, and BroadVision Interaction Manager are running.

8.

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. 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.

2.

10 n n n

webMethods BroadVision Adapter Tutorial VERSION 1.2

Lesson 1 Exercise

Note: All entries are case sensitive!

In this field… Alias Name

Specify…

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

Description IT_NAMES_SERVER _HOST

Text that describes the alias. Optional. The machine on which you want to connect to the NamingService 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-toBroadVision) 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… Package Folder Service Description Specify…

The package in which to store the generated Flow service. For this exercise, type Default. The folder in which to store the generated Flow service. For this exercise, type Tutorial. The Flow service name. Use the default name, which is the CORBA method name. 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. 2. 3. 4. 5. 6. 7. 8. 9. Start the webMethods Developer. Click on the Tutorial folder in the Default package. Click the New icon on the Service Browser toolbar. Select the Flow Service option and click Next. Assign the name insertProduct to the new flow service and click Next. Ensure that the Empty Flow option is selected and click Finish. Click on the Flow Pane (the top pane). Click the (Insert) icon on the toolbar in the Flow Pane.

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 down menu. (Insert) icon again and select Browse from the pull-

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, rightclick 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 store_id cnt_type user_id Value

90 0 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. 2. 3. 4. In the webMethods Developer window, expand the Default package. Expand the Tutorial folder. Select the insertProduct service in the folder. 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. Type the following values in the dialog box and click OK.

5.

Field

Value

PROD_ID NAME PRICE

111111 Deluxe Snowboard 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… Package Folder Service Description Specify…

The package in which to store the generated Flow service. For this exercise, type Default. The folder in which to store the generated Flow service. For this exercise, type Tutorial. The Flow service name. Use the default name, which is the CORBA method name. 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. 2. 3. 4. In the webMethods Developer window, expand the Default package. Expand the Tutorial folder. Select the delete_content_by_key service in the folder. 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. Type the following values in the dialog box and click OK.
Field Value

5.

ALIASNAME store_id cnt_type Key

Tutorial 90 0 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 Port Username Password 3. 4.

Your IP address. Your host’s port number. Your user name. Your password.

Select the supplier Snowboard Supplier. 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. 6.

Click the Back button on your browser. 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. 8.

To add the Economy Snowboard to the back-end system, display the webMethods Developer. 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 service. (Run) icon on the Service Browser toolbar to run the

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 PRICE NAME

222222 599.97 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. 2. 3.

Verify that the file libwmSessionPortal.so appears in your webMethods Integration Server’s lib directory. Copy the files libsessionHandle.so.1 and libbvcCallin.so.1 from /opt/bv1to1/lib to ServerDirectory/lib. 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. 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 BroadVision Application Name JavaScript File Description

2.

The name of your BroadVision application. For this exercise, type default (if using a Windows platform) or bvsm (if using a UNIX platform). 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. 2. 3. 4. 5. 6. 7. 8. 9. Start the webMethods Developer. Expand the Default package. Expand the Tutorial folder. Click the Tutorial folder. Click the New icon on the Service Browser toolbar. Select the Flow Service option and click Next. Assign the name sessionPortal t o the new flow service and click Next. Ensure that the Empty Flow option is selected and click Finish. Click on the Flow Pane (the top pane). (Insert) icon on the toolbar in the Flow Pane.

10. Click the

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. (Insert) icon again and select stringToDocument from 16. Click the 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 SCRIPTNAME INPUT

default (if using Windows) or bvsm (if using UNIX) webmethods\scripts\listsuppliers.jsp 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-toBroadVision) Adapter.....................................................................................................................................30 Configuring the Session Portal Interface .......................................................................................................32 Testing the Session Portal Interface..............................................................................................................33

ii

n n n

You're Reading a Free Preview

Download
scribd
/*********** DO NOT ALTER ANYTHING BELOW THIS LINE ! ************/ var s_code=s.t();if(s_code)document.write(s_code)//-->