Finishes an asynchronous operation and returns the result.

Arguments

result. The result of the JavaScript block execution (any, optional).

Return value

None

Example:

IOA.read(TC.scriptDir + "mylog.txt").then(function(data){
  TCA.done(data);
}).catch(function (error) {  
  TCA.doneWithError(error);
});

Back to top

Finishes an asynchronous operation with an error.

Arguments

error. Any object can be used to stand for the error detail (any).

Return value

None

Example:

IOA.read(TC.scriptDir + "mylog.txt").then(function(data){
  TCA.done(data);
}).catch(function (error) {  
  TCA.doneWithError(error);
});

Back to top

Notifies the execution engine that an asynchronous API will be invoked, so that the engine waits for completion notification.

Arguments

None

Return value

None

Example:

TCA.useAsyncAPI();
setTimeout(function() {
   IOA.read(TC.scriptDir + "mylog.txt").then(function(data){
     TCA.done(data); 
   }).catch(function (error) {  
     TCA.doneWithError(error);
   });

}, 1000);

Back to top

Adds a filter for URL requests.

Arguments

filters. Filter representing one or more URLs (string). Separate multiple URLs with a semicolon (;). The URL can have the wildcard (*) which can match 0 or more characters.

include. True to include URL requests that match the filter; otherwise false (default). Optional argument (boolean).

applyTo. (Optional argument) Specify the type of request the filter applies to:

• Xhr. Filters XHR requests only.

• NonXhr. Filters non-XHR requests only.

• All. Filters all requests (default).

Return value

A promise that will be fulfilled with no arguments.

Example:

TCA.addNetworkFilter("http://www.myco.com/*", true, "All").then(function(){ 
  TCA.done();
}).catch(function (error) {
  TCA.doneWithError(error);
});

From the point that you add this API call, until you call the remove filter or the end of the iteration, TruClient will not wait for requests to get a response unless the URL has a http://www.myco.com/ prefix.

Back to top

Removes all URL request filters.

Arguments

None

Return value

A promise that will be fulfilled with no arguments.

Example

TCA.clearNetworkFilters().then(function(){
  TCA.done();
}).catch(function (error) {
  TCA.doneWithError(error);
}); 

Back to top

Starts logging URL requests.

Arguments

None

Return value

A promise that will be fulfilled with no arguments.

Example

TCA.startLogRequests().then(function(){
  TCA.done();
}).catch(function (error) {
  TCA.doneWithError(error);
}); 

Back to top

Advances the specified parameter to the next value in the file. This must be a parameter of type file or unique number; this is the argument type set in VuGen.

Arguments

name. The name of the parameter to advance (string).

Return value

A promise that will be fulfilled with no arguments.

Example

