The UBot Studio SCRIPT REFERENCE. The Flow/Input/Variable/Qualifier Commands

Transcription

1 The UBot Studio SCRIPT REFERENCE The Flow/Input/Variable/Qualifier Commands

2 FLOW COMMANDS SCRIPT REFERENCE PAUSE SCRIPT STOP SCRIPT DELAY WAIT FINISH INCLUDE LOOP THREAD IF THEN ELSE WHILE RUN SCRIPT SUB/RUN SUB IN FIREFOX WINDOW IN IE WINDOW IN SUB WINDOW DIVIDER

3 INPUT COMMANDS SCRIPT REFERENCE (CLICK TO JUMP TO): MOVE MOUSE MOUSE CLICK SEND KEYS PRESS OR RELEASE KEY

4 VARIABLE COMMANDS SCRIPT REFERENCE (CLICK TO JUMP TO): SAVE TO FILE SET SET LOCAL PARAMETER INC DEC ADD TO LIST ADD TO LOCAL LIST REMOVE FROM LIST SET LIST POSITION CLEAR LIST CREATE TABLE FROM FILE SET TABLE CELL ADD LIST TO TABLE AS COLUMN ADD LIST TO TABLE AS ROW CLEAR TABLE

5 QUALIFIER COMMANDS SCRIPT REFERENCE (CLICK TO JUMP TO): TRUE/FALSE BOTH EITHER EVALUATE NOT SEARCH PAGE CONTAINS

6 FLOW COMMANDS: PAUSE SCRIPT: This will pause the script, as though you hit the pause button. This should generally be used for debugging. This command can be placed anywhere in the script. Once the script reaches this command and executes it, the script will pause until you hit the play button again to resume the script where it left off. When a script is paused it will show both the play button and the stop button (see image):

7 STOP SCRIPT: This command will stop the script as though you hit the stop button. When the play button is pressed AFTER a stop script has executed, the script will start from the beginning. DELAY: This command will suspend the script for a specified number of seconds. This command can be very useful in bots that contain a lot of commands varying in complexity. Placing delays intermittently within a script can help improve its performance as it allows the application time to process all the functions and data. The only parameter for this command is the number of seconds:

8 WAIT FINISH: This command suspends the script until a web page has finished loading. It is also very useful after clicking a button or a link on a web page. It is most commonly used following a navigation command. There is only one parameter which is the number of seconds to wait before the script continues processing. The default number is 30 seconds.

9 INCLUDE: This command allows you to use subs and scripts from other bots (.ubot files) via the from included bot command. When this command is placed in the scripting area you will be asked to select a ubot file to include: The file you include can come from one of two places: Your hard drive (from the local computer), OR From the internet via a url (you can upload a ubot file to your server and call it from this command. i.e. This command can be used in several different ways, so it's important that you understand them to use it effectively. How you use this command depends entirely on how you set up your.ubot file that you will be calling via the INCLUDE command. If your file is an entire script that you wish to run as a whole script, then you will call it using the Run Script command from the Action

10 Commands Menu. By doing that you will be running it is an independent script. If your file is made up of several different subs (like a library of sub routines) then you will call each sub separately with the Run Sub command from the Action Commands menu. Once you include another script into your bot, it will be listed when you call it via the Run Script or Run Sub commands: IMPORTANT! : THE SCRIPT BEING CALLED VIA THE INCLUDE COMMAND MUST BE ACCESSIBLE IMMEDIATELY WHEN THE APPLICATION IS LAUNCHED OR YOU WILL RECEIVE AN ERROR. (i.e. it cannot be behind a protected directory or login script if being called from the web). There is one very important thing you need to know about using the INCLUDE command, that if ignored, will cause this command not to work.

11 ***You cannot pass variables across independent scripts! The way you overcome this issue is to use the Parameter command located in the Variable Commands menu: There are two ways you can use this command: 1) You can simply place then at the top of the script being called, or 2) Place them in a sub at the top of the script being called When you place the parameter command in the scripting area, you'll be asked for the name of the parameter you would like to pass:

12 Since the parameters will already be set in the script being called, you will need to specify which parameter it is being set to in the main bot at the time you first use the include command. So, your main bot is calling an external script using the INCLUDE command. The script being called has used the Parameter command(s) to set the variables... When you drag the RUN SCRIPT or RUN SUB command into the scripting area of your main bot you will see the following parameter options:

