Developing a Simple Solution Application with IBM Operational Decision
Manager Advanced V8.8 Decision Server Insights?
This lesson will show you a simple Insight Solution development using a
Customer Profile Management Scenario.
The Solution project is the starting point for building an event driven
application.
In this lesson, you will learn how to create a solution project in Insight
Designer.
Steps:
1. Launch Insight Designer. (StartAll ProgramIBMDecision Server
Insights V8.8Insight Designer8.8).
2. Before you start solution development, you need to set Insight Server as
the active target definition.
This is an important step in order to compile and build the solution
correctly. (Window>Preferences>Plug-in Development>Target Platform>click
Add>choose Template>select Insight Server>Next>Finish>select Insight Server
(Active)>Apply>Ok)
Note: In the Decision Insight Perspective, some Insights-specific views
such as Solution Explorer and Solution Map are available.
3. To create a solution project, click File>New>Solution Project>Enter
Simple Solution as the project name>Next>Enter Simple BOM as the BOM
project name>Finish. (In Solution Explorer view, you can see the three projects
that are generated.)
Select Simple Solution, The Solution Map views loads the corresponding
solution status and all available task information.
4. Click Define events and entities>Enter package name as com.ibm>Finish.
(The business model definition editor is opened.)
Now Define the following entities as it is:
an address is a concept with
a street,
a city,
a country,
a zip.
a customer is a business entity identified by an email with
a first name,
a last name,
an address.
a create customer event is a business event with
a first name,
a last name,
an address.
a create customer event is related to a customer.
a change of address event is a business event with
a new address (an address).
a change of address event is related to a customer.
Save the definition file. And expand the BOM project folder.
Next steps show you how to create a rule agent project and add the business
logic to handle the events and entities.
5. To create a rule agent project, click Add rule agent in the Solution Map
view>Enter Simple Rule Agent as the project name>Finish. (The agent definition
editor is opened. A template is created by default.) Make it as:
‘Simple_Rule_Agent’ is an agent related to a customer ,
processing events :
- create customer event, where this customer comes from the customer of this
create customer event
- change of address event, where this customer comes from the customer of this
create customer event
Save the definition.
6. Expand Simple Rule Agent project>Right click the rules folder>Select
Action Rule in the contextual menu>Enter create customer as the rule
name>Finish. (The content assistant is available in the rule editor too.)
Now write the rule as it is:
Save the rule definition.
Create another action rule that is called change of address. (Right
click on rule>New>Action Rule>Give the name as change of address>Finish)
Now write the rule as it is:
Save the rule definition.
Next steps show you how to model the solution connectivity, export the solution
archive, and export the connectivity configuration from Insight Designer.
6. You can use the solution map to define a solution connectivity. (Click
Define Connectivity from Solution Map>Click Finish)
Write the following code as it is:
Save the connectivity.cdef file.
7. Expand the Simple Solution project. (You can find the connectivity.cdef
file under the Connectivity Definitions folder.)
The Solution development is complete. It is now time to export the
solution archive.
8. Click the Export solution archive in the Solution Map>Click Browse to
specify the location of the solution archive. (By default, the version of the solution
archive is set to 0.0)>Finish.
If you define the connectivity in the solution, you also need to create
the connectivity server configuration file.
To do so, click Export connectivity configuration in the Solution
Map>click Browse to specify the location of the file>Next>select the defined
endpoint>Finish.
The connectivity server configuration file is opened.
For simplicity, comment out the security role mapping in the configuration.
Next steps show you how to deploy the solution and connectivity
configuration file to the Insight Server.
Before you deploy the solution, you need to make sure that the Insights
server is started.
A default server, called cisDev, is create during product installation for
development usage.
You can start the cisDev server in the Samples Console perspective.
Wait until you see the “Server cisDev started” message in the console view.
Use command-line script to deploy the solution.
In the command prompt window, navigate to the <Insights_Home>/runtime/is/bin
directory.
9. Click Start>type cmd in Search program and files>Right click on cmd
and click Run as administrator.
10. Navigate up to the bin folder like that
Run the solutionManager command to deploy the solution to the server.
C:\Program Files\IBM\ODMInsights88\runtime\ia\bin>solutionManager deploy
local C:\Users\cbit5\Desktop\Simple_Solution-0.0.esa
And hit enter key.
If the deployment is successful, you see the “Server configuration file successfully
updated for server” message displayed in the command window.
11. Run the connectivityManager command to deploy the solution
connectivity.
C:\ProgramFiles\IBM\ODMInsights88\runtime\ia\bin>connectivityManager
deploy local C:\Users\cbit5\Desktop\Simple_Solution-0.0.esa
C:\Users\cbit5\Desktop\connectivity-server-configuration.xml
And hit enter key.
Wait until the succussfully message are displayed.
Next steps show you how to test the solution by sending the XML request.
12. Genarate the model schema file. (Click Export event types to XSD in the
solution map>Leave the default output location, click Finish.)
Expand Simple Solution. Make ensure that model.xsd file is
created under the schemas/namespace1 folder.
Now you can create the XML instance files based on the
schema.
13. Right click on Simple Solution>New>Other…>choose XML
File>Next>Give the file name as NewCustomer.xml>Next>click on Create XML
file from an XML schema file radio button>Next>Expand Simple Solution and
select model.xsd file>Next>select Root element: as CreateCustomerEvent>Finish.
The XML file editor is opened. Switch to the Source tab.
14. Update the address fields with the instance data. And then save that
XML file.
15. Create another instance XML file for the change address event.
Right click on Simple Solution>New>Other…>choose XML
File>Next>Give the file name as ChaneAddress.xml>Next>click on Create XML
file from an XML schema file radio button>Next>Expand Simple Solution and
select model.xsd file>Next>Leave Root element: as
ChangeOfAddressEvent>Finish.
16. Change the address values. And then save that XML file.
17. Open a Web Browser. And use the Poster add-on tool to send the
requests.
(Go to the Tool Menu>Poster>Enter the inbound HTTP endpoint
URL path as (http://localhost:9080/Simple_Solution/post)
Browse to the NewCustomer.xml instance file that was created in the
Designer workspace.
18. Click the POST button to send creation request.
19.Close the Respons window. And Switch back to the web browser.
20. Enter the solution REST URL to check the entity types.
21. Add the entity type full name to the end of the URL.
The customer is created with initial address value.
22. Open the Poster again. This time, choose ChageAddress.xml to send.
23. Click the POST button to send creation request.
24.Close the Respons window. And Switch back to the web browser.
25. Refresh the URL. (Notice that the address is changed.)