Beruflich Dokumente
Kultur Dokumente
Welcome!.....................................................................................2
Architecture and Components .....................................................3
The Global Sporting Goods Case Study......................................3
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
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.
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 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.
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
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.
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
2. mkdir webmethods
3. cd webmethods
4. mkdir scripts
5. cd scripts
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.
Objectives..................................................................................10
Background................................................................................10
Lesson 1 Exercise .....................................................................10
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
Complete the following fields. You may need to ask your BroadVision
server administrator for the values for these fields.
Alias Name A unique name for this alias. (This is the name by which Services will
reference this alias.)
For this exercise, type:
Tutorial
Type:
hostName.companyName.com
For example:
odin.east.webmethods.com
IT_NS_PORT The port number at which the Names Server can be contacted.
1221
IT_NAMES_SERVER The name with which the Names Server is registered in the
Implementation repository. This name is usually NS.
bv1to1/bvconf_srv_a
For example:
east.webmethods.com
1221
5. Click Save.
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.
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.
Objectives..................................................................................14
Background................................................................................14
Lesson 2 Exercise .....................................................................14
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
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.
2. Run the following Orbix command to give the client “invoke and launch”
permissions to the IFR:
putidl –I /opt/bv1to1/include/idl/
/opt/bv1to1/include/idl/bv/cntdb.idl
A list of the interface’s methods and their return types are displayed.
5. Select the method insert_content from the list.
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.
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:
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:
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:
End of Lesson 2
The next lesson will show you how to create and test the delete_content_by_key service.
Objectives..................................................................................22
Background................................................................................22
Lesson 3 Exercise .....................................................................22
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.
A list of the interface’s methods and their return types are displayed.
5. Select the method delete_content_by_key from the list.
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.
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.
Field Value
User_id 0
End of Lesson 3
The next lesson will show you how to run the tutorial in your web browser.
Objectives..................................................................................26
Lesson 4 Exercise .....................................................................26
O b j ecti ves
In this lesson, you will run the tutorial in your web browser.
L esso n 4 Exerci se
http://hostNameOfBroadVisionServer/start.html
A message should be displayed, stating that this product does not exist
in the system.
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.
Field Value
PROD_ID 222222
PRICE 599.97
13. Click your browser’s Back button to return to the previous 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.
Objectives..................................................................................30
Lesson 5 Exercise .....................................................................30
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.
• 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.
HKEY_LOCAL_MACHINE\SOFTWARE\BroadVision\One-To-One
Application System\5.5\Interaction
Manager\default\export
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.
Note: If you are installing on HP-UX, in the instructions below, replace the file suffix .so with the suffix .sl.
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.
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.
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.
10. Click the (Insert) icon on the toolbar in the Flow Pane.
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.
16. Click the (Insert) icon again and select stringToDocument from
the pull-down list.
18. Click the isXML field in Service In and click the Set Value icon on the
Pipeline toolbar.
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
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.
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
n n n i
Lesson 3 Exercise.................................................................................................................................................22
Generating the delete_content_by_key Service ............................................................................................22
Testing the delete_content_by_key Service ..................................................................................................23
ii n n n