The Omni Group
These forums are now read-only. Please visit our new forums to participate in discussion. A new account will be required to post in the new forums. For more info on the switch, see this post. Thank you!

Go Back   The Omni Group Forums > OmniFocus > OmniFocus 1 for Mac
FAQ Members List Calendar Search Today's Posts Mark Forums Read

 
Draft FAQ: OF 1.8 Filter options and their search-language equivalents Thread Tools Search this Thread Display Modes
This is a rough first draft, and corrections would be very welcome - (there probably do need to be some, so pinch of salt still required :-)

Draft FAQ: OF 1.8 Filter options and their search language equivalents:

Showing the option label used in the GUI (spaces removed) and (if different) the corresponding filter identifier in the OF 1.8 Applescript suite.

I hope that this may be helpful, and possibly shed some additional light on exactly what each filter does/means.

[Once there seems to be consensus that these search language equivalents are more or less correct, I will add this list to the default abbreviations file in the Where in OF script for OF 1.8]

PlanningMode:Sidebar

[Remaining-projects]->((status is active) or (status is on hold) and ((effectively hidden of its folder is false) or (its folder is missing value)))
[Active-projects]->((status is active) and ((effectively hidden of its folder is false) or (its folder is missing value)))
[Stalled-projects]->((number of tasks is number of completed tasks) and (status is active) and (singleton action holder is false) and ((effectively hidden of its folder is false) or (its folder is missing value)))
[Pending-projects]->((singleton action holder is false) and (status is active) and (start date > now) and ((effectively hidden of its folder is false) or (its folder is missing value)))
[OnHold-projects]|[on-hold-projects]->((status is on hold) and ((effectively hidden of its folder is false) or (its folder is missing value)))
[Dropped-projects]->((status is dropped) or (effectively hidden of its folder is true))
[Completed-projects]->(status is done)

PlanningMode|ContextMode:Status

[Remaining]|[incomplete]->(completed is false)
[NextAction]|[next]->(next is true)
Available: tasks which are neither waiting their turn in a sequential project, nor already completed, nor deferred by a future start date (either of their own or inherited from a project or Single Action list), nor out of action because their project or context is on hold or dropped.
[Available]->(blocked is false) and (completed is false) and ((start date is missing value) or (start date < now)) and ((its containing project is missing value) or (status of its containing project is active) and ((start date of its containing project < now) or (start date of its containing project is missing value))) and ((its context is missing value) or ((allows next action of its context is true) and (hidden of its context is false)))
[Completed]|[complete]->(completed is true)

PlanningMode|ContextMode:Flagged

[Flagged]->(flagged is true)
[Unflagged]->(flagged is false)

PlanningMode|ContextMode:Duration

[5min]|[5m]->(estimated minutes <= 5)
[15min]|[15m]->(estimated minutes <= 15)
[30min]|[30m]->(estimated minutes <= 30)
[1hour]|[60m]->(estimated minutes <= 60)
[>1hour]|[long]->(estimated minutes > 60)
[Unestimated]->(estimated minutes is missing value)

ContextMode:Sidebar

[Remaining-Contexts]|[available-contexts]->(effectively hidden is false)
[Active-Contexts]->(remaining task count > 0)
[Stalled-Contexts]|[inactive-contexts]->(remaining task count is 0)
[OnHold-Contexts]|[on-hold-contexts]->(status is on hold)
[Dropped-Contexts]|[unavailable-contexts]->(effectively hidden is true)


ContextMode:Due (within Flagged menu)
The value of 'soon' below depends on the setting in OF Preferences > Data > "Due Soon" is in the next N days. Code defining 'soon' is given in the next post in this thread.

[DueSoon]|[due]->(due date ≤ soon)
[DueOrFlagged]|[due-or-flagged]->((due date ≤ soon) or (flagged is true))
[DueAndFlagged]|[due-and-flagged]->((due date ≤ soon) and (flagged is true))

--

Last edited by RobTrew; 2012-07-17 at 07:22 AM.. Reason: adjusted definition of Pending to use '> now' rather than '>= tomorrow'
 
I have amended the search language definitions which refer to 'soon' in the FAQ above.

Whereas they previously used the expression:
today + <num> * days
they now simply use the variable name:
soon
Which can be defined in Applescript with code like:
Code:
tell application id "com.omnigroup.omnifocus"
	tell default document
		set soon to (current date) + ((value of setting id "DueSoonInterval") as integer)
	end tell
end tell
[I have also added the keyword 'soon' to the search language recognized by my Where in OF script. The expression 'today + <num> * days' can also be used in Where in OF searches and shortcuts, and is resolved by a dialog asking the user to enter a number for <num>]

(Note that 'soon' is the current moment + N * 24 hours, which I understand to be the calculation used by OF, whereas the 'today' in today + <num> * days uses a base time of "00:00" this morning, rather than the time of the search.)

Last edited by RobTrew; 2012-07-17 at 07:22 AM..
 
Updated the definition of [Available] tasks.
(Above)

The help file's comment on the Availability filter is that Available actions are:
"things you can actually do, because they aren’t blocked by earlier actions in a sequential project"
but the fuller picture is more like:
tasks which are neither waiting their turn in a sequential project, nor already completed, nor deferred by a future start date (either of their own or inherited from a project or Single Action list), nor out of action because their project or context is on hold or dropped.

--

Last edited by RobTrew; 2010-09-15 at 11:56 PM.. Reason: glossed 'Available' in English
 
 


Thread Tools Search this Thread
Search this Thread:

Advanced Search
Display Modes


Similar Threads
Thread Thread Starter Forum Replies Last Post
Date Parsing: Natural Language, Relative Date Options xmas OmniFocus 1 for Mac 107 2012-10-10 06:15 AM
Request for Feature: Preference option for Search / Filter field JasonAsbahr OmniFocus 1 for Mac 0 2012-08-01 02:26 PM
No search filter? pjb OmniFocus for iPad 1 2012-04-22 01:39 PM
A search language translation of the drop-down filter settings ? RobTrew OmniFocus 1 for Mac 0 2010-08-11 02:11 PM
Changing language or spelling options RonA OmniGraffle Extras 1 2009-12-04 07:09 AM


All times are GMT -8. The time now is 04:39 PM.


Powered by vBulletin® Version 3.8.7
Copyright ©2000 - 2024, vBulletin Solutions, Inc.