Statuses and transitions
Adding 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, enter the following parameters:
- Name
- Description
- Color
- Category
- Universal transitions
- Select Add status.
The status will appear in the list.
Editing 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.
Deleting a status
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.
Before deleting a status, the system checks for security issues associated with the status.
If the system finds at least one security issue associated with the status, change the status of that issue. Also, if the status is associated with at least one 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. A transition can't exist without that status.
If the status isn't critical in a transition, the system doesn't delete that transition.
- Select Confirm and delete.
The system deletes statuses asynchronously. Deletion time depends on the number of security issues associated with the status.
Adding a transition
To add a new transition, follow these steps:
- Go to Customization → Status model
- Select Add transition on the Transitions tab.
- In the form that opens, enter the transition parameters:
- Name;
- Description;
You can also select the Show description when changing status checkbox to display the description when you change the status of a security issue.
-
Groups;
-
Statuses:
- From;
- To.
infoYou can transition from any status specified in the From field to any other status specified in the To field.
- Select Add transition.
Editing a transition
To edit a transition between statuses, 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.
Deleting 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.
Importing and exporting status model parameters
System users can import and export the status model configuration.
To import a configuration, upload a prepared configuration to the current configuration. The system won't change or delete any current settings.
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 full configuration in JSON format.