I have a two dimensional filter statistics gadget with Priority on the X axis and Sprint on the Y axis. It works fine until I try to drill down on any of the numbers displayed. I get:
The operator '=' is not supported by the 'Sprint' field.
It seems the gadget isn't constructing the correct JQL for the drill down. Is this a bug or am I doing something wrong?
Thanks for the response. This is a Company Managed project. The JQL in the filter used by the gadget is:
project = GOLD AND issuetype in (Bug, Story) AND status in ("Status 1", "Status 2", "Status 3") AND labels = Prod_impact order by created DESC
The JQL generated by the drill down in the gadget is:
project = GOLD AND issuetype in (Bug, Story) AND status in ("Status 1", "Status 2", "Status 3") AND labels = Prod_impact AND Sprint = 784 AND priority = High
(The latter is what was generated by clicking on the number in the cell corresponding to a certain sprint and the "High" priority.)
Hm, that is very odd since the 'equals' operator is most definitely supported for the built-in Sprint field.
Do you happen to have more than one custom field named Sprint? Jira does allow for the creation of multiple custom fields with identical names. I'm wondering if the click-through filter might be picking up an alternate custom field also named Sprint.
I think you're onto something. When I enter raw JQL, autocomplete for Sprint shows two options: "cf" and "Sprint[short text]". The '=' operator works for cf but not for Sprint[short text].
That said, in project settings under issues->fields it only lists one Sprint field.
Any suggestions on how I can clean this up?
I would recommend changing the name of the second Sprint (short text) field to something else, or if it is not used in any projects, then delete it.
If the field is associated to screens and projects, renaming it could break filters (and potentially boards) that may be relying on it. Exercise due diligence to find out the origin and usage of the field before changing its name.
And have a chat with all the people who have Jira Administration access to educate them on best practices for creating custom fields, which includes not duplicating the name of an existing field.
Let me see if I understand. By experimenting, I found the custom field (cf) works with the '=' operator and the (apparently) standard field (Sprint (short text)) does not. So you're recommending to change the name or delete the standard field? Am I able to do that? If so, how? By the way, the custom field type is listed as "Jira Sprint field".
I'm having a hard time interpreting the Jira documentation relative to all this. It lists the Sprint standard field as a Number type, not Short text or Jira Sprint field. And it also seems to say standard fields can't be renamed. But I'm not always clear if the documentation I'm looking at is for the right version of Jira.
Yes, I am recommending that you change the name of the "Sprint (short text)" field, or delete it entirely if it is not used by any screens. You can do that through the Custom Fields screen (from the gear icon select Issues, then Custom Fields should become available in the navigation pane).
What documentation are you viewing?
This is the correct documentation for managing Custom Fields in Jira Cloud.
Can you provide a screen image from the Custom Fields screen for the results of searching for a field named "Sprint"? For example, this is what I see in my instance:
If somebody added a second custom field named sprint and defined it as a Text field it might look like this.
You can rename custom fields that you have manually added to your system by clicking the ... to the far right
... and selecting Edit Details.
The built-in Sprint field is a special custom field added by the Jira Software product. If you had only the Jira Core/Work Management project you would not see that built-in Sprint field. Jira will not allow you to change the name of that field.
The actual data stored in the field is a list of 0..n numbers. Sprints have a "name", but that is not required to be unique, so they also have a system-wide unique numeric ID. It is the ID numbers that actually gets stored in the field.
The "=" operator does not work for a text field, but it does work for a list field because the list field is storing the unique IDs of the list items rather than the text of the list items.
Here's what my Custom Fields screen shows:
If I understand correctly, you confirmed my suspicion that the "built-in" Sprint field is actually a custom field (probably cf in my case). Presumably that would be what's showing up in the Custom Fields screen, and I don't see a second one. That's what's confusing me.
In a previous response you said:
"By experimenting, I found the custom field (cf) works with the '=' operator and the (apparently) standard field (Sprint (short text)) does not."
How did you find the "Sprint (short text)" field originally? Were you typing "sprint" into the Advanced Issue Search JQL field?
A possible explanation for not seeing "Sprint (short text)" in the Custom Fields screen would be if it is a Custom Field that was added to a Team Managed project. Custom Fields added to Team Managed projects don't show up in the Custom Fields screen because custom fields for Team Managed projects can't be shared with other projects.
In that case it would be necessary to look through the Team Managed projects to try to find the one where that field was created and is in use, and rename it there.
Regarding the custom field ID you are seeing, you can confirm if that is the ID for the "Sprint [LOCKED]" field in the Custom Fields scree. In the Custom Fields screen for the row where you see "Sprint LOCKED" if you click the ... button to the far right and then hover over one of the options revealed there, then in the preview of that option's URL you will see the ID number associated with that custom field and you can confirm if 10003 is the number associated with that field.
I found the names of the two sprint fields in auto-complete while typing JQL into the advanced filter box.
Your recent response sounded really promising. But to add to the confusion, the one Sprint field I can see under custom fields has an ID of 10750, not 10003. And I checked all the team-managed projects, and the few that use Sprint are using the built-in one (it says "Jira created this field, you can't edit its name" when I hover over it).
The custom field IDs can vary - Jira allocates the numbers for all sorts of things as it needs them. So you can get very different ones depending on what the history of your system is.
Imagine my first Jira system - it was installed before we had Greenhopper, let alone Agile or Jira Software. When the people who inherited it from me installed the Agile application, it created the new Sprint field with a number higher than all the other custom fields we had created over the years. It gave them something like your 10750.
The last Jira Software I fired up got 10003 as the sprint field's id, because it was completely new, and 10003 is the next free number in a new system.
TLDR: the numbers are not that important. The bit that matters is the howling bug in Jira that lets you create fields with duplicate names. The best fix for your problem is to rename the non-system Sprint field to something else so you can identify it as not actually being the sprint. A simple change will do - change the name to "sprint" or "sprint." to make it distinct, and then go talk to the people using it about how you can get rid of it and get everyone to use the system Sprint field as intended.
Another place you may find a custom field named Sprint is in the Custom Fields Trash. However, when that is the only place that I have an extra sprint field, it does not come up in the JQL field in Advanced Search.
I'm a bit stumped now about where else to look for that short text Sprint field. When looking at the Team Managed projects, did you look at all the issue types and also look in the Previously Created Fields section? If the custom field was created in a Team Managed project but is not currently associated with any issues it will still show up in the autocomplete in the Search screen.
Scratch the bit about the custom field having an ID of 10750...I was on the wrong field. It's actually 10003 which matches what I see in the autocomplete in the Advanced Search.
But for the life of me, I can't find the "other" (short text) sprint field. I looked in trash and archived projects (there aren't any), in the custom fields trash (none), and in all the team-managed projects, including Previously Created Fields. There are two team-managed projects that use Sprint and they both are the standard built-in one. I can't delete or rename a field I can't find.
Is there a way in the team-managed projects that I can find the ID of the fields it's using, just to make sure? I couldn't find any. See this screenshot to see what I'm using to verify it's the standard sprint field:
I got the custom field ID for the Sprint[short text] field when I tried to use it in and ORDER BY clause. In my case I had already named the field "Sprint1" when I created it.
The last idea I have to try to figure out where that Sprint[short text] field is coming from is to do a search for all issues, order the output by that field, and include the field in the output columns for List view. If the field has a value set anywhere (in any issue you have permissions to see) then you should see it in the output. That will tell you if it was used in a Team project or a Company project.
If it is a Company project then it must be defined in the Jira Administration > Issues > Custom Fields list. In that case you could use the URL for editing a custom field to access it by plugging in the field ID
If it is in a Team Managed project, hopefully the value will be set for at least one issue and that will help you identify the Team project containing the field.
OK, thanks for your suggestion...I was able to formulate a query that exposed the offender. It's a project of type "Product Discovery". When I go into "Change settings" it asks me to accept Early Access terms, and I see it's a beta product. So a big part of the mystery is solved.
The documentation that I found shows a way to delete a field but the option doesn't show up for me. Further investigation confirms I don't have project administration permissions for this project. I'll explore that avenue.
I'll consider this issue resolved based on this. Thanks so much for the help.
FYI that Jira Product Discovery projects are essentially fancy team-managed projects with better filtering and visualizations. A target usage is often portfolio management. The product is in beta and it is unclear when it switches to a paid-product from Atlassian.
The admin of that project may have added the field to support something in their reporting, so check with them to collaborate on changes to the field. And...as this tool is based around team-managed projects, that may also be related to why it has problems with dashboard gadgets.
Hello Atlassian Community! Feedback from customers like you has helped us shape and improve Jira Software. As Head of Product, Jira Software, I wanted to take this opportunity to share an update on...