Home | Appendix

|  |  | Smart Rule Events and Actions

Smart rules in DEVONthink provide many powerful actions and events that can trigger these actions. Below is a list of the available options for both. Events When an action is triggered is almost as important as the action itself. Actions can be triggered when any of these events occur: On Demand: Run only when Apply Rule is selected in a contextual menu or Tools > Apply Rules. On Startup: Runs when DEVONthink launches. Before Synchronization: Runs all actions before DEVONthink begins synchronizing to any sync location. After Synchronization: Runs all actions after DEVONthink completes synchronizing to any sync location, i.e. all uploads, downloads, and changes are committed. On Quit: Runs when DEVONthink quits. Hourly/Daily/Weekly: Runs on an hourly, daily, or weekly schedule. On Workdays: Runs on Monday through Fridays. On Weekends: Runs on Saturday or Sunday. On Creation: Runs when a new document is created in the specified location. To trigger actions when taking notes or screen captures with the Sorter, choose Via Sorter. On Save: Runs when any matching document is saved. On Import: Runs when documents are added to the specified location. On Clipping: Runs when documents are added via clipping, e.g., via menu commands, the Sorter, DEVONagent, bookmarklets, or AppleScript. On Download: Runs when items are downloaded via DEVONthink's Download Manager. On Scan: Runs after a scanning operation has completed. On OCR: Runs after an OCR operation has completed. On News: Runs when an RSS feed refreshes and receives new articles. SERVER On Upload: Runs when an item is uploaded through DEVONthink's web server. On Open: Runs when a matching item is opened in a new document window or viewed in a main window. On Open Externally: Runs when a matching file is opened in an external application. On Launch URL: Runs when the URL associated with the item is launched. On Reminder: Runs when an alarm set on a matching item's Reminder comes due. On Renaming: Runs after matched items are manually renamed. On Moving: Runs when matched items are moved to the specified location. On Classifying: Runs when matching items are classified by DEVONthink. On Moving into Database: Runs when indexed items are moved into the database, becoming imported items. On Moving to External Folder: Runs when imported or created items in a database are moved to external locations, becoming indexed items. Actions The power in smart rules is the actions. DEVONthink provides actions that cover simple tasks, e.g., prefixing a filename, all the way to ultra-powerful AppleScript injection via external or embedded scripts. Since you can chain multiple actions together, the possibilities are nearly endless. Here's a list of available actions: Bounce Dock Icon: Causes DEVONthink's dock icon to bounce. This will only trigger when DEVONthink isn't the active application. Display Notification: Shows a message via the Mac's Notification Center. Notifications need to be enabled in System Preferences > Notifications for Display Notification to operate correctly. Display Alert: Shows a message in an alert window. Speak Text: Using your computer's voice synthesis, it will speak the message you specify. Play Sound: Plays a selected system alert sound. Send Mail: Enter email addresses to send the matching items. This can be a comma-delimited list of addresses, names, or enter the name of a group you've defined in your contacts. Add to Reading List: Add the matched items to the Reading List. Open Externally: Open the matched file in the system default application. Launch URL: Open the URL associated shown in the Info Inspector & URL. Execute Script: Execute External or Embedded scripts. Embedded scripts are created in a popup menu and only available to the smart rule they are created in. Read more... Change Name/Aliases/Comment/Label/Rating: Change the specific attribute of the matched file. For items with an existing attribute, e.g., a comment, a placeholder will preserve the existing value. Mark: Toggle the state of read/unread, flagged/unflagged, and locked/unlocked. Note you change more than one of these attributes with one action, but you can chain more than one Mark action in the smart rule. Change Creation/Modification Date: Change the creation or modification date of matched files to: current, addition, creation, modification, or the document date. Add Tags: Add tags to the matched files. As you type, tags from all open databases will be suggested. Press the comma key to commit the tag. Remove Tags: Removes specific tags you enter. Remove All Tags: Removes all tags from the items. Move/Replicate/Duplicate: Move, replicate, or duplicate a matched file to a chosen location. Duplicate & Continue: Duplicates matched files and applies subsequent actions to the copies. File: Allows you to file items into a group. Specify subgroups using a forward slash, e.g., `2019/DEVONtech` would create or file into the DEVONtech subgroup of a 2019 group in the current group. You can use placeholders to define the location. Classify: Using our AI, this will attempt to move any matched files to an apropos location. Failures to classify files are noted in the Log window. Move Into Database: Moves indexed items into the database, essentially importing them. Note this removes the file from the original location in the filesystem. Move To External Folder: For an item located in an indexed group, this moves the file to the indexed folder in the Finder. Convert: Attempts to convert files into plain/rich text, formatted notes, Markdown, HTML, web archive, or PDF. Convert & Continue: Converts files and applies subsequent actions to the copies. Imprint: Apply the selected imprint to any matching files, if possible. PRO OCR: This will perform OCR on a file, if possible. Choose a format to generate a new file in the selected file type. Note the file type selected will override the option set in Preferences > OCR > Convert incoming scans to. Choose Apply to convert a matched file directly to a PDF with OCR. This action does not generate new files. Custom Metadata: If you have specified custom metadata fields, you will have options to change values with an action. For example, if you had a Boolean field named "Done", you could have the action set this field to true when the action is triggered. Move to Trash: Move the item to the database's trash. The items are not removed from the database until the trash is emptied. Delete: Be very cautious with this option. Delete truly deletes a file. It is not sent to the database's trash. It is not sent to the Finder's trash. It is completely deleted.