Home | Appendix

|  |  | Predicate Editor

The Predicate editor allows you to create a set of criteria for matching items. When you create or edit a smart group or smart rule, this window is where you set criteria to match and for smart rules, what actions to take with any matched files. And while displayed in a sheet instead of a separate window, the Advanced search supports creating predicates in a similar way. Search Options When used with a smart item, the top section of the editor contains a mandatory name and search location, as well as a few optional items. Name: Enter a name for the smart item. Search in: Select the location you want this smart item to search. Exclude Subgroups: Enable this to ignore items in subgroups of the location selected in the Search in dropdown. Ignore Diacritics: Check this to treat letters with diacritics, e.g., umlauts or accented characters, the same as their regular counterparts. Fuzzy Word Comparison: Check this to apply fuzzy logic to contents-based criteria, ignoring simple typos so that instances of "hello" and "hallo" are both found. Highlight Occurrences: When used with contents-based matching, this will highlight the terms in the text of selected search results, if possible. Predicates The other section of the editor shows the search predicates. The predicates are built as a series of logical steps. At the top, define whether All (Boolean AND) or Any (Boolean OR) of the contained predicates need to be true for an item to be matched. If you need to create a more complex match, hold the ⌥ Option key and click a ... button to create a "compound predicate" also called "branch". Each branch also has its own All or Any option as well. This allows you to create very targeted searches. Criteria may be content- or attribute-related. These contain the attributes you want to match. For example, searching for a specific word in PDF documents added this week would require three criteria: `Content`, `Kind`, and `Date Added`. Each criterion is made up of three parts: the attribute to be evaluated, e.g., `Content` or `Date Modified`, an operator like `begins with`, and the value to be matched. When using text-based criteria, a placeholder will indicate if booleans and wildcards are supported. Use the + and - buttons to add more criteria to your smart group or to delete them. Add as many criteria as you need noting it's better to as specific as possible to avoid false positives. Criteria can be rearranged with drag-and-drop, if needed.
Example: To find all Microsoft Excel files use the condition Extension ... is ... xslx. To find items created in the last 7 days use the condition Date created ... is ... Last Week.
Placeholders are a powerful option in predicates, whether it's in a search, smart rule, or batch configuration. A placeholder can be used to get a document's item link, the year and month of the current date, or even the response from a Chat prompt. When the search, rule, or batch configuration runs, the placeholder is replaced dynamically. You can access placeholders in the context menu but at the right end of text fields for certain criteria in the predicate editor, you may see an ellipsis in a rectangle. This is the placeholder popup where you can browser and quickly choose the attributes you need.
Note: Full regular expressions are not supported in criteria.