Keywords are migrated and renamed as persistent group stereotype class in AB Suite.
In EAE, Keywords are defined on the Segment and consists of a single lined fixed presentation of Data Items and Display Items. The Keyword represents a structured string with the parts only able to be referred to via presentation. Logic must refer to the entire string.
The EAE Keywords are migrated as Group stereotyped class with presentation type. The members of Keywords become attributes of the Group.
For example –
AKey is a keyword in EAE segment and consists of data items X and Y. After migration,
AKey class is created and includes attributes X and Y in it where AKey has –
Stereotype as Group
Presentation Type as Graphical & Fixed
Following are the different scenarios and usage of Keyword migration from EAE to AB Suite –
Same As Keyword Migration
Same As Keyword represents the Keyword as a single string control.
As a Single Element
If in EAE, the DataItem SASKey is declared as Same As Keyword, is persistent, and has presentation associate with it, then after migration to AB Suite –
A Group stereotyped class with presentation is created for this Keyword; containing its data items as Attributes.
An Attribute SASKey is created in an Ispec that is templated to the Group and its Direction is set to None.
Persistent data items of the keyword are migrated to the persistence properties of the Attribute If there is persistent Data Item, then it is reflected in the IsPersistent and IsKey properties of SASKey.
The presentation associated with the DataItem is migrated as a Reference SASKey_ref whose constraint refers to the SASKey attribute.
As an Array
If in EAE, the DataItem SASKey is declared as Same As Keyword and includes up to three dimensions (DIM), then after migration all the elements created in AB Suite remains same as in ‘As a Single Element’ with an additional numeric attribute Dim to present the array element. However, the Reference SASKey_ref created in this case will have a constraint referring to a cell of array as SASKey[Dim].
As Nested Keywords
If in EAE, K1 and K2 are two keywords where
DA1 and DA2 are Data Items of K1,
DA3 and DA4 are Data Items of K2, and DA4 is Same As K1. Then, after migration –
K1 and K2 becomes two groups with DA1, DA2, DA3, DA4 as their respective attributes.
DA4 is an attribute of primitive string under group K2
DA4 template to K1 and its Direction is set as InOut. Since, there cannot be any references added to a Group in AB Suite, so DA4 is migrated as an independent attribute on the painter.
Same Name Keyword Migration
Same Name Keyword represents the Keyword for individual controls.
As a Single Element
If in EAE, the DataItem Key1 (with DA1 and DA2) is declared as Same Name Keyword, is persistent, and has presentation associate with it, then after migration to AB Suite –
A Group stereotyped class (Key1) with presentation is created for this Keyword; containing its data items as Attributes (DA1, DA2).
An Attribute Key1 is created in an Ispec that is templated to the Group and its Direction is same as it was in EAE.
Persistent data items of the keyword are migrated to the persistence properties of the Attribute If there is persistent Data Item, then it is reflected in the IsPersistent and IsKey properties of Key1.
The presentation associated with the DataItem is migrated as individual Reference Attributes DA1 and DA2 whose constraint refers to the Key1.DA1 and Key1.DA2. The Reference Attributes from the keyword definition is added directly in the painter (of Ispec)
As an Array
If in EAE, the DataItem Key1 (with DA1 and DA2) is declared as Same Name Keyword with three dimensions (DIM) representing an array of the Keyword Items, then after migration all the elements created in AB Suite remains same as in ‘As a Single Element’ with an additional numeric attribute Dim to present the array element.
However, the Reference Attributes (DA1, DA2) created in this case will have a constraint referring to a cell of array as Key1[Dim].DA1 and Key1[Dim].DA2.