Requirements Management in Enterprise Architect 13

Webinar June 2016
In this webinar you will learn how to:
  • Record, model, evaluate and trace requirements
  • Use diagram filters, legends and visualization techniques
  • Document, view and edit requirements using the Specification Manager.

Do you need to capture, manage and trace project requirements?

Do you have requirements stored in text documents, spreadsheets or other formats that inhibit traceability and analysis?

Enterprise Architect provides powerful tools for requirements management and activities associated with discovering, evaluating, recording, validating and reporting on your project requirements.

Scott Hebbard
Scott Hebbard

We have provided the example Enterprise Architect model used in the webinar.
Example Model: shuttle-launch-use-case-extended.eap Download the Enterprise Architect Example Model
Whitepaper: requirements-engineering.pdf requirements-engineering
Whitepaper: time-aware-modeling.pdf time_aware_models.pdf

Questions from the Audience

Click on a question to see the answer.

General

What Version and Build of Enterprise Architect was used throughout the webinar?

Enterprise Architect 13 Beta. Build 1301.

When will Enterprise Architect 13 officially be available?

Registered Users can download the Enterprise Architect 13 Beta installer from the following page:
http://www.sparxsystems.com/ea13

Registered Users will be notified via the Forum when Enterprise Architect 13 is officially released.

I'm a Business Analyst and am new to Enterprise Architect. Is there a place to get training on how to use Enterprise Architect?

Yes. Sparx Systems has a global network of authorized Enterprise Architect Trainers and Consultants that offer a full range of products and services to support you in your activities.

For more information or to contact a partner, please refer to our Partners and Services webpage:
http://www.sparxsystems.com/partners/index.html

Can I view previous webinars from Sparx Systems?

Yes. Sparx Systems has a comprehensive library of webinars available to the public.

Previous webinars are available for viewing at:
http://www.sparxsystems.com/webinars

Are the previous webinars also available via YouTube?

Yes. Some of the webinars are also available on the Sparx Systems YouTube site:
https://www.youtube.com/user/SparxSystems

Where can I find out more information about the Enterprise Architect 13 Beta?

The Enterprise Architect 13 release page outlines some of the exciting features and benefits that may be of interest to new and existing customers. Please refer to the release page for more information:

http://www.sparxsystems.com/ea13

The Enterprise Architect 13 User Guide also provides a comprehensive range of resources to help get you started.

Is it possible to automatically ID requirements as they are created? In the example the REQxxx ID appears to be typed in the Requirement Name field.

Yes. I have used Auto Naming to ensure consistency in the names of requirements as they are created. You can add pre and post fix details to any requirement.

See the Help Guide for more information about Auto Naming and Auto Counters .

Will Enterprise Architect 13 be able to run under Linux via Wine ?

Yes. There is improved support for Linux and Mac OS under Enterprise Architect 13.

Which of the features that you demonstrated are new to Enterprise Architect 13 and which ones are available in version 12.1?

The Specification Manager, Charts, Custom UML Types, Requirement Diagrams and Requirement Checklists are all available in Enterprise Architect 12.1

Tagged Values were available in Enterprise Architect in 12.1, however the ability to filter based on tagged values is new to Enterprise Architect 13. The new Ribbon Interface, including the ability to search for tools and commands was introduced in Enterprise Architect 13. Time Aware Models and Cloning capabilities are new features available in Enterprise Architect 13, that were designed to help people understand how models evolve over time.

Which Edition of Enterprise Architect do I need to enable the features that you demonstrated?

These details have not been finalized.

When Enterprise Architect 13 is officially released, a detailed break down will appear on the Compare Editions Page.

Requirements

Does Enterprise Architect support OSLC?

Yes. You can create and retrieve requirements from a Cloud repository. Please refer to the Help Guide to learn how to set up OSLC Requirements Management.

You may also care to review the webinar on Cloud Services to better understand how OSLC works in Enterprise Architect.
http://www.sparxsystems.com/resources/webinar/model-repository/cloud/introduction/introduction-cloud-services.html

Are Use Case Models and User Story mapping features supported?

Yes. Enterprise Architect has a purpose built User Story element that can be used to create a story. It is possible to link the User Story element to any number of other elements including business Goals, Objectives high level stakeholder requirements and detailed requirements resulting from grooming the story, constraints and more. To learn more, view the following webinar on Model Driven Use Case Analysis with Structured Scenarios:

http://www.sparxsystems.com/resources/demos/use-case-analysis/model-driven-use-case-analysis-with-structured-scenarios.html

For additional information on User Stories, please refer to the following Help Topic:
http://sparxsystems.com/enterprise_architect_user_guide/13.0/business_analysis_tools/tools_ba_user_story.html

Can you please show how to create a new Requirement?

There are many options for creating new requirements. The webinar illustrated how to create a new Requirement using the Specification Mangager. Another common method is to drag a Requirement Element from the Toolbox onto a Diagram or into a selected Package.

For more information on creating a requirement, see the Help topic:
http://sparxsystems.com/enterprise_architect_user_guide/13.0/model_domains/creatingrequirements.html

When should we use the Version Requirement property and when should we use Phase?

You might use Phase to represent the phase of the project, whereas Version captures the version of the requirement itself. Sparx Systems does not dictate a methodology, and many companies may vary their usage to suit their individual needs. Some companies may even use the Glossary to further define terms such as Version and Phase.

Can a Requirement have more than one Status?

Yes. You can create your own Tagged Values to represent more than one Status.

