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:

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


Type: System String
The transaction identifier.
Type: System DateTime
The time at which the transaction started.
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.

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.


The following example demonstrates recording a transaction with a different name, depending on the return value of a method.
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);
    RecordTransaction("transaction2", startTime, duration, false);
See Also