Issue fields - Cloud
Description
Create Issue, Update Issues, and Create Subtask post functions support a number of fields for a configuration that helps you control when the issue or subtask should be created or updated and what information is associated with the issue or subtask once created or updated.
Important Notes
If the issue is not a subtask, then the Parent Issue is the same as the Original Issue (the issue that originally started the transition).
Unless otherwise indicated, most fields are common to Create Issue, Create Subtask and Update Issues.
Sections containing field configurations
The configuration screen contains sections of powerful configuration options.
On the top right corner of any selectable field, when you hover over you can see usable icons that help you switch between one of the following modes:
Select value (default) - select a value from the available list of options or type in the field to select a value from the auto-suggestions
Set value - enter a value as required from the Substitution variables list
Basic fields
The following configuration fields are most commonly used by customers.
Field | Create Issue | Create Subtask | Update Issues (Available) | Default | Description |
|---|---|---|---|---|---|
Summary |
| Enter a summary for the issue being created or updated. Alternatively, you can add substitution variables to copy the summary from the parent or original issue. The character limit for this field is a maximum of 255 characters. Ensure the summary entry respects the character limit. If not, the post function cannot be processed further. | |||
Description | Same (Update Issues) | Enter a detailed description for the issue being created or updated. | |||
Environment | Same (Update Issues) | Enter the hardware and software environment details related to the issue (if applicable). | |||
Notes |
| Enter additional notes you may want to add with the post function. |
Detailed fields
Configurations within this section help direct where new issues or subtasks are created or updated, who they are assigned, and other important details associated with the issue and subtask creation.
Field | Create Issue | Create Subtask | Update Issues (Available) | Default | Description |
|---|---|---|---|---|---|
Projects | Original project | Lists all the available projects. Select one or more projects from the list to create issue(s) in the specified project(s) or start typing in the field to select a project from the respective auto-suggestions. Alternatively, you can enter substitution variables by switching to the Set value mode. The other issue field values displayed in the form are dependent on this selection. For example, when one project is selected, Issue type displays only the respective issue types. When multiple projects are selected, it displays all issue types from all the projects in the instance. | |||
Entry Parent | Parent issue key | Lists all the available issues in the instance. Select one or more issues to create subtask(s) in the specified issue(s) or start typing in the field to select an issue from the respective auto-suggestions. Alternatively, you can enter substitution variables by switching to the Set value mode. If you do not find the intended issue key(s) in the auto-suggestions list associated with this field, you can:
You can also use any substitution variable that returns issue key value such as %jql_result_1%, etc., to define issue keys. | |||
Issues to update | Original key | Start typing in the field to view the respective list of auto-suggestions. From this list, select one or more issues to be updated with the configuration provided. You can also set values using substitution variables by switching to the Set value mode. If you do not find the intended issue key(s) in the auto-suggestions list associated with this field, you can:
You can also use any substitution variable that returns issue key value such as %jql_result_1%, etc., to define issue keys. | |||
Issue type |
| The issue types listed here are dependent on how the Project field is set.
Select a value from the list to set the issue type of the issue being created or updated. Alternatively, you can add substitution variables by switching to the Set value mode. The issue types are categorized under: A. CLASSIC ISSUE TYPES: Most of the issue types in classic projects are common across projects. They are displayed as is. B. NEXT-GEN ISSUE TYPES: You may see one or more issue types repeated multiple times in the list. To differentiate these issue types and select one that suits your requirement, you see the project key in the brackets next to each issue type. Refer to the following image: You also have:
| |||
Transition |
| Enter transition name or ID. During transition, only fields available on the transition screen are updated. The original issue being transitioned can not be a part of another transition. Refer to Transition Issues. | |||
Priority |
| Lists all the available priorities. Select a priority from the list or start typing in the field to select a value from the respective auto-suggestions to set the priority of the issue being created or updated over other issues. Alternatively, you can set values using substitution variables by switching to the Set value mode. Notice that the existing list displays the Parent's priority and original priority options, which can also be set using substitution variables. | |||
Components |
| Set components to which the issue being created or updated is related to. Start typing in the field to view the respective list of auto-suggestions. Select a component from the list. Alternatively, you can set values using substitution variables by switching to the Set value mode. | |||
Affected versions | Same (Update Issues) | Set the project version to which the issue being created or updated is a part of. You can set a value by selecting a value from the existing list or using substitution variables by switching to the Set value mode. Notice that the values like Parent issue's affected versions and Parent issue's fixed versions are present in the list for you to select from or can be set using substitution variables. | |||
Fixed versions | Same (Update Issues) | Set the project version in which the issue being created or updated is being fixed. You can set a value by selecting a value from the existing list or using substitution variables by switching to the Set value mode. Notice that the values like Parent issue's fixed versions and Parent issue's fixed versions are present in the list for you to select from or can be set using substitution variables. | |||
Security level |
| Set permissions that determine which users, groups, or project roles have access to the issue being created or updated. You can set security level by selecting a value from the existing list or using substitution variables by switching to the Set value mode. Notice that the values like Parent issue's security level and Original issue's security level are present in the list for you to select from or can be set using substitution variables. | |||
Labels | Same (Update Issues) | Lists all the available labels. You can either select from the list available to set values for the issue being created or updated or start typing in the field to select a value from the respective auto-suggestions. Alternatively, you can set values using substitution variables by switching to the Set value mode. Notice that the values like Parent issue's label and Original issue's label are present in the list for you to select from or can be set using substitution variables. | |||
People | |||||
Reporter |
| Set the user whom you want to be the creator of the issue being created or updated. You can select a user from the list available or start typing in the field to select a value from the respective auto-suggestions. Alternatively, you can set values using substitution variables by switching to the Set value mode. Notice that the following values are present in the list for you to select from or can be set using substitution variables:
| |||
Assignee |
| Set the user to whom you want to assign the issue being created or updated. You can select a user from the list available or start typing in the field to select a value from the respective auto-suggestions. Alternatively, you can set values using substitution variables by switching to the Set value mode. Notice that the following values are present in the list for you to select from or can be set using substitution variables:
| |||
Watchers | Same (Update Issues) | Add one or more users as watchers to the issue being created or updated. You can select user(s) from the list available or start typing in the field to select the user from the respective auto-suggestions. Notice that the values like Original issue's watchers and Parent issue watcher are present in the list for you to select from or can be set using substitution variables. | |||
Dates | |||||
Due date | Same (Update Issues) | Set a due date by which you want the issue being created or updated complete. Enter a specific date in the field or select from the list available. Alternatively, you can set values using substitution variables by switching to the Set value mode. dd/MMM/yy is the only valid date format to be used when you enter a specific date. For example, 29/Mar/20. | |||
Original Estimate | Same (Update Issues) | Set the original estimate, which is the amount of time required to resolve the issue being created or updated. Enter a value in the field in a valid format. For example, 2w 1d 6h 30m or 7d 2h 40m.
| |||
Remaining estimate | Same (Update Issues) | Set remaining estimate, which is the current estimate of remaining amount of time required to resolve the issue being created or updated. Enter a value in the field in a valid format. For example, 1w 3d 10h 30m.
| |||
Links
Configurations within this section help create and copy links and link types.
Field | Create Issue | Create Subtask | Update Issues (Available) | Default | Description |
|---|---|---|---|---|---|
Create links | |||||
Issue(s) |
| Add one or more issue keys to link to the issue being created or updated to the specified issues. Start typing in the field to select one or more issues from the respective auto-suggestions. Alternatively, you can set values using substitution variables by switching to the Set value mode. If you do not find the intended issue key(s) in the auto-suggestions list associated with this field, you can:
You can also use any substitution variable that returns issue key value such as %jql_result_1%, etc., to define issue keys.
| |||
Link type |
| Lists all the link types. Select the link type of the issue links added in the Issue(s) field from the available list or set a value using substitution variables by switching to the Set value mode. | |||
Link direction |
| Select a value for the link direction from the available list or start typing in the field to select a value from the respective list of auto-suggestions. This specifies if the link associated is inwards (target to source) or outwards (source to target). | |||
Copy links | |||||
Issue(s) |
| Add one or more issue keys to copy the respective issue links to the issue being created or updated. Start typing in the field to select one or more issues from the respective auto-suggestions. Alternatively, you can set values using substitution variables by switching to the Set value mode. By default, all link types are copied from each issue key specified. To copy links of specific link types, select the required link type from the Link types field. If you do not find the intended issue key(s) in the auto-suggestions list associated with this field, you can:
| |||
Need support? Create a request with our support team.