13 You will simply enter the variables you want to associate those parameters with in the main bot (so if the main bot has the variables #username and #password, you will set #user to #username and #pass to #password). Once you do that then the main bot will be able to pass those variables to the included bot.

14 LOOP: The LOOP command allows anything contained within it to be repeated a specified number of times. The number of loop cycles can be set using a variable (as long as it's set to a number), $list total (the total number of items in a list) or a number itself. As you can see in the above image, you can set the number of cycles to a number (in this case 10 ), you can set it to the variable #cycles (which was set to the number 10) or you can set it to a list total. The image shows a variable set to a list total, but you can use the list total constant directly in the parameter box by right clicking in the red rectangle and choosing $list total from the variable constants menu (see image below).

15 The LOOP command has so many different uses, it's just not possible to show them all here, but you will get the idea of how you can use them in your scripts. For this example we will create a list consisting of 100 numbers from 1-100: As you can see the variable #number was set to 1 and the number of cycles was set to 100. This loop will add the number one to the

16 list %numbers and then increment the variable (#number) by 1 on each cycle of the loop. This will result in a list of numbers from The next thing we want to do is remove all items on that list that are less than 50. In order to do that we will use another loop, only this time we will set the number of cycles to the list total of %numbers: We will then add in If/Then statement and use EVALUATE as the qualifier. The first value is set the list item starting in position 0 (notice we set the position to zero and then use the variable as the list position. This is because we will increment it as we did before). The condition is Less Than (<) and the second value is 50. So what it says is IF the list item in the specified list position is less than We will then add the THEN commands to execute if the condition returns true (that is to say if the number is less than 50, what do we want it to do?):

17 As you can see, if the condition returns true then the list item at position (#position) will be removed from the list, the position will be decremented by 1, and then incremented by 1. Why? Because if we remove list position3, for example, then the original list position 4 BECOMES position 3, so we need to evaluate position three again. It is also necessary to maintain the integrity of the number of cycles (regardless of how many items are removed, we still need the loop to evaluate ALL 100 list items, so if we removed and only incremented, we would get an error when it reached the end of the list since it was trying to do 100 cycles on only 51 list items). Once this script is run the list will contain only the numbers from Everything else will have been removed from the list.

18

19 THREAD: This command will execute the commands within it in a separate thread from the main script. This means that everything that happens within the thread happens independent of, and simultaneously with the flow of the script. In the code demonstrated in the image, the mouse click command is located inside the thread. This mouse click is the command that will cause the dialog box to appear on the screen (to choose a location to save the file to:

20 The next command in the script is a click dialog button (the Save button). If the THREAD were not present in the script, the dialog box would cause the script to wait until the dialog box was no longer on the screen. The script would NOT proceed to the click dialog button command. The THREAD allows the dialog box to be present AND allows for the script to continue to the next command. You can think of it as a sort of an Overpass where traffic still continues to flow underneath it as opposed to an intersection where traffic has to wait their turn to proceed. The traffic that flows across the overpass does not affect or impede the traffic that flows on the road below.

21 IF-THEN-ELSE: Although the command is listed as if, this command is a full if-then-else statement. This command allows you to create a condition that, when true, will execute the THEN node and when false will execute the ELSE node. In this example you will see a UI List Box that contains two options: Google Yahoo The purpose of the list box is to set a conditional statement that causes specific actions to occur when either of those two options are chosen. In other words, what do you want the script to do if Google is chosen, and the same goes for Yahoo. So the next step is to set up the conditional statement itself.

22 You will do this by dragging the if command into the scripting area: You will see the command node appears initially with all three nodes empty. In this case we have added the qualifier command evaluate to the IF node as we want to evaluate the user input of the list box to determine what the script should do next. Very simply in this case, IF Google is chosen, THEN navigate to ELSE navigate to The problem here is that if nothing is chosen it will navigate to You can overcome this with a second conditional statement telling it to navigate to if Yahoo was chosen from the list.

23 To account for all possible conditions in this example you will see three conditional statements: 1. What happens when Google is chosen? 2. What happens when Yahoo is chosen? 3. What happens when nothing is chosen? Please note that when nothing is chosen in the third conditional statement, there is a stop script following the alert. This will cause the user to enter a choice and the script will start from the beginning. Recap: IF---> The condition you set THEN---> Executes when the condition returns TRUE ELSE---> Executes when the condition returns FALSE

24 WHILE: This command will run all contained commands as long as its qualifier remains true. It is also known as a while loop. The command initially calls for a qualifier command to determine whether or not the condition is true or false.

25 In the above example the condition is set as: As long as the url of the web page contains the word google... In this case it navigates to and enters a random number between in the search filed and presses the search button. Since these are all google searches, it doesn't matter what search we perform, the url will ALWAYS contain the word google therefore making the condition indefinitely true. This loop will execute infinitely. This can be especially useful if you are looking for something specific where the number of required loop cycles is unknown.

26 RUN SCRIPT: This command allows you to run a script as though it were a sub routine. For the purposes of Ubot, we can define a script as being... "A collection of commands centered around a single task represented by a tab on the user interface" All the code located in the Script 1 tab would be considered an independent script just as all the code located within the other 3 tabs would also be considered individual scripts. NOTE: A Run Script command can be placed at the end of each script to continuously run all 4 scripts, but by definition they are still considered independent of one another. By placing a Run Script command at the end of Script 1 for the purpose of running Script 2 eliminates the need for the user to click on the Script 2 tab and click the play button. You can also use the Run Script command to run a script that was called using the Include function (so it does not necessarily need to be physically located within the script your are working on).

27 SUB/RUN SUB: This command is like a self contained script within a script. It allows you to create more manageable and cleaner coding in your scripts. When you have a sub in your script it will not execute the code within it until it is called by a Run Sub command. The Run Sub command simply tells the script when to execute the code within a particular sub. Each sub is distinguished by a specified name (i.e. you need to name each sub, and no two subs can share the same name within a single bot). The power of the Sub node is realized when it is implemented in a script as reusable code. That is to say, you can code a function that you can use over and over again simply by placing the Run Sub command wherever you want that particular code to execute. In the image below you will see there is a UI text box that asks for a keyword. This is not coded inside the sub. But the sub contains commands that tell it to navigate to google, place the keyword from the ui text box in the search box and conduct the search. The way you see that code as it is, the sub will NOT run. It requires the Run Sub command which is not present in that image or in the code. However, regardless of where that sub is located in the script, you can call it as many times as you like by simply placing the Run Sub command in your script. That makes that function reusable without having to re-code it each time you want to run that sub.

28 In order for that sub to run, simply add the Run Sub command anywhere in your script where you want it to run. The parameter option for the run sub is simply the name of the sub which will be located in a list in the parameter window:

29 IN FIREFOX WINDOW: This command allows you to run all commands and constants located within this container in a Firefox browser. The browser appears in a new window, independent of the integrated Ubot browser window. The example above simply navigates to within a Firefox browser window.

30 IN IE WINDOW: This command is exactly the same as the In Firefox window command except it executes all its code in an independent Internet Explorer window as opposed to an independent Firefox window.

31 IN SUB WINDOW: This command runs all commands and constants contained within it in a separate web browser in a separate window. Placing code inside a sub window, despite opening a new window, remains part of the main script flow, and no code that follows the sub window will execute until after all the code within the sub window has finished executing. One common use for this command may be when creating accounts in the main browser window, a sub window can be used to navigate to the web mail account to verify the registration. In the image above an account has been created in the main browser and the can be retrieved in a sub window. As you can see the main browser stays the same and the account is accessed via a sub window.

32 DIVIDER: This command adds a space in your script to enhance the aesthetics of the script window. It is also very useful for organizing your script into sections.

33 INPUT COMMANDS: MOVE MOUSE: This command is used to place the mouse cursor at a specific location on the screen (or within the browser) using specified screen coordinates. The coordinates can be placed manually into the parameter fields or they can be generated by holding the ctrl button and moving the mouse to the desired location on the screen. The location you select will be relevant to the second parameter choice. These choices include screen, browser or active window. ***NOTE: It is important to select number 1 before choosing the mouse position as the mouse position will be relative to whatever choice is selected in the relative to parameter box.

34 MOUSE CLICK: This command will simulate a mouse click, a mouse up or mouse down action. There are several choices for mouse clicks: 1) Left Click 2) Right Click 3) Double Click 4) Left Mouse Down 5) Left Mouse Up 6) Right Mouse Down 7) Right Mouse Up

