Stage Configuration

Introduction

Users must specify the milestones that occur in a specific transaction during business process configuration. These milestones are defined as Stages.

Users may add one or more stages to each of the selected transactions.

Create a Stage

Custom Logging type

1. Go to Transactions section in a Business Process
2. Click Edit transaction flow in any of the available transactions
3. Click Add Stage
4. Provide a Tracking name and a Friendly name to the transaction stage
5. Users can also make use of the Optional settings if necessary
6. Choose any of the available options from the Executed at dropdown to specify the resource in which the stage is to be performed.
7. Users can add Stage property as well as Global property by selecting the relevant option from the Add Property button
8. Click the Add button to complete creating a stage

Once the stage is added, users can configure properties for the added stage by using Configure properties (Custom Properties that need to be tracked) available in the context menu of the stage. The transaction stage can be connected in the transaction flow as per the users' needs.

Optional settings

1. Is Conditional Stage - Enabling this feature will make the stage look like a decision-making box in the transaction diagram.

2. Mark transaction instance as completed - Enabling this option in a stage will make the transaction completed whenever that stage gets executed, irrespective of the IsTransactionComplete parameter passed to the stage. This setting will be applied only when the IsTransactionComplete parameter is not enabled in the checkpoint connector.

3. Mark transaction instance as failed - Enabling this option in a stage will make the transaction fail whenever that stage gets executed. This setting will be applied only when the StageStatus parameter is not enabled in the checkpoint connector.

Data Queries type

1. Go to Transactions section in a Business Process

2. Click Edit transaction flow in any of the available transactions

3. Click Add Stage

4. Provide a Tracking name and a Friendly name to the transaction stage

5. Choose between App Insights and Log Analytics in the Type dropdown.

6. Select the desired resource. The user can choose to configure the stage to be dependent to another stage.
   

7. Execute the stage query

8. The optional settings include configuring correlation properties, stage status threshold.

9. Choose any of the available options from the Executed at dropdown to specify the resource in which the stage is to be performed.

10. Click Add to create a stage.

Configure properties

1. Go to Transactions section in a Business Process
2. Click Edit transaction flow in any of the available transactions
3. Right-click the desired stage and select Configure properties
4. In order to create a Stage / Global property, press the Add Property button and choose either Stage property or Global property option from the dropdown to proceed further
5. Provide the property with a Property Name, Property DataType, Property Source which can be Xpath, JSON, constant or an HTTP Header, Property Path of the property that needs to be tracked, and Extract value using regular expression data to extract values from the configured property that matches the given regular expression which is optional
6. Press the Add button to complete adding a new property to the respective stage.
   

Index Creation

Index creation in Property configuration helps in improving the performance of querying and BAM correlation if the property is used in "CorrelationCheckpoint" action during instrumentation. This can be achieved by enabling the Create index option while configuring the properties.

Property source

There are four types of property sources for Stage property:

• XPath
• JSON
• Constant
• HttpHeader
• BizTalk Context

XPath

Users must provide a valid XPath in order to track the XPath property.

Example:

• //Landmark

The provided XPath is used to select all Landmark elements.

• PickUpLocation/Landmark

The given XPath picks all Landmark elements that are present under the parent element, PickUpLocation.

JSON

Users must provide a valid JSON path in order to track the JSON property.

Example:

• $['PickUpLocation']

PickUpLocation is the root element that is selected by using this JSON path.

• $['Ratio2.1']

Ratio2.1 is the root element that is selected by using this JSON path.

• $['PickUpLocation'] ['Landmark']

The provided path selects the child element Landmark from the parent element PickUpLocation.

(or)

• Dot notation can be used .PickupLocation.Landmark

Constant

Users can enter a constant value that will be displayed in addition to the other property sources while it is being tracked.

The constant value does not have to match any data in order to be triggered.

Example:

• New York

The specified property name will appear alongside the provided constant value.

HttpHeader

Users must specify a header name that matches the value next to messageHeader when triggering the data in order to display its data while tracking the relevant Stage.

Example:

• BookingStatus

The provided header will be used to extract the data available within it.

BizTalk Context

Users must specify BizTalk context property name and namespace in order to track the BizTalk context property.

Example:

Extract value using regular expression

Users must provide a valid regular expression in order to extract values from the configured property.

Example:

• [^\/:*?"<>|\r\n]+$

The provided expression extracts the file name.

• ^[a-zA-Z]+$

The provided expression accepts only letters.

Other capabilities

• Zoom in/Zoom out option is available in the Transaction Diagram section in order to perform zooming operation in the transaction flow.

• Undo/Redo actions can be performed while editing the transaction flow.