Schema Composer Scripting Integration
Although the Schema Composer provides out-of-the-box schema composition based on a variety of popular technologies, its scripting integration provides you with some flexibility in how you might go about implementing your own requirements. There are three ways in which you might leverage scripting within the Schema Composer:
- Provide custom schema generation using a scripting language
- Provide custom model transformation using a scripting language
- Provide custom stereotype mapping to any standard model transform (such as UPCC)
Model Transformation by script
While the Schema Composer provides in-built transforms for various frameworks, you can always write your own, using the composition tools of the Composer to design the schema, then performing a custom transform with a hand crafted script.
Schema Generation by script
When you select a message in the Schema Composer and click generate, you are presented with a number of export formats. One of those choices is 'Execute custom script'
Schema Iteration Scripting Example
* Script Name:
* Author: Sparx Systems
* Date: 6/12/2016
var schema as EA.SchemaComposer;
var xmlType as EA.SchemaType;
var xmlTypeEnum as EA.SchemaTypeEnum;
var xmlProp as EA.SchemaProperty;
var xmlPropEnum as EA.SchemaPropEnum;
var xmlChoice as EA.SchemaType;
var xmlChoiceEnum as EA.SchemaTypeEnum;
// Get SchemaComposer
schema = Repository.SchemaComposer;
// Get Schema Types Enumerator
xmlTypeEnum = schema.SchemaTypes;
// Get total number of types in schema
var count = xmlTypeEnum.GetCount();
// Enumerate Types
xmlType = xmlTypeEnum.GetFirst();
Session.Output("Type: " + xmlType.TypeName);
xmlPropEnum = xmlType.Properties;
xmlProp = xmlPropEnum.GetFirst();
var sPropDesc = xmlProp.Name;
sPropDesc += "::"
sPropDesc += xmlProp.PrimitiveType;
sPropDesc += xmlProp.TypeName;
sPropDesc += "(by reference)";
sPropDesc += "(inline)";
Session.Output("" + sPropDesc + ", cardinality: " + xmlProp.Cardinality);
xmlChoiceEnum = xmlProp.Choices;
Session.Output(" choice of: ");
xmlChoice = xmlChoiceEnum.GetFirst();
Session.Output(" "+ xmlChoice.TypeName);
xmlChoice = xmlChoiceEnum.GetNext();
xmlProp = xmlPropEnum.GetNext();
xmlType = xmlTypeEnum.GetNext();
Intelli-sense help in scripting
The Scripting editor in Enterprise Architect will help you write script that interacts with the Schema Composer, by providing intelli-sense on the properties and methods of its automation interface.
Stereotype mapping in Model Transformation
Stereotyping forms a large part of the MDG Technology approach. Individual UML profiles for an MDG Technology define stereotypes to offer useful classifications for its elements. It is a common requirement when going from a core framework to a business model or sub-domain to reassign the stereotype. When you work with a CCTS framework the business components you generate have their stereotype automatically generated by Enterprise Architect according to a mapping defined by the CCTS specification (ACC to ABIE, for example).
When you open or create a model transform profile in the Schema Composer you can specify a script to perform this mapping for you. The script can be selected from the Properties window.
var destStereo = srcStereo
if (srcStereo == "BDT")
destStereo = "My_BDT"