eggplant Functional Reference

Size: px
Start display at page:

Download "eggplant Functional Reference"

Transcription

1 Published on Documentation ( Home > eggplant Reference eggplant Reference eggplant Functional Reference This reference section is designed to provide quick information about the interface and script elements you'll find in eggplant Functional, TestPlant's test automation tool. The appendices contain comprehensive lists of eggplant Functional's script elements, suitable for printing. PDF Version If you want to access the documentation offline, you can download a PDF version of this manual from the following link: Click Here for PDF Documentation [1] Main Components of eggplant Functional 1. The Connection List [2] 2. The Viewer Window [3] 3. The Suite Window [4] 4. The Run Window [5] Table of Contents The eggplant Functional Menus [6] The Info/eggPlant Functional Menu [7] The File Menu [8] The Edit Menu [9] The Run Menu [10] 1

2 The Connection Menu [11] The Control Menu [12] The Window Menu [13] The Help Menu [14] The Connection List [2] The Viewer Window [3] The Suite Window [4] The Guide Tab [15] The Script Editor [16] The Image Viewer [17] Tables Pane and Keyword-Driven Testing [18] Results Pane [19] Schedules Pane [20] Sessions Tab [21] Settings Tab [22] The Run Window [5] eggplant Functional Preferences [23] General Preferences [24] Viewer Window Preferences [25] VNC Preferences [26] Script Preferences [27] Run Options Preferences [28] Text Preferences [29] Mail Preferences [30] eggplant Functional Commands and Functions [31] Image References [32] Mouse Commands and Functions [33] Text Commands and Functions [34] Image-Searching Commands and Functions [35] Image Information Functions [36] Found-Image Information Functions [37] Script Commands and Functions [38] Reporting Commands [39] SUT Commands and Functions [40] Mobile Commands and Functions [41] Global Properties [42] eggplant Functional Global Properties [43] Run Options [44] Running from the Command Line [45] Mac: Running from the Command Line [46] Windows: Running from the Command Line [47] Linux: Running from the Command Line [48] Appendix A: eggplant Functional Commands [49] Appendix B: eggplant Functional Functions [50] Appendix C: TypeText Keywords [51] Appendix D: Global Properties [52] Appendix E: Property Lists [53] Appendix F: Pango Markup Tags [54] Appendix G: OCR Language Support [55] Help and Additional Information Manuals You can access all of the following manuals online through the TestPlant Documentation website [56]. You can also access documentation within individual products by going to Help > Documentation. Getting Started [57] provides instructions for a basic eggplant Functional set up to get you started using this testing tool and familiarize you with its functionality. Using eggplant Functional [58] is a collection of articles that delve into the eggplant Functional workflow and explain a variety of important tasks and concepts such as how to organize your testing process and how to use eggdrive to integrate scripts from other testing tools. eggplant Functional Reference [59] describes the eggplant Functional interface and scripting processes, and the SenseTalk commands, functions, and global properties that are unique to eggplant Functional. SenseTalk Reference [60] is a comprehensive guide to the SenseTalk scripting language used with eggplant Functional. This manual discusses all aspects of the SenseTalk language that are used for general scripting purposes. Commands and functions that are unique to eggplant Functional are also described here. The eggplant Performance [61] manual describes how to set up, run tests, and view results with eggplant Performance, a load and performance testing tool. The eggplant Manager [62] manual provides instructions for a basic set up of eggplant Manager, a test management system. Learn how to schedule and execute tests and view results. The eggcloud [63] manual describes how to deploy and administer eggcloud, a test-reservation system. You'll also learn how to make 2

3 reservations and how to connect through eggcloud. The eggman [64] reference helps you set up and get started using this free tool for manual testing. The eggbox [65] manual describes this appliance, which comes with a range of pre-installed TestPlant tools and related applications, and shows how you can use it to easily set up and run a test lab. The eggplant Network [66] reference describes the eggplant Network appliance and how to use it to emulate network conditions when testing with eggplant Functional and eggplant Performance. Connecting to SUTs [67] is a reference for everything you need to know about how to connect to and test against mobile devices with eggplant Functional using either eggon or ios Gateway. The Knowledge Base [68] is a collection of articles from different contributors that describe a variety of techniques and approaches to using eggplant Functional, as well as best practices and use-case scenarios. Further Resources The Examples section [69] of the TestPlant documentation provides a variety of example scripts using SenseTalk to run eggplant Functional tests, which you can adapt to fit your testing needs. The FAQ section [70] gathers common problems and solutions for TestPlant products. Online eggplant Functional Tutorials: [71] This series of four interactive tutorials introduces the scripting environment and some frequently used commands and functions. eggplant Functional User Forum: [72] Use this forum to ask questions of other eggplant Functional users, help your peers, and share ideas and approaches for using the product. eggplant Functional Examples Forum: [73] This forum is a collection of eggplant Functional scripts written in SenseTalk that address a variety of scripting problems. The eggplant Functional Menus The eggplant Functional Menus This section describes the menus that are always present in the eggplant Functional menu bar. The eggplant Menu The eggplant Menu The eggplant menu lets you view version and license information and access the General Preferences panel. The following choices are found on the eggplant menu: About eggplant The About eggplant option displays your current eggplant Functional version number, followed by credits for the dedicated and talented eggplant Functional development team. Preferences Preferences opens the General Preferences panel, which contains settings for a variety of features in eggplant Functional. Choose Preferences to fine-tune your test environment. (For more information, see eggplant Functional Preferences [23].) License Agreement License Agreement brings up a document describing the conditions under which you are licensed to use eggplant Functional. Licenses Licenses opens the eggplant License Registry, a panel that provides information on the specific eggplant Functional licenses available and those in use on the network. (For more information, see Licensing [74].) Quit eggplant Use Quit eggplant to quit or exit eggplant Functional. If a script is running, Quit eggplant displays a confirmation dialog before quitting the program. You can choose to Quit Now, Quit After Next Script Run, or Cancel. If there is no script running, you can bring up this dialog by holding down Alt (Option on Mac OS X) when you quit. If you click Quit After Next Script Run, eggplant Functional delays the quit until the next script run is complete, then quits without further confirmation. (To cancel a delayed quit, choose Quit eggplant again, and click Cancel in the confirmation dialog.) 3

4 The File Menu The File Menu The File menu allows you to manage test suites and scripts; there are menu items that create, open, close, save, revert, and print. New Suite New Suite creates a new test suite in the Suite Editor. (For more information, see The Suite Editor [4].) Note: You can name a default directory for new suites in the General preferences panel. Open Suite Open Suite brings up an Open dialog in which you can select an existing suite to open. New Script New Script creates opens the Script Editor for a new script for the active suite. The new script appears in the Scripts pane of the Suite Editor. Open Script Open Script brings up an Open dialog in which can select an existing script to open. Close The Close menu item closes the active window. Save If the Script Editor is the active window, the Save menu items saves the active script. If a Suite Editor is the active window, the Save menu item saves all open scripts in the active suite. Save As The Save As menu item saves the active script under a new name that you specify. Save All The Save All menu item saves all open scripts and suites. Revert Revert reloads the last saved version of the active script in the Script Editor. Print The Print menu item prints the active script. The Edit Menu The Edit Menu The Edit menu contains a menu items for editing and finding text in your scripts while working in the eggplant Functional Script Editor. Undo Undo reverses the last change you made to the text in the Script Editor. You can undo and redo many steps, in the order in which they were performed. 4

5 Redo Redo reverses the Undo menu item. Cut Cut removes selected text from your script and stores it in the computer s clipboard. After you cut text, you can paste it elsewhere using the Paste menu item. Copy The Copy menu item copies selected text to the computer s clipboard without removing it from its original location. After you copy text, you can paste it using the Paste menu item. Paste Paste inserts cut or copied text from the computer s clipboard into a script. Note: When you have a VNC connection open, you can paste text between the local computer and the SUT. Select All The Select All menu item selects every selectable item in the active window, or all of the text in a text field. Extract New Script The Extract New Script option lets you create a new script from a selection of code in the Script Editor, a form of code refactoring. The selection is removed from the current script and a call to the new script put in its place. For detailed information about using this feature, see the "Extracting Code into New Scripts" section of Reusing Code [75]. Complete When you have typed at least one character in the Script Editor, Complete [76] attempts to finish your current word using variables, commands, and names of scripts or images from your current suite. If there is a single match, the word is completed. If there are multiple matches, you can select the appropriate word from a list of options. To cancel the Complete without selecting any of the options, press the Escape key. Show Resource Show Resource opens the script or image selected in your text. Alt+click (Option+click on Mac OS X) is a shortcut for Show Resource. Insert Comment Use the Insert Comment option to insert comment tags into your code. If you select text in the Script Editor, the option says only Comment and selecting it will wrap your chosen text in comment tags. Find Find displays a submenu of the following commands that search for text in your scripts: Find. The Find menu item opens the Find panel. Find Next. Find Next searches forward in the current document and displays the next occurrence of the current Find term. Find Previous. Find Previous searches backward in the current or previous document and displays the last occurrence of the Find term. Use Selection for Find. Use Selection for Find takes the selected text in the Script Editor as the current Find term. Jump to Selection. Jump to Selection scrolls through the current window to display the selected text. If no text is selected, Jump to Selection displays the current insertion point. Show Colors You can use the Show Colors option to open the Colors panel. You can use the controls in the panel to define colors or use the magnifying glass to pick an on-screen color, then drag from the color box into your script to define specific RGB color codes in your scripts. Special Characters (Mac OS X only) The Special Characters menu item opens a panel that allows you to insert special Unicode characters into your script. Note: Typing an international character in your script does not guarantee that it can be reproduced on the SUT. The ability to send particular characters to a SUT depends on the capabilities of the SUT's operating system and VNC server. Examples: Your SUT and its VNC server both support unicode characters, so any unicode character in your script can be typed on the SUT with no additional steps. Your SUT uses an American keyboard layout, and when you type Asian characters, you use an input method editor (IME). eggplant Functional would also have to use the IME to send Asian characters to this SUT. Your SUT supports unicode characters, but its VNC server does not. It may be possible to find a VNC server that supports unicode characters; otherwise, eggplant Functional would need to use an IME to produce international characters on the SUT. 5

6 The Run Menu The Run Menu The Run menu contains controls for running and debugging scripts. (For more information, see The Run Window. [5]) The eggplant Functional Run Menu when no script is running Run Window. Opens the eggplant Functional Run window, which will display the most recently run code and related results. Run Script. Runs the script currently active in the Script Editor or Run window. Tip: To start the script in a paused state for debugging, hold down Alt (Option on Mac OS X) as you choose Run Script. Run Selection. Runs only the selected part of a script that is active in the Script Editor or Run window. Only available when there is selected text in the active window. Abort Script. Cancels the current script run. Only available when a script is actively running. Animation. Highlights the current line of code in the Script Display area of the Run window as the script is running. Animation Off: When you choose Animation Off, the Display area of the Run window does not update as the script runs; only the initial handler for the script is shown, unless the execution is paused. Animate Calls: When you choose Animate Calls, the Run window shows each script or handler as it is called, but it does not highlight each line of the script. Animate All: When you choose Animate all, the Run window highlights each line of each script or handler as it is run. Notes: Animations cause scripts to execute more slowly, because eggplant Functional is doing more work at the display level. To improve script execution speed, turn off all animations when you are not debugging. The script animation setting can be changed while a script is running, with immediate effect; it can also be modified temporarily by scripts as they run. (For more information, see the ScriptAnimation in Global Properties [42].) Tracing. Causes eggplant Functional to echo information about what the script is about to execute to the Log Area in the Run window. This is similar to script animation, but it allows you to review all of the code that is executed during the script run, interspersed with logged output. This can provide more context when debugging a script. Note:The tracing setting can be changed while a script is running, with immediate effect; it can also be modified temporarily by scripts as they run. (See the ScriptTracing [77].) Update Image. Brings up a submenu to control the Image Doctor settings. 6

7 When Image Not Found: If an image search fails... Throw Exception (Doctor Off): Turns the image doctor off. The script will fail and an Exception will be thrown. Show Panel (Manual Doctor): The image doctor is set to manual. The Update Image panel will appear, allowing you to view diagnostic searches and adjust settings, among other things. Auto Doctor: Sets the image doctor to auto. The Image Doctor will try a variety of diagnostic searches to see if it can find the image without manual intervention. When Multiple Occurrences Found: If multiple instances of an image are found with the current image search settings... Use First Location: (Default.) eggplant Functional will interact with the first image detected. Show Panel: The Update Image panel [78] will appear, allowing you to view diagnostic searches and adjust settings, among other things. Log Warning: eggplant Functional will log a warning, and then interact with the first location of the image found. Throw Exception: eggplant Functional will throw an exception, the script will fail, and it will not interact with any of the instances of the image found on the screen. Other Actions: There are some special instances where Image Doctor does not automatically engage. One of these is when an image is referenced within an ImageFound() function. Validate ImageFound(): Enables validation of images within ImageFound() functions by the Image Doctor. Validate All Image Searches: Runs the image doctor Diagnostics. Toggles that allow the selection of which Diagnostic searches are performed by the image doctor, as shown in the Update Image panel. See Image Update Tools [78] for information on the different diagnostic searches. Image Highlighting. Toggles image highlighting on (checked) or off (unchecked). When image highlighting is turned on, images are highlighted in the Viewer window as they are found during a script execution. Debug Script. Runs the script in the active Script Editor or Run window, starting in a paused state. This allows you to step through the script and follow its execution closely (The next line to be executed is highlighted in the Script Display area of the Run window.) Notes: While you are debugging, you can use the toolbar buttons in the Run window to step through the script, or allow it to continue at a normal rate. (For more information, see The Run Window. [5]) You can also use Debug Script by Alt-clicking (Option-clicking on Mac OS X) the Run Script button in the Script Editor toolbar. Debug Selection. runs only the selected part of a script in the active Script Editor or Run window, starting in a paused state. This allows you to step through the script and follow its execution closely (The next line to be executed is highlighted in the Script Display area of the Run window.) Notes: While you are debugging, you can use the toolbar items on the Run window to step through the script, or allow it to continue at a normal rate. (For more information, see The Run Window. [5]) You can also use Debug Selection by Alt-clicking (Option-clicking on Mac OS X) the Run Script button in the Script Editor toolbar. Pause/Continue Script. Toggle between Pause and Continue to pause and continue the current script execution. This allows you to examine the state of the script and interact with the Viewer window in Live Mode. Step Into. executes the next line of a script, then pauses. If this line calls another script or handler, the script steps into the first line of the called script or handler before pausing again. Step Over. performs a similar function, with one exception: If the line calls another script or handler, Step Over executes the called script or handler entirely before pausing. Step Over. Executes the next line of the script, then pauses. However, if this line calls another script or handler, that script or handler runs in its entirety, stepping over it to the next line of original script before pausing again. Note: During the execution of the script or handler that is stepped over, you can click Pause to regain control of the execution before the Step Over action has finished. 7

8 Step Out. Executes all of the remaining lines in the current script or handler, then pauses. (Using Step Out on an initial handler is the same as clicking Continue.) Note: During the execution of the code being stepped out of, you can click Pause to regain control before the Step Out action has finished. Set/Remove Breakpoint. Toggle between Set and Remove Breakpoint to insert or remove a dynamic breakpoint in the selected line of a script. (For more information, see Dynamic Breakpoints in The Script Editor [79].) Remove All Breakpoints. Removes all breakpoints in all of your currently open scripts. The Connection Menu The Connection Menu The Connection menu contains items that allow you to open and close VNC connections to SUTs. (For more information, see The Connection List [2].) Connection List The Connection List menu item opens the Connection List, in which you can manage and open VNC connections to your SUTs. (For more information, see The Connection List. [2]) Connect The Connect menu item attempts to establish a VNC connection with the SUT selected in the Connection List. Disconnect Disconnect closes the VNC connection with the SUT selected in the Connection List. Check Availability Check Availability updates the availability status of SUTs in the Connection List. To read about what the different status icons mean, please see "Status" [80] in The Connection List. Add Connection... Add Connection opens the Add/Edit panel in the Connection List, allowing you to add a new SUT to the Connection List. Edit Connection... Edit Connection opens the Add/Edit panel in the Connection List, allowing you to edit the selected SUT. Remove Remove deletes the selected SUT from the Connection List. The Control Menu The Control Menu The Control menu contains many of the features that are in the Viewer window toolbar. (For more information on these menu items, see The Viewer Window. [3]) Enter Capture Mode / Enter Live Mode Enter Capture Mode disables your remote control of a SUT, so you can use your local eggplant Functional tools to capture images in the Viewer window. Capture Mode dims the Viewer window, making the selected Capture Area stand out at normal brightness. (For more information on capturing images, see Capture Mode, in The Viewer Window [3].) Enter Live Mode restores your remote control of the SUT. To toggle between Capture Mode and Live Mode quickly, press Control (Command on Mac OS X). (You can change the toggle key in Viewer preferences.) Capture Image... When the Viewer window is in Capture Mode, Capture Image takes a snapshot of the Capture Area. Use Image... (Mac OS X and Linux only) Use Image brings up an Open panel in which you can select a saved image to use in your script. 8

9 Find Text... Find Text (formerly Text Image) allows you to search for text based on content and formatting properties. Script Command submenu The Script Command submenu contains common eggplant Functional script commands and functions. Each menu item inserts the indicated command into the current script. (For more information, see The Viewer window Toolbar in The Viewer Window [3].) Control Panel The Control panel allows you to enter Full-Screen Mode, viewing the SUT in place of your own desktop. Capture Screen Capture Screen takes a snapshot of the entire Viewer window of your SUT. (For more information, see Capture Screen, in The Viewer Window [3].) Refresh Display Refresh Screen requests a full-screen update from the SUT. This is useful for cleaning up occasional artifacts (drawing errors) during scripting. Send... Escape Codes and Function Keys These items allow you to send commands to the SUT that would otherwise be intercepted by the eggplant Functional computer. For example, if you tried to type Control-Alt-Delete to force quit an application on your SUT, your eggplant Functional computer would intercept that command, and quit eggplant Functional. Instead, you could choose the Send Control Alt Delete menu item, and the command would bypass your local system. Record Movie / Stop Movie (Mac OS X only): Deprecated Note: This functionality has been deprecated. Record movie opens a Save dialog in which you select a location to save your QuickTime movie. Recording starts when you click the Save button. (For more information, see Record movie, in The Viewer window [3].) The Window Menu The Window Menu The Window menu contains items that allow you to manage eggplant Functional windows and toolbars. Close Window The Close menu item closes the active window. Zoom Window For most windows, Zoom Window enlarges the active window to the size of your display, or returns it to its previous size. (The exception is the Viewer window, which never grows larger than its contents.) Minimize Window Minimize Window sends the active window to the Taskbar or Dock. To see the window again, click it in the Dock, or choose it in the Window menu. Hide Toolbar / Show Toolbar Hide Toolbar causes the toolbar of the active window to disappear. If the active window s toolbar is already hidden, the action becomes Show Toolbar. Customize Toolbar Customize Toolbar brings up a panel in which you can select the buttons that are available in the toolbar of the active window. To add a button to the toolbar, drag the button from the Customize panel to the toolbar; To remove a button from the toolbar, drag it off of the toolbar. While the Customize panel is open, you can also drag buttons to different locations within the toolbar. Active Connection The Active Connection menu item brings up the Viewer window of the SUT you are currently working with. If your VNC connection has been closed, you can still bring up the Viewer window showing the last known state of the SUT. 9

10 Run Window The Run Window menu item brings the Run window in front of all other windows. If the Run window is minimized or closed, choosing Run Window opens it. The Help Menu The Help Menu The Help menu contains the eggplant Functional help documents, as well as channels through which you can provide feedback about eggplant Functional and get additional assistance. Use Online Documentation and Documentation Use Online Documentation can be selected (checked) or not. When it is selected, clicking Documentation takes you to the online documentation. If it isn't selected, clicking Documentation provides access to a PDF version of the online documentation; the PDF version is updated with every release of eggplant Functional. Release Notes The Help menu has an option to open the Release Notes document. This document contains information about the current release of eggplant, including changes that have been made since the previous release. The release notes are also available online here. [81] When you update to a new eggplant Functional version, please check the Release Notes to read about significant changes to the software. eggon Servers This menu item takes you to the location in the local file system where any eggon servers are located. Tutorials This menu item takes you to the online tutorials available for eggplant Functional. Examples The Examples option takes you to theeggplant Functional Examples [82] discussion forum where you can post questions and engage in discussion with other eggplant Functional users and TestPlant support. Report Bug, Request Feature, Submit Question These three menu items open an eggplant Support Request panel. The Connection List The Connection List The Connection List contains the names and other information about all of the SUTs you can control through eggplant Functional. (For more information, see eggplant Functional: Getting Started.) Information Provided by the Connection List The Connection List The columns in the Connection List contain the following information for each SUT: 10

11 1. Status The Status column indicates the SUT s availability, denoted by a color-coded dot. To receive a status update, choose Connection menu > Availability. Connection List status colors: Color Meaning Green Connected Blue Available Gray Unavailable Yellow Unknown Partial Yellow Connecting Red Error Gold Halo Active Connection 2. Name The Name column refers to the display name a SUT sends to eggplant Functional. Before eggplant Functional connects to a SUT, the Name column displays the same information as the Host column. Tip: To insert the name of a SUT into a script quickly, drag it from the Connection List to the Script Editor. To insert a connection property list into the script, Alt-drag (Option-drag on Mac OS X) the SUT to the Script Editor. 3. Host The Host column displays the SUT s host name or IP address. 4. Port The Port column displays the number of the port on which the SUT listens for VNC connections. 5. Color The Color column displays the setting you choose in the Color Depth menu. 6. SSH Host The SSH Host column displays the host name or IP address of the computer that hosts an SSH tunnel for the SUT s secure connections. 7. SSH User The SSH User column displays the account name with which the SUT user logs into an SSH host. 8. Activity The Activity column displays a running description of your VNC connection. For information on how to add, edit, and remove SUTs in the Connection list, please see Creating a Connection from eggplant Functional [83]. The Viewer Window The Viewer Window The Viewer window shows an image of the SUT as you would see it on its own display. The Viewer Window has two modes; Live Mode and Capture Mode. You can interact with the SUT as a user in Live Mode [84], and capture images to use in eggplant Functional scripts in Capture Mode [85]. To toggle between Live Mode and Capture Mode, click the "Enter Capture Mode" or "Enter Live Mode" icon in the toolbar [86]. 11

12 Note: To toggle between Live Mode and Capture Mode quickly, press Control on Windows or Command on Mac OS X. You can select a different key to perform this action in Viewer Window preferences. Live Mode The Viewer Window in Live Mode In Live Mode, you can use your local mouse and keyboard to interact with the SUT as a user. This works just as if you were using the SUT s own keyboard and mouse directly. In Live Mode, you can also copy and paste text between applications running on the SUT and your local computer. Note: If the Viewer window is not your active window, your clicks and keystrokes are applied to your local computer, not the SUT. Capture Mode 12

13 The Viewer Window in Capture Mode In Capture Mode, you can capture images of your SUT and insert commands and functions into your current script. You continue to receive display updates from the SUT, but your mouse and keyboard events are applied to your local computer. The Viewer window is dimmed in Capture Mode, except for the Capture Area, described below. The Capture Area The Capture Area In Capture Mode, the Capture Area shows the area that is included when you save an image. It is the rectangle shown at normal brightness when the rest of the Viewer window is dimmed. To move the Capture Area, drag the edges. You can also nudge the Capture Area one pixel at a time by pressing the Arrow keys. (Add the Shift key to move the Capture Area in ten-pixel increments.) To resize the Capture Area, drag the corners. You can also nudge the size one pixel at a time with Alt-arrow (Option-arrow on Mac OS X) keys. (Add the Shift key to resize in ten-pixel increments.) The Hot Spot [87] is the little red cross-hair that you see inside of the Capture Area. Note: The Capture Area is drawn with a grey border to make it easier to see on dark backgrounds; you can turn this border off in Viewer window preferences. The Hot Spot The hot spot is the point that is clicked when a script executes a Click command on an image. The hot spot is typically marked with red crosshairs; it automatically turns black when it is positioned over a predominantly red image. 13

14 To move the hot spot in a Capture Area, Control-click or Control-drag the crosshairs. You can also nudge the hot spot in one-pixel increments with Control-arrow (Command-arrow on Mac OS X). Adding the Shift key moves the hot spot in ten-pixel increments. Capturing Images To capture an image of the portion of the SUT as selected by the Capture Area, click the Capture Image button in the Viewer window toolbar, or choose Control menu > Capture Image. For more information on image capture, see Best Image Capture Practices [88]. Note: Images can also be captured using the assisted scripting functionality of other icons in the Viewer window toolbar, described below. When these icons are used, related SenseTalk code is generated at the same time as the image is captured. Full-Screen Control With full-screen control, you can view the SUT as your entire desktop. A small control panel provides access to the regular Viewer window features. To open the control panel, choose Control menu > Control panel. To customize the buttons displayed on the control panel, right-click in the panel, and choose Viewer window items from the contextual menu. To return to your own desktop, click the Exit Full screen button, or use the keyboard shortcut Option+Command+1. Zooming The Full-Screen Control Panel It is possible to zoom in on the SUT while in capture mode. The Viewer window must be set to show the SUT at full scale; It cannot be in "Scale to Fit" mode. To zoom in on Windows or Linux, hold Ctrl and press "+". To zoom out, hold Ctrl and press "-". This is the same on Mac, except use the Cmd key instead of Ctrl. The Viewer Window Toolbar The Viewer Window, with the Toolbar Highlighted 14

15 Most of the buttons in the Viewer window toolbar are also represented as menu items in the Control menu [12]. The toolbar buttons are described below. Since the toolbar can be customized, you might not see all of the buttons on your own toolbar. (For more information on adding and removing toolbar buttons, see Customize, below.) The Toolbar Icons Enter Capture Mode / Enter Live Mode This button toggles the Viewer window between Live Mode and Capture Mode. When you click the Enter Capture Mode button, it turns to Enter Live Mode button, and vice versa. Images of both instances of this button as it is shown in the Viewer window can be seen below. : Enter Capture Mode : Enter Live Mode Note: You can also toggle between Live Mode and Capture Mode quickly by pressing Control on Windows or Command on Mac OS X. You can select a different key to perform this action in the Viewer Window Preferences [25]. Full Size/ Scale to Fit This button toggles between showing the Viewer window at the SUT's full display size, and showing the entire SUT scaled to fit the size of the Viewer window. Images of both instances of this button as it is shown in the viewer window can be seen below. : Show Full Size : Scale to Fit Note: Switching between the sizing options has no effect on the functionality of the Viewer window, image captures, or image matching. Start Session/End Session This button can be used to start and end Turbo Capture Sessions. It toggles between Start Session and End Session according to whether or not a Turbo Capture Session is in progress. : Start Session : End Session To read about how to use the Turbo Image Capture, please see Creating Tests with eggplant Functional [89]. Capture Image The Capture Image button takes a snapshot of the SUT as selected by the Capture Area and opens the Image Capture panel, which is described in detail below [90]. Use Image (Mac OS X and Linux only) The Use Image button opens the Use Image panel, in which you can select a saved image to use in a script. Option-clicking a command button also opens a Use Image panel. The Use Image panel is described in detail below [91]. At the bottom of the Use Image panel, there is a pop-up menu of eggplant Functional commands and functions [31] that you can insert into the script with your selected image. For more information, see The Use Image Panel [91]. Find Text The Find Text button (formerly the Text Image button) opens the Find Text panel, which allows you to search for text without using a previously captured image. This feature can be used either with TIG [92] (Text Image Generation) or OCR [93] (Optical Character Recognition). The Find Text panel is described in detail below [94]. 15

16 Note: Shift-clicking a command button also opens the Find Text panel. Click, DoubleClick, RightClick, MoveTo, Drag, Drop These command buttons perform three actions at once: Save an image of the SUT as selected by the Capture Area into the Images folder of the current suite. Insert the respective SenseTalk command into the active script. Perform the respective action on the SUT. Please see the list below for images of these buttons and links to the associated commands for more information: inserts a Click command [95]. inserts a DoubleClick command [96]. inserts a RightClick command [97]. inserts a MoveTo command [98]. inserts a Drag command [99]. inserts a Drop command [100]. Add Image The Add Image button takes a snapshot of the SUT as selected by the Capture Area, and adds it to the line indicated by your insertion point in the Script Editor. (The exact location of the insertion point does not matter, as long as it is in the correct line of the script.) The Add Image button is only available if the Viewer window is in Capture Mode. WaitFor The WaitFor command causes a script to pause and wait for an image to appear in the Viewer window. When you click the WaitFor button, an image capture panel opens. In the Maximum Wait text field, enter the longest period of time (in seconds) that you want the script to wait for the image to appear in the Viewer window. When you run the script, the script executes the next command as soon as the WaitFor image appears. If the image does not appear in the maximum wait time, the test fails. Wait The Wait command causes a script to wait for a specified period of time before executing the next command. This way, you can allow an arbitrary length of time for the SUT to complete a task before proceeding with the script. The Wait button opens a dialog in which you must specify the time (in seconds) of the Wait command. Tip: The WaitFor command has two advantages over the Wait command: WaitFor delays the next action in your script only as long as necessary to locate the appropriate image, while Wait delays the next action for a fixed period of time, even if less time is needed. The WaitFor command returns the time it took for its target image to appear. If you use the Wait command, you only know that the image appeared sometime in the Maximum Wait time frame. TypeText The TypeText command sends text as keystrokes typed in the Viewer window, allowing you to simulate typing on the SUT. The TypeText button opens a panel in which you can enter your text parameters. When you create a TypeText command with this panel, clicking the Insert button automatically encloses your text parameters in quotation marks in your script. 16

17 Note: Text parameters enclosed in quotation marks are typed as literal text on the SUT. Text parameters that are not enclosed in quotation marks are treated as variables. Tip: When the Viewer window is in capture mode, you can start a TypeText command by typing the text you want to insert into your script. For more information, see "Recording TypeText Commands" in Using eggplant Functional. Log The Log command creates a custom entry in a script s execution log. To insert a Log command, click the Log button and type an entry into the Log panel. (If you provide multiple parameters, each one is added to the script as a separate entry.) Note: You can see the execution log in the Results Pane [101] of the Suite Window [4]. Comment The Comment button opens a panel in which you can type a comment for the active script. The comment is inserted into the script in the form (*Comment*). Comments can also be created through the Script Editor [102] as described here [103]. Capture Screen The Capture screen button takes a snapshot of the entire Viewer window of your SUT. Although screen captures in your Images directory appear in the Images pane of the Suite Editor, they are not added to a script when you choose Capture screen. Instead, Capture screen is useful for other purposes, such as reporting, documentation, and interface design discussions. Note: The CaptureScreen command [104] performs screen captures from within a script, as opposed to the Capture screen button, which performs screen captures independently of a script. Refresh Screen The Refresh screen button requests a full-screen update from the SUT. This is useful for cleaning up occasional artifacts (drawing errors) during scripting. Note: The Refresh screen button does not add a command to your script, as opposed to the RefreshScreen command [105]. Abort Script Abort Script stops a script in progress. It stops before executing the next line of the script. Cursor Location This field contains screen coordinates for the SUT cursor in the Viewer window. You can move the cursor to a particular location by editing the coordinates in this field. Home The Home button presses the home button on mobile devices. Rotate The Rotate button rotates the screen of mobile devices in the Viewer window 90 degrees clockwise. Swipe The Swipe button brings up a panel to select the direction of the swipe. Options are to swipe left, right, up, or down. Customize The Customize button opens a panel in which you can select the buttons that are available in the Viewer window toolbar. To add a button to the toolbar, drag the button from the Customize panel to the toolbar; 17

18 To remove a button from the toolbar, drag it off of the toolbar. While the Customize panel is open, you can also drag buttons to different locations within the toolbar. Deprecated Toolbar Buttons Record Movie/Stop Movie (currently Mac OS X only): Deprecated Note: This functionality is now deprecated. The Record movie button opens a Save dialog in which you select a location to save your QuickTime movie. Recording starts when you click the Save button. All screen updates from the SUT are recorded in the movie, whether they are caused by a script, your interaction with the Viewer window, or a user operating the SUT directly. To end the movie, click the Stop movie button. Note: The Record movie button does not create a script command; to add movie recording to a script, you must edit the script manually. The Image Capture Panel The Capture panel is similar to a Save dialog box, with some additional script and image controls. 1. Image Name Field: The Image Name field defaults to a dynamically generated name that is unique to the current suite, beginning with image0001. This name may be sufficient for temporary scripts and experimentation, but more descriptive names are easier to follow as you start scripting in earnest. Image names can contain alphanumeric characters, spaces, and most punctuation marks. 2. Where Pop-Up Menu: The Where pop-up menu displays the folders in which you can save an image. The default choice is the Images folder of the current suite. 3. Image Well: The central portion of the Capture panel is an image well that displays the captured image. The Hot Spot in the image is indicated by red cross hairs. To move the Hot Spot, Control-click in the image (Command-click on Mac OS X) or Control-drag the cross hairs (Command-drag on Mac OS X). Note: If the captured image is too large for the image well, it is scaled down to fit. The actual image is not affected, but it may appear distorted in the Capture panel. 4. Search Type Pop-Up Menu: The Search Type pop-up menu allows you to choose a search type other than the default at the time of image capture. Note:The Default Search Type The default choice in the Search Type pop-up menu depends upon the image you are saving. eggplant Functional attempts to choose the most appropriate search type for each image. (Tolerant is usually the best choice, so it is the most common default search type. Text and Text&Pulsing are never default choices.) Note: You can adjust the tolerance of the Precise and Tolerant search types settings in Run Options preferences. 5. Command/Function Pop-Up Menu: To insert a command or function into the script with your image, choose the command or function in the Command/Function pop-up menu. To insert the image into the script with no command or function, choose Capture Image. To insert the image into a selected command or function in the script, choose Add Image. 6. Creating a New Folder: To create a subfolder within the currently selected folder, click the New Folder button. 7. Making an Image Collection: To make an Image Collection based upon an existing image, select the image and click the Make Collection button. The Image Collection takes on the same name as the image, and the image is automatically moved into the 18

19 Image Collection. To read more about Creating an Image Collection, click here [106]. 8. Max Wait Field: To specify the maximum wait time associated with the Wait or WaitFor commands, type the time (in seconds) in the Max Wait field. 9. Cancel Button: To cancel the image capture and close the Capture panel, click the Cancel button. 10. Save Button: To complete the image capture and close the Capture panel, click the Save button. The Use Image Panel (Mac OS X and Linux only) The Use Image panel is similar to a standard Open dialog, with added script controls at the bottom. You can open the Use Image panel by Alt-clicking (Option-clicking on Mac OS X) any command that typically opens a Capture panel. 1. File Browser: The upper portion of the Use Image panel is a standard file browser. Use it to navigate between the current suite s Images directory and subfolders. 2. Command/Function Pop-Up Menu: To insert a command or function into the script with your image, choose it in the Command/Function pop-up menu. To incorporate the image into the selected command or function in the script, choose Add Image. 3. Max Wait Field: To specify the maximum wait time associated with the Wait or WaitFor commands, type the time (in seconds) in the Max Wait field. 4. Cancel Button: To cancel the image selection and close the Use Image panel, click the Cancel button. 5. Insert Button: The Insert button completes the Use Image operation. It inserts the generated command or function into the script, executes the command (if possible) and closes the Use Image panel. The Find Text Panel The Find Text panel allows you to search for text without using captured images. This can be used to find text with either the OCR (Optical Character Recognition) or TIG (Text Image Generator). OCR: The default platform is Generic OCR which uses the Optical Character Recognition functionality in eggplant Functional. OCR uses interpretive algorithms to look at pixel patterns on the screen of the SUT and identify characters present on the screen. It checks its findings against a dictionary (the default dictionary is English) and it has access to a variety of dictionaries, which allows it to read in many lanugages. For a list of supported languages, please see Appendix G: OCR Language Support [55]. TIG: The is a Text Image Generator installed on the SUT to dynamically generate images of text and then search for them. Text Image Generators can be downloaded from the TestPlant downloads [107] page. To open the Find Text panel, click the Find Text button in the Viewer window, or choose Control menu > Find Text. The Find Text Panel contains two sets of text properties; one for text platforms that use OCR (Optical Character Recognition), and one for platforms that dynamically generate images of your defined text. 19

20 1. Text String Field: The Text String field contains the actual text that appears in your image. You must enter text here before you can insert the text property list. 2. Platform Pop-up Menu: The Platform pop-up menu comprises the text platforms that you define in Text preferences. Text platforms are usually distinguished by SUT operating system. Choose the Generic text platform or a text platform that represents the SUT you are working with. (For more information about text platforms and TIGs, see Using eggplant Functional: "More About Text Platforms". 3. Style Pop-Up Menu: The Style pop-up menu contains choices of predetermined text styles. After you choose a style as a starting point, you can change the individual attributes as needed. (For example, if your text uses a SUT s standard menu font but displays it in red, you can choose the menu style, then change the text color to red.) You can define new styles in Text preferences. 4. Text Language Pop-Up Menu: The Text Language pop-up menu contains choices OCR language dictionaries. 5. Case Sensitive: The Case Sensitive check box determines whether or not your search is case-sensitive. 6. Contrast On: The Contrast On check box determines whether or not your search uses contrast. This is often useful when working with anti-aliased text. It filters the screen of the SUT so that it appears two-toned to the OCR engine. You can set a contrast Tolerance and contrast Color. Best Practice: It is generally advised to use the background color as the contrast color, though in some circumstances the text color can be used. 7. Command/Function Pop-Up Menu: To insert a command or function into the script with your text property list, choose from the Command/Function pop-up menu. The preview field below the pop-up menu shows the text that is inserted into your script. To incorporate the text image into the selected command or function in the script, choose Add Image. 8. Max Wait Field: To specify the maximum wait time associated with the Wait or WaitFor commands, type the time (in seconds) in the Max Wait field. 9. Cancel Button: To cancel the text property list and close the Find Text Panel, click the Cancel button. 10. Save Button: The Save button inserts the text property list into your script with the chosen command or function, executes the command (if applicable), and then closes the Find Text panel. TIG Only Elements: Font and Size Fields: In the Font and Size fields, choose the font and size of your text if they differ from the chosen style. Bold, Italic and Underline Check Boxes: Select these checkboxes to generate bold, italicized, or underlined text in your text image. Not all fonts can be drawn in a bold or italic form, so some font and style combinations cannot produce a usable text image. Note: Programs can differ in the way they draw underlining, so an underlined image may not produce the exact image you need. If this is the case, use Capture Image to take a snapshot of your text in the Viewer window. Text-Image Preview: To hide or show the image preview area, click the disclosure triangle or the words Text Image Preview. Previews of text images can be useful if your selected text platform uses a native eggplant Functional text-image generator (TIG) or another fast TIG on the network. If the selected text platform uses a slower TIG, or the platform s TIG is currently unavailable, the image preview can slow down your system. Search Type Pop-Up Menu: Search Type describes the level of precision eggplant Functional requires to consider a part of the Viewer window a match for your target image. For text, the best search type is usually Text. (For more information, see Search Type pop-up menu, in The Capture Panel, above.) This pop-up menu is only available when the image preview area is shown. Text and Background Color Wells: To edit a text or background color, click the respective color well and select a new color in the Colors panel. Tip: The color picker in the Colors panel is especially useful for eggplant Functional; it allows you to copy a color from any place in your display, including the Viewer window. To use the color picker, click the magnifying glass in the Colors panel, then click again wherever you see the color you would like to copy. 20

21 The Suite Window The Suite Window The Suite window is where you manage scripts, images, and run results within eggplant Functional; it's the control hub for all of your testing operations. However, more detailed results can be viewed with eggplant Manager [62]. Opening a New Suite To open a Suite window, choose File > New Suite or Open Suite. When you're working with multiple suites, you must open a separate Suite window for each one. When you create a new suite, you'll be prompted to select a Save location for the suite. After you've done that, the Suite window opens, showing the Guide tab [15]. Note: On Mac OS X and Linux, if a suite folder is locked in your file system, a lock icon appears in the top left corner of the Suite window. When a suite is locked, you can't add, remove, or edit any script resources. You can still run scripts, but run data isn't saved. Guide Tab The Guide Tab When you first create a new suite, it will open with the Guide tab open. The Guide tab gives you some pointers to get started. Here are the options you can select on this pane: The Guide Tab in eggplant Functional's Suite Window New Script: Switches you to the Script Editor and creates a new, untitled tab. 21

22 Show Connection List: opens the Connection List window, where you define connections to your systems under test (SUTs) and can open connections. Note: If you're already connected to a SUT, section 2 of the Guide tab displays the Show SUT in Capture Mode button, which takes you directly into your SUT. New Table: Switches you to the Table Pane and creates a new, untitled table. New Schedule: Opens a new tab and takes you to the Schedule pane to define a new schedule to run scripts. To access the Guide tab from another part of the Suite window, you can select its tab at the top of the suite or you can click the Guide button at the bottom left. If you wish, you can close the Guide pane; to re-open it at any time, click the Guide button. The Script Editor The Script Editor You use the eggplant Functional Suite window to manage all the scripts in the active suite. You also use it to create new scripts and run scripts. The Scripts Pane The Suite window's Scripts pane on the left sidebar shows all of the scripts in the suite. When you select a script in the Scripts pane, the main pane of the Suite window opens a Script Editor tab with your selected script displayed in preview mode (in a temporary tab). If you click away from it, its tab goes away. When a script is in preview mode, the Script Editor appears gray. eggplant Functional's Scripts Pane in the Suite Window Right-click within the Scripts pane (or on a specific script in the list) for a list of actions you can perform. On Mac OS X, you can also click the gear icon at the top of the pane to view the actions list. Your options include: New Script: Creates a new, untitled script in the scripts list, and a new Script Editor tab opens. You can also select New Script from the File menu. Run: Executes the selected script; you can also click the Run button on the Script Editor toolbar. Debug: Runs the selected script in debug mode. Open: Opens a script from preview mode into a permanent Script Editor tab for editing. You can also double-click the script name to open it, or you can click in the Script Editor when the script is displayed in preview mode. Reveal In Explorer/Finder: Opens a Windows Explorer or Mac OS X Finder window and shows the location of the current script. Rename: Allows you to change the name of the current script. Delete: Deletes the selected script. You can select and delete multiple scripts at one time. All Script Editor tabs associated with deleted 22

23 scripts close. Sort by: Allows you to sort the scripts list by Name, Modified Date, Last Run Date, and Status. Show > Table Actions: Turns on the color indicator in the Scripts list so that any scripts that are enabled as table actions are shown in blue. Searching for a Script To search for a particular script in your suite, type part of a script name or script text in the search field above the Scripts list. To set a search filter, click the magnifying glass beside the Search field and choose Search All, Search Names, or Search Contents from the drop-down list. The Script Editor Toolbar Along the top of the Script Editor, you'll find a toolbar with buttons to run scripts as well as other controls to help with creating scripts. The functions available on the toolbar are: The Script Editor Toolbar 1. Run Script: Use this button to execute your scripts. While the script is running, the Run Script button changes to Abort Script. While a script is running (and not paused), you cannot perform any manual actions in the Viewer window or open and close VNC connections. To run a script in debug mode, Alt-click (Option-click on Mac OS X) the Run Script button. Debug mode loads the script for execution and immediately pauses it so that you can step through line by line to closely follow its execution.) Dynamic Breakpoints Dynamic breakpoints are markers that cause a script to pause for debugging at designated points. To set a dynamic breakpoint in the Script Editor, click in the narrow column to the left of the script. A black triangle appears next to the line, denoting the breakpoint. To change or remove a breakpoint, drag the triangle to another line in the script or out of the script entirely. 2. Run Selection: This button executes only the selected part of the script. The selection does not have to include an entire line of code, but it must be syntactically complete and executable. For example, if you select the beginning of an if block, you must select all the way through the end if statement. To run the selection in debug mode, Alt-click (Option-click on Mac OS X) the Run Selection button. Debug mode loads the selection for execution and immediately pauses it so that you can step through line-by-line to closely follow its execution. Note: When you run a selection, results are not generated in the Results pane of the Suite window. 3. Show Results: Click this button to go to the Results pane for this script. 4. Show Resource: Use this button to see the source of an image or script referenced in your script. When you select an image name and click the Show Resource button, the image opens in a new Image Viewer [108] tab. When you select a script name and click the Show Resource button, the script opens in a new Script Editor tab. Note: You can also show a resource by Alt-clicking (Option-clicking on Mac OS X) a script or image name. 5. Comment: Use this button to insert a comment into a script. The button inserts an empty comment into your script at the current cursor location. Comment text is not compiled as part of the script, and will look like the code shown below: (*Comment*) You can also comment out a portion of existing code by using the Comment button while a portion of text in a script is selected. Tip: Because comments are not compiled with the rest of the script, you can use the Comment button to temporarily disable parts of a script. When you select comment text, this button changes to Uncomment. You can un-comment a previously commented portion of your script by selecting it and clicking the button. The selected text is then treated as a regular part of the script. 6. Insert: This drop-down list contains common commands and functions that you can insert into your script. When you choose an imagebased item from this menu, an Open File dialog box lets you select previously captured images as parameters to the chosen command or function. Choosing Add Image lets you insert the image into the script with no new command or function. The Find Text menu item opens the Find Text panel so that you can create an image based on text attributes. Tip: On Mac OS X, Shift-clicking the Insert drop-down list lets you use any of the commands there with an OCR Find Text search. 7. Handler: This drop-down list contains all of the handlers defined in the current script, including the script itself. You can choose a handler from the list to jump to its definition in the script. 8. Line Jump: In this field, you can enter a line number and press Return to jump to that line in the script. Note: If you have a handler selected in the Handler drop-down list, line number entered in the Line Jump field apply only to that handler. 23

24 9. Save: The Save button saves the current script. When a script has unsaved changes, a yellow dot appears in the close button in the top left corner of the Script Editor tab; the dot disappears when the script is saved. 10. Info: This button toggles a portion of the toolbar known as the Info pane. The Info pane contains supplemental information about the current script, and the Table Action pane, enables you to define any of your scripts as possible actions for tables. For more information, see Info pane [109] below. 11. SenseTalk Browser: This button is a toggle that shows or hides the SenseTalk Browser. It is displayed by default when the Script Editor opens. For more information about it, see The SenseTalk Browser [110]. Note: By default, eggplant Functional automatically saves scripts when you run them. You can change this behavior in Script Editor preferences. For more detailed information about creating scripts and running tests, see Creating Tests with eggplant Functional [111] in the Using eggplant Functional manual. The Info Pane The Info button on the right side of the toolbar opens and closes a portion of the toolbar known as the Info pane. The Info pane contains supplemental information about the current script, and the Table Action pane. The information in the Info pane includes: Length: This field tells you the number of characters in your script. Modified: This field tells you the date the script was last modified. Created: This field tells you the date the script was originally created. The Info Pane on the Script Editor's Toolbar Description: This text field lets you add information about the the purpose of the script or other pertinent notes. Table Action Pane The Info pane is also where you find the Table Action pane. The Table Action pane enables you to define any of your scripts as possible actions for tables. (You can find out more about tables on the Tables Pane and Keyword-Driven Testing [18] page.) The fields you can set in the Table Action pane are as follows: The Table Action Pane under Info on the Script Editor toolbar 24

25 Table Action Type: This drop-down list provides the following options: Not a Table Action: is for scripts that cannot be used in tables. This option disables the other options in the Table Action pane. It is the default setting. Execute: is for executing scripts that do not return a value to the table. Verify: is for executing scripts that you want to verify a value against an expected result after execution. Note: Selecting either the Execute or Verify option enables the Default Arguments field. Selecting Verify also enables the Default Expected Value field. Default Arguments: is an optional field that provides you with ways to enter default arguments for your script. For more information see, Specifying Table Arguments on the Tables Pane and Keyword-Driven Testing [18] page. Actual values: You can enter specific values you want as arguments in this field. Tokens: You can enter tokens in this field. Tokens provide a list of the text or images in your suite. If your argument is an image, use [@MyImageToken] in this field. If your argument is text, type [MyToken], where MyImageToken and MyToken are the names you want to assign your tokens. Default Expected Value: You can optionally enter a value or values in this field that you expect the script results to match. When you run the script from a table, it compares the expected value to the actual result it returns to determine if the run was successful. Note that you can also use the tokens described above in this field instead of an actual value. The SenseTalk Browser The SenseTalk Browser provides you with a quick-reference for the SenseTalk programming language while you are working in the Script Editor. Not only can you use it for a reference, but also to paste sample syntax from the SenseTalk Browser directly into your script. You can also add your own topics and SenseTalk code to the SenseTalk Browser. The SenseTalk Browser, when it is enabled, consists of the panes on the right side of the Script Editor. For more information, see The SenseTalk Browser [112]. The SenseTalk Browser in the Script Editor The SenseTalk Browser The SenseTalk Browser The SenseTalk Browser is a quick-reference tool for the SenseTalk programming language. It is built into the eggplant Functional Script Editor, where you can easily use it while you are working on your scripts. The SenseTalk Browser not only provides information about the language, but also sample code syntax and templates you can insert directly into your script and use. You can also add your own topics with SenseTalk code that you write, and then use them in the SenseTalk Browser the same way you use the provided topics. 25

26 Below you will find the following information about the SenseTalk Browser and how to use it: The SenseTalk Browser Panes [113] Using the SenseTalk Browser [114] Opening the SenseTalk Browser [115] Finding information [116] Editing sample code [113] Tokens [117] Working with custom snippets [118] The CustomSnippets.rtf file [119] The SenseTalk Browser Panes The SenseTalk Browser, when it is enabled, consists of the panes on the right side of the Script Editor window. The screen below shows the SenseTalk interface. The numbers on the screen correspond to the descriptions below it. For more information about the Script Editor, see The Script Editor [16]. The SenseTalk Browser with the TypeText topic selected 1. SenseTalk sample code: This code shows how sample code you insert from the SenseTalk Browser looks in a script. 2. Search bar: This window at the top of the SenseTalk Browser enables you to search for topics. 3. The SenseTalk Browser button: This button, which is on the Script Editor toolbar, is a toggle that shows or hides the SenseTalk Browser. 4. Topic pane: This top pane of the SenseTalk Browser lists the SenseTalk topics. 5. More on this topic: This button opens a web browser and displays the page for the selected topic in the eggplant Functional product documentation. 6. Plus (+)/Minus (-): These buttons add or remove a custom topic in the SenseTalk Browser. 7. Insert template/snippet into script: This left-facing arrow button inserts the sample code for the selected topic into your open script. 8. Syntax bar: This bar shows the sample SenseTalk code syntax or template for the selected topic. 9. Description pane: This bottom pane of the SenseTalk Browser shows a description of the selected topic. Using the SenseTalk Browser You can use the SenseTalk Browser to search for or display topics related to the SenseTalk programming language, including commands, control structures and more. Information about how to use the SenseTalk Browser and its features follows. Opening the SenseTalk Browser 26

27 The SenseTalk Browser displays by default when you open the Script Editor. You can hide the SenseTalk Browser by clicking the SenseTalk Browser button in the Script Editor toolbar. This button is a toggle that shows or hides the SenseTalk Browser. Finding Information The top pane you see in the SenseTalk Browser is called the Topic pane. The top-level list you see in the Topic pane consists of the topic categories: SUT interaction, value assignment, control structures, connections, reporting and so on. To find the information you want, you can browse the provided topics or use the search feature. When you select a category or topic, a description of it opens in the Description pane. If the topic includes sample SenseTalk code syntax or a template that sample displays in the Syntax bar. Browsing Topics Use the Topic pane to see the provided topics. 1. Scroll through list of categories in the Topic pane. 2. Expand a category to see the related topics below. 3. To display a topic, simply select it in the Topic pane. Using Search The SenseTalk Browser also provides a Search bar above the Topic pane that you can use to search for information in the SenseTalk Browser. Any topics that match your search criteria display in the Topic pane. Inserting sample code and templates For some topics, the SenseTalk Browser provides sample SenseTalk code syntax or templates that you can insert directly into your script and modify for use there. To insert sample code or a template, follow these steps: 1. Place your cursor at the point in your script where you want the sample code inserted. 2. Insert sample using one of the following methods: Double-click the topic that discusses the sample code or template you want, or Select the topic that provides the sample you want and click the Insert template/snippet into script button. Editing Sample Code After you insert the sample SenseTalk code or a template into your script, you need to edit it as appropriate for your script. Some of the SenseTalk Browser samples include placeholders, enclosed in square brackets. When you insert these placeholders into your script, they are inserted as tokens as shown below. Tokens Sample Click commands with tokens inserted into a script from the SenseTalk Browser Descriptions of the different types of tokens and how to use them follows: Text tokens: Text tokens are enclosed in square brackets. For example, the sample code for the Mouse Event Click [text] command is as follows: Click (Text:"[textToFind]"). After you insert a text token in your script, simply replace the token "texttofind" with the text you want your script to find. Some of the code samples contain coordinates in a similar format. For example, Click ([xcoordinate],[ycoordinate]). These coordinates are also text tokens. You replace them with x and y coordinates to specify a location. Image tokens: Image tokens are enclosed in square brackets and preceded with an "@" sign. For example, the sample code for the Mouse Event Click [image] command is as follows: Click "[@imagename]". After you insert an image token into your script, move your cursor over it to display a list of all the images in your current suite. Then select the one you want. The name of the image you select appears in the token. Statement tokens: Statement tokens are enclosed in square brackets and preceded with a dollar ($) sign. For example, the sample code for Reporting Test Case is shown below. After you insert a statement token, replace the [$statementstotest] with the statements you want your script to test. You can also select existing statements in your script and then insert a sample with a statement token. In this case, the selected text is automatically inserted instead of the token. BeginTestCase [testcasename] [$statementstotest] EndTestCase [testcasename] Paired tokens: If a snippet contains more than one occurrence of a token, eggplant Functional populates all occurrences of that token at the same time when you provide the value for one occurrence. For example, the previous example contains two occurrences of the text token " [testcasename]." When you replace one occurrence with text, eggplant Functional automatically replaces the second occurrence with the same text. Working with Custom Snippets The SenseTalk Browser enables you to add your own topics and sample SenseTalk code, which are called custom snippets. Once you add 27

28 them, you can use them like any of the provided topics. Any snippets you add display under the Custom Snippets category in the Topic pane. To add a custom snippet to the SenseTalk Browser, follow these steps: The SenseTalk Browser with a new custom snippet 1. Click the + button below the Topic pane. This inserts a topic, shown as Snippet 1 in the screen above, under Custom Snippets in the Topic pane. It also enables the Syntax bar and Description pane for editing. If you have existing custom snippets and you want to create sub-topics underneath them, select the custom snippet under which you want to create the sub-topic and then click In the Topic pane, rename the inserted snippet with the topic name you want. 3. In the Syntax bar, if you want to provide sample code, replace the text (enter snippet template here) with the syntax for your SenseTalk code or template. You can also use tokens in your code using the syntax described above. If your topic does not have sample code, leave it as is. 4. In the Description pane, replace the text (enter snippet description here) with the description you want for your snippet. 5. Save your new custom snippet by simply navigating away from its input fields. The SenseTalk Browser saves the snippet automatically. Once you save it, you can use your custom snippet and reuse its sample code like the other provided topics in the SenseTalk Browser. The CustomSnippets.rtf file The SenseTalk Browser saves the custom snippets you create in a file named CustomSnippets.rtf. You can also edit this file directly. Information about the location of the CustomSnippets.rtf file, how to edit it, and the syntax you need to use follows. File Location The CustomSnippets.rtf file is specific to your user account, or the user account you used to log into the machine and run eggplant Functional. The file location varies with different operating systems: Mac and Linux: ~Library/EggPlant/ Windows: C:\Users\user_name\AppData\EggPlant\ File Format The entry for each custom snippet in the CustomSnippets.rtf file consists of the topic name, a description, and optionally sample SenseTalk code syntax or a template. If you do not create any custom snippets using the SenseTalk Browser before you open the file, the file is empty when you open it. If you did create a custom snippet, you can see the format and syntax the file uses as shown below. Note: Because this is rich text file (.rtf), you may see formatting characters in some text editors, like Notepad++. The CustomSnippets.rtf file stores the custom snippets created in the SenseTalk Browser A description of the syntax you need to use for a custom snippet entry in the CustomSnippets.rtf file follows: Custom Snippets->nameVariable: The Custom Snippet is the category under which the SenseTalk Browser lists the custom snippets, and namevariable is the name of the snippet. Enter the name of your topic where namevalue is shown in this example. 28

29 @Template: This precedes the sample SenseTalk code or template. Leave it blank if your snippet does not have sample code. If your snippet does has a sample, enter it on the line(s) below this one as follows: In-line template: If you want your sample code to be inserted in-line, that is within an existing line. Enter the sample without a blank line after it. Multi-line template: If your sample has multiple-lines, separate each one with a newline character. blank line: After your last line of sample code, press Enter to insert a blank line. This blank line ensures the SenseTalk sample code is inserted on a new line within a script. Omit this blank line for in-line templates as described This precedes the description. Enter your custom snippet description on the line below This precedes a portion of the URL for a topic in the TestPlant documentation. Providing a URL is optional. If you want to include a link to a topic in the SenseTalk documentation that is related to your custom snippet, you include the end of the URL here. Important! The SenseTalk Browser automatically supplies the domain of the TestPlant documentation website: [120]. Thus, you only provide the part of the URL that follows the provided domain, and you can only provide links to pages in the TestPlant documentation. For example, suppose you want to include a link to a discussion of variables in the SenseTalk Reference. The full URL for that page is as follows: [121]. Thus, you only provide the "?q=content/variables" part of the URL here in the CustomSnippets.rtf file. If you do not want to provide a URL, leave the "@Documentation" text in the file. The SenseTalk Browser requires it to parse the file This designates the end of an entry. Important! Although you do not see it in the file, you must also include a newline character (i.e., press Enter) after signs. To parse the file properly, eggplant Functional requires this newline character. Editing the File You can use any text editor to edit the CustomSnippets.rtf file. To edit the file, follow these steps: 1. Open your text editor. 2. Open the CustomSnippets.rtf file in the text editor. Note: You may need to change the default file type in your text editor's Open/Browse window to *.* or.rtf to see the file. 3. Locate and select the file, and then click Open. 4. Make the edits you want in the file. Refer to File Format [122] above for information about formatting the custom snippet entries. Important! Any time you end a snippet entry with signs, be sure to press Enter at the end of the line, especially if it is the last line in the file. To parse the file properly, eggplant Functional requires a newline character at the end of line after signs. 5. Save the file. 6. Close and re-open the eggplant Functional application. The SenseTalk Browser lists the new or updated snippets under Custom Snippets in the SenseTalk Browser. The Image Viewer The Image Viewer This section describes the Suite window's Image Viewer and related panes used to create images and insert existing images into your eggplant Functional scripts. The Images Pane The Images pane on the left sidebar of the Suite window contains a list of all the images and image folders that are saved in the suite. Folders are identified by a triangle to the left of the name in the list; you can click the folder name to expand the list to show the images within. 29

30 eggplant Functional's Images pane in the Suite Window. If you hover the mouse over an image, a pop-up window displays the image itself. If you hover the mouse over a folder, a pop-up window opens, displaying the first image within the folder; a number in the upper right corner of the pop-up indicates the number of images in the folder. By default, folders are displayed first in the Images list, followed by images that aren't collected in folders. However, you can right-click in the Images list and clear the selection for Show Folders First if you want folders and individual images alphabetized together. Adding and Deleting Images There are two ways to add outside images to an eggplant Functional suite: Drag one or more images or image folders from another location into the Images list in the Suite window. Right-click in the Images list, select Add Images, then locate and add images or image folders through the file browser. Note: eggplant Functional accepts the following image file formats: TIFF, ICNS, ICO, PICT, GIF, BMP, PNG, PDF, and JPG/JPEG. To create a new image folder, right-click in the Images list, select New Folder, then enter a folder name. To delete an image or image folder, select one or more items in the image list, right-click, and select Delete. Searching Your Existing Images To search for images in your suite, type an image name or part of an image description in the Search field above the Scripts list. (Note: This search function searches all the panes in the left sidebar simultaneously.) To set a search filter, click the magnifying glass icon in the Search field and choose Search All, Search Names, or Search Contents from the drop-down list. Tip: The search works as you type, so you might find your results before you finish entering your search term. However, if you have searches that you frequently repeat, you can save your search as an item in the Search History by pressing Return after you type the term. Your search is saved on the drop-down list under the magnifying glass. The Image Viewer 30

31 When you select an image in the Images list, the main body of the Suite window displays the Image Viewer, which provides options for working with images. Image Preview When you click an image once in the Images list, it opens in preview mode. This mode lets you browse images in a temporary tab in the Image Viewer. Double-clicking an image or clicking in the preview display opens the image in a permanent tab. The Image Viewer's preview mode can be recognized by the gray background. Note: This preview feature is also available when browsing scripts, tables, results, and schedules. Image Viewer Components The Image Viewer consists of several distinct areas that let you browse and manipulate images in your suite. 31

32 1. Image Well When you select an image in the Images list, the Image Well shows you the captured image as it is currently saved. The image's hot spot is marked by red crosshairs. You can change the location of the hot spot by Ctrl-clicking (Cmd-clicking in Mac OS X) and dragging it to a new location. You can also nudge the hot spot one pixel at a time with Ctrl+Arrow key (Cmd+Arrow on Mac OS X). Adding the Shift key moves the hot spot in ten-pixel increments. Note: You can use these methods to move the image's hot spot outside the bounds of the image itself; however, because you aren't viewing the image in place on the SUT, you should be careful about doing so to avoid unpredictable results. 2. Image Name Field You can use this field to edit the name of the image. 3. Searching & Properties With an image selected in the Images list, the Searching & Properties section of the Suite window contains supplemental information about the selected image and lets you change certain properties: SearchType: Describes the level of precision eggplant Functional requires to consider a part of the Viewer window a match for your target image. The drop-down list lets you to select from the following settings related to the image search: Precise: The Precise search type requires a very high degree of precision to consider an image matched in the Viewer window. This setting is useful for images with subtle color differences or little contrast. Tolerant: The Tolerant search type accepts matches that have slightly different pixel colors caused by background and transparency changes. Tolerant searches are more forgiving than precise searches, so they reduce the chance of a script failing because of a minor variation in rendering. Text: The Text search type allows for dynamic font smoothing (text anti-aliasing) in images that contain text. If eggplant Functional sometimes fails to locate an image that contains text, try changing the search type to Text. Pulsing: The Pulsing search type allows for pixel colors that can change, such as the pulsing buttons in Mac OS X. Text & Pulsing: The Text & Pulsing search type allows for both changing pixel colors and text anti-aliasing. Tolerance: Lets you change the tolerance to color variation used in searching for the image. Discrepancy: Lets you adjust the percent or number of pixels that can be ignored when finding a match to the image. 32

33 Image Size: Displays the dimensions of the original image in pixels. Hot Spot: Lets you change the image hot spot by entering new coordinates; click the Center button to return the hot spot to the center of the image. Scale: Lets you scale the original image. Rotate: Lets you rotate the original image. Capture Screen Size: Displays the screen size of the SUT on which the original image was captured, and lets you change the values. Description: Lets you add a description of the image. Optional. 4. Image Doctor The Image Doctor is a utility that lets you adjust the search criteria for images that are not being found in the SUT Viewer window. Using the Image Doctor requires an active remote connection. To use the Image Doctor, select an image in the Image pane, and click the Search button. As the searches complete, the results for each type of diagnostic appear in this area. The searches include: Standard Search: Searches for the image in its normal state with no adjustments. Dynamic Tolerance: Searches by adjusting the image's tolerance setting. It starts at the image's normal tolerance setting and gradually raises the tolerance until the image is found in the Viewer window. Alternate Types: Searches by applying increasingly lenient search types until a match is found. Scaling Search: Searches by looking for the image at a variety of different scales, ranging from 0.5 to 2.0, until a match is found. Discrepancy Search: Searches by gradually increasing the image's discrepancy setting until a match is found. OCR Search: Searches for text in your image and attempts to find instances of that text on the screen. Prior Location: Searches the location where your image was last found in a successfully completed test. Note: You can choose a test run other than the most recently completed run by using the Mark As Prior Run button on the Results pane for the script. Original Location: Searches the location of the selected image at the time of original capture. The Status column displays the found status of each diagnostic. If the particular diagnostic search found the image in the Viewer window, the screen coordinates of the image are displayed in the Status column. The Info column displays information about how much each successful diagnostic changed the search criteria to produce a match. Working with the Image Doctor The Image Doctor provides several ways to use a selected diagnostic. The buttons below the diagnostic results become available when you select a particular diagnostic from the list. Note that options are available only for diagnostic searches that produced successful results, and not all options are available for all diagnostics. Show Original Image: This shows the diagnostic image with your original image overlaid to help you discern the difference between the two. Fix: The Fix option replaces your image's original search criteria with the search criteria that produced the diagnostic image match. Recapture: This recaptures your image at the location where the diagnostic image is found. Add Rep: The Add Rep option (for "Add Representation") turns your original image into an Image Collection and saves the diagnostic image as part of it. (For more information, see Creating an Image Collection [106].) 5. Image Browser This browser lets you navigate your images, seeing many or all of them at once. To open an image from here, simply click it. Tip: In this section, you can select multiple images at once by using Ctrl+click on Windows or Cmd+click on Mac, and then change settings such as the Search Type in bulk. Tables Pane and Keyword-Driven Testing Tables Pane and Keyword-Driven Testing eggplant Functional's Suite window includes the Tables pane, which is where you can set up and manage keyword-driven testing. You'll find the Tables pane on the left sidebar of eggplant Functional's Suite window. The Tables Pane The Tables pane of the Suite window lists all the tables defined in the current suite. When you select a table in the list, the table tab opens in the main suite window in preview mode (in a temporary tab). To open the table, right-click the table in the list and select Open, or click in the main pane when the table is displayed in preview mode. To create a new table, right-click in the Tables pane and select New Table. On Mac OS X, you can also click the gear icon on the Tables pane title bar and select New Table. When you create a new table, a new tab opens in the Suite window with a blank table, ready to be developed: 33

34 [123] Setting Up a Table eggplant Functional's Tables pane in the Suite window showing a newly created table. (Click image for larger view.) A new table consists of one blank row. Each time you define a row in the table, a new blank row is added to the bottom. You can also add a new row either above or below a row by choosing the appropriate option from the Action drop-down list on the toolbar or by right-clicking a row and selecting Insert 1 Above or Insert 1 Below. The table includes several columns; some of these are pre-defined, others you need to assign: Step: The first column includes the step number; this number is generated automatically and is not editable. Note that you can also click and drag on this column to re-order your table, and if you do so, the step numbers update automatically to reflect the new positioning. Action: This column includes a drop-down list where you pick the action you want to perform on this step. In addition to SenseTalk commands that are included here automatically, you can mark your own scripts to be accessible on the Action drop-down list; you do so on the Info pane of the Script Editor tab [124] for each script. Arguments: This column is where you enter arguments required by the command or script selected in the Action column. For more information on arguments, see the section below on Specifying Table Arguments [125]. Expected Value: This column lets you insert the value you expect from the chosen action; for instance, for a boolean expression, the expected value would be either True or False. Note: When you declare scripts as table actions, you can include placeholder text for the expected value or include a specific value. Actual Value: After the step runs, this column displays the actual value for the action or command. (This value is not editable by the user.) Pass/Fail: After a run, this field displays Pass and a green background if the Expected Value matches the Actual Value or Fail with a red background if they don't match. If the step encounters an exception, this column displays Error. If the line completes successfully but there are no values to compare, the table cell turns gray. Comment: The comment field lets you enter your own notes about this step. This field is optional and doesn't affect the running of the step in the table. Specifying Table Arguments The Arguments column in the table lets you pass arguments, if required, to the commands selected in the Action column. You can also pass arguments to scripts that you select as table actions. If you're passing multiple arguments for a single action, separate them with commas. When you use the drop-down list in the Action column to insert a SenseTalk command, a token for any required argument is inserted in the Arguments column, and the token includes text that describes what the expected argument should be: If the expected argument is an image, such as with the click command, the inserted token acts as a drop-down list, which includes all the images in the current suite. If the argument is text, such as with TypeText, the token acts as placeholder text; select the token and replace it with the text you want to use. Note: When you declare scripts as table actions on the Script Editor tab, you can define tokens and placeholder argument text or pass actual arguments that show up here when the script is selected as an action; for information about this process, see The Script Editor [126] page. You can highlight table action scripts by right-clicking in the Scripts list and selecting Show > Table Actions. Any scripts you've enabled for use in tables turn blue in the list. Passing Results as Table Arguments A table step can reference the results from previous steps as arguments. That is, if a step returns a result, that result can be used as an argument in a later step of the table. This ability effectively lets you pass table results to other table actions. To use a step result as an argument, you reference the line or step number by using the number sign (#) and the specific step number: # <step>. For example, to reference the result of step 3, you would use #3 as the argument. You can use #prev to reference the previous line. Table arguments let you pass results to later steps in the table. 34

35 You can also insert step references from the table toolbar or by selecting a row and right-clicking. Select Insert Reference from the dropdown list, then choose the step number or #prev. Note that if you insert multiple arguments with this method, the arguments are listed without commas, which is also valid syntax (the number sign serves as a separator). Step references in arguments are relative to the line they initially reference. If you later re-order the lines of the table, step references in arguments will update automatically so that they continue to point to the same action at its new step number. Note: You can't reference a result that occurs in a later step in the table. For instance, in step 2, you can't reference the result of step 5. If you re-order a table, be careful to ensure your references are still valid. You will get an error message if you attempt to run a table that has invalid references. Using Tables for Data-Driven Testing You can build a table that pulls information from an external.csv file for data-driven testing. For information about data-driven testing, see the "Data-Driven Testing" section of Gathering and Using Data [127] and Data Driven Testing with eggplant Functional [128]. To attach a.csv file, click the folder icon on the tables toolbar. In the file browser, locate the.csv file that you want to use, then click Open (Windows) or Choose (Mac). The file is referenced with a relative path. Best practice is to store your.csv files inside the suite folder that will be accessing the file, which will allow you to access the file without needing to qualify or re-establish the path if you connect to eggplant Functional remotely or if you move the suite itself. Note: Your.csv file must include a header row as its first row. Headers must be single words (i.e., no spaces); they can include underscores but no other special characters. You can reference values from an attached data file in the Arguments column and the Expected Value column. To reference a value, you call the name of the column in the.csv file, preceded with the dollar sign ($). For example, if the first column in your data file is called Location, you would insert $Location to call values from that column. [129] You can use eggplant Functional Tables for data-driven testing. (Click image for larger view.) A typical run of a table performs each table action one time; however, when you attach a data file for data-driven testing, the table runs through fully once for each line of data in the file (excluding the header row, of course). Each iteration accesses one row of data; within that iteration, all the rules of tables apply, including the ability to pass results to later steps. However, no values are passed between iterations; each pass of the table begins with a new row of data from the.csv file. Responsiveness Testing with Tables You might want to test or validate how long a table run takes to execute, or even how long specific steps take. You can perform responsiveness testing with the BeginTimer and EndTimer commands on the Actions drop-down list. When you insert a BeginTimer command, you can include an argument, which would be a name for the timer. The name argument is optional; however, naming the timer lets you use nested timers. For instance, you could have a timer named Main as the first and last lines of your table so that it provides a timing for the whole table; within the table, you could enclose a subset of steps in a timer called Test1, which would allow you to validate a specific procedure within the table. There is no Expected Value or Actual Value for BeginTimer. The argument for EndTimer is the name of the timer you want to "stop." If the timer doesn't have a name, leave the argument blank. Note, however, that the timer doesn't actually stop. Instead, it outputs the current timer value to the Actual Value column, and the timer continues running. Therefore, you can start a single timer, then use EndTimer to check time values at multiple points in your table run. In the Expected Value column for EndTimer, you can insert a value that might be your timing goal for reaching that step of the table. Remember that the Actual Value will be the value of the timer at that point, in seconds. The Expected Value you use should be expressed as a simple comparison; for example: < 1 minute > 2 seconds <= 42 Note that if you don't specify the units, seconds is assumed. Your Expected Value is compared against the Actual Value to provide a Pass/Fail value for the step. The Table Toolbar Above the table, you'll find the toolbar, which contains several controls: The Tables toolbar lets you manipulate tables for keyword-driven testing. 35

36 1. Run Table Script: This button begins a run of the table. In a typical run, all the steps in the table are performed once, in sequence. However, if you have attached an external file (.csv) for data-driven testing, the run performs each line of the table once for every row of data in the.csv (excluding the header). Even if an individual step fails, the run continues to the next step. During a run, the Run button changes to Abort Table Script so that you can stop the run. 2. Run selection: This button lets you run selected rows from the table. Click to highlight the step or steps you want to run. You can use Shift+click or Cmd+click (Mac)/Ctrl+click (Windows) to select multiple rows. Note that the rows you choose for Run selection don't have to be contiguous, but they will always run in order. 3. Pause Table Script: You can use this button to pause a running table script. Click the button again (Continue Table Script) to resume running the table. 4. Show results for this table: This button takes you to the Results pane and opens the tab for the the current table. 5. Action: The Action drop-down list includes options for working with the table. Most of these options are available only when you have a line (or lines) selected in the table. The options are: Insert 1 Above / Insert 1 Below: Inserts a new line in the table either above or below the currently selected line; these options are available only when a single line is selected in the table. Delete Row(s): Permanently deletes the selected row or rows from the table. Disable Row(s): Disables the currently selected row or rows. Disable rows are preventing from running; you can re-enable a disabled row by clicking it and selecting Enable Row(s) from the Action drop-down list. Clear results: Clears the results from the last execution of the table from the Pass/Fail column and the Actual Value column (for any row that receives an Actual Value). Reset Arguments: Resets the argument for the selected row or rows to the default value for the currently selected action; if there is no default value for an action, any value is cleared. Reset Expected Value: Resets the expected value for the selected row or rows to the default value for the currently selected action; if there is no default value for an action, any value is cleared. Insert Reference: This option lets you insert a reference to a specific line to use the result of that line as an argument. You can also insert the shortcut #prev to refer to the result of the previous line. 6. Data driven test file: If you have attached a.csv file for data-driven testing, the file name shows in this field, along with the relative path. Use the X (delete) button to the right of the field to remove a.csv file. Use the folder icon button to open the file browser to attach a.csv file for data-driven testing. 7. Info: The Info button toggles a pane of additional information: table Length (in number of rows, i.e., steps), Modified date, and Created date, as well as a Description field you can use to include notes about the current table. 8. Save: This button saves the current table. Typically, updates are saved automatically. However, whenever the table contains unsaved changes, the close icon of the tab changes to a yellow circle; if you attempt to close the tab or the Suite window, you'll get an Unsaved Changes warning. Note: Tables can't be added to schedules [20]. To learn more about using the tables feature to implement keyword-driven testing, see Using eggplant Functional for Keyword-Driven Testing [130]. Results Pane Results Pane The Results pane of the Suite window contains records of the tests you have run in the current suite. You'll see statistics for each test you've run for each script and table by date and time; the complete log for each test; and images for any image-based step in the log, including fullscreen images captured in cases of failure. 36

37 eggplant Functional's Results Pane 1. The Results List and Run Date List Every script and table that you test is recorded in the Results list in the Suite window's left sidebar. When you click an item in the Results list, the dates and times when that script or table was tested show in the Run Date list in the main pane of the window. The Run Date list is color-coded to denote test results: Green: Success Red: Failure (for tables, if any row fails, the result will show as Failure) Black: Aborted or Interrupted For each run date, the list displays the number of errors, warnings, and exceptions that occurred in the run. (For more information, see The ScriptLogging [131] in Global Properties.) Resource Links Each run date listing includes an arrow that links to a results resource. Click the arrow to open a LogFile.txt file, which contains a line-by-line record of the run. Note: You might need to scroll this window or expand it to the right to see the clickable arrows. Delete Log(s) The Delete Log(s) button deletes the selected script or table logs. This action requires confirmation. Mark As Prior Run The Mark As Prior Run button lets you choose any of the run dates to serve as the "prior run" when using the Prior Location diagnostic in the Image Doctor. Only one run date at a time can be chosen as the prior run. If no prior run is selected, the Prior Location diagnostic uses the most recently completed successful run. 2. Statistics Area and Image Well 37

38 The Statistics area shows statistics related to the script or table selected in the Results list. In addition to the date and time the test was first run and last modified, you can see the total number of times it has been run, including number and percents of successes and failures. You can click the Reset Stats button if you want to clear all the run statistics for the current script or table. Below the Statistics is an image well. When you select a script step in the Log Area (described below) that includes an image, that image appears in the image well. If the image is part of an image collection, the number of images in the collection appears in the top right corner of the image well. 3. The Log Area When you select an item in the Run Date list, the Log Area at the bottom of the Suite window shows the detailed log for that run. The log shows each step that executed an eggplant Functional command or function. Note: The eggplant Functional commands are an extension of the SenseTalk scripting language; for more information about using the core SenseTalk language for advanced scripting, see the SenseTalk Reference Manual [60]. When you view log results for table runs, you'll still see a line for each step, but note that when you call a script as a table action, that script can perform many steps; each step in the script appears as a line in the log of the table run. You can double-click any step to open the Script Editor tab with that step highlighted. For each numbered line, the Log Area provides the following information: Time: The Time column shows the local system time when each step occurred. Times are recorded to the nearest thousandth of a second. (You might have to widen the column to see fractional seconds.) Message: The Message column displays the name of the function or command that was executed. (In SenseTalk, command and function calls are referred to as messages.) If an error occurred in the line, Exception is displayed. If the exception wasn't caught, the following lines display EndTestCase and Failure. Image: The Image column displays the name of any image used by the command or function in that step. Resource Link: When the Image column displays the name of an image, the Resource Link column (which is the narrow, unlabeled column to the right of the Image column) contains a link that opens the image's tab in the Image Viewer. Note: If the image is the result of a CaptureScreen command, the image opens in your default image viewing application. Text: The Text column displays additional information, such as the coordinates where images were found and descriptions of errors encountered. Action Drop-Down List The Action drop-down list above the Log Area contains several actions that you can perform on the selected log entry in the Log Area: Show Script Line: Opens the Script Editor and highlights the line of the script associated with the selected log entry. Show Image: Switches to the Image Viewer tab for the image associated with the selected log entry. Apply Fix: For log entries that were generated by the Auto Doctor, this action permanently applies an Auto Doctor fix to the selected image. Searching for Log Entries To search for log entries, type a search term (such as a command or image name) in the Search field above the Log Area. To set a search filter, click the magnifying glass beside the Search field, and choose All Entries, Interesting Entries, or Errors & Warnings from the drop-down list. (Interesting Entries include: warnings, errors, exceptions, log commands, start, and end.) Tip: To save your search term as an item in the Search drop-down list, press Return after you type the term. Schedules Pane Schedules Pane Schedules let you collect scripts together that you want to run in a sequence. You can have multiple schedules that appear in the Suite window's Schedule's pane in the left sidebar. When you select a schedule, it opens a Schedules tab in the main Suite window. 38

39 The Suite Window's Schedules Pane The Schedules Pane The Suite window's Schedule pane on the left sidebar contains a list of all your defined schedules. To create a new schedule, right-click in the Schedule list and select New. On Mac OS X, you can also click the gear icon at the top of this pane to find the New option. The new schedule appears in the list with a default name; you should pick a meaningful and recognizable name for your schedules. When you select a schedule in the Schedules list, the Suite window shows the schedule in preview mode (in a temporary tab). To open the schedule in a permanent tab, right-click the schedule in the Schedules list and select Open, or simply click in the main pane while it's selected. To learn about using schedules to run tests, see Running Scripts using eggplant Functional Schedules [132]. Sessions Tab Sessions Tab The Sessions tab is for use with Turbo Capture>, one of the test creation workflows available as a part of eggplant Functional. To learn how to use the Turbo Capture through this tab and through the Viewer window [3], please see Creating Tests with eggplant Functional [89]. 39

40 In the bottom left corner of the Suite window, there is a Sessions button. This opens the Sessions tab, which contains information about all previously recorded Turbo Image Capture sessions. This tab is used to manage these sessions, as well as use them to generate scripts. This tab provides options to record new Turbo Capture Sessions, edit existing sessions, or delete sessions. Creating a New Session To create a new session, click Start Turbo Capture Session. Then, follow the instructions available under Creating Tests with eggplant Functional [111] to record and edit the session, and generate a script. Editing an Existing Session To edit an existing Turbo Capture Session, click Open Session. More information on editing sessions is available on the Creating Tests with eggplant Functional [89] page. Deleting Turbo Capture Sessions To delete a Turbo Capture Session, select the session to be deleted, and click the Delete button. Turbo Capture Sessions should be deleted periodically, as they take up a fair amount of space on your computer. Each action is recorded alongside a full-resolution screenshot of the SUT at the time the action took place. Multiple sessions can be deleted at once by selecting multiple sessions and then clicking the Delete button. Tip: You can tell whether or not a script has been generated from the session by looking under the "Status" column in the table on this tab. Three statuses are possible: New. The session has been recorded, but no editing has been completed yet. In Progress. Some editing has taken place, but no script has been generated from this session. Script Generated. The session has been edited and a script has been generated from this session. If a script has already been generated from the session, it is a good idea to delete that session, so that unnecessary space is not being taken 40

41 up on your computer. Settings Tab Settings Tab The Suite window's Settings tab contains general information about the current eggplant Functional suite. You can access the Settings tab by clicking the Settings button at the bottom left of the Suite window. Settings Tab Components The Settings Tab of the Suite Window The Settings tab consists of four sections that provide information and let you set defaults for your suite. These four sections are described below. 1. The Helper Suites Pane The Helper Suites section on the Setting tab contains a list of the suites whose scripts, images, and helpers are available to the current suite; such attached suites are known as helper suites. Helper suites are useful as core suites, with scripts and images that you use across several other suites. The table shows the following information about each helper suite: Relationship: Shows how the helper suite is related to the current suite; either Includes if the current suite can access resources from the helper suite, or Included by if another suite accesses the current suite as a helper suite. Helper Suite: Displays the name of the attached helper suite. Path: Shows the file path of the helper suite; red text indicates a file path that is no longer valid. Double-clicking a helper suite in the list opens that suite (or brings it to the front). Adding or Removing a Helper Suite 41

42 To add a helper to your suite, click the Add button and browse to select the suite you want to add. To remove a helper suite, select it and click the Remove button. When you remove a helper suite, scripts in the current suite can no longer access that helper suite s scripts, images, and other helper suites. Using a Relative Path for a Helper Suite You can change the path of a helper suite to make it relative to your Home directory or your Default Suite Directory. To edit the path of the helper suite, select the helper suite in your Helper Suites pane and click in the path. Paths that start with a tilde (~/) are relative to your Home directory. Paths that start with a dot (./) are relative to your Default Suite Directory [133]. For more information about using helpers, see Helpers [134] in the SenseTalk Reference manual. 2. Utility Scripts The Utility Scripts section lets you declare pre-run and post-run scripts; you can also choose a script from the current suite to act as a template for all new scripts. Setting Pre-Run and Post-Run Scripts If you set a pre-run script, this script executes before every script run in the current suite. A post-run script executes at the conclusion of every script run. You select pre-run and post-run scripts in the Utility Scripts section of the Settings tab. All the scripts in the suite are available to select from the drop-down list for both pre-run and post-run. Note that only scripts from the current suite are able to serve these functions. The pre-run and post-run scripts have check boxes next to them. If you've defined these scripts for your suite but want to run a script without the pre-run or post-run script, you can deselect the check box for that run. Using Pre-Run and Post-Run Scripts A pre-run script is called with three parameters: The full path of the script that is about to be run. A list of all of the parameters (if any) that will be passed to the script about to be run. The full path to the log file that will be created during the script run. You can use the pre-run script to change the parameters that are passed to the script. To do this, the pre-run script should return a property list with a "parameters" property whose value is a list of the parameters. A post-run script is called with two parameters: The full path of the script that was run. The scriptresult property list for the run, which is similar to the result returned by the RunWithNewResults command. In addition to the parameters and return values described above, pre-run and post-run scripts can interact with the script being run through a shared environment. For instance: Connections: If you open a connection in the pre-script, it will be the active connection when the script being run starts. Global and Universal Variables: These types of variables are common across all three scripts. Global Properties: These properties are common across all three scripts, including the InitialSuites and the FinalSuites properties. New Script Template You can also specify a template script for new scripts in the Utility Scripts section of the Settings tab. If a template script is chosen, each new script that is created in that suite begins as a copy of that script. All the scripts in the suite are available to select from the drop-down list as the template script for the suite. Note that only scripts from the current suite are able to serve as a template. 3. Results Directory This Results Directory area shows the file path of the current suite's results. You can click the Browse button if you want to select a new directory in the file browser. 4. Suite Description This text field is a place for you to record your own notes about the current suite. The Run Window The Run Window The Run window displays information about the currently running script. In the Run window you can manually control script execution, view script output as it is generated, see and modify variables, and follow the progress of the script with animation or tracing. 42

43 1. The Run Window Toolbar [135] 2. The Script Frame Pop-Up Menu [136] 3. The Script Display Pane [137] 4. Dynamic Breakpoints [138] 5. The Log Pane [139] 6. The Ad Hoc Do Box and Do Button [140] 7. The Variable Watcher Pane [141] 8. Add/Remove List and Property List Items Buttons [142] 1. The Run Window Toolbar The eggplant Functional Run window The Run window toolbar contains buttons and menus for the tasks you can perform while your script is running. When you change the width of your Run window, the buttons and menus available on the toolbar change. If you see the >> button, it indicates there are more options. When you click >>, a menu displays showing the buttons and menus that do not fit in the Run window at its current size. You can also customize your toolbar. For information about customizing your toolbar, see Customize Toolbar on The Window Menu [13] page. 1. Run Script/Abort Script: The Run window toolbar The Run Script button reruns the last script that was run, or the entire script from which a selection was run. While a script is running, the Run Script button becomes Abort Script. While a script is running (and not paused), you cannot perform any manual actions in the Viewer window, or open and close VNC connections. Note: You can run the script in debug mode by Alt-clicking (Option-clicking on Mac OS X) the Run Script button. This loads the script for execution and immediately pauses it, allowing you to step through line by line. (This is the same as choosing Run menu>debug Script.) 2. Run Selection The Run Selection button executes only the selected part of a script. The selection does not have to include an entire line of code, but it must be syntactically complete and executable. (For example, if you select the beginning of an if block, you must select all the way through the end if statement.) You can run the selection in debug mode by Alt-clicking (Option-clicking on Mac OS X) the Run Selection button. This loads the selection for execution, but immediately pauses it, allowing you to step through it line-by-line to closely follow its execution. Note: When you run a selection, results are not generated in the Results pane of the Suite Editor. 3. Pause / Continue The Pause/Continue buttons allow you to pause and continue execution whenever a script is running. When the script execution is paused, you can perform additional operations: Type commands in the Ad Hoc Do Box. (See The Ad Hoc Do Box and Do Button [140] section below.) Use the debug mode tools: Step Into, Step Over, and Step Out. (See below.) Interact with the Viewer window in Live Mode. 4. Step Into 43

44 The Step Into button executes the next line of a script, then pauses. If this line calls another script or handler, the script steps into the first line of the called script or handler before pausing again. Note: The Step Over button performs a similar function, with one exception: If the line calls another script or handler, Step Over executes the called script or handler entirely before pausing. 5. Step Over Like Step Into, Step Over executes the next line of the script, then pauses. However, if this line calls another script or handler, that script or handler runs in its entirety, stepping over it to the next line of original script before pausing again. During the execution of the script or handler that is stepped over, you can click Pause to regain control of the execution before the Step Over command has finished. 6. Step Out Step Out executes all the remaining lines in the current script or handler, then pauses. (Using Step Out on your initial handler is the same as clicking Continue.) During the execution of the code being stepped out of, you can click Pause to regain control before the Step Out command has finished. 7. Edit Script The Edit Script button opens the Script Editor for the script that is currently in the Run window. If you have text selected when you click this button, eggplant Functional attempts to automatically select the same text in the Script Editor. (If the selected text has been edited since the last run, eggplant Functional may not be able to find it in the Script Editor.) 8. Show Results The Show Results button opens the last recorded results for the current script, in the Results pane of the Suite window. 9. Show Suite The Show Suite button opens the current script s suite in the Suite windo. 10. Animation The Animation selection box highlights the current line of code in the Script Display area of the Run window while the script is running. You can change animation settings at any time with immediate effect, including while a script is running. Animations cause scripts to execute more slowly, because eggplant Functional is doing more work at the display level. You can improve script execution speed by turning off all animations when you are not debugging. The Animation options are available as a selection box or pop-up menu, depending on how wide your window is. If it is wide, you see the selection box. If it is narrower, you see it as a pop-up menu on the >> menu. Animation Off: The Display area of the Run window does not update as the script runs; only the initial handler for the script is shown, unless the execution is paused. Animate Calls: The Run window shows each script or handler as it is called, but it does not highlight each line of the script. Animate All: The Run window highlights each line of each script or handler while it runs. Note: Animation settings can also be modified temporarily by scripts. (For more information, see the ScriptAnimation in Global Properties [42].) The >> button The >> button indicates more options are available on the Run window tooblar. When you click it, a menu displays showing the buttons and menus that do not fit on the Run window toolbar at its current size. When you change the size of your Run window, the buttons and menus on this menu change. When your Run window is wider, more of the buttons and menus show on the toolbar. When your Run window is narrow, more of the buttons and menus show on the menu. Tracing The Tracing menu is available as a selection box or pop-up menu, depending on the width of your window. The Tracing menu on the Run window toolbar Tracing causes eggplant Functional to "echo" information about what the script is about to execute to the Log Area in the Run window. This is similar to animation, but it allows you to review all of the code that is executed during the script run, interspersed with logged output. This can provide more context when debugging a script. You can change trace settings at any time with immediate effect, even while a script is running. Note: Trace settings can also be modified temporarily by scripts. (For more information, see the ScriptTracing in eggplant Functional Global Properties [77].) 44

45 Tracing Off: Only standard log messages are displayed in the Log Area of the Run window. Trace Calls: The Log Area of the Run window displays a message as it enters and leaves each script or handler. Trace All: The Log Area of the Run window displays every line of each script or handler prior to executing it. Note: Tracing causes scripts to execute more slowly, because eggplant Functional is doing more work at the display level. You can improve script execution speed by turning off tracing when you are not debugging. The Doctor The Doctor menu allows you to specify whether or not you want to use the Image Doctor and, if so, how you want to use it: manually or automatically. For information about the Image Doctor, see Image Update Tools [78]. The Doctor menu is available as a selection box or pop-up menu, depending on the width of the Run window. Doctor off: The Image Doctor is not used during script execution. The Doctor menu on the Run window toolbar Manual Doctor: The Image Update panel opens when an image fails. You can choose to proceed with a corrected image, or allow the script to fail. Auto Doctor: the Image Doctor automatically attempts to correct image failures and continues the script execution. In this case, eggplant Functional does not open the Image Update panel and the initial image failure is logged as a warning. Multiple Found The Multiple Found menu provides options for you to specify what you want to do when a script finds multiple occurrences of the same image or text during a search that were not anticipated by the script. The Multiple Found menu is available as a selection box or pop-up menu, depending on the width of your Run window. The Multiple Found menu on the Run window toolbar Use First Instance: eggplant Functional uses the first occurrence of the image or text that it finds. It does not search for other occurrences and the script continues to run. This is the default setting. Show Panel: eggplant Functional displays the Image Update panel when it finds multiple occurrences of an image or text, like it does when it cannot find an image. When eggplant Functional finds multiple occurrences, this panel opens with the Start tab in focus, alerting you to the problem. You can choose to Diagnose and Fix the Problem or Capture a New Image. This panel has a count-down. If you do not select an option, at the end of the count-down, eggplant Functional uses the first occurrence and the script continues to run. For more information about options and the panel, see The Image Update Panel [78]. Important! The Image Update panel only opens when the Doctor menu is set to Manual Doctor on the Run window. See The Doctor Menu above for information about using this setting. Log Warning: eggplant Functional writes a warning indicating it found multiple occurrences of an image or text to the log. In this case, it uses the first occurrence and the script continues running. You can see this warning in the Run window Log pane, with the rest of the logged script events. Throw Exception: eggplant Functional raises an exception. If your SenseTalk script contains exception handling code for multiple occurrences of an image or text, it proceeds as specified in the exception handling code. If it does not, the script fails. Show Variables The Show Variables menu provides options for the Variable Watcher feature. The Variable Watcher feature (7. Variable Watcher Pane [141]) described below allows you to see and modify the effective SenseTalk variables while your script is paused or running. Note: The Variable Watcher does not continue to display variables after a script finishes running. The Show Variables menu is available as a selection box or pop-up menu, depending on the width of your Run window. 45

46 The Show Variable menu options are as follows: The Show Variables menu on the Run window toolbar Never: This option disables the Variable Watcher and hides the Variable Watcher pane on the Run window. When Paused: This option enables the Variable Watcher and shows the pane in the Run window. With this setting, you can only see and modify the variables when a script is paused. Always: This option enables the Variable Watcher and shows the pane in the Run window. With this setting, you can see and edit the variables both while a script is running and while it is paused. Note: Even when you use the Always setting, the variables only display while your script is running or paused. You will not see them after your script finishes running. 2. Script Frame Pop-up Menu The Script Frame pop-up menu displays the handlers that are being executed, listed in the reverse order in which they are called. When script execution is paused, you can select a different frame from this pop-up menu to view it in the Script Display area and see which line it is currently executing. This also sets the context for commands typed into the Ad-hoc Do Box. For example, if you want to output the value of a variable that is present only in the script handler that started your execution, you must make sure to select the very bottom frame, numbered Script Display Pane The Script Display pane is the top half of the Run window. When script animation is turned on, the currently executed handler is displayed here. (When script animation is turned off, the initial handler is displayed, but it is only updated when the script is paused.) Note: A handler is a unit of execution in SenseTalk. If a script does not explicitly declare a handler, the entire script is treated as a handler. (For more information on handlers, see the SenseTalk Reference Manual.) 4. Dynamic Breakpoints Dynamic breakpoints are markers that cause a script to pause for debugging at designated points. They can be added or changed at any time, even while the script is running. You can set a dynamic breakpoint in the Run window by clicking in the column to the left of the Script Display area. A black triangle appears next to the line, denoting the breakpoint. (You can also set a breakpoint at your insertion point in the script by choosing Run menu>set Breakpoint.) You can move a breakpoint by dragging the triangle to another line in the script, or remove it by dragging it out of the column. 5. The Log Pane The Log pane is the lower half of the Run window. As the script runs, the Log pane displays the following information: 1. The same information that is recorded in the script s permanent log. (See the Results pane, in The Suite Editor.) 2. The output of Put commands that have no specific destination. 3. Script tracing information, when Script Tracing is turned on. (See the ScriptTracing, in eggplant Functional Global Properties [77].) 4. Output from commands entered in the Ad-hoc Do-Box. (See the Ad-hoc Do-Box, below.) 6. The Ad Hoc Do Box The Ad Hoc Do Box (AHDB) allows you to modify a script while it is running. You can enter SenseTalk code in it to assign new variable values, execute commands, or call other scripts. It also keeps a history of everything you enter, so you can rerun previous entries. AHDB is located at the bottom of the Run window and is always shown. Note: The AHDB executes the SenseTalk Do command to run your code. However, you will not see this command in the log when you use it. Using the Ad Hoc Do Box Entering SenseTalk Code To use AHDB, simply enter the SenseTalk code you want in the box as follows: 46

47 1. Type your first line of code in the box. For each additional line, press the alt + keys on Windows and Linux or Option + keys on Mac. You can enter up to 10 lines and the box will automatically expand to accommodate them. Use the arrow keys to move between lines when you have multiple lines. Important! Pressing Enter in AHDB has the same effect as clicking the Do button it executes the code. It does not function like a carriage return for you to enter a new line. 2. Click Do or press Enter to execute the code. Note that if you click Do while your script is paused, your code executes and then pauses again. You need to click Continue to continue running your script. If you click Do while your script is running, eggplant Functional finishes the line of code it is currently processing, and then executes the code you entered and continues running the script. Working with the History AHDB also provides a history option. This enables you to return to code that you previously ran and run it again. The history is saved for the duration of the eggplant Functional session. It will be cleared when you restart. To scroll through the History, use Alt + the up and down arrow keys on Windows and Linux, or Option + the up and down arrow keys on Mac. 7. The Variable Watcher Pane The Variable Watcher, when it is enabled, is the pane on the right-side of the Run window. The Variable Watcher enables you to display the effective variables and edit their values while your script is paused or running. You can also configure the types variables you see: local, global, universal or any combination of them. For more about using it, see the Variable Watcher [143]. Note: The Variable Watcher does not continue to display variables after a script finishes running. 8. The Add/Remove List and Property List Items Buttons The plus (+) and minus (-) buttons below the Variable Watcher pane enable you to add or remove an item from a list or property list in the Variable Watcher while your script is running or paused. For more information about using lists and property lists, see Lists [144] and Property Lists. [145] For more information about using the Variable Watcher, see Variable Watcher [143]. The Variable Watcher The Variable Watcher The Variable Watcher, when it is enabled, is the pane on the right-side of the Run window [5]. The Variable Watcher enables you to display the effective SenseTalk variables and edit their values while your script is paused or running. It also provides you the option to configure the types of variables you show or hide: local, global, universal or any combination of them. For more information about SenseTalk variables, see Variables [146]. Note: The Variable Watcher does not continue to display variables after a script finishes running. Below you will find the following information about the Variable Watcher: Using the Variable Watcher [147] Enabling/Disabling the Variable Watcher [148] Specifying the types of variables to show or hide[149] Changing variable values [150] Adding/removing items from lists or property lists [142] 47

48 The Variable Watcher pane in the eggplant Functional Run window Using the Variable Watcher Information about using the Variable Watcher is provided below, including how to enable it, how to specify what variables you want to show, and how to change variable values. Note: The Variable Watcher truncates variable values to 40 characters. To see and edit longer values, see Displaying the Expanded Edit Pan [151]e below. Enabling/Disabling the Variable Watcher To enable or disable the Variable Watcher, from the eggplant Functional application Run menu, you can choose Show Variables and select an option there. You can also use the Show Variables selection box or menu on the Run window toolbar [5]. The options for using the Variable Watcher follow: Never: Disables the Variable Watcher and hides the pane from the Run window. When Paused: Enables the Variable Watcher pane and displays the variables only when your script is paused. Always: Enables the Variable Watcher pane and displays the variables both while your script is running, and when it is paused. Note: Even when you use the Always setting, the variables only display while your script is running or paused. You will not see them after your script finishes running. Specifying the Types of Variables to Show The Variable Watcher provides the Show Variable Types menu for you to specify the types of SenseTalk variables you want to show or hide. SenseTalk uses local, global and universal variable types. Check marks on the menu indicate the types of variables currently selected to show. For more information about SenseTalk variables, see Variables [146]. To display the Show Variable Types menu, follow these steps: The Variable Watcher Show Variable Types menu 1. Click the drop-down button, highlighted in the screen above, to display the Show Variable Types menu. The menu opens, showing the variable types available. These menu items are toggles that show and hide the variable types. The variables selected to show have check marks; the variables that do not have a check mark are hidden. The menu provides the following variable types: Show Local Variables and Show Unassigned Locals: shows the effective assigned and unassigned local variables. Show Global Variables: shows the effective global variables. Show Universal Variables: shows the effective universal variables. 2. Select the type of variable you want to show, or ded. You can only select one option at a time. The menu closes after you make your selection. The selections are listed in the bar at the top of Variable Watcher pane. For example, Locals and Globals are the currently selected values in the screen above. 3. If you want to select additional variable types, repeat step 2. If you change the variable type selections while your script is paused, you will see variables based on your new selections in the Variable Watcher when you continue running your script. If you change selections while your script is running, eggplant Functional finishes the line of SenseTalk code it is currently processing and then implements the new selections. The Variable Watcher shows the variables based on the new selections when they take effect. Changing Variables Values You can change a variable value in the Variable Watcher either when your script is paused or while it is running. 48

49 To change a variable value, follow these steps: Editing a variable value in the Variable Watcher 1. Select the variable value you want to change in Value column. 2. Replace the existing value with the new value you want and press Return. If you change a variable value while your script is paused, the new value takes effect when you continue running your script. If you change a value while your script is running, eggplant Functional finishes the line of code it is currently processing and then the new value takes effect. Thus, you may not know exactly when the change takes effect. Displaying the Expanded Edit Pane The Variable Watcher truncates values in the Value column. To see a long variable value, you can display it in an expanded edit pane as follows: 1. Double-click the variable value you want to change in the Value column to begin editing it. You edit the shorter values right in the column. For longer values, which don't fully display in the column, the expanded edit pane opens as shown below. 2. View the full variable value. You can also edit variable values in this expanded pane as follows: Select the variable value you want to see and double-click it. 1. Display the variable you want in the expanded edit window as described above. 2. Replace the value in the pane with the one you want. 3. Click Save. The new value displays in the pane and at least partially in the Value column above. Adding or Removing an Item from a List or Property List The Expanded Edit pane in the Variable Watcher If your script includes a list or property list, you can add or remove an item from it using the plus (+) or minus (-) buttons below the Variable Watcher pane. The buttons remain disabled until you click within a list or property list. For more information about using lists, see Lists [144]. For more information about using property lists, see Property Lists [145]. Both of these topics are discussed in the SenseTalk Reference [60]. Adding a List Item or Property To add a new item to your list or property to your property list, follow these steps: 1. If you see only the name of the list or property list (like suitepath shown in the screen below), click the disclosure triangle to display its list items or properties. The + button is disabled when the selected list or property list is closed, or it applies to the parent list or property list if any. 2. Select the appropriate row in the Variable Watcher for where you want to add the new item. The following describes what to select depending on where you want the row inserted: Lists: If you select the row containing the name of the list, the new item is inserted as (item 1) at the top of the list as shown in the screen below. If you select any other item in the list, the new item is inserted underneath the selected item with the name (item x), where x is the number of the item in the list. This also applies to nested lists. Property list: Regardless of what row you select in a property list, the new item is inserted into the list where it fits alphabetically. Click the plus (+) button. 49

50 If you are adding a new list item, the item is inserted into the Variable Watcher pane. Note that the new item has a name (item x) but not a value. Variable Watcher with a new list item inserted in a list If you are adding a new item (property) to a property list, the Add Property to dialog box, shown below, opens for you to add your new property name. Note that suitepath shown in the screen below will be the name of the property list you selected and to which this new property will be added. Enter the name you want for your new property and click OK. The Variable Watcher Add Property to property list dialog box Add a value for your new list item or property by placing your cursor in the Value column to the right of your new item, entering the value you want, and pressing Enter. The value is now saved for your new list or property list item. Removing an Item from a List or Property List To remove an item from a list or property list, select the item and click the minus (-) button. eggplant Functional Preferences eggplant Functional Preferences This section talks about all of the different preferences available in the eggplant Functional Preferences. These options are available under the eggplant menu [7] in the application. General Preferences eggplant Functional General Preferences You access eggplant Functional's Preferences by going to eggplant > Preferences. The General tab or section of Preferences controls several basic housekeeping behaviors, as described below. 50

51 On Startup 1. Reopen suites and scripts from last session. Selected by default. Select this checkbox to automatically reopen your last open suites and scripts when you launch eggplant Functional. 2. Reopen connections from last session. Selected by default. Select this checkbox to automatically reopen your last open connections when you launch eggplant Functional. (If eggplant Functional cannot connect to a previously open SUT, there is no alert or error message.) 3. Check for updates. Selected by default. Select this checkbox to automatically check for eggplant Functional software updates when you launch eggplant Functional. Connection List 4. Update connection availability. This drop-down list contains choices for how often SUT status in the Connection List is updated. The default choice is Once at startup. (Regardless of your choice, SUT status is always updated when you first open or close a connection.) 5. Maximum open connections. This drop-down list allows you to limit concurrent SUT connections to the chosen number. The default is No Limit. 6. Close Connection List after opening a connection. When this checkbox is selected, eggplant Functional closes the Connection List window when you open a connection. 7. Show alert when a connection fails. Selected by default. When this checkbox is selected, eggplant Functional prompts you to retry or cancel when a connection fails. 8. Show table headers in the connection list. Selected by default. When this checkbox is selected, eggplant Functional displays table headers in the Connection List. For more information on table headings in this window, please see The Connection List [2]. 9. Enable Bonjour discovery of VNC servers. Selected by default. When this checkbox is selected, local computers that have Bonjour networking technology enabled automatically appear in your Connection List. 51

52 Note: SUTs that are detected through Bonjour are not automatically saved to the Connection List. To save a Bonjour-detected SUT, open the add/edit screen for the connection, select Remember This Connection, then click Save; otherwise, the SUT is removed from the Connection List when it is no longer detected on the network. Note: On Windows operating systems, you have to install Bonjour to enable this feature; Bonjour is included with installation of eggplant Functional 15.1 and later for Windows. Other Options 10. Automatically upgrade suites to the current version. Selected by default. When this checkbox is selected, eggplant Functional automatically changes any of your scripts that are effected by changes in SenseTalk commands and functions. 11. Bring the Run window forward when a script is run.selected by default. Select this checkbox to automatically open the Run window (or bring it to the front) whenever a script is run. 12. Alert user when script execution fails. Selected by default. Select this checkbox to see an alert dialog box when a script fails. (This option does not apply to scripts that are run as part of a schedule [132].) 13. Generate result log in JUnit-compatible XML format. Selected by default. Select this checkbox to generate script results in JUnitcompatible XML format. These files are saved alongside the standard text log files generated by eggplant Functional. 14. Text file line endings. This drop-down list allows you to set the type of line ending eggplant Functional should expect on the host machine. Options are Mac / Linux (LF) or Windows (CRLF). 15. Show Image Popovers. These checkboxes, In Images List and In Scripts, allow you to choose whether you want to see image pop-overs appear in the Images list [152] and in the Script Editor [102] of the Suite window, respectively. Both options are selected by default. Default Suite Directory 16. Default Suite Directory. This field contains the default location eggplant Functional presents when you open a New Suite, Save As, or Open dialog. Type a file path in the text field, or click the Browse button and navigate to the directory. This location is also used as the initial setting of the Folder global property at the beginning of each script run. Viewer Window Preferences Viewer Preferences The Viewer Preferences control the ways you can interact with the SUT through the Viewer window [3]. 1. Live Mode Toggle Key. Choose the key used for quick toggling between Capture Mode and Live Mode in the associated drop-down list. Live Mode 52

53 2. Live Mode Cursor. This setting determines the appearance of your cursor in the Viewer window. Choose one of the following in the drop-down list: Local Cursor. This option displays the local eggplant Functional cursor in addition to any visible SUT cursor. Guide Box. This option displays the local cursor as a small guide box, in addition to any visible SUT cursor. None. This option displays only the cursor that is native to the SUT, and displayed by its VNC server. 3. Mouse Scroll Wheel. This option determines whether mouse scrolling in a Viewer window is interpreted by the local Viewer window, or by the active window in the Viewer window. Choose one of the following items in the associated drop-down list: Remote System. This option sends mouse scrolling through to the Viewer window. Local Window. This option applies mouse scrolling to the Viewer window. (When the Viewer window does not have scroll bars, mouse scrolling is sent through to the SUT.) 4. Mouse Right Click Key. This preference sets the modifier key you can hold to change a left click to a right click in the Viewer window. (If you are using a standard mouse, you can just press your right mouse button; this setting is only important if you don't have a right mouse button available.) 5. Mouse Middle Click Key. This preference sets the modifier key you can hold to change a left or right click to a middle click in the Viewer window. (If you are using a standard mouse, you can just press your middle mouse button; this setting is only important if you don't have a middle mouse button available.) 6. Auto-scroll window in Live Mode. When this checkbox is selected, the Viewer window scrolls in the appropriate direction when the cursor is moved outside the Viewer window. 7. Track mouse outside of window in Live Mode.Select this checkbox to make the Viewer window cursor follow your mouse movement outside the Viewer window. Capture Mode 8. Remember image folder for next capture. Select this checkbox to have eggplant Functional use the folder in which the last image was saved when saving a new image. 9. Display Capture Area border. Select this checkbox to display a gray border around the Capture Area in Capture Mode. The border can make it easier to see the Capture Area on dark backgrounds. 10. Name images with text when capturing. Select this checkbox to have eggplant Functional use OCR when capturing images to set the name of the current image to any text detected in the image. 11. Detect pulsing images when capturing. Select this checkbox to allow eggplant Functional to attempt to recognize pulsing images during image capture. In general, this is a useful feature; however, if you are working over a slow network connection, pulsing detection can make your image captures impractically slow. 12. Default Search Type. Set the default search type for images. Tolerant by default. Precise TolerantM Text To read more about the different Search Type settings, please see "Searching" here [153]. Connections Preferences Connections Preferences These eggplant Functional preferences pertain to VNC connections and communication. 53

54 Reverse Connections 1. Listen for reverse connections: Select this checkbox to allow SUTs to initiate VNC connections with the local computer running eggplant Functional. VNC Encodings 2. This is a list of the common encodings in which data is transferred over VNC connections. The encodings appear in order from most compressed to least compressed, and eggplant Functional always starts at the top of the list and attempts to use the most compressed encoding available. Most computers experience the best VNC performance by using the fastest (most compressed) encoding available; however, if you feel that your processor s ability to decompress and draw data is more of a limiting factor than your connection speed, you can disable the more compressed encodings. Additional VNC Features 3. Copy Rect: Allows faster updates in the Viewer window by redrawing only the portions of the SUT that have changed. 4. Rich Cursors: Allows faster updates in the Viewer window by receiving cursor updates as screen locations, rather than re-drawn cursors. 5. Detailed Connection Logging: Logs some additional information during connections for troubleshooting purposes. On Mac this information is recorded in Console. On Windows this information will be in the Windows Event Viewer. Mobile 6. ADB Version: Select the ADB version that eggplant Functional will use. Only one version of ADB can run at a time. Note that newer Android devices typically require to take advantage of eggplant Functional's built-in VNC server. Script Preferences Script Preferences The eggplant Functional Script preferences contain the controls for features that can make it easier for you to read and write scripts. Script preferences can be found by going to eggplant > Preferences, then selecting the Script tab. General Pane The General pane of the Script preferences tab provides basic controls for working with scripts in your eggplant Functional suites. 54

55 Script Saving Section When a script is run: This preference determines how eggplant Functional deals with unsaved script changes when you run a script. You have the following options: Don't save: Select this option to run scripts without saving changes. Save that script: Select this option to auto-save script changes before running scripts. Save all scripts: Select this option to auto-save all open scripts before running the current script. Ask to save: Select this option to be alerted to unsaved script changes when you run a script. Note: When a running script calls another script, the called script is read from the currently saved copy. If you have unsaved changes in the called script, they are not executed. When a script is modified: This preference determines what eggplant Functional does if another user saves changes to a script while you are using it. You have the following options: Ignore: Select this option to keep the script as it currently appears on your desktop without loading the newly saved version. Reload the script: Select this option to reload your script when eggplant Functional detects that the saved version has changed. Ask to reload: Select this option to have eggplant Functional ask you whether to keep the current version or load the saved version of your script. Reload breakpoints from last save: Select this checkbox to automatically reset saved breakpoints when you open scripts. Text Section Default Script Font: This field displays the default font of your text in the Script Editor. (New text and plain text loaded from other scripts are both displayed in this font.) Click Set to select a font on your system. This font choice is also used in the initial setting of the folder global property at the beginning of each script run. Script Log Font: This setting determines the font used to display script results and output in the Log Area of the Run window. Click Set to select a font on your system. Allow Text Drag and Drop: Drag-and-drop text is enabled in the Script Editor by default. Deselect this checkbox if you do not want to be able to move text by dragging it. Completion Pane The Completion pane of the Script preferences tab provides options for how the code auto-completion feature works when you're scripting in the eggplant Functional Script Editor. 55

56 Punctuation Assistance: Use this section to choose which punctuation marks you want eggplant Functional to auto-complete, or close, as you type in the Script Editor. Auto-Complete Statements: Use this section to determine which statement types you can auto-complete. For example, with If Statements selected, when you begin typing an If statement, a pop-up window provides suggestions for completion; you can select the variant you want to use from the list, and eggplant Functional inserts the appropriate code, ready for you to customize. Suggested Completions: This section provides options to control how script suggestions and insertions operate. To learn more about any individual option, hover the cursor over it to see explanatory text. By default, all options are selected on the Completion pane. You can clear the checkbox for any option you don't want to use. Indentation Pane The Indentation pane of the Script preferences tab includes settings to control the automatic indentation of text in the Script Editor. Script Indentation Section 56

57 Indent scripts automatically: Select this checkbox to apply indentation when you insert a comment, paste text, or press Return. Indent control structures by / Indent continuation lines by:these preferences determine the size of your automatic indentations. Select Tab(s) or Space(s), then enter the number of tabs or spaces to indent. Continuation line refers to a long statement displayed across multiple lines. To force a line break in a statement, insert a backslash (/). The Tab Key. Choose an item in this drop-down list to determine the function of Tab in the Script Editor. The Tab key can trigger indentation, insert a tab space, or both. Example Script Section This pane shows a script with the current indentation settings. As you make changes in the Script Indentation section, the example script updates automatically to reflect the new settings. Colorization Pane The settings on the Colorization pane of the Script preferences tab control the automatic color-coding of text in the Script Editor. Enable syntax coloring: Select this checkbox to turn on automatic script colorization. Update colors continuously while typing: Select this checkbox to automatically update colors in the current script line as you type. If this feature is turned off, script colors are updated when you insert a comment, paste, save, or press Return. Colorization Settings: These settings let you customize the colorization of different script elements. For each script element, select the first checkbox to auto-colorize it in the Script Editor. To edit a script element s color, click its color well, then select a new color in the standard Colors panel. Select the Bold checkbox to display the script element in bold text. Restore Colors: Click this button to restore colorization to the default settings. Example Script This pane displays a preview of the way scripts appears in the Script Editor with your current colorization settings. As you make changes above, the example script updates automatically to reflect the new settings. Run Options Preferences Run Option Preferences Run Option preferences are the default values of frequently-used run options. To change these values for an individual script, use the SetOption command or set the global property within the script. (For more information, see Run Options Global Properties [44].) To restore all run options (from all four tabs) to their default value, click the Restore Defaults button at the bottom of the preferences panel. The Mouse Pane 57

58 The Mouse settings determine specific mouse behavior in the Viewer window during script execution. 1. Mouse Click Delay. This value represents the time between the press and release of a mouse click on the SUT. 2. Double-Click Delay. This value represents the time between the release of the first click and the press of the second click of a DoubleClick command. 3. Mouse Move Speed. This value represents the maximum distance the mouse cursor can move per segment. 4. Mouse Drag Speed. This value represents the maximum distance the mouse cursor can drag per segment. 5. Mouse Move Delay. This value represents the delay between segments of mouse movement. 6. Movement Mode. This pop-up menu determines the path a mouse cursor takes when it moves from one place to another. Choose Direct, Horizontal Then Vertical, or Vertical Then Horizontal. 7. Should reposition mouse during image search. Select this checkbox to have eggplant Functional move the mouse to the bottom right corner after an initial image search that did not reveal a match. 8. Restore Default Run Options. Restores all run options (from all four tabs) to their default value. The Keyboard Pane The Keyboard preferences determine specific keyboard behavior in the Viewer window during script execution. (For more information, see Global Properties.) 58

59 1. Key-Down Delay. This value represents the length of time between a key press and release. 2. NextKeyDelay. This value represents the delay between typed keystrokes. 3. Send shift key down for capitals. This pop-up menu determines the whether or not eggplant Functional will hold the SUT's Shift key while typing capital letters. Choose from Always, Never, or When modifiers aren't down. If Never is selected, eggplant Functional sends capital-letter key codes to the SUT, without using the Shift key. 4. Enable Backslash Escape Codes. Select this checkbox to allow eggplant Functional to recognize backslash escape codes in scripts. 5. Restore Default Run Options. Restores all run options (from all four tabs) to their default value. The Screen Pane The Screen preferences determine search time and image tolerance in the Viewer window. Search Timing 1. Image Search Time. The number in this field represents the approximate maximum time that you want to allow eggplant Functional to 59

60 find an image match in the Viewer window. The actual time can be longer than the time specified here, depending on other factors related to the search. Click the disclosure triangle to reveal or hide the following preferences: Search Delay: The value in this field is time between one image search and the next. Search Count: The value in this field represents the number of times eggplant Functional searches for a single image match. (When the search count value is 1, eggplant Functional does not perform a full-screen refresh and reposition the mouse before failing. This can reduce delay when searching for images that are not present in the Remote screen, but it can also cause unnecessary failures due to screen artifacts and timing errors.) Note: The Image Search Time is equal to the Image Search Delay multiplied by one less than the Image Search Count. Changing the Image Search Time affects the other two values, and vice versa. Precise Image Tolerance 2. The position of this slider determines the level of precision eggplant Functional requires to match an image with a tolerant search. The number represents the maximum difference between an original pixel s RGB value and the RGB value of a presumed match in the Viewer window. Standard Image Tolerance 3. The position of this slider determines the level of precision eggplant Functional requires to match an image with a standard search. The number represents the maximum difference between an original pixel s RGB value and the RGB value of a presumed match in the Viewer window. Note: These image tolerance values affect your searches throughout every script you run in eggplant Functional. If you need to change these values, it is usually best to do it on a script-by-script basis. 4. Restore Default Run Options. Restores all run options (from all four tabs) to their default value. The System Pane The settings under the System pane allow you to configure how eggplant Functional interacts directly with the remote system. Minimum Time Between SUT Actions 1. Remote Work Interval. The value in this fields represents the minimum delay between two commands that interact with the SUT. (For more information, see the RemoteWorkInterval [154], in the Run Options Global Properties [44].) Countdown on Manual Doctor 60

61 2. Doctor Delay. Doctor Delay is the time you have to act on a manual Image Docter event. When the Doctor Delay time is up, the script proceeds normally. To turn off the Image Doctor timer, set the Doctor Delay to 0. Refreshing Remote Screen Between Events 3. Force Screen Refresh. Select this checkbox to force the Viewer window to redraw the SUT after every line of script executed. (For more information, see The ForceScreenRefresh [155], in the Run Options Global Properties [44].) 4. Restore Default Run Options. Restores all run options (from all four tabs) to their default value. Text Preferences Text Preferences These settings define the text platforms that are available for use in text property lists. Each platform includes a Text Engine, and any number of predefined text styles. 1. The Platform Pop-Up Menu: The Platform pop-up menu contains the names of all of the operating systems for which you can currently create text property lists. To display and edit the properties of a platform, choose it in the Platform pop-up menu. 2. Adding a Platform: To define a new platform, click the Add button. The new platform is created with the same initial settings as the platform that was displayed when you clicked the Add button. 3. Removing a Platform:To remove a platform from Text preferences, choose it in the Platform pop-up menu and click the Remove button. (You cannot remove the default platform unless you name a different default first.) Platform removal requires confirmation, and it cannot by undone. 4. Set As Default: The default platform is the initial value of the CurrentTextPlatform global property [156] in your scripts. To set a platform as the default, choose it in the Platform pop-up menu and click the Set as Default button. The default platform name is displayed in bold text. Text Engine 5. In the Text Engine pop-up menu, you can choose whether you want to search for your text with OCR (optical character recognition) or a text-image generator specific to your SUT. The choices are listed in the table below: Text Engines Name Operating System Additional Details External TIG Windows Host: The host name or IP address of the computer that is hosting your TIG. (To use a TIG on the current SUT, type Current SUT.) Port: The port on which the TIG host communicates. (The default port is 5899.) Native TIG Mac OS X Currently included in eggplant Functional on Mac OS X only. 61

62 Text Engines Name Operating System Additional Details OCR Search Any operating system Pango TIG Linux See note, below. Scripted TIG Custom Command: The name of the TIG script. Note: Installing the Pango TIG The Pango TIG is not bundled with eggplant Functional. To install the Pango TIG, download the bundle from TestPlant downloads [157], and save the download in the /Library/Frameworks directory, or in the ~/Library/Frameworks directory of your user account. Text Styles 6. This pop-up menu contains all of the defined text styles for the current platform. Each style includes a defined font, size, text color, and background color; it may also include bold, italic, or underlined text. (For information on using styles, see The Find Text Panel [158].) To display and edit a text style, choose it in the Text Styles pop-up menu (discussed as part of The Find Text Panel [158]). Note: Typically, a text style corresponds to a particular type of graphical interface element, such as menu item or title bar. 7. Add: To define a new text style, click the Add button. The new text style is created with the same initial settings as the text style that was displayed when you clicked the Add button; you can save time by choosing a text style that has some attributes in common with the new text style. 8. Remove: To remove a text style from the current platform, choose the text style in the Text Style pop-up menu and click the Remove button. This action requires confirmation, and it cannot be undone. 9. Font and Size Fields: In the Font and Size fields, type or choose a font and size for the current text style. Note: The fonts in the pop-up menu are native to the computer that is running eggplant Functional. You can always type the names of fonts native to your SUTs. 10. Text and Background Color: To edit a text or background color, click the respective color well and select a new color in the Colors panel. Tip: The color picker in the Colors panel is especially useful for eggplant Functional; it allows you to copy a color from any place in your display, including the Viewer window. To use the color picker, click the magnifying glass in the Colors panel, then click again wherever you see the color you would like to copy. 11. Text Attributes:Select the Bold, Italic, and Underline checkboxes to define a text style with those attributes. 12. Restore Defaults: Click this button to restore the Text Preferences to their default settings. Sharing Text Platforms with Other Users All of the text platform information you define in Text preferences is stored in a property list within your user account. Mac OS X and Linux: ~/Library/Eggplant/TextPlatform.plist. Windows: \Library\Eggplant\TextPlatform.plist. To share platform definitions with another user account, copy this file into that account s Library\Eggplant folder. (This folder is not created until the user changes a text preference.) Mail Preferences Mail preferences These settings determine the default mail server eggplant Functional uses for the SendMail command [159]. 62

63 Mail Server for SendMail Command 1. SMTP Server. In the SMTP Server field, enter the host name or IP address of the server you use for sending Transport and Port. The Transport drop-down list lets you choose between Unencrypted, SSL, and TLS as the encryption method for transport. In the Port field, enter the port used to connect to the mail server, or leave the field blank to use the default value of 25, the standard mail port. 3. Authentication. From the Authentication drop-down list, choose None, Plain, Login, or CRAM-MD5 as appropriate for your mail server. 4. User Name and Password. In these fields, enter the user name and password of the account you use for authentication. If None is chosen in the Authentication drop-down list, these fields are not available. eggcloud Preferences eggcloud Preferences These preferences are for use when connecting to devices in eggcloud. To read about how to connect to devices through eggcloud from eggman, please see Connecting to Devices from eggplant Functional or eggman [160]. Connection Information 1. Hostname. The IP address of the eggcloud machine on the local network (not the eggcloud subnet), and the port where eggcloud is running on that machine. 2. Username. The address associated with your eggcloud login credentials. 3. Password. The password associated with your eggcloud login credentials. eggplant Functional Commands and Functions eggplant Functional Commands and Functions 63

eggplant v11.0 Mac OS X EggPlant Reference Manual

eggplant v11.0 Mac OS X EggPlant Reference Manual eggplant v11.0 Mac OS X EggPlant Reference Manual Copyright 2011 TestPlant Inc. Eggplant Reference Manual Trademarks Eggplant, the Eggplant logos, TestPlant, and the TestPlant logo are trademarks or registered

More information

eggplant v11.0 Mac OS X EggPlant: Getting Started

eggplant v11.0 Mac OS X EggPlant: Getting Started eggplant v11.0 Mac OS X EggPlant: Getting Started Copyright 2011 TestPlant Inc. Eggplant: Getting Started Trademarks Eggplant, the Eggplant logos, TestPlant, and the TestPlant logo are trademarks or registered

More information

OpenForms360 Validation User Guide Notable Solutions Inc.

OpenForms360 Validation User Guide Notable Solutions Inc. OpenForms360 Validation User Guide 2011 Notable Solutions Inc. 1 T A B L E O F C O N T EN T S Introduction...5 What is OpenForms360 Validation?... 5 Using OpenForms360 Validation... 5 Features at a glance...

More information

Getting Started with eggplant Functional

Getting Started with eggplant Functional Published on Documentation (http://127.0.0.1) Home > Getting Started Getting Started Getting Started with eggplant Functional This manual provides the background and set-up instructions you need to get

More information

Page 1 of 6 Mac OS X keyboard shortcuts Summary Learn about common Mac OS X keyboard shortcuts. A keyboard shortcut is a way to invoke a function in Mac OS X by pressing a combination of keys on your keyboard.

More information

Computer Shortcut Keys

Computer Shortcut Keys Powered By Computer Shortcut Keys Let s kickstart the list with the most common shortcuts that you ll often use. F1 [Display Help] F2 [Rename the selected item] F3 [Search for a file or folder] F4 [Display

More information

Lesson 4 - Creating a Text Document Using WordPad

Lesson 4 - Creating a Text Document Using WordPad Lesson 4 - Creating a Text Document Using WordPad OBJECTIVES: To learn the basics of word processing programs and to create a document in WordPad from Microsoft Windows. A word processing program is the

More information

OS X keyboard shortcuts

OS X keyboard shortcuts OS X keyboard shortcuts Summary Learn about common OS X keyboard shortcuts. A keyboard shortcut is a way to invoke a function in OS X by pressing a combination of keys on your keyboard. Original source:

More information

Using Online Help. About the built-in help features Using Help Using the How To window Using other assistance features

Using Online Help. About the built-in help features Using Help Using the How To window Using other assistance features Using Online Help About the built-in help features Using Help Using the How To window Using other assistance features About the built-in help features Adobe Reader 6.0 offers many built-in features to

More information

Windows 10 Essentials

Windows 10 Essentials Windows 10 Essentials User Interface START MENU Start typing to search for applications or files Once the start menu is open you can change its size by dragging a side Right-click on an application and

More information

Introduction to 9.0. Introduction to 9.0. Getting Started Guide. Powering collaborative online communities.

Introduction to 9.0. Introduction to 9.0. Getting Started Guide. Powering collaborative online communities. Introduction to 9.0 Introduction to 9.0 Getting Started Guide Powering collaborative online communities. TABLE OF CONTENTS About FirstClass...3 Connecting to your FirstClass server...3 FirstClass window

More information

Switch between open apps Close the active item, or exit the active app

Switch between open apps Close the active item, or exit the active app Ctrl + X Ctrl + C (or Ctrl + Insert) Ctrl + V (or Shift + Insert) Ctrl + Z Alt + Tab Alt + F4 L D F2 F3 F4 F5 F6 F10 Alt + F8 Alt + Esc Alt + underlined letter Alt + Enter Alt + Spacebar Alt + Left arrow

More information

VisualPST 2.4. Visual object report editor for PowerSchool. Copyright Park Bench Software, LLC All Rights Reserved

VisualPST 2.4. Visual object report editor for PowerSchool. Copyright Park Bench Software, LLC All Rights Reserved VisualPST 2.4 Visual object report editor for PowerSchool Copyright 2004-2015 Park Bench Software, LLC All Rights Reserved www.parkbenchsoftware.com This software is not free - if you use it, you must

More information

Using Help Contents Index Back 1

Using Help Contents Index Back 1 Using Online Help Using Help Contents Index Back 1 Using Online Help About the built-in help features Adobe Reader 6.0 offers many built-in features to assist you while you work, including the Help window

More information

Basic Concepts. Launching MultiAd Creator. To Create an Alias. file://c:\documents and Settings\Gary Horrie\Local Settings\Temp\~hh81F9.

Basic Concepts. Launching MultiAd Creator. To Create an Alias. file://c:\documents and Settings\Gary Horrie\Local Settings\Temp\~hh81F9. Page 1 of 71 This section describes several common tasks that you'll need to know in order to use Creator successfully. Examples include launching Creator and opening, saving and closing Creator documents.

More information

2 Getting Started. Getting Started (v1.8.6) 3/5/2007

2 Getting Started. Getting Started (v1.8.6) 3/5/2007 2 Getting Started Java will be used in the examples in this section; however, the information applies to all supported languages for which you have installed a compiler (e.g., Ada, C, C++, Java) unless

More information

USER GUIDE MADCAP CAPTURE 7. Getting Started

USER GUIDE MADCAP CAPTURE 7. Getting Started USER GUIDE MADCAP CAPTURE 7 Getting Started Copyright 2018 MadCap Software. All rights reserved. Information in this document is subject to change without notice. The software described in this document

More information

Appendix J: Using Shortcut Keys and Shortcut Menus

Appendix J: Using Shortcut Keys and Shortcut Menus Appendix J: Using Shortcut Keys and Shortcut Menus Introduction This appendix covers shortcuts to many of the menu options, dialog boxes, and commands used in PC-DMIS. Using shortcuts will speed up your

More information

Microsoft PowerPoint 2013 Beginning

Microsoft PowerPoint 2013 Beginning Microsoft PowerPoint 2013 Beginning PowerPoint Presentations on the Web... 2 Starting PowerPoint... 2 Opening a Presentation... 2 File Tab... 3 Quick Access Toolbar... 3 The Ribbon... 4 Keyboard Shortcuts...

More information

IBM Rational Rhapsody Gateway Add On. User Guide

IBM Rational Rhapsody Gateway Add On. User Guide User Guide Rhapsody IBM Rational Rhapsody Gateway Add On User Guide License Agreement No part of this publication may be reproduced, transmitted, stored in a retrieval system, nor translated into any

More information

Table of Contents Lesson 1: Introduction to the New Interface... 2 Lesson 2: Prepare to Work with Office

Table of Contents Lesson 1: Introduction to the New Interface... 2 Lesson 2: Prepare to Work with Office Table of Contents Lesson 1: Introduction to the New Interface... 2 Exercise 1: The New Elements... 3 Exercise 2: Use the Office Button and Quick Access Toolbar... 4 The Office Button... 4 The Quick Access

More information

Word 2010 Beginning. Technology Integration Center

Word 2010 Beginning. Technology Integration Center Word 2010 Beginning File Tab... 2 Quick Access Toolbar... 2 The Ribbon... 3 Help... 3 Opening a Document... 3 Documents from Older Versions... 4 Document Views... 4 Navigating the Document... 5 Moving

More information

Quick Guide for Photoshop CC Basics April 2016 Training:

Quick Guide for Photoshop CC Basics April 2016 Training: Photoshop CC Basics Creating a New File 1. Click File > New 2. Keep Default Photoshop Size selected in the Preset drop-down list. 3. Click OK. Showing Rulers 1. On the Menu bar, click View. 2. Click Rulers.

More information

Getting Started (1.8.7) 9/2/2009

Getting Started (1.8.7) 9/2/2009 2 Getting Started For the examples in this section, Microsoft Windows and Java will be used. However, much of the information applies to other operating systems and supported languages for which you have

More information

User Manual Version 1.1 January 2015

User Manual Version 1.1 January 2015 User Manual Version 1.1 January 2015 - 2 / 112 - V1.1 Variegator... 7 Variegator Features... 7 1. Variable elements... 7 2. Static elements... 7 3. Element Manipulation... 7 4. Document Formats... 7 5.

More information

Windows Computer A to Z Shortcut Key list with PDF

Windows Computer A to Z Shortcut Key list with PDF Windows Computer A to Z Shortcut Key list with PDF In the Computer world, a keyboard shortcut is a combination of one or more command to execute a particular action. These shortcuts are really helpful

More information

Tabbing Between Fields and Control Elements

Tabbing Between Fields and Control Elements Note: This discussion is based on MacOS, 10.12.6 (Sierra). Some illustrations may differ when using other versions of macos or OS X. The capability and features of the Mac have grown considerably over

More information

Getting Started. Microsoft QUICK Source 7

Getting Started. Microsoft QUICK Source 7 Microsoft QUICK Windows Source 7 Getting Started The Windows 7 Desktop u v w x u Icon links to a program, file, or folder that is stored on the desktop. v Shortcut Icon links to a program, file, or folder

More information

XnView Image Viewer. a ZOOMERS guide

XnView Image Viewer. a ZOOMERS guide XnView Image Viewer a ZOOMERS guide Introduction...2 Browser Mode... 5 Image View Mode...14 Printing... 22 Image Editing...26 Configuration... 34 Note that this guide is for XnView version 1.8. The current

More information

AutoCAD 2009 User InterfaceChapter1:

AutoCAD 2009 User InterfaceChapter1: AutoCAD 2009 User InterfaceChapter1: Chapter 1 The AutoCAD 2009 interface has been enhanced to make AutoCAD even easier to use, while making as much screen space available as possible. In this chapter,

More information

End User Guide. 2.1 Getting Started Toolbar Right-click Contextual Menu Navigation Panels... 2

End User Guide. 2.1 Getting Started Toolbar Right-click Contextual Menu Navigation Panels... 2 TABLE OF CONTENTS 1 OVERVIEW...1 2 WEB VIEWER DEMO ON DESKTOP...1 2.1 Getting Started... 1 2.1.1 Toolbar... 1 2.1.2 Right-click Contextual Menu... 2 2.1.3 Navigation Panels... 2 2.1.4 Floating Toolbar...

More information

ArcGIS. Desktop. A Selection of Time-Saving Tips and Shortcuts

ArcGIS. Desktop. A Selection of Time-Saving Tips and Shortcuts ArcGIS Desktop A Selection of Time-Saving Tips and Shortcuts Map Navigation Refresh and redraw the display F5 9.1, Suspend the map s drawing F9 9.1, Zoom in and out Roll the mouse wheel backward and forward.

More information

OU EDUCATE TRAINING MANUAL

OU EDUCATE TRAINING MANUAL OU EDUCATE TRAINING MANUAL OmniUpdate Web Content Management System El Camino College Staff Development 310-660-3868 Course Topics: Section 1: OU Educate Overview and Login Section 2: The OmniUpdate Interface

More information

Microsoft PowerPoint 2007 Beginning

Microsoft PowerPoint 2007 Beginning Microsoft PowerPoint 2007 Beginning Educational Technology Center PowerPoint Presentations on the Web... 2 Starting PowerPoint... 2 Opening a Presentation... 2 Microsoft Office Button... 3 Quick Access

More information

Apple is rightfully proud of the user interface design incorporated into

Apple is rightfully proud of the user interface design incorporated into Customizing OS X Apple is rightfully proud of the user interface design incorporated into the Macintosh OS X family of operating systems. The interface is easy to use, and it s also easy to customize so

More information

Computer Shortcuts. Files menu options in current program. Edits options in current program Universal Help in almost every Windows program.

Computer Shortcuts. Files menu options in current program. Edits options in current program Universal Help in almost every Windows program. www.bankjobszone.com Computer Shortcuts Shortcut keys Concept: Shortcuts keys help provide an easier and usually quicker method of navigating and using computer software programs. Shortcut keys are commonly

More information

button Double-click any tab on the Ribbon to minimize it. To expand, click the Expand the Ribbon button

button Double-click any tab on the Ribbon to minimize it. To expand, click the Expand the Ribbon button PROCEDURES LESSON 1: CREATING WD DOCUMENTS WITH HEADERS AND FOOTERS Starting Word 1 Click the Start button 2 Click All Programs 3 Click the Microsoft Office folder icon 4 Click Microsoft Word 2010 1 Click

More information

PowerPoint 2016 Basics for Mac

PowerPoint 2016 Basics for Mac 1 PowerPoint 2016 Basics for Mac PowerPoint 2016 Basics for Mac Training Objective To learn the tools and features to get started using PowerPoint more efficiently and effectively. What you can expect

More information

Word 2013 Beginning. Technology Integration Center

Word 2013 Beginning. Technology Integration Center Word 2013 Beginning Getting Started... 2 Quick Access Toolbar... 3 The Ribbon... 3 Help... 4 Compatibility Mode... 4 Document Views... 4 Navigating the Document... 5 Moving Around in the Document... 5

More information

A Guide to Quark Author Web Edition 2015

A Guide to Quark Author Web Edition 2015 A Guide to Quark Author Web Edition 2015 CONTENTS Contents Getting Started...4 About Quark Author - Web Edition...4 Smart documents...4 Introduction to the Quark Author - Web Edition User Guide...4 Quark

More information

XnView 1.9. a ZOOMERS guide. Introduction...2 Browser Mode... 5 Image View Mode...15 Printing Image Editing...28 Configuration...

XnView 1.9. a ZOOMERS guide. Introduction...2 Browser Mode... 5 Image View Mode...15 Printing Image Editing...28 Configuration... XnView 1.9 a ZOOMERS guide Introduction...2 Browser Mode... 5 Image View Mode...15 Printing... 22 Image Editing...28 Configuration... 36 Written by Chorlton Workshop for hsbp Introduction This is a guide

More information

ECDL Module 6 REFERENCE MANUAL

ECDL Module 6 REFERENCE MANUAL ECDL Module 6 REFERENCE MANUAL Presentation Microsoft PowerPoint XP Edition for ECDL Syllabus Four PAGE 2 - ECDL MODULE 6 (USING POWERPOINT XP) - MANUAL 6.1 GETTING STARTED... 4 6.1.1 FIRST STEPS WITH

More information

How to Get Started. Figure 3

How to Get Started. Figure 3 Tutorial PSpice How to Get Started To start a simulation, begin by going to the Start button on the Windows toolbar, then select Engineering Tools, then OrCAD Demo. From now on the document menu selection

More information

ArcGIS. ArcGIS Desktop. Tips and Shortcuts

ArcGIS. ArcGIS Desktop. Tips and Shortcuts ArcGIS ArcGIS Desktop Tips and Shortcuts Map Navigation Refresh and redraw the display. F5 9.1, Suspend the map s drawing. F9 9.1, Zoom in and out. Center map. Roll the mouse wheel backward and forward.

More information

How To Capture Screen Shots

How To Capture Screen Shots What Is FastStone Capture? FastStone Capture is a program that can be used to capture screen images that you want to place in a document, a brochure, an e-mail message, a slide show and for lots of other

More information

4D Write. User Reference Mac OS and Windows Versions. 4D Write D SA/4D, Inc. All Rights reserved.

4D Write. User Reference Mac OS and Windows Versions. 4D Write D SA/4D, Inc. All Rights reserved. 4D Write User Reference Mac OS and Windows Versions 4D Write 1999-2002 4D SA/4D, Inc. All Rights reserved. 4D Write User Reference Version 6.8 for Mac OS and Windows Copyright 1999 2002 4D SA/4D, Inc.

More information

BASICS OF MOTIONSTUDIO

BASICS OF MOTIONSTUDIO EXPERIMENT NO: 1 BASICS OF MOTIONSTUDIO User Interface MotionStudio combines draw, paint and animation in one easy easy-to-use program gram to save time and make work easy. Main Window Main Window is the

More information

StickFont Editor v1.01 User Manual. Copyright 2012 NCPlot Software LLC

StickFont Editor v1.01 User Manual. Copyright 2012 NCPlot Software LLC StickFont Editor v1.01 User Manual Copyright 2012 NCPlot Software LLC StickFont Editor Manual Table of Contents Welcome... 1 Registering StickFont Editor... 3 Getting Started... 5 Getting Started...

More information

Agent and Agent Browser. Updated Friday, January 26, Autotask Corporation

Agent and Agent Browser. Updated Friday, January 26, Autotask Corporation Agent and Agent Browser Updated Friday, January 26, 2018 2018 Autotask Corporation Table of Contents Table of Contents 2 The AEM Agent and Agent Browser 3 AEM Agent 5 Privacy Mode 9 Agent Browser 11 Agent

More information

Included with the system is a high quality speech synthesizer, which is installed automatically during the SymWord setup procedure.

Included with the system is a high quality speech synthesizer, which is installed automatically during the SymWord setup procedure. Introduction to SymWord SymWord is a simple to use, talking, symbol-word processor. It has the basic functionality of a word processor. SymWord can also be configured to produce speech and/or display text

More information

Microsoft Word Part I Reference Manual

Microsoft Word Part I Reference Manual Microsoft Word 2002 Part I Reference Manual Instructor: Angela Sanderson Computer Training Coordinator Updated by: Angela Sanderson January 11, 2003 Prepared by: Vi Johnson November 20, 2002 THE WORD SCREEN

More information

OnBase - EDM Services (Electronic Document Management Services)

OnBase - EDM Services (Electronic Document Management Services) OnBase - EDM Services (Electronic Document Management Services) Overview EDM Services contains the following features: EDM Briefcase Prerequisites The EDM Briefcase allows you to: Document Templates Image

More information

With ClaroIdeas you can quickly and easily create idea maps using a combination of words, symbols and pictures.

With ClaroIdeas you can quickly and easily create idea maps using a combination of words, symbols and pictures. Welcome to ClaroIdeas ClaroIdeas is a fresh tool to support the creation and editing of concept maps or idea maps using visual and audio components. It has been specifically developed to support people

More information

Keynote 08 Basics Website:

Keynote 08 Basics Website: Website: http://etc.usf.edu/te/ Keynote is Apple's presentation application. Keynote is installed as part of the iwork suite, which also includes the word processing program Pages and the spreadsheet program

More information

eggplant TM eggplant RITA BAsIcs

eggplant TM eggplant RITA BAsIcs eggplant TM RITA Basics Copyright 2008 Redstone Software, Inc. RITA Basics Trademarks Eggplant, Eggplant Functional Tester, Eggplant Load Tester, Eggplant Starter Edition the Eggplant logos, Redstone,

More information

Using Sitecore 5.3.1

Using Sitecore 5.3.1 Using Sitecore 5.3.1 An End-User s Guide to Using and Administrating Sitecore Author: Sitecore Corporation Date: December 12, 2007 Release: Rev. 1.0 Language: English Sitecore is a registered trademark.

More information

Microsoft PowerPoint 2010 Beginning

Microsoft PowerPoint 2010 Beginning Microsoft PowerPoint 2010 Beginning PowerPoint Presentations on the Web... 2 Starting PowerPoint... 2 Opening a Presentation... 2 File Tab... 3 Quick Access Toolbar... 3 The Ribbon... 4 Keyboard Shortcuts...

More information

Introduction to Microsoft Office PowerPoint 2010

Introduction to Microsoft Office PowerPoint 2010 Introduction to Microsoft Office PowerPoint 2010 TABLE OF CONTENTS Open PowerPoint 2010... 1 About the Editing Screen... 1 Create a Title Slide... 6 Save Your Presentation... 6 Create a New Slide... 7

More information

Working with PDF s. To open a recent file on the Start screen, double click on the file name.

Working with PDF s. To open a recent file on the Start screen, double click on the file name. Working with PDF s Acrobat DC Start Screen (Home Tab) When Acrobat opens, the Acrobat Start screen (Home Tab) populates displaying a list of recently opened files. The search feature on the top of the

More information

The Fundamentals. Document Basics

The Fundamentals. Document Basics 3 The Fundamentals Opening a Program... 3 Similarities in All Programs... 3 It's On Now What?...4 Making things easier to see.. 4 Adjusting Text Size.....4 My Computer. 4 Control Panel... 5 Accessibility

More information

Microsoft Word 2011 Tutorial

Microsoft Word 2011 Tutorial Microsoft Word 2011 Tutorial GETTING STARTED Microsoft Word is one of the most popular word processing programs supported by both Mac and PC platforms. Microsoft Word can be used to create documents, brochures,

More information

Microsoft Word 2010 Part 1: Introduction to Word

Microsoft Word 2010 Part 1: Introduction to Word CALIFORNIA STATE UNIVERSITY, LOS ANGELES INFORMATION TECHNOLOGY SERVICES Microsoft Word 2010 Part 1: Introduction to Word Summer 2011, Version 1.0 Table of Contents Introduction...3 Starting the Program...3

More information

Introduction to Microsoft Office 2016: Word

Introduction to Microsoft Office 2016: Word Introduction to Microsoft Office 2016: Word Last Updated: September 2018 Cost: $2.00 Microsoft Word is a word processing software. You can use it to type letters, reports, and other documents. This class

More information

Interface. 2. Interface Photoshop CS/ImageReady CS for the Web H O T

Interface. 2. Interface Photoshop CS/ImageReady CS for the Web H O T 2. Interface Photoshop CS/ImageReady CS for the Web H O T 2. Interface The Welcome Screen Interface Overview Using the Toolbox Using Palettes Using the Options Bar Creating a Tool Preset Resetting Tools

More information

Overview of Adobe InDesign

Overview of Adobe InDesign Overview of Adobe InDesign In this guide, you ll learn how to do the following: Work with the InDesign workspace, tools, document windows, pasteboard, panels, and layers. Customize the workspace. Change

More information

Welcome! Table of contents:

Welcome! Table of contents: Table of contents: Welcome!... 1 User interface... 2 Working with menus... 2 Working with toolbars... 4 Navigating between slides... 4 Entering text... 5 Selecting text and objects... 6 Spell checking...

More information

CS Multimedia and Communications REMEMBER TO BRING YOUR MEMORY STICK TO EVERY LAB! Lab 02: Introduction to Photoshop Part 1

CS Multimedia and Communications REMEMBER TO BRING YOUR MEMORY STICK TO EVERY LAB! Lab 02: Introduction to Photoshop Part 1 CS 1033 Multimedia and Communications REMEMBER TO BRING YOUR MEMORY STICK TO EVERY LAB! Lab 02: Introduction to Photoshop Part 1 Upon completion of this lab, you should be able to: Open, create new, save

More information

User Guide. FTR Reporter For more information, visit

User Guide. FTR Reporter For more information, visit FTR Reporter 5.7.1 For more information, visit www.fortherecord.com TABLE OF CONTENTS INTRODUCTION... 5 Overview... 5 About This Document... 5 GETTING STARTED... 6 Installation... 6 Starting Reporter...

More information

Introduction to Word 2010

Introduction to Word 2010 Introduction to Word 2010 Screen Elements 4 1 2 3 5 10 6 7 8 9 1. File Tab: The File tab will bring you into the Backstage View. The Backstage View is where you manage your files and the data about them

More information

This book will help you quickly create your first documents, spreadsheets, and slideshows.

This book will help you quickly create your first documents, spreadsheets, and slideshows. Getting Started Welcome to iwork 08 Preface This book will help you quickly create your first documents, spreadsheets, and slideshows. iwork 08 includes three applications that integrate seamlessly with

More information

Use the Apple menu to change settings, get Mac OS X software, open recent items, and restart or shut down your computer.

Use the Apple menu to change settings, get Mac OS X software, open recent items, and restart or shut down your computer. Welcome to Mac OS X Aqua makes using your Mac easier than ever. Its color, depth, and motion guide you through your tasks, while the Finder and Dock provide easy access to your computer and network. Aqua

More information

Publishing Electronic Portfolios using Adobe Acrobat 5.0

Publishing Electronic Portfolios using Adobe Acrobat 5.0 Step-by-Step Publishing Electronic Portfolios using Adobe Acrobat 5.0 2002, Helen C. Barrett Here is the process we will use to publish a digital portfolio using Adobe Acrobat. The portfolio will include

More information

Microsoft Office Word. Help. Opening a Document. Converting from Older Versions

Microsoft Office Word. Help. Opening a Document. Converting from Older Versions Microsoft Office 2007 - Word Help Click on the Microsoft Office Word Help button in the top right corner. Type the desired word in the search box and then press the Enter key. Choose the desired topic

More information

Complete List of Windows 8 Keyboard Shortcuts Keyboard Shortcuts for Desktops

Complete List of Windows 8 Keyboard Shortcuts Keyboard Shortcuts for Desktops Complete List of Windows 8 Keyboard Shortcuts s for Desktops 11/1/2012 http://theapptimes.com Introduction One of the smartest ways to work with Windows is by using keyboard shortcuts. All of us Windows

More information

Lesson 1 Introduction to LabVIEW. TOPICS LabVIEW Environment Front Panel Block Diagram Dataflow Programming LabVIEW Help and Manuals Debugging a VI

Lesson 1 Introduction to LabVIEW. TOPICS LabVIEW Environment Front Panel Block Diagram Dataflow Programming LabVIEW Help and Manuals Debugging a VI Lesson 1 Introduction to LabVIEW TOPICS LabVIEW Environment Front Panel Block Diagram Dataflow Programming LabVIEW Help and Manuals Debugging a VI 1 Virtual Instruments (VIs) Front Panel Controls = Inputs

More information

Copyright 2018 MakeUseOf. All Rights Reserved.

Copyright 2018 MakeUseOf. All Rights Reserved. 15 Power User Tips for Tabs in Firefox 57 Quantum Written by Lori Kaufman Published March 2018. Read the original article here: https://www.makeuseof.com/tag/firefox-tabs-tips/ This ebook is the intellectual

More information

Code Editor. The Code Editor is made up of the following areas: Toolbar. Editable Area Output Panel Status Bar Outline. Toolbar

Code Editor. The Code Editor is made up of the following areas: Toolbar. Editable Area Output Panel Status Bar Outline. Toolbar Code Editor Wakanda s Code Editor is a powerful editor where you can write your JavaScript code for events and functions in datastore classes, attributes, Pages, widgets, and much more. Besides JavaScript,

More information

User Guide. v7.5. September 4, For the most recent version of this document, visit kcura's Documentation Site.

User Guide. v7.5. September 4, For the most recent version of this document, visit kcura's Documentation Site. User Guide v7.5 September 4, 2013 For the most recent version of this document, visit kcura's Documentation Site. Table of Contents 1 User guide overview 4 2 Relativity objects 4 3 Workspace 6 3.1 Workspaces

More information

Intermediate/Advanced. Faculty Development Workshop FSE Faculty retreat April 18, 2012

Intermediate/Advanced. Faculty Development Workshop FSE Faculty retreat April 18, 2012 Intermediate/Advanced Faculty Development Workshop FSE Faculty retreat April 18, 2012 Remote Desktop Sharing Quick Reference Guide for Moderators The Moderator or a Participant may request control of another

More information

Introduction to Microsoft Excel 2010

Introduction to Microsoft Excel 2010 Introduction to Microsoft Excel 2010 THE BASICS PAGE 02! What is Microsoft Excel?! Important Microsoft Excel Terms! Opening Microsoft Excel 2010! The Title Bar! Page View, Zoom, and Sheets MENUS...PAGE

More information

Standard Windows Keyboard Layout & Keyboard Shortcuts

Standard Windows Keyboard Layout & Keyboard Shortcuts Standard Windows Keyboard Layout & Keyboard Shortcuts Desktop keyboard Laptop keyboard Explanation of the Keys on a Windows QWERTY Keyboard Q W E R T Y "The name "QWERTY" for our computer keyboard comes

More information

QromaTag for Mac. User Guide. v1.0.5

QromaTag for Mac. User Guide. v1.0.5 QromaTag for Mac User Guide v1.0.5 About QromaTag v1 QromaTag for Mac is a new way to create and embed industry standard photo metadata into your digital images using Natural Language Tagging. Unlike traditional

More information

CHAPTER 1 COPYRIGHTED MATERIAL. Getting to Know AutoCAD. Opening a new drawing. Getting familiar with the AutoCAD and AutoCAD LT Graphics windows

CHAPTER 1 COPYRIGHTED MATERIAL. Getting to Know AutoCAD. Opening a new drawing. Getting familiar with the AutoCAD and AutoCAD LT Graphics windows CHAPTER 1 Getting to Know AutoCAD Opening a new drawing Getting familiar with the AutoCAD and AutoCAD LT Graphics windows Modifying the display Displaying and arranging toolbars COPYRIGHTED MATERIAL 2

More information

Microsoft Word Basic Editing. Lesson , John Wiley & Sons, Inc. Microsoft Official Academic Course, Microsoft Word

Microsoft Word Basic Editing. Lesson , John Wiley & Sons, Inc. Microsoft Official Academic Course, Microsoft Word Microsoft Word 2013 Lesson 2 Basic Editing 2014, John Wiley & Sons, Inc. Microsoft Official Academic Course, Microsoft Word 2013 1 Objectives 2014, John Wiley & Sons, Inc. Microsoft Official Academic Course,

More information

Coach s Office Playbook Tutorial Playbook i

Coach s Office Playbook Tutorial  Playbook i Playbook i The Playbook... 1 Overview... 1 Open the Playbook... 1 The Playbook Window... 2 Name the Chapter... 2 Insert the First Page... 3 Page Templates... 3 Define the Template Boxes... 4 Text on the

More information

Introduction to Microsoft Word 2010

Introduction to Microsoft Word 2010 Introduction to Microsoft Word 2010 Microsoft Word is a word processing program you can use to write letters, resumes, reports, and more. Anything you can create with a typewriter, you can create with

More information

Introduction to Microsoft Word 2010

Introduction to Microsoft Word 2010 Introduction to Microsoft Word 2010 THE BASICS PAGE 02! What is Microsoft Word?! Opening Microsoft Word! The Title Bar! Page View and Zoom MENUS...PAGE 03! Quick Access Toolbar! The Ribbon! File Tab! Home

More information

Chapter 9 Slide Shows

Chapter 9 Slide Shows Impress Guide Chapter 9 Slide Shows Transitions, animations, and more Copyright This document is Copyright 2007 2012 by its contributors as listed below. You may distribute it and/or modify it under the

More information

BDM s Annotation User Guide

BDM s Annotation User Guide ETS :Foothill De Anza CC District April 17, 2014 1 BDM s Annotation User Guide Users with Read/Write access can annotate (markup) documents if they retrieve the document using Microsoft s Internet Explorer

More information

Adobe Acrobat Reader 4.05

Adobe Acrobat Reader 4.05 Adobe Acrobat Reader 4.05 1. Installing Adobe Acrobat Reader 4.05 If you already have Adobe Acrobat Reader installed on your computer, please ensure that it is version 4.05 and that it is Adobe Acrobat

More information

Mac OS X Part 3. The University of Utah Student Computing Labs Macintosh Support

Mac OS X Part 3. The University of Utah Student Computing Labs Macintosh Support Mac OS X Mac OS X Part 3 The University of Utah Student Computing Labs Macintosh Support mac@scl.utah.edu Basic overview of Mac OS X s interface Finding files/folders Basic overview of directory structure

More information

BLUEPRINT READER 2010 INSTALLATION & USER GUIDE 09OCT09

BLUEPRINT READER 2010 INSTALLATION & USER GUIDE 09OCT09 BLUEPRINT READER 2010 INSTALLATION & USER GUIDE 09OCT09 The information in this document is subject to change without notice and should not be construed as a commitment by Blueprint Software Systems Inc.

More information

Overview of Adobe InDesign CS5 workspace

Overview of Adobe InDesign CS5 workspace Overview of Adobe InDesign CS5 workspace In this guide, you ll learn how to do the following: Work with the InDesign workspace, tools, document windows, pasteboard, panels, and layers. Customize the workspace.

More information

Creating Web Pages with SeaMonkey Composer

Creating Web Pages with SeaMonkey Composer 1 of 26 6/13/2011 11:26 PM Creating Web Pages with SeaMonkey Composer SeaMonkey Composer lets you create your own web pages and publish them on the web. You don't have to know HTML to use Composer; it

More information

page 1 OU Campus User Guide

page 1 OU Campus User Guide page 1 OU Campus User Guide Logging Into OU Campus page page 2 1. Navigate to a page on your site that you wish to edit. 2. Scroll down to the footer and click the symbol. 3. Enter your OU Campus username

More information

MICROSOFT WORD 2010 BASICS

MICROSOFT WORD 2010 BASICS MICROSOFT WORD 2010 BASICS Word 2010 is a word processing program that allows you to create various types of documents such as letters, papers, flyers, and faxes. The Ribbon contains all of the commands

More information

Adobe Acrobat Pro: Tips, Tricks and Timesavers

Adobe Acrobat Pro: Tips, Tricks and Timesavers Learner Outcomes: How to apply reviewing features to a PDF Learn how to manage and secure your documents Explore how to build forms in Acrobat Find out how to add and edit form fields including text fields,

More information

Impress Guide Chapter 11 Setting Up and Customizing Impress

Impress Guide Chapter 11 Setting Up and Customizing Impress Impress Guide Chapter 11 Setting Up and Customizing Impress This PDF is designed to be read onscreen, two pages at a time. If you want to print a copy, your PDF viewer should have an option for printing

More information

Edupen Pro User Manual

Edupen Pro User Manual Edupen Pro User Manual (software for interactive LCD/LED displays and monitors) Ver. 3 www.ahatouch.com Some services in Edupen Pro require dual touch capability. In order to use dual touch, your computer

More information

Introduction to Topologi Markup Editor , 2005 Topologi Pty. Ltd.

Introduction to Topologi Markup Editor , 2005 Topologi Pty. Ltd. http://www.topologi.com Introduction to Topologi Markup Editor 2.3 2004, 2005 Topologi Pty. Ltd. info@topologi.com Markup Editor Edit publishing-oriented documents in the built-in Markup Editor: a tag-aware

More information