FailTransaction Method (String, String)

VirtualUserScript FailTransaction Method (String, String)

C# API

Writes a fail transaction event to the VU event log, specifying a tag which appears in the Info column.

Namespace: Facilita.Fc.Runtime
Assembly: fc_clr (in fc_clr.dll) Version: 9.5.8.37

Syntax

public int FailTransaction(
	string id,
	string tag
)

public int FailTransaction(
	string id,
	string tag
)

Parameters

id: Type: System String
The transaction identifier.

tag: Type: System String
Extra information which appears in the Info column.

Return Value

Elapsed time in milliseconds since the start of the test.

Remarks

The time in milliseconds since the start of the test run is recorded when this method is called. The StartTransaction(String, String) method should already have been called with the same id. eggPlant Performance uses the time difference between the events to calculate the transaction time for the transaction named with the specified id.

This transaction will be interpreted as having failed, so it will be counted separately in Test Controller and Analyzer. This is equivalent to calling EndTransaction(String, Boolean, String) with a pass value of false.

Test Controller and Analyzer use the transaction times to calculate statistics such as average transaction time for each different id. These statistics give an indication of the performance of the System Under Test, as they show how long it takes for Virtual Users to perform the actions.