Creating an IEC Standard CIM Profile with CIM EA

   Minimize

1. Introduction

Using CIM EA, you can create and manage CIM Profiles in accordance with any International Electrotechnical Commission (IEC) Working Group (WG) standard. This tutorial provides the step-by-step instructions to creating a CIM Profile in Enterprise Architect with CIM EA, using Part 452 of International Standard IEC 61970 to create an example CIM Profile. The IEC 61970-452 document is available for download from the UCA International Users Group website.

To use CIM EA as described in this tutorial, you must first have both Sparx Systems Enterprise Architect and the CIM EA Add-In installed. You will also need a copy of the IEC CIM model on your local drive. You can find and save a copy of the IEC CIM file on the CIM Users Group website.

2. Create and Format a New CIM Profile

Before you can create a CIM Profile, you must first open the IEC CIM model file in Enterprise Architect from your local drive. The source IEC CIM package should then appear in the Project Browser in Enterprise Architect.

2.1 Create a CIM Profile

In the EA Project Browser, right-click on the source CIM package and click Add-In. The CIM EA menu appears. Click Create a CIM Profile... to open the Profile Editor.

Create a CIM profile

CIM EA Profile Editor is where you will configure and save the new CIM Profile.

Profile Editor

2.2 Add the CIM Profile to a Profile Group

A CIM Profile Group is a logical grouping of CIM Profiles. CIM Profile Groups are a valuable organization option for managing multiple CIM Profiles, as they simplify and expedite navigation among CIM Profiles and their contents. You can view the CIM Profile Groups you create in the EA Project Browser pane. If you do not select a Profile Group for a CIM Profile, your Profile will be displayed under "(No Profile Group)" in EA's Project Browser.

If you would like to add your Profile to a Profile Group, you can do so in the Profile Editor. In the Profile Group field, type in the name of a new CIM Profile Group, or select an existing Profile Group from the drop-down menu. In our example, the new Profile Group name is “IEC 61970 Profile Group.”

Profile group

2.3 Name the CIM Profile

Enter the name of your CIM Profile in the Profile name field at the top right of the Profile Editor. The text you enter in this field will be displayed as the CIM Profile name in the EA Project Browser. In our example, the Profile name is “Part 452: CIM Transmission Network Model Exchange Profile.”

Name the CIM Profile

2.4 Add Classes, Attributes, and Associations to the CIM Profile

In Profile Editor, source CIM classes are displayed in the Class View (left pane). To include a class in the CIM Profile, select or deselect the class from the Class View by clicking the corresponding checkbox. The first class listed in the IEC 61970-452 document for our example profile is “IEC61970CIMVersion” under the “IEC 61970” folder. As shown in the following image, selecting the checkbox next to “IEC61970CIMVersion” adds the class to the CIM Profile.

Add Classes, Attributes, and Associations to the CIM Profile

You can also view classes in an alphabetical list by clicking the View as list toolbar button. List mode provides a search mechanism for quickly locating classes in the Class View. The search option is especially valuable any time you are working with an unfamiliar model or package.

List mode

When you select a class in the Class View, the Profile Manager displays that class's attributes and associations in the Detail View on the right. The icon next to an association represents that association's type.

Icon Association Type Description
Aggregation Aggregation An association that indicates that one side is part of the other side.
Association Class Association Class Contains the connectivity properties of an association along with the attributes, operations, and other associations.
Bidirectional Bidirectional An association with two navigable sides.
Composite Composite An association similar to but more restrictive than an aggregation. A composite association indicates that one side is part of the other, but one part cannot have this relation with multiple wholes, and the lifetime of the part is bound by that of the whole.
Undirected Undirected An association with two non-navigable sides.
Unidirectional Unidirectional An association with one navigable sides.

Note: Associations ends are sometimes referred to as “roles” in IEC standard documents.

When you select a class, its attributes and associations are not automatically selected. Select or deselect attributes and associations to include in the CIM Profile by clicking the corresponding checkboxes in the Detail View.

2.4.1 Add Inherited Attributes and Associations

IEC Standard documents often call for inherited attributes and associations ends (or “roles”) in a profile. In our example, the IEC 61970-452 document calls for the class “Bay” with the inherited attributes “name,” “pathName,” “aliasName,” and “description.” By default, the Profile Editor displays only native attributes and associations for a class, so the inherited attributes that we need to add are not currently visible in the Detail View.

Bay

To view the inherited attributes and associations, select the Show inherited attributes and associations toolbar button.

Inherited attributes

The Detail View on the right now includes inherited attributes and associations, including the four we need to add in our example. To add an inherited attribute or association, click the corresponding checkbox.

2.5 Adjust Abstract and Multiplicity Settings

You can adjust the abstract and multiplicity settings of a class in the Profile Editor. When you select a class, the selected class's name will appear in the Class Property Grid at the bottom left of the window, reading Class: [Selected Class Name]. You can adjust a class’s abstract and multiplicity settings in the Class Property Grid.

You can also adjust the multiplicity setting of any attribute or association. When you select an attribute, its name appears in the lower right Detail Property Grid, where you can adjust that attribute’s multiplicity setting. When you select an association, the association ends will appear in the Detail Property Grid, where you can adjust each association end’s multiplicity setting.

2.5.1 Change the Abstract Setting of a Class

In the Class Property Grid, click on Abstract. This will highlight the row and prompt a drop-down arrow next to the class's current setting (True or False). Click the arrow to open the drop-down menu and adjust the class's abstract setting.

Adjust Abstract

For our example, we’ll change Abstract for the Bay class to True. Once we’ve changed the abstract setting, the class name “Bay” changes to italics in the Class View.

2.5.2 Change the Multiplicity Setting of a Class

In the Class Property Grid, click on Multiplicity. This will highlight the row and prompt a drop-down arrow next to the class's current setting. Click the arrow to open the drop-down menu and adjust the class's multiplicity setting.

Click multiplicity property

For our example, we’ll change Multiplicity for the Bay class to 1. The selected value now appears to the right of the class name “Bay” in the Class View.

2.5.3 Change the Multiplicity Setting of an Attribute or Association

Select the attribute or association that you wish to modify. For our example, we’ll select the bayEnergyMeasFlag attribute in the Bay class. The attribute’s name and current multiplicity setting appear in the Detail Property Grid.

Select attribute or association

To change the multiplicity setting, click on Multiplicity in the Detail Property Grid. This will highlight the row and prompt a drop-down arrow next to the attribute or association's current setting. Click the arrow to open the drop-down menu and adjust the multiplicity setting. For our example, we’ll change the bayEnergyMeasFlag attribute’s multiplicity setting to 1.

Change multiplicity

The new multiplicity value now appears in brackets to the right of the attribute name in the Detail View.

2.6 Save and Close

When you are finished with the Profile Editor, click Save to save the new CIM Profile and click Close to exit the window. Your new CIM Profile will appear in the CIM Profiles section of the EA Project Browser.

Download

Get v1.3.30 

of the tool.
 
Download the latest version of CIM EA