Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 3 Getting Started : Working with an ActiveMatrix SOA Project

Working with an ActiveMatrix SOA Project
Before the Adapter Service Engine instance can be deployed, it must be packaged in a service assembly.
To package an Adapter Service Engine instance in a service assembly, complete the following tasks:
1.
2.
3.
4.
5.
For detailed information, refer to Chapter 5, Working with ActiveMatrix SOA Projects.
Creating an ActiveMatrix SOA Project
To create an ActiveMatrix SOA project, follow these steps:
1.
2.
Select File > New > Project from the Menu to open the New Project window.
3.
Expand the TIBCO ActiveMatrix folder and select ActiveMatrix SOA Project in the Select a wizard page, and then click the Next button.
 
4.
Enter TIB_SBL_Adapter_SOA as the SOA project name in the Project name field.
Check the Use default location check box if you want to save the SOA project in your default workspace.
Select Basic SOA Project from the Available Templates list.
Figure 18 Create an ActiveMatrix SOA Project - New SOA Project
5.
Click the Next button and accept all default names for the selected assets.
6.
Click the Finish button. The TIB_SBL_Adapter_SOA project is shown in the Project Explorer panel.
For detailed information about creating an ActiveMatrix SOA project, refer to Creating an ActiveMatrix SOA Project.
Generating an Adapter WSDL
TIBCO ActiveMatrix services are described using WSDL files.
To generate a WSDL file, follow these steps:
1.
Right-click SiebelAdapterConfiguration.adsblmodel under the TIB_SBL_Adapter project in the Project Explorer Panel, and then select Generate Adapter WSDL from the pop-up menu to open the Target Project dialog.
 
2.
Select TIB_SBL_Adapter_SOA as the matching resource, and then click the OK button.
For detailed information about generating an adapter WSDL, refer to Generating an Adapter WSDL.
Creating a JMS or HTTP Server Shared Resource
After creating an ActiveMatrix SOA project, a composite file for this project is automatically generated. You will need to add a service into it. In order for the composite service to be accessible from an external client, add a TIBCO Shared Resource.
To add a TIBCO Shared Resource, follow these steps:
1.
Select the TIB_SBL_Adapter_SOA project in the Project Explorer Panel, and then select File > New > TIBCO Shared Resources... from the Menu to open the TIBCO Resource Wizard dialog.
 
2.
Select JMS as the example in the following steps.
3.
Select TIB_SBL_Adapter_SOA as the parent folder for the newly created TIBCO Shared Resource file and accept the default file name, JMS Shared Resource.
4.
Click the Finish button to close the dialog and open the shared resource file
JMS Shared Resource.sharedjmscon in the Project Explorer panel.
For detailed information about creating a JMS or HTTP Server Shared Resource, refer to Configuring a TIBCO Shared Resource.
Configuring a Composite
To configure a composite, complete the following tasks:
For detailed information about configuring a composite, refer to Configuring Composites.
 
Task A Launching the Composite Editor
To launch the Composite Editor, follow these steps:
1.
Expand TIB_SBL_Adapter_SOA > Composites in the Project Explorer panel.
2.
Double-click TIB_SBL_Adapter_SOA.composite under the Composites folder to launch the Composite Editor on the right.
Task B Creating a Siebel Adapter Component
To create a Siebel Adapter Component for the TIB_SBL_Adapter_SOA project composite, follow these steps in the Composite Editor:
1.
Drag the SiebelAdapter component from the Palette to the Components column and enter ADSBL_Component as the component name.
2.
Click the ADSBL_Component component to display the configuration parameters under the Properties Views panel.
Figure 19 ADSBL_Component Properties Tab
3.
Click the Services tab, and then Click the Add button to open the Resource Picker dialog. Expand the tree in the left pane and select an adapter endpoint (for example, COUNTRYEndpoint), and then click the Add button to add it into the Selected Adapter Endpoint pane on the right.
Figure 20 Resource Picker Dialog
4.
Click the OK button. The added service appears under the Services tab.
5.
Click the Save button to save your configuration.
Task C Adding the Shared Resource to the Composite
In section Creating a JMS or HTTP Server Shared Resource, you have created the JMS Shared Resource for your composite service. Now you need to add the JMS shared resource to the composite.
To add the JMS Shared Resource to the composite, follow these steps:
1.
2.
Click the Shared Resource Profiles tab to add the shared resource.
3.
Click the Save button to save your configuration.
Task D Creating a Composite Service
To create a composite service in the Composite Editor, follow these steps:
1.
2.
Click the ADSBL_JMS service, the configuration parameters are displayed under the Properties Views panel.
Click the Target tab and click the radio button next to the target component service. A wire is drawn between the ADSBL_JMS service and the ADSBL_Component component.
Click the Binding tab to add the shared resource profile to the Endpoint pane.
3.
Click the Save button to save your configuration.
Creating a Service Assembly and a Service Assembly Archive
The adapter services that have been created in the design phase have to be packaged into a service assembly before they can be deployed.
To create a service assembly and a service assembly archive, follow these steps:
1.
Select the TIB_SBL_Adapter_SOA project in the Project Explorer panel and expand the Composites folder.
2.
Right-click TIB_SBL_Adapter_SOA.composite under the Composites folder and select Service Assembly from the pop-up menu.
3.
Save the composite if prompted TIB_SBL_Adapter_SOA.saf is created in the Deployment Packages folder.
4.
Expand the Deployment Packages folder under the TIB_SBL_Adapter_SOA project in the Project Explorer. Right-click TIB_SBL_Adapter_SOA.saf and select Build Archive from the pop-up menu.
5.
After completing the process, a ZIP file, TIB_SBL_Adapter_SOA.zip, is created in the Deployment Packages folder. This service assembly archive can now be deployed and started using TIBCO ActiveMatrix Administrator.
For detailed information about creating a service assembly and a service assembly archive, refer to Creating a Service Assembly Archive.

Copyright © TIBCO Software Inc. All Rights Reserved