New & Noteworthy for IBM Engineering Test Management 7.0.2


Description
Administration New Project Area Metadata viewer for ETM

From the ETM 7.0.2 release, a new Project Area Metadata viewer is now accessible that displays the metadata of all active project areas. The Project Area Metadata viewer displays the following metadata of all active project areas:

  • Name
  • Item ID
  • Configuration Management
  • Alias

For more information, see Project Area Metadata Viewer.

Artifacts Simplified linking for OSLC link types

Drag-and-drop
In the 7.0.2 release, you can drag-and-drop test artifacts from the ETM test artifacts editors or list views into work item editors in IBM Engineering Workflow Management (EWM) or requirement editors in IBM Engineering Requirements Management DOORS Next (DOORS Next).

You can use the test artifact icon in the test artifact editor header to drag a test artifact.

Image of the editor header:


You can use the drag handle in the test artifact list view to drag the selected test artifacts.

Image of the list view:


You can drag a test artifact into another tab or window that uses the same browser instance and drop the test artifact into the artifact editor. When you drag a test artifact over an artifact editor, a drop target is displayed.

Image of the drop target for single artifact editor:


When you drop a test artifact into an artifact editor, you can create links between the artifacts. You can select the link types and editor section, if available, from the Create Links dialog box and then click Create Links. The Create Links dialog box is also used in the copy-and-paste operation for the confirmation of link creation.

Image of the Create Links dialog box:


Copy-and-paste
You can use the Copy link for this page option in the test artifact editor to copy the test artifact link besides copying the browser link of the page.

Image of the copy option in the test artifact editor:


You can use the Paste artifact links option in the artifact editor header to paste the copied test artifact links into the artifact editor.

Image of the paste option in the test artifact editor:


In the test artifact list view, you can use the new Copy artifact links option to copy the selected test artifacts.

Image of the copy option in the test artifact list view:


You can use the following keyboard shortcuts for the copy-and-paste feature:
  • Copy Link: Ctrl+C (Windows) or Command+C (Mac)
  • Paste as link: Ctrl+Shift+V (Windows) or Command+Shift+V (Mac)
Note: The drag-and-drop and copy-and-paste features for creating links are supported for all the OSLC link types that are supported in the EWM, ETM, and DOORS Next applications.

The copy-and-paste feature is not supported for creating links across Jazz Team Servers. You can use this feature only to create links between applications that are registered to the same Jazz Team Server.

The links between ETM and EWM are managed within EWM. ETM searches for the links by using the Link Index Service. The links that are created from ETM to EWM might not be available in the Link Index Service immediately. Even after you save the test artifact, the links might not display in ETM. When you refresh the test artifact, the links that are created in the Link Index Service get displayed.

You cannot link artifacts between different global configurations. If you select a configuration in the EWM application, you cannot create a link to an artifact in a different global configuration.

Image of the error when trying to create a link to a different configuration:

 
ETM Excel/Word Importer Utility ETM Excel Importer Utility now displays the configuration name during an offline execution and supports automatic population of the configuration name when exporting to the server

The Microsoft Excel file (.xls) that is generated from the offline execution package (.rqms file) now displays the configuration name. This read-only field is available for reference, and it cannot be modified.

You can now avoid selecting the project name and configuration URI when you export the test result back to the server after an offline execution. To avoid the manual selection, click Validate after you enter the server URL and authentication details in the Export to ETM dialog box. After successful validation, the project name and configuration URI that are specified in the generated Microsoft Excel file (.xls) are automatically populated. If required, you can change the automatically populated project name, configuration URI, or both before you export the test result to the server and click Export.

Note: The automatic population of the project name and configuration URI does not work for a Microsoft Excel file (.xls) that is not generated from an offline execution package (.rqms file) or generated from an offline execution package (.rqms file) that is created by using an earlier version of the ETM server or imported by using an earlier version of the ETM Excel Importer Utility.
 
ETM Excel Importer Utility now displays the test environment name during an offline execution

The Microsoft Excel file (.xls) that is generated from the offline execution package (.rqms file) now displays the test environment name. This read-only field is available for reference, and it cannot be modified or exported back to the server.
ETM Excel/Word Importer Utility now supported on desktop version of Excel and Word from Microsoft 365 Apps

ETM Excel/Word Importer Utility is now supported on the desktop versions of Microsoft Excel and Microsoft Word from Microsoft 365 (formerly known as Office 365).
ETM Excel/Word Importer Utility shows error messages with category names and category values if the export operation fails due to permission issues when creating categories

Until now, if a test artifact export operation failed due to permission issues when creating categories, the ETM Excel/Word Importer Utility showed an error message in the ETM Export dialog box without category names or category values.

Now, if a test artifact export operation fails due to permission issues when creating categories, the error message in the ETM Export dialog box shows the category names and category values. Also, the error message specifies the type of the category.

Execution ETM now supports customization of execution states for test script step results

In ETM, you can customize the execution states under the Execution States section in the Manage Project Properties > Properties page. The following customization options are available:

  • Edit the name of the execution states.
  • Enable or disable the execution states.

Until the 7.0.2 release, you were able to customize execution states for test case results and test suite results.

From this release, the support is now extended to include the following enhancements:

  • You can now customize execution states for the test script step results along with test case results and test suite results.
  • You can now see the scope of the execution states under the Execution States section in the Manage Project Properties > Properties page. An execution state can have one of the following scopes:
    • Results (applicable for test case results and test suite results)
    • Step Results (applicable for test script step result only)
    • Results, Step Results (applicable for test case results, test suite results, and test script step results)
  • You can now see the customized names of execution states in the following fields:
    • Execution schedule result
    • The following dashboard widgets:
      • Execution Status by Points
      • Execution Status by Number of Steps
      • Team Execution Status for Test Cases
      • Team Execution Status for Test Suites
      • Test Suite Execution Status
    • LQE-based reporting
  • Changes are made in the resource shape of test results, test suite results, and test script step results to show the customized names of the following properties:
    • Points Blocked
    • Points Failed
    • Points Inconclusive
    • Points Passed
    • Points Deferred
    • Points Skipped
    • Points Perm Failed
    • Script Step Count Blocked
    • Script Step Count Deferred
    • Script Step Count Skipped
    • Script Step Count Failed
    • Script Step Count Inconclusive
    • Script Step Count Passed
    • Script Step Count Perm Failed
    • Number of Blocked Test Cases
    • Number of Deferred Test Cases
    • Number of Error Test Cases
    • Number of Failed Test Cases
    • Number of Incomplete Test Cases
    • Number of Inconclusive Test Cases
    • Number of Inprogress Test Cases
    • Number of Partially Blocked Test Cases
    • Number of Passed Test Cases
    • Number of Paused Test Cases
    • Number of Perm Failed Test Cases
  • ETM Reportable Rest API now shows the customized labels of the test script step result verdict and execution schedule result.
  • Allow steps to be skipped during manual test script execution is removed from the Execution States section in the Manage Project Properties > Properties page. Instead, the Skipped execution state is added. If you enabled the Allow steps to be skipped during manual test script execution property in the earlier ETM versions, the Skipped execution state is enabled after migration to the ETM 7.0.2 version.
New option to copy associated test environments to the target test plan while duplicating execution records

While duplicating test case execution records or test suite execution records, the Duplicate Execution Records dialog box now shows an option to include or exclude test environments that are associated with the execution records. If you select the Include test environments option, test environments that are associated with the execution records are copied to the target test plan along with the execution records.

The option to include or exclude test environments has the following characteristics:

  • The option is available for duplicating test case execution records and test suite execution records in the same project area.

  • The option is enabled only when a test plan is selected in the Duplicate Execution Records dialog box.

  • The Test Environments > Platform Coverage section of the target test plan is not updated with lab resources that are part of the copied test environments.

New project properties are introduced to add the referenced test cases or test suites to a test plan while duplicating a test case execution record or test suite execution record

Until now, it was not possible to duplicate test case execution records or test suite execution records to a test plan when the referenced test cases or test suites were not part of the target test plan.

Now, new project properties, Add the required test case to the target test plan while duplicating the test case execution record and Add the required test suite to the target test plan while duplicating the test suite execution record are added under the Execution Record Preferences section in the Manage Project Properties > Properties page. When these project properties are enabled by the project administrator, the referenced test cases or test suites are added to the target test plan while duplicating the execution records. These new project properties are disabled by default.
New project properties to enable ETM to automatically determine the test script to be executed for a test suite step during a test suite execution

Until now, you could manually change the test scripts of a test suite step in the Run Test Suite dialog box during a test suite execution. You might change the test script of a test suite step in the following scenarios:

  • You added a test script to a test case that was already added to the test suite.
  • You archived a test script that was the default test script of a test suite step.
  • You removed a test script from the associated test case and the test script was the default test script for a test suite step for that test case.
  • You created an automated test script for a test case that was already added to the test suite. A manual test script that was associated to the test case was selected as the default test script for the test suite step. Then, you added an automated test script to the test case and wanted to run the automated test script during the test suite execution.

From ETM 7.0.2 Sprint 4, the following project properties are added under the Execution Preferences section in the Manage Project Properties > Properties page to take care of these scenarios:

  • The execution preference, During a test suite execution, automatically select a test script that is associated with the test case if the user does not set a default test script enables ETM to automatically determine the default test script for a test suite step during the test suite execution in the following scenarios:
    • The test suite step does not have a default test script.
    • The existing default test script is archived or removed from the associated test case of the test suite step.
The automated test script with the highest ID (when the associated test case contains both automated and manual test scripts) or the manual test script with the highest ID is selected as the default test script.
  • The execution preference, During a test suite execution, automatically select an automated test script that is associated with the test case if the user sets a manual test script enables ETM to automatically select an automated test script as the default test script during the test suite execution if the associated test case contains both automated and manual test scripts, and you set a manual test script as the default test script for the test suite. The automated test script with the highest ID is selected as the default test script.
Global Configuration Management Multi-component Technology Preview

The ETM application now includes the Multi-component Technology Preview that enables test artifact relationships, such as linking and running tests across components in a configuration management enabled project area.

The following capabilities are provided in the Multi-component Technology Preview:

  • To enable or disable this feature in ETM or a specific configuration management enabled project area.
  • To view test artifacts from multiple components on the same page. For example, test cases from multiple components can be displayed in the Browse > Test Cases view.
  • To create new test artifacts with a specific component.
  • To create or delete links between test artifacts from multiple components. For example, the Test Cases section of a test plan can be used to add test cases from multiple components to the current test plan and view test cases from multiple components.
  • To provide ETM Reportable REST API and OSLC QM API support of a multi-component context.
  • To run tests with test artifacts that are linked to artifacts from multiple components.
  • To display all the components in the current multi-component context.

Note: This feature is currently a technology preview and is not supported for use in a production environment. You must install the ELM applications on a dedicated server to use this feature.

For more information, see the Multi-component Technology Preview WIKI.

Offline Execution Execution variables can be added or modified for Offline Execution and can be exported back to the server

From the ETM 7.0.2 release, execution variables are now supported for test case and test suite offline executions. You can add artifact execution variables and project execution variables to test scripts, test cases, and associated test suites. The values can be modified in the Run Offline and Run Test Suite Offline dialog boxes.

The following changes are made in the ETM web UI:

  • You can add execution variables to a test script that is intended for offline execution.
  • You can add execution variables to a test case that is intended for offline execution.
  • You can add execution variables to a test suite that is intended for offline execution.
  • You can modify execution variables in the Run Offline and Run Test Suite Offline dialog boxes. The edited values in the Run Offline dialog box are processed for further execution. The generated execution package (.rqms file) contains information about the execution variables and their values.

In this release, changes are also made in the ETM Excel Importer Utility. After you import the execution package (.rqms file), the generated Microsoft Excel file (.xls) shows the execution variables and their values with the following options:

  • For the execution step type, the variables are displayed inline with the step description. These variables cannot be modified.
  • For the variable step type, the variables are displayed inline with the step description. The values of these variables can be modified from the editable cells.
  • If a test suite has multiple test cases with associated execution variables, each of the sheets in the generated Microsoft Excel file (.xls) shows the associated execution variables.

For more information on different formats of the generated Microsoft Excel file (.xls) and limitations of using execution variables, see ETM Excel/Word Importer Utility.

Offline execution support for a test suite with scriptless test cases

You can now run a test suite offline with scriptless test cases. Earlier, the offline execution of a test suite was possible only when the test suite had test cases with test scripts.

You can add multiple test cases with or without associated test scripts to a test suite and run the test suite offline. After a successful execution, an RQMS file (.rqms) is downloaded.

To import the RQMS file (.rqms) into Microsoft Excel, select the ETM > Import for offline option from the Add-In menu. A Microsoft Excel file (.xls) is generated with one test suite result sheet and multiple test case result sheets. The result sheets have different attributes and properties for test case results with and without step results. You can update the start time, end time, overall result, step results, and weight distribution values for execution results without step results.

You can export the test results back to the server in a single user operation by selecting the ETM > Export to Repository option from the Add-In menu.

ETM now shows the customized names of the execution states in an offline execution

ETM supports customization of execution states for test case results and test suite results. You can customize the execution states under the Execution States section in the Manage Project Properties > Properties page. From the ETM 7.0.2 release, you can see the customized names of execution states in test script step results along with test case results and test suite results.

From this release, support is also extended to include the customized names of execution states in an offline execution package (.rqms file) when you run a test offline by using ETM Excel Importer Utility. You can see the customized names of execution states in the following sections of the generated Microsoft Excel file (.xls):

  • Overall Result
  • Step Result
  • Weight Distribution

Note: The Skipped execution state is not supported for an offline execution.

After you export the result back to the ETM server, these customized values are updated in the result details.

OIDC Application Password Support OIDC application password support is provided for the command-line and Selenium adapters

The command-line and Selenium adapters now support a new type of authentication process to connect to IBM Engineering Lifecycle Management (ELM) applications that are configured for OpenID Connect (OIDC) authentication by using the Jazz Authorization Server (JAS).

You can use the new authentication process with the command-line and Selenium adapters to work in an environment that uses third-party identity providers, such as SAML or OIDC for authentication without any direct support for the protocol that is used by these identity providers. Instead, users receive an application password from JAS. The application password is generated by the configured third-party identity provider. For example, a user can select SAML with the two-factor authentication process and use the application password for authentication with the ELM applications.

With this new authentication process, the user must assign the existing command-line argument, -password and enter the application password instead of the user password.

OIDC application password support is provided for the ETM Copy Project Properties Utility

ETM Copy Project Properties Utility now supports a new type of authentication process to connect to ETM applications that are configured for OpenID Connect (OIDC) authentication by using the Jazz Authorization Server (JAS).

You can use the new authentication process with the ETM Copy Project Properties Utility to work in an environment that uses third-party identity providers, such as SAML or OIDC for authentication without any direct support for the protocol that is used by these identity providers. Instead, users receive an application password from JAS. The application password is generated by the configured third-party identity provider. For example, a user can select SAML with the two-factor authentication process and use the application password for authentication with the ELM applications.

With this new authentication process, the user must assign the existing command-line argument, -sp/-dp and enter the application password instead of the user password.
OIDC application password support is provided for the ETM Excel/Word Importer Utility

ETM Excel/Word Importer Utility now supports a new type of authentication process to connect to IBM Engineering Lifecycle Management (ELM) applications that are configured for OpenID Connect (OIDC) authentication by using the Jazz Authorization Server (JAS).

You can use the new authentication process with the ETM Excel/Word Importer Utility to work in an environment that uses third-party identity providers, such as SAML or OIDC for authentication without any direct support for the protocol that is used by these identity providers. Instead, users receive an application password from JAS. The application password is generated by the configured third-party identity provider. For example, a user can select SAML with the two-factor authentication process and use the application password for authentication with the ELM applications.

With this new authentication process, the user must select the Username and Password authentication type in the Export to ETM information window and enter the application password in the Password field.

For more information on the available authentication types, see ETM Excel/Word Importer Utility.

OIDC application password support is provided for the ETM Execution Tool

ETM Execution Tool now supports a new type of authentication process to connect to ETM applications that are configured for OpenID Connect (OIDC) authentication by using the Jazz Authorization Server (JAS).

You can use the new authentication process with the ETM Execution Tool to work in an environment that uses third-party identity providers, such as SAML or OIDC for authentication without any direct support for the protocol that is used by these identity providers. Instead, users receive an application password from JAS. The application password is generated by the configured third-party identity provider. For example, a user can select SAML with the two-factor authentication process and use the application password for authentication with the ELM applications.

With this new authentication process, the user must assign the existing command-line argument, -password and enter the application password instead of the user password.
OSLC Migration Improved status of OSLC Migration

From the ETM 7.0.2 release, you can see an improved status of OSLC Migration when you go to https://<host>:<port>/<context>/oslcMigrationManager (for example, https://myserver:9443/qm/oslcMigrationStatus).

You can now see the following new columns:

  • Project Area: Name of the project area that is migrated, being migrated, or waiting to be migrated.
  • Status: The current status of the project area, such as Complete, In Progress, or Not Started.
  • Total Items Migrated: Total number of items that are migrated in the project area.
  • Current Item Type: The item type that is being migrated.
  • Items Migrated for Current Item Type: Total number of items that are migrated of the item type that is being migrated.
  • Progress: The percentage value that is calculated based on the number of item types (for example, test plan, test case, and other types) in a configuration that are pending to be migrated in the project area. Some item types might take longer to migrate than other item types.
  • Current Configuration: The configuration that is being migrated.
Reporting ETM Reportable REST API, PDF export, and CSV export can now optionally show the updated labels of remote links

ETM stores the labels of owned remote links when the links are created. However, these labels become stale when the remote resources are modified. Owned remote link types include all remote link types in an ETM project area where configuration management is not enabled and remote link types that are owned by ETM in configuration management enabled project areas, such as Requirement Management (RM) links.

A new advance property, Resolve the latest labels of owned remote links in PDF, CSV, and REST API, is added in the ETM Integration Component section under the Server Administration > Advanced properties page. This property is disabled by default. When this property is enabled, the latest labels of the owned remote links are resolved from the remote application and used as the labels of the owned remote links in PDF reports, CSV exports, and ETM Reportable REST API responses. Otherwise, the existing labels of the owned remote links are used as the labels of the owned remote links in PDF reports, CSV exports, and ETM Reportable REST API responses.

The existing advance property, Enable resolving remote link labels for PDF, CSV, and REST API, is renamed to Resolve the latest labels of unowned remote links in PDF, CSV, and REST API. Its functionality remains same. This advance property is enabled by default. Unowned remote link types include remote link types that are not owned by ETM in configuration management enabled project areas, such as Change and Configuration Management (CCM) links. When this property is enabled, the latest labels of the unowned remote links are resolved from the remote application and used as the labels of the unowned remote links in PDF reports, CSV exports, and ETM Reportable REST API responses. Otherwise, the URLs of the unowned remote links are used as the labels of the unowned remote links in PDF reports, CSV exports, and ETM Reportable REST API responses.

Notes:

  • A functional user association with the remote application is required to resolve the latest remote link labels.
  • PDF reports, CSV exports, and ETM Reportable REST API responses take longer to resolve the latest remote link labels.
REST API Project Feed Service supports fields filtering

The Project Feed Service now supports fields filtering to easily resolve a project area based on the title or alias properties.

For more information, see Project Feed Service.

Server Start Up New readiness probe for ETM

From the ETM 7.0.2 release, a readiness probe is available for ETM. This service can be used to determine if an application is ready to use.

For more information, see the Readiness probe wiki.

Usability Enhancements Archive streams and baselines with dependent configurations

From ETM 7.0.2 Sprint 4, you can now archive baselines or streams when child streams or baselines have a dependency on these configurations. For example, if a parent baseline is associated with a child stream, you can now archive the parent baseline.

Column titles of a list view now honor the Wrap words to show all preference in the Change Column Display Settings dialog box

Until now, you were able to set the Wrap words to show all preference for the cell text display of test artifacts in the list view. When many columns were displayed, the contents in the cells were wrapped but the column titles were not wrapped and might not be fully visible.

Now, the Wrap words to show all preference is enhanced for the column title display also. After you enable the Wrap words to show all preference under the Cell Text and Column Title Display section in the Change Column Display Settings dialog box, the column titles are wrapped and fully visible even when many columns are displayed.
Web UI New people picker component

A new people picker component is now introduced as part of the ongoing user experience transformation and alignment with IBM's open source Carbon Design System. The people picker is a dialog box for selecting users and can be used for assigning an owner or a set of subscribers to an artifact.

The new people picker is common across the following applications:
  • DOORS Next
  • Engineering Insights
  • Engineering Test Management
  • Engineering Workflow Management (including Rhapsody Model Manager)
  • Global Configuration Management
  • Jazz Team Server
The following improvements are included over the classic people picker component:
  • Access control scoping of users: Only the relevant users are shown as defined in the Access Control setting of the current project area. For instance, if read access is set to Members of the project area hierarchy, then you can see only project area and team area members in the search results.
  • Recent users: In addition to the current user, you can access the 10 most recently selected users. However, in this release, the Recent list for quick access is limited to the current user.
  • Managing multiple users: Existing users are preselected in the dialog box. You can add new users or remove existing users. Previously, the people picker only supported the addition of new users. Now, you can manage an existing selection set in a single step.
Note: The classic people picker component is not entirely replaced. You can still use it in the Administration UI, and for selecting users when querying and filtering because these use cases require access to all historical users.

Image of the classic people picker component:


Image of the new people picker component (single-user mode):


Image of the new people picker component (multiple-user mode):

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