Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Operators suggested by field type

An operator in PQL is one or more symbols or words that compare the value of a field on its left with one or more values on its right so that only true results are retrieved by the clause.  And a Projectrak field is a field that has already been defined in Projectrak. You can search for projects by a Projectrak field value which can be one of six different types, each with supported operators. 

Here, you can find a list of the operators that you can use in advanced serch: 


Common operator

Text operator

Numeric operator

Items operator

Field type

=

!=

IS

IS NOT

~

!~

>

>=

<

<=

IN

NOT IN

Function text





(tick)

(tick)







Text (Single and Multiple line)



(tick)

(tick)

(tick)

(tick)







Project Description



(tick)

(tick)

(tick)

(tick)







Project URL



(tick)

(tick)

(tick)

(tick)







Project key

(tick)

(tick)



(tick)

(tick)





(tick)

(tick)

Project name

(tick)

(tick)



(tick)

(tick)





(tick)

(tick)

Date

(tick)

(tick)

(tick)

(tick)



(tick)

(tick)

(tick)

(tick)



Number

(tick)

(tick)

(tick)

(tick)



(tick)

(tick)

(tick)

(tick)



Duration

(tick)

(tick)

(tick)

(tick)



(tick)

(tick)

(tick)

(tick)



Status

(tick)

(tick)

(tick)

(tick)







(tick)

(tick)

Priority

(tick)

(tick)

(tick)

(tick)







(tick)

(tick)

List (Single and Multiple choices)

(tick)

(tick)

(tick)

(tick)







(tick)

(tick)

User (Single and Multiple choices)

(tick)

(tick)

(tick)

(tick)







(tick)

(tick)

Group (Single and Multiple choices)

(tick)

(tick)

(tick)

(tick)







(tick)

(tick)

Project (Single and Multiple choices)

(tick)

(tick)

(tick)

(tick)







(tick)

(tick)

Project category

(tick)

(tick)

(tick)

(tick)







(tick)

(tick)

Project type

(tick)

(tick)









(tick)

(tick)

Project lead

(tick)

(tick)









(tick)

(tick)

Keywords suggested by autocomplete

A keyword in PQL is a word or phrase that does (or is) any of the following:

  • Joins two or more clauses together to form a complex PQL query

  • Alters the logic of one or more clauses

  • Alters the logic of operators

  • Has an explicit definition in a PQL query

  • Performs a specific function that alters the results of a PQL query

Keep in mind Projectrak's reserved words

reserved word is a word that cannot be used as a value in our PQLs, such as the name of a system field or an operator. These words are "reserved from use". These might show errors in your PQL when you choose to filter through them. 

To avoid these errors, and in case you have a value that is the same as a reserved word, you can write that value between double quotation marks.

Here is a list of Projectrak' reserved words:

System Fields:
key, lead, type, category, description, name, assignee, url
pf[x] ('x' being a number)

Connectors:
and, or, order, by, asc, desc.

Operators:
not in, in, is, is not, =, !=, >=, <=, >, <, ~, !~.

Other characters to keep in mind:
Parenthesis "(", ")", and comas ",". 

List of keywords

AND

Used to combine multiple clauses, allowing you to refine your search.

Note: You can use parentheses to control the order in which clauses are executed.

Example

Find all projects where the value of Category is marketing and IT Systems:

category = marketing AND ( Country ~ Spain OR Continent ~ Europe )

OR

Used to combine multiple clauses, allowing you to expand your search.

Notes: 

  • You can use parentheses to control the order in which clauses are executed.

  • Also see IN, which can be a more convenient way to search for multiple values of a field.

Examples

Find all projects where the value of Category is marketing or IT Systems:

category = business OR ( Country ~ Italy OR Continent ~ Europe )

EMPTY

This keyword is used to be able to show the Project fields that have empty values. 

Notes:

  • You can only use this keyword with the IS or IS NOT operator. 

Example

Find all the projects where "Project Status" is empty and use Bulk Operations in order to populate those empty fields with the status that starts the project's process.