What is a 'Screen Scheme'?A Screen Scheme allows you to choose which Screen will be shown to a JIRA user when they perform a particular issue operation. There are three issue operations for which you can choose a Screen:
You can specify the same screen for each of these issue operations, or choose different screens for each operation.
|
Configuring a Screen Scheme
Associating a Screen with an Issue Operation
- Log in as a user with the 'JIRA Administrators' global permission.
- Select 'Administration' > 'Issues' > 'Screens' > 'Screen Schemes'.
Keyboard shortcut: 'g' + 'g' + type 'sc' - The 'View Screen Schemes' page will be displayed:
Screenshot 1: the 'View Screen Schemes' page

- Locate the Screen Scheme in which you are interested, and click the 'Configure' link next to it. The 'Configure Screen Scheme' page will be displayed:
Screenshot 2: the 'View Screen Schemes' page

- The 'Add Issue Operation to Screen Association' is located at the bottom of the 'Configure Screen Scheme' page.
- Select the Issue Operation with which you wish to associate a Screen.
- Select the desired Screen.
Note:
- There can only be one association for an issue operation per Screen Scheme. If all operations have been associated with a Screen, use the 'Edit' link next to each operation to change the Screen it is associated with.
- If an issue operation does not have a specific mapping to a Screen, the screen that is associated with the Default entry will be used for that operation. The Default entry cannot be deleted from a Screen Scheme. You can click the "Edit" link next to the Default entry to change the Screen that is associated with it.
- The 'View Issue' operation only allows you to control the layout of custom fields in the middle of the 'View Issue' page. The 'View Issue' page ignores all the non-custom fields on the Screen.
Editing an Association
- Log in as a user with the 'JIRA Administrators' global permission.
- Select 'Administration' > 'Issues' > 'Screens' > 'Screen Schemes'.
- The 'View Screen Schemes' page will be displayed (see above).
- Locate the Screen Scheme in which you are interested, and click the 'Configure*' link next to it. The 'Configure Screen Scheme' page will be displayed (see above).
- On the 'Configure Screen Scheme' page, click the 'Edit' link next to the issue operation you wish to edit. The 'Edit Screen Scheme Item' page will be displayed:
Screenshot 3: the 'Edit Screen Scheme Item' page

- Select the desired screen and click 'Update'.
Deleting an Association
- Log in as a user with the 'JIRA Administrators' global permission.
- Select 'Administration' > 'Issues' > 'Screens' > 'Screen Schemes'.
- The 'View Screen Schemes' page will be displayed (see above).
- Locate the Screen Scheme in which you are interested, and click the 'Configure*' link next to it. The 'Configure Screen Scheme' page will be displayed (see above).
- On the 'Configure Screen Scheme' page, click the 'Delete' link next to the issue operation you wish to remove.
Adding a Screen Scheme
Depending on your requirements, you may want to create multiple Screen Schemes, and associate them with different projects/issue types.
To create a new screen scheme,
- Select 'Administration' > 'Issues' > 'Screens' > 'Screen Schemes'.
Keyboard shortcut: 'g' + 'g' + type 'sc' - The 'View Screen Schemes' page will be displayed (see above).
- The 'Add Screen Scheme' form is located at the bottom of the 'View Screen Schemes' page. Enter the name of the new field screen and select a default screen. The default screen will be used for issue operations that do not have a screen associated with them.
Editing a Screen Scheme's details
To change a screen scheme's name, description or default screen,
- Select 'Administration' > 'Issues' > 'Screens' > 'Screen Schemes'.
- The 'View Screen Schemes' page will be displayed (see above). Click the 'Edit' link next to the desired Screen Scheme.
- You will now be directed to the 'Edit Screen Scheme' page where you can edit the Screen Scheme's name and description and the Screen that is associated with the Default Entry of the scheme.
Screenshot 4: the 'Edit Screen Scheme' page

Deleting a Screen Scheme
Note that Screen Schemes that are associated with an Issue Type Screen Scheme cannot be deleted. You will first need to edit the Issue Type Screen Scheme and remove the Screen Scheme.
To delete a screen scheme,
- Select 'Administration' > 'Issues' > 'Screens' > 'Screen Schemes'.
- The 'View Screen Schemes' page will be displayed (see above). Click the 'Delete' link next to the desired Screen Scheme. You will be prompted to confirm your deletion.
Screenshot 5: the 'Delete Screen Scheme' page

Copying a Screen Scheme
- Select 'Administration' > 'Issues' > 'Screens' > 'Screen Schemes'.
- The 'View Screen Schemes' page will be displayed (see above). Click the 'Copy' link next to the Screen Scheme you wish to copy
- You will now be directed to the 'Copy Screen Scheme' page. Enter the name and description of the new Screen Scheme and click the 'Copy' button.
Screenshot 6: the 'Copy Screen Scheme' page

Activating a Screen Scheme
To activate a Screen Scheme, you need to associate it with one or more projects and issue types, using Issue Type Screen Schemes. To activate a Screen Scheme,
- configure an Issue Type Screen Scheme to use the Screen Scheme; then
- associate the Issue Type Screen Scheme with a project.
For details of both procedures, see 'Associating screens with Issue Types'.