DEVONagent Pro VERSION 3.11.1 DOCUMENTATION © 2001-2019 DEVONtechnologies TABLE OF CONTENTS Read Me 4 Menus 29 The DEVONagent Pro Advantage 5 The DEVONagent Pro menu 29 System Requirements 6 The File menu 30 Installing, Updating, Removing 6 The Edit menu 31 Trial Restrictions 6 The Data menu 32 Version history 7 The Sort menu 33 License Agreement 11 The View menu 33 Credits 11 The Web menu 34 The History menu 35 Getting Started 12 The Go menu 36 Why use DEVONagent Pro? 12 The Window menu 36 When to use DEVONagent Pro? 12 The Services menu 37 DEVONagent Pro at a Glance 13 The Scripts menu 37 First steps with DEVONagent Pro 13 The Help menu 37 The Dock menu 38 Common Tasks 14 Windows and panels 39 How to find on the Internet 14 How to search beyond Google 14 Search window 40 How to customize DEVONagent Pro 15 Web browser 46 How to set up a search set to crawl feeds 15 Archive window 52 How to run a search automatically 16 Search sets 54 How to archive search results 16 Plugins and scanners 54 Downloads 56 Queries 18 Preferences 57 Assistant 57 Operators 18 Designing a search query 19 Preferences 59 Search sets 21 General 59 Search 60 What are search sets? 21 Menu extra 61 Choosing a search set 21 Web 62 Creating and managing sets 22 Tabs 63 Sharing sets 23 Bookmarks 64 General tab 23 Email 64 Advanced tab 25 Update 65 Sites tab 25 Plugins tab 26 Menu extra 66 Actions tab 27 Scripts 67 Schedule tab 28 Introduction 67 DEVONagent Pro's Scripts menu 68 Automator 69 DEVONagent Pro 3.11.1 Documentation, page 2 Plugin Development 70 Creating Your Own Plugins 70 XML and JSON Keys 72 Troubleshooting 77 DEVONagent Pro behaves irrationally 77 Problems interacting with DEVONthink 77 FAQ 78 General questions 78 Release schedules, Mac OS X, and Windows 78 Purchasing 79 Mac App Store 80 Your software license 81 Product-related questions 81 Technology 82 General Concept 82 Features 82 Structure 82 Applications 83 Other Products 84 Overview 84 DEVONthink 84 DEVONagent 84 DEVONsphere 84 DEVONnote 85 Needful Things 85 Appendix 86 Glossary 86 FAQ (product-specific) 87 List of Search Sets 88 List of Plugins 88 List of Scanners 94 Log message codes 94 DEVONagent Pro 3.11.1 Documentation, page 3 READ ME In this chapter: Web Searching: Fed up with Web searches that return loads of useless links? Using advanced search The DEVONagent Pro Advantage 5 techniques, DEVONagent Pro takes on all those System Requirements 6 tedious search-and-review tasks, releasing you to Installing, Updating, Removing 6 concentrate on relevant results. Trial Restrictions 6 Version history 7 License Agreement 11 Credits 11 DEVONagent Pro 3.11.1 Documentation, page 4 THE DEVONAGENT PRO ADVANTAGE WHY DEVONAGENT PRO? WHAT DEVONAGENT PRO DOES FOR YOU Using advanced search techniques, DEVONagent Using both standard and specialized search Pro takes on all those tedious search-and-review engines, DEVONagent Pro intelligently tasks, releasing you to concentrate on relevant summarizes the results -- fast! results. It assists you in Alternatively, DEVONagent Pro shows you an even larger number of search results using its finding, unique graphical topic map. collecting, and DEVONagent Pro support your research while organizing browsing the Web, e.g., by listing all objects such information from the Web or your DEVONthink Pro as images, linked documents, or outgoing links Office databases with a powerful and flexible search embedded into a viewed page. architecture. It also features a powerful, research- DEVONagent Pro archives your search results oriented web browser and simple built-in archive, with a single click or sends them to your and tightly integrates with DEVONthink. DEVONthink database. Instead of making you repeat actions, DEVONagent Pro performs those actions for you. Combine search sets, schedule searches, etc., to create your very own personalized search assistant. DEVONagent Pro 3.11.1 Documentation, page 5 PERFECT INTEGRATION To update an existing version of DEVONagent Pro, simply copy the application package from the disk DEVONagent Pro integrates seamlessly with image to your Applications folder, replacing the old DEVONthink. With just one click, archive your version. Your database(s) will not be affected. search results, webpages, and other information grabbed from the Web to your DEVONthink If you would like to switch from the Mac App database. Store variant of DEVONagent Pro to one directly Select text in any application and use downloaded from the DEVONtechnologies website, DEVONagent Pro's Services menu or a you can do so at any time. The official version will contextual menu item to search for it. The Menu accept your Mac App Store receipt as a valid license. Extra keeps DEVONagent Pro at your fingertips. Copies not downloaded from the Mac App Store Use various actions, including notifications and also allow you to buy an upgrade to a higher edition AppleScript, to inform you of search results, or version (if available). then send them to either DEVONthink or the To remove DEVONagent Pro traces from your application of your choice to process them any computer, trash the following files and folders (~ way you wish. represents your home folder): Learn more about why you should use DEVONagent DEVONagent Pro Pro, when you should use it, and how to run your ~/Library/Application Support/DEVONagent Pro first query: See also p. 12ff ~/Library/Contextual Menu Items/DEVONagent Pro CM.plugin SYSTEM REQUIREMENTS ~/Library/Preferences/com.devon- technologies.agentexpress.* Every Mac running OS X Yosemite or later. In Depending on whether you have installed the addition, a fast Internet connection is highly following extras or not, remove them, too: recommended. The product-specific scripts in ~/Library/Scripts and ~/Library/Workflows INSTALLING, UPDATING, The contextual menu plugin in ~/Library/ REMOVING Contextual Menu Items/ The Dashboard widget Just move the DEVONagent Pro application package to the Applications folder or any other Note: Depending the version of OS X you are directory you have access to. Please note that OS using, some files may or may not be installed on X Services and the connection to DEVONthink your machine. work only for applications installed into one of the Applications folders, and that logout and login or a TRIAL RESTRICTIONS restart is required after installation. Unregistered DEVONagent Pro runs for 60 hours of non-continous runtime. Close the app to stop the clock from ticking and re-open later to continue your evaluation. The menu extra is restricted to 100 searches until DEVONagent Pro is registered. DEVONagent Pro 3.11.1 Documentation, page 6 VERSION HISTORY New Improved Fixed Removed VERSION 3.11.1 This maintenance release addresses a sporadic crash some users had when accessing the Preferences panel on macOS Mojave, as well as some visual artifacts in the interface. We have also added support for JSON RSS feeds and improved handling of RSS feeds in general. Overall reliability has been the primary focus of this release. Added support for JSON RSS feeds. Updated plugins: Government > USA.gov, References > SEC. Renamed the search option Atom, RSS, RSD & RDF feeds to Atom, RSS & JSON feeds. Improved handling of untitled RSS feed items. Improved overall performance and reliability. Fixed various visual artifacts including ones affecting tabs on search windows (macOS Mojave). Fixed an issue where opening the License panel could stall the application when a network connection was not available or reliable. Fixed an issue where an alert was not displayed after entering an incorrect license code. Fixed a crash and incomplete display of the window when accessing the Preferences panel (macOS Mojave). VERSION 3.11 This release features fixes, including greater compatibility with macOS Mojave, as well as other improvements. We have reorganized the search sets and updated a number of plugins as well as the thumbnail galleries scanner. A new option allows you to group search sets for more easily managing your sets. You can now choose to install and update extras automatically in the Support Assistant. A change to parsing a web page's rendered HTML allows for better See Also, translation, and automation via AppleScript. VoiceOver support in the interface has been enhanced too. You can now create search set groups in Windows > Search Sets. The action menu in the Search Sets panel now has New Group and New Set options. Search sets can now be installed via Help > Support Assistant. Added an option to the Support Assistant for installing and updating extras automatically. DEVONagent Pro 3.11.1 Documentation, page 7 Plugins updated: Qwant, Yandex, Blogs > Google Blog Search, News > BBC News, News > Google News, News > Topix, News > World News Network, Patents > Google Patents Search sets updated: Marketing, Mac > Latest News, and Mac > Latest Software. Scanners updated: Thumbnail Galleries. Renamed, merged, and reorganized the default search sets. Merged the Advanced and Exclude tabs of the Search Sets panel. Improved automatic selection of content of web pages after choosing Remember Selection from the contextual menu. The toolbar button Share > Email in a browser window uses the current website's title as the subject line. Improved adding URLs via drag-and-drop in the Downloads window and the Sites tab of a search set. Improved keyboard navigation in outline views of windows like Archive and Search Sets. Renamed Go > Workspace > Update... to Update. The last used workspace is now updated. Added tooltips to the buttons on the Downloads window. Tooltips in the menu extra results now update more quickly. Minor cosmetic adjustments made in Search windows and Properties inspector of browser windows. Improved VoiceOver support. Increased efficiency in handling of RSS feeds. Improved filtering and retrieval of links, especially in Express mode.