# Tickets

A ticket is a kind of task that cannot be scheduled in a unitary manner.

This is usually a short-lived activity for a single ticket that gives feedback to the issuer or to keep track of the result.

Tickets management screen

It can be globally planned as a general activity, but not unitarily.

For instance, bugs should be managed through tickets :

- You can not plan bugs before they are registered.
- You must be able to give a feedback on each bug.
- You can (or at least should) globally plan bug fixing activity.

Tickets (simple)

- This screen is a limited version of screen “Tickets”.
- It’s dedicated to users who want to create and follow their own tickets without be involved in their treatment.
- When fields and features are available, the description is similar.

Restrict the entry of real work in the ticket

- Possibility to define that only the responsible of ticket can enter real work.
- This behavior can be set in Global parameters screen.

Due dates

- Initial and planned due date allows to define a target date for solving the ticket.

> Initial due date

> - If a definition of ticket delay exists for giving ticket type and urgency the date is automatically calculated with this delay.
> - Delays for tickets screen allows to define ticket delay.

> Planned due date

> - Is used to define a target date after evaluation.
> - Automatically initialized to the initial due date.

> Monitoring indicator

> - Possibility to define indicators to follow the respect of dates values.
> `Respect of initial due date/time`
> `Respect of planned due date/time`

Note

Initial due date of the ticket set as read only if it is calculated from the setting of “delays for tickets”

Product, component and versions fields

- Allows to identify the product and component relating to the issue.
- Identifies from which versions, the issue occurs and to which versions a resolution will be applied.

Responsible of product

A responsible can be defined for a product or component.

If a product or component is selected, the responsible defined can be automatically assigned to the ticket.

Note

Ticket responsible from product responsible

This parameter, in Global parameters, allows to define, if the defined responsible is automatically assigned to the ticket.

See: Global Parameters

Section Description

Required fields
Field | Description
--- | ---
Id | Unique Id for the ticket.
Name | Short description of the ticket.
Ticket type | Type of ticket.
Project | The project concerned by the ticket.
External reference | External reference of the ticket.
Urgency | Urgency for treatment of the ticket, as requested by the issuer.
Requestor | Contact at the origin of the ticket.
Origin | Element which is the origin of the ticket.
Duplicate ticket | Link to another ticket, to link duplicate tickets.
Context | List of 3 items describing the context of the ticket.
Product | The product for which this ticket has been identified.
Component | The component for which this ticket has been identified.
Original product version | Product versions for which the issue has been identified.
Original comp. version | Component versions for which the issue has been identified.
Description | Complete description of the ticket.

Field Context

- Contexts are initialized for IT Projects as “Environment”, “OS” and “Browser”.
- This can be easily changed values in Contexts screen.

Product or component

- List of values contains the products and components linked the selected project.

Fields: Original product version & Original comp. version

- The list of values will be filtered depends on the selected value in fields “Product and component”.
- Click on to add a other version, see Multi-version selection.

Section Treatment

Required fields
Field | Description
--- | ---
Planning activity | Activity where global work for this kind of ticket is planned.
Status | Actual status of the ticket.
Resolution | Ticket resolution.
Responsible | Resource who is responsible for the ticket.
Criticality | Importance of impact on the system, as determined after analysis.
Priority | Priority of treatment.
Initial due date | Initial target date for solving the ticket.
Planned due date | Actual target date for solving the ticket.
Estimated work | Estimated workload needed to treat the ticket.
Real work | Real workload spent to treat the ticket.
Left work | Left workload needed to finish the ticket.
Handled | Box checked indicates the ticket is taken over.
Done | Box checked indicates the ticket has been treated.
Solved | Box checked indicates the ticket has been solved.
Closed | Box checked indicates the ticket is archived.
Cancelled | Box checked indicates the ticket is cancelled.
Target product version | Product versions for which a resolution of issue will be delivered.
Target comp. version | Component versions for which a resolution of issue will be delivered.
Result | Complete description of the resolution of the ticket.

Priority

- Automatically calculated from Urgency and Criticality values. See: Priority value calculation.
- Can be changed manually.

Notion of regression can be added.

Left work

- Automatically calculated as Estimated – Real.
- Set to zero when ticket is done.

Target product version & Target comp. version

- The list of values will be filtered depends on the selected value in fields “Product and component”.
- Click on to add a other version, see Multi-version selection.

Field Solved

- The box is automatically checked or unchecked, according to the resolution selected.

Button Start/End work

- The start Work / Stop Work button is a clock on / off timer.
- If the logged in user is a resource, he or she has the option to start working on the ticket.
- Click the “Start work” button to start timing the processing time on the ticket.
- The start time is then displayed under the button and the button changes name.

- Once the work is done, press the “stop work” button.
- The spend time will automatically be converted as real work.
- It’ll be transferred on planning activity if it is set.
- A decrease in “left work” on activity will be carried out.

Important

Closing the application or starting work on another ticket will automatically stop the current ongoing work.

Button Dispatch

This button allows to dispatch ticket.

- Click on to add a line.

Button Show periods