35 SEND KEYS: This command simulates typing on the keyboard. It can be very useful for using keyboard shortcuts in addition to using keyboard action keys. Below is a list of commonly used Send Keys commands you can utilize with this command: Key BACKSPACE BREAK CAPS LOCK DEL or DELETE DOWN ARROW END Code {BACKSPACE}, {BS}, or {BKSP} {BREAK} {CAPSLOCK} {DELETE} or {DEL} {DOWN} {END} ENTER {ENTER}or ~ ESC HELP HOME INS or INSERT LEFT ARROW NUM LOCK PAGE DOWN PAGE UP PRINT SCREEN RIGHT ARROW SCROLL LOCK TAB UP ARROW F1 F2 F3 F4 F5 {ESC} {HELP} {HOME} {INSERT} or {INS} {LEFT} {NUMLOCK} {PGDN} {PGUP} {PRTSC} {RIGHT} {SCROLLLOCK} {TAB} {UP} {F1} {F2} {F3} {F4} {F5}

36 F6 F7 F8 F9 F10 F11 F12 F13 F14 F15 F16 {F6} {F7} {F8} {F9} {F10} {F11} {F12} {F13} {F14} {F15} {F16} Send keys commands can be combined as shown in the image:

37 PRESS OR RELEASE KEY: This command simulates the pressing (and holding) of the Alt, Shift and Ctrl keys. There are two parameters to choose from: 1) Which key to press 2) Wheter you are pressing or releasing the chosen key The second parameter is important to understand because once you press one of these keys programatically it will stay pressed until you release it programatically. You can use this command in conjunction with other key presses (such as the Send Keys command) to do things like Select All (Ctrl + a), etc. (see image below)

