|
  |
Getting Started: The interface
Introduction
The Djuggler interface and work method is simple and straightforward. Take a look at the interface below. There are three main windows: Actions, Script and Variables & Sources. The Script window is where you compose your script. The script is composed of script lines, called actions. You find all the actions you can use to the left in the Action window. A script is thus composed of multiple actions. An action can be opening a web page, setting a variable, doing a text search etc. Actions themselves make extensive use of variables to handle data. You will find variables in the lower window, called Variables & Sources.
The main Djuggler interface with Script, Actions and Variables & Sources windows.
Creating a script
You can insert script lines or actions by double-clicking on an action, or simply dragging it rom the Actions window into the Script window. The actions are devided into categories. As an example we will insert the Show Message action into the new script. A new script line will appear in the Script window, showing the Show Message action. This action, when executed, will display a message to the user in a dialog. When an action is inserted, all it's variables (if any, but most actions use them) are empty. We need to fill in the message we want to display in the action. To do so, we open the Properties window by double-clicking on the action in the Script window. The properties window is displayed below.
The Properties window that allows you to set action variables.
The Properties window allow you to set the variables an action needs to properly execute. In this case, Show Message needs a message text. If you take a look at the screen above, you see that there is only one variable in this action, called Text. Click in the box next to text, and fill in "Hello world!". That's it! Click Done to return to the Script window. You will now see that show message carries the text "Hello world!".
Next, we will give a go at executing this script. Click on the Run button in the button bar. This causes Djuggler to interpret and run the script you have created in the script window. It will follow all actions one by one, like a recipe, from top to bottom.
Djuggler during the run of our script.
Well, that's it. That is how you create a script and execute it. To make more sophisticated scripts, you probably want to acquire more knowledge about Djuggler. We suggest reading the remainder of the Getting Started text, and reading the Important Concepts text to get properly acqainted with Djuggler.
The Variables & Sources window
Let us take a brief look at the Variables & Sources window. Variables and sources will be explained in detail in the Important Concepts section, so for now we concentrate on the window itself. Take a look at the window below.
Some variables after a run.
You can have different kinds of variables to store different kinds of data in. In the window above you can see a Text, a Number and a Web Page variable. Also, you can see the ccontent of a variable during and after a run in the third content column. There is a toolbar below the window; clicking on the icons carrying a "+" will create a variable of a certain kind (hover above the icon to see what kind). Of course, you can also use the menu: Variables|New Source, or Variables|New Variable. Variables are always filled by actions, so you cannot give a variable a value in this window. To delete a variable, select the variable in the window, and press the "x" icon or just hit the "Del" key.
The Properties window
The Properties window is very important as it is the control area of an action. It is here you control the behaviour of an action. The way to do that is to assign variables, sources, literal text and number or default settings to an action variable. (Indepth information on variables and sources can be found in the Important Concepts section.)
The Properties window displaying direct action help.
The Properties window gives direct help about the action in its window. You can directly read what the action does, and how you should use it. Also, the action variables are explained.
The input box (where you type "Hello world!") is where you type a literal text, or chooose a variable. The input box changes according to the allowed types of variables that may be choosen. If it is allowed to type literal text, like in the Text variable about for Show Message, it lets you type text directly into the input box. In addition, you can get a drop down that lets you choose all the allowed variables for the Text variable. In this way, it helps you to choose the right kind of variable.
A variable dropdown in the Properties window.
Take a look at the example above. The Text variable input box is dropped down. Remember, the Text variable holds the message for the Show Message action. You can type it directly, as was done with "Hello world!". From the list, you may also choose variable Text1. In that case, Show Message will show the content of this Text1 variable as the message in the dialog. A number variable such as Number1 is also allowed. If you would like to create a variable and fill it in at the same time, choose "> New Text variable" or another kind suiting your needs.
Running a script
You Run a script to execute all of its actions. The script engine will start a the top line, execute it, and continue to execute lines until the last line is reached and the executing process stops. There are a couple of ways to execute script actions. Pull down the Script menu to see the options.
Full Run. Click Run to execute a full automatic run from the first line of the script to the last. This is the speedy way of executing scripts. No feedback is given to the user a to what happens, although after a run you can see the value of variables in the Variables & Sources window.
Debug Run. Click Debug Run to execute a full automatic run from the first line of the script to the last, while indicating the currently executed script line during the run. The Variables & Sources window is updated during the run.
Stepping. Stepping allows you to manually walk through the script. One script line at a time is executed. The Variables & Sources window is updated after each step. The stepping process starts from the current line position (the yellow line in the script window), allowing you to execute one line only to see the effect of it, or to do a partial execute.
Getting Started: The interface
Introduction
The Djuggler interface and work method is simple and straightforward. Take a look at the interface below. There are three main windows: Actions, Script and Variables & Sources. The Script window is where you compose your script. The script is composed of script lines, called actions. You find all the actions you can use to the left in the Action window. A script is thus composed of multiple actions. An action can be opening a web page, setting a variable, doing a text search etc. Actions themselves make extensive use of variables to handle data. You will find variables in the lower window, called Variables & Sources.
The main Djuggler interface with Script, Actions and Variables & Sources windows.
Creating a script
You can insert script lines or actions by double-clicking on an action, or simply dragging it rom the Actions window into the Script window. The actions are devided into categories. As an example we will insert the Show Message action into the new script. A new script line will appear in the Script window, showing the Show Message action. This action, when executed, will display a message to the user in a dialog. When an action is inserted, all it's variables (if any, but most actions use them) are empty. We need to fill in the message we want to display in the action. To do so, we open the Properties window by double-clicking on the action in the Script window. The properties window is displayed below.
The Properties window that allows you to set action variables.
The Properties window allow you to set the variables an action needs to properly execute. In this case, Show Message needs a message text. If you take a look at the screen above, you see that there is only one variable in this action, called Text. Click in the box next to text, and fill in "Hello world!". That's it! Click Done to return to the Script window. You will now see that show message carries the text "Hello world!".
Next, we will give a go at executing this script. Click on the Run button in the button bar. This causes Djuggler to interpret and run the script you have created in the script window. It will follow all actions one by one, like a recipe, from top to bottom.
Djuggler during the run of our script.
Well, that's it. That is how you create a script and execute it. To make more sophisticated scripts, you probably want to acquire more knowledge about Djuggler. We suggest reading the remainder of the Getting Started text, and reading the Important Concepts text to get properly acqainted with Djuggler.
The Variables & Sources window
Let us take a brief look at the Variables & Sources window. Variables and sources will be explained in detail in the Important Concepts section, so for now we concentrate on the window itself. Take a look at the window below.
Some variables after a run.
You can have different kinds of variables to store different kinds of data in. In the window above you can see a Text, a Number and a Web Page variable. Also, you can see the ccontent of a variable during and after a run in the third content column. There is a toolbar below the window; clicking on the icons carrying a "+" will create a variable of a certain kind (hover above the icon to see what kind). Of course, you can also use the menu: Variables|New Source, or Variables|New Variable. Variables are always filled by actions, so you cannot give a variable a value in this window. To delete a variable, select the variable in the window, and press the "x" icon or just hit the "Del" key.
The Properties window
The Properties window is very important as it is the control area of an action. It is here you control the behaviour of an action. The way to do that is to assign variables, sources, literal text and number or default settings to an action variable. (Indepth information on variables and sources can be found in the Important Concepts section.)
The Properties window displaying direct action help.
The Properties window gives direct help about the action in its window. You can directly read what the action does, and how you should use it. Also, the action variables are explained.
The input box (where you type "Hello world!") is where you type a literal text, or chooose a variable. The input box changes according to the allowed types of variables that may be choosen. If it is allowed to type literal text, like in the Text variable about for Show Message, it lets you type text directly into the input box. In addition, you can get a drop down that lets you choose all the allowed variables for the Text variable. In this way, it helps you to choose the right kind of variable.
A variable dropdown in the Properties window.
Take a look at the example above. The Text variable input box is dropped down. Remember, the Text variable holds the message for the Show Message action. You can type it directly, as was done with "Hello world!". From the list, you may also choose variable Text1. In that case, Show Message will show the content of this Text1 variable as the message in the dialog. A number variable such as Number1 is also allowed. If you would like to create a variable and fill it in at the same time, choose "> New Text variable" or another kind suiting your needs.
Running a script
You Run a script to execute all of its actions. The script engine will start a the top line, execute it, and continue to execute lines until the last line is reached and the executing process stops. There are a couple of ways to execute script actions. Pull down the Script menu to see the options.
Full Run. Click Run to execute a full automatic run from the first line of the script to the last. This is the speedy way of executing scripts. No feedback is given to the user a to what happens, although after a run you can see the value of variables in the Variables & Sources window.
Debug Run. Click Debug Run to execute a full automatic run from the first line of the script to the last, while indicating the currently executed script line during the run. The Variables & Sources window is updated during the run.
Stepping. Stepping allows you to manually walk through the script. One script line at a time is executed. The Variables & Sources window is updated after each step. The stepping process starts from the current line position (the yellow line in the script window), allowing you to execute one line only to see the effect of it, or to do a partial execute.
|
  |
 |
 |
 |
|
|
|
|
|