Part 11 Compliance

Introduction

The configuration option Part 11 Compliance is provided at the project level to enable the Part 11 Compliance feature in a specific QMetry project. Users can disable the feature afterward. Enabling Part 11 Compliance will ask users to authenticate before changing the execution status.

Note: The Part 11 Compliance option will only be available if the eSignature feature is enabled in the project.

Whenever users change the execution status of a test case while test execution, an authentication pop-up appears to the user asking to provide a username and password/Part 11 Authentication Token. The operation is carried out only after the successful authentication of the user. The user authentication is asked across QMetry wherever users try to change the execution status. The purpose is to have only authenticated users in the organization to change the execution status of test cases.


Note: The Part 11 Compliance is only applicable to Test Case Approval and Test Suite Approval. The Part 11 Compliance is not applicable to Requirement Review.

Business Rules

  • If users change the execution status of multiple test cases through Bulk Operation, then the authentication pop-up appears only once. Users have to enter Username and Password to authenticate themselves. On successful authentication of the user, the execution status of test case gets changed. If the user is failed in authentication, the execution status of test case will not get changed.

  • Timezone for Execution Status Changed By values is managed as per the location of the user.

  • If the Part 11 Compliance option is enabled in QMetry project, then uploading automation result file through Automation API will not be allowed in respective project.

  • For existing users, the Part 11 Compliance feature will be disabled. For newly created project and eSignature enabled project, this option will remain disable by default.

  • If the Part 11 Compliance feature is enabled, then QMetry and LDAP users can do authentication with Username and Password/Part 11 Authentication Token. SAML users can do authentication with Username and Part 11 Authentication Token. Refer to know how to generate the Part 11 Authentication Token.
  • Users can not authenticate with inactive/deleted user.

Impact in Application

When the Part 11 Compliance feature is enabled, users get authentication pop-up. The can carry respective operations only after entering correct username and password.


Affected Areas in QMetryDescription
Test Suite module
  • Test Suite (with test case, platform, release and cycle associated with it) > Test Execution Tab. Select test suites to be executed and click on Bulk Execute. Update Status for a test case(s). The authentication window pops up.
  • While importing test suite run XLS/CSV file: If the Execution Status in the file differs, then the authentication window pops up. The execution status can be changed only after entering correct username and password.
  • In case of eSignature feature is enable: If users try to change the approval status of test execution from test suite detail page > Test Execution tab, the authentication window pops up.


Test Execution Screen
  • Test Suite (with test case, platform, release and cycle associated with it) > Test Execution Tab. Execute individual test suite. Update status for test cases individually or in bulk.
  • If user sets build/change build using "Set Your Build" button, at that time there is pop-up coming and asking for confirmation on whether to change Execution status to 'Not Run' or not. If you opt to Reset the execution status, then the authentication window pops up.
  • When syncing test cases with their latest version. Users can sync the test case with their latest version only on successful authentication.
  • In case of eSignature feature is enable: If users try to change the approval status of the test suite to "Close" on the execution screen, the authentication window pops up.


Test Case list view

  • In case of eSignature feature is enable: If users try to change the approval status of test cases individually or in bulk, the authentication window pops up. The test case is approved after successful user authentication subject to the user is added as a Test Case Approver.


How to Enable Part 11 Compliance?

  • Pre-requisite: The eSignature feature should be enabled for the project for which you want to apply the Part 11 Compliance.

Steps

  1. Go to eSignature > Approval Access.
  2. Turn the flag on for Part 11 Compliance on the screen.

The message pops up asking your confirmation -

"Once Part 11 Compliance is enabled, it will discontinue execution through Automation. Are you sure?"

3. Click "Yes" to proceed.


4. The Part 11 Compliance is enabled for the project. User authentication will be asked before changing the status of test cases as well as test steps. Users can opt to disable the compliance for the test step level.

  • Disable Part 11 for Test Step Level: By default, the option remains unchecked. Hence, the authentication screen pops up on the execution screen for every step for which you try to change its status. To stop asking for user credentials at the step level execution, check the check box and enable the option. The user credentials will then be required only at the test case level execution.

Business Rules

When the Part 11 Compliance feature is enabled, users are asked for QMetry credentials to authenticate themselves before performing certain operations. 

Test Case Operations

Testers can perform the following test case operations depending on the status of the eSignature feature, Part 11 Compliance feature, or their Approver permissions for test cases.

OperationeSignature DisabledeSignature Enabled but Not Authorized to Approve Test CaseeSignature Enabled and Authorized to Approve Test CaseeSignature and Part Compliance Enabled and Authorized to Approve Test Case
Create new test casesYYYY
Edit unapproved test case/test case versionYYYY
Approve test casesNANY (does not require QMetry credentials)Y (requires QMetry credentials)
Edit approved test cases/test case versionsNANNN
Create a new version of approved test casesNAYYY
Bulk Approve test casesNANY (does not require QMetry credentials)

Y (requires QMetry credentials)


Test Execution Operations

Testers can perform the following test execution operations depending on the status of the eSignature feature, Part 11 Compliance feature, or their Approver permissions for test execution.


OperationeSignature DisabledeSignature Enabled but Not Authorized to Approve Test SuiteeSignature Enabled and Authorized to Approve/Close Test SuiteeSignature and Part Compliance Enabled and Authorized to Approve/Close Test Suite
Create test suite and link platform, release and cycle to itYYYY
Approve a test executionNANY (does not require QMetry credential)Y (requires QMetry credentials)
Close a test executionNANY (does not require QMetry credential)Y (requires QMetry credentials)
Execute a test caseYY (can execute only Approved executions)Y (can execute only Approved executions)Y (requires QMetry credentials and can execute only Approved executions)
Import Test ExecutionsYY (can execute only Approved executions)Y (can execute only Approved executions)

Y (*requires QMetry credentials and can execute only Approved executions)


*pop-up appears only when the status in file differs from QMetry

Bulk Execute test cases against multiple releases, cycles and platformsYY (can execute only Approved executions)Y (can execute only Approved executions)Y (requires QMetry credentials and can execute only Approved executions) 
Bulk Execute test cases for a single platform, release and cycleYY (can execute only Approved executions)Y (can execute only Approved executions)Y (requires QMetry credentials and can execute only Approved executions) 
Sync latest version of test case on Execution ScreenYY (can sync only Approved executions)Y (can sync only Approved executions)Y (requires QMetry credentials and can sync only Approved executions) 
Assigning/resetting a BuildYY (can assign Build to only Approved executions)Y  (can assign Build to only Approved executions)Y (requires QMetry credentials and can assign Build to only Approved executions) 

Notes:

  • If the Part 11 Compliance option is enabled in QMetry project, then uploading automation result file through Automation API will not be allowed in the respective project.

  • If the Part 11 Compliance feature is enabled, then QMetry/LDAP users can do authentication. SAML users can not do authentication.

  • Users can not authenticate with an inactive/deleted user.
  • Time would be recorded as per the user profile. 

API

Method Type

Request

Response

/rest/admin/compliance/authenticate

POST

{"username":"admin","password":"Ispl123#"}

{"success":true,"userId":1}

/rest/admin/project/getinfo

GET

NO

Added “isPartLevelComplianceEnabled“ flag

/rest/admin/project

PUT


Added “isPartLevelComplianceEnabled“ flag

Added “isPartLevelComplianceEnabled“ flag

/rest/execution/matrix/updatestatus

POST

Added “changedBy“ parameter

NO

/rest/execution/runstatus/bulkupdate

PUT

Added “changedBy“ parameter

NO