Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

To define the business context you need to open the Image AddedBusiness Context Manager. Therefore, navigate to the Image AddedConfiguration Perspective

Image Removed

 

Business Context Manager

Image Removed

 

Creating Application

Image Removed

 

Result of creating application

Image Removed

 

Moving Applications ...

 

Image Removed

 

Defining application ....

Image Removed

 

Adding Matching Rule

Image Removed

 

Result Matching Rule

Image Removed

 

Data View after application definition

Image Removed

 

 

 and select the Image AddedBusiness Context Manager tab:

Image Added

Creating an Application Definition

The Image AddedBusiness Context Manager view shows a list of defined applications with the number of Business Transactions and a Description. Per default, there is one immutable application called Unknown Application. The Unknwon Application is a placeholder for requests that cannot be mapped to any other applications.

 

Image Added

To create a custom Application Definition click on the Create Application button (Image Added) in the toolbar of the Image AddedBusiness Context Manager. A dialog pops up asking for some information for the new application:

  • Name: The name of the new application. Providing an application name is mandatory and application names must be unique! 
  • Description: This is an optional field that allows for providing a description for the application.
  • Insert Before: This value specifies where the new application should be positioned in the list of available applications. Section The Order of Application Definitions describes why the order of applications matters!

Image AddedImage Added

Defining Application Mapping

Once an application is created, the next step is to define matching rules that determine when user requests shall be assigned / mapped to the created application. Therefore, open the Image AddedApplication Definition Editor by double-clicking on the corresponding application in the Image AddedBusiness Context Manager.

Then, add a new matching rule by selecting the desired rule type in the context menu of the Add New Rule toolbar button (Image Added). In the following example we use Image AddedHTTP URI Matching. The Image AddedHTTP URI Matching rule allows to define a mapping based on the URI of a request. In this example, a request is assigned to the DVDStore application if the URI of the request starts with the string "/dvdstore/".

Besides the Image AddedHTTP URI Matching rule there are also other matching rules.
The Specifying Matching Rules page describes in more detail how to specify matching rules.

Image AddedImage Added

Once the matching rules are created and the configuration is saved, the data view is automatically updated with the new assignments. In the following screenshot you see that the DVDStore application has been assigned to all the technical requests:

Image Added

The Order of Application Definitions
Anchor
orderOfApplications
orderOfApplications

The order of application definitions in the Image AddedBusiness Context Manager plays an important role, if applications are not strictly separated.

When requests are evaluated to find the application they should be assigned to, the application definitions are processed in the same order as shown in the Image AddedBusiness Context Manager. If the evaluation identifies a matching application for a request, all subsequent application definitions are not considered anymore for the corresponding request. This is not a problem if the matching rules of the differnet application definitions are unabiguous. However, if this is not the case and the rules of one application definition cover the rules of another application definition, then the order of application definitions is important. 

Info
titleGood Practice

Position applications with rather generic rules below application definitions with rather specific rules!

Example

Lets assume we have two applications in the following order and having following matching rules:

  • DVDStore: Matches if URI starts with "/dvdstore/"
  • DVDPayment: Matches if URI starts with "/dvdstore/payment/"

In this example, every request that belongs to the application DVDPayment would match to DVDStore because the rule of DVDStore covers the rule of DVDPayment and DVDstore is front of DVDPayment with respect to the order. 

To make both applications in this example match correctly to the corresponding requests, the DVDPayment application must be moved above the DVDStore application. To do so, select the application to be moved (here: DVDPayment) and use the Image Addedup and Image Addeddown buttons in the toolbar of the Business Context Manager to move the application, respectively.

Image Added