Version 9.8
 —  Designing and Developing an Application  —

Business Activity Entity

Business Activity entities are used in the Screen Process Extraction when analyzing trace files. This entity enables defining rules and conditions that are later searched for when analyzing trace files. Once these rules and conditions are met, the relevant information regarding the activity is detailed in an XML file and summarized in a CSV file (located in <application root>\AnalysisSummary directory). The XML file is then used by ARIS PPM to analyze business processes and the CSV file can be reviewed. Debugging information can be found in ApplinX server log.

Note:
The Screen Process Extractor license is required.

This section describes how to define a business activity. A business activity can be defined either in the entity editor or via the session view.


Define a Business Activity Entity using the Session View

Start of instruction setTo define a business activity entity using the session view:

  1. Within the relevant ApplinX application, ensure that you are connected to an ApplinX session.

  2. Navigate to the first screen where the business activity is to begin.

  3. In the Session View, click on the Activity toolbar icon. The toolbar is displayed.

  4. Navigate to the screen where you would like to begin and click the Capture Business Activity icon.

  5. Click the Rule Selector, and select a Rule. The relevant wizard is displayed. There are four types of rules:

  6. Click the Mark Fields to Check icon and select the fields whose value you would like to check.

  7. Click the Mark fields to Map for Output icon and select the relevant fields that you would like to map as outputs.

  8. Click the Add Rule icon. The Start Rule wizard is displayed. The fields you marked to be checked appear in the Screen section.

    graphics/startrulesessionview.png

    By default the " Check value" condition is selected and when analyzing the file, the field will be checked to see if the value you entered is the value in this field. You can click the link to change the condition type to "Check not empty" or "No validation".

  9. In the Previous Screen section, it is possible to define user action conditions for the previous screen, such as the host key used, or input field values.

  10. Click Next. The Output screen is displayed.

    graphics/startrulesessionviewoutput.png

    Determine whether the output is to be mapped to a basic PPM output or to a user defined output.

  11. Click Finish.

  12. Click on the Save Business Entity icon in the Activity toolbar.

  13. The created entity appears in the tree in the ApplinX Explorer.

Top of page

Define a Business Activity Entity in the Entity Editor

Start of instruction setTo define a business activity entity in the entity editor:

  1. Select the relevant application.

  2. In the File menu select New>Entity>Business Activity. The New Business Activity wizard is displayed:

  3. The created entity appears in the tree in the ApplinX Explorer.

  4. The work flow structure of the entity may include a Start rule, a Participating rule, an Abort rule and a Complete rule.

  5. Outputs: For each Rule, you can map the condition's outputs to the output of the activity. Define outputs and determine whether each output should be mapped to a PPM basic attribute or to a PPM user defined attribute.

Note:
An image of the Activity tree can be saved as a PNG file for later reference, by right-clicking on the Activity root node, and selecting Save as Image....

Top of page

Examples for Creating a Business Activity from the Session View and from the Business Activity Editor

Example

The following example is demonstrated in the Insurance Demo (using CompositeDemo repository). The object of the activity is to enable the Insurance company track new customers added in the host application.

Start of instruction setThe Host Application Workflow (Original Workflow)

  1. From within the BrowseCustomers1 screen, the user presses PF4 to initiate the process of creating a new customer.

  2. The CreateCustomer1 screen is displayed and the messages "Enter new record" appears at the bottom of the screen.

  3. The user enters information in the relevant input fields in the screen and presses PF9 to confirm the entries.

  4. The BrowseCustomers1 screen is then displayed and the message "Customer added successfully" appears at the bottom of the screen.

Guidelines for creating a suitable activity:

Looking at the host application workflow, we can assess that when creating a new customer, the user will inevitability pass through the CreateCustomer1 screen, and the message "Enter new record" will appear at the bottom of this screen. These conditions are to be defined as the Start Rule of the activity.

The activity that we are trying to identify will be defined as completed when we reach the BrowseCustomers1 screen and the message "Customer added successfully" appears at the bottom of the screen. Therefore this is what should be defined in the Complete rule.

An activity can be created either in the entity editor or via the Session View. Follow the steps below to demonstrate how to implement the activity in each of these options.

Start of instruction setCreating the Activity using the Session view Activity Toolbar

  1. Ensure that you are connected to an ApplinX session.

  2. From within BrowseCustomers1, navigate to CreateCustomer1 by pressing on PF4.

  3. In the Session View, click on the Activity toolbar icon. The toolbar is displayed.

  4. Click the Start Activity icon.

  5. Define the Start Rule:

    1. Click the Rule Selector, and select Start Rule.

    2. Click the Conditions icon.

    3. Click the field named "Message" (towards the bottom of the screen). The "Enter new record" string is currently displayed in this field.

    4. Click the Add Rule icon. The Start Rule wizard is displayed. The condition appears in the Screen section.

    5. Click Finish.

  6. Define the Complete Rule

    1. Click the Rule Selector, and select Complete Rule.

    2. Click the Conditions icon.

    3. Click the field named "Message" (towards the bottom of the screen). The "Customer added successfully" string is currently displayed in this field.

    4. Click the Output icon to define relevant outputs.

    5. Click the CustomerID field to highlight it.

    6. Click the Confirm icon. The Complete Rule wizard is displayed. The condition appears in the Screen section.

    7. Click Next. The Complete Rule Output screen is displayed.

    8. Click on the relevant link to determine whether CustomerID is to be a user defined output or one of the PPM predefined outputs.

    9. Click Finish.

    10. Click the Stop Activity Definition icon. A screen is displayed where you are required to enter a name for the activity. Click Finish.

Start of instruction setCreating the Activity using the Editor

  1. Ensure that you are connected to an ApplinX session.

  2. From within BrowseCustomers1, navigate to CreateCustomer11 by pressing on PF4.

  3. Right click the repository and select New Entity > New Business Activity.

  4. Enter a name for the entity and select/type the process type name. Click Finish.

  5. Define a Start Rule:

    1. Drag an Activity condition and drop it on the Start node. A Start rule is added to the Start node.

    2. In the Start Rule details area at the bottom of the screen, select CreateCustomers1 as the screen.

    3. Click the Condition link and select Test screen Content.

    4. Set the Test screen content expression condition to check if the Message field contains the text "Enter new record".

  6. Define the Complete rule.

    1. Navigate to the last screen in the session view (the BrowseCustomers1 screen with the message "Customer added successfully" at the bottom of the screen).

    2. Drag an Activity condition and drop it on the Complete node. A Complete rule is added to the Complete node.

    3. Select CreateCustomers1 as the Previous screen.

    4. Depending on whether you want the CustomerID field to be defined as one of the PPM general outputs or a PPM user-defined output, either drag the CustomerID field to one of the PPM general outputs OR create a new PPM user-defined output and drag CustomerID to it. Select BrowseCustomers1 as the screen.

    5. Click the Condition link and select Test screen Content.

    6. Set the Test screen content expression condition to check if the Message field contains the text "Customer added successfully".

  7. Save the Activity.

Top of page