6.3. Custom Table Views and Editor

Beside the graphical editor for SysML models the tool offers a customizable table view that also supports editing of element properties. The view can be derived from a SysML model or any element and provides a filtered view on (the subset of) the elements in a model. Each row in the table shows a single model elements and its properties in subsequent columns. The view will synchronize automatically with the underlying model in case of changes so that the table is always showing the current model state.

A new table view can be created as follows:

  1. Select a SysML model, package, or part in the Model Browser

  2. Open the context menu and choose "Derive → Table View"

  3. In the upcoming dialog, enter a name for the view and select the scope for where the view shall be created. Confirm with OK.

  4. After creation the new table view will open automatically with the Cover page opened.

  5. Switch to the Worksheet page to view the model and configure the view to your needs.

Initially, the editor will show the whole model content as a structured tree-view in a single column. The view can now be customized to show and edit properties of the elements. Both aspects of customization are described in Configuration of a Table View.

6.3.1. Configuration of a Table View

The rows and columns of a table view can be configured to show and edit the relevant information about a SysML model. Configuring the view essentially means the following:

  • Since each row represents a model element the first aspect of a table configuration consists of selecting which SysML concepts the table view should include. Hence, the configuration allows you to filter the model content based on the meta-classes of SysML (i.e. language concepts such as block, part, port, and so on).

  • The second aspect of the configuration is related to the table columns. Each column can show one property of a SysML model element, for example: name, description, multiplicity, and so on. Beside native properties of SysML all profile properties can be added as columns to the table.

  • In addition to the element properties a table can have additional columns that are only available for the view itself. This provides a means to add comments, computed columns, or analysis related information to the table (e.g. risk graphs, references to other data).

Based on these principles the table configuration works as follows:

  1. Open the Worksheet page of a table and click on the Configuration button on top of the table

  2. The configuration dialog provides two pages for Rows and Columns. Select the Rows tab to start the configuration

  3. Check all SysML concepts that you want to appear in the editor. Note that the table will show elements always in the hierarchy where they are contained. Therefore additional elements might appear (i.e. the parents of the elements), but they will not be editable.

  4. Switch to the Columns tab to define which properties shall be shown. Here you will see all the concepts selected previsouly on the Rows tab including their properties.

  5. Select the properties or profile properties of the elements you want to get as columns in the table and use the "→" button to add them. You can remove columns by going the opposite direction using the "←" button.

  6. Note that in addition there is one entry shown named "Table Row". If you want to add columns dedicated to the table (i.e. only seen here) you can use the general profiling mechanism and add them. See also Profiling mechanism.

  7. The column ordering will be determined by the order of the properties on the right side. The list of properties from top-down will appear left to right. However, the column order is only the default and can be changed later using the Layout context menu as in any other table (cp. Table Layout).

Note that not all SysML properties are available in the current version of the tool. They will be added in subsequent releases.