Page History

Rows returned after filtering.

Getting Row Elements in Specific Row Numbers

getRow( rowNumber : int ) : Element

$table.getRow($rowNumber)

Where the parameter is: 

• rowNumber – the row number starts with 0.

The returned value is an Element.

Getting Column Names

Column names are referred by column IDs. A column is a MagicDraw QProperty ID that is not readable or accessible by the user. We need to create other methods that provide better usability than using QProperty ID. Use the following methods to retrieve column names.

Getting Column Names from Column ID

getColumn( columnId : String) : String

$table.getColumn($columnId)

Where the parameter is:

• columnId – the ID of a column. Using column IDs has a benefit of consistency between different languages, for example, French and English. The column ID can be retrieved by the method getColumnIds().

The returned value is the name of a column.

Getting Column Names from Column Numbers

getColumn(columnNumber : int) : String

$table.getColumn($columnNumber)

Where the parameter is: 

• columnNumber – a column number starts with 1. The column number 0 is the row number.

The returned value is the name of a column.

Getting All Column Names

getColumnNames() : List<String>

$table.getColumnNames()

The returned value is a list of column names. 

Example code:

Prints all column names.

#foreach($colname in $table.getColumnNames()) 
$colname 
#end

Getting All Column IDs

getColumnIds() : List<String>

$table.getColumnIds()

The returned value is a list of column IDs.

Example code:

Print all columns IDs

#foreach($colid in $table.getColumnIds()) 
$table.getColumn($colid) 
#end

Getting Cell Values

A cell value is the value in a row element with a column name. To get a cell value, you need to provide both the row element and column. A cell value is an Element or row number. Use the following methods to retrieve a cell value.

Getting Values from Row Element and Column ID

getValue( rowElement : Element, columnIdOrName : String ) : Object

$table.getValue($rowElement, $columnId)

Where the parameters are: 

• rowElement – a row element.
• columnId – a column ID.

The returned value is the value in a cell. If the cell contains an element, the value is the Element.
Example code:

Prints the row, column, and value.

#foreach($diagram in $project.getDiagrams("Generic Table")) 
#set($table = $generic.getTable($diagram)) 
#foreach($row in $table.getRows()) 
<h1>$row.name</h1> 
#foreach($col in $table.getColumnIds()) 
$table.getColumn$col) : $table.getValue($row, $col) 
#end
#end
#end

Getting Values from Row Element and Column Name

getValue( rowElement : Element, columnIdOrName : String ) : Object

$table.getValue($rowElement, $columnName)

Where the parameters are: 

• rowElement – a row element.
• columnName – a column name.

The returned value is the value in a cell. If the cell contains an element, the value is the Element.

Getting Values from Row Element and Column Number

getValue( rowElement : Element, columnNumber : int ) : Object

$table.getValue($rowElement, $columnNumber)

Where the parameters are: 

• rowElement – a row element.
• columnName – a column number starts with 1. The column number 0 is the row number. 

The returned value is the value in a cell. If the cell contains an element, the value is the Element.

Getting Values from Row and Column Numbers

getValue( rowNumber : int, columnNumber : int ) : Object

$table.getValue($rowNumber, $columnNumber)

Where the parameters are: 

• rowNumber – a row number starts with 0.
• columnNumber – a column number starts with 1. The column number 0 is the row number. 

The returned value is the value in a cell. If the cell contains an element, the value is the Element.

Getting Values from Row Element and Column IDs as String

getValueAsString( rowElement : Element, columnIdOrName : String ) : String

$table.getValueAsString($rowElement, $columnId)

Where the parameters are: 

• rowElement – a row element.
• columnId – a column ID.

The returned value is the value in a cell and is converted into String. The String value is created by MagicDraw text representation API.

Getting Values from Row Element and Column Name as String

getValueAsString( rowElement : Element, columnIdOrName : String ) : String

$table.getValueAsString($rowElement, $columnName)

Where the parameters are: 

• rowElement – a row element
• columnName – a column name 

The returned value is the value in a cell and is converted into String. The String value is created by MagicDraw text representation API.

Getting Values from Row Element and Column Number as String

getValueAsString( rowElement : Element, columnNumber : int ) : String

$table.getValueAsString($rowElement, $columnNumber)

Where the parameters are: 

• rowElement – a row element.
• columnName – a column number starts with 1. The column number 0 is the row number. 

The returned value is the value in a cell and is converted into String. The String value is created by MagicDraw text representation API.

Getting Values from Row and Column Numbers as String

getValueAsString( rowNumber : int, columnNumber : int ) : String

$table.getValueAsString($rowNumber, $columnNumber)

Where the parameters are: 

• rowNumber – a row number starts with 0.
• columnNumber – a column number starts with 1. The column number 0 is the row number.

The returned value is the value in a cell and is converted into String. The String value is created by MagicDraw text representation API.

Getting Visible Column and Cell Values

A visible cell value is the column which is visible on a diagram. Unlike the methods described in section 23.1.5 Getting Cell Values, the following methods will retrieve only the value which is visible on a diagram.

Getting All Visible Column IDs

getVisibleColumnIds() : List<String>

$table.getVisibleColumnIds()

The returned value is a list of visible column IDs.

Getting Visible Column Names from Column Numbers

getVisibleColumn( columnNumber : int) : String

$table.getVisibleColumn($columnNumber)

Where the parameter is: 

• columnNumber – a column number starts with 1. The column number 0 is the row number.

The returned value is the name of a visible column.

Getting Visible Values from Row Elements and Column Number

getVisibleValue( rowElement : Element, columnNumber : int ) : Object

$table.getVisibleValue($rowElement, $columnNumber)

Where the parameters are: 

• rowElement – a row element.
• columnNumber – a column number starts with 1. The column number 0 is the row number. 

The returned value is the value in a visible cell. If the cell contains an element, the value is the Element.

Getting Visible Values from Row Number and Column Number

getVisibleValue( rowNumber : int, columnNumber : int ) : Object

$table.getVisibleValue($rowNumber, $columnNumber)

Where the parameters are: 

• rowNumber – a row number starts with 0.
• columnNumber – a column number starts with 1. The column number 0 is the row number. 

The returned value is the value in a visible cell. If the cell contains an element, the value is the Element.

Getting Visible Values from Row Element and Column Number as String

getVisibleValueAsString( rowElement : Element, columnNumber : int ) : String

$table.getVisibleValueAsString($rowElement, $columnNumber)

Where the parameters are: 

• rowElement – a row element.
• columnNumber – a column number starts with 1. The column number 0 is the row number.

The returned value is the value in a visible cell and is converted into String. The String value is created by MagicDraw text representation API.

Getting Visible Values from Row and Column Numbers as String

getVisibleValueAsString( rowNumber : int, columnNumber : int ) : String

$table.getVisibleValueAsString($rowNumber, $columnNumber)

Where the parameters are:

• rowNumber – a row number starts with 0.
• columnNumber – a column number starts with 1. The column number 0 is the row number.

The returned value is the value in a visible cell and is converted into String. The String value is created by MagicDraw text representation API.