Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Page Contents
Table of Contents | ||
---|---|---|
|
Live Search spaceKey ZenGRCOnboardingGuide additional none placeholder Search our site type page
Overview
Functionalities of using Jira ServiceNow to manage ZenGRC audits, tasks and requests include the following:
- An audit can be connected to any Jira ServiceNow project within the connected Jira ServiceNow instance.
- The audit and imported requests are automatically created in Jira ServiceNow and linked together.
- All audit and request updates are transferred in real time between Jira ServiceNow and ZenGRC.
- ZenGRC tasks can be linked to any Jira ServiceNow issue.
- Assignees to a request do not need to exist in ZenGRC. As long as they are Jira ServiceNow users, they can be assigned to a request.
- For users in the linked Jira ServiceNow project, ZenGRC seamlessly opens the application for direct access.
Tip | ||
---|---|---|
| ||
There are several areas where users can access Jira ServiceNow from ZenGRC. However, that access requires you to also have a Jira ServiceNow user account. Jira ServiceNow will display an error message stating that you do not have access. |
Note | ||
---|---|---|
| ||
This page only details the additional functionality of Jira ServiceNow audits, tasks and requests. For full instructions, please see Audits in ZenGRC. |
Accessing
JiraServiceNow from an Audit
The majority of information for a Jira ServiceNow audit can be directly accessed and updated within ZenGRC. However, there may be times when you want to open JiraServiceNow.
The quickest way to open an audit in Jira ServiceNow is directly from the Audits page prior to accessing the individual audit. To do this, complete the following steps:
- Click Audits in the left-hand navigation.
- Scroll to desired audit.
- Click Open in JiraServiceNow.
If the individual audit summary page is already open from the Audits home page, access Jira ServiceNow by completing the following:
- Click Actions | Open in JiraServiceNow.
To open Jira ServiceNow and export information, complete the following:
- Click Actions | Export from JiraServiceNow.
Working with Requests
Tip | ||
---|---|---|
| ||
Requests in a Jira ServiceNow audit can only be assigned to users in the connected Jira ServiceNow instance. The assignees need to add evidence and complete the request within JiraServiceNow. |
Once requests are imported into a JiraServiceNow-connected audit in ZenGRC, they are also created in JiraServiceNow. Updates in Jira ServiceNow are reflected in ZenGRC requests and vice versa.
Info | ||
---|---|---|
| ||
Jira ServiceNow audit requests do not display in the System of Record | Requests or in the To-Do List. The requests can only be viewed in bulk within the individual Jira ServiceNow audit. |
Editing a
JiraServiceNow Request
Requests imported into Jira ServiceNow audits can be edited in both ZenGRC and JiraServiceNow. But in ZenGRC, the only way to access them is through Audits.
To open and edit a request, complete the following steps:
- Click Audits and open the desired Jira ServiceNow audit.
- Click Requests (in JIRAServiceNow).
- Find the request and click View.
- On the resulting page, only two fields can be edited.
- Click the dropdown arrow beside Status to make another selection.
- Start typing in the Comments text field to prompt an Add button.
- Click Edit to open a page where the majority of fields can be edited while remaining in the ZenGRC application.
Click Open in JiraServiceNow to open Jira ServiceNow in a new browser tab or window.
Tip title TIP Jira ServiceNow only opens for users who have a Jira ServiceNow profile.
Linking a ZenGRC Task to
JiraServiceNow
A task must already exist in ZenGRC prior to linking to JiraServiceNow. However, a new Jira ServiceNow issue can be created directly from a ZenGRC task and saved in the selected Jira ServiceNow project.
Info | ||
---|---|---|
| ||
At this time, there is no way to review all Jira ServiceNow issues that are linked to ZenGRC tasks. The Jira ServiceNow issues can only be accessed from individual ZenGRC tasks. |
Connecting to an Existing
JiraServiceNow Item
To connect a task to an existing Jira ServiceNow item, complete the following steps:
- Create or open a task.
- Click the ellipses in the top right (if your browser is maximized, an Actions button replaces the ellipses) and select Link to JiraServiceNow.
In the dialog box, enter a search term and click Search.
Tip title TIP The Search box does not auto populate, so you will need to know a word in the Jira ServiceNow Key or Summary fields in order to search for your issue.
- Select an option from the results.
Click Save. The page refreshes to display information from the Jira ServiceNow issue.
Tip title TIP These Jira ServiceNow fields can only be edited in JiraServiceNow.
Linking a ZenGRC Task to a New
Jira ItemServiceNow Item
To create a new Jira ServiceNow item and connect it to a task, complete the following steps:
- Create or open a task.
- Click the ellipses in the top right (an Actions button replaces the ellipses if your browser is maximized) and select Create new Jira ServiceNow issue.
In the Project dropdown, select an option.
Tip title TIP The Project dropdown displays projects in the connected Jira ServiceNow instance. This then populates the Issue dropdown with selections from the chosen Jira ServiceNow project.
- Select an option in the Issue dropdown and click Create new. Alternatively, click Back to cancel and return to the prior page.
A new dialog box displays with fields to complete that are dependent on the selected Jira ServiceNow project setup.
Note title IMPORTANT Since user information cannot be transferred from Jira ServiceNow to ZenGRC, clicking within the Assignee and Reporter dropdown boxes won't prompt a name dropdown. These fields either expect email addresses associated with the Jira ServiceNow accounts or Jira ServiceNow user names following the @.
For example, the below screenshot is from Jira ServiceNow and displays a list of users.
- Only the person's email address (not shown) or the information outlined in red (without the @) is accepted in the ZenGRC fields. ("Eddy" or "Eddy Editor" will prompt errors, but "michael+editor" or "michael+editor@reciprocitylabs.com" won't.)
- The user must be in JiraServiceNow, but does not have to be in ZenGRC.
- Only one user can be assigned per field.
These are not a mandatory fields, so a workaround is to create the issue without assigning names. Then, log into Jira ServiceNow and assign users.
Editing a
JiraServiceNow Issue Linked in a ZenGRC Task
To access a Jira ServiceNow issue from a ZenGRC task, complete the following steps:
- Open the task.
- Click the link under Jira ServiceNow issue key.
Unlinking or Replacing a Linked Item
Only one Jira ServiceNow item can be linked within a task.
To remove the link between a task and a Jira ServiceNow item, complete the following steps:
- Open the task.
- Click the ellipses in the top right (an Actions button replaces the ellipses if your browser is maximized) and select Unlink Jira ServiceNow issue.
- In the dialog box, click Unlink. Alternatively, click Cancel to close without changes.
To replace the link between a task and a Jira ServiceNow item with a different Jira ServiceNow item, complete the following steps:
- Open the task.
- Click the ellipses in the top right (an Actions button replaces the ellipses if your browser is maximized) and select Replace Jira ServiceNow issue.
- The dialog box displays allowing you to search or create a new Jira ServiceNow issue.
Include Page | ||||
---|---|---|---|---|
|