Rational DOORS Next Generation 6.0.4 New & Noteworthy Details


Description
Configuration Management Artifact changes are more visible in a collapsible sidebar

In previous releases, artifact changes were listed in a sidebar that did not easily display conflicts or particular change types, or that required scrolling to find them.

In this release, the sidebar sections are individually collapsible and a new section specifically displays conflicts. You can also collapse the sidebar, which reveals more screen space to view the changes.
Automatically merge artifacts when you deliver change sets

If conflicts occur when you deliver change sets, such as if an artifact is modified in both the source and the target configurations, the artifacts can be merged automatically.

For automatic merge to work, different attributes of an artifact must be modified in each configuration; for example, the primary text modified in the source and the description modified in the target. If the same attribute is modified in both configurations, you must manually select the change that you want to deliver. This is the current process.

Now, you can use this new merge feature for express delivery and standard delivery. For express delivery, you choose the automatic merge option on the first page of the delivery wizard. Conflicts that cannot be merged are shown as before.

For standard delivery, use the new auto merge icon. All merged artifacts are displayed in a new section of the wizard where you can review the changes. You must manually address any conflicts that cannot be merged automatically.

Image of the auto merge icon:
Change set dependency calculations occur when a subset of change sets are selected for delivery

When you deliver change sets from stream to stream, the delivery wizard presents three delivery options: Express, Standard, and Custom.

Image of the delivery options:


Before this enhancement, the dependency calculation ran when you started the wizard, regardless of the delivery option that you chose.

When you select the Custom option, you can choose a set of change sets and view the dependencies for the selected change sets. After you select change sets, a dialog box notifies you that the dependency calculation is progressing.

Image of the calculation dependency dialog box:


After the calculations are complete, the selected change sets and dependencies are displayed.
Compare and deliver UI always shows source on the left and target on the right, and enables two-way comparisons in modules

The compare and deliver user interface now consistently shows the source in the left pane and the target in the right pane. This is always the case, whether you select folders, artifacts, or modules.

You can also perform a side-by-side comparison of artifacts in modules. Artifacts that are in conflict and are in a module are highlighted in the module compare and deliver view. You can choose to hide the following types of changes:

- Changes to rows that include links
- Structural changes such as additions, removals, or moved rows
- Rows for which the core artifact attributes changed
 
Image of the filter options:
Deliver Change Sets wizard was improved

You can now select the change sets in the first step of the Deliver Change Sets wizard.

The deliver options were modified to provide two simple options and a third option to customize your delivery. Use the Express option if you want to automatically deliver all the changes without reviewing them; you will be notified if there are any conflicts. Use the Standard option if you want to first review all the changes before delivering them. Use the Custom option to select all the changes or a subset of them, to review them or not, and to select the conflict resolution policy.

Image of the deliver options:
Drag and drop Rational DOORS Next Generation configurations

In Global Configuration Management, you can now drag streams, baselines, and change sets from the Rational DOORS Next Generation configuration picker into a valid location in a global configuration.

For details, see Global Configuration Management: Additional applications now support drag and drop and Work Item 111966.
Filter the list of comparison results

You can now filter the list of changed artifacts that are displayed in the compare and deliver user interface. Filter the results by typing part of the artifact name or the artifact ID.
 
Image of the sidebar showing the filtered artifacts:
More efficient data comparison

The compare and deliver user interface now loads all required data in manageable chunks and displays a progress bar to reflect the loading status.

Image of the progress bar:


For efficiency, the sidebar now pages each grouped section so that you never see more than 100 items at a time.

Image of the sidebar showing 100 artifacts at a time:
Navigate the configuration hierarchy of a component

The OSLC configuration representation of a stream now supports GET on the following Linked Data Platform Container (LDPC) resources:

- oslc_config:baselines
- oslc_config:streams

The LDPC resource representation contains the set child configuration resources, which can be retrieved to support navigation of the configuration tree.

For more information, see the OSLC Configuration Management specification.
New Changed Resources tab shows the changed resources for a change set

When you view change set details in the Change Set Editor, you can now use the new Changed Resources tab to see a list of changed resources for the current change set.

