Incident management
Introduction
A ticket is a digital representation of registered incident. Incident management is the process of finding problems in street lighting or equipment. Created once, a ticket can be handled by responsible user, or transferred to another user or organization.
An organization is a legal entity participating in the street lighting service delivery. It could be a City Major Office, Project management Team, Service provider, hardware vendor, etc. Each organization could have many users. One of the organization’s user shall be appointed as ticket recipient (mediator).
Ticket Streams
All tickets are pre-filtered:
- My: active tickets assigned to the signed in user.
- Organization: active tickets assigned to the users from organization to which logged in user belongs.
- All Active: all active tickets without filtering by users or organizations.
- Archive: all closed tickets without filtering by users or organizations.

Table columns are different in streams.
Ticket Properties
| Name | Description | Comment |
|---|---|---|
| ID | Unique ticket number. Automatically increasing. | Automatically generated |
| Title | A short description of the incident. | Mandatory |
| Message | A full description of the incident. Does not require in the most cases. | Optional |
| Related Object | Street lighting object which is related to the incident: cabinet or mounting. | If object is not clearly known, use Unknown and add |
| Owner user | A user who has created ticket. | Only the owner can CLOSE ticket. The value assigned implicitly using information of logged in user. |
| Owner organization | An organization to which owner user belongs | The value assigned implicitly. |
| Current user | A user who holds the ticket at the moment | A current user is responsible to find the roots of the incident and fix it. |
| Current organization | An organization to which current user belongs | |
| Priority | Low, Normal, High | A value assigned by default is stored in configuration defaultTicketPriority |
| State | One of the supported ticket states: New, In progress, Canceled, Done. | All newly created tickets get state New. |
Ticket could be open or closed:
- Open - all operations are allowed in accordance to the action limitations
- Closed - incident successfully resolved or canceled.
Only a user who has created ticket can close it. Closing ticket does not change ticket final state.
Incident Management Flow
The basic incident management flow includes:
- Register incident: create new ticket
- Report: a ticket is in progress
- Report: a ticket is fixed
- Close incident: close the ticket
Alternative process flow could include:
- Transfer ticket to another user or organization, if it is found that it’s responsibility of other organization.
- Delete ticket (if it’s duplicated or mistaken)
- Specify object cabinet or mounting if it was not known before.
Commenting ticket always allowed at any step of incident’s life cycle.
Register incident: create new ticket
-
Choose menu item Control->Tickets in the main menu.

-
The last selected ticket stream is shown. Click green button Add New located on right of the tool bar.

-
The modal window with required ticket attributes is shown. Enter value at least to mandatory values marked with (*).

3.1. Choose short, sustainable ticket’s title. The title will be visible in the ticket streams.
3.2. If an object (cabinet or mounting) is known, choose object type from the combobox and object in the suggestion box.3.3. Long text explaining an issue if necessary.
3.4. By default, Regular priority is assigned. Change it if necessary.
3.5. Select organization and organization’s user who be appointed to resolve issue.There are two configuration parameters setting an organization and user are default issue resolver.
3.6. Click Assign to me, to quickly initialize attributes Organization and User by your data.
3.7. Press button Save. Ticket created. If checkbox Go to details was set user forwards to the ticket page.
-
A ticket created. The ticket appears in the streams:
- All Tickets - visible to everyone
- My - visible to assigned user only
- Organization - visible to all users from organization who is employer of assigned user.
Report: a ticket is in progress
- Choose a ticket in the stream. Click to the link in columns ID or Title.

1.1. Change the ticket state to In progress. It will show to everyone, that work is started
1.2. Reassign the ticket to another organization, if the incident shall be resolved by another organization.
The user will be changed automatically too. Will be choosen user who plays mediator role of the organization.
1.3. Reassign the ticket to another user of your organization.
A triangle shows that the ticket assigned to the current user.
1.4. Put comments to any ticket, even if it’s not assigned to you currently.
1.5. Return the ticket to the onwer, if you don’t understand or you could not reproduce it.
-
The work on incident is considered as started by chaning tiket state to In progress.
If the ticket is reassigned to another user inside the same organization, the another user shall change state to In progress.
Report: a ticket is fixed
-
Activity list holds all changes
-
Add comment explaining incident resolution details.
-
Change ticket state to Done.

-
Click button Return to Owner. Confirm operation. The page will look like following:

Incident Could not be Resolved
- Add explanation why incident cound not be resolved.
- Change ticket state to Canceled.
- Click button Return to Owner. Confirm operation.
Close incident: close the ticket
The ticket can be closed only by ticket owner. The owner looks ticket like following:

- Comment, Edit or Delete ticket if it’s required.
- Click button Close to close the ticket.
Ticket Action Limitations
In accordance to the current user who holds the ticket, the list of actions are limited.
| Action | Owner | Current User | Colleague | User of Another Org |
|---|---|---|---|---|
| Comment | Yes | Yes | Yes | Yes |
| Change State | Yes | |||
| Assign to User | Yes | Yes | ||
| Change Org | Yes | Yes | ||
| Change Owner | Yes | |||
| Change Owner Org | Yes | |||
| Delete | Yes | |||
| Edit | Yes | |||
| Return to Owner | Yes* | |||
| Change Priority | Yes | Yes |
* - if current user is not an onwer
Alternative ways of registring incident
- The button in the header of the application:

-
Cabinet page

-
Mounting page

Feedback
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.