RoboTask User's Guide
Keyword Index
Home page



IconQuick Start Guide
IconSeveral practical recommendations
IconMenus
IconActions
IconTriggering Events
IconAppendix
IconOther software

© 2004-2016 Neowise.com

Task - New

Top  Previous  Next

 

Allows you to add a new task. After you select the command, the Add Task dialog box displays, allowing you to select the following tabs to create a task:

 

Actions tab

 

TaskEditorActions

 

Action List

Displays a list of the actions you have selected for the task you are creating or modifying. Click the Add button to add an action. Select an action in the Action List and click the Edit button to modify the action parameters.

 

When you start the current task, the actions run in the order in which they appear in this list.

Click the clip0175 & clip0177 buttons to move an action up or down in the order listed.

 

clip0179Record a macro

In order to record mouse actions "as is" click this button. Macro recorder catches mouse actions and saves them as a sequence of task actions.

 

Add

Place the cursor in a row of the Action List where you want to add an action. You can then click the Add button to display a list of actions that you can add to the task.

 

Edit

Select an action in the Action List and click the Edit button to modify the parameters, or settings, for the action.

 

Remove

Select an action and click the Remove button to remove the action from the task.

 

Move Step Up

Select an action in the Action List and click clip0175 to move the action up in the list. This ensures the action runs earlier in the process when the task runs.

 

Move Step Down

Select an action in the Action List and click clip0177 to move the action down in the list. This ensures the action runs later in the process when the task runs.

 

Enabled

If the check box is cleared, the task is disabled and you must run it manually by double-clicking the task in the RoboTask window.

 

Tip

To change the Enabled setting, select a task in the RoboTask window and right-click.

 

Triggering Events tab

 

TaskEditorEvents

 

Event List

Displays a list of the events you have selected for the task you are creating or modifying. The order in which events appear in the list does not matter.

 

Run When RoboTask Starts

If this check box is selected, the task will run automatically when RoboTask starts.

 

Run When RoboTask Quits

If this check box is selected, the task will run automatically when RoboTask quits.

 

Add

Click the Add button to display a list of events that you can add to the task.

 

Edit

Select an event in the Event List and click the Edit button to modify the parameters, or settings, for the event.

 

Remove

Select an event and click the Remove button to remove the event from the task.

 

 

Advanced tab

 

TaskEditorAdvanced

 

Log Level

 

Select the status messages you want to record in the log file:

Nothing
Errors Only
Errors and Warnings
All Messages

 

Action After Completion

 

Select an option to run a task:

Nothing - Nothing happens when the task completes all actions.
Disable Task - The task is disabled when the task completes all actions. This is useful if you want to run a task once and save the task to use again later. You can change this later.
Delete Task - The task is removed from the computer permanently when the task completes all actions. This is useful if you want to run a task once and do not need it again. You cannot use the task again when you select this option and run the task.

 

External Name

 

You can define an external name by hand. External Name is, per se, an alternative identifier of a task, which can help you to refer to a task (see object RoboTaskApp). RoboTask controls the uniqueness of the External Name and, in case of name clash, resets it to the default value. The default value looks like TaskNNNN, where NNNN – is just an ordinal number.

 

If Error Occurred

 

Here you can define the behavior of a task when an error is raised in any step. You can choose from 3 variants:

Stop Task – the default action. When an error is raised, performance of a task is stopping.
Continue Execution – when an error is raised, performance of a task is going on. In other words – it is ignoring of the error. We recommend to use this mode only if it is really necessary.
Run the Error Handling Task – run the other task if an error is raised. The running task, per se, is an error handler. In this case, performance of the main task is stopping. See below the describing of the transferred parameters.

 

Error Handling Task

 

Choose the task of error handler in a drop-down list. This task will be started up in case of appearance of error. When the task is being started up, the fixed kit of parameters is transferring to it:

LastErrorTaskID – the internal ID of the task, in which an error was raised. It is a formal identifier of the task like a number.
LastErrorTaskName - the name of the task, in which an error was raised.
LastErrorTaskExternalName – an External Name of the task, in which an error was raised.
LastErrorStep – the number of the step (starting from 1), in which an error was raised.
LastErrorCode – code of the error. There is the own kit of codes of errors for any type of actions (see description of actions). By default – 0.
LastErrorDescription – the description of the error. It depends on a type of action. By default, it is the line "General error".

 

LastErrorCode and LastErrorDescription depend on a type of action. Descriptions of error codes are put into the help of actions (help file)

 

 

Local variables tab

 

TaskEditorLocalVars

 

You can declare local variables on the "Local variables" tab of the task editor. There are two ways to declare them:

Enumerate the names of the variables;

Assign initial values to them.

If you enumerate them, just fill the list of names for local variables: one variables per line. For example, like this:

 

LineCount

FileToUpload

CurrentFile

 

etc.

 

To assign an initial value, specify this value after the "=" character. For example, like this

 

LineCount = 0

FileToUpload = c:\incoming\list.txt

CurrentFile = note.txt

 

etc.

 

You can assign initial values not to all variables. By default, local variables contain an empty value (an empty string).

By default, the list of local variables is empty. It means that all variables that are used in a task will be processed as global ones when you run the task.

See more information about local variables.

 

note Related Topics

Task - Edit

Task - Delete

Task - Run

Task - Stop

Task - Find the task

Task - Local running task

Task - Export

Task - Import

Task - Copy

Task - Paste

Task - Duplicate

Task - Create Shortcut on Desktop

Task - Create Batch File

Task - Exit