Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 5 RPC Server Interacting with RPC Client : Setting Up the Example

Setting Up the Example
 
To set up the example, complete the following tasks:
 
Task A Set up Lotus Notes Application
The sample.nsf database is used in this example.
1.
2.
Configure the sample.nsf database.
a.
Queue Db Server: IP address of the machine that hosts the database file.
Host Name: IP address of the machine on which the adapter is running.
Port Number: should be the same as the Http Port to Listen to LotusNotes Events field value that is specified in the Adapter Options tab. In this example, it is 8081.
b.
Task B Create Agents
1.
In Lotus Notes, select Create > Agents.
2.
For example, HTTPInitiateClientRequest.
3.
Close the Agent dialog.
4.
In the Action panel, select Imported Java from the Run list box.
5.
Click Import Class Files. Import the class file InitiateClientRequestHttp.class from ADLN_HOME/lib/agents/HTTP.
6.
7.
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\ClientInteractServerEndpoint.zip.
5.
Ensure that the Adapter Project ClientInteractServerEndpoint-UI and the SOA Project ClientInteractServerEndpoint-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 your environment.
1.
In the Project Explorer, expand ClientInteractServerEndpoint-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 ClientInteractServerEndpoint-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 ClientInteractServerEndpoint-UI > Adapter Configurations, and then double-click the adapter instance ADLN_RpccInteractWithRpcsConfiguration.adlnmodel to open the editor.
2.
Click the Adapter Services tab, configure a view document in the Request-Response Invocation Request Document Editor. Figure 2 is a sample configuration.
Figure 2 Configure a Request Response Invocation Document
3.
Click Apply Change.
A Request Response Invocation document named rpcClient, which is the same 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.
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 ClientInteractServerEndpoint-UI > Adapter Configurations, right-click the adapter instance ADLN_RpccInteractWithRpcsConfiguration.adlnmodel, and then select Generate Adapter WSDL from the shortcut menu.
b.
In the Target Project dialog, select the SOA project ClientInteractServerEndpoint-SOA, click OK.
c.
Click OK when prompted to overwrite the existing resource.
2.
a.
In the Project Explorer, expand ClientInteractServerEndpoint-SOA > Deployment Packages.
b.
Right-click the service assembly file ClientInteractServerEndpoint-SOA.saf, and then select Refresh Service Assembly from the shortcut menu.
c.
Right-click the ClientInteractServerEndpoint-SOA.saf file, and then select Build Archive from the shortcut menu.
d.
Click Yes when prompted to overwrite the existing resource.

Copyright © TIBCO Software Inc. All Rights Reserved