Storyboard Rhapsody Design Manager 4.0 David Hirsch€¦ · contains Predefined Rhapsody && SysML Domains. Shouldn’t be used for Storing Rhapsody Models 2. Actively Managed: Project

®

IBM Software Group

© 2008 IBM Corporation

Storyboard Rhapsody Design Manager 4.0 David Hirsch September 2012

IBM Software Group | Rational Software

2

Supported functionality in 4.0 RC

1. Installation && Setup

2. Rhapsody Client

3. Rhapsody Design Manager Web UI

4. Domains && User Domains

5. Configuration Management

6. Rhapsody Import Engine/Publish

7. Limitations


3



Rhapsody Project Areas

Create New Project Area

2. Rhapsody Client





7. Limitations


4

Installation

Run Design Manager RC0 Launch pad to install Rhapsody Design Manager Components

IBM Rational Rhapsody Design Manager Server

The Rhapsody Design Manager Server

IBM Rational Rhapsody Design Manager Import Engine

The Rhapsody Import Engine to schedule periodically Model Imports from your CCM tools.

IBM Rational Rhapsody Design Manager Simulink Manual Importer

The Simulink Importer to import Simulink Models from you CCM tools.

IBM Rational Rhapsody Design Manager Client Extension

Extension to an existing Rhapsody Client (8.0) Installation to work with Rhapsody Models managed on the server.


5

Installation : Rhapsody Project Area There are 3 types of Rhapsody Project Areas

1. Rhapsody System Domains: Project Area created automatically during install which

contains Predefined Rhapsody && SysML Domains.

Shouldn’t be used for Storing Rhapsody Models

2. Actively Managed: Project Area containing Rhapsody Models Managed by Design

Manager. Models are modified && saved directly from Rhapsody Client on the Design

Manager server. (Requires Rhapsody UML Domain Association)

3. Managed Externally (Published): Project Area host Rhapsody Models which are

managed by an external CM tool. Models are updated on Design Manager by the

Import Engine.


6

Create new Rhapsody Project Area

To create a new project Area

follow the 4 steps shown in

pictures.

To Fill in the form see next

slide ->

1.

2.

1.

3.

4.

4.

1.

2.

1.

3.


7

Create new Rhapsody Project Area - 2

Follow the steps in the

picture

To activate the Project Area

for Rhapsody Models see

next slide

1.

2.

3.

4.

5.

6,9.

7

.

8.


8

Rhapsody Project Areas – 3

Go to Project area’s Properties page

2.

1.

3.

4.


9

Rhapsody Project Areas – 4 Configure Space (Default Stream of the Project Area)

5.

6.

7.

8.


1

0

Rhapsody Project Areas – 5 For Actively Managed Project Areas only, apply Rhapsody Domains to the Project Area

Externally Managed Project Areas should stay with the “Managed externally using import definition” option !

9.

11.

10.

12.

13.

14.

15.


1

1




2. Rhapsody Client

Create new model on Design Manager Server

Open model stored on Design Manager server

Move existing model to be managed by Design Manager server

Edit & Save changes on Design Manager server

Multi User support: Locking

Changesets View

Multiple Projects in Workspace

Add To Model

Design Manager Views

Collaboration (Markups && OSLC links), Search, Reviews

Create Integration Requirements Links

Rhapsody Eclipse Client





7. Limitations


1

2

Create new model on Design Manager Server

From the File Menu select “New

on Design Manager…”

Or: select “New on Design Manager” from the

Design Manager Toolbar directly

In the “New Design Manager

Dialog” provide the Design

Manager Server location details.

Provide Name of the Model

Should be unique in selected

Project Area

The Model will be created and

stored directly on the Design

Manager Server


1

3

Open model stored on Design Manager server

From the File menu select “Open from Design Manager…”

In the “Select Design Management Server Dialog” provide the Design Manager Server location details

Select the Model

Model is loaded from Design Manager Server

Load is done on Demand

Optional:

To reopen the model you can select the model’s entry in File -> Recent File List


1

4

Move an existing model to be managed by Design Manager server

From the Tools Menu select

Design Manager ->“Move to Design Manager…”

In the Select Design Management Server

Dialog, provide the Design Manager Server

location details.

Press OK.

The local model and all it’s units will be stores

on the Design Management server.

The main Repository of the resource

(Configuration Management) is now the Design

Manager Server.


1

5

Edit & Save model on the server

After Opening Model from Design Manager Server, user

can simply edit the model and save it directly on the

Design Manager Server.

Save will process the changes and share it with other

users on the Workspace

Implicitly (no user interaction)

Only modified elements (Documents) will be saved.


1

6

Multi User Editing - Locking To support multi user editing, every resource

