Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "Papyrus/Papyrus User Guide/Table Documentation"

(Table Property View: Add explanation for the paste in the table)
Line 264: Line 264:
  
 
<br>  
 
<br>  
 +
 +
== Paste From Spreadsheet in a Table ==
 +
Tables support the paste from Spreadsheet (Excel for example).
 +
 +
This feature is already configured for SysML Requirements and Allocations.
 +
 +
For Generic Table, the user must configure the paste himself.
 +
 +
Steps to paste in a Generic Table :
 +
 +
We assume that the user wants to paste rows (and not columns).
 +
*Create a new Generic table
 +
*Select the columns to display in your table.
 +
*Select the table in the ModelExplorer View in order to display its Property View
 +
*In the Property View goes into the Paste Tab. 4 informations must be completed by the user :
 +
**Detached Mode :
 +
***if false, Paste action uses the service edit (initialize default values, apply stereotypes required by element id).
 +
***if true, stereotype required by the element id will be ignored (uses Post Action to apply stereotypes)
 +
**Pasted Element Id : define the pasted element: org.eclispe.papyrus.uml.Class will create a UML Class
 +
***org.eclipse.papyrus.sysml.Requirement will create a uml.Class stereotyped Requirement if detached mode==false
 +
***org.eclipse.papyrus.sysml.Requirement will create a uml.Class
 +
**ContainementFeature : the feature owning the pasted elements
 +
**Post Actions : a way to define actions done just after the element creation but before to paste the cell value. Post Actions are not available when Detached Mode is false; Existing Post Actions allows to apply stereotypes
 +
 +
 +
 +
 +
 +
  
 
== Table Property View<br>  ==
 
== Table Property View<br>  ==

Revision as of 10:18, 31 March 2014

Since Papyrus 0.10 (Eclipse Kepler), Papyrus provides a new version of the tabular editors. This version will replace the previous version in Eclipse Luna.

Existing Tables

  • UML Generic Table
  • SysML Allocation Table
  • SysML Requirement Table
  • Views Table


UML Generic Table

Elements Accepted : UML Element only (all of them)

Filling Way : User, by Drag&Drop from the Model Explorer

Possible Context : all UML Element.

Save : All rows displayed in the table are saved in the model

Element Creation : All UML Elements


SysML Allocation Table

Elements Accepted : SysML Allocation only

Filling Way : Automatic, by Synchronization on the context of the model. Only the Allocation directly owned by the context of the table are displayed.

Possible Context : UML Package, with the SysML Profile Allocations applied.

Save : The Rows are not serialized in the model, because they are derived of the UML Model.

Element Creation : SysML Allocation


SysML Requirement Table

Elements Accepted : SysML Requirement only

Filling Way : Automatic, by Synchronization on the context of the model. Only the Requirements directly owned by the context of the table are displayed.

Possible Context : UML Package, with the SysML Profile Requirement applied.

Save : The Rows are not serialized in the model, because they are derived of the UML Model.

Element Creation : SysML Requirement


Views Table

Elements Accepted : Papyrus Views (Table/Diagram/...) only

Filling Way : Automatic, by Synchronization on the context of the model.

Possible Context : All UML Elements

Save : The Rows are not serialized in the model, because they are derived of the notation Model.

None


Table Features

The table framework provides a large number of features. Here we will describe all existing features supported by the framework, but not necessarly by all the tables.

  1. Edit Cell Values
  2. Change Axis (Columns/Row) Order
  3. Invert Axis (Exchange Column And Row)
  4. Add Axis (Column/Row) Element by Drag&Drop from another view (ModelExplorer)
  5. Remove Column/Row
  6. Destroy Column/Row Element
  7. Rename Column/Row Header
  8. Choose the Displayed Columns/Rows
  9. Choose the Displayed Columns/Rows for Stereotype Property in the popup menu
  10. Paste Columns/Rows From External Spreadsheet
  11. Display Index Column/Row Header
  12. Display Label Column/Row Header
  13. Configure Index Header Style (A, B, C...Z, AA, AB, ... or 0,1,2,3)
  14. Configure Label Header Style : select the information to Display in the Header Label (Name, Multiplicity, Type, Icon, isDerived)
  15. Export table into the Excel Format
  16. Print table
  17. Sort Column/Row Axis by Alphabetic order
  18. Sort Rows selecting one or several column header
  19. Save and restore Table Axis Configuration
  20. Select All
  21. AutoResize axis


