Pr full uml

CM-Consult Company
and
Rational Tools project
www.rational-tools.info
https://twitter.com/rrationaltools
______________________________________________________
'UML2ClearQuest' Tansform UML diagrams into
ClearQuest Designer state matrix
1.1. About
The purpose of this application is to ease the process of programming ClearQuest Designer's state
transitions matrix for change requests. UML2ClearQuest can export UML state charts to
ClearQuest Designer, which makes for a simple visual design process. UML Export is supported
from IBM Rational Software Architect or MS Visio.

UML2ClearQuest supports the following capabilities:

Transferring UML states from IBM Rational Software Architect, MS Visio or StarUML.
Design business processes with the comfort of IBM Rational Software Architect, MS Visio
and StarUML and easily import the results to IBM Rational ClearQuest to a new or
existing record type.
Visualizing the import data. Before importing, UML2ClearQuest shows the state diagram
and checks it for compliancy with the IBM Rational ClearQuest state machine.
Exporting state machines for record types from IBM Rational ClearQuest. Allows for
exporting IBM Rational ClearQuest state machines to UML diagrams in IBM Rational
Software Architect, MS Visio and StarUMLformat for modifying and viewing. A modified
diagram can then be imported to the existing record type from which it was exported.

Why UML2ClearQuest

1. UML2ClearQuest helps to tune ClearQuest scheme in very short terms basing on our UML
diagrams which are describing the whole process of CM
2. UML2ClearQuest allows easy converting the transition matrix of ClearQuest Designer into
the UML State chart diagrams.
3. The quickness and efficiency of UML2ClearQuest make it the irreplaceable tool for the
analysis of the complex and undocumented processes. The time spent for UML diagrams'
optimization is significantly less than the time needed for the analysis of the ClearQuest
Designer transition matrix.
4. UML2ClearQuest helps to appreciably reduce TOC of CM process in company by reducing
the requirements for CM manager qualification and for CM administrator as well. Also by
radical reducing of the labor coefficient during ClearQuest Designer's schemes debugging.
5. UML2ClearQuest enclose an internal UML syntax parser that allows rapidly and efficiently
receiving required ClearQuest Designer scheme which is bug free.

1.2. Rationale
In ClearQuest, a change request’s lifecycle is described via state machines, which is defined by
the state transition matrix. Programming these matrices is an administrative task, which is based
on some specification (contained in a “Configuration management plan” document). The
specification is written by an analyst, usually using two types of charts that describe a process –

CM-Consult Company
and
______________________________________________________
State-charts and Activity-charts. These charts are handed over to the administrator, who plots them
to ClearQuest. This approach has several obvious deficiencies:

There’s an excessive link in the chain: the administrator.
Errors can frequently occur when transferring the diagrams.
Correcting the diagram entails manual reprogramming of the ClearQuest state transition
matrix.

1.3. Description
The purpose of this application is to ease the process of programming ClearQuest Designer's state
transitions matrix for change requests. UML2ClearQuest can export UML state charts to
ClearQuest Designer, which makes for a simple visual design process. This module enables for
automatic state chart transformations to ClearQuest Designer’s state transition matrix for a certain
entity (change request) and is distributed in two flavors, for different platforms:

As a plug-in for IBM Rational Software Architect
As an external application, which takes UML diagrams (in Visio & StarUML format), and
converts them to ClearQuest’s state machine.

When exporting, UML diagrams are checked for compliancy with ClearQuest: since it's state
transition matrix places several constraints on it's states and transitions, not all UML diagrams are
valid. The export process is configurable; you can, for example, choose to create a new entity in
the database, or change an existing one to match your UML diagram. If the export process was
successful, your schema will increase it's version by one, and the entity will have been
successfully added to your schema.

The external application works with Visio 2003 and StarUML diagrams . For Visio 2003, the
following XML formats are supported:

XML Drawing (*.vdx).
XML Stencil (*.vsx).
XML Template (*.vtx).

For StarUML the following format is supported:

StarUML Project File (*.uml).

In Rational Software Architect, StateMachines are created in UseCases.

In all 3 cases (Visio, StarUML and RSA), only "UML Activity" elements are used to describe a
change request's lifecycle.

1.4. Requirements

CM-Consult Company
and
______________________________________________________
ClearQuest Designer.
Administrative rights.
Rational Software Architect or UML files MS Visio/StarUML format.

1.5. Implementation
This module is realized in the form of Win32 application, designed in .NET 2.0
environment.

1.6. Features
New in 3.0 version

UML2ClearQuest 3.0. includes the set of the unique functions which make the usage of
UML2ClearQuest as more effective as it possible:

Strongly adjusted the algorithm of the statements visualization. Now it allows
visualizing UML diagrams of change request’s statements more fast and easy than
ever.
o Scaling function is added;
o UML diagrams display is hastened.
The new function of documenting the properties of the IBM Rational ClearQuest
Designer schemes:
o The documenting proceeds with the template formed in advance that could be the
part of the Configuration Management Plan or Change Management Plan.
o The documenting is being done in XML.format. Our solution supports all text
editors for XML display including MS Word, Open Office etc.
o To be documented:
General list of the scheme properties (statistic data), including the ER
diagram;
The structure of the scheme’s entities (change requests) divided on
StatelessNo Stateless;
For every entity the fields structure is defined (including initial and listed
values, and comments for every field as well), statement diagram, ER
diagram (all dependencies – showing the ParentChild hierarchy), state
transition matrix, list of all activities, and also the fields behavior
description.
o It is able to define the depth of the scheme documenting basing on the
predetermined templates (Brief , Full or Custom);
o The templates are available in Russian and English;
o Visualization template can be customized by the user himself: every control pattern
can be changed including the language of visualization.
The new function is added –documenting the comments to the scheme. Usually the
biggest challenge with the scheme development is the documenting the help item for every
field of entity. In UML2ClearQuest 3.0 it’s possible after scheme documenting to type
into the field table the help item for every field and then, to import the resulted table by the
special way. Meanwhile UML2ClearQuest creates the new version of the scheme and

