Tuleap Query Language (TQL)

The Tuleap Query Language is a pseudo-language to search items in the platform. As of today only artifacts in trackers can be searched.

• TQL in tracker reports
  • Queries
  • Query construction
  • Pro tips
  • Date operators
• TQL in Cross-Tracker Search
  • The widget
  • Default mode
  • Expert mode

Limitations

TQL in Tracker reports does not have the same features as TQL in Cross-Tracker Search. There are also two “modes” in Cross-Tracker search TQL: Expert mode is the most complete and supports additional syntax (see below).

Feature	TQL in tracker reports	TQL in Cross-Tracker search “Default mode”	TQL in Cross-Tracker search “Expert mode”
Conditions on @comments	✔️	❌	❌
Conditions on file fields	✔️	❌	❌
Conditions on @assigned_to	❌	✔️	✔️
Conditions on @description	❌	✔️	✔️
Conditions on @status	❌	✔️	✔️
Conditions on @title	❌	✔️	✔️
Conditions on @id	❌	✔️	✔️
Conditions on @submitted_on	❌	✔️	✔️
Conditions on @submitted_by	❌	✔️	✔️
Conditions on @last_update_date	❌	✔️	✔️
Conditions on @last_update_by	❌	✔️	✔️
SELECT	❌	❌	✔️
FROM	❌	❌	✔️
ORDER BY	❌	❌	✔️