Creating a Defect

You can create a defect whenever necessary to report a problem with a model version.

Required access roles:

  • App-specific: Defect Engineer
  • Baseline: Author

Defects are generally created from one of these contexts:

  • Customer-filed issues: referred to as external defects
  • Testing defects: discovered for a model version under development, usually by Quality Engineering; referred to as internal defects

To create a defect from an issue, you can either start with the top bar then search for the issue, or you can start from the Properties page of the issue.

  1. To create a defect, do one of the following:

    From the top bar, click > Defect Management > Create Defect.

    Or:

    1. Open the required model version. See the Product Line Management User's Guide: Opening a Model Version.
    2. From the Properties page toolbar, select Actions Create Defect .

    Or, if you have Defect Management and Collaboration installed:

    1. View the Model Version Derivations page for the model version.
    2. Select a model version revision or branch.
    3. From the toolbar, select Actions Create Defect .

    Some fields are filled in based on where you created the defect. For example, if you created the defect from the properties page for the model version, that model version shows in the Reported Against Model Version field.

  2. Enter these details:

    Field NameDescription
    Basics:
    Title Enter a title that briefly defines the defect.
    StateChoose the state the defect should be set to once created:

    StateDescription
    SubmitYou still need to gather additional details for the defect, but you want to enter the information you currently have.
    EvaluateYou will enter all the needed details and the defect is ready for assessment once you click Done.

    Expected Completion DateThe date when all associated defect actions are complete and verified.
    Reported Against Model Version Click the ellipsis button to search for and select the model version that the defect affects. If you started this procedure from a properties page for a model version or from an issue, the relevant model version is automatically listed here.
    Introduced In Click the ellipsis button to select the first revision of the model version where the defect is thought to exist.
    Reporting Organization By default, shows the organization associated with you (the person reporting the defect). Click the ellipsis button to select a different organization.
    When Found Select an option from the drop-down menu to indicate the stage of the model version development process where the defect was discovered:
    • Development
    • First Pass Test
    • Second Pass Test
    • Final Qualification
    • After Release
    • N/A
    Type For information only: shows the object type used to save the defect; cannot be changed.
    Policy For information only: shows the policy used to govern the defect; cannot be changed.
    Details:
    Severity Click the option that indicates how severe the defect is, where S0 is a showstopper and S3 is the least severe.
    Priority Click the option that indicates the priority for fixing this defect, where P0 means the highest priority and P3 is the lowest priority.
    Description Enter a detailed description of the defect.
    Steps to Reproduce Enter a step-by-step procedure showing exactly how to reproduce the defect.
    Environment Click the ellipsis button to select the environment (client and server operating systems, browsers, and so on) in use when the defect was discovered.
    Summary:
    Regression Click Yes or No.
    Regression From If regression is Yes, click the ellipsis button to select the model version revision where the feature last worked.
    Regression Details Enter a detailed description of the change that broke the relevant feature.
    NotesUse this field to enter discussion notes about the defect.
    Subscribers Click the ellipsis button to select people and member lists to be notified whenever a change is made to this defect.
    Keywords Enter a list of terms relevant to this defect that people can use when searching for defects.

  3. Click Done.