RADE

Data Model Customizer for ENOVIA

Customizing the ECO/ECR Modeler

Use Case

Abstract

This article shows how to create a customization on ENOVIA ECOECR.


Principle

The change request process allows various internal groups to communicate the need for change or to request some type of work effort.

Use a change request to identify the need for change, analyze the change requirement, and approve the change implementation. Use a change order for more formal changes such as defining deliverables, affected objects, and effectivity.

 

Let's customize a change request (ECR) and a change order (ECO) which do not necessarily have to be customized together.

You are going to add 2 new fields to each component:

for ECR
a date Attribute1       
  a double Attribute 2
   
for ECO
a list of boolean MyFirstAttribute
  a string MySecondAttribute

        [Top]

Creating a UML Project

  1. From the File menu, select New->Other->UML Project. Click Next>.
  2. Enter the name of the UML project. Click Next> and Finish.
  3. In the Navigator view, right-click your project and select Open as a DMC Project.
  4. In the Open a DMC Project window, select the tool level and click Next>.
  5. Click Close in the Initializing tools window.
  6. Click Add and select your prerequisite frameworks. Click Finish.
  7. Click Close in the Installing Prereqs window.

[Top]

Creating an ECOECR Customization

  1. From the File menu, select New->Other->DMC Elements->New LCA Customization. Click Next>.
  2. Enter the application name in the Application Name field.
  3. Click ... in the Customize LCA application field. In the Select a framework window, select ECOECR.

  1. Click Finish. The wizard creates a new workspace.

[Top]

Creating a Modeler Object

Creating a ECO Modeler Object

  1. In the Navigator view, expand the MyECOECR node and double-click the .emx file.
  2. From the File menu, select New->Other->DMC Elements->New Modeler Object. Click Next>.

  3. Enter the name of the new Modeler Object (MyECO in this example).
  4. Select ECO in the list and click Next>.
  5. Click Insert to add the attribute MyFirstAttribute to your MyECO.
  6. Enter MyFirstAttribute in the Name field and select STRING in the Type list. Click OK.
  7. Click Insert to add the attribute MySecondAttribute to your MyECO.
  8. Enter MySecondAttribute in the Name field and select STRING in the Type list. Click OK.
  9. Optionnal: Add a new index using the second Insert button.
  10. Click Finish when done.

Creating a ECR Modeler Object

  1. In the Navigator view, expand the MyECOECR node and double-click the .emx file.

  2. From the File menu, select New->Other->DMC Elements->New Modeler Object. Click Next>.
  3. Enter the name of the new Modeler Object (MyECR in this example).
  4. Select ECO in the list and click Next>.
  5. Click Insert to add the attribute Attribute1 to your MyECR.
  6. Enter Attribute1 in the Name field and select DATE in the Type list. Click OK.
  7. Click Insert to add the attribute Attribute2 to your MyECR.
  8. Enter Attribute2 in the Name field and select DOUBLE in the Type list. Click OK.
  9. Optionnal: Add a new index using the second Insert button.
  10. Click Finish when done.

Here is the UML graphic describing your customization.

UML Graphic for ECO

 

UML Graphic for ECR

 

[Top]

Generating the Dictionary File

  1. Select DMC Project->Generate VPM Dictionary file.

The wizard creates MyECOECR.metadata under the directory MyECOECR/CNext/code/dictionary. Close IBM Rational Software Architect or IBM Rational Software Modeler.

[Top]

Publishing Enovia Data

  1. Select DMC Project->Publish VPM Dictionary file in Database.

Check if the settings are correctly valuated and click OK to start the Publish command to finish the scenario.

[Top]

Testing in ENOVIA

Now it is time to test your customization. To use this customization, launch ENOVIA with the environment of the customization. To do so, indicatethe location where your customization is built on the server, as follows:

On UNIX:

$ENOVIA_INSTALLATION_PATH$/$OS$/code/command/enoviastart -direnv $EnvDir$ -env $EnvName$

where :

On Windows:

$ENOVIA_INSTALL_PATH$/$OS$/code/bin/CATSTART -run "ENOVIA.exe" -direnv $EnvDir$ -env $EnvName$ -object "-senv $sEnvName$ -sdirenv $sEnvDir$"

where :

 

Now, when creating a new CustoECR,

 

and when searching for our new object committed in the database:

The same behavior is expected for MyECO.

[Top]


History

Version: 1 [Mar 2004] Document created
Version: 2 [March 2006] Document updated
[Top]

Copyright © 2006, Dassault Systèmes. All rights reserved.