will be automatically locked on editing.

User can manually lock a resource on advanced by selecting Design Manager -> Lock/Unlock from the resource context menu in browser.

Locked Resources are marked with a sign in browser.

If locking fails, user’s action will be rolled back.

Locking can fail for 2 reasons:

Resource is locked:

Resource has been locked by another user.

Resource has been locked by same user in another changeset.

Resource in not updated: resource has been modified by another user.

Reload model (Refresh) to get latest resource versions.

Refresh resource by selecting Design Manager -> Refresh from the resource context menu


1

7

Multi User Editing – lock – Diagram Overview


1

8

Multi User: Share on Save

User can decide to save the changes temporarily on the server in a changeset, without sharing it directly with other users.

Select Tools -> Design Manager -> Settings

Un-Select the “Share on Save” Option

To share the changes user will explicitly share the changeset with others.

See Changesets View (next slide)

User can also select the Discard button to discard this changeset


1

9

Changesets

All users model modifications are bundled in a changeset.

A changeset can be in following states:

Active: Currently active changeset

All locks && modifications are saved with this changeset

Browser reflects this changeset changes

There can only be one active changeset simultaneously

Pending: None active changeset

Changes are saved on server, but not yet shared with other users.

Shared:

Changes are shared with other users on the workspace

Discarded:

Changes are discard from server


2

0

Changesets View

View showing all none-shared changesets and their resources

From the Changeset’s context menu you can:

Activate a changeset

Share a changeset

Discard a changeset

Link a changeset (OSLC link)

New tab will be opened

To Create a New Changeset Press the New Changeset Button


2

1

Multiple Projects

User can loaded multiple projects into one Rhapsody Client.

Projects can originate from Design Manager Server or from local machine.

Only Active Project is editable

Rhapsody Window Title expresses the location of the model


2

2

Add To Model (as reference)

User can Add to it’s model Reference Model Elements from other models saved on the server

Select File -> Add To Model

In the Add to Model View lookup the Package you would like to add as reference.

Press OK

Package will be added as reference to the Active Project.


2

3

Design Manager Views

Rhapsody Client provides different Views to

access Design Manager Items.

Collaboration View: Comments (& Markups), OSLC

Links

Search View: Search the Design Manager Server

Reviews View: Work with Design Manager Reviews


2

4

Creating New Requirements Link in Browser

User creates new dependency and

selects remote requirement as

“Depends On”

This new dependency automatically

becomes an RM link


2

5

Creating New Requirements Link on Diagrams

In Rhapsody Graphic Editor, draw a dependency from model element

to remote requirement

This new dependency automatically becomes an RM link

Start creating new

dependency

Draw new dependency from

model element to remote

requirement


2

6

Putting Remote Requirement on Diagram

To get a remote requirement on a

diagram, select Add Remote

Requirement... menu option

OSLC picker from RM tool displays

requirements

Select Add Remote Requirement...

in Graphic Editor context menu

Select requirement from OSLC

picker


2

7

Putting Requirement on Diagram (Cont.)

Drag and drop existing remote requirements from Browser to Graphic

Editor

Drag-n-drop remote

requirement from Browser


2

8

Rhapsody Eclipse Client

In DM4.0 you can use the Rhapsody Eclipse Client to work with the Design Manager Server


2

9

Rhapsody Eclipse Client (2) Open Settings Dialog && Changesets View Toolbar


3

0




2. Rhapsody Client


View Rhapsody Models on Design Manager

Explorer

Properties Page

Search

Query model

Comments

OSLC Links

Impact Analysis




7. Limitations


3

1

View Rhapsody Models on Design Manager Server With your Web Browser navigate to

<Design Manager Server URI>/dm/web

Select your Project Area

Now you review on the Project Area’s Dashboard the Project Area recent state


3

2

New Explorer: Domains & Model Viewports

Select Explorer from the Designs menu

Switch between different views with the Viewpoint dropdown.

Documents: list of documents

Model Viewpoint: Tree of all models and their documents

Detailed Model Viewpoint: Tree of all models and their documents and fragments

Select the > button to drill down the models

Select Action “Focus on Element” (or double click) to open the property page

Hover an element to view a preview


3

3

Property Page

In the Explorer select the elements Action “Focus on Element” (or double click) to open the property page

Expand left and right panes to see the explorer on comments view.

View the breadcrumb to localize the element.

Select the Related Elements Tab to view related elements.

Select the Links Tab to view/create OSLC Links

Select the Source Tab to view the resource rdf source file


3

4

Search

Prerequisite: Open a Project Area

Enter your search string in the quick search textbox

The result results will be shown in the Search Results Editor


3

5

Queries

For more effective search, you can create

