plugins/doc/org.eclipse.papyrus.sirius.properties.doc/src/site/mediawiki/papyrus-sirius-properties-userDoc.mediawiki - papyrus/org.eclipse.papyrus-sirius - Git at Google

 = Introduction =

 Starting from version 2.1.0, Papyrus supports the definition of properties view by using EEF technology.

 EEF Properties view display same properties view to user than by using Papyrus Properties View.
 Same tabs and same sections will be retrieve in EEF properties View.

 =Apply EEF properties view=

 Papyrus provide a preference to activate EEF properties view instead of Papyrus properties view. To activate EEF property view, user needs to open the Papyrus preferences, from ''Window>Preferences''.

 Then, user has to display ''Papyrus>EEF Properties view'' preference page.

 [[File:../../../image/user/activateEEFpreference.png|500px]]

 If user wants to display EEF Properties view, he has to check the preference ''Activate EEF Properties View''.
 Eclipse will take into account the new choice after a restart.

 = Legacy Semantic Tabs =

 ''Advanced'' tab given by EMF is displayed in properties view when an element is selected in the model Explorer view.

 [[File:../../../image/user/modelExplorer_advancedTab.png|1000px]]

 This tab is also displayed in properties view when an element is selected in a Sirius representation. In this case, this tab is called ''semantic''.

 [[File:../../../image/user/siriusRepresentation_semanticTab.png|1000px]]

 In case of properties view displayed on element from Sirius representation, user can hide this tab by unchecking preference ''Show semantic tab'' from Sirius preferences (''Sirius>Sirius Properties view'').

 [[File:../../../image/user/semanticTabPreference.png|500px]]

 = Custom widgets =

 In the properties view, there are various types of widgets to manipulate and display values of semantic elements: text widgets, checkboxes, combo boxes, radio buttons, ...

 Some of Sirius specifiers need to build custom or complex Properties view to match their designers and their needs.
 These new Properties View are defined with advanced controls described in the following parts.

 == Papyrus Reference widget ==

 A new Papyrus Reference Widgets is available specifically to handle various relations between elements of the UML model.
 The reference widget is used to edit four kind of references:

 * Multi-valued references with containment.
 * Multi-valued references without containment.
 * Mono-valued references with containment.
 * Mono-valued references without containment.

 === Multi-valued references with containment ===
 Multi-valued references with containment are represented by a widget with a table that contains the list of elements of the relation and some buttons to manage the reference.

 [[File:../../../image/user/multi-valuedReferenceWithContainment_example.png]]

 The user can double-click on each element of the list to display properties of this element in a new properties dialog.
 Several buttons are displayed in column on the right side of the list :

 * '''Up and Down''' buttons : they allow to change the order of the list by moving the selected elements. These buttons do not appear if the reference is not ordered. If no element is selected in the list, these buttons are grayed.
 * '''Add''' button : it allows to create a new element in the list. It is grayed if the list contains the maximum number of items allowed by the reference.
 ** After clicking on the button, if the type of the element is simple (only one type can be contained by the reference), a properties dialog is displayed. This dialog allows to fill all the fields of the object to create.
 *** [[File:../../../image/user/addButtonDialog.png]]
 ** If the type of the element is complex (several types can be contained by the reference), a wizard is invoked before the display of the properties dialog. This wizard allow the user to choose the type of the object he wants to create.
 *** [[File:../../../image/user/addWizardDialog.png]]

 * '''Remove''' button : it removes the selected element from the reference. If none element is selected in the list, this button is grayed.
 * '''Edit''' button : it displays the properties dialog used to edit values of the selected element. If none element is selected in the list, this button is grayed.

 [[File:../../../image/user/editButtonDialog.png]]

 === Multi-valued references without containment ===
 Multi-valued references without containment are represented by the same widget, but with the ''Browse'' button in addition and a different behavior on the ''Add'' button.

 [[File:../../../image/user/multi-valuedReferenceWithoutContainment_example.png]]

 * '''Browse''' button : it allows the user to select an element in the model to add to the reference. If no element is selected in the list, this button is grayed.

 [[File:../../../image/user/browseButtonMultiRefWithoutContainment.png]]

 * '''Add''' button : it still allows to create a new element in the list but a wizard is invoked each time you click on the button before displaying properties dialog. This wizard allows the user to choose the container of the new object, the reference used to contain this element and its type.

 [[File:../../../image/user/addButtonMultiRefWithoutContainment.png]]

 === Mono-valued references with containment ===
 Mono-valued references with containment are represented by a widget with one element and some buttons to manage the reference.

 [[File:../../../image/user/mono-valuedReferenceWithContainment_example.png]]

 User can double-click on the element to display properties of this element in a new properties dialog.
 Several buttons are displayed horizontally on the right side of the element :

 * '''Add''' button : the behavior is the same as that of the Multi-valued references with containment.
 * '''Edit''' button : the behavior is the same as that of the Multi-valued references with containment.
 * '''Remove''' button : it removes the element targeted by the reference. Note that this button may be not available if the reference is required or is a container.

 === Mono-valued references without containment ===
 Mono-valued references without containment are represented by the same widget as above, but with the ''Browse'' button in addition.

 [[File:../../../image/user/mono-valuedReferenceWithoutContainment_example.png]]

 * '''Browse''' button : it invokes the same Dialog as the ''Browse'' button for Multi-valued references without containment.
 == Language Expression widget ==

 The Language Expression Widget has been specifically created to handle UML "BodyOwner" elements such as OpaqueExpressions, OpaqueActions, OpaqueBehaviors and FunctionBehaviors. This Widget allows to create a list of expressions that are described by a language and a text field.

 [[File:../../../image/user/expressionLanguageWidget_OCL_example.png]]

 According to the language selected on the left part of the widget, a specific editor is displayed on the right part.

 For the OCL language, an Xtext editor is displayed with several functionalities to assist user. For example, syntax highlighting and auto-completion are provided for the OCL language using the Xtext technology.

 For other languages, NaturalLanguageEditor is used. This Papyrus editor is a multi-String editor.ing editor.

 Several buttons are displayed horizontally on the right side of the languages list:
 * '''Up''' and '''Down''' buttons allow to change the order of the list by moving the selected elements. If no element is selected in the list, these buttons are grayed.
 * '''Browse''' button allows to browse existing languages from the "Language Registry" and add one or many languages to the languages list of the Language Expression widget.

 [[File:../../../image/user/expressionLanguageWidget_browseDialog.png]]

 * '''Add''' button allows to add a new custom language to the languages list of the Language Expression widget.
 * '''Remove''' button removes the selected language and its body. This button is grayed if no element is selected.
 * '''Edit''' button allows to edit the name of the selected language. This button is grayed if no element is selected. The user can also double-click on the language to edit its name.

 [[File:../../../image/user/expressionLanguageWidget_editDialog.png]]
	= Introduction =

	Starting from version 2.1.0, Papyrus supports the definition of properties view by using EEF technology.

	EEF Properties view display same properties view to user than by using Papyrus Properties View.
	Same tabs and same sections will be retrieve in EEF properties View.

	=Apply EEF properties view=

	Papyrus provide a preference to activate EEF properties view instead of Papyrus properties view. To activate EEF property view, user needs to open the Papyrus preferences, from ''Window>Preferences''.

	Then, user has to display ''Papyrus>EEF Properties view'' preference page.

	[[File:../../../image/user/activateEEFpreference.png\|500px]]

	If user wants to display EEF Properties view, he has to check the preference ''Activate EEF Properties View''.
	Eclipse will take into account the new choice after a restart.

	= Legacy Semantic Tabs =

	''Advanced'' tab given by EMF is displayed in properties view when an element is selected in the model Explorer view.

	[[File:../../../image/user/modelExplorer_advancedTab.png\|1000px]]

	This tab is also displayed in properties view when an element is selected in a Sirius representation. In this case, this tab is called ''semantic''.

	[[File:../../../image/user/siriusRepresentation_semanticTab.png\|1000px]]

	In case of properties view displayed on element from Sirius representation, user can hide this tab by unchecking preference ''Show semantic tab'' from Sirius preferences (''Sirius>Sirius Properties view'').

	[[File:../../../image/user/semanticTabPreference.png\|500px]]

	= Custom widgets =

	In the properties view, there are various types of widgets to manipulate and display values of semantic elements: text widgets, checkboxes, combo boxes, radio buttons, ...

	Some of Sirius specifiers need to build custom or complex Properties view to match their designers and their needs.
	These new Properties View are defined with advanced controls described in the following parts.

	== Papyrus Reference widget ==

	A new Papyrus Reference Widgets is available specifically to handle various relations between elements of the UML model.
	The reference widget is used to edit four kind of references:

	* Multi-valued references with containment.
	* Multi-valued references without containment.
	* Mono-valued references with containment.
	* Mono-valued references without containment.

	=== Multi-valued references with containment ===
	Multi-valued references with containment are represented by a widget with a table that contains the list of elements of the relation and some buttons to manage the reference.

	[[File:../../../image/user/multi-valuedReferenceWithContainment_example.png]]

	The user can double-click on each element of the list to display properties of this element in a new properties dialog.
	Several buttons are displayed in column on the right side of the list :

	* '''Up and Down''' buttons : they allow to change the order of the list by moving the selected elements. These buttons do not appear if the reference is not ordered. If no element is selected in the list, these buttons are grayed.
	* '''Add''' button : it allows to create a new element in the list. It is grayed if the list contains the maximum number of items allowed by the reference.
	** After clicking on the button, if the type of the element is simple (only one type can be contained by the reference), a properties dialog is displayed. This dialog allows to fill all the fields of the object to create.
	*** [[File:../../../image/user/addButtonDialog.png]]
	** If the type of the element is complex (several types can be contained by the reference), a wizard is invoked before the display of the properties dialog. This wizard allow the user to choose the type of the object he wants to create.
	*** [[File:../../../image/user/addWizardDialog.png]]

	* '''Remove''' button : it removes the selected element from the reference. If none element is selected in the list, this button is grayed.
	* '''Edit''' button : it displays the properties dialog used to edit values of the selected element. If none element is selected in the list, this button is grayed.

	[[File:../../../image/user/editButtonDialog.png]]

	=== Multi-valued references without containment ===
	Multi-valued references without containment are represented by the same widget, but with the ''Browse'' button in addition and a different behavior on the ''Add'' button.

	[[File:../../../image/user/multi-valuedReferenceWithoutContainment_example.png]]

	* '''Browse''' button : it allows the user to select an element in the model to add to the reference. If no element is selected in the list, this button is grayed.

	[[File:../../../image/user/browseButtonMultiRefWithoutContainment.png]]

	* '''Add''' button : it still allows to create a new element in the list but a wizard is invoked each time you click on the button before displaying properties dialog. This wizard allows the user to choose the container of the new object, the reference used to contain this element and its type.

	[[File:../../../image/user/addButtonMultiRefWithoutContainment.png]]

	=== Mono-valued references with containment ===
	Mono-valued references with containment are represented by a widget with one element and some buttons to manage the reference.

	[[File:../../../image/user/mono-valuedReferenceWithContainment_example.png]]

	User can double-click on the element to display properties of this element in a new properties dialog.
	Several buttons are displayed horizontally on the right side of the element :

	* '''Add''' button : the behavior is the same as that of the Multi-valued references with containment.
	* '''Edit''' button : the behavior is the same as that of the Multi-valued references with containment.
	* '''Remove''' button : it removes the element targeted by the reference. Note that this button may be not available if the reference is required or is a container.

	=== Mono-valued references without containment ===
	Mono-valued references without containment are represented by the same widget as above, but with the ''Browse'' button in addition.

	[[File:../../../image/user/mono-valuedReferenceWithoutContainment_example.png]]

	* '''Browse''' button : it invokes the same Dialog as the ''Browse'' button for Multi-valued references without containment.
	== Language Expression widget ==

	The Language Expression Widget has been specifically created to handle UML "BodyOwner" elements such as OpaqueExpressions, OpaqueActions, OpaqueBehaviors and FunctionBehaviors. This Widget allows to create a list of expressions that are described by a language and a text field.

	[[File:../../../image/user/expressionLanguageWidget_OCL_example.png]]

	According to the language selected on the left part of the widget, a specific editor is displayed on the right part.

	For the OCL language, an Xtext editor is displayed with several functionalities to assist user. For example, syntax highlighting and auto-completion are provided for the OCL language using the Xtext technology.

	For other languages, NaturalLanguageEditor is used. This Papyrus editor is a multi-String editor.ing editor.

	Several buttons are displayed horizontally on the right side of the languages list:
	* '''Up''' and '''Down''' buttons allow to change the order of the list by moving the selected elements. If no element is selected in the list, these buttons are grayed.
	* '''Browse''' button allows to browse existing languages from the "Language Registry" and add one or many languages to the languages list of the Language Expression widget.

	[[File:../../../image/user/expressionLanguageWidget_browseDialog.png]]

	* '''Add''' button allows to add a new custom language to the languages list of the Language Expression widget.
	* '''Remove''' button removes the selected language and its body. This button is grayed if no element is selected.
	* '''Edit''' button allows to edit the name of the selected language. This button is grayed if no element is selected. The user can also double-click on the language to edit its name.

	[[File:../../../image/user/expressionLanguageWidget_editDialog.png]]