1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
|
h1. Customization of model with EMF Facet
{toc}
EMF Facet provides a customization component, that can be used to define the appearance of model elements when viewed in an editor or view that supports this customization mechanism.
h1. Creation of .custom file
A customization is defined in a model that conforms to the EMF Facet customization metamodel. This model is saved in a file with the ".custom" file extension. The file can be created via a wizard in Eclipse from “New -> EMF Facet -> Create a customization 0.2” option in menu and will prompt the user for the nsURI and prefix for the customization model. The following screen captures show step by step the creation process :
!WizardCreation1.png!
Figure 1 : custom file creation wizard
!WizardCreation2.png!
Figure 2 : file name selection
!WizardCreation2.png!
Figure 3 : nsURI and prefix specification for the model
Upon the creation of the customization model file, the editor will open and allow the user to populate the model:
!EditorWithEmptyFile.png!
Figure 4 : empty Customization created from the wizard
Customization is a specific FacetSet acting as the main container for the customization elements. These elements may be customization for
EClass or Facet; each of them containing DerivedTypedElement such as FacetAttribute, FacetReference, and FacetOperation.
h1. EClassCustom and FacetCustom
h2. Creation and basic edition
Custom classes can be created when a Customization element is selected, the far right panel displays buttons to ease the creation of such
elements:
!EClassCustomCreation1.png!
Figure 5 : creation of an EClassCustom
The dialog allows specifying generic features for Custom classes and the properties view is always there to fine-tune different features:
!EClassCustomEdition.png!
Figure 6 : Edition of an EClassCustom
In this example, the EClassCustom extends the metaclass from the org.eclipse.emf.facet.examples.library metamodel, the editor will
automatically load every model in which a facet specifies this metamodel, hence the loading of .efacet and .custom files available in the
platform. This allow an easy access of all declared facets bound to an element of the customized metamodel.
The process is identical for the creation of a FacetCustom:
!FacetCustomCreation1.png!
Figure 7 : creation of a FacetCustom
h2. Fine-tune edition
If needed, properties view allows the user to have a more advanced control on custom elements:
!FineTuneEClassCustomization.png!
Figure 8 : fine-tune edition of an EClassCustom
Also, applied customization are strongly affected by the order the manager load them up, the editor provides a way to modify this order by
selecting an element and press either the “Up” or “Down” bottom. This results in modifying the index of the selected element in its
containment list.
h1. DerivedTypedElement
h2. Creation and basic edition
Custom element, either ECLassCustom or FacetCustom, contains DerivedTypeElement. Those elements can be FacetAttribute, FacetReference or
FacetOperation. The most used lement for Customization is the FacetOperation: each of these FacetOperations overrides the FacetOperation
corresponding to the customizable feature you want to customize: label, font, color, etc…
In order to create a FacetOperation, a FacetCustom or an EClassCustom must be selected:
!FacetOperationCreation1.png!
Figure 9 : creation of a FacetOperation
Finally, the user must provide an implementation for an overriding FacetOperation, by the means of a Query that will return the value of the
customization when this Query is evaluated on a model element that conforms to the extendedFacet. If the query has not been written yet, the
wizard provides an easy wizard to create the Query directly extending one of the Query class available, or the editor will scan the project
and prompt the user to choose among a list of available query classes.
!FacetOperationSpecifyQuery.png!
Figure 10 : Creation of a Query for a FacetOperation
If a FacetOperation is selected, it is possible to add parameters. This parameter is useful for customizing the structural feature
corresponding to a single customized model element:
!addParameter.png!
Figure 11 : adding a parameter to a FacetOperation
h2. Structured views
The left tree is the main navigator of the model in the editor, when a Custom element is selected or any DerivedTypeElement, the right panel
shows the list of all child derivedTypeElements, or brother depending on the nature of the left panel selection. This panel offers a quick
overview of the DerivedTypeElement:
!RightPaneldescription.png!
Figure 12 : detailed view of the right panel
An icon symbolizes the override customization facet, all icons are as follow:
* !attributes.gif! means the derivedTypeElement is not a FacetOperation
* !customizationLabel.png! stands for “label”
* !fontBold.png! stands for “isBold”
* !fontItalic.bmp! stands for “isItalic”
* !fontName.png! stands for “fontName”
* !fontSize.png! stands for “fontSize”
* !fontStrukethrough.bmp! stands for “isStrikethrough”
* !fontUnderline.bmp! stands for “isUnderlined”
* !imageCustomization.png! stands for “image”
* !rgb.png! stands for “foreground” or “background”
* !middleLeftOverlay.png! stands for “middleLeftOverlay”
* !middleRightOverlay.png! stands for “middleRightOverlay”
* !topLeftOverlay.png! stands for “topLeftOverlay”
* !topMiddleOverlay.png! stands for “topMiddleOverlay”
* !topRightOverlay.png! stands for “topRightOverlay”
* !bottomRightOverlay.png! stands for “bottomRightOverlay”
* !bottomMiddleOverlay.png! stands for “bottomMiddleOverlay”
* !bottomLeftOverlay.png! stands for “bottomLeftOverlay”
h2. Fine-tune edition
An advanced control of FacetOperation, and moreover DerivedTypeElement, is available via the properties view:
!facetOperationWithPropertiesView.png!
Figure 13 : fine-tune edition of a FacetOperation
|
