Programming the Reader Configuration

When the reader is launched from rules or Java code, you can set options to tweak the reader's behavior.

Map options = new HashMap();
options.put(Options.OPTION_XMI_READ_PROFILES_STANDARDIZED, Boolean.TRUE);
Model umlModel =...
umlModel.read("Enterprise Architect Application", "", options);

Programmatic Properties

The model reader can be configured.

• Options.OPTION_XMI_READ_PROFILES_STANDARDIZED
  • Determines whether Enterprise Architect profiles are replaced by the standard ones during reading. The available standard profile is SysML 1.3.
    If true, the native Enterprise Architect SysML 1.3 profile is replaced by a reference to the standard OMG SysML 1.3 Profile.
  • Default: true.
• Options.OPTION_XMI_READ_DIAGRAM_ZOOM
  • Determines the zoom value to apply when reading Enterprise Architect.
  • Default: 1.0f.
• Options.OPTION_XMI_READ_EXTENSIONS
  • Determines whether Enterprise Architect specific extensions in the XMI file must be parsed.
  • Default: false.
  • More Information on how to Read Extensions.
• Options.OPTION_XMI_READ_EXTENSIONS_SUBSET
  • Determines whether Enterprise Architect specific extensions in the XMI file must be parsed.
    Only listed properties will be extracted. Properties should be described by a qualifiedName category.propertyKey.
    The value could be a Collection of String, or a String containing all qualified names separated by a comma.
  • Default: null.
  • More Information on how to Read Extensions.
• Options.OPTION_APP_XMI_VERSION
  • Determines the UML and XMI versions used when Enterprise Architect exports the temporary XMI file.
    Possible values:
    • EA21 for UML 2.1 (XMI 2.1)
    • EA211 for UML 2.1.1 (XMI 2.1)
    • EA212 for UML 2.1.2 (XMI 2.1)
    • EA22 for UML 2.2 (XMI 2.1)
    • EA23 for UML 2.3 (XMI 2.1)
    • EA24 for UML 2.4 (XMI 2.4)
    • EA241 for UML 2.4.1 (XMI 2.4.2)
  • Default: EA241
• Options.OPTION_APP_XMI_FORMATTED
  • Determines whether the XMI temporary file is formatted. If false, the entire content is on one line only.
  • Default: true.
• Options.OPTION_APP_XMI_DTD
  • Determines whether a DTD should be generated along the temporary XMI file.
  • Default: false.
• Options.OPTION_APP_DIAGRAM_XML_EXPORT
  • Determines the way the diagram information are exported.
    Possible values:
    • EXPORT - Export Diagram data.
    • EXPORT_ALONG_ALTERNATE_IMAGES- Export Diagram data and Diagram images.
  • Default: EXPORT.
• Options.OPTION_APP_DIAGRAM_IMAGE_FORMAT.
  • Determines the format of diagram images to export. The Option Options.OPTION_APP_DIAGRAM_XML_EXPORT must be set to EXPORT_ALONG_ALTERNATE_IMAGES.
    Possible values:
    • NONE
    • EMF - Metafile Format
    • BMP - Bitmap Format
    • GIF - GIF Format
    • PNG - PNG Format
    • JPG - JPG Format
  • Default: NONE.
  
  Here is a sample code that shows how to export Diagram Images for Enterprise Architect:

  	import com.sodius.mdw.metamodel.uml21.io.ea.Options;
  	...
  	Map<String, Object> options = new HashMap<String, Object>();
  	options.put(Options.OPTION_APP_DIAGRAM_XML_EXPORT, DiagramXMLExport.EXPORT_ALONG_ALTERNATE_IMAGES);
  	options.put(Options.OPTION_APP_DIAGRAM_IMAGE_FORMAT, DiagramImageFormat.PNG);
  	
  	MDWorkbench workbench = MDWorkbenchFactory.create();
  	Model umlModel = workbench.getMetamodelManager().getMetamodel("uml21").createModel();
  	umlModel.read("Enterprise Architect Application", "", options);
  	
  	// loop on all diagrams
  	for (Diagram diagram : model.<Diagram>getInstances("Diagram")) {
  		System.out.println("Diagram: " + diagram.getName());
          
  		// query the diagram image
  		DiagramFileImage image = (DiagramFileImage) model.getDiagram(diagram, new DiagramOptions());
  		System.out.println("Image: " + image.getFile());
  		image.dispose();
  	}
  	...
  	umlModel.clear();
  	

• Options.OPTION_APP_PACKAGE_SELECTION
  • Determines the package to read.
  • Default: empty string.
• Options.OPTION_GRAPH_NODES_HIERARCHY
  • Determines whether the hierarchy of Graph Nodes should be created.
  • Default: true.
• Options.OPTION_IMPROVE_WAYPOINTS
  • Determines whether the waypoints coordinates have to be improved.
  • Default: false.
• Options.OPTION_IMPROVE_CONNECTORS
  • Enable fixing ConnectorEnds partWithPort from Diagram drawing.
  • Enable fixing Connector not contained in good owner.
  • Default: true.
• Options.OPTION_FIX_ILLEGAL_TRANSITIONS
  • Determines whether the illegal Transitions should be fixed.
  • Default: true.
• Options.OPTION_FIX_CONSTRAINT_POSITION
  • Determines whether Constraints in Packages should be moved in a more convenient Namespace owner.
  • Default: true.
• Options.OPTION_FIX_ILLEGAL_LIFELINES
  • Determines whether Lifelines representing InterfaceRealization or Usage should instead represent a Port that Provided or Required those Interfaces.
  • Default: true.
• Options.OPTION_PROFILES_REFERENCE_TO_STRING
  • Determines whether Stereotype's Tags referring to complex types (Classes, Datatype with attributes) are converted to String.
  • Default: false.
• Options.OPTION_CONVERT_PRIMITIVE_TYPE_STANDARD
  • Determines whether references to language specific primitive types (as EAJavaTypesPackage::int) are converted to UML standard Primitive Types (as Integer).
  • Default: false.
• Options.OPTION_XMI_READ_LOG_XMLNODE_LEVEL
  • Determines level of XML Nodes displayed in log in case of critical exception during reading.
    
    • 0 : no Node displayed in logs
    • 1 : current node displayed in logs
    • 2-* : including parents and their content in logs
  • Default: 0.

Diagram Interchange
Profile and Stereotypes

Reading UML Data
Reading Enterprise Architect Data
Reading a Package
Reading Extensions
Managing Ids

MDAccess UML API Reference
MDAccess for MagicDraw API Reference