Please note : This help page is not for the latest version of Enterprise Architect. The latest help can be found here.
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
This example demonstrates accessing the Schema Composer in an Enterprise Architect script written in JScript. The script first obtains an interface to the Schema Composer and then traverses the schema, printing out the types and each of its properties.
!INC Local Scripts.EAConstants-JScript
function print(s)
{
Session.Output(s)
}
function main()
{
var schema as EA.SchemaComposer;
var xmlType as EA.SchemaType;
var umlType as EA.ModelType;
var umlPropEnum as EA.SchemaPropEnum;
var umlProp as EA.SchemaProperty;
var umlModelTypeEnum as EA.ModelTypeEnum;
// Get SchemaComposer
schema = Repository.SchemaComposer;
// Get Schema Types Enumerator
umlModelTypeEnum = schema.SchemaTypes;
// Get total number of types in schema
var count = umlModelTypeEnum.GetCount();
// Enumerate Types
xmlType = umlModelTypeEnum.GetFirst();
while(xmlType)
{
print( "Type: " + xmlType.TypeName );
umlPropEnum = xmlType.Properties;
if(umlPropEnum)
{
umlProp = umlPropEnum.GetFirst();
while(umlProp)
{
if(umlProp.IsPrimitive())
{
print( " " + umlProp.Name + "::" + umlProp.PrimitiveType);
}
else
{
umlType = schema.FindInModel( umlProp.TypeID );
print( " " + umlProp.Name + "::" + umlType.TypeName );
}
umlProp = umlPropEnum.GetNext();
}
}
xmlType = umlModelTypeEnum.GetNext();
}
}
main();
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. It can be written in either Javascript, JScript or VBScript, and only has to implement this function (described here in Javascript notation):
function TranslateStereotype( srcStereo )
{
var destStereo = srcStereo
if (srcStereo == "ABIE")
{
destStereo = "My_ABIE"
}
return destStereo;
}
Learn more