Edit Cell Values

Double Click on a cell or selecting a cell then pressing F2, excepted for derived features

Change Axis Order

Click on the axis to move and drop it to its new location.

Invert Axis

Select the action Invert Axis in the popup menu or change it into the Table Property View.

Add Axis (Column/Row) Element by Drag&Drop

Select your element and drop it into the table, in the column region or in the row region to add it.

Remove Column/Row

Select the header of the axis to remove then right click and select Remove Column/Row. The axis will be remove of the table, but the represented element will continue to be in the model.

Destroy Column/Row Element

Select the header of the axis element to destroy then right click and select Destroy Column/Row Element. The represented element will be destroyed and its axis will be removed from the table.

Rename Column/Row Header

This function can do 2 things according to the usecase :

  • Rename the element represented by the axis, when the element is owned by your model
  • Define an alias to the axis, when the element is not owned by your model (UML Feature for example)

Select the header of the axis element to rename then right click and select Rename Header.

Choose the Displayed Columns/Rows

Right click in the table (not in the header) and select Columns ->  Create/Destroy Columns. (the same thing for rows

Choose the Displayed Columns/Rows for Stereotype Property in the popup menu

Right click in the table (not in the header) and select Select Stereotype Properties Columns (or Rows)


Features/Tables, when the Axis are NOT inverted.


UML Generic Table
SysML Allocation Table
SysML Requirement Table
Views Table
Content synchronized on table context
No
Yes
Yes
Yes
Edit Cell Value
Yes
Change Axis Order
Add Column Axis By Drag & Drop No
Add Row Axis By Drag & Drop All UML Elements
No (Synchronized table)
Remove Column
Yes
Remove Row
Yes
Destroy Column Element
Yes
Yes
Yes

Destroy Row Element
Yes
Yes
Yes

Rename Column Header




Rename Row Header




Choose the Displayed Columns
Yes
Choose the Displayed Columns for Stereotype Property in the popup menu

Choose the Displayed Rows
No
No
No

Choose the Displayed Rows for Stereotype Property in the popup menu
No
Paste Column From Spreadsheet
No
No
No

Paste Row From Spreadsheet
Yes
Display Index Column/Row Header
Display Label Column/Row Header
Configure Index Header Style
Configure Label Header Style
Export to Excel
Print table
Sort Column Axis By Name
Sort Row Axis By Name




Save and restore Table Axis Configuration
Yes
Select All
AutoResize axis
Yes








Paste From Spreadsheet in a Table

Tables support the paste from Spreadsheet (Excel for example).

This feature is already configured for SysML Requirements and Allocations.

For Generic Table, the user must configure the paste himself.

Steps to paste in a Generic Table :

We assume that the user wants to paste rows (and not columns).

  • Create a new Generic table
  • Select the columns to display in your table.
  • Select the table in the ModelExplorer View in order to display its Property View
  • In the Property View goes into the Paste Tab. 4 informations must be completed by the user :
    • Detached Mode :
      • if false, Paste action uses the service edit (initialize default values, apply stereotypes required by element id).
      • if true, stereotype required by the element id will be ignored (uses Post Action to apply stereotypes)
    • Pasted Element Id : define the pasted element: org.eclispe.papyrus.uml.Class will create a UML Class
      • org.eclipse.papyrus.sysml.Requirement will create a uml.Class stereotyped Requirement if detached mode==false
      • org.eclipse.papyrus.sysml.Requirement will create a uml.Class
    • ContainementFeature : the feature owning the pasted elements
    • Post Actions : a way to define actions done just after the element creation but before to paste the cell value. Post Actions are not available when Detached Mode is false; Existing Post Actions allows to apply stereotypes




Table Property View

The Property View of the table is accessible selecting the table in the ModelExplorer.


Back to the top