TOTABLE Function
Created by Harry Lewis, Modified on Fri, 25 Apr at 4:27 PM by Harry Lewis
Applies to:
- Velixo NX only
- not available with Velixo Classic
The Velixo NX TOTABLE function converts an Excel array into an Excel table and places that table into the specified cell range.
While some Velixo functions have built-in support for table mirroring (e.g., the GI and SI.QUERY functions), the TOTABLE function is provided to help you create tables when using functions which do not include this built-in support.
TABLE OF CONTENTS
Syntax
TOTABLE(Array, KeyColumnIndex, DataIncludesHeader, OutputColumn1, OutputColumn2,...,OutputColumnN)
Parameters
The TOTABLE function uses the following parameters:
Parameter | Required/ Optional | Description |
Array | Required | The array which is to be converted to a table. This *must* be an array (and not just a set of individual values) |
KeyColumnIndex | Required if more than one Output Column is specified. | if user-entered values (not those returned by a Velixo function) are be included in the resulting table, you must specify which columns in the input array represent unique keys (uniquely identify each row of the data). If more than one column is required to uniquely identify each row, you can pass an inline array of column indexes. This works the same as the Excel SORT() function - for example =SORT(A1#, {1,3}) would sort the array specified in cell A1 by column 1 and then by 3. |
DataIncludesHeader | Optional | True or False (default) Specifies whether or not the original array contains header information. |
OutputColumn1 | Required | If no other Output Column is specified, this parameter contains the cell location where the table is to be placed. If more than one Output Column is specified, this parameter specifies the cell in which the first column of the array is to appear within the table. |
OutputColumn2 | Optional | If more than one Output Column is specified, this parameter specifies the cell in which the second column of the array is to appear within the table. |
... | ||
OutputColumnN | Optional | If more than one Output Column is specified, this parameter specifies the cell in which the last column of the array is to appear within the table. |
Examples
These and other examples of creating tables with Velixo functions can be found in Table Mirroring.
Example 1 - convert entire array to table (with columns in same order) - Full Mirroring Mode=TOTABLE(B10#,,,P9) Description Creates a table (based on the results of the array defined in cell B10) and places that table starting in cell P9.
Result Note: This method is referred to as Full Mirroring Mode - meaning that the entire results (and ONLY the results) from the original array are included in the resulting table. |
Example 2 - convert entire array to table (changing column order) - Per-Column Mirroring Mode=TOTABLE(B10#, {2,1}, FALSE, K9, M9, I9, L9, N9, J9) Description Creates a table (based on the results of the array defined in cell B10) as follows:
This technique - where we both...
... is referred to as per-column mirroring mode
Result |
Example 3 - include (and maintain) user-entered data with the table - Per-Column Mirroring ModeIn this example, we have added a calculation to the end of our table: In order to maintain those calculated values when we refresh our report, we need to use per-column mirroring mode. =TOTABLE(A6#,{1,2,3,4},,I5,J5,K5,L5,M5,N5) Description This function creates a table (based on the results of the array defined in cell A6) as follows:
By using per-column mirroring mode, when the report is refreshed, the user-specified calculations in the highlighted column will be maintained (even if the results end up displaying different records). |
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article