Samples > Rule Team Server Business Rule Management Extensions > How to Extend the Rule Model

How to Extend the Rule Model

PREVIOUS NEXT

This sample shows how to extend the default properties of the rule packages and business rules, and how to customize web pages to display these properties.

Key Features

Key features of this sample include:

Installing this Sample

To install this sample through the Samples Console:

  1. Go to the Samples Console and locate the teamserver > serverextendedbrm sample.
  2. Check that the Samples Server is started. For information on how to start and stop the Samples Server, see Stopping and Restarting the Samples Server from the Samples Console.
  3. Execute the repack command to compile and repackage the application into a new deployable file.
  4. Execute the run command to set the extensions and deploy the new application.
    5. The database schema is automatically updated by the Ant tasks.
  5. Wait for the Java EE application to start before continuing. (The server trace displays the message: [EARDeployer] Started J2EE application.)

Running this Sample

This sample can only be opened and run in the Samples Console.

To open and run the sample:

  1. Open a web browser and enter the following URL to access Rule Team Server:
    2. http://localhost:8080/teamserver?datasource=jdbc/serverextendedbrm
    The datasource parameter on the URL instructs Rule Team Server to use a specific datasource which supports the extended database schema and provides access to an extended rule type, Extended Rule.
  2. Sign in to Rule Team Server using the following details:
    3. Username: rtsAdmin
    Password: rtsAdmin
  3. To create a rule of type Extended Rule:
    1. Click the Compose tab.
    2. Click Extended Rule in the Start from a type list, then click OK in the Type Information page.
  4. The Extended Rule properties are defined in 8 steps.
    5. Custom properties are defined in Step 1: Properties, Step 5: Edit Additional Properties, and Step 6: Edit Target Release, as follows:
    1. In Step1: Properties, the custom field Customer Names allows you to enter a comma-separated list of values (in this case, customer names).
    2. Click Step 5: Edit Additional Properties > New. This step includes four customized fields:
      3. - In the Requestor Mail field, enter an invalid e-mail, such as "john doe", and then click Apply. An error message is displayed asking you to enter a valid e-mail address.
      - Click a state on the Territory map to select a territory. The name of the state you clicked appears in the text field just above the territory map.
      - Select one of the options listed in the Requirement list.
      - Click the folder icon to the right of the Authority text box, expand the hierarchy of options, and select the authority loanvalidation-rules > Corporate > WS-ASE Department > Service 1.
      - Click Apply. The options are applied and the newly created property is listed in the Edit Additional Properties page.
    3. Click Next to go to Step 6: Edit Target Release, and then click New.
      4. This step includes three text fields (Major Version, Minor Version, and Patch Level). Each text field is associated with a custom validator to ensure that values entered are between a specified minimum and maximum value, and a custom Production Level field that offers a list of numbered options.
    4. Click Apply.
      5. An error message is displayed indicating that the value of the property majorVersion should be between 1 and 20.
    5. Click Finish.
  5. Return to the Samples Console and execute the feed command.
    6. This updates the custom properties, such as the options in the hierarchical list of department authorities for the Authority property in Step 5: Edit Additional Properties.

Source Files

This sample is located in <InstallDir>/teamserver/samples/serverextendedbrm.

The source files for the new extension model are located in:

<InstallDir>/teamserver/samples/serverextendedbrm/resources

The source file for the configuration is located in:

<InstallDir>/teamserver/samples/serverextendedbrm/config

The source files for the customization are located in:

<InstallDir>/teamserver/samples/serverextendedbrm/src/serverextendedbrm

Highlights

Highlights of this sample include:

Rebuilding this Sample

To rebuild this sample.

  1. Execute the clean command.
  2. Execute the build command.

Related Concepts

Rule Model Extension Schema

Related Tasks

Customizing Rule Team Server
Defining Common Model Extensions for Rule Studio and Rule Team Server

Related Reference

Rule Model Extension Editor
Copyright © 1987-2008 ILOG S.A. All rights reserved. Legal terms. Documentation homepage. PREVIOUS NEXT