Version: 1.6

Statuses and transitions

Add a status

To add a new status, follow these steps:

Go to Customization → Status model.
On the Statuses tab, select Add status.
In the form that opens, fill in the following parameters:

Name
Description
Color
Category
Universal transitions

Select Add status.

The status appears in the list.

Edit a status

To edit a status, follow these steps:

Go to Customization → Status model.
Select the edit button () in the status row.
Change the status parameters in the window that opens.
Select Save changes.

Delete a status

danger

You can't delete the New and Fixed statuses or change their categories.

To delete a status, follow these steps:

Select the delete button () in the status row.
In the window that opens, confirm that you want to delete the status.

caution

Before deleting a status, the system checks for security issues associated with the status you're deleting.

If the system finds at least one security issue associated with the status you're deleting, change the status of that issue. Also, if the status you're deleting is associated with at least one status transition, confirm that you want to remove the status from the associated transitions and delete the transitions where the status is the only value in the From and To fields. The transition can't exist without this status.

If the status you're deleting isn't critical in the transitions, the system doesn't delete those transitions.

Select Confirm and delete.

caution

The system deletes statuses asynchronously. The deletion time depends on the number of security issues associated with the status you're deleting.

Add a transition

To add a new transition, follow these steps:

Go to Customization → Status model
On the Transitions tab, select Add transition.
In the form that opens, fill in the transition parameters:

Name;
Description;

note

You can also select the Show description when changing the status checkbox to display the description when changing the status of a security issue.

Groups;
Statuses:
- From;
- To.
info
You can transition from any status specified in the From field to any other status specified in the To field.

Select Add transition.

Edit a transition

To edit a status transition, follow these steps:

Go to Customization → Status model.
On the Transitions tab, select the edit button () in the transition row.
Change the transition parameters in the window that opens.
Select Save changes.

Delete a transition

To delete a transition, follow these steps:

On the Transitions tab, select the delete button () in the transition row.
In the window that opens, confirm that you want to delete the transition.

Import and export status model parameters

System users can import and export the status model configuration.

To import a configuration, upload the prepared configuration to the current one. The current settings won't be changed or deleted.

The system also includes presets for status and transition configurations.

To import a configuration, use a JSON file with the following structure:

{
  "statuses": [
    {
      "key": "string",
      "name": "string",
      "description": "string",
      "category": "string ('open' | 'closed')",
      "color": "string (HEX code)",
      "universal_transition": "boolean"
    }
  ],
  "transitions": [
    {
      "name": "string",
      "description": "string",
      "groups": [
        "string"
      ],
      "from_statuses_keys": [
        "string (key)"
      ],
      "to_statuses_keys": [
        "string (key)"
      ],
      "show_description_in_select": "boolean"
    }
  ]
}

The system exports the complete configuration in JSON format.

Add a status​

Edit a status​

Delete a status​

Add a transition​

Edit a transition​

Delete a transition​

Import and export status model parameters​