The displayed resource changes are grouped into the following categories: Types, Links, Folders, Artifacts, Tags, and Comments.

Image of the new Changed Resources tab:
New option to resolve a conflict in the Primary Text field

Previously, you had two options to resolve an attribute conflict: either deliver the source value or do not (which meant keeping the target value). You now have a third option: to manually edit the primary text value of the attribute to resolve the conflict. You can do this even if the primary text attribute itself is not in conflict but the artifact as a whole is in conflict.

Image of the Manually Merge menu option:


When you select the Manually Merge menu option, a dialog box opens with an editable Primary Text field. The field is populated with the target value, since that is what you can edit. The dialog box also shows the read-only source value for comparison.

Image of the Primary Text dialog box:
New two-way comparison view

In addition to the single view that shows additions, removals, and changes, you can now see a side-by-side comparison of a changed text artifact. This view helps you navigate through each change and shows all changes to attributes, links, and primary text.

Image of comparing versions of an attribute:


Image of comparing versions of primary text:
OSLC provider now supports component containers

The Requirements Management (RM) OSLC configuration management provider now supports component containers, as described in the OSLC Configuration Management specification. This support means that you can enumerate the components for a project and create new components that are associated with that project.
Original Change Sets tab added to the change set editor

The process to deliver change sets from one stream to another stream was simplified. After you deliver your changes to a parent stream, you might want to deliver them to another stream. When you deliver between streams, you can use a single change set to group the change sets that you want to deliver.

Use the Original Change Sets tab to view the change sets that you want to deliver to another stream.

Image of the Original Change Sets tab:


You don’t see this tab when you open a change set that hasn’t been delivered to its parent stream yet.

You can see the name of the change set, who created it, and when. Click the change set name to open it, and use the bread crumbs to navigate elsewhere.
Primary text merge includes existing embedded artifacts, links, and terms

When you manually merge a conflict in primary text, you can now include existing embedded artifacts, links, and terms from both the source and the target by using either copy and paste or drag and drop.

You can copy a link or an image to the clipboard without selecting the entire link text or image. In the read-only primary text content on the left side of the dialog box, right-click a link or an image and click Copy. You can also click and drag a link or an image from the left side and drop it into the editable primary text field on the right.
Import ReqIF packages into global configurations

You can now use the Rational DOORS Next Generation ReqIF API to import a ReqIF package into a global configuration.

To import the ReqIF package, issue an HTTP POST by using the REST client. The POST operation should use the resource URI that was returned in the location header of a preceding ReqIF upload request.
Upload ReqIF packages into global configurations

You can now use the Rational DOORS Next Generation ReqIF API to upload a ReqIF package into a global configuration.

To upload a ReqIF package, issue a multiple-part HTTP POST request by using a REST client. A successful HTTP POST operation returns a 201 message, and you can find the ReqIF Descriptor resource URI in the Response location header.
Start the proposed primary text with the source or target value

Previously, when you merged primary text for an artifact manually, the target text was on the right. Now, you can start editing either the source text or the target text.

If you click Start With Source Text, the original source text moves to the right so you can edit it with your proposed changes, and the current target text moves to the left so that you can compare them.

Then, you can edit the text on the right and click Apply Changes. The text on the right becomes the proposed changes that you apply to the target when you deliver the changes.

Image of the Manually Merge dialog box:
Streams Delivered To tab added to the change set editor

When you examine a change set in the change set editor, you can also see which streams the change set was delivered to, rather than the stream in which it was created.

For each stream, you see the name, creation, and modification details. Hover over a stream name to see more details.

If a change set is delivered to other streams, even as part of a stream-to-stream delivery, those streams are also shown.

If a change set is not delivered yet, or is delivered only to the stream in which it was created, a message is shown.

Image of the Streams Delivered To tab:
View details of changes to artifacts made as part of a change set

You can now see more details for artifacts when you view the changed resources in a change set.

To view details about the changes to an artifact, in the change set editor, on the Changed Resources page, click an artifact. Information about the associated changes is displayed in the same format as used in audit history.