Queries based on Rhapsody Ontology

Compose Query

Run Query

Browse Queries


3

6

Create Comments && Markups In the property page you can create a comment for every model

element

For diagrams you can also add some graphical markups


3

7

Create OSLC Links


3

8

Setup OSLC Links

To Setup OSLC Links you need to do following Steps:

Add other OSLC Server as Friend Server

Bottom of page:


3

9

Setup OSLC Links – cont’d

2. Add Association from your Project Area to the Linked Project Area

1.

2.

1.

Bottom of page:

Bottom of page:


4

0

Setup OSLC Links – cont’d

2. Deploy Project Link Types

1.

2.

3.

4.

5.


4

1

Impact Analysis Impact Analysis allows you to view the impact of an element with others.

User can:

The Root Model Elements

Depth level of the impact analysis

Direction of the impact (Upstream/Downstream)

Graphical Representation of the results (Hierarchical, Tree, Cyclic, etc)

Manually Removing/Adding model elements form/to the diagram


4

2

Impact Analysis – cont’d


4

3



2. Rhapsody Client





7. Limitations


4

4

Domains and Ontology's A Domain (Ontology) defines the Meta

Model of the Repository

Defining a Domain allows Design

Manager to understand the Structure of

your model

Browser reflects Meta Model (New terms

containers)

Create Queries based on the Meta Model

Rhapsody Design Manager has several

predefined Domains in Project Area

[System Defined] Rational Rhapsody

Domains

Rhapsody UML Domain

Rhapsody SysML Domain

Rhapsody Testing Domain

Rhapsody UPDM 20 Domain

Rhapsody UPDM L1 Domain


4

5

Create User Domain from Profile User can convert it’s profile to be a

Domain on Design Manager

User Domains are stored in the

Domains Project Area

To Create a Domain enter following

properties values on the profile: Model::Profile::DomainDefinition: Defines the URI of the Domain Definition

Model::Profile::DomainName

Model::Profile::DomainTitle

Model::Profile::RDFNamespace: defines the URI prefix for each resource

inside a profile

See the SysML profile for an example

Important:

Check your properties values before creating the

Domain as a rollback is difficult to achieve.

When moving your Rhapsody Projects to Design

Manager, be sure to referenced the profile with

updated properties


4

6

Create User Domain from Profile (2) After updating the properties select from the

Profile’s Context Menu:

Design Manager -> Create Domain From Profile

A new domain will be created in the Domains

Project Area.

A Snapshot will be on the Domains Project Area to

baseline this domain version

You can now flag your Active Managed Project

Area to use the User Domain.


4

7



2. Rhapsody Client




Create Snapshot / Child Workspace

Merge between Workspaces

Configuration Compare / Merge View


7. Limitations


4

8

Create Snapshot / Child Workspace Open the Web UI and select your project area.

In the Configuration menu select:

Search for more: to select a different configuration

Create New Snapshot to create a snapshot of current

workspace

Create New Workspace to create a child workspace.

A child snapshot will automatically being created

which will contain the child workspace.


4

9

Merge between Workspaces Open the Web UI and select your project area.

In the Configuration menu select:

Open Current Configuration: you’ll be navigated to the

VVC Web Page of this configuration

On the top-rigth you’ll have a toolbar with following

options:

Rebase: Choose a different Snapshot as base of this

Workspace

Accept all incoming changesets from parent workspace

Deliver all outgoing changesets to parent workspace

Compare with base snapshot

Compare with parent workspace

After selecting one of the options a compare/merge

view of the two configurations will be shown. (see

next slide)


5

0

Configurations Compare/Merge View The Merge View allows you to

view the changes between the

child and parent workspace, and

manually (or by default all

resolvable changes) select which

changes to merge into parent

workspace.

The toolbars allow:

Navigate between the changes

Accept all resolvable changes/commit/discard merge

Select which version to use in the merge.


5

1



2. Rhapsody Client





Publish Rhapsody Model on Design Manager Server

7. Limitations


5

2

Rhapsody Import Engine/Publish To publish your model on Design

Manager Server, without moving it to

be persisted by the Design Manager

Server you can use the Rational

Rhapsody Import

Manually Import

Select Workspace Administration ->

Rational Rhapsody Import -> Import

Provide your model as zip file and

press Import.

Define Import Definition for the Import

Engine (See install)

Select Workspace Administration ->

Import -> Import Definition


5

3



2. Rhapsody Client





7. Limitations


5

4

Limitations

User Domains

Icons of User Domain aren’t loaded from Design Manager into Rhapsody Client

Can’t apply user Domain to new model from Design Manager

Work Around: Apply local copy of profile to the model

Auto-Save is disabled: changes will be lost on crash