TCA.advanceParam("multi_row_param").then(function(){
  TCA.done();
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Returns the value of the specified parameter.

Arguments

name. The parameter name (string).

Return value

A promise that will be fulfilled with a string: If the parameter exists, it returns its value. If it does not exist, it returns an empty string.

Example

TCA.getParam(“myParam”).then(function(result){
  TCA.done(result);
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Saves a string to a parameter, creating a temporary parameter value in the memory if it does not exist (it does not create a parameter that can be read in the next run).

Arguments

name. The name of the parameter in which to save the value (string).

value. The parameter value (string).

Return value

A promise that will be fulfilled with no arguments.

Example

TCA.setParam("myparam", "paramVal").then(function(){
  TCA.done(result);
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Returns the IP address when IP spoofing is enabled and the script is running in load mode in Controller.

Arguments

None

Return value

A promise that will be fulfilled with a string, which is the IP address when IP spoofing is enabled and the script is running in load mode in Controller.

Example

None

Back to top

Same as TCA.log at the Standard log level with the additional ability to show the message in the Controller's Output window as a notification.

Arguments

text. The message text (string).

Return value

A promise that will be fulfilled with no arguments.

Example

TCA.outputMessage("My output message").then(function(){
  TCA.done();
}).catch(function (error) {
  TCA.doneWithError(error);
}); 

Back to top

Begins a transaction in a Vuser script that will be ended in another Vuser script.

Arguments

name. The name of the transaction (string).

identifier. The identifier of the transaction (string). The same value is used by TCA.crossTransactionEnd(name, identifier, type) to identify the transaction.

Return value

A promise that will be fulfilled with no arguments.

Example

TCA.crossTransactionStart("transactionName", "TransactionId").then(function(){
  TCA.done();
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Ends a transaction in a Vuser script that has been started in another Vuser script.

Arguments

name. The name of the transaction (string).

identifier. The identifier of the transaction (string). The value of the parameter must be identical to the value of the identifier param that the Vuser initiating the transaction used in TCA.crossTransactionStart(name, identifier).

type. One of the following: "Pass", "Fail", "Auto", "Abort", or "Stop".

Return value

A promise that will be fulfilled with no arguments.

Example

TCA.crossTransactionEnd("transactionName", "TransactionId", "Pass").then(function(){
  TCA.done();
}).catch(function (error) {
  TCA.doneWithError(error);
}); 

Back to top

Returns the duration of a specific transaction, in seconds.

Arguments

name. The name of the transaction (string).

Return value

A promise that will be fulfilled with a string, which is the duration of a specific transaction, in seconds.

Example

None

Back to top

Starts a LoadRunner transaction.

Arguments

name. (String) The name of the transaction to start.

Return value

A promise that will be fulfilled with no arguments.

Example

TCA.startTransaction("login_tr1").then(function(){
  TCA.done();
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Sets the default end status of open transactions.

Arguments

status. One of the following transaction status values: "Pass", "Fail". The "Auto" status is not applicable.

The TCA.setTransactionStatus function sets the default end status of currently open transactions which have "Auto" in their TCA.endTransaction(name, status) statement.

If you make a series of calls to functions that modify the "Auto" status, then it is the last call before TCA.endTransaction that effectively changes the status.

Return value (void)

A promise that will be fulfilled with no arguments.

Example

TCA.setTransactionStatus("Fail").then(function(){
  TCA.done();
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Sets the default end status of a single open transaction by the transaction name.

Arguments

status. One of the following transaction status values: "Pass", "Fail". The "Auto" status is not applicable.

name. The name of the transaction to set.

The TCA.setTransactionStatusByName function sets the default end status of the transaction with the defined name. This transaction must have "Auto" in its TCA.endTransaction(name, status) statement.

If you make a series of calls to functions that modify the "Auto" status, then it is the last call before TCA.endTransaction that effectively changes the status.

Return value (void)

A promise that will be fulfilled with no arguments.

Example

TCA.setTransactionStatusByName("Fail", "T1").then(function(){
  TCA.done();
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Ends a LoadRunner transaction.

Arguments

name. The name of the transaction to end (string).

status. One of the following status values: “Pass”, “Fail”, “Auto”

Return value

A promise that will be fulfilled with no arguments.

Example

TCA.endTransaction("login_tr1", status).then(function(){
  TCA.done();
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Runs a specific function in C language, defined in the C-functions.c file.

Arguments

funcname. The function name (string).

functimeout. The maximum expected runtime, in seconds, of the function called by the step (number). The default timeout is 60 seconds.

Return value

A promise that will be fulfilled with no arguments.

Example

TCA.evalC("myFunc", 20).then(function(){
  TCA.done();
}).catch(function (error) {
  TCA.doneWithError(error);
}); 

Back to top

Returns the text after unmasking.

Arguments

text. The masked text (string).

Return value

A promise that will be fulfilled with a string, which is the text after unmasking.

Example

TCA.unmask(str).then(function(result){ 
  TCA.done(result);
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Records a user-defined data point for analysis.

Arguments

name. The name of the data point (string). Do not begin a data-point name with any of these strings: HTTP, NON_HTTP, RETRY, mic_, stream_, mms_

value. The numeric value (number).

Return value

A promise that will be fulfilled with no arguments.

Example

TCA.userDataPoint("myDP", 1).then(function(){
  TCA.done();
}).catch(function (error) {
  TCA.doneWithError(error);
}); 

Back to top

Indicates which Vuser is handling a specific script.

Arguments

text. Any text string (string).

Return value

A promise that will be fulfilled with no arguments.

Example

TCA.vuserStatusMessage("FlightStatus").then(function(){
  TCA.done();
}).catch(function (error) {
  TCA.doneWithError(error);
}); 

Back to top

Logs a message as a line in TruClient’s interactive/load log.

Arguments

text. The message (string).

level. Optional argument. One of the following:

• "Error"
• "Warning"
• "Standard" (default)
• "Extended"
• "Status" - sends a string to the Status area of the Controller. It also sends the string to the Vuser log. When run from VuGen, the message is sent to output.txt.
• "Status_msg"

Return value

A promise that will be fulfilled with no arguments.

Example

TCA.log("my warning", "Warning").then(function(){
  TCA.done();
}).catch(function (error) {
  TCA.doneWithError(error);
}); 

Back to top

Enables you to change the log level during script replay. To restore initial log level setting, use TCA.restoreLogLevel.

Arguments

level. Specify the log level:

• "Disabled". Disables the log level. It still captures a log including the error level.
• "Standard". Standard log captured.
• "Extended". Extended log file captured.

log_flags. (Object) If the log level is set to extended, you can specify which data is captured using Boolean(true/false) flags as properties of json_object.

Any flag which is omitted will be considered as “false”.

• log_http
• log_AUT
• log_parameters

Return value

A promise that will be fulfilled with no arguments.

Example

• Disable the log level:

  TCA.setLogLevel(“Set the log level to “Disabled”).then(function(){
    TCA.done();
  }).catch(function (error) {
    TCA.doneWithError(error);
  });

• Enable the standard log:

  TCA.setLogLevel(“Standard”).then(function(){          
    TCA.done();     
  }).catch(function (error) {           
    TCA.doneWithError(error);     
  });

• Enable the extended log:

  TCA.setLogLevel(“Extended”).then(function(){          
    TCA.done();
  }).catch(function (error) {
    TCA.doneWithError(error);
  });

• Enable the extended log, and specify which logs to capture:

  TCA.setLogLevel(“Extended”,{ log_http : true, log_AUT: true, log_parameters: true}).then(function(){
    TCA.done();
  }).catch(function (error) {
    TCA.doneWithError(error);
  });

Back to top

Restore log level to the initial setting.

Arguments

None

Return value

A promise that will be fulfilled with no arguments.

Example

TCA.restoreLogLevel().then(function(){
  TCA.done();
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Stops logging URL requests.

Arguments

None

Return value

A promise that will be fulfilled with no arguments.

Example

TCA.stopLogRequests().then(function(){
  TCA.done();
}).catch(function (error) {
  TCA.doneWithError(error);
}); 

Back to top

Enables you to set a proxy address manually in the script.

Arguments

option. Specify the type of proxy you want to use.

• "PROXY_NONE". No proxy
• "PROXY_SYSTEM". Use system proxy; settingsString will be ignored.
• "PROXY_MANUAL". Manually set proxy.
• "PROXY_PAC". Use a proxy auto-config (PAC) file.

settings. The details of the proxy setting (string).

Return value

A promise that will be fulfilled with no arguments.

Example

• Use system proxy settings. The second argument is ignored, so it can be any string value, usually empty.

  Note: Because schema needs two arguments, the second one cannot be omitted.

  TCA.setProxy("PROXY_SYSTEM", "").then(function(){
    TCA.done();
  }).catch(function (error) {
    TCA.doneWithError(error);
  });

• Manually set proxy and set separate proxy for different protocols (http & https).

  TCA.setProxy("PROXY_MANUAL", '{"proxyShare":false,"proxyHttp":" proxy.xxx.com ","proxyHttpPort":8080,"proxySsl":" proxy.yyy.com ","proxySslPort":8080}').then(function(){
    TCA.done();
  }).catch(function (error) {
    TCA.doneWithError(error);
  });

• Manually set proxy and share the proxy settings for all protocols (http, https, …).

  Note: If you also specify an address for “proxySsl”, it will be ignored because “proxyShare” is set to true.

  TCA.setProxy("PROXY_MANUAL", '{"proxyShare":true,"proxyHttp":"proxy.xxx.com","proxyHttpPort":8080}').then(function(){
    TCA.done();
  }).catch(function (error) {
    TCA.doneWithError(error);
  });

• Use manually set proxy which is already in memory (maybe set previously, maybe nothing is set).

  Note: If you are not sure which setting is in memory, it is recommended that you explicitly specify the proxy settings you want to use every time.

  TCA.setProxy("PROXY_MANUAL ", "").then(function(){
    TCA.done();
  }).catch(function (error) {
    TCA.doneWithError(error);
  });

• Do not use any proxy.

  Note: The proxy address/port that are set in the options sections are not removed. The settings in memory can be activated in another call (refer to the next example).

  TCA.setProxy("PROXY_NONE", "").then(function(){
    TCA.done();
  }).catch(function (error) {
    TCA.doneWithError(error);
  });

• Use PAC.

  TCA.setProxy("PROXY_PAC",'{"proxyPAC":"http://autocache.xyzcorp.net/"}').then(function(){
    TCA.done();
  }).catch(function (error) {
    TCA.doneWithError(error);
  });

Back to top

Adding a filter to one of the denylist or allowlist lists of URLs. The URL of each HTTP request will be checked first against the denylist, and then the allowlist. HTTP requests that do not pass the check will be blocked.

Arguments

url. String or regular expression representing the URL (string).

isIncluded. True to add the URL to allowlist, or false to add the URL to denylist (boolean).

Return value

A promise that will be fulfilled with no arguments.

Example

Set only the allowed domain on the allowlist. All other domains are blocked.

String example:

UtilsA.addAutoFilter("http://www.myco.com/*", true).then(function(){
  TCA.done();
}).catch(function (error) {
  TCA.doneWithError(error);
});

Regular expression example:

UtilsA.addAutoFilter(/^http:\/\/www\.myco\.com\/.*/, true).then(function(){
  TCA.done();
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Remove all filters from both the denylist and allowlist lists of URLs.

Arguments

None

Return value

A promise that will be fulfilled with no arguments.

Example

UtilsA.cleanupAutoFilters().then(function(){
  TCA.done();
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Adding an HTTP header to every consecutive HTTP requests following this function call.

Arguments

header. The name of the header to be added (string).

value. The value of the header to be added (string).

merge. "True" indicates to merge the value with an existing header by the same name; "false" indicates to overwrite it (boolean).

Note: Merge does not support modifying the following headers: "content-type", "content-disposition", "content-length", "user-agent", "referer", "host", "authorization", "proxy-authorization", "if-modified-since", "if-unmodified-since", "from", "location", "max-forwards"

Return value

A promise that will be fulfilled with no arguments.

Example

UtilsA.addAutoHeader("someCustomHeader", "someValue", true).then(function(){
  TCA.done();
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Removes all HTTP headers and stops adding HTTP headers to every consecutive HTTP request following this function call.

Arguments

None

Return value

A promise that will be fulfilled with no arguments.

Example

UtilsA.cleanupAutoHeaders().then(function(){
  TCA.done();
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Removes an HTTP header added with Utils.addAutoHeader and stops adding this HTTP header to every consecutive HTTP request following this function call.

Arguments

header. The name of the header to be stopped from being added.

Return value

A promise that will be fulfilled with no arguments.

Example

UtilsA.removeAutoHeader("someCustomHeader").then(function(){
  TCA.done();
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Remove a filter that was added using Utils.addAutoFilter from the denylist or allowlist of URLs.

Arguments

filter. String representing the URL.

isInclude. True value indicates the allowlist, false otherwise.

Remarks

Use the exact same filter URL value that was added to the list.

Return value

A promise that will be fulfilled with no arguments.

Example

UtilsA.removeAutoFilter("http://www.myco.com/*", true).then(function(){
  TCA.done();
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Clears the cache of a single Vuser; the content of the whole cache simulator is unaffected.

Arguments

None

Return value

A promise that will be fulfilled with no arguments.

Example

None

Back to top

Removes all cookies currently stored by the Vuser.

Arguments

None

Return value

A promise that will be fulfilled with no arguments.

Example

None

Back to top

Adds a new cell as the last field of a column to a value.

Equivalent method in LoadRunner: lrvtc_send_message

Arguments

colName. The name of the column (string).

value. The value as a string (string).

vtsName. The alias of the VTS server (string, optional).

Remarks

If the column specified in the argument does not exist, the column will be created and the cell content is set to the argument value.

Return value

A promise that will be fulfilled with 0 if completed successfully/ If not completed successfully, it will throw an error.

Example

TCA.vtcAddCell("MyColumn","myValue","MyVts").then(function(result){
  TCA.done(result);
}).catch(function (error) {
  TCA.doneWithError(error);
}); 

Back to top

Sets the data in multiple columns.

Equivalent method in LoadRunner: lrvtc_send_row1

Arguments

colNames. The column names delimited by a semicolon (string).

values. The values as a string delimited by a semicolon (string).

option. Define how the values are added (integer).

• 0. Add as same row in all columns based on the column with the highest row count. The created row will be n+1 for all columns.
• 1. Add as stack - last row in every column.
• 2. Add as unique stack - last row in every column only if the value is unique in the column.

vtsName. The alias of the VTS server (string, optional).

Remarks

If the columns specified in the argument do not exist, the columns will be created and the cell contents will be set to the argument values.

Return value

A promise that will be fulfilled with 1 if completed successfully. If not completed successfully, it will throw an error.

Example

TCA.vtcAddCells("MyColumn1;MyColumn2;MyColumn3", "MyValue1;MyValue2;MyValue3", 0, "MyVts").then(function(result){
  TCA.done(result);
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Sets the last field of a column to a value if the value does not exist in the column.

Equivalent method in LoadRunner: lrvtc_send_if_unique

Arguments

colName. The name of the column (string).

value. The value (string).

vtsName. The alias of the VTS server (string, optional).

Remarks

If the column specified in the argument does not exist, the column will be created and the cell content is set to the argument value.

Return value

A promise that will be fulfilled with a boolean: true if the value exists in the column, and false if the value does not exist. If not completed successfully, it will throw an error.

Example

TCA.vtcAddUniqueCell("MyColumn",1,"MyVts").then(function(result){
  TCA.done(result);
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Clears all data in a column.

Equivalent method in LoadRunner: lrvtc_clear_column

Arguments

colName. The name of the column (string).

vtsName. The alias of the VTS server (string, optional).

Remarks

If the column specified in the argument does not exist, the step will run without returning an error and no data in the VTS is changed.

Return value

A promise that will be fulfilled with 0 if completed successfully; If not completed successfully, it will throw an error.

Example

TCA.vtcClearColumn("MyColumn","MyVts").then(function(result){
  TCA.done(result);
}).catch(function (error) {
  TCA.doneWithError(error);
}); 

Back to top

Clears the data in a field.

Equivalent method in LoadRunner: lrvtc_clear_message

Arguments

colName. The name of the column (string).

rowIndex. The index number of the field (integer). 1 is the first field in the column.

vtsName. The alias of the VTS server (string, optional).

Remarks

If the column or the row index specified in the argument does not exist, the step will run without returning an error and no data in the VTS will be changed.

Return value

A promise that will be fulfilled with 0 if completed successfully. If not completed successfully, it will throw an error.

Example

TCA.vtcClearCell("MyColumn",1,"MyVts").then(function(result){
  TCA.done(result);
}).catch(function (error) {
  TCA.doneWithError(error);
}); 

Back to top

Clears the values from all fields in a row.

Equivalent method in LoadRunner: lrvtc_clear_row

Arguments

rowIndex. The index number of the field (integer). 1 is the first field in the column.

VtsName. The alias of the VTS server (string, optional).

Remarks

If the row index specified in the argument does not exist, the step will run without returning an error and no data will be changed in the VTS.

Return value

A promise that will be fulfilled with 0 if completed successfully; If not completed successfully, it will throw an error.

Example

TCA.vtcClearRow(1,"MyVts").then(function(result){
  TCA.done(result);
}).catch(function (error) {
  TCA.doneWithError(error);
}); 

Back to top

Returns the number of fields that contain data in a column.

Equivalent method in LoadRunner: lrvtc_column_size

Arguments

colName. The name of the column (string).

vtsName. The alias of the VTS server (string, optional).

Return value

A promise that will be fulfilled with the number of fields in the column, or 0 if the column does not exist. If not completed successfully, it will throw an error.

Example

TCA.vtcColumnSize("MyColumn","MyVts").then(function(result){
  TCA.done(result);
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Creates a connection to the server (supports HTTP).

Equivalent method in LoadRunner: lrvtc_connect

Arguments

serverName. Either the IP or server name (string).

port. The port number (integer).

vtsName. The alias of the VTS server (string, optional).

Return value

A promise that will be fulfilled with 0 if completed successfully; If not completed successfully, it will throw an error.

Example

TCA.vtcConnect("MyServer", 8888, "MyVts").then(function(result){
  TCA.done(result);
}).catch(function (error) {
  TCA.doneWithError(error);
}); 

Back to top

Creates a connection to the server (supports HTTP, HTTPS version VTS server, basic authentication based on user name and password entered by the user, and NTLM authentication).

Equivalent method in LoadRunner: lrvtc_connect_ex

Arguments

serverName. Either the IP or server domain name (string). The protocol can be omitted; the default protocol is “https://”.

port. The port number (integer). The available range is 1-65535.

userName. The user name for basic or NTLM authentication (string, optional).

password. The password for basic or NTLM authentication (string, optional).

domain. The domain name for NTLM authentication (string, optional).

vtsName. The name of the VTS connection (string, optional).

Return value

A promise that will be fulfilled with 0 if completed successfully; If not completed successfully, it will throw an error.

Example

TCA.vtcConnectEx("MyServer", 8888, "MyUser", "MyPW", "MyDomain", "MyVts").then(function(result){
  TCA.done(result);
}).catch(function (error) {
  TCA.doneWithError(error);
}); 

Back to top

Creates a column.

Equivalent method in LoadRunner: lrvtc_create_column

Arguments

colName. The name of the column (string).

VtsName. The alias of the VTS server (string, optional).

Remarks

If a column of the same name already exists, the function does nothing.

Return value

A promise that will be fulfilled with 0 if completed successfully; If not completed successfully, it will throw an error.

Example

TCA.vtcCreateColumn("MyColumn","MyVTS").then(function(result){
  TCA.done(result);
}).catch(function (error) {
  TCA.doneWithError(error);
}); 

Back to top

Disconnects from the server.

Equivalent method in LoadRunner: lrvtc_disconnect

Arguments

vtsName. The alias of the VTS server (string, optional).

Return value

A promise that will be fulfilled with 0 if completed successfully; with no arguments if on error.

Example

TCA.vtcDisconnect("MyVts").then(function(result){
  TCA.done(result);
}).catch(function (error) {
  TCA.doneWithError(error);
}); 

Back to top

Returns the data in a field.

Equivalent method in LoadRunner: lrvtc_query_column

Arguments

colName. The name of the column (string).

rowIndex. The index number of the field (integer). 1 is the first field in the column.

vtsName. The alias of the VTS server (string, optional).

Return value

If data exists in the specified column and row, it returns a promise that will be fulfilled with a string, the data in the specified cell. If the specified column or index does not exist, it returns null.

Example

TCA.vtcGetCell("MyColumn",1,"MyVts").then(function(result){
  TCA.done(result);
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Returns the data in a row as a JavaScript object. The properties of the object will be set to the column names

Equivalent method in LoadRunner: lrvtc_query_row

Arguments

rowIndex. The index number of the field (integer). 1 is the first field in the column.

vtsName. The alias of the VTS server (string, optional).

Remarks

If the column specified in the argument does not exist, a null value will be returned for every column.

Return value

A promise that will be fulfilled with an object, which is the field from the specified index in all columns. If the column does not have a value in the specified index, the value is an empty string. Example: {col1:”larry”,col2:””}

Example

TCA.vtcGetRowCells(1,"MyVTS").then(function(result){
  TCA.done(result);
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Increments a counter stored in a field.

Equivalent method in LoadRunner: lrvtc_increment

Arguments

colName. The name of the column (string).

rowIndex. The index number of the field (integer). 1 is the first field in the column.

value. The value.

vtsName. The alias of the VTS server (string, optional).

Remarks

If the column name specified in the argument does not exist, the column will be created and the cell referenced by the index will be set to the argument value.

If the index specified in the argument exceeds the column size, the cell is created by the specified index and the cell contents is set to the argument value.

If the column referenced by the index contains a string, the cell contents are replaced with the value argument.

If the column referenced by the index contains an integer, the value will be incremented to the integer.

Return value

A promise that will be fulfilled with 0 if completed successfully; If not completed successfully, it will throw an error.

Example

TCA.vtcIncrement("MyColumn",1,1,"MyVTS").then(function(result){
  TCA.done(result);
}).catch(function (error) {
  TCA.doneWithError(error);
}); 

Back to top

Pops the first field from a column.

Equivalent method in LoadRunner: lrvtc_retrieve_message

Arguments

colName. The name of the column (string).

vtsName. The alias of the VTS server (string, optional).

Return value

A promise that will be fulfilled with a string, which is the value of the first index in the column, or with null if the column is empty or does not exist.

Example

TCA.vtcPopCell("MyColumn","MyVts").then(function(result){
  TCA.done(result);
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Pops the data in a row as a JavaScript object.

Arguments

vtsName. The alias of the VTS server (string, optional).

Return value

A promise that will be fulfilled with an object, which is the first field from the columns. If the column is empty, the value is null. For example, {col1:”larry”,col2:""}

Example

TCA.vtcPopCells( "MyVts").then(function(result){
  TCA.done(result);
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Pops the first fields from specified columns. Returned as a JavaScript object. The properties of the object will be set to the column names.

Equivalent method in LoadRunner: lrvtc_retrieve_messages1

Arguments

colNames. The names of the columns (string).

vtsName. The alias of the VTS server (string, optional).

Remarks

If the column name specified in the argument does not exist, a null value will be returned.

Return value

A promise that will be fulfilled with an object, which is the first field from the specified columns. If the column is empty, the value is null. Example: {col1:”larry”,col2:""}

Example

TCA.vtcPopMultipleCells("MyColumn","MyVts").then(function(result){
  TCA.done(result);
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Retrieves the first field from the specified column and moves the values to the bottom.

Equivalent method in LoadRunner: lrvtc_rotate_messages

Arguments

colName. The name of the column (string).

option. Define how the values are rotated (integer).

• 1. Add as stack - Retrieve data from column, and move it to the bottom to the last valid row of every column.

• 2. Add as unique stack - Retrieve data from column, and move it to the bottom to the last valid row if the data is unique.

vtsName. The alias of the VTS server (string, optional).

Remarks

If the column name does not exist, a null value will be returned and a new column will be added to the table.

Return value

A promise that will be fulfilled with a string, the first field of the specified column. If the column is empty, the value is an empty string.

Example

TCA.vtcRotateCell("MyColumn1", 1, "MyVts").then(function(result){
  TCA.done(result);
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Retrieves the first field from all columns and moves the values to the bottom.

Equivalent method in LoadRunner: lrvtc_rotate_row

Arguments

option. Define how the values are rotated (integer).

• 0. Same row – Retrieve data from all columns and move it to the bottom for all columns, based on the column with the highest row count. The created row will be n+1 for all columns.
• 1. Add as stack - Retrieve data from all columns and move it to the bottom to the last valid row of every column.
• 2. Add as unique stack - Retrieve data from all columns and move it to the bottom to the last valid row of every column only if the data is unique.

vtsName. The alias of the VTS server (string, optional).

Remarks

If there is no data in a row, a null value will be retrieved.

Return value

A promise that will be fulfilled with an object, which is the first field from the columns. If column is empty, the value is an empty string. Example: {col1:”larry”,col2:””}

Example

TCA.vtcRotateCells (0, "MyVts").then(function(result){
  TCA.done(result);
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Retrieves the first field from the specified columns and moves the values to the bottom.

Equivalent method in LoadRunner: lrvtc_rotate_messages1

Arguments

ColNames. The column names delimited by a semicolon (string).

option. Define how the values are rotated (integer).

• 0. Same row – Retrieve data from all columns and move it to the bottom for all columns based on the column with the highest row count. The created row will be n+1 for all columns.

• 1. Add as stack - Retrieve data from all columns, and move it to the bottom to the last valid row of every column.

• 2. Add as unique stack - Retrieve data from all columns, and move it to the bottom to the last valid row of every column if the data is unique.

vtsName. The alias of the VTS server (string, optional).

Remarks

If the column name does not exist, a null value will be returned and a new column will be added to the table.

Return value

A promise that will be fulfilled with an object, which is the first field from the specified columns. If the column is empty, the value will be an empty string. Example: {col1:”larry”,col2:””}

Example

TCA.vtcRotateMultipleCells("MyColumn1;MyColumn2;MyColumn3", 0, "MyVts").then(function(result){
  TCA.done(result);
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Searches for a row containing specific values in specific columns.

Equivalent method in LoadRunner: lrvtc_search_row

Arguments

columns. The names of the columns to search. The column names are separated by the delimiter.

values. The values of the columns to search. The values are separated by the delimiter.

delimiter. The character that separates the column names and values in the lists. If a string, rather than a single character, is passed in delimiter, the string as a whole is the delimiter.

VtsName. The alias of the VTS server.

Remarks

If the column specified in the argument does not exist, the return value is empty.

Return value (number)

Returns the whole row values if the value of columns exist. For example: {col1:"a", col2:"b",col3:"c"}. Otherwise, it returns an empty value. If not completed successfully, it will throw an error.

Example

TCA.vtcSearchRow("col1,col2", "a,b", ",", "test");

Back to top

Replaces a specific value inside a set of columns with a new value.

Equivalent method in LoadRunner: lrvtc_update_all_message_ifequals

Arguments

ColNames. The column names delimited by a semicolon (string).

Message. New value (string).

Ifmessage. Original value (string).

Delimiter. Delimiter to separate column names. By default, the separator value is a semicolon (;).

Return value

A promise that will be fulfilled with 0 if completed successfully. If not completed successfully, it will throw an error.

Example

TCA.vtcUpdateAllMessageIfequals("MyColumn1;MyColumn2;MyColumn3", "NewVal1", "OldVal1").then(function(result){  
  TCA.done(result);
}).catch(function (error) {
  TCA.doneWithError(error);
}); 

Back to top

Replaces the data in a field.

Equivalent method in LoadRunner: lrvtc_update_message

Arguments

colName. The name of the column (string).

rowIndex. The index number of the field (integer). 1 is the first field in the column.

value. The value (string).

vtsName. The alias of the VTS server (string, optional).

Remarks

If the column name or index does not exist, the column and/or the cell referenced by the index will be created and the cell contents set to the argument value.

Return value

A promise that will be fulfilled with 0 if completed successfully. If not completed successfully, it will throw an error.

Example

TCA.vtcUpdateCell("MyColumn",1,"MyValue","MyVTS").then(function(result){
  TCA.done(result);
}).catch(function (error) {
  TCA.doneWithError(error);
}); 

Back to top

Replaces the data in a field if the current data equals a given value.

Equivalent method in LoadRunner: lrvtc_update_message_ifequals

Arguments

colName. The name of the column (string).

rowIndex. The index number of the field (integer). 1 is the first field in the column.

value. The replacement value (string).

comparedValue. If the current cell contents are the same as the comparedValue, the cell contents are replaced with value (string).

vtsName. The alias of the VTS server (string, optional).

Return value

A promise that will be fulfilled with a boolean value: false if a field with the same value exists or true if there is no field with the same value in the column. If not completed successfully, it will throw an error.

Example

TCA.vtcUpdateEqualsCell("MyColumn",1,"MyValue","MyCompareValue","MyVTS").then(function(result){
  TCA.done(result);
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Replaces the data in multiple fields.

Equivalent method in LoadRunner: lrvtc_update_row1

Arguments

ColNames. The column names delimited by a semicolon (string).

rowIndex. The index number of the field (integer). 1 is the first field in the column.

values. The values as a string delimited by a semicolon (string).

vtsName. The alias of the VTS server (string, optional).

Remarks

If the column name or index does not exist, the column and/or the cell referenced by the index will be created, and the cell contents set to the argument value.

Return value

A promise that will be fulfilled with 0 if completed successfully. If not completed successfully, it will throw an error.

Example

TCA.vtcUpdateRowCells("MyColumn1;MyColumn2;MyColumn3", 1, "MyNewValue1;MyNewValue2;MyNewValue3", "MyVts").then(function(result){
 TCA.done(result);
}).catch(function (error) {
  TCA.doneWithError(error);
}); 

Back to top

Returns the value of the command line parameter passed to the test or the its default value. If the attribute doesn't exist, it returns an empty string.

Arguments

name. The name of the command-line parameter (string).

The command-line parameter name is generally assigned by the user in the Additional Attributes tab in VuGen > Runtime Settings or in the Controller in the group command line argument.

When the test is run, the additional attribute or the group command line argument is passed to the test as a parameter in the command line. During test run, the value can be accessed with this function.

Return value

A promise that will be fulfilled with a string, which is the value of the command line parameter passed to the test or the default value set for it.

Example

To get the Controller command line argument, -MyServerURL http://myserver.com, call:

TCA.getAttr(“MyServerURL”).then(function(result){
  TCA.done(result);
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Creates the specified folder. If needed, creates all the folders necessary to complete the path.

Arguments

path. The absolute path of the folder (string).

Return value

A promise that will be fulfilled with no arguments.

Example

IOA.createDir(TC.outputDir + "mydir").then(function(){
  TCA.done();
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Deletes the specified folder or file. If a folder is specified, deletes all the files in the folder, including sub-directories.

Arguments

path. The absolute path of the folder or file (string).

Return value

A promise that will be fulfilled with no arguments.

Example

IOA.delete(TC.outputDir + "mydir").then(function(){
  TCA.done();
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Returns true if the specified folder or file exists, and false if it does not, or for a disconnected or unauthenticated mapped drive.

Arguments

path. The absolute path of the folder or file (string).

Return value

A promise that will be fulfilled with a boolean: true if file exists, and false if it does not.

Example

IOA.isExist(TC.outputDir + "mydir").then(function(result){
  TCA.done(result);
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Returns all the data from the specified file. Converts the data from the specified charset to unicode.

Arguments

filename. The absolute path of the file (string).

charset. The charset of the file, if it is not UTF-8 (string).

Return value

A promise that will be fulfilled with a string, which is all the data from the specified file.

Example

IOA.read(TC.scriptDir + "mylog.txt").then(function(data){
  TCA.done();
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Writes the string to the specified file. If the file does not exist it is created.

Arguments

filename. The absolute path to the file (string).

input. The string to write to the file (string).

append. (boolean)

• true. Append the string to the end of the file (default).
• false. Overwrite the file with the string.

charset. The charset of the file, if it is not UTF-8 (string).

Return value

A promise that will be fulfilled with a boolean which is always true.

Example 1

IOA.write(TC.scriptDir + "mylog.txt", "first msg\n", false).then(function(result){
  TCA.done(result);
}).catch(function (error) {
  TCA.doneWithError(error);
});

Example 2

IOA.write(TC.scriptDir + "mylog.txt", "second msg").then(function(result){
  TCA.done(result);
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Returns the value of the specified environment variable. Returns an empty string if the specified variable does not exist.

Arguments

name. The name of the environment variable (string).

Return value

A promise that will be fulfilled with a string, which is the value of the specified environment variable.

If the specified value does not exist, returns a promise that will be fulfilled with no arguments.

Example

UtilsA.getEnv("PATH").then(function(path){
  TCA.done(path);
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Evaluates the specified JavaScript file in the arguments context.

Arguments

filename. The absolute path to the JavaScript file (string).

Return value

A promise that will be fulfilled with no arguments.

Example

UtilsA.import(TC.scriptDir + "myjs.js").then(function(){
  TCA.done();
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Returns true if the specified environment variable exists and false if it does not exist.

Arguments

name. The name of the environment variable (string).

Return value

A promise that will be fulfilled with a boolean: true if the specified environment variable exists, and false if it does not exist.

Example

UtilsA.isEnvExists("PATH").then(function(exist){
  TCA.done(exist);  //exist is true
}).catch(function (error) {
  TCA.doneWithError(error);
});

UtilsA.isEnvExists("TC_kukuku").then(function(exist){
  TCA.done(exist);   //exist is false
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top

Sets the named environment variable to the specified value. If the variable already has a value it is overwritten.

Arguments

name. The name of the environment variable (string).

value. The value to which to set the environment variable (string).

Return value

A promise that will be fulfilled with no arguments.

Example

UtilsA.setEnv("PATH", "C:\\loadrunner\\").then(function(){
  TCA.done();
}).catch(function (error) {
  TCA.doneWithError(error);
});

Back to top