You can also view the current state of an artifact in the stream by hovering over the artifact.
Reporting Avoid timeouts by configuring the ETL to run asynchronously

You can use a new advanced property to control the communication between the ETL clients and the Rational DOORS Next Generation reporting services. The new property is named RDMPPublishAllowAsyncModelForETL and is inactive by default.

By setting this property value to "true," the Rational DOORS Next Generation reporting services can communicate asynchronously with the ETL clients that add asynch=true to their requests. The ETL client itself does not have to support asynchronous communication.
External requests against the publish views data source schema are now supported

By using either Rational Publishing Engine or a browser, you can now submit external requests against the Rational DOORS Next Generation publish views data source schema. As a result, you can run Rational Publishing Engine reports that are based on the views schema directly on the Rational Publishing Engine launcher.

To run an external request against the views schema, you must provide information about the project, module, and view with these minimum parameters:

-moduleURI
-viewURI (viewName is not supported)
-ProjectURI

If one of the required parameters is missing, you will receive a bad request message. To run a successful request against the views schema, the view and module must belong to the project identified in the request.

The following examples show the new request formats that are supported:

https://serverNAme:port/rm/publish/views?moduleURI=https://serverNAme:port/rm/resources/_YbK4wd6IEeaEaOW7hUvrNQ&viewURI=https://serverNAme:port/rm/views/_iRsR8d6IEeaEaOW7hUvrNQ&projectURI=serverNAme:port/rm/process/project-areas/_uxdv8N3FEeaRC8I0G_Qhlg

https://serverNAme:port/rm/publish/views?moduleURI=_YbK4wd6IEeaEaOW7hUvrNQ&viewURI=_iRsR8d6IEeaEaOW7hUvrNQ&projectURI=serverNAme:port/rm/process/project-areas/_uxdv8N3FEeaRC8I0G_Qhlg
ReqIF Bulk import for links

The time it takes to import links from ReqIF packages is significantly reduced. Links are now created by using a bulk import, which occurs in a single change set.
Diagnostic and serviceability tool

Rational DOORS Next Generation now provides a ReqIF diagnostic service in a standalone tool that is available through IBM Support. The tool also provides serviceability features that you can use to check and verify the integrity of the ReqIF mapping tables. The ReqIF identifier tables are now preserved by backward-linking to previous revisions of those tables.
Improved memory consumption for importing and exporting packages

The memory consumption during ReqIF import and export operations is improved. The server's memory consumption is no longer proportional to the size of the ReqIF package. When ReqIF packages are imported or exported, the memory consumption remains steady after an initial warm-up period.

This improvement means that you can now import and export larger ReqIF packages before reaching the resource limitations of the server.
Use the ReqIF API to import ReqIF packages

You can now use the Rational DOORS Next Generation ReqIF API to initiate the import of an uploaded ReqIF package so that you can create and update the artifacts. To initiate an import, use the Descriptor resource URI in the form of a ReqIF import request as an HTTP POST by using the REST client. You can find the Descriptor resource URI in the location header of a successful ReqIF upload request.
Use the ReqIF API to upload ReqIF packages

You can use the Rational DOORS Next Generation ReqIF API to initiate the upload of a ReqIF package so that it can be imported. With this feature, you must upload the ReqIF package in a multiport request by using the REST client.
Reviews Create review comments for artifacts within modules

You can now comment on individual artifacts within a module that is under review. The comments are displayed in the Comments sidebar for the selected artifact.

Image of the Comments sidebar:


When a module is under review, a new Review Comments column is available. This column is automatically included in the default view for the module. You can add it to existing views, but it will only apply when the module is in review mode.

Image of a module showing the new Review Comments column:


The Review Comments column is similar to the Comments column: icons indicate when review comments exist and the state of those comments. You can also use the column to create a review comment for an artifact.

Image of the comment that is displayed when you hover over the icon:


Note that the Artifact Comments sidebar does not include module artifact comments. Only review comments made for the module itself are listed.

Image of the Artifact Comments sidebar:
SAFe Updated SAFe project templates

The following updates were made to the SAFe project templates:

- Updated attribute descriptions that were incorrect or out of date, particularly those for Program and Value Stream artifact types

Image of the Value Stream attributes:


Image of the Program attributes:



- Added default values for attributes on the Program and Value Stream artifact types

Image of the Allocated Capacity attributes:


Image of the Allocated Investment attributes:


Image of the Budgeted Capacity attributes:


Image of the Budgeted Investment attributes:


Image of the Owner attributes:


Image of the Status attributes:



- Updated existing artifacts and refreshed the templates
UI changes Filter bar was added to the artifact selection UI

The filter bar that was implemented in the 6.0.3 release is now available when you select artifacts.
Performance option for generating PDF reports was removed

When you generate a PDF report, you can no longer select the Performance option that was available in previous releases. The Sophisticated Formatting option for generating PDF reports was improved during recent releases, which made the limited features of the Performance option obsolete.
The "Confirm the source and target configurations" page was removed from the Compare Configurations wizard

You now have fewer steps to navigate to the Components Properties page in the Compare Configurations wizard.
The Summary page was removed from the Deliver Changes wizard

The Summary page, the final page in the Deliver Changes wizard, was removed, which reduces the number of clicks and screens that you have to complete to deliver changes from one configuration to another.
Upgrading and migrating Automatically validate data to identify potential migration issues

During migration, the validation process is a before-and-after comparison of the data. All reviews, components, and versionable data are validated. By default, 10 percent of the versionable data is validated. You can change this default by setting an environment variable called "validateData". You can enter a value of 0 - 10, where 1 represents 10 percent, 2 represents 20 percent, 3 represents 30 percent, etc.
Note: The higher the percentage of data to be validated, the more time is required to complete the upgrade. If there is a validation issue, it will often be repeated throughout the data and found with smaller validation percentages.

If errors are found during the comparison, the console and the addTables log file provide details that explain what the errors are. If errors are found during validation, the migration is considered unsuccessful.

After the migration is finished, a validation report is generated that shows how much data was validated, and the number of errors that were found in each baseline and each component in the projects.
Graphical artifact migration - New utility to migrate older graphical artifacts to new diagram format

If you have older graphical artifacts that were created with the graphical artifact editor browser add-on, you can now use a new utility to migrate them to the new diagram format. During migration, all existing links and comments are preserved.

The new migration utility is a custom widget that you can download, and host and place on the mini-dashboard in Rational DOORS Next Generation. The utility works with all graphical artifacts except storyboards.

To download the utility and view its documentation, see Rational DOORS Next Generation 6.0.4 – Graphical Artifact Migration Utility.
New upgrade status tool

When you upgrade the server from a version 5 release to a version 6 release by running the Requirements Management (RM) repository tools -addTables command, a new log file named rm_addTablesProgress.log is generated. This new log file tracks the progress of the RM project migration and displays the number of formal reviews, URIs, review baselines, module baselines, and project baselines grouped by project.
Rational DOORS 9 migration - Migration information is displayed on a new Migration tab in Project Properties

When you import a Rational DOORS 9 migration package by using the Import wizard, the package contents and the import reports are displayed on a new Migration tab in Project Properties. This information was originally displayed on the ReqIF tab.

You can review and inspect the packages that you imported from Rational DOORS.
Rational DOORS 9 migration - Specify a type system for modules in an incoming package

When you migrate requirements from Rational DOORS 9, during the import process, you can now specify an attribute to use for the module type within the incoming migration packages. Where appropriate, the value of the selected attribute for each incoming module is used to match against an existing Rational DOORS Next Generation artifact type.

This feature allows basic artifact mapping between Rational DOORS and Rational DOORS Next Generation, and can prevent problems with mapping their different data models.

Image of the Attribute for imported modules option in the Import wizard:
Usability improvements Editing Contents cells is more responsive

When you open a Contents cell for editing, you no longer have to wait for background server communications to finish before you make changes. Behind the scenes, the appropriate server calls still retrieve the latest version of the artifact, and lock it, but you can start editing right away. In most cases, you won't notice the background changes, except in high latency environments when the following situations might arise:

1. If you change a Contents value that is not in the most recent state, the following dialog box opens:


If you click Show changes, you will see a message similar to the following one:

You can copy the contents that are displayed on the left onto the clipboard.

2. If you change a Contents value, and the underlying artifact is already locked by another user, the following dialog box opens:


If you have the Override Lock permission, you will see a message similar to the following one:


In both of these situations, you only see the dialog box if you change the Contents cell before the server calls are completed, which typically only happens in high latency environments.

You might also notice that as soon as the lock icon or conflict icon appear for a particular row, one or more editable cell values might change. These value changes occur when the most up-to-date version of the underlying artifact is retrieved from the server. For example, a Priority cell's value might change from High to Low.
Saving Contents cells is more responsive

In modules, you can now make changes to Contents cells and save them immediately, without waiting for any server requests to complete.

When you open a Contents cell for editing, make changes and then save them, you no longer have to wait for any background server communications. In the background, the appropriate server calls still retrieve the latest version of the artifact, and lock it, but you can edit and save changes without waiting. In most cases, you won't notice the background changes, except in high latency environments when the following situations might arise:

1. If you change a Contents value that is not in the most recent state and then save the changes before the lock is obtained, the following dialog box opens:


If you click Show both versions, the dialog box expands, as in the following image:

You can copy the contents that are displayed on the left onto the clipboard.


2. If you change a Contents value and save it before the system determines that the underlying artifact is already locked by another user, the following dialog box opens:


If you have the Lock Override permission, the dialog box will look like the following image instead:



3. If you change a Contents value and then save the changes, you might notice that other cell values for the row also change. For example, a Priority cell value might change from High to Low. When you save only Contents cell changes, any updates are taken into account that other users made to other attributes before the background communications retrieved the most recent version of the underlying artifact.


4. If you navigate to another page while a row is being saved, you might see an "Are you sure you want to navigate away from this page?" dialog box. In the past, this type of dialog box opened if you tried to navigate away when a row is opened for editing. Now, this dialog box also opens when you save a row, but only in those cases where you attempt to save before the initial server communications to get the most recent version of the artifact and lock are complete.
Filter project area and component lists

In the Add Configuration dialog box, you can now type text to filter the lists in the Project Area field and the Component field. This capability enables you to quickly find and select project areas or components.

Image of filtering in the Component field:
New bulk edit option for views

You can now edit the attributes for all artifacts in a view.

If you have a large number of artifacts that you want to edit, in the Views menu, click Edit Attributes. In the Edit Attributes dialog box, you can select the attributes that you want to update for all artifacts in the view.

Image of the new Edit Attributes menu option:


Image of the new Edit Attributes dialog box:
Scrolling in modules is more reliable

In modules, the scrolling function is now more reliable, including in, but not limited to, the following situations:

- Loading asynchronous content such as links, images, and embedded artifacts
- Finding modules
- Resizing modules
Several minor updates were made to improve usability

The following items were updated to improve usability:

Dialog box to select configurations
The dialog box to select configurations when you deliver or accept changes, or compare configurations now shows the correct title. When you deliver changes, the dialog box title is "Select Target Configuration." When you accept changes, the dialog box title is "Select Source Configuration." When you compare configurations, the dialog box title is "Select Configuration to Compare." In addition, the wizard shows appropriate buttons for the operation.

Choose another component menu
The Choose another component menu now shows the correct capitalization. Also, the dialog box to select components shows the correct title, and has an increased column width to display more data.

Import button
In the project properties, the Import button now shows the correct name with a descriptive tooltip, and the URI shows the correct label.

All Projects page
On the All Projects page, components now show the correct label with the icon.

Add filter dialog box
In the Add filter dialog box, the correct label is now used for filtering or searching. When you filter, the label is "Type to filter." When you search, the label is "Type to search."

Icon to expand and collapse the sidebar
In artifact, module, and collection views, an expand and collapse icon was added for the right sidebar.
Support for Mozilla Firefox 52 ESR

Rational DOORS Next Generation now fully supports Mozilla Firefox 52 ESR.

© Copyright IBM Corporation 2017  |  Contact  |  Privacy Policy  |  Terms of Use