Publish MATLAB Elements to Polarion

You should now have a connection configured and working between MATLAB and a project on a Polarion server. This topic explains various options for publishing model elements in MATLAB to Work Items in Polarion that represent requirements. Although requirements are the most common use case, the target item can be of any Work Item type configured in the project on your Polarion server.

Publishing means creating a link to a Work Item in Polarion .— either a preexisting item, or one you create during the process of publishing. Once published, users can easily navigate from elements and subsystems in the MATLAB model to Work Items in Polarion, and vice-versa. You can publish:

  • A single selected element to a single Work Item (existing or new).

  • Multiple selected elements to multiple Work Items (existing or new).

  • An entire subsystem (to a single Work Item that may later be decomposed into multiple child items).

  • An entire diagram to a single Work Item.

Publishing to a new Work Item

You can select a MATLAB element and publish it to create a new Work Item in the configured Polarion project.

  1. Select an element in a MATLAB diagram. The element must be one supported by MATLAB's Requirements Management Interface (RMI).

  2. On the element's context menu, select PolarionPublish Block/(Sub)System. (If the element is not supported by RMI, the Polarion menu item visible, but all actions are disabled.)

    A new Work Item of the type specified in the configuration for this connection is created in Polarion and displayed in a dialog box that now pops up.

  3. Click the Work Item listed in the dialog box, wait while your web browser opens a new instance, and the new Work Item opens in the Polarion web interface.

  4. Optionally edit any data fields of the new Work Item, such as Title or Description, and save the Work Item.

Tip:

Polarion users can now follow the link in the Hyperlinks section of the Work Item back to the element in MATLAB.

You can optionally link the same MATLAB element to multiple Work Items in Polarion. For example, you might link to two requirements: functional and nonfunctional.

The Polarion context menu in MATLAB now has an item Open Linked Work Item, which leads to a dialog box in which you can click any listed item to open it in Polarion.

Publishing to an existing Work Item

You can select a MATLAB element and publish to link it an existing Work Item in the configured Polarion project.

  1. Select any element in the MATLAB model and on its context menu, select Polarion Link Block/(Sub)System with Existing Item.

    The Select Polarion Work Item dialog box opens and lists all items found by the query specified in the MATLAB to Polarion connection settings. Note that the configured query string is shown, and that you can modify it in this dialog box to retrieve a different set of items.

  2. Locate the target Work Item in the dialog box, and select it.

  3. Click Link Selected.

A hyperlink to the MATLAB model is added to the existing Work Item in the Hyperlinks section.

Bulk publishing to Polarion

You can publish multiple elements of a MATLAB diagram to Polarion in order to create, say, requirements for them in a single operation. For example, you could publish two selected subsystems to create Requirements in Polarion that cover both of them.

  1. Select multiple elements in a MATLAB diagram — subsystems, for example.

  2. Right click any selected element and on the context menu select: PolarionPublish Block/(Sub)System.

  3. Confirm that you want to publish multiple selected items.

New Work Items are created for all elements selected and these are listed in the Following Work Items Were Linked dialog box.

You can click any listed item to open it in Polarion in your web browser. Each item has the same title as the element in MATLAB, and also contains an image of the element (subsystem or block, for example), as well as a hyperlink back to the element in MATLAB.

Publish an entire diagram to Polarion

  1. Right-click the diagram background, and on the context menu choose: Polarion Publish Block/(Sub)System.

    A new Polarion Work Item is created in Polarion with the same title as the MATLAB diagram.

  2. Navigate to the Work Item in Polarion in your browser by clicking on the item in the dialog box.

    The Work Item's Description field contains an image of the entire MATLAB diagram.

  3. Edit the data of the new Work Item as desired and save it.

    Users can follow the link in Hyperlinks to the diagram in MATLAB.

Tip:

  • Use the element context menu item Remove Highlighting in MATLAB to prevent the image in Polarion from showing highlighted elements.

  • If you modify the diagram in MATLAB, use diagram context menu item Refresh Published Diagram(s) to update the image in the Work Item on the Polarion server.

  • The diagram image is created/updated as an attachment to the Work Item, which is versioned in the repository. Older revisions of the image are accessible in the attachment history.

Use the Requirements Management interface

MATLAB is designed to work with external requirements management tools. Polarion natively integrates with MATLAB, so you can access Polarion-managed diagrams/elements and modify their properties in MATLAB.

Right-click any diagram element linked to Polarion, and choose Requirements on the context menu. The context menu indicates if the element is linked to any requirements. You can click any requirement beginning with Polarion: to navigate to the linked Requirement in Polarion.

Click Add-Edit links to see the link properties. You can use this dialog box to unlink any element from Polarion (if an element was linked to the wrong existing Work Item by mistake, for example).