For more information on creating a custom Status value, please refer to the Help Topic on
Status Types.

Can the HML priority be extended to MoSCoW (Must, Should, Could, Would/Won't)?

Yes. This can be achieved using Tagged Values.

How can you trace a change of requirement state?

Yes. You can trace changes using a combination of Baselines, Auditing and Time Aware Models.

Auditing is a project-level feature that model administrators can use to record model changes in Enterprise Architect. To learn more about how auditing can trace a change of requirement state, refer to the Help Guide on:
Auditing.

Enterprise Architect has a comprehensive and powerful built in Compare (diff) utility, which enables you to explore what has changed within a model over time.Enterprise Architect provides a facility to 'Baseline' (snapshot) a model branch at a particular point in time for later comparison with the current Package state. Baselines can be used in conjunction with Time Aware modeling to see how the state of Requirement changes over time, clearly identifying any changes that occur to that State. For more information, refer to the Help Topic on:
Baselines.

Are you able to trace elements between requirement types, or only within a requirement type? For example, can you trace from a trace use case to a non-functional functional requirement?

Yes, Enterprise Architect can Trace from a Use Case to a non Functional Requirement. Traceability helps to identify the way a given requirement or process has been implemented in a system, enabling you to follow the path of dependencies from the initial request, through a modeled solution and up to the deployed physical system or process. For more information, please refer to the webinar on
Traceability.

Requirements Checklist Element

What is a Requirements Checklist?

The Requirements Checklist is a convenient element that acts as a tally to indicate whether a Requirement complies with a set of predefined measures. The Checklist element can be assigned to any Requirement and the measures can be updated directly in the diagram.

For more information, refer to the Requirements Checklist section of Help Guide.

How do I get access the Requirements Checklist Element?

The Requirements Checklist element is available from the Requirements Toolbox. Simply drag the Requirements Checklist onto a diagram and draw a connector between the Checklist and the desired Requirement. The Checklist helps to ensure that a requirement follows a set of best practice guidelines.

Where to find the requirements Checklist Elements:
Toolbox | More Tools... | Requirements | Extended Requirements Page | Requirements Checklist

Is the Requirements Checklist an Enterprise Architect 13 feature?

No. It was available in a previous version of Enterprise Architect.

Can you customize the Requirements Checklist?

Yes. It is possible to customize a Requirements Checklist. You can add additonal list items with ease. The Checklist details are stored in a Tagged Value field of type Memo called: "Checklist". You can modify this XML statement to list many other other options or alter the existing set of options.

For more information, please refer to the Help Topic on the
Requirements Checklist.

Is it possible to programmatically update the values in the Requirements Checklist?

The values of the Requirements Checklist are available via the Memo tag. You can use the Enterprise Architect Object Model to make changes to the Tagged Value Class.

For more information, please refer to the Help Guide on:
The TaggedValue Class in relation to Automation.

Can you attach a Checklist to another element type?

Yes.

In addition to a requirements Checklist, there is also a generic checklist that can be associated with any model element.

Specification Manager

Can the Specification Manager be used with SysML requirements?

Yes. You can edit and review SysML requirements using the Specification Manager.

To learn more about the Specification Manager, please refer to the following page:
http://sparxsystems.com/enterprise_architect_user_guide/12.1/building_models/specification_usage.html

Can we show the id and the text fields as specified in SysML 1.4? Does this support user-defined requirement types (e.g. business rules, UI elements, etc.)?

The SysML Requirement type include the Tagged Values: ID and Text. You can use these, however they are displayed in the Tagged Value window.

An alternative option is to use the Element.Alias (ID) Element.Notes (text). These Alias and Notes and Tagged Values can be displayed in the diagram by selecting Diagram Properties (F5) | Element tab.

The Alias is set in F5 | Diagram > [x] use Element Alias.

A point to consider is that Auto numbering supports the Element Alias, however it is not supported for a SysML ID Tagged Value.

Enterprise Architect 13

Where can I download Enterprise Architect 13?

Registered users can download the Enterprise Architect installer directly from:
http://www.sparxsystems.com/securedownloads/EA130_Reg.msi

To learn more about Enterprise Architect 13 visit the release page:
www.sparxsystems.com/ea13

Is it possible for Enterprise Architect 12 and 13 to sit alongside one another?

Yes. When installing a newer version of Enterprise Architect, any existing Enterprise Architect installation will automatically be uninstalled. As a workaround to run multiple parallel versions of EA on your system, copy the directory where EA is currently installed before upgrading.
Ensure that you create a copy of the existing EA directory before installing Enterprise Architect 13. On Windows, it is typically found at:
C:\Program Files (x86)\Sparx Systems\EA
Running the EA.exe from this copied directory will allow you to continue using your previous version of Enterprise Architect while having Enterprise Architect 13 as your 'primary' installation.

What options are available for integration into Version Control in Enterprise Architect 13?

Read our Version Control whitepaper to learn best practice information in relation to version control in Enterprise Architect. For additional information, you may also refer to the Help Topic on using
Version Control.

Diagram Filters

In the Enterprise Architect version 13, are filters local to the user or available to all persons with access to the repository?

Diagram Filters are available to all users of a model.

Does the Diagram Filter work on all sort of diagrams? (Use Case, Activity diagram, etc)

Yes. Diagram Filters can be applied to any type of diagram within Enterprise Architect.

Are Diagram Filters applicable to individual diagrams or to all diagrams?

Diagram Filters can be applied to all diagrams.