You can calculate the time spent between the start of processing, which corresponds to the receipt of the ticket and the end of processing of a ticket, that is to say when it goes to the done state, with the possibility of subtracting waiting periods thanks to the “paused” state macro.

The passages from an active macro-state to a non-active macro-state (paused or done), are recorded thanks to the start and end dates of each period. This table is updated automatically with calculation of the duration in working hours and the duration in calendar hours when the end date of the period is entered.

Status period

## Planning activity

Planning activity field allows to link the ticket with a planning activity.

If the global parameter limit Planning Activity to those with flag is set to yes then:

- You must check the “Planning activity” box on the activity to be linked.
- It will then be visible in the planning activities list of your ticket.
- Work on the ticket will be included in this activity.
- After saving the option, new fields are displayed.
- You can see the number of tickets linked to this activity and time information corresponding to all of these tickets.

New fields displayed after saving the Planning activity option

- Click on to open a popup which will display the details of these tickets.

List of tickets linked to the activity

Real work

Put the real work from tickets to the resource timesheet.

- When a resource has entered the real work on the ticket and the ticket is linked to a planning activity.
- The resource is automatically assigned to this activity.
- Real work set on tickets is automatically set in resource timesheet.

Imputations real work on related tickets.

- The tickets are very dependent on the planning activity.
- The time indicated by the resources will be decremented to that planned for the activity.

## Multi-version selection

In the version fields, it’s possible to set several versions.

Main and other version

- The version with smaller id will appear in the select list and is considered as the main version.
- Other versions are listed above.
- It is possible to set an ‘other’ version as the main version using the button .

- Click on to add a other version.
- Click on to delete a version.

## Priority value calculation

Priority value is automatically calculated from Urgency and Criticality values.

Priority, Urgency and Criticality values are defined in lists of values screens. See: Priorities, Urgencies and Criticalities screens.

In the previous screens, a name of value is set with numeric value.

Priority numeric value is determined by a simple equation as follows:

Equation

- [Priority value] = [Urgency value] X [Criticality value] / 2
- For example:
  - Blocking (4) X Critical (8) / 2 = Critical priority (16)for [Priority value]

Default values

- Default values are determined.
- You can change its values while respecting the equation defined above.

## Receive tickets from emails

ProjeQtOr offers to save tickets from e-mail directly in the application.

Receive email from ticket screen

Description section

This section allows you to enter the parameters of your mailbox.

Required field
Field | Description
--- | ---
Id | Unique Id for the ticket.
Name | Short description of the ticket.
Project | name of the project to which the ticket is attached.
IMAP host | Name of your IMAP host.
IMAP User | Mail of the IMAP user.
IMAP Password | IMAP user account password entered.

You can create a new mailbox for tickets on each project and for each type of ticket configured in ProjeQtOr.

> IMAP Host

> The address must be an IMAP connection string.

> Example to connect to the GMAIL input area, the host must be

> {imap.gmail.com:143}INBOX

> No protocol is required

> security constraints

> - Mails from any source (may lead to spam Allow you to receive emails from anyone and therefore can cause spam

> - Only mails from known users Can only receive emails saved in your ProjeQtOr application

> - Only mails from known users allocated to the project Only allows you to receive emails saved in your ProjeQtOr application and which are assigned to the project selected in the settings of your mailbox

> - Include attachments Indicates whether or not you allow your users to attach attachments.

> - allow up to maximum weight allowed for receiving emails.

>   Warning

>   maximum weight

>   There is no weight limit in ProjeQtOr but probably your mail server.

>   Most of the time emails are blocked beyond 5 to 10 MB

Description treatment

Required fields
Field | Description
--- | ---
Ticket type | Type of ticket for which emails will be sent.
Responsible | Name of the person who will work on the default ticket.
Planning activity | Name of the planning activity on which the tickets will be decremented. The parent activity must belong to the same project.
Limit of tickets / hour | Maximum number of emails per hour allowed.
Last input date | Date of last ticket received
Last input ticket | Display the name of the last ticket received
Total input tickets | Total number of the tickets since the mailbox creation

Warning

Cron must be launched for tickets to be processed in ProjeQtOr. If you do not receive a ticket, try to stop the cron so that it can restart with a refresh of the code.

Some fields can be decisive for the reception of your emails.

> limit of tickets / hour

> - This limit allows you to restrict the reception of emails by hour.

>   If the number of tickets received is much higher than your limitation then the probability of spam is to be considered or you have incorrectly evaluated the number of tickets to be processed.

> - When the maximum number of tickets is reached then the mailbox freezes

>   Only manual intervention by the administrator can unlock it

>   Its role will consist in reassessing the number of tickets to allow their receipt

> - If the maximum number of tickets per hour has been reached then you have a rejection message on the history line: rejected ticket: ticket limit per hour

History of ticket created

You can choose the number of tickets to display in the history by filling in the “history to display” field

Required fields
Field | Description
--- | ---
Email adresse | address of the ticket sender
Date | date of receipt of the ticket
Result | Indicates whether the ticket has been processed or rejected