RecordTransaction Method (String, DateTime, TimeSpan, Boolean, VirtualUserScript)

VirtualUser RecordTransaction Method (String, DateTime, TimeSpan, Boolean, VirtualUserScript)

C# API

Records a transaction in the VU event log, specifying whether the transaction passed.

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

Syntax

public void RecordTransaction(
	string id,
	DateTime startTime,
	TimeSpan duration,
	bool pass = true,
	VirtualUserScript script = null
)

public void RecordTransaction(
	string id,
	DateTime startTime,
	TimeSpan duration,
	bool pass = true,
	VirtualUserScript script = null
)

Parameters

id: Type: System String
The transaction identifier.

startTime: Type: System DateTime
The time at which the transaction started.

duration: Type: System TimeSpan
The duration of the transaction, in milliseconds.

pass (Optional): Type: System Boolean
true if the transaction should be interpreted as a pass; otherwise, false.

script (Optional): Type: Facilita.Fc.Runtime VirtualUserScript
The currently executing VirtualUserScript.

Remarks

The recommended way to record a transaction is by using the StartTransaction(String, String, VirtualUserScript) and EndTransaction(String, Boolean, String, VirtualUserScript) methods.

This method is useful if you need to measure a transaction where the start time and/or the transaction name are not known at the point the transaction starts. For example, you may wish to record a different transaction name depending on the result of a particular call to the SUT.

Examples

The following example demonstrates recording a transaction with a different name, depending on the return value of a method.

C++

Copy to Clipboard Print

DateTime startTime = DateTime.Now;
bool result = DoSomething();
TimeSpan duration = DateTime.Now - startTime;

// Transaction name differs, depending on the result of the call         
if (result)
{
    RecordTransaction("transaction1", startTime, duration, true);
}
else
{
    RecordTransaction("transaction2", startTime, duration, false);
}

DateTime startTime = DateTime.Now;
bool result = DoSomething();
TimeSpan duration = DateTime.Now - startTime;

// Transaction name differs, depending on the result of the call         
if (result)
{
    RecordTransaction("transaction1", startTime, duration, true);
}
else
{
    RecordTransaction("transaction2", startTime, duration, false);
}