This document outlines Best Practices in using Integration X Jira system for issue tracking.
Integration X’s Jira is a tool to facilitate communication around issues relating to ADPOINT and PLANPOINT systems.
Our customers have access to Jira to track issues that are relevant to their system. These can be individual issues that apply to our customers specific installation or issues that are general to all ADPOINT and PLANPOINT systems.
Issues in Jira are used to manage all communications in relation to configuration- and development tasks requested through a project specification, change request or development agreement.
Support cases do not belong in Jira |
As mentioned, Jira is intended for issue tracking. Support cases are handled according to the above. Please note that general user documentation for Integration X solutions is available here:
https://integration-x.atlassian.net/wiki/spaces/UD
Jira keeps track of all details needed to describe and solve a ticket.
But more correctly, tickets are called Issues in Jira.
From the moment an issue is created it gets a status to reflect its current stage. When something happens, the status updates to reflect the latest action.
The stages reflected by the status spans from “Open” to “Closed”. Any stage in between is where the action takes place. For an overview of statuses, please see the explanation of statuses below.
Issues are assigned to one or more agents depending on their nature. Agents (Assignees), reporter (the user that created the issue) and participants (one of more observers) receives email updates (may be suppressed) whenever a ticket changes status.
Jira users can access filtered dashboards to track issue progress.
URL: https://integration-x.atlassian.net
Username: Enter the username assigned to you or your team.
Password: Enter the corresponding password.
By default, the opening screen will be a dashboard showing all open issues, issues that require input and issues that have recently been updated.
Issues can be opened simply by clicking on the issue key or the summary. The ··· menu to the right of the issue may also have other options relevant to the current status of the issue
To quickly find an Issue, use the search box in the upper right-hand corner of the screen.
Here, simply type the Issue number (you do not need to enter preceding letters). If you don’t know the Issue number, just write a key-word from the Issue. A list of found Issues will be displayed.
It is also possible to use filters to find Issues. There are some default filters in Jira and you can create your own.
From the Filters menu, select one of the recent filters or try the Advanced issue search to set up complex filters. Filters can be saved for later use.
To create a new issue click the button in the top menu.
Unless otherwise agreed, all information should be entered in English. |
The following field description cover all fields, regardless of where they appear in Jira.
Field name | Description | |
|---|---|---|
Project | Select the product to which you want the Issue to apply:
| |
Issue type | Select the type that is closest to the purpose of the Issue:
| |
Status | By default this should be set to Open when creating a new Issue | |
Components | Not used | |
Priority | Indicate the priority of the Issue. Blocker Work with appl. or production cannot run.
| |
IX Prio | Integration X’s internal priority. | |
Summary | Write a summary of the Issue. Please make it short, descriptive and distinguishable from other issues.
| |
Description | Enter a detailed description of the issue here. Please be as precise as possible and consider adding references to examples that can be tracked by the Integration X support teams.
| |
| Creates the current issue. |
Some fields may not be available or have different appearance or different selectable options according to individual agreement. |
Most of these fields cannot be edited. They are merely available for information and filtering purposes.
Field name | Description |
|---|---|
Assignee | The Integration X agent(s) assigned to the Issue. |
Group share | The group that can view and edit the Issue. |
Labels | Integration X may from time to time add new labels in order to tag individual Issues to create virtual groups. |
Time tracking | A summary of the time spend on an Issue - typically used for Issue that are billable. |
Due date | The date for which a solution is expected to be available. |
When an issue is being worked on, it is possible to add comments. Comments are similar to the Description field in terms of options for formatting, adding attachments etc. When a comment is entered, it can be modified only by the user who entered it.
Comments are visible to the user who created it, to any other user in the same group (group share) and to members of the Integration X staff.
Comments are by default listed in chronological order.
Below find an explanation of the most important statuses.
Status | Next action expected by | Description |
|---|---|---|
Open |
| The Issue is open for modifications. |
In progress | The Issue is being worked on. | |
Resolved | The Issue is resolved, but not closed. It will be closed by Integration X. | |
Reopened |
| The Issue was resolved, but reopened by Integration X. |
Awaiting approval | The issue is awaiting approval by the customer. | |
Closed | - | The Issue is closed. Not further changes can be made. |
Approved | The solution to the Issue is approved by customer. | |
Pending | The Issue is pending - likely waiting for more information or internal review. | |
Rejected | The Issue is rejected by Integration X. A work-around is typically indicated. | |
Awaiting customer input | The Issue is waiting for the customer to provide input. | |
Customer input provided | The customer has provided input. Now waiting on Integration X to continue. |
As an Issue appears in a certain status, there will be actions to progress. These actions vary depending on the actual status.
To change the status, click the Status button and select one of the options available.