38 VARIABLE COMMANDS: SAVE TO FILE: This command allows you to save text and lists to a file. You can specify the name and location where you want to save the file. If you are saving text, it will save it verbatim to the file, and if you are saving a list it will save it to the file one list item per line. You can read these files using the $read file or $list from file constants. You can save files with whatever extension you choose (i.e..txt,.csv,.html,.bat, etc) The two parameter options are: 1. location and name of file (where you want the file saved) 2. content of the file (what content you are saving) This command will create the file you specify. The basic application of this command is relatively self explanatory, so

39 the example that will be shown demonstrates a more unique application of the command: The first step in this example is to create a simple html page using your favorite html editor. Here is the page I've created for this example: A very simple page with a title, a table and some text. The next step is to copy all the html code of this page (in most editors you just go to code view, highlight all the text and hit ctrl+c). Now you want to drag the Save to File command into the scripting area, choose a location to save the file (with a file name) and paste the html code into the content:

40 Now that you have the file created and saved on your computer you are going to set some variables (3 total): The first variable(#html) is set to $read file (The file you just created) The second variable (#username) is set to an auto generated username The third variable (#password) is set to an auto generated password Now for the fun part. We are simply going to replace some of the text in the html file with the variables we set. To do that we will use two (2) set commands.

41 So the original variable #html was set with a %read file constant making its contents available through the variable. The first command resets the variable using a $replace function (found in the text constants), and replaces AAA with the username variable that was set. The second command does the exact same thing with BBB and the password variable. Now we can save the #html file back to its original location and navigate to the new file which contains our login information: After the script is run you can see the resulting html page in the image below:

42 This is an excellent technique when you want to display results from scraping, submitting, keyword analysis, etc. You can create your html file to look any way you want using any colors, images etc, as the file is stored on your computer and there is no need to upload it. NOTE: if you use images, however, you will need to upload them to your server or hosting account and place the proper path in the html code.

43 SET: This command allows you to create a variable and choose its value. Variables can be set to a large variety of values that are not just limited to words or numbers. Some of those values are: Math Functions (using $eval) File Contents (using $read file) List Totals (using $list total) User Data (i.e. usernames, passwords, etc)...and Much More! There are two parameters when creating a variable with the set command: 1. The Variable Name 2. The Value Simply provide a name and a value:

44 Which results in: The variables you set become GLOBAL variables in the script once you run the script containing them. (You have to hit the play button to actually set the variable). However, if the variables are set in Tab 1 and you run Tab 1, then the variables can be passed to all the other tabs in the bot.

45 SET LOCAL: This command is similar to the Set command with one exception. The variable you create is only available in the sub or script it is created in. So if the set local variable is created in Tab 1, it can only be passed in Tab 1.

46 PARAMETER: When this command is used at the top of a sub or a script, it allows the parameters to be passed when the script is called from another source and they become local variables. Since the ability to call scripts from a url has been added, this is significantly more important to understand. Without the use of this command none of your included scripts will function. This command is simple to implement. There are only two steps you need to follow. The first step is to add the parameter commands to the script (That is to say, any script you may be calling from another source). Simply provide variable names for the parameters. After you've included the script in the main script, you will add a Run script command and choose the script you have included. It is here you will set the parameters to a local variable:

47 In this scenario the parameter containing the variable #username was set to the local variable #username. The same was done with #password. Now the variables in the main bot (via the UI text boxes) will be passed to the included bot.

48 INC: This command increments a numerical variable by 1. The simplest way to demonstrate this is with a simple loop that creates a list. The first step is to set a variable to a numerical value. In this case it will be set to 0 : The next step is to create a simple loop: This loop will create a list of numbers from 0-9. Keep In mind the variable gets set outside of the loop.

49 DEC: This command decreases a numerical variable by 1. It works exactly the same way the inc command works. So given the previous example, you would just set the variable to 9 and replace the inc command with the dec command...then the loop will create a list of numbers from 9-0

50 ADD TO LIST: This command allows you to work with multiple strings or variables at the same time which is essential for page scraping or loading information from text files. Choosing add to list with a sub parameter of $list from file will allow you to pull a text file into a Ubot list (all lists are indicated by a % sign), which can then be modified or read on a line by line basis with a variety of commands. Lists are commonly used when text manipulation is required by the user. There are three (3) parameters required when adding the add to list command: 1. The list name 2. The content, and 3. Whether or not you want to delete duplicates

51 To start you just need to provide a name for your list. Any name you want is fine. The second parameter asks for the content. In this example we are going to create a list from 1 to 10 using the add to list command inside a loop. To do this simply set a variable to 1 using the set command: You now want to add a loop just below the set command with 10 cycles: Now you are going to add the add to list command, give it a name, and enter the variable you set as the content: Since #number is set to 1 the first cycle of the loop will add the number 1 to the list. In order to get it to add number 2 in the next cycle and then number 3, etc we need to add the inc command inside

52 the loop using #number as the variable to increment: ***IMPORTANT...Any time you create a list you need to add a clear list command at the top of the script (or prior to creating the list) That's it. The above script will create a list of numbers from 1-10.

53 ADD TO LOCAL LIST: This command is similar to add to list with the exception being the list is only accessible in the script or sub it is created in. REMOVE FROM LIST: This command allows you to remove items from a specified list, at a specified list position. If the need arises to remove a list item this is the command that will accomplish that. The two parameters required are: 1. The list name (of the list you are removing the item from), and 2. The list position of the item to be removed In the previous example we created a list of numbers from If you wanted to remove the number 6 you would use the remove from list command like this: Remember you are using list position 5 because the list is zero based (meaning the first position is 0 not 1).

54 SET LIST POSITION: This command sets the list position which is used by $next list item. In short, it provides a reset for you to use when running a list more than once. Similar to the set command you will provide a a list name and a value, but in this case it will be a numerical value (since it refers to a list position). In a previous example we created a list from one 1-10 (see add to list). If you were to run that list to check, for example, to make sure no numbers were greater than ten: Assuming you need to run the list again to make sure no list items are,

55 for example less than 1, you would reset the list position to 0 to ensure it starts from the top of the list and does not throw the exceeded range of the list error: Just add the set list position command and you can rerun the list. Do this as many times as you need to.

56 CLEAR LIST: This command empties the contents of an existing list and resets its position to 0. This is an essential command to add to EVERY script that uses a list. If this command is omitted, and the script creates a list, it will append all new list items to the previous ones that were created in the same instance of Ubot. In other words, if you run your bot and create a list with numbers from Stop the script and then run it again (without clearing the list, it will contain the numbers 1-10 twice on the list (20 numbers total). To use it, simply drag it into the scripting area anywhere BEFORE the list is created and tell it which list to clear:

57 CREATE TABLE FROM FILE: This command allows you to create a table based on a.csv (comma separated value) file. So if you had a.csv file (that when opened in Excel) that looked like this: And you wanted to create a table from this file, you would bring the command into the scripting area, name the table and load this file. For the sake of this example we will say this file is called names.csv: All tables are denoted with the & symbol. Since all lists and tables are zero based, the structure of the csv file

58 and the table are the same with the exception of the column and row numbers. The following image illustrates how the tables are set up:

59 SET TABLE CELL: This command allows you to set a specific cell in a table. If the table does not exist it will be created. There are four (4) parameters required for this command: 1. Table Name 2. Row Number 3. Column Number 4. Cell Content If you wanted, for example, to create column headers in the table because you planned on saving the table to a.csv file, this command would accomplish that for you.

60 ADD LIST TO TABLE AS COLUMN: This command inserts a list into a table as a column in a specified area. If the table does not exist, it will be created. There are four (4) parameters required for this command: 1. Table Name 2. Row Number 3. Column Number 4. List Name So if the list %names contained: Bob Jones 23 and it was added to a table as a column starting at row 0 and column 0, it would look like this:

61

62 ADD LIST TO TABLE AS ROW: This command inserts a list into a table as a row in a specified area. If the table does not exist, it will be created. There are four (4) parameters required for this command: 5. Table Name 6. Row Number 7. Column Number 8. List Name So if the list %names contained: Bob Jones 23 and it was added to a table as a row starting at row 0 and column 0, it would look like this:

63

64 CLEAR TABLE: This command empties the contents of an existing table. This is an essential command to add to EVERY script that uses a table. As it ensures the table is empty prior to adding any data to it: Just provide the name of the list you want to clear an make sure the clear node appears prior to the table commands in the flow of the script.

65 QUALIFIER COMMANDS: TRUE/FALSE: These commands return True and False respectively. They can be used to set the condition within an If/Then Statement to execute commands within the Then or Else compartments of the statement. When True is entered in the qualifier field of the If/Then statement then the Then commands will always be executed. When False is entered in the qualifier field of the If/Then statement then the Else commands will always be executed. In and of itself this may appear to be a bit random or arbitrary. So let's take a look at a practical application for these commands: The idea behind the True/False qualifiers is that it is currently only used for debugging purposes.

66 BOTH: The Both qualifier allows you to have more than one sub node within the While loop or the If Then Else command. Simply put BOTH conditions must be met to execute the THEN node within an if/then statement or while loop. As you can see in the image, the both qualifier provides you with two qualifier place holders. This is where you will set the two conditions that must return true in order to run the THEN node. If they don't return true, then the ELSE node will get executed. So for this example we will first set the two conditions:

67 The first condition that must return true uses the contains qualifier, and states, If the page url contains 'hotairballoons' AND The second qualifier that must return true states: A search page qualifier finds the text, Hot Air Balloon Rides in USA on the page... If both qualifiers return true, the THEN node will execute any commands in it. If not, the ELSE node will execute.

68 EITHER: The Either qualifier is similar to the Both qualifier in that you are setting two conditions within the If/Then statement. The difference is that only one of them needs to return true to execute the THEN node. Although both of these conditions return true, the THEN node would execute with only ONE of them returning true. If neither condition returns true the ELSE node would execute. The conditions can be any of the qualifiers and can include math functions or files. For example, IF--->Either file1.txt OR file2.txt CONTAINS How To THEN---> Do Something. OR IF--->Evaluate: #Results<1000 OR $url CONTAINS bing.com THEN---> Do Something.

69 EVALUATE: The Evaluate qualifier is the most common of all the qualifiers. The evaluate qualifier allows you to compare any two values, which will return true if they match. There are three (3) parameters associated with the evaluate qualifier: The first value which can be a variable, a number or any value you want to compare against another. The condition which is either equal to (=), less than(<) or greater than (>). The second value which is the value you are comparing against the first value. In the image above you will see the first value, condition and second value set as: 5 > 2 (5 is greater than 2). Since that condition will return true, the THEN node will execute. If the second value was 10, the condition would return false and the ELSE node would execute. This can be a very powerful component of your script if used properly.

70 One excellent use of this command is based on scraping data for keyword research. EXAMPLE Go to Google and type in a keyword: You will see just underneath the search box the number of results that were returned for that keyword (see image): In this case it is 6,560,000. You will want to isolate that number by first scraping the whole string (About 6,560,000 (0.17 seconds) This is one way to do that: You have now set the scrapes string to the variable #results. Next you want to start removing the parts of the string you don't want. The first step is to remove About and the results.(note the space before and after the word results ) You can do these in the exact

71 same way you set the variable and adding the $replace function (see image): Take note that you are replacing the words with $nothing. The final step is to remove the parenthesis and everything in them. This can be done easily using regular expressions (regex) as follows: \(\d\.\d{2}\sseconds\) \( Literal text Left Parenthesis \d Single digit between 0-9 \. Literal text -period(dot) \d Single digit between 0-9 {2} Repeat twice (number of digits) \s Literal text - space Seconds The word seconds \) Literal text Right Parenthesis The replace function for the parenthesis is slightly different.

72 Now your scraped data is ready to be evaluated. Very simply place the evaluation qualifier inside and If/Then statement: What that statement says is IF my variable(#results) is greater than 200,000 THEN tell me the keyword is no good. We know the variable we scraped is 204,000 so the condition returns true and you get the message the keyword is no good.

73 You should start seeing in that example how useful the evaluate qualifier can be. Take some time and play around with it to see how many different unique uses you can find!

74 NOT: This will return true when its sub nodes do not return true. It is used in conjunction with other qualifiers (see image): What this image show is: IF the $url does NOT contain the word google THEN navigate to Again, the NOT qualifier is a container for another qualifier.

75 SEARCH PAGE: This is a qualifier that will return true if the specified text is present on the page within the browser. There are two ways to use this qualifier. You can either drag the node from the qualifiers menu to the qualifiers place holder in the If/Then statement, OR You can highlight the qualifiers place holder in the If/Then statement, roght click the text in the web browser and choose search page from the menu. By doing it the second way, it pre-loads the text you are searching for into the parameters window.

76 The above image is the result of the second technique (right clicking the text in the browser. If you highlight the text in the right pane it will load in the center pane: Just a note about the search page. This function WILL work if you navigate to, for example a text file (as it will load the text file in the browser). So if you have a file on your hard drive you want to search, this function will work for you.

77 CONTAINS: This qualifier will return true if the container text or list contains the specified search text. You can check a list or a file to see if it contains specific text: There are two (2) parameters. The first parameter asks for the the list or text you want to search for and the second parameter asks for the specific text to search for. In this case two lists will be created from text files. 1) A generic list of cars 2) A list of the worlds 10 most expensive cars The script will check the generic list to see if it contains the item from the second list. If it does, it will add that item to a third list. So the first step is to create the two lists from the files:

78 The next step is to loop through the second list and check it against the first list. We will do this by setting the list position to zero and checking by $list item. (see image below):

79 Next we will add the If/Then statement to the loop using the contains qualifier: The condition states that IF my list CONTAINS the text found in the list item of the top ten list, THEN add that item to a third list and increment the position. If it does not CONTAIN the text then just increment the position. The two text lists are:

80 1) Maybach 62 Zeppelin SSC Ulitmate Aero Leblanc Mirabeau Pagani Zonda F Coupe Maybach Landaulet Pagani Zonda F Roadster Lamborghini Reventon Pagani Zonda Cinque Coupe Bugatti Veyron 16.4 Pagani Zonda Cinque Roadster 2) Ferrari Corvette Jaguar Mercedes Benz Bentley Maybach 62 Zeppelin SSC Ulitmate Aero Leblanc Mirabeau Pagani Zonda F Coupe Maybach Landaulet Pagani Zonda F Roadster Lamborghini Reventon Pagani Zonda Cinque Coupe Bugatti Veyron 16.4 Pagani Zonda Cinque Roadster BMW Hyundai Toyota Rolls Royce Lotus Honda Volkswagon Oldsmobile Ford Chevy Dodge Porsche This process should return a third list containing all the items from the second list.

81 When run it does exactly that. It returned the ten items we were looking for in the larger list.