Skip to content

Model Architecture

This page explains the general architecture of the UML modeling of your modernization application.

MagicDraw Project Creation

BluAge products 5.4

  1. Right-click on the model/ folder of your BluAge Forward project and select New -> Other, or press Ctrl+N;

    Architecture1

  2. Select MagicDraw Project from Template under MagicDraw/ folder;

    Architecture2

  3. Once MagicDraw has started, select the template that suits your needs :

    Architecture3

    • Bluage_Template : template for all PLTC technologies;
    • Bluage_Template_RichUI : deprecated template for all CSLTC technologies;
    • Bluage_Template_RichUI_v2 : template for all CSLTC technologies;
    • Bluage_Template_V7 : template for the V7 line of BluAge products.
  4. Give a name to your MagicDraw model, then click on Finish;

    Architecture4

  5. Your newly created model is automatically opened in the Containment view of Eclipse. Bluage Profiles and utils are automatically linked.

    Architecture5

BluAge products 5.5

  1. Click on the Launch MagicDraw entry from the MagicDraw menu, or press Ctrl+Shift+M;

    Architecture6

  2. Once MagicDraw has started in an external window, click on the New Project.. entry from the File menu, or press Ctrl+Maj+N;

    Architecture7

  3. The following screen appears :

    Architecture8

    1. Select the Project from Template entry from the Other menu on the left panel;
    2. Give a name to your MagicDraw model;
    3. Select the target folder location of your MagicDraw model. The model files are usually located in the model/ folder of your BluAge Forward project.
    4. Select the template that suits your needs :
      • Bluage_Template : template for all PLTC technologies;
      • Bluage_Template_RichUI : deprecated template for all CSLTC technologies;
      • Bluage_Template_RichUI_v2 : template for all CSLTC technologies;
      • Bluage_Template_V7 : template for the V7 line of BluAge products.
  4. Click on OK. Your newly created model is automatically opened in the MagicDraw Containment view. Bluage Profiles and utils are automatically linked.

    Architecture9

MagicDraw Project Architecture

A complete project architecture example is shown in the following screen.

Note : This architecture covers package description for all types of project and is only for description purpose. All of them are not useful in every project.

Architecture17

Here is the list of all stereotypes which can be applied to packages elements in your UML model.

Name Description Project type
PK_BUSINESS Package where the business layer is modeled All
PK_BUSINESS_OBJECT Package where the business objects are modeled
This package must be located under the PK_BUSINESS package.
All (deprecated)
PK_ENTITY Package where the entities are modeled
This package must be located under the PK_BUSINESS package.
All (deprecated)
PK_MODEL Package where the composite entity+BO classes are modeled
This package must be located under the PK_BUSINESS package.
All
PK_SERVICE Package where services are modeled All
PK_TARGET Application root package.
All other stereotypes must be applied on packages under this package, otherwise they are ignored by the BluAge Forward generation.
All
PK_UTILS Package containing utils classes All
PK_JOB Package where jobs are contained Batch
PK_STEP Package where steps are contained Batch
PK_CRUDGEN Package where elements are generated by CrudBooster Web
PK_ROLES Package where actor objects are modeled Web
PK_VALUE_OBJECT Package where value objects are modeled.
This package must be located under the PK_BUSINESS package.
Web
PK_VO_SERVICE Package where the value objects services are modeled.
This package must be located under the PK_SERVICE package.
Web
PK_WEB Package container where presentations objects are modeled Web
PK_APP Package for dynamic validators Deprecated
PK_ITEM Package where items are contained Deprecated
PK_REPORT Package where the reports are modeled Deprecated

MagicDraw Project Initialization

BluAge provides a wizard to help you through the initialization of your project structure.

BluAge products 5.4

  1. Click on the Initial packages creation Wizard entry from the Bluage -> Wizards menu;

    Architecture10

  2. The following screen appears :

    Architecture11

    • Main namespace : defines the root package of your application;
    • Web namespace : defines the root package of the view layer of your application.
  3. When clicking Next, you will be able through this page to override package names for each layer of the project architecture.

    Architecture12

  4. Last page of the wizard is the summary of the soon-to-be architecture. Click on Finish. The project structure will be added to your MagicDraw model.

    Architecture13

BluAge products 5.5

  1. Create the package hierarchy leading to your root package using the MagicDraw Containment view, then add the PK_TARGET stereotype to this package.

    Architecture14

  2. Right-click on your PK_TARGET package and select the BluAge - Create initial packages entry, or press Alt+Maj+I;

    Architecture15

  3. The project structure will be added to your MagicDraw model.

    Architecture16

Note : In the BluAge products 5.5, PK_BUSINESS and PK_ENTITY layers are deprecated and PK_MODEL layer is favoured, hence the difference between the structure generated by 5.4 and 5.5 products. For more information about business layer modeling, please refer to the business modeling page.