Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 3 RPC Client Binding with JMS : Setting Up the Example

Setting Up the Example
 
To set up the example, complete the following tasks:
 
Task A Set up Lotus Notes Application
To run the examples:
1.
2.
Open the sample.nsf file from ADLN_HOME/examples/LotusDatabase, and upload it to Domino Server.
3.
Select the sample.nsf file that is at the Domino Server. Enter values for the following field in the Setup Document:
Queue Db Server: IP address of the machine which hosts the database file.
Host Name: IP address of the machine on which the adapter is running.
Publish Subject: the same as the Subject to Listen to LotusNotes Events field value that is specified in the Adapter Services tab of the adapter instance. In this example, it is trigger_rpcc.
RV Batch File for RPC: the path of the RV batch file. For example, C:\Program Files\lotus\notes\RvInitClient.bat.
4.
Task B Create RV Agents
Create a RV agent to trigger the RPC Client:
1.
2.
3.
In the action panel, select Imported Java from the Run list box. Click Import Class Files to import the class file InitiateClientRequest from ADLN_HOME/lib/agents/RV/rv_agents.
4.
Task C Import the Adapter Project and SOA Project
1.
2.
3.
In the Import dialog, select General > Existing Projects into Workspace. Click Next.
4.
In the Import dialog, check the Select archive file radio button, browse to select the example archive file AMX_HOME\extensions\adlnse\6.0\samples\AMX_UIBase\CustomerRequest.zip.
5.
Ensure that the Adapter Project RpcClientRequest-UI and the SOA Project RpcClientRequest-SOA have been selected in the Projects pane.
6.
Select the Copy projects into workspace checkbox.
7.
Click Finish.
Task D Customize the Adapter Project
After importing the projects, you need to change the connection parameters as required by the environment.
1.
In the Project Explorer, expand RpcClientRequest-UI > defaultVars, and then double-click defaultVars.substvar to open the editor for substitution variables.
2.
Change values for substitution variables adln.connection.dominoserver, adln.connection.username, and adln.connection.password.
3.
4.
In the Project Explorer, expand RpcClientRequest-UI > Shared Resources, and then double-click LotusNotes Connection.sharelnc to open the editor for connection.
5.
Click the Test Connection button to ensure that the adapter can connect to Lotus applications.
Task E Create a Request Response Invocation Document
1.
In the Project Explorer, expand RpcClientRequest-UI > Adapter Configurations, and then double-click the adapter instance ADLN_RpccRequestConfiguration.adlnmodel to open the editor.
2.
Click the Adapter Services tab, configure a view document in the Request-Response Invocation Request Document Editor. Figure 1 is a sample configuration.
Figure 1 Configure a Request Response Invocation Document
3.
Click Apply Change.
A Request Response Invocation document named rpcClient, which is the same name as that of the adapter service configuration, is created in Lotus Notes.
4.
5.
a.
Open the sample.nsf database.
b.
Expand TIB Administration\5. Defined Client Requests.
c.
Copy a new client request document, change the Request name to rpcClient, and change the Client Name to rpcClientEndpoint.
d.
Task F Update the SOA Project
The adapter project being customized, you need to update resources in the SOA project.
1.
a.
In the Project Explorer, expand RpcClientRequest-UI > Adapter Configurations, right-click the adapter instance ADLN_RpccRequestConfiguration.adlnmodel, and then select Generate Adapter WSDL from the shortcut menu.
b.
c.
Click OK when prompted to overwrite the existing resource.
2.
a.
In the Project Explorer, expand RpcClientRequest-SOA > Deployment Packages.
b.
Right-click the service assembly file CustomerRequest-SOA.saf, and then select Refresh Service Assembly from the shortcut menu.
c.
Right-click the CustomerRequest-SOA.saf file, and then select Build Archive from the shortcut menu.
d.
Click Yes when prompted to overwrite the existing resource.
Task G Import the Designer Project
1.
2.
Start TIBCO Designer and select Open existing project. In the Multi-File Project tab, select ProcessClientRequest-BW for the Project Directory field. Click OK.
3.
Change the configuration as necessary. For example, provide values for the global variables adln.connection.dominoserver, adln.connection.username, and adln.connection.password.
4.
In the Project panel, select RequestHandler > LotusNotesAdapterConfiguration, click Test Connection in the Design-time Connection tab to ensure that the adapter can connect to the Lotus application.
5.
Select rpcS under the Adapter Services folder, and then click Get Schema in the Configuration tab.
6.
In the Project panel, select the process ProcessRequest. In the Design panel, select the activity Invoke an Adapter Request-Response Service.
7.
In the Configuration tab, click Refresh Adapter Service, and then click Apply.
8.

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved