Setting Up the Examples
To successfully run the examples, you must perform the following tasks:
- Build the COM Components, as described in Task A.
- If you are using TIBCO Enterprise for JMS, start the JMS server, as described in Task B.
- Do one of the following:
- Start TIBCO BusinessWorks with any one of the following files:
BWExample-adcom-JMS.zip
, if you are using TIBCO Enterprise for JMS.
BWExample-adcom-RV.zip
, if you using TIBCO Rendezvous.
For details, see Task C.
OR
- Generate an EAR file as described in Task D, and deploy the examples using TIBCO Administrator as described in Task E.
- Start the adapter as described in Task F.
- Execute the operations on the business objects. For details, see Task G.
Task A Build the COM Components
- Build the COM Servers. Open the
ExampleUtils.cpp
in the ComAdapterService
project and update the repo url
path with the location of the BWExample-adcom-RV.dat
file. To do so, start Microsoft Visual C++ and build the ComAdapterService
and ComAdapterSyncOperation
projects from the tibco\adapter\adcom\5.3\examples\TEAKExamples\BusinessWorks\ComAdapterService
directory, using the ComAdapterService.dsw
workspace.
Task B Start TIBCO Enterprise for JMS
- At the command prompt, go to the
<JMS_HOME>
\bin
directory.
- Run the following command to start the TIBCO Enterprise for JMS Server:
tibjmsd.exe
Task C Start TIBCO BusinessWorks Using TIBCO Designer
- To start TIBCO BusinessWorks, click Start>Programs>Tibco>TIBCO Designer 5.2> Designer 5.2 and click New Empty Project.
- Click Project > Import Full Project. The Import Project dialog is displayed.
- Click the
Zip Archive
tab and browse to the zip archive you want to import. Select one of the following from the tibco\adapter\adcom\5.3\TEAKExamples\BusinessWorks
folder:
BWExample-adcom-JMS.zip
, if you are using TIBCO Enterprise for JMS.
BWExample-adcom-RV.zip
, if you using TIBCO Rendezvous.
- Click OK to import the file. The Import Options dialog is displayed. Select
Overwrite on name conflict
and click Apply.
- Select Project>Export Full Project. The Export Project dialog is displayed. Click the
Local Repository
tab, and specify a dat file name and directory. Click OK.
 |
For the Sync operation to work correctly, you must save the local repository with the same name as the zip file, in the same directory.
|
- Click the
Tester
tab and click the Start testing viewed process
button or press F9
. The Select Processes to Load dialog box is displayed.
- Select the required TIBCO BusinessWorks process and click Start Selected. The TIBCO BusinessWorks process is started.
Task D Generate an EAR File
- Click
Sample
in the project panel. The Sample (Enterprise Archive) configuration panel is displayed. You can specify a different folder or file name. Click Apply to save changes.
- Click Build Archive. The
Enterprise Archive File has built correctly
message is displayed.
Task E Deploy the Examples Using TIBCO Administrator
To deploy the example using TIBCO Administrator, you must generate an EAR file as described in Task D.
In TIBCO Administrator:
- Go to Application Management. Click New Application. Upload the EAR file created in the previous section and click OK. On the following screen, clear the Quick Configure check box and then click Save. The Configuration page is displayed.
- Click the top level application name in the Configuration page.
- Go to the Advanced tab and provide the values for User Name and Password if it is not already provided.
- Click Apply and Save. The Configuration page is displayed. Expand the top-level application.
- Click the adapter archive (
COMAdapterService.aar
) and click Add To Additional Machines.
- Select the machine and click OK. In the following screen, click Save. In the Configuration screen click Deploy. Click OK.
Once the deployment is complete, click Service Instances under the application. The adapter and TIBCO BusinessWorks is listed. Select both and click Start Selected, if it is not running. The adapter service and the TIBCO BusinessWorks processes are started.
Task F Start the Adapter
- Make sure that the repository URL and configuration URL properties are set in the
adcomService.tra
file.
- The
tibco.repourl
property must point to the BWExample-adcom-RV.dat
or to the BWExample-adcom-JMS.dat
file. For example, if you have installed the adapter on the C: drive and are using BWExample-adcom-RV.dat
, the tibco.repourl
property should be set as follows:
- The
tibco.configurl
property should point to the adapter instance:
COMAdapterService
- At the command prompt, go to the
<ADCOM_HOME>
\bin
directory.
- Start the service component of the adapter using the
BWExample-adcom-RV.dat
file:
adcomService
Task G Executing Operations for Business Objects
- Open
Index.htm
from the <ADCOM_HOME>\
examples\TEAKExamples\BusinessWorks\Html directory. The TIBCO Adapter for COM Examples page is displayed. The top right panel displays the business objects, and the bottom-left panel displays the operations available for each business object.
- Select a business object and run the operations against it:
TIBCO Adapter™ for COM Examples Guide
Software Release 5.3,
September 2005
Copyright © TIBCO Software Inc. All rights reserved
www.tibco.com
|