From bf46808af145d943439cd6c8fb4fa4665e15740f Mon Sep 17 00:00:00 2001
From: Pierre-Charles David
Date: Fri, 8 Sep 2017 11:00:18 +0200
Subject: [519566] Document how to refer to external VSMs for properties
customizations
Bug: 519566
Change-Id: I05f749a44569df4a0d7f53e25637af81f27aad6a
Signed-off-by: Pierre-Charles David
Note that both mechanisms can be used to customize properties view descriptions which are defined in other projects. To allow references from you VSM to elements defined in other modelers, you must first
+ load them in your VSM editor, or you will not see the elements you need as targets for extension/overriding. To load an external VSM, right-click anywhere inside the VSM editor, and select
+ Load Resource.... A dialog will appear asking for the URI of the model to load (the
+ .odesign
file you want to refer to). Several forms of URIs are possible:
+
platform:/plugin/<projectName>/<path>/<to>/<example>.odesign
, for example
+ platform:/plugin/org.eclipse.emf.ecoretools.design/description/ecore.odesign
.
+ Note that in the later case (VSM selected from the workspace), if you want to test your modeler directly from your development environment, in your test session make sure to select the extended VSM + from the workspace, as this is the one your own VSM refers to, and not the one which may also be avaible from your plug-ins. In the viewpoint selection dialog, the version from the workspace will have a small folder decorator in addition to the normal viewpoint icon. Once everything is deployed as plug-ins, which is the nominal case for end-users, this distinction disappears and everything should work fine. +
+Note also that if you define in your project
+ A customizations for properties views defintions defined in another project
+ B, you should make sure to declare the dependency in project
+ A's
+ MANIFEST.MF
, otherwise it will be possible for users to install
+ A without having
+ B available, which will prevent
+ A from working correctly.
+
A
page can extend another page defined somewhere else (in another
diff --git a/plugins/org.eclipse.sirius.doc/doc/specifier/properties/Properties_View_Description.textile b/plugins/org.eclipse.sirius.doc/doc/specifier/properties/Properties_View_Description.textile
index 3fe7acf334..61b9a3a3cd 100644
--- a/plugins/org.eclipse.sirius.doc/doc/specifier/properties/Properties_View_Description.textile
+++ b/plugins/org.eclipse.sirius.doc/doc/specifier/properties/Properties_View_Description.textile
@@ -557,6 +557,14 @@ h2(#extensibility_features). Extensibility Features
Sirius has specific support for extending and overriding properties view descriptions without modifying the original one. The purpose is to be able to reuse or modify a part of a properties view. Its exits two different concepts to customize a properties view description: the "extension":#extends and the "overriding":#overrides.
+Note that both mechanisms can be used to customize properties view descriptions which are defined in other projects. To allow references from you VSM to elements defined in other modelers, you must first _load_ them in your VSM editor, or you will not see the elements you need as targets for extension/overriding. To load an external VSM, right-click anywhere inside the VSM editor, and select _Load Resource..._. A dialog will appear asking for the URI of the model to load (the @.odesign@ file you want to refer to). Several forms of URIs are possible:
+* If you don't have the customized plug-in in your workspace, you must currently enter the URI manually, using the syntax @platform:/plugin/