Search business rule groups

IBM BPM, V8.0.1, All platforms > Administer applications and processes in the runtime environment > Administer business rules and selectors > Business process rules manager
Search business rule groups

You can perform a search query on a business rule group to locate or narrow a specified set of business rule groups that you want to work with.
You create a search query based on the name, target name space, custom properties, or any combination of these.

You need to be on the Search for Business Rule Groups page, which you can open by clicking Search in the business process rules manager toolbar.

To create a search query...

Procedure

In the Name field enter the name of the business rule group to search for. You can leave this value empty; however, it will not be included in the search context. The value you enter is used as both a name and a display name. Consequently, the search will look for business rule groups with either the names or the display names that match the entered name value. If you want to specifically search by either name or display name, but not both, you need to indicate such a search through property names.

Example: If you enter IBMSystemName for the name of a property and VIPGroup for the value of the property, the business process rules manager will search for business rule groups with the names, but not display names, matching VIPGroup.
In the Target Namespace field enter the URL of the business rule group. You can leave this value empty; however, it will not be included in the search context.
For each Search Data field select one of the following four query operators.

Option Description

Query Operator Description
is equal to Indicates that the value of a business rule group name, target name space, or property must match the specified string exactly.
is like Indicates that the query should look for business rule groups where the value of a business rule group name, target name space, or property is like the specified string. The string can contain wildcard characters. Use the percent character ('%') to specify a wildcard for any number of characters and use the underscore character ('_') to specify a single character wildcard. These wildcard characters must follow SQL syntax.

Examples:

If you enter "is like" "Discount" for the business rule group name and "http://calculateDiscounts" as the target name space, the search will return all the business rule groups containing that string and with that URL.
If you enter "is like" "%Discount%" for the business rule group name, the search will return all the business rule groups with names such as AirlineTicketDiscount and MovieTicketDiscountRules.

is not equal to Indicates that the value of the business rule group name, target name space, or property must not match the specified string.
is not like Indicates that the query should look for business rule groups where the value of a business rule group name, target name space, or property is not like the specified string. The string can contain wildcard characters as defined in the "like" operator.

Optional: Click Add Property to add as many properties as needed for the search context.

Specify the Name. It must be unique inside the Properties table of the search context and must not be empty.
Specify the Query Operator.
Specify the Value. The value can be empty and is taken into the search context.

Example: If the value of property PayMethod is left empty and its query operator is set to "is not equal to," the search will find all the business rule groups whose PayMethod property has the value set to a non-empty string.
Click the up and down arrows in the Action field to order the properties.

You can combine the properties in the Logical Operator field using "And", "Or", or "Not" to create a search query containing multiple properties.

Example: To search for all the business rule groups in target namespace "http://calculateDiscounts" and with the DiscountedItem property containing string "men T-Shirts" and with the Ship Handling property set to value "Free", you would use the logical property "And".
Adding, deleting, or modifying the properties on the Search for Business Rule Groups page only applies within the search context. It does not affect the properties of any rule object inside the business process rules manager.
Click Search.

Results
The business rule groups that match the search query display in the Search Results section on the Search for Business Rule Groups page. The status of the business rule group returned from the runtime as a search result may be one of the following four kinds of status.

Status Description
Same as Local Indicates that a copy of the result business rule group already exists in the business process rules manager and that its content and the content of the result business rule group are exactly similar. Consequently, no further action is taken after the search.
Modified from Runtime Indicates that a copy of the result business rule group already exists in the business process rules manager. However, another user session modified the master copy, and so the contents of the local and result business rule groups are different. The business process rules manager will automatically update the local copy to get new modifications from the runtime.
Modified in Local Indicates that a copy of the result business rule group already exists in the business process rules manager. However, it has been modified by the current user. The business process rules manager will use the local copy for any further actions by the user.
New to Local Indicates that a copy of the result business rule group does not exist in the business process rules manager. In this case, the business process rules manager will create a local copy of the result business rule group and will also display it in the navigation pane, too.

The synchronization of changes of the business rule groups occurs at the same time as the search results returned and is applied in the business process rules manager context. This means that the next operation on an affected business rule group will work with the latest updates of the business rule group.

