You are not logged in. Click here to log in.

codeBeamer Application Lifecycle Management (ALM)

Search In Project

Search inClear

Tags:  not added yet

Requirement Management Interface Add-On for MATLAB Simulink Requirements

MATLAB Simulink Verification and Validation (TM) defines a Requirements Management Interface, that allows to connect

  • Models,
  • Tests and
  • Code

with definitions like

  • Requirements,
  • Test cases,
  • Use cases

in external Requirements Management Systems.

By default only

are supported, but with the

  • codeBeamer Requirements Management Interface (RMI) Add-On,

you can also seamlessly link definitions managed by

codeBeamer RMI is a MATLAB Toolbox Add-On and requires

You can download the latest release from the Downloads section.

After successful installation, you will find CodeBeamer in the SimulinkTools menu, and your next step should be, to configure the connection to your codeBeamer server via

Tools -> CodeBeamer -> Settings... :

You can only link definitions at the specified codeBeamer Server, that are accessible (readable) by the specified user, who is

  • identified by Username and
  • authenticated by Password.

Bi-directional linking to codeBeamer work- and configuration items also requires permission to add comments to the respective item.

You can further configure the Linkable Item Types by (un-) checking the corresponding checkboxes, and choose,

whether the Select a CodeBeamer Tracker Item dialog (see below) should

  • Show the CodeBeamer item ids or not
  • Show the respective item paragraph numbers or not.

You can change these settings later at any time, but please be aware, that changing the codeBeamer Server and/or Username/Password, can break previously configured links from Simulink model elements to codeBeamer items.

The default MATLAB Simulink Requirements Traceability workflow looks like this:

Right-click on a Simulink model element and choose Requirements Traceability -> Open Link Editor ... from the context menu:

In the Link Editor popup dialog, click New on the Requirements tab, and choose the Document Type to be a CodeBeamer Item.

Next, click on Browse ..., to select a Document, which in CodeBeamer terminology is a Tracker:

Should you miss a specific project in the Project drop down list, then please Reload the (cached) list of all projects on the configured CodeBeamer server, accessible to the configured user.

Should you miss a specific tracker in the Tracker drop down list for the selected Project, then please check the CodeBeamer Settings... (see above), to see whether items in this type of tracker are enabled for linking.

If you already know the ID of the CodeBeamer Item to link, you can enter that Id directly into the Page/Item number field of the Link Editor.

But in most cases, you will want to select the CodeBeamer Item from the Document Index tab, which shows an outline of the currently selected Document (CodeBeamer Tracker):

Instead of using the Link Editor, you can also directly use the Link to CodeBeamer Item shortcut from the Requirements Traceability context menu, that brings up the
Select a CodeBeamer Tracker Item dialog:

The most recently used Tracker and Item are already pre-selected and the Tracker selector also contains all previously used trackers.

To add a new Tracker to the selector, click on Choose..., which brings up the Select a CodeBeamer Tracker dialog (see above).

If there are lots of Items to choose from, you can use the Filter to only show those items containing the entered text.

Only if you have enabled the Modify destination for bidirectional linking checkbox in the Selection Linking tab of the Simulink RMI Settings dialog, then also a comment, containing a link back to the selected Simulink model element, will be added to the linked CodeBeamer Tracker Item. E.g.:

Because MATLAB is a desktop application and not a web application, links from CodeBeamer items to MATLAB Simulink will only work,

  • if a MATLAB instance is currently active on localhost (the same machine where the Web Browser is running),
  • that also has Simulink installed and
  • that has access to the necessary model files.

For more information about using MATLAB Simulink and the linking and tracing of requirements, please refer to the appropriate MathWorks documentation.