Using X-Priority Headers

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

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

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

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

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

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