Modeling tabular view columns

See the procedures on this page for modeling tabular view columns. 

Prerequisites

The procedures for modeling tabular view columns described on this page can be used for modeling columns for predefined tabular view definitions, custom tabular view definitions, and individual tabular view usages. However, the following procedure, Redefining the inherited renderer, must be done in all cases.

Redefining the inherited renderer

To redefine the inherited renderer

1. Ensure the package containing the view usage/definition for which you want to model columns imports KerML, SysML, and DS_Views packages.
   

   package CustomTabularViews {
       private import KerML::*;
       private import SysML::*;
       private import DS_Views::*;
   }

2. Ensure the following steps are done based on whether you want to model table columns for a view usage or a custom view definition:
   1. For a view usage:
      1. The view is defined by the needed tabular view definition.
      2. The view has an expose relationship. 
      3. (Optional) The view has filters.
   2. For a custom view definition:
      1. Ensure you have created the new view definition instance.
3. Within the body of the view usage/definition, declare the keywords render rendering, (optionally) specify the name for the element, and do one of the following:
   1. Redefine the inherited asTable renderer. This applies to:
      1. View usages: views defined by predefined tabular view definitions.
      2. View definitions: new custom tabular view definitions created from scratch or those reusing predefined tabular view definitions.
         
         

         All standard predefined tabular view definitions use the DS_Views::CoreViews::asTable renderer.

   2. Redefine the inherited renderer. This applies to:
      1. View usages: views defined by custom tabular view definitions.
      2. View definitions: new custom tabular view definitions that reuse custom-created tabular view definitions.
4. Click the Synchronize button. Proceed to model table columns.

Modeling tabular view columns

Removing inherited table columns

To remove inherited table columns

1. Ensure the inherited renderer is redefined.
2. Within the body of the renderer, declare a view, redefine the column you want to remove, and set its multiplicity to zero.
   

   The table columns that are inherited from the standard predefined tabular view definitions are indicated in the Tabular views table.

3. Click the Synchronize button.

Adding table columns

Adding table columns by feature

For more information, see the Column kinds table on the Tabular view columns page.

To add table columns by feature

1. Within the body of the renderer, declare a view, specify the column name, define it by CoreViews::ColumnByFeatureView, and subset column. 
2. Within the column view's body, declare ref item, redefine columnFeature, and specify the expression for the targeted metadata feature. 
3. Click the Synchronize button.
   

   view 'VCCU System Behavior Table' : 'System Behavior Table' {
      expose DroneStructure::**;
      render rendering :>> asNewTable1 {

         view 'Declared Name' : CoreViews::ColumnByFeatureView :> column {  // new column
            ref item :>> columnFeature = declaredName meta KerML::Core::Feature;  // targets Declared Name
         }

         view 'Declared Short Name' : CoreViews::ColumnByFeatureView :> column {  // new column 
            ref item :>> columnFeature = declaredShortName meta KerML::Core::Feature;  // targets Declared Short Name
         }
         view Documentation : CoreViews::ColumnByFeatureView :> column {  // new column 
            ref item :>> columnFeature = documentation meta KerML::Core::Feature;  // targets Documentation
         }
         view 'Qualified Name' : CoreViews::ColumnByFeatureView :> column {  // new column 
            ref item :>> columnFeature = qualifiedName meta KerML::Core::Feature;  // targets Qualified Name
         }
         view Owner : CoreViews::ColumnByFeatureView :> column {  // new column 
            ref item :>> columnFeature = owner meta KerML::Core::Feature;  // targets Owner
         }
         view 'Owned Element' : CoreViews::ColumnByFeatureView :> column {  // new column 
            ref item :>> columnFeature = ownedElement meta KerML::Core::Feature;  // targets for Owned Element
         }
      }
   }

   Alternative notation

   // the following expressions are equivalent:
   ref item :>> columnFeature = declaredShortName meta KerML::Core::Feature;
   ref item :>> columnFeature = declaredShortName.metadata as KerML::Core::Feature;

   
   

Adding table columns by expression

For more information, see the Column kinds table on the Tabular view columns page.

To add table columns by expression

1. Within the body of the renderer, declare a view, specify the element name, define it by CoreViews::ColumnByExpressionView, and subset column. 
2. Within the column view's body, declare the keywords render rendering, specify the name for the element, define it by the needed cell rendering definition, and subset CoreViews::asTableCell.
   

   The available table cell rendering can be found in the CoreViews package. 

   Click here to view them

       rendering def BooleanCellRendering :> TableCellRendering;
       rendering def ElementCellRendering :> TableCellRendering;
       rendering def EnumCellRendering :> TableCellRendering;
       rendering def IntegerCellRendering :> TableCellRendering;
       rendering def MetaobjectCellRendering :> TableCellRendering;
       rendering def RealCellRendering :> TableCellRendering;
       rendering def StringCellRendering :> TableCellRendering;

       rendering def TableCellRendering {
           calc getValue { in rowElement [0..1] : Metaobjects::Metaobject; }
           attribute isMultiValued [0..1] : ScalarValues::Boolean;
       }

   
   

3. Within the body of the rendering, declare a calculation and redefine getValue. Specify the in direction, redefine the rowElement. Specify the needed expression. See the example below.
4. Click the Synchronize button.

Modifying table columns

Modifying table column attributes

To modify table column attributes

1. (Conditional) For inherited columns, redefine the column whose attributes you want to modify.
2. Within the column view's body, redefine the needed attribute and set its value.
   

   Predefined column attributes are:

   • isMultiline. Learn more >>
3. Click the Synchronize button.