CM-Consult Company
and
______________________________________________________
puts there all the comments.. Thus it’s possible to read comments in the scheme, update
them and record again unlimited amount of times:
o The mode “Get scheme’s properties” is supported
Add comments;
Update scheme basing on the document.
o Unlimited recurrence is supported as well.

All features

Supports UML 2.1 and up (all current versions).
o Only state-chart export supported.
Analyze state chart syntax for ClearQuest state machine compatibility.
UML diagrams can be transferred to new entities in a ClearQuest schema, or existing
entities can be modified based on the UML.
A ClearQuest-style preview of the transition matrix is available for checking the end-
results.
Code style independency.
Multilanguage support.

Note: each export cycle increases ClearQuest Designer’s schema version. The schema must be
checked in before the export operation. After the export all user databases must be updated

Import and visualize state charts from ClearQuest – reverse-engineering is employed to
correct an already existing lifecycle with the visual convenience of UML.
Programming ClearQuest transition matrices based on activity diagrams, with required
field detection and access rights configuration according to groups and role policy
depending on the state and action.
There are no similar solutions on the market.

1.7. Advantages & tech. info
Details:

There are several restrictions on the UML diagrams that can be exported to ClearQuest:

Only "UML Activity" elements are supported.
o Visio 2003: "Initial State", "Final State", "State", "Action State" and "Control
Flow".
o StarUML: "InitialState", "FinalState", "ActionState", "SubactivityState" and
"Transition".
o Rational Software Architect: "Initial State", "Final State", "State", "Transition".
There must be exactly one transition from the "Initial State" (or "InitialState").
There must be at least one transition to the "Final State" (or "FinalState").
All transitions must have names, except for transitions to the "Final State" (or
"FinalState").

CM-Consult Company
and
______________________________________________________
Every state ("State", "Action State", "ActionState", "SubactivityState") must have at least
one incoming and one outgoing transition.
No transition from any state can lead to that same state.
If two transitions have the same name, they must lead to the same state.
No transition can have "loose ends": every transition has to point from one state to another.
No two states can have more than a single transition in each direction.

Names can contain letters (english and russian), underscores and numbers;
Transition and state names must be no more than 25 symbols long.
No two states can have the same name.

At export time, you can create a new entity or modify an existing one. If you're creating a new
one, you'll need to enter the entity's ClearQuest DB name, otherwise the existing one is used. The
entity's name can consist of letters (english or russian), underscores and numbers, and it's length
must be no more than 25 symbols. The ClearQuest DB name follows the same rules, but it must
contain only english symbols.

When exporting to a schema, the schema name is chosen from the appropriate list, which is
determinted automatically from the specified connection parameters (to an available repository).

The external application contains the following control elements:

The "Fill" button loads the UML diagram, with the file type indicated as a standart filter.
The «Diagrams» drop list contains the list of available diagrams. The chosen diagram is
graphically displayed in the application window.
The «Validate» button verifies the diagram for compliance with ClearQuest's restrictions.
The verification result can be seen in the "Result" field; if there are any requirement
violations, the specific requirement violation will be outputted there.
The «Result» field shows error messages (red) if the diagram does not meet the
requirements, or «Verification is completed» (green) if all requirements are met.

The result of UML2ClearQuest is a configured state transition matrix in ClearQuest
Designer.
UML2ClearQuest automatically creates all the necessary states and actions between them.
All that's left to do is define the fields' behaviour and access policy.

_______________________________________________________________________________

About CM-Consult
It was founded in 2004. The main business is consulting in project management area,
implementation and support IBM Rational tools and technologies as well as methodic (RUP).
Distribution, setup and customization, support of IBM Rational software and Microsoft tools.
«CM-Consult» is in TOP-5 of the Russian consulting companies implementing IBM
Rational.

CM-Consult Company
and
______________________________________________________
Our team conducted over 25 successful projects of IBM Rational technologies
implementation, we trained over 700 specialists.
«CM-Consult» is a business partner of IBM for all these years and has a status
Premier IBM Partner as well as Value Advantage Plus (V.A.P.).
The base of the team is the certified professionals and experts whose experience and deep
knowledge are beyond doubts.
The clients of «CM-Consult» are the biggest international companies: HUK-COBURG
(Germany), Banco do Nordeste (Brazil), United Aviation Group (Russia), Tatneft (Tatarstan
oil, Russia), VTB bank (state external trade bank, Russia), Irkut avia plant (Russia), Russian
Aluminum and many others.

About Rational Tools project
The project starts at 2008 for international promoting the solutions and services of CM-
Consult which are worked through the real projects of the company. Rational-Tools is the set of
the unique solutions and software which extends and complements the capabilities of IBM
Rational tools and it has no analogues in the world. Some of these products are registered in IBM
as Value Advantage Plus (V.A.P.) solutions (Project Tracker and UML2ClearQuest), that
confirms their high quality and relevance for the broad spectrum of customers.

http://rational-tools.info
info@rational-tools.info

Pr full uml

Recommandé

Recommandé

Contenu connexe

Tendances

Tendances (11)

Similaire à Pr full uml

Similaire à Pr full uml (20)

Dernier

Dernier (20)

Pr full uml