DEVONagent Pro VERSION 3.2 DOCUMENTATION © 2001-2012 DEVONtechnologies TABLE OF CONTENTS Read Me 4 Menus 24 The DEVONagent Pro Advantage 5 The DEVONagent Pro menu 24 Highlights of Version 3.0 6 The File menu 25 System Requirements 6 The Edit menu 26 Installing, Updating, Removing 6 The Data menu 26 Trial Restrictions 7 The Sort menu 27 The View menu 28 Getting Started 8 The Web menu 28 Why use DEVONagent Pro? 8 The History menu 29 When to use DEVONagent Pro? 8 The Go menu 29 First steps with DEVONagent Pro 8 The Window menu 30 The Services menu 31 Common Tasks 10 The Scripts menu 31 The Help menu 31 How to find on the Internet 10 The Dock menu 32 How to search beyond Google 10 The contextual menu extension 32 How to customize DEVONagent Pro 11 How to set up a search set to crawl feeds 11 Windows and panels 33 How to run a search automatically 12 How to archive search results 13 Search window 34 Web browser 39 Queries 14 Archive window 44 Search sets 46 Operators 14 Plugins and scanners 46 Designing a search query 15 Downloads 48 Search sets 17 Preferences 49 Assistant 49 What are search sets? 17 Preferences 51 Choosing a search set 17 Creating and managing sets 18 General 51 Sharing sets 19 Search 52 General tab 19 Menu extra 53 Advanced tab 20 Web 54 Sites tab 21 Tabs 55 Plugins tab 22 Bookmarks 55 Actions tab 22 Email 56 Schedule tab 23 Update 56 Widgets & menu extra 58 Menu extra 58 DEVONagent Pro widget 58 DEVONagent Pro 3.2 Documentation, page 2 Scripts 59 Appendix 81 Introduction 59 Glossary 81 DEVONagent Pro's Scripts menu 60 FAQ (product-specific) 82 Automator 61 List of Search Sets 82 List of Plugins 83 Plugin Development 62 List of Scanners 88 Creating Your Own Plugins 62 Log message codes 88 XML Keys 64 Version history 89 License Agreement 94 Troubleshooting 68 Credits 94 DEVONagent Pro behaves irrationally 68 Problems interacting with DEVONthink 68 FAQ 69 General questions 69 Release schedules, Mac OS X, and Windows 69 Purchasing 70 Mac App Store 71 Your software license 71 Product-related questions 72 Technology 73 General Concept 73 Features 73 Structure 73 Applications 74 Other Products 75 At a Glance 75 DEVONthink 75 DEVONthink To Go 76 DEVONagent Pro 76 DEVONagent Express 77 DEVONagent Lite 78 DEVONnote 78 Needful Things 79 DEVONagent Pro 3.2 Documentation, page 3 READ ME In this chapter: Web Searching: Fed up with just a load of links? Using advanced search techniques, DEVONagent The DEVONagent Pro Advantage 5 Pro takes on all those tedious search-and-review Highlights of Version 3.0 6 tasks releasing you to focus valuable time on System Requirements 6 relevant results. Installing, Updating, Removing 6 Trial Restrictions 7 DEVONagent Pro 3.2 Documentation, page 4 THE DEVONAGENT PRO ADVANTAGE WHY DEVONAGENT PRO? as images, linked documents, or outgoing links embedded into a viewed page. Using advanced search techniques, DEVONagent DEVONagent Pro archives your search results Pro takes on all those tedious search-and-review with a single click or sends them to e.g. your tasks releasing you to focus valuable time on DEVONthink database. relevant results. It assists you in Instead of letting you repeat actions, DEVONagent finding, Pro performs them for you. Combine search sets, collecting, and schedule searches, etc. to create your very own organizing personalized search assistant. information from the Web or your DEVONthink Pro Office databases with a powerful and flexible search PERFECT INTEGRATION architecture, has a powerful, research-oriented DEVONagent Pro integrates seamlessly with web browser and simple built-in archive, and tightly DEVONthink. With just one click, archive integrates with DEVONthink. your search results, webpages, etc. to your DEVONthink database. WHAT DEVONAGENT PRO DOES FOR YOU Select text in any application and use Using both standard and specialized search DEVONagent Pro's Services menu or contextual engines, DEVONagent Pro intelligently menu item (Mac OS X 10.5 only) to search for it. summarizes the results — fast! The Dashboard widget keeps DEVONagent Pro Alternatively, DEVONagent Pro shows you an at your fingertips. even larger number of search results using its Use various actions including Growl and unique graphical topic map. AppleScript to inform you of search results, DEVONagent Pro support your research while then send them to either DEVONthink or the browsing the Web, e.g. by listing all objects such DEVONagent Pro 3.2 Documentation, page 5 application of your choice to process them in any See Also drawer lists also archived results as well way you wish. as documents from DEVONthink Pro and related webpages. Learn more about why you should use DEVONagent Improved Archive and Download Manager. Pro, when you should use it, and how to run your first query: See also p. 8ff Reworked user interface. Improved performance, responsiveness, compatibility, and reliability. HIGHLIGHTS OF VERSION 3.0 Improved interoperability with third-party applications and DEVONthink. DEVONagent Pro 3.0 comes with a reworked user Support for Mac OS X 10.6 and OS X 10.7, e.g interface, better browsing capabilities, new and the extended Services menu and the Dock icon updated plugins, and is based on a new technology badge. foundation. Here's just a short list of what's new in Much extended export capabilities. DEVONagent Pro 3.0 compared to earlier versions: Growl support. Better search results, summaries, digests, ranking. 64 bit support. Support for wildcards, more natural phrase Welcome Assistant. matching. New Plugin Assistant that allows to easily create new search plugins. SYSTEM REQUIREMENTS New possibility to edit and test plugins internally. Every Apple Mac computer with at least 512 MB Settings drawer is now a tab. of RAM, Mac OS X 10.5 or later. In addition, a Searches can be saved and reopened later. broadband Internet connection (2 Mbps or faster) is Results can be appended to (saved) searches, older highly recommended. results can be skipped. Searching in results, improved searching in the archive. INSTALLING, UPDATING, Express mode for fast searches without filtering. REMOVING Integrated DEVONagent Express. New scanners and plugins, e.g. for Bing, the App Just move the DEVONagent Pro application Store, Unfolding News, or DEVONthink Pro package to the Applications folder or any other Office. directory you have access to. Please note that Mac Updated plugins, scanners, and search sets. OS X Services and the connection to DEVONthink Support for PDF, PostScript, OpenOffice, work only for applications installed into one of the Oracle Open Office, RTF, and Microsoft Word Applications folders, and that logout and login or a documents. restart is required after installation. Possibility to match title, text, URL, keywords, To update an existing version of DEVONagent Pro, description, and objects. simply copy the application package from the disk New search operators and options, e.g. 'OPT' and image to your Applications folder, replacing the old fuzzy searching. version. Your database(s) will not be affected. Much improved Web browsing and news feed If you would like to switch from the Mac App reading experience. Store variant of DEVONagent Pro to one directly Bookmark management. downloaded from the DEVONtechnologies website Sidebar in browser window unifies drawers. you can do so at any time. The official version will Customizable toolbar in browser windows. accept your Mac App Store receipt as a valid license. Improved integration of scanners. Copies not downloaded from the Mac App Store Cover Flow for searching and browsing plus also allow you to buy an upgrade to a higher edition previews/snapshots of webpages. or version (if available). DEVONagent Pro 3.2 Documentation, page 6 To remove DEVONagent Pro traceless from your The contextual menu plugin in ~/Library/ computer, trash the following files and folders (~ Contextual Menu Items/ represents your home folder): The Dashboard widget DEVONagent Pro Note: Some files may or may not be installed on ~/Library/Application Support/DEVONagent Pro your machine depending the version of Mac OS X ~/Library/Contextual Menu Items/DEVONagent you are using. Pro CM.plugin ~/Library/Preferences/com.devon- technologies.agentexpress.* TRIAL RESTRICTIONS Depending on whether you have installed the Unregistered DEVONagent Pro runs for 60 hours following extras or not, remove them, too: of non-continous runtime. Close the app to stop the clock from ticking and re-open later to continue The product-specific scripts in ~/Library/Scripts your evaluation. The menu extra is restricted to and ~/Library/Workflows 100 searches alltogether until DEVONagent Pro is registered. DEVONagent Pro 3.2 Documentation, page 7 GETTING STARTED In this chapter: DEVONagent Pro can repeatedly run searches unattended for you and present the results, if any, Why use DEVONagent Pro? 8 when it has finished. When to use DEVONagent Pro? 8 First steps with DEVONagent Pro 8 WHEN TO USE DEVONAGENT This chapter helps you get started with PRO? DEVONagent Pro. It explains why and when to use DEVONagent Pro, and how to run a first query, DEVONagent Pro does much more than a search step-by-step. on a Web search engine. And because it downloads all results to your Mac to analyse and post-process them, a search run takes between a few seconds and WHY USE DEVONAGENT PRO? several minutes. Consequently, DEVONagent Pro is The first misconception is that DEVONagent Pro not necessarily the most useful tool for every search is a simple front-end to Google or Bing. It is an task. Internet research assistant that takes over tedious Use DEVONagent Pro for: research tasks such as weeding out bad search Getting answers to a question results, looking for linked documents, or finding Finding all available data about a subject information on a webpage.