ReadMe for Eco model DLL

CapableLogo

General

This project contains an ECO model and generated source code. Initially the model contains a single class with a single string attribute.

Editing the model

The model is edited in a separate application, EcoModeler. EcoModeler is launched by double-clicking on the .mmcseco file in the solution.

The actual use of the EcoModeler is described in C:\Program Files\CapableObjects\ECO\4.0\doc\pdf\EcoModeler.pdf.

When code is generated with Tools|Generate Eco Model in EcoModeler, the project file is automatically updated with the files added/removed.

Template contents

The template contains the following files:

h
ReadMe.html This file.
Class_1.cs The generated code for Class_1. One such file is created for each class in the model. The generated class has properties corresponding to the attributes and association ends in the model.
EcoProject1Package.cs Contains the class EcoProject1Package, which is used by ECO to know which classes are part of an Eco Package.
EcoProject1Package.mmcseco Contains the actual model in EcoModeler format. The name of this file does not matter, so if you wish you can rename it if you rename the package.
ModelInterfaces.cs Contains the declarations of all modeled interfaces.
ModelMergeData.ecoxml Contains information used by EcoModeler when merging the changes into the existing classes after the model has been changed. Do not remove or rename this file.
licenses.licx licx file for including the ECO runtime license.

Using EcoModeler separately

It is also possible to start EcoModeler in other ways, e.g. from the start menu, or by double-clicking on a .mmcseco file in the windows explorer. It this case it will not be integrated into the Visual Studio IDE, and the project file will not be automatically updated. You can start the IDE integration manually by selecting "Tools"|"Start EcoModeler Integration" in the VS menu

Renaming the package

It is best to name the package correctly in the wizard when creating it, but if you need to rename it later you need to perform the following steps:

  1. You may rename the .mmcseco-file, but it is not required. EcoModeler should be closed when renaming this file.
  2. Change the Package name in EcoModeler Options|Project options|ECO
  3. Rename the file EcoProject1Package.cs in the project. If you don't do this, the file will be removed from the project, and a new one with the new package name created
  4. Tools|Generate Eco Model in EcoModeler.
  5. Recompile the project (F6)
  6. Open the EcoSpace designer in the EcoSpace project, and use the package selector tool to remove the old package name, and add the new one.