Where can I find a more comprehensive guide to using Smart Values?

Question

I am at my wit's end with trying to figure out the structure and use of Smart Values. Does someone know of a guide or reference book that serves this purpose?

A simple example of my problem with this is using worklogAuthor in a JQL search but knowing I need to change that to {{worklog.Author}} to get that value back out of the search results.

My list of attempts to utilize what is published in the Atlassian documentation in a rule that ultimately fails due to issues like this would be a novel in itself.

Even with the help of experienced users like @Bill Sheboy this can be an arduous task.

Why is the Atlassian documentation so poor? I'm pretty certain that it never gets any updates to improve it and It always seems to me that no matter what I am looking for the example given to explain the use of the smart value is never what you are looking for and there is no way to know how to alter it for what you need.

To summarize, if someone can point to a resource I would appreciate it.

Rant over for now.

Danno · Answer

@Laurie Sciutti I did find something new in your additional links that might provide some more insight. Thank you for your continued help.

I've started searching for information outside of the Atlassian community as well. If I find the motherlode somewhere out there on the interwebs I will definitely post about it here. Keep watching. As you can see above @Marcus Jones posed an interesting thought on going down the AI route.

Danno · Answer

@Marcus Jones I'm not laughing. I was starting to consider using the internal Atlassian Beta AI tool. Thanks for pushing me in that direction.

I'm also of a mindset that I need to spend time digging into JSON which is what I think is being used for what I am trying to do.

I will reply here with my findings after playing around with it.

Marcus Jones · Answer

Ok so don't laugh at me when I say this but have you tried ChatGPT? It's hit or miss but I have been able to work through a few things by leveraging it and I know you're at your wits end. Here's an example response (I can't say whether all or some is accurate so take it with a grain of salt) How do I use the smart value worklogAuthor in jira service management JQL ChatGPT In Jira Service Management (formerly known as Jira Service Desk), the worklogAuthor field represents the author of worklogs for an issue. You can use this field in Jira Query Language (JQL) to search for issues based on the author of the worklogs associated with them. Here's how you can use the worklogAuthor field in JQL: * Basic Usage: To find issues based on the worklog author, you can use the following JQL query: makefileCopy code worklogAuthor = "username" Replace "username" with the actual username of the user whose worklogs you want to search for. This query will return all issues where the specified user has logged work. * Operators: You can use various operators with the worklogAuthor field to refine your JQL queries. Here are some examples: * =: Use the equals operator to find issues where the worklog author exactly matches the specified username. makefileCopy code worklogAuthor = "john.doe" * !=: Use the not equals operator to find issues where the worklog author is not the specified username. arduinoCopy code worklogAuthor != "jane.smith" * IN: Use the IN operator to find issues where the worklog author is one of multiple specified usernames. javaCopy code worklogAuthor IN ("alice", "bob", "charlie") * IS EMPTY and IS NOT EMPTY: You can use these operators to find issues where the worklog author field is either empty or not empty. * Functions: You can also use JQL functions to perform more advanced queries. For example: * worklogAuthor in membersOf("groupname"): This query will find issues where the worklog author is a member of the specified Jira group. * Combining with Other JQL Clauses: You can combine the worklogAuthor clause with other JQL clauses to further narrow down your search. For example, you can find issues assigned to a specific user where the worklog author is also that user: javaCopy code assignee = "john.doe" AND worklogAuthor = "john.doe" Remember to replace "username" with the actual username or group name you want to use in your query. Using the worklogAuthor field in JQL can help you track and manage issues based on who has worked on them, making it a useful tool for team collaboration and workload analysis.