Migration Guide

This section documents changes in XGEE that require manual adjustments to existing projects.

ShapeFromResource Attributes Cleanup

The attributes sizeX and sizeY have been removed from the ShapeFromResource class in the Editor Model (editorModel.ecore). These attributes were obsolete and ignored by the XGEE runtime, as the size is controlled by the containing object (e.g., Vertex).

Action Required: You must update your .editorModel files to remove these attributes from any ShapeFromResource elements. Failure to do so may prevent the model from loading.

Example Migration:

Old code (Allocations.editorModel):

<shape xsi:type="xgeeDisplayStyles:ShapeFromResource" sizeX="20.0" sizeY="20.0" filepath="shapes/io.svg"/>

New code:

<shape xsi:type="xgeeDisplayStyles:ShapeFromResource" filepath="shapes/io.svg"/>

Note: The effective size of the element continues to be determined by the sizeX and sizeY attributes of the parent Vertex, SubVertex, or Container.

ReferringObject Attributes Deprecation

The refersTo containment reference and the attributes nsURI and className on ReferringObject (inherited by Vertex, Edge, SubVertex) have been deprecated. These fields are ignored by the XGEE runtime, which relies on the Editor configuration and queryStr for type resolution.

Runtime Warning: XGEE will now issue a console warning if it detects that refersTo (with content), nsURI, or className are set in your editor model.

Action Required: Update your .editorModel files to remove the <refersTo> block and the nsURI / className attributes from Vertex and Edge definitions. The metamodel constraint has been relaxed (lowerBound="0") to facilitate this removal.

Example Migration:

Old code:

<displayableObjects xsi:type="xgeeDisplayObjects:Vertex" name="Task" nsURI="http://oaam.de/oaam/model/functions" className="Task">
   <refersTo refNsURI="http://oaam.de/oaam/model/functions" refClassname="Task"/>
   <!-- ... -->
</displayableObjects>

New code:

<displayableObjects xsi:type="xgeeDisplayObjects:Vertex" name="Task">
   <!-- refersTo, nsURI, and className removed -->
   <!-- ... -->
</displayableObjects>