Using X-Priority Headers
- Kyle McEwan
What is an X-Priority?
The X-Priority is used to indicate the importance of a message. Microsoft supports 5 X-Priority levels https://docs.microsoft.com/en-us/openspecs/exchange_server_protocols/ms-oxcmail/2bb19f1b-b35e-4966-b1cb-1afd044e83ab with 1 being the highest and 5 the lowest.
When enabled through Profile > Issue > Use Mail X-Priority Priority, JEMH will map this to an actual Priority defined in the Project Priority Scheme.
How JEMH works with X-Priority header
Since 3.3.111 & 4.0.4
Starting in the above versions, JEMH will make use of the priorities set on a per project basis through a Priority Scheme. As the number of Project Priorities can be any number, the 5 X-Priorities map into the set of available Jira priorities. We have ensured that an X-Priority value of 1 always maps to the highest Jira priority and 5 always maps to the lowest Jira priority. Values 2-4 will spread between the highest and lowest priority depending on how many there are. If the value supplied has been deliberately set above 1-5, it will be tested for an exact match on a Jira priority ID, non-matches are treated as lowest priority.
How X-Priority values map to Jira priorities
The tables below show how X-Priority values map to project priorities. The selected index indicates the target priority from the available project priorities (1 = first/highest).
X-Priority = 1
Project Priorities | Selected Index |
|---|---|
1 | 1 |
2 | 1 |
3 | 1 |
4 | 1 |
5 | 1 |
6 | 1 |
7 | 1 |
8 | 1 |
9 | 1 |
10 | 1 |
X-Priority = 2
Project Priorities | Selected Index |
|---|---|
1 | 1 |
2 | 1 |
3 | 1 |
4 | 1 |
5 | 2 |
6 | 2 |
7 | 2 |
8 | 2 |
9 | 2 |
10 | 3 |
X-Priority = 3
Project Priorities | Selected Index |
|---|---|
1 | 1 |
2 | 2 |
3 | 2 |
4 | 3 |
5 | 3 |
6 | 4 |
7 | 5 |
8 | 5 |
9 | 6 |
10 | 6 |
X-Priority = 4
Project Priorities | Selected Index |
|---|---|
1 | 1 |
2 | 2 |
3 | 3 |
4 | 4 |
5 | 4 |
6 | 5 |
7 | 6 |
8 | 7 |
9 | 8 |
10 | 8 |
X-Priority = 5
Number of Priorities | Chosen Priority | Result Priority |
|---|---|---|
1 | 5 | 1 |
2 | 5 | 2 |
3 | 5 | 3 |
4 | 5 | 4 |
5 | 5 | 5 |
6 | 5 | 6 |
7 | 5 | 7 |
8 | 5 | 8 |
9 | 5 | 9 |
10 | 5 | 10 |