Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 4 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 6, 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 ADPSFT_DEMO_SOA as the SOA project name in the Project name field.
Check the Use default location checkbox if you want to save the SOA project into your default workspace.
Select Basic SOA Project from the Available Templates list.
Figure 35 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 ADPSFT_DEMO_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 PeopleSoftAdapterConfiguration.adpsft8model under the ADPSFT_DEMO project in the Project Explorer Panel, and then select Generate Adapter WSDL from the pop-up menu. The Target Project dialog appears.
 
2.
Select ADPSDFT_DEMO_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 ADPSDFT_DEMO_SOA project in the Project Explorer Panel, and then select File > New > TIBCO Shared Resources... from the Menu. The TIBCO Resource Wizard dialog appears.
 
2.
Select JMS as the example in the following steps.
3.
Select ADPSFT_DEMO_SOA as the parent folder for the newly created TIBCO Shared Resource file and accept the default file name. The default shared resource file name is JMS Shared Resource.
4.
Click the Finish button to close the dialog. The shared resource file
JMS Shared Resource.sharedjmscon appears 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 ADPSDFT_DEMO_SOA > Composites in the Project Explorer panel.
2.
Double-click ADPSFT_DEMO_SOA.composite under the Composites folder to launch the Composite Editor on the right.
Task B Creating a PeopleSoft Adapter Component
To create a PeopleSoft Adapter Component to the ADPSDFT_DEMO_SOA project composite, follow these steps in the Composite Editor:
1.
Drag the PeoplesoftAdapter componet from the Palette to the Components column and enter ADPSFT_Component as the component name.
2.
Click the ADPSFT_Component component, the configuration parameters are displayed under the Properties Views panel, as shown in Figure 36.
Figure 36 ADPSFT_Component Properties Tab
3.
Click the Services tab, and then Click the Add button to open the Resource Picker dialog, as shown in Figure 37. 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 37 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 Composite
In the Creating a JMS or HTTP Server Shared Resource section, 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 ADPSDF_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 ADPSDF_JMS service and the ADPSFT_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 ADPSDFT_DEMO_SOA project in the Project Explorer panel and expand the Composites folder.
2.
Right-click ADPSDFT_DEMO_SOA.composite under the Composites folder and select Service Assembly from the pop-up menu.
3.
Save the composite if prompted. ADPSDFT_DEMO_SOA.saf is created in the Deployment Packages folder.
4.
Expand the Deployment Packages folder under the ADPSDFT_DEMO_SOA project in the Project Explorer. Right-click ADPSDFT_DEMO_SOA.saf. and select Build Archive from the pop-up menu.
5.
After completing the process, a ZIP file, ADPSDFT_DEMO_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