Example
Examples: Four business rule groups are installed with the following properties:

Business rule group 1

Name: BRDCR002BRG2.brg
Target namespace: http://BRDCR002BRG2/com/ibm/br/rulegroup
Properties:

organization, 7GAA
department, accounting
ID, 0000047
ID_cert45, ABC
region, NorthRegion

Business rule group 2

Name: BRDCR002BRG3.brg
Target namespace: http://BRDCR002BRG3/com/ibm/br/rulegroup
Properties:

organization, 7FAB
department, finance
ID, 0000053
ID_app45, DEF
region, NorthCentralRegion

Business rule group 3

Name: BRDCR002BRG4.brg
Target namespace: http://BRDCR002BRG4/com/ibm/br/rulegroup
Properties:

organization, 7HAA
department, shipping
ID, 0000023
ID_app45, GHI
region, SouthRegion

Business rule group 4

Name: BRDCR002BRG5.brg
Target namespace: http://BRDCR002BRG5/com/ibm/br/rulegroup
Properties:

organization, 8JAA
department, claims
ID, 00000567
region, SouthCentralRegion
manager, Joe Bean

Retrieve a business rule group by a single property.

Logical Operator Name Query Operator Value
department is equal to accounting
This returns business rule group 1.
Retrieve business rule groups by two properties using the '%' multi-character wildcard.

Logical Operator Name Query Operator Value
region is like %Region
AND ID is like 00000%
This returns business rule groups 1-4.
Retrieve business rule groups by using the '_' single-character wildcard.

Logical Operator Name Query Operator Value
ID is like 00000_3
This returns business rule groups 2 and 3.
Retrieve business rule groups by using multiple '_' single-character wildcard.

Logical Operator Name Query Operator Value
region is like __uth%Region
This returns business rule groups 3 and 4.
Retrieve a business rule group by using a '_' single-character wildcard and not operator.

Logical Operator Name Query Operator Value
organization is not like 7__A
This returns business rule group 4.
Retrieve a business rule group by using a '%' multi-character wildcard and not operator.

Logical Operator Name Query Operator Value
organization is not like 7%
This returns business rule group 4.

What to do next
Click a result business rule group to open its business rule group page.

Business process rules manager

Option	Description
Query Operator	Description
is equal to	Indicates that the value of a business rule group name, target name space, or property must match the specified string exactly.
is like	Indicates that the query should look for business rule groups where the value of a business rule group name, target name space, or property is like the specified string. The string can contain wildcard characters. Use the percent character ('%') to specify a wildcard for any number of characters and use the underscore character ('_') to specify a single character wildcard. These wildcard characters must follow SQL syntax. Examples: If you enter "is like" "Discount" for the business rule group name and "http://calculateDiscounts" as the target name space, the search will return all the business rule groups containing that string and with that URL. If you enter "is like" "%Discount%" for the business rule group name, the search will return all the business rule groups with names such as AirlineTicketDiscount and MovieTicketDiscountRules.
is not equal to	Indicates that the value of the business rule group name, target name space, or property must not match the specified string.
is not like	Indicates that the query should look for business rule groups where the value of a business rule group name, target name space, or property is not like the specified string. The string can contain wildcard characters as defined in the "like" operator.

Status	Description
Same as Local	Indicates that a copy of the result business rule group already exists in the business process rules manager and that its content and the content of the result business rule group are exactly similar. Consequently, no further action is taken after the search.
Modified from Runtime	Indicates that a copy of the result business rule group already exists in the business process rules manager. However, another user session modified the master copy, and so the contents of the local and result business rule groups are different. The business process rules manager will automatically update the local copy to get new modifications from the runtime.
Modified in Local	Indicates that a copy of the result business rule group already exists in the business process rules manager. However, it has been modified by the current user. The business process rules manager will use the local copy for any further actions by the user.
New to Local	Indicates that a copy of the result business rule group does not exist in the business process rules manager. In this case, the business process rules manager will create a local copy of the result business rule group and will also display it in the navigation pane, too.