Share this page

# TC.vtcRotateMultipleCells

Retrieves the first field from the specified columns and moves the values to the bottom. If the column name does not exist, a null value is returned and a new column is added to the table.

Equivalent method in VuGen: lrvtc_rotate_messages1

TC.vtcRotateMultipleCells(colNames, option, vtsName);

## Arguments

Name | Description
--- | ---
colNames | (string) The names of the columns, delimited by a semicolon.
option | (integer) Defines how the values are rotated. 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 is 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 (Optional) | (string) The alias of the VTS server.

## Return value

(object) The first field from the columns.

If a column is empty, the value is an empty string. For example, `{col1:"larry",col2:""}`.

## Example

Copy code

    TC.vtcRotateMultipleCells("MyColumn1;MyColumn2;MyColumn3", 0, "MyVts");

Tips to improve your search results... VuGen Function Reference Version 25.1-25.3 Function Reference 25.1-25.3 All View Local Help Center View Online Help Center Version: