This information is for planning purposes only. The information herein is subject to change or removal without notice before the products described may become available.
The CE/CLM products were renamed in version 7.0. As the help is updated to reflect the changes, the topics might contain inconsistencies. For details on the name change, see Renaming the IBM Continuous Engineering Portfolio.

Configuring test artifacts to lock automatically after a state change

You can configure a test artifact so that it is locked depending on its state.

About this task

Typically, a new test artifact starts in Draft state and progresses through other states, such as Under Review, Approved, and Retired. While the artifact is in Draft state, you want it to be available for editing, but while it is in the other states, you might want it to be locked. You can configure the artifact to be locked automatically when it moves to certain states.


  1. Log in as a user who has permission to save project areas. The appropriate permissions are as follows:
    • A user who has permission to save the project area in the process configuration.
    • A user who is an administrator of the project area.
    • A user who has either the JazzProjectAdmins or JazzAdmins repository group permissions.
  2. Click the Administration (Administration) icon in the banner, and then click Manage This Project Area.
  3. In the Project Area editor, click Test Artifacts > Auto-Lock.

    The Test Artifacts - Auto-Lock editor opens, where you can define how an artifact state change can trigger whether an artifact is locked or not.


  4. Select a workflow to configure.
  5. In the Auto-Lock Triggers section, select a lock action for each state.

    For example, to configure a test artifact to be locked automatically when it moves to the Under Review state, select the Lock action for the Under Review state, and then click Save.

video icon Video channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community forums library

support icon Support

IBM Support Community
Deployment wiki